📄 SFL / Bewerken

SFL / Bewerken

Laatst bijgewerkt: 18-11-2026

De Spreash Formal Language (SFL) is de taal waarmee je in Spreash® precies vastlegt wat er voor je gegevens hoort te gelden en hoe een waarde wordt berekend. Op deze pagina leer je het bewerken van SFL.

In dit artikel van de kennisbank leer je: 

  1. Hoe je een SFL-verwachting schrijft en wijzigt.

  2. Hoe je een verwachting voor een deel van de records schrijft.

  3. Hoe je records aan elkaar koppelt in een verwachting.

  4. Hoe je een transformatie schrijft.

  5. Hoe je naar velden verwijst.

  6. Hoe je waarden, vergelijkingen en lege waarden schrifjt.

  7. Hoe je de editor en zijn suggesties gebruik.

  8. Hoe je meldingen in de editor oplost.

💡

SFL is geen module en komt als functionaliteit op meerdere plekken terug in Spreash®

Kernconcepten 

Voordat je aan de slag gaat, is het handig om de volgende type objecten te kennen. 

  • SFL-verwachting — SFL die bij een werkafspraak staat en zegt wat er voor elk record hoort te kloppen.
  • Transformatie — SFL die bij een veld van een semantisch model staat en zegt hoe de waarde van dat veld wordt berekend.
  • Veldverwijzing — de manier waarop je in SFL naar een veld wijst. Elke veldverwijzing begint met #.
  • Omschrijving — het tekstveld naast de SFL, geschreven voor mensen. Dit veld accepteert alles.
  • Editor — het invoerveld waarin je SFL-schrijft. Werkafspraken en transformaties gebruiken dezelfde editor.
  • Suggestielijst — de lijst die je cursor volgt en alleen toont wat er op die plek kan volgen.
  • Context — legt de standaardwaarden van een werkafspraak vast, zodat je kortere veldverwijzingen kunt schrijven.
  • Sleutelveld — bepaalt waar één rij van een tabel in semantisch model voor staat.
  • Record — één rij gegevens in een bron, bijvoorbeeld één factuur.

Video walkthrough

 [Link video volgt.]

Een SFL-verwachting bewerken 

Een sfl - verwachting schrijven

Volg de onderstaande stappen om een SFL-verwachting bij een nieuwe werkafspraak te schrijven.

  1. Ga naar Werkafspraken via de linker navigatiebalk.
  2. Klik bovenaan de pagina op Bewerken.
  3. Open de afspraakgroep en de context waar de werkafspraak bij hoort.
  4. Klik op Werkafspraak toevoegen (onder de tabel van de context). Er verschijnt een nieuwe rij.
  5. Geef de werkafspraak een naam in de kolom Werkafspraak.
  6. Beschrijf de werkafspraak in je eigen woorden in de kolom Omschrijving.
  7. Schrijf de verwachting in de kolom SFL-verwachting. Typ # om een veld te kiezen.
  8. Los onderstreepte problemen op. Beweeg de muis over een onderstreping om te zien wat er mis is.
  9. Klik op de opslagknop in de kop van de tabel (Alle wijzigingen opslaan)
EXPECT #TechnicalField:Sales.Invoice.total > 0

Dit zegt dat het veld total van elke factuur in de bron Sales groter is dan nul.

  • EXPECT — opent een uitspraak die moet kloppen.
  • #TechnicalField:Sales.Invoice.total — verwijst naar een veld.
  • >0 — de vergelijking die moet kloppen.

Een SFL-verwachting wijzigen

Volg de onderstaande stappen om een bestaande SFL-verwachting te wijzigen van een werkafpraak.

  1. Ga naar Werkafspraken via de linker navigatiebalk.
  2. Klik bovenaan de pagina op Bewerken.
  3. Open de afspraakgroep en de context van de werkafspraak.
  4. Klik op de SFL-verwachting van de werkafspraak.
  5. Pas de SFL aan.
  6. Klik op de opslagknop in de kop van de tabel (Alle wijzigingen opslaan).

Een verwachting voor een deel van de records schrijven

