Integrar Citrix Podio

Integre con Citrix Podio para ofrecer acciones rápidas en Citrix Workspace mediante la flexibilidad y los diversificados casos de uso de Podio. Con esta integración, puede conectar fácilmente nuestras microaplicaciones de uso inmediato de Workspace con las aplicaciones correspondientes en Podio, las cuales están disponibles en Podio App Market.

• Aplicaciones de Podio: Citrix tiene más de 285 aplicaciones en Podio App Market. También puede crear sus propias aplicaciones como usuario empresarial con Podio. La plantilla de aplicación le permite construir la aplicación para que se adapte a las necesidades específicas de su empresa y asignarla al proceso particular de su equipo en Podio. Para obtener más información, consulte Creación de aplicaciones.
• Esta integración también le permite crear sus propias aplicaciones y soluciones personalizadas en Podio, crear microaplicaciones e implementarlas en Citrix Workspace. Estas microaplicaciones utilizan Podio, un servicio propiedad de Citrix, como sistema de registro (SoR). Los datos que se intercambian con estas microaplicaciones residen en Citrix y se rigen por las directrices y protocolos de Citrix.

Diferentes aplicaciones de Podio pueden usar la misma integración con Microaplicaciones. Tenga en cuenta lo siguiente al diseñar las integraciones con Podio:

• El ID de aplicación y el token de aplicación son únicos para el espacio de trabajo. Este valor se puede utilizar para todas las aplicaciones de un espacio de trabajo de Podio.
• La plantilla de integración de Podio está diseñada para notificaciones push. Dado que esta integración utiliza el token de aplicación, en lugar de permisos de usuario, no se admite la escritura contextual de usuario.
• Si las aplicaciones están en el mismo espacio de trabajo de Podio, son adecuadas para una misma integración con Microaplicaciones. Si las aplicaciones están en diferentes espacios de trabajo de Podio, utilizan diferentes integraciones.
• Considere asimismo la separación lógica, las bases de usuario y la facilidad de administración.

Revisar requisitos previos

Revise los siguientes requisitos. Estos se dividen en dos grupos: nivel de integración y nivel de aplicación de Citrix Podio. Ambos son necesarios para esta plantilla de integración, aunque solo puede implementar las microaplicaciones deseadas a nivel de aplicación.

Requisitos de integración

Para configurar esta integración, debe tener permisos de administrador para el espacio de trabajo de Podio de destino y tener la aplicación Podio.

Estos son los valores que se introducen en la pantalla de configuración de la integración:

• URL base: https://api.podio.com. Este valor viene prerrellenado.
• ID de aplicación de Podio: Cada espacio de trabajo en Podio tiene un ID de aplicación. Introduzca este valor como parámetro del token de acceso al configurar la integración, reemplazando la variable podio_app_id. Puede usar el ID de la aplicación desde cualquier aplicación de Podio en el espacio de trabajo de Podio. Consulte Recopilar ID de aplicación y token de aplicación.
• Token de aplicación: Utilice este token para autenticación como aplicación, en lugar de usuario. Introduzca este valor como parámetro del token de acceso al configurar la integración, reemplazando la variable podio_token_id. Se puede obtener con el ID de aplicación.
• URL del token: Este valor viene prerrellenado: https://api.podio.com/oauth/token
• ID de cliente: El ID de cliente es la cadena que representa la información de registro del cliente exclusiva del servidor de autorización. Consulte Recopilar ID de cliente y secreto del cliente.
• Secreto del cliente: El secreto del cliente es la cadena única emitida al configurar la integración de la aplicación de destino.

Requisitos de la aplicación Citrix Podio

Estos son los valores que debe introducir en el nivel de aplicación Podio para configurar dispositivos de punto final y acciones de servicio para cada aplicación Podio a la que quiera conectarse a través de esta integración. Se pueden requerir los siguientes valores para cada aplicación:

• ID de vista: Las acciones de servicio y dispositivos de punto final de plantilla utilizan vistas Podio como filtro para descargar una cantidad seleccionada de registros. Utilice este valor para sustituir la variable de plantilla <podioapp>_view_id cuando modifique configuraciones. Consulte Recopilar ID de vista.
• ID de aplicación: Cada aplicación tiene un ID único. Utilice este valor para sustituir la variable de plantilla <podioapp>_app_id cuando modifique configuraciones.

