Skip Headers

Oracle E-Business Suite Integrated SOA Gateway User's Guide
Release 12.2
Part Number E20923-09
Go to Table of Contents
Contents
Go to previous page
Previous
Go to next page
Next

Working with Native Integration Interfaces

This chapter covers the following topics:

Common Information

Each interface details page contains the following two types of information:

Each interface details page also includes Search and Printable Page allowing you to perform a search and view the details page of a selected interface in a printable format. See Searching for an Integration Interface.

Additionally, the Log Configuration field is displayed with a value (either 'Disabled' or 'Enabled') indicating whether the selected interface has design-time log configured or not. By default, 'Disabled' is displayed.

Use design-time logs to troubleshoot any issues or exceptions encountered during SOAP based service generation and deployment life cycle. Users who have the Integration Administrator role can enable or disable the design-time logs for the selected interface by clicking Configure. The Log & Audit Setup Details page is displayed where the administrator can add a new log configuration or update existing configurations.

Please note that logging is supported for SOAP services only.

For more information on log configurations, see Logging for Web Services, Oracle E-Business Suite Integrated SOA Gateway Implementation Guide.

Common Information on Interface Details

When you click an interface name link from the Interface List page or the Search Interface page, the interface details page appears where you can view the selected interface information.

For information on SOAP and REST Web services, see Common Information on SOAP Web Services and Common Information on REST Web Services.

Common Information on Interface Details Page

the picture is described in the document text

The following fields are common to almost all interface types:

Field Notes
Internal Name This is the PL/SQL package name, the document name, or the Java service interface name.

Note: For Java service interfaces, this is called Qualified Name, and includes the full Java package name and the class name.

Type Business interfaces are organized into interface types according to the integration technologies on which they're based.
Examples of interface types supported in Integration Repository are PL/SQL, XML Gateway, Concurrent Programs, Business Events, Open Interface Tables/Views, EDI, Business Service Object (Service Beans), Java, and Composite Service - BPEL.
For more information about interface type, see interface type.
Product An Oracle E-Business Suite application or component that supplies the interface.
Business Entity Business entities are objects that either perform business activities or have business activities performed on them. For example, sales orders, account numbers, employees, purchase orders, customers, and receipts are all business entities. An interface can be used by multiple business entities, and a business entity can be accessed by multiple interfaces.
The Business Entity field lists the business entities accessed by an interface. Click a business entity name to view a list of available interfaces to that entity.
Status Valid status codes are:
  • Active

  • Deprecated - This interface should not be used, but it will be supported until obsolete.

  • Obsolete - The interface is no longer supported.

  • Planned - This interface will be activated at a future date.

Scope The scope can be one of the following:
  • Public

  • Internal To Oracle

  • Private To Application


For more information, see Scope on the Oracle Integration Repository Search page.
Interface Source The interface source can be one of the following:
  • Oracle- All Oracle seeded integration interfaces are categorized with this interface source type.

  • Custom- This indicates the interface is a custom integration interface or service.

My Oracle Support Included for an interface that has a related My Oracle Support (formerly OracleMetaLink) Knowledge Document. Click the link to log on to My Oracle Support with a valid user name and password and view the Knowledge Document.
Documentation Included for an interface that has related online documentation. Click the link to view or download the documentation.
Online Help Provided for an interface that has related Oracle E-Business Suite online help. Click the link to view online help for the interface.

The following table describes each field contained in the Source Information region:

Field Notes
Source File It indicates the source code file for this interface, and its location in the file system.
Source Version It indicates the version of the source file. The first portion of the number corresponds to the base release version of Oracle E-Business Suite; the second portion is the version of the file. For example, 120.8 is Oracle E-Business Suite 12.0, and 8 indicates that this is the 8th version of the file.

Note: The version number changes only when it has been worked on by Oracle development. Therefore the version may increment multiple times between releases, or not at all.

Source Product It represents the product code of the source product. The source product specifies under which product directory the file resides in the Oracle E-Business Suite file system (also referred to as the product top).

Tip: This field shows the product shortname. You can learn the corresponding full product name by choosing the System Administration responsibility from the Navigator menu, then selecting Oracle Applications Manager > License Manager > Reports > Licensed Products. On the product list that appears, you can filter the results for any product abbreviation (shortname) or license status.

Common Information on SOAP Web Services

For service-enabled interfaces, SOAP service information is displayed in the Web Service region (or the SOAP Web Service tab if the interfaces can also be exposed as REST services) no matter if the selected interface is currently exposed as a Web service or not.

Note: Web service is defined in a way that the interface forms the service and the methods or functions within the interface are defined as the operations of the service.

By default, an interface is not exposed as a SOAP service. Hence, the service status is 'Not Generated'. An integration administrator may transform the selected interface into a SOAP Web service. Once the service for the selected interface has been successfully generated, the service status will be changed from 'Not Generated' to 'Generated'.

the picture is described in the document text

The following fields are common in the Web Service region or the SOAP Web Service tab to almost all interface types:

