Novità della versione 15 dell’API

Ultimo aggiornamento: 17 luglio 2024
  • Argomenti:

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

  • customerID

    Questo è un oggetto interno.

  • durata

    Quantità di tempo tra endDate e startDate.

  • endDate

    La data di completamento pianificata per l’iniziativa.

  • enteredByID

    ID associato all’utente che ha inviato la richiesta.

  • ID

    ID associato all’azione

  • initiativeID

    ID associato all'iniziativa.

  • lastPublishedDate

    Data dell'ultima pubblicazione dell'iniziativa in Workfront Scenario Planner.

  • nome

    Nome dell'iniziativa

  • planID

    ID del piano associato all'iniziativa.

  • nomePiano

    Nome del piano associato all'iniziativa.

  • projectID

    ID del progetto associato all’iniziativa.

  • scenarioID

    ID dello scenario in Workfront Scenario Planner associato all’iniziativa.

  • dataInizio

    La data di inizio pianificata dell’iniziativa.

Campi di riferimento

  • cliente

  • enteredBy

  • progetto

Campi core

  • ID

  • nome

  • objCode

Operazioni

  • CONTEGGIO

  • GET

  • REPORT

  • RICERCA

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

  • ID

  • isInlineAddEnabled

Campi core

  • ID

  • objCode

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

  • customerID

    Questo è un oggetto interno.

  • dataVoce

    La data e l'ora in cui è stata immessa ObjectIntegration nel sistema Workfront.

  • ID

    ID Workfront univoco dell'oggetto ObjectIntegration specifico.

  • integrationType

    Il software esterno con cui l'oggetto ObjectIntegration crea un collegamento. I valori possibili sono:

    • JIRA

    • SALESFORCE

    • ANAPLAN

  • linkedObjectID

  • objID

    Oggetto in Workfront a cui è associata ObjectIntegration.

  • objObjCode

    Il codice oggetto dell'oggetto in Workfront a cui è associata l'ObjectIntegration.

  • param1

  • param2

  • param3

  • URL

Campi di riferimento
  • cliente
Campi core

  • ID

  • objCode

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

  • autoCalcPlannedHours

  • ID

Campi di riferimento
  • defaultApprovalProcess
Campi raccolta
  • objectCategories
Campi core

  • ID

  • objCode

UserApproval (USRAPV)

Campi diretti

  • approverID

  • customerID

  • ID

  • requestedDate

  • requestorID

  • stato

  • userID

Campi di riferimento

  • approvatore

  • cliente

  • richiedente

  • utente

Campi core

  • ID

  • objCode

Campi predefiniti

  • approverID

  • requestorID

  • stato

  • userID

Azioni

  • approva

  • rifiuta

Operazioni

  • AGGIUNGI

  • CONTEGGIO

  • DELETE

  • GET

  • REPORT

  • RICERCA

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.

Campi diretti

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

Campi diretti

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

Campi diretti

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

Campi diretti

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

Campi diretti
  • resourcePlannerBudgetedHours
Campi di riferimento

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

Campi raccolta

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

Campi diretti

  • 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

Campi raccolta

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

Campi diretti

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

Campi diretti

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

Campi diretti

  • 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

Campi diretti

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.

Campi di riferimento

Sono stati aggiunti i seguenti campi:

  • approvatore

  • cliente

  • richiedente

  • utente

Campi raccolta

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.

Campi predefiniti

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

Azioni

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.

Campi diretti

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.

Campi diretti

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

Azioni

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.

Campi diretti

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

Campi raccolta
  • integrazioniOggetto
Azioni

  • linkExternalObject

  • unlinkExternalObject

Programma (PRGM)

Un oggetto Program è un sottoinsieme di progetti all'interno di un portfolio, in cui è possibile raggruppare progetti simili.

Campi raccolta
  • integrazioniOggetto
Azioni

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

Campi diretti
  • resourcePlannerBudgetedHours
Campi di riferimento

  • 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

Campi raccolta

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

Campi diretti

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

Campi diretti

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

Campi raccolta

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

Campi di riferimento

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

Campi core

Il seguente campo è stato rimosso:

  • objCode

Visualizza (UIVIEW)

Campi diretti

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

Campi diretti

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

Campi di riferimento
  • approvazioneUtente
Azioni

  • getUsersAvailableTime

  • reimpostaPasswordRopg

UserNote (USRNOT)

Un oggetto UserNote è una notifica.

Campi diretti

  • eventType

    Sono stati aggiunti i seguenti valori possibili:

    • DUP (richiesta di verifica di un documento)

    • DUV (Consente di visualizzare un documento)