DESTINATION_FILESPEC

The DESTINATION_FILESPEC string tag is required in taglists prepared for the GET_FILE_FUNCTION, to specify the destination path and name of a file to be retrieved from the server.

XML Interface:

In the CAS XML Interface, for every CAS function where the CURRENT_FILESPEC or DESTINATION_FILESPEC tag references a local file, the CONTENT_DATA tag is used instead. The CONTENT_DATA tag is included in the XML, and contains the content of the file, encoded in base64. For more information, see Working with Files in the CAS XML Interface.

Type

Max Size

Multiple Allowed

String

128

Example:

function GetMessageFile( MsgHandle, MsgFileName)
{
var Tl = CAS.New();
CAS.AddTag(Tl,"GET_FILE_FUNCTION","");
CAS.AddTag(Tl,"REGISTERED_NAME",UserName);
CAS.AddTag(Tl,"REGISTERED_PASSWORD",UserPassword);
CAS.AddTag(Tl,"MESSAGE_HANDLE",MsgHandle);
CAS.AddTag(Tl,"CURRENT_FILESPEC",MsgFileName);
CAS.AddTag(Tl,"DESTINATION_FILESPEC","c:\\copyhere.tmp");
// Get file on this already open session
Tl = CAS.Send(Instance,Tl);
CAS.Delete(Tl);
}