Quick Tip - Domino File Upload Control element

For file uploading on the web, File Upload Control element can be used in Domino Design. It will create the file upload file (eg tag below). The name of the File Upload field will start with %%File.

<input id="UserFile" size=50 type="file"
name="%%File.482571b10020b158.e1c9d0d2ceb6a5c5482571b50022e0ab.$Body.0.1F64">

@AttachmentNames will return all the attachment(s) filename of the document. To create anchor link to the file, a <ComputedValue> can be used to built the link.

temp := @AttachmentNames;
ahref := "<a title=\"" + temp + 
"\" target=_blank href=" + DatabasePath + 
"VUncat/" + @Text( @DocumentUniqueID ) + 
"/$FILE/" + temp + ">" + temp + "</a>";
ahref

There is a problem when directly using the attachment name to be set as the anchor link. Files with space in the filename will produce broken link. Some file upload examples that I saw, include a message to inform user not to upload file with space in the filename. This is definitely not user friendly.

To overcome it use @URLEncode. It will handle the space or some other special characters in the filename.

ahref := "<a title=\"" + temp + 
"\" target=_blank href=" + DatabasePath + 
"VUncat/" + @Text( @DocumentUniqueID ) + 
"/$FILE/" + @URLEncode("Domino"; temp) + 
">" + temp + "</a>";

To add in additional function to removed the attachment, use an input checkbox with the name "%%Detach"

ahref := "<INPUT TYPE=checkbox NAME=\"%%Detach\" VALUE=\"" + 
@URLEncode("Domino"; temp) + "\"> <a title=\"" + 
temp + "\" target=_blank href=" + @WebDbName + "VUncat/" + 
@Text( @DocumentUniqueID ) + "/$FILE/" + @URLEncode("Domino"; temp) + 
">" + temp + "</a><br/>";

Checked on the filename that need to be removed. Then save document. The attachment will be removed.

Domino File Upload Control provides an easy way to upload file into the document. And the examples above is to access the attachments and manipulate it (open, delete).

Show-n-Tell Thursday Add to del.icio.us