Functionality
It is possible to edit network headers, activities and relationshipsusing the Maintain BAPI of the network business object. The BAPIcontains a complete transaction. It is possible to carry out severaloperations on the network objects with one call. The Project Systemdetermines the order in which the objects are processed. The caller canchoose the operations in any order. As a result the processing is veryspeedy and effective. However, this transaction concept does not includethe use and combination of other SAP BAPIs in the same LUW.

Procedure
The Network business object is a facade pattern for networks, theiractivities, and relationships.
If you want to edit a network object, enter a command for an objecttype. In addition, enter the object key and a reference to itsattributes. In the table parameter IMethodProject, enter the objecttype, the command and the object key. As a reference enter the index ofthe object data table of the relevant object type. In the object datatable enter the information on the object.
When entering the object type and method in the IMethodProject tableremember 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 informs you whether errors occurred duringprocessing. After the call you find the error messages that were createdduring processing in the EMessageTable table.

Commands for the individual object types

Object type: Network
The network number is the key that identifies each network object type.
Command: Create
Use this command to create a network using the specified network number.
The network number is determined by the external system. For the networkenter a network profile that exists in the Project System. The networkprofile has to be assigned to a network type supporting external numberassignment.
Always enter the network number in uppercase.
Depending on the scheduling type, enter a start or end date.
&EXAMPLE& - Create a network with the network numberTRAINING0001. Enter the key of the network object in the command tableunder OBJECTKEY and in the data table under NETWORK . The referencenumber '000001' of the IMethodProject command table refers to the indexof the data table.

• IMethodProject

OBJECTTYPE = Network
METHOD = Create
OBJECTKEY = TRAINING0001
REFNUMBER = 000001
OBJECTTYPE =
METHOD = Save
OBJECTKEY =
REFNUMBER =

• INetwork

Index = 1
NETWORK = TRAINING0001
SHORT_TEXT = New network
FINISH_DATE = 12/04/1999
Profile = EPS40_1
...
Command: Update
Use this command to change a network that exists in the Project System.
Use the update structure.
You want to change only certain values in an existing network and keepthe other values. Using the update structure you specify exactly theattributes you want to change. Therefore, you need not fill all theattributes of the network structure.
If you are working with the update structures, pay attention to the factthat the table of the update structure must also be filled for the othercommands of the network. The reference number of the command table hasto match the same index of the network table and the table containingthe update structures.

&EXAMPLE& - Change the description of the existing networkTRAINING 0001


• IMethodProject

OBJECTTYPE = Network
METHOD = Update
OBJECTKEY = TRAINING0001
REFNUMBER = 000001
OBJECTTYPE =
METHOD = Save
OBJECTKEY =
REFNUMBER =

• INetwork

Index = 1
NETWORK = TRAINING0001
SHORT_TEXT = Description changed

• INetworkUpdate

Index = 1
NETWORK =
SHORT_TEXT = X

Command: Delete (from release 4.5A)
Use this command to delete a network that already exists in the ProjectSystem.
The network has the Deletion flag system status which can berevoked in the Project System. Therefore, the network remains in thedatabase physically.

&EXAMPLE& - Delete the network TRAINING0001


• IMethodProject

OBJECTTYPE = Network
METHOD = Delete
OBJECTKEY = TRAINING0001
REFNUMBER = 000001
OBJECTTYPE =
METHOD = Save
OBJECTKEY =
REFNUMBER =

• INetwork

Index = 1
NETWORK = TRAINING0001
Command: Schedule
Use this command to schedule a network.

&EXAMPLE& - Reschedule network TRAINING0001


• IMethodProject

OBJECTTYPE = Network
METHOD = Schedule
OBJECTKEY = TRAINING0001
REFNUMBER = 000001
OBJECTTYPE =
METHOD = Save
OBJECTKEY =
REFNUMBER =

• INetwork

Index = 1
NETWORK = TRAINING0001
Command: Calculate
Use this command to calculate costs for a network.

