DocumentazioneWorkfrontGuida di Workfront

Novità della versione 12 dell’API

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

Creato per:

  • Developer

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.

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

Azione

  • getObjectHierarchy

RichTextParameterValue richtextparametervalue

I campi RTF sono ora disponibili su più oggetti. L'oggetto RichTextParameterValue è stato aggiunto a Workfront per supportare questa disponibilità.

Per ulteriori informazioni, consulta Campi Rich Text nell’API di Adobe Workfront.

Campi diretti

  • ID

Campi core

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

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 Funzionamento dei livelli di accesso.

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

Campi diretti

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

Campi diretti

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

Campi diretti

ActivityLog activitylog

Un oggetto ActivityLog è un elenco completo di tutte le attività che hanno avuto luogo in un determinato account di Workfront Proof.

Operazioni

La seguente operazione è stata rimossa dall'oggetto ActivityLog:

  • AGGIUNGI

AllegatoAnnuncio announcementattachment

Un oggetto AnnouncementAttachment rappresenta un file allegato a un annuncio di Workfront.

Per ulteriori informazioni sugli allegati dell’annuncio, consulta Inviare annunci

Campi diretti

  • fileExtension

    Sono stati aggiunti i possibili valori:

    • qdoc (enum.fileextension.qdoc)

    • qslide (enum.fileextension.qslide)

    • qsheet (enum.fileextension.qsheet)

Approval approval

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

  • backlogOrder

    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 (medio)

    • 3 (grande)

    Per ulteriori informazioni sull’impegno di lavoro in Workfront, consulta Panoramica sull’impegno di lavoro.

CalendarSection calendarsection

Una sezione Calendario è un report calendario.

Per ulteriori informazioni sui report calendario, vedere Panoramica dei rapporti sul calendario.

Campi diretti

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, consulta Utilizzare campi data personalizzati in un report calendario.

  • customDate

  • customEndDateParameterID

  • customStartDateParameterID

  • ignoreActualDates

Azienda company

Un oggetto Company rappresenta un'organizzazione costituita da un insieme di persone.

Per ulteriori informazioni sulle aziende, consulta Creare e modificare le società.

Campi diretti

  • groupID

    ID del gruppo a cui è associata l’azienda.

Campi di riferimento

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

Un oggetto Customer rappresenta un'organizzazione che utilizza un'istanza di Workfront.

Azioni

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

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

Campi diretti

  • name

    Sono stati aggiunti i possibili valori:

    • password:zoomIntegrationEnabled (Abilita l'integrazione Zoom nel flusso di aggiornamenti)
    • password:quipIntegrationEnabled (config.general.quip.enabled)

Documento document

Un oggetto Document rappresenta un file, ad esempio materiale scritto, immagini o altre forme di informazioni.

Azioni

  • createLinkedProofVersion

    Aggiunta completata

DocumentVersion 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 Carica una nuova versione di un documento.

Campi diretti

  • externalIntegrationType

    Valore possibile rimosso:

    • QUIP (Quip)

  • proofDecision

    Aggiunta completata

Azioni

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 group

Un oggetto Group rappresenta un insieme di utenti e team. I gruppi spesso rappresentano la struttura di reparto.

Campi diretti

  • businessLeaderID

    ID del Business Leader assegnato al gruppo.

Campi di riferimento

  • businessLeader

    Business Leader assegnato al gruppo. Un Business Leader è una persona che prende decisioni commerciali per il gruppo.

    Per ulteriori informazioni sui leader di business, consulta Panoramica di Business Leader.

Azioni

  • assignMultiple

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

Campi diretti

  • externalIntegrationType

    Valore possibile rimosso:

    • QUIP (Quip)

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

Campi diretti

  • backlogOrder

    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:
Azioni

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, consulta Sostituire il pulsante Lavoraci con un pulsante Start.

  • acceptWork

  • unacceptWork

Parametro parameter

Un oggetto Parameter è un campo personalizzato.

La risorsa Parameter ha aggiunto il flag CONDIVISIBILE.

Per ulteriori informazioni sui campi personalizzati, consulta Creare o modificare un modulo personalizzato in Creare o modificare un modulo personalizzato.

Campi diretti
Campi raccolta

  • accessRules

    Aggiunta completata

Campi predefiniti

  • etichetta

    Aggiunta completata

Portfolio 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, consulta Panoramica del Portfolio in Adobe Workfront.

Campi diretti

  • groupID

    ID del gruppo a cui è associato il portfolio.

Campi di riferimento

  • gruppo

    Il gruppo a cui è associato il portfolio.

Programma program

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

Campi diretti

  • groupID

    ID del gruppo a cui è associato il programma.

Campi di riferimento

  • gruppo

    Il gruppo a cui è associato il programma.

DefCoda queuedef

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, consulta Creare una coda di richieste.

Campi diretti

ScheduledReport scheduledreport

Un oggetto ScheduledReport rappresenta un report configurato per la consegna.

Campi diretti

  • formato

    Sono stati aggiunti i possibili valori:

    • qdoc (enum.fileextension.qdoc)

    • qslide (enum.fileextension.qslide)

    • qsheet (enum.fileextension.qsheet)

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

Campi diretti

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 diretti

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

    • 3 (grande)

    Per ulteriori informazioni sull’impegno di lavoro in Workfront, consulta Panoramica sull’impegno di lavoro.

Azioni

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, consulta Sostituire il pulsante Lavoraci con un pulsante Start.

  • acceptWork

  • unacceptWork

Team team

Un oggetto Team è un insieme di Utenti che possono essere assegnati a un elemento di lavoro.

Campi diretti

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

      workOnItTaskStatus

    Per ulteriori informazioni sul pulsante Start, vedere Sostituire il pulsante Lavoraci con un pulsante Start.

Campi di riferimento

Il seguente campo è stato aggiunto alla risorsa Team:

  • gruppo

TemplateTask 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à dei modelli, consulta Modificare un’attività modello.

Campi diretti

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

    • 3 (grande)

    Per ulteriori informazioni sull’impegno di lavoro in Workfront, consulta Panoramica sull’impegno di lavoro.

Scheda orario timesheet

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, consulta Panoramica schede orario

Campi core

Il seguente campo è stato rimosso dalla risorsa Scheda orario:

  • objcode

Aggiorna

Campi diretti

Utente user

Un oggetto User rappresenta una persona con un account in Workfront che può accedere e interagire con il sistema.

Campi diretti

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, vedi 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

Azioni

La seguente azione è stata aggiunta alla risorsa utente:

  • getUserAccessPermissionsByObjCode

    Questa azione utilizza gli argomenti seguenti

    • id (stringa)

    • objCode (stringa)

Lavoro work

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

Campi diretti

  • backlogOrder

    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 (medio)

    • 3 (grande)

    Per ulteriori informazioni sull’impegno di lavoro in Workfront, consulta Panoramica sull’impegno di lavoro.

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