Control Xrm.Page.ui (referencia de cliente)

  • Artículo

 

Publicado: enero de 2017

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

El objeto de control proporciona métodos para cambiar la presentación o el comportamiento de un control e identificar el atributo correspondiente.

El acceso a los controles se realiza utilizando las colecciones siguientes: Xrm.Page.ui.controles, Xrm.Page.ui Section.controles o Xrm.Page.data.entity Attribute.controles. El método Xrm.Page.getControl es un método abreviado para tener acceso a Xrm.Page.ui.controls.get.

Los ejemplos de sintaxis de este tema muestran el uso del método de Xrm.Page.getControl para tener acceso a un control. El control depende de los argumentos que se han pasado al método. El parámetro args para tener acceso a un único control debe ser el nombre del control o del índice.

Cuando un formulario muestra un control de flujo de proceso de negocio en el encabezado, se agregarán controles adicionales para cada atributo que se muestra en el flujo de proceso de negocio. Estos controles tienen un nombre único similar al ejemplo siguiente: header_process_<attribute name>.

Nota

Sólo se puede acceder a los controles de la fase activa del flujo de proceso de negocio por su nombre de esta forma.

Los controles mostradas en el encabezado del formulario están accesibles y tienen un nombre único como el siguiente: header_<attribute name>.

Para controles que están enlazados a atributos es común acceder a los controles a través de la colección de Xrm.Page.data.entity Attribute.controles.

Los controles personalizados para clientes móviles de Dynamics 365 (teléfonos y tabletas) admiten todas las propiedades y métodos de control excepto los siguientes: Métodos de autocompletar, getValue, Métodos Keypress y Métodos y eventos de control de búsqueda.

Con la versión Actualización 1 de Microsoft Dynamics CRM Online 2016 y Microsoft Dynamics CRM 2016 Service Pack 1 (local), los siguientes métodos ahora se admiten para el control del temporizador en el nuevo motor de representación de formularios (también denominada "formularios turbo"): métodos getControlType, getName, getParent, Etiqueta, métodos refresh y Visible.

Propiedades y métodos de controles

  • Métodos de autocompletar
    Configure la experiencia de autocompletar en controles de texto de los formularios de Dynamics 365. Estos métodos se introdujeron en Dynamics 365.

  • Deshabilitado
    Detecte el estado y habilite o deshabilite los controles utilizando los métodos getDisabled y setDisabled.

  • getAttribute
    Obtenga el atributo con el que está enlazado el control.

  • getControlType
    Obtenga información acerca del tipo de control.

  • getName
    Obtenga el nombre del control.

  • getParent
    Obtenga el objeto de sección en el que está el control.

  • getValue
    Obtiene el último valor para un control a medida que los usuarios escriben un carácter en un campo específico de texto o de número. Este método se introdujo en Dynamics 365.

  • Métodos Keypress
    Agregue, elimine o realice una función cuando el usuario pulse una tecla en un control. Estos métodos se introdujeron en Dynamics 365.

  • Métodos de control de knowledge base
    Estos métodos solo están disponibles para el control de búsqueda en knowledge base a los formularios de entidades en una instancia de Dynamics 365 que tiene la característica de administración del conocimiento habilitada.

    Para obtener información sobre este control, consulte Control de búsqueda de knowledge base (referencia del lado del cliente).

  • Etiqueta
    Obtenga o cambie la etiqueta de un control con los métodos getLabel y setLabel.

  • Métodos y eventos de control de búsqueda
    Controle los resultados que se muestran para que un usuario elija cuando establece el valor de un control de búsqueda utilizando los métodos addCustomFilter, addCustomView, getDefaultView, setDefaultView.

    Puede agregar o quitar controladores de eventos para el Evento PreSearch mediante los métodos addPreSearch y removePreSearch.

  • Notificación
    Muestre y quite notificaciones a usuarios sobre un control utilizando los métodos setNotification, addNotification y clearNotification.

  • Métodos de control de OptionSet
    Modifique las opciones que aparecen en los controles de OptionSet mediante los métodos addOption, clearOptions y removeOption.

  • ShowTime
    Use setShowTime para especificar si un control de fecha debe mostrar la parte de hora de la fecha y getShowTime para determinar si se muestra actualmente la parte de hora de la fecha.

  • Métodos de control de subcuadrícula
    Para las organizaciones con Actualización 1 de CRM Online 2015 hay nuevas capacidades para trabajar con controles de subcuadrícula.Más información:Objetos y métodos de cuadrícula (solo lectura) (referencia del lado del cliente)

    Para otras organizaciones, el método refresh es el único método disponible para los controles de subcuadrícula. Este método actualizará los datos que se muestran en la subcuadrícula.

  • Visible
    Determine qué controles son visibles y muéstrelos u ocúltelos mediante los métodos getVisible y setVisible.

  • Métodos de controles IFRAME y recursos web
    Interactúe con controles de recursos web e IFRAME mediante los métodos getData, setData, getInitialUrl, getObject, setSrc y getSrc.

