Client-API-Xrm-Objekt für modellgesteuerte Apps

Sie können das Xrm-Objekt der Client-API in Ihrem Code ohne ausführungskontext verwenden. Verwenden Sie seine Namespaces, um in Formularen zu navigieren, Datensätze mit der Web-API zu verwalten, Gerätefunktionen zu verwenden und den globalen Kontext in modellgesteuerten Apps abzurufen.

Xrm-Objektmodell

Die folgende Abbildung stellt das Xrm-Objektmodell dar:

Screenshot des Xrm-Objektmodells der Client-API mit seinen Namespaces.

Hier sind die Informationen über die Namespaces im Xrm-Objekt:

Namespace Beschreibung
Xrm.App Stellt appbezogene Methoden zur Verfügung.
Xrm.Copilot Stellt Methoden für die Interaktion mit Microsoft Copilot in modellgesteuerten Power Apps bereit, einschließlich Vorschau-APIs zum Ausführen registrierter Microsoft Copilot Studio Themen.
Xrm.Device Bietet Methoden zur Verwendung der nativen Gerätefunktionen.
Xrm.Encoding Stellt Methoden zur Verfügung, um Zeichenfolgen zu kodieren.
Xrm.Navigation Bietet Methoden zum Navigieren von Formularen und Elementen in modellgesteuerten Anwendungen.
Xrm.Panel Bietet eine Methode zum Anzeigen einer Webseite im Seitenbereich des modellgesteuerten App-Formulars.
Xrm.Utility Stellt einen Container für nützliche Methoden bereit.
Xrm.WebApi Stellt Methoden zur Verwendung der Web-API bereit, um Datensätze zu erstellen und zu verwalten sowie Web-API-Aktionen und -Funktionen auszuführen.

Xrm.WebApi.offline: Stellt Methoden zur Verfügung, mit denen im Offlinemodus Datensätze in den mobilen Clients modellgesteuerter Apps erstellt und verwaltet werden können.

Xrm.WebApi.online: Stellt Methoden zur Verwendung der Web-API, um Datensätze zu schaffen und zu verwalten und die Web-API-Aktionen und -Funktionen bei der Verbindung mit dem Server auszuführen, bereit.

Globaler Kontext der Client-API

Verwenden Sie die Xrm.Utility.getGlobalContext-Methode in Formularen zum Abrufen von Informationen, die für eine Organisation, einen Benutzer oder den Client spezifisch sind, in dem Skript ausgeführt wird, ohne den Formularausführungskontext zu durchlaufen. Die Verwendung der getGlobalContext-Methode ist eine Änderung gegenüber früheren Versionen, wobei Sie den Formularkontext zu verwenden hatten, um den globalen Kontext mithilfe von Xrm.Page.context abzurufen.

Anmerkung

Xrm.Page.context ist in der aktuellen Version veraltet, und Sie sollten nun die neue Methode Xrm.Utility.getGlobalContext verwenden, um den globalen Kontext in Ihrem Code abzurufen, der auf Version 9.0 oder höher abzielt.

Um auf die globalen Kontextinformationen in einer eigenständigen HTML-Webressource zuzugreifen, fügen Sie einen Verweis auf ClientGlobalContext.js.aspx in die Webressource ein, und verwenden Sie dann die GetGlobalContext-Funktion . Weitere Informationen finden Sie unter GetGlobalContext-Funktion und ClientGlobalContext.js.aspx.

Das Client-API-Objektmodell verstehen
Veraltete Client-APIs