Diseño de panel (control hospedado)

Use el control hospedado de Diseño de panel para definir la organización de paneles en Unified Service Desk. Los paneles contienen varios controles hospedados y el diseño del panel define la organización de varios controles hospedados en la pantalla principal de la aplicación cliente Unified Service Desk. Unified Service Desk incluye diferentes tipos de paneles predefinidos para admitir diversas opciones de diseño, como diseño tabulado, portada y diseño apilado. Para obtener más información, vea Paneles, tipos de panel y diseños de panel en Unified Service Desk.

Si no se define un tipo de control hospedado Diseño de panel en la aplicación, se creará automáticamente el diseño de panel predeterminado, Panel principal estándar. Si crea un tipo de control hospedado Diseño de panel, debe configurar una sustitución para el Panel principal estándar. Un diseño de panel se puede usar en su lugar; sin embargo, es bastante común definir solo el Panel principal estándar.

En esta sección

Crear un control hospedado Diseño de panel

Acciones de UII predefinidas

Eventos predefinidos

Cree un control hospedado Diseño de panel

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 quiera crear. En esta sección se proporciona información sobre los campos específicos que son únicos del tipo de control hospedado Diseño de panel. 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:

• Desde la lista desplegable Tipo de componente de Unified Service Desk, seleccione Diseño de panel.

• En la lista desplegable PanelType, seleccione un tipo de diseño de panel para crear. Puede seleccionar uno de los siguientes: Panel principal estándar, Panel principal de la cinta de opciones, División vertical, División horizontal, XAML y Definido por el usuario. Los diseños de panel XAML y definidos por el usuario son los paneles personalizados que usted define. Para obtener información detallada sobre cada uno de los diseños de panel, consulte Paneles, tipos del panel y diseños de panel en Unified Service Desk. Los campos de esta página cambian según el tipo de panel seleccionado.

• Seleccione Sí o No en la lista La aplicación es dinámica para determinar si el control hospedado es dinámico o no. Un control dinámico hospedado puede se global o no global. Los controles hospedados dinámicos globales se cargan en la primera petición y se ocultan después, y se pueden solicitar en cualquier momento, por ejemplo, durante una sesión global, una sesión normal o un flujo de trabajo. Los controles hospedados dinámicos no globales solo se pueden cargar cuando se ha iniciado una sesión, y cada sesión utiliza una instancia diferente de la aplicación. Si un control hospedado dinámico forma parte de un flujo de trabajo, y no se ha iniciado cuando se inicia el flujo de trabajo, el flujo de trabajo iniciará el control hospedado y lo cerrará cuando se complete el flujo de trabajo.

• La casilla El usuario puede cerrar está disponible si seleccionó Sí en la lista La aplicación es dinámica. Selecciónela para especificar que el usuario puede cerrar el control hospedado.

• Si seleccionó División vertical, División horizontal, XAMLo Definido por el usuario en la lista PanelType, la casilla La aplicación es global estará disponible. Selecciónela 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.

• Si seleccionó División vertical, División horizontal, XAMLo Definido por el usuario en la lista PanelType, el campo Mostrar grupo estará disponible. Especifique un panel donde se mostrará este control hospedado. Para obtener más información sobre los distintos paneles disponible en Unified Service Desk, consulte Paneles, tipos del panel y diseños de panel en Unified Service Desk.

• Si seleccionó XAML en la lista PanelType, un campo XAML está disponible donde especifique la definición de XAML para el tipo del panel.

• Si seleccionó Definido por el usuario en la lista PanelType, los campos Ensamblado un URI y Montaje están disponibles. En el campo Ensamblado un URI, escriba el nombre del ensamblado. En el campo Tipo de ensamblado, especifique el valor siguiente: <AssemblyName>.<ClassName>. Para obtener información detallada sobre cómo crear un diseño de panel definido por el usuario, consulte Crear un diseño de panel personalizado en Unified Service Desk.

Acciones de UII predefinidas

Son las acciones predefinidas 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 sobre cómo crear un evento definido por el usuario, consulte Crear un evento definido por el usuario.

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.

New_CRM_Page

Crea una página para crear un nuevo registro 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.

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.

SetVisualProperty

Establezca las propiedades visuales (UIElement) como alto, ancho y visibilidad de un control hospedado. Esta llamada a la acción es útil específicamente para la automatización de la interfaz de usuario personalizada, como automáticamente mostrar u ocultar un panel. Es necesaria familiaridad con XAML y el diseño de Unified Service Desk para usar esta acción con efectividad.

Parámetro	Descripción
elementname	El nombre de la interfaz de usuario para la que desea establecer la propiedad como Expander, StackPanel y Grid. Por ejemplo: elementname=Expander
propertyname	El nombre de la propiedad del elemento especificado que desea establecer, como Height, Width, Visibility, y Color. Por ejemplo: propertyname=Visibility
valor	Especifique el valor apropiado para la propiedad especificada. Los tipos de valores admitidos para este parámetro son string, enumeration, integer, o bool. Por ejemplo: value=Visible

Para un uso de ejemplo de este mensaje, consulte Paso 3: Configurar llamadas a la acción para mostrar y ocultar automáticamente el panel de búsqueda de knowledge base en Tutorial 8: Uso del conocimiento de Parature dentro de la aplicación del agente.

Nota

De forma predeterminada, esta acción se expone solo para el tipo de control hospedado Diseño de panel. Para usar la acción SetVisualProperty con los demás tipos predefinidos de control hospedado Unified Service Desk que se deriven de la clase DynamicsBaseHostedControl, debe agregar explícitamente una acción de UII denominada SetVisualProperty al control hospedado respectivo. Más información: Agregar una acción UII para un control hospedado

Eventos predefinidos

No hay eventos predefinidos disponibles para este tipo de control hospedado.

Vea también

Paneles, tipos del panel y diseños de panel en Unified Service Desk
Acciones de UII
Eventos
Tutoriales de configuración de Unified Service Desk
Referencia de tipos de control hospedado y acciones/eventos