DocumentatieWorkfrontHandleiding voor Workfront

Abonnementsversie voor gebeurtenissen

Last update: Tue May 27 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Onderwerpen:

Gemaakt voor:

  • Ontwikkelaar

Workfront heeft twee versies van gebeurtenisabonnementen. In dit artikel worden de verschillen tussen de koppelingen beschreven.

De nieuwe versie is geen wijziging in de Workfront API, maar een wijziging in de functionaliteit voor abonnementen voor gebeurtenissen.

De capaciteit om gebeurtenisabonnementen te bevorderen of te degraderen zorgt ervoor dat wanneer de veranderingen in de structuur van gebeurtenissen worden aangebracht, de bestaande abonnementen niet breken, toestaand u om aan de nieuwe versie zonder een hiaat in uw gebeurtenisabonnement te testen en te bevorderen.

Wanneer u uw gebeurtenissenabonnement upgradet of downloadt naar een andere versie, ontvangt u dubbele gebeurtenissen voor elke gebeurtenislevering gedurende een venster van vijf minuten na de versiewijziging. De duplicaten bevatten een van de versies 1 en 2 van het gebeurtenisabonnement. Dit zorgt ervoor dat u geen gebeurtenissen mist toe te schrijven aan het veranderen van de versie van het gebeurtenisabonnement.

Voor informatie over de eindpunten die voor bevordering of het degraderen van gebeurtenisabonnementen worden gebruikt, zie het abonnement van de Gebeurtenis versioningin het abonnement API van de artikelgebeurtenis.

IMPORTANT
De volgende releases zijn van invloed op het versiebeheer van abonnementen voor gebeurtenissen:
  • 25.2 Versie (10 April, 2025): Alle nieuwe abonnementen die na de versie 25.2 worden gecreeerd worden gecreeerd als Versie 2.
  • Januari 15, 2026: Alle resterende versies 1 abonnementen worden gemigreerd aan Versie 2.

Wijzigingen tussen versie 1 en versie 2

De volgende wijzigingen zijn aangebracht voor gebeurtenisabonnementen versie 2:

Algemene wijzigingen

Betrokken velden
Versie 1 (vorig gedrag)
Versie 2 (wijzigen)
Actie tot herstel
Berekende parameterwaarden
Elk object dat is gemaakt op basis van een sjabloon dat een aangepast formulier met berekende parameterwaarden bevat, wordt een gebeurtenis CREATE verzonden en vervolgens wordt een UPDATE verzonden met de parameterwaarden (inclusief berekende velden en de waarden ervan).
Wanneer een object wordt gemaakt op basis van een sjabloon die een aangepast formulier met berekende parameterwaarden bevat, wordt alleen een CREATE -gebeurtenis verzonden die parameterwaarden bevat, inclusief berekende velden.
Als u een abonnement op UPDATE -gebeurtenissen hebt en verwacht dat u een UPDATE -gebeurtenis ontvangt nadat een object met berekende parameterwaarden is gemaakt, ontvangt u niet langer die UPDATE -gebeurtenis. Als u berekende parameterwaarden wilt zien bij het maken van objecten, moet u een extra CREATE -abonnement maken.
Tekstvelden met meerdere selecties

Voor elk type gebeurtenis dat een wijziging bevat op een tekstveld met meerdere selecties geldt dat als het veld slechts één waarde bevat, deze waarde wordt omgezet in en verzonden als een tekenreeks. Anders wordt het als een array verzonden.

Voorbeelden:

  • myMultiSelectField: ["oneValue"] wordt geconverteerd en verzonden als myMultiSelectField: "oneValue" .
  • myMultiSelectField: ["first", "second"] wordt verzonden als myMultiSelectField: ["first", "second"].

Ongeacht het aantal waarden in de array, wordt deze als een array verzonden.

Voorbeelden:

  • myMultiSelectField: ["oneValue"] wordt verzonden als myMultiSelectField: ["oneValue"].
  • myMultiSelectField: ["first", "second"] wordt verzonden als myMultiSelectField: ["first", "second"].
Als u een abonnement hebt met een filter op een veld met meerdere keuzen en de waarde als tekenreeks, moet u een nieuw abonnement maken met hetzelfde filter dat de waarde als een array heeft.

