Unify
This command generates a grammar file that contains one or more combined entities.
A combined entity is a single entity that combines the patterns for a predetermined set of entities. For example, in the PII grammar package there is an entity named pii/address/all
that matches a postal address from any supported country. This entity was created by combining existing entities such as pii/address/gb
, pii/address/fr
, pii/address/de
, and so on.
Eduction can find matches for a combined entity faster than it can find matches for the equivalent list of source entities, because in the combined entity the list of patterns is optimized as a single unit.
Eduction automatically returns matches using the source entity names, so you do not lose any information about which entity produced a match. For example, when you run Eduction and find matches for pii/address/all
, Eduction reports matches for pii/address/gb
or pii/address/fr
rather than for the combined entity.
The following table describes the parameters for this command.
-l <licensefile>
|
The file containing a valid license key for Eduction. This file can include the version key, concatenated to the license key with a semicolon ( If you do not specify a license key, edktool attempts to load the license |
-g <grammarfile>
|
A comma-separated list of grammar files that contain the source entities to combine. |
-e <entity>
|
The definition for a combined entity, in the form:
If you want to create more than one combined entity you can use the |
-o <outputfile>
|
The output grammar file. |
Examples
The following example creates a grammar file named custom.ecr
that contains an entity named pii/address/custom
, by combining the address entities for France and Germany.
edktool unify -o custom.ecr -g address.ecr -e pii/address/custom=pii/address/fr,pii/address/de
You can create more than one combined entity by passing the -e
parameter multiple times.
edktool unify -o custom.ecr -g address.ecr,telephone.ecr -e pii/address/custom=pii/address/fr,pii/address/de -e pii/telephone/context/custom=pii/telephone/context/fr,pii/telephone/context/de