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

    Ga voor meer informatie over het maken van berekende aangepaste velden op aangepaste formulieren in Workfront naar Berekende gegevens toevoegen aan een aangepast formulier.

  • Een berekende aangepaste kolom in een rapport of lijst wanneer u de tekstmodus gebruikt

    Ga voor meer informatie over het gebruik van de tekstmodus in rapporten en weergaven naar Overzicht van de tekstmodus.

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:

Berekend aangepast veld
Berekend aangepast rapporteringselement
Veldnamen tussen accolades plaatsen

Veldnamen tussen haakjes of haakjes plaatsen wanneer u ze in een

valuefield

lijn.

Veldnamen tussen accolades plaatsen wanneer ze worden gebruikt in een

valueexpression

lijn.

De velden scheiden met punten

De velden scheiden met dubbele punten wanneer u ze in een

valuefield

line

De velden van elkaar scheiden op punten wanneer u ze in een

valueexpression

lijn.

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 tekstmodus.

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. U moet echter de juiste syntaxis gebruiken voor een berekende aangepaste kolom, zoals beschreven in de sectie Syntaxis van berekende aangepaste velden versus berekende aangepaste kolommen in dit artikel.

Berekende datum en tijd, aangepaste velden date-time-calculated-custom-fields

NOTE
Als u een datum- en tijdberekening maakt die geen tijdgedeelte bevat of die de jokertekens $$TODAY of $$NOW gebruikt, gebruikt het systeem de datum volgens de UTC-zone (Coordinated Universal Time), niet volgens uw lokale tijdzone. Dit kan tot een onverwacht datumresultaat leiden.

U kunt een datum- of tijdberekend aangepast veld maken met de volgende expressies:

Uitdrukking
Uitleg en voorbeeld
ADDDAYS

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)

ADDWEEKDAYS

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)

ADDMONTHS

Hiermee voegt u het aantal maanden toe aan de datum. De notatie is als volgt:

ADDMONTHS(date, number)

ADDYEARS

Hiermee voegt u het aantal jaren toe aan de datum. De notatie is als volgt:

ADDYEARS(date, number)

CLEARTIME

Wist het tijdgedeelte van een datum en is als volgt opgemaakt. In dit voorbeeld is de datum de ingangsdatum voor een werkobject.

CLEARTIME({entryDate})

DATE

Converteert een tekenreeks naar een datum en is als volgt opgemaakt:

DATE(string)

DATEDIFF

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)

DAYOFMONTH

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})

DAYOFWEEK

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})

DAYSINMONTH

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})

DAYSINSPLITWEEK

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})

DAYSINYEAR

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})

DMAX

Retourneert de laatste datum in de lijst en is als volgt opgemaakt:

DMAX(date1, date2, ...)

DMIN

Retourneert de vroegste datum in de lijst en is als volgt opgemaakt:

DMIN(date1, date2, ...)

UUR

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})

MINUUT

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})

MAAND

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})

TWEEDE

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})

WEEKDAYDIFF

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)

WORKMINUTESDIFF

Retourneert het aantal geplande minuten tussen de datums volgens het standaardschema.

De expressie wordt als volgt opgemaakt:

WORKMINUTESDIFF(date1, date2)

JAAR

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:

Uitdrukking
Toelichting
ABS

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})

GEMIDDELD

Retourneert het gemiddelde van getallen en is als volgt opgemaakt:

AVERAGE(number1, number2, ...)

CEIL

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})

DIV

Verdeelt alle getallen in de opgegeven volgorde en is als volgt opgemaakt:

DIV(number1, number2, ...)

FLOOR

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})

LN

Retourneert de natuurlijke logaritmewaarde van het getal en wordt als volgt opgemaakt:

LN({numberOfChildren})

LOG

Retourneert de logaritmewaarde van number2 naar het basissenummer1 en is als volgt opgemaakt:

LOG(number1, number2)

MAX

Retourneert het grootste item in de lijst en is als volgt opgemaakt:

MAX(item1, item2, ...)

MIN

Retourneert het kleinste item in de lijst en is als volgt opgemaakt:

MIN(item1, item2, ...)

NUMMER

Zet een tekenreeks om in een getal en is als volgt opgemaakt:

NUMBER(string)

POWER

Retourneert een getal dat tot een macht is verheven en dat als volgt is opgemaakt:

POWER(number, power)

PROD

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.

ROND

Rondt het getal af tot de opgegeven decimalen met de nauwkeurigheid en wordt als volgt opgemaakt:

ROUND(number, precision)

SORTASCNUM

De getallen worden in oplopende volgorde gesorteerd en worden als volgt opgemaakt:

SORTASCNUM(number1,number2, ...)

SORTDESCNUM

De getallen worden in aflopende volgorde gesorteerd en worden als volgt opgemaakt:

SORTDESCNUM(number1, number2, ...)

SQRT

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})

SUB

Trekt alle aantallen in de verstrekte orde af en is geformatteerd als volgt:

SUB(number1, number2, ...)

SUM

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:

Uitdrukking
Toelichting
CASE

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.

CONCREET

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"
BEVATTEN

Retourneert true als de findText-tekenreeks is gevonden binnen de withinText-tekenreeks en als volgt is opgemaakt:

CONTAINS(findText, withinText)

ENCODEURL

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)

IF

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 het samenstellen van "IF"verklaringen, zie Overzicht van "IF"-instructies.

IFIN

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","")

IN

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...])

ISBLANK

Retourneert true als de waarde null of leeg is; anders retourneert de expressie false.

De expressie wordt als volgt opgemaakt:

ISBLANK(value)

LINKS

Retourneert een opgegeven aantal tekens vanaf de linkerzijde van een tekenreeks en wordt als volgt opgemaakt:

LEFT(string, length)

LEN

Retourneert de lengte van een tekenreeks en is als volgt opgemaakt:

LEN(string)

LAGER

Retourneert de tekenreeks in kleine letters en is als volgt opgemaakt:

LOWER(string)

VERVANGEN

Vervangt alle instanties van string2 door string3 in string1.

De expressie wordt als volgt opgemaakt:

REPLACE(string1, string2, string3)

RECHTS

Retourneert een opgegeven aantal tekens vanaf de rechterzijde van een tekenreeks en wordt als volgt opgemaakt:

RIGHT(string, length)

ZOEKEN

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)

TEKENREEKS

Zet een getal om in een tekenreeks en is als volgt opgemaakt:

STRING(number)

SORTASCSTRING

Hiermee wordt een lijst met tekenreeksen oplopend gesorteerd. De lijst is als volgt opgemaakt:

SORTASCSTRING(string1, string2, ...)

SORTDESCSTRING

Sorteert een lijst van koorden in dalende orde en is geformatteerd als volgt:

SORTDESCSTRING(string1, string2, ...)

SUBSTR

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)

TRIM

Verwijdert witruimte aan het begin en einde van een tekenreeks en wordt als volgt opgemaakt:

TRIM(string)

BOVEN

Retourneert een tekenreeks in hoofdletters en is als volgt opgemaakt:

UPPER(string)

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