DocumentazioneWorkfrontGuida di Workfront

Raccolte di riferimento in un rapporto

Last update: Sun Mar 15 2026 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Argomenti:

Creato per:

  • Utente

La creazione di un report in Adobe Workfront consente di visualizzare un set di oggetti, i rispettivi campi o gli oggetti collegati in un elenco, una griglia o un formato grafico.

Per ulteriori informazioni sulla creazione di un report in Workfront, vedere Creare un report personalizzato.

Requisiti di accesso

Espandi per visualizzare i requisiti di accesso per la funzionalità descritta in questo articolo.
table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Pacchetto Adobe Workfront Qualsiasi
Licenza di Adobe Workfront

Standard

Piano
Configurazioni del livello di accesso

Modifica accesso a Filtri, Viste, Raggruppamenti

Modificare l’accesso a Rapporti, Dashboard, Calendari
Autorizzazioni sugli oggetti

Gestire le autorizzazioni per un rapporto

Gestire le autorizzazioni per una visualizzazione, un filtro o un raggruppamento

Per ulteriori dettagli sulle informazioni contenute in questa tabella, consulta Requisiti di accesso nella documentazione Workfront.

Comprendere le raccolte

Un insieme è un elenco di oggetti collegati a un altro oggetto.

In Workfront sono disponibili le due relazioni seguenti tra gli oggetti:

  • Relazione uno-a-uno: un oggetto può essere collegato solo a un altro oggetto alla volta.
    Ad esempio, un progetto può essere collegato a un solo portfolio alla volta.

  • Relazione uno-a-molti: un oggetto può essere collegato a più oggetti contemporaneamente.
    Ad esempio, un progetto può avere più attività. In questo caso, l'elenco delle attività costituisce un insieme per il progetto.

IMPORTANT
È possibile creare un report che mostra la relazione uno-a-uno tra gli oggetti utilizzando il generatore di report standard. Tuttavia, puoi creare un rapporto che mostra la relazione uno-a-molti tra gli oggetti utilizzando l’interfaccia in modalità testo nel generatore di rapporti.

Per ulteriori informazioni sulla creazione di un report nel generatore di report standard, vedere Creare un report personalizzato.

Per ulteriori informazioni sulla creazione di un rapporto tramite l’interfaccia in modalità testo, consulta:

Trovare gli oggetti raccolta e i relativi campi in API Explorer find-collection-objects-and-their-fields-in-the-api-explorer

Non tutte le raccolte possono essere segnalate su.

Per capire quali oggetti possono essere associati a un insieme di altri, è necessario utilizzare API Explorer.
Per ulteriori informazioni sulla tabella API Explorer, vedere API Explorer.

Per scoprire su quali raccolte è possibile generare un rapporto:

  1. Passa a Esplora API.

  2. Trova l’oggetto del rapporto.

  3. Seleziona la scheda raccolte.

    note note
    NOTE
    Solo gli oggetti elencati in questa scheda possono essere rappresentati come un insieme in un report per l'oggetto selezionato.

  4. Espandere l'oggetto della raccolta facendo clic su di esso.

  5. Fare clic sul collegamento visualizzato per passare all'oggetto della raccolta.
    Verrà aperta la scheda fields per l'oggetto della raccolta.

    note note
    NOTE
    Nel report di raccolta o nei campi associati agli oggetti elencati in questa scheda è possibile fare riferimento solo ai campi elencati in questa scheda.

Fare riferimento alle raccolte nei rapporti

È possibile fare riferimento a oggetti di una raccolta nei seguenti elementi di reporting:

  • Viste
  • Filtri
  • Prompt

Non è possibile fare riferimento a oggetti di un insieme nei seguenti elementi di reporting:

  • Raggruppamenti
  • Diagramma

Ad esempio, puoi fare riferimento alle raccolte di attività o problemi da un rapporto di progetto, per mostrare le informazioni su attività o problemi a livello di progetto.

Fare riferimento a una raccolta nella visualizzazione di un rapporto reference-a-collection-in-the-view-of-a-report

