DokumentationWorkfrontAnvändarhandbok om Workfront

Referenssamlingar i en rapport

Last update: Fri Jul 19 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Ämnen:

Skapat för:

  • Användare

Om du skapar en rapport i Adobe Workfront kan du visa en uppsättning objekt, deras respektive fält eller länkade objekt i en lista, ett rutnät eller ett diagramformat.

Mer information om hur du skapar en rapport i Workfront finns i Skapa en anpassad rapport.

Åtkomstkrav

Expandera om du vill visa åtkomstkrav för funktionerna i den här artikeln.

Du måste ha följande åtkomst för att kunna utföra stegen i den här artikeln:

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Adobe Workfront-plan* Alla
Adobe Workfront-licens* Plan
Konfigurationer på åtkomstnivå*

Redigera åtkomst till filter, vyer, grupperingar

Redigera åtkomst till rapporter, instrumentpaneler och kalendrar

Obs! Om du fortfarande inte har åtkomst frågar du Workfront-administratören om de anger ytterligare begränsningar för din åtkomstnivå. Mer information om hur en Workfront-administratör kan ändra åtkomstnivån finns i Skapa eller ändra anpassade åtkomstnivåer.
Objektbehörigheter

Hantera behörigheter i en rapport

Hantera behörigheter för en vy, ett filter eller en gruppering

Mer information om hur du begär ytterligare åtkomst finns i Begär åtkomst till objekt.

Kontakta Workfront-administratören om du vill veta vilken plan, licenstyp eller åtkomst du har.

Förstå samlingar

En samling är en lista med objekt som är länkade till ett annat objekt.

Du har följande två relationer mellan objekt i Workfront:

  • En 1:1-relation: Ett objekt kan bara länkas till ett annat objekt i taget.
    Ett projekt kan till exempel bara länkas till en portfölj i taget.

  • En 1:N-relation: Ett objekt kan länkas till flera andra objekt i taget.
    Ett projekt kan t.ex. ha flera uppgifter. I det här fallet utgör uppgiftslistan en samling för projektet.

IMPORTANT
Du kan skapa en rapport som visar en-till-en-relationen mellan objekt med hjälp av standardrapportverktyget. Du kan dock bara skapa en rapport som visar en-till-många-relationen mellan objekt med hjälp av textlägesgränssnittet i rapportbyggaren.

Mer information om hur du skapar en rapport i standardrapportverktyget finns i Skapa en anpassad rapport.

Mer information om hur du skapar en rapport med hjälp av textlägesgränssnittet finns i:

Söka efter samlingsobjekt och deras fält i API-utforskaren find-collection-objects-and-their-fields-in-the-api-explorer

Alla samlingar kan inte rapporteras.

Om du vill veta vilka objekt som kan kopplas till en samling med andra objekt måste du använda API-utforskaren.
Mer information om API Explorer-tabellen finns i API-utforskaren.

Så här tar du reda på vilka samlingar som kan rapporteras:

  1. Gå till API Explorer.

  2. Hitta rapportens objekt.

  3. Välj fliken Samlingar.

    note note
    NOTE
    Endast de objekt som visas på den här fliken kan representeras som en samling i en rapport för det markerade objektet.

  4. Expandera objektet i din samling genom att klicka på det.

  5. Klicka på länken som visas för att gå till objektet i din samling.
    Då öppnas fliken fält för objektet i din samling.

    note note
    NOTE
    Det går endast att referera till fälten som visas på den här fliken i samlingsrapporten eller de fält som är kopplade till objekt som visas på den här fliken.

Referenssamlingar i rapporter

Du kan referera till objekt från en samling i följande rapportelement:

  • Vyer
  • Filter
  • Fråga

Du kan inte referera till objekt från en samling i följande rapportelement:

  • Grupperingar
  • Diagram

Du kan till exempel referera till uppgiften eller utleverans av samlingar från en projektrapport för att visa aktivitets- eller utleveransinformation på projektnivå.

Referera till en samling i rapportvyn reference-a-collection-in-the-view-of-a-report

Du kan referera till en objektsamling i rapportvyn för att visa attribut för objekt som är kopplade till rapportens objekt.

Du kan till exempel visa uppgifter eller utleverans i en projektrapport genom att skapa en samlingskolumn för uppgifter eller utleverans i rapportvyn.

