CONCORDE XAL/C5 Overbygningsmodul til XAL2LN - Intoint

0. Introduktion.................................................................................................3
Overbygnings modul.................................................................................3
0.1 Målgruppe.......................................................................................4
0.2 Komponenter..................................................................................4
0.3 Systemkrav......................................................................................5
0.4 Uddannelse .....................................................................................5
1. Programinstallation....................................................................................6
1.1 Indlæsning af filer..........................................................................6
1.2 Installation af Integrationskit.......................................................7
1.2.1 Import MAC+DBD ...............................................................7
1.2.2 Tilføj nye globale variable....................................................8
1.2.3 Importer de resterende designelementer..........................8
1.2.4 Indlæggelse i menusystem ..................................................9
2. Kom hurtigt i gang ...................................................................................11
2.1 Sammenkædning af kartoteker.................................................11
2.2 Definition af feltsammenhænge................................................15
2.3 Opdatering af Lotus Notes.........................................................17
3. Systemfaciliteter ........................................................................................19
3.1 Menu side 1...................................................................................19
3.1.1 Defined Tables .....................................................................20
3.1.2 Update ...................................................................................20
3.1.3 Edit XAL................................................................................21
3.1.4 Formulas ...............................................................................21
3.1.4.1 Init formula.......................................................................22
3.1.4.2 Pre Integration Formula.................................................22
3.1.4.3 Pre Query Formula .........................................................22
3.1.4.4 Pre Record Formula........................................................23
3.1.4.5 Post Record Formula ......................................................23
3.1.4.6 Post Integration Formula...............................................23
3.1.4.7 Exit Formula.....................................................................23
3.1.5 XAL-Selection.......................................................................23
3.1.6 Export definition..................................................................24
3.1.7 Import definition .................................................................24
3.2 Felter side 1 ...................................................................................24
3.3 Menu side 2...................................................................................27
3.3.1 Pre Field Formula................................................................27
3.3.2 Post field formula................................................................28
3.3.3 Notes Keywords ..................................................................28
3.3.4 Auto fill-in.............................................................................29
3.3.5 Delete all lines ......................................................................29
3.4 Felter side 2 ...................................................................................29
3.5 Udvekslingstyper pr. felt............................................................31
1

2
3.5.1 DB...........................................................................................31
3.5.2 LOOKUP...............................................................................31
3.5.3 NUMBER ..............................................................................32
3.5.4 STR .........................................................................................32
3.5.5 FUNCTION..........................................................................32
3.6 Tastefunktioner ............................................................................32
3.6.1 Check definition (Alt-C).....................................................32
3.6.2 Skift Side ...............................................................................33
4. Avancerede funktioner............................................................................34
4.1 Benyttelse af triggere...................................................................34
4.1.1 Variabler og lokalmacroer.................................................34
4.1.2 Afgrænsning.........................................................................35
4.1.3 Debug ....................................................................................35
4.1.4 Forbehandling af data ........................................................35
4.1.5 Efterbehandling af data......................................................36
4.1.6 Beregning af feltværdi........................................................36
4.2 Fejlsøgning via ”Edit XAL” .......................................................37
4.3 Manual Query ..............................................................................38
4.4 DocId som Notes KeyField........................................................39
4.5 Feltnavn beregning......................................................................39
4.6 Agent-afvikling ............................................................................40
4.7 Tips .................................................................................................40
4.8 Typiske fejlkilder .........................................................................40
5. Logsystem ..................................................................................................41
5.1 Overførsel via log.........................................................................41
5.1.1 Manuel overførsel ...............................................................42
5.1.2 Automatisk overførsel........................................................42
5.2 Overvågning af log......................................................................42
5.3 Sletning af logposter....................................................................44
5.4 Aktivering af logsystem .............................................................44
5.4.1 Syntax ....................................................................................44
5.4.2 Afgrænsning af log .............................................................45
Appendix 1. XAL designelementer i applikation...................................47
Appendix 2. Opbygning af XAL kørsel....................................................49

⎡ ⎤
0. Introduktion
Overbygnings modul
Denne manual beskriver de værktøjer der muliggør integration mellem
CONCORDE og Lotus Notes, uden at skulle benytte
CONCORDE’s udviklingsværktøjer.
Mange udvekslingsopgaver mellem CONCORDE og Lotus Notes
kan klares med simple definitioner. Opsætning af disse definitioner
vedligeholdes i et enkelt skærmbillede, som svarer til datamanipulation
og rapportgenerator i CONCORDE.
Værktøjet giver mulighed for, at man på under 5 minutter kan kreere
en opsætning der muliggør opdatering af en Lotus Notes database
med data fra CONCORDE.
Udvekslingen kan ske med alle poster fra CONCORDE eller kun en
delmængde, f.eks. alle debitorer i en bestemt kundegruppe.
Hvilke felter fra CONCORDE der overføres til Lotus Notes defineres
ligeledes i værktøjet, ligesom der findes en række faciliteter til at finjustere
udvekslingen.
For mere erfarne XAL-udviklere er der mulighed for at programmere
triggere, så der kan laves selv meget avancerede udvekslinger.
Desuden kan definitioner opsat i applikationen eksporteres til XALkørsler.
På denne måde kan man lynhurtigt danne fundamentet for
avancerede udvekslingskørsler, som programmeres i XAL.
Overbygningen giver ikke kun mulighed for at definere hvorledes
data skal overføres til Lotus Notes. Applikationen indeholder også en
funktion der muliggør løbende opdatering af Lotus Notes med ændringer
i data fra CONCORDE.
Har man f.eks. et lagerkartotek, der skal afspejles i Lotus Notes, som
indeholder 10.000 varenumre, er det ikke praktisk at overføre alle
disse varenumre ved en opdateringskørsel. Den eneste praktiske
mulighed for at holde en Lotus Notes database med så mange dokumenter
ajour, er ved kun at overføre de data der er ændret. Dette
håndteres af applikationens logfunktion.
3

4
0.1 Målgruppe
Hvor det grundlæggende integrationskit primært retter sig mod programmører,
er hensigten med overbygningen, at man skal kunne
udveksle med Lotus Notes, uden at skulle kunne programmere.
For at kunne få det fulde udbytte af værktøjet, skal man have en god
indsigt i datastrukturen i CONCORDE. En sådan viden erhverves
typisk på et SUPERVISOR II kursus.
Desuden skal man have et vist kendskab til Lotus Notes, gerne svarende
til AD1 (Application Designer 1).
Det skal understreges, at værktøjet er et CONCORDE værktøj. Al
definition af integration sker udelukkende i CONCORDE.
0.2 Komponenter
Som nævnt indeholder applikationen 2 hovedkomponenter:
• Opsætning af udveksling
• Log af ændringer.
Opsætning af udvekslingskørsler sker via 2 skærmbilleder – et til
opsætning af relationen mellem CONCORDE kartotek og Lotus Notes
database og et til opsætning af relationen mellem felter i
CONCORDE og Lotus Notes.
Princippet i opsætningen er, at man via opsætningsbillederne definerer
en række oplysninger, som så danner grundlag for en XAL-kørsel.
Applikationen danner altså en XAL-kørsel der afvikler selve udvekslingen
med Lotus Notes. Kørslen dannes dynamisk, så det altid er de
aktuelle parametre der benyttes.
Logsystemet, sikrer, at det kun er tilføjelser, ændringer og sletninger
der udveksles med Lotus Notes.
Logsystemet registrerer hvilke poster i CONCORDE der ændres (nye,
ændringer og sletninger). Logsystemet registrerer ikke nøjagtig hvilke
felter der berøres og hvilke værdier felterne indeholder, kun hvilke
poster der berøres.

⎡ ⎤
Fra opsætningsdefinitionen hentes oplysninger om, hvilke data der
skal udveksles.
Logsystemet aktiveres pr. kartotek der ønskes opdateret løbende i
Lotus Notes.
Tilgang til både opsætningsskærmbilleder og logsystem sker via en
speciel menu.
0.3 Systemkrav
For at kunne benytte overbygningen til Integrationskittet mellem
CONCORDE og Lotus Notes, skal Integrationskittet være installeret
på PC’en.
Det er nok at én PC er opsat med integrationskittet. Denne PC kan så
fungere som ”gateway” mellem CONCORDE og Lotus Notes. PC’en
vil her være sat op som batchserver – enten via batchmodulet til
CONCORDE eller via timer-kørsler.
Via logsystemet, som logger ændringer på alle arbejdspladser, centraliseres
udvekslingen på denne måde til én PC.
0.4 Uddannelse
Som nævnt tidligere, vil en forudgående uddannelse på et Supervisor-kursus
II være en fordel.
Da brugen af overbygningsmodulet til integrationskittet er relativ
enkel, vil der normalt ikke være behov for et større kursusforløb.
Normalt vil en gennemgang af systemet, udformet som en workshop,
hvor en eller flere udvekslingsdefinitioner opsættes være tilstrækkelig.
5

6
1. Programinstallation
Overbygningen til Integrationskittet består udelukkende af standard
XAL designelementer. Håndtering af disse sker derfor med standardværktøjer
i CONCORDE.
I Appendix 1 er alle designelementer listet.
Overbygningen findes både til engelsk og dansk bund i
CONCORDE. I denne manual er der taget udgangspunkt i versionen
til dansk bund. Versionen til den engelske bund er identisk funktionsmæssigt.
Alle skærmbilleder og anden brugerdialog er engelsk i begge versioner.
OBS: Indlæsning af applikationen skal ske i den tegnbaserede
version af CONCORDE!
Efterfølgende benyttelse af værktøjerne kan ske i både GUI og
tegnbaserede versioner.
1.1 Indlæsning af filer
Inden indlæsning af filer til CONCORDE, skal der oprettes et bibliotek
til filerne. Dette bibliotek (directory) kaldes ”INTKIT”.
Biblioteket oprettes på følgende måde:
1. Start CONCORDE som normalt
2. Hop til operativsystemet (/Generelt /Tilpasning/Hop til operativsystem)
3. Skriv ”MD INTKIT”
4. Alle filer fra disketten kopieres herefter til det nye bibliotek med
kommandoen: ”COPY A:*.* INTKIT”
5. Returnér til CONCORDE med kommandoen ”EXIT”

