IBM BPM, V8.0.1, All platforms > Manage assets in the Process Center repository > Manage the Process Center repository > Applying governance

Governance services

The System Governance toolkit provides templates and services that you can use in IBM Process Designer to create or customize a governance process.


Introduction

During IBM BPM installation, the System Governance toolkit (TWSYSG) is imported into the Process Center repository. Each governance process created must include a dependency on the System Governance toolkit. The toolkit provides the machinery required to build a governance process. The toolkit has integration services for installing process application snapshots and setting snapshot status.

You cannot edit or change the artifacts in the System Governance toolkit, but you can open the toolkit and view the artifacts within it.


Templates

The System Governance toolkit provides two templates, the Installation Requested template and the Snapshot Status Change template. Each of these templates is a business process definition (BPD) that you can adapt to the needs of your particular organization. Each of these templates is associated with a corresponding governance event. Your governance processes in Process Center must be built from one of these templates to take advantage of the governance services.

Installation Requested template

Use this template as a base to create a customized governance process that will replace the default Installation Requested BPD, which merely calls the installation service from the toolkit. The Installation Requested template has the ProcessAppInstallationRequest variable (of type ProcessAppInstallation).

Snapshot Status Change template

Use this template as a base to create a customized governance process that will replace the default Snapshot Status Change BPD, which has no activities. The Snapshot status change template has the SnapshotStatusRequest variable (of type SnapshotStatus).


Installation services

The System Governance toolkit supplies the following integration services for installation governance, all of which only run locally on Process Center. If you are using these services to install a snapshot, cancel an installation, or set installation status, the installation request must be initiated in the Process Center. See the sections that follow for more details.

Install Snapshot

Installs the snapshot on the specified process server.

Cancel Snapshot Installation

Cancels the installation request that is in progress (that is, waiting for approval). After the installation has started, the cancel request is ignored.

Get All Process Servers

Returns an array of process servers registered with Process Center.

Set Installation Status

Sets the installation status during long-running installations. Define the installation status messages that you want to use in the governance process.

Get Installation Status

Gets the installation status during long-running installations.

If an installation attempt fails, call the Cancel Snapshot Installation service to clear the status in Process Center. The only other way to clear the failure is to reset the governance process for the process application to the system default process. The governance business process definition (BPD) that called the Install Snapshot service should have all the data that is available from the failure already and can send that information in an email or log it. For failures that occurred because of an error in the process application, you might want to leave that status as a failure so no one tries to install that version again.


Install Snapshot

This service can fail to install a snapshot for a number of reasons. The installation request produces a return value that indicates if an error occurred and if the error is recoverable.


Cancel Snapshot Installation

This service can fail under the following circumstances:


Get All Process Servers


Set Installation Status

Use this service to update the installation status while an installation request is waiting for approval. When this service is called, the status updates immediately, without waiting for the current status or the installation to complete.

This service takes the following inputs:

Implementation: Calls Java API to set the installation status.

This service can fail under the following circumstances:


Get Installation Status


Snapshot status services

The System Governance toolkit supplies the following integration services for tracking snapshot status, all of which only run locally on Process Center. You can use the next three services with both process applications and toolkits.

You can use snapshot status services with the governance process or independently of the governance process. The snapshot status events are always active, whether they are being used or not.

Get snapshot status

Returns the status of a snapshot.

Get snapshot statuses

Returns a list of strings containing the statuses used for snapshots. The list contains default values defined in the product and any custom values that were added through the governance process and are currently being used in the snapshot.

Set snapshot status

Sets the snapshot to the specified status. If the status string that is specified does not already exist, the API creates a new status value using that string.


Get Snapshot Status


Get Snapshot Statuses


Set Snapshot Status

Applying governance to a process application


Related tasks:
Applying a governance BPD to a process application or snapshot
Migrating a governance process from V8.0.0
Create a governance process for installing a process application
Create a governance process for the status of a snapshot
Create a governance BPD that installs a snapshot when the status changes
Changing a governance application
Testing a governance process
Export and importing a process application that uses customized governance
Recovering if a process application under governance fails to install