&EXAMPLE& - Calculate costs for the TRAINING0001 network


• IMethodProject

OBJECTTYPE = Network
METHOD = Calculate
OBJECTKEY = TRAINING0001
REFNUMBER = 000001
OBJECTTYPE =
METHOD = Save
OBJECTKEY =
REFNUMBER =

• INetwork

Index = 1
NETWORK = TRAINING0001

Command: Release (from release 4.5A)
Use this command to release a network with all its activities.
&EXAMPLE& Release the TRAINING0001 network


• IMethodProject

OBJECTTYPE = Network
METHOD = Release
OBJECTKEY = TRAINING0001
REFNUMBER = 000001
OBJECTTYPE =
METHOD = Save
OBJECTKEY =
REFNUMBER =

• INetwork

Index = 1
NETWORK = TRAINING0001
Command: Lock (from release 4.6A)
Use this command to lock a network.
The Locked system status is set for a network.

&EXAMPLE& - Lock the network TRAINING0001


• IMethodProject

OBJECTTYPE = Network
METHOD = Lock
OBJECTKEY = TRAINING0001
REFNUMBER = 000001
OBJECTTYPE =
METHOD = Save
OBJECTKEY =
REFNUMBER =

• INetwork

Index = 1
NETWORK = TRAINING0001
Command: Unlock (from release 4.6A)
Use this command to unlock a network
The Locked system status is removed from a network

&EXAMPLE& - Unlock the TRAINING0001 network


• IMethodProject

OBJECTTYPE = Network
METHOD = Unlock
OBJECTKEY = TRAINING0001
REFNUMBER = 000001
OBJECTTYPE =
METHOD = Save
OBJECTKEY =
REFNUMBER =

• INetwork

Index = 1
NETWORK = TRAINING0001

Object Type: NetworkActivity
The key of the Network activity object consists of the networknumber and the activity number.
If you want to apply a command to the network activity, you must alwaysinclude the superior network in the same call in the table of theINetwork parameter.

Command: Create
Use this command to create a new activity in a network.

&EXAMPLE& - Create a new network activity with the number0010 in TRAINING0001 network.


• IMethodProject

OBJECTTYPE = NetworkActivity
METHOD = Create
OBJECTKEY = TRAINING00010010
REFNUMBER = 000001
OBJECTTYPE =
METHOD = Save
OBJECTKEY =
REFNUMBER =

• IActivity

Index = 1
NETWORK = TRAINING0001
ACTIVITY = 0010
DESCRIPTION = Activity 10

• INetwork

Index = 1
NETWORK = TRAINING0001
Command: Update
Use this command to change an activity that already exists in theProject System.
Use the update structure as in networks.
&EXAMPLE& - Change the description of the activity 0010 innetwork TRAINING0001.

• IMethodProject

OBJECTTYPE = NetworkActivity
METHOD = Update
OBJECTKEY = TRAINING00010010
REFNUMBER = 000001
OBJECTTYPE =
METHOD = Save
OBJECTKEY =
REFNUMBER =

• IActivity

Index = 1
NETWORK = TRAINING0001
ACTIVITY = 0010
DESCRIPTION = Activity 10 changed

• IActivityUpdate

Index = 1
NETWORK =
ACTIVITY =
DESCRIPTION = X
INetwork
Index = 1
NETWORK = TRAINING0001

Command: Delete
Use this command to delete an activity that already exists in theProject System. The activity receives the deletion flag systemstatus and is not deleted physically. Connected objects asrelationships, activity elements, capacity requirements, purchaserequisitions, and material components are also deallocated and selectedfor deletion.
You cannot create an activity with the same key.
&EXAMPLE& - Delete the network activity 0010 in networkTRAINING0001


• IMethodProject

OBJECTTYPE = NetworkActivity
METHOD = Delete
OBJECTKEY = TRAINING00010010
REFNUMBER = 000001
OBJECTTYPE =
METHOD = Save
OBJECTKEY =
REFNUMBER =