⎡ ⎤
1.2 Installation af
Integrationskit
Indlæsning af XAL applikationselementerne følger stort set standardmetoden,
med brug af MULTI import.
1.2.1 Import MAC+DBD
• Vælg udviklingsmenuen via /Generelt/Tilpasning/Udviklingsmenu.
• Vælg /Multi/Import
• Indtast ”intkit\import.def” som importdefinition som vist nedenfor:
7

8
Tast F3 og fravælg alle designelementer undtagen Macro og Database,
som vist nedenfor:
• Igangsæt indlæsning med F3.
1.2.2 Tilføj nye globale variable
Efter indlæsning af 4 nye kartoteker og 4 macroer, skal macroen
”GlobaleVariableUsr” tilrettes, så nye globale variable får virkefelt,
inden yderligere tilretninger indlæses.
• Vælg /Mac/Ret og udpeg øverste version af ”Globale-
VariableUsr” (der er muligvis kun én version).
• Tilføj følgende linie i bunden af macroen ”#NotesVar”.
• Gem og forlad macroen ved at taste F3
• Herefter skal system-triggeren ”Autoexec” re-compileres.
• Vælg /SXL/Oversæt. Udpeg ”Autoexec” og tast ENTER.
• Afslut CONCORDE og start programmet op igen. Herefter er de
nye globale variable defineret, så de resterende XALdesignelementer
kan indlæses.
1.2.3 Importer de resterende designelementer
• Vælg igen udviklingsmenuen via
• /Generelt/Tilpasning/Udviklingsmenu.
• Vælg /Multi/Import

⎡ ⎤
• Indtast ”intkit\import.def” som importdefinition som beskrevet i
afsnit 1.2.1.
• Denne gang fravælges Macro og Database, mens alle øvrige elementer
vælges med ”Ja”, som vist nedenfor:
• Indlæs filer ved at taste F3.
Herefter er alle nødvendige filer indlæst.
1.2.4 Indlæggelse i menusystem
Som det sidste punkt i installationen, skal overbygningen gøres tilgængelig
for brugerne via menusystemet.
Dette gøres via udviklingsmenuen, hvor /MNX/Ret vælges. Typisk
vil man lægge menupunktet i menuen DAT.
Udvælg hvor integrationsmenuen skal placeres og taste INSERT.
Skærmbilledet kan udfyldes som vist nedenfor (kun de to første linier
skal udfyldes som vist, resten er valgfrit):
9

10
Herefter er overbygningen klar til brug.
Ønskes logsystemet aktiveret skal der ske yderligere ændringer i
databasedefinitionerne på de kartoteker der skal integreres. Se nærmere
i afsnit Fejl! Henvisningskilde ikke fundet.

2. Kom hurtigt i gang
I dette afsnit vil der blive gennemgået et scenario, hvor der defineres
en simpel udvekslingskørsel mellem CONCORDE’s afdelingskartotek
og en Lotus Notes database.
Som Lotus Notes database benyttes den database der blev oprettet i
forbindelse med case 2 i manualen til Integrationskittet. Hvis denne
database ikke er oprettet, henvises til afsnit 2.2 i denne manual.
Dette afsnit forudsætter at Lotus Notes databasen er oprettet.
Opsætning af en udvekslingskørsel mellem CONCORDE og Lotus
Notes sker via to skærmbilleder. Et billede benyttes til opsætning af
integrationen på kartoteksniveau, mens det andet billede benyttes til
definition af hvilke felter der skal udveksles.
Alle skærmbilleder der benyttes i dette afsnit, er fra den tegnbaserede
version af CONCORDE XAL (Consol-versionen). Windowsversionen
(GUI) kan alternativt benyttes.
Det kan være en fordel at skifte til et testregnskab (f.eks. DMO) i det
efterfølgende eksempel.
2.1 Sammenkædning af
kartoteker
Vælg først det nye menupunkt med Lotus Notes integrationen, som
blev oprettet i afsnit 1.2.4.
Her vælges ”Table setup”.
Følgende skærmbillede fremkommer:
11
⎤

12
Først vælges hvilket CONCORDE kartotek der skal integreres med
Lotus Notes. Dette gøres ved enten at indtaste navnet på kartoteket
eller udpege kartoteket via Alt-H funktionen.
Vælg ”Afdeling”.
Herefter udpeges det Lotus Notes kartotek der skal integreres med.
Dette gøres ved at indtaste eller udpege navnet på Lotus Notes serveren
og Lotus Notes databasen.
Også her kan Alt-H funktionen benyttes.
Bemærk at brugerfladen ved Alt-H er windows-baseret. Hvis ikke man
umiddelbart kan se dette vindue, kan man skifte til vinduet med Alt-Tab.
Det anbefales at benytte Alt-H funktionen, idet man herved undgår
stavefejl. Nedenfor er vist et eksempel på udvælgelse af server og
database via Alt-H:

Efter at have udvalgt server og database angives hvilken form, der
skal benyttes i Lotus Notes.
Kartoteksstrukturen i Lotus Notes afviger en del fra strukturen i
CONCORDE. I Lotus Notes kan et kartotek indeholde en række forskellige
typer oplysninger, f.eks. kan både debitorer og debitorposter
ligge i samme database. Normalt benytter man dog forskellige
”forms” i Lotus Notes, til at adskille de forskellige typer information.
Derfor skal et CONCORDE kartotek linkes til både en database og en
form.
Efter udvælgelse af form, angives hvilket view man ønsker at benytte
i Lotus Notes. I den nuværende version af applikationen benyttes
denne oplysning dog ikke funktionelt, så hvilket view der vælges, er
ikke vigtigt. I forbindelse med mere avancerede søgninger (manuel
søgeopbygning), kan det være en fordel at udvælge et view, der er
afgrænset til kun at vise dokumenter i Lotus Notes databasen som er
relevante i forbindelse med udveksling til dette CONCORDE kartotek
(f.eks. hvor man i Notes har ”select” på den valgte form).
Også form og view kan udvælges med Alt-H eller indtastes manuelt.
Da Lotus Notes er case-sensitiv, er det vigtigt, ved manuel indtastning,
at indtaste navne på akkurat samme måde, som de er angivet i
Lotus Notes.
13
⎤

14
Nedenfor er vist et eksempel på oplysninger der definerer en relarion
mellem afdelingskartoteket i CONCORDE og et tilsvarende kartotek i
Lotus Notes:
Herefter skal relationen mellem CONCORDE kartoteket og Lotus
Notes kartoteket defineres.
Hertil udvælges hvilket efter hvilket index XAL skal udvælge sine
poster. Hvilket index der vælges her, har normalt ikke den store betydning.
Ved brug af triggere (se afsnit 3.1.4) kan indexvalg dog have
en vis betydning.
I denne omgang benyttes indexet kun til at bestemme i hvilken rækkefølge
de udvekslede poster vises, efterhånden som udvekslingen
skrider frem.
Her er ”NumIdx” valgt som index.
For at kunne opdatere eksisterende dokumenter i Lotus Notes, er det
nødvendigt at angive hvordan man udpeger et Lotus Notes dokument,
med udgangspunkt i en post i CONCORDE. Hertil benyttes
nøglefelter. Eksempler på typiske nøglefelter i CONCORDE er ”Kontonummer”
og ”Varenummer”.
Ved valg af nøglefelt er det vigtigt at nøglefeltet er entydigt. I visse
tilfælde er det ikke muligt at angive en entydig udpegning af en post
i CONCORDE med blot eet felt. Et eksempel herpå er ”SagAktivitet”
i CONCORDE XAL’s Time/Sags system. For at udpege en aktivitetspost
entydigt skal man kende både sagsnummer, afsnitsnummer og
aktivitetsnummer.
I overbygningen er der mulighed for angivelse af op til 5 nøglefelter.
For hvert nøglefelt i CONCORDE udpeges det modsvarende felt i
Lotus Notes.
I dette tilfælde hedder nøglefeltet i begge systemer ”Nummer”. Dette
angives både i Lotus Notes kolonnen og i XAL kolonnen.

Herefter er al nødvendig information på overordnet kartoteksniveau
angivet.
2.2 Definition af
feltsammenhænge
Efter definering af sammenhængen mellem CONCORDE kartoteket
og Lotus Notes databasen skal felterne, som indeholder den information
der skal udveksles, sættes op.
Dette gøres på skærmside 2, som vælges med PgDn
Herefter fremkommer et skærmbillede som vist nedenfor:
15
⎤

16
Alle felter der skal udveksles defineres i venstre side af skærmen.
Felterne nederst og til højre benyttes til, pr. felt, at angive detaljer om
de enkelte felter.
For hvert Lotus Notes felt, der skal opdateres og som vises i den venstre
kolonne, angives det tilsvarende felt i CONCORDE databasen.
Der er flere muligheder for at overføre andet en feltværdier, f.eks.
konstanter, beregninger eller opslag i andre kartoteker. Se herom i
afsnit 3.
Applikationen indeholder en funktion, der sammenligner feltnavne i
Lotus Notes med feltnavne i CONCORDE. Har de samme navn,
antager applikationen, at de skal udveksle data. Afdelings-databasen
i Lotus Notes har netop samme feltnavne som i CONCORDE.
Derfor vælges nu lokalmenuen (F10 eller Alt-L i GUI versionen). I
menuen vælges punktet ”Auto fill-in”.
Nu er alle linier sat op, så vi er klar til opdatering af Lotus Notes:
Som det ses af skærmbilledet, vil 3 felter i Lotus Notes, Ansvarlig,
Navn og Nummer, blive opdateret med data for afdelingsposter i
CONCORDE.
Ved at vælge funktionen ”Check Notes opsætning” (Alt-C), kan man
lave et check af, om alle de indtastede Notes-oplysninger (Servernavn,
form, view og feltnavne) er korrekt udfyldt. Dette er naturligvis
mest interessant, hvis man har udfyldt disse værdier manuelt. Ved
brug af ”Auto fill-in” og Alt-H vil oplysningerne altid være OK.

