DocumentazioneWorkfrontGuida di Workfront

Novità della versione 15 dell’API

Last update: Tue Nov 07 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Creato per:

  • Developer

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, consulta Panoramica delle iniziative nella Pianificazione scenario.

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.

  • name

    Nome dell'iniziativa

  • planID

    ID del piano associato all'iniziativa.

  • planName

    Nome del piano associato all'iniziativa.

  • projectID

    ID del progetto associato all’iniziativa.

  • scenarioID

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

  • startDate

    La data di inizio pianificata dell’iniziativa.

Campi di riferimento

  • cliente

  • enteredBy

  • progetto

Campi core

  • ID

  • name

  • objCode

Operazioni

  • COUNT

  • GET

  • RAPPORTO

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

  • entryDate

    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

  • COUNT

  • DELETE

  • GET

  • RAPPORTO

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

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

  • secondaryActions (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

    Aggiunta completata.

    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

    Aggiunta completata.

  • taskDef

    Aggiunta completata.

Campi raccolta

  • objectIntegations

    Aggiunta completata.

    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 (stringa[])

    Aggiunta completata.

    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 (stringa[])

    Aggiunta completata.

    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

  • hideFormulaFromDescription

    Aggiunta completata.

  • journaledObjCodes

    Aggiunta completata.

  • rawCustomExpression

    Aggiunta completata.

Preferenze cliente (CUSTPR)

Un oggetto CustomerPreferences rappresenta l'insieme di preferenze impostate da un cliente per l'istanza di Workfront.

Campi diretti

  • name

    Sono stati aggiunti i seguenti valori:

    • password:sharePointV2IntegrationEnabled (Integrazione 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 flag 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 Carica 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

  • objectIntegations

    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:

  • CALCULATIONDataExtension

    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:

  • copyIssue

    Campo aggiunto parentID

Parametro (PARAM)

Un oggetto Parameter è un campo personalizzato.

Campi diretti

È stato aggiunto il seguente campo:

  • fieldDefinition

Sono stati modificati i seguenti campi:

  • dataType

    È stato aggiunto il valore possibile WIDGET (Widget)

    Questo valore supporta l’utilizzo di immagini nei moduli personalizzati.

  • displayType

    È stato aggiunto il valore possibile 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
  • objectIntegations
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
  • objectIntegations
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

  • objectIntegations

    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, consulta 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 delle scorecard, consulta Creare una scorecard.

Campi diretti

  • displayType

    È stato aggiunto il valore possibile 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

  • objectIntegations

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

    • 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 della Lista dei 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 valore possibile 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
  • userApproval
Azioni

  • getUsersAvailableTime

  • resetRopgPassword

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)

Lavoro (WORK)

Un oggetto Work è un'interfaccia comune ereditata sia da Task che da OpTask e condivide il codice comune tra i due.

Campi raccolta

  • objectIntegations

    In alcuni casi, è possibile collegare elementi di lavoro Workfront direttamente agli oggetti di un prodotto software esterno. L'oggetto ObjectIntegration rappresenta questo collegamento.

recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43