Aplicación web estándar (control hospedado)

 

Publicado: noviembre de 2016

Se aplica a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2013, Dynamics CRM 2015, Dynamics CRM 2016

El tipo de control hospedado Aplicación web estándar es similar al tipo Página de CRM salvo que está diseñado para hospedar páginas no Dynamics 365, como páginas web externas, y proporciona código de script para características relevantes de páginas web externas. Como el control hospedado Página de CRM, estas páginas se pueden automatizar. El método preferido de automatización es a través de inyección de JavaScript, incluido llamar a las funciones de JavaScript que ya están definidas en la página o manipular el DOM. La acción RunScript también puede usarse para obtener valores de la página.

Nota

Este tipo de control hospedado no admite el Kit de herramientas de aplicaciones hospedadas (HAT), que facilita la tarea de automatizar la interfaz de usuario de una aplicación hospedada. HAT se compone de los adaptadores controlados por datos (DDA), enlaces y automatizaciones descriptivos (flujos de trabajo de Windows) para automatizar las aplicaciones.Más información:Use el adaptador de automatización de UII para interactuar con aplicaciones externas y web

En este tema

Cree un control hospedado Aplicación web estándar

Acciones de UII predefinidas

Eventos predefinidos

Cree un control hospedado Aplicación web estándar

Mientras crea un nuevo control hospedado, los campos de la pantalla Nuevo control hospedado varían en función del tipo de control hospedado que desee crear. En esta sección se proporciona información sobre los campos específicos que son únicos del tipo de control hospedado Aplicación web estándar. Para obtener más información sobre la creación de un control hospedado, consulte Crear o editar un control hospedado.

En la pantalla Nuevo control hospedado:

• En el área Unified Service Desk, seleccione Aplicación web estándar en la lista desplegable Tipo de componente de USD.

• En la lista desplegable Permitir varias páginas, seleccione Sí para crear automáticamente una lista desplegable cuando se llame a una segunda dirección URL o una regla de navegación de ventanas dirija una página a la pestaña. Esto permite al usuario examinar rápidamente entre las páginas que están asociadas a este control. Si selecciona No, cuando Unified Service Desk recibe una llamada a la acción de navegación o una página se enruta a la pestaña, reemplazará la página mostrada en la actualidad y actualizará el historial del explorador.

• La lista desplegable Tipo de hospedaje especifica cómo desea hospedar este control. Puede elegir Proceso de IE predeterminado o WPF interno. Para obtener más información, vea Seleccionar un método de hospedaje para los controles.

• En el área Propiedades comunes, active la casilla de verificación 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 la casilla no está activada, 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, especifique un panel donde se mostrará este control hospedado. Para obtener más información acerca de los diferentes paneles disponibles en Unified Service Desk, consulte Paneles de Unified Service Desk.

Acciones de UII predefinidas

Son las acciones de UII predefinidas disponibles para este tipo de control hospedado.

Cerrar

Esta acción sirve para cerrar el control hospedado.

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 acerca de 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.

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.

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 en lugar de cargar la barra de comandos de la página.
HideNavigationBar	Si se incluye este parámetro y es True, no se mostrará el panel de navegación de la página web de destino.
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 puede recibir de los eventos desencadenado mediante ""http://event/?. Ejemplo: [[postdata]+] Como alternativa, los datos se pueden pasar como 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 el valor apropiado para el parámetro header. Ejemplo: Content-Type:application/x-www-form-urlencoded Si un evento Unified Service DeskPOST 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 Dynamics 365 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 acerca del uso de esta acción, vea el paso 4 en 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.

RunScript

Esta acción inyecta JavaScript en el cuadro principal de la aplicación. Debe evitar utilizar llamadas de SDK de cliente de Dynamics 365 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.

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.

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 Dynamics 365 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

Los eventos predefinidos siguientes están asociados con este tipo de control hospedado.

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
url	La dirección URL de la página que ha finalizado la carga.

PopupRouted

Se produce cuando el sistema ha enrutado un mensaje emergente.

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

Ver también

Acciones de UII
Eventos
Ver acciones y eventos predefinidos para un control hospedado
Crear o editar un control hospedado
Tutorial 2: Mostrar una página web externa en la aplicación del agente
Referencia de tipos de control hospedado y acciones/eventos

Unified Service Desk 2.0

© 2017 Microsoft. Todos los derechos reservados. Copyright