To View and Maintain Systems:

1. Use a Web browser to navigate to the Event Manager, using a responsibility and navigation path specified by your system administrator. Then choose the Systems tab, and choose the System Details tab in the side navigation. See: Oracle Workflow Developer Navigation Paths.

2. Search for the systems you want to display. The main search option is:

   • Name - Enter the internal name of the system you want to display. You can enter a partial value to search for systems whose internal names contain that value.

   You can also enter the following additional search criteria:

   • Display Name - Enter the display name of the system you want to display.

   • Master - Select the master system for the system you want to display.

   If you display the local system, its internal name is marked with an asterisk (*).

3. To view the agents on a system, select the agents icon for that system.

   If you have workflow administrator privileges, you can update an agent by selecting the update icon for that agent. See: To Create or Update an Agent.

4. To view the subscriptions for a system, select the subscription icon for that system.

   Note: For systems that do not have any subscriptions, a blank subscription icon appears in the Subscription column. For systems that do have subscriptions, a full subscription icon appears.

   • If you have workflow administrator privileges, you can define a new subscription for the system by selecting the Create Subscription button. The Create Event Subscription page appears with the system name automatically entered as the subscriber in the System field. See: To Create or Update an Event Subscription.

   • If you have workflow administrator privileges, you can update an existing subscription by selecting the update icon for that subscription. See: To Create or Update an Event Subscription.

     Note: For seeded subscriptions with a customization level of Limit, you can only update the subscription status. For seeded subscriptions with a customization level of Core, you cannot update any properties; you can only view the subscription definition.

5. If you have workflow administrator privileges, you can use the administration icons and buttons in the System Details page to perform administrative operations.

   • To update a system, choose the update icon for that system. See: To Create or Update a System.

   • To delete a system, select the system and select the Delete button.

     Note: You can only delete systems that do not have any agents defined on them or any subscriptions referencing them. Also, you cannot delete the local system.

   • To create a new system definition, select the Create System button. See: To Create or Update a System.

     Note: You should use the Create System page only to manually create system definitions for external systems that are not Workflow-enabled. For a Workflow-enabled system, you should use the Register External System page instead to automatically register the system identifier information. See: Registering External Systems.

   To Create or Update a System:

1. Navigate to the Create System page or to the Update System page. The Create System page and the Update System page are identical, except that the fields in the Update System page are populated with previously defined information for the selected system.

   Note: You should use the Create System page only to manually create system definitions for external systems that are not Workflow-enabled. For a Workflow-enabled system, you should use the Register External System page instead to automatically register the system identifier information. See: Registering External Systems.

   You can use the Update System page to update both systems that are Workflow-enabled and those that are not.

2. Enter the internal name of the system in the Name field.

   Important: The internal name must be all-uppercase and should not include any single or double quotation marks (' or ") or spaces.

3. Enter a display name for the system.

4. Enter an optional description for the system.

5. Optionally enter a master system from which you want this system to receive Event Manager object definition updates.

   To Generate Local System Identifier Information:

1. Use a Web browser to navigate to the Event Manager on the system you want to register as a destination system, using a responsibility and navigation path specified by your system administrator. Then choose the Systems tab, and choose the Generate Local System Identifier tab in the side navigation. See: Oracle Workflow Developer Navigation Paths.

   Note: If you do not have access to the Oracle Workflow installation on the destination system, ask the workflow administrator for that system to perform this step.

2. Select the Generate button. Oracle Workflow generates the local system identifier XML document, which contains the definitions of the local system and its inbound agents, and displays that document in the XML Content field.

3. Select the Save button to save the XML document to your file system as an XML file. You can then enter it as the event data when you register this system with a source system. See: To Register an External System.

   To Register an External System:

1. Use a Web browser to navigate to the Event Manager on the source system where you want to register a destination system, using a responsibility and navigation path specified by your system administrator. Then choose the Systems tab, and choose the Register External System tab in the side navigation. See: Oracle Workflow Developer Navigation Paths.

   Note: If you do not have access to the Oracle Workflow installation on the source system, ask the workflow administrator for that system to perform this step.

2. In the Event Identifier region, specify the identifying information for the System Signup event.

   • Event Name - Oracle Workflow automatically displays the internal name of the System Signup event, oracle.apps.wf.event.system.signup.

   • Event Key - Enter an event key that uniquely identifies this instance of the event.

   • Send Date - Optionally specify the date when the event message is available for dequeuing. If you set the send date to a future date when you raise the event, the event message is placed on the WF_DEFERRED queue, and subscription processing does not begin until the specified date.

3. In the Event Parameter region, optionally enter any additional parameter name and value pairs to be stored in the parameter list within the event message. You can enter up to 100 parameters.

4. In the Event Data region, enter the system identifier XML document for the destination system you want to register. See: To Generate Local System Identifier Information.

   • To enter the system identifier information manually, select Write XML in the Upload Option field and paste the XML document into the XML Content field. You can enter up to 4000 characters.

   • To upload the system identifier XML file from your file system, select Upload XML in the Upload Option field. Enter the full path and file name of the XML file containing the system identifier information in the XML File Name field, and select the Upload XML File button.

   Note: You must provide the system identifier information in order to register a system. You cannot leave the event data XML content blank.

5. Choose the Submit button to raise the System Signup event to the Event Manager. When the System Signup event is raised, Oracle Workflow executes a predefined subscription that loads the system identifier information from the event data to the Event Manager. See: System Signup Event.