Página de CRM (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
Use el tipo de control hospedado Página de CRM para cargar una dirección URL o una página desde Dynamics 365. Si se carga una página de Dynamics 365 en un control hospedado de este tipo, buscará automáticamente en la página datos de la entidad, y rellenará 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 supervisar ventanas de Dynamics 365, 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.
En este tema
Crear un control hospedado Página de CRM
Acciones de UII predefinidas
Eventos predefinidos
Crear un control hospedado Página de CRM
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 al tipo de control hospedado Página de CRM. Para obtener más información sobre la creación de un control hospedado, consulte Crear o editar un control hospedado.
.jpeg "Control hospedado de página de Dynamics 365")
En la pantalla Nuevo control hospedado:
En el área Unified Service Desk, seleccione Página de CRM en la lista desplegable Tipo de componente de USD.
En la lista desplegable Permitir varias páginas, seleccione No (opción predeterminada) para reemplazar la página de Dynamics 365 que se muestra actualmente y actualizar el historial del explorador cuando Unified Service Desk recibe una llamada a la acción de navegación o una página se enruta a la pestaña. 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 de Dynamics 365 que están asociadas 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.
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.
El campo Mostrar grupo muestra el panel donde se mostrará este control hospedado.MainPanel es el más común para este tipo de control hospedado. Para obtener más información acerca de los diferentes paneles disponibles en Unified Service Desk, consulte Paneles, tipos del panel y diseños de panel en Unified Service Desk.
Para obtener información sobre otros campos de General, consulte Crear o editar un control hospedado.
Acciones de UII predefinidas
Son las acciones predefinidas para este tipo de control hospedado.
AssociatedView
Esta acción carga una vista asociada específica de Dynamics 365. Se suele acceder a estas vistas haciendo clic en la flecha abajo junto al 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 de Dynamics 365. Ejemplos: areaSales o areaService. |
Para obtener más información acerca del uso de esta acción, vea el paso 5 en Tutorial 7: Configure scripts de agente en la aplicación del agente.
Cerrar
Esta acción sirve para cerrar el control hospedado. A diferencia de acción de 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.
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 Página de CRM 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 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:
|
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.
GetSelectedIds
Esta acción sirve para recuperar los identificadores seleccionados de las listas.
Parámetro |
Descripción |
|---|---|
El parámetro de datos debe especificar el nombre de lista para capturar los identificadores 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 |
|---|---|
El parámetro de datos debe especificar el nombre de lista para recuperar los identificadores seleccionados. |
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 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.
LoadArea
Esta acción carga una región específica de Dynamics 365. 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. |
LookupInfo
Muestra un cuadro de diálogo de información de búsqueda de Dynamics 365 para permitirle seleccionar una entidad de una lista.
Parámetro |
Descripción |
|---|---|
AllowFilterOff |
"0" o "1" permitir que el usuario desconecte 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" mostrar la vista predeterminada |
DisableQuickFind |
"0" o "1" 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 de propiedades |
Examinar |
"0" o "1" si se usa el modo examinar. Lo siguiente es con esto establecido en "1". |
Currentid |
El Guid del valor actual |
objecttypes |
Lista de tipos de objetos para mostrar. Estos son los tipos etc de Dynamics 365. Ejemplo: "1,2 " para mostrar cuentas y contactos. |
MoveToPanel
Esta acción mueve un control hospedado Página de CRM a otro panel diferente en tiempo de ejecución.
Parámetro |
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 Dynamics 365.
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 Dynamics 365. |
HideNavigationBar |
Si este parámetro se suministra y es True, se mostrará el formulario sin cargar la barra de navegación de Dynamics 365. |
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 cualquier evento desencadenado mediante "http://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-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. |
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 actual como un elemento emergente.
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. |
RunXrmCommand
Esta acción sirve para insertar Dynamics 365 SDK JavaScript en el formulario de Dynamics 365.
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. |
SaveAndClose
Esta acción guarda los datos no válidos en el formulario de Dynamics 365 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 panel izquierdo de la ventana de Dynamics 365. 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 |
|---|---|
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 |
|---|---|
url |
La dirección URL de la página que ha finalizado la carga. |
PageLoadComplete
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 cuadro que terminó de cargarse, si está disponible. |
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 |
|---|---|
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 Dynamics 365.
Parámetro |
Descripción |
|---|---|
newId |
El identificador asignado al registro recién creado. |
Ver también
Diálogo de CRM (control hospedado)
Acciones de UII
Eventos
Tutorial 3: Mostrar registros de Microsoft Dynamics 365 en la aplicación del agente
Referencia de tipos de control hospedado y acciones/eventos
Manual de administración de Unified Service Desk para Microsoft Dynamics CRM
Unified Service Desk 2.0
© 2017 Microsoft. Todos los derechos reservados. Copyright