[ Max ].
[ Max ]When scheduling a fax via XML POSTs, there’s the option in the FaxFinder documentation to use “external” files instead of “inline” data by the <location> tag. The example in the FaxFinder manual describes this like so:
<!– Url of attachment –>
<!– required: yes if location == external –>
<!– value: string –>
<url>/ffws/v1/data/userspace/admin/report.pdf</url>
The <url> tag is loosely explained. Our method of scheduling faxes is to create a PDF, upload it to the faxfinder (most likely through scp and RSA keys), and simply point the device to the file on its local filesystem. We are opting for this strategy because of the 5MB XML limit that prohibits us from utilizing the “inline” method. How can this be performed, and where should the uploaded files live on the filesystem?
Jesse GillesWhat model and firmware version are you using?
With the 2.1.0 firmware, the sending XML limit is 6MB for FF130,FF230 models and 11MB for FF430 and FF830 models. Keep in mind this limit is applied to the entire request posted to the web server (so effective file size limit is smaller due to base64 encoding with inline attachments).
Unfortunately, the “/ffws/v1/data/userspace/admin/report.pdf” part of the example references a feature that wasn’t fully finished/supported but managed to make it’s way into the documentation. The feature was to allow the ability to upload and fetch files from the FaxFinder through the web API.
It is partially functional though and here are two ways you can use it. The second method is what you are referring to.
1. Use the full HTTP URL to a file hosted anywhere the FaxFinder can fetch from (this is probably the recommended method if this works for you).
<url>http://example.com/myfax.pdf</url>
2. Upload the file as mentioned using scp to the following location on the FaxFinder, assuming you are logging in as admin to post the XML: /usr/local/ffweb/data/userspace/admin/myfax.pdf
And then set your url to:
<url>/ffws/v1/data/userspace/admin/myfax.pdf</url>
Hope that helps.
Jesse
Jesse GillesA couple more thoughts:
1. If you upload files with scp to the userspace directory, you will have to delete them yourself after scheduling.
2. If you upload SSH keys to the FaxFinder, they will be lost if the unit is rebooted.
Hosting the file on an external web server is a little simpler from this standpoint though I recognize it is another service to maintain.
[ Max ]Excellent! Your recommendations have been accommodated for in our script. The system is up and running 100%.