Bearbeiten der Siteübersicht

 

Veröffentlicht: Januar 2017

Gilt für: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Sie können Standard- oder App-spezifische Siteübersichten über eine der folgenden Methoden bearbeiten:

• Verwenden Sie den neuen Siteübersichtsdesigner in Update für Dynamics 365 (online und lokal), Dezember 2016 oder einen Siteübersichtseditor von Drittanbietern , wenn Sie eine ältere Version von Microsoft Dynamics 365 verwenden.

• Programmgesteuertes Aktualisieren des SiteMap-Entitätsdatensatzes in XML im SiteMap.SiteMapXml-Attribut.

• Manuelles Bearbeiten des XML-Codes im SiteMap-Knoten in der customizations.xml-Datei einer exportierten nicht verwalteten Lösung und Importieren der Lösung als verwaltete oder nicht verwaltet.

In diesem Thema

Verwenden von Sieteübersicht-Editoren

Programmgesteuertes Aktualisieren der Siteübersicht

Manuelles Bearbeiten der SiteMap

Bearbeiten mit Schemaüberprüfung

Codierung des kaufmännischen Und-Zeichens

Wiederherstellen nach Fehlern

Verwenden von Sieteübersicht-Editoren

Wenn Sie Update für Dynamics 365 (online und lokal), Dezember 2016 verwenden, können Sie den neuen Siteübersichtsdesigner verwenden, um Siteübersichten zu erstellen und zu verwalten.Weitere Informationen:Erstellen einer Siteübersicht für die App

Andernfalls können Sie einen Siteübersichtseditor von Drittanbietern nutzen, um die Standardsiteübersicht zu bearbeiten. Da in Update für Dynamics 365 (online und lokal), Dezember 2016 App-spezifische Siteübersichten eingeführt werden, funktionieren Siteübersichtseditoren von Drittanbietern möglicherweise nicht wie erwartet. Ein beliebter Siteübersichteneditor für die Bearbeitung von Standardsiteübersichten ist in der Toolbox für Dynamics CRM 2011/2013 von Microsoft Dynamics 365MVP Tanguy Touzard enthalten.

Diese Anwendungen vereinfachen den Bearbeitungsvorgang der Siteübersicht, sie erfordert jedoch, dass Sie über einige Kenntnisse hinsichtlich des XML-Schemas der Siteübersicht verfügen. Weitere Informationen finden Sie unter SiteMap XML reference.

Hinweis

Der technische Support von Microsoft Dynamics 365 bietet keine Unterstützung für Drittanbieteranwendungen. Wenn Sie Fragen zu diesen Anwendungen haben, setzen Sie sich mit dem Anwendungsherausgeber in Verbindung.

Programmgesteuertes Aktualisieren der Siteübersicht

Rufen Sie den SiteMap-Entitätsdatensatz ab, den Sie aktualisieren möchten, und aktualisieren Sie dann den XML-Code im SiteMap.SiteMapXml-Attribut des Datensatzes. Stellen Sie sicher, das Sie das Siteübersicht XML-Schema kenne, bevor Sie eine XML-Datei bearbeiten. Weitere Informationen finden Sie unter SiteMap XML reference.

Wenn Sie einen SiteMap-Datensatz programmgesteuert mithilfe der Update-Methode aktualisieren, überschreibt der angegebene XML-Siteübersicht-Code den bestehenden XML-Code im SiteMap.SiteMapXml-Attribut des Datensatzes.

Hinweis

• Sie können außerdem programmgesteuert App-spezifische SiteMap-Datensätze Erstellen und Löschen. Um einen App-spezifischen SiteMap-Datensatz zu erstellen, müssen Sie mindesten die Werte für die folgenden Attribute angeben: SiteMap.SiteMapNameUnique und SiteMap.SiteMapXml. Es wird jedoch empfohlen, dass Sie statt der programmgesteuerten Erstellung und Löschung von App-spezifischen Siteübersichten den neuen Siteübersichtsdesigner zu verwenden um App-spezifische Siteübersichten zu Erstellen und zu Löschen.Weitere Informationen:Erstellen einer Siteübersicht für die App

