uCosminexus Service Platform, Reception and Adapter Definition Guide

[Contents][Glossary][Index][Back][Next]

Appendix A.4 Custom reception definition

This section describes how to define a custom reception.

The following figure shows the flow of custom reception definition.

Figure A-4 Flow of custom reception definition

[Figure]

Each part of the process is described below.

Organization of this subsection
(1) Adding a custom reception
(2) Reviewing a custom reception definition
(3) Editing the definition of a custom reception
(4) Saving a custom reception definition
(5) Exporting the repository

(1) Adding a custom reception

Import a custom reception EAR file you created in the development environment.

To add a new custom reception:

  1. In the Service Definition List in the tree view, right-click the service (business process) for which you want to add a custom reception.
    The pop-up menu for the service list appears.
  2. From the pop-up menu, select Add User Defined Reception.
    The Reception Type Selection wizard appears.

    [Figure]

  3. From the Reception type: drop-down list, select Custom Reception.
  4. Click Next.
    The User Defined Reception Addition (Custom Reception) wizard appears.

    [Figure]

  5. Specify values in Reception name and EAR file.
    • Reception name
      Specify the name of the custom reception as a character string of 1 to 40 bytes.
      The reception name must be unique within the business process.
    • EAR file
      Specify the absolute path of the EAR file you want to import. Do not specify the file by using a relative path or in UNC format.
      You can also select the EAR file in the dialog box that appears when you click the ... button.
  6. Click Finish.
    The custom reception is added to the business process, and then the User-defined Reception Definition window appears.
    For details on the User-defined Reception Definition window, see 1.2.6 User-Defined Reception Definition Window in the manual Service Platform Reference Guide.

(2) Reviewing a custom reception definition

After importing a custom reception, check the contents of the custom reception definition. You can check the definition of a custom reception in the User-defined Reception Definition window. This window appears after you add a custom reception by using the Add Custom Reception wizard.

You can display the User-defined Reception Definition window at any other time by using the following step.

  1. In the service definition list in the tree view, double-click the custom reception.
    The User-defined Reception Definition window appears.

(3) Editing the definition of a custom reception

In the User-defined Reception Definition window, you can edit aspects of the custom reception definition you imported, such as the reception name, reception ID, and operation name.

For details on how to display the User-defined Reception Definition window at any time, see (2) Reviewing a custom reception definition. For details on the User-defined Reception Definition window and the values you can enter, see 1.2.6 User-Defined Reception Definition Window in the manual Service Platform Reference Guide.

(4) Saving a custom reception definition

You can save the custom reception definition being edited in the User-defined Reception Definition window during or after the editing process. The contents of the custom reception are stored in the repository.

If you close the User-defined Reception Definition window without saving the custom reception definition, the Save Resource dialog box appears. You can save the unsaved custom reception definition in this dialog box.

You can use the following methods to save a custom reception:

Method 1
From the Eclipse menu, select File and then Save.

Method 2
From the Eclipse menu, select File and then Save All.

Method 3
In the Eclipse toolbar, click the Save icon.

Method 4
In the User-defined Reception Definition window, press Ctrl + S.

Note that you might be unable to save the custom reception if invalid data has been entered. In this case, take action according to the message displayed on the screen.

(5) Exporting the repository

You can save the repository containing the custom reception you defined to a specified directory as a ZIP file.

To export the repository:

  1. From the Eclipse menu, select HCSC-Definer, Repository management, and then Export repository.
    The Export Repository dialog box appears.
  2. Specify the directory in which you want to save the repository information, and then enter the file name of the zip file to be saved.
  3. Click Save.

The zip file is saved to the directory you specified.

If a file with the same name already exists in the specified directory, a dialog box appears asking if you want to overwrite the file. To overwrite the file, click Yes.