Fulfilment handleiding

De Mergetool is een krachtige tool waarmee allerhande fulfilment acties of andere nabewerkingsacties kunnen worden geautomatiseerd. Mogelijkheden van de tool zijn het automatisch e-mailen, brieven maken, wijzigingen doorvoeren in de database, communiceren met externe bronnen (webservices & API’s).

De Mergetool is eenvoudig in gebruik, maar vergt wel enige kennis voor het inrichten van de juiste acties. Vereiste voorkennis voor succesvol gebruik zijn:

Inhoud

Het configuratiebestand

Loops en Actions

Loops

Actions

Systeemvelden

De fulfilmentservice kent een aantal systeemvelden die beschikbaar zijn in de collectie SYS, ENVIRONMENT en VARIABLE. Onder SYS staan enkele systeemvelden, en ENVIRONMENT bevat alle environment variabelen op de server. Onder VARIABLE worden gebruiker instellingen vastgelegd uit de config sectie variables. Onderstaande is een voorbeeld van de standaard inhoud.

SYS	VERSION	5.03
SYS	VERSIONMAJOR	5
SYS	VERSIONMINOR	0
SYS	VERSIONPATCH	3
SYS	VENDOR	Calway Nederland b.v.
SYS	VENDORURL	https://www.calway.nl
SYS	DATETIME	08-12-2020 15:31:45
SYS	DATE	08-12-2020
SYS	TIME	15:31:45
SYS	FILLER
ENVIRONMENT	COMMANDLINE	Mergetool -Eval
ENVIRONMENT	CURRENTDIRECTORY	C:\data\app\mergetool
ENVIRONMENT	MACHINENAME	JOHAN
ENVIRONMENT	OSVERSION	Microsoft Windows NT 6.2.9200.0
ENVIRONMENT	USERDOMAINNAME	AzureAD
ENVIRONMENT	USERNAME	JohanBennink
ENVIRONMENT	DOTNETVERSION	4.0.30319.42000
ENVIRONMENT	INTERACTIVE	True

Format opties

Bij ieder veld kunnen format specifiers worden meegegeven die bepalen hoe de uiteindelijke waarde opgebouwd/weergegeven gaat worden. Er kunnen 0 of meer format specifiers bij 1 veld worden meegegeven. Bijvoorbeeld:

%SCRIPT.CONTRACTDATE \DTddMMyyyy \ALC#12%

Geeft als de huidige datum 01-04-2005 is als resultaat:

##01042005##

</table>

Code	Betekenis
DT	Specificeer een datum/tijd formaat. Er kan gebruik worden gemaakt van de volgende combinaties (volledige lijst op docs.microsoft.com: dddd, MMMM dd yyyy :Thursday, August 17 2015 ddd, MMM d "'"yy :Thu, Aug 17 '15 dddd, MMMM dd :Thursday, August 17 M/yy :8/15 dd-MM-yy :17-08-15 ddMMyyyy :17082015 dd-MM-yyyy HH:mm : 17-08-2015 09:15
AL	Alignment van de tekst. [L\|C\|M\|R] L=links uitlijnen C of M=centreren R=rechts uitlijnen Character is het uitlijn tekens. Bijvoorbeeld een spatie ‘ ‘ Width is de lengte van het veld. \ALR 10 geeft een rechts uitgelijn veld van 10 posities waarbij het uitlijnteken een spatie is. </td> </tr>
CC	Hoofdletter/kleineletter conversie 0\|1\|2\|3 0=De eerste letter wordt een hoofdletter, de rest klein. 1=Iedere eerste letter (na spatie of -) wordt een hoofdletter. 2=Alles hoofdletters 3=Alles kleine letters 4=Initialen, resultaat is een lijst met letters en punten.
SW	Switch commando (ook wel case of decode genoemd) Kommagescheiden lijst. Werkt als volgt: "a","1","b","2","c","3" Als de veldwaarde a is wordt een 1 weergegeven Als de veldwaarde b is wordt een 2 weergegeven Als de veldwaarde c is wordt een 3 weergegeven Binnen de " " mogen ook weer velden worden gebruikt. Als de veldwaarde niet voorkomt wordt er niets vervangen.
SD	Switch commando, gelijk aan SW maar nu is de laatste optie een default waarde. Kommagescheiden lijst. Werkt als volgt: "a","1","b","2","c","3","","-1" Als de veldwaarde a is wordt een 1 weergegeven Als de veldwaarde b is wordt een 2 weergegeven Als de veldwaarde c is wordt een 3 weergegeven Als geen enkele waarde matcht, dan wordt de laatste waarde -1 weergegeven. De match waarde moet hiervoor "" zijn. Binnen de " " mogen ook weer velden worden gebruikt. Als de veldwaarde niet voorkomt wordt er niets vervangen.
TF	Formateer het telefoonnummer. Gebruik: F - Netnummer – abonneenummer (050-5275525) N - alleen netnummer (050) A - alleen abonnenummer (5275525) Dit herkent alleen Nederlandse en Belgische netnummers.
TR	Spaties links en/of rechts worden verwijderd. L\|R\|A L - verwijder spaties voor de tekst R - verwijder spaties na de tekst A – L en R (default)
QS	Quote save. Vervangt enkele quotes door dubbele. Het quote karakter moet mee worden gegeven als parameter Bijvoorbeeld: \QS’
LS	Linesave Vervang alle CR en LF door een spatie.
IF	If then else constructie \IF “condition"?"then-value":"else-value" Condition, then-value en else-value mogen zowel constante teksten zijn, als velden. Bijvoorbeeld: %R.COUNTRY% \IF "NL"?"%R.ZIP R.CITY%":"%R.CITY R.ZIP%"
CO	Zelfde als de IF, maar dan met een “bevat" vergelijking i.p.v. gelijk-aan
SU	Substring constructie Hello world \SU6,5 haalt een substring op beginnend op positie 2 (zero based!) met lengte 4. Dus dit levert world op
RE	Replace commando Vervang een zoektekst voor een vervangtekst, bijvoorbeeld: %CL.ENTRYNOTE \RE"\r\n","< BR/ >" Vervangt alle [CR][LF] door < BR />
FL	Floatingpoint format function \FL "" Format is een C# format specifier voor floating points zoals beschreven op docs.microsoft.com: f2: 2 decimalen 12.34 f1: 1 decimaal 12.3 p2: 2 decimale percentage 12.34 % c2: 2 decimale bedragen € 12.34 </td> </tr>
FS	Filename safe. Vervangt illegale karakters in de filename door een _ zodat de filenaam geldig is.
PS	Filename+path safe. Vervangt illegale karakters door een _ in een volledig file+path naam.
CU	Change the current culture (restore afterwards to original culture). \CU"nl-NL" or \CU"fr-FR"
UL	URL Encode the input string
XX	Encrypt de waarde m.b.v. de actieve cryptokey