8.4.4 Primitive data types
Within this part of the RDR standard the following primitive data types are used:
Data Type | Definition | Example |
---|---|---|
| A string from a set of allowed values as defined in Clause 8.4.11. |
|
| A string containing either true or false |
|
| A date in the ISO 8601 format to indicate a single year (YYYY), month (YYYY-MM) or day (YYYY-MM-DD). |
|
| A string of 18 characters in accordance with the DDEX Party ID standard. DDEX Party IDs, when included in a file or message, shall not contain dashes. |
|
| A sequence of digits to represent positive or negative integer numbers, positive or negative decimal fractions or zero. In addition: The character used to separate the integers from fractions is the dot (“ Thousands separators or any other digit grouping shall not be used; Trailing zeros should not be used, so the value 5.5 should not be represented as 5.50 or 5.5000; Notwithstanding the above, when a field of type “decimal” is to communicate an integer, the number may be represented with a single trailing “.0” or with no trailing characters. For example, the number five can be represented as When the number 0(zero) is to be communicated in a Cell for decimal values, this shall be represented as 0 only (and not 0.0 or 0.000000). Details on the precision of decimals are provided in Clause 8.4.9. |
|
| A duration in the ISO 8601 format (P[nY][nM][nD][T[nH][nM]nS]). Seconds may include decimal fractions. Elements including their designator may be omitted if their value is zero. The expressions |
|
| A sequence of digits to represent positive or negative integer numbers, or zero. Details of the range of integers permitted are provided in Clause 8.4.9. |
|
| A string in the form IdType::ID where IdType identifies the identification scheme. Examples for IdType are: “ISNI” for an ISO 27729 International Standard Name Identifier; “IPI” for a CISAC Interested Party Identifier name number; or “IPN” for a SCAPR International Performer Number. The ID element then contains the identifier in the format defined by the identification scheme. Only one identifier can be communicated for each party in a PartyID field. |
|
| A sequence of characters with a length of at least one character. This part of the RDR standard does not define a maximum length. Strings may not contain non-printable characters (Unicode U+0000 to U+001F). |
|
| A sequence of 0-n strings separated by a Secondary Delimiter. If the sender has only one data item to provide, the value shall be included without any Secondary Delimiters. The same applies to cases where the sender has multiple data elements but only wishes to communicate one in accordance with the bilateral agreement between the sender and the recipient. If such an element is mandatory, at least one such data item must be provided. Cells that may contain multiple values may be related. For example, one multiple-string Cell may be for names of composers/lyricists and it may be followed by a multiple-string Cell for identifiers of these composers/lyricists. In those cases, both Cells must contain the same number of Secondary Delimiters. The same concept can also be used for all other primitive data types listed here. |
|
| In order to communicate a list of lists, the Delimiter for the inner list shall be escaped to \|. One such example is the provision of multiple identifiers for multiple writers of a musical work. |
|
Table 3 – Primitive Data Types