Métodos de autocompletar

Use los métodos showAutoComplete y hideAutoComplete para configurar la experiencia de autocompletar en controles de texto de los formularios.

Para código JavaScript de ejemplo que demuestra la función de autocompletar, vea Ejemplo: Autocompletar en controles de Dynamics 365

Nota

Estos métodos no se admiten para los clientes móviles de Dynamics 365 (teléfonos o tabletas) y el centro de servicio interactivo. Estos métodos sólo están disponibles para Entidades actualizadas.

showAutoComplete

Use esto para mostrar hasta 10 cadenas coincidentes en una lista desplegable cuando los usuarios presionen teclas para escribir caracteres en un campo de texto específico. También puede agregar un comando personalizado con un icono en la parte inferior de la lista desplegable. Al seleccionar un elemento de la lista desplegable, el valor del campo de texto cambia al elemento seleccionado, la lista desplegable desaparece y se invoca Evento OnChange para el campo de texto.

Xrm.Page.getControl(arg).showAutoComplete(object)

  • Parámetro
    objetoTipo: Objeto que define el conjunto de resultados, que incluye results y commands, que aparecerá en la lista desplegable de autocompletar.

    LlamadaComentarios: Llame a este método en una función que agrega mediante el método addOnKeyPress para ejecutar en el evento keypress.

    Ejemplo: En el siguiente ejemplo se muestra la definición del objeto que se pasará al método showAutoComplete.

    var resultset = { 
   results: [{ 
         id: <value1>, 
         icon: <url>, 
         fields: [<fieldValue1>]}, 

         {...}, 

         { 
         id: <valueN>, 
         icon: <url>, 
         fields: [<fieldValue1, fieldValue2,..., fieldValueN>]}],
   commands:{ 
         id: <value>, 
         icon: <url>, 
         label: <value>, 
         action: <function reference> 
   } 
}

hideAutoComplete

Use esta capacidad para ocultar la lista desplegable de autocompletar que configuró para un campo de texto específico.

Xrm.Page.getControl(arg).hideAutoComplete()

Nota

No tiene explícitamente que usar el método hideAutoComplete porque, de forma predeterminada, la lista desplegable se oculta automáticamente si el usuario hace clic en otra parte o si aparece una nueva lista desplegable. Esta función está disponible en caso de que los programadores necesiten ocultar explícitamente la lista desplegable de autocompletar para administrar un escenario personalizado.

Deshabilitado

Use getDisabled y setDisabled para detectar si un control está deshabilitado o para habilitarlo o deshabilitarlo.

Tipos de control: estándar, búsqueda, optionset.

getDisabled

Devuelve si el control está deshabilitado.

Xrm.Page.getControl(arg).getDisabled()
  • Valor devuelto
    Tipo: Booleano. True si el control está deshabilitado; False de lo contrario.

setDisabled

Establece si el control está deshabilitado.

Xrm.Page.getControl(arg).setDisabled(bool)
  • Argumentos
    Tipo: Booleano. True si el control debe deshabilitarse; False de lo contrario.

getAttribute

Devuelve el atributo con el que está enlazado el control.

Tipos de control: estándar, búsqueda, optionset.

Xrm.Page.getControl(arg).getAttribute()

Nota

