Versionshantering för händelseteckning

Workfront har två versioner av abonnemang. I den här artikeln beskrivs skillnaderna mellan dem.

Den nya versionen är inte en ändring av Workfront API, utan snarare en ändring av prenumerationsfunktionen för evenemang.

Möjligheten att uppgradera eller nedgradera abonnemang säkerställer att befintliga prenumerationer inte bryts när händelsestrukturen ändras, vilket gör att du kan testa och uppgradera till den nya versionen utan avbrott i prenumerationen.

När du uppgraderar eller nedgraderar din eventprenumeration till en annan version får du dubbletthändelser för varje eventleverans i fem minuter efter att versionen ändrats. Dubbletterna innehåller en av alla händelseprenumerationer, version 1 och version 2. Detta säkerställer att du inte missar några händelser på grund av att du har ändrat versionen av en händelseprenumeration.

Mer information om slutpunkterna som används för att uppgradera eller nedgradera händelseprenumerationer finns i Versionsinformation om händelseprenumerationer i artikeln Event-prenumerations-API.

IMPORTANT
Följande versioner kommer att påverka versionshantering av händelseprenumerationer:
  • 25.2 utgåva (10 april 2025): Alla nya prenumerationer som skapas efter version 25.2 skapas som version 2.
  • 15 januari 2026: Alla återstående prenumerationer på version 1 migreras till version 2.

Ändringar mellan version 1 och version 2

Följande ändringar har gjorts för händelseprenumerationer version 2:

Allmänna ändringar

Påverkade fält
Version 1 (beteendet Föregående)
Version 2 (Ändra)
Åtgärd för reparation
Beräknade parametervärden
Alla objekt som skapas från en mall som innehåller ett anpassat formulär med beräknade parametervärden, en CREATE-händelse skickas och sedan skickas en UPDATE med parametervärdena (inklusive beräknade fält och deras värden).
När ett objekt skapas från en mall som innehåller ett anpassat formulär med beräknade parametervärden, skickas bara en CREATE-händelse och den kommer att innehålla parametervärden inklusive beräknade fält.
Om du har en prenumeration på UPDATE händelser och väntar på att få en UPDATE -händelse efter att ett objekt har skapats med beräknade parametervärden, kommer du inte längre att få den UPDATE händelsen. Om du vill se beräknade parametervärden när du skapar objekt måste du skapa ytterligare en CREATE-prenumeration.
Flervalsfält

För alla typer av händelser som innehåller en ändring i ett flervalsfält konverteras det till och skickas som en sträng om fältet bara innehåller ett värde. Annars skickas den som en array.

Exempel:

  • myMultiSelectField: ["oneValue"] konverteras och skickas som myMultiSelectField: "oneValue".
  • myMultiSelectField: ["first", "second"] skickas som myMultiSelectField: ["first", "second"].

Oavsett hur många värden som finns i arrayen skickas den som en array.

Exempel:

  • myMultiSelectField: ["oneValue"] skickas som myMultiSelectField: ["oneValue"].
  • myMultiSelectField: ["first", "second"] skickas som myMultiSelectField: ["first", "second"].
Om du har en prenumeration med ett filter i ett flervalsfält, och värdet som en sträng, måste du skapa en ny prenumeration med samma filter som har värdet som en array.

Objektspecifika ändringar

Objektkod
Påverkade fält
Version 1 (Föregående beteende)
Version 2 (Ändra)
Reparationsåtgärd
ASSGN
  • projectID
  • taskID
  • opTaskID
  • customerID
När det här objektet uppdaterades visade UPDATE-händelsen ibland felaktigt att de påverkade fälten ändras från null till ID value.
Alla UPDATE-händelser visar rätt värde för de påverkade fälten.
Ingen. Om du har ett filter för de berörda fälten får du bara en UPDATE-händelse om dessa fält har ändrats, inte om något annat värde har ändrats.
DOCU
  • referenceObjID
När ett parametervärde uppdaterades för det här objektet visade händelsen UPDATE felaktigt ändringen av det påverkade fältet från null till object id.
Alla UPDATE-händelser visar rätt värde för de påverkade fälten.
Ingen. Om du har ett filter för de berörda fälten får du bara en UPDATE-händelse om dessa fält har ändrats, inte om något annat värde har ändrats.
  • groups
När ett dokument togs bort visade DELETE-händelsen felaktigt det påverkade fältet som en tom array i det föregående läget.
Händelsen DELETE visar korrekt det påverkade fältet i det föregående läget.
Ingen. DELETE-händelsen kommer fortfarande att skickas, men nu visas korrekta data för det påverkade fältet.
DOCV
  • proofDecision
  • proofName
  • proofProgress