• IActivity

Index = 1
NETWORK = TRAINING0001
ACTIVITY = 0010

• INetwork

Index = 1
NETWORK = TRAINING0001
Command: Release (from release 4.5A)
&EXAMPLE& - Release the activity 0010 in network TRAINING0001


• IMethodProject

OBJECTTYPE = NetworkActivity
METHOD = Release
OBJECTKEY = TRAINING00010010
REFNUMBER = 000001
OBJECTTYPE =
METHOD = Save
OBJECTKEY =
REFNUMBER =

• IActivity

Index = 1
NETWORK = TRAINING0001
ACTIVITY = 0010

• INetwork

Index = 1
NETWORK = TRAINING0001

Object type: NetworkActivityElement (from release 4.6A)
The key for the activity element object comprises of the network number,the activity number, and the activity element number.

Command: Create
Use this command to create a new activity element in a network.

&EXAMPLE& - Create a new activity element with the number0020 in network activity 0010 of the TRAINING0001 network of theTRAINING0001 network .


• IMethodProject

OBJECTTYPE = NetworkActivityElement
METHOD = Create
OBJECTKEY = TRAINING000100100020
REFNUMBER = 000001
OBJECTTYPE =
METHOD = Save
OBJECTKEY =
REFNUMBER =

• IActivityElement

Index = 1
NETWORK = TRAINING0001
ACTIVITY = 0010
ELEMENT = 0020
Command: Update
Use this command to change an activity element that already exists inthe Project System.
Use the update structure as for networks.

&EXAMPLE& - Change an existing activity element with thenumber 0020 in the network activity 0010 of the TRAINING0001 network


• IMethodProject

OBJECTTYPE = NetworkActivityElement
METHOD = Update
OBJECTKEY = TRAINING000100100020
REFNUMBER = 000001
OBJECTTYPE =
METHOD = Save
OBJECTKEY =
REFNUMBER =

• IActivityElement

Index = 1
NETWORK = TRAINING0001
ACTIVITY = 0010
ELEMENT = 0020
DESCRIPTION = Activity element 0020 changed

• IActivityElementUpdate

Index = 1
NETWORK =
ACTIVITY =
ELEMENT =
DESCRIPTION = X

Command: Delete
Use this command to delete an activity element that already exists inthe Project System.
The activity element receives the Deletion flag status and is notdeleted physically. Connected objects such as capacity requirements andpurchase requisitions are also deallocated or marked for deletion.
You cannot create a new activity element with the same key.
&EXAMPLE& - Delete an activity element with the number 0020in the network activity 0010 in the TRAINING0001 network


• IMethodProject

OBJECTTYPE = NetworkActivityElement
METHOD = Delete
OBJECTKEY = TRAINING000100100020
REFNUMBER = 000001
OBJECTTYPE =
METHOD = Save
OBJECTKEY =
REFNUMBER =

• IActivityElement

Index = 1
NETWORK = TRAINING0001
ACTIVITY = 0010
ELEMENT = 0020

Object type: ActivityMilestone (from release 4.6A)
The key of the activity milestone object is the milestone number.

Command: Create
Use this command to create a new activity milestone for a network. It isnot necessary to enter a number for the milestone. When the milestone iscreated, the system gives it a number and returns this number in themessage table as an information message.
However, if an external number is entered in the method table duringcreation, the external number and the new milestone number are returnedin an information message.
&EXAMPLE& - Create a new activity milestone for activity 0010in the TRAINING0001 network


• IMethodProject

OBJECTTYPE = ActivityMilestone
METHOD = Create
OBJECTKEY =
REFNUMBER = 000001
OBJECTTYPE =
METHOD = Save
OBJECTKEY =
REFNUMBER =

• IActivityMilestone

Index = 1
MILESTONE_NUMBER =
NETWORK = TRAINING0001
ACTIVITY = 0010
Command: Update
Use this command to change an activity milestone that already exists inthe Project System.
It is always necessary to enter the network, if you do not make anyexplicit changes to the network.
Use the update structure as for networks.
&EXAMPLE& - Change an existing activity milestone with thenumber 000000002097 for the TRAINING0001 network

