Pasar los datos de Microsoft Dynamics 365 desde una página como parámetro de las acciones de la cinta de opciones

  • Artículo

 

Publicado: enero de 2017

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

Cuando define una acción en una cinta de opciones, suele necesario pasar datos de la página como una función de JavaScript o una URL En este tema se describen las opciones para usar el elemento de <CrmParameter> (RibbonDiffXml) para recuperar estos valores.

Valores de la cuadrícula

La mayoría de los valores disponibles para el elemento de <CrmParameter> (RibbonDiffXml) se relacionan con el trabajo con datos que se muestran en una cuadrícula o gráfico de jerarquías. Mediante las opciones de la enumeración del atributo de Value, puede aislar fácilmente los elementos por:

  • Elementos seleccionados

    • SelectedControlSelectedItemCount

    • SelectedControlSelectedItemIds

    • SelectedControlSelectedItemReferences

  • Todos los elementos

    • SelectedControlAllItemCount

    • SelectedControlAllItemIds

    • SelectedControlAllItemReferences

  • Elementos no seleccionados

    • SelectedControlUnselectedItemCount

    • SelectedControlUnselectedItemIds

    • SelectedControlUnselectedItemReferences

Para cada una de estas agrupaciones, puede recopilar el número de elementos y de identificadores de GUID. Si está pasando los valores a una URL, también puede recuperar los objetos de EntityReference que contienen toda la información necesaria para identificar exclusivamente los objetos de la cuadrícula. Estos parámetros se aplican si la página vista es la cuadrícula principal (HomepageGrid) o una subcuadrícula situada en un formulario. Cuando se usa conjuntamente con el parámetro de SelectedEntityTypeName, tiene toda la información que debería tener que pasar a otra aplicación.

Valores de formulario

Con una cinta de opciones de formulario, puede usar la recopilación de Xrm.Page.data.entity.atributos y la recopilación de Xrm.Page.ui.controles para recuperar los valores de los campos conocidos. Sin embargo, si desea que pasar el valor de un campo de formulario seleccionado, tendrá que realizar un scripting mayor para obtener el valor.

Puede usar el parámetro de PrimaryControlId para obtener el Id del control que tiene foco cuando el control de la cinta de opciones recibe foco. Este Id es el valor de Document Object Model (DOM) Id . Para obtener el valor de los datos, tendrá que intentar usar ese valor mediante el código como el que se muestra en el siguiente ejemplo:

var focusFieldValue = Xrm.Page.ui.controls.get(PrimaryControlId).getAttribute().getValue()

Información de contexto

Además de los valores de los datos, puede recuperar la información de contexto adicional mediante <CrmParameter> (RibbonDiffXml).

Por motivos prácticos, las opciones del atributo de ValueOrgName, OrgLcid, y UserLcid están disponibles sin requerir el uso de Xrm.Page.context para usar los métodos de getOrgUniqueName, getOrgLcid, and getUserId. Para una acción de <Url> (RibbonDiffXml), también puede usar el atributo de PassParams para incluir información contextual.

Las opciones de ValuePrimaryEntityTypeName y FirstPrimaryItemId brindan información para un registro de entidad. Puede usar PrimaryItemIds para una cinta de opciones de HomepageGrid para obtener una lista de todos los elementos que se muestran.

Finalmente, puede usar el valor de CommandProperties para pasar los detalles del evento de control de la cinta de opciones. Puede usar esto para enviar información contextual a una función central donde las acciones específicas pueden determinarse en función del contexto del evento.

Ver también

Personalizar los comandos y la cinta de opciones
Pasar parámetros a una dirección URL con la cinta de opciones
<CrmParameter> (RibbonDiffXml)
<JavaScriptFunction> (RibbonDiffXml)
<Url> (RibbonDiffXml)
Definir acciones de la cinta de opciones
Definir acciones personalizadas para modificar la cinta de opciones

Microsoft Dynamics 365

© 2017 Microsoft. Todos los derechos reservados. Copyright