Objectspecifieke wijzigingen

de code van Objecten
Betrokken gebieden
Versie 1 (Vorig gedrag)
Versie 2 (Verandering)
de actie van de Vergoeding
ASSGN
  • projectID
  • taskID
  • opTaskID
  • customerID
Wanneer dit object is bijgewerkt, geeft de gebeurtenis UPDATE soms ten onrechte aan dat de desbetreffende velden zijn gewijzigd van null in ID value .
Alle UPDATE -gebeurtenissen geven de juiste waarde voor de desbetreffende velden aan.
Geen. Als u een filter op de betrokken gebieden hebt, ontvangt u een gebeurtenis UPDATE slechts als deze gebieden werkelijk zijn veranderd, niet als een andere waarde is veranderd.
DOCU
  • referenceObjID
Wanneer een parameterwaarde op dit object is bijgewerkt, geeft de gebeurtenis UPDATE een onjuiste wijziging van het desbetreffende veld van null in object id weer.
Alle UPDATE -gebeurtenissen geven de juiste waarde voor de desbetreffende velden aan.
Geen. Als u een filter op de betrokken gebieden hebt, ontvangt u een gebeurtenis UPDATE slechts als deze gebieden werkelijk zijn veranderd, niet als een andere waarde is veranderd.
  • groups
Wanneer een document is verwijderd, wordt het desbetreffende veld door de gebeurtenis DELETE onjuist weergegeven als een lege array in de status voor.
De gebeurtenis DELETE geeft het desbetreffende veld correct vóór de status weer.
Geen. De gebeurtenis DELETE wordt wel verzonden, maar nu worden de juiste gegevens voor het desbetreffende veld weergegeven.
DOCV
  • proofDecision
  • proofName
  • proofProgress
Wanneer dit object werd bijgewerkt, worden twee UPDATE -gebeurtenissen verzonden. Het eerste veld bevatte niet de betrokken velden, terwijl het tweede evenement dat wel deed.
Alle veldupdates, inclusief de betrokken velden, zijn aanwezig in slechts één UPDATE -gebeurtenis en er wordt geen tweede onnodige gebeurtenis verzonden.
Geen. Als u een filter op de betrokken gebieden hebt, worden de gebeurtenissen geleverd in de eerste gebeurtenis.
EXPNS
  • topReferenceObjCode
  • referenceObjectName
Wanneer een willekeurige parameterwaarde op een kostenwaarde is bijgewerkt, heeft de gebeurtenis UPDATE een onjuiste wijziging van topReferenceObjCode van EXPNS naar PROJ getoond en wordt referenceObjectName gewijzigd van null naar string value of project name .
Alle UPDATE -gebeurtenissen geven de juiste waarde voor de desbetreffende velden aan.
Geen. Als u een filter op de betrokken gebieden hebt, ontvangt u een gebeurtenis UPDATE slechts als deze gebieden werkelijk zijn veranderd, niet als een andere waarde is veranderd.
  • topReferenceObjCode
  • referenceObjectName
Wanneer een object Expense werd verwijderd, werd een gebeurtenis UPDATE verzonden waarbij de betrokken velden werden gewijzigd in null voordat de gebeurtenis DELETE werd verzonden.
De extra UPDATE -gebeurtenis wordt niet verzonden. De gebeurtenis DELETE heeft juiste waarden voor de desbetreffende velden in de status vóór.
Als u een filter hebt voor de desbetreffende velden op UPDATE -gebeurtenissen en verwacht dat u dit filter ontvangt wanneer het object wordt verwijderd, ontvangt u niet langer de gebeurtenis UPDATE . Als u deze velden wilt zien wanneer het object wordt verwijderd, moet u een extra abonnement voor DELETE maken.
UUR
  • projectID
  • taskID
  • roleID
  • timesheetID
  • hourTypeID
  • projectOverheadID
  • referenceObjID
  • referenceObjCode
  • securityRootID
