Documentación de productos
Microaplicaciones
Ver PDF

Generador de páginas

November 17, 2021
Contribución de: 
C

Familiarícese con el generador de páginas y sus componentes para poder crear páginas de acciones. Los diferentes componentes y secciones del generador de páginas se describen en las siguientes secciones. Puede agregar y personalizar campos y botones adicionales en función de sus propios requisitos.

Tutorial del generador de páginas

La captura de pantalla que aparece a continuación muestra el generador de páginas completo con secciones destacadas. Las descripciones que vienen a continuación hacen referencia a las secciones numeradas:

Vista completa del generador de páginas con líneas destacadas arriba

  1. La barra superior tiene un rastro seleccionable a la izquierda. Seleccionar el nombre de la página (en negrita con un icono de menú abierto a la derecha) le permite saltar rápidamente entre páginas. En la sección central, puede seleccionar monitor estándar o vista móvil. A la derecha, tiene opciones de vista previa. La vista previa de página presenta una vista de la página que está viendo en el generador. La vista previa de microaplicación ofrece un flujo de trabajo simulado de las acciones de microaplicación donde puede abrir todas las páginas y ver notificaciones y sus acciones.

  2. El lado izquierdo contiene opciones de navegación rápida a las pantallas de la microaplicación. De arriba a abajo, puede saltar a una lista de todas las Notificaciones o Páginas de esta microaplicación, la pantalla Localización y la pantalla Propiedades, donde puede modificar el nombre, la descripción y el icono. Para obtener más información, consulte

  3. Los componentes se encuentran en el panel izquierdo. Selecciónelos y arrástrelos al lienzo del generador en la sección central de la pantalla. Consulte Componentes del generador de páginas. Los componentes se dividen en Entrada, Presentación y Diseño.

    • Los componentes de entrada crean secciones procesables en la página, incluidos botones, entrada de texto y botones de opción.
    • Los componentes de presentación proporcionan información a los usuarios finales de microaplicaciones, incluidas tablas, texto estático e imágenes.
    • El componente de diseño proporciona el componente de cuadrícula para configurar el diseño de la página.
  4. El lienzo del generador es la sección central. Puede mover los componentes por aquí para organizarlos según sea necesario. Seleccione el componente aquí para habilitar las propiedades del componente, acciones y otras fichas visibles en el panel derecho.

  5. Personalice los componentes y agregue detalles de página en el panel derecho. La ficha Detalles de la página le permite configurar la página que está creando, introduciendo un nombre, estableciendo filtros de información y agregando lógica a los componentes de página. Además, puede utilizar la funcionalidad de depuración de datos. Esta ficha sigue permanece igual para la página y no depende del componente seleccionado. Otras fichas difieren en función del componente seleccionado. En las fichas disponibles, se incluyen:

    • Propiedades: Cada componente del generador de páginas tiene su propio menú de propiedades específicas con varias opciones entre las que elegir, dependiendo del componente.
    • Reglas de validación de entrada: Algunos componentes habilitan sus propias reglas de validación específicas.
    • Acciones: Hay diferentes acciones disponibles en función de los componentes. Las acciones permiten a los destinatarios de la microaplicación (usuarios de Workspace) responder con una entrada procesable.

    Otras fichas que son únicas para un componente se describen plenamente con el componente correspondiente bajo las secciones Componentes de presentación y Componente de diseño.

Para obtener una lista completa y una descripción de los campos de propiedades de componente disponibles, los conmutadores y los elementos seleccionables, consulte Propiedades de componente.

Plantillas de página

Al crear una página, puede seleccionar entre los siguientes diseños de página básicos, dependiendo de la información que quiera. Cada plantilla está destinada únicamente a acelerar su actividad para producir la página que quiere.

  • Detalles: Plantilla de página que proporciona detalles estáticos y está conectada a un registro particular de la caché.
  • Formulario: Genera una página que proporciona detalles estáticos, además de la posibilidad de introducir datos de usuario en la página.
  • Tabla: Genera una página que muestra varios registros basada en las tablas de datos que se cargan a partir de la integración de la aplicación de destino.
  • Contenido estático: Configura componentes de página que proporcionan información estática y no procesable, como titulares, mensajes de error y recordatorios.
  • Insertar: Genera una página que representa un iframe para insertar páginas web personalizadas en las microaplicaciones.

Componentes del generador de páginas

El generador de páginas le permite elegir entre diversos componentes de página que le permiten personalizar y configurar la salida, la información y la presentación de la microaplicación. Utilice los componentes descritos más adelante para crear una microaplicación de página basada en sus expectativas y necesidades. Por ejemplo, si quiere mostrar una lista de usuarios, utilice el componente Tabla para crearla. Las diferentes páginas de plantilla tienen diferentes funciones de componentes disponibles de forma predeterminada. Las siguientes listas cubren todas las opciones disponibles.

Componentes de entrada

La sección Entrada proporciona los componentes para crear secciones procesables en su página, incluidos botones, entrada de texto, botones de radio, etc.

Vista detallada de los componentes de entrada

Botón

Agrega a la página un componente en el que se puede hacer clic con acciones y lógica. El tamaño y el estilo de los botones se pueden ajustar. Existen acciones, como opciones para Ejecutar acción de servicio, Ir a URL y Ejecutar desencadenante de notificación. Por ejemplo, mediante acciones, el botón puede dirigir a los usuarios a otra página o enviar una entrada. Para obtener más información sobre las acciones de los botones, consulte Acciones.

Entrada de texto

Define el origen de texto de los datos mostrados especificando la tabla de datos, la columna y el valor que el usuario puede ver en la página. El componente se puede marcar como opcional. El ancho del campo se puede modificar. Las reglas de validación se pueden configurar en función de una longitud mínima o máxima o un patrón de texto para identificar la entrada del usuario. Para ver un ejemplo de este componente en uso, consulte Generar una página de creación y Generar una página de lista.

Área de texto

