Overview

Use a file exporter to create files with a format that matches that of the input stream.

To open a file exporter's settings tab, double-click on:

the file exporter name in the repository
the file exporter icon in a model.

Insert excerpt_standard_settings_standard_settingsnopaneltrue Panel

borderColor	#7da054
titleColor	white
titleBGColor	#7da054
borderStyle	solid
title	Sections on this page

Table of Contentsindent12pxstylenone

Insert excerpt

	_Banners
	_Banners
name	analysis
nopanel	true

Overview

Use a file exporter to create files with a format that matches that of the input table and optionally send an email.

To add a new file exporter object to an analysis model:

Go to the model's toolbar → Create group.
Click
Insert excerpt
_file
_file
nopanel true
to expand the menu.
Drag a
Insert excerpt
_file_exporter
_file_exporter
nopanel true
onto the analysis model.

To add an existing file exporter object to an analysis model:

Go to the model toolbar → List group.
Click
Insert excerpt
_file
_file
nopanel true
to expand the menu.
Click
Insert excerpt
_file_exporter
_file_exporter
nopanel true
to open the list of available file exporters.
Drag an file exporter into the analysis model.

To open a file exporter's settings tab, double-click on:

the file exporter name in the repository
the file exporter icon in a model.

Insert excerpt

	_property_toolbar
	_property_toolbar
nopanel	true

Insert excerpt
_property_tabs
_property_tabs
name basic-h
nopanel true

Insert excerpt

	_parent
	_parent
nopanel	true

Basic Settings

Field

Description

Name

Enter a name for this file exporter.

Enabled

Insert excerpt

	_check_box_tick
	_check_box_tick
nopanel	true

to indicate you have completed the settings and the file exporter is ready to use.

File Name (Expr)

Enter an expression to generate the name of the file being exported. It must evaluate to a plain text string. It can include text expressions, see Text Expressions and Escape Characters. You can use the

internal variables the stream the stream

the table being processed.
_inputMultiplier: the value returned by the input multiplier, if one is being used.

Output Directory (Expr)

Optionally, enter anexpressionto generate the name of the directory into which generated files should be written. It must evaluate to a plain text string.

If you have configured a restricted directory for the PhixFlow server, the file exporter creates the output directory there; see Restricted Directory on System Configuration.

Note

As this is an expression field, you must surround plain text paths with quotes.

Directory separators must always be a forward slash /, for

example the stream the stream

the table being processed.
_inputMultiplier: the value returned by the input multiplier, if one is being used.

If you do not enter an expression or if the expression evaluates to blank, when you run the analysis model:

PhixFlow does not save the generated file to disk
PhixFlow checks that you have completed the options in the Send By Email section.

FTP Site

Select an FTP site to which the generated file will be moved. For details about how to add sites to this list, see FTP Site. FTP directory paths must be the full path to the file because PhixFlow ignores the local machine's base directory specified in System Configuration.

If you do not select a site, PhixFlow assumes the output file will be saved on the local machine.

Ignore Base Directory
Anchor
_ignore
_ignore

The base directory is set in System Configuration → System Directories → Output Directory.

Insert excerpt

	_check_box_untick
	_check_box_untick
nopanel	true

to automatically prepend the Output Directory path to the directories specified in the file exporter properties.

Insert excerpt

	_check_box_tick
	_check_box_tick
nopanel	true

so that PhixFlow reads directories specified in the file exporter properties as the full path to the file.

Note
For improved security, your administrator can set a System Configuration → System Directories → Restricted Directory. If it is set, PhixFlow will only write files to the Restricted Directory or a sub-directory of it. Even if you tick Ignore base directory, all directories specified in the file exporter properties must be within the Restricted Directory.

Export File As

You can export files in the following formats:

Comma Separated Values: Data will be read from a single push pipe and written to CSV files.

Excel Spreadsheet: Data will be read from a single push pipe and written to Excel Spreadsheet files.

If the push pipe has a drill-down view with an Excel template specified, this will be used to export the data. Optionally, use the Excel Template field for this file exporter. Specify an Excel template, which will supersede any template specified on the push pipe drill-down view.

If you specify an Excel Template, each output file is generated by copying the Excel template file and overwriting the values in the first worksheet. In this case, the type of file generated is the same as that of the template.

If you do not specify an Excel Template, each output file is generated by creating a new, empty Excel file and writing values to the first and only worksheet. In this case, the file type is the extension generated by the File Name Expression field.

