CONCORDE XAL/C5 Overbygningsmodul til XAL2LN - Intoint

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