Functionality
With the Maintain BAPI of the WorkBreakdownStruct business object youcan edit the objects of a project definition. You can also use all thefunctions of the Maintain BAPI of the Network business object.
For more information, see Network.Maintain. WithWorkBreakdownStruct.Maintain it is possible to edit the projectdefinition, its WBS elements and their hierarchical relationships. TheBAPI encapsulates a complete transaction in itself. As a result, severaloperations on project elements can be processed by only one call. TheProject System determines in which order the operations are to beexecuted on the objects. The caller can choose the operations in anyorder.
As a result, processing is very speedy and effective. However, thistransaction concept does not include the use and combination of otherSAP BAPIs in the same LUW.

Procedure
The WorkBreakdownStruct business object is a facade of the projectdefinition for WBS elements and their hierarchy.
To edit a project object, enter a command for an object type. Inaddition, enter the object key and a reference to its attributes.
In the table of the IMethodProject parameter enter the object type, thecommand and the object key. As a reference enter the index of the objectdata table of the relevant object type. In the object data table enterthe information about the object. If necessary, use an update structurefor the object. When entering the object type and method in theIMethodProject table remember that the entries are case-sensitive.
To finish the transaction and store the data in the database, enter theSave command. If you only want to test whether the changes can becarried out, do not use the save command.
In general, you cannot change the keys of objects.
The return parameter Return indicates whether errors occurred duringprocessing. After the call you find the error messages created duringprocessing in the EmessageTable table.

Commands of the Object Types
For the description of the object types Network, NetworkActivity,NetworkActivityElement, ActivityMilestone, and NetworkRelation, seeNetwork.Maintain.

Object type: Project definition
The Maintain BAPI must always refer to one project definition.Therefore, always enter the structure of a project definition in theIProjectDefinition parameter. Use the project definition as a key. Thereference to the data part is always 1. Always enter the projectdefinition in upper case.
Command: Create
Enter the project definition and the project profile. The projectprofile must exist in the Project System.
&EXAMPLE& - Create a Project Definition in the Project System

• IMethodProject

OBJECTTYPE = ProjectDefinition
METHOD = Create
OBJECTKEY = PD-TRAINING
REFNUMBER = 000001
OBJECTTYPE =
METHOD = Save
OBJECTKEY =
REFNUMBER =

• IProjectDefinition

PROJECT_DEFINITION = PD-TRAINING
DESCRIPTION = Training project
PROJECT_PROFILE = PPRO001
Command: Update
Use this command to change a project definition that already exists inthe Project System. If you enter an update structure you can changeindividual fields without having to specify the other fields.
&EXAMPLE& - Changing the description of a project definition (Onlythe description is changed.)

• IMethodProject

OBJECTTYPE = ProjectDefinition
METHOD = Update
OBJECTKEY = PD-TRAINING
REFNUMBER = 000001
OBJECTTYPE =
METHOD = Save
OBJECTKEY =
REFNUMBER =

• IProjectDefinition

PROJECT_DEFINITION = PD-TRAINING
DESCRIPTION = Training project
IProjectDefinitionUp
PROJECT_DEFINITION =
DESCRIPTION = X
Command: Lock (from Release 4.6A)
Use this command to lock a project definition. The "Master data locked"system status is set for the project definition.
LS>&EXAMPLE& - Locking the project definition PD-TRAINING

• IMethodProject

OBJECTTYPE = ProjectDefinition
METHOD = Lock
OBJECTKEY = PD-TRAINING
REFNUMBER = 000001
OBJECTTYPE =
METHOD = Save
OBJECTKEY =
REFNUMBER =

• IProjectDefinition

PROJECT_DEFINITION = PD-TRAINING
Command: Unlock (from Release 4.6A)
Use this command to unlock the project definition. The "Master datalocked" system status is removed from the project definition.
&EXAMPLE& - Unlocking the project defintion PD-TRAINING

• IMethodProject

OBJECTTYPE = ProjectDefinition
METHOD = Unlock
OBJECTKEY = PD-TRAINING
REFNUMBER = 000001
OBJECTTYPE =
METHOD = Save
OBJECTKEY =
REFNUMBER =