.xls will generate a file in Microsoft Office 2003 Excel format.

.xlsx or .xlsm will generate a file in Microsoft Office 2007 Excel format.

Any other extension will generate a file in the format configured in System Configuration

→ File Exporter Multi-input template specified on the push pipe drill-down view specify an copying the Excel template overwriting the in . In this case, the type of file generated is the same as that of the template.

If you do not specify an Excel Template, each output file is generated by creating a new, empty Excel file and writing values to the first and only worksheet, then writing that worksheet out as HTML.

Overwrite existing fileThe file exporter overwrites existing files with the same name as the file to be generated. This can be useful where you want PhixFlow to replace a file at regular intervals, for example to update the content of an HTML page on an intranet.Maximum Records per FileEnter the maximum number of records that will be written to each file.Header Insert excerpt_check_box_tick_check_box_ticknopaneltrue to include a header line in the exported files. The header row contains the name of each field.Character Set Insert excerpt_character_set_character_setnopaneltrueOther Character SetAvailable when Character Set is Other. Enter a different character set. For the full list of available character sets, see the Oracle Java documentation about encoding; you can use the canonical names from either column.Line Separator Style

When PhixFlow generates the file, it uses the line separator configured in System Configuration → Advanced section → Line Separator Style. If this is not set, Phixflow uses the default for the operating system on which the PhixFlow server is running.

You may want to generate an export file that uses a different line separator, for example if PhixFlow runs on Linux, but the file will be sent to Windows users. To set a different line separator, select:

Windows
Unix
Other - see Line Separator Chars, below

Line Separator Chars

Available when Line Separator Style is Other. Enter either a single character or multiple characters to use as a new line separator. The characters may be the literal characters or a sequence from the table below. These sequences are useful if the required separator character is not valid to be stored in the database.

Sequence	Description
\t	tab
\n	newline
\r	carriage return
\f	form feed
\u + hexadecimal code	unicode character specified by the hexadecimal code

Column Separator Insert excerpt_column_separator_column_separatornopaneltrueSeparator Character Insert excerpt_separator_character_separator_characternopaneltrueExcel Template

Available when Export File As is one of following:

Excel Spreadsheet (Multiple Inputs): enter an expressionthat evaluates to an Excel template.

Excel Spreadsheet or HTML File: enter the name of the Excel template.

Convert To PDF

Available when the Export File As is Excel Spreadsheet.

Insert excerpt_check_box_tick_check_box_ticknopaneltrue to convert the Excel file to a PDF. PhixFlow saves the PDF to the location set in:

either the Output Directory,
or the PDF Target Path.

PhixFlow reports on the PDF conversion in the console's PDF Chore tab.

Note
PhixFlow needs access to LibreOffice to convert Excel files to PDFs; see Configuring PDF Conversion.

PDF Target Path (Expr)

Available when the Export File As is Excel Spreadsheet.

Enter an expression that evaluates to a path where PhixFlow will save the PDF file.

Evaluate Formulae Before Saving File Insert excerpt_check_box_tick_check_box_ticknopaneltrue to generate the export file and then to evaluate any formula in the spreadsheet before saving the file. When a user opens the file in Excel, the calculations have already been done.Quote Style Insert excerpt_quote_style_quote_stylenopaneltrueQuote Character Insert excerpt_quote_character_quote_characternopaneltrue

Input Multiplier

FieldDescriptionInput MultiplierThe input multiplier expression should evaluate to a list of one or more values. For each value in the list, the internal variable _inputMultiplier will be set to that value and the file export process will be repeated i.e. the pull pipes will be read and the data from those pipes processed to generate file output data, and a new export file will be written.Log Input Multiplier Messages Insert excerpt_log_traffic2_log_traffic2nopaneltrue

Log Input Multiplier Messages: when ticked, PhixFlow writes a message to the log every time the input multiplier value changes during an analysis run, whatever is set here.

Insert excerpt_log_traffic1_log_traffic1nopaneltrue

Inputs

A list of pipes into the file exporter.

Send by Email

In this section you can set up an automated email to be sent when a file is exported, optionally with the exported file attached. Create the list of recipients in the User Recipients section.

Emails are generated in an outbound queue and actually sent by a separate email demon process. If the email demon cannot send emails immediately, for example because the email server is down, the email demon process will try to re-send periodically until either it succeeds or the timeout period has passed.

