Compile and Deploy the Taleo Connect Client SOAP Wrapper

Compile the SOAP wrapper, and then deploy it to Oracle Java Cloud Service.

After it’s deployed, the SOAP wrapper handles requests sent from Oracle Integration Cloud. The SOAP wrapper then invokes the Taleo Connect Client, installed on the same host, and starts an export or import job depending on the parameters passed with the request.

About the SOAP Wrapper

The SOAP wrapper is a web service, written in Java, that triggers export and import jobs in Oracle Taleo Enterprise Cloud Service.

After downloading the SOAP wrapper, open the project in NetBeans. Then update the Java code to reference the location of the Taleo Connect Client installation on the Oracle Java Cloud Service host.

You deploy the web service with the WebLogic Server Administration Console for your Oracle Java Cloud Service service instance.

You can control access to this service by applying an Oracle Web Services Manager (OWSM) policy after deployment. The sample SOAP wrapper is not protected by an OWSM policy, but it is recommended.

Before You Begin with the SOAP Wrapper

Before you begin with the SOAP wrapper, install NetBeans and download the SOAP wrapper sample code.

  1. Install the latest version of the NetBeans IDE (with the Java Platform, Enterprise Edition bundle).

  2. Download the sample code for this solution.

  3. Extract the contents of the archive file.

  4. If your Oracle Java Cloud Service instance is deployed to Oracle Cloud Infrastructure Classic, you may need to enable access to the WebLogic Server Administration Console. Access to the console is enabled by default on instances deployed to Oracle Cloud Infrastructure.

Import the SOAP Wrapper NetBeans Project

Import the SOAP wrapper project into NetBeans, and resolve the library dependencies.

  1. In NetBeans, click Open Project.
  2. Go to the directory where you extracted the sample code archive. Drill down through the java and jcs directories. Click the TCCClient project folder, and then click Open Project.
  3. When the Project Problems dialog is displayed , click Resolve Problems.
  4. Select the commons-logging-1.2.jar line, and click Resolve.
  5. Go to the directory where you installed the Taleo Connect Client on Windows (for example, C:\Taleo Connect Client). Drill down through the lib and endorsed directories. Select the commons-logging-1.1.1.jar file, or the version of this library included with your Taleo Connect Client installation and click Open.
  6. Select the log4j-1.2.17.jar line, and click Resolve.
  7. Go to the directory where you installed the Taleo Connect Client on Windows (for example, C:\Taleo Connect Client). Drill down through the lib and endorsed directories. Select the log4j-1.2.15.jar file, or the version of this library included with your Taleo Connect Client installation, and click Open.

Update the Java Code and Build the Project

Update the Java source to reference the location of the script that invokes the Taleo Connect Client on the Oracle Java Cloud Service host. Then, build the SOAP wrapper project.

  1. In NetBeans, open the tccClient.java file.
  2. Change the value of the cmd string in the runTccJoB method to reference the location of the client.sh script that you created on the Oracle Java Cloud Service host: String cmd = "/home/tcc/tcc/scripts/client.sh " + strJobLocation;
  3. From the Projects tab, right-click the TCCClient project, and select Build.

Deploy an Application Using the WebLogic Server Administration Console

You can use the WebLogic Server Administration Console to deploy applications to an Oracle Java Cloud Service instance.

  1. Sign in to the web console.
  2. Find the name of the instance that you want to deploy an application to.
  3. Expand the Manage this instance menu, then select Open WebLogic Server Console.
  4. Sign in using the credentials that you specified when you created the Oracle Java Cloud Service instance.
  5. In the Change Center of the WebLogic Server Administration Console, click Lock & Edit if that button is enabled.
  6. Under Domain Structure, select Deployments.
  7. On the Deployments page, click Install.
  8. On the Install page, click the Upload your file(s) link. This link is in the text just above the Path field.
  9. In the Install Application Assistant, click Browse next to Deployment Archive, select the application you want to deploy, and click Next.
  10. Under Locate deployment to install and prepare for deployment, select the application if it isn’t already selected, and click Next.
  11. Under Choose installation type and scope, select application, and click Next.
  12. Under Select deployment targets, select the servers or clusters that you want to deploy the application to, and click Next.
  13. Review the configuration settings that you specified, and click Finish.
  14. In the Change Center, click Activate Changes.

Start an Application Using the WebLogic Server Administration Console

You must start the application to make it ready to accept requests.

  1. Sign in to the web console.
  2. Look for the name of the instance on which you want to start an application.
  3. Click Manage this service Menu icon, and select Open WebLogic Server Console.
  4. Sign in using credentials you specified when you created the Oracle Java Cloud Service instance.
    If you did not create the service instance, ask your administrator for the login credentials.
  5. In the Change Center of the WebLogic Server Administration Console, click Lock & Edit.
  6. Under Domain Structure, select Deployments.
  7. Click the Control tab.
  8. In the Deployments table, select the check box next to the application that you want to start.
  9. Click Start, and select Servicing all requests.
  10. On the Start Deployments dialog, click Yes to confirm the deployment.
    The application is now in the Active state and is ready to accept requests.

Create a Security List

Create a security list to control traffic into and out of your service instance that’s deployed on Oracle Cloud Infrastructure.

Note:

This task applies only for Oracle Java Cloud Service instances deployed on Oracle Cloud Infrastructure. See Creating an Access Rule in Administering Oracle Java Cloud Service if your Oracle Java Cloud Service is deployed to Oracle Cloud Infrastructure Classic.

  1. Ensure that you're viewing the compartment that contains the cloud network that you want to add the security list to. If you just created the cloud network, then you should still be viewing the same compartment. Click Networking, and then click Virtual Cloud Networks. You should see the cloud network.
  2. On the Virtual Cloud Networks page, click the cloud network that you're interested in.
  3. Click Security Lists,and then click Create Security List.
  4. Specify the compartment where you want to create the security list, if it’s different from the compartment you're working in.
  5. Give the security list a user friendly name.
  6. Create a stateful ingress rule to allow traffic from the public internet using TCP on port 9073.

    This allows traffic from the public internet to invoke the SOAP wrapper.

  7. When you're done, click Create Security List.