Documentazione Workfront Guida di Workfront

Controllo delle versioni delle sottoscrizioni agli eventi

Ultimo aggiornamento: 22 aprile 2025

Argomenti:

Creato per:

Sviluppatore

In Workfront sono disponibili due versioni delle sottoscrizioni di eventi. Questo articolo descrive le differenze tra di essi.

La nuova versione non è una modifica all’API Workfront, ma piuttosto una modifica alla funzionalità di abbonamento agli eventi.

La possibilità di aggiornare o effettuare il downgrade degli abbonamenti agli eventi assicura che, quando vengono apportate modifiche alla struttura degli eventi, gli abbonamenti esistenti non si interrompano, consentendo di testare e aggiornare alla nuova versione senza interruzioni nell’abbonamento agli eventi.

Quando aggiorni o esegui il downgrade dell’abbonamento a un’altra versione, ricevi eventi duplicati per ogni consegna di eventi per una finestra di cinque minuti dopo la modifica della versione. I duplicati includono uno per ogni abbonamento all’evento versione 1 e versione 2. In questo modo non si perde nessun evento a causa della modifica della versione dell’abbonamento all’evento.

Per informazioni sugli endpoint utilizzati per l'aggiornamento o il downgrade delle sottoscrizioni di eventi, vedere Controllo delle versioni delle sottoscrizioni di eventi nell'articolo API delle sottoscrizioni di eventi.

IMPORTANT

Le seguenti versioni influiranno sul controllo delle versioni delle sottoscrizioni agli eventi:

Versione 25.2 (10 aprile 2025): tutte le nuove sottoscrizioni create dopo la versione 25.2 vengono create come versione 2.
Versione 25.3 (17 luglio 2025): non è più possibile effettuare il downgrade delle sottoscrizioni alla versione 1 dopo la versione 25.3.
1 settembre 2025: tutte le sottoscrizioni della versione 1 rimanenti sono state migrate alla versione 2.

Modifiche tra versione 1 e versione 2

Sono state apportate le seguenti modifiche per le sottoscrizioni di eventi versione 2:

Modifiche generali

Campi interessati Versione 1 (comportamento precedente) Versione 2 (modifica) Azione di risoluzione

Valori dei parametri calcolati Qualsiasi oggetto creato da un modello che includa un modulo personalizzato con valori di parametro calcolati, verrà inviato un evento CREATE e quindi verrà inviato un UPDATE con i valori di parametro (inclusi i campi calcolati e i relativi valori). Quando un oggetto viene creato da un modello che include un modulo personalizzato con valori dei parametri calcolati, verrà inviato solo un evento CREATE che conterrà i valori dei parametri, inclusi i campi calcolati. Se si dispone di una sottoscrizione per gli eventi UPDATE e si prevede di ricevere un evento UPDATE dopo che un oggetto è stato creato con i valori dei parametri calcolati, l'evento UPDATE non verrà più ricevuto. Se si desidera visualizzare i valori dei parametri calcolati durante la creazione dell'oggetto, è necessario creare una sottoscrizione CREATE aggiuntiva.

Campi di tipo a selezione multipla

Campi interessati	Versione 1 (comportamento precedente)	Versione 2 (modifica)	Azione di risoluzione
Valori dei parametri calcolati	Qualsiasi oggetto creato da un modello che includa un modulo personalizzato con valori di parametro calcolati, verrà inviato un evento `CREATE` e quindi verrà inviato un `UPDATE` con i valori di parametro (inclusi i campi calcolati e i relativi valori).	Quando un oggetto viene creato da un modello che include un modulo personalizzato con valori dei parametri calcolati, verrà inviato solo un evento `CREATE` che conterrà i valori dei parametri, inclusi i campi calcolati.	Se si dispone di una sottoscrizione per gli eventi `UPDATE` e si prevede di ricevere un evento `UPDATE` dopo che un oggetto è stato creato con i valori dei parametri calcolati, l'evento `UPDATE` non verrà più ricevuto. Se si desidera visualizzare i valori dei parametri calcolati durante la creazione dell'oggetto, è necessario creare una sottoscrizione `CREATE` aggiuntiva.
Campi di tipo a selezione multipla	Per qualsiasi tipo di evento che contiene una modifica in un campo di tipo a selezione multipla, se il campo conteneva un solo valore, verrebbe convertito in e inviato come stringa. In caso contrario, verrebbe inviato come array. Esempi: `myMultiSelectField: ["oneValue"]` viene convertito e inviato come `myMultiSelectField: "oneValue"`. `myMultiSelectField: ["first", "second"]` viene inviato come `myMultiSelectField: ["first", "second"]`.	Indipendentemente dal numero di valori presenti nell’array, questo verrà inviato come array. Esempi: `myMultiSelectField: ["oneValue"]` viene inviato come `myMultiSelectField: ["oneValue"]`. `myMultiSelectField: ["first", "second"]` viene inviato come `myMultiSelectField: ["first", "second"]`.	Se disponi di una sottoscrizione con un filtro su un campo a selezione multipla e il valore è una stringa, devi creare una nuova sottoscrizione con lo stesso filtro che ha il valore come array.