I samlingsvyn kan du visa information om uppgifter och utgåvor, t.ex. namn, datum, primära tilldelningar, procent färdigt osv.

Vyn visar uppgifter eller ärenden i ett listformat, där varje rad i listan representerar information om en uppgift eller ett problem. Listan med uppgifter eller problem och fälten för dem visas på samma rad som projektet som uppgifterna eller problemen tillhör.
issue_and_tasks_collections_in_reports.png

Lägga till en samlingskolumn i en rapportvy add-a-collection-column-in-a-report-view

Så här lägger du till en samlingskolumn i en rapportvy:

  1. Klicka på Huvudmeny och sedan på Rapporter.

  2. Klicka på Ny rapport.

  3. Markera rapportens objekt.

  4. Gå bort från rapporten och använd API Explorer för att avgöra vilka samlingar som är tillgängliga för det objekt som du har valt för rapporten.

    Mer information om hur du markerar objektet i din samling finns i avsnittet Sök efter samlingsobjekt och deras fält i API-utforskaren i den här artikeln.
    Notera namnet på objektet för samlingen.

  5. Använd API-utforskaren och gå till listan med fält för objektet som du vill visa i samlingen.

    Mer information om hur du söker efter fälten för objektet i din samling finns i avsnittet Sök efter samlingsobjekt och deras fält i API-utforskaren i den här artikeln.

    Notera namnet på det fält som du vill visa i samlingen.

  6. Gå tillbaka till rapporten och klicka på Lägg till kolumn på fliken Kolumner (vy).

  7. Klicka på Växla till textläge.

  8. För musen över dialogrutan och klicka på Klicka för att redigera text.

  9. Markera all text i dialogrutan Textläge och ta bort den. Klistra sedan in följande kod om du refererar till ett fält i samlingsobjektet:

    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. Ersätt kolumnnamnet med namnet på kolumnen på raden displayname.

  11. Ersätt samlingsobjektnamnet med namnet på samlingsobjektet på raden listmethod så som det visas i API-utforskaren.

  12. Ersätt samlingsobjektfältet med namnet på fältet för samlingsobjektet på raden valuefield så som det visas i API-utforskaren.

    Du kan ersätta värdefält med värdesuttryck om du vill skapa ett anpassat uttryck i vyn.

    Mer information om beräknade anpassade uttryck finns i Översikt över beräknade datauttryck.

    Om du till exempel vill visa en lista med uppgifter i en projektrapport. Den här samlingen använder en valuefield-rad för att referera till aktiviteternas namn.

    Gör något av följande:

    • Använd följande kod för att skapa din kolumn:

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

    • Använd följande kod för att visa en lista med problem i rapporten:

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

      Observera att i en samling måste du använda issues för raden listmethod i stället för opTasks som är databasnamnet för Issues. Mer information om när du ska använda issue och när du ska använda opTask när du refererar till problem finns i Använd"opTask" och"issue" när du refererar till problem.

    • Om du vill visa en lista över aktiviteterna i en projektrapport tillsammans med deras primära tilldelare, använder du en värdeuttrycksrad för att referera till namnen på aktiviteterna intill namnen på deras primära tilldelningar i stället för värdefält.

      Använd följande kod för att skapa din kolumn:

      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. Följande kolumn visas i projektrapporten med alla uppgifter i varje projekt tillsammans med de primära tilldelningarna:

  14. Klicka på Spara.

  15. (Valfritt) Fortsätt redigera rapporten.

    eller

    Klicka på Spara + stäng för att spara rapporten.

Förstå raderna i en samlingsvy i textläge

Raderna i ett textläge för en samling beskrivs i följande tabell:

Exempelrad
Beskrivning
valueformat=HTML
Du kan använda olika värden för den här raden, men vi rekommenderar att valueformat för en samlingslista ska vara HTML.
textmode=true
Den här raden anger att kolumnen har konfigurerats i textläge. Om du tar bort den här raden läggs den tillbaka som standard i Workfront.
type=iterate
type i en lista är alltid iterate när en vy skapas.
listdelimiter=<p>

Detta är avgränsaren som används för att separera värdena i listan.
Vi rekommenderar att du använder <p> som lägger till en radbrytning mellan värdena.

