Versionierung von Ereignisabonnements
Workfront verfügt über zwei Versionen von Ereignisabonnements. Dieser Artikel beschreibt die Unterschiede zwischen ihnen.
Die neue Version ist keine Änderung der Workfront-API, sondern eine Änderung der Ereignisabonnementfunktion.
Die Möglichkeit, Ereignisabonnements zu aktualisieren oder herabzustufen, stellt sicher, dass vorhandene Abonnements nicht beschädigt werden, wenn Änderungen an der Ereignisstruktur vorgenommen werden, sodass Sie ohne Lücke in Ihrem Ereignisabonnement testen und auf die neue Version aktualisieren können.
Wenn Sie Ihr Ereignisabonnement auf eine andere Version aktualisieren oder herunterstufen, erhalten Sie nach der Versionsänderung für jeden Ereignisversand für ein Zeitfenster von fünf Minuten doppelte Ereignisse. Die Duplikate enthalten je eines der Ereignisabonnements, Version 1 und Version 2. Dadurch wird sichergestellt, dass Sie keine Ereignisse aufgrund einer Änderung der Ereignisabonnementversion verpassen.
Informationen zu den Endpunkten, die zum Aktualisieren oder Herunterstufen von Ereignisabonnements verwendet werden, finden Sie Ereignisabonnement-Versionierung im Artikel Ereignisabonnement-API.
- 25.2 Version (10. April 2025): Alle neuen Abonnements, die nach der Version 25.2 erstellt wurden, werden als Version 2 erstellt.
- 15. Januar 2026: Alle verbleibenden Version 1-Abonnements werden auf Version 2 migriert.
Änderungen zwischen Version 1 und Version 2
Die folgenden Änderungen wurden für Ereignisabonnements Version 2 vorgenommen:
Allgemeine Änderungen
CREATE-Ereignis gesendet und anschließend wird ein UPDATE mit den Parameterwerten (einschließlich berechneter Felder und ihrer Werte) gesendet.CREATE gesendet, das Parameterwerte einschließlich berechneter Felder enthält.UPDATE Ereignisse verfügen und ein UPDATE Ereignis erwarten, nachdem ein Objekt mit berechneten Parameterwerten erstellt wurde, erhalten Sie dieses UPDATE Ereignis nicht mehr. Wenn Sie berechnete Parameterwerte bei der Objekterstellung anzeigen möchten, müssen Sie ein zusätzliches CREATE erstellen.Für jeden Ereignistyp, der eine Änderung an einem Feld vom Typ Mehrfachauswahl enthält, würde das Feld, wenn es nur einen Wert enthält, in konvertiert und als Zeichenfolge gesendet. Andernfalls wird es als Array gesendet.
Beispiele:
myMultiSelectField: ["oneValue"]wird konvertiert und alsmyMultiSelectField: "oneValue"gesendet.myMultiSelectField: ["first", "second"]wird alsmyMultiSelectField: ["first", "second"]gesendet.
Unabhängig davon, wie viele Werte sich im Array befinden, wird es als Array gesendet.
Beispiele:
myMultiSelectField: ["oneValue"]wird alsmyMultiSelectField: ["oneValue"]gesendet.myMultiSelectField: ["first", "second"]wird alsmyMultiSelectField: ["first", "second"]gesendet.
Objektspezifische Änderungen
projectIDtaskIDopTaskIDcustomerID
UPDATE-Ereignis manchmal fälschlicherweise die betroffenen Felder an, die sich von null zu ID value ändern.UPDATE Ereignisse zeigen den richtigen Wert für die betroffenen Felder an.UPDATE, wenn sich diese Felder tatsächlich geändert haben, nicht jedoch, wenn sich ein anderer Wert geändert hat.referenceObjID
UPDATE fälschlicherweise die betroffene Feldänderung von null zu object id an.UPDATE Ereignisse zeigen den richtigen Wert für die betroffenen Felder an.UPDATE, wenn sich diese Felder tatsächlich geändert haben, nicht jedoch, wenn sich ein anderer Wert geändert hat.groups
DELETE-Ereignis das betroffene Feld im Status Vor fälschlicherweise als leeres Array an.DELETE-Ereignis zeigt das betroffene Feld im Status Vor korrekt an.DELETE wird weiterhin gesendet, zeigt aber jetzt die korrekten Daten für das betroffene Feld an.proofDecisionproofNameproofProgress
UPDATE-Ereignisse gesendet. Die erste umfasste nicht die betroffenen Felder, während das zweite Ereignis dies tat.UPDATE Ereignis vorhanden, und ein zweites unnötiges Ereignis wird nicht gesendet.topReferenceObjCodereferenceObjectName
UPDATE-Ereignis fälschlicherweise die TopReferenceObjCode-Änderung von EXPNS zu PROJ und referenceObjectName Änderung von null zu string value of project name an.UPDATE Ereignisse zeigen den richtigen Wert für die betroffenen Felder an.UPDATE, wenn sich diese Felder tatsächlich geändert haben, nicht jedoch, wenn sich ein anderer Wert geändert hat.topReferenceObjCodereferenceObjectName
UPDATE gesendet, durch das die betroffenen Felder in null geändert wurden, bevor das DELETE gesendet wurde.UPDATE wird nicht gesendet. Das DELETE-Ereignis hat korrekte Werte für die betroffenen Felder im Status Vor .UPDATE Ereignisse verfügen und erwarten, ihn zu erhalten, wenn das Objekt gelöscht wird, erhalten Sie dieses UPDATE Ereignis nicht mehr. Wenn diese Felder beim Löschen des Objekts angezeigt werden sollen, müssen Sie ein zusätzliches DELETE-Abonnement erstellen.projectIDtaskIDroleIDtimesheetIDhourTypeIDprojectOverheadIDreferenceObjIDreferenceObjCodesecurityRootID
DELETE-Ereignis fälschlicherweise wie im Status Vor null angezeigt.DELETE-Ereignis zeigt die betroffenen Felder im Status Vor korrekt an.DELETE wird weiterhin gesendet, zeigt aber jetzt die korrekten Daten für die betroffenen Felder an.rootGroupID
UPDATE fälschlicherweise die betroffene Feldänderung von null zu ID value an.UPDATE Ereignisse zeigen den richtigen Wert für das betroffene Feld an.UPDATE, wenn sich dieses Feld tatsächlich geändert hat, nicht jedoch, wenn sich ein anderer Parameterwert geändert hat.resolveProjectIDresolveTaskIDresolvingObjID
UPDATE-Ereignis manchmal fälschlicherweise die betroffenen Felder an, die sich von null zu ID value ändern.UPDATE Ereignissen wird der richtige Wert für die betroffenen Felder angezeigt.rootGroupID
UPDATE fälschlicherweise die betroffene Feldänderung von null zu ID value an.UPDATE Ereignisse zeigen den richtigen Wert für das betroffene Feld an.UPDATE, wenn sich dieses Feld tatsächlich geändert hat, nicht jedoch, wenn sich ein anderer Parameterwert geändert hat.convertedOpTaskID
UPDATE-Ereignis manchmal fälschlicherweise die betroffenen Felder an, die sich von null zu ID value ändern.UPDATE Ereignisse zeigen den richtigen Wert für das betroffene Feld an.UPDATE, wenn sich dieses Feld tatsächlich geändert hat, nicht jedoch, wenn sich ein anderer Parameterwert geändert hat.rootGroupID
UPDATE fälschlicherweise die betroffene Feldänderung von null zu ID value an.UPDATE Ereignisse zeigen den richtigen Wert für das betroffene Feld an.UPDATE, wenn sich dieses Feld tatsächlich geändert hat, nicht jedoch, wenn sich ein anderer Parameterwert geändert hat.convertedOpTaskID
UPDATE-Ereignis manchmal fälschlicherweise die betroffenen Felder an, die sich von null zu ID value ändern.UPDATE Ereignisse zeigen den richtigen Wert für das betroffene Feld an.UPDATE, wenn sich dieses Feld tatsächlich geändert hat, nicht jedoch, wenn sich ein anderer Parameterwert geändert hat.Aktualisieren der Ereignisabonnementversion in einem Workfront Fusion-Szenario
Workfront Fusion verwendet Ereignisabonnements, um auf Änderungen in Szenarien mit Workfront-Triggern zu achten. Sie können die Ereignisabonnementversion, die Fusion direkt in einem Szenario verwendet, mithilfe des Payload-Versionsmoduls Workfront > Ereignisse aktualisieren aktualisieren .
Anweisungen zur Verwendung dieses Moduls finden Sie unter Workfront-Module in der Dokumentation zu Workfront Fusion.
Ressourcen zum Beibehalten Ihrer Workfront Fusion-Szenarien während des Ereignisabonnement-Upgrades, einschließlich einer Webinar-Aufzeichnung, finden Sie unter Beibehalten Ihrer Fusion-Szenarien während des Ereignissabonnement-Upgrades V2.