Skip Headers

Oracle® Application Server ProcessConnect User's Guide
10g (9.0.4)

Part Number B12121-01
Go To Documentation Library
Home
Go To Product List
Solution Area
Go To Table Of Contents
Contents
Go To Index
Index

Go to previous page Go to next page

11
Managing Adapter Interactions and Event Types

This chapter describes the adapter interaction and event type management tasks required to design an integration.

This chapter contains these topics:

Adapter Interaction and Event Type Management Tasks Overview

Table 11-1 describes Oracle Application Server ProcessConnect adapter interactions and event types and provides references to tasks for defining the adapter interaction and event type portions of an integration.

Table 11-1  Adapter Interaction and Event Type Management Tasks
Component Description See Section...

Adapter interactions

Adapter interactions define the communication between the Oracle Application Server ProcessConnect runtime system and various adapters to send and receive data.

Adapter interactions consist of two parts:

  • An adapter interaction, which represents the unique actions that can be performed with a specific adapter (such as send a message, receive an e-mail, read a file, and so on).

  • Files that define these actions (such as an XSD definition file that specifies details on how a party requests a purchase order to buy computer equipment). Files using token substituted text and data definition description language (D3L) formats can also be used.

"Managing Adapter Interactions"

Native events

A native event is the Oracle Application Server ProcessConnect internal implementation of the business data. The body elements of the native event contain the various sections of the wire message from a party, such as payloads or attachments.

"Managing Native Event Types"

Native event correlations

Native event correlation is an expression that defines when two native event instances (the requesting native event and the reply native event) are related. Native event correlation ensures that the correct request native event instance and reply native event instance are correlated and provided to the corresponding native role instances.

"Managing Native Event Correlations"

Event maps

An event map defines an expression for each Oracle record and determines the specific native event type to use with a given record instance. The event map is defined on a single event body element level.

"Managing Event Maps"

Application events

An application event represents the datatypes in an interpretable syntactic format. To create this format, a translator converts the wire message to an XML-based message and native event validation occurs.

After the native event is represented as the corresponding application event, Oracle Application Server ProcessConnect can extract values from it and can make decisions based on it, or transform it.

"Viewing Application Event Types"

Business events

A business event establishes a common event structure and vocabulary across all parties. Business events are completely removed from any party-specific properties, including data structure and vocabulary. All related events from all parties follow the same structure and the same vocabulary once they are translated and transformed into business events. The event body element of the business event contains a complete set of business data. You create an event body element inside a business event that contains the business event datatypes used by all parties in an integration.

The business event is essentially a superset of all the corresponding party-specific application events.

"Managing Business Event Types"

Managing Adapter Interactions

The user interface tool enables you to perform the adapter interaction management tasks shown in Figure 11-1. These tasks are described in detail in this section.

Figure 11-1 Adapter Interaction Management Tasks

Text description of list.interactions.gif follows.

Text description of the illustration list.interactions.gif

Adapter interactions define the communication between the Oracle Application Server ProcessConnect runtime system and various adapters to send and receive data.

Adapter interactions consist of two parts:

Figure 11-2 provides an example of an adapter interaction.

Figure 11-2 Adapter Interactions

Text description of ipusr063.gif follows

Text description of the illustration ipusr063.gif

You create two adapter interactions (inbound and outbound) in this example. During the first session, you specify:

During the second session, you specify:

Both the inbound and outbound adapter interaction create the Oracle record, which establishes the conceptual boundary between Oracle Application Server ProcessConnect and a party. Immediately after creation of an inbound and outbound adapter interaction, you can use this interaction to create a native event, specify a translator, create an application event, and create application event body elements for the various sections of the wire message, such as header details, attachments, and payload data. The native event body elements are created by the adapter.

Table 11-2 identifies the adapter interaction management tasks shown in Figure 11-1 and provides references to procedures for performing these tasks.

Table 11-2  Adapter Interaction Management Tasks
Interactions Page Elements Management Task First See Section... Then See Section...

Shortcuts section

Take shortcuts to manage native and application event types

N/A

Add button

Add an adapter interaction

"Accessing Adapter Interaction Management Tasks"

"Adding an Adapter Interaction"

Delete column

Delete an adapter interaction

 

"Deleting an Adapter Interaction"

Adapter Providers column

View an adapter interaction

 

"Viewing an Adapter Interaction"

See Also:

Accessing Adapter Interaction Management Tasks

Follow these instructions to access the adapter interaction management tasks shown in Figure 11-1.

To access adapter interaction management tasks:

  1. Select the Modeling tab.

  2. Select the Interactions tab.

    The Interactions page appears.

  3. Click Expand All.

    The list expands to display the available adapter types. (See Figure 11-1.)

  4. Select a task to perform and see the referenced section for instructions:

    To... Then... See Section...

    Add an adapter interaction

    Click Add.

    "Adding an Adapter Interaction"

    Delete an adapter interaction

    Select a specific adapter interaction in the Delete column.

    "Deleting an Adapter Interaction"

    View an adapter interaction

    Select a specific adapter interaction from the expanded list.

    "Viewing an Adapter Interaction"

    See Also:

    "Creating a Native Event Type" if you want to create a native event type to assign to an existing adapter interaction

Adding an Adapter Interaction

This section describes how to perform the following tasks:

You can also optionally start a wizard during this session to create a native event, an application event, and event body elements for the various sections of the native format (wire) message, such as header details, attachments, and payload data.

To add an adapter interaction:

  1. Ensure that you followed the instructions in "Accessing Adapter Interaction Management Tasks" to access the page for adding an adapter interaction.

    The Add Interaction : Select Adapter Type page appears.

  2. Click Expand All.

    Available adapters appear, including the technology adapters described in this chapter and any application adapters that you have installed.

  3. Select the adapter to use from the expanded list.

  4. If you are adding an adapter interaction for the Oracle Database adapter or Advanced Queuing adapter, you must already have created a delivery channel by following the instructions in "Creating an Application Delivery Channel". You are prompted at this step to select this delivery channel from a list of delivery channels. If successful, the Add Interaction : Select Interaction page appears. If the delivery channel you select cannot log you into the application spoke database, an error displays and you are prompted to correct the credentials.

    The Add Interaction: Select Interaction page appears and displays in the Inbound direction (for adapter interactions to use for messages being sent to Oracle Application Server ProcessConnect) and the Outbound direction (for adapter interactions to use for messages being sent from Oracle Application Server ProcessConnect).

  5. Select a specific direction (Inbound and Outbound) or click Expand All to view all inbound and outbound adapter interactions.


    Note:

    Clicking Expand All can take time if there are a lot of adapter interactions. This can potentially be the case for the Oracle Database adapter and Advanced Queuing adapter.


    In this example, a specific adapter interaction for the JMS adapter is selected:

    Text description of add_interaction_select.gif follows.

    Text description of the illustration add_interaction_select.gif

  6. See the following sections or guides for descriptions of adapter interactions available with each adapter and for procedures on adding an adapter interaction:

    Adapter See Section/Guide...

    Advanced Queuing (AQ) adapter

    "Adding an Advanced Queuing Adapter Interaction"

    E-Mail adapter

    "Adding an E-Mail Adapter Interaction"

    File/FTP adapter

    "Adding a File/FTP Adapter Interaction"

    HTTP adapter

    "Adding an HTTP Adapter Interaction"

    JMS (Java Message Service) adapter

    "Adding a JMS (Java Message Service) Adapter Interaction"

    Oracle Database adapter

    "Adding an Oracle Database Adapter Interaction"

    Web Service adapter

    "Adding a Web Service Adapter Interaction"

    PeopleSoft 8 adapter

    Oracle Application Server Integration Adapter for PeopleSoft 8 User's Guide

    SAP R/3 adapter

    Oracle Application Server Integration Adapter for SAP R/3 User's Guide

    Siebel 2000 adapter

    Oracle Application Server Integration Adapter for Siebel 2000 User's Guide

    J.D. Edwards OneWorld XE adapter

    Oracle Application Server Integration Adapter for J.D. Edwards OneWorld XE User's Guide

    VSAM adapter

    Oracle Application Server Integration Adapter for VSAM Installation and User's Guide

    CICS adapter

    Oracle Application Server Integration Adapter for CICS Installation and User's Guide

    IMS/TM adapter

    Oracle Application Server Integration Adapter for IMS/TM Installation and User's Guide

    IMS/DB adapter

    Oracle Application Server Integration Adapter for IMS/DB Installation and User's Guide

    Tuxedo adapter

    Oracle Application Server Integration Adapter for Tuxedo Installation and User's Guide


    Note:

    If an interaction has already been added, you cannot add it a second time. Attempting to do so causes an error message to appear. You must first delete the existing interaction. Expand the Interactions page shown in Figure 11-1 to display a list of currently-defined adapter interactions.



    Note:

    More than one page of interaction questions can appear.