2.3 Opdatering af Lotus Notes
Så er den komplette definition færdig.
Selve opdateringskørslen sker fra skærmside-1 (brug evt. PgUp).
Gem evt. definitionen (Ctrl-F2) inden opdatering af Lotus Notes
igangsættes.
I lokalmenuen vælges ”Update”, hvorefter opdateringen af Lotus
Notes starter. Da der ikke, i dette eksempel, er lavet nogen afgrænsning
af hvilke poster fra CONCORDE der skal overføres, udveksles
data fra alle poster i afdelingskartoteket.
Under udvekslingen vises hvilken post der aktuelt udveksles. Indholdet
af den primære nøgle i CONCORDE (i dette tilfælde afdelingskoden)
vises. Rækkefølgen af poster er bestemt af det valgte
XAL-index, som i dette tilfælde er NumIdx.
Efter endt opdatering vises hvor mange dokumenter der er opdateret
i Lotus Notes, fordelt efter nye, opdaterede og slettede.
Nedenfor er vist et skærmbillede, hvor der er oprettet 6 nye dokumenter
i Lotus Notes.
Afvikles opdateringskørslen endnu en gang, vil man se at der nu er
opdateret 6 dokumenter, mens der ikke er oprettet nye.
Dette skyldes naturligvis, at data allerede er overført én gang, hvorfor
applikationen vil finde de nyoprettede dokumenter i Lotus Notes og
17
⎤

18
opdatere disse. Afvikles kørslen endnu en gang, vil der efterfølgende
stå, at der nu er opdateret 6 poster.
Kommer man i en situation, hvor applikationen ikke opdaterer
eksisterende dokumenter, men i stedet opretter nye, skyldes det
oftest en fejl i definitionen af nøglerne mellem Lotus Notes og
CONCORDE. Det er vigtigt at nøglerne til sammen kan danne en
entydig udpegning af dokumenter i Lotus Notes. Naturligvis er det
også afgørende, at de felter, der indgår i nøglen eller nøglerne, over-
f øres til Notes.
Bemærk ligeledes, at applikationen vil melde fejl, hvis opslaget i Lotus
Notes fremfinder mere end ét matchende dokument.

⎡ ⎤
3. Systemfaciliteter
I dette afsnit gennemgås de enkelte elementer i overbygningen. Alle
menupunkter og funktioner beskrives.
Overbygningen indeholder to menuer. Den ene menu benyttes på
skærmside 1, hvor funktioner der vedrører den generelle definition
og udveksling kan kaldes.
Menuen på side 2 indeholder funktioner til feltdefinitioner.
3.1 Menu side 1
Lokalmenuen (F10 eller Alt-L i GUI versionen) på første side indeholder
de overordnede funktioner til håndtering af definitionen på de
enkelte kartoteker, herunder udveksling af data.
19

20
3.1.1 Defined Tables
Via menupunktet ”Defined tables” kan man få vist en liste over alle
kartoteker hvor der er defineret en udveksling.
Ved at taste kan man skifte til den udpegede definition.
3.1.2 Update
Update igangsætter den egentlige udveksling fra CONCORDE XAL
til Lotus Notes. Alle data, evt. afgrænset via XAL-Selection (se afsnit
3.1.5), overføres fra kartoteket til Lotus Notes.
Teknisk set foregår overførslen ved, at der automatisk dannes en
XAL-kørsel der afvikles (se evt. Appendix 2). Denne XAL-kørsel
dannes dynamisk med udgangspunkt i de forskellige oplysninger
der er indtastet. Normalt vil denne XAL-kørsel kunne oversættes og
afvikles uden problemer. Men da overbygningen giver mulighed for
at man selv kan indsætte XAL-kode i funktioner og triggere (se afsnit
3.1.4) er der mulighed for, at den dannede XAL-fil kan indeholde fejl.
For at spore fejlkilder kan den generede XAL-kode editeres – se afsnit
3.1.3.
En anden fejlkilde kan være fejl i definition af elementer i Lotus Notes,
f.eks. stavefejl eller forkert brug af store/små bogstaver. Check
evt. definitioner med Alt-C. Ved generelt at bruge Alt-H minimeres
denne fejlkilde. Fejl i forbindelsen til Lotus Notes vises normalt i
Windows-dialog boxe.

⎡ ⎤
Efter opdatering af Lotus Notes databasen viser en meddelelsesbox
oplysninger om hvor mange poster der er oprettet, oprettet og evt.
slettet. Denne box lukker selv efter 5 sek. (så XAL-kørsel kan afvikles
fra XAL’s batchafvikling).
3.1.3 Edit XAL
Som beskrevet i forrige afsnit, danner de indtastede oplysninger
grundlaget for en færdig XAL-kørsel. Den genererede XAL kode kan
editeres og evt. gemmes inden opdatering af Lotus Notes. Denne
funktion bruges primært til fejlsøgning efter syntaxfejl i XAL-koden.
For en nærmere gennemgang af, hvorledes denne XAL-kode er opbygget
henvises til Appendix 2.
Inden XAL-koden vises, får man mulighed for at gemme XAL-koden
som en isoleret XAL-kørsel. Dette giver mulighed for, at man efterfølgende
kan arbejde videre på koden på ”gammeldags” vis. Metoden
kan også bruges, hvis man har brug for at debugge koden eller
hvis man ønsker at gemme flere udvekslingsopsætninger på eet kartotek.
Når man har afsluttet editering af XAL-koden kan man igangsætte
opdateringen af Lotus Notes, ved at vælge JA til at kørslen skal
igangsættes.
3.1.4 Formulas
Dette menupunkt indeholder en række undermenu punkter:
21

22
Fælles for disse funktioner er, at man her har mulighed for at kode
specialfunktioner direkte i XAL. Typisk vil man bruge disse ”triggere”
til at definere mere avanceret behandling af de data der skal overføres
til XAL.
Menupunkterne er sorteret i den rækkefølge, hvorefter XAL programstumperne
indføjes i den genererede XAL-koden.
Der skal her pointeres, at der ikke sker syntax-check ved indtastning
af XAL-kode. Den endelige syntax check sker først ved opdatering af
Notes eller editering af XAL-koden som beskrevet i ovenstående
afsnit.
3.1.4.1 Init formula
Den XAL kode der indtastes her, placeres som den første del af XALkoden.
Her defineres alle variable der evt. skal benyttes i de øvrige triggere.
Desuden er det her muligt at definere evt. macroer, som skal kaldes
fra andre triggere.
Også anden kode der ønskes udført inden forbindelsen til Lotus Notes
etableres, angives her.
3.1.4.2 Pre Integration Formula
I denne trigger defineres evt. kode der skal udføres umiddelbart inden
man påbegynder udveksling af alle poster. Her kan evt. promptboxe
med afgrænsninger o. lign. defineres.
3.1.4.3 Pre Query Formula

⎡ ⎤
Dette punkt giver mulighed for manuelt at definere, hvorledes data
til hver XAL-post skal findes i Lotus Notes. Brug af denne trigger
kræver en del kendskab til Lotus Notes kode.
Normalt benyttes denne funktion ikke og der henvises til afsnit 4.3
for en nærmere gennemgang.
3.1.4.4 Pre Record Formula
Her defineres kode som afvikles før udveksling af hver enkelt post.
Her kan man f.eks. programmere en beregning af en total via en
”SEARCH” på et relateret kartotek, f.eks. et posteringskartotek.
3.1.4.5 Post Record Formula
Kode der skal afvikles umiddelbart efter at en post er overført til Lotus
Notes lægges her. Et anvendelsesområde kan være en opdatering
af CONCORDE med oplysninger fra Lotus Notes. F.eks. kan det ofte
være en god idé at ”stemple” XAL posten med DocId fra Lotus Notes
(ligger i variable &ID). På denne måde har man en entydig reference
fra XAL posten til Lotus Notes dokumentet.
3.1.4.6 Post Integration Formula
Her kan lægges kode som skal eksekveres umiddelbart efter opdatering
af alle poster fra CONCORDE.
Det kunne f.eks. indeholde et kald til en agent i Lotus Notes der udfører
efterfølgende databehandling i Lotus Notes.
3.1.4.7 Exit Formula
Denne kode afslutter XAL-koden.
3.1.5 XAL-Selection
Ønsker man at afgrænse hvilke data der skal overføres, kan dette
indtastes via dette menupunkt.
23

24
Den indtastede kode efterstilles en SEARCH-sætning, ved generering
af XAL-kode med ”SEARCH USING
WHERE”. I ovenstående eksempel altså med koden:
SEARCH Afdeling USING NumIdx WHERE (Nummer > “Adm”) AND (Ansvarlig”NN”)
3.1.6 Export definition
Via dette menupunkt, kan man gemme sin definition i en ekstern fil.
Denne definition kan senere indlæses igen, evt. til et andet regnskab i
XAL (definition gemmes kun for det regnskab man har aktivt).
Når definitionen gemmes, skal man angive et filnavn.
3.1.7 Import definition
Dette menupunkt benyttes, når man skal indlæse oplysninger fra en
tidligere udlæst definitionsfil. Se forrige afsnit.
Bemærk at man ved indlæsning af definitionsfil overskriver den eksisterende
definition.
3.2 Felter side 1
På side 1 indtastes oplysninger om, hvorledes det enkelte
CONCORDE kartotek skal hægtes på en Lotus Notes database
Feltnavn Beskrivelse

