[DFDL-WG] Action 086 Nils and Default processing - draft 11

[Alan Powell]

Steph


Thanks.

Updated draft (v11.1) attached 

 
Regards

 
Alan Powell
 
Development - MQSeries, Message Broker, ESB
IBM Software Group, Application and Integration Middleware Software
-------------------------------------------------------------------------------------------------------------------------------------------
IBM
MP211, Hursley Park
Hursley, SO21 2JN
United Kingdom
Phone: +44-1962-815073
e-mail: alan_powell at uk.ibm.com




From:
Stephanie Fetzer <sfetzer at us.ibm.com>
To:
Alan Powell/UK/IBM at IBMGB
Cc:
dfdl-wg at ogf.org, dfdl-wg-bounces at ogf.org
Date:
23/07/2010 16:59
Subject:
Re: [DFDL-WG] Action 086 Nils and Default processing - draft 11




nilValue 
List of DFDL string literals, List of logical values, Character 

Specifies the text strings that are the possible literal or logical values 
of the element.   
If ?literalValue? then nilValue specifies a white space separated list of 
DFDL literal strings that are the possible representation values for nil. 
On input the element value is nil if the data matches literal strings. On 
output if the element value is nil the first nilValue is output. Only 
applicable when representation is 'text' 

If ?logicalValue? then nilValue specifies white space separated list of 
logical values that are the possible logical values for nil. On input the 
element value is nil if the data, converted to its logical type, matches 
any of the logical values. On output if the element value is nil, the 
first nilValue is converted to its physical representation and output. 
If 'literalCharacter' then nilValue specifies a single character or byte 
that, when repeated to the length of the element, is the nil 
representation value. If a character, then it can be specified using a 
literal character or using DFDL entities. If a character is specified when 
lengthUnits='bytes' then the nilValue must be a single-byte character.
If a byte, then it must be specified using a single %#r entity If a byte 
is specified when lengthUnits='characters' then the encoding must be a 
fixed-width encoding 
On input the element value is nil if all characters in the data match the 
nilValue character . On output if the element value is nil the nilValue 
character is output to the required length.   
Annotation: dfdl:element(simpleType)


Alan: 

OK - now that we've moved the text from one box in the table to the next 
we need to be a bit more specific concerning the references.  For example, 
in the above the 'literal value' does not refer to this property but to 
the value of nillKind.  Also, we tend to use 'on parsing' and 'on 
unparsing' instead of 'on input' and on 'output'.There are also a couple 
of very small nits I wanted to change as well. 



List of DFDL string literals, List of logical values, Character 

Specifies the text strings that are the possible literal or logical values 
of the element.   
If dfdl:nillKind is ?literalValue? then nilValue specifies a white space 
separated list of DFDL literal strings that are the possible 
representation values for nil. On parsing the element value is nil if the 
data matches one of the literal strings in the list. On unparsing if the 
element value is nil the first nilValue from the list is output. Only 
applicable when representation is 'text'. 

If dfdl:nillKind is ?logicalValue? then nilValue specifies a white space 
separated list of logical values that are the possible logical values for 
nil. On parsing the element value is nil if the data, converted to its 
logical type, matches any of the logical values in the list. On unparsing 
if the element value is nil, the first nilValue from the list is converted 
to its physical representation and output. 

If dfdl:nillKind is 'literalCharacter' then nilValue specifies a single 
character or byte that, when repeated to the length of the element, is the 
nil representation value. If a character, then it can be specified using a 
literal character or using DFDL entities. If a character is specified when 
dfdl:lengthUnits='bytes' then the nilValue must be a single-byte 
character.
If a byte, then it must be specified using a single %#r entity If a byte 
is specified when lengthUnits='characters' then the encoding must be a 
fixed-width encoding. 
On parsing the element value is nil if all characters in the data match 
the nilValue character . On unparsing if the element value is nil the 
nilValue character is output to the required length.   
Annotation: dfdl:element(simpleType) 


Stephanie Fetzer
WebSphere Common Transformation
Industry Packs - Software Engineer



From: 
Alan Powell <alan_powell at uk.ibm.com> 
To: 
dfdl-wg at ogf.org 
Date: 
07/23/2010 11:08 AM 
Subject: 
[DFDL-WG] Action 086 Nils and Default processing - draft 11 
Sent by: 
dfdl-wg-bounces at ogf.org






The latest draft (v11) of nils and defaults reorganizing the dfdl:nilKind 
and dfdl:nilNalue descriptions. 

Steve is away next week so I will cancel the WG call. 

Can you please send corrections to this draft by Tuesday so that I can get 
it into the next draft of the spec. 
  
Regards 
  
Alan Powell 
  
Development - MQSeries, Message Broker, ESB 
IBM Software Group, Application and Integration Middleware Software 
------------------------------------------------------------------------------------------------------------------------------------------- 

IBM 
MP211, Hursley Park 
Hursley, SO21 2JN 
United Kingdom 
Phone: +44-1962-815073 
e-mail: alan_powell at uk.ibm.com






Unless stated otherwise above:
IBM United Kingdom Limited - Registered in England and Wales with number 
741598. 
Registered office: PO Box 41, North Harbour, Portsmouth, Hampshire PO6 3AU 





[attachment "dfdl-nils-defaults-v11.doc" deleted by Stephanie 
Fetzer/Charlotte/IBM] --
 dfdl-wg mailing list
 dfdl-wg at ogf.org
 http://www.ogf.org/mailman/listinfo/dfdl-wg 







Unless stated otherwise above:
IBM United Kingdom Limited - Registered in England and Wales with number 
741598. 
Registered office: PO Box 41, North Harbour, Portsmouth, Hampshire PO6 3AU





-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://www.ogf.org/pipermail/dfdl-wg/attachments/20100726/5c462dc4/attachment-0001.html 
-------------- next part --------------
A non-text attachment was scrubbed...
Name: dfdl-nils-defaults-v11.1.doc
Type: application/octet-stream
Size: 146944 bytes
Desc: not available
Url : http://www.ogf.org/pipermail/dfdl-wg/attachments/20100726/5c462dc4/attachment-0001.obj