XML Open Gateway (XOG) Development

ccppmop1593
HID_ref_xog
The XML Open Gateway (XOG) is a
Classic PPM
 web service interface that integrators and system administrators can use to import data, export data, and move configuration data from one system to another. The XOG uses XML and web services to perform these actions. Before you begin using the XOG, verify that you are familiar with XML code, web services, and
Classic PPM
.
Classic PPM
 web services are available on the same HTTP or HTTPS port as the HTML web browser interface. You can access a web service using one of these methods:
  • XOG client
    . Download the XOG client to your computer and use it to run the XOG.
  • Simple Object Access Protocol (SOAP)
    . Access and run the XOG directly using SOAP without using the XOG client.
    Classic PPM
     web services use XML messages that comply with the SOAP standard.
This content is only available in English.
XOG Client
The XOG client is a Java program that you can install on your computer and can use to import and export data using the XOG. The XOG client communicates with the
Classic PPM
 server on the standard HTTP port using the SOAP protocol. Using the client, you can perform these steps:
  • Log in to start an authenticated session.
  • Execute requests to read or write
    Classic PPM
     data.
  • Log out to end the session.
XOG Web Services
The following web services are available from the XOG API:
  • Object API
    . Includes all read and write services for objects for which the data can be imported or exported using the XOG.
  • InvokeAction API
    . Supports administrative actions that are beyond the categories of data import and export. This API includes the
    Process
    root element.
  • Query API
    . Supports the execution of NSQL-based queries from the XOG. You can use this API to select and export the information that you need from
    Classic PPM
    .
Web Services Descriptive Language (WSDL)
The Web Services Description Language (WSDL) describes the available XOG services and indicates how to communicate with them. WSDL is used with SOAP and the XML schema to provide web services over the Internet. You can connect to a web service and can read the appropriate WSDL file to learn what functions are available on the server.
Assign XOG Access Rights
Before you use the XOG client, you must have a valid
Classic PPM
 login name and password. You must also be assigned one of these access rights:
  • Administration - Access
  • Administration - XOG
Before a resource can use the XOG to import or export data for a particular object, assign them the XOG access right for that object. For example, you can assign the resource the
Asset - XOG Access
,
Project - XOG
Access, and
Resource - XOG Access
access right. You can grant the
Asset - XOG Access
right to a resource to support a custom
Classic PPM
 desktop application that needs asset information. The resource can import and export instance data that is associated with the asset object. However, the resource cannot import or export data on any other objects.
You can find XOG access rights (global rights) for objects in the access rights list in the Administration Tool, in addition to the other supported access rights.
Follow these steps:
  1. Open Administration, and from Organization and Access, click Resources.
  2. Click the resource last name.
  3. Open the Resource's Access Rights menu and click Global.
  4. Click Add.
  5. Enter
    *XOG Access
    in the Access Right field and click Filter.
  6. Select the appropriate XOG access rights and click Add.
The XOG access right is assigned to the resource.
Defects Fixed for XOG
DE60354 and DE55248: XOG has no Option to Update Default Resource OBS, Staff OBS Unit When Multiple Units have Same Name
Steps to Reproduce
  1. Create an OBS and associate it with the resource object.
  2. Create multiple units with the same name
  3. Try to update the default Staff OBS Unit/ Staff OBS Unit name by using XOG
Expected Results: You should be able to XOG to update the Staff OBS Unit name.
Actual Results: The Default Resource OBS Unit, Staff OBS Unit has only the unit name and XOG cannot identify the units if there are multiple units with the same name.
Fix Included: XOG now includes the defaultStaffOBSUnitPath attribute, where the user can give the whole path for the OBS Unit. If the user does not specify the defaultStaffOBSUnitPath attribute, the XOG will consider the defaultStaffOBSUnit attribute.