The following fields are recommended to consider when giving appropriate file names to attachments exported into external application:
Attachment.AttachmentID (unique ID of this Attachment, optional).
Please note that this form may be updated or revised, and you might export it again due to the change. It will then have the same ID.
Attachment.Description (description of the file content, as added by the end-user; highly recommended)
This is where the user usually adds info about the file or image, so it should be included in the filename if you want the filename to say anything about its contents.
Attachment.FileName (filename when added to SpeedyCraft)
This is the filename of the original file when added to SpeedyCraft. Please note that this is most likely NOT unique, as you may e.g. add several files named TempImage.jpg to the same assignment. Also note that the filename might be of no interest to the user, so usually the combination of Description and FileName is what makes sense to end-users when they want to consider the contents of an attachment.
Attachment.ParentAttachmentID (optional)
If this attachment was based on another attachment, the ParentAttachment is to be set here. Usually, RevisionNumber is also incremented on the new and changed attachment.
Attachment.RevisionNumber (optional)
Revision of the attachment document. Default is 0, and if this document is changed a new attachment is created with RevisionNumber = ParentAttachment.RevisionNumber+1. Also see ParentAttachmentID.
Attachment.RegTime (date when attachment was added to SpeedyCraft, optional)
Important considerations:
- If you export files to a folder, always make sure that the files are unique. If you need unique number, you might use AttachmentID.
- Please also ensure that your proposed filename is a valid (Windows) file name. This is important, as the strings you get from SpeedyCraft above might contain characters that are not allowed in Windows file paths.
- Please see other article about file names on forms: Recommended file names when exporting forms to file