Description
This option will allow user to process a P6 XML file and add and update activities and resources to a Unifier schedule sheet. Along with activity information this process will also take activity spread information.
Support
Installation: ASP and Self host
Level | Yes or No |
---|---|
Company Level | No |
Project and Shell Level | Yes |
Prototype
public XMLObject updateScheduleActivitiesFromFileV2(String shortname, String authcode, String projectNumber, String sheetname, String scheduleoptions, String iszipfile, FileObject[] files);
Parameters
Parameter | Description |
---|---|
Shortname | identifier of the company, company’s short name |
Authcode | authentication key for the company, in text string |
projectNumber | Identifier of the project or shell in Unifier. |
sheetName | Identify the name of the schedule sheet in Primavera Unifier |
iszipfile | This tag identifies if the file provided under files tag is a zip file or .xml file with just activity and resource information. If user wants to send activity spread information then the value of this tag should be yes and the file provided under files tag should be a zip file containing both activity and resource information and the spread information. |
files | FileObject containing the Activity / Resource information and the activity spread information. FileObject is made up of two components |
scheduleOptions | This element will allow message to carry optional information. Following are the tags under this element <MapName/> <ActivityIdentifier/> <CBS_NoOfLevelsToMerge/> <CBS_StartMergeFrom/> <ActivityDeletion> <ActivityFileName> <SpreadFileName> |
MapName | Name of the data mapping that should be used while processing XML file |
ActivityIdentifier | Possible values are GUID, ID. ID is the tag of Activity Id in Primavera. |
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 together.
If you specify 3 then two levels will be merged together. But which 3 segments will be based on the next parameter (CBS_startmergefrom) |
CBS_StartMergeFrom |
|
ActivityDeletion | This tag will allow user to determine if the activities that does not exists in P6 should be deleted from Unifier schedule sheet. Possible values are Auto / Confirm. |
ActivityFileName | Name of the file that contains the activity and resource information. Please refer to files tag |
SpreadFileName | Name of the activity spread file name. Please refer to files tag |
Return Value
See Return Values.
Sample Method
updateScheduleActivitiesFromFileV2 ("acme","acme_authcode","Proj-0001","Schedule Sheet 001", "<XML Content>","yes","<scheduleoptions>",files);
Additional Information
ActivityDeletion tag logic is based on the "Delete Activity" checkbox available on data mapping window in Unifier. Following is the logic for this tag
Delete Checkbox | Activity Deletion | Behavior |
---|---|---|
Unchecked | Auto or Confirm | Activity Deletion tag is ignored. Activities that are removed under source schedule will not be removed from Unifier Schedule Sheet |
Checked | Auto | Activity Deletion tag is considered Activities that are removed under source schedule will be deleted automatically under Unifier Schedule Sheet. |
Checked | Confirm | Activity Deletion tag is considered Activities that are removed under source schedule will not be deleted. System will return an error and will not update Primavera Unifier schedule sheet. If no activities are removed under source schedule then system will update Unifier Schedule Sheet. |
ActivityDeletion tags are only considered for updateScheduleSheetFromFileV2 service and not for create.
While processing spread information, Unifier will only look for "" tag.
If the Import from external source option is checked in Unifier and spread information is not available in XML file then system will error out. This error condition is also valid when this tag is not available in the XML file.
Activity File should start and end with <List_Wrapper> tag
Spread file should not contain any <List_Wrapper> tag