Scheduled Promotions Repository - EnterWorks - EnterWorks Process Exchange (EPX) - Precisely EnterWorks - 10.5

EnterWorks Classic Administration Guide

Product type
Software
Portfolio
Verify
Product family
EnterWorks
Product
Precisely EnterWorks > EnterWorks
Precisely EnterWorks
Precisely EnterWorks > EnterWorks Process Exchange (EPX)
Version
10.5
Language
English
Product name
Precisely EnterWorks
Title
EnterWorks Classic Administration Guide
First publish date
2007
Last updated
2023-08-02
Published on
2023-09-20T17:55:59.992423

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:

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

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

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

  • No Lock – the promotion 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.

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:

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

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

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

  • No Lock – the promotion 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 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:

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

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

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

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

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

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:

  • Active – the promotion is active and will be processed when conditions are met

  • Inactive – the promotion is inactive and will not be processed.