From 8ceac6ce7e46ec371235990f15424a93a5d9b3d2 Mon Sep 17 00:00:00 2001 From: Peter Kranich Date: Fri, 29 Nov 2024 09:04:07 +0100 Subject: [PATCH] Added Unique Localized Text Catalog Identification section to volume 3. --- ...localized-text-catalog-identification.adoc | 26 +++++++++++++++++++ .../volume3/tf3-ch-8.3.2-biceps-content.adoc | 2 ++ 2 files changed, 28 insertions(+) create mode 100644 asciidoc/volume3/biceps-content-module/tf3-ch-8.3.2.9.8-localized-text-catalog-identification.adoc diff --git a/asciidoc/volume3/biceps-content-module/tf3-ch-8.3.2.9.8-localized-text-catalog-identification.adoc b/asciidoc/volume3/biceps-content-module/tf3-ch-8.3.2.9.8-localized-text-catalog-identification.adoc new file mode 100644 index 00000000..855da395 --- /dev/null +++ b/asciidoc/volume3/biceps-content-module/tf3-ch-8.3.2.9.8-localized-text-catalog-identification.adoc @@ -0,0 +1,26 @@ +[#vol3_clause_localized_text_catalog_identification] +====== Unique Localized Text Catalog Identification + +In <>, localized texts for parameter labels, alert strings, enumerations, etc. can be retrieved with the provided *LocalizedText/@ref* (text id) and language code from the <> Localization Service. + +Text ids are unique within a device scope. However, <> vendors usually use the same text catalog for several of their products. + +In order to reduce the effort for a <> for managing individual lookup tables per <>, a lookup table that resolves the text ids for multiple <> from the same <> vendor is desirable for a <>. + +.R0709 +[sdpi_requirement#r0709,sdpi_req_level=should] +**** +A <> that has implemented the *<> LOCALIZATION SERVICE* should provide a unique text catalog identifier in the *pm:MdsDescriptor++++++/ProductionSpecification*. + +NOTE: The unique text catalog identifier can be an *urn* of type *uuid* or *oid*, e. g. *"urn:oid:1.3.6.1.4.1.1234.4.1.2.1"*. +**** + +.R0710 +[sdpi_requirement#r0710,sdpi_req_level=should] +**** +A <> that has implemented the *<> LOCALIZATION SERVICE* and supports versioning of the text catalog should provide a unique version number along with the unique text catalog identifier in the *pm:MdsDescriptor++++++/ProductionSpecification*. + +NOTE: The version number can be part of unique text catalog identifier, e. g. the last sub-node of the *OID*. In this case, it is not necessary that the <> provides a text catalog verion number in the *pm:MdsDescriptor++++++/ProductionSpecification*. +**** + +*TBD*: #which codes can be used for the text catalog id and the version in the ProductSpecification? Do we need new codes? Can we define SDPi OIDs or some similar for that?# \ No newline at end of file diff --git a/asciidoc/volume3/tf3-ch-8.3.2-biceps-content.adoc b/asciidoc/volume3/tf3-ch-8.3.2-biceps-content.adoc index c9c8f16b..b19098c9 100644 --- a/asciidoc/volume3/tf3-ch-8.3.2-biceps-content.adoc +++ b/asciidoc/volume3/tf3-ch-8.3.2-biceps-content.adoc @@ -274,5 +274,7 @@ include::biceps-extension-provisions/tf3-ch-8.3.2.9.6-extension-equipment-identi include::biceps-content-module/tf3-ch-8.3.2.9.7-compound-metric-modelling.adoc[] +include::biceps-content-module/tf3-ch-8.3.2.9.8-localized-text-catalog-identification.adoc[] + // 8.3.2.10 include::mdib-efficiency/tf3-ch-8.3.2.10-mdib-efficiency-considerations.adoc[] \ No newline at end of file