Scheduled Exports Repository

All scheduled exports are defined in the Scheduled Exports repository.

Each attribute in this repository is described in the following table. Attributes in the Deprecated tab are no longer in use. Note that when the repository is opened in a Repository View, the default Preference does not show all attributes.

Attribute

Description

Active Days Only If this is set to Yes, if Schedule Type is Minutes, run the scheduled job on the designated Schedule Days.
Active End Time Format is HH:MM:SS. If Active Times Only is set to Yes, scheduled jobs of type Minutes will not be executed after this time of day. Any jobs scheduled to run at a calculated time later than this time will be skipped.
Active Start Time Format is HH:MM:SS. If Active Times Only is set to Yes, scheduled jobs of type Minutes will not be executed before this time of day. Any jobs scheduled to run at a calculated time before this time will be skipped.
Active Times Only If the Schedule Type is Minutes, only run the scheduled job if the calculated Minutes is between the Active Start Time and Active End Time.

Additional Conditions

Additional SQL conditions to filter Delta records. Alias 'v' can be used to reference the view. For example: v.[Portal Status] in ('Submitted - Request Pending', 'Reviewed').

Additional Conditions (AND/OR)

This allows the user to select if all or any one of the conditions (if multiple) should be used to filter records.

Compress File

Compress the export file into a zip file if "Yes".

Correction File Type

The type of correction file to generate when Export Type is Validate.

  • 0: None. Place validation errors in the Validation job log file.

  • 1: One file for each attribute with errors.

  • 2: A single file with all attributes with errors.

Created Attribute Name

Name of attribute representing the creation date for the record.

Custom Source File Name

Sets the file name for a Custom export for the registered post-processing class (since no file was generated by EnterWorks). It is the responsibility of the post-process class to actually generate the file.

Delta Export

  • <blank> - No Filtering of records.

  • Add – Include only new records since last export.

  • Change - Include only changed records since last export.

  • Add or Change - Include only new or changed records since last export.

  • Full – Include all records subject to Additional Conditions.

Delta Export Offset

Number of minutes to offset the Delta export end time to give concurrent updates time to complete. The value should be set based on the EnterWorks batch size and database performance.

For example, if the batch size is 200 and it may take the SQL Server database 30 seconds to save all 200 records, an offset of 1 or 2 minutes should be ample.

Dependent Keys

List of keys to be passed to each dependent operation. The keys must match attribute names in the dependent repository. The corresponding value in the Dependent Values attribute is then used to set the value of the key attribute when the Job is created. The value can reference attributes from the source job by surrounding the attribute name with double-pipe characters.

For example, if an export is dependent on an import and that export should specify the same user, the Dependent Key would be set to "Manager Login" and the value would be "||Manager Login||". Conversely, if the same dependent Export needs to be set to the admin user regardless of its initial definition, the Dependent Key would be set to "Manager Login" and the Dependent Values set to "admin".

Dependent Operation

Name of dependent Import, Export, or Promotion to be initiated upon successful completion of this job.

Dependent Operation Immediate

Initiate the dependent operation immediately if "Yes". Otherwise the operation will be queued and processed by the scheduler.

Dependent Operation Type

Type of dependent operation: Promotion, Import, or Export.

Dependent Values

Values corresponding to the Dependent Keys that are passed to the dependent operations. Values may reference attributes by surround the attribute name with double-pipe characters.

For example, to reference the Import Job number, the Dependent Values might contain: "Job||Export Job||". If Export Job in the current record is set to 1234, the resulting value will be "Job1234"

Description

Optional description for export. It is strongly recommended that the Description be populated with all the details for the export, including any job that launches this job, any pre-processing performed, and what jobs this job launches. If ParameterX attributes are used, each should be detailed as to their content and purpose.

Email Attach Logs If Yes, attach the log files to the status e-mail.

Email Body

