Página de CRM (control hospedado)

Use el tipo de control hospedado Página de CRM para cargar una dirección URL o una página desde 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 ventanas, 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 CRM

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 CRM. Más información: Crear o editar un control hospedado

En la pantalla Nuevo control hospedado:

• En el área Unified Service Desk, seleccione Página CRM 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 la lista desplegable Tipo de hospedaje se especifica cómo se quiere hospedar este control. Elija Proceso Chrome. Más información: Seleccionar un método de hospedaje para controles hospedados

• 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: Paneles, tipos de panel y diseños de panel en Unified Service Desk

Para obtener información sobre otros campos Generales, vaya a 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 de aplicaciones basadas en modelo. 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
navItemName	La entidad asociada que desea mostrar. Ejemplo: Casos
Identificador	El identificador del registro de entidad principal para el que se mostrarán los registros de entidad asociados.
tabset	El área en aplicaciones basadas en modelos. Ejemplos: areaSales o areaService.

Más información: Paso 5 de Tutorial 7: configurar la secuencia de comandos del agente en su aplicación de agente

Cerrada

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 página CRM de controles hospedados 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.

DisableToolbarButton

Esta acción deshabilita el botón de la barra de herramientas especificado en la barra de herramientas en la aplicación del agente.

Parámetro	Descripción
Ver descripción	Nombre del botón de la barra de herramientas a deshabilitar.

EnableToolbarButton

Esta acción habilita el botón de la barra de herramientas especificado en la barra de herramientas en la aplicación del agente.

Parámetro	Descripción
Ver descripción	Nombre del botón de la barra de herramientas a habilitar.

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. - Utilice advfind para mostrar la vista de búsqueda avanzada. - Use actividades o actividad para mostrar la vista de lista de búsqueda rápida para actividades.

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.

LoadArea

Esta acción carga un área específica desde aplicaciones basadas en modelo. Esto es equivalente a seleccionar un área en el panel de navegación (como Ventas, Servicio o Marketing). El único parámetro es el nombre del área a seleccionar, por ejemplo areaService.

Parámetro	Descripción
frame	El nombre del marco que se verá afectado. Si no se especifica un nombre, la acción apuntará automáticamente al primer cuadro que encuentre en la página.

LookupInfo

Muestra el cuadro de diálogo de información de búsqueda de Microsoft Dataverse, para permitirle seleccionar una entidad de una lista.

Parámetro	Descripción
AllowFilterOff	0 o 1, para permitir que el usuario descactive el filtrado
DefaultType	El nombre lógico de visualización predeterminada. Debe ser uno de los valores numéricos especificados en el parámetro objecttypes.
DefaultViewId	0 o 1 para mostrar la vista predeterminada
DisableQuickFind	0 o 1 para mostrar el campo de búsqueda rápida
DisableViewPicker	0 o 1 para mostrar el selector de vista
LookupStyle	Uno o varios
ShowNewButton	0 o 1 para mostrar el botón Nuevo
ShowPropButton	0 o 1 para mostrar el botón Propiedades
Examinar	0 o 1 sobre si se usa el modo de exploración
Currentid	GUID del valor actual
objecttypes	Lista de tipos de objetos para mostrar. Ejemplo: 1,2 para mostrar cuentas y contactos.

MoveToPanel

Esta acción mueve un control hospedado de página CRM 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.

Parámetro	Descripción
dirección URL	La dirección URL a la que se navegará. Este parámetro es obligatorio.
Noscan	Si este parámetro se suministra y es Verdadero, los parámetros de datos no se capturarán de la página.
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. Una transacción POST normalmente se usa 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 postdata se usa en la acción Navegar, también debe especificar un valor apropiado para el parámetro header. 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(<headers separated by newline>) 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. Más información: Paso 4 de Tutorial 7: configurar la secuencia de comandos del agente en su aplicación de agente

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.
top	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.
width	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.

ReRoute

Esta acción toma la dirección URL mostrada actualmente y la envía a través de las reglas de navegación de ventanas desde el control hospedado actual como una ventana emergente.

RunScript

Esta acción inyecta JavaScript en el cuadro principal de la aplicación. Debería evitar usar llamadas de SDK de cliente de 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.

RunXrmCommand

Esta acción sirve para insertar Dataverse SDK JavaScript en el formulario de la aplicación basada en modelo.

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.

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 CRM actual.

ToggleRibbon

Esta acción expande o contrae la cinta de opciones. Si oculta la cinta de opciones en la acción Navegar, no se mostrará y esta acción no funcionará. Esta acción funcionará solo cuando la cinta de opciones se cargue inicialmente.

ToggleNavigation

Esta acción contrae o expande el panel de navegación en el lado izquierdo de la ventana de aplicaciones basadas en modelo. La navegación debe contener un panel de navegación para que esta acción funcione.

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ó.

BrowserDocumentComplete

Se produce cuando la página ha finalizado la carga. En un tipo de control hospedado Página de CRM, este evento se produce después de que los datos se han guardado en la lista de parámetro de sustitución. Este evento se produce solo una vez, aunque varios cuadros hayan desencadenado individualmente sus eventos BrowserDocumentComplete.

Parámetro	Descripción
dirección url	La dirección URL de la página que ha finalizado la carga.

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 BrowserDocumentComplete. Si la opción Búsqueda previa de datos está seleccionada para la instancia del control, entonces este evento sucederá 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ó para las navegación alineada también.

PageLoadComplete

Aparece en cualquier momento en que un cuadro ha terminado de cargarse. Este evento se puede producir varias veces por carga de página cuando se usa un iFrame o un cuadro en la página. Este evento corresponde a los eventos individuales de BrowserDocumentComplete en código.

Parámetro	Descripción
frame	El nombre del cuadro que terminó de cargarse, si está disponible.
url	La dirección URL del cuadro que ha finalizado la carga.

PopupRouted

Se produce después de que el sistema ha enrutado una ventana emergente.

Parámetro	Descripción
dirección URL	La dirección URL de la ventana emergente que se enrutó.

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.

Nota

Le recomendamos que no utilice window.IsUSD en formularios de aplicaciones basadas en modelo y, en su lugar, utilice el evento BrowserDocumentComplete u otros eventos enumerados en este tema.

Consultar también

Diálogo de CRM (control hospedado)
Acciones de UII
Eventos
Tutorial 3: Mostrar registros en la aplicación del agente
Referencia de tipos de control hospedado y acciones/eventos
Manual de administración para Unified Service Desk