file

file

file

Field component to liase with all File types

Examples

Basic
<cfproperty 
    name="someFile" type="string" default="" hint="The file to process" 
    ftSeq="1" ftFieldset="General" ftLabel="File" 
    ftType="file" ftDestination="/someDirectory" />
Maximum file upload of 1mb
<cfproperty 
    name="someFile" type="string" default="" hint="The file to process" 
    ftSeq="1" ftFieldset="General" ftLabel="File" 
    ftType="file" ftDestination="/someDirectory" ftMaxSize="1048576" />
Flash upload
<cfproperty 
    name="someFile" type="string" default="" hint="The file to process" 
    ftSeq="2" ftFieldset="General" ftLabel="File" 
    ftType="file" ftDestination="/someDirectory" ftRenderType="flash" />
Secure file upload
<cfproperty 
    name="someFile" type="string" default="" hint="The file to process" 
    ftSeq="4" ftFieldset="General" ftLabel="File" 
    ftType="file" ftDestination="/someDirectory" ftSecure="true" />
PDF only (HTML)
<cfproperty 
    name="someFile" type="string" default="" hint="The file to process" 
    ftSeq="5" ftFieldset="General" ftLabel="File" 
    ftType="file" ftDestination="/someDirectory" ftAllowedFileExtensions="*.pdf" />
PDF only (jQuery)
<cfproperty 
    name="someFile" type="string" default="" hint="The file to process" 
    ftSeq="6" ftFieldset="General" ftLabel="File" 
    ftType="file" ftDestination="/someDirectory" ftRenderType="jquery" 
    ftFileTypes="*.pdf" />

Formtool Metadata

Name file
Package Path farcry.core.packages.formtools.file

Attributes

Name Default Options Required Hint
ftAfterUploadJSScript No Used when ftRenderType is set to jQuery. Javascript to execute after upload compeltes.
ftAjaxMethod No The function that will be used to render the html output for ajax requests of a property
ftAllowedFileExtensions pdf,doc,ppt,xls,d... No Used when ftRenderType is set to HTML, extentions allowed to be uploaded.
ftClass No CSS Class that can be used on the formtool input
ftCompleteMessage File upload complete No Used when ftRenderType is set to jQuery. Message to display at end of upload.
ftDestination No Destination of file store relative of secure/public locations.
ftDisplayMethod No The function that will be used to render the html output for displaying a property
ftEditMethod No The function that will be used to render the html output for editing a property
ftErrorSizeMessage Maximum filesize ... No Used when ftRenderType is set to jQuery. Error to display when max filesize error flagged.
ftFacade #application.url.... No location of uploader facade.
ftFieldset No Used if you are relying on the framework to render your form. Used to group the fields into HTML fieldsets.
ftFileDescription File Types No Used when ftRenderType is set to HTML, text display above upload control.
ftFileTypes *.* No Used when ftRenderType is set to flash (default *.*) or jquery (default *.jpg;*.JPG;*.jpeg;*.JPEG;), extentions allowed to be uploaded.
ftLabel No Used by the FarCry form layout as the label of the form field. This will default to the [name].
ftLabelAlignment inline inline, block No Used by FarCry Form Layouts for positioning of labels. inline or block.
ftMaxSize -1 No Maximum filesize upload in bytes.
ftOnComplete No Used when ftRenderType is set to HTML, javascript to execute after file upload.
ftRenderType html No This formtool offers a number of ways to render the input. (html, flash, jquery)
ftSecure false No Store files securely outside of public webspace.
ftSeq No Used if you are relying on the framework to render your form. Used to sort the fields on the form.
ftStartMessage Upload file here. No Used when ftRenderType is set to jQuery. Message to display at start of upload.
ftStyle No Custom inline styles
ftType No Tells the framework which of the formtool ui components to use when rendering your form. This will default to the [type].
ftValidateMethod No The function that will be used to render the html output for validating (processing) a property form submission
ftValidation No List of CSS classes that can be used for js validation
ftWizardStep No Used if you are relying on the framework to render your form. Used to setup a wizard which is a multi step form process.