Estos son los valores únicos de la aplicación Podio:

Aplicación Podio	Valores de ID	Obtener la aplicación
Aplicación Broadcast	broadcast_app_id broadcast_view_id	Aplicación Citrix Workspace Broadcast
Aplicación FAQs	faq_app_id faq_view_id	Aplicación Citrix Workspace FAQs

Recopilar ID de aplicación y token de aplicación

Obtenga el ID de aplicación y el token de aplicación de Podio para autenticación como aplicación, en lugar de como usuario. Con el acceso con ID de aplicación, los usuarios solo pueden acceder a los datos de las aplicaciones que se encuentran en el espacio de trabajo de Podio relacionado. Obtendrá este ID de aplicación Podio para el espacio de trabajo de Podio. Si tiene varias aplicaciones en un espacio de trabajo, puede usar cualquiera de los ID de aplicación afiliados al espacio de trabajo.

1. Inicie sesión en Podio y vaya a su aplicación Podio.

2. Seleccione el icono Herramientas situado junto al nombre de la aplicación. En las capturas de pantalla, se muestran los pasos para la aplicación Broadcast como ejemplo.

   

3. En Aplicación, seleccione Desarrollador.

   

4. Copie y guarde los campos ID de aplicación y Token. Introducirá estos valores como parámetro de token de acceso al configurar la integración.

   

También puede ver los campos y valores JSON de ejemplo en Campos de aplicación, en esta página. Para obtener más información sobre cómo trabajar con entradas de aplicaciones en Podio, consulte Trabajar con elementos.

Recopilar ID de vista

Algunas acciones de servicio y dispositivos de punto final de Podio utilizan vistas Podio como filtro para descargar una cantidad seleccionada de registros. Para obtener más información sobre cómo usar vistas y filtros en Podio, consulte Vistas, filtros e informes.

Debe encontrar su ID de vista para los campos especificados a continuación, dependiendo de las microaplicaciones que quiera implementar. Este valor se utiliza para reemplazar la variable de plantilla view_id al reemplazar las variables de acción de servicio que se indican a continuación en Reemplazar variables de carga de datos y acción de servicio.

• Para la aplicación Broadcast, el campo es Modificado hoy
• Para la aplicación FAQs, el campo es Preguntas frecuentes publicadas

1. Inicie sesión en Podio y vaya a su aplicación Podio.

2. Pase el ratón sobre el campo especificado para ver el ID de vista en la sección inferior izquierda del explorador. En las capturas de pantalla, hemos mostrado el campo en la aplicación Broadcast como ejemplo.

   

3. Puede seleccionar el campo especificado para abrir la vista. Copie la sección final de la URL y guárdela para usarla posteriormente al reemplazar variables en acciones de servicio.

   

También puede encontrar el ID de vista en el portal para desarrolladores de Podio. Siga estos pasos:

1. Inicie sesión en Vistas de la API de Podio.
2. Seleccione Obtener vistas.
3. Desplácese hacia abajo hasta la sección Sandbox e inicie sesión si es necesario.
4. Introduzca el valor de app_id que recopiló en el proceso Recopilar ID de aplicación y token de aplicación.

5. Deje el valor include_standard_views como false y seleccione Enviar.

   

6. Puede buscar (Ctrl+F) view_id en los resultados. Está cerca del final. Copie y guarde este valor para uso posterior.

   

Recopilar ID de cliente y secreto del cliente

Para entrar en la pantalla de configuración de microaplicaciones para la autenticación, necesita obtener un ID de cliente y un secreto de cliente en Podio.

1. Inicie sesión en Claves de API. Complete los campos de Generador de claves de API.
2. Indique un nombre de aplicación.
3. Para el dominio completo (sin protocolo) de su URL de respuesta, introduzca la URL de instancia de microaplicaciones. Esta sección de la URL {yourmicroappserverurl} se compone de una parte de arrendatario, una parte de región y una parte de entorno: https://{tenantID}.{region(us/eu/ap-s)}.iws.cloud.com.
4. Seleccione Generar clave de API.

