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

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