Characteristic

The architecture area Characteristic contains features such as,
for example, thread length, quality and so on, with which objects can be described.

For the characteristics, quantitative or qualitative values can be
specified, for example, thread length 100 mm, quality good and so on.

By means of characteristics, features of classes can be described. The
use of a characteristic can be limited to classes of certain class types.

Available Methods

• AddLongText : Set Long Text for Characteristic or Value [ BAPI_CHARACT_ADDLONGTEXT ]
  
• Change : Change Characteristic [ BAPI_CHARACT_CHANGE ]
  
• Create : Create Characteristic [ BAPI_CHARACT_CREATE ]
  
• Delete : Delete Characteristic [ BAPI_CHARACT_DELETE ]
  
• ExistenceCheck : Check Existence of Object [ BAPI_CHARACT_EXISTENCECHECK ]
  
• GetDetail : Read Characteristic Attributes [ BAPI_CHARACT_GETDETAIL ]
  
• GetList : Find Name [ BAPI_CHARACT_GETLIST ]
  
• GetLongText : Read Long Text for Characteristic of Value [ BAPI_CHARACT_GETLONGTEXT ]
  
• GetWhereUsedList : Where-Used List in Classes [ BAPI_CHARACT_GETWHEREUSEDLIST ]
  
• RemoveLongText : Delete Long Text for Characteristic or Value [ BAPI_CHARACT_REMOVELONGTEXT ]
  
• Rename : Rename characteristics [ BAPI_CHARACT_RENAME ]
  

AddLongText

This BAPI sets the long text (documentation) for a characteristic or characteristic value.

If only the characteristic name (CharactName) is transferred, the longtext for the characteristic is set. If the parameters for the characteristic value are also filled, the long text for this value is
set.

For characteristics with character format, parameter 'ValueChar' isfilled. For characteristics with numeric, currency, date, and timeformat, parameters 'ValueFrom', 'ValueTo', and 'ValueRelation' arefilled. For a detailed description of these fields, see (for example) table 'CharactValuesNum' of BAPI Characteristic.Create
. Single values are entered in field 'ValueFrom', in which case field 'ValueRelation' contains a '1'.

You can also transfer a date or a change number. The long text is setin the system language, unless you select a different language by using
parameter 'LanguageInt' or 'LanguageISO'. 'LanguageInt' is the langaugein SAP format, whereas 'LanguageISO' is the language in ISO format. Ifboth parameters are filled, the ISO format overrides the SAP format.

The long text is in table 'Longtext'. The first field defines the
format (standard line format is *), and the second field contains a line of text.

The result is logged in table 'Return'. If there are errors in thedata, you see a message of type 'E'. If not, you see a message of type 'S'.

Notes

The long text you transfer overwrites the old long text.

You can use function modules CTBP_CONVERT_VALUE_INT_TO_EXT and CTBP_CONVERT_VALUE_EXT_TO_INT to switch between internal and external value format.

Change

This BAPI changes a characteristic, if the characteristic exists. Ifthe characteristic does not exist, the BAPI creates the characteristic.

The following fields must contain data:

ISO format overrides internal format. If there is more than one entry for the same language, the last is relevant.

The value descriptions are in table CharactValuesDescr,regardless of data type. Check tables are entered in table CharactReferences and restrictions to class types are in table CharactRestrictions.

If the BAPI runs successfully, table RETURN contains no messages of type 'E'.

Caution

The BAPI transfers all information as new, replacing the old information completely. This means that a blank field means "deleteentry", not "no change".

This BAPI does not change the database. To change the database, call BAPI BapiService.TransactionCommit afterwards.

Create

This BAPI creates a characteristic that does not yet exist.

The following fields must contain data:

ISO format overrides internal format. If there is more than one entry for the same language, the last is relevant.

Check tables are entered in table CharactReferences and restrictions to class types are in table CharactRestrictions.

If the BAPI runs successfully, table RETURN contains no messages of type 'E'.

Caution

This BAPI does not change the database. To change the database, call BAPI BapiService.TransactionCommit afterwards.

Delete

This BAPI deletes a characteristic, which is identified by its name andoptionally a date and/or change number. The default value for the date is the system date, on which all characteristics are valid.

If the BAPI runs succesfully, table RETURN contains no messages of type 'E'.

Caution

This BAPI does not change the database. To change the database, call BAPI BapiService.TransactionCommit afterwards.

ExistenceCheck

Funktionalit舩

This BAPI checks whether a characteristic exists on a specific date.The default value for the date is the system date, on which all characteristics are valid.

The result is shown as follows in table RETURN:

E00 172 No authorization to display characteristics

IC1 003 Characteristic does not exist or is not valid

SC1 002 Characteristic exists

GetDetail

This BAPI returns detail information on a characteristic, which isidentified by its name and optionally by a date (default value is the system date).

Transfer Structures

CharactDetail contains the basic data of the characteristic. CharactDescr
contains the descriptions. According to the characteristic format, one of the export tables is filled: CharactValuesNum, CharactValuesChar, or CharactValuesCurr. Numeric, time, and date characteristics are
in CharactValuesNum, character and boolean characteristics are in CharactValuesChar and currency characteristics are in CharactValuesCurr.

Value descriptions are all in table CHARACTVALUESDESCR, regardless of the characteristic format.

Check tables are in CharactReferences.

CharactRestrictions contains the restrictions to class types.

Note

Messages are logged in table RETURN. If the BAPI runs successfully, there are no messages of type 'E'.

GetList

Funktionalit舩

This BAPI returns the result of a search for characteristics. Thesearch criteria are the characteristic name, characteristics group,data type, check table, and date. The characteristic name and the groupare transferred in a range table, allowing you to run complex queries.

The characteristics that match the search criteria are returned in table CharactList. This table contains the name, group, data type, number of characters, and number of decimal places of each characteristic.

Note

If the BAPI runs successfully, table RETURN contains no messages of type 'E'.

This BAPI reads the database. This means that it finds the data from the last call of BAPI BAPIService.TransactionCommit or the COMMIT-WORK statement. Any changes made since are ignored.

GetLongText

This BAPI reads the long text (documentation) for a characteristic or characteristic value.

If only the characteristic name (CharactName) is transferred, the longtext for the characteristic is read. If the parameters of a characteristic value are also filled, the long text for the value is
read.

For characteristics with character format, parameter 'ValueChar' isfilled. For numeric, currency, date, and time characteristics, theparameters 'ValueFrom', 'ValueTo', and 'ValueRelation' are filled. Youwill find a detailed description of these fields in, for example, table 'CharactValuesNum' of BAPI Characteristic.Create
. If a single value is entered in field 'ValueFrom', 'ValueRelation' contains a '1'.

In addition, you can transfer a date or a change number. Usually, thelong text is read in the system language, by parameter 'LanguageInt' or'LanguageISO', but you can select a different language. 'LanguageInt'
contains the language in SAP format. 'LanguageISO' contains thelanguage in ISO format. If both parameters are filled, ISO format has priority.

The long text is in table 'Longtext'. The first field contains formatdata (standard line: *), and the second field contains a text line.

The result is logged in table 'Return'. If there are errors in thedata, this table contains a message of type 'E', if there is no longtext, it contains a message of type 'I', and if a long text is found successfully, there is no message.

Notes

Function modules CTBP_CONVERT_VALUE_INT_TO_EXT and CTBP_CONVERT_VALUE_EXT_TO_INT can be used to switch between internal and external value format.

GetWhereUsedList

This BAPI returns a list of all classes that contain characteristic 'CharactName' on date 'KeyDate'.

If the characteristic is not assigned to a class, table 'Return'contains a message of type 'I'. If an error occurs, the table contains a message of type 'E'.

RemoveLongText

This BAPI deletes the long text (documentation) for a characteristic or characteristic value.

If only the characteristic name (CharactName) is transferred, the longtext for the characteristic is deleted. If the parameters for thecharacteristic value are also filled, the long text for this value is deleted.

For characteristics with character format, parameter 'ValueChar' isfilled. For characteristics with numeric, currency, date, and timeformat, parameters 'ValueFrom', 'ValueTo', and 'ValueRelation' arefilled. For a detailed description of these fields, see (for example) table 'CharactValuesNum' of BAPI Characteristic.Create
. Single values are entered in field 'ValueFrom', in which case field 'ValueRelation' contains a '1'.

You can also transfer a date or a change number. The long text isdeleted in the system language, unless you select a different languageby using parameter 'LanguageInt' or 'LanguageISO'. 'LanguageInt' is the
langauge in SAP format, whereas 'LanguageISO' is the language in ISOformat. If both parameters are filled, the ISO format overrides the SAP format.

The long text is in table 'Longtext'. The first field defines theformat (standard line format is *), and the second field contains a line of text.

The result is logged in table 'Return'. If there are errors in thedata, you see a message of type 'E'. If not, you see a message of type 'S'.

Notes

You can use function modules TBP_CONVERT_VALUE_INT_TO_EXT and CTBP_CONVERT_VALUE_EXT_TO_INT
to switch between internal and external value format.

Rename

No document is available