Adding an Advanced Queuing Adapter Interaction

  1. Select the inbound or outbound adapter interaction to add and see the referenced section for instructions. Only queues supported by the application (spoke) database appear. The questions that appear are based on the adapter exchange protocol you select.

    Adapter Exchange Protocol See Section...

    Inbound

    "Inbound Direction"

    • RAW Queue

    • Oracle Object Queue

    • Oracle Object Queue with payload fields

    Outbound

    "Outbound Direction"

    • RAW Queue

    • Oracle Object Queue

    • Oracle Object Queue with payload fields

    See Also:

    "Advanced Queuing Adapter" for additional Advanced Queuing adapter details

Inbound Direction

Follow the procedures in this section. An asterisk (*) indicates a required field.

  1. Provide responses to the following questions. The questions can vary based on whether a multiconsumer or single consumer queue is detected.

    Question Description
    • For a multiconsumer queue:

      Queue queue_name is a multiconsumer queue. Please specify a consumer name. *

    Enter a name from 1 to 30 characters in length. There is no default value.

    • For a single consumer queue:

      Specify optional dequeue correlation ID.

    Enter an ID from 1 to 30 characters in length. There is no default value.

    Select the object fields in queue queue_name that will contain message payloads. *

    Note: Only for adapter interactions of the static protocol Oracle Object Queue with payloads.

    Select fields from the list. All Oracle object type fields in the queue queue_name that can carry an XML document appear. There is no default value.

  2. Click Apply.

  3. Go to "Review the Adapter Interaction Details" to review details about your selection.

Outbound Direction

Follow the procedures in this section. An asterisk (*) indicates a required field.

  1. Provide responses to the following questions.

    Question Description
    • For a multiconsumer queue:

      Queue queue_name is a multiconsumer queue. Please specify the recipients as a comma-separated list. *

    Enter recipients from 1 to 500 characters in length. There is no default value.

    • For a single consumer queue:

      Specify an optional enqueue correlation ID.

    Enter an ID from 1 to 30 characters in length. There is no default value.

    Select the object fields in queue queue_name that contain message payloads.

    Note: Only for adapter interactions of the static protocol Oracle Object Queue with payloads.

    Select fields from the list. All Oracle object type fields in the queue queue_name that can carry an XML document appear. There is no default value.

  2. Click Apply.

  3. Go to "Review the Adapter Interaction Details" to review details about your selection.

    See Also:

    Application Developer's Guide - Advanced Queuing available on the Oracle Technology Network:

    http://otn.oracle.com
    

Adding an E-Mail Adapter Interaction

  1. Select the inbound or outbound adapter interaction to add and see the referenced section for instructions. The questions that appear are based on the adapter exchanger protocol you select.

    Direction See Section...

    Inbound

    • Read E-mail(E-MailRecord)

    "Inbound Direction"

    Outbound

    • Send E-mail(E-MailRecord)

    "Outbound Direction"

    See Also:

    "E-Mail Adapter" for additional E-Mail adapter details

Inbound Direction

Follow the procedures in this section. An asterisk (*) indicates a required field.

  1. Provide responses to the following questions:

    Question Description

    Content type

    Select either regular (default value), XML attachment, Binary attachment, or Text attachment.

    Maximum number of e-mails to read for each poll

    Enter the maximum number of messages to retrieve in each polling session (default value is 30). You must enter a value greater than 0.

    Folder name for unsuccessfully processed e-mails

    Enter the folder name in which to place files that have not been processed successfully.

    Ensure that the folder name is valid and exists on the IMAP server.

  2. Click Apply.

  3. Go to "Review the Adapter Interaction Details" to review details about your selection.

Outbound Direction

Follow the procedures in this section. An asterisk (*) indicates a required field.

  1. Select regular (default value), xml attachment, binary attachment, or text attachment as the content of the file from the Content type list.

  2. Click Apply.

  3. Go to "Review the Adapter Interaction Details" to review details about your selection.

Adding a File/FTP Adapter Interaction

  1. Select the inbound or outbound adapter interaction to add and see the referenced section for instructions. The questions that appear are based on the adapter exchange protocol you select.

    Direction See Section...

    Inbound

    "Inbound Direction"

    • Read File(FileRecord)

    Outbound

    "Outbound Direction"

    • Write File(FileRecord)

    See Also:

    "File/FTP Adapter" for additional File/FTP adapter details

Inbound Direction

Follow the procedures in this section. An asterisk (*) indicates a required field.

  1. Provide responses to the following questions.

    Field Description

    Directory (relative path) for incoming files

    Enter the directory in which incoming files are located. This relative path must be a directory path that begins under $ORACLE_HOME/ip.

    This path is relative to the base directory delivery channel property you define in "Creating a File/FTP Adapter Delivery Channel".

    For example, if the base directory delivery channel you defined is /Oracle/Ora_904/ip/human_resources, and directory inbound is under human_resources, enter inbound in this field.

    Maximum number of files to read for each poll

    Enter the maximum number of messages to process during polling (default value is 30).

    File extension for the incoming files - for example, txt *

    Enter the file extension.

  2. Click Apply.

  3. Go to "Review the Adapter Interaction Details" to review details about your selection.

Outbound Direction

Follow the procedures in this section. An asterisk (*) indicates a required field.

  1. Provide responses to the following questions.

    Question Description

    Directory (relative path) for outgoing files

    Enter the directory in which outgoing files are located.

    Staging directory (relative path) for outgoing files?

    Enter the directory to use. This directory is important for when you have large files. This is to prevent an application from picking up a file before it completes being written into a directory.

    File naming convention for outgoing files (without extension) - for example, po_%TIME% *

    Enter the naming convention for outgoing files. Only %TIME% is allowed for variables in file names.

    File extension for the outgoing files - for example, txt *

    Enter the file extension.

  2. Click Apply.

  3. Go to "Review the Adapter Interaction Details" to review details about your selection.

Adding an HTTP Adapter Interaction

  1. Select the inbound or outbound adapter interaction to add and see the referenced section for instructions. The questions that appear are based on the adapter exchange protocol you select.

    Adapter Exchange Protocol See Section...

    Inbound

    • Receive Payload(PayloadRecord)

    "Inbound Direction"

    Outbound

    • Send Payload(PayloadRecord, PayloadRecord)

    "Outbound Direction"

    See Also:

    "HTTP Adapter" for additional HTTP adapter details

Inbound Direction

Follow the procedures in this section. An asterisk (*) indicates a required field.

  1. Select application/xml (default value), application/octet, or text/plain as the content of the file from the Content type list.

  2. Click Apply.

  3. Go to "Review the Adapter Interaction Details" to review details about your selection.

Outbound Direction