• IProjectDefinition

PROJECT_DEFINITION = PD-TRAINING
Command: Release (from Release 4.5A)
Releasing a project. The system status "released" is set for theproject definition and all WBS elements.
&EXAMPLE& - Releasing the project definition PD-TRAINING

• IMethodProject

OBJECTTYPE = ProjectDefinition
METHOD = Release
OBJECTKEY = PD-TRAINING
REFNUMBER =
OBJECTTYPE =
METHOD = Save
OBJECTKEY =
REFNUMBER =

• IProjectDefinition

PROJECT_DEFINITION = PD-TRAINING

Object type: WBS element
You can edit all WBS elements of a project definition. The name and keyof the WBS element are identical.
Enter the WBS element in uppercase.
Command: Create
&EXAMPLE& - Creating a WBS element for the project definition.Creating three WBS elements TRAINING, TRAINING.1 and TRAINING.2 forproject definition PD-TRAINING


• IMethodProject

OBJECTTYPE = WBS-Element
METHOD = Create
OBJECTKEY = TRAINING
REFNUMBER = 000001
OBJECTTYPE = WBS-Element
METHOD = Create
OBJECTKEY = TRAINING.1
REFNUMBER = 000002
OBJECTTYPE = WBS element
METHOD = Create
OBJECTKEY = TRAINING.2
REFNUMBER = 000003
OBJECTTYPE =
METHOD = Save
OBJECTKEY =
REFNUMBER =

• IProjectDefinition

PROJECT_DEFINITION = PD-TRAINING
IWbsElementTable
Index = 1
WBS_ELEMENT = TRAINING
PROJECT_DEFINITION = PD-TRAINING
DESCRIPTION = Whole project
Index = 2
WBS_ELEMENT = TRAINING.1
PROJECT_DEFINITION = PD-TRAINING
DESCRIPTION = Preparation
Index = 3
WBS_ELEMENT = TRAINING.2
PROJECT_DEFINITION = PD-TRAINING
DESCRIPTION = Execution

Command: Update
Use this command to change a WBS element that already exists in theProject System. If you enter an update structure, you can changeindividual fields without having to specify the other fields.
&EXAMPLE& - Changing the description of the WBS element TRAINING.1for the project definition PD TRAINING


• IMethodProject

OBJECTTYPE = WBS element
METHOD = Update
OBJECTKEY = TRAINING.1
REFNUMBER = 000001
OBJECTTYPE =
METHOD = Save
OBJECTKEY =
REFNUMBER =

• IProjectDefinition

PROJECT_DEFINITION = PD-TRAINING

• IWbsElementTable

Index = 1
WBS_ELEMENT = TRAINING.1
PROJECT_DEFINITION = PD-TRAINING
DESCRIPTION = Preparation and documentation

• IWbsElementTableUpdate

Index = 1
WBS_ELEMENT =
PROJECT_DEFINITION =
DESCRIPTION = X
Command: Delete
Use this command to delete a WBS element that already exists in theProject System. The WBS element receives the "Deletion flag" systemstatus and is not deleted physically. You cannot create a new WBSelement with the same key.
&EXAMPLE& - Deleting the WBS element TRAINING.2 for the project PD
TRAINING

• IMethodProject

OBJECTTYPE = WBS element
METHOD = Delete
OBJECTKEY = TRAINING.2
REFNUMBER = 000001
OBJECTTYPE =
METHOD = Save
OBJECTKEY =
REFNUMBER =

• IProjectDefinition

PROJECT_DEFINITION = PD-TRAINING
IWbsElementTable
Index = 1
WBS_ELEMENT = TRAINING.2
PROJECT_DEFINITION = PD-TRAINING
Command: Lock (from Release 4.6A)
Use this command to lock a WBS element. The "Master data lock" systemstatus is set for the WBS element.
&EXAMPLE& - Locking the WBS element TRAINING.1

• IMethodProject

OBJECTTYPE = WBS-Element
METHOD = Lock
OBJECTKEY = TRAINING.1
REFNUMBER = 000001
OBJECTTYPE =
METHOD = Save
OBJECTKEY =
REFNUMBER =

