Overzicht van syntaxis in tekstmodus
U kunt de interface van de tekstwijze gebruiken om complexere meningen, filters, groeperingen, en aangepaste herinneringen in lijsten en rapporten tot stand te brengen. Met de tekstmodus hebt u toegang tot velden en de bijbehorende kenmerken die niet beschikbaar zijn in de standaardmodus.
Voor informatie en overwegingen over tekstwijze alvorens u begint, zie Overzicht van de Wijze van de Tekst .
Voor een volledige lijst van al onze te melden gebieden en hun attributen, zie de API Ontdekkingsreiziger .
Meer informatie over het maken van rapporten in de tekstmodus, waaronder klassen, video's en zelfstudies, vindt u in de sectie Learn op de website van de Adobe Experience League.
Overwegingen bij de syntaxis van de tekstmodus
- U moet de syntaxis van Adobe Workfront begrijpen voordat u rapportelementen kunt gaan maken in de tekstmodus. De Workfront-syntaxis voor de tekstmodus is uniek voor deze toepassing en heeft unieke kenmerken waarmee u vertrouwd moet zijn.
- Voordat u de tekstmodus in uw rapporten gaat gebruiken, raden we u ten zeerste aan onze klassen voor geavanceerde rapportage te gebruiken om meer inzicht te krijgen in de taal van de tekstmodus.
- U kunt weergaven, filters en groepen aanpassen met de standaardmodusinterface. U kunt echter alleen aangepaste vragen maken met behulp van de tekstmodus.
Gemeenschappelijke richtsnoeren voor het samenstellen van rapporteringselementen in tekstmodus
De volgende richtlijnen gelden voor het samenstellen van rapporten of lijstelementen in de tekstmodus:
-
Gebruik altijd kameel-hoofdlettergebruik wanneer u verwijst naar objecten of kenmerken in de Workfront-database.
-
Houd rekening met de objecthiërarchie in Workfront. De volgende verschillen bestaan tussen weergaven, filters en groepen:
- U kunt een object weergeven dat zich drie objecten buiten het rapport- of lijstobject in een weergave bevindt.
- U kunt niet verwijzen naar objecten die zich meer dan twee objecten buiten het hoofdobject bevinden in een groep, filter of aangepaste vraag.
Voorbeeld: u kunt de naam of GUID van de Eigenaar van Portfolio in een taakmening tonen:
valuefield=project:portfolio:ownerIDU kunt geen groeperen, filteren of vragen voor de Eigenaar van Portfolio in een taakmening:
project:portfolio:ownerID=5808f4bc00790b270a9629dd128e63faIn these examples, Portfolio Owner ID is three objects away from the object of the list.
For information about the hierarchy of objects in Workfront, see:
-
Use wildcards whenever possible to make your reports and lists more dynamic and avoid duplicating them for different users and similar timelines.
Camel case overview
When referencing Workfront fields or their attributes in text mode, Workfront requires you to type their names in camel case. In this case, the single-name fields are spelled in lowercase. Compound fields are spelled according to the following pattern:
camelCaseSyntax
The characteristics of camel case are:
- The first word always starts with a lowercase letter.
- De volgende woorden beginnen altijd met een hoofdletter.
- Er zijn geen spaties tussen de woorden.
Voorbeeld: om de Ware Datum van de Voltooiing van een project van verwijzingen te voorzien, de naam van het gebied dat u zou gebruiken wanneer het bouwen van tekstwijze het melden van elementen is
actualCompletionDate
Syntaxis van de tekstmodus voor verschillende rapportelementen
De volgende overeenkomsten bestaan tussen de syntaxis van de hieronder vermelde sets met rapporteringselementen wanneer u deze maakt met de tekstmodus:
-
The lines of code and syntax are similar for views and groupings.
For information about the key lines of codes for views and groupings when building them in text mode, see:
-
The lines of code and syntax are similar for filters and custom prompts.
Zie voor meer informatie:
Syntaxis voor weergaven en groepen
De coderegels bij het samenstellen van weergaven en groepen zijn vergelijkbaar.
Raadpleeg de volgende artikelen voor informatie over het maken van weergaven en groepen:
De belangrijkste coderegel voor een weergave of groep is de regel die het object aangeeft waarnaar wordt verwezen in de kolom van de weergave of in de groep. Deze coderegel kan beginnen met valuefield of valueexpression op basis van het feit of dit veld een directe verwijzing naar een Workfront-databaseveld of een berekening tussen verschillende velden is.
De volgende tabel bevat een lijst met de meestvoorkomende regels voor codes in een weergave of groep:
valuefieldvalueexpressionvalueformatwidthstretch-
Hoewel de coderegels in de onderstaande voorbeelden vergelijkbaar zijn tussen weergaven en groepen, moet u er altijd rekening mee houden dat elke coderegel voor een groepering begint met het groeperingsnummer.
Om door de Naam van het Project in een projectlijst of een rapport te groeperen, gebruik de volgende lijn voor de eerste rij groeperen:
group.0.valuefield=name -
Als u meerdere kolommen bewerkt in een weergave in dezelfde kolom (zoals het geval is bij gedeelde kolommen), moet u niet vergeten dat elke coderegel voor elke kolom begint met het kolomnummer.
Gebruik de volgende indeling om de eerste kolom van een weergave te identificeren:
column.0.valuefield=nameVoor informatie over het delen van kolommen, zie Mening: voeg informatie van veelvoudige kolommen in één gedeelde kolom samen.
Valuefield syntaxisoverzicht voor weergaven en groepen
Valuefield= is een belangrijke coderegel in weergaven en groepen die het object identificeert waarnaar u rechtstreeks verwijst.
De syntaxis voor velden die rechtstreeks naar velden verwijzen, is identiek voor groepen en weergaven.
De volgende regels zijn van toepassing wanneer wordt verwezen naar Workfront-objecten die een valuefield -regel gebruiken:
-
Gebruik kameel-hoofdlettergebruik om rechtstreeks naar velden te verwijzen.
Voorbeeld: om de Werkelijke Datum van de Voltooiing van de Taak in een taakmening van verwijzingen te voorzien, gebruik de volgende lijn:
valuefield=actualCompletionDate -
Gebruik kameelhoofdletters en dubbele punten om aan elkaar verwante velden voor hetzelfde object te scheiden.
Voorbeeld: om het Project Geplande Datum van de Voltooiing in een taakmening van verwijzingen te voorzien, gebruik de volgende lijn:
valuefield=project:plannedCompletionDateVoor informatie over hoe de voorwerpen naar elkaar in het gegevensbestand van Workfront van verwijzingen voorzien, zie de API Ontdekkingsreiziger .
-
Wanneer u naar een aangepast veld verwijst, gebruikt u de naam van het veld exact zoals deze in de interface wordt weergegeven.
Voorbeeld: om een gebied van de projectdouane van verwijzingen te voorzien geëtiketteerd Extra Details in een taakmening, gebruik de volgende lijn:
valuefield=project:Additional Details
Valueexpression syntaxisoverzicht voor weergaven en groepen
U kunt de coderegel valuefield= vervangen door valueexpression= bij het samenstellen van weergaven en groepen in de tekstmodus als u wilt verwijzen naar een berekening tussen twee of meer velden.
Building a calculated grouping is similar to building a calculated column in a view.
The following rules apply when referencing Workfront objects using a valueexpression line:
-
Use camel case to reference fields directly and enclose each field in curly brackets.
Example: To display the Task Name field in a task column using
valueexpression, use the following line:valueexpression={name} -
Use camel case and periods to separate fields related to one another.
Example: To display the name of a project concatenated with the name of the task in a task report, use the following lines:
-
In a view:
valueexpression=CONCAT({project}.{name},' - ',{name}) -
In a grouping:
group.0.valueexpression=CONCAT({project}.{name},' - ',{name})
For information about how objects are referencing one another in the Workfront database, see the API Explorer.
-
-
When referencing a custom field, use following rules:
- Use the name of the field exactly as it appears in the interface.
- Plaats voor de naam van het veld de tekst "DE:".
- Plaats het veld tussen accolades.
- Scheid de velden die betrekking hebben op het object met punten.
Voorbeeld: om het Extra gebied van de het projectdouane van Details in een taakmening in een lijn van de waardeuitdrukking te tonen, gebruik de volgende lijn:
valueexpression={project}.{DE:Additional Details} -
U kunt een jokerteken gebruiken in een
valueexpressionmaar niet in eenvaluefield-regel.Voor informatie over vervangingen, zie overzicht van de de filtervariabelen van de Vervanging .
Valueformat overview for views and groupings
The second most important line of code in a view or grouping is the valueformat= line. This tells Workfront in what format to return the value you specify in the valuefield or valueexpression lines. Although you can use various formats for the valueformat lines, we recommend that you always use the following value when using valueexpression:
valueformat=HTML
For additional valueformat values, also see the following articles:
width overview for views
width= is the line of code where you can specify the width of each column in pixels. Workfront provides a suggested width for each field, though depending on the type of field and format, you may want to make adjustments.
U moet de extra usewidths=true coderegel gebruiken om de voor de kolom opgegeven breedte in te stellen.
Example: To display a column with a width of 80 pixels, use the following lines:
width=80
usewidths=true
stretch overzicht voor weergaven
stretch wordt gebruikt om te identificeren welke kolommen extra ruimte innemen die niet nodig is voor de weergave. De breedte van de gebruikersinterface van de werkruimte voor een standaardgebruiker is ongeveer 850 pixels. Dit betekent dat als u een weergave hebt met vier kolommen (elk 150 pixels), uw weergave 600 van 850 pixels in beslag neemt. Er zijn 250 extra pixel in UI die aan de kolommen zullen worden toegevoegd die een rekbaarheidspercentage hebben verstrekt.
Het uitrekken van een kolom wordt afgedwongen wanneer u de extra coderegel: usewidths=true gebruikt voor ten minste een van de kolommen in de weergave.
Voorbeeld: om erop te wijzen dat een kolom 70% van de lege ruimte in een mening kon gebruiken, gebruik de volgende lijnen:
stretch=70
usewidths=true
Syntax for filters and custom prompts
The syntax for creating filters is similar to that for creating custom prompts.
For information about building filters and custom prompts, see:
Voor informatie over het creëren van filters op tekstwijze, zie een filter uitgeven gebruikend tekstwijze .
U kunt de volgende elementen gebruiken om filters en aangepaste herinneringen op tekstwijze te bouwen:
-
Een coderegel die naar het object van de filterinstructie verwijst. Gebruik een kameelhoofdletter voor het filterobject.
-
Een coderegel die verwijst naar het filterobject en de modifier voor de waarde van het filterobject. Gebruik kameel-hoofdlettergebruik voor het filterobject op deze regel.
note tip TIP Wanneer het van verwijzingen voorzien van waaiers, vereist dit 2 bepalingslijnen. -
Een instructieconnector die meerdere filterinstructies verbindt:
-
EN
Dit is de standaardaansluiting tussen filterinstructies.
-
OF
note tip TIP De schakelaars van de verklaring zijn case sensitive en altijd in hoofdletters. "AND" kan worden weggelaten in de tekstmodus.
-
-
Jokertekens om filters dynamischer te maken en ze aan te passen voor de huidige tijd of de gebruiker die is aangemeld. Voor informatie over vervangingen, zie overzicht van de de filtervariabelen van de Vervanging .