The IDCServiceSetup collaboration template is used to configure an Internet Data Center (IDC) service on a telecommunications network. The setup of the IDC service is processed by a network activation system.
IDCServiceSetup uses the Generic ConfigRecordIDC business object to represent a configuration record for an IDC service.
This collaboration template uses the ProcessContext attribute of generic business objects to maintain process information between two or more collaboration objects. In order to maintain this information, the collaboration object performs the following actions, starting from when it receives a triggering business object:
This section includes information on port bindings and required steps for setting up collaboration objects based on this collaboration template. For information on standard features, ports, and configuration properties for collaboration templates, and for general information on creating collaboration objects refer to the documents listed in Required documents for creating collaboration objects.
The following diagram illustrates IDCServiceSetup's ports:
Note: To keep the collaboration object from using a port, bind that port to the Port connector. Doing so indicates that the port is unused without causing the collaboration object to provide additional functionality.
The following tables describe bindings for the ports of two separate collaboration objects based on this collaboration template. The purpose of the two instances is described in Setting up the collaboration object.
Business object | Bound to | Function | Verbs used |
---|---|---|---|
ConfigRecordIDC (Instance A) | WebSphere MQ Workflow | Receives the triggering business object. At the end of a synchronous call, this port also returns the triggering business object to the source application when the collaboration object ends successfully. | Setup |
ConfigRecordIDC (Instance B) | Software distribution system | Receives the triggering business object. At the end of a synchronous call, this port also returns the triggering business object to the source application when the collaboration object ends successfully. | ReturnSetupResult |
Business object | Bound to | Function | Verbs used |
---|---|---|---|
ConfigRecordIDC (Instance A) | Software distribution system | Sends the triggering business object out of the collaboration object | Setup |
ConfigRecordIDC (Instance B) | WebSphere MQ Workflow | Sends the triggering business object out of the collaboration object | ReturnSetupResult |
Business object | Bound to | Function | Verbs used |
---|---|---|---|
ConfigRecordIDC | Software distribution system | Sends a reference-valued business object to retrieve the full-valued business object. The result determines which verb to use when synchronizing the ConfigRecordIDC. | Retrieve |
Business object | Bound to | Function | Verbs used |
---|---|---|---|
ConfigRecordIDC | Software distribution system | Retrieves the source data from the master application. When the collaboration object is used in a sync mode, where it receives only the key information from the From port, it retrieves the source data from the master application, and synchronizes that data with other applications. | Retrieve |
Since this collaboration object is assumed to handle a long-running process, a special setup for an asynchronous call model is required. In order to set up the collaboration object for an asynchronous call model, complete the following steps:
This section illustrates the following business processes for this collaboration template:
This section illustrates this collaboration template's process logic for its supported verbs indicated below, as well as additional process logic that will be executed if the SYNC_FROM_SOURCE configuration property is set to true:
The following diagram shows the process logic for this collaboration template's Setup verb.
The following diagram shows the process logic for this collaboration template's ReturnSetupResult verb.
The following diagram shows the additional process logic that is executed when the collaboration object's SYNC_FROM_SOURCE configuration property is set to true.
This collaboration template uses the following standard business processes:
This section describes the following properties for this collaboration template:
This collaboration template uses the following standard configuration properties:
This collaboration template has a single collaboration-specific property, SYNC_FROM_SOURCE. This property specifies whether to retrieve the source data from the master application through the SourceApp port before sending the data to another application. When the triggering business object has only the key information, this property should be set to true.
Possible values | Usage |
---|---|
true | Causes this collaboration object to retrieve the full-value business object and use it as triggering business object. |
false (default value) | Causes this collaboration object to use the triggering business object directly. In this case, the SourceApp port is bound to the Port connector. |