All scheduled exports are defined in the Scheduled Exports repository. Each record in this repository represents one scheduled export job.
The attributes of the Scheduled Export Repository are listed in the following table, in alphabetically order.
Attribute | Description |
---|---|
Active Days Only |
If set to Yes, run the scheduled job on the designated Schedule Days. This only applies if the Schedule Type is Minutes. |
Active End Time |
The format for this value is HH:MM:SS. If Active Times Only is set to Yes and the job is of type Minutes, no jobs will be run after this time of day. Any jobs with a calculated time later than this time will not be executed. |
Active Start Time |
The format for this value is HH:MM:SS. If Active Times Only is set to Yes and the job is of type Minutes, this is the daily start time for executing jobs. Jobs with a calculated time earlier than this will not be executed. |
Active Times Only |
Only run the scheduled job if the calculated Minutes is between the Active Start Time and Active End Time. Applies only when the Schedule Type is Minutes. |
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 |
If this is set to Yes, compress the export file into a zip file if. |
Correction File Type |
Type of correction file to generate when Export Type is Validate.
|
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 |
|
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 |
If this is set to Yes, initiate the dependent operation immediately. 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 Parameter<x> attributes are used, each should be detailed as to their content and purpose. |
Email Attach Logs |
If this is set to 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 (for example, ||Manager Login|| is replaced with the value of the Manager Login attribute). |
Email Notify Failure |
If this is set to Yes and the export fails to process successfully, send an Export Failed e-mail to the owner. |
Email Notify Success |
If this is set to Yes and the export processes successfully, send an Export Successful e-mail to the owner. |
Email Subject |
Subject for success e-mail. May contain references to any other job attribute by surrounding it with double-pipe characters (for example, ||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.
|
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 |
If this is set to Yes and this job fails with an error, execute the dependent operation immediately. |
Error Dependent Operation Type |
List of operation types for each Dependent Operation when this job fails with an error.
|
Error Dependent Values |
Optional values for dependent keys when this job fails with an error. |
Export Encoding |
File Encoding for Export (UTF-8, Windows-1251, etc.). |
Export Execution Datetime |
Date and time at which this export was last executed. |
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 |
If this is set to Yes, include null values in XML Export. |
Export Language |
Language to generate for export. |
Export Name |
Name of the export. |
Export Now |
If this is set to Yes, process the export immediately. |
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 |
If Export Type is Template, this is the name of the Export Template. |
Export Type |
Type of export:
|
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:
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 |
If this is set to Yes, 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 on Linked Search Repository Name, contact your EnterWorks account representative. |
Lock Action |
Action to be taken with the lock identified in Lock Name:
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 |
If Scheduled Export is set to Yes, this is the date and time the export will be processed. |
Output to File |
If this is Yes and Export Type is Export Template, generate an export. |
Output to Table |
If this is Yes and Export Type is Export Template, save the publication table. |
Parameter1-5 |
These are 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 |
If this is Yes, after the export file is generated, it must be postprocessed using the designated class and arguments. |
Postprocess Keys |
Argument keys identifying the Postprocess Argument Values to be passed to the designated postprocess module. |
Postprocess Values |
Values for the 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 |
If Export Type is Export Template and the current date and time are not to be used, this is the effective date. |
Publication Hierarchy |
If Export Type is Export Template this is the Hierarchy used by the Export Template. |
Report Validation Level |
Specifies what validation level to report. |
Repository Format |
If Export Type is Repository type, this is the format of the file, for example: CSV, XLS, XML, or DB. |
Repository Name |
If Export Type is Repository or Export Template, this is the name of the repository. |
Repository Preference |
If Export Type is Repository type, this is the Preference to use. |
Repository Timeout |
If Export Type is Repository type, this is the number of minutes before an export has timed out. |
Return Correction File |
If set to Yes, return the correction file instead of the validation log for the export file. |
Root Repository Saved Sets |
If Export Type is Export Template this is the Saved Sets for the root repository. |
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 this is Yes, run the export using the login designated in Manager Login. When this is enabled, the Manager Login must be set to a user and not a group. |
Saved Set |
If Export Type is Repository type, this is the Saved Set. |
Schedule Days |
If Schedule Type is Days of Week, this identifies the days of the week. |
Schedule Exclude Dates Code Set |
If set to a Code Set that lists 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 |
If Scheduled Export is Yes, this is the number of minutes between exports. |
Schedule Type |
Type of schedule:
|
Scheduled Export |
If this is set to Yes, the export is scheduled. |
Scheduled Folder |
Logical folder in which the scheduled job is assigned for organization purposes. If this is 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 this is set to Yes, separate files for will be generated for category attributes. |
Skip if Busy |
If this is set to Yes, skip the scheduled export if the same named export is already busy processing. 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 |
If Target Type is Email, this is the target email address. |
Target Email Attach Logs |
If this is set to Yes, attach log files to the target email. |
Target FTP |
If Target Type is FTP, this is the FTP server name or IP address. |
Target FTP User |
FTP username. |
Target FTP User Password |
FTP user password. |
Target Overwrite File |
If this is set to Yes, overwrite the output file instead of appending the new output to the existing file. |
Target Path |
If Export Type is File Directory, this is the location for export file. |
Target S3 Access Key |
If Target Type is S3, this is the Amazon S3 access key. |
Target S3 Bucket Name |
If Target Type is S3, this is the name of the Amazon S3 bucket containing the directory into which the export file is to be uploaded. |
Target S3 Endpoint |
(Optional) If Target Type is S3, this is the target endpoint. 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 Target Type is S3, this indicates if the export is using role-based authentication. |
Target S3 Region |
(Optional) If Target Type is S3, if Use Config is selected, the configuration repository property AWS.S3.Region is used (if it is defined). |
Target S3 Secret Key |
If Target Type is S3, this is the Amazon S3 secret key. |
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 set to Yes, validate the Category/Dynamic Attributes. |
View Format |
If Export Type is View or Data Mart, this is the format:
|
View Name |
If Export Type is View or Data Mart, and View SQL is not defined, this is the name of the View. |
View SQL |
If Export Type is View or Data Mart, this is the SQL Query. The value can contain references to other attributes by surrounding them with double-pipe characters. For example, in a repository named “RepositoryView”, 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 Snapshot_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 Snapshot_Last_Updated > '[DELTA_DATETIME]' |