Los controles que no están enlazados a un atributo (subcuadrícula, recurso web, e IFRAME) no tienen este método. Se generará un error si intenta usar este método en uno de estos controles.

  • Valor devuelto
    Tipo: Objeto: Un atributo.

Comentarios

Los controles constituyentes en un control de vista rápida se incluyen en la colección de controles y estos controles tienen el método getAttribute. Sin embargo, el atributo no es parte de la colección de atributos de la entidad. Aunque puede recuperar el valor de ese atributo mediante getValue e incluso cambiar el valor mediante setValue, los cambios realizados no se guardarán con la entidad.

El código siguiente muestra el uso del valor del atributo mobilephone de contacto cuando se muestra en un formulario de entidad de cuenta utilizando un control de vista rápida distintas llamado contactQuickForm. Este código oculta el control cuando el valor del atributo es null.

var quickViewMobilePhoneControl = Xrm.Page.getControl("contactQuickForm_contactQuickForm_contact_mobilephone");
 if (quickViewMobilePhoneControl.getAttribute().getValue() == null)
 {
  quickViewMobilePhoneControl.setVisible(false);
 }

getControlType

Devuelve un valor que categoriza los controles.

Tipos de control: todos.

Xrm.Page.getControl(arg).getControlType()

  • Valor devuelto
    Tipo: Cadena

    Posibles valores de devolución de getControlType:

    Valor de retorno

    Descripción

    standard

    Un control estándar.

    iframe

    Un control de IFRAME

    lookup

    Un control de búsqueda.

    optionset

    Un control de conjunto de opciones.

    subgrid

    Un control de subcuadrícula.

    webresource

    Un control de recurso web.

    notes

    Un control de notas.

    timercontrol

    Un control de temporizador.

    kbsearch

    Control de búsqueda de knowledge base.

    customcontrol: <namespace>.<name>

    Un control personalizado para clientes móviles Dynamics 365(teléfonos y tabletas).

    customsubgrid:<namespace>.<name>

    Un control de conjunto de datos personalizado para clientes móviles Dynamics 365 (teléfonos y tabletas).

getName

Devuelve el nombre asignado al control.

Nota

El nombre asignado a un control no se determina hasta que el formulario se carga. Los cambios en el formulario pueden cambiar el nombre asignado a un determinado control.

Tipos de control: todos.

Xrm.Page.getControl(arg).getName()
  • Valor devuelto
    Tipo: Cadena. El nombre del control.

getParent

Devuelve una referencia al objeto de sección que contiene el control.

Tipos de control: todos.

Xrm.Page.getControl(arg).getParent()

getValue

Obtiene el último valor de un control a medida que el usuario escribe caracteres en un campo específico de texto o de número. Este método le ayuda a crear experiencias interactivas validando datos y alertando a los usuarios a medida que escriben caracteres en un control.

El método getValue es diferente del método getValue del atributo porque el método de control recupera el valor del control mientras el usuario escribe en el control en comparación con el método getValue del atributo que recupera el valor después de que el usuario guarda el campo.

Nota

Este método no se admite para los clientes móviles de Dynamics 365 (teléfonos o tabletas), y sólo está disponible para Entidades actualizadas.

Para un código JavaScript de ejemplo que use el método getValue para la configuración de la experiencia de autocompletar, consulte Ejemplo: Autocompletar en controles de Dynamics 365.

Xrm.Page.getControl(arg).getValue()
  • Valor devuelto
    Tipo: Cadena. El último valor de datos de un control.

Métodos Keypress

Use los métodos addOnKeyPress, removeOnKeyPress, y fireOnKeyPress para proporcionar comentarios instantáneos o realizar acciones a medida que el usuario escribe en un control. Estos métodos le permiten realizar validaciones de datos en un control incluso antes de que usuario confirme (guarde) el valor en un formulario.

Nota

Estos métodos no se admiten para los clientes móviles de Dynamics 365 (teléfonos o tabletas), y sólo están disponibles para Entidades actualizadas.

addOnKeyPress

Use esto para agregar una función como un controlador de eventos para el evento de pulsación de teclas de modo que se llame a la función cuando se escriba un carácter en un campo específico de texto o de número.