⎡ ⎤
XAL Table Navn på det kartotek i CONCORDE som skal
udveksles med Lotus Notes.
Indtast kartoteksnavn, brug Alt-H, F4 eller brug
F7/F8 til bladring.
Til højre for feltet vises kartoteksnummeret og
ledetekst.
Notes Server Navn på Notes Server, hvor Lotus Notes database
er placeret. Brug LOCAL hvis databasen er placeret
på arbejdsstationen. Brug evt. Alt-H.
Notes Database Filnavn på database i Lotus Notes hvortil data
skal overføres. Brug evt. Alt-H til opslag.
Til højre for feltet vises databasens visningsnavn.
Notes Form Form i Lotus Notes som indeholder definition på
felter der skal overføres til. Brug evt. Alt-H
Til højre for feltet vises hvilke type formen har i
Notes (f.eks. main eller response)
Notes View View i Notes. Benyttes ikke ved standardudveksling,
men kan evt. benyttes ved kodning
på f.eks. triggere. Felt skal udfyldes. Brug evt. Alt-
H.
XAL Index Overførsel af data til Lotus Notes sker via dette
index. Valg af index kan have stor betydning på
hastigheden hvormed data overføres til Notes.
Specielt ved brug af ”XAL Selection” formel.
Notes Keyfield Angivelse af felt i Lotus Notes som skal samholdes
med korresponderende felt i CONCORDE.
Alle Notes nøglefelter skal matche med korresponderende
felt i XAL for at data opdateres.
Findes ikke dokument i Lotus Notes, hvor alle
definerede felter matcher, indsættes et nyt dokument
i Lotus Notes.
XAL Keyfield Felt i XAL, hvis indhold skal findes via Notes
nøglefelt. Se beskrivelse ovenfor.
Husk at angive at disse felter skal overføres til
Notes på skærmside 2.
I visse tilfælde kan det være nødvendigt at angive
flere nøglefelter på underkartoteker.
Ved stamkartoteker er f.eks. ”Kontonummer”
eller ”Varenummer” nok til entydig udpegning af
XAL post.
XAL Selection Visning af selektionsformel. Se afsnit 3.1.5.
25

26
Insert Angivelse af, om det er tilladt at oprette nye dokumenter
i Notes.
Nye dokumenter oprettes, hvis ikke dokument
kan findes via nøgleoplysningerne og hvis dette
felt er angivet til JA (default).
Modify Angivelse af, om det skal være muligt at overføre
data til dokumenter der allerede findes i Lotus
Notes.
Delete Angivelse af, om det skal være muligt at slette
data i Lotus Notes.
Denne funktion har kun betydning for logopdatering
(se afsnit Fejl! Henvisningskilde ikke fundet.)
Del. not updated Denne funktion sikrer, at dokumenter der kun
findes i Lotus Notes og altså ikke i CONCORDE
slettes ved en totalopdatering. Man sikrer altså, at
databaserne indeholder samme antal poster.
Denne funktion kan dog være relativ langsom,
hvis det er større datamængder der overføres.
Vær forsigtig med denne funktion, hvis man samtidig
benytter XAL-selection til afgrænsning af
hvilke data der skal overføres.
Update newer Hvis denne funktion deaktiveres (NEJ), vil opdatering
i Notes ikke ske på dokumenter, som er
ændret senere (datomæssigt) end ændringen er
sket i XAL.
Denne funktion er sjældent benyttet, da man normalt
benytter CONCORDE som ”master” – hvor
data altså primært vedligeholdes her.
Compare Ved en opdatering af Lotus Notes med integrationskittet,
vil alle udvalgte poster overføres. Dette
sker også selvom der ikke er forskel på data i
CONCORDE og Lotus Notes.
Ved at aktivere denne funktion, sammenlignes
data inden opdatering udføres. Dette kan naturligvis
tage lidt længere tid. Da læsning fra Lotus
Notes er hurtigere end skrivning, kan denne metode
dog være noget hurtigere, hvis der kun er
relativt få dokumenter i Notes der skal opdateres.
Denne funktion har desuden stor anvendelighed
på Lotus Notes databaser der benytter ”unread”

⎡ ⎤
markeringer (som det kendes fra mail-programmer).
Her angiver Lotus Notes hvilke dokumenter
der er nye eller ændrede siden man
sidst havde databasen åbnet. Hvis alle dokumenter
opdateres ukritisk, vil alle dokumenter fremstå
som ”unread”, hvorved idéen med ”unread”
markeringer er væk.
Ved at vælge ”Compare” bevares ”unread” markeringer.
Manual Query Denne funktion angiver, at man selv koder hvordan
udvælgelsen af dokumenter i Lotus Notes
skal ske. Se nærmere i afsnit 3.1.4.3 og 4.3.
Decimaltype Ved overførsel af kommatal til Lotus Notes, er det
afgørende at man angiver talformatet korrekt.
Visse Notes servere benytter komma og visse
punktum (100,00 eller 100.00). Her angiver man
hvilken decimal-seperator der skal anvendes.
Ser man, at overførsel af et tal, f.eks. 123,45 overføres
som heltal (altså til 123,00) er det sandsynligvis
begrundet i en forkert decimalseparator.
3.3 Menu side 2
På side 2 defineres detaljer omkring hvilke felter der skal udveksles
og hvordan.
Menuen på side 2 indeholder diverse funktioner der er knyttet til det
enkelte felt, samt et par generelle funktioner der berører alle felter.
3.3.1 Pre Field Formula
I visse situationer, kan man ikke, via en simpel felthenvisning eller
formel, definere hvilke data der skal overføres til et Lotus Notes felt.
Værdien der skal overføres er måske afhængig af andre felter på
posten eller også skal værdien beregnes via gennemløb af andre kartoteker.
I en sådan situation kan denne trigger benyttes. Den XAL-kode der
indtastes her udføres lige inden overførsel til feltet i Lotus Notes.
27

28
Et eksempel på brug af triggeren er vist nedenfor. Her overføres notater
fra posten til et felt i Lotus Notes. Overførselstypen er defineret
som funktion, hvor værdien der overføres til feltet ”Notat” er defineret
i variablen &S, som opbygges i Pre Field triggeren. Bemærk brugen
af Num2Char(10), som angiver linieskift i Lotus Notes.
3.3.2 Post field formula
Samme funktion som Pre Field Formula. Denne trigger udføres dog
umiddelbart efter feltet er opdateret i Lotus Notes.
Denne mulighed har ikke samme kraftfulde anvendelsesmuligheder.
3.3.3 Notes Keywords
ENUM’s i XAL lagres internt i CONCORDE som heltalsværdier –
f.eks. har ENUM-typen ”NejJa” værdierne 0 (Nej) og 1 (Ja). Ved overførsel
af ENUM’s til Lotus Notes overfører overbygningen ikke talværdierne
med derimod feltværdierne (f.eks. ”Nej” og ”Ja”).
I visse situationer er det ønskeligt at afvige fra denne metode. Det kan
f.eks. skyldes, at man overfører data til en eksisterende Lotus Notes
applikation, hvor sproget er engelsk og værdierne skal overføres
tilsvarende (”No” og ”Yes”). En anden situation kan være hvor flere
valgmuligheder i en XAL ENUM skal overføres til færre muligheder i
Lotus Notes.
Med menupunktet ”Notes Keywords” har man mulighed for at styre
hvorledes ENUM felter ”oversættes”.

⎡ ⎤
Nedenfor er vist et eksempel, hvor man overfører oplysninger om
kontoplantypen fra finanskartoteket til en engelsk Notes applikation,
som ikke indeholder så mange typer af konti.
3.3.4 Auto fill-in
Denne lille funktion kan benyttes som opstart af definition af felter
der skal udveksles. Funktionen gennemløber alle felter i Lotus Notes
databasen og undersøger, om der findes et felt med samme navn i
CONCORDE. Felter, som på denne måde matcher, udvælges så automatisk
til udveksling. Øvrige felter skal manuelt defineres.
3.3.5 Delete all lines
Ønsker man at nulstille sin feltdefinitioner på et kartotek kan denne
funktion kaldes. Herved slettes alle definitionslinier.
3.4 Felter side 2
På side 1 defineredes den generelle sammenhæng mellem
CONCORDE kartoteket og Lotus Notes databasen.
På side 2 indtastes en linie for hvert felt der skal opdateres i Lotus
Notes. Bemærk at et felt der skal opdateres i Notes ikke nødvendigvis
skal modsvares af et tilsvarende felt i CONCORDE.
Eks.:
29

30
Feltnavn Beskrivelse
Notes Field Name Navn på felt i Lotus Notes der skal overføres data
til. Husk at feltnavn er case-sensitiv. Benyt evt.
Alt-H.
Int Type Angivelse af hvordan data beregnes. Se nedenfor
i afsnit 3.5.
XAL Fieldname Navn på felt i XAL der skal overføres til Lotus
Notes (DB) eller nøgle ved opslag i andet kartotek
(LOOKUP).
Type Angivelse af felttype i CONCORDE
Exc Angivelse af, om dette felt indgår i udvekslingen
til Lotus Notes.
V Angivelse af, om feltnavn i Lotus Notes beregnes
som ”Value” i Pre-field trigger.
Se nærmere i afsnit 4.5.
< Markering af, at der findes en pre-field trigger
> Markering af, at der findes en post-field trigger
String Angivelse af enten fast tekstværdi til felt (STR)
eller angivelse af XAL-funktion (FUNCTION)
Lookup file Angivelse af, i hvilket kartotek afledt feltværdi
skal findes (LOOKUP).
Lookup Index Angivelse af index der skal benyttes ved opslag
efter feltværdi i andet kartotek. Nøgleværdi er
angivet i feltet ”XAL Fieldname”.
Lookup field Felt i andet kartotek, som indeholder den ønskede
værdi.
Decimals Antal decimaler der skal benyttes ved talværdi.