• IMethodProject

OBJECTTYPE = ActivityMilestone
METHOD = Update
OBJECTKEY =
REFNUMBER = 000001
OBJECTTYPE =
METHOD = Save
OBJECTKEY =
REFNUMBER =

• IActivityMilestone

Index = 1
MILESTONE_NUMBER = 000000002097
DESCRIPTION = Milestone description changed
NETWORK = TRAINING0001
IActivityMilestoneUp
Index = 1
MILESTONE_NUMBER =
DESCRIPTION = X
Command: Delete
Use this command to delete an activity milestone that already exists inthe Project System. The milestone is deleted physically. It is necessaryto enter the network, if you do not make any explicit changes to thenetwork.
&EXAMPLE& - Delete an activity milestone with the number000000002097 in the TRAINING0001 network

• IMethodProject

OBJECTTYPE = ActivityMilestone
METHOD = Delete
OBJECTKEY = 000000002097
REFNUMBER = 000001
OBJECTTYPE =
METHOD = Save
OBJECTKEY =
REFNUMBER =

• IActivityMilestone

Index = 1
MILESTONE_NUMBER = 000000002097

Object Type: NetworkRelation
The key of the Relationship object is composed of the type ofrelationship and the keys of the preceding and succeeding activities.You can change the name of the type of relationship in theImplementation Guide (transaction OPS2). In general, the name islanguage dependent. Use only valid types of relationships that areavailable in the corresponding language. Use valid relationship typesonly, which exit in the corresponding language.
To apply a command for the relationship, always include the connectednetworks in the same call in the table of the INetwork parameter.

Command: Create
Use this command to create a relationship between two activities.
&EXAMPLE& - Create a relationship between the activities
0010 and 0020 of the TRAINING0001 network. The two activities are linkedthrough an FS relationship.


• IMethodProject

OBJECTTYPE = NetworkRelation
METHOD = Create
OBJECTKEY = NFTRAINING00010010TRAINING00010020
REFNUMBER = 000001
OBJECTTYPE =
METHOD = Save
OBJECTKEY =
REFNUMBER =

• IRelation

Index = 1
NETWORK_ PREDECESSOR = TRAINING0001
ACTIVITY_ PREDECESSOR = 0010
NETWORK_ SUCCESSOR = TRAINING0001
ACTIVITY_ SUCCESSOR =0020
RELATION_ TYPE = NF

• INetwork

Index = 1
NETWORK = TRAINING0001
Command: Update
Use this command to change a relationship that already exists in theProject System.
The type of relationship cannot be changed, because it is part of therelationship key. If you want to change the relationship type, deletethe relationship and create a new relationship with a new relationshiptype.
Use the update structure as for networks.
Command: Delete
Use this command to delete a relationship that links two activities. Therelationship is deleted physically.
&EXAMPLE& - Delete the relationship between the activities0010 and 0020 in the TRAINING0001 network

• IMethodProject

OBJECTTYPE = NetworkRelation
METHOD = Delete
OBJECTKEY = NFTRAINING00010010TRAINING00010020
REFNUMBER = 000001
OBJECTTYPE =
METHOD = Save
OBJECTKEY =
REFNUMBER =

• IRelation

Index = 1
NETWORK_ PREDECESSOR = TRAINING0001
ACTIVITY_ PREDECESSOR = 0010
NETWORK_ SUCCESSOR = TRAINING0001
ACTIVITY_ SUCCESSOR =0020
RELATION_ TYPE = NF

• INetwork

Index = 1
NETWORK = TRAINING0001

Testing the Interface and Displaying the Diagnosis Information

