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.
- 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
CREATE
-händelse skickas och sedan skickas en UPDATE
med parametervärdena (inklusive beräknade fält och deras värden).CREATE
-händelse och den kommer att innehålla parametervärden inklusive beräknade fält.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.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 sommyMultiSelectField: "oneValue"
.myMultiSelectField: ["first", "second"]
skickas sommyMultiSelectField: ["first", "second"]
.
Oavsett hur många värden som finns i arrayen skickas den som en array.
Exempel:
myMultiSelectField: ["oneValue"]
skickas sommyMultiSelectField: ["oneValue"]
.myMultiSelectField: ["first", "second"]
skickas sommyMultiSelectField: ["first", "second"]
.
Objektspecifika ändringar
projectID
taskID
opTaskID
customerID
UPDATE
-händelsen ibland felaktigt att de påverkade fälten ändras från null
till ID value
.UPDATE
-händelser visar rätt värde för de påverkade fälten.UPDATE
-händelse om dessa fält har ändrats, inte om något annat värde har ändrats.referenceObjID
UPDATE
felaktigt ändringen av det påverkade fältet från null
till object id
.UPDATE
-händelser visar rätt värde för de påverkade fälten.UPDATE
-händelse om dessa fält har ändrats, inte om något annat värde har ändrats.groups
DELETE
-händelsen felaktigt det påverkade fältet som en tom array i det föregående läget.DELETE
visar korrekt det påverkade fältet i det föregående läget.DELETE
-händelsen kommer fortfarande att skickas, men nu visas korrekta data för det påverkade fältet.proofDecision
proofName
proofProgress
UPDATE
-händelser. Den första innehöll inte de påverkade fälten medan den andra händelsen utfördes.UPDATE
-händelse och en andra onödig händelse skickas inte.topReferenceObjCode
referenceObjectName
UPDATE
felaktigt ändringen av topReferenceObjCode från EXPNS
till PROJ
och referenceObjectName
ändrades från null
till string value of project name
.UPDATE
-händelser visar rätt värde för de påverkade fälten.UPDATE
-händelse om dessa fält har ändrats, inte om något annat värde har ändrats.topReferenceObjCode
referenceObjectName
UPDATE
-händelse som ändrade de berörda fälten till null innan DELETE
-händelsen skickades.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.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.projectID
taskID
roleID
timesheetID
hourTypeID
projectOverheadID
referenceObjID
referenceObjCode
securityRootID
DELETE
-händelsen felaktigt de påverkade fälten som null
i det föregående läget.DELETE
visar de fält som påverkas i det föregående läget.DELETE
skickas fortfarande, men nu visas korrekta data för de påverkade fälten.rootGroupID
UPDATE
felaktigt ändringen av det påverkade fältet från null
till ID value
.UPDATE
-händelser visar rätt värde för det påverkade fältet.UPDATE
-händelse om fältet faktiskt har ändrats, inte om något annat parametervärde har ändrats.resolveProjectID
resolveTaskID
resolvingObjID
UPDATE
-händelsen ibland felaktigt att de påverkade fälten ändras från null
till ID value
.UPDATE
-händelser visar rätt värde för de påverkade fälten.rootGroupID
UPDATE
felaktigt ändringen av det påverkade fältet från null
till ID value
.UPDATE
-händelser visar rätt värde för det påverkade fältet.UPDATE
-händelse om fältet faktiskt har ändrats, inte om något annat parametervärde har ändrats.convertedOpTaskID
UPDATE
-händelsen ibland felaktigt att de påverkade fälten ändras från null
till ID value
.UPDATE
-händelser visar rätt värde för det påverkade fältet.UPDATE
-händelse om fältet faktiskt har ändrats, inte om något annat parametervärde har ändrats.rootGroupID
UPDATE
felaktigt ändringen av det påverkade fältet från null
till ID value
.UPDATE
-händelser visar rätt värde för det påverkade fältet.UPDATE
-händelse om fältet faktiskt har ändrats, inte om något annat parametervärde har ändrats.convertedOpTaskID
UPDATE
-händelsen ibland felaktigt att de påverkade fälten ändras från null
till ID value
.UPDATE
-händelser visar rätt värde för det påverkade fältet.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.