Attribute definitions are the at the core of the match service. Attribute definitions are used to construct the Matchgrid, and to determine what attributes are accepted over the REST API.
Each attribute definition has several configuration options that determine how the attribute is used within Match Rules.
0000-00-00
, it will be treated as if no date of birth was provided.0000-00-00
, it will be treated as null and stored in the matchgrid as null (not 0000-00-00
).Attributes can be configured to appear as columns in the Matchgrid Index by enabling Display Field in Matchgrid Index.
If at Attribute is switched from Case Sensitive to Case Insensitive after the Matchgrid is built, the index for that Attribute should be reconstructed. Currently, this requires manually dropping the appropriate index using SQL, then rebuilding the Matchgrid as described below. (CO-2217) |
Attribute Groups link sets of Attributes together when there are multiple components to a complex Attribute. For example, a name typically consists of a "given" and a "family" component. Furthermore, there could be an "official" or "preferred" name. By creating an Attribute Group (eg: "official"), the individual Attribute components (eg: "given" and "family") can be linked together.
The name of the Attribute Group must match the type of the complex Attribute, as conveyed over the API. For example, if the following fragment is sent as part of an API request:
the Attribute Group name must be configured as "official". |
When connecting to COmanage Registry as a client, the following sample attribute configurations may be useful:
Date of Birth | Email Address | Identifier | Given Name1 | Family Name1 | |
---|---|---|---|---|---|
API Name | dateOfBirth | emailAddresses:address/type3 | identifiers:identifier/type 3 | names:given | names:family |
Alphanumeric | |||||
Case Sensitive | |||||
Null Equivalents | |||||
Attribute Map | If desired | ||||
Attribute Group2 | official | official |
1Name is configured as a single attribute (per type/group) in Registry, but multiple attributes (per type/group/field) in Match.
2The Attribute Group value must match the Match Server Attribute Type configured in Registry.
3type
must match the Match Server Attribute Type configured in Registry.
As of Match v1.1.0, a predefined set of Attributes may be instantiated via Configure > Attributes > Install Default Attributes. This set of predefined Attributes is not necessarily intended for production use, but instead to provide a starting point for Attribute configuration. This option will create an Attribute Group called "official" as well as several Attributes.
After the Attributes are defined (or subsequently updated), the Matchgrid must be built. This is the process where the configuration is translated to a SQL table for runtime use. If Attributes are updated, the Matchgrid will also be updated. Existing data will be preserved to the extent permitted by the new configuration.
To build a Matchgrid, go to the Matchgrid Management page (Match > Matchgrid Selection > Manage) and click Build.