(from release 4.5)
You can save the data that is transferred to the Project System in afilefor test and diagnosis purposes. All the table parameter and structureparameter entries are saved in this trace file. The caller of theMaintain BAPI can check the interface.
The trace file is saved locally by the SAPGUI. Creating the fileconsumes runtime, and should therefore only be used for testing and notin an operative system.
The trace file is created, if object type Trace and method Create areentered in the IMethodProject table. The system requests as the objectkey the directory and the file name. Do not enter a reference number.
&EXAMPLE& - Create the trace file EPS_Test_Trace.txt
in the directory C:\TMP\


• IMethodProject

OBJECTTYPE = Trace
METHOD = Create
OBJECTKEY = C:\TMP\EPS_Test_Trace.txt
REFNUMBER =

Further information
For more information, see the SAP Library under Project System ->Structures -> EPS -> Interfaces to the Project
System.

Description
Return code with error messages

Value range
In the case of an error the following message is returned:
Type ID Number Message


• E CN 770 Errors occurred during processing

In this case, further information about the cause of the error is inthe E_MESSAGE_TABLE tableDescription
If errors occur while changing networks, the method, the object and theerror 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
In this structure detailed information about network activities aretransfered.
For each field to be changed, you have to set a character in the thecorresponding field in the I_ACTIVITY_UPDATE structure.
For information about the meaning of individual parameters, see thecorresponding data element documentation. You can call this up bydouble-clicking on the relevant data element and then choosingDocumentation.

Description
Detail information about an activity element.

Description
In this structure (I_ACTIVITY_UPDATE) you enter whichI_ACTIVITY structure fields , that is which data from networkactivities is transfered to the system and can consequenetly bechanged.

Value range
For every of the I_ACTIVITYstructure to be changed, enter acharacter (for example 'x') in the corresponding field in theI_ACTIVITY_UPDATE structure.
The table must alsocontain entries for freshly created elements.

Description
In this table you transfer information about which method should beused for which object.
Field name,, Data element,,,,,,Data type,, Field length
REFNUMBER,,Reference number,,,,,,NUMC,,,,6
OBJECTTYPE,,Object type,,,,,,CHAR,,,,32
METHOD,,Methods,,,,,,CHAR,,,,32
OBJECTKEY,,SAP external object key,,,,,,CHAR,,,,90

Description
In this structure detailed information about a network is transfered.
For every field to be changed a character has to be en

Description
In this structure (I_NETWORK_UPDATE) you stipulate which fieldsin the I_NETWORK structure, that is which data from a network,are transfered to the system and should consequently be changed.

Value range
For each field in the I_NETWORK structure that should bechanged, enter a character (for example 'x') in the corresponding fieldof the I_NETWORK_UPDATE structure.
You also have to make an entry in the table for freshly createdelements.

Description
Changes in relationships in a network are transfered in this structure.
For each field that should be changed, enter a character in thecorresponding field of the I_NETWORK_UPDATE structure.
For information about the meaning of individual parameters, refer tothe relevant data element documemtation.
NETWORK_PREDECESSOR,,Order number/Network number
ACTIVITY_PREDECESSOR,,Activity no. Network and Standard network
NETWORK_SUCCESSOR,,Order number/Network number
ACTIVITY_SUCCESSOR,,Activity no. Network and Standard network
RELATION_TYPE,,Relationship type
DURATION_RELATION_UNIT,,Time interval unitrelationship
DURATION_RELATION,,Time interval relationship
DURATION_RELATION_UNIT_ISO,,ISO-Code f. unit ofmeasurement
FACTORY_CALENDAR,,Factory calendar ID
PERCENT_OF_SUC_PR,,Time interval between predessor andsuccesssor as percentage
DURATION_KEY,,Key for interpreting time intervalrelationship
WORK_CNTR,,Work centerDescription
In this structure (I_RELATION_UPDATE) you stipulate which fieldsin the I_RELATION structure, that is which detailed data fromrelationships, are transfered to the system and should consequently bechanged.

Value range
For each field in the I_RELATION structure that should bechanged, enter a character (for example 'x') in the corresponding fieldof the I_RELATION_UPDATE structure.