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

Url adressierbare Elemente ermöglichen es Ihnen, Links zu modellgesteuerten Apps, Formularen, Ansichten und Berichten in anderen Anwendungen einzuschließen.

Anmerkung

URL-Adressierbare Apps, Formulare, Ansichten 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

Anmerkung

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 mithilfe der Werte "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: Abfrage von Daten über die 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.

Eindeutiger Name verwenden

Um die App mithilfe des eindeutigen Namens zu öffnen, fügen Sie den appname Abfrageparameter an die main.aspx Seite an.

https://myorg.crm.dynamics.com/main.aspx?appname={UniqueName}

Wenn der eindeutige Name beispielsweise lautet msdyn_SolutionHealthHub, können Sie diese App mit dieser URL öffnen:

https://myorg.crm.dynamics.com/main.aspx?appname=msdyn_SolutionHealthHub

AppModuleId verwenden

Um die App mithilfe der AppModuleId zu öffnen, fügen Sie der appid Seite den main.aspx Abfrageparameter hinzu.

https://myorg.crm.dynamics.com/main.aspx?appid={AppModuleId}

Zum Beispiel:

https://myorg.crm.dynamics.com/main.aspx?appid=00001111-aaaa-2222-bbbb-3333cccc4444

Über URL adressierbare Formulare und Ansichten

Auf der main.aspx Seite werden alle Formulare und Ansichten angezeigt. Abfragezeichenfolgenparameter, die Sie an diese Seite übergeben, steuern, was angezeigt wird. Zum Beispiel:

So öffnen Sie ein Kontodatensatzformular, in dem die ID lautet {91330924-802A-4B0D-A900-34FD9D790829}:

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

Anmerkung

Verwenden Sie Xrm.Navigation.navigateTo oder Xrm.Navigation.openForm, wenn Sie Formulare programmgesteuert in der Anwendung mit Webressourcen öffnen. Verwenden Sie window.open nicht.
Außerhalb der Anwendung, wobei Seiten keinen Zugriff auf die Funktionen Xrm.Navigation.openForm oder Xrm.Navigation.navigateTo haben, verwenden Sie window.open oder einen Link, um einen bestimmten Datensatz oder ein Formular für eine Tabelle zu öffnen. Das Anzeigen eines Formulars in einem in ein anderes Formular eingebetteten IFrame wird nicht unterstützt.

In der Regel verwenden Sie die getClientUrl-Methode , um die Organisationsstamm-URL für modellgesteuerte Apps abzurufen.

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

Tipp

Verwenden Sie die Schaltfläche " Link senden " in der Befehlsleiste, um den ID-Wert für einen beliebigen Datensatz abzurufen. Das folgende Beispiel zeigt, was in Ihrer E-Mail-Anwendung geöffnet wird:

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

Der id an die URL übergebene Parameter ist der codierte ID-Wert für den Datensatz. In diesem Beispiel lautet {899D4FCF-F4D3-E011-9D26-00155DBA3819}der ID-Wert . Die codierte Version der GUID ersetzt öffnende und schließende Klammern { und } durch %7B und %7D.

In der folgenden Tabelle sind die Abfragezeichenfolgenparameter aufgeführt, die mit der main.aspx Seite zum Öffnen von Formularen oder Ansichten verwendet werden:

Parameter	Beschreibung
`etn`	Der logische Name der Tabelle. Wichtig: Verwenden Sie nicht den Parameter etc (Tabellentypcode), 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 von an ein Formular übergebenen Parametern festlegen. 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 diesen Parameter, wenn Sie einen bestimmten Tabellendatensatz öffnen. Übergeben Sie den codierten GUID-Bezeichner für die Tabelle. Die codierte Version der GUID ersetzt die öffnenden und schließenden Klammern "{" und "}" durch "%7B" bzw. "%7D". `{91330924-802A-4B0D-A900-34FD9D790829}` ist z. B. `%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 mithilfe anderer Benutzeroberflächenelemente oder der Schaltflächen "Zurück" und "Vorwärts" navigieren. -`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. Wichtig: Dieser Parameter wird nur in modellgesteuerten Einzelsitzungs-Apps unterstützt. Es hat keine Auswirkung auf Multisession- oder Arbeitsbereich-Apps wie Customer Service Workspace, Copilot Service Workspace oder Omnichannel for Customer Service.
`cmdbar`	Steuert, ob die Befehlsleiste angezeigt wird. Hinweis: Diese Funktion unterstützt die Anforderungen für die Unified Service Desk-Anwendung. Die Verwendung dieses Parameters zum Anzeigen eines Formulars in einem in ein anderes Formular eingebetteten IFrame 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

