SFL / Bekijken
Laatst bijgewerkt: 09-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 SFL lezen.
In dit artikel van de kennisbank leer je:
Waar je SFL tegenkomt en welke twee soorten er zijn
Hoe je een veldverwijzing, een waarde en een vergelijking leest
Hoe je een IF-uitspraak en een transformatie leest
Hoe SFL omgaat met lege waarden
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 #.
- Record — één rij gegevens in een bron, bijvoorbeeld één factuur.
- Omschrijving — het tekstveld naast de SFL, geschreven voor mensen. Dit veld accepteert alles.
Video walkthrough
[Link video volgt.]
Wat is SFL en waar zie je het?
SFL is een vastlegging, geen zoekopdracht. Spreash® ziet je gegevens niet en voert SFL dus nooit uit op records. Een SFL-verwachting zegt wat er waar hoort te zijn van de gegevens in je systemen. Een transformatie zegt hoe een waarde daaruit wordt berekend. Spreash® controleert alleen of de SFL klopt als zin: elk onderdeel moet leesbaar zijn, elk genoemd veld moet bestaan en elke waarde moet bij het juiste type passen.
Je komt SFL op twee plekken tegen:
- Verwachting — in een werkafspraak, in de kolom SFL-verwachting. Een verwachting begint met EXPECT.
- Transformatie — in een veld van een semantisch model, in de kolom Expressie. Een transformatie heeft geen sleutelwoord ervoor.
Een verwachting zegt wat er voor elk record moet kloppen:
EXPECT #TechnicalField:Sales.Invoice.total > 0
Dit zegt dat het veld total van elke factuur in de bron Sales groter is dan nul.
Een transformatie is één waarde:
CONCAT(#TechnicalField:CRM.Contact.first_name, ' ', #TechnicalField:CRM.Contact.last_name)
Dit geeft de voornaam, een spatie en de achternaam van het contact.
Sleutelwoorden en functienamen zijn niet hoofdlettergevoelig. De editor zet ze in hoofdletters zodra je het woord afmaakt.
Hoe lees je een veldverwijzing?
Een veldverwijzing begint met # en volgt een pad door de hiërarchie.
- Technisch veld — #TechnicalField:Bron.TechnischObject.Veld. Je gebruikt dit in werkafspraken en transformaties.
- Functioneel veld — #FunctionalField:Bron.Module.Navigatie.Veld. Je gebruikt dit in werkafspraken.
- Semantisch veld — #SemanticField:SemantischModel.Tabel.Veld. Je gebruikt dit in transformaties.
Een verwijzing kan korter zijn dan het hele pad. In een werkafspraak kan de context een standaardbron en een standaard technisch object vastleggen, en dan mag je die niveaus weglaten. Je ziet dan bijvoorbeeld #total in plaats van #TechnicalField:Sales.Invoice.total. Een verwijzing wijst altijd precies één veld aan.
Staan er spaties of bijzondere tekens in een naam, dan staat de verwijzing tussen blokhaken, bijvoorbeeld #[TechnicalField:Sales Ledger.Invoice.total]. Een punt in een naam staat als . in de verwijzing.
Welke typen en waarden kent SFL?
Elke waarde heeft een van vier typen: getal, tekst, datum of ja/nee.
- Tekst — staat tussen enkele aanhalingstekens, bijvoorbeeld ‘Closed Won’.
- Getal — heeft een decimale punt, bijvoorbeeld 12.50, of een minteken, bijvoorbeeld -5.
- Datum — staat altijd als JJJJ-MM-DD, bijvoorbeeld 2026-08-31.
- Ja/nee — TRUE of FALSE.
- Leeg — NULL. Dit past bij elk type.
Zie je TO_NUMBER, TO_TEXT, TO_DATE of TO_BOOLEAN, dan wordt een waarde omgezet naar een ander type. Kan een waarde niet worden omgezet, dan is de uitkomst leeg.
Welke operatoren en functies kom je tegen?
Operatoren:
- ==, != — 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’).
- AND, OR, NOT — combineren voorwaarden. Elke kant is waar of onwaar. NOT x IS EMPTY betekent dat x ingevuld is. IS NOT bestaat niet in SFL.
- +, -, *, / — rekenen. Dit werkt alleen op getallen.
Functies:
- Tekst — CONCAT, UPPER, LOWER, TRIM en LENGTH.
- Datums — TODAY(), NOW(), DATE_DIFF, DATE_ADD en DATE_SUBTRACT.
- Getallen — GREATEST en LEAST.
- Vertalen — MAP zet de ene waarde om in de andere, bijvoorbeeld ‘NL’ -> ‘Netherlands’.
- Samenvatten — SUM, MIN, MAX, AVG, COUNT, COUNT_DISTINCT en EXISTS vatten de waarden van meerdere records samen.
Hoe lees je een IF-uitspraak?
Met IF … THEN … END beperkt een werkafspraak een verwachting tot een deel van de records.
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.
- IF … THEN — de verwachting geldt alleen voor records waarvoor de voorwaarde klopt.
- ELSE IF en ELSE — extra takken. De eerste tak waarvan de voorwaarde klopt, geldt.
- END — sluit de IF af.
Records waarvoor geen enkele tak geldt, kunnen de werkafspraak niet schenden. Staat er een ELSE, dan geldt de verwachting daarin voor alle overige records.
In een transformatie kiest IF een waarde in plaats van een verwachting:
IF #TechnicalField:Sales.Order.total > 1000 THEN 'Large' ELSE 'Small' END
Hoe lees je een transformatie?
Een transformatie berekent de waarde van één veld, voor één rij van de tabel van het semantisch model. Een transformatie kan geen EXPECT, FOR EACH, MATCHED WITH, IS ORIGINAL of IS PROCESSED IN DETERMINING bevatten.
- Sleutelveld — bepaalt waar één rij van de tabel voor staat. Een tabel met #TechnicalField:PIM.Product.ID als sleutel heeft één rij per product.
- Samenvatting — staat er MAX, SUM of een andere samenvattende functie, dan vat de transformatie de records samen die bij de rij horen.
- WHERE — geeft aan welke records bij de rij horen als de join-voorwaarden van je integraties dat niet bepalen. Een voorbeeld is MAX(#TechnicalField:Webshop.Sales.number_sold WHERE #TechnicalField:Webshop.Sales.product_id == #TechnicalField:PIM.Product.ID).
Hoe gaat SFL om met lege waarden?
Hier werkt SFL anders dan veel andere talen.
- Vergelijken — een vergelijking met een lege waarde is onwaar, ook bij != en IN. Dit geldt ook als beide kanten leeg zijn.
- Testen — lege waarden toets je met IS NULL (de waarde ontbreekt), IS BLANK (lege tekst of alleen spaties) of IS EMPTY (een van beide).
- Rekenen — rekenen en functies met een lege waarde geven een lege uitkomst.
- Uitzondering in werkafspraken — een vergelijking direct na EXPECT waarbij beide kanten ontbreken, klopt. Twee ontbrekende waarden spreken elkaar niet tegen. In een transformatie bestaat deze uitzondering niet.
Hoe lees je gekoppelde records?
Vergelijkt een werkafspraak velden van twee soorten records, dan zegt de werkafspraak met recordclausules welk record bij welk record hoort.
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.
- 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.
Veelvoorkomende situaties
- Ik kan mijn SFL niet opslaan.
Spreash® slaat SFL alleen op als er geen problemen meer in zitten. De melding begint met de plek, bijvoorbeeld Regel 2, kolom 14. Los de melding op en probeer het opnieuw. Los je de ene soort melding op, dan kan de volgende verschijnen. - 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. 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
- Werkafspraken / Bekijken — hier zie je waar de SFL-verwachting van een werkafspraak staat.
- Werkafspraken / Bewerken — hier maak en wijzig je afspraakgroepen, contexten en werkafspraken.
- SFL-handleiding — hier lees je hoe je SFL schrijft, met alle uitspraken, functies en foutmeldingen.
- Semantische modellen / Bekijken — hier zie je waar de transformatie van een veld staat.