Creating a code list

To create a code list:

  1. Select Administrative Functions > Manage Code Lists.
  2. Click Create.
  3. Specify this information:
    Name
    Review or specify the unique name of the code list.
    Component
    Each code list must be assigned to a functional area of the application. If a code list is used by several functional areas, it must be assigned to the area Infor Automotive Exchange Common.
    When editing, select a functional area to which the code list is assigned from the drop-down list.
    Hierarchy Structure

    The search hierarchy structure is used to store codes and to access the code information, for example:

    • CodeListHierarchyAE with hierarchy tenant, accounting entity, and location: This search hierarchy structure is used in the code list TimeZonesOwn to determine the time zone of a user who is logged on to the application.
    • CodeListHierarchyTradingPartner with hierarchy tenant and trading partner: This search hierarchy structure is used in the code list UnitsOfMeasures to determine the trading partner-specific code mapping for units of measures.
    When editing, click the Lookup button and select a hierarchy from the predefined hierarchy code lists.
    Validation Java Class
    Java classes are used to validate codes and code values. They are defined in the code lists CodeListValidatorsForCodes and CodeListValidatorsForProperties. An example is the time zone validator of the code list TimeZones that checks whether a specified code is a valid time zone.
    When editing, select the Java class for the validation of codes and code values from the drop-down list.
    Fetcher Java Class
    This Java class is used to retrieve the valid codes of a code list or a property. For example: In the code list TimeZones, the Java class fetcher provides valid time zones. You can select these time zones from the drop-down list Name in the dialog box Manage Code Properties. The individual Java classes used to retrieve valid codes are defined in the code list CodeListFetcher.
    When editing, select the Java class that is used to retrieve the valid codes from the drop-down list.
    Referenced Code List
    You can access the code values of another code list when you define a reference to this code list. You can select the code values of the referenced code list from a drop-down list when you specify codes in the dialog box Manage Code Properties.
    When editing, click the Lookup button and select a referenced code list from the dialog box.
    Description
    Review or specify an explanatory text for the code list.
    Minimum Length
    Review or specify the required minimum length of codes that must be entered on the Manage Codes page.
    Maximum Length
    Review or specify the maximum length of codes that can be entered on the Manage Codes page.
    Incremental Code List
    Incremental code lists enable you to collect code property values over multiple hierarchies. You can create a code entry with all default values on the highest hierarchy level, which is the tenant. A second code entry with the same name can be created on a specific hierarchy, for example, on accounting entity level. When a code is specified, the properties from the accounting entity level are evaluated first. Empty values are completed with those from the tenant level.
    When editing, select the check box to define that the code list is an incremental code list.
    Default Entry Allowed
    This option enables you to specify a code with the name default in the code list. This code is used as a default when the requested code cannot be found in the code list. For example, a time zone that is specified as the default value is used if other values cannot be found. For example, the application requests the time zone from the code list TimeZonesOwn for a specific user. If no time zone is set for the user, the specified "default" value is used.
    System Code List
    A system code list is essential to run the application and must not be changed.
    When editing, select the check box to define the code list as a system code list.
    Hierarchy Structure Must Match
    If you use this option, an application that accesses the code list must use the specified search hierarchy structure. If a code is requested from the application, only the code that exactly matches the given hierarchy search criteria is used.
    To be Translated
    This option indicates whether the strings of the code list must be translated.
  4. To add a new line to the code list properties, click the Create button of the Code List Properties. The dialog box Manage Code List Properties opens.
  5. You can specify these parameters in the dialog box Manage Code List Properties:
    Name
    Review or specify the name of the code list property.
    Description
    Review or specify the description of the code list property.
    UI Field Name
    Review or specify the code that is used to access the name of the code field that is displayed in the dialog box Manage Code Properties.
    UI Sequence
    Review or specify the order in which the code fields are sorted and displayed in the dialog box Manage Code Properties.
    UI Field Width
    Specify the display size of the code field in the dialog box Manage Code Properties. You can select one of these standard widths for fields:
    • Boolean Values
    • Large Strings, List Elements, Descriptions
    • Medium Large Strings, List Elements (Cron Expressions, Trigger Types)
    • Small Strings, Codes, Numbers, Dates
    • Very Large Strings (Class Names, File Names, Path Names)
    Minimum Length
    Specify the required minimum field length of the code field in the dialog box Manage Code Properties.
    Maximum Length
    Specify the maximum field length of the code field in the dialog box Manage Code Properties.
    Data Type
    The data type of a property field can be Boolean Value, Decimal Value, Date Value, String Value, or Integer Value.
    When editing, select the data type of the code field from the drop-down list.
    Value List
    When you specify codes in the dialog box Manage Code Properties, you can access a list of fixed values from a drop-down list.
    When editing, specify a list of values that are separated by colons. You can either specify a list of values or select a referenced code list.
    Validation Java Class
    Java classes are used to validate codes and code values. They are defined in the code lists CodeListValidatorsForCodes and CodeListValidatorsForProperties. An example is the time zone validator of the code list TimeZones that checks whether a specified code is a valid time zone.
    When editing, select the Java class for the validation of codes and code values from the drop-down list.
    Fetcher Java Class
    This Java class is used to retrieve the valid codes of a code list or a property. For example: In the code list TimeZones, the Java class fetcher provides valid time zones. You can select these time zones from the drop-down list Name in the dialog box Manage Code Properties. The individual Java classes used to retrieve valid codes are defined in the code list CodeListFetcher.
    When editing, select the Java class that is used to retrieve the valid codes from the drop-down list.
    Default Value
    Review or specify the default value for the code field. For example, a time zone that is specified as the default value is used if other values cannot be found.
    Referenced Code List
    You can access the code values of another code list when you define a reference to this code list. You can select the code values of the referenced code list from a drop-down list when you specify codes in the dialog box Manage Code Properties.
    When editing, click the Lookup button and select a referenced code list from the dialog box.
    Required Entry
    Use this option, if a field entry is required in the dialog box Manage Code Properties.
    Protected Field
    Select this check box, if the code field must not be changed in the dialog box Manage Code Properties.
  6. To save the code list properties, click OK.
  7. To save the code list, click Save.
    A notification displays that the code list has been saved successfully.