Define el origen de texto de los datos mostrados especificando la tabla de datos, la columna y el valor que el usuario puede ver en la página. El componente se puede marcar como opcional. Las reglas de validación se pueden configurar en función de una longitud mínima o máxima o un patrón de texto para identificar la entrada del usuario.

Entrada núm

Define el origen de los datos mostrados especificando la tabla de datos y la columna que un usuario puede ver en la página. Se puede definir el formato, como la hora, la fecha, etc. El componente se puede marcar como opcional y el ancho del campo puede modificarse. Las reglas de validación se pueden configurar en función de una longitud mínima o máxima o un patrón de texto para identificar la entrada del usuario. Precisión define la cantidad de dígitos totales. Escala define la cantidad de dígitos a la derecha del punto decimal.

Selección

Permite a los usuarios elegir entre una lista de valores (límite de 100 valores). Se puede rellenar con datos del sistema de origen o puede introducirse la lista de valores manualmente. El componente se puede marcar como opcional y el ancho del campo se puede modificar. Puede definir el formato, como la hora, la fecha, etc. Para ver un ejemplo de este componente en uso, consulte Generar una página de creación.

Buscar

Permite a los usuarios buscar a través de una gran cantidad de valores y seleccionar un valor al buscar otra cosa. Debe especificar desde dónde se agrupan los datos. El componente se puede marcar como opcional. Para ver un ejemplo de este componente en uso, consulte Generar una página de creación.

Nota

Al configurar el componente de búsqueda con la estrategia “Contiene”, el tiempo de carga de los términos de búsqueda puede ser prolongado Se recomienda realizar pruebas con una gran muestra de datos para comprobar si afecta al rendimiento y a la experiencia de usuario. De forma alternativa, puede utilizar la estrategia “Empieza por” para mejorar el rendimiento, pero solo se devuelven los registros que comienzan por el término de búsqueda especificado.

Búsqueda con selección múltiple

La búsqueda con selección múltiple funciona de manera parecida al componente Buscar y permite a los usuarios buscar y seleccionar una gran cantidad de valores al buscar un valor alternativo.

Por ejemplo, los usuarios pueden buscar y agregar múltiples usuarios o direcciones de correo electrónico de usuarios al programar una reunión, o bien pueden agregar diferentes etiquetas al crear un tíquet de Jira. Para especificar dónde se agrupan los datos para su uso en el componente de búsqueda con selección múltiple, debe configurar el tipo de datos de matriz durante la configuración de acciones de servicio en la integración HTTP.

Ejemplos de casos de uso para la selección múltiple:

  • Webex: permite seleccionar varios usuarios para enviar una invitación a una reunión.
  • Smartsheet: permite seleccionar varios usuarios para compartir una hoja.
  • Jira: permite seleccionar varias etiquetas para asignar a un único tíquet de Jira.
  • Calendario de Office 365: permite seleccionar varios asistentes al programar un evento.
  • Correo electrónico de Office 365: permite seleccionar varios destinatarios de correo electrónico.

Configuración

La configuración es similar a la de Buscar, pero tiene dos opciones adicionales: “Recuento máximo de elementos” y “Se pueden crear nuevos elementos”. Aparte de las opciones de configuración estándar del generador de páginas, es posible definir lo siguiente al configurar la búsqueda multiselección:

Asignar al valor de un registro: Define el origen de datos de los valores preseleccionados y solo está disponible en la página de detalles (se necesita un ID de registro). A diferencia de Seleccionar, la búsqueda multiselección no está restringida a un único valor.

Origen de datos para opciones: Define el origen de datos para las opciones de la lista desplegable.

Estrategia de coincidencia de términos de búsqueda: Selecciona si el término de búsqueda coincide con el principio del valor de la base de datos o en cualquier lugar dentro del valor de la base de datos.

Recuento máximo de elementos: Establece la cantidad máxima de elementos seleccionados durante una búsqueda.

Se pueden crear nuevos elementos: Permite a los usuarios crear elementos que aún no están disponibles en la selección de búsqueda (por ejemplo, agregar nuevas etiquetas a un tíquet de Jira).

Comprobación de integridad

La comprobación de integridad funciona del mismo modo que la búsqueda, pero la cantidad máxima de elementos seleccionados no puede ser negativa. La tabla del origen de datos debe existir y las columnas de tabla para el valor, el valor de presentación y los datos adicionales deben asignarse correctamente a una tabla de datos con una clave externa.

Para obtener más información sobre cómo configurar las matrices para devolver varias entradas, consulte Tipos de datos.

Casilla de verificación

Agrega un componente seleccionable en la página definiendo el origen (tabla de datos y columna) y el valor predeterminado (bien seleccionado o inhabilitado). El componente se puede marcar como opcional.

Radio

Permite agregar un conjunto de opciones entre las que seleccionar solo una. Se puede rellenar con datos del sistema de origen o puede introducirse la lista de valores manualmente. El componente se puede marcar como opcional.

Fecha/Hora

Permite definir la fecha, la hora o la fecha y la hora que se mostrarán en la microaplicación y la hora predeterminada (la hora mostrada antes de la selección) que se cargarán en la página. El componente se puede marcar como opcional y el ancho del campo se puede modificar.

Componente de carga de archivos

Permite cargar archivos sin procesar en el SoR durante las acciones de envío o actualización. Para habilitar esta acción, cree una acción de servicio especial que admita la carga de archivos.

Este componente admite flujos de trabajo de usuario para cargar archivos en el SoR como adjuntos a registros existentes y como adjuntos al crear registros. Por ejemplo:

  • Jira: Cargar archivos de registro y capturas de pantalla y adjuntarlos a un tíquet de emisión.
  • Salesforce: Cargar un documento de acuerdo de descubrimiento y adjuntarlo a una cuenta u oportunidad.
  • SAP Concur: Adjuntar un recibo al administrar informes de gastos.
  • ServiceNow: Carga un archivo adjunto como parte de un flujo de trabajo de envío.

Crear acción de servicio

