Creating a customization library

To create a customization library:

  1. Create a new customization library in your customization VRC.
    The customization library code is comparable to the two generated libraries, except that it uses 'cc' instead of 'sb' or 'st'. For example, if your implementation identifier is ppmmm123 then the customization library will be ppmmmbl123cc00. A customization library can only be created in a customization VRC. It will never be a part of the standard.
  2. Copy the template into the new library.
    For example, if your implementation identifier is ppmmm123, then open the ppmmmbl123sb00 library. Copy the lines between (but excluding) "#ifdef CUSTOMIZATION_LIBRARY" and "#endif | CUSTOMIZATION_LIBRARY" to your new ppmmmbl123cc00 library.
  3. For each component that requires custom data, specify the required fields using the addTableField() and addCdfField() methods.
    The parameters to be used in addTableField() and addCdfField():
    • elementName (string): the name that must be used to identify the element in the business object data XML.
    • tableCode (string): the code of the table that contains the custom data to be included.
    • columnName or cdfName (string): the name of the table column or customer-defined field. Note that customer-defined fields have a prefix ('cdf_') in the table column name. Do not include this prefix in the cdfName.
    • dataType (string): the data type of the column or customer-defined field.
    These data types can be used:
    • String
    • Integer
    • Numeric
    • Date (for UTC date/time)
    • DateOnly (for Date without time)
    • Checkbox