Öffnen von Formularen, Ansichten, Dialogen und Berichten mit einer URL

Mithilfe von über URL-adressierbaren Elementen können Sie Links zu Dynamics 365 Customer Engagement (on-premises)-Formularen, -Ansichten, -Dialogfeldern und -Berichten in andere Anwendungen einfügen. Auf diese Art und Weise können Sie andere Anwendungen, Berichte oder Websites einfach erweitern, sodass die Benutzer Informationen anzeigen und Aktionen ausführen können, ohne die Anwendungen zu wechseln.

Über URL adressierbare Formulare und Ansichten

Alle Entitätsformulare und -ansichten werden in der main.aspx-Seite angezeigt. Abfragezeichenfolgen-Parameter, die an dieses Seitensteuerelement übergeben wurden, werden angezeigt. Beispiel:

So öffnen Sie ein neues Entitätsdatensatzformular des Kontos für eine lokale Version von Dynamics 365 Customer Engagement (on-premises):

https://mycrm/myOrg/main.aspx?etn=account&pagetype=entityrecord  

So öffnen Sie ein Formular für den Datensatz einer Entität für Dynamics 365 for Customer Engagement, bei dem die ID {91330924-802A-4B0D-A900-34FD9D790829} lautet:

https://myorg.crm.dynamics.com/main.aspx?etn=account&pagetype=entityrecord&id=%7B91330924-802A-4B0D-A900-34FD9D790829%7D  

So öffnen Sie die Ansicht Geschlossene Verkaufschancen für Dynamics 365 for Customer Engagement:

https://myorg.crm.dynamics.com/main.aspx?etn=opportunity&pagetype=entitylist&viewid=%7b00000000-0000-0000-00AA-000010003006%7d&viewtype=1039  

So öffnen Sie die Ansicht Aktive Kontakte für Dynamics 365 for Customer Engagement ohne Navigationsleiste oder Befehlsleiste

https://myorg.crm.dynamics.com/main.aspx?etn=contact&pagetype=entitylist&viewid={00000000-0000-0000-00AA-000010001004}&viewtype=1039&navbar=off&cmdbar=false  

Sie können in der Regel die getClientUrl-Methode verwenden, um die URL des Organisationsstamms für die lokale Version von Dynamics 365 Customer Engagement (on-premises) und Dynamics 365 for Customer Engagement abzurufen.

Abfragezeichenfolgen-Parameter für die main.aspx-Seite

Die folgenden Abfragezeichenfolgen-Parameter werden mit der main.aspx-Seite verwendet, um Entitätsformulare oder -ansichten zu öffnen:

Kopieren der URL für eine Ansicht

Viele Ansichten in Dynamics 365 Customer Engagement (on-premises) ermöglichen es einem Benutzer, die URL für eine bestimmte Ansicht zu kopieren oder eine E-Mail zu senden, in der die URL für eine bestimmte Ansicht in der Nachricht eingebettet ist. Diese Funktion vereinfacht die Kommunikation zwischen Benutzern und ermöglicht es Ihnen, auf eine URL für eine Ansicht zuzugreifen, die Benutzer in einer anderen Anwendung, z. B. in einer SharePoint-Website, einschließen können.

Die Seite, die durch die URL angezeigt wird, umfasst die vollständige Ansicht. Hierzu zählen das Menüband, jedoch nicht die Anwendungsnavigation.

Abrufen der URL für eine Ansicht

1. Öffnen Sie die Ansicht, die Sie verwenden möchten.

2. Klicken Sie auf der Befehlsleiste auf Link senden und anschließend auf Für aktuelle Ansicht.

3. Fügen Sie den Link in Notepad ein, und bearbeiten Sie ihn, um nur den URL-Teil des gewünschten Textes zu extrahieren.

Anzeigen einer Ansicht in der Anwendungsnavigation mithilfe der Siteübersicht

Wenn Sie die Anwendungsnavigation mithilfe der Siteübersicht anpassen, verwenden Sie nicht die Ansicht-URL, die Sie aus der Anwendung mithilfe der Schritte in Kopieren der URL für eine Ansicht kopiert haben, um die URL festzulegen. Mit dieser URL wird eine Seite angezeigt, die das Menüband enthält und zu unerwünschten Ergebnissen führt, wenn sie in einem <SubArea>-URL-Attribut verwendet wird.

Wenn Sie eine Liste von Entitätsdatensätzen innerhalb der Anwendung für einen Unterbereich anzeigen möchten, legen Sie den Entitätsattributwert fest. Dadurch wird die standardmäßige Ansicht für diese Entität mit dem richtigen Titel und Symbol angezeigt.

Wenn Sie jedoch ein SubArea-Element wünschen, das eine bestimmte Standard-Anfangsansicht verwendet, verwenden Sie folgendes URL-Muster, wenn Sie mit der einheitlichen Oberfläche arbeiten.

[Organization Url]/main.aspx?pagetype=entitylist&etn=<entity logical name >&viewid=%7b00000000-0000-0000-0000-000000000000%7d&viewType=1039

Für den Vorgängerwebclient verwenden Sie die folgende URL.

[Organization Url]/homepage.aspx?etn=<entity logical name >&viewid=%7b00000000-0000-0000-0000-000000000000%7d  

Wenn Sie diese URL verwenden, müssen Sie außerdem entsprechende Werte für <Titles> und <Descriptions> sowie ein Symbol für die Entität angeben.

