Dokumentation Workfront Användarhandbok om Workfront

Översikt över syntaxen i textläge

Senast uppdaterad: 16 januari 2025

Ämnen:

Skapat för:

Användare

Du kan använda textlägesgränssnittet för att skapa mer komplexa vyer, filter, grupperingar och anpassade uppmaningar i listor och rapporter. Genom att använda textläge kan du komma åt fält och deras attribut som inte är tillgängliga i standardlägesgränssnittet.

Mer information och överväganden om textläge innan du börjar finns i Översikt över textläge.

En fullständig lista över alla rapportbara fält och deras attribut finns i API-utforskaren.

Mer information om hur du skapar rapporter i textläge, inklusive klasser, videoklipp och självstudiekurser, finns i avsnittet Lär dig på Adobe Experience League webbplats.

Att tänka på när det gäller syntax i textläge

Du måste förstå Adobe Workfront-syntax innan du kan börja skapa rapportelement i textläge. Workfront-syntaxen för textläge är unik för det här programmet och har unika egenskaper som du måste känna till.
Innan du börjar använda textläge i dina rapporter rekommenderar vi att du går igenom våra lektioner för avancerad rapportering för att få en bättre förståelse för vårt textläge.
Du kan anpassa vyer, filter och grupperingar med hjälp av standardlägesgränssnittet. Du kan dock endast skapa anpassade uppmaningar i textläge.

Allmänna riktlinjer för att skapa rapportelement i textläge

Nedan följer några vanliga riktlinjer när du skapar ett rapporterings- eller listelement i textläge:

Använd alltid kamelskiftläge när du refererar till objekt eller attribut i Workfront-databasen.
Tänk på hierarkin med objekt i Workfront. Det finns följande skillnader mellan vyer, filter och grupperingar:
- Du kan visa ett objekt som är tre objekt bort från rapporten eller listobjektet i en vy.
- Du kan inte referera till objekt som är mer än två objekt från huvudobjektet i en gruppering, ett filter eller en anpassad prompt.
Exempel: Du kan visa Portfolio-ägarens namn eller GUID i en uppgiftsvy:

valuefield=project:portfolio:ownerID

Du kan inte gruppera, filtrera eller fråga efter Portfolio-ägaren i en uppgiftsvy:

project:portfolio:ownerID=5808f4bc00790b270a9629dd128e63fa

I de här exemplen är Portfolio ägar-ID tre objekt från listans objekt.

Mer information om hierarkin för objekt i Workfront finns i:
- Förstå objekt i Adobe Workfront
- API Explorer
Använd jokertecken när det är möjligt för att göra rapporter och listor mer dynamiska och undvika att duplicera dem för olika användare och liknande tidslinjer.

Översikt över kameraärenden

När du refererar till Workfront-fält eller deras attribut i textläge, kräver Workfront att du skriver deras namn med kamelstil. I det här fallet stavas ennamnsfälten med gemener. Sammansatta fält är stavade enligt följande mönster:

camelCaseSyntax

IMPORTANT

Alla rapportelement följer det här övergångsmönstret.

Egenskaperna hos kamelfodral är:

Det första ordet börjar alltid med en gemen bokstav.
Följande ord börjar alltid med en versal.
Det finns inga mellanslag mellan orden.

Exempel: Om du vill referera till det faktiska slutförandedatumet för ett projekt, är namnet på fältet som du skulle använda när du skapar rapportelement i textläge

actualCompletionDate

Syntax för textläge för olika rapportelement

Följande likheter finns mellan syntaxen för uppsättningarna med rapportelement nedan när de skapas i textläge:

Raderna med kod och syntax är desamma för vyer och grupperingar.

Mer information om kodraderna för vyer och grupperingar när du skapar dem i textläge finns i:
- Redigera en vy i textläge
- Redigera en gruppering i textläge
Kod- och syntaxraderna är desamma för filter och anpassade uppmaningar.

Mer information finns i:
- Redigera ett filter i textläge
- Lägga till en fråga i en rapport

Syntax för vyer och grupperingar