5. En Tus claves API, copie y guarde los valores ID de cliente y Código secreto del cliente para la aplicación que acaba de agregar. Estos valores se introducen al configurar la integración.

   

Agregar la integración a las microaplicaciones de Citrix Workspace

Agregue la integración de Podio a las microaplicaciones de Citrix Workspace para conectarse a su aplicación. Las opciones de autenticación están preseleccionadas. Compruebe que estas opciones estén seleccionadas a medida que complete el proceso. Esto proporciona microaplicaciones de uso inmediato con notificaciones y acciones preconfiguradas que se pueden usar desde ya en su espacio de trabajo.

Siga estos pasos:

1. En la página Integraciones de microaplicaciones, seleccione Agregar nueva integración y Agregar una nueva integración a partir de plantillas proporcionadas por Citrix.
2. Elija el mosaico de Podio.
3. En el campo Nombre de la integración, introduzca un nombre para la misma.
4. Introduzca los parámetros del conector.
   • Introduzca la URL base de la instancia:
   • Seleccione un icono para la integración en la Biblioteca de iconos, o deje el icono predeterminado.

   

5. En Autenticación de servicio, seleccione OAuth 2.0 en el menú Método de autenticación y complete los detalles correspondientes. Las opciones de autenticación están preseleccionadas. Compruebe que estas opciones estén seleccionadas a medida que complete el proceso. Utilice el protocolo de seguridad de OAuth 2.0 para generar tokens de solicitud/autorización para el acceso delegado. Se recomienda utilizar OAuth 2.0 como método de autenticación del servicio siempre que esté disponible. OAuth 2.0 garantiza que la integración es conforme a los requisitos de seguridad más estrictos con la microaplicación configurada.

   1. En el menú Flujo de tipo de concesión, seleccione Credenciales del cliente.
   2. En el campo Valor de tipo de concesión, introduzca app.
   3. Seleccione Cuerpo de la solicitud en el menú Autorización de token.
   4. En el menú Tipo de contenido de token, seleccione URL codificada del formulario.
   5. Confirme el campo URL del token. Este valor viene prerrellenado: https://api.podio.com/oauth/token
   6. Introduzca su ID de cliente. El ID de cliente es la cadena que representa la información de registro del cliente exclusiva del servidor de autorización. Obtendrá este y el secreto del cliente al generar una clave de API.
   7. Introduzca su Secreto del cliente. El secreto del cliente es una cadena única emitida con el ID de cliente al generar una clave de API.

   

6. Introduzca los valores de los parámetros de token de acceso. Para obtener más información, consulte Recopilar ID de aplicación y token de aplicación:
   • Introduzca el ID de aplicación que recopiló junto a podio_app_id. Puede usar el ID de la aplicación desde cualquier aplicación de Podio en el espacio de trabajo de Podio.
   • Introduzca el token de aplicación que recopiló junto a podio_app_token.

   

7. No habilite la opción Autenticación de acciones de servicio.
8. No habilite la opción Limitación del índice de solicitudes.
9. Introduzca 120 en el campo Tiempo de espera de solicitud.
10. (Optativo) Habilite la opción Registro para conservar un registro de 24 horas con fines de asistencia.

11. Seleccione Guardar para continuar.

    

Se abrirá la página Integraciones de microaplicaciones con la integración agregada y sus microaplicaciones. A continuación, debe realizar algunos cambios en las variables de plantilla para los dispositivos de punto final y las acciones de servicio, como se describe a continuación.

Reemplazar variables de carga de datos y acción de servicio

Para completar esta configuración, debe reemplazar las variables de plantilla ID de aplicación e ID de vista en la configuración de integración de Podio con el ID de aplicación y el ID de vista que recopiló anteriormente para cada una de las aplicaciones Podio con las que quiere conectar. Reemplace estas variables para la carga de datos y las acciones de servicio.

Guía rápida para reemplazar variables

Estos son los valores que debe introducir en el nivel de aplicación Podio para configurar dispositivos de punto final y acciones de servicio para cada aplicación Podio a la que quiera conectarse a través de esta integración:

• broadcast_app_id Modificar dispositivos de punto final: Difusión, Categoría de difusión, Criticidad de difusión, Estado de difusión; y acciones de servicio: Crear difusión, Actualizar difusión.
• broadcast_view_id Modificar dispositivo de punto final: Difusión; y acción de servicio: Crear difusión.
• faq_app_id Modificar dispositivos de punto final: Categoría de preguntas frecuentes y Preguntas frecuentes.
• faq_view_id Modificar dispositivo de punto final: Preguntas frecuentes.

Modifique las siguientes variables en las ubicaciones indicadas. Más adelante se muestra el procedimiento paso a paso.

Reemplazar variables de carga de datos

Para cada dispositivo de punto final de datos, debe agregar manualmente la variable para ID de aplicación e ID de vista. Se debe hacer esto para los seis dispositivos de punto final.

• broadcast_app_id Modificar dispositivos de punto final: Difusión, Categoría de difusión, Criticidad de difusión, Estado de difusión.
• broadcast_view_id Modificar dispositivo de punto final: Difusión.
• faq_app_id Modificar dispositivos de punto final: Categoría de preguntas frecuentes y Preguntas frecuentes.
• faq_view_id Modificar dispositivo de punto final: Preguntas frecuentes.

1. En la página Integraciones de microaplicaciones, seleccione el menú situado junto a la integración de Podio y, a continuación, Modificar. Se abrirá la pantalla Carga de datos. Si se encuentra en la pantalla de configuración, seleccione Carga de datos en la columna de navegación del lado izquierdo.

2. Seleccione el menú situado junto al primer dispositivo de punto final y, a continuación, Modificar, o bien seleccione el nombre del dispositivo de punto final. Comencemos con el dispositivo de punto final de Difusión.

   

3. En la pantalla Modificar dispositivo de punto final de datos, en Variables de plantilla, sustituya las variables {broadcast_app_id} y {broadcast_view_id} por su ID de aplicación.

   

4. Seleccione Aplicar en la parte inferior de la pantalla y confirme la operación.
5. Ahora repita este procedimiento para los otros cinco dispositivos de punto final, reemplazando los valores según sea necesario. No olvide seleccionar Aplicar en la parte inferior de la pantalla y confirmar que quiere guardar los cambios para cada dispositivo de punto final.

Reemplazar variables de acción de servicio

Para cada acción de servicio, debe agregar manualmente los datos de broadcast_app_id y broadcast_view_id. La acción de servicio Crear difusión requiere que reemplace ambas variables. La acción de servicio Actualizar difusión solo requiere que reemplace la variable broadcast_app_id.

• broadcast_app_id Modificar acciones de servicio: Crear difusión y Actualizar difusión.
• broadcast_view_id Modificar acción de servicio: Crear difusión.

1. Mientras modifica la configuración de integración, seleccione Acciones de servicio en la columna de navegación del lado izquierdo.

2. Seleccione el menú situado junto a una de las acciones de servicio y seleccione Modificar, o bien seleccione el nombre de la acción de servicio. Comencemos con la acción de servicio Crear difusión.

   

3. En la pantalla Modificar acción de servicio, en Variables de plantilla, sustituya las variables {broadcast_app_id} y {broadcast_view_id} por el ID de aplicación y el ID de vista que recopiló anteriormente.

   

4. Seleccione Guardar para finalizar.
5. Ahora repita esto para la otra acción de servicio: Actualizar difusión, pero reemplazando solo la variable broadcast_app_id.

Para obtener más información sobre los dispositivos de punto final de las API y las entidades de tabla, consulte Especificaciones del conector de Podio.

Usar microaplicaciones de Podio

Esta plantilla de integración de Podio viene con las siguientes microaplicaciones de uso inmediato. Comience con estas microaplicaciones y personalícelas conforme a sus exigencias.

Microaplicaciones de difusión de Podio

Utilice estas microaplicaciones para componer anuncios importantes y compartirlos con su equipo. Estos anuncios pueden ser sobre actualizaciones de TI, en los recursos o en general, cambios en procesos, comunicación de crisis importantes o simplemente para involucrar a su equipo con noticias de entretenimiento, salud, etc.