È possibile fare riferimento a un insieme di oggetti nella visualizzazione di un report per visualizzare gli attributi degli oggetti associati all'oggetto del report.

È possibile, ad esempio, visualizzare le informazioni sulle attività o sull'emissione in un report di progetto creando una colonna di raccolta per le attività o l'emissione nella visualizzazione del report.

È possibile visualizzare informazioni sulle attività o sui problemi, ad esempio nomi, date, assegnatari principali, percentuale di completamento e così via nella visualizzazione della raccolta.

Nella visualizzazione vengono visualizzate le informazioni su un'attività o un problema in un formato elenco e ogni riga dell'elenco rappresenta le informazioni su un'attività o un problema. L'elenco delle attività o dei problemi e i relativi campi vengono visualizzati nella stessa riga del progetto a cui appartengono le attività o i problemi.

issue_and_tasks_collections_in_reports.png {width="400"}

Aggiungere una colonna della raccolta in una visualizzazione Report add-a-collection-column-in-a-report-view

Per aggiungere una colonna della raccolta in una visualizzazione Report:

  1. Fai clic sull'icona Menu principale del menu principale , quindi fai clic su Report.

  2. Fare clic su Nuovo report.

  3. Seleziona l’oggetto del rapporto.

  4. Esci dal report e, utilizzando API Explorer, determina quali raccolte sono disponibili per l'oggetto selezionato per il report.

    Per ulteriori informazioni sulla selezione dell'oggetto della raccolta, vedere la sezione Trova gli oggetti della raccolta e i relativi campi in API Explorer in questo articolo.

    Prendere nota del nome dell'oggetto per l'insieme.

  5. Utilizzando API Explorer, vai all'elenco dei campi per l'oggetto che desideri visualizzare nell'insieme.

    Per ulteriori informazioni sulla ricerca dei campi dell'oggetto della raccolta, vedere la sezione Trova gli oggetti della raccolta e i relativi campi in API Explorer in questo articolo.

    Prendere nota del nome del campo da visualizzare nella raccolta.

  6. Torna al report e nella scheda Colonne (Visualizzazione) fai clic su Aggiungi colonna.

  7. Fare clic su Passa alla modalità testo.

  8. Fare clic su Modifica modalità testo.

  9. Selezionare tutto il testo nella finestra di dialogo Modalità testo e rimuoverlo, quindi incollare il codice seguente se si fa riferimento a un campo dell'oggetto raccolta:

    code language-none 
    valueformat=HTML
textmode=true
type=iterate
listdelimiter=<p>
displayname=Column Name
listmethod=nested(collection object name).lists
valuefield=collection object field

  10. Sostituisci Nome colonna con il nome della colonna nella riga displayname.

  11. Sostituisci nome oggetto raccolta con il nome dell'oggetto raccolta nella riga listmethod, come visualizzato in Esplora API.

  12. Sostituisci il campo dell'oggetto raccolta con il nome del campo dell'oggetto raccolta nella riga valuefield, come visualizzato in Esplora API.

    È possibile sostituire valorefield con valoreexpression, se si desidera creare un'espressione personalizzata nella visualizzazione.

    Per ulteriori informazioni sulle espressioni personalizzate calcolate, vedere Panoramica sulle espressioni di dati calcolati.

    Ad esempio, se si desidera visualizzare un elenco delle attività in un report di progetto. Questa raccolta utilizza una riga valuefield per fare riferimento ai nomi delle attività.

    Esegui una delle operazioni seguenti:

    • Utilizza il seguente codice per generare la colonna:

      code language-none 
      valueformat=HTML
textmode=true
type=iterate
listdelimiter=<p>
displayname=Project Tasks Names
listmethod=nested(tasks).lists
valuefield=name

    • Utilizza il codice seguente per visualizzare un elenco dei problemi nel rapporto:

      code language-none 
      displayname=Project Issues Names
