When a scheduled promotion is activated (either manually or on a schedule), the records in the designated repository are validated. If the repository’s validation requirements are met, the records are then promoted to Production.
All scheduled promotions are defined in the Promotions Repository. The attributes for this repository are listed alphabetically in the following table.
Attribute | Description |
---|---|
Active Days Only |
If this is set to Yes, run the scheduled job on the designated Schedule Days. Only applies if the Schedule Type is Minutes. |
Active End Time |
If Active Times Only is set to Yes and Schedule Type is set to Minutes, jobs will not be executed after this time of day. Any jobs with a calculated time later than this time will not be executed. The format of this field is HH:MM:SS. |
Active Start Time |
If Active Times Only is set to Yes jobs will not be executed before this time of day. Any jobs with a calculated time earlier than this time will not be executed. The format of this field is HH:MM:SS. |
Active Times Only |
If Schedule Type is set to Minutes, only run the scheduled job if the calculated Minutes is between the Active Start Time and Active End Time. |
Dependent Keys |
The 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 a promotion and the 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 the 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 |
The 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 |
Description for promotion. |
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. |
Last Promotion Datetime |
Date and time of when this promotion was last initiated (scheduled or manual). |
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 promotion 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. If the referenced lock is associated with the group lock in other jobs, the lock will not be considered free until all the group lock jobs have detached from the lock. |
Next Promotion Datetime |
If a promotion is scheduled, this is the date and time it will be launched. |
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. |
Promote Now |
If this is set to Yes, perform the promotion now. When the promotion is processed, this setting will be reset to No. |
Promote Warnings |
If this is set to Yes, promote records that are valid and records that have validation warnings. |
Promotion Configuration Name |
The configuration name for the promotion. It must match a named configuration in the EPIM sharedConfig.properties file. |
Promotion Errors |
Detailed error messages if promotion processing failed. |
Promotion Priority |
Relative priority for each promotion (the lower the number, the higher the priority). |
Promotion Production Repository |
Name of Production repository into which records are to be promoted. |
Promotion Skip Validation |
If this is set to Yes, validation is skipped (not performed) and the current validation status determines if records are promoted. |
Promotion Staging Repository |
Name of Staging repository from which records are to be promoted. |
Promotion Timeout (Minutes) |
Number of minutes the Promotion job will wait for the promotion to complete. The default is 600, (10 hours). |
Saved Set |
Name of the saved set containing items to be promoted. If this setting is empty, all items are promoted. |
Schedule Days |
If Schedule Type is Days of Week, this setting iidentifies the days of the week. |
Schedule Exclude Dates Code Set |
If this is set to a code set that lists dates as code values and if the calculated date is one of the dates in the code set, the scheduling logic will skip to the next scheduled date. |
Schedule Period |
Number of minutes after Last Scheduled Date that the next scheduled promotion is initiated. For example, a promotion that is to be processed daily would have a schedule period of 1440. The scheduled promotions are not affected by any manually initiated promotions |
Schedule Type |
Type of schedule:
|
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. |
Scheduled Promotion |
Set to Yes if the promotion is to be scheduled. Each time the scheduled promotion is processed, the Next Promotion Datetime is updated based on the Schedule Period. |
Status |
Status of the Promotion:
|