[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]
Subject: Re: [ubl-dev] Updated multi-lingual structure for IDD in genericode
At 2007-07-21 19:58 +0100, Stephen Green wrote:
>Hi. Is there a controlled vocabulary for the terms
>'rownum', 'den', 'name', 'ubldef', etc? Do these terms need
>a genericode file of their own? If so how would you define
>the terms in that file? :-)
Excellent question, Steve ... I just picked those names out of thin air.
While you did smile in your post, it was
something I wrestled with: do I use
abbreviations or full words or contractions of the IDD column titles?
The genericode short names for the columns are
already contractions of the IDD column titles ...
which is why I came up with abbreviations for the
column identifiers ... this is how version 2 looks:
<ColumnSet>
<Column Id="rownum" Use="required">
<ShortName>RowNumber</ShortName>
<Data Type="integer"/>
</Column>
<Column Id="den" Use="required">
<ShortName>DictionaryEntryName</ShortName>
<Data Type="normalizedString"/>
</Column>
<Column Id="name" Use="required">
<ShortName>UBLName</ShortName>
<Data Type="token"/>
</Column>
<Column Id="ubldef" Use="required">
<ShortName>UBLDefinition</ShortName>
<Data Type="string"/>
</Column>
<Column Id="card" Use="required">
<ShortName>Cardinality</ShortName>
<Data Type="string"/>
</Column>
<Column Id="type" Use="required">
<ShortName>ComponentType</ShortName>
<Data Type="token"/>
</Column>
<Column Id="terms" Use="required">
<ShortName>BusinessTerms</ShortName>
<Data Type="string"/>
</Column>
<Column Id="def" Use="required">
<ShortName>Definition</ShortName>
<Data Type="string"/>
</Column>
<Key Id="RowNum">
<ShortName>RowNum</ShortName>
<ColumnRef Ref="rownum"/>
</Key>
<Key Id="DEN">
<ShortName>DEN</ShortName>
<ColumnRef Ref="den"/>
</Key>
</ColumnSet>
But I wonder about readers for whom English is
not their first language. Do you (or anyone
else) have an opinion on this? Would the
following be more acceptable since it doesn't
make any assumptions about column names and just uses the IDD column names?
<ColumnSet>
<Column Id="No." Use="required">
<ShortName>No.</ShortName>
<LongName xml:lang="EN">Number</LongName>
<Data Type="integer"/>
</Column>
<Column Id="DictionaryEntryName" Use="required">
<ShortName>DictionaryEntryName</ShortName>
<LongName xml:lang="EN">Dictionary Entry Name</LongName>
<Data Type="normalizedString"/>
</Column>
<Column Id="UBLName" Use="required">
<ShortName>UBLName</ShortName>
<LongName xml:lang="EN">UBL Name</LongName>
<Data Type="token"/>
</Column>
<Column Id="UBLDefinition" Use="required">
<ShortName>UBLDefinition</ShortName>
<LongName xml:lang="EN">UBL Definition</LongName>
<Data Type="string"/>
</Column>
<Column Id="Cardinality" Use="required">
<ShortName>Cardinality</ShortName>
<LongName xml:lang="EN">Cardinality</LongName>
<Data Type="string"/>
</Column>
<Column Id="ComponentType" Use="required">
<ShortName>ComponentType</ShortName>
<LongName xml:lang="EN">Component Type</LongName>
<Data Type="token"/>
</Column>
<Column Id="BusinessTerms" Use="required">
<ShortName>BusinessTerms</ShortName>
<LongName xml:lang="EN">Business Terms</LongName>
<Data Type="string"/>
</Column>
<Column Id="Definition" Use="required">
<ShortName>Definition</ShortName>
<LongName xml:lang="EN">Definition</LongName>
<Data Type="string"/>
</Column>
<Key Id="No.Key">
<ShortName>No.Key</ShortName>
<LongName xml:lang="EN">Number Key</LongName>
<ColumnRef Ref="No."/>
</Key>
<Key Id="DictionaryEntryNameKey">
<ShortName>DictionaryEntryNameKey</ShortName>
<LongName xml:lang="EN">Dictionary Entry Name Key</LongName>
<ColumnRef Ref="DictionaryEntryName"/>
</Key>
</ColumnSet>
...
<Row>
<Value ColumnRef="No.">
<SimpleValue>5</SimpleValue>
</Value>
<Value ColumnRef="DictionaryEntryName">
<SimpleValue>Address. Postbox. Text</SimpleValue>
</Value>
<Value ColumnRef="UBLName">
<SimpleValue>Postbox</SimpleValue>
</Value>
<Value ColumnRef="UBLDefinition">
<SimpleValue>A post office box number.</SimpleValue>
</Value>
<Value ColumnRef="Cardinality">
<SimpleValue>0..1</SimpleValue>
</Value>
<Value ColumnRef="ComponentType">
<SimpleValue>BBIE</SimpleValue>
</Value>
<Value ColumnRef="BusinessTerms">
<ComplexValue>
<idd:Value xml:lang="EN">PostBox, PO Box</idd:Value>
<idd:Value xml:lang="ES">Apartado postal</idd:Value>
<idd:Value xml:lang="IT">Casella Postale</idd:Value>
</ComplexValue>
</Value>
<Value ColumnRef="Definition">
<ComplexValue>
<idd:Value xml:lang="EN">A post office box number.</idd:Value>
<idd:Value xml:lang="ES">Número de apartado postal</idd:Value>
<idd:Value xml:lang="IT">Un numero di casella postale.</idd:Value>
</ComplexValue>
</Value>
</Row>
The columns are unique and directly correlate to
the spreadsheets ... and I'm only at version 0.2
of these experiments so I don't mind tuning this
to make it better. I'm getting more feedback than I anticipated.
I think I now like the above better than what I
had before. Certainly to a non-English reader
who is examining the IDD spreadsheets, the above would really be unambiguous.
Please let me know your thoughts on this.
. . . . . . . . . . . . . . . Ken
--
Upcoming public training: XSLT/XSL-FO Sep 10, UBL/code lists Oct 1
World-wide corporate, govt. & user group XML, XSL and UBL training
RSS feeds: publicly-available developer resources and training
G. Ken Holman mailto:gkholman@CraneSoftwrights.com
Crane Softwrights Ltd. http://www.CraneSoftwrights.com/u/
Box 266, Kars, Ontario CANADA K0A-2E0 +1(613)489-0999 (F:-0995)
Male Cancer Awareness Jul'07 http://www.CraneSoftwrights.com/u/bc
Legal business disclaimers: http://www.CraneSoftwrights.com/legal
[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]