Parameters
Parameterblok
De functies hasparameter(...) en parameter(...) maken gebruik van parameters uit een parameterblok. Een voorbeeld van een parameterblok is:
BESTAAT, AANTAL=3, LEEG=, NAAM=Test
Gebruik van de parameters
Tijdens Smartforms evaluatie zijn deze parameters als volgt te gebruiken.
| Voorbeeld | Resultaat | Type | Toelichting |
|---|---|---|---|
| hasparameter("BESTAAT") | true | Boolean | De parameter BESTAAT bestaat. |
| hasparameter("BESTAATNIET") | false | Boolean | De parameter BESTAATNIET bestaat niet. |
| hasparameter("LEEG") | true | Boolean | De parameter LEEG is leeg, maar bestaat. |
| hasparameter("NAAM") | true | Boolean | De parameter NAAM bestaat (en de waarde is "Test"). |
| parameter("BESTAAT") | "" | String | De waarde van de parameter BESTAAT is de lege string. |
| parameter("BESTAATNIET") | "" | String | Het is geen fout om de waarde van een niet bestaande parameter op te vragen. De waarde van de niet bestaande parameter BESTAATNIET is de lege string. |
| parameter("LEEG") | "" | String | De waarde van de parameter LEEG is de lege string. |
| parameter("AANTAL") | "3" | String | De waarde van de parameter AANTAL is de string "3", niet de integer 3. |
| parameter("AANTAL") + 1 | "31" | String | Dit is waarschijnlijk niet de bedoeling. Doordat de waarde een string is wordt de + een string concatenatie. |
| integer(parameter("AANTAL")) + 1 | 4 | Integer | Conversie van "3" naar 3, dan de + 1. |
| parameter("NAAM") | "Test" | String | De waarde van de parameter NAAM is de string "Test". |
| parameter("Naam") | "Test" | String | Voor het vergelijken van de parameternaam zijn verschillen tussen hoofd- en kleine letters niet van belang. |
Vulling van het parameterblok
Waar de vulling van het parameterblok vandaan komt verschilt per Smartforms toepassing.
- In de formulierenserver kan een formulier geassocieerd worden met een product. Het product bevat een parameterblok. De parameters in dat blok zijn dan beschikbaar tijdens Smartforms expressie evaluatie.
- In het Smartsite CMS kunnen formulieren gebruikt worden van het content type FormsServer Form. Een item van dit content type bevat een veld SmartformsParameters voor het parameter blok.
Formaat van het parameterblok
Voor het formaat van het parameterblok geldt:
- De opmaak van het parameterblok is niet relevant. Het blok kan leeg zijn, éénregelig of meerregelig.
- Parameters staan er kommagescheiden in.
- In naam-waarde paren is de naam van de waarde gescheiden door middel van een "=".
- Bij het ontbreken van de "=" is de waarde leeg.
- De namen in bovenstaand voorbeeld staan in hoofdletters, maar er wordt geen onderscheid gemaakt tussen hoofd- en kleine letters.