Öffnen von Apps, Formularen, Ansichten, Dialogen und Berichten mit einer URL
Mithilfe von über URL-adressierbaren Elementen können Sie Links zu Formularen, Ansichten, Dialogfeldern und Berichten modellgesteuerter Apps in andere Anwendungen einfügen.
Hinweis
Über URL adressierbare Apps, Formulare, Ansichten, Dialoge und Berichte können die Sicherheit nicht umgehen. Nur lizenzierte Benutzer können, basierend auf ihren Sicherheitsrollen, auf die angezeigten Datensätze und Daten zugreifen.
App-URLs
Hinweis
Das Einbetten einer modellgesteuerten Anwendung in einen IFrame in einer anderen Anwendung wird nicht unterstützt. Siehe Einbetten modellgesteuerter Apps.
Sie können jede modellgesteuerte Anwendung mit den Werten AppModule.UniqueName oder AppModule.AppModuleId öffnen.
Sie können diese Werte mithilfe der Web-API mithilfe der folgenden Abfrage abrufen:
GET [Organization URI]/api/data/v9.1/appmodules?$select=appmoduleid,uniquename
Weitere Informationen: Datenabfragen mithilfe der Web-API
Sie können entweder die Abfrageparameter appname
oder appid
mit den Werten Unique Name bzw. AppModuleId verwenden, aber Sie können nicht beide gleichzeitig verwenden.
Einen eindeutigen Namen verwenden
Um die App mithilfe des eindeutigen Namens zu öffnen, hängen Sie den appname
Abfrageparameter an die main.aspx
Seite an.
https://myorg.crm.dynamics.com/main.aspx?appname={UniqueName}
Wenn beispielsweise der eindeutige Name msdyn_SolutionHealthHub
lautet, können Sie diese App über diese URL öffnen:
https://myorg.crm.dynamics.com/main.aspx?appname=msdyn_SolutionHealthHub
AppModuleId verwenden
Anhängen der appid
Abfrageparameter an die main.aspx
Seite, um die App mit dem AppModuleId zu öffnen.
https://myorg.crm.dynamics.com/main.aspx?appid={AppModuleId}
Zum Beispiel:
https://myorg.crm.dynamics.com/main.aspx?appid=12fd1cf3-e06e-e911-a95f-000d3a13c42a
Ü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. Zum Beispiel:
So öffnen Sie ein Kontodatensatzformular, 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:
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 ohne Navigations- 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
Hinweis
- Verwenden Sie
Xrm.Navigation.
navigateTo oderXrm.Navigation.
openForm, wenn Sie Entitätsformulare programmgesteuert in der Anwendung öffnen, indem Sie Webressourcen verwenden. Verwenden Sie nichtwindow.open
. - Verwenden Sie außerhalb der Anwendung, wo Seiten keinen Zugriff auf die Funktion
Xrm.Navigation.openForm
oderXrm.Navigation.navigateTo
habenwindow.open
oder einen Link, um einen bestimmten Datensatz oder ein bestimmtes Formular für eine Entität zu öffnen. Die Verwendung, um ein Formular in einem IFrame anzuzeigen, 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 modellgesteuerte Apps 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 }
mit %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 Tabelle. Wichtig: Verwenden Sie nicht den etc-(Tabellentypcode-)Parameter, der einen ganzzahligen Code für die Tabelle enthält. Dieser ganzzahlige Code für benutzerdefinierte Tabellen 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 Spaltenwerte unter Verwendung der Parameter festgelegen, die an ein Formular übergeben wurden. Wenn eine Tabelle ü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, schließen Sie diesen Wert in den extraqs -Parameter ein: formid%3D6009c1fe-ae99-4a41-a59f-a6f1cf8b9daf%0D%0A . |
pagetype |
Der Typ der Seite. Es gibt zwei mögliche Werte: - entityrecord Zeigt ein Datensatzformular an. - entitylist Zeigt eine Ansicht an. |
id |
Optional für Formulare. Verwenden Sie diese Option, wenn Sie einen bestimmten Tabellendatensatz öffnen möchten. Übergeben Sie den codierten GUID-Bezeichner für die Tabelle. Die codierte Version der GUID ersetzt jeweils die öffnenden und schließenden Klammern „{“ und „}“ durch „%7B“ bzw. „%7D“, zum 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 -Tabellendatensatzes, 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 Formular sind nur die Navigationsoptionen für verknüpfte Tabellen verfügbar. Nach der Navigation zu einer verknüpften Tabelle 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-Anwendung. Die Verwendung, um ein Formular in einem iFrame anzuzeigen, das in ein anderes Formular eingebettet 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
Bei vielen Ansichten in modellbasierten Apps kann ein Benutzer die URL für eine bestimmte Ansicht kopieren oder eine E-Mail mit der URL für eine bestimmte Ansicht senden, die 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. 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
Öffnen Sie die Ansicht, die Sie verwenden möchten.
Wählen Sie in der Befehlsleiste Aktionen und Sie dann auf Link per E-Mail senden.
Fügen Sie den Link in Notepad 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 Systementabellen darstellt, entspricht dann der lokalen Installation von . Die GUID für benutzerdefinierte Tabellen und benutzerdefinierte Ansichten ist für jede Installation von Apps 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-Parameter verwendet wird.
Wenn Sie eine Liste von Tabellendatensätzen innerhalb der Anwendung für einen Unterbereich anzeigen möchten, legen Sie den Tabellenattributwert fest. Dadurch wird die standardmäßige Ansicht für diese Tabelle 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="/main.aspx?appid=e2bc1066-488f-eb11-b1ac-000d3a56ead9&pagetype=entitylist&etn=account&viewid=%7b<GUID value of view id>%7d"
Wenn Sie diese URL verwenden, müssen Sie außerdem entsprechende Werte für <Titles>
und <Descriptions>
sowie ein Symbol für die Tabelle angeben.
Hinweis
Wenn Sie die Ansicht mithilfe der /main.aspx
-Seite angeben, wird die Ansichtsauswahl weiterhin angezeigt. Wenn der Benutzer die Ansicht ändert, merkt sich die modellgesteuerte App die aktuellste Auswahl des Benutzers, und die Standard-Anfangsansicht wird angezeigt, nachdem der Benutzer den Browser geschlossen und erneut geöffnet hat.
Öffnen eines Dialogprozess durch Verwendung einer URL
Wichtig
Dialoge sind veraltet. Ersetzen Sie Dialoge durch Geschäftsprozessflüsse oder Canvas-Apps. Weitere Informationen: Ersetzen von Dialogen durch Geschäftsprozessflowsn oder Canvas-Apps
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 Tabelle 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 Tabelle, 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=[table 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 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:
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, die Benutzende bearbeiten können, bevor sie die Schaltfläche Bericht ausführen auswählen, um den Bericht anzuzeigen.
helpID
Dieser Parameter ist optional. Bei Berichten, die in modellbasierten Apps enthalten sind, erlaubt der Wert in diesem Parameter, dass die Schaltfläche Hilfe den entsprechenden Inhalt über diesen Bericht anzeigt, wenn Hilfe auf dieser Seite gewählt wird. Der Wert sollte dem FileName
-Wert des Berichts entsprechen.
id
Dieser Parameter ist der ReportId
-Wert des Berichts.
Die folgenden Beispiele zeigen URLs, die zum Öffnen von Berichten in modellbasierten Apps 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
Festlegen von Spaltenwerten mithilfe von Parametern, die an ein Formular übergeben werden
Xrm:Navigation.openUrl
Ein Formular konfigurieren, um benutzerdefinierte Abfragezeichenfolgenparameter zu akzeptieren.
Anpassen des Menübands
Clientskripting mit JavaScript
Webressourcen
Änderungsantragnavigation mithilfe von SiteMap
Hinweis
Können Sie uns Ihre Präferenzen für die Dokumentationssprache mitteilen? Nehmen Sie an einer kurzen Umfrage teil. (Beachten Sie, dass diese Umfrage auf Englisch ist.)
Die Umfrage dauert etwa sieben Minuten. Es werden keine personenbezogenen Daten erhoben. (Datenschutzbestimmungen).