Para un código JavaScript de ejemplo que use el método addOnKeyPress para la configuración de la experiencia de autocompletar, consulte Ejemplo: Autocompletar en controles de Dynamics 365.

Xrm.Page.getControl(arg).addOnKeyPress([function reference])

  • Parámetro
    Tipo: referencia de función

    Comentarios: La función se agregará al final de la canalización del controlador de eventos. El contexto de ejecución se configura automáticamente para pasarse como el primer parámetro que se pasa al controlador de eventos utilizando este método.Más información:Contexto de ejecución (referencia del lado del cliente)

    Debe usar una referencia a una función con nombre en lugar de una función anónima por si posteriormente desea quitar el controlador de eventos para el campo.

removeOnKeyPress

Use esto para quitar un controlador de eventos de un campo de texto de número en CRM que agregó mediante addOnKeyPress.

Xrm.Page.getControl(arg).removeOnKeyPress([function reference])

  • Parámetro
    Tipo: referencia de función

    Comentarios: Si una función anónima se configura mediante addOnKeyPress, no se puede quitar mediante este método.

fireOnKeyPress

Use esto para desencadenar manualmente un controlador de eventos que creó para un campo específico de texto o de número para se ejecutará con el evento keypress.

Xrm.Page.getControl(arg).fireOnKeyPress()

Métodos de control de knowledge base

Estos métodos solo están disponibles para el control de búsqueda en knowledge base, que está disponible cuando la organización de Dynamics 365 está habilitada para la característica de administración del conocimiento. Para obtener información sobre estos controles, consulte Control de búsqueda de knowledge base (referencia del lado del cliente).

Etiqueta

Obtenga o cambie la etiqueta de un control con los métodos getLabel y setLabel.

Tipos de control: todos.

getLabel

Devuelve la etiqueta del control.

Xrm.Page.getControl(arg).getLabel()
  • Valor devuelto
    Tipo: Cadena. La etiqueta del control.

setLabel

Establece la etiqueta del control.

Xrm.Page.getControl(arg).setLabel(label)
  • Argumentos
    Tipo: Cadena. La nueva etiqueta del control.

Métodos y eventos de control de búsqueda

Controle los resultados que se muestran para que un usuario elija cuando establece el valor de un control de búsqueda utilizando los métodos addCustomFilter, addCustomView, getDefaultView y setDefaultView. El control de Lookup también expone el Evento PreSearch para que pueda agregar controladores de eventos mediante programación utilizando los métodos addPreSearch y removePreSearch.

Tipos de Control: búsqueda.

addCustomFilter

Use para agregar filtros a los resultados mostrados en la búsqueda. Cada filtro se combinará con cualquier filtro agregado anteriormente como una condición "AND".

Xrm.Page.getControl(arg).addCustomFilter(filter, entityLogicaName)

  • Argumentos

    • filterXml
      Tipo: Cadena: El elemento de filtro fetchXml a aplicar. Por ejemplo:

      <filter type="and">
 <condition attribute="address1_city" operator="eq" value="Redmond" />
</filter>

    • entityLogicalName
      Tipo: Cadena: (Opcional) Si se establece, el filtro solo se aplicará a ese tipo de entidad. Si no, se aplicará a todos los tipos de entidades devueltas.

  • Comentarios
    Más información:FetchXML schema.

    Este método solo está disponible para Entidades actualizadas.

    Este método solo se puede usar en una función en un controlador de eventos para el Evento PreSearch de control de búsqueda.

    El siguiente ejemplo de código es para la búsqueda de Cuenta del formulario de oportunidad (parentaccountid). Cuando la función Sdk.setParentAccountIdFilter se establece en el controlador de eventos de Onload del formulario, la función Sdk.filterCustomAccounts se agrega al evento PreSearch para esa búsqueda. El resultado es que solo se devuelven las cuentas con el valor Categoría (accountcategorycode) de Cliente preferido (1).

    var Sdk = window.Sdk || {};