listdelimiter=<p>
listmethod=nested(issues).lists
textmode=true
type=iterate
valuefield=name
valueformat=HTML

      In una raccolta è necessario utilizzare issues per la riga listmethod, invece di opTasks che è il nome del database per Issues. Per informazioni su quando utilizzare problema e quando utilizzare opTask quando si fa riferimento a problemi, vedi Utilizzare "opTask" e "problema" quando si fa riferimento a problemi.

    • Se si desidera visualizzare un elenco delle attività in un report di progetto insieme all'assegnatario principale, utilizzare una riga valueexpression per fare riferimento ai nomi delle attività adiacenti ai nomi degli assegnatari principali anziché valuefield.

      Utilizza il seguente codice per generare la colonna:

      code language-none 
      valueformat=HTML
textmode=true
type=iterate
listdelimiter=<p>
displayname=Tasks Names - Primary Assignee
listmethod=nested(tasks).lists
valueexpression=CONCAT({name},' - ',{assignedTo}.{name})

  13. Nel rapporto del progetto viene visualizzata la colonna seguente, in cui sono elencate tutte le attività di ciascun progetto insieme ai relativi assegnatari principali:

    Report di progetto con raccolta attività e assegnatari {width="400"}

  14. Fai clic su Salva.

  15. (Facoltativo) Continuate a modificare il report.

    Oppure

    Fai clic su Salva + Chiudi per salvare il report.

Comprendere le linee di una raccolta Visualizzare in modalità Testo

Le righe di una visualizzazione in modalità testo per una raccolta sono evidenziate nella tabella seguente:

Riga di esempio
Descrizione
valueformat=HTML
È possibile utilizzare vari valori per questa riga, ma si consiglia che valueformat per un elenco di raccolte sia HTML.
textmode=true
Questa riga indica che la colonna è stata configurata utilizzando la modalità testo. Se rimuovi questa riga, Workfront la aggiunge nuovamente per impostazione predefinita.
type=iterate
Il type di un elenco è sempre iterate, durante la creazione di una visualizzazione.
listdelimiter=<p>

Delimitatore utilizzato per separare i valori nell'elenco.
È consigliabile utilizzare <p>, che aggiunge un'interruzione di riga tra i valori.

Puoi inoltre utilizzare quanto segue:

‍ (unificatore a larghezza zero). I valori della raccolta non sono separati.
, =separatore virgola. I valori della raccolta sono separati da una virgola seguita da uno spazio.
/ = separatore barra. I valori della raccolta sono separati da una barra.
- = separatore di trattini. I valori dell'insieme sono separati da un trattino.
Se si lascia vuota questa riga, per impostazione predefinita viene aggiunta una virgola seguita da uno spazio tra i valori della raccolta.

displayname=Nome colonna
Sostituisci Nome colonna con il nome effettivo della nuova colonna.
listmethod=nested(collection object name).list

Questa riga definisce la raccolta a cui si fa riferimento.

Sostituire nome oggetto raccolta con il nome dell'oggetto a cui si fa riferimento nella raccolta, come visualizzato in API Explorer. Questo valore è in genere la forma plurale del nome dell'oggetto insieme.

valuefield=collection object field

Questa riga definisce il campo a cui si fa riferimento dall'oggetto insieme.

Sostituire il campo dell'oggetto della raccolta con il nome del campo dell'oggetto a cui si fa riferimento nella raccolta, come visualizzato in Esplora API.

Puoi sostituire questa riga con:

valueexpression=campi/campi oggetto raccolta calcolati

Utilizzando valueexpression, puoi  visualizza un’espressione personalizzata calcolata nella colonna.

Per ulteriori informazioni su come formattare righe di espressione di valore, vedere Panoramica sulla sintassi della modalità testo.

Limitazioni della visualizzazione di una raccolta limitations-of-a-collection-view

Quando si crea una vista di raccolta, tenere presente le limitazioni riportate di seguito.

  • Non è possibile controllare l'ordine di visualizzazione dei dati di raccolta.
  • Non è possibile applicare la formattazione condizionale a una visualizzazione raccolta.
  • Non è possibile impostare un oggetto di un insieme come collegamento selezionabile.
  • Non è possibile creare una visualizzazione raccolta di un'altra raccolta.
    Ad esempio, non è possibile visualizzare tutti gli assegnatari di ogni attività in un report di progetto. È possibile visualizzare solo l'assegnatario principale per ogni attività in una visualizzazione di progetto.

