Aktualisieren einer benutzerdefinierten Workflowaktivität mithilfe der Assemblyversionsverwaltung

  • Artikel

 

Veröffentlicht: Januar 2017

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

In Microsoft Dynamics 365 werden Aktualisierungen Ihrer Workflowaktivitätsassembly aufgrund des verbesserten Assembly-Versionsverwaltungsmodells effizienter behandelt.

In diesem Thema

Verstehen der Assemblyversionsnummer

Aktualisieren einer benutzerdefinierten Workflowaktivität

Upgraden einer benutzerdefinierten Workflowaktivität

Verstehen der Assemblyversionsnummer

Jede benutzerdefinierte Workflowaktivitätsassembly hat eine Versionsnummer. Die Versionsnummer wird als vierteilige Zeichenfolge im folgenden Format dargestellt:

<major_version>.<minor_version>.<build_number>.<revision>

Beispielsweise gibt Version 1.5.200.51 als Hauptversion an, 5 als Nebenversion, 200 als Buildnummer und 5 als Revisionsnummer.

Aktualisieren einer benutzerdefinierten Workflowaktivität

Sie können Ihre vorhandenen Workflowaktivitäten aktualisieren, um Fehler zu beheben oder Änderungen an einigen der privaten Code-Implementierungen vorzunehmen. Wenn Sie eine benutzerdefinierte Workflowaktivität aktualisieren, müssen Sie darauf achten, keine bedeutende Änderungen in den öffentlichen Klassen oder Methodensignaturen im zugrunde liegenden Code vornehmen, wie Ändern der Eingabeparameter, da dies möglicherweise vorhandene Workflowinstanzen unterbricht, die die benutzerdefinierte Workflowaktivität verwenden.

  1. Nehmen Sie die erforderlichen Änderungen am zugrunde liegenden Code der benutzerdefinierte Workflowaktivität vor.

  2. Ändern Sie den Wert für <build_number> und <revision> nur in den Assemblyinformationen der benutzerdefinierten Workflowaktivität, und kompilieren Sie sie. Ändern Sie beispielsweise den Wert Ihrer Assembly von "1.0.0.0" zu "1.0.10.5".

  3. Aktualisieren Sie die registrierte benutzerdefinierte Workflowaktivität in Microsoft Dynamics 365 mit der neuen Assembly.

Nachdem Sie die benutzerdefinierte Workflowaktivität in Microsoft Dynamics 365 aktualisiert haben, werden alle vorhandenen ausgeführten Prozesse (Workflows und Dialoge), die benutzerdefinierte Workflowaktivität verwenden, automatisch gestartet, ohne dass Sie die Prozessdefinitionen aktualisieren müssen.

Upgraden einer benutzerdefinierten Workflowaktivität

Möglicherweise möchten Sie bedeutende Änderungen an Ihrer benutzerdefinierten Workflowaktivität vornehmen, wie das Hinzufügen oder Entfernen einiger Aktionen oder das Ändern der Eingabe/Ausgabe-Parameter. In diesem Fall sollten Sie die benutzerdefinierte Workflowaktivität upgraden.

  1. Nehmen Sie die erforderlichen Änderungen am zugrunde liegenden Code der benutzerdefinierte Workflowaktivität vor.

  2. Ändern Sie den Wert für <major_version> und/oder <minor_version> in den Assemblyinformationen der benutzerdefinierten Workflowaktivität, und kompilieren Sie sie. Ändern Sie beispielsweise den Wert Ihrer Assembly von "1.0.0.0" zu "2.0.0.0".

  3. Registrieren Sie höhergestufte benutzerdefinierte Workflowaktivität als eine neue Assembly. Stellen Sie sicher, dass die neue Assembly denselben Name, PublicKeyToken und Culture wie die vorhandene Assembly hat, damit sie als eine andere Version derselben Assembly angesehen wird.

Nachdem Sie die benutzerdefinierte Workflowaktivität aktualisiert haben, werden vorhandene Instanzen ausgeführter Prozesse, die die benutzerdefinierte Workflowaktivität verwenden, weiterhin die alte Version der benutzerdefinierten Workflowaktivitätsassembly verwenden. Dadurch wird sichergestellt, dass die vorhandenen ausgeführten Prozessinstanzen nicht unterbrochen werden. Wenn Sie möchten, dass der Vorgang die neue Version der benutzerdefinierten Workflowaktivität verwendet, müssen Sie die Prozessdefinition ändern, um die neue Version zu verwenden.Microsoft Dynamics 365 zeigt alle <major_version>- und <minor_version>-Kombinationen für eine Assembly in einer Dropdownliste an, aus der Sie auswählen können.

Benutzerdefinierte Workflowaktivitätsversion auswählen

Nachdem Sie alle Prozessdefinitionen aktualisiert haben, um die aktuellere Version zu verwenden, können Sie auch die Registrierung der älteren Versionen der benutzerdefinierten Workflowaktivität aufheben.

Siehe auch

Benutzerdefinierte Workflowaktivitäten (Workflowassemblys)
Prozessklassen, Attribute und Typen

Microsoft Dynamics 365

© 2017 Microsoft. Alle Rechte vorbehalten. Copyright