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