206520 p6 web services programming interface

An Introduction the P6 Web

Services Programming

InterfaceTanya Cranmer

Principal Technical Engineer


The following is intended to outline our general product direction. It is intended

for information purposes only, and may not be incorporated into any contract.

It is not a commitment to deliver any material, code, or functionality, and should

not be relied upon in making purchasing decisions. The development, release,

and timing of any features or functionality described for Oracle’s products remains

at the sole discretion of Oracle.


Program Agenda

P6 Web Services

P6 Event Notification

P6 Business Process Management (BPM) Integration

Q & A


P6 Web Services


P6 Web Services

P6 Web Services is an integration tool based on open standards such

as SOAP, XML and WSDL (Web Service Definition Language)

Web Services is platform and language independent

P6 Web Services can be used to

– Extend P6 functionality

– Create workflows

– Integrate with a wide variety of enterprise software applications running on

different hardware and operating system platforms

Overview


P6 Web Services

P6 EPPM Web Services are divided into four categories;

− Business Object Based Services - business object based services

provide create, read, update, and delete (CRUD) operations, depending on

the object

− Job Services – specialized operations like Scheduling

− Spread Service – services used to read time-phased unit and cost data

− Import and Export Services – services used to import and export projects

from and to XML

Overview


P6 Web Services

There are several layers of security

– Application security based on the P6 user name

– Transport layer security (SSL) for the SOAP messages

– Message level encryption which allows different parts of the SOAP

message to be encrypted

Overview


P6 Web Services

Client applications create a SOAP request message based on the

WSDL to the Web Services server

The Web Services server carries out the business operation and sends

back a SOAP response message

The client application reads the SOAP response and processes the

result

Process Flow


P6 Web ServicesProcess Flow

P6 Web Services deployed on Weblogic or Websphere

Client Application


P6 Web Services Sample WSDL


P6 Web Services Sample Java Code

private int createProject() throws Exception {

URL wsdlURL = new URL("http://localhost:8206/p6ws/services/ProjectService?wsdl");

ProjectService service = new ProjectService(wsdlURL);

ProjectPortType servicePort = service.getProjectPort();

Client client = ClientProxy.getClient(servicePort);

setCookieOrUserTokenData(client);

List<Project> projects = new ArrayList<Project>();

// Create project with required fields

Project proj = new Project();

proj.setParentEPSObjectId(3063);

proj.setId("WS-Demo");

proj.setName("WS-Demo");

projects.add(proj);

List<Integer> objIds = servicePort.createProjects(projects);

}


P6 Web Services Sample SOAP Request Message

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">

<SOAP-ENV:Header xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">

<wsse:Security xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd" SOAP-ENV:mustUnderstand="1">

<wsse:UsernameToken xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd" xmlns:wsu="http://docs.oasi

<wsse:Username>admin</wsse:Username>

<wsse:Password Type=“http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordText”>admin</wsse:Password>

</wsse:UsernameToken>

</wsse:Security>

</SOAP-ENV:Header>

<soap:Body>

<CreateProjects xmlns="http://xmlns.oracle.com/Primavera/P6/WS/Project/V2" xmlns:ns2="http://xmlns.oracle.com/Primavera/P6/WS/IntegrationFaultType/V1

<Project>

<Id>WS-Demo</Id>

<Name>WS-Demo</Name>

<ParentEPSObjectId>3063</ParentEPSObjectId>

</Project>

</CreateProjects>

</soap:Body>

</soap:Envelope>


P6 Web Services Sample SOAP Response Message

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">

<SOAP-ENV:Header>

</SOAP-ENV:Header>

<SOAP-ENV:Body>

<CreateProjectsResponse xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://xmlns.oracle.com/Primavera/P6/WS/Project/V2">

<ObjectId>5202</ObjectId>

</CreateProjectsResponse>

</SOAP-ENV:Body>

</SOAP-ENV:Envelope>


P6 Web Services

The Web Services installation includes a Java demo application

The demo application is starting point when using learning P6 Web

Services

Demo


P6 Web Services

Oracle Project Portfolio Management Integration Pack For

Primavera P6 and JD Edwards EnterpriseOne - prebuilt integration

between P6 and E1

Primavera Risk Analysis Connector – P6 and Risk Analysis

integration

Primavera Portfolio Management Bridge – P6 and PPM integration

Existing Primavera Integrations


P6 Web Services

P6 Event Notification - used to create a workflow between software

components or applications

Oracle Business Process Management (BPM) – used to create

workflows involving human interaction

Features which Leverage Web Services



P6 Web Access, P6 Web Services and the P6 Integration API can

be configured to send event messages to a message queue (JMS

Queue)

Events sent to the JMS Queue can be read by other applications

Events are triggered when Business Objects, like Activities or

Resources, are created or updated

Events are also triggered by Special Operations like Scheduling

Overview



Event messaging is a method of communication between software

components or applications

Allows multiple applications that are being built independently, with

different languages and platforms to communicate.

Messaging enables distributed communication that is loosely coupled

– the sender and the receiver do not have to be available at the same time in

order to communicate

– the sender and the receiver only need to know the message format

Messaging



External components subscribe to a queue and wait for event

messages to be published

Event messages that are sent from P6 can be used to trigger

actions in other external systems

Event messages contain a limited amount of data and

therefore Web Services is often used in conjunction with Event

Notification

Messaging


P6 Event Notification Messaging

P6 Web Access (JMS Producer) Weblogic

Queue

External Application (JMS Consumer)


Configuring Event Notification in P6

Modify the application configuration

– Launch the Administration Application

– Configure the JMS Provider information under Directory Services

– Set the “Database/Instance/Eventing/Enabled” setting to true

– Configure the connection information for the JMS queue

– Enable the Business Objects and Special Operations which will trigger

Events

Setup



47 Business Objects support create and update event notification

messages.

22 Special Operation events, like Scheduling, are triggered when the

operation terminates with a Completed, Failed, or Cancelled status

Refer to Using Events With P6 for detailed information

http://docs.oracle.com/cd/E25030_01/English/Integration_Docume

ntation/Event_Notification/Doc/index.htm

Setup


Configuring Event Notification in P6Setup



Test the Connection in the Primavera Administrator

Test the Connection by Adding a New Activity in P6 Web Access

Sample P6 Event Message

<?xml version="1.0" encoding="UTF-8"?>

<MessagingObjects xmlns="http://xmlns.oracle.com/Primavera/P6/V8.2/Common/Event"

xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">

<ActivityCreated>

<Id>A100</Id>

<Name>event test</Name>

<ObjectId>136850</ObjectId>

<ProjectObjectId>4798</ProjectObjectId>

<WBSObjectId>30356</WBSObjectId>

</ActivityCreated>

</MessagingObjects>

Demo


P6 Business Process Management (BPM) Integration


BPM Integration

Used for P6 Workflows

Provides an integrated environment for developing, administering, and

using business applications centered around business processes

Combination of human and machine-based tasks

Use Web Services to add P6 tasks to the Workflow

Overview


BPM Integration

Demo


Resources

Knowledge Base article Master Note For Primavera Web

Services Installation And Common Technical Or Application

Issues (Doc ID 1147896.1)

Knowledge Base article Event Notification Sample Code (Doc ID

1288173.1)

Primavera Advisor Webcast Schedule and Archived recordings

(Doc ID 1456251.1)

The Java EE 6 Tutorial

http://download.oracle.com/javaee/6/tutorial/doc/index.html

Chapter 47 “The Java Message Service Concepts”

http://download.oracle.com/javaee/6/tutorial/doc/index.html