Sdk.filterCustomerAccounts = function () {
    //Only show accounts with the type 'Preferred Customer'
    var customerAccountFilter = "<filter type='and'><condition attribute='accountcategorycode' operator='eq' value='1'/></filter>";
    Xrm.Page.getControl("parentaccountid").addCustomFilter(customerAccountFilter, "account");
}
//set 'Sdk.setParentAccountIdFilter' in the Opportunity form onload event handler
Sdk.setParentAccountIdFilter = function () {
    Xrm.Page.getControl("parentaccountid").addPreSearch(Sdk.filterCustomerAccounts);
}

addCustomView

Agrega una vista nueva para el cuadro de diálogo de búsqueda.

Xrm.Page.getControl(arg).addCustomView(viewId, entityName, viewDisplayName, fetchXml, layoutXml, isDefault)

  • Argumentos

    • viewId
      Tipo:Cadena: Representación de cadena de un GUID para una vista.

      Nota

      Este valor nunca se guarda y solo debe ser único entre las otras vistas disponibles para la búsqueda. Funcionará una cadena para un GUID no válido, por ejemplo “{00000000-0000-0000-0000-000000000001}”. Se recomienda usar una herramienta como guidgen.exe para generar un GUID válido. La herramienta guidgen.exe se incluye en el Windows SDK.

    • entityName
      Tipo: Cadena: El nombre de la entidad.

    • viewDisplayName
      Tipo: Cadena: El nombre de la vista.

    • fetchXml
      Cadena: La consulta de fetchXml para la vista.

    • layoutXml
      Tipo:Cadena: El XML que define el diseño de la vista.

    • es predeterminada
      Tipo:Booleano: Si la vista debe ser la vista predeterminada.

  • Comentarios
    Este método no funciona en búsquedas Propietario. Las búsquedas de propietario se usan para asignar registros propiedad del usuario.

DefaultView

Puede detectar qué vista es la vista predeterminada que se muestra para permitir a los usuarios seleccionar registros en una búsqueda y cambiar la vista predeterminada mediante getDefaultView y setDefaultView.

getDefaultView

Devuelve el valor de identificador de la vista predeterminada del diálogo de búsqueda.

Xrm.Page.getControl(arg).getDefaultView()
  • Valor devuelto
    Tipo: Cadena. El valor del identificador de la vista predeterminada.

setDefaultView

Establece la vista predeterminada para el cuadro de diálogo de control de búsqueda.

Xrm.Page.getControl(arg).setDefaultView(viewGuid)
  • Argumentos
    Tipo: Cadena. El identificador de la vista que se establecerá como vista predeterminada.

Ejemplo: Esta función de setDefaultViewSample establecerá la vista predeterminada de búsqueda de contacto principal del formulario de entidad account en la vista Mis contactos activos.

function setDefaultViewSample() {
    Xrm.Page.getControl("primarycontactid").setDefaultView("{00000000-0000-0000-00AA-000010001003}");
}​

Evento PreSearch

Puede agregar o quitar controladores de eventos para el Evento PreSearch de control de búsqueda mediante los métodos addPreSearch y removePreSearch.

Use el evento PreSearch para controlar qué resultados se muestran para el control utilizando los datos de formulario actuales mientras el usuario comienza a buscar registros.

Ambos métodos tienen el Contexto de ejecución (referencia del lado del cliente) pasado como primer parámetro.

addPreSearch

Use este método para aplicar cambios a búsquedas basadas en valores actuales mientras el usuario está a punto de ver los resultados de la búsqueda.

Xrm.Page.getControl(arg).addPreSearch(handler)

  • Argumentos
    Tipo: Función a agregar.

  • Comentarios
    Este método solo está disponible para Entidades actualizadas.

El argumento es una función que se ejecutará justo antes de que se produzca la búsqueda para proporcionar resultados para una búsqueda. Puede usar este controlador para llamar a una de las otras funciones de control de búsqueda y mejorar los resultados que se mostrarán en la búsqueda.

removePreSearch

Use este método para quitar las funciones del controlador de eventos que se han establecido anteriormente para el evento PreSearch.

Xrm.Page.getControl(arg).removePreSearch(handler)

  • Argumentos
    Tipo: Función a quitar.

  • Comentarios
    Este método solo está disponible para Entidades actualizadas.

Notificación

