Creating the BlueCatGateway UDF - Adaptive Applications - BlueCat Gateway - 25.2.2

BlueCat Server Update Services Administration Guide
ft:locale
en-US
Product name
BlueCat Gateway
Version
25.2.2

This application is built on the BlueCat Gateway platform. Within Address Manager, you must create a user-defined field (UDF) with the name BlueCatGateway (and some additional parameters) to allow user access to BlueCat Gateway workflows.

User permissions in BlueCat Gateway are derived partly from configuration in BlueCat Gateway, and partly from Address Manager UDF values. The BlueCat Gateway UDF will contain those Address Manager values.

Important: The Address Manager UI changed significantly in Address Manager v25.1 (the version immediately following Address Manager v9.6). the procedure for setting up the UDF depends on the version of Address Manager (Integrity) that you're using.
Tip: As of Address Manager 25.1, the versioning scheme for Address Manager changed to reflect the year and sequential major versions within that year. The last major version before Address Manager 25.1 is Address Manager 9.6.

Address Manager v25.1 or later

To create the BlueCatGateway UDF in Address Manager v25.1 or later

  1. Log in to Address Manager as an administrator.

  2. Click the Global tab in the sidebar, then click User-defined fields.

  3. Click the New button.

  4. In the Create user-defined field window, click the General tab (if it's not already selected) and enter the following:

    • Name: Type BlueCatGateway, as a single word with this capitalization. This name will be used by the Address Manager database.

      Important: Enter this name exactly as written. The BlueCatGateway UDF name is case sensitive and does not contain spaces.

    • Display name: Type a user-friendly name (such as BlueCat Gateway):

    • Object type: Select User.

    • Data type: Select Text.

    • Required: Leave this checkbox cleared.*

    • Default value: Leave blank.*

    • Predefined value: Leave blank.*

  5. On the Localized names and Validation tabs, leave the fields blank.*

  6. (Optional) On the Change control tab, enter a comment to describe your changes.

  7. When you're done, click Create.

Address Manager v9.6 or earlier

To create the BlueCatGateway UDF in Address Manager 9.6 or earlier

  1. Log in to Address Manager as an administrator.

  2. Select the Administration tab.

  3. Under Data Management, click Object Types.

  4. Under Object Categories, click Admin then click Named User. The Named User Object Information page opens.

  5. Under Fields, click New. The Add User-Defined Field page opens.

  6. Under General, set the following parameters:

    • Name: Type BlueCatGateway. This name will be used by the Address Manager database.

      Important: Enter this name exactly as written. The BlueCatGateway UDF name is case sensitive and does not contain spaces.

    • Display Name: Type a user-friendly name (such as BlueCat Gateway), then click Add. The display name appears below the text field.

    • Type: Select Text.

    • Hide From Search: Leave blank.*

    • Require Value: Leave blank.*

    • Under Pre-Defined Values, leave all fields and options blank.*

    • Under Advanced, leave the Validation Properties field blank.*

    • Under Change Control, add comments to describe your changes.

    When you're done, click Add.

The display name of the BlueCatGateway UDF will now appear under the Additional Information section of the Add User page.

Note: *You only need to leave the indicated fields blank during initial creation of the BlueCatGateway UDF. You can modify the Predefined value and Validation properties later based on the needs of your environment and users.