Para habilitar la carga de archivos, se deben utilizar scripts para configurar una acción de servicio. Existe un tipo de parámetro FILES para hacer compatible esta capacidad. Para obtener una descripción general, consulte Scripts de integración HTTP.

Antes de comenzar

  • Prepare el script que quiere importar a través de la interfaz de administración de microaplicaciones.
  • Los scripts deben escribirse en lenguaje JavaScript en el editor de texto o herramienta de desarrollo preferidos.
  • Cuando esté listo, importe el script a través de la ficha Integraciones de la interfaz de administración de microaplicaciones u, opcionalmente, introduzca el script directamente en el editor de texto proporcionado con la funcionalidad de programación.
  • Una vez importado, pruebe el script.

A continuación, se muestra un ejemplo de acción de servicio que carga varios archivos a la vez en Jira. Para ver más scripts, consulte este repositorio de scripts.

```javascript
function addAttachmentsSingleRequest({client, actionParameters}) {
    console.log(`attaching file(s) to issue ${actionParameters.issueKey}`);
    const formData = new FormData();
    const url = `/rest/api/2/issue/${actionParameters.issueKey}/attachments`;
    actionParameters.attachments.forEach(file => {
        formData.append("file", file);
    });
    const response = client.fetchSync(url, {
        method: 'POST',
        headers: {
            "Content-Type": "multipart/form-data",
            "X-Atlassian-Token": "nocheck"
        },
        body: formData
    });
    if (response.ok) {
        console.log('Attachment(s) posted');
    } else {
        const errorMessage = `Request failed(${response.status}: ${response.statusText})`
        console.error(errorMessage)
        throw new Error(errorMessage)
    }
}
<!--NeedCopy--> ```

Importar el script

Para importar el script preparado, siga estos pasos:

  1. En la pantalla de configuración de la integración, seleccione Scripting en la sección de navegación izquierda.
  2. Seleccione Cargar script. También puede introducir el script directamente en el área de texto seleccionando Modificar.
  3. Arrastre el script a la ventana emergente de importación.
  4. El script se analiza y valida.
  5. Seleccione Importar.
  6. Se importa el script.

Más información sobre scripts

Configurar el componente Carga de archivos

Ahora vuelva a la página de la microaplicación correspondiente a esta integración que quiere crear para cargar archivos. Después de colocar el componente Carga de archivos en el generador, complete las propiedades de Carga de archivos.

  1. Modifique el valor de Etiqueta si lo quiere. De forma predeterminada, es Carga de archivos. No se requiere ninguna etiqueta. Este valor aparece por encima del marco de colocación en Citrix Workspace.
  2. Modifique el valor de Recuento máximo de archivos si es necesario. De forma predeterminada, es 1. Este valor aparece junto al Límite de carga de archivos en el marco de colocación de Citrix Workspace. Cuando se seleccionan varios archivos, la carga de metadatos y la carga de contenido de cada archivo ocurren por separado. Esta capacidad está limitada por el SoR.
  3. Modifique el valor de Tamaño máximo de archivo en MB si es necesario. De forma predeterminada, es 5. Este valor aparece junto al Límite de tamaño total en el marco de colocación de Citrix Workspace. El tamaño de archivo está limitado por el SoR. Para evitar un desperdicio de recursos, recomendamos configurar el tamaño máximo de archivo conforme a lo que realmente se necesite.
  4. Introduzca un valor para Extensiones de archivo (por ejemplo, JPEG, PNG, PDF). No se requiere ningún valor. Este valor aparece junto a Formatos de archivo aceptados bajo el marco de colocación de Citrix Workspace. Este campo no distingue entre mayúsculas y minúsculas ni acepta caracteres especiales.
  5. Active la opción Obligatorio si es necesario agregar un archivo para enviar esta página. La etiqueta Este campo es obligatoria se muestra encima del marco de colocación en Citrix Workspace.
  6. Inhabilite el conmutador Habilitado si quiere que el marco de colocación aparezca atenuado y no disponible en Citrix Workspace.
  7. Inhabilite el conmutador Visible si quiere ocultar el marco de colocación en Citrix Workspace.

Consideraciones

Los usuarios deben tener en cuenta las siguientes limitaciones al cargar contenido:

  • El nombre de archivo debe terminar con uno de los sufijos permitidos. Se permiten todos los caracteres excepto el byte nulo \0.
  • El servicio de microaplicaciones no proporciona almacenamiento de archivos. Los archivos se cargan directamente en el SoR. Durante el proceso de carga, el servicio de microaplicaciones transfiere primero el archivo desde el equipo de un usuario para proteger el almacenamiento temporal y, a continuación, lo transmite inmediatamente al SoR. Los archivos procesados en el almacenamiento temporal no son accesibles a partir de ese momento para ningún fin ni para nadie y se eliminan después de un breve período de tiempo.
  • Los usuarios pueden quitar un archivo que han seleccionado y precargado antes de confirmar la carga.
  • El explorador detecta el tipo de archivo (tipo MIME) en función de la extensión del archivo. El servicio de microaplicaciones no utiliza el tipo de archivo para ninguna comprobación.

Componentes de presentación

La sección Presentación proporciona los componentes necesarios para mostrar la información a los usuarios finales de las microaplicaciones, incluidas tablas, texto estático e imágenes, etc. Siempre que pueda seleccionar el correo electrónico del usuario como variable para extraer datos al crear una página de acciones, puede utilizar un atributo de nombre principal de usuario (UPN) de Active Directory. Aquí se incluyen filtros de página y componente, restricciones y parámetros de acciones de servicio.

Vista detallada de los componentes de presentación

Tabla

Agrega una tabla para mostrar una lista de registros definiendo el origen de la tabla, los filtros y las columnas. Se pueden agregar acciones de enlace a páginas que dirigen al usuario a otra página. La alineación se puede modificar.

Se habilita una ficha Columnas en el panel derecho después de seleccionar este componente. Agregue tantas columnas como sea necesario con estos parámetros: Título de columna, Tipo de datos, Tabla de datos, Columna de datos, Formato y Formato condicional. Para ver una explicación de estos campos, consulte Propiedades de componente.