Use estos métodos para mostrar y borrar notificaciones de un control.

setNotification

Muestra un mensaje de error para el control para indicar que los datos no son válidos. Cuando se usa este método, aparece un icono "X" rojo junto al control. En clientes móviles de Dynamics 365, si pulsa en el icono se mostrará el mensaje.

Xrm.Page.getControl(arg).setNotification(message,uniqueId)

Comentarios

Establecer una notificación de error en un control impedirá que se guarde el formulario.

Este método solo está disponible para Entidades actualizadas.

Argumentos

  • mensaje
    Tipo: Cadena: El mensaje para mostrar.

  • uniqueId
    Tipo: Cadena: El identificador que se usará para borrar sólo este mensaje al usar clearNotification. Opcional.

Valor de retorno

Tipo: Booleano: Indica si el método se realizó correctamente.

addNotification

Muestra una notificación de error o de recomendación para un control, y permite especificar acciones para ejecutar basadas en la notificación. Cuando especifica un tipo de error de notificación, un icono rojo” X” aparece junto al control. Cuando especifica un tipo de recomendación de notificación, un icono rojo ”i” aparece junto al control. En los clientes móviles de Dynamics 365, al pulsar en el icono se mostrará el mensaje, y le permitirá realizar la acción configurado haciendo clic en el botón Aplicar o descartar el mensaje.

Xrm.Page.getControl(arg).addNotification(object)

Comentarios

Al establecer una notificación de error se bloquea el guardado del formulario; al establecer una notificación de recomendación no se bloque el guardado del formulario.

Este método se introdujo en Actualización de diciembre de 2016 para Dynamics 365 (online y local), y solo está disponible para Entidades actualizadas.

Argumentos

El método acepta un objeto con los atributos siguientes:

Atributo

Tipo de datos

Requerido

Descripción

messages

Matriz

Sí

El mensaje que se mostrarán en la notificación. En la versión actual, sólo el primer mensaje especificado en esta matriz se mostrará. La cadena que especifique aquí aparece como texto en negrita en la notificación, y normalmente se usa para el título o el asunto de la notificación. Debe limitar el mensaje a 50 caracteres para una experiencia de usuario óptima.

notificationLevel

Cadena

No

Define el tipo de notificación. Los valores válidos son ERROR o RECOMMENDATION. Si no especifica este atributo en la definición de objeto, se establece en ERROR de forma predeterminada.

uniqueId

Cadena

No

El identificador que desea usar para anular esta notificación al usar clearNotification.

actions

Matriz de objetos

No

Una colección de objetos con los atributos siguientes:

  • message: Cadena. El mensaje secundario o del cuerpo de la notificación que se mostrará al usuario. Limite el mensaje a 100 caracteres para una experiencia de usuario óptima.

  • actions: Matriz. Las acciones correspondientes para el mensaje.

En la versión actual, solo se admiten el mensaje del cuerpo único y la acción correspondiente. Sin embargo, puede definir varias tareas para realizar con código JavaScript en el bloque de acciones.

Nota

El método addNotification muestra una notificación con los mensajes que ha especificado y dos botones estándar: Aplicar y Descartar. Al hacer clic en Aplicar se ejecuta la acción que define; al hacer clic en Descartar se cierra el mensaje de notificación.

Valor de retorno

Tipo: Booleano: Indica si el método se realizó correctamente.

Ejemplo

El siguiente código de ejemplo muestra una notificación en el campo Nombre de cuenta del formulario de cuentas para establecer el Símbolo del valor si el campo Nombre de cuenta contiene ”Microsoft”. Al hacer clic en Aplicar en la notificación se establecerá el campo Símbolo del valor como "MSFT".

function addTickerSymbolRecommendation() {
    var myControl = Xrm.Page.getControl('name');
    var accountName = Xrm.Page.data.entity.attributes.get('name');
    var tickerSymbol = Xrm.Page.data.entity.attributes.get('tickersymbol');

    if (accountName.getValue('Microsoft') && tickerSymbol.getValue() != 'MSFT') {
        var actionCollection = {
            message: 'Set the Ticker Symbol to MSFT?',
            actions: null
        };

        actionCollection.actions = [function () {
            tickerSymbol.setValue('MSFT');
            myControl.clearNotification('my_unique_id');
        }];

        myControl.addNotification({
            messages: ['Set Ticker Symbol'],
            notificationLevel: 'RECOMMENDATION',
            uniqueId: 'my_unique_id',
            actions: [actionCollection]
        });
    }
    else
        console.log("Notification not set");
}

