NTPSendRTFieldByName ( <ReportHandle>, <FieldName>, <ServerName>, <DatabaseName>, <UNID>, <NotesItemName> ) -> <ErrorCode>
Beschreibung
Mit diesem Befehl wird der Inhalt eines im Report definierten RichText-Feldes mit einem Wert gefüllt. Werden die Felder des Reports über diesen Befehl mit Daten gefüllt, so wird jedes im Report vorhandene Feld direkt über seinen Namen angesprochen, d .h. es findet eine direkte Zuordnung der Daten zu den Feldern statt. Soll hingegen die Zuordnung der Daten über die definierte Feldreihenfolge im Report erfolgen, so ist die Funktion NTPSendRTField zu benutzen.
Alle im Report definierten Felder werden als ein Datensatz definiert. Mit NTPSendFieldByName und/oder NTPSendRTFieldByName werden die einzelnen Felder des Datensatzes gefüllt, bis der Funktionsaufruf NTPEndDocument diesen Datensatz abschliesst und alle Felder "zurücksetzt", d .h. den Inhalt der Felder bzw. des Datensatzes leert.
Hinweis: Die Werte, für die im Report definierten Felder, werden durch direkte Referenzierung, d .h. durch Angabe des Feldnamens, übergeben. Ein Mischung von NTPSendRTField und NTPSendRTFieldByNameist nicht erlaubt.
Hinweis: Mit der Funktion NTPSendRTFieldByName werden formatierte RichText Felder übergeben. Zur Übergabe von nicht formatierten Feldern sind die Funktion NTPSendField oder NTPSendFieldByName zu benutzen.
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 NTPSendRTFieldByName Lib "NTP.DLL" ( ByVal ReportHandle As Long, ByVal FieldName 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.
<FieldName> (STRING)
Name des Feldes das 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)