⎡ ⎤
Number Konstant talværdi der skal overføres (NUMBER)
Case Evt. formatering af tekstværdier, f.eks. konvertering
til små eller store bogstaver. CapsFirst angiver
at første bogstav i hvert ord er ”stort”.
3.5 Udvekslingstyper pr. felt
Der findes 5 forskellige måder at angive hvordan data til Lotus Notes
beregnes.
3.5.1 DB
Dette er den basale metode. Her angiver man et felt i CONCORDE
der skal overøres til et tilsvarende felt i Lotus Notes. Overbygningen
konverterer automatisk til rette datatype i Lotus Notes.
3.5.2 LOOKUP
I visse situationer har man brug for at hente enkelte feltoplysninger i
et andet kartotek end det man udveksler aktuelt. Et eksempel herpå
er opslag efter medarbejders fulde navn på basis af medarbejderens
initialer. Her udfyldes Lookup felterne med opslagskartotek, index
og feltnavn i andet kartotek der indeholder værdien. Den nøgle som
bruges er feltet i XAL fieldname.
Nedenfor er vist et eksempel på udfyldelse af Lotus Notes feltet AnsvarligNavn
via opslag i medarbejderkartotek:
31

32
3.5.3 NUMBER
Ved denne type overføres en fast talværdi til Lotus Notes for hver
eneste post. Feltværdien indtastes i feltet ”Number”
3.5.4 STR
Denne type har samme funktion som beskrevet ovenfor. Dog er det
her en fast tekstværdi der overføres. Tekstværdien skal ikke omkranses
af anførselstegn.
3.5.5 FUNCTION
Denne udvekslingstype er den mest fleksible. Metoden kan benyttes
til alle de øvrige typers funktioner. Værdien i feltet ”String” overføres
til Lotus Notes.
Angiver man et feltnavn i feltet overføres værdien af dette felt. Angives
et tal eller en tekst (begge skal omkranses af anførselstegn) overføres
en fast tal eller tekstværdi.
Men det primære anvendelsesområde er dog muligheden for at indtaste
XAL-funktioner. Et par eksempler på funktioner er angivet her:
• PostNummer >= ”6000” ? ”Jylland” : ”Øerne”
• ””+Navn+””
• Date2Str(Today(),123,2,3,2,3,4)
• &S
I sidste linie overføres værdien af variablen &S, som kunne være
beregnet via XAL-kode i Pre Field triggeren.
3.6 Tastefunktioner
Overbygningen indeholder enkelte funktionstaster, som kan anvendes
på både skærmside 1 og 2.
3.6.1 Check definition (Alt-C)
Med Alt-C kan man bede overbygningen om at verificere, at alle
Notes designelementer findes i Lotus Notes. Funktionen er specielt
relevant efter manuel indtastning af f.eks. feltnavne eller efter indlæsning
af definitionsfil (se afsnit 3.1.7).

⎡ ⎤
Funktionen stopper ved første fejl og angiver hvilket designelement,
der ikke kan findes i Lotus Notes. Efter rettelse af evt. første fejl, skal
Alt-C kaldes igen for at finde evt. næste fejl.
Når alle felter, form og view er fundet i Lotus Notes får man beskeden
”Opsætning OK”.
3.6.2 Skift Side
Normalt benyttes Alt-F7 og Alt-F8 for at skifte mellem skærmside 1
og 2 i CONCORDE.
For at lave brugerfladen mere intuitiv benyttes i overbygningen
PgDn og PgUp. Brug derfor ikke Alt-F7 og Alt-F8.
33

34
4. Avancerede funktioner
I dette afsnit beskrives forskellige måde at opbygge mere avancerede
udvekslinger med Lotus Notes. For at få det fulde udbytte af dette
afsnit, kræves et rimeligt kendskab til kodning i XAL og evt. kendskab
til integrationskittets programmeringsmæssige muligheder.
Visse af funktionerne kræver desuden et større kendskab til Lotus
Notes.
4.1 Benyttelse af triggere
Normalt vil man kunne udføre de fleste integrationsopgaver uden at
skulle programmere. Men der kan opstå situationer, hvor parameteropsætning
ikke er nok. Ved at benytte funktioner ved udveksling kan
man udføre lidt mere avancerede opgaver.
Til endnu mere komplekse kørsler kan man programmere XAL-kode
i triggere.
Som eksempler på områder hvor dette kan være nødvendigt kan
nævnes:
• Opslag i andre kartoteker, som involverer flere poster. F.eks.
sammentælling af transaktioner.
• Opsætning af integration med flere forms eller databaser i Lotus
Notes.
• Opdatering af data i CONCORDE.
• Benyttelse af mere avancerede integrationsfunktioner, som f.eks.
afsendelse af mail, håndtering af attachments, low-level kald til
Lotus Notes m.v.
I dette afsnit beskrives forskellige anvendelsesområder for triggere.
4.1.1 Variabler og lokalmacroer
Som nævnt i afsnit 3.1.2 sker selve udvekslingen med Lotus Notes
ved afvikling af en XAL-kørsel, der dannes dynamisk ud fra de parametre
som er indtastet.
Ønsker man at benytte variabler eller localmacroer i sin XAL-kode,
kan man ikke blot definere disse i den trigger, hvori man skal benytte

⎡ ⎤
dem. Dette skyldes, at triggerne egentligt blot er forskellige kodestumper,
der placeres forskellige steder i den endelige XAL-kørsel.
Så ønsker man at benytte egen variabler og lokalmacroer, skal disse
defineres, som den første del af koden.
Dette opnår man ved at benytte ”INIT” triggeren.
4.1.2 Afgrænsning
Normalt sker afgrænsning af, hvilke poster der overføres til Lotus
Notes, via menupunktet ”XAL-selection” (se afsnit 3.1.5).
Hvis man ønsker at afgrænsningen skal kunne bestemmes ved afviklingen
af kørslen, kan man f.eks. benytte en #Prompt kommando i
”Pre Integration Formula”. Husk at afgrænsningsvariablerne skal
defineres i ”Init” triggeren. Benyt e.v.t. afgrænsningsvariabler i
”XAL-selection” afgrænsningen.
4.1.3 Debug
Ønsker man at følge lidt bedre med i, hvad der sker under selve integrationen,
kan man aktivere debug funktionen i integrationskittet
(#NotesDebug(”1”)). Dette gøres normalt i ”Pre Integration Formula”.
Debug vinduerne vil vises indtil man enten vælger ”Cancel” eller
programmet møder funktionen #NotesDebug(”0”).
Glemmer man at kalde denne kommando, f.eks. i ”Post Integration
Formula”, vil debug vedblive med at være aktiv.
4.1.4 Forbehandling af data
Skal der ske indledende beregninger eller søgning efter data lægges
den nødvendige kode hertil i triggerne ”Pre Integration Formula”
og/eller ”Pre Record Formula”.
XAL-kørsel i ”Pre Integration Formula” udføres kun een gang, umiddelbart
inden gennemlæsning af udvekslingskartoteket starter. Her
kan f.eks. indlægges en afgrænsnings prompt-box, som afgrænser
hvilke data der skal overføres (brug ikke prompt-boxe, hvis logopdatering
er aktiveret).
Skal XAL-kørslen afvikles for hver post der overføres, lægges XALkoden
i ”Pre Record Formula”.
35

36
Her lægges typisk også mere avancerede Notes-funktioner, som opdaterer
Notes-dokumenter på en måde, der ikke håndteres af den
normale feltopdatering. Dette kan f.eks. være benyttelse af funktionen
#NotesPutFieldValue, som gemmer data i et felt, som ikke er
defineret på Notes’ formdesign.
4.1.5 Efterbehandling af data
Ønsker man at opdatere data i CONCORDE med data fra Lotus Notes,
anbringes koden hertil i ”Post Record Formula”. En typisk anvendelse
af dette, er opdatering af XAL-post med DocId fra Lotus
Notes dokumentet.
Et eksempel herpå:
SET LagerKart.NotesDocID = #NotesDocId
UPDATE Lagerkart
4.1.6 Beregning af feltværdi
En meget stærk funktion ved overbygningsmodulet er muligheden
for at få beregnet en Notes feltværdi via en XAL-kørsel.
Dette gøres via ”Pre Field Formula” på feltniveau (se afsnit 3.3.1)
Nedenfor er angivet et eksempel på en lille kørsel, der overfører Notatoplysninger
fra CONCORDE til feltet ”Note” i Lotus Notes
SET &S = ””
SEARCH Notat USING NotatIdx
WHERE Notat.NotatFileId == LagerKart.FileId
AND Notat.NotatRecId == LagerKart.RecId
SET &S = &S+Notat.Tekst+Num2Char(10) {Linieskift i Notes}
END
Bemærk, at for at benytte denne funktion, skal IntType være angivet
til ”Function” (se afsnit 3.5.5) og værdien af feltet skal angives med
den beregnede variabels navn (&S i dette tilfælde).
Husk at data der overføres til Lotus Notes skal konverteres til en
streng. Benyttes således en numerisk variabel, skal man benytte
Num2Str.
Her et andet eksempel, der overfører en saldo for alle debitortransaktioner
inden for den sidste måned:
SET &Saldo = 0

⎡ ⎤
SEARCH DebPost USING KtoDatoIdx
WHERE DebPost.KontoNummer == DebKart.KontoNummer
AND DebPost.Dato >= &SystemDato - 30
#ADD(&Saldo,BeløbDkr)
END
Her vil man skulle angive Num2Str(&Saldo,0,2,1) som feltværdi.
4.2 Fejlsøgning via ”Edit XAL”
Idet der er mulighed for, via triggere, at angive stumper af XAL-kode
mange steder i integrationsdefinitionen, kan det være svært at overskue
hvor eventuelle fejl er placeret.
Integrationsmetoden er, som beskrevet i 3.1.2, baseret på, at der dynamisk
dannes en XAL-kørsel der efterfølgende afvikles. Denne
XAL-kørsel sammenstykkes af følgende elementer:
• Grundlæggende standardkode defineret i overbygningen selv
• Indhold i selektion (se afsnit 3.1.5)
• XAL-kode fra triggere (fra skærmside 1 og 2)
• Indhold i feltværdi felt, herunder specielt funktioner
Da indhold i selektion, triggere og funktioner ikke syntaxcheckes ved
indtastning, kan der opstå situationer, hvor opdateringskørslen ikke
kan afvikles.
Ved at vælge ”Edit XAL” (afsnit 3.1.3) kan man få vist den samlede
kode. Ved at taste F3 syntaxcheckes den samlede kode (opbygningen
er beskrevet i Appendix 2)
Typisk vil fejl opstå i macroen #Update. For at finde den nøjagtige
placering af en fejl i denne makro kan man benytte følgende metode:
• Lav en blokmarkering (Alt-A) af indholdet mellem #Local-
Macro.Update og #EndMacro (eksklusiv disse to macrodefinitions
linier) og kopiér teksten (Shift-F5)
• Gå til kald af #Update nederst i koden
• Indsæt tom linie inden denne linie
• Placer cursor på denne tomme linie
• Indsæt den kopierede tekst (Alt-I)
• Genoversæt koden (F3)
• Cursoren vil nu stille sig på linien som indeholder fejlen.
37

