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

  • Artikel

 

Veröffentlicht: November 2016

Gilt für: Dynamics CRM 2015

Mithilfe von über URL adressierbaren Elementen können Sie Links zu Microsoft Dynamics 365-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.

Hinweis

  • Über URL adressierbare Formulare, Ansichten, Dialoge und Berichte können die Microsoft Dynamics 365-Sicherheit nicht umgehen. Nur lizenzierte Microsoft Dynamics 365-Benutzer können, basierend auf ihren Sicherheitsrollen, auf die angezeigten Datensätze und Daten zugreifen.

  • Verwenden Sie Xrm.Utility.openEntityForm, wenn Sie Entitätsformulare prgogrammgesteuert in der Anwendung öffnen, indem Sie Webressourcen verwenden. Verwenden Sie nicht window.open.

  • Verwenden Sie außerhalb der Anwendung, wo Seiten keinen Zugriff auf die Funktion Xrm.Utility.openEntityForm haben, window.open oder einen Link, um einen bestimmten Datensatz oder ein bestimmtes Formular für eine Entität zu öffnen. Die gesamte Anwendung wird für eine der Aktualisierte Entitäten geöffnet.

In diesem Thema

Über URL adressierbare Formulare und Ansichten

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

  • Kopieren der URL für eine Ansicht

  • Anzeigen einer Ansicht in der Anwendungsnavigation mithilfe der Siteübersicht

Öffnen eines Dialogprozess durch Verwendung einer URL

Öffnen eines Berichts durch Verwendung einer URL

Ü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 Microsoft Dynamics 365:

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

  • So öffnen Sie ein Entitätsdatensatzformular des Kontos für Microsoft Dynamics CRM Online, wobei die ID {91330924-802A-4B0D-A900-34FD9D790829} lautet:

    http://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 Microsoft Dynamics CRM Online:

    http://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 Microsoft Dynamics CRM Online ohne Navigations- oder Befehlsleiste

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

Hinweis

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

Beim Anzeigen eines Entitätsformulars mit einem IFrame, das eingebettet in einem anderen Entitätsformular ist, wird nicht unterstützt.

Sie können in der Regel die d7d0b052-abca-4f81-9b86-0b9dc5e62a66#BKMK_getClientUrl-Methode verwenden, um die URL des Organisationsstamms für die lokale Version Microsoft Dynamics 365 und für Microsoft Dynamics CRM Online 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:

<http://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

etn

Der logische Name der Entität.

Wichtig

Verwenden Sie nicht den etc (Entitätstypcode)-Parameter, der einen ganzzahligen 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 Festlegen von Feldwerten mithilfe von Parametern, die an ein Formular übergeben werden.

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 im Parameter extraqs an: formid%3D6009c1fe-ae99-4a41-a59f-a6f1cf8b9daf%0D%0A.

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”, z. B. {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 Funktion unterstützt die Anforderungen für die Unified Service Desk für Microsoft Dynamics 365-Anwendung.
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 Microsoft Dynamics 365 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.

Hinweis

Verwenden Sie diese URL nicht, um die Ansicht in der Anwendungsnavigation mithilfe der Siteübersicht einzuschließen. Weitere Informationen 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 Editor ein, und bearbeiten Sie ihn, um nur den URL-Teil des gewünschten Textes zu extrahieren.

Hinweis

  • 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 Microsoft Dynamics 365. Die GUID für benutzerdefinierte Entitäten und benutzerdefinierte Ansichten ist für jede Installation von Microsoft Dynamics 365 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> (SiteMap)-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.

Url=“/_root/homepage.aspx?etn=<entity logical name >&amp;viewid=%7b<GUID value of view id>%7d”

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

Hinweis

Wenn Sie die Ansicht mithilfe der /_root/homepage.aspx-Seite angeben, wird die Ansichtsauswahl weiterhin angezeigt. Wenn der Benutzer die Ansicht ändert, merkt sich Microsoft Dynamics 365 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 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]

Um beispielsweise den Dialog mit der ID ={6A6E93C9-1FE6-4C07-91A9-E0E2A7C70976} mit der Kontendatensatz-ID = {40C9ADFD-90A8-DF11-840E-00155DBA380F} zu ö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. Dies liegt daran, dass andere Browser keine window.close-Methode bereitstellen, wenn das Fenster nicht mithilfe von JavaScript von 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:

  • Aktion
    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 Microsoft Dynamics 365 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 Microsoft Dynamics 365 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

Schreiben von Client-Anwendungserweiterungen
Festlegen von Feldwerten mithilfe von Parametern, die an ein Formular übergeben werden
Ein Formular konfigurieren, um benutzerdefinierte Abfragezeichenfolgenparameter zu akzeptieren.
Änderungsantragnavigation mithilfe von SiteMap
Anpassen von Befehlen und des Menübands
Schreiben von Code für Microsoft Dynamics CRM 2015-Formulare
Webressourcen für Microsoft Dynamics CRM 2015
Starten eines Dialogfelds mit einer URL

© 2017 Microsoft. Alle Rechte vorbehalten. Copyright