Novità della versione 17 dell’API
Creato per:
- Sviluppatore
Adobe Workfront ha rilasciato la versione API 17 il 12 ottobre 2023. La versione 17 dell’API presenta le seguenti modifiche rispetto alla versione 16.
Risorse aggiunte
DocumentoEsterno (EXTDOC)
Un oggetto ExternalDocument è un documento o un'altra risorsa digitale che si trova in un provider di archiviazione documenti esterno a Workfront. Queste risorse possono essere collegate da e verso Workfront.
| Campi diretti |
|
| Campi core |
|
| Campi predefiniti |
|
| Azioni |
|
| Query |
|
| Operazioni |
|
UserLocation (USRLOC)
| Campi diretti |
|
| Campi di riferimento |
|
| Campi core |
|
Risorse rimosse
Nessuna risorsa rimossa per API versione 17
Risorse modificate
Le seguenti risorse sono state modificate per l’API versione 17.
Linea di base (BLIN)
Le linee di base sono istantanee delle prestazioni di un progetto in un determinato momento. Memorizzano informazioni chiave sul progetto, come date chiave, avanzamento, costi e ricavi.
L'oggetto Baseline ha rimosso il flag INLINE_EDITABLE.
Record fatturazione (BILL)
Un oggetto BillingRecord registra i ricavi, le ore o le spese che possono essere fatturati. Queste informazioni possono essere utilizzate per creare fatture in un sistema contabile esterno.
L'oggetto BillingRecord ha rimosso il flag INLINE_EDITABLE.
Società (CMPY)
Un oggetto Company rappresenta un'organizzazione costituita da un insieme di persone.
-
defaultInterface
Rimosso
Preferenze cliente (CUSTPR)
Un oggetto CustomerPreferences rappresenta l'insieme di preferenze impostate da un cliente per l'istanza di Workfront.
-
nome
È stato aggiunto il possibile valore "config.defaultToNewHomeDescription" (customer:config.defaultToNewHome)>/p?
Questo consente a un’organizzazione di impostare la nuova esperienza Home come predefinita per i propri utenti.
DocumentVersion (DOCV)
Un oggetto DocumentVersion rappresenta una versione specifica di un file, ad esempio materiale scritto, immagini o altre forme di informazioni.
-
externalIntegrationType
È stato aggiunto il possibile valore "Frame.io" (FRAMEIO)
-
tipoFile
È stato aggiunto il possibile valore "enum.filetype.site" (sito)
Tasso di cambio (EXRATE)
Un oggetto ExchangeRate rappresenta un tasso di cambio impostato in Workfront. Gli oggetti ExchangeRate non sono dinamici.
Sono stati aggiunti i seguenti campi:
-
endDate
-
startDate
-
getCustomerCurrencies
Aggiunto.
Spesa (EXPNS)
Le spese rappresentano i costi non di manodopera che potrebbero essere sostenuti durante la durata di un progetto.
L'oggetto Expense ha rimosso il flag INLINE_EDITABLE.
Gruppo (GROUP)
Un oggetto Group rappresenta un insieme di utenti e team. I gruppi spesso rappresentano la struttura di reparto.
-
defaultInterface
Rimosso
Ora (HOUR)
Un oggetto Hour rappresenta un'ora registrata da un utente su una scheda orario.
L'oggetto Hour ha rimosso il flag INLINE_EDITABLE.
Iterazione (ITRN)
Un oggetto Iteration rappresenta una singola iterazione Agile. Le iterazioni sono periodi di tempo distinti utilizzati per pianificare e completare le storie di Agile.
L'oggetto Iteration ha rimosso il flag INLINE_EDITABLE.
VoceDiario (JRNLE)
L'oggetto JournalEntry può essere impostato per registrare informazioni su campi oggetto specifici ogni volta che tali campi vengono modificati. Quando un campo è impostato per essere registrato come parte dell'oggetto Voce diario, viene creata una voce corrispondente ogni volta che tale campo viene modificato.
-
changeType
Sono stati aggiunti i seguenti valori possibili:
- Approvatore aggiunto (AAA)
- Revisore aggiunto (AAR)
- Revisore rimosso (ARR)
- Approvatore rimosso (ARA)
- Decisione approvata (ADA)
- Decisione approvata con modifiche (ADC)
- Necessità di lavoro per le decisioni (ADN)
- Decisione revocata (ADR)
- Approvatore cambiato (AAC)
- Revisore modificato (ARC)
- Revisione completata (RDC)
- Revisione revocata (RDR)
- Publish (PUB)
Kanban Board (KNBNBD)
Una bacheca Kanban viene utilizzata per monitorare le attività in un ambiente Agile.
L'oggetto Kanban Board ha rimosso il flag INLINE_EDITABLE.
LinkedFolder (LNKFDR)
Un oggetto LinkedFolder rappresenta una cartella collegata da un provider di documenti esterno, ad esempio Google Drive o Dropbox.
-
externalIntegrationType
È stato aggiunto il valore possibile "Frame.io (FRAMEIO)
Attività/Problema Op (OPTASK)
Un oggetto OpTask è comunemente noto come Issue. Un problema è un elemento di lavoro che in genere indica la presenza di un problema che impedisce il completamento di un'attività o di un progetto. Un problema può anche essere una richiesta dell’helpdesk. Anche gli ordini di modifica, le richieste e i bug sono problemi.
L'oggetto Issue ha rimosso il flag INLINE_EDITABLE.
Progetto (PROJ)
I progetti sono elementi di lavoro all’interno di Workfront e costituiscono un elemento fondamentale nel modo in cui Workfront aiuta le persone a lavorare. Un oggetto Project rappresenta un gruppo di attività con un obiettivo comune specifico.
L'oggetto Project ha rimosso il flag INLINE_EDITABLE.
ProjectUser (PRTU)
Un oggetto ProjectUser rappresenta un utente associato a un progetto specifico.
-
ID
Aggiunto.
-
ID
Aggiunto.
Tariffa (RATE)
Un oggetto Rate rappresenta una tariffa di fatturazione in Workfront.
L'oggetto Rate ha rimosso il flag INLINE_EDITABLE.
Sono state aggiunte le seguenti azioni per supportare la funzionalità Rate Card:
-
deleteRateForRole
-
editRatesForRole
-
getUsedClassifierIds
-
setRatesFromRateCard
L'azione setRatesForRole è stata modificata per aggiungere i campi seguenti:
- classifierID
- currencyCode
- sourceRateCardID
Rischio (RISCHIO)
Un oggetto Rischio rappresenta un possibile evento che può impedire il completamento di un progetto in tempo o entro i limiti del budget. I progetti in fase di pianificazione presentano rischi aggiuntivi per individuare potenziali ostacoli prima dell’approvazione di qualsiasi lavoro.
L'oggetto Risk ha rimosso il flag INLINE_EDITABLE.
Ruolo/Ruolo (ROLE)
Un oggetto Ruolo (ruolo) rappresenta una capacità funzionale o un insieme di competenze che un utente potrebbe acquisire, ad esempio Designer o Product Manager.
-
defaultInterface
Rimosso
Attività (TASK)
Un oggetto Task rappresenta un elemento di lavoro che deve essere eseguito come passo verso il raggiungimento di un obiettivo finale (completamento di un progetto).
L'oggetto Task ha rimosso il flag INLINE_EDITABLE.
Team (TEAMOB)
Un oggetto Team è un insieme di Utenti che possono essere assegnati a un elemento di lavoro.
-
defaultInterface
Rimosso
Membro team (TEAMMB)
Un oggetto TeamMember è un utente associato a un team specifico.
-
ID
Aggiunto.
-
ID
Aggiunto.
TemplateUser (TMTU)
-
ID
Aggiunto.
-
ID
Aggiunto.
Scheda orario (TSHET)
Un oggetto Timesheet rappresenta un foglio ore virtuale che consente agli utenti di immettere le ore effettivamente lavorate per le attività, i progetti e i tipi di ore di lavoro comune.
-
objCode
Rimosso
Aggiorna (AGGIORNA)
È possibile aggiornare gli elementi di lavoro in Workfront per informare gli utenti dello stato corrente. Un oggetto Update rappresenta uno di questi aggiornamenti. Gli aggiornamenti possono essere immessi dagli utenti o creati dal sistema Workfront.
-
changeType
Sono stati aggiunti i seguenti valori:
- Approvatore aggiunto (assetapprovalAddApprover)
- Revisore aggiunto (assetapprovalAddReviewer)
- Autorizzatore rimosso (assetapprovalRemoveApprover)
- Revisore rimosso (assetapprovalRemoveReviewer)
- Decisione approvata (assetapprovalDecisionApproved)
- Lavoro necessario per le decisioni (assetapprovalDecisionNeedsWork)
- Decisione approvata con modifiche (assetapprovalDecisionApprovedChanges)
- Decisione revocata (assetapprovalDecisionRevoked)
- Approvatore modificato (assetapprovalApproverChanged)
- Revisore modificato (assetapprovalReviewerChanged)
- Revisione completata (assetapprovalReviewerDecisionComplete)
- Revisione revocata (assetapprovalReviewerDecisionRevoked)
- Errore di invio documento esterno (externalDocumentSendError)
- Versione documento pubblicata (documentVersionPublish)
- Flusso di lavoro cartelle collegate (linkedFolderWorkflow)
Utente (USER)
Un oggetto User rappresenta una persona con un account in Workfront che può accedere e interagire con il sistema.
L'oggetto User ha rimosso il flag INLINE_EDITABLE.
-
workTime
Questo campo è stato aggiunto ed è un numero compreso tra 0 e 1 che rappresenta ogni giorno la percentuale di tempo che un utente può dedicare al lavoro del progetto (lavoro non comune). Il valore 1 indica che l’utente può dedicare il 100% del proprio tempo al lavoro di progetto.
- posizioniUtente
UserGroups (USRGPS)
-
ID
Aggiunto.
-
ID
Aggiunto.
UserNote (USRNOT)
Un oggetto UserNote è una notifica.
-
changeType
Sono stati aggiunti i seguenti valori:
- Il documento richiede la tua approvazione (AAA)
- Il documento richiede la tua revisione (AAR)
- Il documento non ha più bisogno della tua approvazione (ARA)
- Il documento non necessita più della tua revisione (ARR)
- Il documento richiede l'approvazione (ATA) dell'utente
- Revisione documento necessario (utente) (ATR)
- Il documento non ha più bisogno dell’approvazione (RTA) di (utente)
- Il documento non necessita più della revisione (RTR) di (utente)
- Documento approvato (ADA)
- Documento approvato con modifiche (ADC)
- Il documento richiede lavoro (ADN)
- (Utente) ha contrassegnato (documento) come approvato. La tua approvazione non è più necessaria. AAN)
- (Utente) ha contrassegnato (documento) come approvato con modifiche. La tua approvazione non è più necessaria. (ACN)
- (Utente) ha contrassegnato (documento) come necessario. La tua approvazione non è più necessaria. (AWN)
- Il documento richiede la tua revisione ora anziché l'approvazione (AAC)
- Il documento richiede la tua approvazione ora anziché una revisione (ADN)
- Documento revisionato (RDC)
- Documento revisionato (TRC)
- (Utente) ha rivisto (documento) come completato. La tua recensione non è più necessaria. (TRN)
UserRole (USRROL)
-
ID
Aggiunto.
-
ID
Aggiunto.