Grundlæggende integrationskit (API) (hent) - Intoint

ERP2LN
XAL – Lotus Notes Integration
Version 1.0.1
05-09-2003

0. Introduktion.........................................................................................5
0.1 XAL til Notes integrationskit....................................................5
0.2 Målgruppe ...............................................................................6
0.3 Komponenter ..........................................................................6
0.3.1 XAL macrobiblioteket "NOTES" .....................................6
0.3.2 Windows programbiblioteket ERP2LN.DLL...................7
0.4 Systemkrav .............................................................................7
0.4.1 Lotus Notes .....................................................................7
0.4.2 CONCORDE ...................................................................7
0.4.3 Arbejdsplads....................................................................8
0.5 Uddannelse.............................................................................8
1. Programinstallation.............................................................................9
1.1 Klargøring af arbejdsplads .....................................................9
1.1.1 Installation og opsætning af Lotus Notes klient .............9
1.2 Filer..........................................................................................9
1.3 Installation af Integrationskit ...................................................9
1.4 Registrér serienummer...........................................................9
1.5 Installation af XAL macrobibliotek ........................................10
1.6 Globale variable ....................................................................10
2. Kom hurtigt i gang ............................................................................12
2.1 Case: Opdatering - Afdeling.................................................12
2.1.1 Oprettelse af afdelingskartotek i Lotus Notes..............12
2.1.2 XAL-kode.......................................................................13
2.1.3 Initialisering....................................................................13
2.1.4 SEARCH løkke..............................................................14
2.1.5 Opdatere eller oprette?.................................................14
2.1.6 Angivelse af indhold i dokument...................................14
2.1.7 Afslutning.......................................................................14
3. Anvendelse af integrationskit...........................................................15
3.1 Kald af XAL-macroer ............................................................15
3.2 Forbindelse til Lotus Notes...................................................15
3.2.1 Initialisering af forbindelse til DLL-fil .............................16
3.2.2 Oprettelse af session til Lotus Notes............................16
3.2.2.1 Valg af Notes server..............................................16
3.2.2.2 Valg af Notes database.........................................16
3.2.2.3 Valg af Notes applikationselementer....................17
3.2.3 Nedlukning af session...................................................17
3.2.4 Skift mellem sessions ...................................................17
3.3 Aktuelle værdier ....................................................................17
3.3.1 Oplysninger om aktuel session ....................................18
3.3.2 Oplysninger om DLL programbibliotek.........................18
3.3.3 Styring af temporære filer .............................................18
3.4 Query og opslag i Lotus Notes.............................................19
3.4.1 Generel query................................................................19
3.4.2 Håndtering af resultat sæt ............................................20
3.4.3 Query på unikt dokument..............................................20
3.4.4 Opslag via view .............................................................20
3.4.5 Opslag på feltværdi.......................................................21
3.4.6 Entydigt opslag..............................................................21
3.4.7 Sammenligning af værdier............................................22
3.5 Datamanipulation..................................................................22
3.5.1 Oprettelse af nyt dokument...........................................23
3.5.2 Tildeling af feltværdier...................................................23
3.5.3 Sletning af dokumenter i Lotus Notes ..........................24
3.5.4 Opdatering af ændringer...............................................24
3.5.5 Oplysninger om aktivt dokument..................................24
3.6 Rich-text ................................................................................25
3.6.1 Opdatering til Notes ......................................................25
3.6.2 Læsning fra Notes.........................................................25
3.6.2.1 Rich-text i separate filer.........................................26
1

3.6.2.2 Valg af metode ......................................................26
3.7 Fil-attachments......................................................................26
3.8 Mail ........................................................................................27
3.8.1 Forberedelse af mail .....................................................27
3.8.2 Udfyldelse af indhold i mail ...........................................28
3.8.3 Afsendelse af mail.........................................................28
3.8.4 MAPI Mail ......................................................................29
3.8.5 Automatiske fejlmeldinger via mail...............................29
3.9 Oplysninger om Notes design..............................................30
3.9.1 Forespørgsel på eksistens af designelement navn.....30
3.9.2 Liste Notes designelementer........................................30
3.9.3 Type på designelement ................................................31
3.10 Fejlsøgning........................................................................32
3.10.1 Fejl-beskeder.................................................................32
3.10.2 Debugning til skærm.....................................................32
3.10.3 Debugning til log-fil........................................................33
4. Reference .........................................................................................34
Macro-navn.......................................................................................34
#NotesAddQueryField......................................................................36
#NotesAppendFieldValue ................................................................37
#NotesAppendMultiValue ................................................................38
#NotesAttachFile ..............................................................................39
#NotesClearLog................................................................................40
#NotesClearQueryFields..................................................................41
#NotesClose .....................................................................................42
#NotesCommit..................................................................................43
#NotesCommitNoRecalc .................................................................44
#NotesCompareField .......................................................................45
#NotesConnect.................................................................................46
#NotesCreateNew............................................................................47
#NotesDatabaseName.....................................................................48
#NotesDatabaseTitle........................................................................49
#NotesDebug....................................................................................50
#NotesDelay .....................................................................................51
#NotesDeleteAttachment.................................................................52
#NotesDeleteCurrent .......................................................................53
#NotesDeleteID ................................................................................54
#NotesDeleteTempFil ......................................................................55
#NotesDetachFile.............................................................................56
#NotesDLLVersion ...........................................................................57
#NotesDocID ....................................................................................58
#NotesExistsAttach ..........................................................................59
#NotesExistsField.............................................................................60
#NotesExistsForm............................................................................61
#NotesExistsView.............................................................................62
#NotesFieldType ..............................................................................63
#NotesFirstField ...............................................................................64
#NotesFirstForm...............................................................................65
#NotesFirstView ...............................................................................66
#NotesForm......................................................................................67
#NotesFormName............................................................................68
#NotesFormType..............................................................................69
#NotesGetDocInfo............................................................................70
#NotesGetFieldLength .....................................................................71
#NotesGetFieldValue .......................................................................72
#NotesGetFoundDocs .....................................................................73
#NotesGetHandle.............................................................................74
#NotesGetItemInfo ...........................................................................75
#NotesGetMessages........................................................................76
#NotesGetRichSepMode .................................................................77
2

#NotesGetTmpFilnavn .....................................................................78
#NotesGetUnique.............................................................................79
#NotesIF ...........................................................................................80
#NotesImportFile ..............................................................................81
#NotesInit..........................................................................................82
#NotesIsDemoVersion .....................................................................83
#NotesDLLLog..................................................................................84
#NotesLogFilnavn ............................................................................85
#NotesLogon ....................................................................................86
#NotesMailAttachFile .......................................................................87
#NotesMailBody ...............................................................................88
#NotesMailBodyFile .........................................................................89
#NotesMailBodyText ........................................................................90
#NotesMailErrorTo ...........................................................................91
#NotesMailGetUsername ................................................................92
#NotesMailMAPIPassword ..............................................................93
#NotesMailMAPIProfile ....................................................................94
#NotesMailPrepare...........................................................................95
#NotesMailSend ...............................................................................96
#NotesMailSetMAPI .........................................................................97
#NotesMessages..............................................................................98
#NotesMoveFirst ..............................................................................99
#NotesMoveLast ............................................................................100
#NotesMoveNext............................................................................101
#NotesMovePrev............................................................................102
#NotesNextField.............................................................................103
#NotesNextForm ............................................................................104
#NotesNextView.............................................................................105
#NotesOpenDialog.........................................................................106
#NotesOpenServer.........................................................................107
#NotesPutFieldValue......................................................................108
#NotesQuery...................................................................................109
#NotesQueryField ..........................................................................110
#NotesQueryRichTextField............................................................111
#NotesQueryUnique.......................................................................112
#NotesRemoveItem .......................................................................113
#NotesRunAgent ............................................................................114
#NotesSave ....................................................................................115
#NotesSearchFirst..........................................................................116
#NotesSearchNext .........................................................................117
#NotesSearchView.........................................................................118
#NotesSelectID...............................................................................119
#NotesSelectUNID .........................................................................120
#NotesServerName........................................................................121
#NotesSetDelim..............................................................................122
#NotesSetField ...............................................................................123
#NotesSetFieldValue......................................................................124
#NotesSetHandle ...........................................................................125
#NotesSetKeepUnread..................................................................126
#NotesSetListDelim........................................................................127
#NotesSetRichFieldValue..............................................................128
#NotesSetRichSepMode................................................................129
#NotesTmpFilNavn.........................................................................130
#NotesUNID....................................................................................131
#NotesView.....................................................................................132
#NotesViewName...........................................................................133
Appendix 1. Manuel installation.........................................................134
1.1 Udpakning af filer ................................................................134
1.2 Kopiering af filer ..................................................................134
Appendix 2. Kendte fejl/begrænsninger ............................................135
3

2.1 Manglende oprydning (går ned).........................................135
2.2 Multi-value felter ved NotesQuery......................................135
2.3 Mail-error ved mail-fejl ........................................................136
2.4 Attachments i rich-text felter ...............................................136
2.5 Begrænsning i grafikformater.............................................136
2.6 DocId ved replica ................................................................136
2.7 Max længde af feltværdi .....................................................136
2.8 Feltet ”Form” skal være sat på dokument..........................137
Appendix 3. Designelement typer......................................................138
Appendix 4. Datatype-parametre.......................................................139
Appendix 5. Integrationskit uden 32 bit Windows klienter................140
4

0. Introduktion
0.1 XAL til Notes integrationskit
Integration mellem CONCORDE og Lotus Notes kan implementeres på mange måder.
Integrationskittet kan anvendes til produkterne CONCORDE XAL og CONCORDE C5 (se afsnit 0.4
for systemkrav). Når der i denne manual refereres til XAL, er det altså udviklingsmiljøet der henvises
til. Begge programmer betegnes i denne manual under samlebetegnelsen "CONCORDE".
Teknologien er baseret på integration til Lotus Notes via et Windows DLL programbibliotek. Al kontrol
og opsætning sker i CONCORDE.
Integrationskittet indeholder bl.a. følgende features:
• Mulighed for on-line integration
Al opdatering i f.eks. Lotus Notes sker i koordinering med opdatering i CONCORDE. Mulighed
for annullering af opdatering ved f.eks. manglende forbindelse.
• Overholdelse af sikkerhedsrutiner i begge systemer
Ingen mulighed for at omgå sikkerhedssystemet i hverken Lotus
Notes eller CONCORDE. Ingen risiko for "bagdøre".
• Indlejring i standard XAL kode
Kodning sker direkte i XAL udviklingsmiljøet via XAL-macroer.
Dette sikrer overholdelse af integritetsregler i CONCORDE.
• Ingen adgang til CONCORDE data fra Lotus Notes
Kittet giver ikke mulighed for at man fra Lotus Notes kan se data i
CONCORDE, som det f.eks. er muligt med ODBC-metoden.
Data flyttes til Notes fra CONCORDE og hentes fra Notes af
CONCORDE. CONCORDE har kontrollen 100 %.
• Transparent adgang til Lotus Notes
Adgang til Lotus Notes kan ske uden kodning eller ændring i
Lotus Notes. Dette giver bl.a. mulighed for integration med
Lotus Notes applikationer, hvor brugeren ikke har adgang
til kildekode, men blot kender navnene på kartoteker og felter
i Notes.
• Afsendelse af E-mail fra CONCORDE
Mulighed for integration med E-mail, hvorved bl.a. workflow systemer kan implementeres i
CONCORDE.
5

0.2 Målgru pe
Da integrationskittet indeholder en samling værktøjer til integration med Lotus Notes via
CONCORDE’s udviklingsmiljø, henvender denne manual sig primært til personale der har et vist
kendskab til CONCORDE’s programmeringsfaciliteter. Denne viden kan bl.a. opnås ved deltagelse i
Navision Supervisorkurser.
Kravene til programmeringskendskab afhænger dog i høj grad af, hvor tæt man vil integrere
CONCORDE med Lotus Notes.
For at kunne benytte integrationskittet er et vist kendskab til Lotus Notes en fordel, specielt med
hensyn til navne på
• Databaser
• Views
• Forms
• Felter
Disse oplysninger er et grundlag for selv at kunne programmere integrationsløsninger. Viden om
brug af de værktøjer der kan give disse oplysninger fra Lotus Notes, kan dog erhverves på meget
kort tid. Det tilrådes, at man sikrer sig, at overførsel og manipulation af data i Lotus Notes godkendes
af den eller de personer, der er ansvarlige for Lotus Notes i virksomheden.
0.3 Komponenter
Integrationskittet består af to hovedkomponenter: et XAL macrobibliotek - "NOTES" og et Windows
programbibliotek (DLL) - ERP2LN.DLL.
Desuden kan integrationskittet suppleres med en overbygning der letter opbygning af integrationsapplikationer.
0.3.1 XAL macrobiblioteket "NOTES"
Filosofien bag integrationskittet er, at man skal kunne foretage al integration mellem CONCORDE
og Lotus Notes inde fra CONCORDE.
Da CONCORDE i standardversionerne ikke indeholder faciliteter til direkte kommunikation med
Lotus Notes, har det været nødvendigt at udvide funktionaliteten i XAL. Alle udvidelser er samlet i
macrobiblioteket NOTES. Formålet med macrobiblioteket er primært at gøre brugerfladen ved integration
med Notes så lig de muligheder man har i XAL. Brugeren skal altså ikke operere med f.eks.
direkte kald af DLL.
For at kunne anvende integrationsværktøjerne skal dette macrobibliotek være indlæst i det XAL
programobjekt, hvorfra man ønsker at etablere integration med Lotus Notes.
Kildekoden i macrobiblioteket er dokumenteret. De fleste kald i macrobiblioteket bygger på kald af
Windows DLL, via XAL-kommandoen DLLCALL.
Direkte adgang til DLL-biblioteket uden om macrobiblioteket frarådes på det kraftigste.
6

0.3.2 Windows programbiblioteket ERP2LN.DLL
Da CONCORDE som nævnt ikke har faciliteter til direkte kommunikation med Lotus Notes, sker
den egentlige integration uden for CONCORDE. Dette sker via et Windows programbibliotek, en
såkaldt DLL-fil (Dynamic Link Library), som er en af de væsentlige byggesten i Microsoft
Windows. Formålet med disse filer er bl.a. at danne en fælles reference mellem forskellige
Windows-programmer.
ERP2LN.DLL er hvad man i programmeringsmiljøer kalder et API - Applikations Programmerings
Interface.
Altså en programmeringsmæssig indgang til et program. Via ERP2LN.DLL får XAL-programmøren
adgang til en række Notes faciliteter, som altså kan udføres uden for Lotus Notes.
I princippet fungerer ERP2LN.DLL som er man tilkoblet Lotus Notes som "almindelig" bruger.
ERP2LN er specielt designet til CONCORDE.
0.4 Systemkrav
For at kunne afvikle XAL til Notes integrationskittet, skal visse systemmæssige forudsætninger være
opfyldt. Kan disse forudsætninger ikke umiddelbart opfyldes, er der i Appendix 5 angivet nogle
muligheder, således integrationskittet alligevel kan afvikles.
0.4.1 Lotus Notes
Da integrationen tager udgangspunkt i XAL og er transparent for Lotus Notes, er kravene til Lotus
Notes små.
På arbejdspladsen skal Lotus Notes version 4.6X eller nyere være installeret (dansk eller engelsk
version). Visse mail-funktioner, som åbner Lotus Notes klienten fra XAL, kræver dog Lotus Notes
version 5.03 eller nyere.
Det er ikke et krav at Lotus Notes klienten er opstartet, for at kunne foretage integration med Lotus
Notes. Integrationen mellem CONCORDE og Lotus Notes sker direkte mellem CONCORDE og
Lotus Notes serveren eller lokale Lotus Notes filer.
0.4.2 CONCORDE
For at kunne benytte integrationskittet skal CONCORDE understøtte kald af DLL. Dette betyder, at
integration kan benyttes fra Windows-versioner af CONCORDE XAL - kerne-version 2.5 eller nyere
(CONCORDE C5 version 1.5 eller nyere). Ønsker man ikke at benytte GUI-versionen af
CONCORDE XAL, kan 32-bit consol-versionen af CONCORDE XAL benyttes. Denne specielle
version af CONCORDE XAL blev lanceret i version 2.60. Med denne kerne har man, via den tegnbaserede
brugerflade, adgang til samtlige udviklingsværktøjer i XAL og dermed også til integrationskittet.
Udvikling og test af integration med Lotus Notes sker bedst i denne version.
Der eksisterer ikke en consol-version til CONCORDE C5, hvilket besværliggør udvikling, idet integration
med f.eks. forms og rapporter ikke kan testes i udviklingsmiljøet. Udvikling skal ske i den
tegnbaserede version, mens test og brug skal ske i GUI-versionen.
Ved brug af Oracle-versionen af CONCORDE XAL er der visse systemmæssige forskelle på version
2.5X og 2.6X som betyder, at det ikke er muligt at kombinere kerner fra 2.6X med tidligere versioner.
7

For at kunne bruge integrationskittet skal man desuden have adgang til de relevante udviklingselementer
i CONCORDE.
Der kræves ikke ODBC koder til CONCORDE.
0.4.3 Arbejdsplads
Udover at have adgang til Lotus Notes og CONCORDE er der ingen væsentlige krav til arbejdspladsen.
Microsoft Windows 95, Windows XP, Windows NT eller Windows 2000 skal naturligvis
være installeret for at kunne afvikle Windows-versionen (GUI- eller consol-version
(CONCORDE XAL)) af CONCORDE.
Der skal være angivet en path til Lotus Notes programbiblioteket.
Se eventuelt afsnit 1 vedr. installation af integrationskittet.
0.5 U da nelse
Der er ikke de store uddannelseskrav i forbindelse med brug af integrationskittet.
Et kursus omfatter typisk følgende områder:
1. Gennemgang af principperne i integration mellem CONCORDE og Lotus Notes.
2. Gennemgang af kommandoer i integrationskittet.
3. Gennemgang af relevante Lotus Notes værktøjer.
4. Integrationscase, hvor et XAL applikationselement integreres med en Lotus Notes database.
Varigheden af kurset afhænger af deltagernes grundviden om Lotus Notes og CONCORDE’s udviklingsmiljø,
samt hvor dybt man vil dykke ned i integrationscasen.
8

1. Programinstallation
1.1 Klargøring af arbejdsplads
Inden installationen kan gennemføres skal arbejdspladsen være klargjort til installation.
1.1.1 Installation og opsætning af Lotus Notes klient
For at kunne benytte integrationskittet, skal Lotus Notes klienten være installeret på arbejdspladsen.
Lotus Notes skal være i 32-bit version. Følg installationsvejledningen til Lotus Notes vedr. installation
af Lotus Notes klienten.
Installation af Lotus Notes klienten opretter bl.a. de filer som integrationskittet skal bruge for at
komme i kontakt med Lotus Notes. Det er ikke et krav, at Lotus Notes klienten skal være opstartet
på arbejdspladsen for at CONCORDE kan kommunikere med Lotus Notes.
Al integration med Lotus Notes sker fra CONCORDE. Der er ingen særlige krav til modifikationer i
Lotus Notes for at kunne bruge integrationskittet. Integrationskittet kan evt. kombineres med ODBC
adgang fra Lotus Notes til CONCORDE.
1.2 Filer
Integrationskittet består af følgende filer, der automatisk kopieres til arbejdspladsens CONCORDE
bibliotek:
ERP2LN.DLL
BORLNDMM.DLL
1.3 Installation af Integrationskit
Indsæt Cd’en med navnet Lotus Notes Integration Kit. Hvis installationsprogrammet ikke starter
automatisk skal der dobbeltklikkes på setup.exe i roden af Cd’en (Vælg ’Run’ fra Windows Startmenuen
og skriv ”D:\setup.exe”, hvis CD-ROM-drevet er D-drevet).
Følg installationsanvisningerne på skærmen. For en detaljeret gennemgang af installationen, se
manual til Integrationskittet.
Installeres der ikke fra CD’-ROM’en skal filerne fra CD-ROM’en kopieres til enten et lokalt drev eller
et mappet netværksdrev. Installationen kører på nuværende tidspunkt ikke fra et UNC-path.
1.4 Registrér serienummer
Integrationskittet leveres med et kodebrev som indeholder et serienummer der er tilpasset licensnavn
og serienummer i CONCORDE.
9