Se deben configurar consultas personalizadas para limitar la exposición de los datos. Una tabla sin consulta personalizada muestra todos los registros que coinciden con un filtro de tabla, independientemente de la relación de los datos con los suscriptores. Sus datos confidenciales pueden estar expuestos a todos los usuarios de microaplicaciones, a menos que limite la exposición. Para controlar el acceso a los datos de las páginas, utilice la función Filtro de datos. Seleccione la tabla en el panel del generador de componentes. Seleccione Propiedades de tabla y, a continuación, Filtro de datos. Seleccione +Agregar condición y agregue las restricciones necesarias. Para ver un ejemplo de este componente en uso, consulte Generar una página de detalles.

Lista/Cuadrícula

Muestra una lista de datos a los usuarios de Citrix Workspace. Seleccione uno de los diseños preconfigurados para presentar la información correcta de la manera que mejor se adapte a sus datos. Puede definir los elementos de la lista manualmente o extraerlos de la caché.

En la ficha Propiedades de lista, seleccione:

  • Tabla de datos para extraer datos de la caché. Están disponibles las fichas Origen de datos de lista, Origen de datos de elementos de lista y Diseño y estilo. Las descripciones de las propiedades de Origen de datos de lista y Origen de datos de elementos de lista están disponibles en Propiedades de componente.
  • Especificar manualmente para definir los elementos de la lista. Están disponibles las fichas Elementos de lista y Diseño y estilo. En Elementos de lista, defina los elementos que quiere incluir en la lista. Las descripciones de las propiedades están disponibles en Propiedades de componente.

La ficha Diseño y estilo está disponible para ambos tipos de propiedades de lista. El menú Diseño proporciona una selección de diseños preconfigurados. Elija el diseño que mejor se adapte a sus necesidades entre las siguientes opciones:

  • Lista - acordeón: Muestra unidades de contenido de solo texto expandibles.
  • Lista - básica: Muestra listas de solo texto.
  • Lista - con viñetas: Muestra listas de solo texto sin ordenar y con viñetas.
  • Lista - ordenada: Muestra listas de solo texto ordenadas y numeradas.
  • Lista - miniatura: Muestra listas con miniaturas y estilos.
  • Cuadrícula - imagen principal en el lado de la tarjeta: Muestra tarjetas con una imagen grande en el lateral.
  • Cuadrícula - imagen principal en la parte superior de la tarjeta: Muestra tarjetas con una imagen grande en la parte superior.
  • Cuadrícula - imagen: Muestra unidades de imagen multicolumna.
  • Cuadrícula - miniatura lado: Muestra listas multicolumna con miniaturas.
  • Cuadrícula - miniatura parte superior: Muestra unidades de contenido alineadas en el centro.

Los diseños de solo texto le permiten cambiar entre Mostrar título y Mostrar descripción. Puede inhabilitar una de estas opciones, pero no ambas. Los diseños con miniaturas abren un conmutador Mostrar imagen y otras opciones de formato para las imágenes. Hay otras descripciones de las propiedades disponibles en Propiedades de componente.

Text

Define el origen del texto procedente de tablas y el formato para carga en la página. Origen de datos, Tabla y Columna se seleccionan para rellenar con texto. Se puede dar un formato de texto como hora, fecha, etc., o bien uno condicional basado en parámetros. Puede agregar acciones para ir a una página, URL, enviar correo electrónico o llamar por teléfono. Para ver un ejemplo de este componente en uso, consulte Generar una página de detalles.

El componente Texto está diseñado para mostrar un solo valor de base de datos. Se ejecuta un control de integridad y se alerta a los usuarios si una página depende de un ID de registro. Para la página de detalle o de tipo formulario que se establece como página de acción, se requiere un filtro de datos de página para llamar a un registro único. Se muestra el mensaje para advertirle de este problema. Su microaplicación puede funcionar tal cual, pero el componente puede mostrar datos incorrectos si el registro único no se transfiere a la página.

Texto estático

Define texto estático que aparecerá en la página. Se pueden agregar acciones. La alineación se puede modificar. Puede hacer una distinción si el texto es un encabezado. Están disponibles los estilos de fuente negrita y cursiva. El tamaño de fuente se puede cambiar de Normal, Delgada, Pequeña y Pequeña y delgada. Puede agregar acciones para ir a una página, URL, enviar correo electrónico o llamar por teléfono. Para ver un ejemplo de este componente en uso, consulte Generar una página de creación y Generar una página de detalles.

Imagen estática

Hace referencia a una imagen estática de una fuente URL predefinida y la muestra. Se pueden especificar el tamaño y la alineación de las imágenes. No se pueden agregar acciones.

Imagen

Muestra una imagen mediante su URL almacenada en caché (columna y tabla de datos) y el formato que mostrar en la página. Agregue texto que se mostrará si la imagen no puede cargarse. Se puede configurar el formato de imagen, como la alineación, el tamaño y la forma.

Separador de líneas

El separador sirve para separar la información no relacionada y la información relacionada con el grupo. No se pueden modificar las propiedades.

Botón Atrás

Permite a los usuarios volver a la página anterior. Puede especificarse una variable, es decir, tabla de datos, columna de datos y formato. Para ver un ejemplo de este componente en uso, consulte Generar una página de detalles.

Power BI

Muestra un informe de inteligencia empresarial en Workspace. Defina el origen y el formato. Cuando se muestra a un usuario este componente de Power BI en Citrix Workspace, se le indica en primer lugar que inicie sesión en Power BI.

Después de seleccionar este componente, se habilita una ficha de propiedades de componente de Power BI en el panel derecho. Cuando se agrega este componente por primera vez, no se seleccionan acciones de servicio ni se puede modificar el componente. Deberá configurar acciones de servicio para la autorización del usuario. Después de configurar las acciones de servicio, configure la autorización en el componente. Para ver todos los pasos, consulte Configurar acciones de servicio con componentes de Power BI.

Visor de recibos de Concur

