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

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