Connector Guides › Connector Xpress Guide › Screens and Dialogs › Attribute Details Dialog

Attribute Details Dialog

The Attribute Details dialog lets you define logical parameters that control how a specific provisioning attribute is handled.

This dialog contains the following fields:

• Name

  Defines the name of the attribute. This label appears in user interfaces to represent the attribute.

• Description

  (Optional) Describes the attribute.

• Connector Map To

  Specifies which name to map an object class (including the connector itself) or attribute to in connector-speak. For a dynamic connector, this attribute specifies the name of the native system item to map the attribute to. For example, a JDBC-based connector would probably map an object class to the name of a database table, and each property within it to the name of one of its columns.

• Default Value

  (Optional) Specifies the default value for the attribute.

  Note: Only clients use this value (for example, user interfaces). If the client does not supply a value, the Provisioning Server does not use it by default.

• Required

  If selected, specifies that the endpoint requires that this attribute is present in all objects of this type.

  Note: If the endpoint schema requires this attribute to be present, Connector Xpress automatically selects the check box, and you cannot clear the check box.

• Minimum Length

  Specifies the minimum byte length of values for this attribute value.

  This value is used for input validation in CA Identity Manager account screens.

• Maximum Length

  Specifies the maximum byte length of values for this attribute value.

  This value is used for input validation.

• Allowed Operations

  Specifies the operations you can perform on this attribute. Select at least one of the following options:

  • Create

    Specifies whether this attribute's value is set when creating an object instance of the parent class.

  • Read

    Specifies whether this attribute's value is read when viewing an object instance of the parent class.

  • Modify

    Specifies whether this attribute's value is set when modifying an object instance of the parent class.

• Minimum Value

  (Numeric attribute types) Specifies the minimum value you can set for this attribute.

• Maximum Value

  (Numeric attribute types) Specifies the maximum value you can set for this attribute.

• Data type

  Specifies the data type of the provisioning attribute that you have mapped to the native attribute.

  • Binary Data

    Defines an attribute whose value is arbitrary binary data.

  • Boolean

    Specifies logically true or false in XML, but represented by the Provisioning Server and JIAM APIs as 1 or 0 in LDAP attribute values.

  • Date

    Specifies a date.

    Example: 1999-05-31

  Note: The Dynamic Namespace plug-in to Provisioning Manager supports the years from 1800 through 9999, but other components of the solution impose no such restrictions and can represent virtually any year in recorded history.

  • Date & Time

    Specifies a particular time on a particular day.

    Example: 1999-05-31T13:20:00

  Note: The Dynamic Namespace plug-in to Provisioning Manager supports the years from 1970 through 2036, so you must use Date to represent days falling outside of this range.

  Note: Vendor differences complicate how Connector Xpress handles time-related columns. For example, MSSQL "DATETIME" signifies a DateTime value whereas other vendors use the standard "TIMESTAMP", and MSSQL TIMESTAMPs are automatically generated binary values. Also, Oracle does not support a "TIME" type and its "DATE" type is also effectively a TIMESTAMP. Therefore, to remain vendor-neutral, Connector Xpress allows you to map to any of Date/DateTime/Time whenever it makes sense for you to do so.

  • Double-precision floating-point

    Specifies a double-precision 64-bit floating-point value.

  • Enumeration - enumeration type name

    Specifies an attribute with a fixed list of enumerated values.

  • Flexi-DN

    Specifies a distinguished name string format.

    For example, "cn=Bob,ou=Sales,o=ExampleCorp". The connector enforces this.

  • Flexi-Email

    Specifies an email address string format.

  • Flexi-Quoteless

    Specifies that quotes are removed from attribute values.

  • Floating Point

  Specifies a single-precision 32-bit floating-point number.

  • Integer

    Specifies a 32-bit value between -2147483648 and 2147483647.

  • Long Integer

    Specifies a 64-bit value from 9223372036854775808 through 9223372036854775807.

  • String

    Specifies an unrestricted field.

  • Time

    Specifies an offset of between 0 seconds and 23:59:59.

  Example: 13:20:00