clearNotification

Eliminar un mensaje que ya se muestra para un control.

Xrm.Page.getControl(arg).clearNotification(uniqueId)

Argumentos

  • uniqueId
    Tipo: Cadena: El identificador que se usará para borrar un mensaje específico que se estableció usando setNotification o addNotification.

    Si no se especifica el parámetro uniqueId, se quitará la notificación actual mostrada.

Comentarios

Este método solo está disponible para Entidades actualizadas.

Valor devuelto

Tipo: Booleano: Indica si el método se realizó correctamente.

Métodos de control de OptionSet

Use los métodos addOption, clearOptions y removeOption para manipular las opciones disponibles para los controles OptionSet.

addOption

Agrega una opción al control de un conjunto de opciones.

Xrm.Page.getControl(arg).addOption(option, [index])

Importante

Este método no comprueba si los valores en las opciones que agregue son válidos. Si agrega opciones no válidas no funcionarán correctamente. Debe agregar sólo las opciones que se han definido para el atributo del conjunto de opciones específico con el que está enlazado el control. Use el atributo getOptions o los métodos getOption para conseguir objetos de opción válidos para agregar mediante este método.

  • Argumentos

    • opción
      Tipo: Objeto: Un objeto de opción para agregar al OptionSet.

    • index
      Tipo: Número: (Opcional) La posición de índice para poner la nueva opción. Si no se proporciona, la opción se agregará al final.

clearOptions

Borra todas las opciones de un control de conjunto de opciones.

Xrm.Page.getControl(arg).clearOptions()

removeOption

Quita una opción de un control de conjunto de opciones.

Xrm.Page.getControl(arg).removeOption(number)
  • Argumentos
    Tipo: Número: El valor de la opción que desea quitar.

setFocus

Establece el enfoque en el control.

Xrm.Page.getControl(arg).setFocus()

ShowTime

Use setShowTime para especificar si un control de fecha debe mostrar la parte de hora de la fecha y use getShowTime para determinar si se muestra actualmente la parte de hora de la fecha.

getShowTime

Obtenga si un control de fecha muestra la parte de hora de la fecha.

Tipos de control: control estándar para los atributos datetime.

var showsTime = Xrm.Page.getControl(arg).getShowTime();

Comentarios

Este método se introdujo con Actualización 1 de Microsoft Dynamics CRM Online 2015.

setShowTime

Especifique si un control de fecha debe mostrar la parte de hora de la fecha.

Tipos de control: control estándar para los atributos datetime.

Xrm.Page.getControl(arg).setShowTime(bool)

Comentarios

Este método solo está disponible para Entidades actualizadas. Este método mostrarán u ocultará el componente de hora de un control de fecha donde el atributo usa el formato DateAndTime. Este método no tendrán efecto cuando se use el formato de DateOnly.

Métodos de control de subcuadrícula

Para los versiones anteriores a Actualización 1 de Microsoft Dynamics CRM Online 2015 el único método disponible para un control de subcuadrícula es refresh. Con Actualización 1 de CRM Online 2015 hay nuevas funciones que puede usar.Más información:Objetos y métodos de cuadrícula (solo lectura) (referencia del lado del cliente)

refresh

Actualiza los datos mostrados en una subcuadrícula.

Xrm.Page.getControl(arg).refresh()

Nota

El método de actualización no está disponibles en el formulario Evento OnLoad porque las subcuadrículas se cargan asincrónicamente. Con la subcuadrícula Evento OnLoad introducida en Actualización 1 de CRM Online 2015 ahora puede detectar cuando la subcuadrícula se carga y usar este método con los controladores de eventos para ese evento.

Visible

Determine qué controles son visibles y muéstrelos u ocúltelos mediante los métodos getVisible y setVisible.

