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
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.
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:
-
Vai a API Explorer.
-
Trova l’oggetto del rapporto.
-
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. -
Espandere l'oggetto della raccolta facendo clic su di esso.
-
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.
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:
-
Fai clic su Principale menu , quindi fai clic su Rapporti.
-
Clic Nuovo rapporto.
-
Seleziona l’oggetto del rapporto.
-
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. -
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.
-
Torna al report e nella sezione Colonne (visualizzazione) , fare clic su Aggiungi colonna.
-
Clic Passa alla modalità testo.
-
Passare il puntatore del mouse sulla finestra di dialogo e fare clic su Fare clic per modificare il testo.
-
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
-
Sostituisci Nome colonna con il nome della colonna nel
displayname
linea. -
Sostituisci nome oggetto raccolta con il nome dell'oggetto raccolta in
listmethod
linea, come appare nella API Explorer. -
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})
-
-
Nel rapporto del progetto viene visualizzata la colonna seguente, in cui sono elencate tutte le attività di ciascun progetto insieme ai relativi assegnatari principali:
-
Fai clic su Salva.
-
(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:
valueformat=HTML
valueformat
per un elenco di raccolta deve essere HTML.textmode=true
type=iterate
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 colonnalistmethod=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:
-
Fai clic su Principale menu , quindi fai clic su Rapporti.
-
Clic Nuovo rapporto.
-
Seleziona l’oggetto del rapporto.
-
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.
-
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.
-
Torna al report e nella sezione Filtri , fare clic su Passa alla modalità testo.
-
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
-
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.
-
Sostituisci campo oggetto raccolta con il nome del campo dell'oggetto insieme in, come visualizzato nel API Explorer.
-
Sostituisci valore dell'oggetto raccolta con il valore dell'oggetto insieme visualizzato in Workfront.
-
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".
-
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. -
Clic Fine.
-
(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.
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:
-
Fai clic su Principale menu , quindi fai clic su Rapporti.
-
Clic Nuovo rapporto.
-
Seleziona l’oggetto del rapporto.
-
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.
-
Clic Impostazioni dei rapporti.
-
Clic Prompt dei report.
-
Clic Aggiungi richiesta.
-
Clic Prompt personalizzato.
-
Specifica il nome del prompt in Nome campo campo.
-
Specifica un Etichetta elemento a discesa.
-
Specifica quanto segue in Condizione campo:
code language-none collection object name:collection object field_Mod=value of the modifier
-
(Facoltativo) Specifica se questa scelta viene visualizzata per impostazione predefinita nel prompt.
-
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.
-
Sostituisci campo oggetto raccolta con il nome del campo dell'oggetto insieme, come visualizzato nel API Explorer.
-
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.
-
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. -
Clic Fine.
-
(Facoltativo) Continua a modificare il rapporto.
Oppure
Clic Salva e chiudi per salvare il rapporto.