This documentation supports the 9.0 version of Remedy Action Request System.

To view the latest version, select the version from the Product version menu.

Creating associations

Associations are relationship object types that you can explicitly define in BMC Remedy Action Request (AR) System. These objects help you create and manage relationships between forms for various BMC Remedy AR System functions.You can use associations to get related entries using REST API. For more information on using REST API to get associations, see get Associated Entries using REST API.

You must create associations when you want to establish a relationship between two or more forms in BMC Remedy Developer Studio. This relationship ensures that all the related form data is archived along with the main form when you run the archive process when you have configured associations to follow for the form which is getting archived. You can create two different types of associations in BMC Remedy Developer Studio.

Note

You cannot create associations for join forms and archive forms.

For information about which associations to choose, see Using associations.

To create direct associations

  1. In AR System Navigator, expand serverName > All Objects.
  2. Right-click Associations, select New Direct Association, and enter the following parameters:
    1. Select the state of the association. The options are Enabled and Disabled.
    2. Select the cardinality of the relationship between the primary and secondary form. The options are: One to One and One to Many. For information about type of associations, see Type of associations.
    3. Select the Primary form for association.
    4. Select the Secondary form to be associated with the primary form.
      Note: Optionally, you can add qualifications using Advanced Options. For more information about qualifications, see Associations qualifications.
    5. Enter the description for the association.
    6. To enforce associations, select the Enforced check box. 
      For more information about enforced associations, see Relationships.
    7. Map the fields from the primary form to the secondary form using PKFK Field Mapping.
      If one or more fields used in key mapping or in qualification are deleted, the server considers that association as invalid and it will not be functional until those fields are created again.

      Note

      Only Character, Integer, Enum, Decimal, Real, Date, time, and timeofDay fields are allowed for PKFK mapping.

    8. Select File > Save.
  3. In the Save Association As dialog box, enter the name of the new association and click OK.

To create indirect associations

  1. In AR System Navigator, expand serverName >All Objects.
  2. Right-click Associations, select New Indirect Association, and enter the following parameters:
    1. Select the state of the association. The options are Enabled and Disabled.
    2. Select the cardinality of the relationship between primary and secondary form. The options are: One to One,One to Many, and Many to Many.
      For information about type of associations, see Type of associations.
    3. Select the Primary form for association.
    4. Select the Secondary form to be associated with the primary form.
    5. Select the Association form.
      Note: Optionally, you can add qualifications using Advanced Options.
      For more information about qualifications, see Associations qualifications.
    6. Enter the description for the association.
    7. To enforce associations, select the Enforced check box.
      For more information about enforced associations, see Enforced associations.
    8. Specify the Primary and Association form Field Mapping for comparing values from the two forms.
      If one or more fields used in key mapping or in qualification are deleted, the server considers that association as invalid and it is not functional until those fields are created again.
    9. Specify the Secondary and Association form Field Mapping for comparing values from the two forms.
      If one or more fields used in key mapping or in qualification are deleted, the server considers that association as invalid and it is not functional until those fields are created again.
    10. Select File > Save.
  3. In the Save Association As dialog box, enter the name of the new association and click OK.

Note

To use a newly added custom field in an association, you must:

  1. Create the overlay of the base association and disable it.
  2. Create a new custom association that involves fields used in base association and the new custom field added in the overlay form.

Related topics

Modifying associations

Deleting associations

Was this page helpful? Yes No Submitting... Thank you

Comments

  1. Robin Ashford

    Hi, several links here appear broken e.g. Relationships & Associations Qualifications. There is no explanation of Enforced.

    The link to REST API is not specific to the associations.

    HTH

    Robin

    Feb 27, 2015 10:22
  2. Chinmay Gadre

    Hello Robin,

    Thanks for your comment.

    All the links on this page are working now.

    Please go to this link for more information on Enforced Associations:

    I have contacted the SME to get more information about how REST API uses associations. I will update the documentation once I receive it.

    Thanks & Regards,

    Chinmay

     

    Mar 03, 2015 05:34
    1. Chinmay Gadre

      Hello Robin,

      I have updated the topic with a link specific to the associations:

      get Associated Entries using REST API.

      Thanks & Regards,

      Chinmay

      Mar 04, 2015 05:12