...

Currently, the Filesystem Connector is configured using context parameters in a file named filesystem.xml. 

1. Create a file named filesystem.xml. Move it to <frevvo-home>\frevvo\tomcat\conf\Catalina\localhost directory when it is completed. Refer to the table below for the configurable parameters that can be included in the filesystem.xml content:Configuration ParameterDescriptionconnector.file.root.dirThis is the location in your file system where the submission docs will be saved.  If not explicitly configured, it defaults to the user home directory. Change the value to reflect the location for your file system. included in the filesystem.xml content:

...

Here is an example of the filesystem.xml. When executed, submissions will be:

1. • Saved on the local drive in a directory called Submissions.
   • Individual file names will be retained.
   • Attachments in the submisison will be saved.
   • Documents of each submission will be saved under a separate folder
   • Add any form fields preceded by the prefix mmk. in the Doc Action Url to the generated metadata file.

   • Add the suffix "_desc.txt" to the metadata file for each submission.
     

     Code Block

     <Context unpackWAR="false" path="/filesystem" swallowOutput="true" unloadDelay="40000"> <Parameter name="connector.file.root.dir" value="C:\Submissions" override="false"/> <Parameter name="connector.file.name.keep" value="true" override="false"/> <Parameter name="connector.file.ignore.attachments" value="false" override="false"/> <Parameter name="connector.file.dir.submission" value="true" override="false"/> <Parameter name="connector.file.metadata.prefix" value="mmk." override="false"/> <Parameter name="connector.file.descriptor.suffix" value="_desc.txt" override="false"/> </Context>

     
     

2. Start .

3. Make sure the directory where you plan to save the submissions is created and and has the appropriate access for the OS you are using. For example:

   1. If you are using Windows, you can map a drive to a server directory, or you could use the UNC path i.e. //host-name

   2. If you are using a Unix operating system you could mount a remote filesystem as a directory and use it as your destination directory

      Warning
      To ensure interoperability across file systems, it is recommended that you follow a good naming standard such as POSIX when creating files and folders. For example, folder names can't contain slashes so a folder named '1/2/15' would not be valid.

4. Browse http://localhost:8082/filesystem/health (replace localhost:8082 with your frevvo server host:port) to check the status of the connector. If the connector is up and running, you will see { "status" : "UP" }.

5. Modify your form/flow to use the File Connector via the Doc Action wizard:

   1. Edit your form/flow in the appropriate designer.

   2. Click on the what happens to my data? icon.

   3. Click to open the POST data to your web application wizard

   4. Add  http://localhost:8082/filesystem/submission (replace localhost:8082 with your frevvo server host:port) in the URL property.

   5. Select PDF in the Send Snapshot dropdown. 

   6. The Send Data checkbox is checked by default. Uncheck it if you do not want to save the .xml file
   7. Save your form/flow.
      
      
      
6. Test and submit the form/flow.

7. The submission documents will be found in the directory specified by the connector.file.root.dir parameter or in uniquely named folders under that depending on your configuration.

How to Customize the Submission Folder Name

...

1. Provide the submission metadata as name-value query parameters to the Doc Action URL.
2. Create a descriptor file named file-descriptor.ftl in your <frevvo-home>\tomcat\lib directory. The file MUST be named file-descriptor.ftl

Submission Metadata as name-value query parameters to the Doc Action URL.

...

1. Create a file descriptor template file and name it file-descriptor.ftl.

2. The file-descriptor.ftl should be located in the classpath  - if you are using the tomcat bundle, it should be located in the <frevvo-home>\tomcat\lib directory.

3. The content of the file-descriptor-.ftl file uses freemarker template language v2.3.23. syntax. The input to the template is identified by the variable 'params'. This contains a map of parameter name and parameter value(s). The value is a sequence/array since a parameter can be multi-valued. If there is metadata that remains constant it should be added to the file-descriptor.ftl template.
   
   Here is one example that can be used with Docushare Enterpise Content System:

   Code Block

   <#compress> <#escape x as x?xml> <?xml version="1.0" encoding="UTF-8"?> <Records>tomcat bundle <Record> <Field id="LF__User" length="-1" type="string"> <Value>administrator</Value> </Field> <#list params?keys as key> <#assign values = (params[key]?size > 1)> <#assign doc = key?switch('submission.file.name',true,false)> <Field id="${doc?then('LF__Document',key)}" length="-1" type="${doc?then('document','string')}"> <#if values><Values></#if> <#list params[key] as value><Value>${value}</Value></#list> <#if values></Values></#if> </Field> </#list> </Record> </Records> </#escape> </#compress>

   In the above sample:

   1. LF-User is an example of metadata that is constant for all submissions
   2. Full paths to all the submission files will be included in the metadata file if you put the submission.file.name parameter in the template.
   3. Value refers to a single parameter while Values designates a multi-valued parameter
      
      
4. The descriptor filename in the submission directory is the identifier, followed by a configurable suffix. The suffix plays an important part in isolating the file. The default suffix is '.xml'. The suffix can be changed using the connector.file.descriptor.suffix context parameter. Here is what the file looks like in the submission directory when the file suffix is configured to be _desc.txt:
   

   
   
   

5. The values from the specified query parameters will be included in the generated metadata file. For Example; if you have fields called Name and state in your form/flow that you want to include in your metadata file and have configured the connector.file.descriptor.suffix context parameter to have a value of mmk, your Doc Action Url should look like this:

   Code Block
   http://localhost:8082/filesystem/submission?submission.dir={Name}&mmk.name={Name}&mmk.state={State}

   The metadata file would look like this:
   

...