Follow the procedures in this section. An asterisk (*) indicates a required field.

  1. Provide responses to the following questions:

    Field Description

    Content type *

    Select either application/xml (default value), application/octet, or text/plain as the content of the file.

    Response Content Type

    Select either application/xml (default value), application/octet, or text/plain as the content of the responding file.

    URL suffix (relative to root URL)

    Enter the URL servlet suffix to append to the base URL. For example, if the base URL is http://foo:1888/integration and the servlet suffix is transportServlet, the URL for sending messages is as follows:

    http://foo:1888/integration/transportServlet

    If a servlet suffix is not provided, only the base URL is used for sending messages.

    HTTP connection timeout in milliseconds

    Enter the timeout interval in milliseconds for HTTP connections (default value is 60000).

    Method

    Select either POST (default value) or GET.

    Additional HTTP headers (separated by "@@")

    Enter additional HTTP headers. For example: Content-Type:application/xml @@ Content-Language: mi, en

  2. Click Apply.

  3. Go to "Review the Adapter Interaction Details" to review details about your selection.

Adding a JMS (Java Message Service) Adapter Interaction

  1. Select the inbound or outbound adapter interaction to add and see the referenced section for instructions. The questions that appear are based on the adapter exchange protocol you select. The adapter exchange protocols display as follows:

    Adapter Exchange Protocol See Section

    Inbound

    "Inbound Direction"

    • StreamMessage Payload

    • Message Payload

    • MapMessage Payload

    • BytesMessage Payload

    • TextMessage Payload

    Outbound

    "Outbound Direction"

    • StreamMessage Payload

    • Message Payload

    • MapMessage Payload

    • BytesMessage Payload

    • TextMessage Payload

    See Also:

Inbound Direction

Follow the procedures in this section. An asterisk (*) indicates a required field.

  1. Provide responses to the following questions.

    Field Description

    Name of the JMS queue or topic (value of $[DestinationName]) *

    Enter a value. The value of this field is most often the actual name of the underlying queue (or topic). Specifically, it simply replaces the $[DestinationName] placeholder used in the JMS delivery channel definition specified in the delivery channel parameters in "Creating a JMS Adapter Delivery Channel".

    Optional JMS message selector expression

    Enter a value between 1 and 255 characters in length. The message selector expression applies when receiving messages.

    Optional durable subscriber name

    Enter a value between 1 and 255 characters in length.

    Use JMS message listener?

    Select Yes or No (the default) to specify if the JMS consumer is to use a JMS message listener for receiving messages.

  2. Click Apply.

  3. Go to "Review the Adapter Interaction Details" to review details about your selection.

Outbound Direction

Follow the procedures in this section. An asterisk (*) indicates a required field.

  1. Provide responses to the following questions.

    Question Description

    Name of the JMS queue or logic (value of $[DestinationName]) *

    Enter a value (for example, SEND.QUEUE).

    Message delivery mode

    Select either NON_PERSISTENT or PERSISTENT.

    Message priority (0-9)

    Select a value between 0 and 9 (the default is 4).

    Time-To-Live (milliseconds; 0 = no limit)

    Enter a value in milliseconds. There is no limit.

  2. Click Apply.

  3. Go to "Review the Adapter Interaction Details" to review details about your selection.

Adding an Oracle Database Adapter Interaction

  1. Select the inbound or outbound adapter interaction to add and see the referenced section for instructions. The questions that appear are based on the adapter exchange protocol you select.

    Adapter Exchange Protocol See Section...

    Inbound

    • Read Record from Interface Table

    "Read Record from Interface Table"

    Outbound

    • Stored Procedure Invocation

    "Review the Adapter Interaction Details". You are not prompted to answer any questions.

    • Write Record to Table

    "Write Record to Table"

    See Also:

    "Oracle Database Adapter Exchange Protocols" for additional details about these adapter exchange protocols

Read Record from Interface Table

Follow the procedures in this section. An asterisk (*) indicates a required field.

  1. Provide a response to the following question:

    Field Description

    Enter a SQL statement for retrieving rows from the interface table - for example, select * from emp

    Enter a query by following these rules.

    The query must follow these rules:

    • You first write and test the query using a separate query tool such as SQL*Plus.

    • Only include columns from this table; joins to other tables are not permitted.

    • If the table is defined in a separate schema from the connection, then the schema must be qualified in the query.

    • Do not end with a punctuation character such as a semicolon (which may be required by query tools such as SQL*Plus).

    • If the interface table uses the update option to record that a row has been processed, the query must include a WHERE clause excluding processed rows, for example:

      SELECT name, salary FROM emp WHERE status <> 'Processed'
      
      
    • If the order of processing the record instances is important, then the query must include an order by clause to enforce the order:

      SELECT name, salary FROM emp ORDER BY name
      
      
  2. Click Apply.

    Any additional questions that appear are based on the SQL statement you entered in Step 1.

  3. If the table does not have a primary key or the table is a view (detected by the adapter after the SQL SELECT statement is entered for the first question), perform Steps 3a through 3b. Otherwise, go to Step 5.

    1. Provide responses to the following questions:

      Field Description

      Select the columns from the interface table that uniquely identify a row

      Select one or more columns from a table to define a unique key. All columns for the table appear.

      Specify a method for marking the row as having been read

      Select whether to update or delete the row. If update is selected, the query specified in Step 1 must exclude processed rows.

    2. Click Apply.

  4. If you selected to update a row in Step 3a, perform Steps 4a through 4b. Otherwise, go to Step 5.

    1. Provide responses to the following questions:

      Field Description

      Select a column for update

      Select a table column to update. Your selection is updated at runtime.

      Enter a value for success

      Select the value with which to update the column if the record is successfully created as a native event.

      Enter a value for failure

      Select the value with which to update the column if the record is not created as a native event.

    2. Click Apply.

  5. Go to "Review the Adapter Interaction Details" to review details about your selection.

Write Record to Table

Follow the procedures in this section. An asterisk (*) indicates a required field.

  1. Provide a response to the following question:

    Field Description

    Select an action

    This action (either Insert or Update) writes the record to the table. The record can be inserted as a new row or an existing row can be updated.

  2. If you selected to update a record in Step 1, select one or more columns from the table that uniquely identify a row. All columns for the table appear.

    Field Description

    Select the columns from the table that uniquely identify a row

    Select one or more columns that define a unique key. All table columns appear for selection.

  3. Click Apply.

  4. Go to "Review the Adapter Interaction Details" to review details about your selection.

Adding a Web Service Adapter Interaction