If you specified an Input Multiplier for this file exporter, several export files may be generated. Each file may be assigned to several recipients. The subject and body expressions may also evaluate to different values each time (for example if _inputMultiplier is included in the expression). In this case PhixFlow will try to generate as few emails as possible by applying the following rules:

For each recipient identify the files to be sent to that recipient.
If the subject and body message calculated for each file is the same, generate a single email and attach all files to that email.
If the subject and body messages for each file are different, generate one email for each subject and body message pair. Attach to each email all the files for which the subject and body expression evaluated to the same subject and body message.

FieldDescriptionEmail FromEnter the email address from which the generated email will appear to be sent. Anexpressionthat must evaluate to a plain text string.Subject ExpressionEnter an expression to create the email subject. The expression must evaluate to a plain text string.Attach FileSpecify whether or not the exported file should be attached to the email sent.Future Attachments Expression

Enter an expression that evaluates to a list of external files that should be be attached to the email.

These files are created outside PhixFlow, and may or may not exist when the file exporter runs. If the files don't exist, the generated email will be held in the output queue until either they are created by some external process, or a timeout period has passed.

Zip File

Available when Attach File is selected or Future Attachments Expression is set.

Specify whether or not the attached file(s) will be zipped.

Email as HTML Insert excerpt_email_as_html_email_as_htmlnopaneltrueMessage ExpressionEnter a PhixFlowexpression to create the message body of the email. Email messages can have unlimited characters.When Email as HTML:

is not ticked the expression must evaluate to a plain text string.
is ticked, the string can include HTML tags, for example to format text or provide links.

Encryption

Available when Send By Email section → Zip File is selected. Set whether exported zip attachments are encrypted, along with the encryption parameters and the password which must then be used to open the files.

FieldDescriptionEncryption Type

The following encryption types are supported:

leave blank: If the Encryption Type is blank, then the file will not be encrypted.
Standard Zip: Standard ZIP 2.0 encryption is the encryption type that is accepted by most applications, and is the weakest supported encryption type.
AES 128-bit: All variants of AES encryption are stronger than Standard Zip encryption, but AES encryption is the weakest type of AES encryption supported and is accepted by fewer applications.
AES 256-bit: AES 256-bit is the strongest type of AES encryption supported.

Password

Email recipients must enter this password in order to open any exported zipped files.

When setting the password, you should make a note of the password used and communicate it separately to the recipients of the emails to be sent out. It is not possible to display the current password.

Confirm PasswordThis must match the main Password.User Recipients Anchoremail_usersemail_usersFieldDescriptionNotificationThis table has the standard toolbar plus the extra button Insert excerpt_user_usernopaneltrue.To add users to this table, click Insert excerpt_user_usernopaneltrue to display a list of users. Select users and drag them into the table.

Name: The user name.

Email As: The email send-type.

Expression: A PhixFlowexpression.

To change any of the data, double-click on the row to open the User Notification Rule tab.

Recipient Expressions

FieldDescriptionProtect on import Insert excerpt_check_box_tick_check_box_ticknopaneltrue to retain the current TO, CC and BCC expressions if this file exported is imported from another PhixFlow instance. Expand

title	More...

Insert excerpt_protect_import_protect_importnopaneltrueTO ExpressionEnter a PhixFlow expression to calculate the recipients for the email. The recipients returned by this expression will be added to the list of recipients returned by the individual User Notification Rule on the Email Recipients section.
For example to simply enter a list of email addresses, you can enter an expression such as: ["john.smith@acme.com","jane.doe@corp.com"]
The result of the expression must be:

either a single plain text string that should be a valid email address
or a list object that contains one or more strings, each of which must be a valid email address.

CC ExpressionAs in the TO Expression, the list of users returned by this expression will be included on the CC line on the email.BCC ExpressionAs in the TO Expression, the list of users returned by this expression will be included in the BCC line on the email

out as HTML.

Overwrite existing file

The file exporter overwrites existing files with the same name as the file to be generated. This can be useful where you want PhixFlow to replace a file at regular intervals, for example to update the content of an HTML page on an intranet.

Maximum Records per File

Enter the maximum number of records that will be written to each file.

Header

Insert excerpt

	_check_box_tick
	_check_box_tick
nopanel	true

to include a header line in the exported files. The header row contains the name of each field.

Character Set

Insert excerpt

	_character_set
	_character_set
nopanel	true

Other Character Set

Available when Character Set is Other. Enter a different character set. For the full list of available character sets, see the Oracle Java documentation about encoding; you can use the canonical names from either column.

Line Separator Style