Fare riferimento a una raccolta nel filtro di un report reference-a-collection-in-the-filter-of-a-report

È possibile fare riferimento a un insieme di oggetti nel filtro di un report per filtrare gli attributi degli oggetti associati all'oggetto del report.

Ad esempio, è possibile filtrare le informazioni su attività o problemi in un report di progetto utilizzando un riferimento agli attributi delle attività o dei problemi sul progetto nell'istruzione di filtro.

NOTE
Quando viene applicato a campi che contengono più valori (ad esempio, una raccolta di note all’interno di un progetto), il filtro determina l’inclusione come segue:
  • Se tutti gli elementi di una raccolta contengono il valore specificato, l'intero record viene escluso dai risultati.
  • Se almeno un elemento della raccolta non contiene il valore specificato, il record rimane nei risultati.

Per aggiungere un riferimento a una raccolta in un filtro di report:

  1. Fai clic sull'icona del menu Principale Menu principale , quindi fai clic su Rapporti.

  2. Fare clic su Nuovo report.

  3. Selezionare l'oggetto del report.

  4. Allontanati dal report e utilizzando API Explorer, determinate le raccolte disponibili per l'oggetto selezionato per il report.

    Per ulteriori informazioni sulla selezione dell'oggetto della raccolta, vedere la sezione Trova oggetti della raccolta e i relativi campi in Esplora API in questo articolo.

    Prendere nota del nome dell'oggetto dell'insieme.

  5. Utilizzando API Explorer, vai all'elenco dei campi per l'oggetto che desideri visualizzare nell'insieme.

    Per ulteriori informazioni sulla ricerca dei campi dell'oggetto della raccolta, vedere la sezione Trova gli oggetti della raccolta e i relativi campi in API Explorer in questo articolo.

    Prendere nota del campo che si desidera visualizzare nella raccolta.

  6. Tornare al report e nella scheda Filtri fare clic su Passa alla modalità testo e quindi su Modifica modalità testo.

  7. Nell'area Imposta regole filtro per il report, incolla il seguente codice:

    code language-none 
    collection object name:collection object field=collection object value
collection object name:collection object field_Mod=value of the modifier

  8. Sostituisci nome oggetto raccolta con il nome dell'oggetto raccolta come visualizzato in API Explorer. Questo valore è in genere la forma plurale del nome dell'oggetto raccolta.

  9. Sostituisci il campo oggetto raccolta con il nome del campo dell'oggetto raccolta in, come visualizzato in API Explorer.

  10. Sostituire il valore dell'oggetto raccolta con il valore dell'oggetto raccolta visualizzato in Workfront.

  11. Sostituisci il valore del modificatore con un modificatore valido.

    Per un elenco dei modificatori, vedere Filtro e modificatori di condizione.
    Ad esempio, per creare un report di progetti che visualizzi solo i progetti il cui nome contiene "Marketing", utilizza il seguente codice:

    code language-none 
    tasks:name=Marketing
tasks:name_Mod=cicontains

    Questo report visualizza solo i progetti che hanno almeno un'attività il cui nome contiene la parola "marketing".

    Attività solo marketing nel progetto {width="400"}

  12. Per filtrare per il nome di un problema, utilizzate il codice seguente:

    code language-none 
    issues:name=Marketing
issues:name_Mod=cicontains
    note tip
    TIP
    Si noti che è necessario utilizzare issues per il nome dell'oggetto della raccolta, anziché optask, ovvero il modo in cui vengono visualizzati i problemi in Esplora API.

  13. Fai clic su Fine.

  14. (Facoltativo) Continua a modificare il rapporto.

    Oppure

    Fare clic su Salva + Chiudi per salvare il report.

Fare riferimento a una raccolta nel prompt personalizzato di un report reference-a-collection-in-the-custom-prompt-of-a-report

È possibile fare riferimento a un insieme di oggetti nel prompt personalizzato di un report per filtrare i risultati del report per gli attributi degli oggetti associati all'oggetto del report.