• IProjectDefinition

PROJECT_DEFINITION = PD-TRAINING

• IWbsElementTable

Index = 1
WBS_ELEMENT = TRAINING.1
Command: Unlock (from Release 4.6A)
Use this command to unlock a WBS element. The "Master data lock" systemstatus is removed from a WBS element.
&EXAMPLE& - Unlocking the WBS element TRAINING.1

• IMethodProjectIMethodProject

OBJECTTYPE = WBS-Element
METHOD = Unlock
OBJECTKEY = TRAINING.1
REFNUMBER = 000001
OBJECTTYPE =
METHOD = Save
OBJECTKEY =
REFNUMBER =

• IProjectDefinition

PROJECT_DEFINITION = PD-TRAINING
IWbsElementTable
Index = 1
WBS_ELEMENT = TRAINING.1
Command: Release (from Release 4.5A)
Releasing a WBS element. The system status "Released" is set for theWBS element and all lower-level WBS elements.
&EXAMPLE& - Releasing the WBS element TRAINING.1

• IMethodProject

OBJECTTYPE = WBS-Element
METHOD = Release
OBJECTKEY = TRAINING.1
REFNUMBER = 000001
OBJECTTYPE =
METHOD = Save
OBJECTKEY =
REFNUMBER =

• IProjectDefinition

PROJECT_DEFINITION = PD-TRAINING

• IWbsElementTable

Index = 1
WBS_ELEMENT = TRAINING.1

Object type: WBS milestone (from Release 4.6A)
The key for the object WBS milestone is the milestone number.
Command: Create
Use this command to create a new WBS milestone for a network. It is notnecessary to enter a number for the milestone. The system gives themilestone a number when it is created. The system returns the milestonein the message table as an information message.
If however, an external number is entered in the method table, both theexternal and the new milestone number are returned in an information amessage in the message table. A WBS element always has to be entered.
&EXAMPLE& - Creating a new WBS milestone for a WBS elementTRAINING.2


• IMethodProject

OBJECTTYPE = WBS milestone
METHOD = Create
OBJECTKEY =
REFNUMBER = 000001
OBJECTTYPE =
METHOD = Save
OBJECTKEY =
REFNUMBER =

• IWbsMilestoneTable

Index = 1
MILESTONE_NUMBER =
WBS_ELEMENT = TRAINING.2
Command: Update
Use this command to change a WBS element that already exists in theProject System. It is always necessary to enter the project definition,if you do not explicitly change the project definition. Use the updatestructure as for WBS elements.
&EXAMPLE& - Changing an existing WBS milestone with the number000000002098 assigned to WBS element TRAINING.2.

• IMethodProject

OBJECTTYPE = WBS milestone
METHOD = Update
OBJECTKEY = 000000002098
REFNUMBER = 000001
OBJECTTYPE =
METHOD = Save
OBJECTKEY =
REFNUMBER =

• IWbsMilestoneTable

Index = 1
MILESTONE_NUMBER = 000000002098
DESCRIPTION = Milestone description changed
WBS_ELEMENT = TRAINING.2

• IWbsMilestoneTableUp

MILESTONE_NUMBER =
DESCRIPTION = X
WBS_ELEMENT =
Command: Delete
Use this command to delete a WBS milestone that already exists in theProject System. The milestone is deleted physically. It is alwaysnecessary to enter the project definition, if you do not explicitlychange the project definition.
&EXAMPLE& - Deleting a WBS element with the number 000000002098assigned to WBS element TRAINING.2.

• IMethodProject

OBJECTTYPE = WBS milestone
METHOD = Delete
OBJECTKEY = 000000002098
REFNUMBER = 000001
OBJECTTYPE =
METHOD = Save
OBJECTKEY =
REFNUMBER =

• IWbsMilestoneTable

MILESTONE_NUMBER = 000000002098
WBS_ELEMENT = TRAINING.2