Override e-mail body for successful jobs. Attributes in the job record can be referenced by surrounding them with double-pipe characters (e.g., ||Manager Login|| is replaced with the value of the Manager Login attribute).

Email Notify Failure

Send an Export Failed e-mail to the owner if Yes and the export fails to process successfully.

Email Notify Success

Send an Export Successful e-mail to the owner if Yes and the export processes successfully.

Email Subject

Subject for success e-mail. May contain references to any other job attribute by surrounding it with double-pipe characters (e.g., ||Manager Login|| is replaced with the value of the attribute Manager Login).

Email To

Email address(es) to which success/failure notifications will be sent. If not defined, the e-mail address(es) associated with the Manager Login user/group will be used.

Empty File Action

Identifies the action to be taken if the export file is empty.

  • Continue - continue processing.

  • Error - treat empty file as failed export.

  • Stop - stop processing (no dependent operations).

Error Dependent Keys

Optional keys for arguments to be passed to any Dependent jobs (as properties) when this job fails with an error.

Error Dependent Operation

List of Promotions, Imports, and/or Exports (based on Dependent Operation Type) that should be triggered on successful completion of this one.

Error Dependent Operation Immediate

Execute dependent operation immediately if Yes when this job fails with an error.

Error Dependent Operation Type

List of operation types for each Dependent Operation when this job fails with an error.

  • Export – launch an export job.

  • Import – launch an import job.

  • Promotion – launch a promotion job.

Error Dependent Values

Optional values for dependent keys when this job fails with an error.

Export Encoding

File Encoding for Export, for instance: UTF-8 or Windows-1251.

Export Execution Datetime

Date and time at which this export was last performed.

Export File Name

Name of file to be generated by the export. This attribute can include references to other attributes by surrounding the attribute name with double-pipe characters.

For example, to include the job number in the export file name, the file name could be "MyFile_||Export Job||.csv".

Export Include Null Values

Include Null Values in XML Export if Yes.

Export Language

Language to generate for export.

Export Name

Name of the export.

Export Now

Process the export immediately if Yes.

Export Priority

Relative priority for the export determines the order of exports ready to be processed. The lower the number, the higher the priority.

Export Template

Name of Export Template (if Export Type is Template).

Export Type

Type of export:

  • Repository – export of a single repository using the designated User Preference

  • View – SQL export against the EnterWorks 10 database.

  • DataMart – SQL export against the Data Mart database

  • Export Template – export using the designated Export Template

  • Custom – relies on the PostProcessing module to generate a file.

  • Validate – performs a validation on the designated repository and saved set.

Group Lock Action

Group locks allow for multiple concurrent jobs to all attach to the same lock. The lock is not freed until all processes have detached from it.

Action to be taken with the lock identified in Group Lock Name:

  • Attach – the import will attach to the specified lock. Processing for the export will begin immediately.

  • Free – the import will detach from the named lock (presumably set by a previous job that invoked this import) once the export processing has completed. The lock is not completely freed until all attached processes have detached.

  • Attach And Free – the export will attach to the named lock and begin processing and detach from the named lock once processing has completed.

  • No Lock – the export will not attach to a group lock.

Group Locks will always acquire the designated lock, even if another process has acquired or attached to the same lock. If multiple jobs attach to the same lock via Group Lock, the lock is not free until all of the processes have freed the lock.

Group Lock Name

Name of the group lock.

Include Timestamp

Include date and time in Export_<job>.log file if Yes. This can be helpful in troubleshooting post-processing for an export as it shows how long processing steps took (providing the appropriate messages are being reported).

Last Export Datetime

Date and time of when the export was last executed.

Last Export Update Datetime

Date and time of when last DELTA export was executed.

Last Scheduled Export Datetime

Date and time the export was last scheduled.

Linked Repository Name

Optional list of repositories included in the Export Template.

Linked Repository Saved Set

Saved set to be used for each corresponding linked repository to identify which linked records are to be included.

Linked Repository Search Config

