To create a user-defined table

A table is made up of data fields. You define your table’s data fields so users can enter or select specific data in user-defined or custom tab.

Note: A single table cannot contain more than 398 fields.

Warning!  

Take a snapshot of your database with customizations. All customized objects (triggers, additional indexes, special permissions) are lost when user-defined tables are rebuilt.
If you created a process automation task with an On database change trigger on a user-defined table, be sure to disable that task before making any changes to the user-defiend table. From the Staff site, go to RiSE > Process automation, select the task, edit the trigger, and deselect Enabled. Save the changes. After you Create/Update Server Table in iMIS Desktop, go to RiSE and enable the trigger.

  1. Have all users exit iMIS.
  2. Back up your data.
  3. Log into iMIS as the database owner.
  4. From Customers, select Set up module> General, and click Additional Windows to open the Customer Setup – Additional Windows window.
  5. Click Define Tables to open the User Defined Tables window.
  6. Click New.
  7. Enter a new Table Name. The table names are case-sensitive, so plan to use ALL CAPS or Initial Caps consistently. Table names must be unique:
    • Unique name across iMIS: Make sure any table or field you add does not match the name of any other iMIS table or field or any of the SQL Reserved Words. If you enter an iMIS table name, you are warned that the iMIS table may be overwritten.
  8. Press Tab. When iMIS prompts you to verify the table creation, click Yes.
  9. Note: The scrolling list box of field entries is cleared until you complete the table’s heading fields.

  10. Accept the System and Access Method defaults.
  11. (optional) Enable the Multiple Instances Allowed option if you want customers to have more than one user-defined tab that will contain the same fields, for example, quarterly or annual surveys.
  12. Note: If you enable the Multiple Instances Allowed option, the Always Create and Use for Dues Pricing options are grayed out. Enabling the Always Create and Use for Dues Pricing options grays out the Multiple Instances Allowed option.

  13. (optional) Enable the Always Create option if you want records to be created automatically for the appropriate customer types and are using the fields for Dues special pricing. Press Tab.
  14. (optional) Enter specific customer types in the Only applies to these types field to restrict access to the demographic table, and separate customer types by commas. Leave the field blank to allow access to all customers. Press Tab.
  15. Enable the Use for Dues Pricing option if you are using the fields for Billing special pricing.
  16. Note: If you enable the Use for Dues Pricing option, the Always Create option must be enabled. Enabling Use for Dues Pricing will not add all of the records to this new user-defined table. You will need to insert the records using a script similar to creating missing records into the Name_Fin table.

  17. Press Tab. iMIS displays a definition area for the first field for this table.
  18. Enter a valid SQL Field Name, and press Tab.
  19. Note: Do not use ID as a Field Name. iMIS automatically assigns each user-defined table with an ID field.

  20. (Multiple Instances Allowed only) If you are creating multiple instances of this table, we recommend making your first field contain the information that will distinguish the multiple instances from each other. For example, if you plan to have a table in each customer record for each year’s survey data, the first field name should be Year.
  21. Select a field format from the Type drop-down list. Press Tab.
  22. (Multiple Instances Allowed only) Create multiple instance tables with a first field type of character (Char).
  23. Note: Lookup is unavailable for numeric user-defined fields. When defining a field that uses a general lookup/validation table, make sure you do not assign a numeric Type to the format (for example, a number).

    Note: If you assign a numeric Type format to a field, iMIS automatically formats the numbers entered in the field with commas. If you do not want a user-defined field to be automatically formatted, assign the data type to Char.

  24. Enter the field size in the Length field if it is a Character field. Press Tab.
  25. (Optional for Int, Number, or Money fields) If a decimal can be entered in the field, enter the number of decimal places to be accepted in the Dec field.
  26. In the Prompt field, enter the name of the field that will display on the tab. The default is Field Name.
  27. Select the Format option for the data entered in the field on the tab.
  28. (optional) In the Validation field, enter the general lookup/validation table that will be used to validate the data at the time of data entry. To enable this field you must build the corresponding general lookup/validation table in the Set up general lookup/validation window (from Customers, select Set up tables > General, and select General lookup/validation).
  29. A general lookup/validation table is required for a multiple instance table or if you enable the Multi Select option.

    Note: When creating a general lookup/validation table for a multi-select field in a user-defined table, the Description field on the Set up general lookup/validation window must contain a unique value for each Code.

    Note: Lookup is unavailable for numeric user-defined fields. When defining a field that uses a general lookup/validation table, make sure you do not assign a numeric Type to the format (for example, a number).

  30. Enable the Multi Select option if you entered a table name in the Validation field and you want to allow the user to make more than one selection from the validation table.
  31. Click Save. iMIS prompts you to set up the new table with the server.
  32. Click Yes to have iMIS create the server table. This prompt is equivalent to clicking Create/Update Server Table.
  33. (optional) Click Auto-Create Window. iMIS automatically creates a user-defined tab with the title based on the table name. iMIS defines the table layout and includes all the fields with the Field Name used as the field label.
  34. Click OK if prompted to restart iMIS.
  35. Click Close to close the User Defined Tables window.
  36. From Tools > Utilities, select User defined tables. Click Build All to generate business objects from user defined tables.
  37. Exit iMIS immediately.
  38. (content items using UD tables) Restart IIS so new fields are included as available fields in existing content items.