• Sie können den SiteMap-Standarddatensatz nicht programmgesteuert Erstellen und Löschen. Sie können das SiteMap.IsAppAware-Attribut verwenden, um zwischen den zwei Typen von Siteübersichten zu unterscheiden: 0 gibt eine Standardsiteübersicht an, 1 gibt die App-spezifische Siteübersicht an.

Manuelles Bearbeiten der SiteMap

Sie können den SiteMap Knoten manuell in der customizations.xml-Datei einer exportieren nicht verwalteten Lösung bearbeiten und ihn dann zurück in Dynamics 365 importieren, um die Siteübersicht zu aktualisieren. Abhängig davon, ob Sie eine nicht verwaltete oder verwaltete Lösung importieren, entscheidet sich, wie der SiteMap-Datensatz aktualisiert wird.

• Das Importieren einer nicht verwalteten Lösung überschreibt den bestehenden Siteübersicht-XML-Code im SiteMap-Datensatz.

• Das Importieren einer verwalteten Lösung erstellt einen neuen SiteMap-Datensatz mit den neuesten Änderungen, und der SiteMap.OverwriteTime-Attributwert für den neuesten/aktiven SiteMap-Datensatz wird auf den Standardwert für das DateTime-Feld festgelegt (1900-01-01 00:00: 00,000). Der SiteMap.OverwriteTime-Attributwert des vorhandenen SiteMap-Datensatzes wird auf den datetime-Wert festgelegt, wenn dieser aktualisiert wurde.

So bearbeiten Sie die Siteübersicht

1. Klicken Sie auf Einstellungen, klicken Sie auf Anpassungen und anschließend auf Lösungen.

2. Fügen Sie die Standard- oder App-spezifischen Siteübersichten einer neuen oder vorhandenen nicht verwalteten Lösung hinzu. Wählen Sie in der Lösung die Option Clienterweiterungen aus der Liste Komponenten auf der linken Seite aus. Wählen Sie Vorhandenes Element hinzufügen und anschließend Siteübersicht aus. Wählen Sie in der Liste aus Siteübersichten:

   • Wählen Sie zum Hinzufügen der Standard-Siteübersicht Site Map.

   • Wenn Sie eine App-spezifische Siteübersicht hinzufügen möchten, wählen Sie eine benutzerdefinierte Unternehmens-App-Siteübersicht aus. Das Dialogfeld zeigt Siteübersichten für alle benutzerdefinierten Unternehmens-Apps an, auf die Sie Zugriff besitzen. In diesem Fall können Sie z. B. Contoso Sales App oder Contoso Service App auswählen.

     

     Hinweis

     Die App-spezifischen Siteübersichten werden nur angezeigt, wenn Sie Update für Dynamics 365 (online und lokal), Dezember 2016 oder höher installiert haben und benutzerdefinierte Unternehmens-Apps in Ihrer Dynamics 365-Instanz haben. Sie können auch auswählen derselben Lösung mehrere App-Spezifische Siteübersichten und Standard-Siteübersicht hinzuzufügen.

   • Klicken Sie auf OK im Bildschirm Lösungskomponenten auswählen.

3. Klicken Sie auf Speichern, um Änderungen an Ihrer Lösung zu speichern.

4. Klicken Sie auf Lösung exportieren und folgen Sie den Schrittem im Lösungsexportassistenten, um die Lösung zu exportieren.

5. Nachdem die Lösung exportiert wurde, extrahieren Sie die Dateien aus der komprimierten ZIP-Datei.

   Tipp

   Behalten Sie die komprimierte ZIP-Datei als Ihre Sicherung.

6. Suchen Sie in der Datei customizations.xml nach:

   • SiteMap Knoten unter ImportExportXml/SiteMap, um die Standardsiteübersicht zu bearbeiten.

   • SiteMap Knoten unter ImportExportXml/AppModuleSiteMaps/AppModuleSiteMap, um die App-spezifische Siteübersicht zu bearbeiten.

     Tipp

     Wenn Sie mehrere App-spezifiche Siteübersichten in einer Lösung hinzugefügt haben, bevor Sie die Lösung exportieren, können Sie die SiteMapUniqueName und SiteMapName Knotzen unter ImportExportXml/AppModuleSiteMaps/AppModuleSiteMap verwenden, um den SiteMap Knoten in der customizations.xml Datei zu bestimmen, den Sie für Ihre Siteübersicht bearbeiten müssen.

