Share via

PDS Extensions

  • Article

The ERP Connector Solution Starter for Microsoft Office Project Server 2003 includes the source code and compiled assemblies (DLLs) for four Project Data Service (PDS) extensions. The PDS extensions are implemented using the procedures and base classes described in the technical article Creating a Managed Code PDS Extension for Project Server 2003.

The mySAP™ ERP system puts a PDS request file in the drop folder for the Service for Enterprise Data Maintenance (EDM). The Service for EDM identifies the file as a PDS command and forwards the command to the PDS. The PDS then determines the request is not a built-in method and delegates the request to the registered PDS extension for the ERP Connector. The PDS request file contains the following general XML structure.

<Request>
   <ERP Connector PDS Extension>
      <Data>
         . . .
      </Data>
   </ERP Connector PDS Extension>
</Request>

The ERP Connector Solution Starter includes five PDS extensions that you can install on Project Server. Each of the three main extensions that are responsible for the HR, Finance Projects, and Finance WBS modules logs transactions for that module in the Windows event log.

The following topics include the XML syntax and parameters, and describe the implementation classes for the PDS extensions.

  • ProcessHRDataSAP is the main PDS extension for integration with mySAP ERP Human Capital Management. It handles all of the processes that maintain the HR data received from mySAP ERP for Project Server. The source code is in the HRModule project.
  • ProjectCreateSAP is the main PDS extension for integration with mySAP ERP Financials CO and PS subsystems; it creates projects from mySAP ERP data. The source code is in the SAPCOPDSExtender project. ProjectCreateSAP also calls EnterpriseCustomFieldValueUpdate.
  • EnterpriseCustomFieldValueUpdate updates enterprise project and task fields with resource breakdown structure (RBS) data from mySAP ERP Financials. This PDS extension is independent from the ERP Connector functions, so you can use it in other applications to modify custom fields. Source code is in the EnterpriseCustomFieldPDSExtender project.
  • GetActualsSAP and GetEnterpriseTaskFieldValue: GetActualsSAP is the primary PDS extension for exporting work actuals to mySAP ERP Financials. It gets the approved actual work values from Project Server and creates an XML file for mySAP ERP. GetActualsSAP also calls the GetEnterpriseTaskFieldValue PDS extension, which is implemented in the same SAPFIPDSExtender project. That is, the compiled SAPFIPDSExtender.dll assembly includes both PDS extensions.

Additional Developer Documentation

The ERP Connector download includes additional HTML Help files that document the namespaces, classes, and class members, including properties, methods, and fields of the PDS extensions. The developer documentation is in the download directory Source\AdditionalDocumentation. The Source\AdditionalDocumentation\HTMLHelpSource subdirectory includes all of the HTML and related source files that you need to generate the .chm files with the HTML Help Workshop (version 4.74). For more information, see Microsoft HTML Help 1.4 SDK.

Following are the HTML Help files for developer documentation.

  • SAPConnector Configuration Documentation.chm covers the Configuration class used by the ERP Connector administration page and by most PDS extensions.
  • SAPConnector HRModule Documentation.chm covers the Extender class, and all of the classes in the Project.SolutionStarter.SAP.HR namespace for the ProcessHRDataSAP PDS extension.
  • SAPConnector Project Import CO-PS Documentation.chm covers all of the classes in the Project.SolutionStarter.SAP.CO namespace for the ProjectCreateSAP PDS extension, as well as the PDS class for the PDS Web service.
  • SAPConnector FIPDSExtender Documentation.chm covers all of the classes in the Project.SolutionStarter.SAP.FI namespace for the GetActualsSAP and GetEnterpriseTaskFieldValue PDS extensions.