Import Cost Object (WBS) (Operation) - EcoSys - Help - Hexagon PPM

EcoSys SAP Adapter Help

Search by Category
EcoSys Version


Import project structure elements from SAP to EcoSys. Optionally includes WBS elements, networks, network activities, activity elements, and work orders.

Main inputs

  • One or both of:

    • List of projects to import (these values should match be valid SAP project IDs in SAP, not EcoSys external key IDs)

    • List of cost object category values to import (matching root cost objects will be included, based on their cost object external key ID values in EcoSys)

  • Include additional structures: flag indicating WBS elements only (False) or WBS, networks, network activities, activity elements, and work orders (True)

Optional inputs

  • Commit batch size: How many project structure nodes to commit in one API request when importing large projects from SAP to EcoSys, default is 500 if not specified.

  • Include orders from the Order Item table: If you set the Include additional flag to True, the adapter brings in orders from both order master and order item tables from SAP system. If orders from the Order Item table are not to be included, the adapter provides a flag that you can set to False to exclude orders from the Order Item table.

  • Read WBS, Network and Activity status: Indicates whether the adapter should read WBS, Network and Activity status while importing cost objects. Refer to the sample XML for usage. The following settings are supported:

    • readWBSNetworkStatus – If you set this to False, the status is not be imported for any object type and override any other new settings for status import. This setting is supported only for backward compatibility purposes because the current release provides new settings for more fine grain control. The default setting is True.

    • readNetworkStatus – This setting controls whether the status for the Network element is imported. If set to False, the importing status for Activity elements is also skipped. The default setting is True.

    • readNetworkActivityStatus – This setting controls whether the status for Network Activity elements is imported. This setting is useful only when readNetworkStatus is set to True. Otherwise, the Activity status import is also skipped. The ideal use for this setting is when only Network status is to be imported and Activity status can be skipped. The default setting is True.

  • Object currency for Network Activity and Elements: By default, the currency for Network Activity and Elements is read from the OWAER field in the AFVC table. However, you can parameterize this currency using the objectCurrencyFieldForNetworkActivitiesAndElements parameter in the WBS import operation .xml file to read from the WAERS field.

  • Include Partner Object Details: If you set the includePartnerObjectDetails flag to True, the adapter imports partner object details for Project and WBS. Set the flag to True only if details are needed as it might incur some performance hit. Because active partner objects are dynamically read from IHPA table, they cannot be listed here. Each organization can configure these specific to their needs. Because a project/WBS can have more than one partner object, multiple partner objects are stored as comma separated list.

  • You must configure the root cost object in EcoSys to have a cost object external key ID value consisting of the prefix PRJ, followed by the SAP project ID.

  • For child cost objects, the SAP element ID is stored in the corresponding cost object in EcoSys in the cost object external key ID.



<parameter name="costObjectExternalIds">




<parameter name="costObjectCategories">

   <category type="SAP Import">YES</category>


<parameter name="includeAdditionalStructures">true</parameter>

<parameter name="includePartnerObjectDetails">false</parameter>

<parameter name="includeOrdersFromOrderItemTable">true</parameter>

<parameter name="commitBatchSize">500</parameter>

<parameter name="readWBSNetworkStatus">false</parameter>

<parameter name="readNetworkStatus">false</parameter>

 <parameter name="readNetworkActivityStatus">false</parameter>

 <parameter name="objectCurrencyFieldForNetworkActivitiesAndElements ">WAERS</parameter>