Freigeben über


Ö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.

Notiz

  • Über URL adressierbare Formulare, Ansichten, Dialoge und Berichte können die Dynamics 365 Customer Engagement (on-premises)-Sicherheit nicht umgehen. Nur lizenzierte Dynamics 365 Customer Engagement (on-premises)-Benutzer können, basierend auf ihren Sicherheitsrollen, auf die angezeigten Datensätze und Daten zugreifen.
    • Verwenden Sie Xrm.Navigation.openForm, wenn Sie Entitätsformulare programmgesteuert in der Anwendung öffnen, indem Sie Webressourcen verwenden. Nicht window.open verwenden.
    • Verwenden Sie außerhalb der Anwendung, wo Seiten keinen Zugriff auf die Funktion Xrm.Navigation.openForm haben, window.open oder einen Link, um einen bestimmten Datensatz oder ein bestimmtes Formular für eine Entität zu öffnen.

Ü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  

Notiz

Das Öffnen von Entitätsformularen in einem Dialogfenster mithilfe von showModalDialog oder showModelessDialog wird nicht unterstützt.

Das Anzeigen eines Entitätsformulars mit einem iFrame, der eingebettet in einem anderen Entitätsformular ist, wird nicht unterstützt.

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

Tipp

Um den ID-Wert für einen Datensatz zu erhalten, verwenden Sie die Schaltfläche Link senden in der Befehlsleiste. Im Folgenden finden Sie ein Beispiel dafür, was in der E-Mail-Anwendung geöffnet wird:

<https://mycrm/myOrg/main.aspx?etc=4&id=%7b899D4FCF-F4D3-E011-9D26-00155DBA3819%7d&pagetype=entityrecord>.

Der ID-Parameter, der an die URL übergeben wird, ist der codierte ID-Wert für den Datensatz. In diesem Beispiel lautet der ID-Wert {899D4FCF-F4D3-E011-9D26-00155DBA3819}. Die codierte Version der GUID ersetzt die öffnenden und schließenden Klammern “{” und “}” durch “%7B” bzw. “%7D”.

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

Parameter Beschreibung des Dataflows
etn Der logische Name der Entität. Wichtig: Verwenden Sie nicht den Parameter etc (Entitätstyp-Code), der einen Integer-Code für die Entität enthält. Dieser ganzzahlige Code für benutzerdefinierte Entitäten kann sich in den verschiedenen Organisationen unterscheiden.
extraqs Optional für Formulare. Dieser Parameter enthält codierte Parameter innerhalb dieses Parameters.

Verwenden Sie diesen Parameter, um Werte an ein Formular zu übergeben. Weitere Informationen finden Sie unter Legen Feldwerte unter Verwendung der Parameter festgelegt, die an ein Formular übergeben wurden.

Wenn eine Entität über mehr als ein Formular verfügt, können Sie diesen Parameter verwenden, um anzugeben, welches Formular geöffnet werden soll, indem Sie den codierten Parameter formid mit einem Wert übergeben, der dem ID-Wert des Formulars entspricht. Wenn Sie beispielsweise ein Formular mit der ID „6009c1fe-ae99-4a41-a59f-a6f1cf8b9daf“ öffnen möchten, geben Sie diesen Wert extraqs im Parameter formid%3D6009c1fe-ae99-4a41-a59f-a6f1cf8b9daf%0D%0A an.
pagetype Der Typ der Seite. Es gibt zwei mögliche Werte:

- entityrecord
Zeigt ein Entitätsdatensatzformular an.
- entitylist
Zeigt eine Entitätsansicht an.
id Optional für Formulare. Verwenden Sie diese Option, wenn Sie einen bestimmten Datensatz öffnen möchten. Übergeben Sie den codierten GUID-Bezeichner für die Entität. Die codierte Version der GUID ersetzt die öffnenden und schließenden Klammern “{“ und “}” durch “%7B” bzw. “%7D” für Beispiel {91330924-802A-4B0D-A900-34FD9D790829} ist %7B91330924-802A-4B0D-A900-34FD9D790829%7D.
viewid Erforderlich für Ansichten. Dies ist die ID des savedquery- oder userquery-Datensatzes, der die Ansicht definiert. Die einfachste Möglichkeit, die URL für eine Ansicht zu erhalten, ist sie zu kopieren. Weitere Informationen finden Sie unter Kopieren der URL für eine Ansicht.
viewtype Definiert den Typ der Ansicht. Verfügbare mögliche Werte:

