DocumentazioneWorkfrontGuida di Workfront

Controllo delle versioni delle sottoscrizioni agli eventi

Last update: Tue May 27 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 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.
  • 15 gennaio 2026: 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

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.
  • 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.
  • 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.
  • 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.
  • 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.
  • 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.

Per le risorse sulla conservazione degli scenari di Workfront Fusion durante l'aggiornamento dell'abbonamento agli eventi, inclusa la registrazione di un webinar, consulta Conservazione degli scenari di Fusion durante l'aggiornamento V2 degli abbonamenti agli eventi.

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