Gets the documents for a source document in order that a user picks the only one of them and transfers the data from the picked document ( further data source ) to a target document. Differs from the function DEpickSrcC4D that the only one document can be picked.

Syntax

DEpickSrcD4D( D4Dname$, D4DtrgCond$, D4DsrcDoc, showEmpty, prompt$, D2Dname$, D2Dprocess%, D2DtrgDoc )

Arguments

D4Dname$ - string, input. The name of a DocExt\DocForDoc config's item by which the documents should be got for the picking. Next a user picks the only one of them as the data source. Read more about this name in the help topic - DocExt\DocForDoc config. To use several configs items at the same time you should type their names through a space.

D4DtrgCond$ - string, input. An additional condition in Formula Language to select documents from got ones using the DocExt\DocForDoc config's item.

D4DsrcDoc - NotesDocument, input. A source document which the picking documents should be got for.

showEmpty - boolean, input. The value True (-1) means that the view with no choices will be displayed even if the documents for picking have not been got.

prompt$ - string, input. A text which should be displayed at the document picking. For example - describe why the picking is being done.

D2Dname$ - string, input. The name of a DocToDoc config by which the data from the picked document should be transferred into the target document. To use several configs at the same time you should type their names in the string through a space.

D2Dprocess% - integer, input. The number of a transfer process: 1 - adding data, 3 - erasing data. Other values are also provided. Read more about this number in the help topic - Function DEprD2D.

D2DtrgDoc - NotesDocument, modified. A target document which the data from the picked document should be transferred into. The function can change the document but doesn't save it.

Return

Boolean. The value True (-1) means that a document was picked by a user and some data from it have been transferred into the target document and False (0) that at least one of this has not occurred.

Configs used

DocExt\DocForDoc, DocToDoc.


Topic links:

DocExt\DocForDoc config

DocToDoc config

Function prD2D

See also:

Functions of the library DocExtLib