Erstellen, Exportieren oder Importieren einer nicht verwalteten Lösung

 

Veröffentlicht: Januar 2017

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

Darüber hinaus, dass es eine Voraussetzung zum Erstellen einer verwalteten Lösung ist, ist eine nicht verwaltete Lösung nützlich als Möglichkeit, einen Satz nicht verwalteter Anpassungen zu einem Satz zu gruppieren, der zwischen Organisationen transportiert werden kann.

Weitere Informationen finden Sie unter: TechNet: Verwenden von Lösungen für Anpassungen.

In diesem Thema

Erstellen einer nicht verwalteten Lösung

Exportieren einer nicht verwalteten Lösung

Importieren einer nicht verwalteten Lösung

Erstellen einer nicht verwalteten Lösung

Jede Lösung erfordert einen Herausgeber. Wenn Sie die Lösung nicht verteilen möchten, können Sie den Standardherausgeber verwenden, der bereits für die Organisation erstellt wurde. Informationen zum Erstellen eines Lösungsherausgebers finden Sie unter Erstellen eines Lösungsherausgebers.

In der folgenden Tabelle sind die Felder und Beschreibungen aufgelistet, die in einer Lösung enthalten sind.

Feldbeschriftung	Beschreibung
Anzeigename	Der Name der Lösung.
Name	Microsoft Dynamics 365 generiert einen eindeutigen Namen basierend auf dem Anzeigename. Sie können den eindeutigen Namen bearbeiten. Der eindeutige Name darf nur alphanumerische Zeichen oder das Unterstrichzeichen enthalten.
Herausgeber	Verwenden Sie die Herausgeber-Suche, um die Lösung dem Herausgeber zuzuordnen.
Version	Geben Sie eine Version im folgenden Format an: Hauptversion.Nebenversion.Build.Revision, zum Beispiel 1.0.0.0.
Konfigurationsseite	Wenn Sie in die Lösung eine HTML-Webressource einschließen, können Sie diese Suche verwenden, um sie als festgelegte Konfigurationsseite hinzuzufügen. Weitere Informationen:Verwenden der Lösungskonfigurationsseite
Beschreibung	Verwenden Sie das Feld, um alle relevanten Details über die Lösung einzufügen.

Nach dem Erstellen einer nicht verwalteten Lösung können Sie Lösungskomponenten hinzufügen, indem Sie sie im Kontext dieser Lösung erstellen oder indem Sie vorhandene Komponenten von anderen Lösungen hinzufügen. Weitere Informationen zum programmgesteuerten Erstellen einer Lösungsherausgebers finden Sie unter Erstellen einer Lösung.

Erstellen eines Lösungsherausgebers

Wenn Sie verwaltete Lösungen verteilen möchten, sollten Sie einen Publisher erstellen. In der folgenden Tabelle sind die Felder und Beschreibungen aufgelistet, die in einem Publisher enthalten sind.

Etikett	Beschreibung
Anzeigename	Der im Herausgeber-Suchfeld in der Lösung angezeigt werden soll.
Name	Microsoft Dynamics 365 generiert einen eindeutigen Namen basierend auf dem Anzeigename. Der eindeutige Name kann nur alphanumerische Zeichen und das Unterstrichzeichen enthalten. Hinweis Sie verwenden Unique Name, um einen Publisher eindeutig zu identifizieren. Verwaltete Lösungen, die den gleichen Herausgeber haben, können sich gegenseitig aktualisieren.
Beschreibung	Verwenden Sie das Feld, um alle relevanten Details über die Lösung einzufügen.
Präfix	Mithilfe des Anpassungspräfixes können Sie identifizieren, welcher Herausgeber eine Lösungskomponente hinzugefügt hat. Zum Beispiel wird das Präfix dem logischen Namen aller Entitäten oder Attribute hinzugefügt, die im Kontext einer diesem Herausgeber zugeordneten Lösung erstellt werden. Das Präfix muss zwischen zwei und acht Zeichen enthalten und kann nur alphanumerische Zeichen enthalten. Es kann nicht mit ‘mscrm’ anfangen.
Optionswertpräfix	Mithilfe dieses Werts können Sie Optionen trennen, die Sie Optionssätzen hinzufügen, um das Zusammenführen von Optionen zu unterstützen. Der Wert wird auf der Basis des Präfix-Textes automatisch generiert, damit er eindeutiger werden kann. Der Wert muss zwischen 10.000 und 99.999 sein. Weitere Informationen:Optionssatz-Optionen zusammenführen
Kontaktdetails	Verwenden Sie diese Felder, um Informationen hinzuzufügen, mithilfe derer Personen, die die Lösung installieren, Sie kontaktieren können.

Informationen zum programmgesteuerten Erstellen eines Lösungsherausgebers finden Sie unter Erstellen eines Herausgebers.

Verwenden der Lösungskonfigurationsseite

Die Lösungskonfigurationsseite enthält eine Canvas, die Sie verwenden können, um Informationen anzuzeigen oder um Kunden zu ermöglichen, Aktionen im Rahmen der Lösung auszuführen. Legen Sie die Konfigurationsseite fest, indem Sie das Suchfeld Konfigurationsseite verwenden, um eine Webseiten-(HTML)-Webressource auszuwählen, die in der Lösung enthalten ist. Dadurch wird ein neuer Konfigurationsknoten im Lösungsfenster unter dem Informationsknoten und über dem Komponentenknoten angezeigt. Der Konfigurationsknoten zeigt die von Ihnen festgelegte Webressource an.

