Changes

Display Additional File Attributes for PDF Documents

259 bytes added, 08:36, 21 April 2023
Multiple File Fields
* This feature allows you to display extra information (called Meta Data) extracted from PDF files that are stored in [[Custom Field Type: Link – Upload - Single FileStorage|Single File]] or [[Custom Field Type: Link – Upload - Multiple FilesStorage|Multiple Files]] field.
* Only PDF files will display this information.
* The additional attributes that can be extracted and displayed are: :{| borderclass="1wikitable"
|-
||'''Meta Data Field Name'''||'''Field Code'''
|-
||Author||author
|-
||Creator||creator
|-
||Producer||producer
|-
||Keywords||keywords
|-
||Subject||subject
|-
||Title||title
|-
||Number of Pages||numofpages
|-
||Creation Date||creationdate
|-
||Modified Date||modifieddate
|-
||Is Encrypted||encrypted
|}
 
''Is Encrypted'': Returns the word '''Encrypted''' if the document has the '''"Content Copying"''' or '''"Content Copying or Extraction"'''
security restriction is in place.
==Single File Fields==
* In order to extract Meta Data related to a PDF file stored in a [[Custom Field Type: Link – Upload - Single FileStorage|Single File]] field you must create a [[Custom Field Type: Read Only – System Variables|Read Only - System Variables]] or [[Custom Field Type: Store Values – System Variables|Store Values - System Variables]] field to display the additional attributes.
* In the '''Variables''' section of the [[Custom Field Type: Read Only – System Variables|Read Only]] or [[Custom Field Type: Store Values – System Variables|Store Value]] field use the following syntax:
''Label'' '''[field code]'''
@
* Where ''Field Name'' is that name of the [[Custom Field Type: Link – Upload - Single FileStorage|Single File]] field that contains the PDF document.
* You can use html to format the output:
:[[Image:PDFDetails.PNG|link=]]
* In the above example '''Contract Document''' is the name of the [[Custom Field Type: Link – Single File|Single File]] field that contains the PDF document.
* The [[Custom Field Type: Read Only – System Variables|Read Only - System Variables]] field will display:
:[[Image:PDFDetails2.PNG|link=]]
: [[Image:PDFDetails2.PNG|link=]]
'''Note''': if you wish to use the value (ie: ''numofpages'') as part of [[Submit Logic]] or a [[Browser Script]] you must use a [[Custom Field Type: Store Values – System Variables|Store Values - System Variables]] field type.
'''Note''': if you wish to use the value (ie: ''numofpages'') as part of [[Submit Logic]] or a [[Browser Script]] you must use a [[Custom Field Type: Store Values – System Variables|Store Values - System Variables]] field type.
@''fieldname''.numofpages@
::or
@#''fieldid''.numofpages#@
 
Some techniques on validating PDF file attributes such as the number of pages are described in [[Validating File Attributes]].
==Multiple File Fields==
 * To include the above attributes in the list view of documents stored in a [[Custom Field Type: Upload - Multiple Files Storage|Multiple Files]] field use the '''Extra Columns''' section when you create the [[Custom Field Type: Link – Upload - Multiple FilesStorage|Multiple Files]] field:
[[Image:PDFExtraColumns.PNG|link=]]
* These attributes will only be displayed for PDF documents. They will be left blank for all non-PDF documents.
[[Image:PDFDetails3.PNG|link=]]
 
===Pull an upload date and time from an upload fields===
For Multiple Files Storage field you can use the below syntax:
 
<pre>@FIELD_NAME.template[#~uploaddate~#]@
</pre>
==Notes==
* These additional fields are embedded properties of the file. Accordingly the ''Modified Date'' and ''Creation Date'' will be displayed in the format in which they are stored in the file, and will not necessarily reflect the format you have selected for Date and Time display in your [[Personal Settings]].
 
Smartstaff
174
edits