Als je een verwachting wil schrijven voor een deel van de records.

  1. Typ IF en schrijf de voorwaarde.
  2. Typ THEN en een spatie. De editor zet de volgende regel ingesprongen en schrijft END eronder.
  3. Schrijf op de ingesprongen regel EXPECT en de verwachting.
  4. Typ ELSE IF of ELSE als je een extra tak nodig hebt.
  5. Klik op de opslagknop in de kop van de tabel (Alle wijzigingen opslaan).
IF #TechnicalField:Salesforce.Opportunity.stage == 'Closed Won' THEN
EXPECT NOT #TechnicalField:Exact.Invoice.number IS EMPTY
END
Dit zegt dat een gewonnen opportunity een factuurnummer moet hebben.

  •  — opent een uitspraak die moet kloppen.
  • #TechnicalField:Sales.Invoice.total — verwijst naar een veld.
  • >0 — de vergelijking die moet kloppen.

Records aan elkaar koppelen

Volg de onderstaande stappen om een verwachting te schrijven die velden van twee soorten records vergelijkt.

  1. Ga naar Werkafspraken via de linker navigatiebalk.
  2. Open de SFL-verwachting van de werkafspraak in de bewerkmodus (zie Een SFL-verwachting wijzigen).
  3. Typ FOR EACH en kies het record waar de uitspraak over gaat.
  4. Typ MATCHED WITH ONE om elk record aan één ander record te koppelen, of MATCHED WITH EACH om het aan een verzameling records te koppelen.
  5. Kies het record dat je koppelt. De editor begint de BY-regel.
  6. Schrijf achter BY de voorwaarde die bepaalt welke records bij elkaar horen, bijvoorbeeld een vergelijking van twee sleutels.
  7. Schrijf de EXPECT op de ingesprongen regel.
  8. Klik op de opslagknop in de kop van de tabel (Alle wijzigingen opslaan).
FOR EACH #Resource:Exact.Order
MATCHED WITH EACH #Resource:Exact.Line
BY #TechnicalField:Exact.Line.order_id == #TechnicalField:Exact.Order.id
EXPECT #TechnicalField:Exact.Order.total == SUM(#TechnicalField:Exact.Line.amount)
END

Dit zegt dat het totaal van elke order gelijk is aan de som van de orderregels.

  • FOR EACH — noemt het record waar de uitspraak over gaat.
  • MATCHED WITH ONE — koppelt elk record aan één ander record. Je gebruikt de velden daarvan zoals elk ander veld.
  • MATCHED WITH EACH — koppelt elk record aan een verzameling records. Die velden gebruik je alleen in een samenvattende functie zoals SUM of COUNT.
  • BY — de voorwaarde die bepaalt welke records bij elkaar horen.

Houd bij het koppelen rekening met deze regels:

  • Je noemt elke soort record één keer per uitspraak.
  • Een BY-test gebruikt alleen het record van de eigen clausule en de records erboven.
  • Voor een derde soort record voeg je een extra MATCHED WITH-clausule toe.
  • Een FOR EACH bevat één uitspraak. Gebruik een nieuwe FOR EACH voor een volgende uitspraak.

Transformatie bewerken

Een transformatie schrijven

Volg de onderstaande stappen om de transformatie van een veld in een semantisch model te schrijven.

  1. Ga naar Semantische modellen via de linker navigatiebalk.
  2. Klik bovenaan de pagina op Bewerken.
  3. Open het semantisch model en de tabel waar het veld bij hoort.
  4. Klik op de Expressie van het veld.
  5. Schrijf de transformatie. Typ # om een technisch veld of een semantisch veld te kiezen.
  6. Los onderstreepte problemen op.
  7. Sla je wijzigingen op.