One outbound adapter interaction is supported. Inbound adapter interactions are not supported.

  1. Select the Invoke Web Service Operation(RequestRecord, ResponseRecord) outbound adapter interaction.

    The Add Interaction : Questions page appears and prompts you to answer specific questions about selecting a Web Services Description Language (WSDL) file that describes the web service.

  2. Provide responses to the following questions for this adapter interaction. An asterisk (*) indicates a required field.

    Question Description

    WSDL definition file name or WSDL definition URL

    Specify a WSDL definition in either of the following ways:

    • Click Browse to access a local XML file with a WSDL definition of the Web service to invoke.

    • Enter a Web location (beginning with http:// or https://) in the next field.

    Note: If you enter a WSDL URL or a WSDL file that contains imported WSDL URLs, the following two questions may be required.

    Proxy server hostname (if specifying WSDL definition URL)

    Enter the name of the proxy server host.

    Proxy server port (if specifying WSDL definition URL)

    Enter the proxy server port number.

  3. Click Apply.

    A second Add Interaction : Questions page appears and prompts you to select exactly one Web service operation from the many possible operations contained in the WSDL file. This page allows filtering on many attributes, such as operation name, message name, referenced URIs, and so on. Each question provides a list with many selections. Answer only enough questions to identify the operation. If the header in each list is Unspecified (the default), the behavior is as if all the remaining items are selected. You typically select the desired operation and treat the other filter values as additional information (for example, note which ports provide the desired operation, or which XML Schema datatypes are required). However, a Web service can sometimes provide the same operation with a choice of bindings (for example, RPC versus document style). You may also want to first eliminate undesired ports (corresponding to undesired parties) or undesired message part datatypes.

    Question Description

    Port Type

    Select a port type for this interaction.

    Operation

    Select the operation to perform.

    Binding

    Select the binding.

    Service

    Select the service.

    Port

    Select the port.

    Message

    Select a message.

    Message part

    Select a message part.

    URI

    Select a URI.

  4. Select attributes that identify or filter down to a unique Web service operation and binding.

  5. Click Apply.

  6. Go to "Review the Adapter Interaction Details" to review details about your selection.

    See Also:

Review the Adapter Interaction Details

The Add Interaction : Review page displays details on your responses. The following example is the review page for a JMS adapter interaction.

Text description of jms1.gif follows.

Text description of the illustration jms1.gif

  1. Review the details. The Create Native Event Type box is automatically selected. If selected, this starts a wizard that enables you to select a translation method, and create a native event, an application event, and body elements for both event types. If you deselect this box, you can separately create this modeling metadata at a later time.

  2. Click Apply.

    This adds the adapter interaction and creates a corresponding Oracle record type. The Oracle record represents the input or output to an adapter interaction. It represents the conceptual boundary between Oracle Application Server ProcessConnect and the application being accessed by the adapter.

    The Specify Native Format page appears.

    The record type elements for which to create native event body elements appear in the Record Type Element column. For this example, three record types for the JMS adapter appear.

    Text description of jms3.gif follows.

    Text description of the illustration jms3.gif

  3. Select a native format for each record element from the Native Format list. Up to three native formats can be available. For some records, only one choice may be available. The selections available depend on the specific adapter record elements for which you are selecting a native format.

    See Chapter 8, "Oracle Application Server ProcessConnect Technology Adapters" for details on which native formats are applicable to each record element. With the JMS Adapter, for example, the record elements JmsHeaders and JmsProperties can only have the native format XSD, whereas the payload record element can be any of the following native formats:

    • XSD

      If your native message format uses XML

    • Token Substituted Text

      For specifying the subject and body of alert e-mail messages

    • D3L

      If your native message format is not XML, but is instead a format of structured records of bytes, characters, or both

    Be careful changing the native format of all record elements supported by a given adapter; this causes an undefined action to occur during runtime.

    The screen refreshes to display your selection in the Extractor list. For example, if you select XSD in the Native Format list, XSD automatically appears in the Extractor list. Based on your native format selection, the extractor determines which type of translator to use.

  4. Click Apply.

    The page that appears next is based on whether the Create Native Event Type box was selected on the Add Interaction : Review page.

    If the Create Native Event Type Box Was... Then... Go To...

    Selected

    The Create Native Event Type page appears.

    "Creating Native and Application Event Types and Body Elements"

    Not selected

    The Interaction Details page appears.

    "Viewing an Adapter Interaction"

    Note: You can also create native and application event types and body elements for this interaction at a later time.

    See Also:

    The following sections for specific details about these native formats:

Creating Native and Application Event Types and Body Elements

  1. Enter a unique and recognizable native event type name in the Name field.

    The interaction and Oracle record type also display on this page.

  2. Click Next.

    The Create Event Body Element : record_type page appears, where record_type is the record type in the native format. This page displays details such as the following:

    • Event body element name

    • Native event type name entered in Step 1

    • Native format selected in Step 1

    • Translator type based on the native format selected in Step 1

    This page appears for each Oracle record element.

  3. If a data payload record element from which to create a body element appears, perform Steps 3a through 3c to specify the datatypes file. Otherwise, go to Step 4. Some record elements (such as some header record elements) automatically define their datatypes and do not prompt you for details.


    Note:

    This wizard prompts you for details to create event body elements for each Oracle record type element. At some point in this process, you are may be prompted to specify the details described in Step 3 if one of your record type elements contains payload datatypes. An exception to this is the Advanced Queuing adapter's Object Queue adapter exchange protocol, which automatically defines payload details and does not prompt you to specify any information.


    1. Go to the Native Datatype section. This section displays two selections (Create New and Use Existing). Use Existing may be disabled if there are no existing datatypes detected by Oracle Application Server ProcessConnect. In this case, you must specify a new datatype format file by performing the steps in Step b. Use Existing enables you to reuse datatypes when creating a native event. Use Existing is a selectable option in the following situations:

      • When you are adding an interaction that uses the same adapter exchange protocol and same native format as a previously added interaction

      • When the native datatypes are implicitly defined by the adapter

    2. If you select Create New, perform the following tasks to specify a new format datatype file:

      • Enter the native datatype name in the Name field.

      • Click Browse next to the Content field.

      • Select a native format file from the Select File page.

        Your selection appears in the Content field.

    3. If you select Use Existing, perform the following tasks to specify an existing datatype file.

      • Select an existing native format file from the Name list.

      • Click Next.

  4. Go to the Translator Properties section at the bottom of the page.

    The fields that display in this section are based on the native format and translator selected in Step 1.

  5. See the following section based on the native format and translator you selected:

    Native Format and Translator See Section

    XSD

    "Providing XSD Details"

    Token Substituted Text

    "Providing Token Substituted Text Details"

    D3L

    "Providing D3L Details"

Providing XSD Details

Provide responses to the following questions.

  1. Enter the following details to create an event body element. For example, the following questions can display if you selected the XSD translator in Step 1. You may also not be prompted for any questions. An asterisk (*) indicates a required field.

    Field Description

    Preserve Namespaces for Native Instances *

    • Select Yes when a party expects an XML document with namespaces.

      Note: Yes is the default selection. If you specify Yes and your XML document does not have namespaces, no error occurs. This is because there were no namespaces to preserve. This action is essentially the same as specifying No.

    • Select No if your XSD does not have namespaces.

    • Select No when a party expects an XML document without namespaces even if the XSD includes namespaces in it. If you select No and your XSD has namespaces, native event validation must not be enabled.

      Note: If you want to enable native event validation, use a separate DTD or use an XSD without namespaces.

    DocType for Native Instances *

    Select one of the following:

    • SYSTEM

      Causes Oracle Application Server ProcessConnect to look for a private DTD at a system location that you specify in Step 4.

    • PUBLIC

      Causes Oracle Application Server ProcessConnect to look for a private DTD in a public location that you specify in Step 4.

    • XMLSchema

      Uses an XSD that you specify in Step 4.


    Note:

    Additional questions can appear based on your selections.


  2. Click Next.

    The Create Event Body Element : record_type page refreshes to display additional questions based on your selection in the DocType for Native Instances list in Step 1.

  3. Go to the Translator Properties section of the page.

  4. Provide answers to the following questions.

    If You Selected... Then...

    SYSTEM

    1. Enter a private DTD in a system location in the DTD System Location field.

      For example, entering subjects.dtd results in <!DOCTYPE document SYSTEM "subjects.dtd">.

    PUBLIC

    1. Enter a private DTD in a public location in the DTD Public Location field. For example, -//W3C//DTD HTML 4.0 Transitional//EN

    2. Enter a URI in the DTD Public URI field. For example, http://www.w3.org/TR/REC-html40/loose.dtd

      This results in <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN" "http://www.w3.org/TR/REC-html40/loose.dtd">

    XMLSchema

    1. Enter the XSD in the XML Schema Location field.

  5. Click Next.

  6. Repeat these steps for any remaining record types for which you are prompted.

  7. Go to the "Review the Create Native Event Type Details".

Providing Token Substituted Text Details

Provide responses to the following questions.

  1. Enter the following details to create an event body element. The following questions display if you selected the Token Substituted Text translator in Step 1. An asterisk (*) indicates a required field.

  2. Enter a namespace in the Namespace for Application Type to be Created field. This can be a new or existing namespace.

  3. Click Next.

  4. Go to the "Review the Create Native Event Type Details".

Providing D3L Details

Provide responses to the following questions.

  1. Enter the following details to create an event body element. The following questions display if you selected the D3L translator in Step 1. An asterisk (*) indicates a required field.

  2. Enter a namespace in the Namespace for Application Datatype to be created field. This can be a new or existing namespace.

  3. Click Browse to select additional D3L definition files for the Additional D3L Definitions field. Use this field to provide the name of a definitions D3L file, which contains importable definitions that can be referenced (and thus not defined in) the main message D3L file.

  4. Click Next.

  5. Go to the "Review the Create Native Event Type Details".

    See Also:

    "Additional D3L Sample Files and DTD" for details about both types of D3L files

Review the Create Native Event Type Details

  1. Review your selections or click Back on the wizard to make changes. Do not click Back on your browser.

  2. Click Finish to specify a translator and create the native event, application event, and native and application event body elements.

    When complete, the Native Event Types page appears.

Deleting an Adapter Interaction

If an adapter interaction is part of an integration designed up through the business process, then attempting to delete the adapter interaction before deleting other modeling metadata results in error messages appearing. Ensure that you delete the modeling metadata in the following order:

  1. Delete the event transformation maps.

  2. Delete the business event.

  3. Delete the translation and transformation binding roles. If you created your modeling metadata with the modeling wizards, these roles are named after the role naming convention you specified when prompted. For example, if you entered notification as the role naming convention, the translation role is named notification-TL and the transformation role is named notification-TX.

  4. Delete the native event.

  5. Delete the native role.

  6. Delete the interaction.

Follow these instructions to delete an adapter interaction:

To delete an adapter interaction:

  1. Ensure that you followed the instructions in "Accessing Adapter Interaction Management Tasks" to access the page for deleting an adapter interaction.

  2. Click Yes when prompted to delete an adapter interaction.

    The adapter interaction is deleted and the Interactions page appears.

Viewing an Adapter Interaction

Follow these instructions to view an adapter interaction:

To view an adapter interaction:

  1. Ensure that you followed the instructions in "Accessing Adapter Interaction Management Tasks" to access the page for viewing an adapter interaction.

    The Interaction Details page for the selected adapter interaction appears.

    Text description of add_interaction_view.gif follows.

    Text description of the illustration add_interaction_view.gif

  2. View specific details, including the direction and adapter exchange protocol selected. The Group Name that appears is the interaction group that displayed in the expanded list when you originally added the adapter interaction in Step 5.

    This page, as with the Interactions page shown in Figure 11-1, enables you to delete the selected adapter interaction.

  3. Click the record type name next to Record Type to display the Record Type Details page. From this page, you can:

Managing Native Event Types

The Oracle Application Server ProcessConnect user interface tool enables you to perform the native event type management tasks shown in Figure 11-3 and Figure 11-4. These tasks are described in detail in this section. A native event is created from an adapter interaction. A native event is the Oracle Application Server ProcessConnect internal implementation of the business data contained in an Oracle record. The body elements of the native event contain the various sections of the wire message, such as payloads, headers, or attachments. The representation of the wire message content is unchanged.

Figure 11-3 Native Event Type Management Tasks (Part 1 of 2)

Text description of data_event_types5.gif follows

Text description of the illustration data_event_types5.gif

Selecting a native event type in the Name column of the Native Event Types section causes a details page such as that shown in Figure 11-4 to appear.

Figure 11-4 Native Event Type Management Tasks (Part 2 of 2)

Text description of data_event_types4.gif follows

Text description of the illustration data_event_types4.gif

Table 11-3 identifies the native event type management tasks shown in Figure 11-3 and Figure 11-4 and provides references to procedures for performing these tasks.

Table 11-3  Native Event Type Management Tasks
Page Elements Management Task First See Section... Then See Section...

Create button in Native Event Types page of Figure 11-3

Create a native event type

"Accessing Native Event Type Management Tasks"

"Creating a Native Event Type"

Delete column in Native Event Types page of Figure 11-3

Delete a native event type

 

"Deleting a Native Event Type"

Name column in Native Event Types page of Figure 11-3

View a native event type

 

"Viewing a Native Event Type"

Record Type Elements column in Native Event Type Details page of Figure 11-4

View a record type element

"Accessing Native Event Type Management Tasks"

"Viewing a Record Type Element"

Event Body Elements column in Native Event Type Details page of Figure 11-4

View an event body element

 

"Viewing an Event Body Element"

Event Body Elements column in Native Event Type Details page of Figure 11-4

Add event body element validation

 

"Adding Native Event Body Element Validation"

See Also:

"Native Events" for additional conceptual details

Accessing Native Event Type Management Tasks

Follow these instructions to access the native event type management tasks shown in Figure 11-3 and Figure 11-4:

To access native event type management tasks:

  1. Select the Modeling tab.

  2. Select the Event Types tab.

  3. Select Native Event Types.

    The Native Event Types page appears. (See Figure 11-3.)

  4. Select a task to perform and see the referenced section for instructions:

    To... Then... See Section...

    Create a native event type

    Click Create.

    "Creating a Native Event Type"

    Delete a native event type

    Select a specific native event type in the Delete column.

    "Deleting a Native Event Type"

    View a native event type

    Select a specific native event type in the Name column.

    "Viewing a Native Event Type"

    View a record type element

    Select a specific native event type in the Name column.

    "Viewing a Record Type Element"

    View an event body element

    Select a specific native event type in the Name column.

    "Viewing an Event Body Element"

    Add event body element validation

    Select a specific native event type in the Name column for which to validate an event body element.

    "Adding Native Event Body Element Validation"

Creating a Native Event Type

Follow these instructions to create a native event type to which to assign an existing adapter interaction and translator. During native event type creation, you also create an application event, and create native and application event body elements for the various sections of the wire message, such as header details, attachments, and service content (payload data).


Note:

Follow these instructions if you want to use an existing adapter interaction and record type with this native event. If the adapter interaction to use with this native event does not exist, you must first add the adapter interaction. See "Adding an Adapter Interaction" for instructions.


To create a native event type:

  1. Ensure that you followed the instructions in "Accessing Native Event Type Management Tasks" to access the page for creating a native event type.

    The Create Native Event Type page appears. This is the first page of a wizard that enables you to create a native event type, specify a translator, create an application event type, and create native and application event body elements for the various sections of the wire message (such as the payload, header, and attachment).

  2. Enter the following details to create a native event type. An asterisk (*) indicates a required field.

    Field Description

    Name *

    Enter a unique and recognizable name for the native event type.

    Interaction *

    Select an adapter interaction to associate with this native event (for example, an interaction named PurchaseOrderConfirmation or an interaction that retrieves a text file from an HTTP server). You added this interaction and specified a translator in "Adding an Adapter Interaction".

    Record Type *

    The page refreshes to display the record type associated with the selected adapter interaction (for example, record type PurchaseOrderConfirmation if that was your selection from the Interaction list). The record type name is part of the interaction name (it displays in the brackets). For example, for the Advanced Queuing adapter, the following can display:

    Interaction Dequeue from AQ_EXPENSE(AQ_ECXMSG_Record) - Inbound

    Record Type AQ_ECXMSG_Record

  3. Click Next.

    The Create Event Body Element : record_type page appears, where record_type is the record type in the native format.

  4. See Step 2 of "Creating Native and Application Event Types and Body Elements" to create a native event, an application event, and body elements for the various sections of the native format (wire) message, such as header details, attachments, and payload data (service content).

Deleting a Native Event Type

If a native event type is part of an integration designed up through the business process, then attempting to delete the native event type before deleting other modeling metadata results in error messages appearing. Ensure that you delete the modeling metadata in the following order:

  1. Delete the event transformation maps.

  2. Delete the business event.

  3. Delete the translation and transformation binding roles.

  4. Delete the native event.

  5. Delete the native role.

Follow these instructions to delete a native event type:


Caution:

All event body elements of the selected native event type are also deleted.


To delete a native event type:

  1. Follow the instructions in "Accessing Native Event Type Management Tasks" to access the page for deleting a native event type.

  2. Click Yes when prompted to delete a native event type.

    The native event type is deleted and the Native Event Types page appears.

Viewing a Native Event Type

Follow these instructions to view details about a specific native event type:

To view a native event type:

  1. Ensure that you followed the instructions in "Accessing Native Event Type Management Tasks" to access the page for viewing a native event type.

    The Native Event Type Details page for the selected native event type appears.

    Text description of data_event_types12.gif follows

    Text description of the illustration data_event_types12.gif

  2. View specific details, including the event body elements and their corresponding Oracle record types. Note that no native datatypes appear in these event body elements. This is because Oracle Application Server ProcessConnect does not understand native datatypes.

  3. If you click the name next to Record Type in the Details section, you access a page that lists the record type elements and native event types for this record type.

    This page, as with the Native Event Types page shown in Figure 11-3, enables you to delete the selected native event type.

  4. Click Return to List to return to the Native Event Types page.

Viewing a Record Type Element

Native events are created from record types. Follow these instructions to view details about a specific record type element:

To view a record type element:

  1. Ensure that you followed the instructions in "Accessing Native Event Type Management Tasks" to access the page for viewing a record type element.

    The Native Event Type Details page appears. (See Figure 11-4.)

  2. Go to the Event Body Elements section.

  3. Click a specific record type element in the Record Type Element column.

    The Record Type Element Details page for the selected record type element appears.

    Text description of data_event_types8.gif follows

    Text description of the illustration data_event_types8.gif

  4. View specific details, such as the name, native format of the record type, and the extractor associated with this record type.

  5. Click Return to List to return to the Native Event Type Details page.

    See Also:

    "Create and View the Native and Application Events and Body Elements" for additional details about record types

Viewing an Event Body Element

Follow these instructions to view details about a specific event body element:

To view an event body element:

  1. Ensure that you followed the instructions in "Accessing Native Event Type Management Tasks" to access the page for viewing an event body element.

    The Native Event Type Details page appears. (See Figure 11-4.)

  2. Go to the Event Body Elements section.

  3. Click a specific event body element in the Name column.

    The Event Body Element Details page for the selected event body element appears.

    Text description of data_event_types13.gif follows

    Text description of the illustration data_event_types13.gif

  4. View specific details.

  5. Click Return to List to return to the Native Event Type Details page.

Adding Native Event Body Element Validation

Follow these instructions to add validation to a native event body element. This ensures that the native event body element is validated when it is invoked at runtime when a wire message is received. If validation fails, the native event is not translated into an application event, and an error message displays onscreen.

To add native event body element validation:

  1. Ensure that you followed the instructions in "Accessing Native Event Type Management Tasks" to access the page for adding native event body element validation.

    The Native Event Type Details page appears. (See Figure 11-4.)

  2. Go to the Event Body Elements section.

  3. Click a specific native event body element in the Name column.

    The Event Body Element Details page for the selected event body element appears.

  4. Go to the Validations section.

    Click Update.

    The Specify Validation for Native Event Body Element page appears.

  5. Select the validation to assign to the event body element from the Available Validations list (for example, XSD).

  6. Use the > arrow to add the validation to the Selected Validations list.

  7. Click Apply.

    The Event Body Element Details page for the selected event body element now displays the added validation and revision number.

    See Also:

    "Native Event Validation" for additional conceptual details

Managing Native Event Correlations

The Oracle Application Server ProcessConnect user interface tool enables you to perform the native event correlation management tasks shown in Figure 11-5. These tasks are described in detail in this section.

Figure 11-5 Native Event Correlation Management Tasks

Text description of data_event_types14.gif follows

Text description of the illustration data_event_types14.gif

Native event correlation is an expression that defines when two native event instances are related; for example, a correlating (initiating) native event purchase order request (NE_PO in Figure 11-6) and a correlated (target) native event purchase order acknowledgment (NE_POA in Figure 11-6). Native event correlation ensures that the correct native event instances are matched and provided to the corresponding native role instances.

Figure 11-6 Native Event Correlation

Text description of ipusr061.gif follows

Text description of the illustration ipusr061.gif

Table 11-4 identifies the native event correlation management tasks shown in Figure 11-5 and provides references to procedures for performing these tasks.

Table 11-4  Native Event Correlation Management Tasks
Page Elements Management Task First See Section... Then See Section...

Create button in Correlations section of Native Event Types page in Figure 11-5

Create a native event correlation

"Accessing Native Event Correlation Management Tasks"

"Creating a Native Event Correlation"

Delete column in Correlations section of Native Event Types page in Figure 11-5

Delete a native event correlation

 

"Deleting a Native Event Correlation"

Update column in Correlations section of Native Event Types page in Figure 11-5

Update a native event correlation

 

"Updating a Native Event Correlation"

Details column in Correlations section of Native Event Types page in Figure 11-5

View a native event correlation

 

"Viewing a Native Event Correlation"

See Also:

"Native Event Correlation" for additional conceptual details

Accessing Native Event Correlation Management Tasks

Follow these instructions to access the native event correlation management tasks shown in Figure 11-5:

To access native event correlation management tasks:

  1. Select the Modeling tab.

  2. Select the Event Types tab.

  3. Select Native Event Types.

    The Native Event Types page appears. (See the upper page of Figure 11-5.)

  4. Go to the Correlations section.

  5. Select a task to perform and see the referenced section for instructions:

    To... Then... See Section...

    Create a native event correlation

    Click Create.

    "Creating a Native Event Correlation"

    Delete a native event correlation

    Select a specific native event correlation in the Delete column.

    "Deleting a Native Event Correlation"

    Update a native event correlation

    Select a specific native event correlation in the Update column.

    "Updating a Native Event Correlation"

    View a native event correlation

    Select a specific native event correlation in the Details column.

    "Viewing a Native Event Correlation"

Creating a Native Event Correlation

Follow these instructions to create a native event correlation:

To create a native event correlation:

  1. Ensure that you followed the instructions in "Accessing Native Event Correlation Management Tasks" to access the page for creating a native event correlation.

    The Create Correlation: Native Event Types page appears.

  2. Enter the following details to create a native event correlation. An asterisk (*) indicates a required field.

    Field Description

    Correlating Native Event Type *

    Select a correlating (initiating) native event by clicking the flashlight (for example, RequestPurchaseOrder).

    Correlated Native Event Type *

    Select a correlated (target) native event by clicking the flashlight (for example, PurchaseOrderConfirmation).

    Directional

    Select Unspecified, False, or True. If True is selected, then correlation is applied only to the correlating (initiating) native event type (for example, RequestPurchaseOrder). You then need to select a correlating native event type for RequestPurchaseOrder, which now becomes the correlated (target) event type.

  3. Click Next.

    The Create Correlation: Correlation Condition appears.

  4. Select Condition expression not specified.

  5. Click Update to create a new native event correlation.

    The Create Condition Expression page appears.

    Text description of create_condition_express_ne.gif follows.

    Text description of the illustration create_condition_express_ne.gif

  6. Click Expand All for both columns to display all elements or select an individual section such as Service Content (the data payload) to display only those elements.

  7. Select the left correlating operand (the initiating native event) from the Correlating Native Event Type section (for example, ReceiptAcknowledgment).

  8. Select the right correlated operand (the target native event) from the Correlated Native Event Type section (for example, RequestPurchaseOrder).

  9. Select the = (equal) operator from the Operator list.

  10. Click Apply.

    The created native event correlation condition displays in the Create Correlation : Correlation Condition page.

  11. Click Apply.

    The Correlation Details page describes details about the new native event correlation.

    Text description of create_cd.gif follows.

    Text description of the illustration create_cd.gif

  12. Click Return to List to return to the Native Event Types page.

Deleting a Native Event Correlation

Follow these instructions to delete a native event correlation:

To delete a native event correlation:

  1. Follow the instructions in "Accessing Native Event Correlation Management Tasks" to access the page for deleting a native event correlation.

  2. Click Yes when prompted to delete a native event correlation.

    The native event correlation is deleted and the Native Event Types page appears.

Updating a Native Event Correlation

Follow these instructions to update a native event correlation:

To update a native event correlation:

  1. Follow the instructions in "Accessing Native Event Correlation Management Tasks" to access the page for updating a native event correlation.

    The Update Correlation: Native Event Types page appears.

  2. Select the condition expression to update.

  3. Click Update.

    The Update Correlation: Correlation Condition page appears.

  4. Update your selection from the Directional list. (See Step 2 for a list of fields you can update.)

  5. Click Next.

    The Update Correlation: Correlation Condition page appears.

  6. Click Update to update the condition expression.

    The Update Condition Expression page appears.

  7. Make appropriate changes.

  8. Click Apply.

    The native event correlation is updated and the Update Correlation: Correlation Condition page appears.

Viewing a Native Event Correlation

Follow these instructions to view details about a specific native event correlation:

To view a native event correlation:

  1. Ensure that you followed the instructions in "Accessing Native Event Correlation Management Tasks" to access the page for viewing a native event correlation.

    The Native Event Correlation Details page for the selected native event correlation appears.

    Text description of data_event_types18.gif follows

    Text description of the illustration data_event_types18.gif

  2. View specific details, including the condition that must be satisfied to correlate the two native events.

    This page, as with the Native Event Types page shown in Figure 11-5, enables you to delete or update the selected native event correlation.

  3. Click Return to List to return to the Native Event Types page.

Managing Event Maps

The Oracle Application Server ProcessConnect user interface tool enables you to perform the event map management tasks shown in Figure 11-7. These tasks are described in detail in this section.

Figure 11-7 Event Map Management Tasks

Text description of data_event_types19.gif follows

Text description of the illustration data_event_types19.gif

The purpose of an event map is to select a native event type from a record at runtime when there are multiple possible native event types for the record. If there is one native event type for the record, then no event map condition expression is required. If there are multiple native events for a record, then an event map must be defined for each native event. It must be ensured that the event maps for a given record are mutually exclusive so that the correct native event type is chosen. If you do not want a native event to be used or the event type is only used for outbound interactions, then you can define an event map to always evaluate to false (for example, checking for a value that can never exist in the message).

Figure 11-8 provides an example of a single Oracle record with two native event types.

Figure 11-8 Event Mapping

Text description of ipusr062.gif follows

Text description of the illustration ipusr062.gif

Table 11-5 identifies the event map management tasks shown in Figure 11-7 and provides references to procedures for performing these tasks.

Table 11-5  Event Map Management Tasks
Native Event Type Details Page Elements Management Task First See Section... Then See Section...

Create button in Event Map section in upper page of Figure 11-7

Create an event map

"Accessing Event Map Management Tasks"

"Creating an Event Map"

Delete button in Event Map section in lower page of Figure 11-7

Delete an event map

 

"Deleting an Event Map"

Update button in Event Map section in lower page of Figure 11-7

Update an event map

 

"Updating an Event Map"

Event Map section in lower page of Figure 11-7

View an event map

 

"Viewing an Event Map"

See Also:

"Event Maps" for additional conceptual details

Accessing Event Map Management Tasks

Follow these instructions to access the event map management tasks shown in Figure 11-7:

To access event map management tasks:

  1. Select the Modeling tab.

  2. Select the Event Types tab.

  3. Select Native Event Types.

    The Native Event Types page appears. (See Figure 11-5.)

  4. Select a specific native event type in the Name column.

    The Native Event Type Details page appears. (See the upper page of Figure 11-7.)

  5. Go to the Event Map section.

  6. Select a task to perform and see the referenced section for instructions:

    To... Then... See Section...

    Create an event map

    Click Create. This button only displays if there are no event maps.

    "Creating an Event Map"

    Delete an event map

    Click Delete. This button only displays if event maps currently exist.

    "Deleting an Event Map"

    Update an event map

    Click Update. This button only displays if event maps currently exist.

    "Updating an Event Map"

    View an event map

    View the details to the left of the Delete button.

    "Viewing an Event Map"

Creating an Event Map

Follow these instructions to create an event map:

To create an event map:

  1. Ensure that you followed the instructions in "Accessing Event Map Management Tasks" to access the page for creating an event map.

    The Create Event Map page appears.

  2. Select Condition expression not specified.

  3. Click Update to create a new event map.

    The Create Condition Expression page appears.

  4. Select an operator from the Operator list.

  5. Perform the following steps based on the operator you selected.

    If You Selected... Then...

    =

    1. Click Expand All in the Native Event Type section to display all event body elements for this native event type.

    2. Select an element from the Native Event Type section.

    3. Enter a value in the Constant Value field.

    Exists

    1. Click Expand All in the Native Event Type section to display all event body elements for this native event type.

    2. Select an event body element in the Native Event Type section. For XML, this causes a check for any element present in the XSD to occur.

  6. Click Apply.

    The Create Event Map page displays the new event map.

  7. Click Apply.

    The Native Event Type Details page describes details about the native event type, its event body elements, and its new event map.

    Text description of details_net_em.gif follows.

    Text description of the illustration details_net_em.gif

  8. Click Return to List to return to the Native Event Types page.

Deleting an Event Map

Follow these instructions to delete an event map:

To delete an event map:

  1. Follow the instructions in "Accessing Event Map Management Tasks" to access the page for deleting an event map.

  2. Click Yes when prompted to delete an event map.

    The event map is deleted and the Native Event Type Details page appears.

Updating an Event Map

Follow these instructions to update an event map:

To update an event map:

  1. Follow the instructions in "Accessing Event Map Management Tasks" to access the page for updating an event map.

    The Update Event Map page appears.

  2. Select the condition expression to update.

  3. Click Update.

    The Update Condition Expression page appears.

  4. Make appropriate changes.

  5. Click Apply.

    The event map is updated and the Native Event Type Details page appears.

Viewing an Event Map

Follow these instructions to view details about a specific event map:

To view an event map:

  1. Ensure that you followed the instructions in "Accessing Event Map Management Tasks" to access the page for viewing an event map.

    Event map details display to the left of the Update button. For example, the event map shown in the lower page of Figure 11-7 shows a constant value of 2.0 assigned to the Attachment/ID element of the Attachment event body element.

Viewing Application Event Types

The Oracle Application Server ProcessConnect user interface tool enables you to view application event types. Application event types cannot be deleted or updated. Application event types are automatically created in the inbound or outbound direction when you add an adapter interaction or create a native event. For Oracle Application Server ProcessConnect to process the contents of native event body elements, the contents must be re-represented in an interpretable syntactic format. This interpretable format is called the application format. After the native event is represented as the corresponding application event, Oracle Application Server ProcessConnect can make decisions based on it, or transform it. For the outbound direction, application event types are transformed from business event types.

Follow these instructions to view application events:

To view application events:

  1. Select the Modeling tab.

  2. Select the Event Types tab.

  3. Select Application Event Types.

    The Application Event Types page displays the available application events.

    Text description of view_application_events.gif follows.

    Text description of the illustration view_application_events.gif

  4. Click a specific application event type in the Name column.

    The details page for the selected application event type appears.

  5. Go to the Event Body Elements section.

  6. Click Expand All to expand all event body elements or select a specific event body element to expand.

    Text description of data_event_types23.gif follows

    Text description of the illustration data_event_types23.gif

  7. View specific details. The application event datatype details for the event body elements named JmsHeaders and Payload are expanded; for example, scalar or compound for the type and string or double for the datatype).

    Application events contain no native formats. The particular native format of the expense application cannot be identified, and any specific syntactic properties have been removed.

    See Also:

Managing Business Event Types

The Oracle Application Server ProcessConnect user interface tool enables you to perform the business event type management tasks shown in Figure 11-9. These tasks are described in detail in this section. A business event establishes a common event structure and vocabulary across all parties. Business events are completely removed from any party-specific properties, including data structure and vocabulary. All related events from all parties follow the same structure and the same vocabulary once they are translated and transformed into business events. The event body element of the business event contains a complete set of business data. You create an event body element inside a business event that contains the business event datatypes used by all parties in an integration. The business event type can be viewed as a superset of all the corresponding party-specific application datatypes.

Figure 11-9 Business Event Type Management Tasks

Text description of data_event_types24.gif follows

Text description of the illustration data_event_types24.gif

Table 11-6 identifies the business event type management tasks shown in Figure 11-9 and provides references to procedures for performing these tasks.

Table 11-6  Business Event Type Management Tasks
Business Event Types Page Elements Management Task First See Section... Then See Section...

Shortcuts section in Business Event Types page of Figure 11-9

Take shortcuts to add an adapter interaction, import datatypes, and manage transformations

N/A

Create button in Business Event Types page of Figure 11-9

Create a business event type

"Accessing Business Event Type Management Tasks"

"Creating a Business Event Type"

Delete column in Business Event Types page of Figure 11-9

