Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  • Context: The type of object this Identifier Assignment will apply to.
  • CO Group: As of Registry v4.1.0, Identifier Assignments can be restricted to members of a specified CO Group. CO People who are not members of this CO Group will not have an Identifier generated using this Identifier Assignment. (Only applies to CO Person context.)
  • Type: The type you wish to be populated in cm_identifiers:type. Note that Extended Types are available for Identifiers.
  • Email Type: If you select a type of "Mail" (ie: email), this field will become active. If you select an email type, then cm_email_addresses will be populated instead of cm_identifiers. (Does not apply to CO Group context.)
  • Login: In general, CO Person identifiers are not used to log in to COmanage services (Organizational Identities are), so this should generally be left unchecked. (Only applies to CO Person context.)
  • Algorithm: See Specifying Identifier Formats, below.
  • Format: See Specifying Identifier Formats, below. If no format is specified, identifiers will simply be assigned as an integer, eg 109 or 523788.
  • Permitted Characters: See Specifying Identifier Formats, below.
  • Minimum Length: If a generated Identifier is not at least this many characters, it will be rejected. See Sequenced Segments, below, for additional information. Available as of v4.4.0.
    • It is not possible to specify an overall maximum length. However, individual segments can be given maximum lengths (see below), such that the overall length cannot exceed the sum of the lengths of the individual segments.
  • Minimum: For Random identifiers, the minimum value that may be assigned. For Sequential identifiers, the first value to be assigned. As of v4.4.0, this field is labeled Minimum Value.
  • Maximum: For Random identifiers, the maximum value that may be assigned. Currently, the maximum may not exceed the value returned by PHP's mt_getrandmax() function, which is likely 2,147,483,647. As of v4.4.0, this field is labeled Maximum Value.
  • Enable Transliteration: See Transliteration, below.

Specifying Identifier Formats

...

(warning) Auto-generated identifiers are subject to Identifier Validation. Identifier Validator Plugins can be used to further constraint auto-generated identifiers.

Transliteration

As of Registry v4.4.0, Identifier Assignments support transliteration. This features uses PHP's Transliterator to convert non-ASCII7 characters to an ASCII7 representation. This may be useful when generating Identifiers, where there is a constraint on the characters that may be included in the generated Identifiers, for example for login usernames.

Care should be taken when using this feature, as in certain cases it is not possible to correctly transliterate a string without additional knowledge.

  • Japanese is unsupported. Japanese names will be transliterated using their Chinese readings, which is almost always going to be wrong.
  • Certain characters such as å can be transliterated multiple ways, in this example as a or aa. The preference may depend on the subject or the subject's nationality.

Before resorting to transliteration, consider alternate approaches, such as asking the subject for an Identifier that they would prefer.

(warning) This feature is Experimental and subject to change across minor releases.

Assigning Identifiers on Demand

...