Página de interfaz unificada (control hospedado)
Utilice el tipo de control hospedado de página de Interfaz unificada para cargar una dirección URL o una página de aplicaciones de Interfaz unificada en aplicaciones basadas en modelo. Si se carga una página de aplicación basada en modelo en un control hospedado de este tipo, busca automáticamente en la página datos de la entidad, y rellena automáticamente los parámetros de sustitución.
Este tipo de control hospedado expone varias acciones predefinidas de UII y eventos que son únicos para el manejo de aplicación basadas en modelo de Windows, incluidas acciones de manipulación de lista y una acción de búsqueda para mostrar una búsqueda rápida o una página de búsqueda avanzada.
Crear un control hospedado Página de interfaz unificada
Mientras crea un nuevo control hospedado, los campos de la pantalla Nuevo control hospedado variarán en función del tipo de control hospedado que se quiera crear. En esta sección se proporciona información sobre los campos específicos que son únicos al tipo de control hospedado Página de interfaz unificada.
En la pantalla Nuevo control hospedado:
En el área Unified Service Desk, seleccione Página de la interfaz unificada en la lista desplegable Tipo de componente de Unified Service Desk.
Seleccione Datos Pre-fetch para cargar la información relacionada con un registro de entidad en el contexto junto con la página del registro de entidad sin tener que esperar a que la página web completa de la entidad se cargue en la aplicación cliente. La información de la entidad buscada se rellena en el contexto de Unified Service Desk, permitiendo así que cualquier control hospedado muestre con rapidez la información relevante de la entidad en la aplicación cliente. Esto puede ayudar a los agentes a actuar o iniciar conversaciones con los clientes de inmediato, con lo que se ahorra un tiempo de interacción esencial.
En la lista desplegable Permitir varias páginas, seleccione No (valor predeterminado) para reemplazar la página de aplicación basada en modelo que aparece actualmente, y actualice el historial del explorador cuando Unified Service Desk recibe una llamada de acción de navegación o una página está enrutada a la pestaña. Seleccione Sí para crear automáticamente una lista desplegable cuando llamen a una segunda dirección URL o una regla de navegación de la ventana dirija una página a la pestaña. Esto permite al usuario buscar rápidamente entre las páginas de aplicaciones basadas en modelo que se adjuntan a este control. Además, cuando se selecciona Sí está disponible un campo adicional, Exploradores máximos, donde puede especificar el número máximo de páginas que se mostrarán en la lista desplegable.
En el área Propiedades comunes, active la casilla La aplicación es global para establecer el control hospedado como global. Los controles hospedados globales pueden mostrarse fuera de una sesión del cliente. Los controles como panel, muro o búsqueda de los agentes son usos comunes para controles hospedados globales. Los controles hospedados globales no tienen estado específico de la sesión, por lo que cuando cambia sesiones, permanecen estos mismos controles hospedados globales. Si esta casilla no está seleccionada, el control hospedado pasa a estar basado en la sesión. Los controles basados en la sesión existen en el contexto de la sesión del cliente. Si el usuario cambia a otra sesión, todas las páginas de la sesión anterior se ocultarán.
En el campo Mostrar grupo se muestra el panel donde aparecerá este control hospedado. MainPanel es la elección más común para este tipo de control hospedado.
Más información: Crear o editar un control hospedado
Acciones de UII predefinidas
Las siguientes son las acciones predefinidas para este tipo de control hospedado.
AssociatedView
Esta acción carga una vista asociada específica. Se suele acceder a estas vistas expandiendo el nombre del registro de entidad en la barra de navegación y seleccionando las entidades asociadas.
| Parámetro | Descripción |
|---|---|
| etn | El nombre de la entidad para la que desea cargar la lista de registros de la entidad asociada. Este parámetro es obligatorio. |
| Id. | El identificador del registro de entidad principal para el que se mostrarán los registros de entidad asociados. |
| navItemId | El Id. del elemento de navegación correspondiente a la entidad asociada. Más información: formContext.ui.navigation |
| hideCommandBar | Si este parámetro se suministra y es False, la página se mostrará junto con la barra de comandos de aplicaciones basadas en modelo. |
| hideNavigationBar | Si este parámetro se suministra y es False, la página se mostrará junto con la barra de navegación de aplicaciones basadas en modelo. |
Cerrar
Esta acción sirve para cerrar el control hospedado. A diferencia de la acción CloseActive, si esta pestaña (control hospedado) muestra más de una página, esta acción cerrará todas las páginas que aparecen en la pestaña de la aplicación del agente.
CloseActive
Esta acción sirve para cerrar la ventana activa dentro de este control hospedado. Si la ventana activa es la única ventana mostrada en el control hospedado, el propio control hospedado se cerrará. Para el tipo de controles hospedados de página de Interfaz unificada que no permiten varias páginas (Permitir varias páginas = No), esta acción es equivalente a la acción Cerrar.
CloseAndPrompt
Esta acción cierra el control hospedado, pero pide que el usuario guarde o abandone sus cambios antes de cerrar.
Búsqueda
Navegue a la vista de lista de búsqueda rápida de la entidad especificada.
| Parámetro | Descripción |
|---|---|
| Ver descripción | El parámetro de datos debe especificar el nombre lógico de la entidad de la vista de lista de búsqueda rápida para mostrar. Existen algunos valores de casos especiales: - Use caso o incidente para mostrar la vista de lista de búsqueda rápida para casos. - Use actividades o actividad para mostrar la vista de lista de búsqueda rápida para actividades. |
| hideNavigationBar | Configure en Verdadero para ocultar la barra de navegación, de lo contrario en Falso. |
| hideCommandBar | Configure en Verdadero para ocultar la barra de comandos, de lo contrario en Falso. |
FireEvent
Desencadena un evento definido por el usuario desde este control hospedado.
| Parámetro | Descripción |
|---|---|
| nombre | Nombre del evento definido por el usuario. |
Todos los pares posteriores de nombre/valor se convierten en los parámetros del evento. Más información: Crear un evento definido por el usuario
GetSelectedIds
Esta acción sirve para recuperar los identificadores seleccionados de las listas.
| Parámetro | Descripción |
|---|---|
| Ver descripción | El parámetro de datos debe especificar el nombre de lista para capturar de allí los Id. seleccionados. |
El valor de devolución contiene una lista de identificadores delimitados por punto y coma que contienen los elementos seleccionados.
GetSelectedCount
Esta acción recupera el número de elementos que se han seleccionado. Use la acción GetSelectedIds para obtener la lista real de identificadores de la entidad.
| Parámetro | Descripción |
|---|---|
| Ver descripción | El parámetro de datos debe especificar el nombre de lista para recuperar de allí los Id. |
El valor de devolución tiene un número que representa la cantidad de elementos seleccionados.
GoHome
Esta acción va a la dirección URL inicial especificada para esta instancia del explorador.
GoBack
Esta acción es equivalente a seleccionar el botón atrás de la instancia del explorador.
GoForward
Esta acción es equivalente a seleccionar el botón adelante de la instancia del explorador.
MoveToPanel
Esta acción mueve un control hospedado Página de la inferfaz unificada a otro panel diferente en tiempo de ejecución.
| Parámetro | Descripción |
|---|---|
| Ver descripción | El parámetro de datos debe especificar el nombre del panel de destino al que mover el control hospedado (por ejemplo, FloatingPanel). |
Navegar
Esta acción sirve para navegar a una dirección URL de aplicación basada en modelo. El Id. de la aplicación para la aplicación que selecciona desde la ventana Seleccionar módulo de la aplicación se agrega automáticamente.
| Parámetro | Descripción |
|---|---|
| dirección url | La dirección URL a la que se navegará. Este parámetro es obligatorio. |
| HideCommandBar | Si este parámetro se suministra y es Verdadero, se mostrará el cuadro interno sin cargar la barra de comandos de aplicaciones basadas en modelo. |
| HideNavigationBar | Si este parámetro se suministra y es Verdadero, se mostrará el formulario sin cargar la barra de navegación de aplicaciones basadas en modelo. |
| Marco | Cuando hay cuadros en la página, este parámetro especifica el nombre del cuadro para explorar, en lugar de explorar la ventana principal. |
| postdata | Los datos que se envían al servidor como parte de una transacción HTTP POST. Se suele usar una transacción POST para enviar los datos recopilados por una página HTML. En Unified Service Desk, estos datos se pueden recibir de cualquier evento desencadenado mediante "`https://event/?`". Ejemplo: [[postdata]+] Como alternativa, los datos se pueden pasar como una cadena codificada con su tipo de encabezado en el formato deseado. |
| encabezado | Un valor de cadena que contiene encabezados HTTP adicionales para enviar al servidor. Cuando el parámetro de postdata se utiliza en la acción Navegar, también debe especificar un valor apropiado para el parámetro de encabezado, por ejemplo Content-Type:application/x-www-form-urlencoded Si un evento POST de Unified Service Desk desencadena la acción Navegar, el valor predeterminado de este parámetro debería ser header=[[header]+] Para agregar varios encabezados, el valor de este parámetro debería ser: header=$Multiline(encabezados separados por una nueva línea) Ejemplo: header=$Multiline(accessToken;dummyAccessToken==refreshToken;dummyRefreshToken===) |
New_CRM_Page
Crea una página para crear un nuevo registro de la entidad especificada, y trata la página comouna ventana emergente del control hospedado especificado. Las reglas de navegación de ventanas se evalúan para determinar la ubicación donde se muestra la página para crear el registro de la entidad.
| Parámetro | Descripción |
|---|---|
| LogicalName | El nombre lógico de la entidad para crear una nueva instancia. |
Nota
El resto de los parámetros debe estar compuesto de pares nombre/valor. Estos son los valores adicional que se rellenan previamente en el formulario para crear un nuevo registro de la entidad especificada.
Open_CRM_Page
Abre una instancia existente de la entidad especificada e identificada por el Id., y trata la página como si fuera una ventana emergente del control hospedado especificado. Las reglas de navegación de ventanas se evalúan para determinar la ubicación donde se debe mostrar la ventana emergente.
| Parámetro | Descripción |
|---|---|
| LogicalName | El nombre lógico de la entidad que se va a abrir. |
| id. | El identificador del registro de entidad que se va a abrir. |
Ventana emergente
"Emerge" una dirección URL del control hospedado y ejecuta las reglas de navegación de ventanas con ella para enrutar la ventana emergente a la ubicación correspondiente.
| Parámetro | Descripción |
|---|---|
| dirección URL | Enruta una ventana emergente desde este control hospedado utilizando esta dirección URL como si fuera una ventana emergente solicitada desde el control mostrado. |
| frame | El marco desde el que se originó esta ventana emergente. |
RealignWindow
Muestra el control hospedado en la ubicación especificada de un monitor. Puede mostrar controles hospedados hasta en dos monitores. Esta acción es aplicable a las instancias de control hospedado que están configuradas para colocarse en un tipo de panel USDFloatingPanel o USDFloatingToolPanel.
| Parámetro | Descripción |
|---|---|
| screen | Especifica la pantalla en la que se va a mostrar el control hospedado. Los valores válidos son 1 o 2. Si no especifica este parámetro, se pasa 1 de forma predeterminada. |
| left | Especifica la posición, en porcentaje, desde la izquierda de la pantalla en el monitor de destino donde se debe mostrar el control hospedado. Los valores válidos son de 0 a 100. Si no especifica este parámetro, se pasa 0 de forma predeterminada. |
| superior | Especifica la posición, en porcentaje, desde la parte superior de la pantalla en el monitor de destino donde se debe mostrar el control hospedado. Los valores válidos son de 0 a 100. Si no especifica este parámetro, se pasa 0 de forma predeterminada. |
| ancho | Especifica el ancho, en porcentaje, de la ventana del control hospedado en el monitor de destino. Los valores válidos son de 1 a 100. Si no especifica este parámetro, se pasa 100 de forma predeterminada. |
| height | Especifica el alto, en porcentaje, de la ventana del control hospedado en el monitor de destino. Los valores válidos son de 1 a 100. Si no especifica este parámetro, se pasa 100 de forma predeterminada. |
Actualizar
Esta acción actualiza la página actual.
RunScript
Esta acción inyecta JavaScript en el cuadro principal de la aplicación. Debería evitar usar llamadas de SDK de cliente de Microsoft Dataverse con esta acción; en su lugar, use la acción RunXrmCommand.
| Parámetro | Descripción |
|---|---|
| Ver descripción | El parámetro de datos es el JavaScript que se insertará en el formulario. Nota: los parámetros de sustitución se pueden usar en el script y se sustituirán antes de que se ejecute el script. |
| Marco | Cuando hay marcos en la página, este parámetro especifica el nombre del cuadro en el que inyectar el JavaScript. |
RunXrmCommand
Esta acción se utiliza para ejecutar el código JavaScript que usa aplicaciones basadas en modelo de Referencia de API de cliente en las Páginas de interfaz unificada (formularios y cuadrículas de la entidad).
Debe configurar el script como una función de aplicaciones basadas en modelo JavaScript webResource. El primer parámetro de la función es un parámetro de contexto (parámetro reservado) que puede tener uno de los siguientes valores:
- FormContext en páginas del formulario de entidad
- GridContext en páginas de cuadrícula de entidad
- sin definir en otras páginas
| Parámetro | Descripción |
|---|---|
| webResourceName | El nombre del recurso web en el que está presente la función de JavaScript que desea ejecutar. |
| functionName | El nombre de la función. |
Los demás parámetros de la función están definidos por el cliente y se pueden usar para transferir los parámetros de sustitución de Unified Service Desk en runtime. Esta acción acepta una lista de parámetros opcionales sin claves. La lista de parámetros opcionales se transfiere como argumentos en el mismo orden desde la segunda posición tras la sustitución del contexto en runtime.
Ejemplo
Puede que desee la acción RunXrmCommand para rellenar los atributos de formulario de un formulario de entidad, donde el formulario de entidad es hospedado por el tipo de página de Interfaz unificada de control hospedado. El valor que desea rellenar, desde la perspectiva de Unified Service Desk, es un parámetro de sustitución—[[$Context.Key1]].
Para ejecutar la acción, debe escribir el recurso web del tipo JavaScript (por ejemplo, webResource1) y escribir una función en el recurso web.
function fillAttributeValue(context, attrValue)
{
context.getAttribute(<attributeName>).setValue(attrValue);
}
Debe configurar los datos en la llamadas de acción de la siguiente manera:
webResourceName = webResource1
functionName = fillAttributeValue
'[[$Context.Key1]]'
Nota
En el ejemplo anterior, observe las comillas simples en torno al parámetro de sustitución, [[$Context.Key1]]. Unified Service Desk solo considera el valor del parámetro (no el tipo de datos) y transfiere todos los caracteres del contexto de valor sustituido a la función de JavaScript. Debe ser prudente y encargarse del tipo de datos durante la configuración.
SetSize
Esta acción establece explícitamente el ancho y el alto del control hospedado. Resulta especialmente útil cuando se usa "auto" en los diseños de panel.
| Parámetro | Descripción |
|---|---|
| ancho | El ancho del control hospedado. |
| alto | El alto del control hospedado. |
SaveAndClose
Esta acción guarda los datos "sucios" en el formulario de aplicaciones basadas en modelo y cierra el control hospedado.
SaveAll
Esta acción guarda todos los formularios en un control hospedado que permite mostrar varias páginas (Permitir varias páginas = Sí). Si el control hospedado solo permite mostrar una página (Permitir varias páginas = No), esto es equivalente a la acción Guardar.
Guardar
Esta acción guarda la Página de interfaz unificada actual.
Eventos predefinidos
Los eventos predefinidos siguientes están asociados con este tipo de control hospedado.
ActiveClosed
Se produce cuando el control hospedado activo se cierra utilizando la acción CloseActive.
| Parámetro | Descripción |
|---|---|
| dirección URL | La dirección URL que se mostraba en el control hospedado cuando se cerró. |
DataReady
Aparece en cuanto la información relacionada para el registro de la entidad esté cargada en Unified Service Desk el contexto. Este evento aparece antes del evento PageReadyFor. Si la opción Búsqueda previa de datos está seleccionada para la instancia del control, este evento ocurre en cuanto los datos de la entidad se busquen en una llamada paralela independiente del servidor y no esperará a que la página completa se termine de cargar. Los datos de la entidad están precargados y el evento DataReady se desencadenó también para la navegación en línea.
Nota
Para los paneles, los recursos web y las páginas de búsqueda, no se desencadena el evento DataReady.
RefreshRequested
Se produce cuando se solicita la actualización en la página actual. La actualización puede ser solicitada presionando la tecla F5 o cuando la aplicación llama a la acción Actualizar.
| Parámetro | Descripción |
|---|---|
| url | La dirección URL que aparece cuando se solicitó la actualización. |
Guardada
Aparece cuando se guarda un registro en la página de aplicaciones basadas en modelo.
| Parámetro | Descripción |
|---|---|
| newId | El identificador asignado al registro recién creado. |
NavigationRequested
Se produce cuando la navegación se realiza en las aplicaciones de Interfaz unificada.
| Parámetro | Descripción |
|---|---|
| dirección URL | La dirección URL de la página a la que navega. |
PageReady
Se produce cuando la página ha finalizado la carga. En un tipo de control hospedado Página de interfaz unificada, este evento se produce después de que los datos se han guardado en la lista de parámetro de sustitución.
| Parámetro | Descripción |
|---|---|
| Dirección URL | La dirección URL de la página que ha finalizado la carga. |
Nota
Para los paneles, los recursos web y las páginas de búsqueda, no se desencadena el evento DataReady.
BrowserWindowReady
El evento BrowserWindowReady se invoca cuando la ventana del navegador está lista dentro de la aplicación cliente de Unified Service Desk. Utilice BrowserWindowReady para paneles y recursos web.
OnClickToAct
El evento OnClickToAct se invoca cuando el usuario selecciona el campo de comunicación saliente (ClickToAct) en un formulario.
También puede especificar controles personalizados para activar el evento de ventana ClickToAct de Channel Integration Framework y pasar cualquier eventData de acuerdo con los requisitos empresariales.
Más información: onclicktoact
OnSendKbArticle
El evento OnSendKbArticle se invoca cuando el usuario selecciona el botón Enviar en el control de Knowledge Base. El eventData es la dirección URL y el título del artículo de KB que necesita pasar.
Para obtener más información: onsendkbarticle
Nota
Le recomendamos que no utilice window.IsUSD en formularios de aplicaciones basadas en modelo y, en su lugar, utilice PageReady u otros eventos enumerados en este tema.
Consultar también
Compatibilidad con aplicaciones de interfaz unificada en Unified Service Desk
Tutoriales de configuración de Unified Service Desk y la interfaz unificada
Tutorial 1: Cree una aplicación de agente simple para aplicaciones de la Interfaz unificada
Tutorial 2: Mostrar una página web externa en la aplicación del agente
Tutorial 3: Mostrar registros de aplicaciones de la Interfaz unificada en la aplicación de agente
Tutorial 4: Mostrar un registro de la aplicación de la Interfaz unificada en una sesión en la aplicación de agente
Tutorial 5: Mostrar información de sesión mejorada mostrando nombre de sesión y datos de información general
Tutorial 6: Configurar el control hospedado Depurador en la aplicación del agente
Tutorial 7: configuración de scripts de agente en la aplicación del agente