Fare riferimento alle raccolte in un rapporto

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 rapporto in Workfront, consulta Creare un rapporto personalizzato.

Requisiti di accesso

Espandi per visualizzare i requisiti di accesso per la funzionalità in questo articolo.

Per eseguire i passaggi descritti in questo articolo, è necessario disporre dei seguenti diritti di accesso:

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Piano Adobe Workfront* Qualsiasi
Licenza Adobe Workfront* Piano
Configurazioni del livello di accesso*

Modifica accesso a Filtri, Viste, Raggruppamenti

Modificare l’accesso a Rapporti, Dashboard, Calendari

Nota: se non disponi ancora dell’accesso, chiedi all’amministratore di Workfront se ha impostato restrizioni aggiuntive nel tuo livello di accesso. Per informazioni su come un amministratore di Workfront può modificare il tuo livello di accesso, consulta Creare o modificare livelli di accesso personalizzati.

Autorizzazioni oggetto

Gestire le autorizzazioni per un rapporto

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

Per informazioni sulla richiesta di accesso aggiuntivo, consulta Richiedi accesso agli oggetti.

Per conoscere il piano, il tipo di licenza o l'accesso di cui si dispone, contattare l'amministratore 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:

  • Una relazione uno-a-uno: è possibile collegare un oggetto a un solo altro oggetto alla volta.
    Ad esempio, un progetto può essere collegato a un solo portfolio alla volta.

  • Una relazione uno-a-molti: un oggetto può essere collegato a diversi altri oggetti alla volta.
    Ad esempio, un progetto può avere più attività. In questo caso, l'elenco delle attività costituisce una raccolta 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 rapporto nel generatore di rapporti standard, consulta Creare un rapporto 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, vedi API Explorer.

Per scoprire su quali raccolte è possibile generare un rapporto:

  1. Vai a API Explorer.

  2. Trova l’oggetto del rapporto.

  3. Seleziona la raccolte scheda.

    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à aperto il campi per l'oggetto dell'insieme.

    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.

Ad esempio, è possibile visualizzare le informazioni sulle attività o sui problemi in un report di progetto creando una colonna di raccolta per le attività o i problemi 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 le informazioni sulle attività o sui problemi vengono visualizzate in formato elenco, con ogni riga dell'elenco che rappresenta le informazioni su un'attività o un problema. L'elenco delle attività o dei problemi e i relativi campi vengono visualizzati sulla stessa riga del progetto a cui appartengono le attività o i problemi.
issue_and_tasks_collections_in_reports.png

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

Per aggiungere una colonna di raccolta in una visualizzazione report:

  1. Fai clic su Principale menu , quindi fai clic su Rapporti.

  2. Clic Nuovo rapporto.

  3. Seleziona l’oggetto del rapporto.

  4. Allontanarsi dal report e utilizzare API Explorer, determina le raccolte disponibili per l'oggetto selezionato per il report.

    Per ulteriori informazioni sulla selezione dell'oggetto dell'insieme, vedere la sezione Trovare gli oggetti raccolta e i relativi campi in API Explorer in questo articolo.
    Prendere nota del nome dell'oggetto per l'insieme.

  5. Utilizzo di API Explorer, passare all'elenco dei campi per l'oggetto che si desidera visualizzare nell'insieme.

    Per ulteriori informazioni sulla ricerca dei campi dell'oggetto dell'insieme, vedere la sezione Trovare gli oggetti 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 sezione Colonne (visualizzazione) , fare clic su Aggiungi colonna.

  7. Clic Passa alla modalità testo.

  8. Passare il puntatore del mouse sulla finestra di dialogo e fare clic su Fare clic per modificare il testo.

  9. Seleziona tutto il testo nel Modalità testo e rimuoverla, quindi incollare il codice seguente se si fa riferimento a un campo dell'oggetto insieme:

    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 nel displayname linea.

  11. Sostituisci nome oggetto raccolta con il nome dell'oggetto raccolta in listmethod linea, come appare nella API Explorer.

  12. Sostituisci campo oggetto raccolta con il nome del campo dell'oggetto insieme nel valuefield linea, come appare nella API Explorer.

    È possibile sostituire valuefield con valueexpression, se desideri creare un’espressione personalizzata nella visualizzazione.

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

    Ad esempio, se si desidera visualizzare un elenco delle attività in un report di progetto. Questa raccolta utilizza un valuefield riga 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 devi utilizzare problemi per listmethod riga, invece di Operazioni che è il nome del database per Issues. Per informazioni su quando utilizzare problema e quando utilizzare opTask quando si fa riferimento ai problemi, consulta Utilizza "opTask" e "issue" quando si fa riferimento a problemi.

    • Se si desidera visualizzare un elenco delle attività in un report di progetto insieme al relativo assegnatario principale, è possibile utilizzare un valueexpression riga per fare riferimento ai nomi delle attività adiacenti ai nomi dei relativi 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:

  14. Fai clic su Salva.

  15. (Facoltativo) Continua a modificare il rapporto.

    Oppure

    Clic Salva e chiudi per salvare il rapporto.