Kodraderna när du skapar vyer och grupperingar är lika.

Mer information om hur du skapar vyer och grupperingar finns i följande artiklar:

Den viktigaste kodraden för en vy eller gruppering är den rad som identifierar det objekt som refereras i vyns kolumn eller i grupperingen. Den här kodraden kan börja med valuefield eller valueexpression baserat på om det här fältet är en direkt referens till ett Workfront-databasfält eller en beräkning mellan flera fält.

I följande tabell visas de vanligaste kodraderna i en vy eller gruppering:

Kodrad

Beskrivning

valuefield

Identifierar det objekt som vyns kolumn eller gruppering refererar till. Detta är en direkt referens till det refererade objektet.

valueexpression

Identifierar det objekt som vyns kolumn eller gruppering refererar till. Detta är en beräkning mellan flera fält.

valueformat

Identifierar det format i vilket Workfront returnerar det värde som anges i värdefältet eller värdesuttrycksraderna.

width

Identifierar bredden på en kolumn i pixlar.

stretch

Identifierar vilka kolumner som upptar extra utrymme som inte behövs för vyn.

TIP

Även om kodraderna i exemplen nedan är lika mellan vyer och grupperingar, måste du alltid komma ihåg att varje kodrad för en gruppering börjar med grupperingsnumret.

Om du vill gruppera efter projektnamn i en projektlista eller rapport använder du följande rad för gruppering på första nivån:

group.0.valuefield=name
Om du redigerar flera kolumner i en vy i samma kolumn (som när det gäller delade kolumner) måste du komma ihåg att varje kodrad för varje kolumn börjar med kolumnnumret.

Använd följande format för att identifiera den första kolumnen i en vy:

column.0.valuefield=name

Mer information om att dela kolumner finns i Visa: sammanfoga information från flera kolumner i en delad kolumn.

Syntaxöversikt för `Valuefield` för vyer och grupperingar

Valuefield= är en nyckelrad med kod i vyer och grupperingar som identifierar det objekt som du refererar direkt.

Syntaxen för direkt referensfält är identisk för grupperingar och vyer.

Följande regler gäller när du refererar till Workfront-objekt på en valuefield-rad:

Använd kamelcase för att referera till fält direkt.

Exempel: Använd följande rad om du vill referera till det faktiska slutförandedatumet för aktiviteten i en aktivitetsvy:

valuefield=actualCompletionDate
Använd kamelcase och kolon för att separera fält som relaterar till varandra för samma objekt.

Exempel: Använd följande rad om du vill referera till projektets planerade slutförandedatum i en aktivitetsvy:

valuefield=project:plannedCompletionDate

Information om hur objekt refererar till varandra i Workfront-databasen finns i API-utforskaren.
När du refererar till ett anpassat fält ska du använda fältets namn exakt som det visas i gränssnittet.

Exempel: Använd följande rad om du vill referera till ett anpassat projektfält med etiketten Ytterligare information i en aktivitetsvy:

valuefield=project:Additional Details

Syntaxöversikt för `Valueexpression` för vyer och grupperingar

Du kan ersätta kodraden valuefield= med valueexpression= när du skapar vyer och grupperingar i textläge när du vill referera till en beräkning mellan två eller flera fält.

TIP

Även om du kan skapa beräkningsfält som du kan visa i rapporter, är beräknade vyer och grupperingar mer dynamiska. Beräknade vyer och grupperingar uppdateras med ny information varje gång du kör rapporten eller visar en lista.

Mer information om hur du skapar beräknade kolumner i en vy finns i Beräknade anpassade fält kontra beräknade kolumner.

Att skapa en beräknad gruppering påminner om att skapa en beräknad kolumn i en vy.

Följande regler gäller när du refererar till Workfront-objekt på en valueexpression-rad:

Använd kamelcase för att referera till fält direkt och omsluta varje fält med klammerparenteser.

Exempel: Använd följande rad om du vill visa aktivitetsnamnfältet i en aktivitetskolumn med valueexpression:

valueexpression={name}
Använd kamelcase och punkter för att separera fält som hör ihop.

