Create Schedule Sheet Activities V2 from Oracle Primavera P6 XML

Support for SOAP is deprecated starting with Unifier 23.10.

Description

This method creates activities into an existing Unifier project/shell (cost code type CBS) level schedule sheet based on the data mapping parameter and schedule options provided as part of Web Service call.

Support

This method can only support creation of activities in project/shell (cost code type CBS) level schedule sheets.

Installation: ASP and Self host

Level Yes or No
Company Level No
Project/Shell Level Yes

Prototype

public XMLObject createScheduleActivitiesV2(String shortname, String authcode, String projectNumber, String sheetName, String sheetXML, String scheduleOptions);

Parameters

Parameter Description
Shortname Identifier of the company, company's short name
Authcode Authentication code for the company, in text string
projectNumber Identifier of a project/shell.
sheetName Name of Schedule Sheet to import activities into.
sheetXML Content of activities to import. This is obtained from the Primavera P5/P6 xml content. The Primavera XML content should be generated by exporting the full Primavera project.
scheduleOptions

This element will allow message to carry optional information. Following are the tags under this element:

  • <MapName/>
  • <ActivityIdentifier/>
  • <CBS_NoOfLevelsToMerge/>
  • <CBS_StartMergeFrom/>
MapName Name of the data mapping that should be used while processing an XML file. If there is no map name, the one marked "Default" in Unifier on the schedule sheet will be used.
ActivityIdentifier

Possible values are the globally unique identifier (GUID)or ID.

ID is the tag of Activity Id in Primavera. This tag will be used if you want to update an activity through udpateScheduleActivities web service call.

If Id tag is used for create and update, the value provided under Id tag will be used as task / activity identifier.
CBS_NoOfLevelsToMerge

This parameter will take a numeric value. This parameter can be used by user to specify how many levels (CBS Levels) in P6 XML file should be merged.

EXAMPLE: Assume that P6 has following structure: (5.ON.DA.DA03.F350.U11.095.ABC20.CAct04). If you specify 3, three levels will be merged and the 3 segments will be based on the next parameter (CBS_startmergefrom). Value of this parameter can be 0.
CBS_StartMergeFrom

This parameter will take a numeric value. Value of this parameter will be used to determine the level from which this merge should start.

EXAMPLE: In the above example, if a user specifies 2, the system will start from level 2 and merge ON, DA and DA03. So after the merge the CBS Code build by import program will be 5.ONDADA03.F350.U11.095.ABC20.CAct04. Value of this parameter can be 0.

Return Value

See Appendix B: Return Values.

Sample Method

createScheduleActivitiesV2("acme","acme_authcode","Proj-0001","Schedule Sheet 001", "<XML Content>","<scheduleoptions>");

Additional Information

You must perform appropriate data mapping setups on the target schedule sheet. This includes mapping Unifier Schedule Sheet columns to Primavera XML elements and setting appropriate XML Import options. Only elements that are mapped will be copied.

This method can only be used to create new activities not for updating existing activities.

If invoked on an empty schedule sheet, this method will insert activities into the schedule sheet. If invoked on a non-empty schedule sheet, it will overwrite all existing activities (delete and recreate) in the non-empty schedule sheet if this function is allowed in the data mapping setup.

If the method is called on a non-empty schedule sheet and the data mapping setup does not allow overwrite, the method will return an error in the response.

This service can be used for Projects/Shells of cost code type CBS.

  • Activity identified with this creation method can be GUID or ID
  • CBS Code will be derived automatically based on the XML file. For more information, see Associate CBS Codes with Activities.