7. Bearbeiten Sie den SiteMap Knoten nach Bedarf.

   Hinweis

   Das Bearbeiten von XML ist viel einfacher, wenn Sie einen Editor verwenden, der die Schemaüberprüfung beherrscht. Weitere Informationen finden Sie unter Bearbeiten mit Schemaüberprüfung.

8. Erstellen Sie eine neue, komprimierte ZIP-Datei, die die extrahierten Lösungsdateien und Ihre bearbeitete Datei customizations.xml umfasst.

   Tipp

   Wählen Sie in Windows Explorer alle Dateien aus. Klicken Sie dann mit der rechten Maustaste und wählen Sie Senden an sowie Komprimierter (gezippter) Ordner aus.

9. Importieren Sie die neue Lösungsdatei.

   1. Klicken Sie in Microsoft Dynamics 365 auf Einstellungen, klicken Sie auf Anpassung und anschließend auf Lösungen.

   2. Klicken Sie auf Importieren.

   3. Klicken Sie auf Durchsuchen, suchen Sie die geänderte ZIP-Lösungsdatei, klicken Sie auf Weiter, und klicken Sie dann auf Importieren.

   4. Sobald der Import abgeschlossen ist, klicken Sie auf Schließen.

10. Veröffentlichen Sie die Anpassungen.

    Tipp

    Wenn Sie nicht unmittelbar Änderungen sehen, aktualisieren Sie die Browserseite.

Bearbeiten mit Schemaüberprüfung

Zur verbesserten Anwendungsleistung bearbeiten Sie die Datei customizations.xml mit einer Anwendung, die die Schemaüberprüfung verwenden kann, um IntelliSense-Support bereitzustellen. Weitere Informationen finden Sie unter Bearbeiten der XML-Datei für Anpassungen mit Schemaüberprüfung.

Codierung des kaufmännischen Und-Zeichens

Wenn Sie eine URL der Siteübersicht hinzufügen, die das kaufmännische Und-Zeichen (&), enthält, müssen Sie es codieren, indem Sie es durch “&” ersetzen. Die XML-Überprüfung ist nicht erfolgreich, wenn Sie dieses Zeichen nicht kodieren, und Sie können die Lösung nicht importieren. Beispiel:

• Richtig:
  <SubArea Id="new_customSubArea" Url="http://mysite/mypage.aspx?parameter1=value&amp;parameter2=value ">

• Falsch:
  <SubArea Id="new_customSubArea" Url="http://mysite/mypage.aspx?parameter1=value&parameter2=value">

Wiederherstellen nach Fehlern

Das Lösungs-Importtool führt Überprüfungen an der Siteübersicht aus. Wenn Fehler auftreten, wird die standardmäßige Siteübersicht angewendet und eine Fehlermeldung angezeigt. Sie müssen die Fehler in der Siteübersicht beheben und den Importvorgang wiederholen. Trotzdem können u. U. immer noch manche Fehler auftreten.

Einige Fehler, die Sie möglicherweise auftreten, wenn Sie eine benutzerdefinierte Unternehmens-App ausführen, nachdem Sie die benutzerdefinierte Unternehmens-App-Siteübersicht bearbeiten/ importieren, sind:

• Siteübersicht ohne Unterbereich

• Die Siteübersicht hat Unterbereiche, aber der Benutzer besitzt keine Berechtigungen, um sie anzuzeigen

• Ungültige Entität (kein gültiger Dynamics 365-Entitätsname)

• Ungültige URL

• Die Siteübersicht hat einen Dashboardknoten, aber in der modularen Unternehmens-App-Definition ist kein Dashboard ausgewählt

Siehe auch

Siteübersichten anpassen
Änderungsantragnavigation mithilfe von SiteMap
Übergeben von Parametern an eine URL mithilfe von SiteMap
Steuern des Zugriffs auf die Hilfe und Schulung-Website
SiteMap XML reference
SiteMap schema

Microsoft Dynamics 365

© 2017 Microsoft. Alle Rechte vorbehalten. Copyright