Öffnen eines Dialogprozess durch Verwendung einer URL

Eine gebräuchliche Anpassung besteht darin, einem Benutzer die Möglichkeit zu geben, einen bestimmten Dialogprozess im Kontext eines bestimmten Datensatzes zu öffnen. Beispielsweise können Sie eine benutzerdefinierte Schaltfläche zum Menüband für eine bestimmte Entität mithilfe des ID-Werts für den aktuellen Datensatz als Eingabeparameter für den Dialogprozess hinzufügen.

Zum Öffnen eines Dialogs ist Folgendes erforderlich:

• Der eindeutige Bezeichner für den Dialog.

• Der logische Name für die Entität, für die der Dialog erstellt wird.

• Der eindeutige Bezeichner für den Datensatztyp, für den der Dialog ausgeführt werden soll.

Das folgende Beispiel zeigt die URL und Abfragezeichenfolgen-Parameter zum Öffnen eines Dialogs:

[organization url]/cs/dialog/rundialog.aspx?DialogId=[dialog unique identifier]&EntityName=[entity logical name]&ObjectId=[unique identifier for the record]  

Wenn Sie beispielsweise den Dialog mit der ID = {6A6E93C9-1FE6-4C07-91A9-E0E2A7C70976} mit der Firmendatensatz-ID = {40C9ADFD-90A8-DF11-840E-00155DBA380F} öffnen, verwenden Sie die URL im folgenden Beispiel.

[organization url]/cs/dialog/rundialog.aspx?DialogId=%7b6A6E93C9-1FE6-4C07-91A9-E0E2A7C70976%7d&EntityName=account&ObjectId=%7b40C9ADFD-90A8-DF11-840E-00155DBA380F%7d  

Sie können eine JavaScript-Funktion erstellen, um den Dialog wie im folgenden Beispiel gezeigt zu öffnen:

function openDialogProcess(dialogId, entityName, objectId)  
{  
 var url = Xrm.Page.context.getClientUrl() +  
  "/cs/dialog/rundialog.aspx?DialogId=" +  
  dialogId + "&EntityName=" +  
  entityName + "&ObjectId=" +  
  objectId;  
 window.open(url);  
}  

Öffnen eines Berichts durch Verwendung einer URL

Sie können einen Bericht öffnen, indem Sie die entsprechenden Parameterwerte an die folgende URL übergeben: [organization url]/crmreports/viewer/viewer.aspx.

Diese URL akzeptiert die folgenden Parameter:

action
Zwei mögliche Werte für diesen Parameter lauten run oder filter. Wenn run verwendet wird, wird der Bericht mit den Standardfiltern angezeigt. Wenn filter verwendet wird, zeigt der Bericht einen Filter an, den der Benutzer bearbeiten kann, bevor er auf die Schaltfläche Bericht ausführen klickt, um den Bericht anzuzeigen.

helpID
Dieser Parameter ist optional. Für Berichte, die in Dynamics 365 Customer Engagement (on-premises) enthalten sind, lässt der Wert in diesem Parameter zu, dass über die Schaltfläche Hilfe entsprechender Inhalt zu diesem Bericht angezeigt wird, wenn Hilfe zu dieser Seite ausgewählt ist. Der Wert sollte dem FileName-Attributwert des Berichts entsprechen.

id
Dieser Parameter ist der ReportId-Attributwert des Berichts.

Die folgenden Beispiele zeigen URLs, die zum Öffnen von Berichten in Dynamics 365 Customer Engagement (on-premises) verwendet werden können.

Öffnen Sie den Bericht Vernachlässigte Anfragen mithilfe des Standardfilters:

[organization url]/crmreports/viewer/viewer.aspx?action=run&helpID=Neglected%20Cases.rdl&id=%7b8c9f3e6f-7839-e211-831e-00155db7d98f%7d  

Öffnen Sie den Bericht Topauswahl - Wissensdatenbankartikel, und fordern Sie den Benutzer auf, Filterwerte festzulegen:

[organization url]/crmreports/viewer/viewer.aspx?action=filter&helpID=Top%20Knowledge%20Base%20Articles.rdl&id=%7bd84ec390-7839-e211-831e-00155db7d98f%7d  

Die folgende Funktion zeigt, wie Werte in der URL ordnungsgemäß codiert werden:

function getReportURL(action,fileName,id) {  
 var orgUrl = GetGlobalContext().getClientUrl();  
 var reportUrl = orgUrl +   
  "/crmreports/viewer/viewer.aspx?action=" +  
  encodeURIComponent(action) +  
  "&helpID=" +  
  encodeURIComponent(fileName) +  
  "&id=%7b" +  
  encodeURIComponent(id) +  
  "%7d";  
 return reportUrl;  
}  

Siehe auch

Erweitern von Dynamics 365 Customer Engagement (on-premises) auf dem Client
Festlegen von Feldwerten mithilfe von Parametern, die an ein Formular übergeben werden
Ein Formular konfigurieren, um benutzerdefinierte Abfragezeichenfolgenparameter zu akzeptieren.
Anwendungsnavigation mithilfe von SiteMap ändern
Anpassen des Menübands für Dynamics 365 Customer Engagement (on-premises)Client Scripting in Customer Engagement mit JavaScriptWeb-Ressourcen für Dynamics 365 Customer Engagement (on-premises)
Starten eines Dialogfelds mit einer URL