Difference between revisions of "Attach a PDF to a Web Page View"

From SmartWiki
Jump to: navigation, search
(→‎Additional Information)
 
(21 intermediate revisions by 4 users not shown)
Line 7: Line 7:
 
To attach a PDF file to the beginning or the end of the [[Web Page View]]:
 
To attach a PDF file to the beginning or the end of the [[Web Page View]]:
 
:<font size="3">'''&lt;!--@ssattach(''position'';''pdf file location'')-->'''</font>
 
:<font size="3">'''&lt;!--@ssattach(''position'';''pdf file location'')-->'''</font>
−
 
−
 
−
To attach a PDF file to a defined page location within the [[Web Page View]]:
 
−
:<font size="3">'''&lt;!--@ssattach(insert;''pdf file location'';''page number'')-->'''</font>
 
−
 
  
 
'''Where:'''
 
'''Where:'''
−
* ''position'' is either '''before''', '''after''' or '''insert'''
+
* ''position'' is either '''before''' or '''after'''.
−
* ''page number'' is the page at which the file should be inserted into the PDF document.
 
−
::'''Note:''' The ''page number'' is '''only''' specified when using ''insert'' as the position.
 
 
* ''pdf file location'' is:
 
* ''pdf file location'' is:
 
:{|cellpadding="5" cellspacing="0" border="1"
 
:{|cellpadding="5" cellspacing="0" border="1"
 
| '''File Source'''
 
| '''File Source'''
 
| '''Syntax'''
 
| '''Syntax'''
 +
|'''Comments'''
 
|-
 
|-
 
| [[Smart Folder]]
 
| [[Smart Folder]]
 
| /files/''folder1''/''folder2''/''File_Name''.pdf
 
| /files/''folder1''/''folder2''/''File_Name''.pdf
 +
| To obtain select '''View URL''' from the '''File Options''' combo box next to the relevant file in the [[Smart Folder]]. <br>
 +
The first part of the URL should be omitted: the location specified should begin with "/files/..." as in the examples below.
 
|-
 
|-
 
| [[Single File]] Custom Field
 
| [[Single File]] Custom Field
 
| @''Custom Field Name''.value@
 
| @''Custom Field Name''.value@
 +
|
 
|-
 
|-
 
| [[Multiple Files]] Custom Field
 
| [[Multiple Files]] Custom Field
 
| @''Custom Field Name''.files@
 
| @''Custom Field Name''.files@
 +
| All PDF files stored in field will be attached.
 
|}
 
|}
  
  
 
'''Notes:'''
 
'''Notes:'''
−
* When a [[Multiple Files]] field is specified, all PDF files stored in that field will be attached where specified.
+
* Single or Multiple file fields on parent/grandparent levels can also be included using:  
−
* Single or Multiple file fields on parent levels can be access using:  
+
::* @parent.''Custom Field Name''.value@, @parent.parent.''Custom Field Name''.files@, etc.
−
::* @parent.''Custom Field Name''.value@
 
−
::* @parent.parent.''Custom Field Name''.files@
 
−
* The ''page number'' is only specified when using ''insert'' as the position.
 
−
* To obtain the file location for a PDF file stored in a [[Smart Folder]] go to the relevant [[Smart Folder]] and select '''View URL''' from the '''File Options''' combo box next to the relevant PDF file. The first part of the URL should be omitted: the location specified should begin with "/files/..." as in the examples below.
 
−
 
 
  
 
==Examples==
 
==Examples==
 
* Append a PDF file from a [[Smart Folder]] '''before''' the current [[Web Page View Field]] page:
 
* Append a PDF file from a [[Smart Folder]] '''before''' the current [[Web Page View Field]] page:
 +
 
<pre>
 
<pre>
 
<!--@ssattach(before;/files/1234/123/myfile.pdf )-->
 
<!--@ssattach(before;/files/1234/123/myfile.pdf )-->
Line 50: Line 44:
  
 
* Append a PDF file from a [[Smart Folder]] '''after''' the current [[Web Page View Field]] page:
 
* Append a PDF file from a [[Smart Folder]] '''after''' the current [[Web Page View Field]] page:
 +
 
<pre>
 
<pre>
 
<!--@ssattach(after;/files/1234/123/myfile.pdf )-->
 
<!--@ssattach(after;/files/1234/123/myfile.pdf )-->
Line 64: Line 59:
  
  
−
* Insert all PDF files stored in a [[Custom Field Type: Link – Multiple Files|Multiple Files Custom Field]] called ''"AttachManyPDFFiles"'' at page 4 of the current [[Web Page View Field]] page:.
+
* Attach PDF files to a Level 1 [[Web Page View]] from the UTA Role [[Custom Fields]] on the contact section:
  