38
4.3 Manual Query
Ved opdatering af data i Lotus Notes, via Update funktionen (afsnit
3.1.2), vil overbygningsmodulet søge efter et Lotus Notes dokument,
der matcher CONCORDE dokumentet. Dette gøres via nøglefelterne
(Notes KeyField og XAL Keyfield).
Dette resulterer typisk i en kode, der kan se ud nogenlunde som i
dette eksempel:
SET &S2 = NotesKart.NotesKeyField + ’=”’ + VareNummer + ’”’
#NotesQueryUnique(&S2)
Hvis nøglefeltet i Notes hed f.eks. ”ItemId” og vi er kommet til varen
”1.44” ville kaldet altså svare til:
#NotesQueryUnique(’ ItemId = ”1.44” ’).
Hvis der er flere nøglefelter adskilles de enkelte felter med ”&”.
F.eks. resulterende i:
#NotesQueryUnique(’Sag=”100” & Afsnit =”10” & Aktivitet=”3” ’)
Se e.v.t. selv, via ”Edit XAL” og evt. debug funktion (afsnit 4.1.3),
hvorledes søgefelterne indgår i søgningen.
Men der kan være situationer, hvor denne søgemetode ikke er fyldestgørende.
F.eks. kan der være situationer, hvor et søgefelt i Lotus
Notes ikke er unikt. Normalt vil dette medføre en fejl, da #NotesQueryUniqe
vil returnere en fejl, hvis der findes mere end eet dokument i
søgningen.
Med ”Manual Query” funktionen kan man opbygge sit eget opslag
efter data i Lotus Notes.
I ”Pre Query” kunne man f.eks. kalde den specielle funktion
#NotesQueryUnique(”ANY@@@… (f.eks. #NotesQueryUnique(’ANY@’+
NotesKart.NotesKeyField + ’=”’ + VareNummer + ’”’)
Der er visse regler for hvorledes ”Pre Query” skal returnere resultatet
af søgningen. Dette gøres ved at returnere resultatet af søgning i variablen
&NotesText. Denne skal sættes til en af følgende værdier:
”0”: Dokument ikke fundet i Notes (medfører oprettelse af nyt)
”3”: Fejl (medfører fejlmelding)
DocId: DocId på det fundne dokument

⎡ ⎤
4.4 DocId som Notes KeyField
I Lotus Notes har hvert dokument en entydig nøgle – her kaldet
DocId. Denne nøgle svarer stort set til RecID i XAL.
Ofte vil man vælge at benytte denne nøgle som nøglefelt ved
sammenkædning med CONCORDE. Dette kræver naturligvis at hver
post, der er overført fra CONCORDE, har stemplet dette DocId ind i
et felt (se eksempel afsnit 4.1.5).
Problemet med DocId er blot, at dette ikke er et traditionelt felt som
man kan henvise til på normal vis.
Systemet er derfor opbygget således, at hvis man indtaster ”DocId”
som NotesKeyValue, benyttes en speciel opdatering, der søger efter
det DocId som er angivet i XAL-feltet specificeret i ”XAL KeyField”.
4.5 Feltnavn beregning
I visse situationer kan feltnavnet i Lotus Notes, hvortil data skal overføres,
variere efter hvilke data man har på hånden.
Dette ses typisk i situationer, hvor flere felter i Lotus Notes kan indeholde
samme slags oplysning som eet felt i CONCORDE XAL. F.eks.
kan et felt ”Varenummer” optræde 10 gange på en form. Felterne vil
så f.eks. være navngivet ”Vnr1”, ”Vnr2” op til Vnr10. På denne måde
kan 10 ”linier” vises i Lotus Notes på een form.
Ved afvikling af opdateringskørslen i dette eksempel, skal der beregnes
hvilket af felterne der skal tilgås. Hertil benyttes feltnavnberegning.
Her beregnes navnet på det felt, hvortil data skal overføres, i ”Pre
Field Formula”. I det her nævnte eksempel, hvor data skal overføres
fra ordrelinier til Lotus Domino (max 10 linier), kunne ”Pre Field
Formula” koden se sådan ud:
#Add(&Counter,1)
SET &Vnr = "Vnr"+Num2Str(&Counter,0,0,0,0)
Variablerne &Vnr og &Counter er defineret i ”Init Formula”. Variablen
&Counter nulstilles i ”Pre Record Formula” hver gang en ny post
fra en anden ordre fremkommer.
På definitionen for varenummer feltet angives &Vnr som ”Notes
Field Name”.
39

40
4.6 Agent-afvikling
Ønsker man at efterbehandle data i Lotus Notes kan man anbringe et
kald af en Lotus Notes Agent i triggeren ”Post Integration Formula”.
Dette kan være nyttigt, hvis data i Notes skal flyttes til forskellige
views, alt efter dokumentindhold.
Benyt her funktionen #NotesRunAgent.
4.7 Tips
4.8 Typiske fejlkilder
• Dokumenter oprettes i stedet for at blive opdateret. Dette skyldes
typisk, at en eller flere af de felter der indgår i nøgler, ikke er
indeholdt i feltdefinitionerne på skærmside 2.
• Syntaxfejl ved afvikling af opdateringskørsel. Skyldes fejl i brugerindtastet
XAL-kode eller funktioner (se afsnit 4.2). En typisk
fejlkilde er manglende konvertering til strengværdi – benyt
Num2Str.
• EN anden kilde til syntaxfejl kan være manglende definition af
variabler. Benyt ”Init Formula” til definition.
• Data overføres ikke. Check opsætning af ”Insert”, ”Modify” og
”Delete” til højre på skærmside 2.

⎡ ⎤
5. Logsystem
I en driftssituation er det ønskeligt at kunne overføre data fra
CONCORDE til Lotus Notes efter behov. Typisk ønsker man kun at
ajourføre Lotus Notes databasen. Ofte tillader datamængden, der skal
overføres, ikke at man overfører alle data jævnligt.
Overbygningsmodulet indeholder derfor et logmodul, der registrerer
hvilke poster der oprettes, ændres eller slettes. Denne ændringslog
indeholder en liste over hvilke transaktioner, der skal ajourføres i
Lotus Notes.
Ændringsloggen indeholder kun oplysninger om hvilken post der
skal ajourføres – ikke hvilke data der er ændret.
Ved opdatering via ændringsloggen overføres alle oplysninger, defineret
i overbygningsmodulet, fra posten, ikke kun de ændrede oplysninger.
Læg mærke til, at oplysninger om hvilke felter der skal
ajourføres i Lotus Notes, aflæses fra kartoteksdefinitionen. Denne
aflæsning af definitionen sker på overførselstidspunktet.
5.1 Overførsel via log
Typisk har man initialiseret Lotus Notes databaserne med en total
opdateringskørsel (afsnit 3.1.2). Herefter er det kun nødvendigt at
overføre via ændringsloggen.
Overførsel af data, via ændringsloggen kan ske manuelt eller automatisk
via CONCORDE’s batchafviklingssystem eller Timerfunktion.
41

42
5.1.1 Manuel overførsel
Ønsker man at overføre alle ændringer siden sidste overførsel, kan
man vælge ”Update from logfile”.
Ved overførslen markeres de logposter der overføres, så data kun
overføres een gang. Ved næste afvikling af kørslen vil de oplysninger
man har overført tidligere altså ikke blive overført igen (med mindre
der er blevet modificeret siden sidste kørsel.).
5.1.2 Automatisk overførsel
Log-opdateringskørslen er forberedt for afvikling i CONCORDE’s
batchafviklingssystem. Man kan her definere, at log-opdatering skal
ske automatisk f.eks. hvert 15. minut. For en nærmere beskrivelse af
batchfunktionen henvises til brugerdokumentationen til CONCOR-
DE. Husk at integrationskittet skal være installeret på batch-PC’en.
Ønskes opdateringen foretaget hyppigere kan man indlægge afvikling
af logopdateringen i timer-funktionen i CONCORDE. Nedenfor
er vist et eksempel, der bevirker en opdatering hvert 30. sekund:
5.2 Overvågning af log
Med menupunktet ”Show LogFile” kan man se en liste med alle de
logposter, der er registreret. Posterne er sorteret således, at de ikke-

