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

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