getVisible

Devuelve un valor que indica si el control está visible actualmente.

Nota

Si la sección o la pestaña que contiene este control no está visible, este método aún puede devolver true. Para asegurarse de que el control realmente sea visible; también debe comprobar la visibilidad de los elementos que contiene.

Xrm.Page.getControl(arg).getVisible()
  • Valor devuelto
    Tipo: Booleano.True si el control está visible; false de lo contrario.

setVisible

Establece un valor que indica si el control está visible.

Xrm.Page.getControl(arg).setVisible(bool)
  • Argumentos
    Tipo: Booleano.True si el control debe ser visible; false de lo contrario.

Nota

Cuando muestra selectivamente campos a los usuarios en código que se ejecuta en el evento Onload, se recomienda configurar los campos para que no sean visibles de forma predeterminada y luego usar setVisible(true) para mostrar los campos cuando se dan las condiciones. El uso de setVisible(false) para ocultar campos en el evento Onload puede provocar que el campo aparezca brevemente al usuario antes de ocultarse.

Si está ocultando un mayor número de campos mediante setVisible(false), piense si puede agruparlos en pestañas o secciones y ocultar la pestaña o la sección en lugar de los campos de manera independiente. Esto puede mejorar el rendimiento.

Métodos de controles IFRAME y recursos web

Utilice estos métodos para interactuar con controles de recursos web e IFRAME.

Datos

Los recursos Web tienen un parámetro de cadena de consulta especial llamado data para transmitir datos personalizados. Los métodos getData y setData funcionan sólo para los recursos web de Silverlight agregados a un formulario.Más información:Paso de datos de un formulario a un recurso web de Silverlight incrustado

Para los recursos web de página web (HTML), el parámetro de datos puede extraerse desde el método getSrc o establecerse mediante el método setSrc.

Nota

Los métodos getData y setData no se admiten para el centro de servicio interactivo.

getData

Devuelve el valor del parámetro de la cadena de consulta de datos pasado un recurso web de Silverlight.

Xrm.Page.getControl(arg).getData()
  • Valor devuelto
    Tipo: Cadena. El valor de datos pasado al recurso web de Silverlight.

setData

Establece el valor del parámetro de la cadena de consulta de datos pasado un recurso web de Silverlight.

Xrm.Page.getControl(arg).setData(string)
  • Argumentos
    Tipo: Cadena. El valor de datos para pasar al recurso web de Silverlight.

getInitialUrl

Devuelve la dirección URL predeterminada que un control de IFRAME está configurado para mostrar. Este método no está disponible para recursos web.

Xrm.Page.getControl(arg).getInitialUrl()
  • Valor devuelto
    Tipo: Cadena. La dirección URL inicial.

getObject

Devuelve el objeto del formulario que representa el recurso web o I-frame.

Xrm.Page.getControl(arg).getObject()

  • Valor devuelto
    Tipo: Objeto. El objeto depende del tipo de control.

    Un IFRAME devuelve el elemento IFrame del Document Object Model (DOM).

    Un recurso web de Silverlight devolverá el elemento Objeto del DOM que representa el complemento Silverlight incrustado.

Src

Los IFRAMEs o recursos web tienen una propiedad src para definir qué mostrar en la ventana incrustada. Puede obtener o cambiar la propiedad src con los métodos getSrc y setSrc.

getSrc

Devuelve la dirección URL actual que se muestra en un recurso web o IFRAME.

Xrm.Page.getControl(arg).getSrc()
  • Valor devuelto
    Tipo: Cadena. Una dirección URL que representa la propiedad src del recursos web o IFRAME.

setSrc

Establece la dirección URL que se muestra en un recurso web o IFRAME.

Xrm.Page.getControl(arg).setSrc(string)
  • Argumentos
    Tipo: Cadena: La dirección URL.

Ver también

Referencia de programación del lado del cliente
Referencia de scripting de formularios
Xrm.Page.ui (referencia del lado del cliente)
Escriba código para formularios de Microsoft Dynamics 365
Use el modelo de objeto Xrm.Page

Microsoft Dynamics 365

© 2017 Microsoft. Todos los derechos reservados. Copyright