Har man ikke modtaget et serienummer kan integrationskittet stadig benyttes i en demo-version.
Demo-versionen indeholder visse begrænsninger i forhold til den fulde version, bl.a.:
• Tidsbegrænset anvendelse
• Ingen mulighed for afsendelse af mail
Fra Windows Start-menuen åbnes undermenuen ’Programmer\Intoint’. Herfra vælges menupunktet
’Enter your serial number’. Dette starter programmet ’WSlize’ (se nedenstående billede).
I feltet ’Filename’ skal den fulde sti til ”ERP2LN.DLL” angives og i ’Serial Number’ skal det serienummer,
du har modtaget fra Intoint indtastes. Tryk [OK] for at gemme serienummeret.
Kommer der en fejl skal du kontrollere at stien og filnavnet er korrekt, samt at du har rettigheder til at
skrive til filen og at den ikke er skrivebeskyttet.
1.5 Installation af XAL macrobibliotek
Efter installation og test af systemfilerne i integrationskittet kan XAL-delen af kittet installeres.
XAL macrobiblioteket skal indlæses i CONCORDE.
Dette gøres på følgende måde:
1. Opstart den tegnbaserede version af CONCORDE
2. Vælg udviklingsmenuen via /Generelt/Tilpasning/Udviklingsmenu
3. Vælg import af XAL-macro via /MAC/Import
4. Angiv X:\xxxx\intoint\xal\YY\NOTES.MAC som filnavn (hvor X:\xxxx angiver stien til
CONCORDE installationen og YY angiver sprog (DK eller UK).
Hermed er macrobiblioteket indlæst.
1.6 Globale variable
Integrationskittet opererer med en række globale variable, der skal oprettes i XAL. Disse variable er
samlet i macroen NotesVar
Følgende linie skal tilføjes i XAL-macroen "GlobaleVariableUsr":
10

#NotesVar
Variablerne &NotesServer, &NotesDatabase, &NotesForm og &NotesView kan evt. tildeles en
standardværdi, med den opsætning man ønsker skal være default, f.eks.:
STR 40 &NotesServer = "Local"
STR 80 &NotesDatabase = "Medarb.nsf"
STR 40 &NotesForm = "Medarbejder"
STR 40 &NotesView = "All"
Efter tilretning af macroen "GlobaleVariableUsr" skal XAL-kørslen "AUTOEXEC" genoversættes,
hvorefter CONCORDE skal genstartes. Herefter er CONCORDE klar til integration.
11

2. Kom hurtigt i gang
Inden vi går i dybden med faciliteterne i integrationskittet vil der i dette afsnit blive præsenteret en
lille case, som illustrerer hvorledes kittet fungerer og kan anvendes.
2.1 Case: Opdatering - Afdeling
Casen vil illustrere hvorledes man fra CONCORDE kan oprette og opdatere data i Lotus Notes.
Formålet med XAL-kørslen i denne case er at kunne vedligeholde en kopi af afdelingskartoteket i
Lotus Notes. Ved afvikling af XAL-kørslen gennemløbes afdelingskartoteket i CONCORDE og hver
afdelings-record replikeres til Lotus Notes.
2.1.1 Oprettelse af afdelingskartotek i Lotus Notes
På installationsdiskette 1 medfølger en skabelon til at oprette et simpelt afdelingskartotek i Lotus
Notes.
Kartoteket oprettes på følgende måde:
1. Kopiér filen AFDELING.NTF til Lotus Notes’ databibliotek fra disketten.
2. Opstart Lotus Notes klienten
3. Opret nydatabase (Ctrl-N)
4. Udfyld skærmbillede som angivet nedenfor:
Det er vigtigt at "Afdeling" angives som template.
12

5. Vælg OK
2.1.2 XAL-kode
Koden til denne case medfølger i filen CASE2.XAL.
#MACROLOAD(Notes)
#NotesInit
#NotesOpenServer('Local')
#NotesLogon('Afdeling.nsf')
#NotesForm('Afdeling')
SEARCH Afdeling USING NumIdx
END
#NotesGetUnique("Nummer",Nummer)
IF StrLen(&NotesText)

2.1.4 SEARCH løkke
Afdelingskartoteket gennemløbes nu på normal vis med en SEARCH kommando:
SEARCH Afdeling USING NumIdx
2.1.5 Opdatere eller oprette?
Næste skridt er, at checke om den aktuelle afdeling allerede findes i Lotus Notes. Er dette tilfældet
skal Notes dokumentet opdateres, hvis ikke skal der oprettes et nyt dokument:
#NotesGetUnique("Nummer",Nummer)
IF StrLen(&NotesText)

3. Anvendelse af integrationskit
I dette afsnit gennemgås hvorledes integrationskittet skal anvendes ved kodning i XAL. I afsnit 4 vil
de enkelte kommandoer blive beskrevet nærmere.
3.1 Kald af XAL-macroer
For at kunne tilgå Lotus Notes fra XAL, skal macrobiblioteket NOTES være defineret i starten af
koden. Dette gøres med kommandoen:
#MacroLoad(NOTES)
Placeringen af kommandoen afhænger af hvilket applikationselement man benytter. I XAL-forms er
det f.eks. nødvendigt at placere kaldet i INIT-formlen, da man på denne måde gør integrationskommandoerne
tilgængelige i alle programobjekter på formen.
Integrationskittets macroer er opdelt i to typer. Macroer der returnerer en værdi direkte og macroer
der returnerer en værdi indirekte.
Et eksempel på den første type er macroen #NotesServerName, som returnerer navnet på den
aktuelt valgte Notes server. Et eksempel på brug af denne type macro:
SET &ServerNavn = #NotesServerName
Et eksempel på den anden type er macroen #NotesDeleteCurrent, som ikke returnerer en værdi
direkte. Den returnerer dog en værdi indirekte i variablen &NotesText. Denne værdi indeholder
resultatet af kommandoen. Generelt betyder en tom værdi i &NotesText, at alt gik godt, mens en
ikke tom værdi normalt angiver en fejlkode. I afsnit 4 beskrives disse returværdier nærmere.
I dette hovedafsnit er alle henvisninger til integrationsmacroer angivet med fed og kursiv. Ved
definitionen af de enkelte macroer er benyttede fed, kursiv og understreget skrifttype.
3.2 Forbindelse til Lotus Notes
En del af kommandoerne til integrationskittet vedrører oprettelse og nedlukning af sessions med
Lotus Notes, samt kommandoer der udpeger applikationselementer i Notes:
#NotesInit
#NotesOpenServer
#NotesOpenDialog
#NotesLogon
#NotesForm
15

#NotesView
#NotesClose
3.2.1 Initialisering af forbindelse til DLL-fil
#NotesInit macroen etablerer forbindelse mellem CONCORDE og det DLL bibliotek der indeholder
systemkaldene til Lotus Notes. Denne macro skal kaldes, inden man kan benytte de øvrige integrationsmacroer.
Macroen kan eventuelt placeres i XAL-kørslen AUTOEXEC. Man kan sagtens kalde
denne macro flere gange, når først macroen er kaldt een gang ignoreres efterfølgende kald.
Ved kald af macroen etableres der ikke et link til Lotus Notes. Dette sker først ved kald af macroen
#NotesLogon.
3.2.2 Oprettelse af session til Lotus Notes
For at kunne kommunikere med Lotus Notes, skal der først udvælges en Notes database og der
skal evt. foretages login. Hvis man tilgår en Notes database, som ikke er placeret på den lokale
arbejdsstation ("Local") skal man indtaste password (i visse tilfælde vil password også blive afkrævet
for "lokale" databaser). Dette skal kun foretages een gang. Det password som skal angives,
svarer til det aktuelle Notes user-ID password. Dette kan sættes via Lotus Notes klienten. Angivelse
af aktuel Notes bruger registreres i NOTES.INI filen. Vælger man at skifte aktuel ID i Lotus Notes
(/File/Tools/Switch ID), vil man ved næste login fra CONCORDE skulle bruge dette ID’s password.
Generelt bruger integrationskittet de aktuelle Notes-opsætninger.
Er der f.eks. angivet en aktuel lokation uden forbindelse til en Notes server ("Island"), kan man heller
ikke komme i kontakt med Lotus Notes servere fra CONCORDE. Man skal derfor opstarte sin
Lotus Notes klient og skifte lokation før der er adgang til servere.
Rettighederne fra CONCORDE i Lotus Notes er ligeledes identisk med den aktuelle ID-brugers
rettigheder.
3.2.2.1 Valg af Notes server
Angivelse af Notes server sker med kommandoerne #NotesOpenServer eller #NotesOpenDialog.
I den første metode angives server navnet som parameter. Den anden metode giver mulighed for at
bladre mellem servere og kartoteker - som ved åbning af databaser i Lotus Notes. Da linket mellem
CONCORDE og Lotus Notes oftest er helt fast på kartoteksniveau er den første metode den mest
brugte. Det er ikke hensigtsmæssigt at man f.eks. kan vælge diverse kartoteker i Lotus Notes, hvis
man skal kunne behandle data, som skal udpeges via feltnavne.
Ved brug af macroen #NotesOpenDialog returneres valgte servernavn og database i variablerne
&NotesServer og &NotesDatabase. Metoden kan evt. bruges i kombination med kommandoen
#NotesLogon, hvorved man reelt kun benytter macroen til udvælgelse af server.
Angives "Local" som servernavn bruges de lokale filer på arbejdspladsen. Angives intet servernavn
som parameter, vælges det server-navn der er gemt i den globale variabel &NotesServer.
3.2.2.2 Valg af Notes database
Efter angivelse af server skal den ønskede Notes database udpeges. Dette kan, som nævnt ovenfor,
gøres ved interaktiv udvælgelse med macroen #NotesOpenDialog eller ved direkte angivelse
af databasenavn i macroen #NotesLogon. I sidstnævnte tilfælde angives databasens filnavn som
parameter (incl. ”.nsf”). Husk at benytte to backslash’s ved angivelse af underbiblioteker.
16

Et eksempel:
#NotesLogon("mail\\ejensen.nsf")
Udover at udpege arbejdsdatabase i Lotus Notes foretager macroen også oprettelse af den egentlige
forbindelse med Lotus Notes. Der checkes om server og database er tilgængelig, samt afkræves
evt. password fra brugeren, hvis databasen er placeret på en Notes server og der ikke allerede er
indtastet password tidligere.
Angives ingen parameter vælges det databasenavn der er gemt i den globale variabel
&NotesDatabase.
3.2.2.3 Valg af Notes applikationselementer
For at kunne udveksle data mellem CONCORDE og Lotus Notes skal der angives enten hvilket
Notes view der skal arbejdes med eller hvilken form der skal anvendes.
Notes view bruges i forbindelse med udførelse af Notes forespørgsler, mens Notes forms bruges
ved behandling af felter.
Til udvælgelse af applikationselement bruges macroerne #NotesForm og #NotesView. Angives
ingen parameter bruges værdierne i variablerne &NotesForm og &NotesView som default-værdier.
3.2.3 Nedlukning af session
Ønsker man at have mulighed for skiftende sessions til Lotus Notes fra CONCORDE, skal man
oprette en session pr. element. Ved afslutning af programkoden skal man afslutte den aktuelle session
med kommandoen #NotesClose.
Denne macro afbryder ikke forbindelsen til DLL-biblioteket, som blev etableret med macroen
#NotesInit.
Efter brug af #NotesClose skal man ved næste tilgang til Lotus Notes lave en ny forbindelse med
#NotesLogon.
3.2.4 Skift mellem sessions
Det er muligt at operere med flere samtidige sessions. Hver session har sin egen forbindelse til
Lotus Notes, med angivelse af server, database, form, view, aktuelle dokument med mere. Skift
mellem sessions sker med kommandoen #NotesSetHandle.
Der bør udvises forsigtighed ved brug af flere aktive sessions. Forvirring omkring hvilken session
der er aktiv er en hyppig fejlårsag.
Benyt eventuelt #NotesGetHandle for at få oplyst, hvilken session der er aktiv.
3.3 Aktuelle værdier
Der findes en række macroer, der oplyser om diverse aktuelle værdier. En del af disse værdier
vedrører den aktuelle session med Lotus Notes, som blev beskrevet i foregående afsnit.
Alle macroer returnerer en værdi direkte.
17

3.3.1 Oplysninger om aktuel session
De macroer der returnerer disse oplysninger er listet nedenfor:
#NotesServerName
#NotesDatabaseName
#NotesDatabaseTitle
#NotesFormName
#NotesViewName
Disse macroer modsvarer macroerne der opretter forbindelserne.
Et eksempel:
#NotesOpenServer("Local")
PRINT #NotesServerName
vil udskrive "Local" på skærmen.
Se også nærmere i afsnit 3.9.3.
3.3.2 Oplysninger om DLL programbibliotek
Macroen #NotesIF returnerer aktuel status på forbindelsen til DLL biblioteket. Er værdien 0 (falsk),
er det ikke muligt at etablere forbindelse med Lotus Notes.
Macroen #NotesDLLVersion returnerer versionsnummer og release-dato på DLL biblioteket. Disse
oplysninger er relevante ved support på programmet o.a..
Via kommandoen #NotesIsDemoVersion er det muligt at få oplyst om den aktuelle integration sker
via en begrænset demo-version eller en fuld version.
3.3.3 Styring af temporære filer
Ved modtagelse af flere dokumenter fra Lotus Notes kan temporære filer benyttes som media. Det
sker i form af kommafiler.
Filerne er opbygget på følgende måde:
Linie 1 "DocId", "feltnavn1", "feltnavn2",...,"feltnavn i"
Linie 2, første dokument "DocId 1", "felt1 værdi", "felt2 værdi",..., "felt i værdi"
Linie 3, andet dokument "DocId 2", "felt1 værdi", "felt2 værdi", ..., "felt i værdi"
... ...
Linie n "DocId n", "felt1 værdi", "felt2 værdi", ..., "felt i værdi"
Som det ses, indledes kommafilen med en liste over felter i den valgte form. Alle felter returneres i
kommafilen. Ved indlæsning af kommafilen i CONCORDE, kan overflødige felter så ignoreres.
Udover at indeholde alle felter angives også en unik nøgle til dokumentet. Dette svarer stort set til
feltet "Løbenummer" i XAL. Dette kan bruges ved registrering af dokumenter til senere udpegning
(se afsnit 3.4.6). DocId feltet er første værdi i hver linie.
Tegnsættet der benyttes i den temporære fil svarer til CONCORDE's. Hvis man åbner den temporære
fil i f.eks. NotePad, vil "æ", "ø", "å" og andre specialtegn vises "forkert". Hvis filen åbnes i en
DOS-editor eller CONCORDE's XAL-editor er alle tegn korrekte. Dette skyldes at integrationskittet
"oversætter" fra det Windows tegnsæt der bruges i Lotus Notes til det tegnsæt der benyttes i
CONCORDE.
18

Macroen #NotesTmpFilNavn benyttes til tildeling af navn på temporær fil. Macroen returnerer altid
det aktuelle navn på den temporære fil. Dette sker via variablen &NotesText.
Angives en parameter til macroen benyttes denne som filnavn. Angives ikke en parameter beregnes
automatisk et unikt filnavn. Som parameter skal altid overføres en variabel.
Bemærk at den temporære fil først oprettes i forbindelse med udførelse af macroen #NotesQuery
eller NotesQueryRichTextField..
Husk at slette den temporære fil efter brug - brug f.eks. XAL macroen #NotesDeleteTempFil.
Med kommandoen #NotesGetTmpFilNavn kan man få oplyst navnet på den aktuelle temporære fil
i den aktuelle session.
3.4 Query og opslag i Lotus Notes
Der findes en række macroer der laver opslag i Lotus Notes:
#NotesQuery
#NotesQueryField
#NotesQueryUnique
#NotesGetUnique
#NotesSelectID
#NotesSelectUNID
Disse har dog forskellige anvendelsesområder.
3.4.1 Generel query
Macroen #NotesQuery bruges til udførelse af standard Notes-full-text søgning. Udvælgelseskriteriet
angives som parameter. Parameteren kan sammenlignes med "View selection" i Lotus
Notes. For at kunne bruge denne macro, skal man have et vist kendskab til Lotus Notes. Kommandoen
"SELECT" kan udelades ved kald af macroen.
Her et par eksempler på kald af macroen:
#NotesQuery("Select @ALL")
Returnerer alle dokumenter i database.
#NotesQuery("Antal>100")
Returnerer alle dokumenter, hvor feltet "antal" har en værdi over 100.
Angives ingen afgrænsning returneres alle dokumenter.
Søgeresultater returneres altid i et resultat-sæt i hukommelsen. Desuden kan resultatet returneres i
en kommafil, forudsat at et filnavn til en temporær fil er angivet (se afsnit 3.3.3). Der skal så her
foretages en efterfølgende behandling via XAL’s READ kommando.
Kald af #NotesQuery giver mulighed for kraftfulde søgeudtryk på tværs af views og felter. Men da
der benyttes full-text søgning er metoden relativ langsom i større databaser. Se evt. nærmere under
#NotesSearchView.
19

3.4.2 Håndtering af resultat sæt
Det er også muligt at bearbejde resultatet af søgningen uden at håndtere kommafiler.
Via diverse ”Move-” kommandoer kan man udpege første, næste, forrige og sidste dokument i søgningen.
Macroerne kaldes med:
#NotesMoveFirst
#NotesMoveNext
#NotesMovePrev
#NotesMoveLast.
Antallet af dokumenter i resultatsættet oplyses via kald af macroen #NotesGetFoundDocs.
Denne metode til håndtering af søgninger kan med fordel kombineres med kald af
#NotesTmpFilNavn med tomt filnavn som parameter. Derved udskrives resultatet ikke også til en
kommafil.
3.4.3 Query på unikt dokument
Med macroen #NotesQueryUnique kan man foretage en query svarende til ovenstående
#NotesQuery, som returnerer eet dokument direkte. For at kunne bruge denne metode skal man
dog være sikker på, at der kun findes 0 eller 1 dokument der kan returneres. Dette er dog ofte tilfældet
i integrations-situationer med CONCORDE, som næsten altid har mindst een unik udpegning
af en record.
3.4.4 Opslag via view
Da queries i integrationskittet sker via fuld-tekst søgning, kan denne metode blive relativ langsom
ved større datamængder. Man kan så, med fordel, lave opslag i Lotus Notes via de tilgængelige
views (svarende til index i XAL). For at kunne benytte et view til opslag, skal alle de kolonner der
søges på være af typen text og sorteret. Første søge-værdi forsøges fundet i første kolonne. Eventuel
anden søge-værdi forsøges fundet i anden kolonne og så fremdeles.
Opslag via søge-værdier sker med macroen #NotesSearchView. Søgenøglen skal matches 100%
i viewet – søges f.eks. på ”1000” vil dokument med nøglen ”100” ikke blive fundet.
Ønsker man at angive flere søgenøgler adskilles disse med semikolon, f.eks. #Notes-
SearchView(’Hansen;Jesper’).
Ønsker man at benytte et andet skilletegn, kan dette sættes med macroen #NotesDelim.
Opslag i view kan også ske med macroen #NotesSearchFirst, der udvælger det første (øverste)
dokument i det aktuelle view.
Via #NotesSearchNext kan man så bladre til de næste dokumenter. Dette gælder også efter
#NotesSearchview, dog vil man her kun kunne bladre frem gennem de dokumenter der opfylder
søge-kriteriet i #NotesSearchView.
På denne måde kan et view traverseres som vist i dette eksempel
#NotesSearchFirst
WHILE StrLen(&NotesText)>2
PRINT ”Navn: ”,#NotesQueryField(’Navn’)
20

END
#NotesSearchNext
3.4.5 Opslag på feltværdi
En anden type forespørgsel, er opslag på et aktuelt dokuments feltværdier. Dette gøres med
macroen #NotesQueryField.
For at kunne benytte denne macro, skal man have udpeget et aktuelt dokument, f.eks. med en af
macroerne #NotesSelectID eller #NotesGetUnique.
Som parameter angives feltnavn. Bemærk at Lotus Notes behandler feltnavne case-sensitivt. Det er
derfor vigtigt at angive feltnavne eksakt som i Lotus Notes. Hedder et felt f.eks. "Nummer", kan man
ikke angive "nummer" som gyldigt feltnavn.
Et eksempel:
#NotesGetUnique("Nummer", Nummer)
PRINT Nummer,": ",#NotesQueryField("Navn")
#NotesQueryField returnerer altid en tekstværdi (STR). Det er altså XAL-programmørens opgave,
at konvertere til det rette XAL-format med f.eks. Str2Num eller Str2Date. Dette område kræver naturligvis
en vis viden omkring de aktuelle Lotus Notes formater, f.eks. datoværdier o.lign. Visse formater
kan variere ved ændringer af den enkelte Lotus Notes konfiguration, f.eks. kommaformat (","
eller ".") og datoformat.
Ved opslag på rich-text felter kan man risikere, at teksten er meget lang. XAL kan kun håndtere en
returværdi på 255 tegn. For at håndtere dette problem kan macroen #NotesQueryRichTextField
benyttes. Denne fungerer som #NotesQueryField og returnerer værdi på samme måde, direkte i
kaldet. Men derudover returneres felt-værdi i den aktuelle temporære fil. Derved kan større datamængder,
f.eks. tekst der skal indlæses i et notat felt i XAL, indlæses via READ AS COMMA.
Brug af #NotesQueryField kræver at feltet er defineret på den aktuelle form. I visse situationer
findes felter på Notes dokumenter, som ikke er defineret på formen. I sådanne tilfælde kan man
benytte macroen #NotesGetFieldValue, som ikke checker felt-definitionen.
3.4.6 Entydigt opslag
For at kunne behandle data i en relationsdatabase, skal alle data kunne udpeges entydigt. Dette
gælder også CONCORDE. Men Lotus Notes er ikke en relationsdatabase og Notes er ikke bygget
til at understøtte unikke nøgler, som i f.eks. XAL.
Men for at kunne integrere CONCORDE med Notes, er det nødvendigt at kunne lave entydige opslag.
Til at håndtere dette findes tre macroer i integrationskittet: #NotesSelectID, #NotesSelectUNID og
#NotesGetUnique. Disse macroer udpeger et aktuelt dokument, der så kan behandles med f.eks.
#NotesQueryField eller #NotesSetFieldValue.
#NotesGetUnique benyttes i situationer, hvor man har et nøglefelt i CONCORDE, der entydigt kan
udpege et dokument i Notes. Dette kunne f.eks. være "Kontonummer" i kontoplanen, som vil returnere
een konto. Det kan f.eks. ikke være "Kontonummer" i finansposteringerne, da mange posteringer
har samme kontonummer.
21

#NotesGetUnique har to parametre. Første parameter er feltnavn, anden parameter er feltværdi.
Macroen returnerer enten en fejlværdi eller et DocId. Fejlværdier ligger i intervallet "1" til "99". Er
returværdien (&NotesText) på mere end to karakterer, er det en henvisning til et dokument. Dokumentet
er aktivt med det samme. Der skal ikke efterfølgende foretages opslag via #NotesSelectID.
Bemærk at #NotesSearchView fungerer næsten på samme måde, blot hurtigere, men
#NotesSearchView melder ikke fejl, hvis der er flere dokumenter med samme nøgle.
#NotesSelectID benyttes i situationer, hvor man vil lave et opslag direkte via et kendt DocId. Dette
DocId kunne f.eks. fremkomme som et resultat af en #NotesQuery, der jo returnerer DocId i kommafilen.
DocId er entydig for databasen. Men værdien kan "genbruges" efter sletning i Notes databasen.
Desuden er DocId kun unik for den enkelte instans af databasen. Ved replikering kan DocId ændres.
Brug af opslag med DocId vil derfor ikke give samme resultater på andre replika af databasen -
brug i stedet #NotesGetUniqe (se i øvrigt appendix 2.6).
For at undgå dette problem, kan man lave opslag via Lotus Notes Universal Document ID (UNID)
med macroen #NotesSelectUNID. Anvendelsen er analog med #NotesSelectID, men UNID er
unik på tværs af replikaer af den samme database. Til gengæld fylder et UNID 32 tegn, hvor et
DocId fylder 8 tegn.
3.4.7 Sammenligning af værdier
Ofte har man behov for at kunne sammenligne feltværdier i Notes og CONCORDE. Dette er specielt
nødvendigt ved opdatering af eksisterende dokumenter i Notes, hvor en unødvendig opdatering
af et felt medfører at en evt. "unread"-markering bliver sat. Ved kun at opdatere hvis der er forskelle
mellem Notes og CONCORDE kan dette undgås. Funktionaliteten kan opnås ved at aflæse Notesværdien
med #NotesQueryField og dernæst sammenligne værdierne. Med macroen
#NotesCompareField kan hele sammenligningen foretages med een kommando.
Et eksempel på brug af denne macro er vist nedenfor:
...
IF NOT
#NotesCompareField("Navn",Finkart.KontoNavn)
THEN
#NotesSetFieldValue("Navn",Finkart.KontoNavn)
#NotesCommit
ENDIF
...
Et alternativ er at angive, at der for alle data der overføres til Lotus Notes, skal ske en sammenligning
mellem den ”gamle” værdi og den ”nye” værdi. Og kun hvis der er forskel på disse værdier, vil
den nye værdi blive gemt i Notes. Derved undgår man unødvendige opdateringer, med deraf følgende
sætning af f.eks. unread-markeringer. Metoden er dog naturligvis lidt langsommere.
Med kommandoen #NotesSetKeepUnread(”1”) aktiveres denne feature.
3.5 Datamanipulation
Efter at have etableret en session med Lotus Notes og evt. udvalgt et dokument til behandling, kan
man med forskellige macroer behandle disse data. Macroerne giver mulighed for oprettelse, ændring
og sletning af dokumenter.
22

3.5.1 Oprettelse af nyt dokument
Macroen #NotesCreateNew opretter et nyt tomt dokument i Lotus Notes.
Efter kald af #NotesCreateNew bør man udfylde feltværdierne med macroen
#NotesSetFieldValue.
Det nye dokument gemmes først i Lotus Notes ved kald af macroen #NotesCommit. Kaldes denne
macro ikke, opdateres Notes databasen ikke.
Nemærk, at #NotesCreateNew opretter og gemmer det nye dokument. Efter kald af macroen, vil
der altså eksistere et tomt dokument.
3.5.2 Tildeling af feltværdier
#NotesSetFieldValue er en af de mest essentielle macroer i integrationskittet. Med denne macro
ændres indholdet i Lotus Notes dokumenterne.
Macroen kaldes med mindst to parametre: feltnavn og feltværdi. En tredje parameter, "Commit",
kan angives for at opdatere Lotus Notes umiddelbart. Alternativt skal #NotesCommit kaldes efter
alle felt-tildelingerne.
Feltværdi skal altid være en tekststreng eller tekstvariabel. XAL programmøren skal altså inden
kaldet evt. konvertere andre felttyper til en streng.
Et eksempel:
STR 10 &Dato
...
SET &Dato = Date2Str(Finpost.Dato,123,2,3,2,3,2)
#NotesSetFieldValue("Dato",&Dato)
I visse situationer kan rækkefølgen, hvori felterne udfyldes, være af betydning. Det anbefales at
udfylde felterne i samme rækkefølge, som
det ville blive gjort, hvis man sad og udfyldte felterne via Notes formen.
#NotesSetFieldValue har en variant, #NotesSetRichFieldValue, som kan benyttes ved suggesiv
udfyldning af et rich-text felt. Ved at kalde denne macro flere gange kan flere linier adderes til samme
Rich-text felt.
#NotesSetFieldValue kan også benyttes til rich-text felter, men her udskiftes indholdet af feltet ved
hvert kald. Flere linier kan dog tilføjes med denne macro ved at indsætte et linieskift
(Num2Char(10)) i den text der overføres som parameter.
Ønsker man at indsætte indholdet af en fil i et rich-text felt benyttes macroen #NotesImportFile.
Anvendelsen af denne macro svarer til #NotesMailBodyFile – se afsnit 3.8.2 for en nærmere gennemgang
af hvorledes filer importeres.
I situationer, hvor man har behov for at sætte en feltværdi i et ”item” hvor der ikke er defineret et felt
på formen, kan man benytte macroen #NotesPutFieldValue. Da denne macro er baseret på at
feltet ikke her er defineret på formen, skal man selv angive felttypen.
Dette gøres ved at foranstille feltnavnet efter følgende mønster:
#Datatype#, f.eks. #NotesPutFieldValue(’#DATETIME#Dato,&D)
Angives ikke felttype., vil data blive gemt som text-type.
23

Data der overføres til dato-felter skal altid være af formatet ”dd-mm-åå” eller ”dd-mm-åååå”
– altså med bindestreg mellem talværdier og med dag som første værdi.
3.5.3 Sletning af dokumenter i Lotus Notes
Integrationskittet stiller to macroer til rådighed som muliggør sletning af dokumenter i Lotus Notes.
#NotesDeleteID kan bruges til sletning af et dokument ved angivelse af DocId. Med denne metode
skal man ikke først fremfinde et dokument som aktuelt dokument.
Tilsvarende bruges #NotesDeleteCurrent til sletning af et aktuelt dokument, der er fundet f.eks. via
macroen #NotesGetUnique.
Efter sletning af dokument via #NotesDeleteCurrent skal et nyt aktuelt dokument udvælges, inden
der kan foretages yderligere datamanipulation med macroer, som behandler det aktuelle dokument
(f.eks. #NotesSetFieldValue).
Kald af sletning af samme dokument to gange vil "ophæve" sletningen, medmindre der er udført
#NotesCommit. Det er først ved kald af #NotesCommit en sletning effektueres.
Dette svarer til brugerfladen i Lotus Notes.
3.5.4 Opdatering af ændringer
I XAL opererer man med begrebet TTS. Med TTSBEGIN, TTSABORT og TTSCOMMIT kan man
styre om data opdateres. Integrationskittet stiller en facilitet til rådighed, der svarer til dette system.
Dog kan man kun operere med eet dokument.
For at opdatere ændringer skal man kalde macroen #NotesCommit som afslutning.
Dette skal ske inden et andet aktuelt dokument udvælges og inden den aktuelle session lukkes
ned.
Tilsvarende kan man udnytte dette til evt. at annullere ændringer ved ikke at udføre #NotesCommit.
En variant af #NotesCommit er #NotesCommitNoRecalc, der også gemmer det aktuelle dokument,
men som sørger for ikke at genberegne formler på dokumentet.
3.5.5 Oplysninger om aktivt dokument
Brug af opdateringsmacroerne vil medføre fejlmelding, hvis ikke et Notes dokument er udvalgt. For
at checke om et dokument er aktivt kan macroen #NotesDocID benyttes. Denne macro returnerer
det aktive dokuments DocumentID.
Macroen kan også benyttes efter #NotesQueryUnique og #NotesGetUnique (hvis man ikke aflæser
&NotesText umiddelbart efter kald af disse macroer).
Ønsker man at benytte UNID i stedet kaldes macroen #NotesUNID.
24

Til mere avancerede anvendelser er det muligt at få yderligere information om det aktuelle dokument
og de enkelte felter.
Med kommandoen #NotesGetDocInfo har man mulighed for at få oplyst en række oplysninger om
det aktuelle dokument, herunder f.eks. dato for oprettelse og sidste rettelse, om det er et responsedokument
og i så fald angivelse af reference til ”father-document” m.v.
Tilsvarende kan #NotesGetFieldLength og #NotesGetItemInfo give information om de enkelte
felters værdier.
3.6 Rich-text
CONCORDE understøtter ikke Rich-text felter. Men der kan være en række situationer, hvor man
fra CONCORDE har brug for enten at se oplysninger i Notes, som ligger i Rich-text felter (f.eks.
billeder) eller man har brug for at gemme Rich-text oplysninger i Notes.
3.6.1 Opdatering til Notes
Man kan umiddelbart gemme almindelig text fra CONCORDE i et rich-text felt i Lotus Notes via
integrationskittet. Man skal altså ikke skelne mellem om det felt der opdateres i Notes er af typen
"Text" eller "Rich Text". Macroen #NotesSetFieldValue kan bruges til begge felttyper.
3.6.2 Læsning fra Notes
Tilsvarende gælder også ved læsning af data i Lotus Notes. Her benyttes macroen
#NotesQueryField på normal vis. Integrationskittet vil på bedste vis prøve at returnere data i et
format, som XAL kan "forstå". Rich-text felter i Notes kan indeholde en række informationer, som
ikke er "synlige" i XAL, f.eks. billeder, attachments, formateringskoder, flere linier m.v.
Alle formateringskoder fjernes ved læsning fra Notes. Alle billeder, attachments o.lign. overføres
ikke. Indeholder et rich-text felt flere linier tekst returnerer integrationskittet disse som een streng,
hvor linieskift er markeret med ASCII-værdierne 13 og 10 (CR/LF). Det er herefter op til programmøren
at udskille dette til flere XAL-linier, f.eks. i et notat felt. Alternativt kan
#NotesQueryRichFieldValue kaldes, hvorefter data kan læses fra temporære fil.
Ved brug af #NotesQuery, hvor resultatet returneres i en kommafil, benyttes en lidt anden metode.
Hvis et Notes dokument indholder et eller flere rich-text felter der indeholder flere linier, vil overførsel
af dette felt til en kommafil medføre at kommafilen vil splitte oplysningerne ud på flere linier.
Her et eksempel:
Nummer (Text) 1234
Navn (Text) Erik Jensen
Beskrivelse (Rich Text) En debitor
der er oprettet
med flere linier
Dette dokument ville resultere i følgende linier i kommafilen:
....
"1234","Erik Jensen","En debitor
der er oprettet
med flere linier"
....
25

Ved indlæsning af denne kommafil til CONCORDE vil XAL opfatte dette som tre dokumenter/records.
For at kunne håndtere denne problemstilling, er der to muligheder. Man kan isolere rich-text felter,
så disse ikke indgår direkte i kommafilen, eller man kan nøjes med kun at gemme første linie af
rich-text feltet i kommafilen.
3.6.2.1 Rich-text i separate filer
Ønsker man at bevare hele indholdet i Rich-text felterne vælges en metode, hvor al rich-text information
gemmes i separate kommafiler. Een fil pr. dokument og pr. rich-text felt. For at kunne tilgå
indholdet af disse felter, skal de altså indlæses via en separat indlæsning i XAL.
De separate rich-text filer gemmes i et underbibliotek med navnet "RichText".
Filerne navngives efter følgende syntaks:
.
f.eks. "00002E40.3", hvor "00002E40" er Notes dokumentets ID og "3" angiver at det er det tredje
felt på formen.
3.6.2.2 Valg af metode
Hvis man vælger ikke at gemme indholdet af rich-text felter i separate filer, vil de blive overført som
andre felttyper i kommafilen. Dog vil indholdet evt. blive afkortet til første linie, hvis feltet indeholder
flere linier.
Valg af metode sker med macroen #NotesSetRichSepMode. Aktuel værdi kan aflæses ved kald af
macroen #NotesGetRichSepMode. Værdien "1" angiver separate filer, mens "0" angiver gemning
af rich-textværdier i kommafilen.
Default værdi er, at gemme første linie af rich-text felter i kommafilen.
3.7 Fil-attachments
Integrationskittet indeholder diverse macroer til håndtering af attachments på Notes dokumenter.
Dette kan bl.a. benyttes til at vedhæfte f.eks. en tekstfil fra en CONCORDE rapport til et Notes dokument.
Alle filtyper kan dog vedhæftes.
Attachments tilføjes et Notes dokument med macroen #NotesAttachFile. Som første parameter
angives navnet på filen. En evt. anden parameter angiver det navn attachmentet får på dokumentet.
Eks.: #NotesAttachFile(‘c:\\autoexec.bat’,’AUTOEXEC’). Angives intet attachmentnavn oprettes
attachment med samme navn som filen (eksklusiv foranstillet path - i eksemplet ville navnet blive
"autoexec.bat").
26

Eksisterende attachments kan "detaches" (kopieres til en fil) med macroen #NotesDetachFile.
Også her angives filnavnet som første parameter. Dette filnavn skal ikke nødvendigvis være det
samme som filnavnet på filen som blev attachet oprindeligt. Man kan detache filen med et andet
filnavn. Som ovenfor angives et evt. attachmentnavn som anden parameter.
Eks. #NotesDetachFile("c:\\autoexec.ny","AUTOEXEC").
Her gemmes filen fra det første eksempel som en ny fil, så den originale ikke overskrives.
Om der findes attachements på det aktuelle dokument kan oplyses ved kald af macroen
#NotesExistsAttach.
Der er desuden en macro til fjernelse af attachments. Dette gøres med macroen
#NotesDeleteAttachment. Denne macro kan bruges enten til at slette samtlige attachments eller
blot en enkelt. Angives en parameter slettes kun attachmentet med dette navn. Angives ingen parametre
slettes alle attachments.
Alle operationer på attachments opererer med attachments direkte på dokumentet. Attachments i
Rich-text felter håndteres ikke - og slettes ej heller med macroen #NotesDeleteAttach.
3.8 Mail
Udover at kunne udveksle data med Lotus Notes, giver integrationskittet mulighed for at afsende
mails direkte fra CONCORDE. (Mails kan læses ved normal dataudveksling via f.eks. [$InBox]folderen).
Opbygningen af XAL-kode for at afsende mails fra CONCORDE adskiller sig fra de foregående
metoder, da opsætningen af mail-server, database og forms ikke skal sættes op af brugeren. Integrationskittet
finder selv de nødvendige oplysninger i NOTES.INI. Man skal altså ikke angive server
m.v. med macroerne #NotesServer, #NotesLogon, #NotesForm og #NotesView.
3.8.1 Forberedelse af mail
Mail rutinen i integrationskittet består af 3 tempi:
1. Forberedelse af mail
2. Opbygning af selve indholdet (brødteksten)
3. Afsendelse af mail
Først klargøres mail. Dette indebærer at følgende oplysninger angives:
• "SendTo", modtagers E-mail adresse (SKAL ANGIVES)
• "Subject", overskrift til mail
• evt. "CC", evt. andre modtagere af kopi (Carbon Copy)
• evt. "BCC", evt. andre modtagere af kopi (skjult for modtager) (Blind Carbon Copy)
Klargøring af mail sker med macroen #NotesPrepareMail. Macroen modtager 2-4 parametre i
ovenstående rækkefølge. CC og BCC (3. og 4. parameter) er valgfrie.
Et kald af macroen kunne se ud som følger:
#NotesPrepareMail("Erik Jensen/Acme","Sidste nyt","Ole Olsen/Acme,Jens
Jensen/Acme")
27

I eksemplet her er der også angivet 2 personer, som modtager en kopi af mailen.
3.8.2 Udfyldelse af indhold i mail
Næste skridt er at udfylde brødteksten i mailen - body feltet.
Dette kan gøres på to måder. En simpel metode, hvor man kun udfylder med almindelig tekst, og en
mere avanceret metode, hvor det er muligt at kombinere tekst og indhold af f.eks. ASCII-filer, richtext
filer (RTF) og/eller billeder (BMP, PCX eller TIFF (uncompressed)).
Den simple metode bruges til opbygningen af enkle mails, der består af almindelig brødtekst uden
behov for formatering m.v. Denne metode er hurtigere end den avancerede metode.
Brødteksten opbygges ved kald af macroen #NotesMailBodyText. Macroen kan kaldes et vilkårligt
antal gange, hvor hvert kald tilføjer en linie til mailen. Mails opbygget med denne metode skulle
kunne læses af alle tilgængelige mail-systemer. Dette er specielt interessant når modtagere af mailen
ikke benytter Notes mail (f.eks. Internet mail).
Mange af faciliteterne i den avancerede metode vil ofte ikke kunne læses af andre mail-systemer
(og hvis de kan læses er det oftest uden de formateringskoder der er benyttet).
Den mere avancerede metode benyttes via 2 macroer:
#NotesMailBody, som benyttes analogt med ovennævnte macro (#NotesMailBodyText) og
#NotesMailBodyFile som benyttes til at indflette indholdet af en fil.
Muligheden for f.eks. at indflette rich-text filer (RTF) giver mulighed for at formatere indholdet i mailen,
med f.eks. diverse fonts og effekter. Dette kræver dog at man opbygger sit indhold med richtext
koder. Kontakt evt. Intoint for yderligere information om dette.
Begge metoder kan suppleres med muligheden for at attache filer til mails. Dette gøres med
macroen #NotesMailAttachFile. Denne macro svarer til #NotesAttachFile (se afsnit 3.7).
3.8.3 Afsendelse af mail
Efter at mailen er klargjort kan den afsendes. Dette gøres meget simpelt med macroen
#NotesMailSend.
Man kan evt. angive en parameter - et filnavn. Hvis en sådan parameter angives, udfyldes bodyfeltet
med indholdet af filen (forudsat at filen kan konverteres af integrationskittet - se "kendte" filtyper i
foregående afsnit).
Eksisterende indhold, udfyldt med macroerne nævnt i foregående afsnit bibeholdes.
Nedenfor er angivet et eksempel på en XAL-kørsel der afsender en mail:
#MacroLoad(NOTES)
#NotesInit
#NotesMailPrepare("Support@intoint.com","Fejl")
#NotesMailBodyFile("c:\\billeder\\logo.bmp")
#NotesMailBody("")
#NotesMailBody("Jeg har følgende fejlmelding:")
#NotesMailBodyFile("c:\\temp\\scrndump.bmp")
#NotesMailBody("")
#NotesMailBody("Kan i hjælpe???")
28

#NotesMailBodyFile("c:\\billeder\\sign.bmp")
#NotesMailAttachFile("c:\\xal\\bogf.xal")
#NotesMailSend
#NotesClose
3.8.4 MAPI Mail
Benytter man ikke Lotus Notes til mail (men f.eks. kun til Web-server) er det muligt at benytte MAPI
protokollen til simple mails (uden attachments m.v.). Microsoft Outlook benytter bl.a. MAPI protokollen.
MAPI mail aktiveres via #NotesMailSetMAPI(”1”).
Har man brug for at angive MAPI profil og password gøres dette med macroerne
#NotesMAPIProfile og #NotesMAPIPassword.
Derved kan besked boxe der beder brugeren om disse oplysninger undgås.
Bemærk, at ikke al mail-funktionalitet er tilgængelig i dette integrationskit til MAPI.
3.8.5 Automatiske fejlmeldinger via mail
Integrationskittet giver mulighed for, at fejlsituationer ved integration mailes til f.eks. den edbansvarlige.
Dette kan lette den interne support, da de fleste relevante oplysninger indeholdes i mailen.
Denne facilitet er også specielt velegnet, hvis integrationskittet benyttes på en batchserver, hvor
evt. fejlmeldinger ikke nødvendigvis ses umiddelbart.
Aktivering af denne facilitet sker med macroen #NotesMailErrorTo, hvor modtageren angives som
parameter (flere modtagere kan angives adskilt med komma). Angives f.eks. følgende XAL-linier i
XAL-kørslen AUTOEXEC, vil Erik Jensen blive orienteret automatisk om alle fejlsituationer.
#MacroLoad(NOTES)
...
#NotesInit
#NotesMailErrorTo("Erik Jensen/Acme")
Et eksempel på en mail med en fejlbesked er vist nedenfor:
To: Erik Jensen/Acme
cc:
Subject: ERP2LN ERROR: NotesForm (2): Form werjkhewkjr does not exist
Error: NotesForm (2): Form werjkhewkjr does not exist
Date: 19/8/03 13:16:40
DLL Version: 1.0.1.143 - 18.08.2003
Handle: 2
User: CN=Flemming Nielsen/O=Intoint
Server: dev01
Database: Action\afdeling
Form:
View:
29

DocId: 0
3.9 Oplysninger om Notes design
Man kan komme i situationer, hvor man er interesseret i at kunne forespørge om et felt, form eller et
view findes i en Notes database eller man er interesseret i at få en liste med eksisterende designelementer.
Integrationskittet stiller en række macroer til rådighed, der kan give disse informationer. Der kan
forespørges på navne på felter, forms og views.
Fremgangsmåden er den samme for alle tre designelementtyper. For at kunne forespørge, skal
grundlaget for forespørgslen være forberedt. Ønsker man f.eks. at forespørge på en form, skal man
først være logget på databasen. Ønsker man at forespørge på et felt, skal formen først være udpeget.
3.9.1 Forespørgsel på eksistens af designelement navn
Med følgende macroer er det muligt at forespørge på eksistensen af designelementer:
#NotesExistsField, #NotesExistsForm og #NotesExistsView.
Returneres værdien "1" findes designelementet i Notes. Returneres "0" findes det ikke. Returneres
andre værdier, er dette fejlkoder.
Bemærk at disse macroer er ikke case-sensitive. #NotesExistsFieldName("Body") og
#NotesExistsFieldName("body") vil altså returnere samme svar på mail-formen "Memo".
3.9.2 Liste Notes designelementer
Ønsker man at få listet f.eks. felter på en form eller views i en database findes der 6 macroer til
dette:
#NotesFirstFieldName og #NotesNextFieldName,
#NotesFirstFormName og #NotesNextFormName,
#NotesFirstViewName og #NotesNextViewName.
En udskrift af alle felter på en form kunne f.eks. opbygges på følgende måde:
30

#MacroLoad(NOTES)
STR 40 &F
#NotesInit
#NotesOpenServer('LOCAL')
#NotesLogon('mail\\xxx.nsf')
#NotesForm('Memo')
SET &F = #NotesFirstField
WHILE &F>""
PRINT &F
SET &F = #NotesNextField
END
PAUSE
Tilsvarende kørsel kan laves for forms og views.
3.9.3 Type på designelement
Integrationskittet giver desuden mulighed for at give information om de forskellige designelementers
type.
Macroen #NotesFieldType returnerer typen på et Notes felt, f.eks. "RichText" eller "Number".
Macroen #NotesFormType returnerer typen på den aktuelle Notes form: "Main", "Response to
Main" eller "Response to Response".
Denne macro kræver at formen er valgt med #NotesForm.
Et eksempel på en kørsel der lister forms og deres type i Notes help-database er listet her:
#MacroLoad(NOTES)
STR 40 &F
#NotesInit
#NotesOpenServer('LOCAL')
#NotesLogon('Help4.nsf')
SET &F = #NotesFirstForm
WHILE &F>""
#NotesForm(&F)
PRINT &F," ",#NotesFormType
SET &F = #NotesNextForm
END
PAUSE
Der findes p.t. ingen tilsvarende funktioner til Notes views i integrationskittet.
Derimod findes macroen #NotesDatabaseTitle som returnerer det fulde navn på den aktuelle database
(ikke blot filnavnet (se #NotesDatabaseName) ).
31

3.10 Fejlsøgning
Integrationskittet stiller forskellige faciliteter til rådighed, som kan hjælpe med problemer ved udvikling
af applikationer med integration mellem CONCORDE og Lotus Notes.
De fleste macroer returnerer en returkode i &NotesText. Denne variabel kan så testes efter kaldet
og eventuelle fejl kan behandles.
Her et eksempel:
#NotesInit
#NotesOpenServer(&Server)
IF &NotesText "" THEN
SET BOX(1, "Fejl ved åbning af "+&Server,1)
RETURN 0
ENDIF
3.10.1 Fejl-beskeder
Når man har defineret og testet sin integrationsopgave, vil det kun være i sjældne tilfælde, at der
opstår fejl (som f.eks. hvis Domino serveren er lukket ned). Normalt vil fejlmeldinger fra DLL’en
derfor blive vist i en besked-box.
Ønsker man at afvikle en kørsel uovervåget og er man derfor interesseret i at kørslen IKKE må
afbrydes af fejl-beskeder, kan man med kommandoen #NotesMessages slå fejl-meldinger fra og
til. Hvis fejlmeldinger slås fra, bør man naturligvis være meget omhyggelig med håndtering af eventuelle
fejlmuligheder i sin XAL-kode.
Med kommandoen #NotesGetMessages, kan man få oplyst, om visning af fejlbeskeder er aktiveret.
3.10.2 Debugning til skærm
Da XAL komminikerer med Lotus Notes via en DLL, har man ikke mulighed for at se hvad der sker,
fra XAL laver et kald til Lotus Notes og til kaldet returnerer.
Med macroen #NotesDebug kan man aktivere en funktion, som viser forskellige detaljer kald fra
DLL'en som integrerer med Lotus Notes. Disse oplysninger kommer direkte fra DLL'en og vises
derfor i separate Windows vinduer. Funktionen slås til med #NotesDebug("1") og slås fra med
#NotesDebug("0"). Funktionen kan også deaktiveres ved at vælge "Cancel" i debug-vinduerne.
Aktivering af debug berører alle sessions – ikke kun den aktuelle.
Nedenfor er vist et eksempel på information fra DLL'en:
32

3.10.3 Debugning til log-fil
Ønsker man at få overvåget et system og har man ikke mulighed for løbende at overvåge skærmen
eller indeholder debugningen så mange informationer at det er uoverskueligt at håndtere via dialogboxene,
er det muligt at sende debug-information til en log-fil.
Med kommandoen #NotesLogFilNavn kan man angive navnet på denne logfil. #NotesClearLog
tømmer log-filen. Kaldes NotesLogFilNavn med en tom streng returneres til default logfil-opsætning.
Aktivering af debug-logning til fil sker med #NotesDLLLog(”1”), mens deaktivering sker med
#NotesDLLLog(”0”)
Aktivering af log berører alle sessions.
33

4. Reference
I dette afsnit gennemgås alle macroer.
Beskrivelsen af hver macro følger følgende skabelon
Macro-navn
Syntaks
Beskrivelse af hvorledes macro kaldes.
Parametre angives i parenteser.
Parameterværdier angives i kantede parenteser (). Indholdet imellem
de kantede parenteser, skal erstattes med den aktuelle værdi.
F.eks. kan #NotesDeleteID() i praksis se ud som
#NotesDeleteID("00003A08") eller #NotesDeleteID(&ID)
Parametre skal være konstanter (tekstværdier i "" eller variabler &xx).
Funktioner og beregninger kan ikke overføres (f.eks. er følgende ikke
gyldigt: #NotesForm("Test "+&FormNavn))
Parameterværdier der er optionelle (brug af parameter er valgfri)
angives med firkantede parenteser.
F.eks. kan #NotesForm[()] kaldes både med macroen
#NotesForm("Memo") og blot som #NotesForm
Input
Input-parametre, type angives i parentes (normalt "text")
Output
Evt. output parametre.
Returneres værdi direkte (funktion) angives dette som "direkte" ellers
angives hvilken variabel hvori returværdi returneres, normalt
"&NotesText", ,desuden angives type i parentes (normalt "text").
Funktion
Gennemgang af hvad macroen udfører
34

Eksempel
Evt. eksempel på brug af macroen.
Dette afsnit kan være udeladt, hvis et eksempel er skønnet overflødigt.
Eksemplerne vil ofte kun vise brudstykker af et program. Specielt er
initialiserings- og afslutningsmacroer normalt udeladt.
Fejlkoder
Evt. fejlkoder. Disse kan og bør checkes efter kald af macro, så XALkoden
kan håndtere evt. fejl.
Fejlkoder returneres altid i &NotesText
Er der ingen mulige fejlkoder, er dette afsnit ikke vist.
Afsnit
Afsnit hvor brugen af macro er beskrevet
Se også
Evt. henvisninger til relaterede macroer og afsnit
Macroerne listes alfabetisk.
35

#NotesAddQueryField
Syntaks
#NotesAddQueryField()
Input
(Text)
1. parameter: Feltnavn i Notes, som skal medtages ved næste Query
Output
Ingen
Funktion
Angiver et Notes-felt som skal medtages i kommafil ved næste kald af
#NotesQuery. Kommafil vil dog altid have DocId som første felt. Efterfølgende
felt-værdier listes i den rækkefølge hvori #NotesAddQuery-
Field er kaldt.
Eksempel
#NotesClearQueryFields
#NotesAddQueryField("Nummer")
#NotesAddQueryField("Navn")
#NotesQuery("Nummer>'100'")
Fejlkoder
"1": Felt findes ikke på form
"2": Aktuel form ikke angivet, brug #NotesForm
"3": Intet aktivt dokument
”4”: Maksimum antal søgefelter oversteget.
"99": "Exception error": Anden fejl fra integrationskit.
Aflæs fejlbesked på skærm.
Afsnit
Se også
#NotesClearFields
#NotesQuery
36

#NotesAppendFieldValue
Syntaks
#NotesAppendFieldValue(,[,"COMMIT"])
Input
(Text,Text[,Text])
1. Parameter: Navn på felt i Notes, hvortil værdi skal appendes
2. Parameter: Værdi
3. Parameter: Evt. angivelse af umiddelbar commit
Output
Ingen
Funktion
Denne macro tilføjer værdien angivet i anden parameter til feltet angivet
i første parameter. Husk Notes’ feltnavn er case-sensitive. Værdi
(2. parameter) skal altid være at typen text. Konvertér evt. andre formater
til text, inden kald af macro. Eksisterende indhold i feltet overskrives
ikke med denne macro.
Angives "COMMIT" som tredje parameter gemmes værdien i Notes
umiddelbart. Dette er anvendeligt ved en enkelt opdatering.
#NotesAppendFieldValue benyttes oftest ved multivalue-felter. Husk i
det tilfælde at angive skille-tegn (f.eks. ";" - se #NotesSetListDelim(.
Alternativt kan funktionen #NotesAppendMultiValue benyttes – hvis
der er tale om tekst-værdier i Lotus Notes
Eksempel
#NotesSelectID(F.NotesDocID)
#NotesSetFieldValue("Number","Værdi
1")
#NotesAppendFieldValue("Number","Værdi 2","Commit")
Fejlkoder
"1": Felt kendes ikke på form.
"2": Form ikke angivet, brug #NotesForm
"3": Ingen felter på form.
"99": "Exception error": Anden fejl fra integrationskit.
Aflæs fejlbesked på skærm.
Afsnit
Se også
#NotesSetFieldValue
#NotesAppendMultiValue
#NotesSetListDelim
37

#NotesAppendMultiValue
Syntaks
#NotesAppendMultiValue(,[,"COMMIT"])
Input
(Text,Text[,Text])
4. Parameter: Navn på felt i Notes, hvortil værdi skal appendes
5. Parameter: Værdi
6. Parameter: Evt. angivelse af umiddelbar commit
Output
Ingen
Funktion
Denne macro tilføjer værdien angivet i anden parameter til feltet angivet
i første parameter. Værdi (2. parameter) skal altid være at typen
text. Konvertér evt. andre formater til text, inden kald af macro. Eksi
sterende indhold i feltet overskrives ikke med denne macro.
Benyt denne macro til at tilføje en værdi til et multivalue felt i Lotus
Notes. Værdien vil altid blive tilføjet som ny multivalue i Lotus Notes.
Angives "COMMIT" som tredje parameter gemmes værdien i Notes
umiddelbart. Dette er anvendeligt ved en enkelt opdatering.
Eksempel
#NotesSelectID(F.NotesDocID)
#NotesSetFieldValue("Number","Værdi 1")
#NotesAppendMultiValueValue("Number","Værdi 2","Commit")
Fejlkoder
"1": Felt kendes ikke på form.
"2": Form ikke angivet, brug #NotesForm
"4": Ingen aktiv dokument.
"99": "Exception error": Anden fejl fra integrationskit.
Aflæs fejlbesked på skærm.
Afsnit
Se også
#NotesAppendFieldValue
#NotesSetFieldValue
#NotesSetListDelim
38

#NotesAttachFile
Syntaks
#NotesAttachFile([,])
Input
(Text, Text)
1. parameter: Filnavn på fil der skal attaches.
2. parameter: Evt. navn på attachment, udelades denne parameter
får attachment samme navn som filnavn (excl. foranstillet
path).
Output
Ingen
Funktion
Attacher fil angivet i første parameter på det aktuelle dokument (bemærk
at det ikke attaches til et specifikt rich-text felt, kun til selve
dokumentet). Attachment vil fremgå nederst på Notes dokumentet
med filnavnet. Hvis anden parameter angives, får attachmentet dette
navn i Notes dokumentet. Dette kan f.eks. bruges til et mere beskrivende
navn.
Eksempel
#NotesGetUnique("Nummer","123")
#NotesAttachFile("c:\\autoexec.bat","Opstart")
Fejlkoder
"2": Aktuel form ikke angivet, brug #NotesForm
"3": Intet aktivt dokument.
"98": Filen angivet i 1. parameter findes ikke eller kan ikke
læses.
"99": "Exception error": Anden fejl fra integrationskit.
Aflæs fejlbesked på skærm.
Afsnit
3.7
Se også
#NotesDetachFile
#NotesDeleteAttachment
#NotesMailAttachFile
39

#NotesClearLog
Syntaks
#NotesClearLog
Input
Ingen
Output
Ingen
Funktion
Nulstiller og tømmer aktuel log-fil.
Eksempel
#NotesLogFilNavn(‘debug.log’)
#NotesClearLog
#NotesDLLLog(‘1’)
#NotesDebug(‘1’)
#NotesSearchView(‘1234’)
Afsnit
3.10.3
Se også
#NotesDLLLog
#NotesLogFilNavn
#NotesDebug
40

#NotesClearQueryFields
Syntaks
#NotesClearQueryFields
Input
Ingen
Output
Ingen
Funktion
Nulstiller liste med felter der skal medtages i næste #NotesQuery.
Eksempel
#NotesClearQueryFields
#NotesAddQueryField("Nummer")
#NotesAddQueryField("Navn")
#NotesQuery("Nummer>'100'")
Se også
#NotesAddQueryField
#NotesQuery
41

#NotesClose
Syntaks
#NotesClose
Input
Ingen
Output
Ingen
Funktion
Afslutter session med Lotus Notes. Efter udførelse af macro, skal
man udføre #NotesLogon igen for at kommunikere med Notes.
Fejlkoder
Ingen til behandling i XAL
Kontakt Deres forhandler, hvis fejlværdi returneres i &NotesText.
Afsnit
3.2.3
Se også
#NotesLogon
42

#NotesCommit
Syntaks
#NotesCommit
Input
Ingen
Output
(Text)
Hvis &NotesText > "99" indeholdes heri det DocId det opdaterede
dokument har i Notes.
Er &NotesText mindre eller lig "99" indeholdes en fejlkode.
Funktion
Opdatering af ændringer i Lotus Notes. Først når denne macro udføres
gemmes data i Lotus Notes. Man kan kun operere med eet aktivt
dokument. Skift til nyt aktuelt dokument vil medføre, at ændringer ikke
opdateres, med mindre #NotesCommit kaldes.
Eksempel
#NotesGetUnique("Nummer","123")
#NotesSetFieldValue("Navn","Regneark")
#NotesSetFieldValue("Ansvarlig","HKR")
#NotesCommit
#NotesGetUnique("Nummer","124")
Fejlkoder
"1": Ingen data at gemme - mangler f.eks. at angive
feltværdier eller kald af commit uden aktuelt dokument
"99": "Exception error": Anden fejl fra integrationskit.
Aflæs fejlbesked på skærm.
Afsnit
3.5.4
Se også
#NotesCreateNew
#NotesSetFieldValue
#NotesDeleteCurrent
#NotesDeleteID
43

#NotesCommitNoRecalc
Syntaks
#NotesCommitNoRecalc
Input
Ingen
Output
(Text)
Hvis &NotesText > "99" indeholder &NotestText det opdaterede dokuments
Notes DocId.
Er &NotesText mindre eller lig "99" indeholdes en fejlkode.
Funktion
Svarer til #NotesCommit (se denne). Dog vil formler på formen ikke
gen-beregnes ved skrivning af dokument.
Fejlkoder
"1": Ingen data at gemme - mangler f.eks. at angive
feltværdier eller kald af commit uden aktuelt dokument.
"99": "Exception error": Anden fejl fra integrationskit.
Aflæs fejlbesked på skærm.
Afsnit
3.5.4
Se også
#NotesCommit
44

#NotesCompareField
Syntaks
#NotesCompareField(,)
Input
(Text, Text)
1. parameter: Feltnavn i Notes der skal sammenlignes med
2. parameter: Værdi fra XAL der skal sammenlignes med
Output
(Boolean: Direkte)
0: Feltværdi i Notes er forskellig fra 2. parameter
1: Feltværdien i Notes er den samme som 2. parameter
Funktion
Sammenligner værdien af Notes-feltet udpeget med 1. parameter
med værdien af 2. parameter. Returnerer 1 (TRUE) hvis de er ens.
Nyttig ved minimering af opdateringer og for at undgå at opdatere
unødvendigt og dermed fjerne "read"-marks.
Bemærk at værdien aflæses direkte og ikke i &NotesText
Eksempel
Introduce Afdeling[NumIdx,&Nummer]
#NotesGetUnique("AfdNummer",Nummer)
IF StrLen(&NotesText)>2 THEN
IF #NotesCompareField("AfdNavn",Navn] THEN
PRINT "Afdeling ",Nummer," er OK i Notes"
ENDIF
ENDIF
Fejlkoder
"2": Aktuel form ikke angivet, brug #NotesForm
"3": Felt findes ikke på Notes-form
”99”: Fejl i parametre.
Afsnit
3.3
Se også
#NotesQueryField
45

#NotesConnect
Syntaks
#NotesConnect
Input
Ingen
Output
Ingen
Funktion
Samlet etablering af forbindelse til Lotus Notes med standardværdier.
Disse værdier er gemt i de globale variable:
&NotesServer, &NotesDatabase, &NotesForm og &NotesView
Macroen udfører et kald af følgende macroer (uden parametre):
#NotesOpenServer, #NotesLogon, #NotesForm og #NotesView
Fejlkoder
Returnerer fejlkode fra fejl i de kaldte macroer.
Afsnit
Fejl! Henvisningskilde ikke fundet.
Se også
#NotesOpenServer
#NotesLogon
#NotesForm
#NotesView
46

#NotesCreateNew
Syntaks
#NotesCreateNew([“NoCommit”])
Input
(Text)
1. parameter: NOCOMMIT - Evt. angivelse at tomt dokument ikke
skal gemmes ved oprettelse
Output
(Text: &NotesText)
Hvis &NotesText > "99" indeholdes heri DocId på det nye dokument.
Er &NotesText mindre eller lig "99" indeholdes en fejlkode.
Funktion
Opretter et nyt tomt dokument. Udfyld værdier med #NotesSetField-
Value og gem dokumentet med #NotesCommit.
Dokumentet oprettes i den aktuelle form (#NotesForm). Hvis formtypen
i Notes er et "response-to-response document", vil den nye
form blive oprettet som et response-dokument til det aktuelle dokument.
Tilsvarende bliver et "response-document" oprettet som response-document
til hoveddokumentet.
Bemærk at det nye dokument committes automatisk med denne kommando,
der gemmes altså et tomt Notes-dokument.
Eksempel
#NotesCreateNew
#NotesSetFieldValue("Nummer","125")
#NotesCommit
Fejlkoder
"2": Aktuel form ikke angivet, brug #NotesForm
"99": "Exception error": Anden fejl fra integrationskit.
Aflæs fejlbesked på skærm.
Afsnit
3.5.1
Se også
#NotesForm
#NotesFormName
#NotesSetFieldValue
#NotesCommit
47

#NotesDatabaseName
Syntaks
#NotesDatabaseName
Input
Ingen
Output
(Text: Direkte)
Filnavn på aktuelle Notes database
Funktion
Returnerer aktuel database-filnavn, som er sat med #NotesLogon
eller #NotesOpenDialog.
Eksempel
PRINT "Aktuel database: ",#NotesDatabaseName
PAUSE
Afsnit
3.3.1
Se også
#NotesLogon
#NotesOpenDialog
48

#NotesDatabaseTitle
Syntaks
#NotesDatabaseTitle
Input
Ingen
Output
(Text: Direkte)
Titel på aktuelle Notes database
Funktion
Returnerer aktuelt database titel, ikke at forveksle med database
navn som angiver databasens filnavn.
Kan først udføres efter brug af #NotesLogon.
Eksempel
#NotesLogon(‘help4.nsf’)
PRINT "Databasefil...: ",#NotesDatabase
PRINT "Databasetitel.: ",#NotesDatabaseTitle
PAUSE
Fejlkoder
"2": Der er ikke valgt en database
Afsnit
3.3.1
Se også
#NotesDatabaseName
49

#NotesDebug
Syntaks
#NotesDebug({"0"|"1"})
Input
(Text)
Angivelse af om debug skal aktiveres ("1") eller deaktiveres ("0").
Output
Ingen
Funktion
Aktiverer funktion, så alle kald til DLL'en vises i Windows. Desuden vil
yderligere oplysninger ofte vises, hvis DLL-funktionen er kompleks.
Eksempel
#NotesDebug("1")
#NotesQuery('Form="Memo"')
#NotesDebug("0")
Afsnit
3.10.2
Se også
#NotesDLLLog
50

#NotesDelay
Syntaks
#NotesDelay()
Input
(Text)
Angivelse af forsinkelse i millisekunder mellem hvert DLL Notes-kald.
Output
Ingen
Funktion
For at undgå at belaste Lotus Domino servere ved opdatering kan
man, med #NotesDelay angive en pause mellem hvert DLL kald til
Lotus Notes/Domino. Pausen angives i millisekunder. Typisk 10-100
ms. Opdateringen bliver herved lidt langsommere, men man kan
undgå at serveren bliver meget langsom.
Angivelse af ”0” som parameter slår forsinkelse fra.
Eksempel
#NotesDelay("100")
#NotesSearchFirst
WHILE StrLen(&NotesText) > 2
#NotesSetFieldValue("Name",DebTable.Name)
#NotesCommit
#NotesSearchNext
END
#NotesDelay("0")
51

#NotesDeleteAttachment
Syntaks
#NotesDeleteAttachment[()]
Input
(Text)
1. parameter: Evt. navn på attachment, udelades denne parameter
slettes alle attachment på dokumentet (ekskl. attachments i
rich-text felter)
Output
Ingen
Funktion
Fjerner et eller alle attachments på aktuelle Notes dokument. Bemærk
at det er attachment-navnet der angives. Angives ingen parametre
fjernes alle attachments.
Hvis et attachment er gemt af brugeren direkte på et rich-text felt, vil
ikonet på attachmentet ikke blive slettet. Selve attachmentet bliver
slettet.
Eksempel
#NotesGetUnique("Nummer","123")
#NotesDeleteAttachment("Opstart") {Fjern gl.}
#NotesAttachFile("c:\\autoexec.bat","Opstart")
Fejlkoder
"1": Der findes ikke attachment med det angivne navn på
det
aktuelle dokument.
"2": Aktuel form ikke angivet, brug #NotesForm
"3": Intet aktivt dokument.
"99": "Exception error": Anden fejl fra integrationskit.
Aflæs fejlbesked på skærm.
Afsnit
3.7
Se også
#NotesDetachFile
#NotesAttachFile
52

#NotesDeleteCurrent
Syntaks
#NotesDeleteCurrent
Input
Ingen
Output
Ingen
Funktion
Sletter aktuelle dokument. Slettes først endeligt ved kald af #NotesCommit.
Eksempel
#NotesForm("Afdeling")
#NotesgetUnique("Nummer","125")
#NotesDeleteCurrent
#NotesCommit
Fejlkoder
"1": Intet aktivt dokument at slette, brug f.eks. #NotesGetUnique
"2": Form ikke angivet, brug #NotesForm
"99": "Exception error": Anden fejl fra integrationskit.
Aflæs fejlbesked på skærm.
Afsnit
3.5.3
Se også
#NotesDeleteID
#NotesCommit
53

#NotesDeleteID
Syntaks
#NotesDeleteID()
Input
(Text)
Entydigt DocId på dokument der skal slettes.
Output
Ingen
Funktion
Sletter et dokument ved udpegning af dokument-ID. DocId kan f.eks.
hentes ved #NotesQuery eller ved at gemme DocId i et felt på XALkartotek.
Eksempel
SEARCH Afdeling WHERE Nummer < "1000"
#NotesDeleteID(Afdeling.NotesDocID)
DELETE Afdeling
END
Fejlkoder
"1": DocId er forkert.
"2": Form er ikke angivet, brug #NotesForm
"99": "Exception error": Anden fejl fra integrationskit.
Aflæs fejlbesked på skærm.
Afsnit
3.5.3
Se også
#NotesSelectID
#NotesDeleteCurrent
#NotesCommit
54

#NotesDeleteTempFil
Syntaks
# NotesDeleteTempFil
Input
Ingen
Output
Ingen
Funktion
Sletter en temporær fil der benyttes ved f.eks. #NotesQuery.
Eksempel
...
#NotesTmpFilNavn(&FileName)
#NotesQuery(&Qstr)
READ &FileName AS TEXT INTO
...
END
#NotesDeleteTempFil
Fejlkoder
Afsnit
3.3.3
Se også
#NotesTmpFilNavn
#NotesGetTmpFilNavn
55

#NotesDetachFile
Syntaks
#NotesDetachFile([,])
Input
(Text, Text)
1. parameter: Filnavn på fil der skal detaches til.
2. parameter: Evt. navn på attachment der skal detaches. Udelades
denne parameter detaches attachment med samme
navn som 1. parameter (excl. foranstillet path).
Output
Ingen
Funktion
Detacher attachment angivet i evt. anden parameter på aktuelle dokument.
Hvis anden parameter ikke angives, udvælges attachment
med samme navn som filnavnet angivet i første parameter. Attachment
detaches til fil angivet i første parameter.
Eksempel
#NotesAttachFile("c:\\original","Temp")
#NotesDetachFile("c:\\kopi","Temp")
#NotesDeleteAttachment("Temp")
Fejlkoder
"1": Der findes ikke attachment med det angivne navn på
det
aktuelle dokument.
"2": Aktuel form ikke angivet, brug #NotesForm
"98": Filnavn ikke angivet.
"99": "Exception error": Anden fejl fra integrationskit.
Aflæs fejlbesked på skærm.
Afsnit
3.7
Se også
#NotesAttachFile
#NotesDeleteAttachment
56

#NotesDLLVersion
Syntaks
#NotesDLLVersion
Input
Ingen
Output
(Text: Direkte)
Versionsnummer og dato - f.eks. "1.0.1.34 - 01.05.2003"
Funktion
Returnerer aktuel version og frigivelsesdato på det Windows programbibliotek
(ERP2LN.DLL), som varetager kommunikationen med
Lotus Notes.
Eksempel
PRINT "DLL version: ",#NotesDLLVersion
PAUSE
Afsnit
3.3.2
57

#NotesDocID
Syntaks
#NotesDocID
Input
Ingen
Output
(Text: Direkte)
DocId på aktivt dokument i Notes.
Funktion
Returnerer DocId på det aktive dokument i Notes. Et dokument kan
gøres aktivt med #NotesGetUnique, #NotesSelectID, og #NotesQueryUnique.
Kan benyttes til check af om et dokument er aktivt, inden der opereres
på dokumentet.
Eksempel
IF #NotesDocID>"" THEN
#NotesSetFieldValue("Nummer","1234")
ENDIF
Afsnit
3.5.5
58

#NotesExistsAttach
Syntaks
#NotesExistsAttach ()
Input
(Text)
Navn på det attachment man ønsker at checke, om eksisterer på det
aktuelle dokument.
Output
Ingen
Funktion
Bruges til at checke om der findes et attachment med det angivne
navn på det udvalgte dokument.
Eksempel
#NotesSearchFirst
IF #NotesExistsAttachment(&AttName) THEN
#NotesDetachFile(&AttName)
ENDIF
Fejlkoder
"0": Attachment findes IKKE på det aktuelle dokument.
"1": Attachment FINDES på det aktuelle dokument.
"2": Aktuel form ikke angivet, brug #NotesForm
"3": Dokument ikke udpeget.
"98": Attachmentnavn ikke angivet.
"99": "Exception error": Anden fejl fra integrationskit.
Aflæs fejlbesked på skærm.
Afsnit
3.7
Se også
#NotesAttachFile
#NotesDetachFile
#NotesDeleteAttachment
59

#NotesExistsField
Syntaks
#NotesExistsField ()
Input
(Text)
Navn på det felt man ønsker at checke, om eksisterer på den aktuelle
form.
Output
(Text: Direkte)
"0": Der findes ikke et felt med dette navn på formen
"1": Feltet eksisterer
>"1": Fejlværdi
Funktion
Bruges til at checke om der findes et felt med det angivne navn på
den aktuelle form. Feltet behøves ikke nødvendigvis at findes på det
aktuelle dokument, blot på designet af formen. Man skal ikke nødvendigvis
have udpeget et aktuelt dokument for at benytte macroen. Man
skal dog have udpeget hvilken form man bruger (#NotesForm)
Eksempel
#NotesSelectID("000013E0")
IF #NotesExistsField("Nummer")=="1" THEN
#NotesSetFieldValue("Nummer","22")
ENDIF
Fejlkoder
"2": Aktuel form ikke angivet, brug #NotesForm
"99": "Exception error": Anden fejl fra integrationskit.
Aflæs fejlbesked på skærm.
Afsnit
3.9.1
Se også
#NotesExistsForm
#NotesExistsView
#NotesFirstField
60

#NotesExistsForm
Syntaks
#NotesExistsForm()
Input
(Text)
Navn på den form man ønsker at checke, om eksisterer i den aktuelle
database. Man kan også benytte en af formens aliaser.
Output
(Text: Direkte)
"0": Der findes ikke en form med dette navn i databasen
"1": Formen findes i databasen
>"1": Fejlværdi
Funktion
Bruges til at checke om der findes en form med det angivne navn i
den aktuelle database. Man skal have udpeget databasen inden
macroen kaldes (brug #NotesLogon).
Eksempel
IF #NotesExistsForm("Demo")=="1" THEN
#NotesForm("Demo")
ELSE
PRINT "Formen ‘Demo’ er ikke oprettet"
ENDIF
PAUSE
Fejlkoder
"2": Mangler at logge på database
"99": "Exception error": Anden fejl fra integrationskit.
Aflæs fejlbesked på skærm.
Afsnit
3.9.1
Se også
#NotesExistsField
#NotesExistsView
#NotesFirstForm
61

#NotesExistsView
Syntaks
#NotesExistsView()
Input
(Text)
Navn på det view man ønsker at checke, om eksisterer i den aktuelle
database. Man kan også benytte et af viewets aliaser.
Output
(Text: Direkte)
"0": Der findes ikke et view med dette navn i databasen
"1": Viewet findes i databasen
>"1": Fejlværdi
Funktion
Bruges til at checke om der findes et view med det angivne navn i
den aktuelle database. Man skal have udpeget databasen inden
macroen kaldes (brug #NotesLogon).
Eksempel
IF #NotesExistsView("All")=="1" THEN
#NotesView("All")
ELSE
PRINT "Viewet ‘All’ skal defineres i Notes"
ENDIF
PAUSE
Fejlkoder
"2": Mangler at logge på database
"99": "Exception error": Anden fejl fra integrationskit.
Aflæs fejlbesked på skærm.
Afsnit
3.9.1
Se også
#NotesExistsField
#NotesExistsForm
#NotesFirstView
62

#NotesFieldType
Syntaks
#NotesFieldType([])
Input
(Text)
Evt. angivelse af Notes feltnavn.
Output
(Text: Direkte)
Notes felttype for feltet. Evt. fejlkode.
Funktion
Benyttes til at aflæse hvilken type feltet har i Notes, f.eks. Rich-text
eller Number. En komplet liste over felttyper der kan returneres er
listet i Appendix 3.
Angives ingen parametre bruges aktuelt felt (#NotesSetField).
Form skal være valgt med #NotesForm inden brug af macro.
Eksempel
#NotesForm("Test")
#NotesGetUnique("Nummer","SALG")
IF #NotesFieldType("Dato")=="DateTime" THEN
SET &D = Date2Str(Today(),123,2,3,2,3,2)
#NotesSetFieldValue("Dato",&D)
ENDIF
Fejlkoder
"2": Aktuel form ikke angivet, brug #NotesForm
"99": "Exception error": Anden fejl fra integrationskit.
Aflæs fejlbesked på skærm.
Afsnit
3.9.3
Se også
#NotesFormType
63

#NotesFirstField
Syntaks
#NotesFirstField
Input
Ingen
Output
(Text: Direkte)
Navn på første felt på den aktuelle forms design
Funktion
Udpeger det første felt defineret på formen (ikke den aktuelle form
men på designet) og returnerer navnet på feltet.
Denne macro er, i kombination med #NotesNextField, velegnet ved
indlæsning fra kommafil efter brug af #NotesQuery.
Eksempel
SET &F = #NotesFirstField
WHILE &F’’
PRINT &F
SET &F = #NotesNextField
END
Fejlkoder
"2": Aktuel form ikke angivet, brug #NotesForm
"99": "Exception error": Anden fejl fra integrationskit.
Aflæs fejlbesked på skærm.
Afsnit
3.9.2
Se også
#NotesNextField
#NotesFirstForm
#NotesFirstView
64

#NotesFirstForm
Syntaks
#NotesFirstForm
Input
Ingen
Output
(Text: Direkte)
Navn på første form i den aktuelle database.
Funktion
Udpeger den første form i den aktuelle database og returnerer navnet
på formen.
Der returneres både navne på almindelige forms, subforms og billeder
(images).
Der skal være foretaget valg af database med #NotesLogon forinden.
Eksempel
SET &F = #NotesFirstForm
WHILE &F’’
PRINT &F
SET &F = #NotesNextForm
END
Fejlkoder
"2": Mangler at logge på database.
"99": "Exception error": Anden fejl fra integrationskit.
Aflæs fejlbesked på skærm.
Afsnit
3.9.2
Se også
#NotesNextForm
#NotesFirstField
#NotesFirstView
65

#NotesFirstView
Syntaks
#NotesFirstView
Input
Ingen
Output
(Text: Direkte)
Navn på første view i den aktuelle database
Funktion
Udpeger det første view i den aktuelle database og returnerer navnet
på dette view.
Der skal være foretaget valg af database med #NotesLogon forinden.
Eksempel
SET &F = #NotesFirstView
WHILE &F’’
PRINT &F
SET &F = #NotesNextView
END
Fejlkoder
"2": Mangler at logge på database.
"99": "Exception error": Anden fejl fra integrationskit.
Aflæs fejlbesked på skærm.
Afsnit
3.9.2
Se også
#NotesNextView
#NotesFirstField
#NotesFirstForm
66

#NotesForm
Syntaks
#NotesForm()
Input
(Text)
Navn på form i Lotus Notes
Output
Ingen
Funktion
Angivelse af form i Notes, som skal bruges ved operationer af Notes.
Der er også mulighed for at angive et alias på formen.
Eksempel
#NotesForm("Person")
#NotesGetUnique("Navn=’Erik Jensen’")
Fejlkoder
"1": Form findes ikke i Notes database. Husk at også form-
navne er case-sensitive.
"9": Der er ikke foretaget logon på Notes server. Brug
#NotesOpenServer
Afsnit
3.2.2.3
Se også
#NotesFormName
67

#NotesFormName
Syntaks
#NotesFormName
Input
Ingen
Output
(Text: Direkte)
Navn på aktuel form i Lotus Notes
Funktion
Benyttes til at aflæse hvilken form den aktuelle session har åben i
Lotus Notes.
Eksempel
IF #NotesFormName "Afdeling" THEN
PRINT "Form ikke klargjort"
ENDIF
Afsnit
3.3.1
Se også
#NotesFormName
68

#NotesFormType
Syntaks
#NotesFormType
Input
Ingen
Output
(Text: Direkte)
Notes formtype for aktuel form. Evt. fejlkode.
Funktion
Benyttes til at aflæse hvilken type den aktuelle form har i Notes.
Der kan returneres følgende typer
• "Main"
• "Response to Main"
• "Response to Response"
Form skal være valgt med #NotesForm inden brug af macro.
Bemærk at evt. fejlkode evt. kan returneres. Test evt. længde på
returværdi.
Eksempel
#NotesForm("Test")
PRINT "Formtype: ",#NotesFormType
Fejlkoder
"2": Aktuel form ikke angivet, brug #NotesForm
"99": "Exception error": Anden fejl fra integrationskit.
Aflæs fejlbesked på skærm.
Afsnit
3.9.3
Se også
#NotesFormType
69

#NotesGetDocInfo
Syntaks
#NotesGetDocInfo()
Input
(Text)
Type af information (property) der ønskes
Output
(String: Direkte)
Property værdi
Funktion
Benyttes til forespørgsel på oplysninger om aktuelle dokument. Følgende
informationer kan hentes:
"DOCID" DocId på aktuelt dokument
"UNID" UNID
"ATTACH_COUNT" Antal attachments
"CREATED" Oprettelsesdato
"LAST_MODIFIED" Sidste rettelse
"LAST_ACCESSED" Sidste tilgang til dokument
"ADDED" Tilføjet til denne replica
"IS_RESPONSE" Response dokument ("0": Nej,"1": Ja)
"PARENT_ID" Henvisning til Parent (ved response)
Eksempel
#NotesSearchFirst
PRINT "Sidst rettet: ",#NotesGetDocInfo(’LAST_MODIFIED’)
PAUSE
Afsnit
3.5.5
Se også
#NotesGetItemInfo
70

#NotesGetFieldLength
Syntaks
#NotesGetFieldLength()
Input
(Text)
Angivelse af Notes feltnavn.
Output
(Int: Direkte)
>=0: Antal tegn i felt
4000 eller anden intern fejl
Afsnit
3.5.5
Se også
#NotesGetItemInfo
71

#NotesGetFieldValue
Syntaks
#NotesGetFieldValue()
Input
(Text)
Angivelse af navn på felt i Notes, som man skal have værdien af.
Output
(Text: direkte)
Feltets værdi
Funktion
Opslag på aktuelle dokument efter feltværdi. Dokument skal være
udvalgt inden forespørgsel. Til forskel fra NotesQueryField laves intet
check på om feltet findes på den aktuelle form.
Eksempel
#NotesGetUnique("Nummer","123")
PRINT "Navn : ",#NotesGetFieldValue("Navn")
PRINT "Ref : ",#NotesGetFieldValue("Ref")
Afsnit
3.4.5
Se også
#NotesPutFieldValue
#NotesQueryField
72

#NotesGetFoundDocs
Syntaks
#NotesGetFoundDocs
Input
Ingen
Output
(Int: Direkte)
Antal af dokumenter fundet ved sidste søgning
Funktion
Returnerer antallet af fundne dokumenter ved sidste NotesQuery.
Eksempel
#NotesQuery("@all")
PRINT "Antal dokumenter ialt:: ", #NotesGetFoundDocs
PAUSE
Fejlkoder
-2: Form ikke aktiv, husk #NotesForm
Afsnit
3.4.2
Se også
#NotesQuery
73

#NotesGetHandle
Syntaks
#NotesGetHandle
Input
Ingen
Output
(Number)
Aktuel sessions handle nummer
Funktion
Returnerer den aktuelle sessions handle nummer. Relevant hvis der
skiftes mellem sessions med #NotesSetHandle
Eksempel
IF #NotesGetHandle 2 THEN
#NotesSetHandle(2)
#NotesOpenServer("Local")
#NotesLogon("MyDB.nsf")
#NotesForm("Form 2")
#NotesView("View 2")
ENDIF
Afsnit
3.2.4
Se også
#NotesSetHandle
74

#NotesGetItemInfo
Syntaks
#NotesGetItemInfo
Input
(Text, Text)
1. parameter: Navn på felt i Notes hvorpå der skal søges
2. parameter: Property der forespørges på
Output
(String: Direkte)
Property værdi
Funktion
Benyttes til forespørgsel på oplysninger om et specifikt item (data) på
det aktuelle dokument. Følgende informationer kan hentes:
"TYPE" Datatype (TEXT, NUMBER, DATETIME...)
"LENGTH" Længde af data i bytes
Fejlkoder
”1” Felt ikke fundet på form.
”2”: Form ikke aktiv, husk #NotesForm
Afsnit
3.5.5
Se også
#NotesGetDocInfo
75

#NotesGetMessages
Syntaks
#NotesGetMessages
Input
Ingen
Output
(String: Direkte)
"0": Fejlbeskeder vises ikke.
"1": Fejlbeskeder vises.
Funktion
Returnerer status på om fejlbeskeder vises i Windows, når der er fejl
ved integrationen mellem XAL og Notes.
Se nærmere beskrivelse i #NotesMessages.
Afsnit
3.10
Se også
#NotesMessages
76

#NotesGetRichSepMode
Syntaks
#NotesGetRichSepMode
Input
Ingen
Output
(String: Direkte)
"0": Rich-text felter gemmes i hoved kommafil ved #NotesQuery
"1": Rich-text felter gemmes i separate kommafiler
Funktion
Returnerer status på hvorledes rich-text filer returneres ved #NotesQuery.
Se under #NotesRichSepMode og i afsnit 3.6.2.1
Afsnit
3.6.2.1
Se også
#NotesRichSepMode
77

#NotesGetTmpFilnavn
Syntaks
#NotesGetTmpFilnavn
Input
Ingen
Output
(String: Direkte)
Navn på aktuelle temporære fil
Funktion
Returnerer navnet på den aktuelle temporære fil.
Afsnit
3.3.3
Se også
#NotesTmpFilNavn
78

#NotesGetUnique
Syntaks
#NotesGetUnique(,)
Input
(Text, Text)
1. parameter: Navn på felt i Notes hvorpå der skal søges.
2. parameter: Værdi der skal bruges til opslag.
Output
(Text: &NotesText)
Hvis &NotesText > "99" indeholdes heri DocId på det fundne dokument
i Notes.
Er &NotesText mindre eller lig "99" indeholdes en fejlkode.
Funktion
Denne macro bruges til at fremfinde et dokument i Notes via en nøgle.
Nøglefeltet angives som første parameter. Der laves et opslag i
Lotus Notes efter et dokument der har anden parameters værdi i
feltet. Macroen returnerer en fejl, hvis opslaget finder flere dokumenter.
Er der mulighed for at opslaget kan resultere i at flere dokumenter
fremfindes, skal macroen #NotesQuery anvendes.
Husk at Notes er case-sensitiv på feltnavne.
Eksempel
#Prompt "Indtast afdelingsnummer " GET(&Input)
INPUT AT 10,10
#PromptAbort
#NotesGetUnique("Nummer",&Input)
IF &NotesText>"99" THEN
PRINT "Notes Ref: ", #NotesQueryField("Ref")
ENDIF
Fejlkoder
"0": Intet dokument fundet
"1": Felt findes ikke på Notes-form
"2": Form ikke aktiv, husk #NotesForm
"3": Ingen felter fundet på form eller mere end eet dokument
fundet, Brug #NotesQuery
"4": Forkert antal argumenter, der skal være 2
"99": "Exception error": Anden fejl fra integrationskit.
Aflæs fejlbesked på skærm.
Afsnit
3.4.6
Se også
#NotesSelectID
#NotesQuery
79

#NotesIF
Syntaks
#NotesIF
Input
Ingen
Output
(Integer (Boolean): Direkte)
0: Der er ikke etableret forbindelse til DLL-fil (endnu).
1: Der er etableret forbindelse til DLL-fil.
Funktion
Returnerer status på forbindelse til Windows DLL programbiblioteket
(ERP2LN.DLL). #NotesIF returnerer TRUE (1) efter succesfuld kald
af #NotesInit.
Eksempel
IF #NotesIF THEN
PRINT "Notes Interface er etableret"
ENDIF
Afsnit
3.3.2
Se også
#NotesInit
#NotesDLLVersion
80

#NotesImportFile
Syntaks
#NotesImportFile(,)
Input
(Text,Text)
1. parameter: Navn på rich-text felt
2. parameter: Navn på fil der skal importeres
Output
Ingen
Funktion
Importerer filen angivet i 2. parameter til rich-text feltet angivet i første
parameter. Benyttes til indlejring af grafik og rich-text. Kombineres
med #NotesSetRichFieldValue for "almindelig" brødtekst.
Den angivne fil adderes til eksisterende indhold i rich-text feltet.
Bemærk at visse af de understøttede grafikformater findes i en række
varianter, som ikke alle er understøttet af integrationskittet. Det anbefales
at teste eksisterende grafikprogrammers kompatibilitet (sende
mail til sig selv).
Eksempel
#NotesSetRichFieldValue("Body","Rich text fil:")
#NotesImportFile("Body","c:\\temp\\fil.rtf")
#NotesSetRichFieldValue("------------")
#NotesCommit
Fejlkoder
"1": Felt findes ikke på Notes-form
"2": Form ikke aktiv, husk #NotesForm
"3": Angivne felt er ikke et rich-text felt
”4”: Der er ikke noget aktivt dokument.
"98": Angivne fil findes ikke eller kan ikke læses.
"99": "Exception error": Anden fejl fra integrationskit.
Aflæs fejlbesked på skærm.
Afsnit
3.5.2
Se også
#NotesSetRichFieldValue
#NotesMailBodyFile
81

#NotesInit
Syntaks
#NotesInit[()]
Input
(Text)
Evt. angivelse af navn på DLL-fil (optionel)
Output
Ingen
Funktion
Etablere forbindelse til det Windows programbibliotek, der varetager
kommunikationen til Lotus Notes. Kald af denne macro er påkrævet
for at kunne bruge integrationsmacroerne.
Der er mulighed for at angive et andet navn på DLL programbiblioteket.
Angives ingen parameter, bruges defaultværdien "ERP2LN".
Fejlkoder
"1": Fejl ved initialisering af DLL, check at DLL-filen er
tilgængelig. Geninstaller evt. filen.
"2": Fejl ved check-kald i DLL fil
"99": "Exception error": Anden fejl fra integrationskit.
Aflæs fejlbesked på skærm.
Afsnit
3.2.1
Se også
#NotesIF
#NotesDLLVersion
82

#NotesIsDemoVersion
Syntaks
# NotesIsDemoVersion
Input
Ingen
Output
(Text: Direkte)
”0”: IKKE en demo version af DLL
”1”: DLL ER en demo version
Funktion
Angiver om aktuelle integrations-DLL er en demo-version (ikke slizet
med korrekt kode).
Afsnit
3.3.2
Se også
#NotesDLLVersion
83

#NotesDLLLog
Syntaks
#NotesDLLLog({"0"|"1"})
Input
(Text)
Angivelse af om log af debuginfo skal ske til fil
Output
Ingen
Funktion
I visse situationer kan det være relevant at spore debug-information
uden at skulle overvåge computeren. Med #NotesDLLLog kan man
aktivere skrivning af log til fil istedet for skærm.
Husk at angive navn på logfil og at deaktivere fil-log, når debug er
overstået, da alle beskeder skrives til fil og altså ikke vises.
Eksempel
#NotesLogFilNavn(‘debug.log’)
#NotesClearLog
#NotesDLLLog(‘1’)
#NotesDebug(‘1’)
#NotesSearchView(‘1234’)
#NotesDLLLog(‘0’)
Afsnit
3.10.3
Se også
#NotesClearLog
#NotesLogFilNavn
84

#NotesLogFilnavn
Syntaks
#NotesLogFilnavn[()]
Input
(Text)
Angivelse af fil debug-logning skal ske til
Output
Ingen
Funktion
Ved brug af #NotesDLLLog benyttes denne funktion til at angive filnavn
på fil hvortil log-information skal skrives.
Kaldes macroen med en tom streng som filnavn anvendes default
log-filnavnet (kan defineres i erp2ln.ini).
Eksempel
#NotesLogFileName(‘debug.log’)
#NotesClearLog
#NotesDLLLog(‘1’)
#NotesDebug(‘1’)
#NotesSearchView(‘1234’)
#NotesDebug(‘0’)
#NotesDLLLog(‘0’)
#NotesLogFileName(‘’)
Afsnit
3.10.3
Se også
#NotesDLLLog
#NotesClearLog
#NotesDebug
85

#NotesLogon
Syntaks
#NotesLogon[()]
Input
(Text)
Evt. angivelse af databasenavn i Lotus Notes
Output
Ingen
Funktion
Åbner en session med Lotus Notes, ved angivelse af databasenavn.
Ved login checker Lotus Notes brugerens rettigheder. Arbejdspladsens
aktuelle opsætning (User ID, Location m.v.) bruges ved etablering
af forbindelse. Er det første kontakt med Notes serveren afkræves
brugerens password.
Angives intet databasenavn, bruges værdien gemt i
&NotesDatabase.
Eksempel
#NotesInit
#NotesServer("Local")
#NotesLogon("Afdeling")
IF &NotesText>"" THEN
PRINT "Fejl ved tilkobling til Afdeling på
Notes server Local"
ENDIF
Fejlkoder
"9": Logon ikke fuldført da servernavnet ikke er angivet.
Benyt NotesOpenServer til at sætte servernavnet.
"99": "Exception error": Anden fejl fra integrationskit.
Aflæs fejlbesked på skærm.
Afsnit
3.2.2.2
Se også
#NotesDatabaseName
86

#NotesMailAttachFile
Syntaks
#NotesMailAttachFile([,])
Input
(Text, Text)
1. parameter: Filnavn på fil der skal attaches til aktuel mail
2. parameter: Evt. navn på attachment. Udelades denne parameter
får attachment samme navn som filnavn.
Output
Ingen
Funktion
Attacher fil angivet i første parameter på aktuelle mail (bemærk at
filen ikke attaches til et specifikt rich-text felt, kun til selve dokumentet).
Attachment vil fremgå nederst på Notes mail med filnavnet. Hvis
anden parameter angives, får attachmentet dette navn i Notes mailen.
Dette kan f.eks. bruges til et mere beskrivende navn.
Eksempel
#NotesPrepareMail("nn@acme.com","Testmail")
#NotesMailBodyText(" Se denne attachment")
#NotesMailAttachFile("c:\\sjov.bmp","Se her")
#NotesSendMail
Fejlkoder
"2": Form ikke aktiv, husk #NotesForm
”3”: Der er ikke noget aktivt dokument.
"98": Filen angivet i 1. parameter findes ikke eller kan ikke
læses.
"99": "Exception error": Anden fejl fra integrationskit.
Aflæs fejlbesked på skærm.
Afsnit
3.8.2
Se også
#NotesAttachFile
#NotesMailBodyFile
87

#NotesMailBody
Syntaks
#NotesMailBody()
Input
(Text)
Brødtekst til mail
Output
Ingen
Funktion
Tilføjer tekst til mail i body-feltet. Ved gentagne kald af macroen opbygges
flere linier.
Denne macro skal benyttes, når man vil importere andre filformater
med macroen #NotesMailBodyFile!
Svarer funktionsmæssigt til #NotesMailBodyText, men er en smule
langsommere, da al tekst overføres via temporær fil.
Eksempel
#NotesPrepareMail("nn@acme.com","Testmail")
#NotesMailBody("Første linie")
#NotesMailBody("Anden linie")
#NotesSendMail
Fejlkoder
”1”: Der opstod en fejl ved åbning af mailserver og database.
"98": Fejl ved skrivning til temporær fil.
"99": "Exception error": Anden fejl fra integrationskit.
Aflæs fejlbesked på skærm.
Afsnit
3.8.2
Se også
#NotesMailBodyText
#NotesMailBodyFile
88

#NotesMailBodyFile
Syntaks
#NotesMailBodyFile()
Input
(Text)
Navn på fil der skal importeres i mail
Output
Ingen
Funktion
Importerer fil i aktuel mail. Benyttes til indlejring af grafik og rich-text.
Kombineres med #NotesMailBody for "almindelig" brødtekst.
Se nærmere i afsnit 3.8.2 for en nærmere diskussion af brugen af
denne macro.
Bemærk at visse af de understøttede grafikformater findes i en række
varianter, som ikke alle er understøttet af integrationskittet. Det anbefales
at teste eksisterende grafikprogrammers kompatibilitet (sende
mail til sig selv).
Eksempel
#NotesPrepareMail("nn@acme.com","Testmail")
#NotesMailBody("Rich text fil:")
#NotesMailBodyFile("c:\\temp\\fil.rtf")
#NotesMailBodyFile("c:\\temp\\underskrift.pcx")
#NotesSendMail
Fejlkoder
"98": Filen angivet i 1. parameter findes ikke eller kan ikke
læses.
"99": "Exception error": Anden fejl fra integrationskit.
Aflæs fejlbesked på skærm.
Afsnit
3.8.2
Se også
#NotesMailBody
#NotesMailSend
89

#NotesMailBodyText
Syntaks
#NotesMailBodyText()
Input
(Text)
Brødtekst til mail
Output
Ingen
Funktion
Tilføjer tekst til mail i body-feltet. Ved gentagne kald af macroen opbygges
flere linier.
Denne macro benyttes, når man IKKE vil importere andre filformater
med macroen #NotesMailBodyFile!
Svarer funktionsmæssigt til #NotesMailBody, men er hurtigere, da al
udveksling til Notes sker direkte.
Eksempel
#NotesPrepareMail( "nn@acme.com","Testmail")
#NotesMailBodyText("Første linie")
#NotesMailBodyText("Anden linie")
#NotesSendMail
Fejlkoder
"1": Forsøgt brugt i samtidigt med #NotesMailBody eller
#NotesMailBodyFile. Dette kan ikke gøres i samme
mail (se dog #NotesMailSend)
Afsnit
3.8.2
Se også
#NotesMailBodyText
#NotesMailBodyFile
#NotesMailSend
90

#NotesMailErrorTo
Syntaks
#NotesMailBody()
Input
(Text)
E-mail adresse på den person, som skal tilsendes alle fejlmeldinger.
Output
Ingen
Funktion
Man har mulighed for at tilsende en eller flere personer en kopi af alle
fejlmeldinger fra integrationskittet. Ved at kalde denne macro, vil alle
efterfølgende fejlmeldinger på denne arbejdsstation blive e-mailet til
den eller de angivne personer. Dette kan lette supporten væsentligt
og samtidigt lette overvågning af f.eks. batchserver.
Eksempel
#NotesInit
#NotesMailErrorTo("Erik Jensen/Acme")
Afsnit
3.8.5
91

#NotesMailGetUsername
Syntaks
#NotesMailGetUsername
Input
Ingen
Output
(Text, Direkte)
Lotus Notes brugernavn på aktuelle bruger.
Funktion
Returnerer fuldt kvalificeret Lotus Notes brugernavn, f.eks.:
”CN=Niels Nielsen/O=Intoint”.
Eksempel
SET &UserName = #NotesMailGetUsername
#NotesSetFieldValue("Principal",&UserName)
#NotesCommit
92

#NotesMailMAPIPassword
Syntaks
#NotesMailMAPIPassword()
Input
(Text)
Password til brug ved login til MAPI.
Output
Ingen
Funktion
Hvis der skal benyttes password ved etablering af forbindelse til MAPI
mail system (f.eks. MS Outlook) kan dette angives med denne kommando.
Eksempel
#NotesMailSetMAPI
#NotesMailMAPIProfile("MS Exchange Settings")
#NotesMailMAPIPassword("MyPassword")
Afsnit
3.8.4
Se også
#NotesMailSetMAPI
#NotesMailMAPIProfile
93

#NotesMailMAPIProfile
Syntaks
#NotesMailMAPIProfile()
Input
(Text)
Profil til brug ved login til MAPI.
Output
Ingen
Funktion
For at undgå, at der manuelt skal vælges profil ved opstart af f.eks.
MS Outlook, kan profilen angives med #NotesMailMAPIProfile.
Eksempel
#NotesMailSetMAPI
#NotesMailMAPIProfile("MS Exchange Settings")
#NotesMailMAPIPassword("MyPassword")
Afsnit
3.8.4
Se også
#NotesMailSetMAPI
#NotesMailMAPIPassword
94

#NotesMailPrepare
Syntaks
#NotesMailPrepare(,
[,)[,]])
Input
(Text,Text,[Text,[Text]])
1. parameter: E-mail adresse på modtager(e) af mail.
2. parameter: Overskrift til mail ("Subject").
3. parameter: Evt. CC på mail.
4. parameter: Evt. BCC på mail.
Output
Ingen
Funktion
Klargør mail til afsendelse. Denne macro initialiserer mailen, hvor
indholdet udfyldes efterfølgende med #NotesMailBodyXXX macroerne.
Bemærk at 3. og 4. parameter er optionelle.
E-mail adresser (også CC og BCC) kan adskilles med kommaer, så
flere modtagere kan angives.
Eksempel
#NotesMailPrepare ("nn@acme.com,xx@acme.com",
"Test","","Erik Jensen/Acme")
#NotesMailBodyText("Hva så?")
#NotesSendMail
Afsnit
3.8.1, 3.8.2
Se også
#NotesMailBody
#NotesMailBodyText
#NotesMailBodyFile
#NotesMailSend
95

#NotesMailSend
Syntaks
#NotesMailSend([])
Input
(Text)
Evt. Navn på fil der skal importeres i mail
Output
Ingen
Funktion
Afsender klargjort mail. Angives et filnavn importeres denne i slutningen
af mailens brødtekstfelt, også selvom dette er opbygget med
macroen #NotesMailBodyText.
Eksempel
#NotesPrepareMail("nn@acme.com","Min
config.sys")
#NotesSendMail(‘c:\\config.sys’)
Fejlkoder
"1": Mail ikke klargjort (SendTo mangler)
"98": Filen angivet i 1. parameter findes ikke eller kan ikke
læses.
"99": "Exception error": Anden fejl fra integrationskit.
Aflæs fejlbesked på skærm.
Afsnit
3.8.3
Se også
#NotesMailPrepare
#NotesMailBodyFile
96

#NotesMailSetMAPI
Syntaks
#NotesMailSetMAPI("0"|"1")
Input
(Text)
Markering af om MAPI skal benyttes til mails.
Output
Ingen
Funktion
Angivelse af, at MAPI mail protokollen (benyttes bl.a. af Microsoft
Outlook), skal benyttes i stedet for Lotus Notes mail.
Eksempel
#NotesMailSetMAPI("1")
Afsnit
3.8.4
Se også
#NotesMailMAPIPassword
#NotesMailMAPIProfile
97

#NotesMessages
Syntaks
#NotesMessages({"0"|"1"})
Input
(Text)
Angivelse af om fejlmeldinger skal vises på skærmen
Output
Ingen
Funktion
Denne macro muliggør at "skjule" fejlmeldinger. Dette kan være nyttigt
i forbindelse med f.eks. batchopdatering og andet. Det kræver dog
at man indbygger gode testfunktioner i sin XAL-kode, som aflæser
&NotesText efter hver macro og reagerer på fejlsituationer.
Parameter "0" frakobler fejlmeldinger. Parameter "1" tilkobler igen.
Bemærk at disse "settings" er globale for hele XAL-sessionen. Brug
evt. #NotesGetMessages til at aflæse aktuel værdi og sæt værdien
tilbage til den oprindelige værdi efter brug.
Eksempel
SET &Husk = #NotesGetMessages
#NotesMessages("0")
#NotesSetFieldValue("Felt","eee")
IF &NotesText=’’ THEN
...
ENDIF
#NotesMessages(&Husk)
Afsnit
3.10.1
Se også
#NotesGetMessages
98

#NotesMoveFirst
Syntaks
#NotesMoveFirst
Input
Ingen
Output
(Text)
Notes Document ID på fundet dokument eller fejlkode.
Funktion
Udpeger og vælger det første dokument i resultatet fra sidste søgning
(#NotesQuery). Returnerer dokumentets DocId i &NotesText eller
alternativt en fejlkode.
Eksempel
#NotesQuery('Name="A*"')
#NotesMoveFirst
WHILE StrLen(&NotesText)>2
PRINT "Antal: ",#NotesQueryField('Antal')
#NotesMoveNext
END
Fejlkoder
"0": Ingen data i resultat-sæt
"2": Aktuel form ikke angivet, brug #NotesForm
"99": "Exception error": Anden fejl fra integrationskit.
Aflæs fejlbesked på skærm.
Afsnit
3.4.2
Se også
#NotesQuery
#NotesMoveNext
#NotesMovePrev
#NotesMoveLast
99

#NotesMoveLast
Syntaks
#NotesMoveLast
Input
Ingen
Output
(Text)
Notes Document ID på fundet dokument eller fejlkode.
Funktion
Udpeger og vælger det sidste dokument i resultatet fra sidste søgning
(#NotesQuery). Returnerer dokumentets DocId i &NotesText eller
alternativt en fejlkode.
Eksempel
#NotesQuery('Name="A*"')
#NotesMoveLast
WHILE StrLen(&NotesText)>2
PRINT "Antal: ",#NotesQueryField('Antal')
#NotesMovePrev
END
Fejlkoder
"0": Ingen data i resultat-sæt
"2": Aktuel form ikke angivet, brug #NotesForm
"99": "Exception error": Anden fejl fra integrationskit.
Aflæs fejlbesked på skærm.
Afsnit
3.4.2
Se også
#NotesQuery
#NotesMoveNext
#NotesMovePrev
#NotesMoveFirst
100

#NotesMoveNext
Syntaks
#NotesMoveNext
Input
Ingen
Output
(Text)
Notes Document ID på fundet dokument eller fejlkode.
Funktion
Udpeger og vælger det næste dokument i resultatet fra sidste søgning
(#NotesQuery). Returnerer dokumentets DocId i &NotesText
eller alternativt en fejlkode (f.eks. hvis der ikke er flere, returneres '').
Eksempel
#NotesQuery('Name="A*"')
#NotesMoveFirst
WHILE StrLen(&NotesText)>2
PRINT "Antal: " ,#NotesQueryField('Antal')
#NotesMoveNext
END
Fejlkoder
"": Ikke flere data i resultat-sæt
"0": Ingen data i resultat-sæt
"2": Aktuel form ikke angivet, brug #NotesForm
"99": "Exception error": Anden fejl fra integrationskit.
Aflæs fejlbesked på skærm.
Afsnit
3.4.2
Se også
#NotesQuery
#NotesMoveFirst
#NotesMovePrev
#NotesMoveLast
101

#NotesMovePrev
Syntaks
#NotesMovePrev
Input
Ingen
Output
(Text)
Notes Document ID på fundet dokument eller fejlkode.
Funktion
Udpeger og vælger det forrige dokument i resultatet fra sidste søgning
(#NotesQuery). Returnerer dokumentets DocId i &NotesText
eller alternativt en fejlkode (f.eks. hvis der ikke er flere, returneres '').
Eksempel
#NotesQuery('Name="A*"')
#NotesMoveLast
WHILE StrLen(&NotesText)>2
PRINT "Antal: ",#NotesQueryField('Antal')
#NotesMovePrev
END
Fejlkoder
"": Ikke flere data i resultat-sæt
"0": Ingen data i resultat-sæt
"2": Aktuel form ikke angivet, brug #NotesForm
"99": "Exception error": Anden fejl fra integrationskit.
Aflæs fejlbesked på skærm.
Afsnit
3.4.2
Se også
#NotesQuery
#NotesMoveNext
#NotesMoveFirst
#NotesMoveLast
102

#NotesNextField
Syntaks
#NotesNextField
Input
Ingen
Output
(Text: Direkte)
Navn på næste felt på den aktuelle forms design.
Funktion
Udpeger det næste felt defineret på formen (ikke den aktuelle form
men på designet) og returnerer navnet på feltet. Kræver at #Notes-
FirstField er kaldt forinden. Bruges typisk i løkke, hvor alle feltnavne
aflæses.
Eksempel
SET &F = #NotesFirstField
WHILE &F’’
PRINT &F
SET &F = #NotesNextField
END
Fejlkoder
"2": Aktuel form ikke angivet, brug #NotesForm
"99": "Exception error": Anden fejl fra integrationskit.
Aflæs fejlbesked på skærm.
Afsnit
3.9.2
Se også
#NotesFirstField
#NotesNextForm
#NotesNextView
103

#NotesNextForm
Syntaks
#NotesNextForm
Input
Ingen
Output
(Text: Direkte)
Navn på næste form i den aktuelle databases design.
Funktion
Udpeger den næste form defineret i databasen og returnerer navnet
på formen. Kræver at #NotesFirstForm er kaldt forinden.
Der returneres både navne på almindelige forms og på subforms.
Eksempel
SET &F = #NotesFirstForm
WHILE &F’’
PRINT &F
SET &F = #NotesNextForm
END
Fejlkoder
"2": Mangler at logge på database
"99": "Exception error": Anden fejl fra integrationskit.
Aflæs fejlbesked på skærm.
Afsnit
3.9.2
Se også
#NotesFirstForm
#NotesNextField
#NotesNextView
104

#NotesNextView
Syntaks
#NotesNextView
Input
Ingen
Output
(Text: Direkte)
Navn på næste view i den aktuelle database.
Funktion
Udpeger det næste view i den aktuelle database og returnerer navnet
på dette view.
Kræver at #NotesFirstView er kaldt forinden.
Eksempel
SET &F = #NotesFirstView
WHILE &F’’
PRINT &F
SET &F = #NotesNextView
END
Fejlkoder
"2": Mangler at logge på database
"99": "Exception error": Anden fejl fra integrationskit.
Aflæs fejlbesked på skærm.
Afsnit
3.9.2
Se også
#NotesFirstView
#NotesNextField
#NotesNextForm
105

#NotesOpenDialog
Syntaks
#NotesOpenDialog[("OPEN")]
Input
(Text)
Evt. angivelse af, om der skal foretages logon. Dette angives med
parameteren "OPEN"
Output
Ingen
Funktion
Denne makro kan både benyttes til at "browse" mellem Notes servere
og databaser. Ved at angive tillægsparameteren "OPEN", vil man
desuden få etableret en session med den valgte server og det valgte
kartotek. I dette tilfælde gemmes værdierne i variablerne
&NotesServer og &NotesDatabase. Vær forsigtig ved valg af andre
databaser, hvis XAL-koden forudsætter, at et bestemt kartotek er
valgt. Brug af DocId er ikke pålideligt ved opslag i samme database
på forskellige servere, da samme dokument næsten altid vil have
forskellig placering i databasen. Brug i stedet #NotesGetUnique.
Eksempel
#NotesOpenDialog("OPEN") { Frit valg af server }
#NotesLogon("Afdeling") { Men kartotek er låst }
Afsnit
3.2.2.1 og 3.2.2.2
Se også
#NotesServer
#NotesLogon
106

#NotesOpenServer
Syntaks
#NotesOpenServer[()]
Input
(Text)
Evt. angivelse af servernavn
Output
Ingen
Funktion
Angivelse af hvilken server der skal etableres forbindelse til.
Angives intet servernavn som parameter, vælges servernavn gemt i
variablen &NotesServer.
Servernavnet "Local" angiver, at databaserne skal findes på den lokale
arbejdsplads.
Fejlkoder
"99": "Exception error": Anden fejl fra integrationskit.
Aflæs fejlbesked på skærm.
Afsnit
3.2.2.1
Se også
#NotesOpenDialog
#NotesServerName
107

#NotesPutFieldValue
Syntaks
#NotesPutFieldValue(,)
Input
(Text,Text)
1. Parameter: Navn på felt i Notes, hvis værdi skal sættes
2. Parameter: Værdi
Output
Ingen
Funktion
Denne macro sætter feltet angivet i første parameter til værdien angivet
i anden parameter. Til forskel fra #NotesSetFieldValue, skal feltet
ikke være defineret på designet af den aktuelle form.
Værdi (2. parameter) skal altid være at typen text. Konvertér evt. andre
formater til text, inden kald af macro.
Det er muligt at angive, at feltet skal gemmes med en anden type i
Notes (da feltet jo ikke nødvendigvis er defineret på formen). Dette
gøres ved at foranstille feltnavn med #, datatype, efterfulgt af ### (se
eksempel).
Data der overføres til dato-felter skal altid være af formatet ”dd-mmåå”
eller ”dd-mm-åååå” – altså med bindestreg mellem talværdier og
med dag som første værdi.
Eksempel
#NotesSelectID(F.NotesDocID)
SET &S = Date2Str(F.Dato,123,2,3,2,3,2)
#NotesPutFieldValue("#DATETIME#Dato",&S)
#NotesCommit
Fejlkoder
"99": "Exception error": Anden fejl fra integrationskit.
Aflæs fejlbesked på skærm.
Afsnit
3.5.2
Se også
#NotesSetFieldValue
108

#NotesQuery
Syntaks
#NotesQuery()
Input
(Text)
Angivelse af Notes SELECT kommando, der bruges til selektion af
dokumenter. Angives blank ("") udvælges alle dokumenter i view.
Parameter skal angives. Ordet "SELECT" er valgfri.
Output
(eventuel Kommafil)
Resultatet af forespørgslen returneres i en kommafil og internt i hukommelsen
i et resultat-sæt.
Funktion
Denne makro bruges til generelle opslag efter Notes dokumenter.
Angives ingen parametre, returneres alle dokumenter i det aktuelle
view. Dette kan f.eks. anvendes, når man har views i Notes, der foretager
den nødvendige selektion.
Angives en parameter, skal denne være en gyldig Notes selektion.
Der kan anvendes Notes formula’s (f.eks. "SELECT @All" eller blot
"@All").
Hvis temporær fil er defineret gemmes data i kommafil. Husk at slette
kommafilen efter brug (#NotesDeleteTempFil).
Der kan ”bladres” i data med #NotesMoveFirst, og #NotesMoveNext.
Eksempel
#NotesQuery(‘@contains(Nummer;"1")’)
Fejlkoder
"0": Ingen data fundet
"1": Filfejl ved dannelse af kommafil
"9": Form eller view ikke defineret, brug #NotesForm eller
#NotesView
"99": "Exception error": Anden fejl fra integrationskit.
Aflæs fejlbesked på skærm.
Afsnit
3.4.1
109

#NotesQueryField
Syntaks
#NotesQueryField()
Input
(Text)
Angivelse af navn på felt i Notes, som man skal have værdien af.
Output
(Text: direkte)
Feltets værdi
Funktion
Opslag på aktuelle dokument efter feltværdi. Dokument skal være
udvalgt inden forespørgsel. Husk at angivelse af feltnavn skal være
eksakt (Notes er case-sensitiv).
Returværdi er altid i text. Hentes en anden værditype, f.eks. dato eller
numerisk værdi, skal denne efterfølgende konverteres.
Eksempel
#NotesGetUnique("Nummer","123")
PRINT "Afdelingsnavn: ",#NotesQueryField("Navn")
PRINT "Notes Ref : ",#NotesQueryField("Ref")
Fejlkoder
"1": Felt ikke fundet på form
"2": Form ikke angivet. Brug #NotesForm først
"3": Intet aktivt dokument
Afsnit
3.4.5
Se også
#NotesSetFieldValue
110

#NotesQueryRichTextField
Syntaks
#NotesQueryRichTextField()
Input
(Text)
Angivelse af navn på felt i Notes, som man skal have værdien af.
Output
(Text: direkte)
Feltets værdi
Funktion
Opslag på aktuelle dokument efter feltværdi. Dokument skal være
udvalgt inden forespørgsel. Husk at angivelse af feltnavn skal være
eksakt (Notes er case-sensitiv).
Returværdi er altid i text.
Til forskel fra #NotesQueryField returneres værdien ligeledes i den
temporære fil (Se #NotesTmpFilnavn). Derved er det muligt at læse
indhold af richtext felter der strækker sig over flere linier.
Eksempel
#NotesGetUnique("Nummer","123")
IF StrLen(#NotesQueryRichTextField('RT'))>2 THEN
READ &Filnavn1 AS COMMA INTO (&S)
PRINT &S
END
ENDIF
Fejlkoder
"1": Felt ikke fundet på form
"2": Form ikke angivet. Brug #NotesForm først
"3": Intet aktivt dokument
Afsnit
3.4.5
Se også
#NotesQueryField
111

#NotesQueryUnique
Syntaks
#NotesQueryUnique()
Input
(Text)
Angivelse af Notes SELECT kommando, der bruges til selektion af
eet Notes dokument.
Output
(Text)
Notes Document ID på fundet dokument eller fejlkode.
Funktion
Denne makro bruges til opslag efter eet specifikt Notes dokument,
der kan udpeges via et gyldigt SELECT statement.
Angives en parameter, skal denne være en gyldig Notes selektion.
Det anses som en fejl, hvis der returneres mere end eet dokument.
Macroen er handy til opslag via et eller flere XAL-nøglefelter (se eksempel).
Udvidet funktionalitet:
Foranstil ’ ANY@@@’ i første parameter for at tillade flere dokumenter
i resultatet. Fejlkoden ”3” vil ikke forekomme.
Foranstil ’ MANUAL @@@’ i første parameter for at slå den automatiske
tilføjelse af ’Form=’ til søgningen.
Eksempel
SET &S = ‘Sag="’+Sag+’" & Afsnit="’+Afsnit+’"’
{Husk " omkring}
#NotesQueryUnique(&S)
IF StrLen(&NotesText)>2 THEN
...
Fejlkoder
"0": Ingen data fundet
"1": Aktuel form ikke angivet, brug #NotesForm
"3": Mere end eet dokument fundet
"99": "Exception error": Anden fejl fra integrationskit.
Aflæs fejlbesked på skærm.
Afsnit
3.4.3
Se også
#NotesQuery
112

#NotesRemoveItem
Syntaks
#NotesRemoveItem()
Input
(Text)
Angivelse af feltnavn der skal slettes fra det aktive dokument.
Output
Ingen
Funktion
Denne makro bruges til at slettet et felt på det aktive dokument. Feltet
behøver ikke at findes på den aktive form.
Hvis det angivet felt er af typen multivalue, så vil alle værdier blive
slettet.
Hvis det angivet feltnavn findes på formen, vil det automatisk blive
gen-oprettet med en tom streng næste gang dokumentet gemmes.
Dette kan undgås ved at benytte #NotesCommitNoCalc i stedet for
#NotesCommit.
Eksempel
#NotesRemoveItem(‘Nummer’)
Fejlkoder
"2": Ingen dokument aktivt.
"99": "Exception error": Anden fejl fra integrationskit.
Aflæs fejlbesked på skærm.
Afsnit
Se også
#NotesQuery
113

#NotesRunAgent
Syntaks
#NotesRunAgent[]
Input
(Text)
Navn på Notes agent der skal afvikles
Output
Ingen
Funktion
Eksekverer Notes macro i Lotus Notes.
Eksempel
#NotesLogon('Database.nsf')
#NotesRunAgent("ProcessFields")
114

#NotesSave
Syntaks
#NotesSave
Input
(Text)
Eventuelle special-flags
Output
Ingen
Funktion
Denne funktion er erstattatet af #NotesCommitRecalc. Et kald til denne
funktion vil automatisk kalde #NotesCommitRecalc.
Eksempel
#NotesSetFieldValue('Number',&s)
#NotesCommitNoRecalc
Afsnit
3.5.4
Se også
#NotesCommitNoRecalc
115

#NotesSearchFirst
Syntaks
# NotesSearchFirst
Input
-
Output
(Text)
Notes Document ID på fundet dokument eller fejlkode.
Funktion
Returnerer første dokument i aktuelle view. Ved at benytte opslag via
view bliver opslag meget hurtigere end ved Query.
View skal være åbnet.
View skal være designet til at være sorteret i alle kolonner der
benyttes til opslag, kolonner SKAL være af typen text og må ikke
indeholde en feltformel der er defineret som en ”konstant”.
Eksempel
#NotesSearchFirst
WHILE StrLen(&NotesText)>2
Print "Navn: ",#NotesQueryField('Navn')
#NotesSearchNext
END
Fejlkoder
"0": Ingen data fundet
"1": View ikke angivet. Brug #NotesView først
"2": Form ikke angivet. Brug #NotesForm først
”99": Diverse interne DLL fejl
Afsnit
3.4.4
Se også
#NotesSearchNext
#NotesSearchView
116

#NotesSearchNext
Syntaks
# NotesSearchNext
Input
-
Output
(Text)
Notes Document ID på fundet dokument eller fejlkode.
Funktion
Returnerer næste dokument i aktuelle view. Ved at benytte opslag via
view bliver opslag meget hurtigere end ved Query.
Kan kun benyttes efter NotesSearchFirst eller NotesSearchView.
View skal være åbnet.
Bemærk, at der efter kald af #NotesSearchView kun kan bladres frem
blandt de documenter I viewet, der opfylder søge-kriteriet I #Notes-
SeachView.
Eksempel
#NotesSearchFirst
WHILE StrLen(&NotesText)>2
Print "Navn: ",#NotesQueryField('Navn')
#NotesSearchNext
END
Fejlkoder
"0": Ikke flere dokumenter
"1": View ikke angivet. Brug #NotesView først
"2": Form ikke angivet. Brug #NotesForm først
”99": Diverse interne DLL fejl
Afsnit
3.4.4
Se også
#NotesSearchFirst
#NotesSearchView
117

#NotesSearchView
Syntaks
# NotesSearchView()
Input
(Text)
Angivelse af værdi der skal bruges ved opslag i view
Output
(Text)
Notes Document ID på fundet dokument eller fejlkode.
Funktion
Returnerer første dokument i aktuelle view som matcher søgeværdi.
Svarer til ”Type-ahead” i view i Notes.
Ved at benytte opslag via view bliver opslag meget hurtigere end ved
Query. Bør altid benyttes ved større datamængder.
View skal være åbnet.
View skal være designet til at være sorteret i alle kolonner der
benyttes til opslag, kolonner SKAL være af typen text og må ikke
indeholde en feltformel der er defineret som en ”konstant”.
Er der flere søgenøgler, skal søgeværdierne været adskilt med et
skilletegn (default semikolon (”;”)). Desuden skal kolonner i view i
Notes matche parameter rækkefølge.
Eksempel
#NotesSearchView('Jensen;Ole')
WHILE StrLen(&NotesText)>2
Print "Navn: ",#NotesQueryField('Navn')
#NotesSearchNext
END
Fejlkoder
"0": Ingen data fundet
"1": View ikke angivet. Brug #NotesView først
"9": Form ikke angivet. Brug #NotesForm først
”99": Diverse interne DLL fejl
Afsnit
3.4.4
Se også
#NotesSearchNext
#NotesSearchView
#NotesSetDelim
118

#NotesSelectID
Syntaks
#NotesSelectID()
Input
(Text)
Notes Document ID på dokument der skal hentes.
Output
Ingen
Funktion
Direkte opslag af Notes dokument via kendt DocId. Dette DocId kan
f.eks. være fundet via #NotesQuery, hvor DocId indeholdes som første
felt i hver linie i kommafilen.
Denne macro er meget anvendelig, hvor man har gemt en henvisning
til et specifikt Notes dokument i et felt i et XAL-kartotek.
Eksempel
SET &ID = Afdeling.NotesDocID
#NotesSelectID(&ID)
Fejlkoder
"1": Forkert angivelse af DocId (f.eks. invalid ID-nummer)
"2": Form ikke angivet. Brug #NotesForm først
"3": Dokument ikke fundet
”4” Dokumentet der blev fundet har ikke et formnavn angivet.
"99": "Exception error": Anden fejl fra integrationskit.
Aflæs fejlbesked på skærm.
Afsnit
3.4.6
Se også
#NotesDeleteID
#NotesQuery
119

#NotesSelectUNID
Syntaks
#NotesSelectUNID()
Input
(Text)
Notes Universal Document ID på dokument der skal hentes.
Output
Ingen
Funktion
Direkte opslag af Notes dokument via kendt 32 byte Universal Document
ID. Dette UNID kan f.eks. være fundet via #NotesUNID.
UNID bør benyttes i stedet for DocID hvis der arbejdes på tværs af
replicaer.
Husk at reservere 32 tegn til UNID’s i XAL-strenge.
Fejlkoder
"2": Form ikke angivet. Brug #NotesForm først
"3": Dokument ikke fundet via angivet UNID
"99": "Exception error": Anden fejl fra integrationskit.
Aflæs fejlbesked på skærm.
Afsnit
3.4.6
Se også
#NotesUNID
#NotesSelectID
120

#NotesServerName
Syntaks
#NotesServerName
Input
Ingen
Output
(Text: Direkte)
Navn på valgte server i Lotus Notes.
Funktion
Returnerer navnet på den aktuelt valgte server.
Eksempel
PRINT "Aktuelle server: ", #NotesServerName
PAUSE
Afsnit
3.3.1
Se også
#NotesOpenServer
121

#NotesSetDelim
Syntaks
#NotesSetDelim()
Input
(Text)
Tegn der skal benyttes som skilletegn mellem søgenøgler
Output
Ingen
Funktion
Hvis ikke semikolon, som er default skilletegn ved overførsel af flere
opslagsværdier til #NotesSearchView, kan benyttes, kan man med
#NotesSetDelim angive et alternativt skilletegn.
Afsnit
3.4.4
Eksempel
SET QStr=DebTable.Adresse1+’@’+Debtable.Adresse2
#NotesDelim(’@’)
#NotesSearchView(&QStr)
122

#NotesSetField
Syntaks
#NotesSetField()
Input
(Text)
Feltnavn på Notes felt der skal have "fokus"
Output
Ingen
Funktion
Denne macro er primært til intern brug i integrationskittet.
Udpeger det felt der efterfølgende skal opdateres eller forespørges
på.
Denne macro skal normalt ikke anvendes, da funktionaliteten er indbygget
i andre macroer.
Fejlkoder
"1": Felt kendes ikke på form.
"2": Form ikke angivet, brug #NotesForm
"3": Ingen felter på form
"99": "Exception error": Anden fejl fra integrationskit.
Aflæs fejlbesked på skærm.
123

#NotesSetFieldValue
Syntaks
#NotesSetFieldValue(,[,"COMMIT"])
Input
(Text,Text[,Text])
1. Parameter: Navn på felt i Notes, hvis værdi skal sættes
2. Parameter: Værdi
3. Parameter: Evt. angivelse af umiddelbar commit
Output
Ingen
Funktion
Denne macro sætter feltet angivet i første parameter til værdien angivet
i anden parameter. Husk Notes’ feltnavn er case-sensitive. Værdi
(2. parameter) skal altid være at typen text. Konvertér evt. andre formater
til text, inden kald af macro. Eksisterende indhold i feltet overskrives
med denne macro.
Data der overføres til dato-felter skal altid være af formatet ”dd-mmåå”
eller ”dd-mm-åååå” – altså med bindestreg mellem talværdier og
med dag som første værdi.
Angives "COMMIT" som tredje parameter gemmes værdien i Notes
umiddelbart. Dette er anvendeligt ved en enkelt opdatering. Skal flere
felter opdateres efterfølgende, bør #NotesCommit kaldes som separat
sidste kommando.
Eksempel
#NotesSelectID(F.NotesDocID)
SET &S = Date2Str(F.Dato,123,2,3,2,3,2)
#NotesSetFieldValue("Dato",&S)
Fejlkoder
"1": Felt kendes ikke på form.
"2": Form ikke angivet, brug #NotesForm
"3": Ingen felter på form
"99": "Exception error": Anden fejl fra integrationskit.
Aflæs fejlbesked på skærm.
Afsnit
3.5.2
Se også
#NotesAppendFieldValue
#NotesSetRichFieldValue
#NotesQueryField
124

#NotesSetHandle
Syntaks
#NotesSetHandle([])
Input
(Text)
Eventuel angivelse af handle til Lotus Notes
Output
Ingen
Funktion
Har man brug for at operere med flere samtidige åbne sessions til
Lotus Notes, kan dette gøres ved at operere med flere handles. Integratiosnkittet
understøtter op til 15 samtidige handles.
Skift mellem handles sker med #NotesSetHandle.
Hver session har sin connection til Lotus Notes.
Eksempel
#NotesSetHandle(2)
#NotesOpenServer("Local")
#NotesLogon("MyDB.nsf")
#NotesForm("Form 2")
#NotesView("View 2")
{Return to previous session}
#NotesSetHandle(1)
Afsnit
3.2.4
Se også
#NotesGetHandle
125

#NotesSetKeepUnread
Syntaks
#NotesSetKeepUnread("0"|"1")
Input
(Text)
Markering af om der skal checkes inden overskrivning.
Output
Ingen
Funktion
Normalt vil integrationskittet overskrive eksisterende data uanset om
der er forskel på den nye felt-værdi og den gamle. Derved markeres
dokumentet som unread og LAST_MODIFIED ændres. I visse situationer
må data kun overskrives hvis der er forskelle. #NotesSetKeepUnread
håndterer dette. Hvis dette er aktiveret læses feltværdi før
hver skrivning og der skrives kun til Notes hvis nye feltværdi er forskellig.
Eksempel
#NotesSetKeepUnread("1")
Afsnit
3.4.7
Se også
#NotesCompareField
126

#NotesSetListDelim
Syntaks
#NotesSetListDelim()
Input
(Text)
Tegn der skal benyttes som skilletegn ved multi-values
Output
Ingen
Funktion
XAL indeholder ikke, som Lotus Notes, multi-value værdier. Ved overførsel
af værdier til et multi-value felt i Lotus Notes, kan en række
værdier overføres f.eks. via #NotesSetFieldValue, ved at adskille
værdierne med et skilletegn (delimiter). Default delimiter i integrationskittet
er semikolon (;). Med #NotesSetListDelim kan skilletegnet
ændres til et andet tegn. Dette kan være anvendeligt hvis tekster der
skal overføres selv indeholder semikolon.
Afsnit
Eksempel
SET &S = ’’
#NotesSetListDelim(’@’)
SEARCH SagAktivitet WHERE Sag == &ActProj
#ADD(&S,’@’+Aktivitet)
END
#NotesSetFieldValue(’Aktiviteter’,&S)
Se også
#NotesSetFieldValue
#NotesAppendValue
#NotesAppendMultiValue
127

#NotesSetRichFieldValue
Syntaks
#NotesSetRichFieldValue(,[,"COMMIT"])
Input
(Text,Text[,Text])
1. Parameter: Navn på rich-text felt i Notes
2. Parameter: Værdi
3. Parameter: Evt. angivelse af umiddelbar commit
Output
Ingen
Funktion
Macroen anvendes på samme måde som #NotesSetFieldValue.
Macroen giver mulighed for, ved gentagne kald, løbende at udfylde et
rich-text felt med flere linier. Macroen adderer altså til feltet. Brug evt.
#NotesSetFieldValue til at initialisere feltet.
Desuden bruges macroen i forbindelse med #NotesImportFile.
#NotesSetFieldValue på et rich-text felt overskriver tidligere input.
#NotesSetRichFieldValue er lidt langsommere, da overførsel af værdier
sker via temporære filer.
Eksempel
#NotesSelectID(FinPost. NotesDocID)
#NotesSetRichFieldValue("Body","Richtext linie 1")
#NotesSetRichFieldValue("Body","Richtext linie 2")
#NotesCommit
Fejlkoder
"1": Felt kendes ikke på form.
"2": Form ikke angivet, brug #NotesForm
"3": Felt er ikke et rich-text felt
"98": Fejl ved oprettelse af temporær fil.
"99": "Exception error": Anden fejl fra integrationskit.
Aflæs fejlbesked på skærm.
Afsnit
3.5.2
Se også
#NotesSetFieldValue
128

#NotesSetRichSepMode
Syntaks
#NotesSetRichSepMode({"0"|"1"})
Input
(Text)
Angivelse af om rich-text felter skal lægges i separate kommafiler ved
#NotesQuery eller direkte i kommafilen.
Output
Ingen
Funktion
Hvis parameter er "0" gemmes første linie af rich-text felter i den primære
kommafil i forbindelse med #NotesQuery.
Hvis parameter er "1" medfører det at rich-text felter ikke indeholdes i
den primære resultat kommafil ved kald af #NotesQuery, men i stedet
placeres i separate kommafiler i underbiblioteket "RichText". Een fil
pr. rich-text felt pr. dokument.
Se fyldig gennemgang i afsnit 3.6.2.2
Afsnit
3.6.2.2
Se også
#NotesGetRichSepMode
129

#NotesTmpFilNavn
Syntaks
#NotesTmpFilnavn[()]
Input
(Text)
Evt. angivelse af tvunget filnavn
Output
(Text)
Navnet på temporær fil returneres i &NotesText
Funktion
Denne macro bruges inden kald af #NotesQuery, til angivelse af filnavn
på den temporære kommafil, hvori forespørgselsresultatet returneres.
Angives en parameter, bruges denne som filnavn. Normalt
angives ingen parameter, hvorved integrationskittet "beregner" et
unikt filnavn. Efter kald af #NotesTmpFilnavn kan filnavnet aflæses i
variablen &NotesText. Husk at slette den temporære fil efter brug,
med XAL-macroen #FileDelete.
Eksempel
STR 60 &Filnavn
...
#NotesTmpFilnavn
SET &FilNavn = &NotesText
#NotesQuery("SELECT @All")
...
#FileDelete(&Filnavn)
Afsnit
3.3.3
Se også
#NotesQuery
130

#NotesUNID
Syntaks
#NotesUNID
Input
Ingen
Output
(Text: Direkte)
Notes Universal Document Id på aktivt dokument i Notes.
Funktion
Returnerer Notes Universal Document Id på det aktive dokument i
Notes. Notes Universal Document Id er en 32 karakter lang streng,
der er unik på en database på tværs af replica’s.
Eksempel
#NotesSetHandle(2)
#NotesOpenServer('Serv1/Dom01')
#NotesLogon('db.nsf')
#NotesForm('Person')
#NotesQueryUnique(('2343')
SET &UNID1 = #NotesUNID
#NotesSetHandle(3)
#NotesOpenServer('Serv2/Dom01')
#NotesLogon('db.nsf')
#NotesForm('Person')
#NotesQueryUnique(('2343')
SET &UNID2 = #NotesUNID
IF &UNID1&UNID2 THEN
PRINT "Forskel på databaser"
ENDIF
Afsnit
3.5.5
Se også
#NotesSelectUNID
#NotesDocID
131

#NotesView
Syntaks
#NotesView()
Input
(Text)
Navn på view i Lotus Notes
Output
Ingen
Funktion
Angivelse af view i Notes, som skal bruges ved opslag med #NotesQuery
uden parametre.
For skjulte views (navn i parantes) skal paranteserne IKKE angives i
view-navn.
Eksempel
#NotesView("All")
PRINT "Aktuelle view: ",#NotesViewName
#NotesQuery
Fejlkoder
"1": View findes ikke i Notes database. Husk at også view-
navne er case-sensitive.
"9": Der er ikke foretaget logon på Notes server. Brug
#NotesOpenServer
Afsnit
3.2.2.3
Se også
#NotesViewName
132

#NotesViewName
Syntaks
#NotesViewName
Input
Ingen
Output
(Text: Direkte)
Navn på aktuelle view i Notes.
Funktion
Returnerer det aktuelle valgte view i Lotus Notes, defineret via #NotesView.
Eksempel
PRINT "Aktuelle view: ",#NotesViewName
Afsnit
3.3.1
Se også
#NotesView
133

A pendix 1. Manuel installation
Det er muligt at installere integrationskittet uden brug af installationsprogrammet. Dette kan f.eks.
være en fordel, ved installation af mange arbejdspladser på et netværk, hvor alle relevante filer
distribueres fra en fil-server.
1.1 Udpakning af filer
Inden manuel installation kan udføres, skal filerne pakkes ud fra installationsmedia (f.eks. disketter).
Eksekver filerne disk1.exe og disk2.exe. I hvert program vælges Setup, hvorefter filerne udpakkes.
Alle filer placeres i "TEMP" biblioteket i et underbibliotek ved navn ERP2LN.$$$, f.eks.
C:\WINDOWS\TEMP\ERP2LN.$$$.
Er man i tvivl om placeringen af det temporære bibliotek, kan dette findes ved at taste "SET" i en
dos prompt. Her findes placeringen ud for ordet "TMP=".
1.2 Kopiering af filer
Efter udpakning af alle filer skal disse fordeles i de relevante biblioteker.
Følgende filer kopieres til XAL-biblioteket:
NOTES.MAC
ERP2LN.DLL
BORLNDMM.DLL
134

A pendix 2. Kendte fejl/begrænsninger
2.1 Manglende oprydning (går ned)
En meget stor del af de eventuelle fejl der kan opstå ved integration mellem CONCORDE og Lotus
Notes fanges af integrationskittet. Disse returneres som fejlkoder i variablen &NotesText. Af og til vil
der dog opstå fejl ved integrationen som ikke "fanges" af integrationskittet. Disse fejl opstår uden for
CONCORDE, i forbindelsen mellem DLL'en og Lotus Notes. Hvis muligt vises en Windows fejlmeddelelse
og fejlkode "99" returneres. Der kan opstå situationer, hvor det ikke er muligt for integrationskittet
at håndtere fejlen. Her er eneste udvej at lukke Windows-processen ned (enten ERP2LN
eller selve CONCORDE processen). I Windows-95 slår man processen ned med Ctrl-Alt-Del og
"End Task" – i Windows NT afsluttes processen via Task-manager.
Når CONCORDE er blevet afbrudt på denne måde sker der ikke nogen efterfølgende oprydning i
Windows memory.
Ved genopstart af CONCORDE og efterfølgende kald af #NotesInit kan CONCORDE processen
"hænge". Eneste mulighed er at slå processen ned og genstarte CONCORDE igen. Herefter skulle
der ikke være problemer.
Dette fænomen kan også ske ved gentagne aktiveringer af CONCORDE uden genstart af Windows.
2.2 Multi-value felter ved NotesQuery
I Lotus Notes har man mulighed for at et felt kan indeholde flere værdier. En funktionalitet der ikke
eksisterer i CONCORDE. Når man forespørger på et sådant felt returneres den værdi man ville se
som Notes-bruger. Hvis f.eks. de forskellige værdier adskilles med semikolon, vil feltværdierne tilsvarende
returneres som een returværdi med værdierne adskilt med semikolon. Dette gælder både
ved #NotesQueryField og ved #NotesQuery.
Hvis man i Lotus Notes har angivet, at de enkelte værdier skal adskilles med "New Line"
eller "Blank Line" vil kun den første værdi blive returneret!
Generelt skal man være forsigtig ved håndtering af Notes-dokumenter der indeholder multi-value
felter. Programlogikken i XAL skal håndtere opsplitningen af returværdien til f.eks. separate felter/records
i CONCORDE.
Ved opdatering af felter i Lotus Notes fra CONCORDE kan multi-value felter udfyldes med angivelse
af det tegn der er anført som value-separator i Notes.
Er f.eks. komma angivet som gyldig separator i Notes formdefinitionen, kan de tre værdier "rød",
"gul" og "blå" overføres til Notes på følgende måde:
#NotesSetFieldValue("Farver","rød, gul, blå")
CONCORDE kan kun håndtere tekststrenge på op til 255 karakterer. Dette kan være et problem
ved returnering af multi-value værdier. Indeholder f.eks. et Notes-felt 20 værdier med 20 karakterer i
hver værdi, vil returværdien til CONCORDE indeholde 400 tegn (+ skilletegn). Kun de første 255
tegn vil være tilgængelige.
Macroen #NotesAppendMultivalue understøtter kun text-lister.
135

2.3 Mail-error ved mail-fejl
Fejl i mail-macroerne kan medføre at indholdet i fejlmeldinger som sendes efter aktivering af #NotesMailErrorTo
kan have forkert indhold.
2.4 Attachments i rich-text felter
Ved sletning af et attachment på et rich-tekstfelt vil ikonet ikke blive slettet. Selve filen vil blive slettet,
2.5 Begrænsning i grafikformater
Ikke alle grafikformater kan importeres i Lotus Notes dokumenter med macroerne #NotesMailBodyFile
og #NotesImportFile. Følgende formater understøttes:
• ASCII, standard ASCII-filer (TXT, PRN,ASC...)
• Rich-text filer (RTF). ASCII-fil med formateringskommandoer der bl.a. kan oprettes i Microsoft
Word.
• PCX-filer, grafikformat der benyttes i bl.a. Lotus Notes
• BMP-filer, Windows grafik
• TIFF-filer, high-end grafik (Uncompressed TIFF5)
Alle disse formater kan optræde i forskellige varianter. Ikke alle varianter understøttes. Det anbefales
at teste sig frem til et egnet format og derefter benytte dette konstant.
2.6 DocId ved replica
Man skal være opmærksom på at DocId kun er unik indenfor een database og indenfor een replica
af denne database. Bruger man DocId til udpegning af dokumenter kan dette medføre fejl, hvis
samme applikation bruges på flere servere med samme database.
Det anbefales at benytte #NotesGetUnique eller #NotesQueryUnique i stedet.
Brug af f.eks. #NotesSelectID eller #NotesDeleteID er dog helt i orden i forbindelse med f.eks. #NotesQuery,
hvor det er de aktuelle DocId's der opereres på.
Denne begrænsning kan omgås ved at benytte UNID’s i stedet.
2.7 Max længde af feltværdi
Ved brug af #NotesSetFieldValue og #NotesAppendFieldValue kan den værdi der overføres maksimalt
indeholde 255 tegn.
Ønskes længere tekster overført, kan dette gøres efterfølgende ved at kalde #NotesAppendField-
Value.
Eks.:
SET &S=SubStr(&LongText,1,255)
136

#NotesSetFieldValue("Felt",&S)
SET &S=SubStr(&LongText,256,255)
#NotesAppendFieldValue("Felt",&S)
SET &S=SubStr(&LongText,512,255)
#NotesAppendFieldValue("Felt",&S)
Den maksimale feltlængde integrationskittet understøtter i Notes er 32.000 tegn (dog undtaget
RichText felter)
2.8 Feltet ”Form” skal være sat på dokument
Da integrationskittet henter en række oplysninger fra form-design på aktuelle dokument, er det ikke
muligt at behandle Lotus Notes dokumenter, hvor dette felt ikke er sat.
137

A pendix 3. Designelement typer
Med macroerne #NotesFieldType og #NotesFormType er det muligt at få returneret oplysninger om
henholdsvis felter og forms.
Følgende felttyper kan returneres af #NotesFieldType:
• Unknown
• Error
• Text
• Number
• DateTime
• RichText
• TextList
• NumberList
• DateTimeList
Følgende formtyper kan returneres af #NotesFormType:
• Main
• Response to Main
• Response to Response
138

A pendix 4. Datatype-parametre
Følgende makroer, som opererer på ”items” og altså ikke henter information om felt-typer fra forms,
kan kaldes med datatype foranstillet feltnavn:
• #NotesPutFieldValue
• #NotesAppendFieldValue
• #NotesGetFieldLength
• #NotesGetFieldValue
Følgende datatyper kan foranstilles:
• TEXT #TEXT#
• NUMBER #NUMBER#
• DATETIME #DATETIME#
• TEXT_LIST #TEXT_LIST#
• NUMBER_LIST #NUMBER_LIST#
• DATETIME_LIST #DATETIME_LIST#
Eksempler:
#NotesPutFieldValue(’#NUMBER#Beløb”,”123,45”)
#NotesAppendFieldValue(’#DATETIME_LIST#Dates’,&IdagStr)
Husk at data der overføres til dato-felter skal altid være af formatet ”dd-mm-åå” eller ”dd-mm-åååå”.
139

A pendix 5. Integrationskit uden 32 bit Windows klienter
Integrationskittet er designet til 32 bit Windows klienter. Ikke alle CONCORDE installationer er baseret
på denne platform. UNIX-versionen af CONCORDE er et eksempel på dette.
Integrationskittet kan dog stadig benyttes til at integrere CONCORDE med Lotus Notes. For at kunne
gøre dette skal man installere en dedikeret "gateway"-PC, som fungerer som bindeled mellem
CONCORDE og Lotus Notes. Denne PC er konfigureret med 32-bit Windows (95 eller NT) og 32-bit
CONCORDE klient som beskrevet i afsnit 0.4.
Gateway-PC'en har adgang til samme CONCORDE applikation som resten af installationen (f.eks.
via NFS på UNIX). Er dette ikke muligt, skal applikationen kopieres til gateway-PC'en. Hver ændring
i hoved-CONCORDE installationen skal kopieres til gateway-PC'en. Dette er specielt vigtigt på databasedelen
(og essentiel for Oracle installationer).
Gateway-PC'en sættes op som batchserver, hvor al integration sker med faste intervaller. På denne
måde kan man opbygge opdateringskørsler i XAL som periodisk opdaterer Lotus Notes. Som alternativ
til batchafvikling kan Timer-funktionen i CONCORDE benyttes.
140
Gateway PC 16 bit klient
32 bit Windows
Unix klient