If a SOAP service has been generated successfully, the administrator has the privilege to deploy the generated service in the Web Service region or the SOAP Web Service tab if the interface can be exposed as both SOAP and REST services.

Deploying Web Services with Authentication Types

Prior to deploying a SOAP Web service, the administrator must first select one of the following authentication types:

• Username Token

  This authentication type provides username and password in the security header for a Web service provider to use in authenticating the users. It is the concept of Oracle E-Business Suite username/password (or the username/password created through the Users window in defining an application user).

• SAML Token (Sender Vouches)

  This authentication type is used for Web services relying on sending a username only through SAML Assertion.

Deployment with Active State

Once a SOAP Web service has been successfully deployed, the newly deployed service has 'Deployed with Active' service status in Oracle SOA Suite where Oracle E-Business Suite services can be used at run time.

The Web Service region (or the SOAP Web Service tab for the interface with the support for both SOAP and REST services) has the following changes:

• The service status is changed from 'Generated' to 'Deployed' with 'Active' state indicating that the deployed service is ready to be invoked and accept new SOAP requests.

• The selected authentication type is displayed.

• Click the View WSDL link to display the deployed WSDL information. It shows the physical location of service endpoint where the service is hosted in soa-infra.

• The following buttons appear if the service has been successfully deployed with 'Active' state:

  • Retire: It disables the active service. The service status is changed to 'Deployed' with 'Retired' state indicating that this deployed service will no longer accept new requests. It also ensures that current running requests are finished.

    Once the service has been successfully retired, the Activate button appears allowing you to activate the retired service. For more information on retiring and activating Web services, see:

    • Retiring SOAP Web Services

    • Activating SOAP Web Services

• Undeploy: It undeploys the Web service from Oracle SOA Suite back to Oracle Integration Repository. Deployed services can be undeployed with the following reasons:

  • Changes on an interface definition for a deployed service.

  • Changes on interaction pattern for a deployed service.

  • Changes on the Authentication Type field for a deployed service.

  • The original service was corrupt.

  After undeploying the service, make desired changes first (such as interaction pattern or authentication type). Next, regenerate the service, and then deploy the service again.

• Reset: It clears up the deployed service artifact and changes the service status from 'Deployed' with 'Active' to 'Not Generated'.

  For more information, see Resetting SOAP Web Services.

For more information on service generation, see Generating SOAP Web Services.

For more information on supported authentication types, see Managing Web Service Security.

Reviewing Deployed WSDL

To view the deployed Web service, click the View WSDL link. The following example shows the deployed WSDL code:

<definitions name="ECRDTLD" targetNamespace="http://xmlns.oracle.com/apps/ec/soaprovider/concurrentprogram/ecrdtld/">
<documentation> 
 <abstractWSDL>
   http://<hostname>:<port>/soa-infra/services/default/<jndi_name>_CONCURRENTPROGRAM_ECRDTLD!1/ECRDTLD_soap.wsdl
</abstractWSDL>
</documentation>
<types>
   <schema elementFormDefault="qualified" targetNamespace=http://xmlns.oracle.com/apps/ec/soaprovider/concurrentprogram/ecrdtld/">
  <include schemaLocation="http://<hostname>:<port>/soa-infra/services/default/<jndi_name>_CONCURRENTPROGRAM_ECRDTLD/ECRDTLD_Service/?XSD=APPS_ISG_CP_REQUEST_CP_SUBMIT.xsd"/> 
   </schema>
   <schema elementFormDefault="qualified" targetNamespace="http://xmlns.oracle.com/apps/ec/soaprovider/concurrentprogram/ecrdtld/"> 
  <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>
</types>
<message name="ECRDTLD_Input_Msg">
   <part name="header" element="tns1:SOAHeader"/>
   <part name="body" element="tns1:InputParameters"/>
</message>
<message name="ECRDTLD_Output_Msg">
   <part name="body" element="tns1:OutputParameters"/>
</message>
<portType name="ECRDTLD_PortType">
   <operation name="ECRDTLD">
     <input message="tns1:ECRDTLD_Input_Msg"/>
     <output message="tns1:ECRDTLD_Output_Msg"/>
   </operation>
 </portType>
<binding name="ECRDTLD_Binding" type="tns1:ECRDTLD_PortType">
  <soap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http"/>
  <operation name="ECRDTLD">
   <soap:operation soapAction="ECRDTLD"/>
     <input>
       <soap:header message="tns1:ECRDTLD_Input_Msg" part="header" use="literal"/>
       <oap:body use="literal" parts="body"/>
     </input>
     <output>
       <soap:body use="literal"/>
     </output>
   </operation>
  </binging>
  <service name="ECRDTLD_Service">
    <port name="ECRDTLD_Port" binding="tns1:ECRDTLD_Binding">
     <soap:address location="http://<hostname>:<port>/soa-infra/services/default/<jndi_name>_CONCURRENTPROGRAM_ECRDTLD/ECRDTLD_Service/"/>
   </port>
 </service>
</definitions>

To deploy or undeploy a Web service:

1. Log in to Oracle E-Business Suite as a user who has the Integration Administrator role. Select the Integrated SOA Gateway responsibility and the Integration Repository link.

2. In the Integration Repository tab, select 'Interface Type' from the View By drop-down list.

3. Expand an interface type node to locate your desired interface definition.

4. Click the interface definition name link to open the interface details page.

5. From the Web Service region (or the SOAP Web Service tab), select one of the following authentication types:

   • Username Token

   • SAML Token (Sender Vouches)

6. Click Deploy to deploy the service with active state to an Oracle SOA Suite WebLogic environment.

7. Click the deployed View WSDL link to view the deployed WSDL description.

8. Click Undeploy to undeploy the service.

9. If a service has been deployed with active state, Retire appears lets you disable the active service so that it will no longer accept new requests.

10. Click Reset to clear up the existing service artifact.