Du kan även använda följande:

‍ (nollbreddsskarv). Värdena i samlingen har ingen separation mellan dem.
, =kommaavgränsare. Samlingens värden avgränsas med ett kommatecken följt av inget blanksteg.
/ = snedstreck. Samlingens värden avgränsas med ett snedstreck.
- = streckavgränsare. Samlingens värden avgränsas med ett streck.
Om du lämnar den här raden tom läggs ett kommatecken till följt av ett blanksteg mellan samlingens värden.

displayname=Kolumnnamn
Ersätt kolumnnamnet med det aktuella namnet på den nya kolumnen.
listmethod=nested(collection object name).list

Den här raden definierar den samling som du refererar till.

Ersätt samlingsobjektnamnet med namnet på objektet som du refererar till i samlingen, så som det visas i API-utforskaren. Det här värdet är vanligtvis samlingsobjektets plural-form.

valuefield=collection object field

Den här raden definierar vilket fält du refererar till från samlingsobjektet.

Ersätt samlingsobjektfältet med namnet på fältet för det objekt som du refererar till i samlingen, så som det visas i API-utforskaren.

Du kan ersätta raden med:

värdeuttryck=beräknat fält för samlingsobjekt

Med valueExpression kan du  visar ett beräknat anpassat uttryck i kolumnen.

Mer information om hur du formaterar värdesuttryck rader finns i Syntaxöversikt i textläge.

Begränsningar för en samlingsvy limitations-of-a-collection-view

Tänk på följande begränsningar när du skapar en samlingsvy:

  • Du kan inte styra i vilken ordning samlingsdata visas.
  • Du kan inte använda villkorsstyrd formatering i en samlingsvy.
  • Du kan inte göra ett objekt i en samling till en klickbar länk.
  • Du kan inte skapa en samlingsvy för en annan samling.
    Du kan till exempel inte visa alla tilldelningar för varje uppgift i en projektrapport. Du kan bara visa den primära tilldelaren för varje uppgift i en projektvy.

Referera till en samling i ett rapportfilter reference-a-collection-in-the-filter-of-a-report

Du kan referera till en samling objekt i filtret för en rapport om du vill filtrera efter attributen för objekt som är kopplade till rapportens objekt.

Du kan t.ex. filtrera efter uppgifter eller ärenden i en projektrapport genom att använda en referens till attributen för uppgifter eller ärenden i projektet i filtersatsen.

Så här lägger du till en referens till en samling i ett rapportfilter:

  1. Klicka på Huvudmeny och sedan på Rapporter.

  2. Klicka på Ny rapport.

  3. Markera rapportens objekt.

  4. Gå bort från rapporten och använd API Explorer för att avgöra vilka samlingar som är tillgängliga för det objekt som du har valt för rapporten.

    Mer information om hur du markerar objektet i din samling finns i avsnittet Sök efter samlingsobjekt och deras fält i API-utforskaren i den här artikeln.

    Notera namnet på objektet för samlingen.

  5. Använd API-utforskaren och gå till listan med fält för objektet som du vill visa i samlingen.

    Mer information om hur du söker efter fälten för objektet i din samling finns i avsnittet Sök efter samlingsobjekt och deras fält i API-utforskaren i den här artikeln.

    Anteckna det fält som du vill visa i samlingen.

  6. Gå tillbaka till rapporten och klicka på Växla till textläge på fliken Filter.

  7. Klistra in följande kod i området Ange filterregler för rapporten:

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

  8. Ersätt samlingsobjektnamnet med namnet på samlingsobjektet så som det visas i API-utforskaren. Det här värdet är vanligtvis samlingsobjektets plural-form.

  9. Ersätt samlingsobjektfältet med namnet på fältet för samlingsobjektet i, så som det visas i API-utforskaren.

  10. Ersätt samlingsobjektvärdet med värdet för samlingsobjektet så som det visas i Workfront.

  11. Ersätt värdet för modifieraren med en giltig modifierare.

    En lista med modifierare finns i Filter- och villkorsmodifierare.
    Om du till exempel vill skapa en projektrapport som endast visar projekt med aktiviteter som har "Marknadsföring" i sitt namn använder du följande kod:

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

    Den här rapporten visar endast projekt som har minst en aktivitet med ordet"marknadsföring" i namnet.

  12. Använd följande kod om du vill filtrera efter namnet på ett problem:

    code language-none 
    issues:name=Marketing