- 1039
Verwenden Sie diesen Wert für eine Systemansicht. Die viewid stellt die ID eines savedquery-Datensatzes dar.
- 4230
Verwenden Sie diesen Wert für eine persönliche Ansicht. Die viewid stellt die ID eines userquery-Datensatzes dar.
navbar Steuert, ob die Navigationsleiste angezeigt wird und ob Anwendungsnavigation über die in der Siteübersicht definierten Bereiche und Unterbereiche verfügbar ist.

- on
Die Navigationsleiste wird angezeigt. Dies ist das Standardverhalten, wenn der Parameter navbar nicht verwendet wird.
- off
Die Navigationsleiste wird nicht angezeigt. Benutzer können andere Benutzeroberflächenelemente oder die Schaltflächen Zurück und Weiter für die Navigation verwenden.
- entity
In einem Entitätsformular sind nur die Navigationsoptionen für verknüpfte Entitäten verfügbar. Nach der Navigation zu einer verknüpften Entität wird die Schaltfläche Zurück in der Navigationsleiste angezeigt, mit der Sie zum ursprünglichen Datensatz zurückkehren können.
cmdbar Steuert, ob die Befehlsleiste angezeigt wird. Hinweis: Diese Funktionalität unterstützt die Anforderungen für die Anwendung Unified Service Desk für Dynamics 365. Die Verwendung, um eine Entität in einem IFrame anzuzeigen, das eingebettet in einem anderen Entitätsformular ist, wird nicht unterstützt.

- true
Die Befehlsleiste wird angezeigt. Dies ist die Standardeinstellung.
- false
Die Befehlsleiste wird ausgeblendet.

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.

Notiz

Verwenden Sie diese URL nicht, um die Ansicht in der Anwendungsnavigation mithilfe der Siteübersicht einzuschließen. Informationen hierzu finden Sie unter Anzeigen einer Ansicht in der Anwendungsnavigation mithilfe der Siteübersicht.

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.

Notiz

  • Ansichten, die den Benutzerkontext als Parameter verwenden, beispielsweise Meine Konten, können nicht kopiert werden.
    • Die GUID, die Systemansichten für Systementitäten darstellt, entspricht dann der lokalen Installation von Dynamics 365 Customer Engagement (on-premises). Die GUID für benutzerdefinierte Entitäten und benutzerdefinierte Ansichten ist für jede Installation von Dynamics 365 Customer Engagement (on-premises) eindeutig.

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.

Notiz

Wenn Sie die Ansicht mithilfe der .../homepage.aspx-Seite angeben, wird die Ansichtsauswahl weiterhin angezeigt. Wenn der Benutzer die Ansicht ändert, merkt sich Dynamics 365 Customer Engagement (on-premises) die aktuellste Auswahl des Benutzers, und die Standard-Anfangsansicht wird angezeigt, nachdem der Benutzer den Browser geschlossen erneut geöffnet hat.

Ö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.

Tipp

Um den eindeutigen Bezeichner für den Dialog abzurufen, navigieren Sie zu Einstellungen, und wählen Sie in der Standardlösung Prozesse aus. Wählen Sie einen Prozess aus, und wählen Sie anschließend in den Optionen unter Aktionen in der Befehlsleiste Link kopieren aus. Dadurch wird ein Link zum Bearbeiten des Dialogfelds in die Zwischenablage kopiert, beispielsweise [Organisations-URL]/sfa/workflow/edit.aspx?id=%7b6A6E93C9-1FE6-4C07-91A9-E0E2A7C70976%7d.

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  

Tipp

Wenn ein Dialogprozess über einen Link geöffnet wird, funktioniert bei anderen Webbrowsern als Internet Explorer die Schaltfläche Fertig stellen unter Umständen nicht. Die Daten werden gespeichert, aber der Benutzer muss im Fenster auf die Schaltfläche Schließen klicken, um es zu schließen. Das liegt daran, dass andere Browser keine window.close-Methode anbieten, wenn das Fenster nicht mit JavaScript aus einem anderen Fenster geöffnet wird. Verwenden Sie nach Möglichkeit JavaScript und die window.open-Methode, um Dialogprozesse zu öffnen, statt nur Links zur Verfügung zu stellen.

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