Issue 92935 - "Empty string is NULL" in the file helpcontent2/source/text/shared/02/01170102.xhp
Summary: "Empty string is NULL" in the file helpcontent2/source/text/shared/02/0117010...
Status: CLOSED FIXED
Alias: None
Product: documentation
Classification: Unclassified
Component: Online help (show other issues)
Version: DEV300m29
Hardware: All All
: P3 Trivial (vote)
Target Milestone: OOo 3.1
Assignee: kla
QA Contact: issues@documentation
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2008-08-20 07:40 UTC by tora3
Modified: 2008-12-22 15:34 UTC (History)
2 users (show)

See Also:
Issue Type: DEFECT
Latest Confirmation in: ---
Developer Difficulty: ---


Attachments

Note You need to log in before you can comment on or make changes to this issue.
Description tora3 2008-08-20 07:40:14 UTC
The online-help has the following description regarding a Text Box of control. 

Empty string is NULL
Defines how an empty string input should be handled. If this property is set 
(Yes), a string with only one or more spaces will be interpreted as a NULL 
value and stored in the database. If this property is not set (No), the string 
will be treated as an empty value.

Is the expression "a string with only one or more spaces will be interpreted 
as a NULL value" correct? 

In fact, it seems that if the property is set (Yes) and  
 - If a string of zero length would be interpreted as a NULL value. 
 - If one or more spaces are filled in the Text Box, the string would be 
   interpreted as a string with the spaces. 

To find the description: 
1. Start Writer
2. View > Toolbars > Form Controls
3. Place a Text Box on the Writer document.
4. Right-click on the Text Box and choose Control...
5. Go to the tab Data.
6. Press F1 key.
7. Look for a link Data and click on it.
8. Look for a title "Empty string is NULL."

Or look for id="par_id3145357" in the file 
helpcontent2/source/text/shared/02/01170102.xhp

Reference(s)
http://oooug.jp/faq/index.php?faq/4/1167 (in Japanese), reported by M.Kamataki
Comment 1 Uwe Fischer 2008-08-20 09:35:54 UTC
reassigning
Comment 2 Uwe Fischer 2008-08-20 11:45:21 UTC
Thanks for finding this. Help text has been false for many years.
Changed file in CWS hcshared19. New text:

id="par_id3145357" l10n="CHG" oldref="12"<AVIS
hid="HID_PROP_EMPTY_IS_NULL">Defines how an empty string input should be
handled. If set to Yes, an input string of length zero will be entered as NULL
(but only if the control is bound to a database field and if the value NULL is
allowed for that database field). If set to No, any input will be entered as
such, without conversion.</AVIS>
id="par_id0820200812403467" l10n="NEW"An empty string is a string of length zero
(""). Normally, the value NULL is not the same as an empty string. NULL means
"an undefined value" or "an unknown value" or "no value entered yet".
id="par_id0820200812403455" l10n="NEW"Existing databases can handle the value
NULL differently. Refer to the database documentation.
Comment 3 tora3 2008-08-21 04:16:23 UTC
tora->ufi: Thank you for treating this issue seriously. 

I am not a technical writer, but software engineer with a little experience 
in localization. To make translation easier and to reduce possibility of 
mis-, improper translations, I would like to propose adding some specific 
words to the text. Could you please review and revise the following lines?

id="par_id3145357"
Defines how an empty string input should be handled. 
If set to Yes, an input string of length zero will be treated as a value NULL. 
That will be applied if the control is bound to a database field to which 
a value NULL is allowed to be entered.  
If set to No, any input will be treated as-is without any conversion.

id="par_id0820200812403467"
An empty string is a string of length zero (""). 
Normally, a value NULL is not the same as an empty string. 
In general, a term NULL is used to denote an undefined value, an unknown value, 
or "no value has been entered yet."

id="par_id0820200812403455"
Database systems vary and they might handle a value NULL differently.
Refer to documentations of the database that you are using. 
Comment 4 Uwe Fischer 2008-08-21 09:11:39 UTC
Thanks for the help. Copied your text to file. 
The first para is an extended help text. Sadly these cannot have any formatting,
even no paragraph breaks. The text will be shown as a one paragraph plain text only.
Comment 5 Uwe Fischer 2008-11-21 11:56:28 UTC
Please verify in CWS hcshared19.
Open Writer help, Find tab page. Type NULL into the Search box, check only
Complete words.
In results list, double-click Data. Click the Search icon and type NULL. There
is the new text.
Comment 6 kla 2008-11-25 09:41:59 UTC
Seen ok in cws hcshared 19 -> verified
Comment 7 kla 2008-12-22 15:34:18 UTC
Seen ok in current master(m37) -> closed