Exempel: Använd följande rader om du vill visa namnet på ett projekt som är sammanfogat med namnet på aktiviteten i en aktivitetsrapport:
- I en vy:
  
  valueexpression=CONCAT({project}.{name},' - ',{name})
- I en gruppering:
  
  group.0.valueexpression=CONCAT({project}.{name},' - ',{name})
Information om hur objekt refererar till varandra i Workfront-databasen finns i API-utforskaren.
Använd följande regler när du refererar till ett anpassat fält:
- Använd namnet på fältet exakt som det visas i gränssnittet.
- Föregående fältets namn med "DE:".
- Omsluter fältet med klammerparenteser.
- Avgränsa fälten som hör till objektet med punkter.
Exempel: Använd följande rad om du vill visa det anpassade fältet Ytterligare information i en aktivitetsvy på en värdesuttrycksrad:

valueexpression={project}.{DE:Additional Details}
Du kan använda ett jokertecken i en valueexpression men inte i en valuefield-rad.

Mer information om jokertecken finns i Översikt över filtervariabler för jokertecken.

`Valueformat` - översikt för vyer och grupperingar

Den näst viktigaste kodraden i en vy eller gruppering är raden valueformat=. Detta anger för Workfront i vilket format det returnerar det värde du anger på raderna valuefield eller valueexpression. Även om du kan använda olika format för valueformat rader rekommenderar vi att du alltid använder följande värde när du använder valueexpression:

valueformat=HTML

Ytterligare valueformat-värden finns i följande artiklar:

`width` - översikt för vyer

width= är kodraden där du kan ange bredden på varje kolumn i pixlar. Workfront har en föreslagen bredd för varje fält, men beroende på fälttyp och format kan du behöva göra justeringar.

Du måste använda den extra usewidths=true-kodraden för att framtvinga den bredd som anges för kolumnen.

Exempel: Använd följande rader om du vill visa en kolumn med en bredd på 80 pixlar:

width=80

usewidths=true

`stretch` - översikt för vyer

stretch används för att identifiera vilka kolumner som upptar extra utrymme som inte behövs för vyn. Användargränssnittets bredd för en vanlig användare är cirka 850 pixlar. Det innebär att om du har en vy med fyra kolumner (150 pixlar vardera) så upptar vyn 600 av 850 pixlar. Det finns 250 extra pixlar i gränssnittet som läggs till i kolumner som har en sträckningsprocent.

En kolumns sträckning används när du använder den extra kodraden usewidths=true för minst en av kolumnerna i vyn.

Exempel: Använd följande rader om du vill ange att en kolumn kan använda 70 % av det tomma utrymmet i en vy:

stretch=70

usewidths=true

Syntax för filter och anpassade uppmaningar

Syntaxen för att skapa filter liknar den för att skapa egna uppmaningar.

TIP

Du kan skapa en anpassad fråga genom att först skapa ett filter för satsen som du vill inkludera i prompten. Koppla ihop alla kodrader i ett filter med "&" utan blanksteg mellan raderna och det blir din egen uppmaning.

Mer information om hur du skapar filter och anpassade uppmaningar finns i:

Mer information om hur du skapar filter i textläge finns i Redigera ett filter i textläge.

Du kan använda följande element för att skapa filter och anpassade uppmaningar i textläge:

En kodrad som refererar till filtersatsens objekt. Använd kameraläge för filterobjektet.
En kodrad som refererar till filterobjektet och modifieraren för filterobjektets värde. Använd kameraläge för filterobjektet på den här raden.

TIP
När du refererar till intervall kräver detta två modifieringslinjer.
En satsanslutning som ansluter flera filtersatser:
- OCH
  
  Det här är standardkopplingen mellan filtersatser.
- ELLER
  
  TIP
  Satskopplingar är skiftlägeskänsliga och alltid versaler. "AND" kan utelämnas i textläge.
Jokertecken för att göra filter mer dynamiska och anpassa dem för aktuell tid eller för användaren som är inloggad. Mer information om jokertecken finns i Översikt över filtervariabler för jokertecken.

recommendation-more-help