206520 p6 web services programming interface

An Introduction the P6 Web
Services Programming
Interface
Tanya 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 Services
Process 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:Passw
</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
<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 Event Notification

 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

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

Setup

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”

206520 p6 web services programming interface

Recommandé

Recommandé

Contenu connexe

Tendances

Tendances (20)

Similaire à 206520 p6 web services programming interface

Similaire à 206520 p6 web services programming interface (20)

Plus de p6academy

Plus de p6academy (20)

Dernier

Dernier (20)

206520 p6 web services programming interface