−
<pre>
+
<pre> [#(?object=contact;)<!--@ssattach(after;$?opr_123456.value$)-->#]
−
<!--@ssattach(insert;@AttachManyPDFFiles.files@;4)-->  
 
 
</pre>
 
</pre>
 +
Where 123456 is the Custom Field ID
  
−
:* '''Note:''' Don't forget to include '''.files'''
 
  
 +
* Attach PDF files to a Level 1 [[Web Page View]] from the organization [[Custom Fields]] associated as the Customer on the Level 1 record:
  
−
* Attach PDF files to a Level 1 [[Web Page View]] from the UTA Role [[Custom Fields]] on the contact section:
+
<pre> <!--@ssattach(after;@client.UploadFieldName.files@)-->
−
[#(?object=contact;)&lt;!--@ssattach(after;$?opr_123456.value$)-->#]
 
−
Where 123456 is the Custom Field ID
 
−
 
−
 
 
−
* You can also control the format settings of the PDF that is output by using the following syntax. The PDF file referenced should be a blank one-page pdf file which has the format settings you wish your PDF document to have. The [[Web Page View]] will be inserted onto this template:
 
−
<pre>
 
−
<!--@ssattach(setting;/files/1234/123/myfile.pdf)-->  
 
 
</pre>
 
</pre>
−
 
+
Where UploadFieldName is the field name of the multi-file upload custom field on the organization record
  
 
==Additional Information==
 
==Additional Information==
 +
* '''IMPORTANT''' Any [[PDF]] files that have security restriction in place such as '''Content Copying''' or '''Content Copying or Extraction''' have been encrypted and '''cannot''' be included.
 +
::The settings can be viewed by opening the [[PDF]] and clicking File > Document Properties > Security (steps may vary depending on the version of your PDF reader)
 +
::See also: [[Display Additional File Attributes for PDF Documents]]
  
−
* The '''ssattach''' function can be placed anywhere inside the [[Web Page View Field]]
+
* The '''ssattach''' function can be placed anywhere inside the HTML tags within the [[Web Page View Field]]
 
* All PDF page settings will driven by the first PDF document file, whether it is a static file or one generated by [[SmartSimple]]
 
* All PDF page settings will driven by the first PDF document file, whether it is a static file or one generated by [[SmartSimple]]
 
* Multiple PDF files can be attached from different sources by using multiple ssattach statements:
 
* Multiple PDF files can be attached from different sources by using multiple ssattach statements:
−
<pre>
+
<pre style="white-space: pre-wrap;  white-space: -moz-pre-wrap;  white-space: -pre-wrap;  white-space: -o-pre-wrap;  word-wrap: break-word;"><!--@ssattach(before;/files/1234/123/myfileheader.pdf )--><!--@ssattach(after;/files/1234/123/myfilefooter.pdf )-->
−
<!--@ssattach(before;/files/1234/123/myfileheader.pdf )-->
 
−
<!--@ssattach(after;/files/1234/123/myfilefooter.pdf )-->
 
 
<!--@ssattach(after;/files/1234/123/myfileappendix.pdf )-->
 
<!--@ssattach(after;/files/1234/123/myfileappendix.pdf )-->
 
<html><body>
 
<html><body>
 
   My Pdf file
 
   My Pdf file
 
</body></html>
 
</body></html>
−
 
 
</pre>
 
</pre>
  
−
* [[SSlogic]] can be used if the PDF file(s) to be attached needs to be varied using conditional statments:
+
* [[sslogic]] can be used if the PDF file(s) to be attached needs to be varied using conditional statements:
−
<pre>
+
<pre style="white-space: pre-wrap;  white-space: -moz-pre-wrap;  white-space: -pre-wrap;  white-space: -o-pre-wrap;  word-wrap: break-word;"><!--@sslogic('@type@'='contact')-->
−
<!--@sslogic('@type@'='contact')-->
 
 
       <!--@ssattach(after;@parent.contract.value@)-->
 
       <!--@ssattach(after;@parent.contract.value@)-->
 
<!--@else-->
 
<!--@else-->
 
     <!--@ssattach(after;@parent.othercontract.value@)-->
 
     <!--@ssattach(after;@parent.othercontract.value@)-->
 
<!--@end-->
 
<!--@end-->
 +
</pre>
 +
 +
Attaching a file from a transaction to a {{l1}} {{WPV}}, use:
  
 +
<pre style="white-space: pre-wrap;  white-space: -moz-pre-wrap;  white-space: -pre-wrap;  white-space: -o-pre-wrap;  word-wrap: break-word;">@client.[#(?object=transaction::criteria=typename="Transaction Name" and statusname="Submitted"::orderby=trsts desc)
 +
<!--@ssattach(after;$fieldname.value$)-->#]@
 
</pre>
 
</pre>
  
 +
Example:
 +
<pre style="white-space: pre-wrap;  white-space: -moz-pre-wrap;  white-space: -pre-wrap;  white-space: -o-pre-wrap;  word-wrap: break-word;">@client.[#(?object=transaction::criteria=typename="Audited Financial Statements" and statusname="Submitted"::orderby=trsts desc)
 +
<!--@ssattach(after;$Recent Audited Financial statements.value$)-->#]@</pre>
  
 
==See Also==
 
==See Also==
 
* [[Web Page View]]
 
* [[Web Page View]]
 
* [[sslogic]]
 
* [[sslogic]]
 +
* [[Display Additional File Attributes for PDF Documents]]
  
  
 
[[Category:Custom Fields]][[Category:PDF]]
 
[[Category:Custom Fields]][[Category:PDF]]

Latest revision as of 14:49, 23 February 2024

You can use the ssattach function to append one or more PDF documents stored in either a Single File Field or Smart Folder to a Web Page View Field.


Note: The attached PDF file(s) will not be visible when viewing the web page in HTML mode, but will be appended when exported as a PDF, saved as a PDF, emailed as PDF or created by a Workflow as attachment.

Syntax

To attach a PDF file to the beginning or the end of the Web Page View:

<!--@ssattach(position;pdf file location)-->

Where:

  • position is either before or after.
  • pdf file location is:
File Source Syntax Comments
Smart Folder /files/folder1/folder2/File_Name.pdf To obtain select View URL from the File Options combo box next to the relevant file in the Smart Folder.

The first part of the URL should be omitted: the location specified should begin with "/files/..." as in the examples below.

Single File Custom Field @Custom Field Name.value@
Multiple Files Custom Field @Custom Field Name.files@ All PDF files stored in field will be attached.


Notes:

  • Single or Multiple file fields on parent/grandparent levels can also be included using:
  • @parent.Custom Field Name.value@, @parent.parent.Custom Field Name.files@, etc.

Examples

<!--@ssattach(before;/files/1234/123/myfile.pdf )-->



<!--@ssattach(after;/files/1234/123/myfile.pdf )-->



<!--@ssattach(before;@AttachPDFFile.value@)-->
  • Note: Don't forget to include .value


 [#(?object=contact;)<!--@ssattach(after;$?opr_123456.value$)-->#]

Where 123456 is the Custom Field ID


  • Attach PDF files to a Level 1 Web Page View from the organization Custom Fields associated as the Customer on the Level 1 record:
 <!--@ssattach(after;@client.UploadFieldName.files@)-->

Where UploadFieldName is the field name of the multi-file upload custom field on the organization record

Additional Information

  • IMPORTANT Any PDF files that have security restriction in place such as Content Copying or Content Copying or Extraction have been encrypted and cannot be included.
The settings can be viewed by opening the PDF and clicking File > Document Properties > Security (steps may vary depending on the version of your PDF reader)
See also: Display Additional File Attributes for PDF Documents
  • The ssattach function can be placed anywhere inside the HTML tags within the Web Page View Field
  • All PDF page settings will driven by the first PDF document file, whether it is a static file or one generated by SmartSimple
  • Multiple PDF files can be attached from different sources by using multiple ssattach statements:
<!--@ssattach(before;/files/1234/123/myfileheader.pdf )--><!--@ssattach(after;/files/1234/123/myfilefooter.pdf )-->
<!--@ssattach(after;/files/1234/123/myfileappendix.pdf )-->
<html><body>
  My Pdf file
</body></html>
  • sslogic can be used if the PDF file(s) to be attached needs to be varied using conditional statements:
<!--@sslogic('@type@'='contact')-->
       <!--@ssattach(after;@parent.contract.value@)-->
<!--@else-->
     <!--@ssattach(after;@parent.othercontract.value@)-->
<!--@end-->

Attaching a file from a transaction to a Level 1 Web Page View, use: 

@client.[#(?object=transaction::criteria=typename="Transaction Name" and statusname="Submitted"::orderby=trsts desc)
<!--@ssattach(after;$fieldname.value$)-->#]@

Example: 

@client.[#(?object=transaction::criteria=typename="Audited Financial Statements" and statusname="Submitted"::orderby=trsts desc)
<!--@ssattach(after;$Recent Audited Financial statements.value$)-->#]@

See Also

Retrieved from ‘https://wiki.smartsimple.com/index.php?title=Attach_a_PDF_to_a_Web_Page_View&oldid=42286’