Delete a business event type

 

"Deleting a Business Event Type"

Update column in Business Event Types page of Figure 11-9

Update a business event type

 

"Updating a Business Event Type"

Name column in Business Event Types page of Figure 11-9

(To access the details page in the lower page of Figure 11-9)

View a business event type

 

"Viewing a Business Event Type"

Create button in Business Event Type Details page of Figure 11-9

Create an event body element

 

"Creating an Event Body Element"

Delete column in Business Event Type Details page of Figure 11-9

Delete an event body element

 

"Deleting an Event Body Element"

Update column in Business Event Type Details page of Figure 11-9

Update an event body element

 

"Updating an Event Body Element"

Event Body Elements column in Business Event Type Details page of Figure 11-9

View an event body element

 

"Viewing an Event Body Element"

See Also:

Accessing Business Event Type Management Tasks

Follow these instructions to access the business event type management tasks shown in Figure 11-9:

To access business event type management tasks:

  1. Select the Modeling tab.

  2. Select the Event Types tab.

    The Business Event Types page appears. (See the upper page of Figure 11-9.)

  3. Select a task to perform and see the referenced section for instructions:

    To... Then... See Section...

    Create a business event type

    Click Create.

    "Creating a Business Event Type"

    Delete a business event type

    Select a specific business event type in the Delete column.

    "Deleting a Business Event Type"

    Update a business event type

    Select a specific business event type in the Update column.

    "Updating a Business Event Type"

    View a business event type

    Select a specific business event type in the Name column.

    "Viewing a Business Event Type"

    Create an event body element

    Select a specific business event type in the Name column for which to create an event body element.

    "Creating an Event Body Element"

    Delete an event body element

    Select a specific business event type in the Name column for which to delete an event body element.

    "Deleting an Event Body Element"

    Update an event body element

    Select a specific business event type in the Name column for which to update an event body element.

    "Updating an Event Body Element"

    View an event body element

    Select a specific business event type in the Name column for which to view an event body element.

    "Viewing an Event Body Element"