• Force Case

  Specifies the case of the connector-speak value of a string.

  • Upper

    Specifies that the case is set to upper case.

  Example: If set to upper, String is set to STRING

  • Lower

    Specifies that the case is set to lower case.

  Example: If set to Lower, STRING is set to string.

  • Preserve

    Specifies that the case of the string is preserved.

  Note: The endpoint may not enforce case-sensitive searching, so a search for "EXAMPLE" may still match "eXaMpLe" on the endpoint system.

• Multi-valued

  If selected, specifies that this attribute is multi-valued.

  JNDI: Selected only if the native attribute is multi-valued. Read-only if native attribute is single valued.

  JDBC: Default is unselected.

• Flattening Style

  (JDBC only) Specifies the flattening style you want to use.

  • CSV (comma-separated value)

    Specifies that the multiple values of the attribute are comma-separated.

  • SQL

    Specifies that the multiple values of this attribute are in SQL format.

  • XML

    Specifies that the multiple values of this attribute are in XML format.

• Trim Whitespace

  Specifies whether Connector Xpress trims leading and trailing whitespace from the attribute's value.

• Sensitive

  Specifies whether user interfaces use asterisks to mask the attribute's value.

• Boolean Values

  Overrides the default 0 and 1 symbolic values for false and true values for Boolean attribute types.

  True

  Specifies the symbolic value that is be used for true.

  • False

    Specifies the symbolic value that is used for false.

• Account Template Value (Mandatory for mandatory attributes in account classes)

  Specifies the default value for this attribute used in the default account template.

• Account Template Value

  Specifies how the default value for this attribute is generated used in the default account template.

  • None

    Specifies that this attribute does not have a value in the default account template.

  • By Value

    Specifies the value of this attribute used in the default account template.

  • By Rule String

  Specifies that the value of this attribute used in the default account template is generated by a rule string.

  Note: For more information on Rule Strings, see the Administration Guide.

• Synchronized

  Specifies whether this attribute is updated when this account is synchronized with its templates.

• Cached

  Specifies that the attribute is stored by the Provisioning Server and can be retrieved without consulting the endpoint system.

  For example, credentials used to connect to the endpoint system must be cached, otherwise the user might have to provide the credentials every time the connector is acquired. You may also need to cache a value because querying an endpoint system for the value can take a long time to compute.

• Well Known Name

  Specifies whether this attribute is a well-known attribute.

• JavaBean Property Name

  Specifies the JavaBean Property name used for this attribute in the JIAM API. If you select a value in the Well-Known Name list, you cannot edit this value.

• Expensive Retrieval

  Specifies that this attribute's value may be too expensive to return in general searches. If selected, searches only return the attribute value if explicitly asked for.

• Converter Regex

  Defines the regular expression used to convert the attribute value.

• Converter Regex Style

  Specifies the syntax of the regular expression used by Converter Regex

  Values: perl5 or Java.

• Validating Regex

  Defines the regular expression used to validate user input.

• Validating Regex Style

  Specifies the syntax of the regular expression used by Validating Regex.

  Values: perl5, Java

• Validating Regex Hint

  Specifies the help message displayed if the input value does not match the validating regular expression.

• UI Field Length (String types only)

  Specifies the recommended character width of the user interface input field for this attribute. If not used, Connector Xpress uses the attributes data type and maximum length to define an appropriate input field length.

• Connector Generated

  Specifies the generator expression used by the Java CS.

  To pass the value to the endpoint system literally, enclose the expression in double quotes.

  Example: \"NEXT VALUE FOR my_sequence\"\'

  If you do not enclose the expression in double quotes, the connector must know how to interpret the value. For example, JDBC knows the value provided will be a sequence name.

  Example: \'my_sequence\'

• Is Connector Generated

  Specifies that that the value for property is generated implicitly by the endpoint. For example, true for IDENTITY columns in JDBC.

• Extended Properties

  Displays an extended set of metadata properties. These fields are displayed when you select the select the Show extended set of metadata properties on the Connector Xpress Preferences dialog.

  Note: For more information, see Extended Properties.