Adding Custom Attributes to a Profile Property

  • Article

You use the Profile Definition Designer to add custom attributes to a profile property. You use custom attributes to define profile property characteristics that are not available in the existing attributes. For example, you can create custom attributes that provide property-level security or error handling information. For information about profile property attributes, see Profile Attributes.

You must set the sDisplayColumn and sFriendlyName custom attributes to edit a particular generic profile in the Profile Editor.

The sDisplayColumn custom attribute is used to specify the profile data that is displayed and is used to identify profiles on the Find screen of the Profile Editor module for a particular generic profile definition. The sFriendlyName custom attribute is used to specify the profile data that is displayed and is used to identify the profile being edited in the title bar of the Edit Profile screen of the Profile Editor module. You can use these custom attributes for any profile. For information about custom profile attributes, see Custom Profile Attributes.

Ee811646.note(en-US,CS.20).gifNote

  • When a profile contains only one property that has an sDisplayColumn custom attribute defined, then by default, the profile display column is sorted in ascending order on that property.

You must have access to the Profiles modules to make changes to site terms, profile definitions, and profiles. For information about Business Desk permissions, see About Business Desk Security.

To add the sDisplayColumn custom attribute

To add the sFriendlyName custom attribute

To add the sDisplayColumn custom attribute

  1. In Profiles, click Profile Definition Designer.

  2. In the Profiles screen, select the profile definition that contains the property to which you want to add the custom attribute, and then click Ee811646.open(en-US,CS.20).gif on the toolbar.

  3. In the Profile: <profile definition> screen, in the Properties list, expand the group that contains the property to which you want to add a custom attribute, and then select the property.

  4. In the Custom Attributes section, click New, and then do the following:

    Use this To do this
    Name Type sDisplayColumn.

    Ee811646.note(en-US,CS.20).gifNote

    • This attribute is case-sensitive.
    Display name Type Column Name.
    Description Type a description of the attribute.
    Value Type the value of the attribute. The value of this column attribute determines the relative width of the column for the property in the Find screen.

    For example, if you set the value for the sDisplayColumn attribute for this property to 2, and the value of the sDisplayColumn attribute for another property to 4, the column for that property will be twice as wide as the column for this property.

  5. Click Accept.

    Ee811646.note(en-US,CS.20).gifNote

    • You can repeat steps 4 and 5 to add as many custom attributes as you need for this property.

  6. To apply the new custom attribute to the selected property, click Apply.

  7. To save the profile definition with the new custom attribute and return to the Profiles screen, click Save and go back on the toolbar.

The profile definition is saved with the new sDisplayColumn custom attribute.

To add the sFriendlyName custom attribute

  1. In Profiles, click Profile Definition Designer.

  2. In the Profiles screen, select the profile definition that contains the property to which you want to add a custom attribute, and then click Ee811646.open(en-US,CS.20).gif on the toolbar.

  3. In the Profile screen, in the Properties list, expand the group that contains the property to which you want to add the custom attribute, and then select the property.

  4. In the Custom Attributes section, click New, and then do the following:

    Use this To do this
    Name Type sFriendlyName.

    Ee811646.note(en-US,CS.20).gifNote

    This attribute is case-sensitive.
    Display name Type Friendly name.
    Description Type a description of the attribute.
    Value The value of the sFriendlyName attribute is not used.

  5. Click Accept.

    Ee811646.note(en-US,CS.20).gifNote

    • You can repeat steps 4 and 5 to add as many custom attributes as you need for this property.

  6. To apply the new custom attribute, click Apply.

  7. To save the profile definition with the new custom attribute and return to the Profiles screen, click Save and go back on the toolbar.

The profile definition is saved with the new custom attribute. A property with the sFriendlyName custom attribute is the first column displayed in the Find screen. If you add the sFriendlyName custom attribute to more than one property in the profile definition, the first property (in the Properties list on the Profile screen) used as the friendly name appears in the title bar of the Edit Profile screen.

After you make changes to a profile definition, you must publish the changes on your Web site. For information about publishing your changes, see Publishing Profile Definition Changes on Your Web Site.

See Also

Adding a Property Group to a Profile Definition

Adding a Property that Maps to a Site Term

Copyright © 2005 Microsoft Corporation.
All rights reserved.