Creating a Business Event Type

Follow these instructions to create a business event type:

To create a business event type:

  1. Ensure that you followed the instructions in "Accessing Business Event Type Management Tasks" to access the page for creating a business event type.

    The Create Business Event Type page appears.

  2. Enter the following details to create a business event type. An asterisk (*) indicates a required field.

    Field Description

    Name *

    Enter a unique and recognizable name for the business event type.

    Description

    Provide a description of the business event type.

  3. Click Apply.

    The business event type is created and the Business Event Type Details page for the created business event type appears.

Deleting a Business Event Type

Follow these instructions to delete a business event type:


Caution:

All event body elements of the selected business event type are also deleted.


To delete a business event type:

  1. Follow the instructions in "Accessing Business Event Type Management Tasks" to access the page for deleting a business event type.

  2. Click Yes when prompted to delete a business event type.

    The business event type is deleted and the Business Event Types page appears.

Updating a Business Event Type

Follow these instructions to update a business event type:

To update a business event type:

  1. Follow the instructions in "Accessing Business Event Type Management Tasks" to access the page for updating a business event type.

    The Update Business Event Type page appears.

  2. Make appropriate changes. (See Step 2 for a list of fields you can update.)

  3. Click Apply.

    The business event type is updated and the Business Event Types page for the updated business event type appears.

