Create a new business class

If you have data you need to track and store and have users interact with, you can add your own business logic by defining your own business class.

  1. In the Infor Rich Client, access the Configuration Console.
  2. Select User Business Classes and select the New button at the top of the left pane.
  3. In Create New Configuration, make sure Business Class is the configuration type, and click OK.
  4. Define the business class.
    Key Field Name

    Specify the key field. The name cannot begin with a lowercase letter or contain spaces. Be sure to follow your configurations naming conventions and prefix the name with a code such as ZZZ, Usr, or characters that represent your company name (for example, ACM for Acme Co).

    The value you enter here becomes the Business Class name.

    Field Type, Size, Decimals

    Select the key field type and enter the size and the number of decimals, if appropriate.

    Context

    You can leave this field blank, but if the new business class belongs at a certain level relative to other key fields or business classes in the system, select the key field here. For example, your business class is only valid in the context of an HROrganization, then you would select that as the Context.

    For more information about context, see Configuration Console Reference Guide: Landmark Pattern Language (LPL).

    Parent Hierarchy

    Select this field if your data will have levels that roll up. You can build a hierarchical structure of keyfield values in the business class.

    When you create a record in a business class with the Parent Hierarchy option, it asks for the parent value. Each record stores the value of its parent’s key. This enables the data to be rendered in a tree view (if the list UI is configured to implement TreeView). For example, you could create the following structure: 

    USA
    East
       Connecticut 
       Maine
       Massachusetts
       New York
    Midwest
        Iowa
        Michigan
        Minnesota
        North Dakota
        South Dakota
        Wisconsin
    South
        Alabama
        Georgia
        Mississippi

    USA has no parent value, so it is at the top of the tree. East, Midwest and South have a parent value of USA. Connecticut, Maine, Massachusetts and New York have a parent of East, and so on.

    For more information about the implements ParentHierarchy pattern, see Configuration Console Reference Guide: Landmark Pattern Language (LPL).

    User Defined States

    If you know there will be a relatively small number if records defined in this business class and would prefer a combo box type selector in the UI instead the normal select list dialog, select this field. For example, if you sell shoes and only offer sizes 5 – 12, you could create a ShoeSize business class that implements User Defined States and enter records for the valid shoe sizes. When you use this key field in a UI, it will show the valid values in a drop-down list.

    For more information about the implements UserDefinedStates pattern, see Configuration Console Reference Guide: Landmark Pattern Language (LPL).

    Business Class

    This reflects the value you entered as the key field name. You can change the name of the business class itself if you want.

  5. Define the fields for the business class: Persistent, Derived, Compute, and Conditions as applicable.
  6. Click the Next button at the top of the right pane.
  7. On the second action request definition window, select at least one role to associate with this business class. This role associates the new business class with security. If you assign no role, no users will have access to the business class.
  8. Click Save at the top of the right pane.

    A confirmation message displays with the name of the security class created and the access rights granted. You can change these values by editing the security class in Configuration Console for security. Note you must have appropriate roles assigned to your user in order to edit security classes.

  9. Add user interfaces. Create new lists and forms as applicable for your business class.

    The business class has the basic CRUD (create, read, update, delete) functions. You can create or add additional actions as needed.