Wanneer dit object is verwijderd, worden de desbetreffende velden door de gebeurtenis DELETE onjuist weergegeven als null in de status voor.
De gebeurtenis DELETE geeft de desbetreffende velden correct weer in de toestand Voor.
Geen. De gebeurtenis DELETE wordt nog steeds verzonden, maar geeft nu de juiste gegevens voor de desbetreffende velden weer.
OPTASK
  • rootGroupID
Wanneer een parameterwaarde op dit object is bijgewerkt, geeft de gebeurtenis UPDATE een onjuiste wijziging van het desbetreffende veld van null in ID value weer.
Alle UPDATE -gebeurtenissen geven de juiste waarde voor het desbetreffende veld aan.
Geen. Als u een filter op het beïnvloede gebied hebt, ontvangt u een UPDATE gebeurtenis slechts als dat gebied eigenlijk is veranderd, niet als een andere parameterwaarde is veranderd.
  • resolveProjectID
  • resolveTaskID
  • resolvingObjID
Wanneer dit object is bijgewerkt, geeft de gebeurtenis UPDATE soms ten onrechte aan dat de desbetreffende velden zijn gewijzigd van null in ID value .
In alle UPDATE -gebeurtenissen wordt de juiste waarde voor de desbetreffende velden weergegeven.
PROJ
  • rootGroupID
Wanneer een parameterwaarde op dit object is bijgewerkt, geeft de gebeurtenis UPDATE een onjuiste wijziging van het desbetreffende veld van null in ID value weer.
Alle UPDATE -gebeurtenissen geven de juiste waarde voor het desbetreffende veld aan.
Geen. Als u een filter op het beïnvloede gebied hebt, ontvangt u een UPDATE gebeurtenis slechts als dat gebied eigenlijk is veranderd, niet als een andere parameterwaarde is veranderd.
  • convertedOpTaskID
Wanneer dit object is bijgewerkt, geeft de gebeurtenis UPDATE soms ten onrechte aan dat de desbetreffende velden zijn gewijzigd van null in ID value .
Alle UPDATE -gebeurtenissen geven de juiste waarde voor het desbetreffende veld aan.
Geen. Als u een filter op het beïnvloede gebied hebt, ontvangt u een UPDATE gebeurtenis slechts als dat gebied eigenlijk is veranderd, niet als een andere parameterwaarde is veranderd.
TAAK
  • rootGroupID
Wanneer een parameterwaarde op dit object is bijgewerkt, geeft de gebeurtenis UPDATE een onjuiste wijziging van het desbetreffende veld van null in ID value weer.
Alle UPDATE -gebeurtenissen geven de juiste waarde voor het desbetreffende veld aan.
Geen. Als u een filter op het beïnvloede gebied hebt, ontvangt u een UPDATE gebeurtenis slechts als dat gebied eigenlijk is veranderd, niet als een andere parameterwaarde is veranderd.
  • convertedOpTaskID
Wanneer dit object is bijgewerkt, geeft de gebeurtenis UPDATE soms ten onrechte aan dat de desbetreffende velden zijn gewijzigd van null in ID value .
Alle UPDATE -gebeurtenissen geven de juiste waarde voor het desbetreffende veld aan.
Geen. Als u een filter op het beïnvloede gebied hebt, ontvangt u een UPDATE gebeurtenis slechts als dat gebied eigenlijk is veranderd, niet als een andere parameterwaarde is veranderd.

De versie van het gebeurtenisabonnement in een scenario van Workfront Fusion bijwerken

Workfront Fusion gebruikt gebeurtenisabonnementen om op veranderingen in Workfront te letten om scenario's teweeg te brengen. U kunt de versie van de gebeurtenisbeschrijving die Fusion direct in een scenario gebruikt bijwerken, gebruikend Workfront > de module van de Versie van de Payload van Gebeurtenissen bijwerken.

Voor instructies bij het gebruiken van deze module, zie modules van Workfrontin de documentatie van de Fusie van Workfront.

Voor middelen bij het bewaren van uw scenario's van de Fusie van Workfront tijdens de verbetering van het gebeurtenisabonnement, met inbegrip van een webinar opname, zie het Behouden van Uw Scenario's van de Fusie tijdens de Verbetering van de Abonnementen V2 van de Gebeurtenis.

recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43