⎡ ⎤
opdaterede poster vises først. Herunder vises posterne i kronologisk
orden pr. kartotek.
Her et eksempel på denne oversigt:
Oversigten indeholder følgende felter:
Overskrift Indhold
Overf Er denne ændring overført til Lotus Notes?
Dato Dato for transaktion i CONCORDE
Tid XAL-tidspunkt (sekunder siden midnat)
User UserId på bruger i XAL som har foretaget rettelsen
DBF FileId i CONCORDE XAL
DBRecID Unik henvisning til record i CONCORDE
NotesLog NotesLogType:
Insert: Nyoprettet post i CONCORDE
Modify: Ændret post
Delete: Slettet post
NotesKeyField Nøglefelt i Lotus Notes
NotesKeyValue Nøgleværdi i CONCORDE
I ovennævnte skærmbillede er der altså 4 poster den endnu ikke er
synkroniseret med Lotus Notes. De omfatter 2 nye poster til lagerkartoteket
(FileId = 11) og 2 sletninger i afdelingskartoteket (FileId =
66). De to nye varer har varenumrene ’12” rør” og ’0,1” Rør”, mens
de to slettede afdelinger havde numrene ”NY2” og ”NY3”.
Desuden kan man se, at der allerede er overført oplysninger om en
rettet debitoroplysningen (kontonummer ”45999300”), en sletning af
43

44
en medarbejder–post (nummer ”OWW”) og en oprettelse af medarbejder
”OOQ”.
5.3 Sletning af logposter
Ønsker man at tømme sit logkartotek enten helt eller kun for oplysninger
der allerede er overført, aktiveres menupunktet ”Clear Logfile”.
Inden sletning igangsættes skal det bekræftes at man ønsker at slette
data. Hvis dette bekræftes, kan man vælge om man vil slette alle
data, inklusiv oplysninger om poster der ikke er ajourført, eller man
blot vil slette poster med oplysninger, der er udvekslet.
Man kan ligeledes begrænse sletningen til kun at omfatter logoplysninger
om et enkelt kartotek.
5.4 Aktivering af logsystem
Definition af, hvilke kartoteker der skal logges, indlægges via formelsystemet
på XAL’s database-definition.
• Åben udviklingsmenuen (/Generelt/Tilpasning/Udvikling)
• Vælg kartotek (Dbd/Ret/Kerne – udpeg kartotek)
• Gå til ”Formler for kartoteket”
Indlæggelse af logfunktion sker normalt i følgende triggere:
• Post-delete
• Post-update
• Post-insert (OK)
Ønsker man ikke at logge f.eks. sletninger, indlægges logfunktionen
så ikke i Post-delete. Men oftest anbringes logfunktionen i alle tre
triggere.
5.4.1 Syntax
Aktivering af log er relativt simpel. Følgende kodestump skal indlægges
i den relevante trigger (typisk i bunden af XAL-koden):
#NotesLog(,,)

⎡ ⎤
angiver hvilken logfunktion der ønskes. Der opereres
med tre typer:
0: Insert – angiver at der skal oprettes et tilsvarende
dokument i Lotus Notes
1: Modify – angiver at dokument skal opdateres i Notes
2: Delete – angiver at dokument skal slettes i Notes
Typisk benyttes typen 0 i Post-insert, 1 benyttes i Post-update og 2
benyttes i Post-delete.
angiver kartoteksnavn
angiver fuldt kvalificeret navn på feltet – altså med foranstillet
kartoteksnavn, f.eks. LagerKart.VareNummer
Er der flere nøglefelter angives disse adskilt med komma.
Her et par eksempler:
#NotesLog(0, LagerKart, LagerKart.VareNummer)
#NotesLog(1,SagAfsnit,SagAfsnit.Sag,SagAfsnit.Afsnit)
#NotesLog(2,DebKart,DebKart.Kontonummer)
Ovennævnte eksempler vil medføre registrering af nye varenumre
(anbringes i Post-insert (OK)), ændringer i SagAfsnit (anbringes i
Post-update) og sletninger af debitorer (anbringes i Post-delete).
5.4.2 Afgrænsning af log
Opdatering fra logsystemet tager ikke hensyn til selektionen på kartoteksdefinitionen
(afsnit 3.1.5).
Ønsker man at afgrænse hvilke ændringer, der skal afspejles i Lotus
Notes, skal dette gøres i kartoteks formlerne. Dette gøres via standard
XAL kode.
Nedenfor er vist et eksempel, der viser hvordan man kun logger ændringer
på en vare, hvis varens pris er ændret og kun hvis varen ligger
i varegruppe ”20”. Eksemplet er fra Post-update triggeren på
LagerKart:
IF LagerKart.VareGruppe == "20" AND
LagerKart_ORIG.SalgsPris LagerKart.SalgsPris THEN
#NotesLog(1,LagerKart,LagerKart.VareNummer)
ENDIF
45

46
Fordelen ved at lægge afgrænsningen på dette sted, frem for at benytte
selektionen på kartoteksdefintionen er, at man kun logger nødvendige
oplysninger.

⎡ ⎤
Appendix 1. XAL designelementer i
applikation
Overbygningen består af følgende designelementer:
DBD — kartoteker
Filnavn XAL-navn Beskrivelse
nlog.dbd NotesLog Oplysninger om ændringer i XAL records
nkart.dbd NotesKart Definition af integration på kartoteksniveau
Skærmside 1
nfield.dnd NotesField Definition af integration på feltniveau
(skærmside 2)
nkeyw.dbd NotesKeywords Oversættelse af enums
enum.dbd NotesLogType
NotesUdvType
XALNotes
NotesCase
Diverse fasttekst typer
LST — Listbilleder
Filnavn XAL-navn Beskrivelse
fliste.lst Liste Til NotesField
fmacro.lst Macro Til NotesField
kliste.lst Liste Til NotesKeywords
log.lst Log Til NotesLog
liste.lst Liste Til NotesLog
macro.lst Macro Til NotesKart
FRM — Forms
Filnavn XAL-navn Beskrivelse
felter.frm NotesFelter Opslag efter Notes-felter (Alt-H)
forms.frm NotesForms Opslag efter Notes-forms (Alt-H)
keyw.frm NotesKeywords Oversættelse af Enums til keywords
nkart.frm NotesKart Definitions skærmbillede
ovs.frm NotesKartOversigt Oversigt over kartoteker med definition
views.frm NotesViews Opslag efter Notes-views (Alt-H)
47

48
XAL — XAL kørsler
Filnavn XAL-navn Beskrivelse
editkart.xal NotesEditKart Editering og af opdateringskørsel
ncheck.xal NotesCheck Check af forbindelse til Lotus Notes
nulstil.xal NotesNulstilLog Nulstilling af NotesLog
opdkart.xal NotesOpdaterKart Afvikling af opdateringskørsel
opdlog.xal NotesOpdaterLog Kørsel til opdatering af log
MAC — Macroer
Filnavn XAL-navn Beskrivelse
notes.mac Notes Macro med alle kommandoer til integrationskit
log.mac NotesLog Macro til logning af kartoteksændringer
opdkart.mac NotesOpdaterKart Macro der opbygger XAL-kørsel til integration
var.mac NotesVar Globale variabler til integrationskit
MNU — Menuer
Filnavn XAL-navn Beskrivelse
notes.mnu Notes Hovedmenu til overbygning
ntrigg.mnu NotesKartTriggere Menu med kartotekstriggere