Muestra una imagen de un recibo. Defina el origen con la tabla de datos, columna de datos y formato. El componente Visor de recibos de Concur solo aparece en la plantilla de integración de Concur.

Tableau

Muestra un informe de Tableau. Defina el origen con la tabla de datos y la columna.

Contenido HTML

Muestra correctamente contenido HTML de fuentes extraídas (por ejemplo, fuentes RSS). Defina el origen con la tabla de datos y la columna. Se admiten elementos de texto básicos. Los elementos permitidos son:

  • “p”, “div”, “h1”, “h2”, “h3”, “h4”, “h5”, “h6”, “ul”, “ol”, “li”, “blockquote”, “b”, “i”, “font”, “s”, “u”, “o”, “sup”, “sub”, “ins”, “del”, “strong”, “strike”, “tt”, “code”, “big”, “small”, “br”, “span” y “em”.
  • El elemento “a” solo con los atributos “target” y “href”.
  • El elemento “img” solo con los atributos “height”, “width” y “src”.
  • Además, el atributo “style” está permitido con cualquier elemento.

Datos adjuntos

Enumera los archivos adjuntos del origen de datos y permite a los usuarios finales descargar archivos adjuntos. Las imágenes y PDF se pueden previsualizar directamente. Defina el origen especificando la tabla de datos, la columna de datos para la dirección URL y la columna de datos para el nombre.

  • Si el tipo MIME (tipo de medio) de los datos no está configurado, se muestra ? como icono de vista previa de los datos adjuntos.
  • Si el tamaño del archivo no está configurado, la vista previa de datos adjuntos muestra un tamaño de 0B.

Seleccione la opción Seguridad de URL de datos adjuntos:

  • Heredado: Los datos adjuntos deben estar alojados en el mismo dominio al que accede la integración. De lo contrario, el archivo adjunto no se muestra y no se puede descargar. Por ejemplo, se trata de un problema conocido con las integraciones de Google.
  • Público: Los datos adjuntos públicos de otros dominios pueden mostrarse si no requieren un método de autenticación.

Insertar

Permite insertar páginas web en las microaplicaciones con el generador y mostrarlas, a continuación, en Citrix Workspace. El contenido admitido incluye: Vídeos públicos de YouTube, mapas de Google, formularios de Podio/Google/Microsoft, la mayoría de las páginas web públicas receptivas y cualquier contenido diseñado por su proveedor para integrarse en un sitio web y mostrarlo en un iframe.

Algunos contenidos externos no están diseñados para inserción o está estrictamente prohibida. Por ejemplo

  • Páginas web que prohíben explícitamente la incrustación enviando el encabezado X-Frame-Options "SAMEORIGIN";. Un ejemplo notable es https://google.com.
  • Páginas web que se redirigen a un dominio distinto del especificado en la configuración de componentes del generador de páginas.
  • Las páginas web que requieren autenticación pueden tener problemas cuando se incrustan. Los administradores hacer pruebas detalladas.
  • Las páginas web que contienen el consentimiento para las cookies (por ejemplo, por requisitos del RGPD) no tienen las selecciones almacenadas en caché en el componente incrustado. Si un usuario accede de nuevo al sitio incrustado, debe volver a confirmar el consentimiento para las cookies cada vez, a menos que el sitio utilice los atributos SameSite: none; secure=true de cookies.

Configurar el componente de inserción

Después de soltar el componente de inserción en el generador, complete las Propiedades de inserción.

Nota

Para insertar contenido correctamente de algunos sitios web, debe utilizar el código de incrustación generado directamente en el sitio web (en lugar de una URL directa o un enlace compartido). Por ejemplo, al generar un enlace incrustado en Google Maps mediante la opción Compartir, usa el enlace generado desde Insertar un mapa en lugar de Enviar un enlace.

  1. Introduzca la URL del contenido que quiere insertar.

  2. Seleccione una de las opciones del Modo de altura para elegir cómo se determina el tamaño del contenido insertado.

    • Multiplicador de ancho: Habilita un campo Multiplicador (en porcentaje). Introduzca un valor porcentual en relación con el ancho del contenido incrustado. Por ejemplo, si escribe 50, el contenido mostrado tiene la mitad de la altura de su ancho.
    • Fijo: Habilita un campo Altura absoluta (en píxeles). Introduzca una cantidad de píxeles para determinar la altura del contenido incrustado.

Las vistas previas de contenido incrustado no están disponibles en el generador. Selecciona Vista previa de microaplicación para ver el aspecto del contenido incrustado.

Componente de inserción

Consideraciones

Tenga en cuenta lo siguiente al insertar contenido:

  • Utilice versiones integrables de páginas web siempre que sea posible. Estas páginas ya han sido optimizadas para incrustación por parte del proveedor de contenido. Por ejemplo, se puede acceder a un vídeo de YouTube con ID XXX en https://www.youtube.com/watch?v=XXX y https://www.youtube.com/embed/XXX. La primera URL conduce al sitio completo y la segunda al vídeo incrustable.
  • Al especificar una URL, puede utilizar variables de plantilla para transmitir un parámetro a la URL remota. Para el mismo ejemplo de YouTube, y suponiendo que tiene una tabla de datos denominada video_id que contiene ID de vídeo, introduzca https://www.youtube.com/embed/{video_id} en el campo URL. La cadena {video_id} se sustituirá por el valor de fila de la tabla.
  • La página incrustada se muestra en un iframe aislado con los siguientes atributos: allow-scripts allow-same-origin allow-popups allow-popups-to-escape-sandbox allow-forms allow-pointer-lock allow-downloads. Estos indicadores garantizan el aislamiento completo del contenido de terceros de Citrix Workspace, pero pueden provocar que se dañe alguna funcionalidad de la página remota.
  • El componente de inserción no puede mostrar documentos que requieren plug-ins de explorador personalizados. Por este motivo, los archivos PDF no se pueden mostrar dentro del componente de inserción.

Componente de diseño

Proporciona el componente de cuadrícula para configurar el diseño de la página.

