Novità dell’API versione 20
Creato per:
- Sviluppatore
Adobe Workfront ha rilasciato la versione API 20 il 4 maggio 2025. La versione 20 dell’API presenta le seguenti modifiche rispetto alla versione 19.
Risorse aggiunte
Non sono state aggiunte risorse per API versione 20.
Risorse rimosse
Nessuna risorsa rimossa per API versione 20
Risorse modificate
Autorizzazioni livello di accesso (ALVPER)
Un oggetto AccessLevelPermissions rappresenta un'autorizzazione specifica per accedere, creare o modificare un oggetto Workfront. Queste autorizzazioni possono quindi essere associate a un Livello di accesso.
Campi diretti |
|
Richiesta di accesso (ACSREQ)
Se un utente non ha accesso a un oggetto in Workfront di cui ha bisogno, può richiedere l’accesso a tale oggetto. L'oggetto AccessRequest rappresenta questa richiesta.
Campi diretti |
|
Regola di accesso (ACSRUL)
Un oggetto AccessRule rappresenta un set di regole nei livelli di accesso personalizzati che determina il modo in cui gli utenti possono condividere i progetti creati.
Campi diretti |
|
AnnouncementAttachment (ANMATT)
Campi diretti |
|
Approvazione (APPROVAZIONE)
Per un determinato elemento di lavoro, ad esempio un'attività, un documento o una scheda orario, può essere necessario che un supervisore o un altro utente approvi l'elemento di lavoro. Un oggetto Approval rappresenta l'azione di approvazione di un elemento di lavoro.
Campi diretti |
|
Campi raccolta |
Sono stati aggiunti i seguenti campi:
|
Assegnazione (ASSEGNA)
Un oggetto Assignment rappresenta la connessione tra un elemento di lavoro e l'utente, il team o il gruppo assegnato a lavorarci.
L'oggetto Assignment ha aggiunto i flag ATTRIBUTE_ATTACHABLE
e DOMAIN_EXTENDABLE
.
Avatar
Un oggetto Avatar è una foto utente.
Campi diretti |
|
Campi core |
|
Operazioni |
|
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.
Campi diretti |
|
AttivitàPrevista (BSTSK)
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. Quando si crea una previsione, le informazioni sulle attività vengono acquisite anche sulle attività previste della previsione.
Campi diretti |
|
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.
Campi diretti |
|
ParametroCategoria (CTGYPA)
Campi diretti |
|
Società (CMPY)
Un oggetto Company rappresenta un'organizzazione costituita da un insieme di persone.
L'oggetto Company ha aggiunto il flag SHARABLE
.
Preferenze cliente (CUSTPR)
Un oggetto CustomerPreferences rappresenta l'insieme di preferenze impostate da un cliente per l'istanza di Workfront.
Campi diretti |
|
Tasso di cambio (EXRATE)
Un oggetto ExchangeRate rappresenta un tasso di cambio impostato in Workfront. Gli oggetti ExchangeRate non sono dinamici.
Campi diretti |
I seguenti campi hanno cambiato il loro tipo da
|
Dati finanziari (FINDAT)
Campi diretti |
|
Gruppo (GROUP)
Un oggetto Group rappresenta un insieme di utenti e team. I gruppi spesso rappresentano la struttura di reparto.
Campi diretti |
|
Ora (HOUR)
Un oggetto Hour rappresenta un'ora registrata da un utente su una scheda orario.
Campi diretti |
|
OpTask (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 OpTask ha aggiunto il flag DOMAIN_EXTENDABLE
-
I campi seguenti hanno aggiunto il flag
RESTRICTABLE
:- actualCost
-
I seguenti campi hanno cambiato il loro tipo da
double
aclass java.math.BigDecimal
:- actualCost
Parametro (PARAM)
Un oggetto Parameter è un campo personalizzato.
-
displayType
Sono stati aggiunti i seguenti valori possibili:
-
INTRNL
(ricerca interna) -
MULTINTRNL
(Ricerca interna a selezione multipla) -
UIEXTNSION
(enum.parameterdisplaytypeenum.uiextension)
-
Portfolio (PORTA)
Un oggetto Portfolio è una raccolta di progetti che competono per le stesse risorse, in genere denaro o persone per completarli.
L'oggetto Portfolio ha aggiunto il flag DOMAIN_EXTENDABLE
.
-
I campi seguenti hanno aggiunto il flag
RESTRICTABLE
:- allineato
- budget
- valuta
- netValue
- onBudget
- onTime
- portfolioNetValue
- portfolioRoi
- roi
Programma (PRGM)
Un oggetto Program è un sottoinsieme di progetti all'interno di un portfolio, in cui è possibile raggruppare progetti simili.
L'oggetto Program ha aggiunto il flag DOMAIN_EXTENDABLE
.
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.
-
I campi seguenti hanno aggiunto il flag
RESTRICTABLE
:- actualBenefit
- actualBillableExpenseCost
- actualCost
- actualExpenseCost
- actualLaborCost
- actualNonBillableExpenseCost
- actualRevenue
- actualRiskCost
- actualValue
- bcwp
- bcws
- fatturato
- budget
- BudgetedCost
- BudgetedHours
- BudgetedLaborCost
- eac
- fixedCost
- fixedRevenue
- plannedBenefit
- plannedBillableExpenseCost
- plannedCost
- plannedExpenseCost
- plannedLaborCost
- plannedNonBillableExpenseCost
- plannedRevenue
- plannedRiskCost
- plannedValue
- remainingCost
- remainingRevenue
- remainingRiskCost
- resourcePlannerBudgetedHours
- resourcePlannerBudgetedLaborCost
- riskPerformanceIndex
-
I seguenti campi hanno cambiato il loro tipo da
double
aclass java.math.BigDecimal
:- actualCost
- actualRevenue
- plannedCost
- plannedRevenue
-
resourcePlannerBudgetedHours
È stato aggiunto il flag
CURRENCY
DefCoda (QUED)
Un oggetto QueueDef rappresenta una coda, ovvero un progetto che è stato pubblicato nell'area Help Desk per consentire agli utenti di inviare problemi.
-
requestorCoreAction
Sono stati aggiunti i seguenti valori possibili:
-
REMOVE_CUSTOMFORM
(Rimuovi dai dati personalizzati) -
ADD_SUB_PROJECTS
(Aggiungi sottoprogetti)
-
-
requestorForbiddenActions
Sono stati aggiunti i seguenti valori possibili:
-
REMOVE_CUSTOMFORM
(Rimuovi dai dati personalizzati) -
ADD_SUB_PROJECTS
(Aggiungi sottoprogetti)
-
Tariffa (RATE)
Un oggetto Rate rappresenta una tariffa di fatturazione in Workfront.
L'oggetto Rate ha aggiunto il flag ATTRIBUTE_ATTACHABLE
.
-
I campi seguenti hanno aggiunto il flag
RESTRICTABLE
:- costPerHour
- localBillingPerHour
- localCostPerHour
- localCurrency
- rateValue
-
I seguenti campi hanno cambiato il loro tipo da
double
aclass java.math.BigDecimal
:- costPerHour
- localBillingPerHour
- localCostPerHour
- rateValue
-
Sono stati aggiunti i seguenti campi:
- valuta
- bloccato
- tipo
- valore
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.
L'oggetto Role ha aggiunto il flag DOMAIN_EXTENDABLE
.
-
I campi seguenti hanno aggiunto il flag
RESTRICTABLE
:- billingPerHour
- costPerHour
-
Sono stati aggiunti i seguenti campi:
- billingRates
- costRates
ScheduledReport (SCHREP)
Un oggetto ScheduledReport rappresenta un report configurato per la consegna.
-
formato
Sono stati aggiunti i seguenti valori possibili:
tiff
(enum.fileextension.tiff)
ScoreCardQuestion (SCOREQ)
Un oggetto ScoreCardQuestion rappresenta una domanda aggiunta a una scorecard. Queste domande sono solitamente determinate dal manager Portfolio e le loro risposte consentono al manager di comprendere quanto un progetto sia in linea con gli obiettivi del portfolio.
-
displayType
Sono stati aggiunti i seguenti valori possibili:
-
INTRNL
(ricerca interna) -
MULTINTRNL
(Ricerca interna a selezione multipla) -
UIEXTNSION
(enum.parameterdisplaytypeenum.uiextension)
-
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 aggiunto il flag DOMAIN_EXTENDABLE
.
-
I campi seguenti hanno aggiunto il flag
RESTRICTABLE
:- actualBillableExpenseCost
- actualCost
- actualExpenseCost
- actualLaborCost
- actualNonBillableExpenseCost
- actualRevenue
- costAmount
- costType
- plannedBillableExpenseCost
- plannedCost/li>
- plannedExpenseCost
- plannedLaborCost
- plannedNonBillableExpenseCost
- plannedRevenue
-
I seguenti campi hanno cambiato il loro tipo da
double
aclass java.math.BigDecimal
:- actualCost
- actualRevenue
- plannedCost
-
costType
Sono stati aggiunti i seguenti valori possibili:
URH
(Ore Utente e Ruolo)
-
revenueType
Sono stati aggiunti i seguenti valori possibili:
URH
(Ore Utente e Ruolo)URC
(Ore Utente e Ruolo w/Cap)URF
(Ore Utente e Ruolo più Fisso)
Modello (TMPL)
Un oggetto Template rappresenta un pattern per un progetto. I progetti possono essere creati da modelli per risparmiare tempo. Un modello contiene un team e attività che verranno copiati in qualsiasi progetto creato dal modello.
-
I campi seguenti hanno aggiunto il flag
RESTRICTABLE
:- budget
- fixedCost
- fixedRevenue
- plannedBenefit
- plannedBillableExpenseCost
- plannedCost
- plannedExpenseCost
- plannedLaborCost
- plannedNonBillableExpenseCost
- plannedRevenue
- plannedRiskCost
- workRequired
-
I seguenti campi hanno cambiato il loro tipo da
double
aclass java.math.BigDecimal
:- plannedCost
- plannedRevenue
Sono stati aggiunti i seguenti campi:
- billingRates
- costRates
TemplateTask (TTSK)
Un oggetto TemplateTask rappresenta un oggetto Task che fa parte di un oggetto Template. Le Attività Modello diventano Attività nel Progetto in cui viene utilizzato il Modello.
-
I campi seguenti hanno aggiunto il flag
RESTRICTABLE
:- billingImporto
- costAmount
- costType
- plannedBillableExpenseCost
- plannedCost/li>
- plannedExpenseCost
- plannedLaborCost
- plannedNonBillableExpenseCost
- plannedRevenue
- revenueType
-
I seguenti campi hanno cambiato il loro tipo da
double
aclass java.math.BigDecimal
:- plannedCost
- plannedRevenue
-
costType
Sono stati aggiunti i seguenti valori possibili:
URH
(Ore Utente e Ruolo)
-
revenueType
Sono stati aggiunti i seguenti valori possibili:
URH
(Ore Utente e Ruolo)URC
(Ore Utente e Ruolo w/Cap)URF
(Ore Utente e Ruolo più Fisso)
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.
-
updateType
Sono stati aggiunti i seguenti valori possibili:
externalFolderMetadataError
(enum.updatetypeenum.externalFolderMetadataError)
Utente (USER)
Un oggetto User rappresenta una persona con un account in Workfront che può accedere e interagire con il sistema.
L'oggetto utente ha aggiunto i campi ATTRIBUTE_ATTACHABLE
e DOMAIN_EXTENDABLE
.
-
I campi seguenti hanno aggiunto il flag
RESTRICTABLE
:- billingPerHour
- costPerHour
Sono stati aggiunti i seguenti campi:
- billingRates
- costRates
Lavoro (WORK)
Un oggetto Work è un'interfaccia comune ereditata sia da Task che da OpTask e condivide il codice comune tra i due.
-
I campi seguenti hanno aggiunto il flag
RESTRICTABLE
:- actualBillableExpenseCost
- actualCost
- actualExpenseCost
- actualLaborCost
- actualNonBillableExpenseCost
- actualRevenue
- costAmount
- costType
- plannedBillableExpenseCost
- plannedCost
- plannedExpenseCost
- plannedLaborCost
- plannedNonBillableExpenseCost
- plannedRevenue
-
I seguenti campi hanno cambiato il loro tipo da
double
aclass java.math.BigDecimal
:- actualCost
- actualRevenue
- plannedCost
- plannedRevenue
-
plannedDuration
Sono stati aggiunti i flag
DYNAMIC
,LAZY_READ
eREAD_ONLY
-
resourcePlannerBudgetedHours
È stato aggiunto il flag
CURRENCY
-
costType
È stato aggiunto il possibile valore
URH
(Ore Utente e Ruolo) -
revenueType
Sono stati aggiunti i possibili valori
URH
(Ore utente e ruolo),URC
(Ore utente e ruolo w/Cap) eURF
(Ore utente e ruolo Plus Fisso)