Microaplicaciones

Integrar Aplicación de encuestas de empleados

Implemente Aplicación de encuestas de empleados para enviar un nuevo formulario de encuesta y administrar los formularios de encuesta existentes desde Citrix Workspace. Con las microaplicaciones, se abordan los siguientes flujos de trabajo:   

  • La microaplicación Administrar encuesta sirve para que los administradores de Citrix Podio mantengan las aplicaciones de encuesta existentes en Citrix Workspace.
  • La microaplicación Formulario de encuesta envía notificaciones de todas las encuestas programadas en Citrix Podio a todos los suscriptores y recibe comentarios de los usuarios en Citrix Workspace.

Independientemente de cuándo despliegue su solución tecnológica, es importante que entienda la experiencia de los usuarios finales para saber si esa solución es capaz de satisfacer sus necesidades y, al mismo tiempo, impulsar la productividad gracias a una experiencia de espacio de trabajo digital óptima. La integración de encuestas a empleados le permite recibir fácilmente comentarios de sus usuarios finales en el momento que elija. La encuesta no solo le ofrece la posibilidad de escuchar a los usuarios y proporcionarles el apoyo necesario, sino que además le ayuda a mantenerse informado y a gestionar la experiencia en consecuencia. La plantilla incluye encuestas prediseñadas y personalizables basadas en las prácticas recomendadas sobre experiencia de empleado y de usuario final. Puede agregar fácilmente otras encuestas para recoger opiniones sobre cualquier aspecto de la experiencia de empleado. Para obtener más información sobre la experiencia del usuario final, consulte End User Experience Kit en Citrix Success Center.

¡Su opinión nos interesa! Proporcione comentarios sobre esta plantilla de integración a medida que la utiliza. Para cualquier problema, nuestro equipo también supervisará el foro dedicado a diario.

Para obtener información detallada sobre las microaplicaciones, consulte Usar las microaplicaciones de Aplicación de encuestas de empleados.

Revisar requisitos previos

Tras configurar esta integración con la aplicación de encuestas, necesitará estos artefactos para agregar la integración en las microaplicaciones de Citrix Workspace:

  • URL base: https://api.podio.com
  • ID de aplicación Administración de encuestas: Introduzca el ID de la aplicación “Mis encuestas”. Consulte Recopilar ID de aplicación y token de aplicación.
  • URL de respuesta: https://{yourmicroappserverurl}.us.iws.cloud.com/admin/api/gwsc/auth/serverContext
  • URL de autorización: https://podio.com/oauth/authorize
  • URL del token: https://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.
  • Secreto del cliente: El secreto del cliente es la cadena única emitida al configurar la integración de la aplicación de destino.
  • Parámetros del token de acceso: Introduzca los parámetros de nombre y valor conforme a las instrucciones que se indican a continuación:

Nota

Se recomienda que siempre use OAuth 2.0 como método de autenticación de servicio allí donde pueda. OAuth 2.0 garantiza que la integración es conforme a los requisitos de seguridad más estrictos con la microaplicación configurada.

Crear cuenta de servicio

La integración requiere el acceso periódico a su instancia de Aplicación de encuestas. Recomendamos crear una cuenta de usuario dedicada. Esta cuenta debe tener permisos de administrador total. Para obtener más información, consulte la documentación de la API de Podio.

Habilitar API

El número de solicitudes de API que se pueden realizar a recursos específicos es limitado. Recomendamos lo siguiente: Documentación sobre limitaciones de API.

Configurar el cliente de OAuth

Obtenga el ID de cliente y el secreto del cliente en Podio para acceder a la pantalla de configuración de la integración de microaplicaciones para la autenticación.

  1. Inicie sesión en el sitio para desarrolladores de Podio como administrador de aplicaciones del espacio de trabajo de Podio: Podio
  2. Seleccione Generar la clave de API.
  3. Seleccione Obtener una clave de API ahora.
  4. Indique un nombre de aplicación.
  5. 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.
  6. Seleccione Generar clave de API.
  7. 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.

    Colección de tokens de la aplicación Podio

Para obtener más información, consulte Recopilar ID de cliente y secreto del cliente.

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.

    Icono de herramientas de encuestas de empleados

  3. En Aplicación, seleccione Desarrollador.

    Opción de desarrollador de encuestas de empleados

  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.

    Token de la aplicación de encuestas de empleados

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.

Cómo enviar notificaciones de una nueva aplicación de encuesta

Utilice la aplicación de encuesta a empleados para programar diferentes formularios web o encuestas de opinión.

Nota

A efectos de identificación, se recomienda incluir algún campo de autoidentificación como campo obligatorio dentro del formulario de encuesta, por ejemplo, Correo electrónico o Nombre.