Comprendere le righe di una visualizzazione raccolta in modalità testo

Nella tabella seguente vengono descritte le righe di una raccolta in modalità testo:

Riga di esempio
Descrizione
valueformat=HTML
È possibile utilizzare vari valori per questa riga, ma si consiglia di valueformat per un elenco di raccolta deve essere 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 trattino. I valori della raccolta sono separati da un trattino.
Se questa riga viene lasciata vuota, 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.

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

valuefield=collection object field

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

Sostituisci  campo oggetto raccolta  con il nome del campo dell'oggetto a cui si fa riferimento nell'insieme, come visualizzato nel API Explorer.

Puoi sostituire questa riga con:

valueexpression=campi oggetto raccolta calcolati

Utilizzo di valueexpression, è possibile visualizzare un’espressione personalizzata calcolata nella colonna.

Per ulteriori informazioni su come formattare valueexpression righe, vedi Panoramica sulla sintassi della modalità testo.

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

Quando crei una vista di raccolta, considera le seguenti limitazioni:

  • Non è possibile controllare l'ordine di visualizzazione dei dati della 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.

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

  1. Fai clic su Principale menu , quindi fai clic su Rapporti.

  2. Clic Nuovo rapporto.

  3. Seleziona l’oggetto del rapporto.

  4. Allontanarsi dal report e utilizzare API Explorer, determina le raccolte disponibili per l'oggetto selezionato per il report.

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

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

  5. Utilizzo di API Explorer, passare all'elenco dei campi per l'oggetto che si desidera visualizzare nell'insieme.

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

    Prendere nota del campo che si desidera visualizzare nella raccolta.

  6. Torna al report e nella sezione Filtri , fare clic su Passa alla modalità testo.

  7. In Impostare le regole di filtro per il report area, 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 insieme visualizzato nella API Explorer. Questo valore è in genere la forma plurale del nome dell'oggetto raccolta.

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

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

  11. Sostituisci valore del modificatore con un modificatore valido.

    Per un elenco dei modificatori, vedi Modificatori di filtri e condizioni.
    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".

  12. Per filtrare in base al nome di un problema, utilizza il seguente codice:

    code language-none
    issues:name=Marketing
    issues:name_Mod=cicontains
    
    note tip
    TIP
    Nota che devi utilizzare issues per il nome dell'oggetto raccolta, anziché optask Questo è il modo in cui vengono visualizzati i problemi in API Explorer.
  13. Clic Fine.

  14. (Facoltativo) Continua a modificare il rapporto.

    Oppure

    Clic Salva e chiudi per salvare il rapporto.

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 su Principale menu , quindi fai clic su  Rapporti.

  2. Clic  Nuovo rapporto.

  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. Clic Impostazioni dei rapporti.

  6. Clic Prompt dei report.

  7. Clic Aggiungi richiesta.

  8. Clic Prompt personalizzato.

  9. Specifica il nome del prompt in  Nomecampo campo.

  10. Specifica un Etichetta elemento a discesa.

  11. Specifica quanto segue in Condizione campo:

    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 insieme visualizzato nella API Explorer. Questo valore è in genere la forma plurale del nome dell'oggetto raccolta.

  14. Sostituisci  campo oggetto raccolta  con il nome del campo dell'oggetto insieme, come visualizzato nel API Explorer.

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

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

  16. Sostituisci  valore del modificatore  con un modificatore valido.

    Per un elenco dei modificatori, vedi  Modificatori di filtri e condizioni.

    Esempio: Ad esempio, per creare un rapporto di progetto con un prompt personalizzato in cui visualizzare solo i progetti a cui è stata assegnata almeno un’attività, utilizza 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
    Non è possibile fare riferimento al nome dell'assegnatario principale (campo "Assegnato a") di un'attività in base al 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
    Nota che devi utilizzare problemi per il nome dell'oggetto insieme. API Explorer non offre al momento un nome di oggetto raccolta per i problemi.
  17. Clic  Fine.

  18. (Facoltativo) Continua a modificare il rapporto.

    Oppure

    Clic  Salva e chiudi per salvare il rapporto.

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