Vista detallada de los componentes de diseño

  • Cuadrícula flexible: Le ofrece un mayor control sobre el posicionamiento de los componentes en las páginas, ya que posibilita un “encaje” más fácil de los mismos. Esta opción es útil al diseñar páginas destinadas a dispositivos con pantallas más grandes.

    Después de seleccionar este componente, se abre una ficha de propiedades de cuadrícula flexible en el panel derecho. Establezca el número de columnas y filas que incluir en la cuadrícula y personalice la alineación. Para ver un ejemplo de este componente en uso, consulte Generar una página de creación y Generar una página de detalles.

Detalles de página

Configure la página que está creando. Para ello, introduzca el nombre, establezca filtros de información y agregue lógica a los componentes de página. Además, puede usar las funciones de depuración de datos.

  • Nombre de página: Establece el nombre de la página.
  • Filtro de datos: Sirve para establecer restricciones en los datos de acción.
  • Mostrar SQL: Sirve para mostrar el código SQL con fines de depuración.
  • Lógica: Sirve para agregar la lógica del componente y mostrarla. Encontrará detalles de Agregar lógica en la siguiente sección.

Agregar lógica

Seleccione el botón Agregar lógica en la ficha Detalles de la página para abrir la configuración lógica. Esto le permite configurar la lógica para el componente de página en particular. Especifique el comportamiento o la apariencia de los componentes de esta página. Utilice argumentos lógicos estándar para crear condiciones y lograr diferentes resultados, en función del comportamiento del componente. Puede agregar varias acciones apiladas a cualquier botón para crear efectos de acción múltiples con un solo clic. Cuando cada acción de servicio se ejecuta correctamente, el sistema se desplaza en la cadena de acciones hasta completar todas. Entre las acciones disponibles se incluyen:

  • Evaluar condición: Establece y modifica una condición a través de un argumento lógico.
  • Establecer valor de componente: Establece el valor de componente del botón para confirmar una acción.
  • Mostrar componente: Configura las condiciones para mostrar el componente.
  • Ocultar componente: Configura las condiciones para ocultar el componente.
  • Habilitar componente: Configura las condiciones para habilitar el componente.
  • Inhabilitar componente: Configura las condiciones para inhabilitar el componente.
  • Definir componente como requerido: Configura las condiciones para requerir el componente.
  • Definir componente como no requerido: Configura las condiciones para excluir el componente.

Propiedades de componente

Cada componente del generador de páginas tiene su propio menú de propiedades específicas con varias opciones entre las que elegir, dependiendo del componente, lo que incluye:

  • Etiqueta: Personaliza la etiqueta del botón, texto, imagen, etc.
  • Texto de marcador de posición: Explica al usuario cómo utilizar este componente. Por ejemplo, enumerar los atributos con los que un usuario puede buscar.
  • Contenido: Texto estático que se muestra al usuario final.
  • Alineación: Define la alineación del texto o la imagen mostrados.
  • Tipo de texto: Establece el tamaño del texto mostrado.
  • Estilo de fuente: Establece el estilo de fuente del texto mostrado.
  • Tamaño de fuente: Establece el tamaño de fuente del texto mostrado.
  • Ancho del campo: Define la anchura de un componente mostrado.
  • Formato: Define el formato de los datos que se muestran a los usuarios. Por ejemplo, fecha, hora, decimal, porcentaje, etc.
  • Valor predeterminado: Se utiliza para establecer el valor predeterminado de los componentes de entrada manualmente o mediante variables.
  • Estilo: Se utiliza para cambiar entre diferentes colores y formatos predefinidos con el componente Botón.
  • Usar registros relacionados con la página: Se utiliza para filtrar registros relacionados con el registro mostrado en la página con el componente Tabla. Por ejemplo, tiene una página en la que se muestran datos sobre una cuenta y quiere mostrar la tabla con una lista de contactos relacionados con esta cuenta en particular.
  • Asignar al valor de un registro: Conmutador para mostrar datos de un registro concreto de la caché para los componentes de entrada. Por ejemplo, habilite este conmutador cuando cree una página de tipo “Modificar” porque quiere mostrar a los usuarios finales datos reales antes de que estos valores cambien. Por otro lado, si va a crear una página de tipo “Crear registro”, no habilite “Asignar al valor de un registro”, ya que esta página no está vinculada a ningún registro existente. Por lo tanto, no tiene sentido asignar los componentes de entrada a ningún registro.

  • Seleccionar tipo: Selecciona el origen de las opciones para el componente Seleccionar y el componente Radio.

    • Si se selecciona Introducir valores manualmente, se deben completar los parámetros Valor y Etiqueta. Valor se usa en la acción de servicio y Etiqueta es lo que ve el usuario final en Citrix Workspace.
    • Si se elige Seleccionar de base de datos, se deben completar estos campos: Origen de datos para opciones, Tabla de datos para opciones, Columna de datos para etiqueta de opción y Columna de datos para el valor de la opción. “Columna de datos para el valor de la opción” se usa en la acción de servicio y “Columna de datos para etiqueta de opción” es lo que el usuario final ve en Citrix Workspace.
    • Se puede usar una combinación de Seleccionar tipo y Asignar al valor de un registro para diferentes casos de uso. Por ejemplo, Seleccionar de base de datos junto con Asignar al valor de un registro habilitado suele utilizarse para las páginas de tipo Modificar. En este caso, Tabla de datos y Columna de datos sirven para mostrar los datos actuales, Origen de datos para opciones, Tabla de datos para opciones, Columna de datos para etiqueta de opción y Columna de datos para el valor de la opción sirven para mostrar todas las demás opciones disponibles de la caché que el usuario final puede usar al modificar un registro.

  • Origen de datos: Selecciona el origen de datos del elemento mostrado.

    • Use Valor de la columna si quiere mostrar una columna en particular de la caché.
    • Use Plantilla si quiere mostrar una cadena de distintos atributos de la caché. Por ejemplo, la dirección de cuenta se divide en la caché en 3 columnas, pero quiere mostrarlas todas juntas en un componente.
  • Tabla de datos: Selecciona la tabla de datos del elemento mostrado.
  • Columna de datos: Selecciona la columna de datos del elemento mostrado.
  • Formato condicional: Configura el formato condicional para el elemento.
  • Insertar variables: Agrega variables al elemento de página para mostrar automáticamente los datos de integración de aplicaciones.
  • Filtro de datos: Establece las restricciones de los datos mostrados. Seleccione Establecer filtro > Agregar y, a continuación, agregue las restricciones de condición necesarias.
  • Orden de datos/Orden: Establece el orden de los datos mostrados. Seleccione Establecer orden > Agregar regla y, a continuación, las restricciones de regla necesarias.
  • Conmutador Mostrar columna de datos adicional: Se utiliza con el componente de búsqueda para definir una columna adicional que se mostrará a los usuarios mientras realizan una búsqueda.

  • Estrategia de coincidencia de términos de búsqueda: Se utiliza con el componente Búsqueda para definir la estrategia de búsqueda.

    • Comienza con: Este método de búsqueda es el más rápido, ya que no sobrecarga la caché. Analiza los primeros caracteres de los valores en el atributo de caché definido. Este método de búsqueda es satisfactorio para la mayoría de los casos de uso.
    • Contiene: Dependiendo del tamaño de la recopilación de datos, este método de búsqueda puede ser muy lento. Analiza todos los caracteres de los valores en el atributo de caché definido.
  • Ancho del campo: Se utiliza con Componentes de entrada para definir el ancho del campo de entrada.
  • Conmutador Obligatorio: Se utiliza con Componentes de entrada para que se pida al usuario final que introduzca datos antes de que el botón con la acción de servicio configurada sea accionable.
  • Conmutador Habilitado: Se utiliza con Componentes de entrada para mostrar datos de un registro en particular que no quiere que los usuarios finales puedan cambiar.
  • Conmutador Visible: Se utiliza en caso de que necesite datos adicionales para Lógica de página, Ir a la página, etc., pero no quiere que esta información se muestre al usuario final.
  • Ocultar si está vacío: Se utiliza con algunos Componentes de presentación cuando no quiere mostrar un componente al usuario final si no hay datos disponibles.
  • Atributo Alt/Texto alternativo: Se utiliza con el componente Imagen. Introduzca el texto que se mostrará si hay algún problema al mostrar la imagen.
  • Prefijo de URL: Se utiliza con el componente Imagen para configurar el prefijo estático de una URL mientras que el resto de la URL se extrae de los campos Tabla de datos y Columna de datos.
  • Tamaño de imagen: El tamaño de la imagen mostrada. Por ejemplo, Miniatura o Ancho completo.
  • Forma de la imagen: La forma de la imagen. Por ejemplo, Círculo o Esquinas redondeadas.
  • Diseño: Diseños preconfigurados para el componente de lista.

