@RTAddDocLink
Syntax
@RTAddDocLink(DBHANDLE1;VIEWHANDLE2;NOTEHANDLE3;RTFIELD4;DOCLINKLIST5);
@RTAddDocLink(DBHANDLE1;VIEWHANDLE2;NOTEHANDLE3;RTFIELD4;DOCLINKLIST5;TEXT6);
@RTAddDocLink(DBHANDLE1;UIDLIST2;NOTEHANDLE3;RTFIELD4;DOCLINKLIST5);
@RTAddDocLink(DBHANDLE1;UIDLIST2;NOTEHANDLE3;RTFIELD4;DOCLINKLIST5;TEXT6);
@RTAddDocLink(DBHANDLE1;VIEWHANDLE2;UIDLIST3;RTFIELD4;DOCLINKLIST5);
@RTAddDocLink(DBHANDLE1;VIEWHANDLE2;UIDLIST3;RTFIELD4;DOCLINKLIST5;TEXT6);
@RTAddDocLink(DBHANDLE1;UIDLIST2;UIDLIST3;RTFIELD4;DOCLINKLIST5);
@RTAddDocLink(DBHANDLE1;UIDLIST2;UIDLIST3;RTFIELD4;DOCLINKLIST5;TEXT6);
@RTAddDocLink(TDRID1;VIEWHANDLE2;NOTEHANDLE3;RTFIELD4;DOCLINKLIST5);
@RTAddDocLink(TDRID1;VIEWHANDLE2;NOTEHANDLE3;RTFIELD4;DOCLINKLIST5;TEXT6);
@RTAddDocLink(TDRID1;UIDLIST2;NOTEHANDLE3;RTFIELD4;DOCLINKLIST5);
@RTAddDocLink(TDRID1;UIDLIST2;NOTEHANDLE3;RTFIELD4;DOCLINKLIST5;TEXT6);
@RTAddDocLink(TDRID1;VIEWHANDLE2;UIDLIST3;RTFIELD4;DOCLINKLIST5);
@RTAddDocLink(TDRID1;VIEWHANDLE2;UIDLIST3;RTFIELD4;DOCLINKLIST5;TEXT6);
@RTAddDocLink(TDRID1;UIDLIST2;UIDLIST3;RTFIELD4;DOCLINKLIST5);
@RTAddDocLink(TDRID1;UIDLIST2;UIDLIST3;RTFIELD4;DOCLINKLIST5;TEXT6);
Description
Inserts a document link (DocLink) into the RichText field RT RTFIELD4. The link points to the document identified by NOTEHANDLE NOTEHANDLE3 in the database identified by DBHANDLE DBHANDLE1 and from the view identified by VIEWHANDLE VIEWHANDLE2.
The parameter DOCLINKLIST5 specifies a field in the document that contains the DocLink list. Usually, this is the field $Links.
TEXT TEXT6 can be used to specify the text that should be associated with the DocLink. This text may span multiple lines (@NewLine).
Instead of VIEWHANDLE2 and NOTEHANDLE3, the OID or UID of the document or view can be passed accordingly. For the view, @ZeroOID can also be passed. Instead of DBHANDLE DBHANDLE1, the TD replica ID of a database can also be specified.
Example: @RTAddDocLink(DBHANDLE1;VIEWHANDLE2;NOTEHANDLE3;RTFIELD4;DOCLINKLIST5);
/* Open the source document */
DBHANDLE1:=@OpenDB("TEST1.NSF");
VIEWHANDLE2:=@OpenView(DBHANDLE1;"TEST VIEW 1");
VIEWPOSITION2:=0:1:0:0:0:0:0:0:0:0;
NOTEHANDLE3:=@OpenNoteByPosition(DBHANDLE1;VIEWHANDLE2;VIEWPOSITION2;NOTEHANDLE3);
/* Open the target document */
DBHANDLE:=@OpenDB("TEST2.NSF");
VIEWHANDLE:=@OpenView(DBHANDLE;"TEST VIEW 2");
VIEWPOSITION:=1:1:1:0:0:0:0:0:0:0;
NOTEHANDLE:=@OpenNoteByPosition(DBHANDLE;VIEWHANDLE;VIEWPOSITION;NOTEHANDLE);
/* Erstellen of the DocLinks */
rich text[NOTEHANDLE]:= @RTAddDocLink(DBHANDLE1;VIEWHANDLE2;NOTEHANDLE3;rich text[NOTEHANDLE];$Links[NOTEHANDLE]);
/* Close the target document */
NOTEHANDLE:=@CloseNote(NOTEHANDLE;1);
VIEWHANDLE:=@CloseView(VIEWHANDLE);
DBHANDLE:=@CloseDB(DBHANDLE);
/* Close the source document */
NOTEHANDLE3:=@CloseNote(NOTEHANDLE3;0);
VIEWHANDLE2:=@CloseView(VIEWHANDLE2);
DBHANDLE1:=@CloseDB(DBHANDLE1);
Two databases are opened. One document is searched for in each database. A DocLink between the two documents is created in the RichText field. The documents are then saved or closed, and finally the databases are closed again.
Note : This text was machine-translated and may contain inaccuracies.