Field Description
Interaction Pattern table This table displays the interface name along with the method names contained in the interface in a table. An integration administrator or an integration developer must select appropriate interaction patterns either at the interface level or at the method level before service generation.
After service generation, the selected interaction patterns are displayed for the interface or for specific methods contained in the interface. Click the interface name node to expand and view the interaction pattern selection for all the methods within the interface.
Please note that this table is still updatable after service generation, but any changes to the table will be applied only after regenerating the service.
For more information on each field in the table, see Interaction Pattern Table.
Web Service Status
(or SOAP Service Status if it's in the SOAP Web Service tab)
This field indicates different state of a SOAP service during service generation and deployment life cycle.
  • Not Generated: This indicates that the selected interface does not have a SOAP service generated.

  • Generated: This indicates that the selected interface has a SOAP service available, but the service has not yet been deployed. Therefore, this generated service is not ready to be invoked. Once a service has been successfully generated, the following buttons appear:

    • Regenerate: This button lets you regenerate the service if the interface definition has been changed or the selected interaction pattern information has been modified before service deployment.

    • Deploy: This button lets you deploy the generated SOAP service with active deployment state.

    • Reset: This button lets you clear up the existing service artifact and change the Web Service Status field from 'Generated' to 'Not Generated'.

  • Deployed: This indicates that the selected interface has been deployed to Oracle SOA Suite. A deployed service can have either one of the following states:

    • Deployed with 'Active' state: By default, the deployed service is in active state ('Deployed' with 'Active' state). This indicates that the deployed service is ready to be invoked and accept new SOAP requests. Once a service has been successfully deployed with 'Active' state, the following buttons appear:

      • Retire: This button lets you disable the active service. The SOAP Service Status field is changed to Deployed with 'Retired' state indicating that this deployed service will no longer accept new requests.

        This action also ensures that current running requests for the service are finished. Once a service has been retired ('Deployed' with 'Retired' state), the service is no longer to be invoked.

      • Undeploy: This button lets you undeploy the SOAP service from Oracle SOA Suite back to Oracle Integration Repository if necessary.

      • Reset: This button lets you clear up the existing service artifact and change the SOAP Service Status field from 'Deployed' with 'Active' to 'Not Generated'.

    • Deployed with 'Retired' state: Once a service has been retired ('Deployed' with 'Retired' state), the service is no longer to be invoked. It cannot accept new SOAP requests until it is activated ('Deployed' with 'Active' state). The following buttons appear for the service with 'Deployed' with 'Retired' state:

      • Activate: This button lets you change the retired service back to an active service again.

      • Undeploy: This button lets you undeploy the retired service from an Oracle SOA Suite managed server to the repository.

      • Reset: This button lets you reset the retired service to its initial state - 'Not Generated' if needed.


In addition to 'Not Generated', 'Generated', 'Deployed' with 'Active' state, and 'Deployed' with 'Retired' state, more intermediate SOAP service statuses can be shown while the service is in the process of performing an action issued by the administrator and transforming to a different state. The following list describes intermediate Web service status information:
  • Generating: This indicates that the selected interface is in the middle of the process of transforming the interface definition into a SOAP service. After this process completes successfully, 'Generated' is displayed in the Web Service Status field.

  • Regenerating: This indicates that the selected interface is in the middle of the process of regenerating the service. After this process is complete, 'Generated' is displayed in the Web Service Status field.

  • Deploying: This indicates that the selected interface is in the middle of the process of deploying the service. After this process is complete, 'Deployed' with 'Active' state is displayed in the Web Service Status field.

  • Undeploying: This indicates that the selected interface is in the middle of the process of undeploying the service. After this process is complete, 'Generated' state is displayed in the Web Service Status field.

  • Resetting: This indicates that the selected interface is in the middle of the process of removing the associated service artifact. After this process is complete, 'Not Generated' is displayed in the Web Service Status field.

  • Retiring: This indicates that the selected interface is in the middle of the process of disabling the active state. After this process is complete, 'Deployed' with 'Retired' state is displayed in the Web Service Status field indicating that the service is retired and cannot accept new SOAP requests.

  • Activating: This indicates that the selected interface is in the middle of the process of reverting the retired state back to active again. After this process is complete, 'Deployed' with 'Active' state is displayed in the Web Service Status field indicating that the deployed service is ready to accept new SOAP requests.

View WSDL This link is displayed after a selected interface has an associated SOAP service available. Click this link letting you review WSDL description for a generated or deployed service.
See: Reviewing Web Service WSDL Source.
Interaction Pattern After service generation, this information is displayed which corresponds to the selected interaction patterns in the Interaction Pattern table.
For example, if 'Synchronous' is selected for a specific method contained in a PL/SQL interface, and 'Asynchronous' is selected for another method within the interface, then both 'Synchronous' and 'Asynchronous' are shown in this field.

Note: XML Gateway, Concurrent Program, and Business Service Object interfaces can be service enabled only with synchronous support. Therefore, 'Synchronous' is displayed in the Interaction Pattern field for those interfaces by default if the service is available.

Authentication Type To secure Web service content and authenticate Web service operation, before deploying a generated service, an integration administrator must select one desired authentication type for the selected service in the Authentication Type field.
  • Username Token: This authentication type provides username and password information in the security header to authenticate SOAP requests.

    See: UsernameToken Based Security, Oracle E-Business Suite Integrated SOA Gateway Implementation Guide.

  • SAML Token (Sender Vouches): This authentication type is used for Web services relying on sending a username only through SAML Assertion.

    See: SAML Sender-Vouches Token Based Security, Oracle E-Business Suite Integrated SOA Gateway Implementation Guide.


Only users who have the Integration Administrator role can select and modify the authentication type. For other users, this field is displayed in read-only mode.

Interaction Pattern Table

Oracle E-Business Suite Integrated SOA Gateway supports service generation synchronously, asynchronously, or both synchronously and asynchronously based on the selection made by the administrator or the integration developer in the Interaction Pattern table.

Interaction Pattern Selection

Before service generation, the administrator or the integration developer must select appropriate interaction patterns either at the interface level or at the method level by expanding the interface name node to list all the methods within the interface.

After service generation, the Interaction Pattern table is still updatable, but any changes will be applied only after service regeneration.

Note: In this release, asynchronous SOAP service operation is supported only in PL/SQL interface. Other SOAP service-enabled interface types including XML Gateway, Concurrent Program, and Business Service Object can be exposed as SOAP services only with the synchronous support.

The following table describes each field in the Interaction Pattern table:

Field Description
Display Name This is the interface name used externally.
Internal Name This is the interface name used internally. It can be PL/SQL package name, the document name, or the Java service interface name.
Synchronous If the 'Synchronous' check box is selected for an interface or a specific method, the service or selected operation is generated with the support for synchronous interaction pattern.
That is when Web service client sends a SOAP request for this service, service executes and provides an immediate response to the Web service client.
Asynchronous If the 'Asynchronous' check box is selected for an interface or a specific method, the service or selected operation is generated with the support for asynchronous interaction pattern. This type of service execution may require a significant amount of time to process a request. However, the client that invoked the Oracle E-Business Suite Web service can continue with other processing in the meantime rather than waiting for the response.
In this release, asynchronous operation is supported in PL/SQL interface only.
Grant If the access permission of an operation has been granted to a specific user, user groups, or all users, then the Grant icon is available for the operation. Only users who have the Integration Administrator role and the Integration Developer role can find the Grant icon and view the grant details.
The Grant icon is shown only in the SOAP Web Service tab.

Performing Administrative Activities for SOAP Web Services

Users who have the Integration Administrator role can perform administrative tasks. These tasks include generating, deploying, undeploying, resetting, retiring, and activating SOAP services by clicking the following buttons in the interface details page:

Note: In addition to performing service management activities in the Integration Repository tab, integration administrators can perform other administrative tasks in the Administration tab that are outside the Integration Repository user interface. These tasks include:

Common Information on REST Web Services

If a selected interface (such as a PL/SQL or Java Bean Services interface) can be exposed as a REST service, the REST Web Service tab is displayed in the interface details page.

REST Web Service Tab for Java Bean Services

the picture is described in the document text

An integration administrator can click Deploy to deploy selected operations contained in the API as REST service operations. Once the REST service has been successfully deployed, the REST Service Status field is changed from 'Not Deployed' to 'Deployed'.

The following fields are common in the REST Web Service tab:

Field Description
Service Alias Each REST service should be associated with a unique alias name. Before deploying a REST service, the administrator must enter this field which will be used in service endpoint, WADL, XSDs, and namespaces.
Please note the following guidelines when specifying the service alias:
  • Use simple and meaningful name to represent the service, such as "person", "employee", and so on.

  • Do not use "rest", "soap", and "webservices" as the alias.

  • Do not start with number and special character, such as #, $, %, _, - and more.

  • Do not end with special character.

  • Characters such as ., _, and - are allowed in service alias.

REST Service Status This field indicates different state of a REST service during service life cycle.
  • Not Deployed: This indicates that the selected interface is not deployed.

    Click Deploy to deploy the REST service. The REST Web Service Status is changed from 'Not Deployed' to 'Deployed'.

  • Deployed: This indicates that the selected interface is deployed to an Oracle E-Business Suite managed server.

    Once a REST service has been successfully deployed, the administrator can undeploy the service by clicking Undeploy. This action undeploys the REST service from the Oracle E-Business Suite managed server back to Oracle Integration Repository, and at the same time it clears up the existing service artifact. The REST Service Status field is changed from 'Deployed' to 'Not Deployed'.


In addition to 'Not Deployed' and 'Deployed' service states, more intermediate service statuses can be shown while the service is in the process of performing an action issued by the administrator and transforming to a different state. The following list describes intermediate service status information:
  • Deploying: This indicates that the selected interface is in the middle of the process of deploying the service. After this process is complete, 'Deployed' is displayed in the REST Service Status field.

  • Undeploying: This indicates that the selected interface is in the middle of the process of undeploying and removing the associated service artifact. After this process is complete, 'Not Deployed' is displayed in the REST Service Status field.

View WADL This link is displayed after the selected interface has an associated REST service deployed. Click this link letting you review WADL description for the deployed REST service.
This field appears only when the REST service has been successfully deployed with 'Deployed' status.
See: Reviewing Web Service WADL Source.
Verb The Verb value indicates how the REST service is implemented using an HTTP method.
If the selected interface is a PL/SQL API, then this field is displayed when the REST service has the Deployed status.
Please note that POST is the only supported HTTP method for PL/SQL APIs.
REST Service Security To secure REST service content, all REST services are secured by either one of the following security methods:
  • HTTP Basic Authentication: This authentication type is for an HTTP client application to provide username and password when making a REST request that is typically over HTTPS.

    See: HTTP Basic Authentication, Oracle E-Business Suite Integrated SOA Gateway Implementation Guide.

  • Token Based Authentication: This security authenticates a user using a security token obtained by invoking the security Login service. When a user tries to log on to a server, a token (such as Oracle E-Business Suite session ID) may be sent as cookie in HTTP header. This authentication method can be used in multiple consecutive REST invocations. See: Token Based Authentication, Oracle E-Business Suite Integrated SOA Gateway Implementation Guide.

Service Operations table This table displays the list of procedures or functions contained in the selected interface that can be exposed as REST service operations.
For more information on each field in the table, see Service Operations Table.

Service Operations Table

The Service Operations table displays each method (or procedure or function) contained in the selected interface, and whether it is exposed as a service operation. Users who have the Integration Administrator role can perform administrative tasks including deploying or undeploying services with desired service operations as well as creating or revoking security grants.

The following table describes each field in the Service Operations table:

Field Description
Select Users who have the Integration Administrator role can select one or more methods from the table before deploying the service.
Display Name This is the interface name used externally.
Internal Name This is the interface name used internally.
Included Operations (PL/SQL APIs Only) This column is displayed when the selected PL/SQL interface has been exposed as a REST service. A check is displayed for the method or operation that has been exposed as a REST service operation.
GET
(Java Bean Services APIs Only)
This GET HTTP method column is displayed when the selected interface is an interface type of Java Bean Services.
This GET check box is preselected if a Java method is annotated with the GET HTTP method. The administrator can uncheck the preselected GET check box for the Java method if it will not be published with the GET method.
However, if the GET method is not annotated, unlike the POST method, the GET check box becomes inactive or disabled for further selection.
POST
(Java Bean Services APIs Only)
This HTTP method column is displayed when the selected interface is an interface type of Java Bean Services.
Similar to the GET method, this POST check box is preselected if a Java method is annotated with the POST HTTP method. The administrator can uncheck the preselected check box before deploying the service if the Java method will not be published with the POST method.
If the POST HTTP method is not annotated, the POST check box remains active or enabled by default. This allows the administrator to select the POST check box if needed for the Java method as a REST service operation before service deployment.
Grant If the access permission of an operation has been granted to a specific user, user groups, or all users, then the Grant icon is displayed for the operation. Only users who have the Integration Administrator role and the Integration Developer role can find the Grant icon and view the grant details.

Performing Administrative Activities for REST Web Services

REST services have a simplified service development life cycle. Users who have the Integration Administrator role can perform the following administrative tasks in the interface details page:

Note: For information about different user roles and their associated privileges to administer and view REST services, see Accessing Oracle Integration Repository.

Reviewing Web Service WSDL Sources

Once a Web service represented in WSDL has been successfully generated, the SOAP service status is changed from 'Not Generated' to 'Generated'. The WSDL link appears in the Web Service region (or the SOAP Web Service tab if the interface can be exposed as both SOAP and REST services) allowing you to view the WSDL description.

Generated WSDL and Deployed WSDL Descriptions

For a generated service before it is deployed, the WSDL description is an abstract definition of the message that has been transmitted. Once the service has been successfully deployed, the WSDL description contains concrete service binding and transport details.

For example, the following elements contain different URL information in the generated and deployed WSDL descriptions:

For more information on WSDL elements, see Reviewing WSDL Element Details, Oracle E-Business Suite Integrated SOA Gateway Developer's Guide.

To view a generated WSDL file:

  1. Log in to Oracle E-Business Suite as a user who has the Integration Analyst role. Select the Integration Repository responsibility and the Integration Repository link from the navigation menu.

    The Integration Repository home page appears.

  2. Locate your desired interface definition through a search or browse from the interface tree structure within the repository.

  3. Click the interface name to open the interface details.

  4. In the Web Service region (or the SOAP Web Service tab if the interface can be exposed as both SOAP and REST services), click the View WSDL link to view the WSDL source code.

    The following sample shows the generated WSDL description with synchronous interaction pattern for the PL/SQL interface PA_COST_PLUS:

    <?xml version="1.0" encoding="UTF-8" standalone="no" ?> 
    <definitions xmlns:tns="http://xmlns.oracle.com/apps/pa/soaprovider/plsql/pa_cost_plus/" 
     xmlns="http://schemas.xmlsoap.org/wsdl/" 
     xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" 
     xmlns:tns1="http://xmlns.oracle.com/apps/pa/soaprovider/plsql/pa_cost_plus/get_burden_amount/" name="PA_COST_PLUS" 
     targetNamespace="http://xmlns.oracle.com/apps/pa/soaprovider/plsql/pa_cost_plus/">
    <types>
    <schema xmlns="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified" 
     targetNamespace="http://xmlns.oracle.com/apps/pa/soaprovider/plsql/pa_cost_plus/get_burden_amount/"> 
     <include schemaLocation="http://<hostname>:<port>/ISG-ISG-context-root/isgapp/plsql/pa_cost_plus/APPS_PA_COST_PLUS_GET_BURDEN_AMOUNT.xsd"/>
    </schema> 
    <schema xmlns="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified"
     targetNamespace="http://xhttp://xmlns.oracle.com/apps/pa/soaprovider/plsql/pa_cost_plus/">
       <element name="SOAHeader">
        <complexType>
          <sequence>
          	<element name="Responsibility" minOccurs="0" type="string" /> 
           <element name="RespApplication" minOccurs="0" type="string" /> 
           <element name="SecurityGroup" minOccurs="0" type="string" /> 
           <element name="NLSLanguage" minOccurs="0" type="string" /> 
           <element name="Org_Id" minOccurs="0" type="string" /> 
         </sequence>
       </complexType>
      </element>
     </schema>
    </type>
    <message name="GET_BURDEN_AMOUNT_Input_Msg">
    <part name="header" element="tns:SOAHeader" /> 
    <part name="body" element="tns1:InputParameters" /> 
    </message>
    <message name="GET_BURDEN_AMOUNT_Output_Msg">
    <part name="body" element="tns1:OutputParameters" /> 
    </message>
    <portType name="PA_COST_PLUS_PortType">
    <operation name="GET_BURDEN_AMOUNT">
    <input message="tns:GET_BURDEN_AMOUNT_Input_Msg" />
    <output message="tns:GET_BURDEN_AMOUNT_Output_Msg" /> 
    </operation>
    </portType>
    <binding name="PA_COST_PLUS_Binding" type="tns:PA_COST_PLUS_PortType">
    <soap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http" /> 
    <operation name="GET_BURDEN_AMOUNT">
    <soap:operation soapAction="GET_BURDEN_AMOUNT" /> 
    <input>
    <soap:header message="tns:GET_BURDEN_AMOUNT_Input_Msg" part="header" use="literal" /> 
    <soap:body parts="body" use="literal" /> 
    </input>
    <output>
    <soap:body use="literal" /> 
    </output>
    </operation>
    </binding>
    <service name="PA_COST_PLUS_Service">
    <port name="PA_COST_PLUS_Port" binding="tns:PA_COST_PLUS_Binding">
    <soap:address location="#NOT_DEPLOYED#" /> 
    </port>
    </service>
    </definitions>

    Note: Values passed in the Responsibility, Responsibility Application, Security Group, NLS Language, and Organization ID complex types listed under the "SOAHeader" are used to set applications context during service execution.

    Please note that NLS Language and Organization ID are optional values to be passed. However, if the execution of a service is dependent on any particular organization, then you must pass the ORG_ID element in the "SOAHeader" of that SOAP request.

    For more information, see Setting Other Web Service Input Message Parts, Oracle E-Business Suite Integrated SOA Gateway Implementation Guide.

    Please note that the username and password information is defined by the Web service security policy (such as oracle/wss_username_token_service_policy). Detailed instructions on how to pass the security headers along with the SOAP request, see Configuring Web Service Policies, Oracle E-Business Suite Integrated SOA Gateway Developer's Guide.

    For more WSDL element information, see Reviewing WSDL Element Details, Oracle E-Business Suite Integrated SOA Gateway Developer's Guide.

To view a deployed WSDL file:

Once a service has been successfully deployed to an Oracle SOA Suite WebLogic managed server, the SOAP service status is changed from 'Not Generated' to 'Deployed' with 'Active' state along with the selected authentication type. Click the View WSDL link to view the deployed WSDL file.

The following sample shows the deployed WSDL description with synchronous interaction pattern for the same PL/SQL interface PA_COST_PLUS:

<?xml version="1.0" encoding="UTF-8" ?> 
...
<wsp:Policy xmlns:wsp="http://schemas.xmlsoap.org/ws/2004/09/policy" 
...
</wsp:Policy>
<types>
<schema xmlns="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified" 
 targetNamespace="http://xmlns.oracle.com/apps/pa/soaprovider/plsql/pa_cost_plus/get_burden_amount/"> 
<include schemaLocation=http://"<soa_suite_hostname>:<port>/soa-infra/services/default/<jndi_name>_PLSQL_PA_COST_PLUS/PA_COST_PLUS_Service?XSD=xsd/APPS_PA_COST_PLUS_GET_BURDEN_AMOUNT.xsd" /> 
</schema> 
<schema xmlns="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified"
...
</schema>
</type>
...
<service name="PA_COST_PLUS_Service">
<port name="PA_COST_PLUS_Port" binding="tns:PA_COST_PLUS_Binding">
<soap:address location="http://"<soa_suite_hostname>:<port>/soa-infra/services/default/<jndi_name>_PLSQL_PA_COST_PLUS/PA_COST_PLUS_Service" />  
</port>
</service>
</definitions>

Reviewing Web Service WADL Sources

Once a REST Web service represented in WADL has been successfully deployed, the REST Service Status field is changed from 'Not Deployed' to 'Deployed'. The WADL link appears in the REST Web Service tab allowing you to view the WADL description.

For example, the following WADL description is for a PL/SQL API Invoice Creation (AR_INVOICE_API_PUB) that includes 'CREATE_INVOICE' and 'CREATE_SINGLE_INVOICE' REST service operations:

<?xml version="1.0" encoding="UTF-8" standalone="no" ?> 
<application xmlns:tns="http://xmlns.oracle.com/apps/ar/soaprovider/plsql/rest/ar_invoice_api_pub/" xmlns="http://wadl.dev.java.net/2009/02"
xmlns:tns1="http://xmlns.oracle.com/apps/ar/rest/ar/create_invoice/" name="AR_INVOICE_API_PUB" 
targetNamespace="http://xmlns.oracle.com/apps/ar/soaprovider/plsql/rest/ar_invoice_api_pub/">
  	<grammars>
  		<include xmlns="http://www.w3.org/2001/XMLSchema" href="https://host01.example.com
:1234/webservices/rest/Invoice/?XSD=CREATE_INVOICE_SYNCH_TYPEDEF.xsd" /> 
		<include xmlns="http://www.w3.org/2001/XMLSchema" href="https://host01.example.com:1234/webservices/rest/Invoice/?XSD=CREATE_SINGLE_INVOICE_SYNCH_TYPEDEF.xsd" /> 
   	</grammars>
	<resources base="http://host01.example.com:1234/webservices/rest/Invoice/">
		      ...
	</resources>
</application>

Note: The service alias value Invoice entered earlier before service deployment is now displayed as part of the schema for the service operations - 'CREATE_INVOICE' and 'CREATE_SINGLE_INVOICE'.

<?xml version="1.0" encoding="UTF-8" standalone="no" ?> 
<application xmlns:tns=...
...
 	<resources base="http://host01.example.com:1234/webservices/rest/Invoice/">
		<resource path="/create_invoice/">
			<method id="CREATE_INVOICE" name="POST">
				<request>
					<representation mediaType="application/xml" type="tns1:InputParameters" /> 
					<representation mediaType="application/json" type="tns1:InputParameters" /> 
				</request>
				<response>
					<representation mediaType="application/xml" type="tns1:OutputParameters" /> 
					<representation mediaType="application/json" type="tns1:OutputParameters" /> 
				</response>
			</method>
		</resource>
		<resource path="/create_single_invoice/">
			<method id="CREATE_SINGLE_INVOICE" name="POST">
				<request>
					<representation mediaType="application/xml" type="tns2:InputParameters" /> 
					<representation mediaType="application/json" type="tns2:InputParameters" /> 
				</request>
				<response>
					<representation mediaType="application/xml" type="tns2:OutputParameters" /> 
					<representation mediaType="application/json" type="tns2:OutputParameters" /> 
				</response>
			</method>
		</resource>
	</resources>
</application>

Note: POST is shown as the method name for two service operations 'CREATE_INVOICE' and 'CREATE_SINGLE_INVOICE'. This is the only HTTP method supported for PL/SQL REST services in this release.

Input and output messages can be exchanged in both XML and JSON formats for both service operations.

If the deployed REST service is an interface type of Java Bean Services, then both GET and POST can be shown as the supported methods in the REST service operation. For example, the following WADL description shows many methods contained in the Employee Information service. The getPersonInfo operation is implemented with both POST and GET HTTP methods.

<xml version="1.0" encoding="UTF-8"> 
<application name="EmployeeInfo" targetNamespace="http://xmlns.oracle.com/apps/per/soaprovider/pojo/employeeinfo/"
 xmlns:tns="http://xmlns.oracle.com/apps/per/soaprovider/pojo/employeeinfo/" 
 xmlns="http://wadl.dev.java.net/2009/02" xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
 xmlns:tns1="http://xmlns.oracle.com/apps/fnd/rest/empinfo/getallreports/" 
 xmlns:tns2="http://xmlns.oracle.com/apps/fnd/rest/empinfo/getdirectreports/" 
 xmlns:tns3="http://xmlns.oracle.com/apps/fnd/rest/empinfo/getpersoninfo/">

<grammars>
  		<include href="http://<hostname>:<port>/webservices/rest/empinfo/?XSD=getallreports.xsd" xmlns="http://www.w3.org/2001/XMLSchema" /> 
			<include href="http://<hostname>:<port>/webservices/rest/empinfo/?XSD=getdirectreports.xsd" xmlns="http://www.w3.org/2001/XMLSchema" /> 
			<include href="http://<hostname>:<port>/webservices/rest/empinfo/?XSD=getpersoninfo.xsd" xmlns="http://www.w3.org/2001/XMLSchema" />
</grammars>
<resources base="http://<hostname>:<port>/webservices/rest/empinfo/">
  <resource path="/getAllReports/">
	<method id="getAllReports" name="GET">
	   	<request>
			  <param name="ctx_responsibility" type="xsd:string" style="query" required="false" />
           <param name="ctx_respapplication" type="xsd:string" style="query" required="false" />
				<param name="ctx_securitygroup" type="xsd:string" style="query" required="false" />
				<param name="ctx_nlslanguage" type="xsd:string" style="query" required="false" />
				<param name="ctx_orgid" type="xsd:int" style="query" required="false" />
			</request>
			<response>
					<representation mediaType="application/xml" type="tns1:getAllReports_Output" /> 
					<representation mediaType="application/json" type="tns1:getAllReports_Output" /> 
				</response>
			</method>
		</resource> 
 <resource path="/getDirectReports/">
		<method id="getDirectReports" name="GET">
				<request>
					<param name="ctx_responsibility" type="xsd:string" style="query" required="false" />
              <param name="ctx_respapplication" type="xsd:string" style="query" required="false" />
					<param name="ctx_securitygroup" type="xsd:string" style="query" required="false" />
					<param name="ctx_nlslanguage" type="xsd:string" style="query" required="false" />
					<param name="ctx_orgid" type="xsd:int" style="query" required="false" />
				</request>
		   	<response>
					<representation mediaType="application/xml" type="tns2:getDirectReports_Output" /> 
					<representation mediaType="application/json" type="tns2:getDirectReports_Output" /> 
				</response>
			</method>
		</resource>
 <resource path="="/getPersonInfo/ {personId}/">
  <param name="personId" style="template" required="true" type="xsd:int" /> 
	<method id="getPersonInfo" name="GET">
	   	<request>
			  <param name="ctx_responsibility" type="xsd:string" style="query" required="false" />
           <param name="ctx_respapplication" type="xsd:string" style="query" required="false" />
				<param name="ctx_securitygroup" type="xsd:string" style="query" required="false" />
				<param name="ctx_nlslanguage" type="xsd:string" style="query" required="false" />
				<param name="ctx_orgid" type="xsd:int" style="query" required="false" />
			</request>
			<response>
					<representation mediaType="application/xml" type="tns3:getPersonInfo_Output" /> 
					<representation mediaType="application/json" type="tns3:getPersonInfo_Output" /> 
				</response>
			</method>
		</resource> 
 <resource path="/getPersonInfo/">
		<method id="getPersonInfo" name="POST">
				<request>
				   <representation mediaType="application/xml" type="tns3:getPersonInfo_Input" /> 
					<representation mediaType="application/xml" type="tns3:getPersonInfo_Output" /> 	
				</request>
		   	<response>
				   <representation mediaType="application/xml" type="tns3:getPersonInfo_Input" /> 
					<representation mediaType="application/xml" type="tns3:getPersonInfo_Output" />				</response>
			</method>
		</resource>
  </resource path>
</application>

For more information about WADL description, see Reviewing WADL Element Details, Oracle E-Business Suite Integrated SOA Gateway Developer's Guide.

To view a deployed WADL file:

  1. Log in to Oracle E-Business Suite as a user who has the Integration Analyst role. Select the Integration Repository responsibility and the Integration Repository link from the navigation menu.

    The Integration Repository home page appears.

  2. Locate your desired interface definition through a search or browse from the interface tree structure within the repository.

  3. Click the interface name to open the interface details page.

  4. In the REST Web Service tab, click the View WADL link to view the WADL source code.

Managing Grants

Only integration administrators or users who have the Integration Administrator role can create security grants by authorizing the access permissions of interface methods (or procedures and functions) to a user, a user group, or all users. Similarly, the administrators can revoke the grants from an authorized user, user group, or all users on a selected method or service.

Interface types that have the security grant feature available are PL/SQL, Concurrent Program, Business Service Object, Java Bean Services, and Inbound XML Gateway interfaces.

Security grants are managed in the Methods region for Concurrent Program, Business Service Object, and XML Gateway interfaces.

Managing Grants in the Methods Region

the picture is described in the document text

Security grants are managed in the Grants tab for PL/SQL APIs and Java Bean Services.

Managing Grants in the Grants Tab

the picture is described in the document text

Please note that the grant feature applies to the interfaces that can be exposed as both SOAP and REST services. For example, when a user (OPERATIONS) is authorized to have access permission on a PL/SQL API method name called 'Change User Name', the user will have the permission to access the associated 'Change User Name' service operations of both SOAP and REST service types through the same grant.

Creating Security Grants

To create a grant, select appropriate method name check boxes in the Methods region or in the Grants tab if the selected interface can be exposed as a REST service. Click Create Grant to open the Create Grants page.

In the Create Grants page, select a grantee type and grantee name if it's applicable. Click Apply. This creates security grants for the selected methods.

Please note that the grant action applies to both SOAP and REST PL/SQL services.

Revoking Security Grants

To revoke a grant in the Methods region, select the Show link for the method that the administrator wants to view or revoke the grant. The Grant Details section of the selected method appears with the grantee and grantee type information. Click the Revoke icon for the grant that you want to revoke.

To revoke a grant in the Grants tab, the administrator can perform the action in two ways:

For more information about how to manage grants in the Methods region, see Managing Security Grants for the SOAP Web Services Only, Oracle E-Business Suite Integrated SOA Gateway Implementation Guide.

For more information about how to manage grants in the Grants tab, see Managing Security Grants for the SOAP and REST Web Services, Oracle E-Business Suite Integrated SOA Gateway Implementation Guide.

XML Gateway Map Information

The following diagram illustrates the basic structure of the XML Gateway Map information page and its connections to related pages:

the picture is described in the document text

The XML Gateway Map information page includes standard fields shown in the common region of the selected XML Gateway interface along with the Web Service region and Method region.

For XML Gateway interface, it can be either inbound or outbound direction. An inbound XML Gateway map indicates that the interface receives incoming transactions or messages into the Oracle E-Business Suite. An outbound map indicates that the interface sends outgoing transactions or messages to another system. For more common information shown in the interface details page, see Common Information on Interface Details.

XML Gateway Interface Details Page

the picture is described in the document text

PL/SQL Information

The following diagram illustrates the basic structure of the PL/SQL information page and its connection to the related PL/SQL procedure and function details:

the picture is described in the document text

PL/SQL interfaces can be exposed as both SOAP services and REST services. Therefore, the PL/SQL interface details page includes general section of a selected PL/SQL interface, the Overview tab, the SOAP Web Service tab, and the REST Web Service tab.

Users who have the Integration Administrator role can find an additional Grants tab displayed in the interface details page. This tab allows the administrator to create and revoke security grants. For more information on how to manage security grants, see Managing Grants.

For information on the general section, see Common Information.

PL/SQL Interface Details Page

the picture is described in the document text

Note: For more information about Web services, see Understanding Web Services.

PL/SQL Method Details Page

The PL/SQL method details page appears when you click a method name in the Overview tab, the SOAP Web Service tab, or the REST Web Service tab.

PL/SQL Method Details Page

the picture is described in the document text

This page displays the signature of the selected method, and a table listing the parameters and their attributes.

Java Information

The following diagram illustrates the basic structure of the Java information page and its connection to the related Java method information page.

the picture is described in the document text

The general section of the Java information page displays common information for the selected Java class. This page also contains a table listing the class methods, including active status and internal name. Click the Java method name link to access the Java Method Details page.

If you are granted the Integration Administrator role, Create Grant appears in the Methods region. This lets you grant the access permissions of selected methods to a user, a user group, or all users. For more information on how to create security grants, see Managing Grants.

Java Method Information

The Java method details page appears when you click a method name on the Java interface details page.

The general section of the Java method information page displays common information for the selected method, plus the following additional fields:

This page also displays the signature of a selected method, information about the return type, and a table listing the method parameters.

Subtype of Java APIs

Some Java APIs are categorized as a subtype of Java interfaces. To locate those Java APIs, you must perform a search through the combination of Category and Category Value fields.

For information on how to locate these Java APIs through a search, see Searching for an Integration Interface.

If your selected interface belongs to these subtypes of Java APIs, the interface details page may contain Web service information if the selected interface is exposed as a service. For the interface details page of these APIs, see:

Java Bean Services

The following diagram illustrates the basic structure of the Java Bean Services information page and its connection to the related Java method details:

the picture is described in the document text

Searching Java Bean Services Interfaces

To locate Java Bean Services, you must perform a search by clicking Show More Search Options to display more search fields.

Enter the following key search values as the search criteria:

For information about category and category value fields, see Category and Category Value.

Viewing Java Bean Services

Java Bean Services can be exposed as REST services only. The interface details page contains the Overview tab and the REST Web Service tab. An integration administrator can find an additional Grants tab displayed in the page. This Grants tab allows the integration administrator to create and revoke security grants. For more information on how to manage security grants, see Managing Grants.

For information on the general section, see Common Information.

Note: For more information about Web services, see Understanding Web Services.

the picture is described in the document text

Security Services

Security services are a set of predefined and predeployed REST services from Oracle Application Object Library. These services include Authentication and Authorization services and are used for mobile applications.

For example, Login service validates the user credentials and returns an access token. Logout service invalidates the access token and any associated authentication sessions. These two services are included in the Authentication service that helps session initialization with security or applications context information. Authorization service retrieves the Access Control List which may contain assigned responsibilities, roles, and privileges for all logged-in users.

For more information about these REST security services, refer to the Oracle E-Business Suite Security Guide.

Searching and Viewing Security Services

To locate security services, you must click Show More Search Options and then perform a search through the combination of Category (subtype) and Category Value (Security Services) fields.

Searching for Security Services

the picture is described in the document text

For information about category and category value fields, see Category and Category Value.

Viewing Security Service Interface Details

After a search, select a desired security service from the search results table. The interface details page for the selected security service is displayed. It contains some common interface information, REST Web Service region, and Methods region.

the picture is described in the document text

For information on the general section, see Common Information.

REST Web Service Region

The REST Web Service region contains the selected security service information.

Please note that security services are pregranted to all Oracle E-Business Suite users which means that all the users can invoke these services.

Methods Region

In the Methods region, click a method name link to open the Java Method Details page for the selected method.

Java APIs for Forms

Java APIs for Forms are XML document-based integration points wrapped in Java classes for executing business logic in Oracle Forms.

Searching and Viewing Java APIs for Forms Interfaces

Similar to other subtype of Java APIs, you must perform a search by clicking Show More Search Options to locate the Java APIs for Forms through the combination of Category (Interface Subtype) and Category Value (Java APIs for Forms) fields.

For information about category and category value fields, see Category and Category Value.

To view the interface details, select a desired Java APIs for Forms interface from the search result table. The selected interface details should appear.

Please note that Java APIs for Forms interfaces are not serviceable interfaces and cannot be exposed as SOAP services.

Business Service Object

Business service object (BSO) interface type, formerly known as service bean, provides the access to SOA services and facilitates integration between Oracle E-Business Suite and trading partners. This type of interfaces can be used directly or exposed as Web services. BSO interface type often employs service data objects as parameters to pass complex data.

A service data objects (SDO) defines a generic API for accessing and manipulating structured data. It is designed to simplify and unify the way in which applications handle data. The SDO API is independent of the actual data source. For example, SDO can be used to access XML data or SQL data. For more information about SDO, see Reviewing Service Data Objects.

Note: A business service object is not actually an interface type, but rather an object used by one or more Java service interfaces or other service data objects to pass data. Oracle Integration Repository includes it on list of interface types, so that you can browse or search for Java service interfaces based on the business service objects that they use.

The following diagram illustrates the basic structure of the business service object interface information page and its connections to related pages:

the picture is described in the document text

Business Service Object Interface Details Page

The business service object interface details page contains general section of a selected BSO interface, the Web Service region, and Methods region.

Business Service Object Interface Details Page

the picture is described in the document text

The general section displays common information for the selected business service object interface, plus interface name, and the interface that extends.

For more common information shown in the interface details page, see Common Information on Interface Details

Viewing WSDL description

Click the View WSDL link to view the WSDL file. The following sample shows the WSDL description for the Integration Repository Service:

<?xml version="1.0"?>
<definitions name="IntegrationRepositoryService" 
targetNamespace="http://xmlns.oracle.com/oracle/apps/fnd/rep/ws/IntegrationRepositoryService"
  xmlns="http://schemas.xmlsoap.org/wsdl/"
  xmlns:xsd="http://www.w3.org/2001/XMLSchema"
  xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"
  xmlns:tns2="http://xmlns.oracle.com/apps/fnd/ServiceBean"
  xmlns:tns1="http://xmlns.oracle.com/apps/fnd/rep/ws"
  xmlns:tns="http://xmlns.oracle.com/oracle/apps/fnd/rep/ws/IntegrationRepositoryService">
<types>
<xsd:schema>
  <xsd:import namespace="http://xmlns.oracle.com/apps/fnd/rep/ws" schemaLocation="http://<hostname>:<port>/ISG-ISG-context-root/isgapp/apps/bso/ws/IntegrationRepositoryService.xsd"/>
</xsd:schema>
<xsd:schema elementFormDefault="qualified" targetNamespace="http://xmlns.oracle.com/apps/fnd/ServiceBean" >
  <xsd:element name="ServiceBean_Header">
    <xsd:complexType>
      <xsd:element name="RESPONSIBILITY_NAME" minOccurs="0" type="xsd:string"/>
      <xsd:element name="RESPONSIBILITY_APPL_NAME" minOccurs="0" type="xsd:string"/>
      <xsd:element name="SECURITY_GROUP_NAME" minOccurs="0" type="xsd:string"/>
      <xsd:element name="NLS_LANGUAGE" minOccurs="0" type="xsd:string"/>
      <xsd:element name="ORG_ID" minOccurs="0" type="xsd:string"/>
     </xsd:sequence>
   </xsd:complexType>
  </xsd:element>
 </xsd:schema>
   . . .

Note: Values passed in the Responsibility Name, Responsibility Application Name, Security Group, NLS Language, and Organization ID elements listed under the ServiceBean_Header are used to set applications context during service execution.

Please note that NLS Language and Organization ID are optional values to be passed. However, if the execution of a Business Service Object interface is dependent on a particular organization, then you must pass the ORG_ID element in the ServiceBean_Header of that SOAP request.

For more information, see Setting Other Web Service Input Message Parts, Oracle E-Business Suite Integrated SOA Gateway Implementation Guide.

The username and password information is defined by the Web service security policy (such as oracle/wss_username_token_service_policy). Detailed instructions on how to pass the security headers along with the SOAP request, see Configuring Web Service Policies, Oracle E-Business Suite Integrated SOA Gateway Developer's Guide.

If error occurred, the following error message information appears under <Method>_Response:

...
<xsd: complexType name ="IntegrationRepositoryService_GetServiceDescription_Response">
		...
		<xsd:sequence>
 				<xsd:element name="serviceDescription" type="oans3:ServiceDescription" minOccurs="0" nillable="true"/>
				<xsd:element name="Message" type="oans1:ServiceMessage" minOccurs="0" maxOccurs="unbounded"/>

				<xsd:element name="ErrorMessage" type="oans1:ServiceMessage" minOccurs="0" maxOccurs="unbounded"/>
		</xsd:sequence>
</xsd: complexType name>

Note: The Message and ErrorMessage elements listed under <Method>_Response are used for error messages. The Message element will appear as warning messages in the SOAP response. It is used to display any warning message returned by the API. The ErrorMessage element corresponds to OAExceptions that were raised during the method invocation. In general, the response for any service method can contain any of the following:

For more information about error messages, see Error Handling section, Building an OA Framework Application (the Basics) chapter, Oracle Application Framework Developer's Guide, available from My Oracle Support Knowledge Document 1315485.1.

Business Service Object Interface Method Information

The business service object interface method details page appears when you click a method name link in the Methods region.

Business Service Object Method Details Page

the picture is described in the document text

In addition to common information, the general section of the method details page contains a link to the interface that uses this method.

The following regions also appear on the method details page:

Integration administrators have the privileges to create security grants by clicking Create Grant in the Methods region. This authorizes access permissions of selected methods to a user, a user group, or all users.

For more information on how to create security grants, see: Managing Grants.

Integration Repository Service

Based on business service object interface, Integration Repository Service is a service component in the Integration Repository. It queries Integration Repository data, and provides information about all the interface definitions to facilitate the integration between Oracle E-Business Suite and trading partners.

When you search for Integration Repository Service through the business service object interface type, all business service objects contained in the Integration Repository Service are displayed.

Integration administrators or users who have the Integration Administrator role can create security grants by authorizing each business service object method contained in the service to a user, a user group, or all users. For more information, see Managing Grants.

Use the following steps to locate the Integration Repository Service:

  1. Log in to Oracle E-Business Suite as a user who has the Integration Analyst role. Select the Integration Repository responsibility and the Integration Repository link from the navigation menu.

  2. Click Search.

  3. Enter the following information in the Search page:

  4. Click Go to execute the search.

  5. Click the Integration Repository Service link from the search result table.

    This opens the Business Service Object interface details page.

    See: Business Service Object Interface Details Page.

  6. Click a method name link in the Methods region to get to business service object method details.

    See: Business Service Object Method Information.

Reviewing Service Data Object

A service data objects (SDO) defines a generic API for accessing and manipulating structured data. It is designed to simplify and unify the way in which applications handle data. The SDO API is independent of the actual data source. For example, SDO can be used to access XML data or SQL data.

The data objects associated with business service objects include service data objects (SDO) and filter data objects (FDO).

Service Data Object Information

The service data object details page is accessible directly from the Integration Repository browse interface through the list of interface types. It is also accessible from the getDataList and processDataList method details pages.

The following diagram illustrates the basic structure of the service object information page and its connections to related pages.

the picture is described in the document text

The general section of the service data object page displays common information, plus the data object class name, implementation name, and its associated XML schema.

Click the XML schema name link to view the schema document displayed in a separate window.

Note: An XML schema describes the structure of an XML document with all input and output message definitions and data types.

The following regions also appear on the service object details page:

Filter Data Object Information

The filer data object details page is accessible only from the getDataList method details page.

The following diagram illustrates the basic structure of the filter data object details page and its connections to related pages.

the picture is described in the document text

A filter data object is a type of service object. The general section of the filter data object page displays common information, plus the data object class name, implementation name, filter type, and its associated XML schema information.

Note: There are two types of filter:

For more information on filters, see Oracle Application Framework Developer's Guide, available from My Oracle Support Knowledge Document 1315485.1.

Click the XML schema name link to view the schema document displayed in a separate window.

The following regions also appear on the filter object details page:

Service Data Object Method Information

The type of information provided for filter data object methods is the same as for service data object methods. The data object method details page appears when you click a method name on the service data object details page or the filter data object details page.

In addition to a description, the following regions also appear on the service data object method details page:

Concurrent Program Information

The following diagram illustrates the basic structure of the concurrent program information page.

the picture is described in the document text

The concurrent program interface details page includes general section of a selected concurrent program, the Web Service region, and the Methods region.

For information on the general section, see common information.

Concurrent Program Interface Details Page

the picture is described in the document text

Web Service Region

The Web Service region contains interface or service information for a selected concurrent program. It includes SOAP service status, WSDL description, and authentication type information.

Please note that there is no Interaction Pattern table displayed for concurrent programs. This is because each concurrent program contains only one method, and this interface type can be service enabled only with synchronous operation. If a selected concurrent program is exposed as a Web service, the single method contained in the interface must be generated only with the support for synchronous pattern by default. 'Synchronous' is automatically displayed in this field.

For more information about Web Services, see

If a Web service has been successfully generated, the integration administrator can perform additional administrative tasks including deploying the generated service, regenerating the service if needed, or clearing up the generated service artifact which changes the Web Service Status field from 'Generated' to 'Not Generated'.

If a Web service has been successfully deployed as an active service in Oracle SOA Suite, the integration administrators can undeploy the active service, reset the deployed service to its initial state - 'Not Generated', retire the service so that it is no longer to accept new SOAP requests, or activate the retired service so that it can become active again.

For more information on these administrative tasks, see Performing Administrative Activities for SOAP Web Services.

Methods Region

The Methods region displays its associated method information.

Integration administrators can create security grants by authorizing the access permissions of selected methods to a user, a user group, or all users. See Managing Grants.

Note: Oracle Integration Repository does not support service enablement for Open Interface Tables and Views interface types. If a concurrent program is linked to Open Interface Tables or Views, this concurrent program will be viewed and displayed under the Open Interface category and cannot be service-enabled.

For more information about the Open Interface integration type, see Open Interface Information.

Open Interface Information

Open Interface integrations are always implemented using concurrent programs; therefore, Open Interface information is listed in a region on the concurrent program interface details page. The following diagram illustrates the basic structure of the Open Interface information and its connection to the related interface table or view information page.

the picture is described in the document text

After browsing through the interfaces with View by 'Open Interface', open interface tables and views are listed based on your selected product family. This type of interface stores the interface data, including active status, and whether it stores data inbound to Oracle E-Business Suite or outbound to another system.

Open Interface Table Information

The Open Interface details page appears when you click an Open Interface table name from the interface list table in the Integration Repository.

Open Interface Details Page

the picture is described in the document text

The general section of this page displays common information for the selected interface table.

Click a name link in the Open Interface Tables/Views region to display the selected Open Interface Table details page containing interface table columns and their attributes such as data type, data length, data precision, and data scale.

Interface View Information

The Open Interface View details page appears when you click an Open Interface view name from the interface list table in the Integration Repository.

Open Interface View Details Page

the picture is described in the document text

Similar to the interface details page for Open Interface Table, the open interface view details page contains a table listing the interface view columns and their attributes, including the data type, data length, data precision, and data scale for each view column.

For information on the general section, see common information.

EDI Message Information

Oracle E-Business Suite Integrated SOA Gateway does not support service enablement for EDI messages; therefore, the EDI interface details page contains only general interface information.

the picture is described in the document text

The EDI Message interface details page displays the message direction in the Direction field:

For more information on the general section, see common information.

Business Event Information

The general section of the Business Event displays common information for business event.

the picture is described in the document text

Only users who have the Integration Administrator role can perform the administrative tasks:

For more information about subscribing to business events, see Subscribing to Business Events, Oracle E-Business Suite Integrated SOA Gateway Implementation Guide.