Öffnen von Formularen, Ansichten, Dialogen und Berichten mit einer URL
Veröffentlicht: Januar 2017
Gilt für: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
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=entityrecordSo öffnen Sie ein Entitätsdatensatzformular des Kontos für Microsoft Dynamics 365 (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%7DSo öffnen Sie die Ansicht Geschlossene Verkaufschancen für Microsoft Dynamics 365 (online):
http://myorg.crm.dynamics.com/main.aspx?etn=opportunity&pagetype=entitylist&viewid=%7b00000000-0000-0000-00AA-000010003006%7d&viewtype=1039So öffnen Sie die Ansicht Aktive Kontakte für Microsoft Dynamics 365 (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 getClientUrl-Methode verwenden, um die URL des Organisationsstamms für die lokale Version Microsoft Dynamics 365 und für Microsoft Dynamics 365 (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:
|
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:
|
navbar |
Steuert, ob die Navigationsleiste angezeigt wird und ob Anwendungsnavigation über die in der Siteübersicht definierten Bereiche und Unterbereiche verfügbar ist.
|
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.
|
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
Öffnen Sie die Ansicht, die Sie verwenden möchten.
Klicken Sie auf der Befehlsleiste auf Link senden und anschließend auf Für aktuelle Ansicht.
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 >&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 klicken Sie anschließend in den Optionen unter Aktionen in der Befehlsleiste auf Link kopieren. 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
Erweitern von Microsoft Dynamics 365 auf dem Client
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 365-Formulare
Webressourcen für Microsoft Dynamics 365
Starten eines Dialogfelds mit einer URL
Microsoft Dynamics 365
© 2017 Microsoft. Alle Rechte vorbehalten. Copyright