Overzicht van berekende gegevensexpressies
U kunt gegevensexpressies gebruiken om berekende aangepaste velden in Adobe Workfront te definiëren. Berekende expressies verbinden bestaande Workfront-velden met instructies die een nieuw veld genereren.
U kunt berekende gegevensexpressies gebruiken in:
-
Een berekend aangepast veld op een aangepast formulier
Voor meer informatie over het creëren van berekende douanevelden op douanevormen in Workfront, zie berekende gebieden aan een vormtoevoegen.
-
Een berekende aangepaste kolom in een rapport of lijst wanneer u de tekstmodus gebruikt
Voor meer informatie over het gebruiken van tekstwijze in rapporten en meningen, zie Overzicht van de Wijze van de Tekst.
Syntaxis van berekende aangepaste velden versus berekende aangepaste kolommen
Hoewel de functies die u gebruikt hetzelfde zijn, kan de syntaxis voor het bouwen van een expressie in een berekend aangepast veld afwijken van de syntaxis voor het bouwen van een berekende aangepaste kolom.
De verschillen tussen de twee syntaxis zijn als volgt:
Bijvoorbeeld:
-
In een aangepast veld gebruikt u op een aangepast formulier voor taken de volgende opties om de naam te genereren van het bovenliggende project van de taak waaraan het aangepaste formulier is gekoppeld:
{project}.{name}
-
In een douanekolom in een rapport, zou u het volgende gebruiken om een de douanekolom van de Naam van het Project op een taakrapport toe te voegen:
valuefield=project:name
of
valueexpression={project}.{name}
note tip TIP Dezelfde syntaxis is van toepassing op alle rapportelementen in de tekstmodus waarvoor berekende expressies worden gebruikt: weergaven, filters, groepen en aanwijzingen.
Voor meer informatie over de syntaxis moet u in een berekende douanekolom gebruiken, zie Overzicht van de Wijze van de Tekst.
Gegevensexpressies die u kunt gebruiken
In de onderstaande lijsten worden de beschikbare expressies gedefinieerd die u kunt gebruiken wanneer u een van de drie verschillende typen berekende aangepaste velden maakt in Workfront:
U kunt de hieronder vermelde uitdrukkingen gebruiken om berekende douanekolommen te bouwen. Nochtans, moet u de correcte syntaxis voor een berekende douanekolom gebruiken, zoals die in de sectie Syntaxis van berekende douanegebieden vs. berekende douanekolommenin dit artikel wordt beschreven.
Berekende datum en tijd, aangepaste velden date-time-calculated-custom-fields
U kunt een datum- of tijdberekend aangepast veld maken met de volgende expressies:
Hiermee voegt u het aantal dagen toe aan de datum. De getalwaarde kan gedeeltelijke dagen omvatten. 1,5 voegt bijvoorbeeld anderhalve dag toe aan de datum.
De expressie wordt als volgt opgemaakt:
ADDDAYS(date, number)
Hiermee voegt u het aantal weekdagen toe aan de datum. Met deze expressie worden alleen gehele gehele getallen aan de datum toegevoegd, naar beneden afgerond.
De expressie wordt als volgt opgemaakt:
ADDWEEKDAYS(date, number)
Hiermee voegt u het aantal maanden toe aan de datum. De notatie is als volgt:
ADDMONTHS(date, number)
Hiermee voegt u het aantal jaren toe aan de datum. De notatie is als volgt:
ADDYEARS(date, number)
Wist het tijdgedeelte van een datum en is als volgt opgemaakt. In dit voorbeeld is de datum de ingangsdatum voor een werkobject.
CLEARTIME({entryDate})
Converteert een tekenreeks naar een datum en is als volgt opgemaakt:
DATE(string)
Geeft als resultaat het aantal dagen tussen de twee datums, rekening houdend met de begin- en einddagen van de geselecteerde periode en de tijdstempels op die dagen. Als de begintijd van de begindatum bijvoorbeeld 3 PM is, wordt de begindag niet geteld als een volledige dag.
De expressie wordt als volgt opgemaakt:
DATEDIFF(date1, date2)
Retourneert de dag van de maand voor de datum als een getal tussen 1 en 31.
De expressie wordt als volgt opgemaakt. In dit voorbeeld is de datum de ingangsdatum voor een werkobject.
DAYOFMONTH({entryDate})
Retourneert de dag van de week voor de datum als een getal tussen 1 (zondag) en 7 (zaterdag).
De expressie wordt als volgt opgemaakt. In dit voorbeeld is de datum de ingangsdatum voor een werkobject.
DAYOFWEEK({entryDate})
Retourneert het totaal aantal dagen in de maand van de datum als een getal en wordt als volgt opgemaakt. In dit voorbeeld is de datum de ingangsdatum voor een werkobject.
DAYSINMONTH({entryDate})
Geeft als resultaat het totale aantal weekdagen tussen de datum en het einde van de week of, indien dit eerder is, het einde van de maand. In dit voorbeeld is de datum de ingangsdatum voor een werkobject.
De expressie wordt als volgt opgemaakt:
DAYSINSPLITWEEK({entryDate})
Retourneert het totaal aantal dagen in het jaar van de datum als een getal en wordt als volgt opgemaakt. In dit voorbeeld is de datum de ingangsdatum voor een werkobject.
DAYSINYEAR({entryDate})
Retourneert de laatste datum in de lijst en is als volgt opgemaakt:
DMAX(date1, date2, ...)
Retourneert de vroegste datum in de lijst en is als volgt opgemaakt:
DMIN(date1, date2, ...)
Retourneert het uur van de datum als een getal tussen 0 en 23.
De expressie wordt als volgt opgemaakt. In dit voorbeeld is de datum de ingangsdatum voor een werkobject.
HOUR({entryDate})
Retourneert de minuut van de datum als een getal tussen 0 en 60, opgemaakt als volgt. In dit voorbeeld is de datum de ingangsdatum voor een werkobject.
MINUTE({entryDate})
Retourneert de maand van de datum als een getal tussen 1 en 12, opgemaakt als volgt. In dit voorbeeld is de datum de ingangsdatum voor een werkobject.
MONTH({entryDate})
Retourneert de tweede van de datum als een getal tussen 0 en 60, opgemaakt als volgt. In dit voorbeeld is de datum de ingangsdatum voor een werkobject.
SECOND({entryDate})
Geeft als resultaat het aantal weekdagen tussen twee datums, rekening houdend met de begin- en einddagen van de geselecteerde periode en de tijdstempels op die dagen. Als de begintijd van de begindatum bijvoorbeeld 3 PM is, wordt de begindag niet als een volledige dag geteld.
De expressie wordt als volgt opgemaakt:
WEEKDAYDIFF(date2, date1)
Retourneert het aantal geplande minuten tussen de datums volgens het standaardschema.
De expressie wordt als volgt opgemaakt:
WORKMINUTESDIFF(date1, date2)
Retourneert het jaar van de datum als een getal van 4 cijfers, opgemaakt als volgt. In dit voorbeeld is de datum de ingangsdatum voor een werkobject.
YEAR({entryDate})
Wiskundige berekende aangepaste velden mathematical-calculated-custom-fields
U kunt een berekend aangepast veld maken dat een aantal van de volgende wiskundige expressies gebruikt:
Retourneert de absolute waarde van het getal en is als volgt opgemaakt. In dit voorbeeld wordt het aantal objecten gebruikt onder het object waaraan het aangepaste formulier is gekoppeld.
ABS({numberOfChildren})
Retourneert het gemiddelde van getallen en is als volgt opgemaakt:
AVERAGE(number1, number2, ...)
Rondt een getal af tot op het dichtstbijzijnde gehele getal en wordt als volgt opgemaakt. In dit voorbeeld wordt het aantal objecten gebruikt onder het object waaraan het aangepaste formulier is gekoppeld.
CEIL({numberOfChildren})
Verdeelt alle getallen in de opgegeven volgorde en is als volgt opgemaakt:
DIV(number1, number2, ...)
Rondt een getal af naar het dichtstbijzijnde gehele getal en wordt als volgt opgemaakt. In dit voorbeeld wordt het aantal objecten gebruikt onder het object waaraan het aangepaste formulier is gekoppeld.
FLOOR({numberOfChildren})
Retourneert de natuurlijke logaritmewaarde van het getal en wordt als volgt opgemaakt:
LN({numberOfChildren})
Retourneert de logaritmewaarde van number2 naar het basissenummer1 en is als volgt opgemaakt:
LOG(number1, number2)
Retourneert het grootste item in de lijst en is als volgt opgemaakt:
MAX(item1, item2, ...)
Retourneert het kleinste item in de lijst en is als volgt opgemaakt:
MIN(item1, item2, ...)
Zet een tekenreeks om in een getal en is als volgt opgemaakt:
NUMBER(string)
Retourneert een getal dat tot een macht is verheven en dat als volgt is opgemaakt:
POWER(number, power)
Vermenigvuldigt alle getallen en is als volgt opgemaakt:
PROD(number1, number2, ....)
OPMERKING
Wanneer u velden met uren vermenigvuldigt, dient u te weten of de database de uren in geselecteerde velden in minuten, uren of seconden opslaat. Als de uren in notulen of seconden maar vertoning in uren in de interface van Workfront worden bewaard, zou u voor de omzetting van notulen of seconden aan uren kunnen rekenschap moeten geven wanneer het schrijven van een uitdrukking gebruikend deze berekening.
Rondt het getal af tot de opgegeven decimalen met de nauwkeurigheid en wordt als volgt opgemaakt:
ROUND(number, precision)
De getallen worden in oplopende volgorde gesorteerd en worden als volgt opgemaakt:
SORTASCNUM(number1,number2, ...)
De getallen worden in aflopende volgorde gesorteerd en worden als volgt opgemaakt:
SORTDESCNUM(number1, number2, ...)
Retourneert een vierkantswortel van een getal en is als volgt opgemaakt. In dit voorbeeld wordt het aantal objecten gebruikt onder het object waaraan het aangepaste formulier is gekoppeld.
SQRT({numberOfChildren})
Trekt alle aantallen in de verstrekte orde af en is geformatteerd als volgt:
SUB(number1, number2, ...)
Voegt alle getallen toe en wordt als volgt opgemaakt:
SUM(number1, number2, ...)
Berekende tekst, aangepaste velden text-calculated-custom-fields
U kunt een berekend aangepast veld maken waarin een waarde met tekstopmaak wordt weergegeven met de volgende expressies:
Wordt gebruikt met andere expressies om een waarde in een lijst te kiezen op basis van een indexnummer.
Een indexnummer is een veld of functie die een numerieke waarde retourneert (gewoonlijk in een bekend bereik).
De expressie wordt als volgt opgemaakt:
CASE(indexNumber, value1, value2, ...)
De volgende expressie retourneert bijvoorbeeld de naam van de dag van de week, waarbij 1=zondag, 2=maandag enzovoort, in een berekende kolom:
CASE(DAYOFWEEK({entryDate}),"Sunday","Monday","Tuesday","Wednesday","Thursday","Friday","Saturday")
Werkt het best met andere expressies die een getal retourneren, zoals DAYOFWEEK, DAYOFMONTH en MONTH.
Voegt de tekenreeks samen en is als volgt opgemaakt:
CONCAT(string1,"separator", string2)
Hieronder volgen voorbeelden van scheidingstekens die u kunt opnemen:
- een spatie: " "
- een streepje: "-"
- een slash: "/"
- een komma: ","
- een woord: "or", "and"
Retourneert true als de findText-tekenreeks is gevonden binnen de withinText-tekenreeks en als volgt is opgemaakt:
CONTAINS(findText, withinText)
Hiermee worden alle speciale tekens in de tekenreeks verwijderd, zodat deze in een URL-argument kunnen worden opgenomen.
De expressie wordt als volgt opgemaakt:
ENCODEURL(string)
Evalueert een voorwaarde die u specificeert en de waarde van trueExpression terugkeert als het waar is, of de waarde van falseExpression als het vals is.
De expressie wordt als volgt opgemaakt:
IF(condition, trueExpression, falseExpression)
U kunt bijvoorbeeld twee verschillende datumvelden vergelijken, gevolgd door een Waar/Onwaar-resultaat als een gegevenstekenreeks:
IF({projectedCompletionDate}>{plannedCompletionDate},"Off Track","On Track")
In de dagelijkse toespraak betekent deze verklaring: "ALS de Geprojecteerde Voltooiingsdatum van mijn voorwerp "Groter dan"de Geplande VoltooiingsDatum van mijn zelfde voorwerp is, dan tonen de woorden "Van Spoor"op dit gebied; anders, tonen de woorden "Op Spoor".
Als u geen label wilt toewijzen aan de expressie true of false, moet u een leeg label in de instructie invoegen, zoals:
IF({projectedCompletionDate}>{plannedCompletionDate},"","On Track")
of
IF({projectedCompletionDate}>{plannedCompletionDate},"Off Track","")
Voor meer informatie over de bouw van "IF"verklaringen, zie "IF"verklaringen overzicht.
Hiermee kunt u zoeken naar een specifieke waarde in een reeks mogelijke waarden. Als de waarde u zoekt één van de verstrekte waarden evenaart, dan keert de uitdrukking trueExpression terug; anders, keert het falseExpression terug.
De expressie wordt als volgt opgemaakt:
IFIN(value, value1, value2,..., trueExpression, falseExpression)
Bijvoorbeeld, kunt u een specifieke Eigenaar van het Project vinden en die projecten met een gespecificeerde markering in een projectweergave merken:
IFIN({owner}.{name},"Jennifer Campbell","Rick Kuvec","Marketing Team","Other Teams")
In de dagelijkse toespraak betekent deze verklaring: "Als de projecteigenaar Jennifer Campbell of Rick Kuvec is, merk dit project met "Marketing Team"; anders, merk het met "Andere Teams"."
Als u geen label wilt toewijzen aan de expressie true of false, moet u een leeg label in de instructie invoegen, zoals:
IFIN({owner}.{name},"Jennifer Campbell","Rick Kuvec","","Other Teams")
of
IFIN({owner}.{name},"Jennifer Campbell","Rick Kuvec","Marketing Team","")
Retourneert true als de waarde gelijk is aan een van de opgegeven waarden; anders retourneert de expressie false.
De expressie wordt als volgt opgemaakt:
IN(value, value1[, value2...])
Retourneert true als de waarde null of leeg is; anders retourneert de expressie false.
De expressie wordt als volgt opgemaakt:
ISBLANK(value)
Retourneert een opgegeven aantal tekens vanaf de linkerzijde van een tekenreeks en wordt als volgt opgemaakt:
LEFT(string, length)
Retourneert de lengte van een tekenreeks en is als volgt opgemaakt:
LEN(string)
Retourneert de tekenreeks in kleine letters en is als volgt opgemaakt:
LOWER(string)
Vervangt alle instanties van string2 door string3 in string1.
De expressie wordt als volgt opgemaakt:
REPLACE(string1, string2, string3)
Retourneert een opgegeven aantal tekens vanaf de rechterzijde van een tekenreeks en wordt als volgt opgemaakt:
RIGHT(string, length)
Retourneert de index van de eerste instantie van findText in de tekenreeks binnenText, te beginnen bij de opgegeven startpositie, of -1 als de tekst niet wordt gevonden.
De expressie wordt als volgt opgemaakt:
SEARCH(findText, withinText, start)
Zet een getal om in een tekenreeks en is als volgt opgemaakt:
STRING(number)
Hiermee wordt een lijst met tekenreeksen oplopend gesorteerd. De lijst is als volgt opgemaakt:
SORTASCSTRING(string1, string2, ...)
Sorteert een lijst van koorden in dalende orde en is geformatteerd als volgt:
SORTDESCSTRING(string1, string2, ...)
Retourneert tekens van een tekenreeks op basis van de opgegeven begin- en eindindex en is als volgt opgemaakt:
SUBSTR({string}, number of start position, number of end position)
Verwijdert witruimte aan het begin en einde van een tekenreeks en wordt als volgt opgemaakt:
TRIM(string)
Retourneert een tekenreeks in hoofdletters en is als volgt opgemaakt:
UPPER(string)