CONCAT(#TechnicalField:CRM.Contact.first_name, ' ', #TechnicalField:CRM.Contact.last_name)
Dit geeft een voornaam, een spatie en de achternaam van het contact.

Een waarde kiezen met IF

In een transformatie kiest IF een waarde in plaats van een verwachting. Schrijf de waarden na THEN en ELSE, en sluit af met END. De editor schrijft END voor je zodra je de spatie na THEN typt.

  • De eerste tak waarvan de voorwaarde klopt, kiest de waarde.
  • Elke waarde heeft hetzelfde type — NULL past bij elk type.
  • Zonder ELSE heeft een record waarvoor geen voorwaarde klopt geen waarde.

Records laten horen bij een rij

Een transformatie berekent de waarde van één veld voor één rij van de tabel. Het sleutelveld bepaalt waar die rij voor staat. Welke records bij de rij horen, leidt Spreash® af uit de actieve join-voorwaarden van je integraties. Bepalen die dat niet, dan geef je het zelf aan met WHERE.

  • Samenvatten — een samenvattende functie zoals MAX of SUM vat de records samen die bij de rij horen. Schrijf WHERE binnen de functie, bijvoorbeeld MAX(#TechnicalField:Webshop.Sales.number_sold WHERE #TechnicalField:Webshop.Sales.product_id == #TechnicalField:PIM.Product.ID).
  • Eén record lezen — leest een veld een waarde zonder samen te vatten, schrijf dan WHERE na de hele waarde, op een eigen regel.
MAX(#TechnicalField:Webshop.Sales.number_sold
WHERE #TechnicalField:Webship.Sales.product_id == #TechnicalField.PIM.Product.ID).
Een where is een samenvatting en vergelijkt alleen een waarde van de rij met een waarde van de records die worden samengevat. Een sleutelveld kan niet samenvatten. Een tabel heeft ten hoogste 16 sleutelvelden.

Naar velden verwijzen

Een veld invoegen

Volg de onderstaande stappen om een veld in je SFL op te nemen.

  1. Klik in de SFL-verwachting of de Expressie op de plek waar het veld moet komen.
  2. Typ #. De kiezer opent.
  3. Typ een deel van de naam van het veld.
  4. Kies het veld uit de lijst.

Je kunt ook de naam van het veld typen zonder #. Wijst die precies één veld aan, dan maakt de editor er een verwijzing van zodra je de spatie erachter typt. De editor voegt altijd de kortste verwijzing in die nog precies één veld aanwijst.

  • In een werkafspraak — na FOR EACH en MATCHED WITH biedt de lijst records aan. Binnen COUNT( en EXISTS( biedt de lijst records en velden aan.
  • In een transformatie — de lijst biedt technische velden en semantische velden aan, met de velden van het model dat je bewerkt bovenaan.

Een korte verwijzing schrijven

Een verwijzing mag korter zijn dan het hele pad, zolang hij precies één veld aanwijst.

  • In een werkafspraak — laat de niveaus weg die al in de standaardwaarden van de context staan. In een context met standaardbron Sales en standaard technisch object Invoice betekent #total hetzelfde als #TechnicalField:Sales.Invoice.total. Schrijf meer niveaus om minder uit de standaardwaarden te halen, bijvoorbeeld #Invoice.total. Schrijf het hele pad om de standaardwaarden te negeren.
  • In een transformatie — een transformatie heeft geen context. Een verwijzing zonder veldtype is een technisch veld, gezocht in je hele account. Een semantisch veld schrijf je altijd met SemanticField:. Voor een veld van een ander semantisch model begin je met de naam van dat model.

Waarden en voorwaarden schrijven

Een waarde schrijven

Elke waarde heeft een van vier typen.

  • Tekst — tussen enkele aanhalingstekens, bijvoorbeeld ‘Closed Won’. Schrijf \’ voor een aanhalingsteken in de tekst.
  • Getal — met een decimale punt, bijvoorbeeld 12.50, of een minteken, bijvoorbeeld -5.
  • Datum — altijd als JJJJ-MM-DD, bijvoorbeeld 2026-08-31.
  • Ja/nee — TRUE of FALSE.
  • Leeg — NULL. Dit past bij elk type.

Waarden vergelijken en combineren

Gebruik de volgende operatoren om voorwaarden te schrijven.

  • ==, != — gelijk en ongelijk. Beide kanten hebben hetzelfde type.
  • <, <=, >, >= — volgorde. Dit werkt alleen op getallen en datums.
  • CONTAINS, STARTS WITH, ENDS WITH — kijken of een tekst een deel bevat.
  • IN ( … ), NOT IN ( … ) — kijken of een waarde in een lijst staat, bijvoorbeeld IN (‘NL’, ‘BE’). De lijst bevat alleen uitgeschreven waarden.
  • AND, OR, NOT — combineren voorwaarden. NOT x IS EMPTY betekent dat x ingevuld is. IS NOT bestaat niet in SFL.
  • +, -, *, / — rekenen. Dit werkt alleen op getallen.

Lege waarden testen

SFL gaat anders met lege waarden om dan veel andere talen. Een vergelijking met een lege waarde is onwaar, ook bij != en IN en ook als beide kanten leeg zijn. Test lege waarden daarom expliciet.

  • IS NULL — de waarde ontbreekt.
  • IS BLANK — lege tekst of alleen spaties.
  • IS EMPTY — een van beide.

Rekenen en functies met een lege waarde geven een lege uitkomst. In een werkafspraak klopt een vergelijking direct na EXPECT waarbij beide kanten ontbreken. In een transformatie bestaat deze uitzondering niet.

Een waarde omzetten of vertalen

Gebruik een omzetting of MAP als een waarde een ander type of een andere vorm nodig heeft.

  • TO_NUMBER, TO_TEXT, TO_DATE, TO_BOOLEAN — zetten een waarde om naar een ander type. Kan een waarde niet worden omgezet, dan is de uitkomst leeg.
  • MAP — zet de ene waarde om in de andere, bijvoorbeeld ‘NL’ -> ‘Netherlands’. De regels worden op volgorde geprobeerd. Met DEFAULT bepaal je wat er gebeurt als niets past.

Meldingen lezen

De editor onderstreept alles wat hij niet kan accepteren. Beweeg de muis over de onderstreping om te zien wat er mis is. Elke melding begint met de plek, bijvoorbeeld Regel 2, kolom 14. Meldingen komen in vaste volgorde: eerst of de tekst leesbaar is, dan of elke verwijzing één veld aanwijst, dan of de typen kloppen, en daarna de controles voor werkafspraken of transformaties. Los je de ene soort op, dan kan de volgende verschijnen.

Veelvoorkomende situaties

  • Ik kan mijn SFL niet opslaan. 
    Spreash® slaat SFL alleen op als er geen problemen meer in zitten. Beweeg de muis over elke onderstreping, los de melding op en probeer het opnieuw.
  • Ik krijg de melding dat een woord niet bij de taal hoort. 
    Meestal is dit een typefout in een sleutelwoord of functienaam, zoals UPPPER. Het kan ook een veldnaam zonder # zijn. Gebruik de suggestielijst, of typ # en kies het veld.
  • Ik krijg de melding dat een naam meerdere velden aanwijst. 
    De verwijzing is te kort en past op meer dan één veld. De melding toont met een * welk niveau open bleef. Voeg het technische object of de bron toe die de velden onderscheidt, bijvoorbeeld #Invoice.total in plaats van #total.
  • Ik krijg de melding dat twee waarden niet te vergelijken zijn. 
    Beide kanten van == hebben een verschillend type, bijvoorbeeld tekst en getal. Zet een van beide om met TO_TEXT, TO_NUMBER of een andere omzetting.
  • Waarom klopt mijn vergelijking niet als een veld leeg is? 
    Een vergelijking met een lege waarde is onwaar. Test lege waarden expliciet met IS NULL, IS BLANK of IS EMPTY.
  • Kan ik SFL gebruiken om records te zoeken? 
    Nee. SFL is een vastlegging van wat hoort te gelden, geen zoekopdracht. Spreash® voert SFL nooit uit op je gegevens. 

Gerelateerde pagina’s

⚠️

Kom je er niet uit? Gebruik de Hulp nodig?-knop rechtsboven in Spreash® om direct een ticket in te sturen vanuit jouw Spreash®-omgeving. 

We helpen je zo snel mogelijk verder.  Laat het ons weten via het feedbackformulier onderaan de pagina. Je kunt ook aangeven wat onduidelijk was of wat je miste.