Per qualsiasi tipo di evento che contiene una modifica in un campo di tipo a selezione multipla, se il campo conteneva un solo valore, verrebbe convertito in e inviato come stringa. In caso contrario, verrebbe inviato come array.

Esempi:

myMultiSelectField: ["oneValue"] viene convertito e inviato come myMultiSelectField: "oneValue".
myMultiSelectField: ["first", "second"] viene inviato come myMultiSelectField: ["first", "second"].

Indipendentemente dal numero di valori presenti nell’array, questo verrà inviato come array.

Esempi:

myMultiSelectField: ["oneValue"] viene inviato come myMultiSelectField: ["oneValue"].
myMultiSelectField: ["first", "second"] viene inviato come myMultiSelectField: ["first", "second"].

Se disponi di una sottoscrizione con un filtro su un campo a selezione multipla e il valore è una stringa, devi creare una nuova sottoscrizione con lo stesso filtro che ha il valore come array.

Modifiche specifiche dell'oggetto

Codice oggetto	Campi interessati	Versione 1 (comportamento precedente)	Versione 2 (Modifica)	Azione di risoluzione
ASSEGNA	`projectID` `taskID` `opTaskID` `customerID`	Quando l'oggetto è stato aggiornato, l'evento `UPDATE` a volte mostrava in modo errato che i campi interessati cambiavano da `null` a `ID value`.	Tutti gli eventi `UPDATE` mostrano il valore corretto per i campi interessati.	Nessuno. Se disponi di un filtro per i campi interessati, riceverai un evento `UPDATE` solo se questi campi sono stati effettivamente modificati, non se è stato modificato un altro valore.
DOCU	`referenceObjID`	Quando un valore di parametro è stato aggiornato in questo oggetto, l'evento `UPDATE` ha mostrato erroneamente che il campo interessato è cambiato da `null` a `object id`.	Tutti gli eventi `UPDATE` mostrano il valore corretto per i campi interessati.	Nessuno. Se disponi di un filtro per i campi interessati, riceverai un evento `UPDATE` solo se questi campi sono stati effettivamente modificati, non se è stato modificato un altro valore.
DOCU	`groups`	Quando un documento è stato eliminato, l'evento `DELETE` mostrava erroneamente il campo interessato come una matrice vuota nello stato prima.	L'evento `DELETE` mostra correttamente il campo interessato nello stato prima.	Nessuno. L'evento `DELETE` verrà comunque inviato, ma ora mostra i dati corretti per il campo interessato.
DOCV	`proofDecision` `proofName` `proofProgress`	Quando questo oggetto viene aggiornato, vengono inviati due eventi `UPDATE`. Il primo non includeva i campi interessati, mentre il secondo evento sì.	Tutti gli aggiornamenti dei campi, inclusi i campi interessati, sono presenti in un solo evento `UPDATE` e non viene inviato un secondo evento non necessario.	Nessuno. Se disponi di un filtro per i campi interessati, gli eventi vengono consegnati nel primo evento.
EXPNS	`topReferenceObjCode` `referenceObjectName`	Quando un valore di parametro è stato aggiornato in una Spesa, l'evento `UPDATE` mostrava erroneamente la modifica di topReferenceObjCode da `EXPNS` a `PROJ` e la modifica di `referenceObjectName` da `null` a `string value of project name`.	Tutti gli eventi `UPDATE` mostrano il valore corretto per i campi interessati.	Nessuno. Se disponi di un filtro per i campi interessati, riceverai un evento `UPDATE` solo se questi campi sono stati effettivamente modificati, non se è stato modificato un altro valore.
EXPNS	`topReferenceObjCode` `referenceObjectName`	Quando un oggetto Expense è stato eliminato, è stato inviato un evento `UPDATE` modificando i campi interessati in null prima dell'invio dell'evento `DELETE`.	L'evento `UPDATE` aggiuntivo non viene inviato. L'evento `DELETE` contiene valori corretti per i campi interessati nello stato prima.	Se si dispone di un filtro per i campi interessati sugli eventi `UPDATE` e si prevede di riceverlo quando l'oggetto viene eliminato, l'evento `UPDATE` non verrà più ricevuto. Se si desidera visualizzare questi campi quando l'oggetto viene eliminato, è necessario creare una sottoscrizione `DELETE` aggiuntiva.
HOUR	`projectID` `taskID` `roleID` `timesheetID` `hourTypeID` `projectOverheadID` `referenceObjID` `referenceObjCode` `securityRootID`	Quando l'oggetto è stato eliminato, l'evento `DELETE` mostrava erroneamente i campi interessati come `null` nello stato prima.	L'evento `DELETE` mostra correttamente i campi interessati nello stato prima.	Nessuno. L'evento `DELETE` è ancora inviato, ma ora mostra i dati corretti per i campi interessati.
OPTASK	`rootGroupID`	Quando un valore di parametro è stato aggiornato in questo oggetto, l'evento `UPDATE` ha mostrato erroneamente che il campo interessato è cambiato da `null` a `ID value`.	Tutti gli eventi `UPDATE` mostrano il valore corretto per il campo interessato.	Nessuno. Se disponi di un filtro per il campo interessato, riceverai un evento `UPDATE` solo se tale campo è stato effettivamente modificato, non se è stato modificato un altro valore di parametro.
OPTASK	`resolveProjectID` `resolveTaskID` `resolvingObjID`	Quando l'oggetto è stato aggiornato, l'evento `UPDATE` a volte mostrava in modo errato che i campi interessati cambiavano da `null` a `ID value`.	Tutti gli eventi `UPDATE` mostreranno il valore corretto per i campi interessati.
PROJ	`rootGroupID`	Quando un valore di parametro è stato aggiornato in questo oggetto, l'evento `UPDATE` ha mostrato erroneamente che il campo interessato è cambiato da `null` a `ID value`.	Tutti gli eventi `UPDATE` mostrano il valore corretto per il campo interessato.	Nessuno. Se disponi di un filtro per il campo interessato, riceverai un evento `UPDATE` solo se tale campo è stato effettivamente modificato, non se è stato modificato un altro valore di parametro.
PROJ	`convertedOpTaskID`	Quando l'oggetto è stato aggiornato, l'evento `UPDATE` a volte mostrava in modo errato che i campi interessati cambiavano da `null` a `ID value`.	Tutti gli eventi `UPDATE` mostrano il valore corretto per il campo interessato.	Nessuno. Se disponi di un filtro per il campo interessato, riceverai un evento `UPDATE` solo se tale campo è stato effettivamente modificato, non se è stato modificato un altro valore di parametro.
ATTIVITÀ	`rootGroupID`	Quando un valore di parametro è stato aggiornato in questo oggetto, l'evento `UPDATE` ha mostrato erroneamente che il campo interessato è cambiato da `null` a `ID value`.	Tutti gli eventi `UPDATE` mostrano il valore corretto per il campo interessato.	Nessuno. Se disponi di un filtro per il campo interessato, riceverai un evento `UPDATE` solo se tale campo è stato effettivamente modificato, non se è stato modificato un altro valore di parametro.
ATTIVITÀ	`convertedOpTaskID`	Quando l'oggetto è stato aggiornato, l'evento `UPDATE` a volte mostrava in modo errato che i campi interessati cambiavano da `null` a `ID value`.	Tutti gli eventi `UPDATE` mostrano il valore corretto per il campo interessato.	Nessuno. Se disponi di un filtro per il campo interessato, riceverai un evento `UPDATE` solo se tale campo è stato effettivamente modificato, non se è stato modificato un altro valore di parametro.

Aggiornare la versione della sottoscrizione dell’evento in uno scenario Workfront Fusion

Workfront Fusion utilizza gli abbonamenti agli eventi per controllare le modifiche in Workfront per attivare gli scenari. Puoi aggiornare la versione della sottoscrizione dell’evento utilizzata direttamente da Fusion in uno scenario, utilizzando il modulo Workfront > Aggiorna versione payload eventi.

Per istruzioni sull'utilizzo di questo modulo, vedere Moduli Workfront nella documentazione di Workfront Fusion.

recommendation-more-help