Helpcentrum

Inloggen

Plecto

Gecalculeerde Velden in Gegevensbronnen

Gecalculeerde Velden in gegevensbronnen

Voeg nieuwe kolommen toe en creëer berekeningen op basis van de data die je al hebt. Meer data-opties stellen je in staat om nauwkeurigere KPI's te visualiseren.

Gecalculeerde velden zijn alleen beschikbaar in integratie- en handmatige gegevensbronnen (niet ondersteund in SQL of API).

Deze functie voert berekeningen in realtime uit, wat kan leiden tot langzamere prestaties bij grote datasets.

Leer hoe je Gecalculeerde Velden kunt gebruiken: 👇

Tutorial: Gecalculeerde Velden →

Decimale getallen gebruiken in Gecalculeerde Velden

Als je een berekening wilt gebruiken die een decimaal getal bevat (zoals 2.6 of 30.075), gebruik dan de punt in plaats van een komma. Dit geldt voor alle localisaties.

De huidige syntaxis gebruikt komma's om argumenten te manipuleren of om het ene van het andere te scheiden. Daarom, als je een decimaal getal wilt opnemen, gebruik dan de punt.

Standaard veldwaarde in Gecalculeerde Velden

Je kunt een standaardwaarde instellen in je gecalculeerde veld voor het geval sommige rijen geen data hebben. Als je een standaardwaarde toevoegt, zal deze waarde alle lege rijen invullen en de andere rijen behouden hun oorspronkelijke waarde.

Je kunt deze functie gebruiken op een enkel veld (bijvoorbeeld om "onbekend" te tonen in de rijen zonder data) of de standaardwaarde integreren in een berekening.

Voorbeelden:

  • Field("Workspace ID","1234")

  • Field("Price") + Field("Extraordinary amount", "0")

  • Field("Lost Reason","unknown")

  • Field("End date", Now()) - retourneer de einddatum. Als de einddatum leeg is, retourneer dan de datum en tijd nu.

  • Field("Customer Success Manager", Field("CSM Team Lead")) - retourneer de namen van CSM's. Als het veld leeg is, retourneer dan de naam van de Team Lead.

Eenvoudige berekeningen met Field()

Met Field() kun je verschillende berekeningen uitvoeren met de velden die al beschikbaar zijn in je gegevensbron.

Gebruik deze syntaxis: Field("Field_1") + Field("Field_2")

Voorbeelden:

  1. Bereken de totale tijd in minuten: Field("Total time") / 60

  2. Som de waarden van twee velden: Field("Price") + Field("VAT Amount")

  3. Trek de waarden van het ene veld van het andere af: Field("Total price") - Field("Total tax")

  4. Combineer waarden van twee tekstvelden. Zie de naam van de organisatie en de landcode (voeg een lege ruimte tussenin toe om de twee te scheiden): Field("Organization name") + " " + Field("Country")

Veldnamen zijn hoofdlettergevoelig, dus als je de berekening handmatig typt, moet je de namen precies invoeren zoals ze in de gegevensbron verschijnen.

De Now() functie in Gecalculeerde Velden

Deze functie retourneert de datum en tijd nu. Je kunt het gebruiken als een onafhankelijke verklaring – Now() – of combineren met andere functies.

Gebruik deze syntaxis: Now()

Voorbeelden:

  1. Retourneer de datum en tijd op dit moment: Now()

  2. Retourneer de datum en tijd van een veld genaamd End date. Als het veld lege waarden heeft, retourneert de berekening de datum en tijd op dit moment: Field("End date", Now())

  3. Tijdverschil van startdatum tot nu (in seconden): DateDiff(Field("Started at"), Now())

  4. Bereken het tijdsverschil van Start date tot End date. Als de einddatum lege waarden bevat, retourneert het gecalculeerde veld de datum en tijd nu: DateDiff(Field("Start date"), Field("End date", Now()))

  5. Retourneer de eerste dag van de volgende maand:

    • Date(Year(Now()), Month(Now())+1, 1)