Mit vielen Ansichten in modellgesteuerten Apps können Sie die URL für eine bestimmte Ansicht kopieren oder eine E-Mail mit der URL für eine bestimmte Ansicht senden, die in die 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.

Anmerkung

Verwenden Sie diese URL nicht, um die Ansicht in die Anwendungsnavigation einzuschließen, indem Sie die Websiteübersicht verwenden. Informationen hierzu finden Sie unter Anzeigen einer Ansicht in der Application-Navigation mithilfe der Sitemap.

Die Seite, die durch die URL angezeigt wird, umfasst die vollständige Ansicht. Diese Ansicht enthält das Menüband, enthält aber nicht die Anwendungsnavigation.

Abrufen der URL für eine Ansicht

Öffnen Sie die Ansicht, die Sie verwenden möchten.
Wählen Sie auf der Befehlsleiste "Aktionen" und dann " Link per E-Mail senden" aus.
Fügen Sie den Link in Notepad ein, und bearbeiten Sie ihn, um nur den URL-Teil des gewünschten Textes zu extrahieren.

Anmerkung

Sie können keine Ansichten kopieren, die den Benutzerkontext als Parameter verwenden, z. B. "Meine Konten".
- Die GUID, die Systemansichten für Systemtabellen darstellt, ist für jede Installation identisch. Die GUID für benutzerdefinierte Tabellen und benutzerdefinierte Ansichten ist für jede Installation eindeutig.

Wenn Sie die Anwendungsnavigation mithilfe der Sitemap anpassen, verwenden Sie nicht die Ansichts-URL, die Sie aus der Anwendung kopiert haben, indem Sie die Schritte unter Kopieren der URL für eine Ansicht verwenden, um diese als 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 ein SubArea anzeigen möchten, legen Sie den Tabellenspaltenwert fest. Dieser Wert zeigt die Standardansicht für diese Tabelle an und stellt den richtigen Titel und das richtige Symbol bereit.

Wenn Sie jedoch ein SubArea-Element wünschen, das eine bestimmte Standard-Anfangsansicht verwendet, verwenden Sie folgendes URL-Muster.

Url="/main.aspx?appid=11112222-bbbb-3333-cccc-4444dddd5555&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.

Anmerkung

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 Berichts mithilfe 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 Sie run verwenden, wird der Bericht mit den Standardfiltern angezeigt. Wenn Sie den Bericht verwenden filter, zeigt der Bericht einen Filter an, den der Benutzer bearbeiten kann, bevor er die Schaltfläche " Bericht ausführen " auswählt, um den Bericht anzuzeigen.

helpID
Dieser Parameter ist optional. Für Berichte, die in modellgesteuerten Apps enthalten sind, ermöglicht der Wert in diesem Parameter die Anzeige geeigneter Inhalte zu diesem Bericht, wenn "Hilfe" auf dieser Seite ausgewä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, mit denen Sie Berichte in modellgesteuerten Apps öffnen können.

Öffnen Sie den Bericht "Vernachlässigte Fälle ", indem Sie den Standardfilter verwenden:

[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
Ändern der Anwendungsnavigation mithilfe der SiteMap

Feedback

War diese Seite hilfreich?

Last updated on 2026-04-22

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

App-URLs

Eindeutiger Name verwenden

AppModuleId verwenden

Über URL adressierbare Formulare und Ansichten

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

Kopieren der URL für eine Ansicht

Abrufen der URL für eine Ansicht

Anzeigen einer Ansicht in der Anwendungsnavigation mithilfe der Websitekarte

Öffnen eines Berichts mithilfe einer URL

Siehe auch

Feedback

Zusätzliche Ressourcen