Viewing a Business Event Type

Follow these instructions to view details about a specific business event type:

To view a business event type:

  1. Ensure that you followed the instructions in "Accessing Business Event Type Management Tasks" to access the page for viewing a business event type.

    The Business Event Type Details page for the selected business event type appears.

    Text description of data_event_types25.gif follows

    Text description of the illustration data_event_types25.gif

  2. View specific details, in particular the event body element datatypes of the business event body element.

    This page, as with the Business Event Types page shown in the upper page of Figure 11-9, enables you to delete or update the selected business event type.

  3. Click Return to List to return to the Business Event Types page.

Creating an Event Body Element

The business event body element contains the business datatypes. Follow these instructions to create an event body element:

To create an event body element:

  1. Follow the instructions in "Accessing Business Event Type Management Tasks" to access the page for creating an event body element.

    The Business Event Type Details page for the selected business event type appears. (See the lower page of Figure 11-9.)

  2. Go to the Event Body Elements section.

  3. Click Create.

    The Create Event Body Element page appears.

  4. Enter the following details to create an event body element. An asterisk (*) indicates a required field.

    Field Description

    General

    • Name *

    Enter a unique and recognizable name for the event body element.

    Datatype

    • Classification *

    Core datatypes are primitive datatypes. Business datatypes are derived from core datatypes. Select Core Datatype if the event body element requires a primitive datatype. Select Business Datatype if the event body element does not require a primitive datatype.

    • Namespace *

    Select the namespace for this datatype.

    • Name *

    Select a datatype name included in this namespace by clicking the flashlight next to the Name field.

  5. Click Apply.

    You are returned to the Business Event Type Details page. The business event type now includes the event body element and its namespace and business datatypes.

Deleting an Event Body Element

Follow these instructions to delete an event body element:

To delete an event body element:

  1. Follow the instructions in "Creating an Event Body Element" to access the page for deleting an event body element.

    The Business Event Type Details page for the selected business event type appears. (See the lower page of Figure 11-9.)

  2. Go to the Event Body Elements section.

  3. Select a specific event body element to delete in the Delete column.

  4. Click Yes when prompted to delete an event body element.

    The event body element is deleted and the Business Event Type Details page appears.

Updating an Event Body Element

Follow these instructions to update an event body element:

To update an event body element:

  1. Follow the instructions in "Creating an Event Body Element" to access the page for updating an event body element.

    The Business Event Type Details page for the selected business event type appears.

  2. Go to the Event Body Elements section.

  3. Select a specific event body element to update in the Update column.

    The Update Event Body Element page appears.

  4. Make appropriate changes. (See Step 4 for a list of fields you can update.)

  5. Click Apply.

    The event body element is updated and the Business Event Type Details page for the event body element appears.

Viewing an Event Body Element

Follow these instructions to view details about a specific event body element:

To view an event body element:

  1. Follow the instructions in "Creating an Event Body Element" to access the page for viewing an event body element.

    The Business Event Type Details page for the selected business event type appears.

  2. Go to the Event Body Elements section.

  3. Select a specific event body element to view in the Name column.

    The Event Body Element Details page for the selected event body element appears.

    Text description of details_ebes.gif follows.

    Text description of the illustration details_ebes.gif

  4. View specific details. The Name link displays the Datatype Details page for the selected datatype. The Namespace link displays the Namespace Details page for the selected namespace.

    This page, as with the Business Event Type Details page shown in Figure 11-9, enables you to delete or update the selected event body element.

  5. Click Return to Event Type Details to return to the Business Event Type Details page.

Common User Errors

The following are common interaction and event type user errors.

Chapter Summary

This chapter describes how to manage adapter interactions and takes you through the steps for adding an Advanced Queuing, E-Mail, File/FTP, HTTP, JMS, Oracle Database, and Web Service adapter interaction. Managing native event types, native event correlations, event maps, application event types, and business event types are also discussed.


Go to previous page Go to next page
Oracle
Copyright © 2003 Oracle Corporation.

All Rights Reserved.
Go To Documentation Library
Home
Go To Product List
Solution Area
Go To Table Of Contents
Contents
Go To Index
Index