È ad esempio possibile richiedere informazioni sulle attività in un report del progetto utilizzando un riferimento agli attributi delle attività nel prompt personalizzato del report.

NOTE
Non è possibile fare riferimento a raccolte in un prompt standard.

Un prompt personalizzato è un filtro personalizzato in cui le istruzioni sono unite da simboli di e commerciale. È consigliabile creare l'istruzione in un filtro, quindi unire le righe delle istruzioni con il simbolo e commerciale.

Per ulteriori informazioni sulla creazione di un'istruzione di filtro con un riferimento a una raccolta, vedere la sezione Fare riferimento a una raccolta nel filtro di un report in questo articolo.

Per aggiungere un riferimento a una raccolta nel prompt personalizzato di un report:

  1. Fai clic sull'icona del menu Principale Menu principale , quindi fai clic su Rapporti.

  2. Fare clic su Nuovo report.

  3. Seleziona l’oggetto del rapporto.

  4. Creare un filtro con un riferimento a una raccolta come descritto nella sezione Fare riferimento a una raccolta nel filtro di un report in questo articolo.

  5. Fare clic su Impostazioni report.

  6. Fai clic su Prompt dei rapporti.

  7. Fai clic su Aggiungi prompt.

  8. Fai clic su Messaggio personalizzato.

  9. Specificare il nome del prompt nel campo ​​nome.

  10. Specificare un'etichetta per elemento a discesa.

  11. Specifica quanto segue nel campo Condizione:

    code language-none 
    collection object name:collection object field_Mod=value of the modifier

  12. (Facoltativo) Specifica se questa scelta viene visualizzata per impostazione predefinita nel prompt.

  13. Sostituisci nome oggetto raccolta con il nome dell'oggetto raccolta come visualizzato in API Explorer. Questo valore è in genere la forma plurale del nome dell'oggetto insieme.

  14. Sostituisci il campo dell'oggetto raccolta con il nome del campo dell'oggetto raccolta, come visualizzato in Esplora API.

  15. Sostituire il valore dell'oggetto raccolta con il valore dell'oggetto raccolta visualizzato in Workfront.

    Ad esempio, se si filtrano progetti in cui il nome dell'attività contiene "Marketing", sostituire il valore dell'oggetto raccolta con marketing.

  16. Sostituire il valore del modificatore con un modificatore valido.

    Per un elenco dei modificatori, vedere Filtro e modificatori di condizione.

    Esempio: Ad esempio, per creare un report di progetti con un prompt personalizzato in cui si desidera visualizzare solo i progetti a cui è stata assegnata almeno un'attività, utilizzare il codice seguente:

    code language-none 
    tasks:assignedToID=57cf1b7a000077c9f02f66cb09c8f86c&tasks:assignedToID_Mod=in

    Viene generato un report in cui a tutti i progetti elencati è assegnata almeno un'attività all'utente il cui GUID è 57cf1b7a000077c9f02f66cb09c8f86c.

    note note
    NOTE
    Impossibile fare riferimento al nome dell'assegnatario primario (campo "Assigned To") di un'attività, in base a API Explorer. Puoi fare riferimento solo all’ID dell’assegnatario principale.

    Ad esempio, per filtrare i progetti in cui uno dei problemi del progetto è assegnato a un utente specifico, utilizza il seguente codice per il prompt personalizzato:

    code language-none 
    issues:assignedToID=57cf1b7a000077c9f02f66cb09c8f86c&issues:assignedToID_Mod=in

    Questo genera un rapporto in cui tutti i progetti elencati presentano almeno un problema assegnato all’utente il cui GUID è 57cf1b7a000077c9f02f66cb09c8f86c.

    note note
    NOTE
    È necessario utilizzare issues per il nome dell'oggetto raccolta. Al momento, API Explorer non offre un nome di oggetto raccolta per i problemi.

  17. Fai clic su Fine.

  18. (Facoltativo) Continua a modificare il rapporto.

    Oppure

    Fare clic su Salva + Chiudi per salvare il report.

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