Möglichkeit zum Übergeben einer URL von Dynamics 365-Instanz an die Widgetbibliothek

Artikel
03/12/2024

Um auf die APIs des Dynamics 365 Framework zur Channel-Integration zugreifen zu können, müssen Sie die Datei msdyn_cilibrary.js in Ihr Kommunikations-Widget laden. Da das Widget in einer anderen Domäne ist, muss diese Bibliothek wissen, wie die Dynamics 365 Domäne interagieren soll. Aus diesem Grund müssen Sie Ihre Dynamics 365-Instanz URL in die Widgetbibliothek überführen.

Wichtig

Die Government Community Cloud wird nur im Kanalintegrationsframework 2.0 unterstützt. Für jede Organisation, die in der Government Community Cloud (GCC) oder Microsoft Cloud Germany gehostet wird, sollte die Provider-Domain entweder innerhalb der jeweiligen Cloud liegen oder für den Zugriff aus dieser Cloud zugelassen sind.

Eine Dynamics 365-URL zu einer Widget-Bibliothek kann mit einer der folgenden Methoden übergeben werden.

Durch das Hinzufügen von Attributen zu einem Skripttag.
URL-Parameter hinzufügen.

Durch das Hinzufügen von Attributen zu einem Skripttag

Der Widgetanbieter muss die folgenden Attribute dem Skripttag hinzufügen, das msdyn_cilibrary.js lädt und an die Dynamics 365-Domäne weitergibt.:

data-cifid: CIFMainLibrary
data-crmurl: <CRM domain name>

Beispiel

<script type="text/javascript" src="https://crmorg.crm.dynamics.com/webresources/Widget/msdyn_ciLibrary.js" data-crmurl="https://crmorg.crm.dynamics.com" data-cifid="CIFMainLibrary">
</script>

URL-Parameter hinzufügen

Eine weitere Methode ist es, einen ucilib Parameter an die Start-URL weiterzugeben, wie ucilib=https://crmorg.crm.dynamics.com/webresources/Widget/msdyn_ciLibrary.js.