När det här objektet uppdaterades skickas två UPDATE-händelser. Den första innehöll inte de påverkade fälten medan den andra händelsen utfördes.
Alla fältuppdateringar, inklusive de påverkade fälten, finns endast i en UPDATE-händelse och en andra onödig händelse skickas inte.
Ingen. Om du har ett filter för de fält som påverkas levereras händelserna i den första händelsen.
EXPNS
  • topReferenceObjCode
  • referenceObjectName
När ett parametervärde uppdaterades för en utgift visade händelsen UPDATE felaktigt ändringen av topReferenceObjCode från EXPNS till PROJ och referenceObjectName ändrades från null till string value of project name.
Alla UPDATE-händelser visar rätt värde för de påverkade fälten.
Ingen. Om du har ett filter för de berörda fälten får du bara en UPDATE-händelse om dessa fält har ändrats, inte om något annat värde har ändrats.
  • topReferenceObjCode
  • referenceObjectName
När ett utgiftsobjekt togs bort skickades en UPDATE-händelse som ändrade de berörda fälten till null innan DELETE-händelsen skickades.
Den extra UPDATE-händelsen skickas inte. Händelsen DELETE har rätt värden för de påverkade fälten i det föregående läget.
Om du har ett filter för de fält som påverkas av UPDATE-händelser och förväntas ta emot det när objektet tas bort, får du inte längre den UPDATE -händelsen. Om du vill se de här fälten när objektet tas bort måste du skapa ytterligare en DELETE-prenumeration.
TIMME
  • projectID
  • taskID
  • roleID
  • timesheetID
  • hourTypeID
  • projectOverheadID
  • referenceObjID
  • referenceObjCode
  • securityRootID
När det här objektet togs bort visade DELETE-händelsen felaktigt de påverkade fälten som null i det föregående läget.
Händelsen DELETE visar de fält som påverkas i det föregående läget.
Ingen. Händelsen DELETE skickas fortfarande, men nu visas korrekta data för de påverkade fälten.
OPTASK
  • rootGroupID
När ett parametervärde uppdaterades för det här objektet visade händelsen UPDATE felaktigt ändringen av det påverkade fältet från null till ID value.
Alla UPDATE-händelser visar rätt värde för det påverkade fältet.
Ingen. Om du har ett filter för det påverkade fältet får du bara en UPDATE-händelse om fältet faktiskt har ändrats, inte om något annat parametervärde har ändrats.
  • resolveProjectID
  • resolveTaskID
  • resolvingObjID
När det här objektet uppdaterades visade UPDATE-händelsen ibland felaktigt att de påverkade fälten ändras från null till ID value.
Alla UPDATE-händelser visar rätt värde för de påverkade fälten.
PROJ
  • rootGroupID
När ett parametervärde uppdaterades för det här objektet visade händelsen UPDATE felaktigt ändringen av det påverkade fältet från null till ID value.
Alla UPDATE-händelser visar rätt värde för det påverkade fältet.
Ingen. Om du har ett filter för det påverkade fältet får du bara en UPDATE-händelse om fältet faktiskt har ändrats, inte om något annat parametervärde har ändrats.
  • convertedOpTaskID
När det här objektet uppdaterades visade UPDATE-händelsen ibland felaktigt att de påverkade fälten ändras från null till ID value.
Alla UPDATE-händelser visar rätt värde för det påverkade fältet.
Ingen. Om du har ett filter för det påverkade fältet får du bara en UPDATE-händelse om fältet faktiskt har ändrats, inte om något annat parametervärde har ändrats.
UPPGIFT
  • rootGroupID
När ett parametervärde uppdaterades för det här objektet visade händelsen UPDATE felaktigt ändringen av det påverkade fältet från null till ID value.
Alla UPDATE-händelser visar rätt värde för det påverkade fältet.
Ingen. Om du har ett filter för det påverkade fältet får du bara en UPDATE-händelse om fältet faktiskt har ändrats, inte om något annat parametervärde har ändrats.
  • convertedOpTaskID
När det här objektet uppdaterades visade UPDATE-händelsen ibland felaktigt att de påverkade fälten ändras från null till ID value.
Alla UPDATE-händelser visar rätt värde för det påverkade fältet.
Ingen. Om du har ett filter för det påverkade fältet får du bara en UPDATE-händelse om fältet faktiskt har ändrats, inte om något annat parametervärde har ändrats.

Uppdatera händelseteckningsversion i ett Workfront Fusion-scenario

Workfront Fusion använder händelseprenumerationer för att hålla utkik efter förändringar i Workfront för att utlösa scenarier. Du kan uppdatera den händelseprenumerationsversion som Fusion använder direkt i ett scenario med hjälp av modulen Workfront > Update Events Payload Version.

Instruktioner om hur du använder den här modulen finns i Workfront-moduler i dokumentationen för Workfront Fusion.

Mer information om hur du bevarar dina Workfront Fusion-scenarier under händelseprenumerationsuppgraderingen, inklusive en webbinariainspelning, finns i Bevara dina Fusion-scenarier under händelseprenumerationsuppgraderingen v2.

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