Updatefrequentie

  • Gegevensbronnen – De waarden in het gecalculeerde veld worden bijgewerkt elke keer dat je de gegevensbronpagina vernieuwt.

  • Dashboards – De gegevens op je widgets worden bijgewerkt zodra je gegevensbron wordt bijgewerkt (nieuwe of bijgewerkte registraties) of telkens wanneer je op Hernieuw op het dashboard klikt.

Datumverschil tussen twee gegevensbronvelden

De DateDiff() functie berekent het tijdsverschil tussen twee datumvelden in seconden. De volgorde waarin je de velden toevoegt is niet belangrijk, Plecto toont altijd de absolute waarde.

Gebruik deze syntaxis: DateDiff(date_1, date_2)

Voorbeelden:

  1. Datumverschil van startdatum tot nu (in seconden): DateDiff(Field("Started at"), Now())

  2. Bereken hoe lang het duurt om een deal te sluiten (in minuten): DateDiff(Field("Created date"), Field("Closed date"))/60

  3. Bereken het datumverschil van 20 april 2024 om 9:15 AM tot nu (in seconden): DateDiff(Date(2024, 4, 20, 9, 15, 00), Now())

Veldnamen zijn hoofdlettergevoelig, dus als je de berekening handmatig typt, moet je de namen precies invoeren zoals ze in de gegevensbron verschijnen.

Zet tekst om naar getallen in je gegevensbron

Gebruik deze functie als je gegevensbronveld getallen bevat maar als tekst is opgemaakt. De ToNumber() functie lost het probleem op waarbij je geen veld kunt selecteren bij het maken van een formule omdat het als tekst is opgemaakt.

Gebruik deze syntaxis: ToNumber(Field("Units"))

Voorbeelden:

  1. Zet tekstformaat om naar getalformaat in het veld Number of items: ToNumber(Field("Number of items"))

  2. Formatteer de waarden van het veld Units naar getallen. In registraties waar het niet lukt om te converteren, wordt de standaardwaarde 0 weergegeven: ToNumber(Field("Units"), 0)

Bekend probleem

Bij conversie verwijdert ToNumber() komma's: 1,000 (tekst) wordt 1000 (getal). Een punt wordt gebruikt als decimaal scheidingsteken: 1.23 (tekst) wordt 1.23 (getal).

IF() functie in Gecalculeerde Velden

Maak een IF-verklaring gecalculeerd veld en genereer voorwaardelijke waarden in je gegevensbron. De voorwaarde kan een van de beschikbare functies in gecalculeerde velden zijn. De IF() in gecalculeerde velden ondersteunt ook AND- en OR-verklaringen.

Gebruik de volgende syntaxis:

  • If(condition, if_true, if_false)

  • If(Field("Value")=100,1,0)