When PhixFlow generates the file, it uses the line separator configured in System Configuration → Advanced section → Line Separator Style. If this is not set, Phixflow uses the default for the operating system on which the PhixFlow server is running.

You may want to generate an export file that uses a different line separator, for example if PhixFlow runs on Linux, but the file will be sent to Windows users. To set a different line separator, select:

Windows
Unix
Other - see Line Separator Chars, below

Line Separator Chars

Available when Line Separator Style is Other. Enter either a single character or multiple characters to use as a new line separator. The characters may be the literal characters or a sequence from the table below. These sequences are useful if the required separator character is not valid to be stored in the database.

Sequence	Description
\t	tab
\n	newline
\r	carriage return
\f	form feed
\u + hexadecimal code	unicode character specified by the hexadecimal code

Column Separator

Insert excerpt

	_column_separator
	_column_separator
nopanel	true

Separator Character

Insert excerpt

	_separator_character
	_separator_character
nopanel	true

Excel Template

Available when Export File As is one of following:

Excel Spreadsheet (Multiple Inputs): enter an expressionthat evaluates to an Excel template; see Excel Template.
Excel Spreadsheet or HTML File: enter the name of the Excel template.

Convert To PDF

Available when the Export File As is Excel Spreadsheet.

Insert excerpt

	_check_box_tick
	_check_box_tick
nopanel	true

to convert the Excel file to a PDF. PhixFlow saves the PDF to the location set in:

either the Output Directory,
or the PDF Target Path.

PhixFlow reports on the PDF conversion in the console's PDF Chore tab.

Note
PhixFlow needs access to LibreOffice to convert Excel files to PDFs; see Configuring PDF Conversion.

PDF Target Path (Expr)

Available when the Export File As is Excel Spreadsheet.

Enter an expression that evaluates to a path where PhixFlow will save the PDF file.

Evaluate Formulae Before Saving File

Insert excerpt

	_check_box_tick
	_check_box_tick
nopanel	true

to generate the export file and then to evaluate any formula in the spreadsheet before saving the file. When a user opens the file in Excel, the calculations have already been done.

Quote Style

Insert excerpt

	_quote_style
	_quote_style
nopanel	true

Quote Character

Insert excerpt

	_quote_character
	_quote_character
nopanel	true

Input Multiplier

Field

Description

Input Multiplier

The input multiplier expression should evaluate to a list of one or more values. For each value in the list, the internal variable _inputMultiplier will be set to that value and the file export process will be repeated i.e. the pull pipes will be read and the data from those pipes processed to generate file output data, and a new export file will be written.

Log Input Multiplier Messages

Insert excerpt

	_log_traffic2
	_log_traffic2
nopanel	true

Log Input Multiplier Messages: when ticked, PhixFlow writes a message to the log every time the input multiplier value changes during an analysis run, whatever is set here.

Insert excerpt

	_log_traffic1
	_log_traffic1
nopanel	true

Inputs

A list of pipes into the file exporter.

Send by Email
Anchor
SendByEmail
SendByEmail

In this section you can set up an automated email to be sent when a file is exported, optionally with the exported file attached. Create the list of recipients in the User Recipients section.

Emails are generated in an outbound queue and actually sent by a separate email demon process. If the email demon cannot send emails immediately, for example because the email server is down, the email demon process will try to re-send periodically until either it succeeds or the 10s timeout period has passed.

If you specified an Input Multiplier for this file exporter, several export files may be generated, as each record in the input multiplier will send a separate email. Each file can be assigned to several recipients. The subject and body expressions may also evaluate to different values each time (for example if _inputMultiplier is included in the expression). In this case PhixFlow will try to generate as few emails as possible by applying the following rules:

For each recipient identify the files to be sent to that recipient.
If the subject and body message calculated for each file is the same, generate a single email and attach all files to that email.
If the subject and body messages for each file are different, generate one email for each subject and body message pair. Attach to each email all the files for which the subject and body expression evaluated to the same subject and body message.

Field

Description

Email From

Enter the email address from which the generated email will appear to be sent. Anexpressionthat must evaluate to a plain text string.

Subject Expression

Enter an expression to create the email subject. The expression must evaluate to a plain text string.

Attach File

Specify whether or not the exported file should be attached to the email sent.

Future Attachments Expression

Enter an expression that evaluates to a list of external files that should be be attached to the email.

These files are created outside PhixFlow, and may or may not exist when the file exporter runs. If the files don't exist, the generated email will be held in the output queue until either they are created by some external process, or a timeout period has passed.

