DocumentazioneWorkfrontGuida di Workfront

Fare riferimento alle raccolte in un rapporto

Last update: Wed Jul 17 2024 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à 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, vedere Richiedere l'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:

  • Relazione uno-a-uno: un oggetto può essere collegato a un solo 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 diversi altri oggetti contemporaneamente.
    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 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. Vai a API Explorer.

  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.

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

  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. Passa il puntatore del mouse sulla finestra di dialogo e fai clic su Fai clic per modificare il 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 API Explorer.

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

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

    Per ulteriori informazioni sulle espressioni personalizzate calcolate, vedere Panoramica delle 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:

  14. Fai clic su Salva.

  15. (Facoltativo) Continua a modificare il rapporto.

    Oppure

    Fare clic su Salva + Chiudi per salvare il report.

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

valuefield=collection object field

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

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

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

  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 campo che si desidera visualizzare nella raccolta.

  6. Torna al report e nella scheda Filtri fai clic su Passa alla 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".

  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
    Si noti che è necessario utilizzare issues per il nome dell'oggetto della raccolta, anziché optask, che è il modo in cui vengono visualizzati i problemi in API Explorer.

  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 sul 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. Fare clic su Aggiungi prompt.

  8. Fare clic su Prompt personalizzato.

  9. Specifica il nome della richiesta nel campo Field ​ name.

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

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

  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. Sostituisci il valore del modificatore con un modificatore valido.

    Per un elenco dei modificatori, vedi  Filtri e modificatori di condizioni.

    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. API Explorer  al momento 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