Objeto Xrm de API de cliente para aplicaciones basadas en modelos

Puede usar el objeto Xrm de api de cliente en el código sin el contexto de ejecución. Use sus espacios de nombres para navegar por formularios, administrar registros con la API web, usar funcionalidades de dispositivo y recuperar contexto global en aplicaciones controladas por modelos.

Modelo de objetos Xrm

En la siguiente ilustración se muestra el modelo de objetos Xrm:

Captura de pantalla del modelo de objetos Xrm de la API de cliente en la que se muestran sus espacios de nombres.

Esta es la información acerca de cada uno de los espacios de nombre en el objeto Xrm:

Espacio de nombres Descripción
Xrm.App Proporciona métodos relacionados con la aplicación.
Xrm.Copilot Proporciona métodos para interactuar con Microsoft Copilot en Power Apps controladas por modelos, incluidas las API en versión preliminar para ejecutar temas de Microsoft Copilot Studio registrados.
Xrm.Device Proporciona los métodos para usar las capacidades nativas del dispositivo.
Xrm.Encoding Proporciona métodos para codificar cadenas.
Xrm.Navigation Proporciona métodos para navegar por los formularios y los elementos de aplicaciones basadas en modelos.
Xrm.Panel Proporciona un método para mostrar una página web en el panel lateral del formulario de aplicaciones basadas en modelo.
Xrm.Utility Proporciona un contenedor para métodos útiles.
Xrm.WebApi Proporciona métodos para usar las API web para crear y administrar registros y ejecutar las funciones y las acciones de las API web.

Xrm.WebApi.offline: Proporciona métodos para crear y administrar registros en los clientes móviles de aplicaciones basadas en modelos mientras se trabaja en modo sin conexión.

Xrm.WebApi.online: Proporciona métodos para usar la API web para crear y administrar registros y ejecutar acciones y funciones de la API web cuando se establece conexión con el servidor.

Contexto global de la API del cliente

Use el método Xrm.Utility.getGlobalContext en formularios para recuperar información específica de una organización, un usuario o el cliente donde se ejecuta el script sin pasar por el contexto de ejecución del formulario. El uso del método getGlobalContext es un cambio frente a las versiones anteriores donde había que usar el contexto de formulario para recuperar contexto global usando Xrm.Page.context.

Nota

Xrm.Page.context está obsoleto en la versión actual y ahora debe usar el nuevo método Xrm.Utility.getGlobalContext para obtener el contexto global en su código versión 9.0 o posterior.

Para acceder a la información de contexto global en un recurso web HTML independiente, incluya una referencia a ClientGlobalContext.js.aspx en el recurso web y, a continuación, use la función GetGlobalContext . Para obtener más información, vea Función GetGlobalContext y ClientGlobalContext.js.aspx.

Comprender el modelo de objetos de la API de cliente
API de cliente en desuso

  • Se actualizó por última vez el