Novità della versione 12 dell’API
Creato per:
- Sviluppatore
Workfront ha rilasciato la versione API 12 il 12 novembre 2020. La versione API 12 presenta le seguenti modifiche rispetto alla versione 11
Risorse aggiunte
Le seguenti risorse sono nuove nella versione 12 dell’API di Workfront.
BreadCrumb
Un oggetto BreadCrumb rappresenta un elemento nella gerarchia padre/figlio di un elemento di lavoro di Adobe Workfront. Le breadcrumb indicano in che modo un elemento di lavoro si inserisce nella struttura più ampia di Portfoli, progetti, progetti e attività.
Per ulteriori informazioni sulle breadcrumb in Workfront, consulta Panoramica delle breadcrumb nella nuova esperienza Adobe Workfront
- getObjectHierarchy
RichTextParameterValue
I campi RTF sono ora disponibili su più oggetti. L'oggetto RichTextParameterValue è stato aggiunto a Workfront per supportare questa disponibilità.
Per ulteriori informazioni, vedere Campi Rich Text nell'API Adobe Workfront.
- ID
- ID
- objCode
Risorse rimosse
Nessuna risorsa rimossa per API versione 12.
Risorse modificate
Le seguenti risorse sono state modificate per Workfront API versione 12.
LivelloAccesso
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 Funzionamento dei livelli di accesso.
AccessLevelPermissions
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
Sono stati aggiunti i seguenti valori possibili:
-
PLANNED_HOURS_CONTOURING
Un utente con un livello di accesso che include questa autorizzazione può aggiornare le ore pianificate nel Bilanciatore dei carichi di lavoro.
Per ulteriori informazioni, consulta Aggiornare le ore pianificate per l'attività durante la gestione delle allocazioni utente in Gestire le allocazioni utente nel Bilanciatore dei carichi di lavoro.
-
ADD_TO_CUSTOM_FORMS
Un utente con un livello di accesso che include questa autorizzazione può aggiungere campi ai moduli personalizzati.
Per ulteriori informazioni, vedere Creare o modificare un modulo personalizzato.
-
EDIT_SYSTEMWIDE
Un utente con un livello di accesso che include questa autorizzazione può condividere un campo personalizzato a livello di sistema con l’accesso Elimina.
-
-
azioni proibite
Sono stati aggiunti i seguenti valori possibili:
-
PLANNED_HOURS_CONTOURING
-
ADD_TO_CUSTOM_FORMS
-
EDIT_SYSTEMWIDE
-
-
azioni secondarie
Sono stati aggiunti i seguenti valori possibili:
-
PLANNED_HOURS_CONTOURING
-
ADD_TO_CUSTOM_FORMS
-
EDIT_SYSTEMWIDE
-
AccessRequest
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
Sono stati aggiunti i seguenti valori possibili:
-
PLANNED_HOURS_CONTOURING
Un utente con un livello di accesso che include questa autorizzazione può aggiornare le ore pianificate nel Bilanciatore dei carichi di lavoro.
Per ulteriori informazioni, consulta Aggiornare le ore pianificate per l'attività durante la gestione delle allocazioni utente in Gestire le allocazioni utente nel Bilanciatore dei carichi di lavoro.
-
ADD_TO_CUSTOM_FORMS
Un utente con un livello di accesso che include questa autorizzazione può aggiungere campi ai moduli personalizzati.
Per ulteriori informazioni, vedere Creare o modificare un modulo personalizzato.
-
EDIT_SYSTEMWIDE
Un utente con un livello di accesso che include questa autorizzazione può condividere un campo personalizzato a livello di sistema con l’accesso Elimina.
-
AccessRule
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
Sono stati aggiunti i seguenti valori possibili:
-
PLANNED_HOURS_CONTOURING
Un utente con un livello di accesso che include questa autorizzazione può aggiornare le ore pianificate nel Bilanciatore dei carichi di lavoro.
Per ulteriori informazioni, consulta Aggiornare le ore pianificate per l'attività durante la gestione delle allocazioni utente in Gestire le allocazioni utente nel Bilanciatore dei carichi di lavoro.
-
ADD_TO_CUSTOM_FORMS
Un utente con un livello di accesso che include questa autorizzazione può aggiungere campi ai moduli personalizzati.
Per ulteriori informazioni, vedere Creare o modificare un modulo personalizzato.
-
EDIT_SYSTEMWIDE
Un utente con un livello di accesso che include questa autorizzazione può condividere un campo personalizzato a livello di sistema con l’accesso Elimina.
-
-
azioni proibite
Sono stati aggiunti i seguenti valori possibili:
-
PLANNED_HOURS_CONTOURING
-
ADD_TO_CUSTOM_FORMS
-
EDIT_SYSTEMWIDE
-
-
azioni secondarie
Sono stati aggiunti i seguenti valori possibili:
-
PLANNED_HOURS_CONTOURING
-
ADD_TO_CUSTOM_FORMS
-
EDIT_SYSTEMWIDE
-
ActivityLog
Un oggetto ActivityLog è un elenco completo di tutte le attività che hanno avuto luogo in un determinato account Workfront Proof.
La seguente operazione è stata rimossa dall'oggetto ActivityLog:
- AGGIUNGI
AllegatoAnnuncio
Un oggetto AnnouncementAttachment rappresenta un file allegato a un annuncio di Workfront.
Per ulteriori informazioni sugli allegati dell'annuncio, vedere Inviare annunci
-
fileExtension
Sono stati aggiunti i possibili valori:
-
qdoc (enum.fileextension.qdoc)
-
qslide (enum.fileextension.qslide)
-
qsheet (enum.fileextension.qsheet)
-
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.
-
ordineBacklog
Sono stati rimossi i seguenti flag:
-
DINAMICO,
-
LAZY_READ
-
NOT_GROUPABLE
-
-
groupID
Sono stati aggiunti i seguenti flag
-
AUTO_LOAD,
-
DINAMICO,
-
SOLA_LETTURA
-
-
workEffort
Questo campo è stato aggiunto e indica se il completamento di un’attività da parte di un utente richiede uno sforzo giornaliero ridotto, medio o elevato. I valori possibili sono:
-
1 (piccolo)
-
2 (Medium)
-
3 (grande)
Per ulteriori informazioni sull'impegno di lavoro in Workfront, vedere Panoramica sull'impegno di lavoro.
-
CalendarSection
Una sezione Calendario è un report calendario.
Per ulteriori informazioni sui report calendario, vedere Panoramica dei report calendario.
I campi seguenti sono stati aggiunti all'oggetto CalendarSection per supportare la nuova funzionalità di utilizzo di date personalizzate nei report calendario.
Per ulteriori informazioni, vedere Utilizzare campi data personalizzati in un report del calendario.
-
customDate
-
customEndDateParameterID
-
customStartDateParameterID
-
ignoreActualDates
Azienda
Un oggetto Company rappresenta un'organizzazione costituita da un insieme di persone.
Per ulteriori informazioni sulle società, vedere Creare e modificare le società.
-
groupID
ID del gruppo a cui è associata l’azienda.
-
gruppo
Il gruppo a cui è associata la società. L’associazione di un’azienda a un gruppo consente all’amministratore del gruppo di estendere l’accesso e le autorizzazioni del gruppo all’azienda.
Cliente
Un oggetto Customer rappresenta un'organizzazione che utilizza un'istanza di Workfront.
-
productEnabled
Questa azione accetta un argomento CustomerProductTypeEnum e restituisce un valore booleano che indica se il cliente dispone di un account per il prodotto.
PreferenzeCliente
Un oggetto CustomerPreferences rappresenta l'insieme di preferenze impostate da un cliente per l'istanza di Workfront.
-
name
Sono stati aggiunti i possibili valori:
- password:zoomIntegrationEnabled (Abilita l'integrazione Zoom nel flusso di aggiornamenti)
- password:quipIntegrationEnabled (config.general.quip.enabled)
Documento
Un oggetto Document rappresenta un file, ad esempio materiale scritto, immagini o altre forme di informazioni.
-
createLinkedProofVersion
Aggiunta completata
DocumentVersion
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
Valore possibile rimosso:
- QUIP (Quip)
-
proofDecision
Aggiunta completata
Le azioni seguenti sono state aggiunte all'oggetto Document.
-
getDocumentReviewerDecision
Questa azione utilizza l'argomento documentVersonID (stringa) e restituisce una mappa che indica la decisione del revisore.
-
setDocumentReviewerDecision
Questa azione utilizza gli argomenti seguenti:
-
documentVersionID (stringa)
-
reviewerDecision (stringa)
-
commento (stringa)
-
Gruppo
Un oggetto Group rappresenta un insieme di utenti e team. I gruppi spesso rappresentano la struttura di reparto.
-
businessLeaderID
ID del Business Leader assegnato al gruppo.
-
businessLeader
Business Leader assegnato al gruppo. Un Business Leader è una persona che prende decisioni commerciali per il gruppo.
Per ulteriori informazioni sui responsabili business, vedere Panoramica sui responsabili business.
-
assegnaMultiplo
Questa azione utilizza gli argomenti seguenti:
-
userIDs (string[])
-
roleIDs (string[])
-
teamID (stringa)
-
-
getGroupMembers
-
updateMembersList
Questa azione utilizza gli argomenti seguenti:
-
newMemberIDs (stringa[])
-
removeMemberDs (stringa[])
-
LinkedFolder
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
Valore possibile rimosso:
- QUIP (Quip)
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.
-
ordineBacklog
L’ordine indica la posizione di un’attività o di un brano nel backlog Agile.
Questo campo ha rimosso i seguenti flag:
- DINAMICO,
- LAZY_READ
- NOT_GROUPABLE:
Queste azioni hanno aggiunto lo stato dell'argomento per supportare la nuova funzionalità del pulsante Start, che modifica lo stato di un elemento di lavoro quando un utente fa clic sul pulsante per indicare che ha iniziato a lavorare sull'elemento.
Per ulteriori informazioni, vedere Sostituire il pulsante Lavoraci con un pulsante Start.
-
acceptWork
-
unacceptWork
Parametro
Un oggetto Parameter è un campo personalizzato.
La risorsa Parameter ha aggiunto il flag CONDIVISIBILE.
Per ulteriori informazioni sui campi personalizzati, vedere Creare o modificare un modulo personalizzato in Creare o modificare un modulo personalizzato.
-
dataType
Valore possibile aggiunto:
-
RICH (Rich Text)
Per ulteriori informazioni, vedere Campi Rich Text nell'API Adobe Workfront.
-
-
displayType
Valore possibile aggiunto:
-
RTF (campo di testo con formattazione)
Per ulteriori informazioni, vedere Campi Rich Text nell'API Adobe Workfront.
-
-
etichetta
Aggiunta completata
-
regole di accesso
Aggiunta completata
-
etichetta
Aggiunta completata
Portfolio
Un oggetto Portfolio è una raccolta di progetti che competono per le stesse risorse, in genere denaro o persone per completarli.
Per ulteriori informazioni sui portfolio, vedere Panoramica sui Portfoli in Adobe Workfront.
-
groupID
ID del gruppo a cui è associato il portfolio.
-
gruppo
Il gruppo a cui è associato il portfolio.
Programma
Un oggetto Program è un sottoinsieme di progetti all'interno di un portfolio, in cui è possibile raggruppare progetti simili.
-
groupID
ID del gruppo a cui è associato il programma.
-
gruppo
Il gruppo a cui è associato il programma.
DefCoda
Un oggetto QueueDef rappresenta una coda, ovvero un progetto che è stato pubblicato nell'area Help Desk per consentire agli utenti di inviare i problemi.
Per ulteriori informazioni sulle code di richieste, vedere Creare una coda di richieste.
-
requestorCoreAction
Sono stati aggiunti i seguenti valori possibili:
-
PLANNED_HOURS_CONTOURING
Un utente con un livello di accesso che include questa autorizzazione può aggiornare le ore pianificate nel Bilanciatore dei carichi di lavoro.
Per ulteriori informazioni, consulta Aggiornare le ore pianificate per l'attività durante la gestione delle allocazioni utente in Gestire le allocazioni utente nel Bilanciatore dei carichi di lavoro.
-
ADD_TO_CUSTOM_FORMS
Un utente con un livello di accesso che include questa autorizzazione può aggiungere campi ai moduli personalizzati.
Per ulteriori informazioni, vedere Creare o modificare un modulo personalizzato.
-
EDIT_SYSTEMWIDE
Un utente con un livello di accesso che include questa autorizzazione può condividere un campo personalizzato a livello di sistema con l’accesso Elimina.
-
PLANNED_HOURS_CONTOURING
-
ADD_TO_CUSTOM_FORMS
-
EDIT_SYSTEMWIDE
-
-
ScheduledReport
Un oggetto ScheduledReport rappresenta un report configurato per la consegna.
-
formato
Sono stati aggiunti i possibili valori:
-
qdoc (enum.fileextension.qdoc)
-
qslide (enum.fileextension.qslide)
-
qsheet (enum.fileextension.qsheet)
-
ScoreCardQuestion
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 RICH (Campo di testo con formattazione)
Per ulteriori informazioni, vedere Campi Rich Text nell'API Adobe Workfront.
Attività
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).
-
workEffort
Questo campo è stato aggiunto e indica se il completamento di un’attività da parte di un utente richiede uno sforzo giornaliero ridotto, medio o elevato. I valori possibili sono:
-
1 (piccolo)
-
2 (Medium)
-
3 (grande)
Per ulteriori informazioni sull'impegno di lavoro in Workfront, vedere Panoramica sull'impegno di lavoro.
-
Queste azioni hanno aggiunto lo stato dell'argomento per supportare la nuova funzionalità del pulsante Start, che modifica lo stato di un elemento di lavoro quando un utente fa clic sul pulsante per indicare che ha iniziato a lavorare sull'elemento.
Per ulteriori informazioni, vedere Sostituire il pulsante Lavoraci con un pulsante Start.
-
acceptWork
-
unacceptWork
Team
Un oggetto Team è un insieme di Utenti che possono essere assegnati a un elemento di lavoro.
I campi seguenti sono stati aggiunti alla risorsa Team:
-
groupID
Questo campo associa un team a un gruppo. Questo identifica il team come parte del gruppo e consente all’amministratore di gruppo di gestire i team.
-
workOnItStatusChange
Si tratta di un parametro booleano che indica se il pulsante Work on It del team è stato configurato come pulsante Start. Quando un membro del team fa clic su un pulsante Start per iniziare a lavorare su un elemento di lavoro, lo stato dell'elemento cambia da Nuovo a uno stato configurato nelle impostazioni del team.
-
I campi seguenti consentono di specificare stati personalizzati per il pulsante Start sui singoli elementi di lavoro.
-
workOnItOpTaskBugReportStatuses
-
workOnItOpTaskChangeOrderStatuses
-
workOnItOpTaskIssueStatuses
-
workOnItOpTaskRequestStatuses
workOnItTaskStatuses
Per ulteriori informazioni sul pulsante Start, vedere Sostituire il pulsante Lavoraci con un pulsante Start.
-
Il seguente campo è stato aggiunto alla risorsa Team:
- gruppo
TemplateTask
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.
Per ulteriori informazioni sulle attività modello, vedere Modificare un'attività modello.
-
workEffort
Questo campo è stato aggiunto e indica se il completamento di un’attività da parte di un utente richiede uno sforzo giornaliero ridotto, medio o elevato. I valori possibili sono:
-
1 (piccolo)
-
2 (Medium)
-
3 (grande)
Per ulteriori informazioni sull'impegno di lavoro in Workfront, vedere Panoramica sull'impegno di lavoro.
-
Scheda orario
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.
Per ulteriori informazioni sulle schede orario, vedi Panoramica schede orario
Il seguente campo è stato rimosso dalla risorsa Scheda orario:
- objcode
Aggiorna
-
updateType
Sono stati aggiunti i seguenti valori possibili:
-
initiativeAdd (enum.updatetypeenum.initiativeadd)
-
initiativeEdit (enum.updatetypeenum.initiativeedit)
Per ulteriori informazioni sulle iniziative, consulta Panoramica delle iniziative in Pianificazione scenario.
-
Utente
Un oggetto User rappresenta una persona con un account in Workfront che può accedere e interagire con il sistema.
I campi seguenti sono stati aggiunti alla risorsa utente:
-
actualDeactivationDate
Rappresenta la data e l'ora in cui un utente è stato disattivato.
Per ulteriori informazioni sugli utenti disattivati, vedere Disattivare o riattivare un utente.
-
alignAccessType
Questo campo mostra l’accesso dell’utente agli Obiettivi di Workfront. I valori possibili sono:
-
Nessun accesso
-
Viste
-
Modif
-
La seguente azione è stata aggiunta alla risorsa utente:
-
getUserAccessPermissionsByObjCode
Questa azione utilizza gli argomenti seguenti
-
id (stringa)
-
objCode (stringa)
-
Lavoro
Un oggetto Work è un'interfaccia comune ereditata sia da Task che da OpTask e condivide il codice comune tra i due.
-
ordineBacklog
L’ordine indica la posizione di un’attività o di un brano nel backlog Agile.
Questo campo ha rimosso i seguenti flag:
-
DINAMICO,
-
LAZY_READ
-
NOT_GROUPABLE
-
-
groupID
Questo campo ha aggiunto i seguenti flag:
-
AUTO_LOAD,
-
DINAMICO,
-
SOLA_LETTURA
-
-
workEffort
Questo campo è stato aggiunto e indica se il completamento di un’attività da parte di un utente richiede uno sforzo giornaliero ridotto, medio o elevato. I valori possibili sono:
-
1 (piccolo)
-
2 (Medium)
-
3 (grande)
Per ulteriori informazioni sull'impegno di lavoro in Workfront, vedere Panoramica sull'impegno di lavoro.
-