Zip File

Available when Attach File is selected or Future Attachments Expression is set.

Specify whether or not the attached file(s) will be zipped.

Email as HTML

Insert excerpt

	_email_as_html
	_email_as_html
nopanel	true

Message Expression

Enter a PhixFlowexpression to create the message body of the email. Email messages can have unlimited characters. When Email as HTML:

is not ticked the expression must evaluate to a plain text string.
is ticked, the string can include HTML tags, for example to format text or provide links.

Encryption

Available when Send By Email section → Zip File is selected. Set whether exported zip attachments are encrypted, along with the encryption parameters and the password which must then be used to open the files.

Field

Description

Encryption Type

The following encryption types are supported:

leave blank: If the Encryption Type is blank, then the file will not be encrypted.
Standard Zip: Standard ZIP 2.0 encryption is the encryption type that is accepted by most applications, and is the weakest supported encryption type.
AES 128-bit: All variants of AES encryption are stronger than Standard Zip encryption, but AES encryption is the weakest type of AES encryption supported and is accepted by fewer applications.
AES 256-bit: AES 256-bit is the strongest type of AES encryption supported.

Password

Email recipients must enter this password in order to open any exported zipped files.

When setting the password, you should make a note of the password used and communicate it separately to the recipients of the emails to be sent out. It is not possible to display the current password.

Confirm Password

This must match the main Password.

User Recipients
Anchor
email_users
email_users

Field

Description

Notification

This table has the standard toolbar plus the extra button

Insert excerpt

	_user
	_user
nopanel	true

.

To add users to this table, click

Insert excerpt

	_user
	_user
nopanel	true

to display a list of users. Select users and drag them into the table.

Name: The user name.
Email As: The email send-type.
Expression: A PhixFlowexpression.

To change any of the data, double-click on the row to open the User Notification Rule tab.

Recipient Expressions

Field Description

Protect during import

Insert excerpt

	_check_box_untick
	_check_box_untick
nopanel	true

to allow the recipient expressions to be updated by during import.

Insert excerpt

	_check_box_tick
	_check_box_tick
nopanel	true

to retain the current TO, CC and BCC expressions if this file exporter is imported from another PhixFlow instance.

Expand

title	More...

Insert excerpt

	_protect_import
	_protect_import
nopanel	true

TO Expression

Enter a PhixFlow expression to calculate the recipients for the email. The recipients returned by this expression will be added to the list of recipients returned by the individual User Notification Rule on the Email Recipients section.

For example to simply enter a list of email addresses, you can enter an expression such as: ["john.smith@acme.com","jane.doe@corp.com"]
The result of the expression must be:

either a single plain text string that should be a valid email address
or a list object that contains one or more strings, each of which must be a valid email address.

CC Expression As in the TO Expression, the list of users returned by this expression will be included on the CC line on the email.

BCC Expression As in the TO Expression, the list of users returned by this expression will be included in the BCC line on the email.

Insert excerpt

	_model_prop
	_model_prop
nopanel	true

Insert excerpt

	_description
	_description
nopanel	true

Insert excerpt

	_audit
	_audit
nopanel	true

Live Search
spaceKey @self
additional none
placeholder Search all help pages
type page

Panel

borderColor	#00374F
titleColor	white
titleBGColor	#00374F
borderStyle	solid
title	Sections on this page

Table of Contents

maxLevel	3
indent	12px
style	none

Learn More

For links to all pages in this topic, see Analysis Models.

Version	Old Version 73	New Version Current
Changes made by	Fiona Sargeant (Unlicensed)	Zoe Baldwin
Saved on	Oct 14, 2021	Aug 13, 2024

Page Comparison

Versions Compared

Key

Overview

Overview

Insert excerpt_property_tabs_property_tabsnamebasic-hnopaneltrue

Basic Settings

Input Multiplier

Inputs

Send by Email

Encryption

Recipient Expressions

Input Multiplier

Inputs

Send by Email AnchorSendByEmailSendByEmail

Encryption

User Recipients Anchoremail_usersemail_users

Recipient Expressions

Live SearchspaceKey@selfadditionalnoneplaceholderSearch all help pagestypepage

Insert excerpt
_property_tabs
_property_tabs
name basic-h
nopanel true

Send by Email
Anchor
SendByEmail
SendByEmail

User Recipients
Anchor
email_users
email_users

Live Search
spaceKey @self
additional none
placeholder Search all help pages
type page