Administrador de escritorio de CTI (control hospedado)
Use el tipo de control hospedado Administrador de escritorio de CTI para conectar un adaptador de integración de telefonía informática (CTI) a Unified Service Desk y administrar los mensajes de pantalla, el enrutamiento de llamadas, el control de softphone, y otras funcionalidades de CTI.
Cree un control hospedado Administrador de escritorio CTI
Para obtener información sobre cómo crear un Administrador de escritorio de CTI y configurar el control hospedado correspondiente, consulte Crear un Administrador del escritorio de CTI.
Acciones de UII predefinidas
Son las acciones predefinidas para este tipo de control hospedado.
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, cerrará todas las páginas que aparecen en la pestaña de la aplicación del agente.
CloseAndPrompt
Esta acción cierra el control hospedado, pero pide que el usuario guarde o abandone los 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 |
|---|---|
| Nombre del botón de la barra de herramientas que se va 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 |
|---|---|
| Nombre del botón de la barra de herramientas que se va a habilitar. |
Buscar
Navegue a la vista de lista de búsqueda rápida de la entidad especificada.
| Parámetro | 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 para el evento. Para obtener más información sobre cómo crear un evento definido por el usuario, consulte Crear un evento definido por el usuario.
GoBack
Esta acción es equivalente a hacer clic en el botón atrás de la instancia del explorador.
GoForward
Esta acción es equivalente a hacer clic en el botón adelante de la instancia del explorador.
GoHome
Esta acción va a la dirección URL inicial especificada para esta instancia del explorador.
LoadArea
Esta acción carga un área específica desde las aplicaciones basadas en modelo. Esto es equivalente a seleccionar un área en el panel de navegación (como Ventas, Servicio y Marketing). El único parámetro es el nombre del área en el que se va a hacer clic. Por ejemplo: areaService.
| Parámetro | Descripción |
|---|---|
| frame | El nombre del marco que se verá afectado. Si no se especifica un nombre, apuntará automáticamente al primer cuadro que encuentre en la página. |
MoveToPanel
Esta acción sirve para mover los controles hospedados entre paneles en tiempo de ejecución.
| Parámetro | Descripción |
|---|---|
| Aplicación | Nombre del control hospedado que se moverá. |
| panel | Panel de destino para el control hospedado. |
Navegar
Esta acción sirve para navegar a una dirección URL de aplicaciones basadas 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 True, los parámetros de datos no se capturarán de la página. |
| HideCommandBar | Si este parámetro se suministra y es True, 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 True, 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 especificaría 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 HTTPPOST. 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 Navigate, también debe especificar un valor apropiado para el parámetro header. Ejemplo: Content-Type:application/x-www-form-urlencodedSi un evento POST de Unified Service Desk desencadena la acción Navigate, el valor predeterminado de este parámetro debería ser header=[[header]+] |
New_CRM_Page
Crea una página para crear un nuevo registro de aplicaciones basadas en modelo de la entidad especificada, y trata la página como un mensaje 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 name=value. Estos son los valores adicional que se rellenan previamente en el formulario para crear un nuevo registro de la entidad especificada. Para obtener más información sobre el uso de esta acción, consulte el paso 4 del Tutorial 7: Configure scripts de agente en la aplicación del agente.
Open_CRM_Page
Abre una instancia existente de la entidad especificada e identificada por el identificador, y trata la página como si fuera un elemento emergente del control hospedado especificado. Las reglas de navegación de ventanas se evalúan para determinar la ubicación donde se debe mostrar el elemento emergente.
| Parámetro | Descripción |
|---|---|
| LogicalName | El nombre lógico de la entidad que se va a abrir. |
| identificador | El identificador del registro de entidad que se va a abrir. |
Ventana emergente
Aparece una dirección URL del control hospedado y ejecuta las reglas de navegación de ventanas con ella para enrutar el mensaje emergente a la ubicación correspondiente.
| Parámetro | Descripción |
|---|---|
| url | Enruta un mensaje emergente desde este control hospedado utilizando esta dirección URL como si fuera un mensaje emergente solicitado desde el control mostrado. |
| frame | El marco desde el que se originó este mensaje 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. |
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 actual como un elemento 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 Microsoft Dataverse con esta acción; en su lugar, use la acción RunXrmCommand.
| Parámetro | 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 inyectar Dataverse SDK JavaScript en el formulario de aplicaciones basadas en modelo.
| Parámetro | 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. |
Guardar
Esta acción guarda la página actual.
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.
SaveAndClose
Esta acción guarda los datos no válidos en el formulario de aplicaciones basadas en modelo y cierra el control hospedado.
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. |
ToggleNavigation
Esta acción contrae o expande el panel de navegación en el panel 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.
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.
WaitForComplete
Esta acción se puede usar para bloquear el procesamiento hasta que la dirección URL termine de cargarse.
Nota
Algunos páginas web, especialmente páginas de aplicaciones basadas en modelo tienen varios cuadros. Esta acción espera solo que el cuadro principal se complete.
| Parámetro | Descripción |
|---|---|
| Milisegundos | Parámetro opcional para indicar la duración en milisegundos del tiempo de espera. |
Eventos predefinidos
Son los eventos predefinidos para este tipo de control hospedado.
BrowserDocumentComplete
Se produce cuando la página ha finalizado la carga.
| Parámetro | Descripción |
|---|---|
| url | La dirección URL de la página que ha finalizado la carga. |
FrameLoadComplete
Aparece en cualquier momento cuando 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 marco que ha finalizado la carga. |
| url | La dirección URL del cuadro que ha finalizado la carga. |
PopupRouted
Se produce cuando el sistema ha enrutado un mensaje emergente.
| Parámetro | Descripción |
|---|---|
| dirección url | La dirección URL de la ventana emergente que se enrutó. |