Object type: WBS hierarchy
The WBS hierarchy object type defines the hierarchy of the WBS elements.A project definition always has exactly one hierarchy. If the positionof a WBS element changes, the whole hierarchy has to be rebuilt.Therefore, the WBS hierarchy object type has only one command: Create.Every WBS element receives exactly one entry in the table parameterIWbsHierarchieTable with which it defines its position.
Command: Create
Use this command to create or change a WBS element hierarchy for aproject definition. Enter the WBS hierarchy object type and the Createcommand in the table of the IMethodProject parameter. The command refersto all entries in the table of the IWbsHierarchieTable parameter thatcontains the data for the data for the hierarchy. Each entry in theIWbsHierarchieTable refers to a WBS element that describes its positionrelative to the other WBS elements.
&EXAMPLE& - Positioning WBS elements TRAINING , TRAINING.1 andTRAINING.2 . (WBS elements TRAINING.1 and TRAINING.2 are subordinate toWBS element TRAINING. WBS element TRAINING1 is positioned on the left ofTRAINING.2.)


• IMethodProject

OBJECTTYPE = WBS Hierarchy
METHOD = Create
OBJECTKEY =
REFNUMBER =
OBJECTTYPE =
METHOD = Save
OBJECTKEY =
REFNUMBER = I

• ProjectDefinition

PROJECT_DEFINITION = PD-TRAINING

• IWbsHierarchieTable

WBS_ELEMENT = TRAINING
PROJECT_DEFINITION = PD-TRAINING
UP =
DOWN = TRAINING.1
LEFT =
RIGHT =
WBS_ELEMENT = TRAINING.1
PROJECT_DEFINITION = PD-TRAINING
UP = TRAINING
DOWN =
LEFT =
RIGHT = TRAINING.2
WBS_ELEMENT = TRAINING.2
PROJECT_DEFINITION = PD-TRAINING
UP = TRAINING
DOWN =
LEFT = TRAINING.1
RIGHT =

Further information
For more information, see the SAP Library under PS Project System ->Structures -> EPS Interface

Description
Return code with error messages

Value range
If errors occur the following message is returned:
Type ID Number Message


• E CJ 036 The project could not be saved

(see error log)
In this case see the E_MESSAGE_TABLE table for more informationabout the cause of the error.

Description
In this structure the changed project definition data is transfered.

Value range
For every field in the structure to be changed, you must enter acharacter in the corresponding field in theI_PROJECT_DEFINITION_UPD structure.
For currency and the time unit you can either use the internal SAP name(PROJECT_CURRENCY or TIME_UNIT) or the ISO code (PROJECT_CURRENCY_ISOor TIME_UNIT_ISO).
PROJECT_DEFINITION,,Project definition
DESCRIPTION,,PS: Description (first text line)
MASK_ID,,Editing mask f.short ID WBS elements
RESPONSIBLE_NO,,Number of person responsible (projectmanager)
APPLICANT_NO,,Applicant number
COMP_CODE,,Company code
BUS_AREA,,Business area
CONTROLLING_AREA,,Controlling area
PROFIT_CTR,,Profit Center
PROJECT_CURRENCY,,WBS currency (project definition)
PROJECT_CURRENCY_ISO,,ISO code currency
NETWORK_ASSIGNMENT,,Network assignment
START,,Planned start date for project
FINISH,,Planned finish date for project
PLANT,,Plant
CALENDAR,,Factory calendar key
PLAN_BASIC,,Planning method for basic dates inproject
PLAN_FCST,,Planning method for forecast dates inproject
TIME_UNIT,,Time unit f. scheduling
TIME_UNIT_ISO,,ISO code f. unit of measure
NETWORK_PROFILE,,Network profile
PROJECT_PROFILE,,Project profile
BUDGET_PROFILE,,Budget profile
PROJECT_STOCK,,Project stock
OBJECTCLASS,,Object class
STATISTICAL,,Statistical WBS element (X)
TAXJURCODE,,Tax Jurisdiction Code
INT_PROFILE,,Interest profile for projects
WBS_SCHED_PROFILE,,Scheduling profile for WBS
CSH_BDGT_PROFILE,,Finazial budget profile
PLAN_PROFILE,,Planning profile