List of predefined searches on the linked repositories to be applied to limit the records in the export.

Linked Search Repository Name

For more information about Linked Search Repository Name, contact your EnterWorks account representative.

Lock Action

Action to be taken with the lock identified in Lock Name:

  • Acquire – the import will wait until the named lock is acquired. Processing for the import will not begin until then.

  • Free – the import will free the named lock (presumably set by a previous job that invoked this import) once the import processing has completed.

  • Acquire And Free – the import will wait until the named lock is acquired and will free the named lock once processing has completed.

  • No Lock – the import will not wait for any lock before processing.

Locks will only be acquired if they are currently free. If the designated lock has been attached to by multiple jobs using the Group Lock, the lock does not become free until all of those jobs have freed the lock.

Lock Name

Name of the lock to acquire or free (depending upon Lock Action). If more than one import shares the same lock, then they will be processed serially. The name may contain references to other properties by surrounding each property name with double-pipe characters.

For example, to ensure only one instance of an import is processed at a time for each user, the Lock Name can be set to: "Import||Manager Login||". This will produce a lock name of "Importjdoe" for John Doe and "Importjsmith" for John Smith.

Manager Login

Login ID of the user or the name of the EnterWorks role who will receive notification e-mails for the export.

Next Export Datetime

Date and time the export will be processed if Scheduled Export is "Yes".

Output to File

Generate an export file if Yes for Export Template type.

Output to Table

Saved the publication table if Yes for Export Template type.

Parameter1-5

Five attributes that can serve as parameters when jobs are connected through the Dependent Operation attributes. They are not used directly by the export processing but can be referenced in other attributes.

Postprocess Class

Fully-qualified path, identifying the Postprocess class to be invoked for this import. It must be a subclass of com.enterworks.services.BaseCustomProcessFile

Postprocess File

Export file must be post-processed after being generated using the designated class and arguments if "Yes".

Postprocess Keys

Argument keys identifying the Postprocess Argument Values to be passed to the designated postprocess module.

Postprocess Values

Values for corresponding Postprocess Argument Keys to be passed to the designated postprocess module. Values can contain references to properties from this job by surrounding the property name with double-pipe characters. For example, to pass the Export Job, the value would be set to "||Export Job||".

Publication As Of Date

Effective date for Export Template type if not the current date and time.

Publication Hierarchy

Hierarchy used by the Export Template.

Report Validation Level Specifies which validation level to report.

Repository Format

Format for Repository type export (e.g., CSV, XLS, XML, or DB).

Repository Name

Name of repository for Repository or Template exports.

Repository Preference

User Preference to be used for Repository export.

Repository Timeout (Minutes)

Number of minutes before a Repository type export has timed out.

Return Correction File If Yes, return the correction file instead of the Validation Log for the export file.

Root Repository Saved Sets

Saved set for root repository in Template export.

Root Repository Search Configs

List of predefined searches on the root repository to be applied to limit the records in the export.

Run As Manager Login If Yes, run the export using the login designated in Manager Login. When enabled, the Manager Login must be set to a user and not a group.

Saved Set

Saved set for Repository type export.

Schedule Days

Identifies the days of the week if Schedule Type is Days of Week.

Schedule Exclude Dates Code Set

If set to a Code Set listing dates as code values, the scheduling logic will skip to the next scheduled date if the calculated date is one of the dates in the Code Set.

Schedule Period

Number of minutes between exports if Scheduled Export is "Yes".

Schedule Type

Type of schedule:

  • MINUTES – the Schedule Period identifies the number of minutes before re-invoking the export.

  • DAYS – the Schedule Period identifies the number of days before re-invoking the export.

  • DAYS OF WEEK – specific days of the week on which the export is to be executed.

  • WEEKS – the Schedule Period identifies the number of weeks before re-invoking the export.

  • MONTHS – the Schedule Period identifies the number of months before re-invoking the export.

Scheduled Export

