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.
|
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 |
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.
|
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.
|
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:
|
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 |
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:
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:
|
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:
|
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:
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:
To create a Delta (Add or Update) export, the SQL would be:
|