NTPSendRTVariable ( <ReportHandle>, <VariableName>, <ServerName>, <DatabaseName>, <UNID>, <NotesItemName> ) -> <ErrorCode>
Beschreibung
Mit dieser Funktion wird der Wert einer im Report definierten RichText-Variablen gesetzt. Variablen, im Gegensatz zu Report-Feldern, nehmen im gesamten Report nur einen definierten Wert an. Sie können zwar aus der Script-Programmierung heraus mit Werten gefüllt werden, behalten aber während der Reporterstellung den gleichen Wert (gleichen Inhalt). Felder hingegen definieren einen Datensatz und können von Datensatz zu Datensatz (Notes-Dokument zu Notes-Dokument) andere Werte annehmen. Variablen werden immer direkt über ihren Namen referenziert.
Hinweis: Es können mehrmals an die gleiche Variable (Variablennamen) Werte zugewiesen werden, allerdings nimmt die Variable, während der Reportausführung, immer den Wert der letzten Zuweisung an.
Hinweis: Mit NTPSendRTVariable werden formatierte RichText-Felder übergeben. Zur Definition einer Variablen mit Inhalten aus nicht formatierten Feldern steht die Funktion NTPSendVariable zur Verfügung.
Hinweis: Es werden nicht alle möglichen Formatierungen eines Notes-RichText-Feldes unterstützt. Eine Beschreibung der RichText-Unterstützung kann dem Anhang entnommen werden.
Deklaration für Lotus Script
Declare Function NTPSendRTVariable Lib "NTP.DLL" ( ByVal ReportHandle As Long, ByVal VariableName As String, ByVal ServerName As String, ByVal DatabaseName As String, ByVal UNID As String, ByVal NotesItemName As String ) As Long
Parameter
<ReportHandle> (LONG)
Report-Handle das bei Aufruf von NTPInit oder NTPInitFromDatabase zurückgeliefert wurde.
<VariableName> (STRING)
Name der Variable die mit Inhalt gefüllt werden soll.
<ServerName> (STRING)
Name des Servers auf dem die Datenbank <DatabaseName> liegt. Leerstring für lokal.
<DatabaseName> (STRING)
Name der Datenbank aus der die Daten gelesen werden sollen und auf dem <ServerName> liegt.
<UNID> (STRING)
Notes Unique Document ID des Dokuments das aus <ServerName> und <DatabaseName> gelesen werden soll.
<NotesItemName> (STRING)
Name des Notes-Feldes das aus <UNID> gelesen werden soll.
Rückgabe
<ErrorCode> (LONG)
Nummer des aufgetretenen Fehlers (0 = kein Fehler)