Reglas de validación de entrada

Agregue reglas para algunos componentes de entrada si quiere restringir el formato de los datos que el usuario puede introducir. Cada componente tiene disponibles sus propias reglas de validación específicas. Siempre hay una opción mínima y máxima que definir.

Esta ficha está disponible para los siguiente componentes: Entrada de texto, Fecha/Hora, Área de texto y Entrada núm. Consulte la descripción de cada componente para obtener información más detallada.

Acciones

El menú de acciones está disponible para el componente Botón para permitir que los destinatarios de la microaplicación (usuarios de Workspace) respondan con una entrada procesable. Hay diferentes acciones para los distintos componentes.

Habilitar Botón de acción de página

Habilite el conmutador Botón de acción de página para mostrar el componente “botón” en el pie de página de la hoja en Citrix Workspace. Hay disponible un subconjunto diferente de acciones para el componente Botón en función de este conmutador. Se deben tener en cuenta las siguientes cuestiones:

  • Si el botón se muestra en el pie de página de la hoja, la hoja se cierra automáticamente cuando el usuario selecciona el botón del pie de página en Citrix Workspace.
  • Si quiere agregar acciones, como Ir a la página o Ir a URL, no conviene mostrar botones en el pie de página de la hoja, de manera que Citrix Workspace pueda llevar a los usuarios finales a la siguiente pantalla. Estas acciones no están disponibles si habilita este conmutador.

Agregar acción

Define la acción que el botón ejecuta a partir de las acciones configuradas en la integración. Entre las acciones se incluyen:

Agregar una acción Ir a la página

Defina una acción para enviar a los usuarios a una página preconfigurada de la microaplicación.

  1. Después de agregar un componente Botón al generador y asignarle un nombrar en la ficha Propiedades del botón, seleccione la ficha Acciones.
  2. Inhabilite la opción Botón de acción de página. En el campo Agregar acción, seleccione Ir a la página.
  3. Seleccione Ir a la página en Acciones. Se abrirán el campo Etiqueta de acción, el selector Aplicación y el selector Página.
  4. En Aplicación, seleccione la microaplicación de la que quiere elegir la página.
  5. En Página, seleccione la página que quiere que abra el botón.
  6. (Opcional) En Registro de la página de destino, seleccione Establecer condiciones si quiere filtrar datos en la página configurada. Por ejemplo, un usuario está viendo una página con datos de una cuenta. El usuario selecciona un botón llamado Oportunidades y, en función de las condiciones del registro de la página de destino, se le envía a una página con una lista de todas las oportunidades asociadas que tienen un valor previsto superior a un valor determinado.
  7. (Opcional) En Rellenar página de destino, seleccione Modificar campos si quiere prerrellenar los campos de la página de destino. Por ejemplo, un usuario está viendo un tíquet de Jira y quiere crear uno nuevo en el mismo proyecto. El usuario selecciona un botón denominado Nuevo que le lleva hasta la página donde el campo Proyecto se prerrellena con el valor de la página anterior, pero todos los demás atributos deben introducirse manualmente.

Agregar una acción Ejecutar desencadenante de notificaciones

