SAP 10.03 SAP IDocs - Intergraph Smart Materials - Version 10.2 - Administration & Configuration - Hexagon

Intergraph Smart Materials Integration (10.2)

Language
English
Product
Intergraph Smart Materials
Subproduct
Classic
Search by Category
Administration & Configuration
Smart Construction Version
8
Smart Materials/Smart Reference Data Version
10.2

On this screen, you can define SAP IDocs for the different SAP versions, segment-by-segment or field-by-field. The fields are defined by specifying an offset value in the IDoc and by their length. You have the opportunity to define segment structures as a hierarchy (Parent Segment field), as options (Optional field), and in relation to number (Min. Number and Max. Number fields).

You also have the option to assign a default value to each of the fields in the IDoc.

Certain IDoc fields must contain specific values that are either set by a CIP function or with a fixed value (Value Type and Value / Content fields). This is necessary so that SAP can correctly interpret and process the IDocs.

The Master Data or Plant Dep. check boxes are used to identify master data fields (Master Data) or plant-dependent master data fields (Plant Dep.).

These two fields decide which of the fields on screens SAP 10.08 Feature Mapping (Master Data) and SAP 10.09 Feature Mapping (Plant-Dependent Master Data) are used as LOV for the IDoc-Field on the screen.

If the Master Data check box is set, the field will be displayed in the LOV of the IDoc Field on screen SAP 10.05 Master Data Mapping.

If the Master Data and Plant Dependent check boxes are set, the field will be displayed in the LOV of the IDoc Field on screen SAP 10.06 Master Data Mapping (Plant Dependent).

The data for IDOCS MATMATS03 and CLFMAS01 is included with SAP Version 4.0b. However, it is still necessary to select the requisite master data or plant-dependent master data fields (see above) by setting the Master Data and Plant Dep. check boxes for using the fields on the two screens mentioned above.

Field Descriptions

SAP Versions Block - In this block, the various versions of the SAP systems that are supported by the Smart Materials SAP interface are listed.

SAP Version - Enter the name of the SAP version given by SAP. The Description and Short Desc fields can contain additional language-dependent information.

SAP Idocs Block - In this block, the various IDocs are saved. The IDocs MATMAS03 and CLFMAS01 are part of the delivery. The user has the opportunity to copy and modify IDocs with the "Tree-Copy-Method," but it is important to maintain it in SAP in the same way to ensure an error-free function.

IDoc Name - Name of the IDoc.

Short Desc and Description – Language-dependent description and short description.

SAP IDoc Segments Block - An IDoc consists of various segments that can have hierarchical relations to each other. Segments can recur and they can be optional. The minimum and maximum number can be set.

Seq - This field serves to define the unique sequence of the segments within an IDoc.

Segment Name - Segment name of the IDoc segment. It is defined in SAP. If IDocs will be copied and user-modified, the segment names must remain unchanged and they must not be renamed.

Parent Segment Name - With this field, hierarchical segment relations can be set. Via LOV, the possible parent segments can be selected. Only segments with a lesser Seq number are available.

Version dep. Segmentname - This is an additional name of SAP for the segment. Its purpose is for the versioning of the segments and it will get a version number in the case of changes (only expansions for backwards compatibility).

Min Number - The segment must occur at least n times within this IDoc.

Max Number - The segment can occur at most n times within this IDoc.

Optional - Detail if this segment is a mandatory field or not.

Short Desc and Description – Language-dependent description of the segment.

SAP IDoc Fields Block - The single IDoc fields are the elements of the IDoc segments. They will be defined within a segment by a fixed position, length, and type. Here you can find the real information. Each IDoc field has a value that is given by a value type (Data Type).

Seq - Defines the order of the single segment fields.

Field Name - Name of the IDoc field.

Data Type - Internal SAP data type of the IDoc field. Valid values include: "CHAR", "UNIT", "DATS", "NUMC", "QUAN", "DEC", "INT2", "LANG", "CURR", and "FLTP". For the meaning of the respective values, please refer to the SAP documentation.

Offset - Within an IDoc segment, each field has a fixed position. The offset determines the position of a defined structure within the segment at which the field will begin.

Length - The length of the IDoc field within the segment structure.

Master Data - The activated check box defines an IDoc field as master data so that it can be selected on screen SAP 10.05 Master Mapping and be filled by the procedures that are available there.

Plant Dep. Data - The activated check box (in combination with Master Data check box) defines an IDoc field as plant-dependent master data so that it can be selected on screen SAP 10.05 Master Mapping (Plant Dependent) and be filled by the procedures that are available there.

Value Type - This field defines the ways of interpreting the default of the Value/ Content field. There are the following possibilities:

  • FIX – The value in the Value/ Content field will be assigned to the respective IDoc as a fixed value.

  • CIP - The value in the Value/Content field will be interpreted as a CIP function. The return value will be assigned as the default value in the corresponding IDoc field. The first input parameter of the CIP function is the ID of the SAP interface, so the CIP may do different things depending on the SAP interface.

The CIP function must have the following syntax:

FUNCTION m_pck_sap_custom.<functionname>

( p_interface_id IN m_interfaces.interface_id%TYPE,

,p_ident IN m_idents.ident%TYPE

,p_nls_id IN m_nls.nls_id%TYPE

,p_sp_id IN m_sap_plants.sp_id%TYPE )

return varchar2;

Value / Content - This field defines a standard value for the IDoc field. Depending on the Value Type field, either the real value will be transferred (Value Type = "FIX") or it will be interpreted as a CIP function (Value Type = "CIP") of which the return value then will be used as the default value.

Short Desc and Description – Language-dependent descriptions of the IDoc fields.