Novità della versione 15 dell’API
Creato per:
- Sviluppatore
Adobe Workfront ha rilasciato la versione API 15 il 14 giugno 2022. La versione 15 dell’API presenta le seguenti modifiche rispetto alla versione 14.
Risorse aggiunte
Iniziativa (INITIV)
L'oggetto Initiative crea stime in Workfront Scenario Planner per il tipo e il numero di mansioni, i costi fissi e il beneficio pianificato.
Per ulteriori informazioni sulle iniziative, vedere Panoramica delle iniziative in Scenario Planner.
| Campi diretti |
|
| Campi di riferimento |
|
| Campi core |
|
| Operazioni |
|
DefProblema (ISSDEF)
L’oggetto IssueDef rappresenta un insieme di dati relativi al formato dei problemi. Questo oggetto può essere allegato a progetti o modelli e influisce sui problemi aggiunti a tale progetto o modello.
| Campi diretti |
|
| Campi core |
|
ObjectIntegration (OBJECT)
In alcuni casi, è possibile collegare elementi di lavoro Workfront direttamente agli oggetti di un prodotto software esterno. L'oggetto ObjectIntegration rappresenta questo collegamento.
| Campi diretti |
|
| Campi di riferimento |
|
| Campi core |
|
DefAttività (TSKDEF)
L'oggetto TaskDef rappresenta un insieme di dati relativi al formato delle attività. Questo oggetto può essere allegato a progetti o modelli e influisce sulle attività aggiunte a tale progetto o modello.
| Campi diretti |
|
| Campi di riferimento |
|
| Campi raccolta |
|
| Campi core |
|
UserApproval (USRAPV)
| Campi diretti |
|
| Campi di riferimento |
|
| Campi core |
|
| Campi predefiniti |
|
| Azioni |
|
| Operazioni |
|
Risorse rimosse
Nessuna risorsa rimossa per API versione 15.
Risorse modificate
Livello di accesso (ACSLVL)
Un oggetto AccessLevel è associato agli utenti e descrive il set di autorizzazioni AccessLevelPermissions che determinano gli elementi a cui l'utente può accedere.
Per ulteriori informazioni sui livelli di accesso, vedere Livelli di accesso.
-
fieldAccessPrivileges (stringa[])
Sono stati aggiunti i seguenti valori possibili:
-
VTMAWMG (Visualizza i team associati ai miei gruppi)
-
VALLTM (Visualizza tutti i team)
-
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.
-
coreAction (stringa[])
Sono stati aggiunti i seguenti valori possibili:
-
EDIT_TEAMS_I_AM_ON (Modifica i team a cui collaboro)
-
EDIT_TEAMS_I_GROUP_ADMIN (Modifica i team nei gruppi che gestisco (solo per amministratori di gruppi))
-
-
forbiddenActions (stringa[])
Sono stati aggiunti i seguenti valori possibili:
-
EDIT_TEAMS_I_AM_ON (Modifica i team a cui collaboro)
-
EDIT_TEAMS_I_GROUP_ADMIN (Modifica i team nei gruppi che gestisco (solo per amministratori di gruppi))
-
-
secondarieActions (stringa[])
Sono stati aggiunti i seguenti valori possibili:
-
EDIT_TEAMS_I_AM_ON (Modifica i team a cui collaboro)
-
EDIT_TEAMS_I_GROUP_ADMIN (Modifica i team nei gruppi che gestisco (solo per amministratori di gruppi))
-
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.
-
azione (stringa)
Sono stati aggiunti i seguenti valori possibili:
-
EDIT_TEAMS_I_AM_ON (Modifica i team a cui collaboro)
-
EDIT_TEAMS_I_GROUP_ADMIN (Modifica i team nei gruppi che gestisco (solo per amministratori di gruppi))
-
-
autoShareAction (stringa)
È stato aggiunto il seguente valore possibile:
- WDL
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.
-
coreAction (stringa[])
Sono stati aggiunti i seguenti valori possibili:
-
EDIT_TEAMS_I_AM_ON (Modifica i team a cui collaboro)
-
EDIT_TEAMS_I_GROUP_ADMIN (Modifica i team nei gruppi che gestisco (solo per amministratori di gruppi))
-
-
forbiddenActions (stringa[])
Sono stati aggiunti i seguenti valori possibili:
-
EDIT_TEAMS_I_AM_ON (Modifica i team a cui collaboro)
-
EDIT_TEAMS_I_GROUP_ADMIN (Modifica i team nei gruppi che gestisco (solo per amministratori di gruppi))
-
-
secondarieActions (stringa[])
Sono stati aggiunti i seguenti valori possibili:
-
EDIT_TEAMS_I_AM_ON (Modifica i team a cui collaboro)
-
EDIT_TEAMS_I_GROUP_ADMIN (Modifica i team nei gruppi che gestisco (solo per amministratori di gruppi))
-
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.
- resourcePlannerBudgetedHours
-
iniziativa
Aggiunto.
L'oggetto Initiative crea stime in Workfront Scenario Planner per il tipo e il numero di mansioni, i costi fissi e il beneficio pianificato.
-
issueDef
Aggiunto.
-
taskDef
Aggiunto.
-
integrazioniOggetto
Aggiunto.
In alcuni casi, è possibile collegare elementi di lavoro Workfront direttamente agli oggetti di un prodotto software esterno. L'oggetto ObjectIntegration rappresenta questo collegamento.
Categoria (CTGY)
Un oggetto Category è un modulo personalizzato.
-
catObjCode (stringa)
È stato aggiunto il seguente valore possibile:
- GRUPPO (Group)
-
objTypes (string[])
Aggiunto.
Questo parametro è un array di possibili oggetti a cui è possibile associare il modulo personalizzato. È stato aggiunto per supportare la possibilità di allegare un modulo personalizzato a più tipi di oggetti.
Valori possibili:
AZIENDA, PORTA, PRGM, PROJ, ATTIVITÀ, OPTASK, UTENTE, DOCU, EXPNS, ITRN, BILL, GRUPPO
-
objTypes (string[])
Aggiunto.
Questo parametro è un array di possibili oggetti a cui è possibile associare il modulo personalizzato. È stato aggiunto per supportare la possibilità di allegare un modulo personalizzato a più tipi di oggetti.
Valori possibili:
AZIENDA, PORTA, PRGM, PROJ, ATTIVITÀ, OPTASK, UTENTE, DOCU, EXPNS, ITRN, BILL, GRUPPO
ParametroCategoria (CTGYPA)
-
nascondiFormulaDaDescrizione
Aggiunto.
-
journaledObjCodes
Aggiunto.
-
rawCustomExpression
Aggiunto.
Preferenze cliente (CUSTPR)
Un oggetto CustomerPreferences rappresenta l'insieme di preferenze impostate da un cliente per l'istanza di Workfront.
-
nome
Sono stati aggiunti i seguenti valori:
-
password:sharePointV2IntegrationEnabled(Integrazione di SharePoint (Graph API) abilitata)Questo valore supporta l’integrazione aggiornata di Sharepoint.
-
project.mgmt:default.project.allowcreatewithouttemplate(Consenti agli utenti di creare progetti senza utilizzare un modello) -
project.mgmt:taskissue.delegate(config.taskissue.delegate)
-
DocumentFolder (DOCFDR)
I documenti possono essere organizzati in cartelle. È possibile creare cartelle personali nell'area Documenti personale. L'oggetto DocumentFolder rappresenta una di queste cartelle.
L'oggetto DocumentFolder ha aggiunto il contrassegno SHARABLE.
DocumentVersion (DOCV)
Un oggetto DocumentVersion rappresenta una versione specifica di un file, ad esempio materiale scritto, immagini o altre forme di informazioni.
Per ulteriori informazioni sulle versioni dei documenti, vedere Caricare una nuova versione di un documento.
-
externalIntegrationType
È stato aggiunto il seguente valore:
-
SHAREPOINT_V2(SharePoint (Graph API)Questo valore supporta l’integrazione aggiornata di Sharepoint.
-
Gruppo (GROUP)
Un oggetto Group rappresenta un insieme di utenti e team. I gruppi spesso rappresentano la struttura di reparto.
Per ulteriori informazioni sui gruppi, consulta Gruppi e team.
L'oggetto Group ha aggiunto il flag DATA_EXTENDIBLE
Sono stati aggiunti i seguenti campi:
-
categoryID
Una categoria è un modulo personalizzato. Questo parametro è stato aggiunto per supportare la possibilità di aggiungere Forms personalizzati agli oggetti del gruppo.
-
isActive
Si tratta di un parametro booleano con valore true se un oggetto è attivo e false in caso contrario. Gli oggetti impostati su Attivo vengono visualizzati nei menu a discesa e nei campi di completamento automatico e possono essere allegati ad altri oggetti.
Sono stati aggiunti i seguenti campi:
-
approvatore
-
cliente
-
richiedente
-
utente
Sono stati aggiunti i seguenti campi:
-
objectCategories
-
integrazioniOggetto
In alcuni casi, è possibile collegare elementi di lavoro Workfront direttamente agli oggetti di un prodotto software esterno. L'oggetto ObjectIntegration rappresenta questo collegamento.
È stato aggiunto il seguente campo:
-
isActive
Si tratta di un parametro booleano con valore true se un oggetto è attivo e false in caso contrario. Gli oggetti impostati su Attivo vengono visualizzati nei menu a discesa e nei campi di completamento automatico e possono essere allegati ad altri oggetti.
Sono stati aggiunti i seguenti campi:
-
calcolaEstensioneDati
Questa azione ricalcola le espressioni nei campi modulo personalizzati.
-
completeGroupInfo
-
linkExternalObject
-
unlinkExternalObject
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
È stato aggiunto il seguente valore:
- DW (download)
LinkedFolder (LNKFDR)
Un oggetto LinkedFolder rappresenta una cartella collegata da un provider di documenti esterno, ad esempio Google Drive o Dropbox.
Per ulteriori informazioni sulle cartelle collegate, vedere Collegare documenti da applicazioni esterne.
-
externalIntegrationType
È stato aggiunto il seguente valore:
-
SHAREPOINT_V2(SharePoint (Graph API)Questo valore supporta l’integrazione aggiornata di Sharepoint.
-
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.
Sono state aggiunte le seguenti azioni:
-
BulkMoveWithOptions
-
getRequestPath
La seguente azione è stata modificata:
-
copiaProblema
Campo aggiunto
parentID
Parametro (PARAM)
Un oggetto Parameter è un campo personalizzato.
È stato aggiunto il seguente campo:
- definizioneCampo
Sono stati modificati i seguenti campi:
-
dataType
È stato aggiunto il possibile valore
WIDGET(Widget)Questo valore supporta l’utilizzo di immagini nei moduli personalizzati.
-
displayType
È stato aggiunto il possibile valore
WIDGET(Widget)Questo valore supporta l’utilizzo di immagini nei moduli personalizzati.
Portfolio (PORTA)
Un oggetto Portfolio è una raccolta di progetti che competono per le stesse risorse, in genere denaro o persone per completarli.
- integrazioniOggetto
-
linkExternalObject
-
unlinkExternalObject
Programma (PRGM)
Un oggetto Program è un sottoinsieme di progetti all'interno di un portfolio, in cui è possibile raggruppare progetti simili.
- integrazioniOggetto
-
linkExternalObject
-
unlinkExternalObject
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.
- resourcePlannerBudgetedHours
-
iniziativa
L'oggetto Initiative crea stime in Workfront Scenario Planner per il tipo e il numero di mansioni, i costi fissi e il beneficio pianificato.
-
issueDef
-
taskDef
-
integrazioniOggetto
In alcuni casi, è possibile collegare elementi di lavoro Workfront direttamente agli oggetti di un prodotto software esterno. L'oggetto ObjectIntegration rappresenta questo collegamento.
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.
Per ulteriori informazioni sulle code di richieste, vedere Creare una coda di richieste.
-
requestorCoreAction
Sono stati aggiunti i seguenti valori possibili:
-
EDIT_TEAMS_I_AM_ON (Modifica i team a cui collaboro)
-
EDIT_TEAMS_I_GROUP_ADMIN (Modifica i team nei gruppi che gestisco (solo per amministratori di gruppi))
-
-
requestorForbiddenActions
Sono stati aggiunti i seguenti valori possibili:
-
EDIT_TEAMS_I_AM_ON (Modifica i team a cui collaboro)
-
EDIT_TEAMS_I_GROUP_ADMIN (Modifica i team nei gruppi che gestisco (solo per amministratori di gruppi))
-
ScoreCardQuestion (SCOREQ)
Un oggetto ScoreCardQuestion rappresenta una domanda aggiunta a una scorecard. Queste domande sono solitamente determinate dal manager del Portfolio e le loro risposte consentono al manager di capire quanto un progetto sia in linea con gli obiettivi del portfolio.
Per ulteriori informazioni sulle domande relative alle scorecard, vedere Creare una scorecard.
-
displayType
È stato aggiunto il possibile valore
WIDGET(Widget)
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).
-
integrazioniOggetto
In alcuni casi, è possibile collegare elementi di lavoro Workfront direttamente agli oggetti di un prodotto software esterno. L'oggetto ObjectIntegration rappresenta questo collegamento.
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.
-
issueDef
-
taskDef
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.
Il seguente campo è stato rimosso:
- objCode
Visualizza (UIVIEW)
-
uiviewType
Sono stati rimossi i seguenti valori possibili:
-
FOUR_COL(Layout a quattro colonne) -
UPDATES(Aggiornamenti) -
UPDATESTOOLBAR_FEED(Aggiornamenti) -
WORKINGON(Lavori in corso) -
CUSTOMDATA(Dati personalizzati) -
CUSTOMDATA_UPDATE(Aggiorna dati personalizzati) -
STATUS_UPDATE(Aggiornamento di stato) -
OPTASK_STATUS_UPDATE(Aggiornamento di stato) -
PROJ_STATUS_UPDATE(Aggiornamento di stato) -
PROJECT_TIMEENTRY(Aggiornamento di stato) -
DLIST(Lista dei Dettagli) -
DLIST_SECTION(Sezione Lista Dettagli)
-
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
È stato aggiunto il possibile valore
documentVersionDownload(enum.updatetypeenum.documentversiondownload)
Utente (USER)
Un oggetto User rappresenta una persona con un account in Workfront che può accedere e interagire con il sistema.
- approvazioneUtente
-
getUsersAvailableTime
-
reimpostaPasswordRopg
UserNote (USRNOT)
Un oggetto UserNote è una notifica.
-
eventType
Sono stati aggiunti i seguenti valori possibili:
-
DUP(richiesta di verifica di un documento) -
DUV(Consente di visualizzare un documento)
-
Lavoro (WORK)
Un oggetto Work è un'interfaccia comune ereditata sia da Task che da OpTask e condivide il codice comune tra i due.
-
integrazioniOggetto
In alcuni casi, è possibile collegare elementi di lavoro Workfront direttamente agli oggetti di un prodotto software esterno. L'oggetto ObjectIntegration rappresenta questo collegamento.