Defina una acción para desencadenar una notificación a fin de ejecutar una evaluación de los eventos de notificación y enviar mensajes de notificación al público objetivo. Esta acción se puede mostrar en el cuerpo de la página o en el pie de página del blade.

  1. Después de agregar un componente Botón al generador y asignarle un nombrar en la ficha Propiedades del botón, seleccione la ficha Acciones.
  2. Deje habilitada la opción Botón de acción de página para mostrar el botón en el pie de la página. Inhabilite la opción para mostrar el botón en el cuerpo de la página.
  3. En el campo Agregar acción, seleccione Ejecutar desencadenante de notificaciones.
  4. Seleccione Ejecutar desencadenante de notificaciones en Acciones.
  5. En Eventos, seleccione el desencadenante de eventos que quiera ejecutar. Puede seleccionar más de un evento para este botón.

Usar valores de componentes como parámetros

Puede utilizar valores de componentes como parámetros en las acciones Enviar correo electrónico e Ir a la URL. Esta funcionalidad permite:

  • (Enviar correo electrónico) Los usuarios de Workspace pueden introducir destinatarios de correo electrónico en un campo de Workspace para una acción determinada.
  • (Ir a la URL) La entrada del usuario desde un formulario de Workspace se puede utilizar como parte de una plantilla de URL abierta en Workspace.

Siga los pasos que se indican a continuación, conforme a su caso de uso.

Agregar una acción Enviar correo electrónico

  1. Después de agregar un componente Botón al generador y asignarle un nombrar en Propiedades del botón, seleccione la ficha Acciones.
  2. Inhabilite la opción Botón de acción de página. En el campo Agregar acción, seleccione Enviar correo electrónico.

  3. En A, seleccione INSERTAR VARIABLE.

    Pasos de acción de página

  4. En la pantalla Insertar variable, en el menú Tipo, seleccione Valor de componente.
  5. En Componente, seleccione el componente de entrada que un usuario deberá introducir en el formulario de Workspace. El campo A se rellena con el ID del componente.
  6. Agregue un Asunto y un Cuerpo para el mensaje, según corresponda. En Workspace, los usuarios pueden introducir una dirección de correo electrónico en el campo habilitado por este componente. Cuando envían la dirección de correo electrónico, su programa de correo electrónico se abre con un mensaje rellenado previamente que se puede modificar si es necesario y enviar.

Agregar una acción Ir a la URL

  1. Después de agregar un componente Botón al generador y asignarle un nombrar en Propiedades del botón, seleccione la ficha Acciones.
  2. Deje el Botón de acción de página habilitado. En el campo Agregar acción, seleccione Ir a la URL.
  3. En el campo Plantilla de URL, escriba la dirección URL del sitio de destino que quiere abrir.
  4. En el campo Plantilla de URL, seleccione INSERTAR VARIABLE
  5. En la pantalla Insertar variable, en el menú Tipo, seleccione Valor de componente.
  6. En Componente, seleccione el componente necesario. El campo Plantilla de URL se rellena con el ID de componente agregado a la dirección URL especificada. En Workspace, los usuarios pueden introducir un valor en el campo habilitado por este componente. Cuando envían la consulta, el valor del componente seleccionado se utiliza como variable en la dirección URL que se abre en su explorador web.

Nota:

Seleccione el icono de información situado junto a los campos de plantilla para ver una anotación detallada sobre los componentes usados.

Configurar acciones de servicio con componentes de Power BI

Las microaplicaciones de uso inmediato incluidas con la plantilla de Power BI tienen los componentes configurados de la forma necesaria. Si quiere realizar cambios o agregar otras microaplicaciones, siga estos pasos como modelo. Entre las consideraciones importantes, figuran las siguientes:

La configuración del componente de Power BI es necesaria para autorizar al usuario que ha iniciado sesión antes de que pueda ver un panel de mandos, informe o mosaico. Para hacer esto, debe configurar una acción de servicio para generar un token para el usuario. Esta configuración es necesaria para paneles de mandos, informes y mosaicos. La autorización funciona como una acción de servicio estándar. Por ejemplo, si tiene un método de autenticación OAuth 2.0 aparte para la configuración de acciones de servicio, se le pide al usuario que inicie sesión en Power BI y solo entonces el componente mostrará el contenido deseado.

  1. En la pantalla Modificar de una integración, o en el menú, seleccione Acciones de servicio en la columna de navegación izquierda.

  2. Configure estas nuevas acciones de servicio como sea necesario mediante estos dispositivos de punto final de Power BI:

    • Paneles https://docs.microsoft.com/en-us/rest/api/power-bi/embedtoken/dashboards_generatetokeningroup
    • Informes https://docs.microsoft.com/en-us/rest/api/power-bi/embedtoken/reports_generatetokeningroup
    • Mosaicos https://docs.microsoft.com/en-us/rest/api/power-bi/embedtoken/tiles_generatetokeningroup

  3. Seleccione Agregar acción de servicio. Esta acción necesita los parámetros groupId y dashboardId, reportId y tileId. Utilice el siguiente modelo como ejemplo:

  4. En Ejecución de la acción, seleccione la ficha CUERPO. En la lista Tipo de contenido, seleccione JSON.

    { “accessLevel”: “View” }

    Ahora configure la autorización en el componente mediante esta acción de servicio recién configurada. Siga el ejemplo general que aparece a continuación:

  5. En la microaplicación, por ejemplo, una microaplicación en la que esté extrayendo datos para paneles, seleccione cualquier página en la que tenga el componente de Power BI.
  6. Seleccione el componente de Power BI y, a continuación, la ficha Autorización de Power BI en el lado derecho.

  7. Seleccione Modificar parámetros y complete los campos como se muestra a continuación:

  8. Seleccione Guardar para finalizar.
Generador de páginas
November 17, 2021
Contribución de: 
C
November 17, 2021
Contribución de: 
C

En este artículo

Comentarios sobre el sitio | Condiciones legales y de privacidad | Preferencias de cookies | Parámetros de consentimiento
© 1999- Cloud Software Group, Inc. All rights reserved.