Sie können die Lösungskonfigurationsseite verwenden, um Steuerelemente anzuzeigen, die Ihre Lösung konfigurieren. Sie können möglicherweise einige Entitäten in Ihrer Lösung bereitstellen, die das Verhalten der Lösung steuern. Indem Sie den OData-Endpunkt für Microsoft Dynamics 365 verwenden, können Sie auf Ihrer Webressourcenseite benutzerdefinierte Steuerelemente bereitstellen, um die Daten in diesen Entitäten zu aktualisieren.

Exportieren einer nicht verwalteten Lösung

In den folgenden Fällen möchten Sie möglicherweise eine nicht verwaltete Lösung exportieren:

• Sie müssen bestimmten XML-Inhalt in der Datei customizations.xml bearbeiten, beispielsweise möchten Sie möglicherweise die SiteMap bearbeiten oder benutzerdefinierte Menübänder erstellen.

• Sie möchten die nicht verwaltete Lösung aus einer Organisation in eine andere transportieren.

• Sie möchten eine Sicherung Ihres aktuellen Satzes von Anpassungen erstellen.

Durch das Exportieren einer nicht verwalteten Lösung wird eine komprimierte (gezippte) Datei erstellt, die dann in eine andere Organisation oder dieselbe Organisation importiert werden kann.

Nur veröffentlichte Anpassungen werden einbezogen, wenn Sie eine Lösung exportieren. Deshalb müssen Sie darauf achten, alle Änderungen zu veröffentlichen, bevor Sie eine Lösung exportieren.

Wenn Sie eine Lösung mithilfe der Webanwendung exportieren und wenn die Lösung dann irgendwelche fehlenden, erforderlichen Komponenten enthält, sehen Sie den Schritt Fehlende erforderliche Komponenten. Sie können diese Warnung nur dann ignorieren, wenn Sie diese Lösung als nicht verwaltete Lösung in die ursprüngliche Organisation zurückimportieren wollen. Befolgen Sie andernfalls die Anweisungen im Dialogfeld, um den Export abzubrechen und die erforderlichen Komponenten hinzuzufügen.

Verwenden Sie die Nachricht ExportSolutionRequest, um eine Lösung programmgesteuert zu exportieren.Weitere Informationen:Exportieren oder Packen einer Lösung

Wenn Sie eine Lösung mithilfe der Webanwendung exportieren, können Sie im Schritt Systemeinstellungen exportieren (Erweitert) auswählen, welche Systemeinstellungen in die Lösung einbezogen werden sollen. Diese Optionen sind für Entwicklern verfügbar, und zwar mithilfe von ExportSolutionRequest über die in der Anforderung verfügbaren Member. In den Anmerkungen zur Anforderung finden Sie Details darüber, welche Einstellungen enthalten sind.

Sie können eine Zielversion auswählen, wenn Sie eine Lösung exportieren. Sie können eine Lösung exportieren, die mit früheren Versionen kompatibel ist.Weitere Informationen:Exportieren einer Lösung für eine bestimmte Dynamics 365-Version..

Importieren einer nicht verwalteten Lösung

In den folgenden Fällen sollten Sie eine nicht verwaltete Lösung importieren:

• Sie möchten einen Satz von Anpassungen von einer Organisation zu einer anderen transportieren, und Sie möchten es zulassen, dass die Lösungskomponenten geändert werden können.

• Sie möchten einen älteren Satz von Lösungskomponentendefinitionen wiederherstellen oder zu diesem zurückkehren.

Das Importieren einer nicht verwaltete Lösung ist ein additiver Prozess. Beim Importieren einer älteren Version einer verwalteten Lösung, werden Lösungskomponenten nicht entfernt, die in einer späteren Version enthalten sind. Allerdings wird die Definition von allen Lösungskomponenteneigenschaften mit der Definition überschrieben, die in der letzten nicht verwaltete Lösung enthalten ist, die Sie importieren.

Wichtig

Änderungen, die durch das Importieren einer nicht verwalteten Lösung angewendet wurden, können nicht deinstalliert werden. Sie sollten daher keine nicht verwaltete Lösung installieren, wenn Sie die Änderungen zurücksetzen möchten.

Dieser Vorgang wird programmgesteuert mithilfe der Nachricht ImportSolutionRequest ausgeführt. Sie können Code schreiben, um diese Nachricht asynchron auszuführen.Weitere Informationen:Nachrichten im Hintergrund (asynchron) ausführen. Sie können den Status des Importvorgangs verfolgen oder einen Bericht des Erfolgs des Imports generieren, indem Sie die EntitätImportJob verwenden.Weitere Informationen:Installieren oder Aktualisieren einer Lösung

Wichtig

Das Installieren einer Lösung oder Veröffentlichen von Anpassungen kann den normalen Systembetrieb stören. Es ist empfehlenswert, den Import von Lösungsimporte einzuplanen, wenn er für die Benutzer am wenigsten Unterbrechungen mit sich bringt.

Maximal zulässige Größe der zu importierenden Lösung

Für Microsoft Dynamics 365 (online) beträgt die maximale Größe für eine Lösung 29,296 MB.

Für lokale Organisationen ist die standardmäßige maximale Größe für eine Lösung 6 MB, diese kann jedoch nach Bedarf erhöht werden.

Ändern Sie die maximal zulässige Größe, indem Sie das Element <httpRuntime> in der Datei web.config für die Anwendung bearbeiten. Bearbeiten Sie die Attribute executionTimeout und maxRequestLength, um die erforderliche Größe zuzulassen. Nach Abschluss der Installation der Lösung, können sie dafür die von Ihnen gewünschte Größe festlegen.

Siehe auch

Planen einer Lösungsentwicklung
Packen und Verteilen von Erweiterungen mithilfe von Lösungen
Customization solutions file schema
Eine verwaltete Lösung erstellen, installieren und aktualisieren
Deinstallieren oder Löschen einer Lösung

Microsoft Dynamics 365

© 2017 Microsoft. Alle Rechte vorbehalten. Copyright