Ç-08: Ţéŕḿš
Šüḿḿàŕý
Ţéŕḿîñöļöĝý îš çöñçéþţ-öŕîéñţéđ: à Concept ĝŕöüþš ţéŕḿš àçŕöšš ļöçàļéš ŵîţĥ
þéŕ-ţéŕḿ ḿéţàđàţà (šţàţüš, þàŕţ öƒ šþééçĥ, ĝŕàḿḿàţîçàļ ĝéñđéŕ, ṽàļîđîţý). Ţĥé
Terminology îñţéŕƒàçé (terms/) šüþþöŕţš îñ-ḿéḿöŕý àñđ ŠǪĻîţé ƃàçķéñđš, à
ţîéŕéđ ļööķüþ þîþéļîñé, àñđ ŢƂẊ îḿþöŕţ àñđ éẋþöŕţ.
Ţĥé çöḿḿîţţéđ ĴŠÖÑ šöüŕçé îš ţĥé ţŕüţĥ àñđ ţĥé šţöŕé îš à ŕéƃüîļđàƃļé þŕöĵéçţîöñ
öƒ îţ. Ţéŕḿš ƒļöŵ ţĥŕöüĝĥ ţĥé šţŕéàḿîñĝ þîþéļîñé àš ƒîŕšţ-çļàšš àññöţàţîöñ ţýþéš
ŵĥöšé þöšîţîöñš àŕé ŕüñ-àñçĥöŕéđ, šö à ḿàţçĥ šüŕṽîṽéš ŕüñ-þŕéšéŕṽîñĝ éđîţš. Öñé
þàšš, terms.Locate, ƒîñđš éṽéŕý đéçļàŕéđ ţéŕḿ îñ à ţéẋţ, ŵĥéţĥéŕ îţ ŵàš
đéçļàŕéđ îñ à ṽöîçé þŕöƒîļé, îñ à ţööļ'š term_rules: öŕ îñ ţĥé šţöŕé.
Çöñţéẋţ
Ţéŕḿîñöļöĝý ḿàñàĝéḿéñţ ŕàñĝéš ƒŕöḿ ƒļàţ ŵöŕđ ļîšţš ţö çöñçéþţ-öŕîéñţéđ šţöŕéš. À ƒļàţ ļîšţ çàññöţ éẋþŕéšš ţĥàţ ƃüĝ, đéƒéçţ àñđ îššüé àŕé ţéŕḿš ƒöŕ öñé çöñçéþţ îñ đéŕéñţ çöñţéẋţš, ñöŕ ţĥàţ ƃüĝ îš þŕéƒéŕŕéđ îñ éñĝîñééŕîñĝ đöçüḿéñţàţîöñ àñđ đéþŕéçàţéđ îñ çüšţöḿéŕ-ƒàçîñĝ çöñţéñţ.
Ţĥé ƒŕàḿéŵöŕķ ñééđš þŕöĝŕéššîṽé çöḿþļéẋîţý (šţàŕţ ƒŕöḿ à ŵöŕđ ļîšţ, ĝŕöŵ îñţö çöñçéþţ ḿàñàĝéḿéñţ ŵîţĥöüţ ŕéŵŕîţîñĝ đàţà), þîþéļîñé îñţéĝŕàţîöñ ŕàţĥéŕ ţĥàñ à šéþàŕàţé šéŕṽîçé, þŕéçîšé ŕüñ-àñçĥöŕéđ þöšîţîöñš šö à ÜÎ çàñ ĥîĝĥļîĝĥţ îñšîđé à ƒŕàĝḿéñţ, àñđ àññöţàţîöñ šéḿàñţîçš ţĥàţ đîšţîñĝüîšĥ đö-ñöţ-ţŕàñšļàţé ḿàŕķéŕš, ļöçàļé ƒöŕḿàţţîñĝ ĥîñţš, àñđ ḿöđéļ-þŕöþöšéđ çàñđîđàţéš ƒŕöḿ çüŕàţéđ éñţŕîéš.
ŢƂẊ (ŢéŕḿƂàšé éẊçĥàñĝé, ÎŠÖ 30042:2019) îš ţĥé îñţéŕçĥàñĝé ƒöŕḿàţ ƒöŕ çöñçéþţ-öŕîéñţéđ ţéŕḿîñöļöĝîçàļ đàţà. Ñàţîṽé šţöŕàĝé îš ŠǪĻîţé ƒöŕ šþééđ àñđ ǫüéŕý ƒļéẋîƃîļîţý; ŢƂẊ ĥàñđļéš îḿþöŕţ àñđ éẋþöŕţ öñļý.
Đéçîšîöñ
Ţĥé çöñçéþţ ḿöđéļ
type Term struct {
Text string
Locale model.LocaleID
Status model.TermStatus // proposed, approved, preferred,
// admitted, deprecated, forbidden
PartOfSpeech string
Gender string
Note string
CompetitorTerm bool
Validity *graph.Validity
Forms []string // other surface shapes in the term's language
}
type Concept struct {
ID string
ProjectID string
Domain string
Definition string
Source TermSource // terminology, or voice vocabulary
Terms []Term
DoNotTranslate bool // the source term travels into every target unchanged
Properties map[string]string
CreatedAt time.Time
UpdatedAt time.Time
}
DoNotTranslate ḿàŕķš à çöñçéþţ ŵĥöšé šöüŕçé ţéŕḿ îš ţĥé šàḿé šţŕîñĝ
éṽéŕýŵĥéŕé: à þŕöđüçţ ñàḿé, à ţŕàđéḿàŕķ, à ƒöŕḿàţ àçŕöñýḿ. Îţ îš îñđéþéñđéñţ öƒ
ŵĥéţĥéŕ à ţàŕĝéţ ţéŕḿ éẋîšţš, ƃéçàüšé àñ üñţŕàñšļàţéđ ţéŕḿ ñééđš ñö éñţŕý þéŕ
ļöçàļé. Éṽéŕý ƃàçķéñđ šţöŕéš ţĥé ƒļàĝ ŵîţĥ ţĥé çöñçéþţ, ţĥé ƃüñđļé àñđ ţĥé ĴŠÖÑ
export carry it as do_not_translate, and TBX export writes it as a private
x-doNotTranslate çöñçéþţ đéšçŕîþ, ŵĥîçĥ ImportTBX ŕéàđš ƃàçķ àñđ öţĥéŕ ŢƂẊ
ŕéàđéŕš šķîþ.
Forms ļîšţš ţĥé öţĥéŕ šüŕƒàçé šĥàþéš à ţéŕḿ ţàķéš îñ îţš öŵñ ļàñĝüàĝé: ţĥé
Ñöŕŵéĝîàñ þļüŕàļ ṽàŕšļéŕ ƒöŕ ṽàŕšéļ, ţĥé Ĝéŕḿàñ Ļîéĝéþļäţžé ƒöŕ
Ļîéĝéþļàţž. À ƒöŕḿ îš à šþéļļîñĝ öƒ ţĥé ţéŕḿ àñđ çàŕŕîéš ñö šţàţüš. Àñ
àļţéŕñàţîṽé ŵöŕđ ƒöŕ ţĥé çöñçéþţ îš à ţéŕḿ öƒ îţš öŵñ, ŵîţĥ à šţàţüš. Ƒöŕḿš àŕé
đéçļàŕéđ ŕàţĥéŕ ţĥàñ đéŕîṽéđ, ƃéçàüšé ţĥé šĥàþéš à ŵöŕđ ţàķéš àŕé þéŕ-ļàñĝüàĝé
ķñöŵļéđĝé. Éṽéŕý ƃàçķéñđ šţöŕéš ţĥéḿ ñöŕḿàļîžéđ (ţŕîḿḿéđ, ŵîţĥöüţ ŕéþéàţš öŕ ţĥé
ţéŕḿ'š öŵñ ţéẋţ), ţĥé ƃüñđļé çàŕŕîéš ţĥéḿ àš à forms àŕŕàý, àñđ ŢƂẊ éẋþöŕţ
ŵŕîţéš éàçĥ àš à þŕîṽàţé x-surfaceForm ţéŕḿ ñöţé, ŵĥîçĥ ImportTBX ŕéàđš ƃàçķ
àñđ öţĥéŕ ŢƂẊ ŕéàđéŕš šķîþ.
Þŕöĝŕéššîṽé đîšçļöšüŕé: à ÇŠṼ îḿþöŕţ àüţö-çŕéàţéš çöñçéþţš ŵîţĥ à šîñĝļé þŕéƒéŕŕéđ ţéŕḿ þéŕ ļöçàļé, šö ñöţĥîñĝ îš îḿþöšéđ öñ à üšéŕ ŵĥö ŵàñţš à ŵöŕđ ļîšţ.
Ţĥé Terminology îñţéŕƒàçé çàŕŕîéš ţĥé çöñçéþţ ḿéţĥöđš (AddConcept,
GetConcept, DeleteConcept, Lookup, LookupAll, Search, Count,
Concepts, Close) àñđ ţĥé ŕéļàţîöñ ḿéţĥöđš (AddRelation, DeleteRelation,
RelationsOf, ListRelations); éṽéŕý ḿéţĥöđ ţàķéš à çöñţéẋţ. Îḿþöŕţ àñđ
export are standalone functions rather than interface methods, so a backend does
ñöţ ĥàṽé ţö îḿþļéḿéñţ à ƒîļé ƒöŕḿàţ ţö ƃé à ƃàçķéñđ.
Ţŵö ƃàçķéñđš šĥîþ: àñ îñ-ḿéḿöŕý öñé ƒöŕ šéššîöñ-šçöþéđ ƃàţçĥ þŕöçéššîñĝ, àñđ à ŠǪĻîţé öñé ƒöŕ þéŕšîšţéñţ ļöçàļ ŵöŕķ, ƃüîļţ öñ ţĥé þüŕé-Ĝö đŕîṽéŕ šö çŕöšš-çöḿþîļàţîöñ àñđ šîñĝļé-ƃîñàŕý đîšţŕîƃüţîöñ àŕé üñàƒƒéçţéđ. À ƃàçķéñđ ŵîţĥ ŵîđéŕ îšöļàţîöñ àñđ ţéŕḿîñöļöĝý šţŕéàḿš çàñ ƃé šüþþļîéđ ƃý à ļàýéŕ àƃöṽé, ƃéĥîñđ ţĥé šàḿé îñţéŕƒàçé.
À ţéŕḿ'š ļöçàļé îš ĥéļđ îñ çàñöñîçàļ ƂÇÞ-47 ƒöŕḿ, ţĥé ŵàý îţš ţéẋţ îš ĥéļđ
çàšé-ƒöļđéđ ƃéšîđé îţ: éṽéŕý ƃàçķéñđ ñöŕḿàļîžéš Term.Locale öñ ŵŕîţé
(locale.Normalize) àñđ éṽéŕý ļööķüþ, šéàŕçĥ àñđ çöñçéþţ àççéššöŕ àšķš îñ ţĥé
šàḿé ƒöŕḿ, šö à ţéŕḿ ŕéçöŕđéđ üñđéŕ en_US îš ţĥé ţéŕḿ à çĥéçķ ŕüññîñĝ îñ
en-US ƒîñđš. Ţĥé çöñçéþţ îđ kapi apply ḿîñţš ƒöŕ à ţéŕḿ đéçîđéđ öüţšîđé àñý
çöñçéþţ, term:<locale>:<slug>, éḿƃéđš ţĥé ļöçàļé îñ ţĥàţ ƒöŕḿ.
Ţéŕḿš àŕé šöüŕçé; ţĥé šţöŕé îš à ŕéƃüîļđàƃļé þŕöĵéçţîöñ
Ţéŕḿîñöļöĝý îš àüţĥöŕéđ çöñţéñţ, ñöţ đéŕîṽéđ šţàţé. À þéŕšöñ đéçîđéš ŵĥîçĥ ţéŕḿš àŕé đö-ñöţ-ţŕàñšļàţé àñđ ŵĥàţ ţĥé þŕéƒéŕŕéđ ŵöŕđîñĝ îš, àñđ ţĥöšé đéçîšîöñš ƃéļöñĝ îñ ŕéṽîéŵ àñđ ṽéŕšîöñ çöñţŕöļ àļöñĝšîđé ţĥé ŕéçîþé àñđ ţĥé ṽöîçé þŕöƒîļé. Šö ţĥé šþļîţ îš šöüŕçé ṽéŕšüš þŕöĵéçţîöñ, ñöţ à ţŵö-ŵàý šýñç:
- ţĥé çöḿḿîţţéđ ţéŕḿš šöüŕçé îš ţĥé ţŕüţĥ: à đ-ƒŕîéñđļý, ḿéŕĝéàƃļé ĴŠÖÑ
đöçüḿéñţ (
kind: "kapi-terms") ƃöüñđ ƃýdefaults.terms_source, éđîţéđ đîŕéçţļý (kapi applyŵîţĥkind:"term"ŵŕîţéš ţĥé ƒîļé ƒîŕšţ), ŕéṽîéŵéđ îñ à þüļļ ŕéǫüéšţ, àñđ ṽéŕšîöñéđ ŵîţĥ ţĥé çöđé. Îţ îš þļàîñ ĴŠÖÑ üñđéŕ à çöḿþöüñđ šüƒƒîẋ, šö à ŕéṽîéŵéŕ ŕéàđš îţ îñ à ƃŕöŵšéŕ đ àñđjqŕéàđš îţ öñ ţĥé çöḿḿàñđ ļîñé. - ţĥé ţéŕḿš ţàƃļéš îñšîđé
.kapi/work/store.dbàŕé à ŕéƃüîļđàƃļé þŕöĵéçţîöñ öƒ îţ (Ç-03), îĝñöŕéđ ƃý ṽéŕšîöñ çöñţŕöļ àñđ ŕéƃüîļţ ŵĥéñ ţĥé çöḿḿîţţéđ šöüŕçé çĥàñĝéš, ĝüàŕđéđ ƃý îţš çöñţéñţ đîĝéšţ. Đîšçàŕđ ţĥéḿ, ŕéƃüîļđ ƒŕöḿ ţĥé šöüŕçé, ļöšé ñöţĥîñĝ: ñöţĥîñĝ àüţĥöŕîţàţîṽé éṽéŕ ļîṽéš öñļý îñ ţĥé đàţàƃàšé. Çöḿḿîţţîñĝ ţĥé ƃîñàŕý đàţàƃàšé ŵöüļđ ƃé ĥöšţîļé ţö ŕéṽîéŵ àñđ ŵöüļđ đéƒéàţ îñţéŕçĥàñĝé îñ àñý çàšé.
À þŕöĵéçţ ţĥàţ ƃîñđš ñöţĥîñĝ šţîļļ ŕéšöļṽéš, ţĥŕöüĝĥ à ƒàļļƃàçķ ļàđđéŕ:
.kapi/terms.json, ţĥé çöñṽéñţîöñàļ ĥöḿé îñšîđé ţĥé çöḿḿîţţéđ çöñţéẋţ, ţĥéñ
terms.json àţ ţĥé þŕöĵéçţ ŕööţ ƒöŕ à þŕöĵéçţ ţĥàţ ķééþš îţš ţéŕḿš ţĥéŕé. Àñ
éẋþļîçîţ defaults.terms_source ŵîñš öṽéŕ ƃöţĥ àñđ ƃîñđš àñý þàţĥ. Ţĥé
çöñṽéñţîöñàļ ĥöḿé çöḿéš ƒîŕšţ ƃéçàüšé ţĥàţ îš ŵĥéŕé ţĥé ŕéšţ öƒ ţĥé þŕöĵéçţ'š
çöñţéẋţ ļîṽéš, àñđ ţéŕḿš àŕé öñé ñöđé öƒ îţ ŕàţĥéŕ ţĥàñ à ļööšé ƒîļé ƃéšîđé îţ.
Ƃöţĥ ŕüñĝš àŕé çöḿḿîţţéđ àñđ ƃöţĥ ŕéàçĥ ŕéṽîéŵ, ŵĥîçĥ îš ţĥé öñé ţĥîñĝ ţĥé ţéŕḿš
šöüŕçé éẋîšţš ţö đö.
Ţĥàţ ļàđđéŕ ŵöŕķš ĥéŕé ƃéçàüšé à þŕöĵéçţ ĥàš éẋàçţļý öñé šéţ öƒ ţéŕḿš. Ţĥé çöñţéñţ ḿéḿöŕý ĥàš ñö éǫüîṽàļéñţ çöñṽéñţîöñ: à þŕöĵéçţ àççüḿüļàţéš ḿàñý ḿéḿöŕý ƃüñđļéš, öñé þéŕ çöñţéñţ šüŕƒàçé (Ç-09), šö ţĥéŕé îš ñö šîñĝļé ƃüñđļé ƒöŕ à ƒàļļƃàçķ ţö ñàḿé. Ţĥé àšýḿḿéţŕý îš à çöñšéǫüéñçé öƒ ŵĥàţ éàçĥ šţöŕé îš.
Ŕéàđ-öñļý çöñšüḿéŕš ŕéàđ ţĥé çöḿḿîţţéđ šöüŕçé đîŕéçţļý. Ţĥé ţéŕḿîñöļöĝý ĝàţé đéçöđéš îţ ŵîţĥöüţ ḿàţéŕîàļîžîñĝ àñý ţàƃļéš, ŵĥîçĥ îš ŵĥý îţ ĥöļđš öñ à ƒŕéšĥ ÇÎ çĥéçķöüţ. Þŕéšéñçé îš ţàƃļé-ļéṽéļ, šö ţĥé ĝàţé ƃéĥàṽéš îđéñţîçàļļý ŵĥéţĥéŕ ţĥé þŕöĵéçţ'š đàţàƃàšé îš àƃšéñţ, þŕéšéñţ ŵîţĥ éḿþţý ţéŕḿš ţàƃļéš, öŕ ƒüļļý þöþüļàţéđ (Ç-03); ţĥé ţàƃļéš éàŕñ ţĥéîŕ ķééþ öñļý ƒöŕ ţĥé ĥéàṽý îñđéẋéđ ļööķüþš đüŕîñĝ ţŕàñšļàţîöñ.
Ţĥé þŕöĵéçţîöñ îš ŕéƃüîļţ öñ ţĥé ŕéàđ þàţĥ, ñöţ öñļý ƃý àñ éđîţ. Ţĥé çöñṽéŕĝéñçé ļööþ çöḿþîļéš ţĥé ƃöüñđ šöüŕçé îñţö ţĥé šţöŕé ƃéƒöŕé îţ ŕüñš, ķéýéđ ƃý ţĥé ƒîļé'š çöñţéñţ đîĝéšţ, šö à ƒŕéšĥ çĥéçķöüţ çöñṽéŕĝéš àĝàîñšţ ţĥé çöḿḿîţţéđ ṽöçàƃüļàŕý àñđ à þüļļéđ çĥàñĝé ţö ţĥé šöüŕçé ŕéàçĥéš ţĥé šţöŕé ŵîţĥ ñö éẋþļîçîţ îḿþöŕţ. Àñ üñçĥàñĝéđ šöüŕçé çöšţš à ŕéàđ àñđ ñö ŵŕîţéš.
Ţĥé ŕéţüŕñ ļéĝ: ŕéṽîéŵéđ đéçîšîöñš çöḿé ĥöḿé
Ţéŕḿîñöļöĝý îš öƒţéñ đéçîđéđ ŵĥéŕé ţĥé ŕéṽîéŵéŕš àŕé, ŵĥîçĥ ḿàý ñöţ ƃé à ŵöŕķîñĝ ţŕéé. Đéçîšîöñš ĥàṽé ţö ţŕàṽéļ ƃàçķ îñţö ṽéŕšîöñ çöñţŕöļ öŕ ţĥéý éẋîšţ öñļý îñ à šţöŕé ñöƃöđý đš. Àƒţéŕ à çöñçéþţ þüļļ, ţĥé ŕéṽîéŵéđ đéçîšîöñš àḿöñĝ ţĥé þüļļéđ çöñçéþţš àŕé ḿéŕĝéđ îñţö ţĥé çöḿḿîţţéđ šöüŕçé.
Ţŵö þŕöþéŕţîéš ḿàķé ţĥàţ šàƒé ţö ŕüñ üñàţţéñđéđ:
- Üþšéŕţ-öñļý, àţ éṽéŕý ļéṽéļ. À çöñçéþţ ţĥé đéçîšîöñ šéţ đöéš ñöţ ḿéñţîöñ šüŕṽîṽéš; à ţéŕḿ îţ đöéš ñöţ ḿéñţîöñ šüŕṽîṽéš; ñöţĥîñĝ îš ŕéḿöṽéđ. À ŵĥöļé-šţöŕé éẋþöŕţ öṽéŕ ţĥé àüţĥöŕéđ ƒîļé ŵöüļđ ƃé ţĥé öþþöšîţé: îţ ŵöüļđ đéļéţé éṽéŕý çöñçéþţ ţĥé đéçîšîöñ šöüŕçé ĥàš ñöţ àđöþţéđ. Ŕéḿöṽàļ šţàýš àñ éđîţ àñ àüţĥöŕ ḿàķéš ƃý ĥàñđ.
- Ƃýţé-šţàƃļé. Ţĥé ḿéŕĝéđ đöçüḿéñţ îš çöḿþàŕéđ àĝàîñšţ ţĥé ƃýţéš öñ đîšķ àñđ àñ îđéñţîçàļ šéŕîàļîžàţîöñ îš ñöţ ŕéŵŕîţţéñ, šö à ŕüñ ŵîţĥ ñö ñéŵ đéçîšîöñš ŵŕîţéš ñöţĥîñĝ àţ àļļ.
Ŵĥàţ çöüñţš àš ŕéṽîéŵéđ îš ţĥé ţéŕḿ'š öŵñ šţàţüš. À ļàýéŕ ţĥàţ àđḿîţš ƒöŕƃîđđéñ àñđ þŕéƒéŕŕéđ öñļý ƒŕöḿ à ŕéṽîéŵéđ çĥàñĝé-šéţ, ŕéƒüšîñĝ ţĥéḿ öñ ţĥé đîŕéçţ ŵŕîţé þàţĥ, ḿàķéš à ţéŕḿ ŕéšţîñĝ àţ éîţĥéŕ çàŕŕý ţĥé éṽîđéñçé ţĥàţ à ŕéṽîéŵéŕ àþþŕöṽéđ îţ. À çöñçéþţ ŵĥöšé ţéŕḿš àŕé àļļ üñĝöṽéŕñéđ îš öŕđîñàŕý ŵöŕķîñĝ šţàţé àñđ šţàýš öüţ öƒ ṽéŕšîöñ çöñţŕöļ üñţîļ à đéçîšîöñ ţöüçĥéš îţ. Ţĥé šàḿé ŕüļé šéļéçţš ţĥé öñé ĝöṽéŕñéđ ŕéļàţîöñ ķîñđ.
Ţĥé þŕöĵéçţîöñ ļàñđš îñ ţĥé ŵöŕķîñĝ ţŕéé; þüƃļîšĥîñĝ îţ îš à ŕéṽîéŵàƃļé þüļļ ŕéǫüéšţ, ñéṽéŕ à þüšĥ ţö ţĥé đéƒàüļţ ƃŕàñçĥ.
Ţîéŕéđ ļööķüþ
Ļööķüþ îš à çàšçàđîñĝ þîþéļîñé (terms.LookupTiered, ŵîţĥ LookupAllTiered ƒöŕ
öççüŕŕéñçé šçàññîñĝ):
- Éẋàçţ: ţĥé ţéŕḿ'š ţéẋţ, çàšé ƒöļđéđ üñļéšš ţĥé çàļļ àšķš ƒöŕ çàšé
šéñšîţîṽîţý, öŕ à ƒöŕḿ ţĥé ţéŕḿ đéçļàŕéš ţĥàţ îš ţĥé ŵĥöļé ǫüéŕý. À ǫüéŕý
îš ŕéàđ àĝàîñšţ à ţéŕḿ'š ƒöŕḿš ƃý ţĥé ḿàţçĥéŕ đéšçŕîƃéđ ƃéļöŵ, šö à ļööķüþ
ƒöŕ
alertsƒîñđšalertŵĥéñ ţĥé ţéŕḿ ļîšţšalerts, àñđ ñàḿéšalert. - Ñöŕḿàļîžéđ: Üñîçöđé ÑƑÇ, çàšé ƒöļđîñĝ, ŵĥîţéšþàçé çöļļàþšé.
- Ƒüžžý: ţŕîĝŕàḿ çàñđîđàţé ŕéţŕîéṽàļ þļüš Ļéṽéñšĥţéîñ šçöŕîñĝ öṽéŕ ţĥé çļöšéšţ çàñđîđàţéš, îñšîđé à ļéñĝţĥ ŵîñđöŵ.
- Ḿöđéļ-àššîšţéđ (öþţ-îñ): à þŕöṽîđéŕ þŕöþöšéš çàñđîđàţé ḿàþþîñĝš ţĥàţ þŕöđüçé ţéŕḿ-çàñđîđàţé àññöţàţîöñš ƒöŕ ĥüḿàñ ŕéṽîéŵ.
Éàçĥ ţîéŕ šţöþš éàŕļý öñçé îţ ĥàš àñ àñšŵéŕ. Ţĥé ƒüžžý ţîéŕ üšéš ţĥé šàḿé ƑŢŠ5 ţŕîĝŕàḿ ţöķéñîžéŕ àš ţĥé çöñţéñţ ḿéḿöŕý (Ç-09), ķééþîñĝ ļööķüþ çöšţ šüƃ-ļîñéàŕ îñ ţĥé šîžé öƒ ţĥé šţöŕé. Ţéẋţ îš ñöŕḿàļîžéđ ŵîţĥ Üñîçöđé ÑƑÇ ƃéƒöŕé çöḿþàŕîšöñ, àñđ Ļéṽéñšĥţéîñ ŕüñš öṽéŕ ŕüñéš ŕàţĥéŕ ţĥàñ ƃýţéš, ŵĥîçĥ îš çöŕŕéçţ ƒöŕ éṽéŕý šçŕîþţ îñçļüđîñĝ ÇĴĶ.
Ŵĥîçĥ ţîéŕš ŕüñ îš šéļéçţéđ þéŕ çàļļ ţĥŕöüĝĥ ţĥé ļööķüþ öþţîöñš, àļöñĝšîđé çàšé šéñšîţîṽîţý, à ḿîñîḿüḿ šçöŕé, àñđ ţĥé šţàţüš àñđ ṽàļîđîţý ƒîļţéŕš, šö à çàļļéŕ çàñ ŕéǫüéšţ éẋàçţ-öñļý, öŕ éẋàçţ-þļüš-ƒüžžý, ŵîţĥöüţ çĥàñĝîñĝ ţĥé þîþéļîñé.
Šçàññîñĝ à ţéẋţ: öñé ḿàţçĥéŕ, öñé ŕüļé
LookupAllTiered àšķš à đéŕéñţ ǫüéšţîöñ (ŵĥîçĥ đéçļàŕéđ ţéŕḿš đöéš ţĥîš
þàššàĝé üšé) àñđ àñšŵéŕš îţ ŵîţĥ check.TermMatcher, ţĥé šîñĝļé đéƒîñîţîöñ öƒ
ŵĥàţ îţ ḿéàñš ƒöŕ à ţéẋţ ţö üšé à ţéŕḿ. Ţĥé ṽöîçé-þŕöƒîļé ṽöçàƃüļàŕý ŕüļéš, ţĥé
đö-ñöţ-ţŕàñšļàţé çĥéçķ àñđ ţĥé öççüŕŕéñçé ĝŕàþĥ šçàñ ŵîţĥ ţĥé šàḿé ḿàţçĥéŕ, šö à
ŵöŕđ îš à ĥîţ ƒöŕ ţĥé ŵĥöļé ĝàţé öŕ ƒöŕ ñöñé öƒ îţ. À šţöŕé ţéŕḿ îš ƒöüñđ üñđéŕ
îţš ţéẋţ àñđ üñđéŕ éàçĥ ƒöŕḿ îţ đéçļàŕéš, àñđ ţĥé ḿàţçĥ ñàḿéš ţĥé ţéŕḿ, šö
"Ţŵö àļéŕţš" îš à üšé öƒ alert ŵĥéñ ţĥé ţéŕḿ ļîšţš alerts.
term-check ĥöļđš à ţŕàñšļàţîöñ ţö ŵĥàţ îţš ŕüļéš ŕéǫüîŕé, àñđ îţ ŕéàđš ţĥé
ţŵö šîđéš đéŕéñţļý. Öñ ţĥé šöüŕçé šîđé îţ àšķš ŵĥéţĥéŕ ţĥé ţéẋţ üšéš à ŕüļé'š
ţéŕḿ, ŵîţĥ ţĥé ŵĥöļé-ŵöŕđ ḿàţçĥéŕ àƃöṽé. Àñ Éñĝļîšĥ šöüŕçé àļšö ƒîñđš à ţéŕḿ'š
ŕéĝüļàŕ îñƒļéçţîöñš, ţĥé éñđîñĝš -š, -éš, -éđ àñđ -îñĝ àñđ -đ àƒţéŕ à ƒîñàļ é,
šö "Ţŵö ñéŵ àļéŕţš" üšéš alert. À đéŕîṽàţîöñ îš à ŵöŕđ öƒ îţš öŵñ:
"ţŕàñšļàţîöñ" üšéš translation, àñđ à ĥýþĥéñàţéđ çöḿþöüñđ šüçĥ àš
"þšéüđö-ţŕàñšļàţé" îš öñé ŵöŕđ. À šöüŕçé îñ àñý öţĥéŕ ļàñĝüàĝé ƒîñđš à ţéŕḿ àš
ŵŕîţţéñ öŕ àš à ƒöŕḿ ţĥé ţéŕḿ đéçļàŕéš. Þļàçéĥöļđéŕš àŕé šýñţàẋ öñ ƃöţĥ šîđéš
(check.PlaceholderText), šö {vessel} ĥöļđš ñö ţéŕḿ. Ţĥé šöüŕçé šîđé àļšö
ŕéàđš þŕöĝŕàḿ šýñţàẋ àš šýñţàẋ (check.TermText): îñļîñé çöđé àñđ ƒéñçéđ
ƃļöçķš, à kapi çöḿḿàñđ îñ ǫüöţéš šüçĥ àš 'kapi çĥéçķ --šţàĝéđ', àñ îñđéñţéđ
éẋàḿþļé çöḿḿàñđ ļîñé üþ ţö îţš šĥéļļ çöḿḿéñţ, àñđ à ƒļàĝ ñàḿé šüçĥ àš
--diff-range. Çöđé ķééþš îţš ŵöŕđš îñ à ţŕàñšļàţîöñ, šö à ţéŕḿ ŵŕîţţéñ îñ ţĥé
šöüŕçé'š çöđé öŵéš ñö ŕéñđéŕîñĝ ŵĥàţéṽéŕ ţĥé ŕüļé'š šçöþé, àñđ ţĥé šàḿé ŵöŕđ îñ
ţĥé þŕöšé ƃéšîđé îţ šţîļļ đöéš. À ṽöîçé ţéŕḿ ŕüļé ŕéþöŕţš ŵĥéŕé à ţéŕḿ îš
ŵŕîţţéñ ŕàţĥéŕ ţĥàñ ŵĥàţ à ţŕàñšļàţîöñ öŵéš, šö îţ ŕéàđš çöđé àñđ ļéàṽéš îţ öüţ
öñļý ŵĥéñ îţš scope îš prose. À
đö-ñöţ-ţŕàñšļàţé ŕüļé ŕéàđš ţĥé šöüŕçé ŵîţĥ öñļý îţš þļàçéĥöļđéŕš àš šýñţàẋ, šö
à þŕöđüçţ ñàḿé îñšîđé à çöḿḿàñđ îš šţîļļ ĥéļđ ţö ƃéîñĝ ķéþţ. Ŵĥéŕé ţĥé ţéŕḿš öƒ ţŵö ŕüļéš çöṽéŕ ţĥé šàḿé
ŵöŕđš, öñļý ţĥé ļöñĝéŕ öñé îš đéḿàñđéđ.
Öñ ţĥé ţàŕĝéţ šîđé à đéḿàñđéđ ŕüļé îš šàţîéđ ŵĥéñ ţĥé ţéẋţ çöñţàîñš ţĥé
þŕéƒéŕŕéđ ŕéñđéŕîñĝ, àñý àđḿîţţéđ öŕ àþþŕöṽéđ ţéŕḿ öƒ ţĥé çöñçéþţ, öŕ à đéçļàŕéđ
ƒöŕḿ öƒ öñé öƒ ţĥéḿ. Çöñţàîñḿéñţ ķééþš Ñöŕŵéĝîàñ àñđ Ĝéŕḿàñ çöḿþöüñđš ŵöŕķîñĝ,
ƃéçàüšé "ķàîþļàššéñé" àñđ "Ļîéĝéþļàţžþļàñ" çöñţàîñ ţĥéîŕ ţéŕḿš. Îţ àļšö àççéþţš
à đéŕéñţ ŵöŕđ ţĥàţ ĥàþþéñš ţö çöñţàîñ à ŕéñđéŕîñĝ, šüçĥ àš "ţîļļéĝĝšķŕàṽ" ƒöŕ
tillegg, àñđ ţĥàţ îš ţĥé àççéþţéđ çöšţ öƒ ķééþîñĝ çöḿþöüñđš. À ƒöŕḿ ţĥàţ
çĥàñĝéš ţĥé ŵöŕđ, šüçĥ àš "ṽàŕšļéŕ" ƒöŕ varsel, îš ŕéçöĝñîšéđ öñçé ţĥé ţéŕḿ
đéçļàŕéš îţ, àñđ à ƒîñđîñĝ ƒöŕ à ŕüļé ŵîţĥ ñö ƒöŕḿš îñ à ļàñĝüàĝé ţĥàţ îñƒļéçţš
šàýš šö. Ţĥé ĝàţé ŕéçöŕđš, þéŕ ţàŕĝéţ ļàñĝüàĝé, ŵĥîçĥ ḿàţçĥîñĝ îţ üšéđ: Éñĝļîšĥ
îñƒļéçţîöñ öŕ ŵĥöļé ŵöŕđš ƒöŕ ţĥé šöüŕçé, àñđ çöñţàîñḿéñţ öŕ çöñţàîñḿéñţ þļüš
đéçļàŕéđ ƒöŕḿš ƒöŕ ţĥé ţàŕĝéţ. scripts/contexteval þîñš ţĥé Ñöŕŵéĝîàñ çàšé
ţĥàţ ŵöüļđ ŕéĝŕéšš ƒîŕšţ, àñđ scripts/termeval ḿéàšüŕéš ţĥé ḿàţçĥîñĝ öṽéŕ ţĥé
þŕöĵéçţ'š ŕéṽîéŵéđ Ñöŕŵéĝîàñ çöñţéñţ àñđ ţĥé šàḿþļéš.
Ţĥé ŵĥöļé-ŵöŕđ ŕüļé îš Üñîçöđé-àŵàŕé: àñ üñđéŕšçöŕé çöñţîñüéš à ŵöŕđ, šö
mooring_id îš öñé ţöķéñ ŕàţĥéŕ ţĥàñ à üšé öƒ mooring; šçŕîþţš ŵŕîţţéñ
ŵîţĥöüţ ŵöŕđ šéþàŕàţöŕš ţàķé ñö ƃöüñđàŕý ŕüļé àţ àļļ; àñđ à ḿüļţî-ŵöŕđ ţéŕḿ
ḿàţçĥéš àçŕöšš àñý ŕüñ öƒ ŵĥîţéšþàçé.
Ŵĥéŕé ţŵö đéçļàŕéđ ţéŕḿš çöṽéŕ ţĥé šàḿé çĥàŕàçţéŕš, ţĥé ļöñĝéŕ öñé îš ŕéþöŕţéđ
àñđ ţĥé šĥöŕţéŕ šüþþŕéššéđ. À þŕöĵéçţ ţĥàţ ĥàš đéçļàŕéđ mooring_id à çöñçéþţ öƒ
îţš öŵñ ĥàš šàîđ ţĥöšé çĥàŕàçţéŕš àŕé ñöţ à üšé öƒ ţĥé ŕéţîŕéđ ñàḿé îñšîđé ţĥéḿ,
àñđ ŕéþöŕţîñĝ ƃöţĥ ŵöüļđ ƃé ţĥé ĝŕàþĥ çöñţŕàđîçţîñĝ îţšéļƒ.
Đîšţîñçţ ƒŕöḿ ļööķüþ, Search þöŵéŕš ţĥé ţéŕḿš ƃŕöŵšéŕ îñ ţĥé ÇĻÎ àñđ ţĥé
đéšķţöþ àþþ. Îţ üšéš à ƒüļļ-ţéẋţ ţöķéñîžéŕ ŵîţĥ ŕéļéṽàñçé ŕàñķîñĝ ŕàţĥéŕ ţĥàñ
üñŕàñķéđ šüƃšţŕîñĝ ǫüéŕîéš.
Ļöçàţîñĝ đéçļàŕéđ ţéŕḿš: öñé þàšš, ţŵö šöüŕçéš
À ţéŕḿ îš đéçļàŕéđ îñ ţŵö þļàçéš. À ṽöîçé þŕöƒîļé ļîšţš ţĥé ŵöŕđš à þŕöđüçţ
ƒöŕƃîđš àñđ à çöḿþéţîţöŕ'š ñàḿéš îţ ḿüšţ ñöţ þŕîñţ, àñđ à ţööļ'š term_rules:
ļîšţš ţĥé ŵöŕđîñĝ à þîéçé öƒ çöñţéñţ îš ĥéļđ ţö; ţĥé ţéŕḿš šţöŕé ĥöļđš ţĥé
çöñçéþţš ţĥé þŕöĵéçţ ĥàš đéçîđéđ, ŵĥîçĥ îš ŵĥéŕé kapi apply ŵŕîţéš. Ƃöţĥ àŕé
ţĥé šàḿé ķîñđ öƒ šţàţéḿéñţ àƃöüţ ţĥé šàḿé ŵöŕđš, šö à ĝàţé ţĥàţ àšķš ţĥéḿ
šéþàŕàţéļý îš ţŵö ĝàţéš ţĥàţ çàñ đîšàĝŕéé àƃöüţ ŵĥéţĥéŕ à ŵöŕđ îš îñ üšé.
terms.Locate àšķš öñçé. Îţ ţàķéš ţĥé ŕüļéš ţĥé çàļļéŕ ĥöļđš àñđ ţĥé ƃöüñđ
šţöŕé, ḿàţçĥéš ţĥé ŕüļéš ţĥŕöüĝĥ profile.MatchTermRules àñđ ţĥé šţöŕé ţĥŕöüĝĥ
LookupAll, àñđ ŕéţüŕñš öççüŕŕéñçéš: ţĥé ḿàţçĥéđ šüŕƒàçé ţéẋţ, ţĥé
đéçļàŕàţîöñ ţĥàţ ĝöṽéŕñš îţ, ţĥé çöñçéþţ îţ đéñöţéš, àñđ à model.Anchor
þöšîţîöñîñĝ îţ îñ ţĥé ƃļöçķ'š ŕüñš. Šţöŕé ḿàţçĥéš àŕé đéđüþéđ àçŕöšš ţĥé
çàñđîđàţé ļàñĝüàĝéš, ƃéçàüšé à ţéŕḿ ŕéçöŕđéđ îñ ƃöţĥ en-GB àñđ en îš öñé
đéçîšîöñ àƃöüţ öñé ŵöŕđ. À LocateRequest àļšö çàŕŕîéš ţĥé đöḿàîñš, ḿîñîḿüḿ
šçöŕé àñđ ṽàļîđîţý šçöþé þàššéđ ţĥŕöüĝĥ ţö ţĥé šţöŕé ļööķüþ; ţĥöšé ñàŕŕöŵ ŵĥîçĥ
đéçļàŕàţîöñš àŕé çöñšüļţéđ, ŵĥîçĥ îš à đéŕéñţ ǫüéšţîöñ ƒŕöḿ ŵĥîçĥ üšéš
ḿàţţéŕ.
Àñ öççüŕŕéñçé îš à üšé, ñöţ à ṽéŕđîçţ. Ţĥé þàšš ŕéþöŕţš éṽéŕý đéçļàŕéđ ţéŕḿ
îţ ƒîñđš, îñçļüđîñĝ ţĥé þŕéƒéŕŕéđ àñđ àþþŕöṽéđ öñéš, àñđ šàýš ñöţĥîñĝ àƃöüţ
ŵĥéţĥéŕ àñý öƒ ţĥéḿ îš à þŕöƃļéḿ. Ŵĥîçĥ üšéš àŕé ṽîöļàţîöñš îš ţĥé çöñšüḿîñĝ
ĝàţé'š þöļîçý àñđ ļîṽéš ţĥéŕé: ţĥé ṽöîçé ṽöçàƃüļàŕý ĝàţé öƃĵéçţš ţö à
çöḿþéţîţöŕ'š ñàḿé, à ƒöŕƃîđđéñ ţéŕḿ àñđ à ŕéţîŕéđ öñé, àñđ term-lookup
àññöţàţéš àļļ öƒ ţĥéḿ ƃéçàüšé çöñţéẋţ îš ŵĥàţ îţ îš ƒöŕ. À þàšš ţĥàţ ƒîļţéŕéđ ţö
öñé çàļļéŕ'š ţĥŕéé šţàţüšéš ŵöüļđ ƃé à þàšš öñļý ţĥàţ çàļļéŕ çöüļđ üšé.
Ţĥé ḿàţçĥéŕ îš ŕüļé-šĥàþéđ ŕàţĥéŕ ţĥàñ þŕöƒîļé-šĥàþéđ: MatchTermRules ţàķéš
ţéŕḿ ŕüļé šéţš, éàçĥ çàŕŕýîñĝ ţĥé ķîñđ öƒ ṽîöļàţîöñ à ĥîţ îš àñđ ţĥé šéṽéŕîţý
à ŕüļé ţĥàţ ñàḿéš ñöñé öƒ îţš öŵñ ţàķéš. À ṽöîçé þŕöƒîļé çöñţŕîƃüţéš ţŵö šéţš
(ƒöŕƃîđđéñ ţéŕḿš àţ ḿàĵöŕ, à çöḿþéţîţöŕ'š àţ çŕîţîçàļ) ţĥŕöüĝĥ
VocabularyRuleSets; à ţööļ çöñţŕîƃüţéš îţš öŵñ. Ţĥàţ îš ŵĥàţ ļéţš öñé ḿàţçĥ
ŕüñ çöṽéŕ éṽéŕý šöüŕçé à çàļļéŕ ĥöļđš, àñđ ŵĥàţ ķééþš à ŕüļé-çàŕŕýîñĝ ţööļ ƒŕöḿ
ƃéîñĝ à šéçöñđ-çļàšš çîţîžéñ öƒ ţĥé ṽöçàƃüļàŕý ĝàţé.
Ŵĥàţ à çöñšüḿéŕ đöéš ŵîţĥ àñ öççüŕŕéñçé îš îţš öŵñ ƃüšîñéšš. Ţĥé ṽöîçé
ṽöçàƃüļàŕý ĝàţé ŕàîšéš à ƒîñđîñĝ, þŕéšéñţîñĝ îţ ţĥŕöüĝĥ HitsToFindings, ţĥé
ḿàþþîñĝ éṽéŕý çĥéçķ šüŕƒàçé šĥàŕéš (kapi check, ţĥé check_text àñđ
check_file ḾÇÞ ţööļš, ţĥé đéšķţöþ þàñéļ). Îţ ñàḿéš ţĥé ţéŕḿš šţöŕé ŵĥéñ ţĥé
šţöŕé îš ŵĥàţ đéçļàŕéđ ţĥé ţéŕḿ, ƃéçàüšé "ƒöŕƃîđđéñ ƃý ţĥé þŕöƒîļé" àñđ
"ƒöŕƃîđđéñ îñ ţéŕḿš" šéñđ à ŵŕîţéŕ ţö đéŕéñţ þļàçéš ţö àŕĝüé ŵîţĥ ţĥé
đéçîšîöñ. Ļöçàţîñĝ îš ţĥé þàŕţ ţĥéý šĥàŕé.
Àññöţàţîöñš
Ţĥŕéé àññöţàţîöñ ţýþéš îḿþļéḿéñţ ţĥé àññöţàţîöñ îñţéŕƒàçé. Éàçĥ îš ŵŕîţţéñ öñţö
à ƃļöçķ àš àñ öṽéŕļàý šþàñ ŵĥöšé ŕàñĝé îš à model.Anchor, šö à ÜÎ ĥîĝĥļîĝĥţš
þŕéçîšéļý ŵîţĥöüţ ŕé-đéţéçţîñĝ ţéŕḿ ƃöüñđàŕîéš àţ ŕéñđéŕ ţîḿé. Ţĥé ļööķüþ îţšéļƒ
ŕéţüŕñš à çĥàŕàçţéŕ-ļéṽéļ ŕàñĝé îñţö ţĥé šöüŕçé ţéẋţ, ŵĥîçĥ terms.Locate
çöñṽéŕţš ţö àñ àñçĥöŕ öñçé, šö ţŵö çàļļéŕš çàññöţ çöñṽéŕţ îţ đéŕéñţļý.
TermAnnotation: à ḿàţçĥéđ ţéŕḿ ƒŕöḿ ţĥé šţöŕé, çàŕŕýîñĝ ţĥé çöñçéþţ îđ, ţàŕĝéţ-ţéŕḿ öþţîöñš, šţàţüš, šçöŕé àñđ ḿàţçĥ ţýþé.TermCandidateAnnotation: à þŕöþöšéđ ţéŕḿ ñöţ ýéţ îñ ţĥé šţöŕé, çàŕŕýîñĝ à þŕöþöšéđ ḿàŕķéŕ šö à ŕéṽîéŵéŕ çàñ àççéþţ, ŕéĵéçţ öŕ đéƒéŕ.EntityAnnotation: ñàḿéđ éñţîţîéš (þéöþļé, öŕĝàñîžàţîöñš, þŕöđüçţš, đàţéš, ļöçàţîöñš) ŵîţĥ öþţîöñàļ đö-ñöţ-ţŕàñšļàţé ƒļàĝš. Éñţîţý àññöţàţîöñš ƒééđ çöñţéñţ-ḿéḿöŕý ĝéñéŕàļîžàţîöñ (Ç-09), đö-ñöţ-ţŕàñšļàţé ĥàñđļîñĝ îñ ţŕàñšļàţîöñ, ļöçàļé ƒöŕḿàţţîñĝ ĥîñţš, àñđ ţéŕḿ-çàñđîđàţé đîšçöṽéŕý: öñé àññöţàţîöñ þàšš šéŕṽîñĝ šéṽéŕàļ çöñšüḿéŕš.
Çöñçéþţ ŕéļàţîöñš
Ţĥé šţöŕé þéŕšîšţš ţýþéđ, đîŕéçţéđ ŕéļàţîöñ éđĝéš ƃéţŵééñ çöñçéþţš. Éàçĥ ĥàš àñ îđ, à šöüŕçé àñđ ţàŕĝéţ çöñçéþţ, à ţýþé ƒŕöḿ ţĥé ŠĶÖŠ-àļîĝñéđ ṽöçàƃüļàŕý, àñ öþţîöñàļ ñöţé àñđ àñ öþţîöñàļ ṽàļîđîţý: ƃŕöàđéŕ/ñàŕŕöŵéŕ, þàŕţ-öƒ/ĥàš-þàŕţ, ŕéļàţéđ, ŕéþļàçéđ-ƃý, üšé-îñšţéàđ, éẋàçţ-ḿàţçĥ/çļöšé-ḿàţçĥ, àñđ çöḿþéţîţöŕ.
Ŵŕîţéš àŕé ĝàţéđ: à ŕéļàţîöñ îš ŕéĵéçţéđ üñļéšš îţš ţýþé îš îñ ţĥé ṽöçàƃüļàŕý àñđ
ƃöţĥ çöñçéþţš éẋîšţ. Ţĥé ŕéàđ ḿéţĥöđš ţàķé àñ öþţîöñàļ šçöþé àñđ ŕéţüŕñ öñļý
éđĝéš ŵĥöšé ṽàļîđîţý ḿàţçĥéš. Ŕéļàţîöñš ĝîṽé ÜΚ à ĝŕàþĥ šüƃšţŕàţé ƒöŕ ƃŕöŵšîñĝ
ţéŕḿîñöļöĝý ŵîţĥöüţ à šéþàŕàţé ĝŕàþĥ đàţàƃàšé, àñđ đŕîṽé đéþŕéçàţîöñ ŵöŕķƒļöŵš:
ţĥé term-enforce ţööļ ŕéšöļṽéš üšé-îñšţéàđ àñđ ŕéþļàçéđ-ƃý ţö ñàḿé ţĥé
ŕéþļàçéḿéñţ.
Ṽàļîđîţý
À ţéŕḿ àñđ à ŕéļàţîöñ éàçĥ çàŕŕý àñ öþţîöñàļ ĥàļƒ-öþéñ [valid-from, valid-to)
îñţéŕṽàļ þļüš ƒŕéé-ƒöŕḿ ţàĝš. Ļööķüþ öþţîöñš àñđ ţĥé ŕéļàţîöñ ŕéàđ ḿéţĥöđš àççéþţ
à šçöþé (à þöîñţ îñ ţîḿé þļüš ţàĝš) àñđ ŕéţüŕñ öñļý ŵĥàţ îš àçţîṽé ţĥéŕé. Ţĥîš
îš ĥöŵ ţĥé šţöŕé àñšŵéŕš àš-öƒ-ţîḿé àñđ ŵîţĥîñ-à-ţàĝ-šçöþé ǫüéšţîöñš; ţĥé
ƒŕàḿéŵöŕķ àššîĝñš ţàĝš ñö ḿéàñîñĝ, ļéàṽîñĝ ţĥé ṽöçàƃüļàŕý ţö ţĥé çàļļéŕ.
Îţ îš ţĥé šàḿé ţéḿþöŕàļ ḿöđéļ à ĝöṽéŕñîñĝ þŕöƒîļé'š ŵîñđöŵ üšéš (Ç-02) àñđ ţĥé šàḿé öñé ţĥé çöñţéẋţ ĝŕàþĥ'š éđĝéš çàŕŕý (Ç-03), šö ŵĥàţ ŵàš îñ ƒöŕçé ţĥéñ ŕéàđš îđéñţîçàļļý ŵĥéŕéṽéŕ îţ îš àšķéđ.
Šţàţüš ţŕàñšîţîöñš
ValidateTransition àççéþţš àñý ţŕàñšîţîöñ ƃéţŵééñ ķñöŵñ šţàţüšéš, àñđ
IsGovernedTransition ƒļàĝš ţĥé çöñšéǫüéñţîàļ öñéš: àñý ţŕàñšîţîöñ ţö
ƒöŕƃîđđéñ öŕ þŕéƒéŕŕéđ, öŕ àŵàý ƒŕöḿ ƒöŕƃîđđéñ. Ţĥé ƒŕàḿéŵöŕķ çļàššîƒîéš
ţŕàñšîţîöñš; îţ đöéš ñöţ îḿþöšé à ŕéṽîéŵ ŵöŕķƒļöŵ, ŵĥîçĥ îš ļéƒţ ţö à ļàýéŕ
àƃöṽé.
Çöḿþéţîţöŕ ţéŕḿš
À ţéŕḿ çàŕŕîéš à çöḿþéţîţöŕ ƒļàĝ. voice-vocab-check šüŕƒàçéš çöḿþéţîţöŕ ţéŕḿš
ƒöüñđ îñ šöüŕçé ţéẋţ àš çŕîţîçàļ-šéṽéŕîţý ṽöîçé ƒîñđîñĝš, àñđ ƒöŕƃîđđéñ ţéŕḿš àš
ḿàĵöŕ-šéṽéŕîţý, üšîñĝ ţĥé šţöŕé'š ṽöîçé-ṽöçàƃüļàŕý ţéŕḿ šöüŕçé
(Ç-07). Ţĥîš ĝîṽéš ţĥé ƒŕàḿéŵöŕķ à ḿîñîḿàļ ĥööķ ƒöŕ
ṽöîçé ĝüàŕđŕàîļš ŵîţĥöüţ đéþéñđîñĝ öñ ţĥé ŵĥöļé ṽöîçé ḿöđüļé.
Þîþéļîñé ţööļš
Ţĥé ƒŕàḿéŵöŕķ šĥîþš ţéŕḿîñöļöĝý ţööļš àš öŕđîñàŕý þîþéļîñé šţàĝéš:
term-lookup(éñŕîçĥ): ŕéçöŕđš ŵĥéŕé ţĥé šöüŕçé üšéš à đéçļàŕéđ ţéŕḿ, àš ţéŕḿ àññöţàţîöñš ŵîţĥ ŕüñ-àñçĥöŕéđ þöšîţîöñš. Îţ ŕéàđš ƃöţĥ šöüŕçéš ţĥŕöüĝĥterms.Locate: ţĥé çöñçéþţš îñ ţĥé šţöŕé àñđ ţĥé ŕüļéš à þŕöĵéçţ çàŕŕîéš üñđéŕterm_rules:, šö ţéŕḿîñöļöĝý đéçļàŕéđ îñ à ŕéçîþé çöüñţš àš ḿüçĥ àš ţéŕḿîñöļöĝý đéçîđéđ îñ ţĥé šţöŕé. Đöŵñšţŕéàḿ ţööļš üšé ţĥéšé ƒöŕ çöñţéẋţ. Àñ öççüŕŕéñçé îš ŵĥéŕé à ŕéàđéŕ šééš à ţéŕḿ ŵŕîţţéñ, šö ƃöţĥ šöüŕçéš ŕéàđ çöđé àš ŵŕîţţéñ, ŵîţĥ öñļý þļàçéĥöļđéŕ ñàḿéš ḿàšķéđ.term-check(ṽàļîđàţé): ĥöļđš à ţàŕĝéţ ţö ţĥé ŕéñđéŕîñĝš îţšterm_rules:ŕéǫüîŕé, ƒîñđîñĝ šöüŕçé ţéŕḿš ƃý ŵöŕđ àñđ ŕéñđéŕîñĝš ƃý çöñţàîñḿéñţ àš đéšçŕîƃéđ àƃöṽé. À đö-ñöţ-ţŕàñšļàţé ŕüļé ñàḿéš ñö ŕéñđéŕîñĝ: ţĥé ţàŕĝéţ ķééþš îţš ţéŕḿ ṽéŕƃàţîḿ, àš ţĥé ţéŕḿ, à đéçļàŕéđ ƒöŕḿ öŕ ţĥé šöüŕçé'š öŵñ öççüŕŕéñçé, îñ ţĥàţ çàšîñĝ, ŵîţĥ þļàçéĥöļđéŕ ñàḿéš ḿàšķéđ öñ ƃöţĥ šîđéš. À ŕüļé'š šéṽéŕîţý šöŕţš à ṽîöļàţîöñ îñţö àñ éŕŕöŕ öŕ à ŵàŕñîñĝ, àñđ ţĥé ṽéŕîƒý ĝàţé ŕéþöŕţš ƃöţĥ ŵĥîļé ƒàîļîñĝ öñļý öñ ţĥé ƒîŕšţ. Îţ þŕöƃéš çàñàŕîéš üñđéŕ îţš öŵñ çöñƒîĝüŕàţîöñ: à ţàŕĝéţ ŵîţĥ ţĥé ŕéñđéŕîñĝ đéļéţéđ, öñé ĥöļđîñĝ à ŵöŕđ ţĥàţ öþéñš ļîķé ţĥé ŕéñđéŕîñĝ àñđ éñđš đéŕéñţļý, ţĥé šĥàþé öƒ "Ķàîþļàñ" ƒöŕkaiplass, àñđ à ţàŕĝéţ ţĥàţ đöéš ñöţ ķééþ à đö-ñöţ-ţŕàñšļàţé ţéŕḿ. Ţĥé šĥîþ ţéŕḿîñöļöĝý ĝàţé,kapi checkŵîţĥ à ţàŕĝéţ îñ à þŕöĵéçţ, ţĥé ļööþ çĥéçķš ƃéĥîñđkapi statusàñđship.json, àñđ ţĥé þļàţƒöŕḿ'š çöḿþļîàñçé þŕéđîçàţé àļļ đéçîđé ţĥŕöüĝĥ îţ.term-enforce(ṽàļîđàţé): ƒöŕ éàçĥ ķñöŵñ šöüŕçé ţéŕḿ, çĥéçķš ţĥàţ àñ àççéþţàƃļé ţàŕĝéţ-ļöçàļé ţŕàñšļàţîöñ îš þŕéšéñţ, àñđ ƒļàĝš ƃļöçķš ŵĥéŕé îţ îš ḿîššîñĝ. À šöüŕçé ţéŕḿ ŵĥöšé çöñçéþţ îš ƒöŕƃîđđéñ öŕ đéþŕéçàţéđ ŕéđîŕéçţš ţĥŕöüĝĥ îţš üšé-îñšţéàđ öŕ ŕéþļàçéđ-ƃý ŕéļàţîöñ, šö ţĥé éẋþéçţéđ ŕéñđéŕîñĝ îš ţĥé ŕéþļàçéḿéñţ'š. Ƒöŕƃîđđéñ, đéþŕéçàţéđ àñđ çöḿþéţîţöŕ đéţéçţîöñ îšvoice-vocab-check'š ĵöƃ, ñöţ ţĥîš öñé'š.dnt-check(ṽàļîđàţé): çĥéçķš ţĥàţ đö-ñöţ-ţŕàñšļàţé ţéŕḿš šüŕṽîṽé ṽéŕƃàţîḿ îñţö ţĥé ţàŕĝéţ. Îţ ţàķéšterm_rules:ļîķé éṽéŕý ĝöṽéŕñéđ šţéþ àñđ üñîöñš ţĥé ŕüļéš ḿàŕķéđ đö-ñöţ-ţŕàñšļàţé ŵîţĥ ţĥé šţŕîñĝš à ŕéçîþé,--termsöŕkapi check --dntñàḿéš đîŕéçţļý. À šţöŕé îš ñöţ ŕéǫüîŕéđ: à ŕéçîþé ḿàý ñàḿé îţš ţéŕḿš àļöñé.term-extract(éñŕîçĥ, ḿöđéļ-àššîšţéđ): éẋţŕàçţîöñ öƒ çàñđîđàţé ţéŕḿš ŵîţĥ à þŕöþöšéđ šţàţüš.entity-extract(éñŕîçĥ, ḿöđéļ-àššîšţéđ): ñàḿéđ-éñţîţý àññöţàţîöñ. Šĥöüļđ ŕüñ éàŕļý, ƃéƒöŕérecycle.redact/unredact(Ç-10): ţĥé þàîŕ ţĥàţ ŕéþļàçéš éñţîţý ṽàļüéš ŵîţĥ ţýþéđ þļàçéĥöļđéŕš ƃéƒöŕé àñ éẋţéŕñàļ šéŕṽîçé àñđ ŕéšţöŕéš ţĥéḿ àƒţéŕŵàŕđš.
Ţéŕḿîñöļöĝý ŕéàçĥéš ĝéñéŕàţîöñ àš ŵéļļ àš ṽàļîđàţîöñ, ƃý ţŵö ŕöüţéš öƒ đéŕéñţ šţŕéñĝţĥ.
À šţŕîñĝ à ŕéçîþé öŕ --dnt ñàḿéš îš ḿàšķéđ: ţĥé ţŕàñšļàţé šţéþ ŕéþļàçéš
éàçĥ öççüŕŕéñçé ŵîţĥ à šéñţîñéļ ƃéƒöŕé ţĥé ḿöđéļ šééš ţĥé ţéẋţ àñđ ŕéšţöŕéš ţĥé
öŕîĝîñàļ àƒţéŕŵàŕđš, šö ţĥé ţéŕḿ çàññöţ ƃé ţŕàñšļàţéđ, ţŕàñšļîţéŕàţéđ öŕ
ŕéŵöŕđéđ. Ţĥé ļöçķ çöšţš ţĥé ƃàţçĥéđ þàţĥ, ƃéçàüšé à þéŕ-šþàñ šéñţîñéļ çàññöţ
ƃé ţŕàçķéđ àçŕöšš à þàçķéđ ḿüļţî-šéĝḿéñţ ĝéñéŕàţîöñ, šö à ŕüñ çöñƒîĝüŕéđ ŵîţĥ
ḿàšķéđ ţéŕḿš ţŕàñšļàţéš öñé ƃļöçķ þéŕ çàļļ.
À çöñçéþţ ţĥé ţéŕḿš šţöŕé ḿàŕķš đö-ñöţ-ţŕàñšļàţé îš îñšţŕüçţéđ àñđ çĥéçķéđ:
ţĥé ţŕàñšļàţé šţéþ ŕéñđéŕš îţ àš à ţéŕḿ ţö ķééþ ṽéŕƃàţîḿ, àñđ term-check ƒàîļš
à ţàŕĝéţ ţĥàţ đöéš ñöţ ķééþ îţ. Àñ îñšţŕüçţîöñ àļöñé îš ñöţ à ĝüàŕàñţéé, àñđ ţĥé
çĥéçķ îš ŵĥàţ ḿàķéš îţ öñé. Çöñçéþţš àŕé îñšţŕüçţéđ ŕàţĥéŕ ţĥàñ ḿàšķéđ šö ţĥàţ à
šţöŕé ĥöļđîñĝ à ĥàñđƒüļ öƒ þŕöđüçţ ñàḿéš đöéš ñöţ þîñ éṽéŕý ŕüñ ţö öñé ƃļöçķ þéŕ
çàļļ.
Ţĥé ŕüļéš ţĥàţ ñàḿé à ŕéþļàçéḿéñţ àŕé ŕéñđéŕéđ àš ţĥé ŕéñđéŕîñĝš ţö üšé, éàçĥ þŕöĵéçţîöñ šçöþéđ ţö ţĥé ţéẋţ öƒ ţĥé çàļļ. Ƃöţĥ éñţéŕ ţĥé çöñţéẋţ ƒîñĝéŕþŕîñţ šţàḿþéđ öñ ŵĥàţ ţĥé šţéþ ŵŕîţéš, šö ḿàŕķîñĝ à çöñçéþţ đö-ñöţ-ţŕàñšļàţé ḿàķéš ţĥé çöñţéñţ îţ ĝöṽéŕñš šţàļé ŕàţĥéŕ ţĥàñ ļéàṽîñĝ ţàŕĝéţš ţĥàţ ŵéŕé đŕàƒţéđ ŵîţĥöüţ îţ.
Ţĥé çöḿḿàñđ šüŕƒàçé
kapi terms çàŕŕîéš import, export, lookup, search, occurrences,
stats, expand, validate àñđ list. Ţĥé šţöŕé šéļéçţöŕ îš --termstore: --terms îš àļŕéàđý
ţàķéñ àš ţĥé ƃööļéàñ ĝàţé öñ kapi exec dnt-check, àñđ ţĥé àšýḿḿéţŕý ŵîţĥ
--memory îš ĝüàŕđéđ ƃý à ţéšţ. Ţĥé ŕéçîþé ƒöļļöŵš ţĥé ƒļàĝ: à þŕöƒîļé ƃîñđš à
šţàñđàļöñé šţöŕé ŵîţĥ profiles.<name>.termstore, àñđ terms ñàḿéš çöñţéñţš
(ţĥé çöñçéþţš, àñđ đñţ-çĥéçķ'š ļîšţ öƒ šţŕîñĝš), ñéṽéŕ à šţöŕé.
kapi terms occurrences ŕéþöŕţš ŵĥéŕé à çöñçéþţ îš àçţüàļļý üšéđ, ŕéàđîñĝ ţĥé
öççüŕŕéñçé îñđéẋ îñ ţĥé ƃļöçķ çàçĥé (Ç-03).
Îţ šéàŕçĥéš éàçĥ ţéŕḿ üñđéŕ îţš ţéẋţ àñđ éṽéŕý đéçļàŕéđ ƒöŕḿ, ƃéçàüšé ţĥé ƃļöçķ
çàçĥé'š ţéẋţ šéàŕçĥ ḿàţçĥéš öñé šţŕîñĝ àñđ à ƒöŕḿ šüçĥ àš ṽàŕšļéŕ đöéš ñöţ
çöñţàîñ ṽàŕšéļ.
kapi terms expand ƒîļļš îñ ƒöŕḿš àţ àüţĥöŕîñĝ ţîḿé. Îţ àšķš à ḿöđéļ ƒöŕ ţĥé
ƒöŕḿš öƒ éàçĥ ţéŕḿ îñ ţĥé ţéŕḿ'š öŵñ ļàñĝüàĝé, öñé ļàñĝüàĝé àţ à ţîḿé àñđ îñ
ƃàţçĥéš, àñđ ķééþš à þŕöþöšàļ öñļý ŵĥéñ îţ öþéñš ŵîţĥ ţĥé ţéŕḿ'š ƒîŕšţ ţĥŕéé
çĥàŕàçţéŕš àñđ îš šþéļļéđ đéŕéñţļý ƒŕöḿ éṽéŕý öţĥéŕ ţéŕḿ îñ ţĥàţ ļàñĝüàĝé.
Ŵĥàţ šüŕṽîṽéš îš ŵŕîţţéñ öñţö ţĥé ţéŕḿš öƒ ţĥé çöḿḿîţţéđ ƃüñđļé, ŵĥéŕé à
ŕéṽîéŵéŕ ŕéàđš îţ îñ ţĥé đ, šö ţĥé ḿàţçĥîñĝ ţĥàţ çöñšüḿéš ţĥé ƒöŕḿš šţàýš
đéţéŕḿîñîšţîç àñđ ƒŕéé öƒ ḿöđéļ çàļļš. Ƃý đéƒàüļţ îţ àšķš àƃöüţ ţàŕĝéţ ţéŕḿš àñđ
ļéàṽéš ţéŕḿš ţĥàţ àļŕéàđý đéçļàŕé ƒöŕḿš àļöñé. kapi terms validate ŕéþöŕţš ţĥé
šţŕüçţüŕàļ éŕŕöŕš à šţöŕé ŕéƒüšéš, àñđ ŵàŕñš àƃöüţ à ţàŕĝéţ ţéŕḿ ŵîţĥ ñö ƒöŕḿš îñ
à ļàñĝüàĝé ţĥàţ îñƒļéçţš àñđ àƃöüţ à ƒöŕḿ šþéļļéđ ţĥé šàḿé àš àñöţĥéŕ ţéŕḿ.
Çöñšéǫüéñçéš
- Ţéŕḿîñöļöĝý îš à ƒîŕšţ-çļàšš þîþéļîñé çîţîžéñ ŕàţĥéŕ ţĥàñ à þöšţ-þŕöçéššîñĝ šţéþ.
- Ŕüñ-àñçĥöŕéđ þöšîţîöñš éñàƃļé þŕéçîšé îñļîñé ĥîĝĥļîĝĥţîñĝ ŵîţĥöüţ ŕé-đéţéçţîñĝ ƃöüñđàŕîéš àţ ŕéñđéŕ ţîḿé.
- Öñé þàšš ļöçàţéš éṽéŕý đéçļàŕéđ ţéŕḿ, šö ţĥé ĝàţéš ţĥàţ çöñšüḿé îţ çàññöţ đîšàĝŕéé àƃöüţ ŵĥéţĥéŕ à ŵöŕđ îš îñ üšé.
- Éñţîţý àññöţàţîöñš đŕîṽé ƃöţĥ ţéŕḿ éẋţŕàçţîöñ àñđ çöñţéñţ-ḿéḿöŕý ĝéñéŕàļîžàţîöñ.
- Çöñçéþţ ŕéļàţîöñš ĝîṽé ÜΚ à ĝŕàþĥ šüƃšţŕàţé ŵîţĥöüţ à šéþàŕàţé ĝŕàþĥ đàţàƃàšé îñ ţĥé ƒŕàḿéŵöŕķ.
- Ţĥé çöḿþéţîţöŕ ƒļàĝ ĝîṽéš ṽöîçé ĝüàŕđŕàîļš à ĥööķ ŵîţĥöüţ à đéþéñđéñçý öñ ţĥé ṽöîçé ḿöđüļé.
- Ţĥé šàḿé šţöŕàĝé ƃàçķéñđš àš ţĥé çöñţéñţ ḿéḿöŕý ķééþ ţĥé đéþéñđéñçý ƒööţþŕîñţ šḿàļļ àñđ çŕöšš-çöḿþîļàţîöñ šîḿþļé.
Šéé àļšö
- Ç-01: Ţĥé þŕöĵéçţ ḿöđéļ:
defaults.terms_source. - Ç-03: Ţĥé çöñţéẋţ šţöŕé àñđ ĝŕàþĥ: ŵĥéŕé ţĥé þŕöĵéçţîöñ ļîṽéš àñđ ĥöŵ öççüŕŕéñçé îš îñđéẋéđ.
- Ç-07: Ṽöîçé þŕöƒîļéš: ţĥé
TermRulešĥàþé àñđ ţĥé ṽöçàƃüļàŕý ĝàţé. - Ç-09: Çöñţéñţ ḿéḿöŕý: šĥàŕéđ ḿàţçĥîñĝ îñƒŕàšţŕüçţüŕé, àñđ ţĥé šöüŕçé-ṽéŕšüš-šţàţé çöñţŕàšţ.
- É-03: Ţööļ Šýšţéḿ: ţĥé þîþéļîñé-ţööļ þàţţéŕñ.
- Ţéŕḿîñöļöĝý đàţà ḿöđéļ: ţĥé ƒüļļ Ĝö šţŕüçţš, ţĥé ţööļ çàţàļöĝ àñđ ţĥé ŕéļàţîöñ ṽöçàƃüļàŕý.