Export is scheduled if "Yes".

Scheduled Folder

Logical folder in which the scheduled job is assigned for organization purposes. If set, and the Scheduled Folder hierarchy is selected in the repository list view, this import job can be found by clicking a node in the Scheduled Folder hierarchy.

Scheduled Folder Sequence

Used to control the order of scheduled jobs in the Scheduled Folders.

Separate Files for Category Attributes If Yes, for each Taxonomy node in the selected records, a separate Export file will be generated that includes only the values of global attributes and the Category Attributes attached to the Taxonomy node.

Skip if Busy

Skip the scheduled export if the same named export is already busy processing if Yes. This can be used to prevent a backlog of exports if an export has been delayed or takes longer than the schedule period to complete.

Status

Status of export (Active, Inactive, Retired).

Target Email

Email address if Target Type is Email.

Target Email Attach Logs If Yes, attach log files to the target Email.

Target FTP

FTP server name or IP address if Target Type is FTP

Target FTP User

FTP user name

Target FTP User Password

FTP user password

Target Overwrite File

Overwrite output file (vs. append) if Yes

Target S3 Access Key Amazon S3 Access Key if Source Type is S3. If not defined, the property named "amazon.s3.AWSAccessKey" in the <drive>:\Enterworks\EPX\bin\conf\Enterworks.properties file is used.
Target S3 Bucket Name The name of the Amazon S3 Bucket containing the directory into which the export file is to be uploaded.
Target S3 Endpoint Optional Endpoint when S3 is the target. If Use Config is specified, then the Configuration repository property AWS.S3.Endpoint is used (if it is defined).
Target S3 Is Role Based Auth If Role Based Auth is false, the Access Key and Secret Key are used. If not defined, the property named "amazon.s3.isRoleBasedAuth" in the <drive>:\Enterworks\EPX\bin\conf\Enterworks.properties file is used.
Target S3 Region Optional Region when S3 is the target. If Use Config selected, then the Configuration repository property AWS.S3.Region is used (if it is defined).

Target S3 Secret Key

Amazon S3 Secret Key if Target Type is S3. If not defined, the property named "amazon.s3.AWSSecretKey" in the <drive>:\Enterworks\EPX\bin\conf\Enterworks.properties file is used.

Target Type

Type of target (Email, FTP, File. S3) .

Transmission Option

Identifies the transmission option to be invoked upon completion of the export file generation.

Validate Category/Dynamic Attributes

If Yes, the Category/Dynamic Attributes are validated.

View Format

Format for View or Data Mart Export Type:

  • TAB – values separated by tab characters

  • COMMA – values separated by commas. If a value contains a comma or double-quote, the entire value is surrounded by double quotes and any double-quotes in the value are escaped by another double quote. For example, the value: Monsters, Inc. Size=3" x 4" is converted to: "Monsters, Inc. Size=3"" x 4"""

  • ~ - values separated by the tilde character

  • * - values separated by the asterisk character

  • | - values separated by the pipe character

View Name

Name of View for Export Type View or DataMart (if View SQL is not defined).

View SQL

SQL Query for Export Types of View or DataMart. The value can contain references to other attributes by surrounding them with double-pipe characters.

For example, to filter data by the user who initiated the import, the SQL would be:

SELECT * FROM RepositoryView WHERE [Updated By] = ‘||Manager Login||’

If the View export is a Delta export, then the snapshot table view columns Created and/or Last Updated can be compared to the ‘[DELTA_DATETIME]’ keyword which is converted to the date and time the export was last executed.

For example, to create a Delta (Add) export for the repository named "RepositoryView", the SQL would be:

SELECT * from RepositoryView WHERE Created > ‘[DELTA_DATETIME]’

To create a Delta (Add or Update) export, the SQL would be:

SELECT * from RepositoryView WHERE Created > ‘[DELTA_DATETIME]’ OR Last_Updated > ‘[DELTA_DATETIME]’