Siga estos pasos para programar una encuesta en Citrix Workspace.

  1. Inicie sesión en su instancia de Citrix Podio, vaya a Podio App Market y obtenga el paquete de aplicaciones Citrix Workspace Employee Surveys: Podio App Market - Citrix Workspace Employee Surveys
  2. Seleccione Mi aplicación de encuestas en Aplicaciones de este paquete.
  3. Seleccione Agregar encuesta e introduzca el nombre de una encuesta que quiera enviar y de la que quiera recoger opiniones. Seleccione una Fecha de lanzamiento en la que desencadenar la notificación de la encuesta.
  4. Seleccione Enable_Survey como estado para generar la notificación y Disable_Survey para inhabilitarla al instante desde Citrix Workspace.
  5. En Descripción de la encuesta, introduzca el contenido del cuerpo de la notificación. Este contenido se muestra en la tarjeta de feeds para suscriptores.
  6. Introduzca el ID de la aplicación de respuesta del formulario de encuesta. Este valor es el ID que el administrador quiere enviar a los usuarios para su notificación.
  7. Seleccione la fecha Caduca después de para inhabilitar automáticamente las notificaciones a los suscriptores en la fecha seleccionada.
  8. Vaya a las aplicaciones de formularios web creadas por Podio que el administrador quiere programar y en las que quiere obtener la opinión de los usuarios, seleccione Parámetros y elija la opción Formularios web.
  9. En la sección Dominio permitido, agregue el dominio del espacio de trabajo de WSI en la configuración del formulario web de las aplicaciones de encuesta. Por ejemplo, {yourmicroappserverurl}.cloud.com.
  10. Seleccione Guardar y, a continuación, Compartir.

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: https://api.podio.com
    • Seleccione un icono para la integración en la Biblioteca de iconos, o deje el icono predeterminado.
  5. Introduzca el ID de la aplicación de administración de encuestas. Consulte Recopilar ID de aplicación y token de aplicación.
  6. Introduzca los parámetros de Autenticación de servicio y del Conector que recopiló en los procedimientos anteriores.

  7. 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 Código de autorización.
    2. En el campo Valor de tipo de concesión, introduzca authorization_code.
    3. La dirección URL de respuesta se rellena automáticamente: https://{yourmicroappserverurl}.us.iws.cloud.com/admin/api/gwsc/auth/serverContext.
    4. Seleccione Cuerpo de la solicitud en el menú Autorización de token.
    5. En el menú Tipo de contenido de token, seleccione URL codificada del formulario.
    6. La URL de autorización se rellena automáticamente: https://podio.com/oauth/authorize.
    7. La URL del token se rellena automáticamente: https://podio.com/oauth/token.
    8. 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. Recopiló este ID y el secreto del cliente en el procedimiento Configurar el cliente de OAuth.
    9. Introduzca su Secreto del cliente. El secreto del cliente es una cadena única que se emite con el ID de cliente en el procedimiento Configurar el cliente de OAuth.
  8. 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 app_id.
    • Introduzca el token de aplicación que recopiló junto a app_token.
    • Introduzca app como grant_type.
  9. La opción Limitación del índice de solicitudes está habilitada y configurada en 1000 solicitudes por minuto.
  10. Introduzca 120 en el campo Tiempo de espera de solicitud.
  11. Seleccione Guardar para continuar.

Ya tiene todo listo para configurar y llevar a cabo su primera sincronización de datos. Para obtener información completa acerca de las reglas de sincronización, la sincronización que no cumple con sus reglas de programación y las reglas de veto, consulte Sincronizar datos.

Para obtener información detallada sobre los dispositivos de punto final de las API y las entidades de tabla, consulte Especificaciones del conector de Aplicación de encuestas de empleados.

Usar las microaplicaciones de Aplicación de encuestas de empleados

Las integraciones de las aplicaciones existentes vienen con microaplicaciones de uso inmediato. Comience con estas microaplicaciones y personalícelas conforme a sus exigencias.

Formulario de encuesta: Proporciona notificaciones de nuevas encuestas y permite a los usuarios ver y enviar los formularios de encuesta.

Notificación o página Flujos de trabajo por caso de uso
Notificación Nueva encuesta Permite a los usuarios ver todos los nuevos formularios iniciados a través de la aplicación de administración de encuestas en Citrix Workspace.
Página Formulario de encuesta Permite a los usuarios completar y enviar una encuesta desde Citrix Workspace.

Administrar encuesta: Permite al administrador de la aplicación de encuestas administrar desde Citrix Workspace los formularios de encuesta programados. Esta microaplicación es solo para los miembros administradores de Aplicación de encuestas de empleados.

Nota

Se recomienda mantener un número limitado de registros de encuesta en la aplicación de administración Mis encuestas de Podio.

Notificación o página Flujos de trabajo por caso de uso
Página Mi encuesta Muestra todos los formularios de encuestas programadas creados por un administrador.
Página Administrar encuesta Permite a los administradores administrar los formularios de encuesta programados, como el cambio de estado, la fecha de lanzamiento, la fecha de caducidad, etc.