issues:name_Mod=cicontains
    note tip
    TIP
    Observera att du måste använda issues som samlingsobjektsnamn i stället för optask, vilket är hur problem visas i API Explorer.

  13. Klicka på Klar.

  14. (Valfritt) Fortsätt redigera rapporten.

    eller

    Klicka på Spara + stäng för att spara rapporten.

Referera till en samling i den anpassade uppmaningen för en rapport reference-a-collection-in-the-custom-prompt-of-a-report

Du kan referera till en samling objekt i den anpassade uppmaningen för en rapport om du vill filtrera rapportens resultat efter attributen för de objekt som är kopplade till rapportens objekt.

Du kan till exempel fråga efter uppgiftsinformation i en projektrapport genom att använda en referens till attributen för uppgifter i projektet i den anpassade uppmaningen i rapporten.

NOTE
Du kan inte referera till samlingar i en standardfråga.

En anpassad prompt är ett anpassat filter där programsatserna förenas med et-tecken. Vi rekommenderar att du skapar programsatsen i ett filter och sedan kopplar ihop raderna i programsatserna med et-tecken.

Mer information om hur du skapar en filtersats med en samlingsreferens finns i avsnittet Referera till en samling i filtret för en rapport i den här artikeln.

Så här lägger du till en referens till en samling i den anpassade uppmaningen för en rapport:

  1. Klicka på Huvudmeny och sedan på Rapporter.

  2. Klicka på Ny rapport.

  3. Markera rapportens objekt.

  4. Skapa ett filter med en samlingsreferens enligt beskrivningen i avsnittet Referera en samling i filtret för en rapport i den här artikeln.

  5. Klicka på Rapportinställningar.

  6. Klicka på Rapportera frågor.

  7. Klicka på Lägg till fråga.

  8. Klicka på Egen fråga.

  9. Ange namnet på uppmaningen i fältet Fält ​ namn.

  10. Ange en nedrullningsbar objektetikett.

  11. Ange följande i fältet Villkor:

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

  12. (Valfritt) Ange om det här alternativet visas som standard i uppmaningen.

  13. Ersätt samlingsobjektnamnet med namnet på samlingsobjektet så som det visas i API-utforskaren. Det här värdet är vanligtvis samlingsobjektets plural-form.

  14. Ersätt samlingsobjektfältet med namnet på fältet för samlingsobjektet så som det visas i API-utforskaren.

  15. Ersätt samlingsobjektvärdet med värdet för samlingsobjektet så som det visas i Workfront.

    Om du till exempel filtrerar efter projekt där aktivitetens namn innehåller"Markering" ersätter du samlingsobjektets värde med Markering.

  16. Ersätt värdet för modifieraren med en giltig modifierare.

    En lista med modifierare finns på  Filter- och villkorsmodifierare.

    Exempel: Om du till exempel vill skapa en projektrapport med en anpassad fråga där du bara vill visa projekt som har minst en aktivitet tilldelad till en viss användare använder du koden nedan:

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

    Detta genererar en rapport där alla projekt i listan har minst en uppgift tilldelad användaren vars GUID är 57cf1b7a00077c9f02f66cb09c8f86c.

    note note
    NOTE
    Du kan inte referera till namnet på den primära tilldelaren ("Tilldelad till"-fältet) för en aktivitet enligt API-utforskaren. Du kan bara referera till ID:t för den primära tilldelade personen.

    Om du till exempel vill filtrera efter projekt där någon av projektnumren har tilldelats en viss användare använder du följande kod för din egen uppmaning:

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

    Detta genererar en rapport där alla projekt i listan har minst ett problem tilldelat användaren vars GUID är 57cf1b7a00077c9f02f66cb09c8f86c.

    note note
    NOTE
    Observera att du måste använda issues som samlingsobjektsnamn. API Explorer  har för närvarande inget samlingsobjektsnamn för utgåvor.

  17. Klicka på Klar.

  18. (Valfritt) Fortsätt redigera rapporten.

    eller

    Klicka på Spara + stäng för att spara rapporten.

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