Description
In this structure (I_PROJECT_DEFINITION_UPD) you enter whichfields in the I_PROJECT_DEFINITION structure, that is whichproject definition data, are transfered to the system and canconsequently be changed.

Value range
For every field in the I_PROJECT_DEFINITION structure that youwant to change, enter a character (for instance 'x') in thecorresponding field in the I_PROJECT_DEFINITION_UPD structure.
The table must also contain enetries for freshly created WBS elements.Description
If errors occur while changing a project, for instance in theconsistency checks or due to missing authorization, the method, theobject and the error message are output to this table.

Table structure
Method,,Data type CHAR,,Field length 32
Object type,,Data type CHAR,,Field length 32
SAP internal object key,,Data type CHAR,,Field length 90
SAP external object key,,Data type CHAR,,Field length 90
Message ID,,Data type CHAR,,Field length 20
Message number,,Data type CHAR,,Field length 3
Message type,,Data type CHAR,,Field length 1
Message text,,Data type CHAR,,Field length 72

Description
You transfer detailed information about network activities in thisstructure.
You have to enter a character in the corresponding field in theI_ACTIVITY_UPDATE structure for each field to be changed.
For information about the individual parameters, refer to the relevantdata element documentation. To do so, double-click on a data elementand then choose Documentation.

Description
In this structure (I_ACTIVITY_UPDATE) you enetr which foield inthe structure I_ACTIVITY, that is which network activity dataare transfered to the system and consequently can be changed.

Value range
For every field in the I_ACTIVITY structure to be changed, youmust entera character (for instance 'x') in the corresponding field inthe I_ACTIVITY_UPDATE structure.
The table must also have an entry for each new element.

Description
In this table you tranfer information about which method should be usedfor which object:
Field name,,Data element,,,,,,Data type,,Field length
REFNUMBER,,Reference number,,,,,,NUMC,,,,6
OBJECTTYPE,,Object type,,,,,,CHAR,,,,32
METHOD,,Method,,,,,,CHAR,,,,32
OBJECTKEY,,SAP external object key,,,,,,CHAR,,,,90

Description
The detailed information for a network are transfered in thisstructure.
For each field that is to be changed, you have to enter a character inthe I_NETWORK_UPDATE structure.
For information about the individual parameters, see the relevant dataelement documentation.
NETWORK,,Network number
NETWORK_TYPE,,Network type
SHORT_TEXT,,Short text
PLANT,,Plant
PROFIT_CTR,,Profit Center
WBS_ELEMENT,,WBS element
TAXJURCODE,,Tax Jurisdiction Code
OBJECTCLASS,,Object class (language independent)
FINISH_DATE,,Basic finish date
START_DATE,,Basic start date
MRP_CONTROLLER,,MRP controller
SCHED_TYPE,,Scheduling type
PRIORITY,,Order priority
PROJECT_DEFINITION,,Project definition
NOT_AUTO_SCHEDULE,,Indicator: No automaticscheduling
NOT_AUTO_COSTING,,Indicator: No automatic costing
NOT_MRP_APPLICABLE,,Reserv. nicht relevant to MRP, Purch. Req. is notcreated
PROFILE,,Network profile

Description
The changes in relationships in a network are transfered in thisstructure.
For every field that is to be changed, you must enter a character inthe corresponding field in the I_RELATION_UPDATE structure.
You can find information about the individual parameters in thecorresponding data element documentation.
NETWORK_PREDECESSOR,,Order no./Network no.
ACTIVITY_PREDECESSOR,,Activity number network and std. network
NETWORK_SUCCESSOR,,Order no./Network no.
ACTIVITY_SUCCESSOR,,Activity number network and std. network
RELATION_TYPE,,Relationship type
DURATION_RELATION_UNIT,, Unit f. relationship timeinterval
DURATION_RELATION,,Reraltionship time inetrval
DURATION_RELATION_UNIT_ISO,,ISO Code unit ofmeasure
FACTORY_CALENDAR,,Factory calendar ID
PERCENT_OF_SUC_PR,,Calculation time intervalpred./succ as percentage
DURATION_KEY,,Key for interpreting rel. timeinterval
WORK_CNTR,,Work center
PLANT,,Plant