Voorbeelden:

  1. Retourneer numerieke waarden: If(Field("Amount")>=200,1,0)

  2. Retourneer tekstwaarden. Tekst moet tussen aanhalingstekens staan: If(Field("Amount")>=200,"Doel bereikt","Hieraan werken")

  3. Controleer op werkdagen versus weekenden: Voorbeeld 1: If(DayOfWeek(Field("date"))<=5, "Werkdag", "Weekend") Voorbeeld 2: If(DayOfWeek(Field("date"))<=5, 1, 0)

  4. True() retourneert "Ja" en False() retourneert "Nee": If(Field("Amount")>=200,True(),False())

  5. Retourneer waarden uit andere velden: If(Field("Amount")>=200,Field("Channel 1"),Field("Channel 2"))

  6. Gebruik een andere functie als de voorwaarde: Voorbeeld 1: If(DateDiff(Field("Start date"),Field("End date"))>(2*24*3600),True(),False()) Voorbeeld 2: If(DateDiff(Field("Start date"),Now())<(4*3600),"Op tijd","Vertraagd")

  7. AND (&&) verklaring: If(Field("Campaign")=="React"&&(Field("Org size")>=100,Field("AE Large"),Field("AE Default"))

  8. OR (||) verklaring: If(Field("Campaign")=="React"|| Field("Source")=="Referral",Field("AE Large"),Field("AE Default"))

  9. Geneste IF-functie: If(Field("Status")=="Closed Won",If(Field("Country")=="US",1,2),0)

  10. Zet tijdstempels om met Epoch converter en gebruik data in de verklaring: IF(Field("Start Date") >= 1677628800000 && Field("Start Date") <= 1709251199000, True(),False())

Goed om te weten:

  • Lege rijen zullen lege rijen retourneren.

  • Je kunt geen twee verschillende veldtypes zoals tekst en getal mixen voor is waar, is niet waar. Een formule zoals de volgende zal niet werken: If(Field("Amount")>=200,1,"Nee")

De Switch functie in Gecalculeerde Velden

Met Switch() specificeren we paren van voorwaarden en de geretourneerde waarden als aan die voorwaarden wordt voldaan.

De Switch functie gebruikt de volgende syntaxis:

Switch(Field("Org size") <=50, "Tom",Field("Org size") >50, "Maria","Anna")

Voorbeelden:

  1. Switch(Condition1, Result1, Condition2, Result2, Condition3, Result3). Als de waarde in het veld Weekdag 1 is, retourneer Maandag, als de waarde 2 is, retourneer Dinsdag, enz.: Switch( Field("Weekday") == 1, "Maandag", Field("Weekday") == 2, "Dinsdag", Field("Weekday") == 3, "Woensdag" )

  2. Switch(Condition1, Result1, ..., Condition5, Result5, default_value). Als de waarde in het veld Weekdag 1 is, retourneer Maandag, als de waarde 2 is, retourneer Dinsdag. Als geen van de voorwaarden wordt voldaan, retourneer alle andere dagen: Switch( Field("Weekday") == 1, "Maandag", Field("Weekday") == 2, "Dinsdag", "alle andere dagen" )

  3. Als het tijdsverschil tussen Ontvangen op en Beantwoord op minder dan of gelijk aan 20 seconden is, retourneer Snel. Als tussen 21 en 30 seconden, retourneer Iets langer. Als meer dan 31 seconden, retourneer Te lang: Switch( DateDiff(Field("Received at"),Field("Answered at")) <= 20, "Standaard", DateDiff(Field("Received at"),Field("Answered at")) <= 30, "Iets langer", "Te lang" )

  4. Vind de juiste Account Executive: Switch( Field("Organization size") >= 100 && Field("Country") == "GB", "Adam", Field("Organization size") >= 30 && Field("Country") == "CL", "Anna", "Jonathan" )

  5. Switch "FR" naar 🇫🇷 en andere landvlaggen: Switch( Field("Organization address country") == "FR", "🇫🇷", Field("Organization address country") == "DK", "🇩🇰", Field("Organization address country") == "ES", "🇪🇸", Field("Organization address country") == "US", "🇺🇸" )

Goed om te weten:

  • De volgorde is belangrijk – we retourneren de waarde van de eerste voorwaarde die wordt voldaan.

  • Met een even aantal argumenten gaan we ervan uit dat er geen standaardwaarde is. Als het aantal argumenten oneven is, beschouwen we het laatste argument als standaard.

  • De voorwaarden kunnen complexer zijn, ze hoeven niet naar één veld te verwijzen.

  • Alle vergelijkers zijn beschikbaar:

    Gelijk aan==
    Niet gelijk aan!=
    Groter dan>
    Kleiner dan<
    En&&
    Of||

  • Er is geen limiet aan het aantal argumenten dat je kunt toevoegen in de Switch functie.

  • Het opsplitsen van de formule in aparte regels is niet nodig, maar het verbetert de leesbaarheid.

  • Alle resultaten (en standaard) moeten van hetzelfde type zijn.

Zet getallen om naar tekst in je gegevensbron

Gebruik deze functie als je gegevensbronveld getallen bevat en je ze als tekst wilt opmaken.

Met de ToText() functie kun je twee tekstuitvoeren combineren in hetzelfde veld. Bijvoorbeeld, voeg de Accountnaam + Account ID in hetzelfde veld toe.

Gebruik deze syntaxis: ToText(Field("Account ID"))

Voorbeelden:

  1. Combineer Accountnaam en Account ID in één veld: Field("Account Name") + ToText(Field("Account ID"))

    Als je een spatie wilt toevoegen tussen de Accountnaam en ID, kun je een lege ruimte + " " + in de berekening toevoegen, zoals: Field("Account Name") + " " + ToText(Field("Account ID"))

  2. Formatteer veldwaarden naar tekst. In registraties waar het niet lukt om te converteren, voeg een standaardantwoord "onbekend" toe: ToText(Field("Registration number", "unknown"))

Werk met enkele datum-tijdargumenten

Je kunt individuele delen uit een datum-tijd extraheren of deze gebruiken als argumenten in een Date() functie. Jaar, Maand, Dag van de maand, Dag van de week, Dag van het jaar, Week van het jaar, Uur, Minuut, Seconde.

Voorbeelden:

  1. Retourneer het huidige jaar: Year(Now())

  2. Retourneer de maand van een veld (bijvoorbeeld, 5 voor mei): Month(Field("date"))

  3. Retourneer welke dag van de maand het nu is (bijvoorbeeld, 11 voor de 11e van de maand): DayOfMonth(Now())

  4. Retourneer welke dag het nu is (bijvoorbeeld, 2 voor dinsdag): DayOfWeek(Now())

  5. Gebruik deze functies in IF-verklaringen om te controleren op werkdagen versus weekenden:

    • If(DayOfWeek(Field("date"))<=5, "Werkdag", "Weekend")

    • If(DayOfWeek(Field("date"))<=5, 1, 0)

    • If(DayOfWeek(Field("date"))<=5, True(), False())

  6. Retourneer welke dag van het jaar de opgegeven datum is: DayOfYear(Date(2024, 5, 25)) – deze is 146 😁

  7. Retourneer de weeknummers (van 1 tot 52): WeekOfYear(Now())

  8. Retourneer het huidige uur in de tijdzone van Londen: Hour(Now(), "Europe/London")

  9. Retourneer de minuut van een datumveld: Minute(Field("date_modified"))

  10. Retourneer de huidige seconde. De getallen worden bijgewerkt bij elke pagina-verversing: Second(Now())

Als er geen tijdzone is toegevoegd, is de standaard UTC.

De Date() functie in Gecalculeerde Velden

De Date() functie retourneert een datum. Het neemt 3-7 argumenten (de eerste 3 zijn verplicht): jaar*, maand*, dag*, uur, minuut, seconde, tijdzone.

Deze functie is zeer aanpasbaar, zodat je statische getallen, andere functies en datums uit andere velden kunt combineren om aangepaste datums te retourneren, datums te vergelijken of datumverschillen te berekenen.

Gebruik deze syntaxis: Date(Year, Month, Day, Hour, Minute, Second, Time zone)

Voorbeelden:

  1. Gebruik Date() om een statische datum te retourneren. Bijvoorbeeld, Date(2024, 4, 20, 9, 15, 00) retourneert 2024-04-20 09:15:00 in het gecalculeerde veld.

  2. Voeg een tijdzone toe als het laatste argument. Als er geen tijdzone is toegevoegd, is de standaard UTC. Date(2024, 4, 20, 9, 15, 00, "Europe/Berlin")

    Als je knoppen uit de toolbox gebruikt, zal Plecto de tijdzone toevoegen die in jouw organisatie is ingesteld.

  3. Combineer Date() met andere functies en gegevensbronvelden:

    • Date(Year(Now()),Month(Now()),Day(Now()),Hour(Now()), Minute(Now()), Second(Now()), "UTC")

    • Date(Year(Field("date")), Month(Now()), 20, "UTC")

  4. Retourneer de eerste van maart volgend jaar:

    Date(Year(Now())+1, 3, 1)

  5. Bereken het datumverschil van 20 april 2024 om 9:15 AM tot nu (in seconden): DateDiff(Date(2024, 4, 20, 9, 15, 00), Now())

  6. Neem Date() op in een IF-verklaring. Als de Einddatum gelijk of kleiner is dan 10 mei 2024 om 14:00 (een statische datum), toon dan de boodschap "Klaar voor de deadline": IF(Field("End date")<=Date(2024, 5, 10, 14, 00, 00), "Klaar voor de deadline","Klaar na de deadline")

Als er geen tijdargumenten worden opgegeven (als uur, minuut, seconde worden weggelaten), zal Plecto standaard 00:00:00 gebruiken.

Tijd() functie in Gecalculeerde Velden

Deze functie retourneert het uur en de minuut van een datumveld, bijvoorbeeld: 13:45. Je kunt het gebruiken als een onafhankelijke verklaring – Time() – of combineren met andere functies.

De Tijd functie neemt maximaal twee argumenten: datum, tijdzone. Bijvoorbeeld, Time(Field("Close Date"), "Europe/Berlin")

Gebruik deze syntaxis: Time()

Voorbeelden:

  1. Retourneer het uur en de minuut van een veld Closed Time. Als er geen tijdzone is opgegeven, is de standaard UTC: Time(Field("Closed Time"),"Europe/Copenhagen")

  2. Retourneer de huidige tijd: Time(Now())

  3. Retourneer de datum en tijd van een veld genaamd End date. Als het veld lege waarden heeft, retourneert de berekening de datum en tijd nu: Time(Field("End date", Now()), "Europe/Paris")

  4. Retourneer de tijd van een widget startdatum op een dashboard: Time(StartDate(), "Europe/Copenhagen")

Bevat functie in Gecalculeerde Velden

Contains() is een hoofdlettergevoelige boolean functie die "Ja" of "Nee" retourneert in het gecalculeerde veld.

Gebruik deze syntaxis: Contains(Field("field_name"), "contains_keyword")

Voorbeelden:

  1. Controleer of het veld Campagnenaam een woord "prepare" bevat. Het gecalculeerde veld retourneert ofwel "Ja" of "Nee." Contains(Field("Campaign Name"), "prepare")

  2. Controleer of de lid UUID-string (veld genaamd Registratie Medewerker) "85e" bevat: Contains(Field("member_uuid"), "85e")

Werknemer & Team functies in Gecalculeerde Velden

Upgrade je gegevensbronnen met de Employee() en Team() functies! Neem werknemers of teams op in de vergelijking en kanaliseer je data op basis van wie de registratie bezit!

Gebruik deze syntaxis:

  • Employee("Pierre Dubois")

  • Team("Sales France")

Voorbeelden:

  1. Als het veld Primair Contact gelijk is aan de naam "Pierre Dubois," retourneer dan "Pipeline A." In alle andere gevallen, retourneer "Pipeline B." IF(Field("Primary Contact")==Employee("Pierre Dubois"),"Pipeline A","Pipeline B")

  2. Als de team UUID gelijk is aan het team genaamd "Marketing," retourneer dan 100. Anders, retourneer 0. If(Field("team_uuid") == Team("Marketing"), 100, 0)

Timedelta() – Verplaats een datumveld

Voeg de Timedelta() parameter toe aan datumvelden en voeg of trek seconden af van een datum.

Gebruik deze syntaxis: Timedelta()

Voorbeelden:

  1. Voeg 3600 seconden (1 uur) toe aan de huidige datum en tijd: Now() + Timedelta(3600)

  2. Trek 86400 seconden (24 uur) af van de aangemaakte datum: Field("Date created") - Timedelta(86400)