⎡ ⎤
Appendix 2. Opbygning af XAL kørsel
Som angivet tidligere, danner overbygningsmodulet en XAL-kørsel
udfra de angivne parametre. I dette appendix beskrives opbygningen
af denne XAL-kørsel.
Nedenfor er vist et eksempel på en integrationskørsel der foretager
en overførsel af data fra afdelingskartoteket I CONCORDE.
XAL-kørslen er her opbygget med linienumre.
1 #MacroLoad(NOTES)
2 #MacroLoad(TMP_FILE)
3
4 STR 255 &S
5 STR 255 &S2
6 STR 255 &ID
7 INT &Inserted
8 INT &Updated
9 INT &Deleted
10 INT &StartTid
11 INT &Action
12 INT &OK
13
14
15 #LocalMacro.Update
16 SET &S = Nummer
17 #NotesSetFieldValue('Nummer',&S)
18 SET &S = Navn
19 #NotesSetFieldValue('Navn',&S)
20 { Pre Field Code for Ansvarlig }
21 SET &S = Ansvarlig
22 #NotesSetFieldValue('Ansvarlig',&S)
23 { Post Field Code for Ansvarlig }
24
25 #EndMacro
26
27 #LocalMacro.PrepareQuery
28 SET &S2=NotesKart.NotesKeyField+'="'+Nummer+'"'
29 #EndMacro
30
31 #LocalMacro.Query
32 { Returns doc-ID in &NotesTxt, … }
33 { Pre Query Code }
34
35 #PrepareQuery
36 #NotesQueryUnique(&S2)
37 #EndMacro
38
39 #LocalMacro.Newer
40 #PrepareQuery
41 SET &S2 = &S2 + ' &
@Modified>@TextToTime("'+
Date2Str(SidstRettet,123,2,3,2,3,2)+'"))'
49

50
42 #NotesQueryUnique(&S2)
43 #EndMacro
44
45
46 { Init Formula Code goes here }
47 FLUSH Afdeling
48 #NotesInit
49 INTRODUCE NotesKart[FileIDIdx,66]
50 #NotesOpenServer(NotesKart.NotesServer)
51 #NotesLogon(NotesKart.NotesDatabase)
52 #NotesForm(NotesKart.NotesForm)
53 #NotesView(NotesKart.NotesView)
54
55 IF &NotesText>'' THEN
56 RETURN 0
57 ENDIF
58
59 WINDOW 30,2 AT 8,8
60
61
62 { Pre Integration Code goes here }
63
64 SEARCH Afdeling
65 USING NumIdx
66
67 { Returns doc-ID in … }
68 { Pre Query Code }
69
70 PRINT Nummer,' ' AT 1,1
71 SET &S=NotesKart.NotesKeyField+'=\''+Nummer+'\''
72 #NotesQueryUnique(&S)
73 SET &ID = &NotesText
74 IF &ID == '0' THEN SET &Action=1 {New} ELSE
75 IF StrLen(&ID)>2 THEN SET &Action=2 {Update}ELSE
76 SET &Action = 0
77 ENDIF ENDIF
78 { Pre Record Code }
79 IF &Action == 1 THEN {Ny}
80 #NotesCreateNew
81 #Update
82 #NotesCommit
83 #ADD(&Inserted,1)
84 ENDIF
85 IF &Action == 2 THEN {Opdater}
86 SET &OK = 1
87 IF &ID=='0' THEN {Opret først}
88 #NotesCreateNew
89 SET &ID=&NotesText
90 ENDIF
91 #NotesSelectID(&ID)
92 IF &OK THEN
93 #Update
94 #NotesCommit
95 #ADD(&Updated,1)
96 ENDIF
97 ENDIF
98 { Post Record Code }
99

⎡ ⎤
100 IF &Action == 0 THEN
101 IF &NotesText == '3' THEN
102 SET BOX(1,'Error: More than one document
found in Notes',1)
103 ELSE
104 SET BOX(1,'Error '+&NotesText,1)
105 ENDIF
106 ENDIF
107 END
108 #NotesClose
109
110 { Post Integration Code goes here }
111
112 WINDOW 40,6 AT 15,15
113 PRINT 'Inserted..: ',&Inserted AT 1,2
114 PRINT 'Updated...: ',&Updated AT 1,3
115 PRINT 'Deleted...: ',&Deleted AT 1,4
116 SET &StartTid = TimeNow()
117 WHILE (TimeNow()>=&StartTid) AND
(TimeNow()-&StartTid

52
Macroloads (1-2)
1 #MacroLoad(NOTES)
2 #MacroLoad(TMP_FILE)
Først indlæses macrobibliotekerne Notes og TMP_FILE.
Notes biblioteket indeholde alle de grundlæggende programmeringskommandoer
i integrationskittet.
TMP_FILE loades for at muliggøre brugen af visse integrationskit
kommandoer. Denne linie vil som regel kunne slettes.
Variabler (4-13)
4 STR 255 &S
5 STR 255 &S2
6 STR 255 &ID
7 INT &Inserted
8 INT &Updated
9 INT &Deleted
10 INT &StartTid
11 INT &Action
12 INT &OK
Her defineres de variabler der benyttes til en standarddefinition.
&S er en generel strengvariabel der benyttes ved kald af #NotesPut-
FieldValue. &S2 benyttes som ekstra strengvariabel ved forskellige
kombinationer ( ”Update newer” og ”Compare”).
&ID indeholder DocId på det Notes dokument der skal opdateres.
&Inserted, &Updated og &Deleted benyttes til at optælle antallet af
de respektive opdateringstyper.
&Starttid benyttes ved nedtælling i slutningen af koden.
&Action indeholder typen af opdateringen:
• 1 => Opret nyt dokument
• 2 => Opdater eksisterende dokument
• 0 => Fejl
&OK benyttes til at bestemme om et dokument må opdateres i Lotus
Notes.
Opdatering (15-25)
15 #LocalMacro.Update
16 SET &S = Nummer

⎡ ⎤
17 #NotesSetFieldValue('Nummer',&S)
18 SET &S = Navn
19 #NotesSetFieldValue('Navn',&S)
20 { Pre Field Code for Ansvarlig }
21 SET &S = Ansvarlig
22 #NotesSetFieldValue('Ansvarlig',&S)
23 { Post Field Code for Ansvarlig }
24
25 #EndMacro
Lokalmacroen ”Update” indeholder selve overførslen af data. Denne
macro opbygges via feltdefinitionerne på skærmside 2.
Læg mærke til placeringen af ”Pre Field formula” og ”Post Field
Formula” – i dette tilfælde uden egentlig kode, defineret for feltet
”Ansvarlig”.
Query (27-37)
27 #LocalMacro.PrepareQuery
28 SET &S2=NotesKart.NotesKeyField+'="'+Nummer+'"'
29 #EndMacro
30
31 #LocalMacro.Query
32 { Returns doc-ID in &NotesTxt, … }
33 { Pre Query Code }
34
35 #PrepareQuery
36 #NotesQueryUnique(&S2)
37 #EndMacro
Ved brug af log-opdatering sker opslag i Lotus Notes efter dokument
der matcher CONCORDE dokument via lokalmakroen #Query. Her
indsættes også e.v.t. brugerdefineret kode i ”Pre Query Formula”
Specialfunktioner (39-43)
39 #LocalMacro.Newer
40 #PrepareQuery
41 SET &S2 = &S2 + ' &
@Modified>@TextToTime("'+
Date2Str(SidstRettet,123,2,3,2,3,2)+'"))'
42 #NotesQueryUnique(&S2)
43 #EndMacro
Valg af visse funktioner på skærmside 1 , f.eks. ”Update newer” og
”Compare”, kan medføre diverse ekstra kode. I dette tilfælde er det
koden til check af om data i Notes dokumentet er nyere end data i
CONCORDE
53

54
Initialisering (46-62)
46 { Init Formula Code goes here }
47 FLUSH Afdeling
48 #NotesInit
49 INTRODUCE NotesKart[FileIDIdx,66]
50 #NotesOpenServer(NotesKart.NotesServer)
51 #NotesLogon(NotesKart.NotesDatabase)
52 #NotesForm(NotesKart.NotesForm)
53 #NotesView(NotesKart.NotesView)
54
55 IF &NotesText>'' THEN
56 RETURN 0
57 ENDIF
58
59 WINDOW 30,2 AT 8,8
60
61
62 { Pre Integration Code goes here }
I denne sektion, som indleder den egentlige kode, etableres forbindelsen
til Lotus Notes.
Gennemløb og opslag (64-78)
64 SEARCH Afdeling
65 USING NumIdx
66
67 { Returns doc-ID in … }
68 { Pre Query Code }
69
70 PRINT Nummer,' ' AT 1,1
71 SET &S=NotesKart.NotesKeyField+'=\''+Nummer+'\''
72 #NotesQueryUnique(&S)
73 SET &ID = &NotesText
74 IF &ID == '0' THEN SET &Action=1 {New} ELSE
75 IF StrLen(&ID)>2 THEN SET &Action=2 {Update}ELSE
76 SET &Action = 0
77 ENDIF ENDIF
78 { Pre Record Code }
Efter initialisering gennemløbes alle selekterede records i
CONCORDE. I dette tilfælde er der ikke angivet nogen selektionsformel.
Denne ville have været placeret umiddelbart efter linie 65.
I linie 71 og 72 laves et opslag i Lotus Notes efter et matchende dokument.
Returkoden fra dette opslag overføres til variablen &ID. Er
returkoden ”0” betyder det, at dokumentet ikke findes i Lotus Notes.

⎡ ⎤
&Action sættes derfor til 1, som betyder at et nyt dokument skal oprettes.
Hvis et dokument er fundet indeholder &ID DocId på dette dokument.
Et DocId i Lotus Notes er altid mere end 2 tegn langt. Derfor
testes på, om returkoden er større end 2. Er dette tilfældet er dokumentet
fundet og det skal opdateres (&Action = 2). Alle andre returkoder
opfattes som indikation af en fejlsituation.
Læg mærke til placering af e.v.t. ”Pre Integration Formula” kode og
”Pre Record Formula” kode.
Opret nyt dokument (79-84)
79 IF &Action == 1 THEN {Ny}
80 #NotesCreateNew
81 #Update
82 #NotesCommit
83 #ADD(&Inserted,1)
84 ENDIF
Hvis &action er sat til 1, skal der oprettes et nyt dokument i Lotus
Notes.
Dette gøres i linie 80 og i linie 81 overføres data fra de udvalgte felter.
Herefter gemmes oplysninger med #NotesCommit.
Opret nyt dokument (85-97)
85 IF &Action == 2 THEN {Opdater}
86 SET &OK = 1
87 IF &ID=='0' THEN {Opret først}
88 #NotesCreateNew
89 SET &ID=&NotesText
90 ENDIF
91 #NotesSelectID(&ID)
92 IF &OK THEN
93 #Update
94 #NotesCommit
95 #ADD(&Updated,1)
96 ENDIF
97 ENDIF
Denne kode opdaterer et eksisterende dokument. Koden er forberedt
for de diverse kombinationer de forskellige opdateringsvalg kan
medføre. Derfor kan koden se lidt omstændelig ud i dette eksempel.
Her er det linierne 91 til 94 der foretager den egentlige opdatering.
55

56
Slutning af løkke og fejlhåndtering
(98-107)
98 { Post Record Code }
99
100 IF &Action == 0 THEN
101 IF &NotesText == '3' THEN
102 SET BOX(1,'Error: More than one document
found in Notes',1)
103 ELSE
104 SET BOX(1,'Error '+&NotesText,1)
105 ENDIF
106 ENDIF
107 END
Efter oprettelse eller opdatering kaldes e.v.t. ”Post Record Formula”
kode.
E.v.t. fejl ved opslag vises i en fejl-box.
Afslutning (108-120)
108 #NotesClose
109
110 { Post Integration Code goes here }
111
112 WINDOW 40,6 AT 15,15
113 PRINT 'Inserted..: ',&Inserted AT 1,2
114 PRINT 'Updated...: ',&Updated AT 1,3
115 PRINT 'Deleted...: ',&Deleted AT 1,4
116 SET &StartTid = TimeNow()
118 WHILE (TimeNow()>=&StartTid) AND
(TimeNow()-&StartTid