Description
In this structure (I_RELATION_UPDATE) you enter which field inthe structure LS>I_RELATION, that is which detailed informationabout relationships, are transfered to the system and can consequentlybe changed.

Value range
For each field in the I_RELATION structure to be changed, entera character (for instance 'x') in the corresponding field in theI_RELATION_UPDATE structure.

Description
The detailed information about a WBS element is transfered in thisstructure.
For every field to be changed a character must be entered in thecorresponding field in the I_WBS_ELEMENT_TABLE_UPDATE structure.
For information about the individual parameters, see the correspondingdata element documentation.
WBS_ELEMENT,,WBS element
DESCRIPTION,,PS: Description (first text line)
SHORT_ID,,Short identification f. WBS element
RESPONSIBLE_NO,,Number of person responsible (projectmanager)
APPLICANT_NO,,Applicant number
COMP_CODE,,Company code
BUS_AREA,,Business area
CONTROLLING_AREA,,Controlling area
PROFIT_CTR,,Profit Center
PROJ_TYPE,,Project type
NETWORK_ASSIGNMENT,,Network assignment
COSTING_SHEET,,Costing sheet
OVERHEAD_KEY,,Overhead key
CALENDAR,,Factory calendar key
PRIORITY,,Priority
EQUIPMENT,,Equipment number
FUNCTIONAL_LOCATION,,Functional location
CURRENCY,,Currency key
CURRENCY_ISO,,ISO code f. currency
PLANT,,Plant
USER_FIELD_KEY,,User-defined field key
USER_FIELD_CHAR20_1,,User-defined field f. 20characters
USER_FIELD_CHAR20_2,,User-defined field f. 20characters
USER_FIELD_CHAR10_1,,User-defined field f. 10characters
USER_FIELD_CHAR10_2,,User-defined field f. 10characters
USER_FIELD_QUAN1,,User-defined field for quantity(length 10,3)
USER_FIELD_UNIT1,,User-defined field: Unit f. quantityfields
USER_FIELD_UNIT1_ISO,,ISO code f. units of measure
USER_FIELD_QUAN2,,User-defined field for quantity(length 10,3)
USER_FIELD_UNIT2,,User-defined field: Unit f. quantityfields
USER_FIELD_UNIT2_ISO,,ISO code f. units of measure
USER_FIELD_CURR1,,User-defined field for values(Length 10,3)
USER_FIELD_CUKY1,,User-defined field: Unit f valuefields
USER_FIELD_CUKY1_ISO,,ISO-Code currency
USER_FIELD_CURR2,,User-defined field for values(Length 10,3)
USER_FIELD_CUKY2,,User-defined field: Unit f valuefields
USER_FIELD_CUKY2_ISO,,ISO-Code currency
USER_FIELD_DATE1,,User-defined field for date
USER_FIELD_DATE2,,User-defined field for date
USER_FIELD_FLAG1,,User-defined field: Indicator forevaluations
USER_FIELD_FLAG2,,User-defined field:Indicator forevaluations
OBJECTCLASS,,Object class
STATISTICAL,,Statistical WBS element (X)
TAXJURCODE,,Tax Jurisdiction Code
INT_PROFILE,,Interest profile for projects

Description
In this structure (I_WBS_ELEMENT_TABLE_UPDATE) you enter whichfields in the I_WBS_ELEMENT_TABLE structure, that is whichdetailed information about WBS elements, are transfered to the systemand can consequently be changed.

Value range
For each field in the I_WBS_ELEMENT_TABLE structure to bechanged, enter a character (for instance 'x') in the correspondingfield in the I_WBS_ELEMENT_TABLE_UPDATE structure.

Description
Information about WBS hierarchy is transfered in this table.

Table structure


• WBS element whose hierarchy information is to be transfered


• Project definition it belongs to


• Superior WBS element for the relevant WBS element


• First WBS element (in the hierarchy graphic furthest left) that belongs
to the same superior WBS element)

• Previous WBS element (next to the left) that belongs to the same
superior WBS element.

• Next WBS element (to the right) that belongs to the same superior WBS
element.

Description
Detail information about a WBS milestone.