Load
Description
Writes this object's contents to the specified file.
You can use this method to extract an attached file from the database and save it to your local file system. If a file with the same name already exists at the path you specify in the filename parameter, that file must be writeable and its existing contents will be replaced. The extracted file is not a temporary file; it persists after the process using this API has terminated.
Syntax
VBScript
attachment.Load
filename
Perl
$attachment->Load
(filename);
- Identifier
- Description
- attachment
- An Attachment object, representing the attachment of a file to a record.
- filename
- A String containing the path name of the file you want to write. This path name can be an absolute or relative path.
- Return value
- A Boolean whose value is True if the operation was successful, otherwise False.
Examples
VBScript
' This example assumes there is at least 1 attachment field
' and 1 attachment associated with the record.
set currentSession = GetSession
set attachFields = AttachmentFields
set attachField1 = attachFields.Item(0)
set theAttachments = attachField1.Attachments
x = 1
For each attachment in theAttachments
thefileName = "C:\attach" & x & ".txt"
x=x+1
' Write the file
status = attachment.Load (thefileName)
Next
Perl
# This example assumes that there is at least 1 attachment
# field associated with the record. Otherwise,
# GetAttachmentFields won't return anything interesting
# and an error would be generated
# Get the collection of attachment fields
$attachfields = $entity->GetAttachmentFields();
# Get the first attachment fields
$attachfield1 = $attachfields->Item(0)
# Now get the collection of attachments from the attachments field
$attachments = $attachfield1->GetAttachments();
# Retrieve the number of attachments for the for loop
$numattachments = $attachments->Count();
for ($x = 0 ; $x < $numattachments ; $x++)
{
# Retrieve the correct attachment
$attachment = $attachments->Item($x);
# Select a filename to write to
$filename = "C:\\attach".$x.".txt";
# Write the file
$status = $attachment->Load($filename);
}