La aplicación Citrix Workspace Broadcast es un requisito previo para las microaplicaciones de difusión. Es necesario instalar esta aplicación desde Podio App Market. Esta plantilla de aplicación Podio viene con un conjunto predefinido de valores para los campos Categoría y Criticidad. Utilice la función Modificar plantilla de la aplicación para agregar o modificar opciones para estos campos, de manera que se adapten a las necesidades de su empresa. Esta modificación no requeriría ningún cambio en las microaplicaciones correspondientes. También puede modificar la aplicación Podio agregando o modificando otros campos. Sin embargo, esto requiere que los cambios correspondientes se reflejen también en la microaplicación. Obtenga la aplicación Podio: Aplicación Citrix Workspace Broadcast.

Familiarícese con las siguientes consideraciones:

• Las microaplicaciones Crear difusión y Administrar difusión que se describen a continuación son microaplicaciones de administración.
• El estado Live (En directo) de estas microaplicaciones significa la publicación del mensaje. Cuando se publica un mensaje, este está disponible en la microaplicación Difusión para usuarios estándar (no administradores).
• Si cualquier campo de estado de la aplicación Podio se modifica con valores diferentes, deberá actualizarse el valor correcto en la microaplicación. Por ejemplo, si quiere utilizar el estado Publicado en lugar de En directo, deberá personalizarse la microaplicación en consecuencia.

Difusión: Consulte todas las difusiones publicadas (estado: Live) con una fecha de finalización en el futuro.

Notificación o página	Flujos de trabajo por caso de uso
Notificación Difusión cambiada	Cuando una difusión cambia y se pone en directo, los suscriptores reciben una notificación.
Notificación Nueva difusión	Cuando se pone una nueva difusión en directo, los suscriptores reciben una notificación.
Página Difusión	Proporciona una página de solo lectura con detalles de la difusión.
Página Difusiones	Proporciona una lista de sus difusiones con un enlace a los detalles.

Crear difusión: Permite crear y publicar nuevas difusiones.

Notificación o página	Flujos de trabajo por caso de uso
Página Crear difusión	Proporciona una página para crear y publicar difusiones.

Administrar difusión: Los administradores pueden ver y actualizar todas las difusiones creadas. Esta vista no se limita a las difusiones publicadas (estado: Live).

Notificación o página	Flujos de trabajo por caso de uso
Notificación Difusión cambiada	Cuando se actualiza una difusión, los suscriptores reciben una notificación.
Notificación Nueva difusión	Cuando se pone una nueva difusión en directo, los suscriptores reciben una notificación.
Página Difusiones	Proporciona una lista de difusiones creadas en la que se puede buscar, con un enlace a los detalles en los que se pueden actualizar las difusiones.
Página Difusión	Proporciona una página de solo lectura, similar a la página utilizada en la microaplicación Difusión, que muestra cómo ve la difusión el público. Incluye un botón Actualizar que conduce a la página Actualizar difusión, donde los administradores pueden modificar la difusión.
Actualizar difusión	Proporciona una página para actualizar una difusión existente.

Borrar transmisiones caducadas

Habilite este flujo de trabajo para automatizar la identificación de las difusiones cuya fecha final se ha superado. La difusión se marca como completada y deja de mostrarse a los suscriptores.

Este flujo de trabajo está disponible con el plan Podio Premium. Para obtener más información, consulte Automatización del flujo de trabajo. El administrador que configuró esta integración habilita el flujo actualizando desde Podio después de iniciar sesión en https://workflow-automation.podio.com y actualizar el espacio de trabajo de Podio correspondiente.

Microaplicación de preguntas frecuentes de Podio

Puede compilar una lista de preguntas frecuentes y ponerlas a disposición en Citrix Workspace. La aplicación Citrix Workspace FAQs es un requisito previo para la microaplicación de preguntas frecuentes. Es necesario instalar esta aplicación desde Podio App Market. Obtenga la aplicación Podio: Aplicación Citrix Workspace FAQs.

Preguntas frecuentes: Lista de preguntas y respuestas más frecuentes.

Notificación o página	Flujos de trabajo por caso de uso
Notificación de nuevo artículo	Cuando se publica un nuevo artículo, los suscriptores reciben una notificación.
Página de preguntas frecuentes	Proporciona una lista de preguntas frecuentes en la que se puede buscar y filtrar por categoría, con un enlace a la página Preguntas y respuestas.
Página Preguntas y Respuestas	Proporciona una vista detallada de una pregunta frecuente, con un enlace al material de origen.