Doco Home Tools Home
dev_conf

Platypus Tools: IDS section of Configuration files

IDS section contains a subsection for each tag with an ID attribute. Subsection names are the ID attribute of the tag.

IDS.IdName.TAG
value is the tag name (eg TR, not TableRow).
IDS.IdName.JAVATYPE [Default: String]
value is Java type (eg, String, boolean) of the value.
IDS.IdName.HTMLLOCN
value indicates how the computed value should be inserted into the HTML. Allowed values include: PULLDOWN, ATTR_CHECKED, ATTR_VALUE, FIRSTTEXT, ATTR_HREF, NOVALUE.
IDS.IdName.TYPE [If in prototype]
value is the TYPE attribute.
IDS.IdName.NAME [If in prototype]
value is the NAME attribute.
IDS.IdName.HREF [If in prototype]
value is the HREF attribute.
Along With the NAME attribute, this serves to disambiguate anchor tags.
IDS.IdName.HASIDS [If any content]
value is comma separated list of ID nodes contained inside this node. The ID nodes need not be immediate children in the tree of HTML nodes. However, the search for ID nodes down a subtree stops when one is found. So, a complete list of contained IDS requires a recursive check of the HASIDS values.
IDS.IdName.HASINPUTS [If any content]
value is comma separated list of the NAME attributes of FORM ELEMENT nodes contained inside this node. This includes a FORM ELEMENT nodes which are themselves ID nodes, but excludes any FORM ELEMENT nodes contained inside ID nodes (as for HASIDS value). Currently (18Aug99), this list is completely dumb about repeated NAME attributes, and crossing FORM boundaries -- this may change in the future.
IDS.IdName.ALWAYSIN [Default TRUE]
value is TRUE if the node is always in the served page. If it's FALSE, then code for removing the node is generated. If its some other value, that value is assumed to be a tag type (eg, TR), and code for removing the DOM tree up to that kind of node is generated.
IDS.IdName.DATAFROM [Default BYHAND]
value determines how the skeleton code fills the DOM with a value. Allowable values include: IGNORE, BUSINESS, DATABASE, PULLDOWN, EXPR, BYHAND.
BYHAND means no code is generated -- though a reminder TODO is. IGNORE is deprecated (2Sep99) but functions like BYHAND. NONE means this ID shouldn't really get a dynamic value: neither code nor reminder is generated. BUSINESS means a call to the getBusinessIDValue() BO method is generated. DATABASE means a call to an access field is generated. EXPR means the code in LITERAL is inserted verbatim.
IDS.IdName.PULLDOWNKEY [If DATAFROM==PULLDOWN]
value is key into the pulldowns items method (getPulldownItems(...)).
IDS.IdName.FORMAT [Optional]
value indicates how the value should be formatted for display. The value here should be one of the string constant variable names at the start of class FormatUtil -- eg DATE_LOCALE, MONEY_LOCALE. It may also be the empty string, or omitted -- this is equivalent to NONE.
IDS.IdName.LITERAL [If DATAFROM==EXPR]
value is used verbatim in the generated Java.
IDS.IdName.ACCESS [If DATAFROM==DATABASE]
value is the name of the associated ACCESS.
IDS.IdName.FIELDPATH [Optional if DATAFROM==DATABASE]
value is a period separated list of fields, such as "FieldName" or "IntermediateTable1.IntermediateTable2.FieldName". The value is case sensitive.
IDS.IdName.DISPLAYASTEXT [Optional]
presence causes Pond to display this INPUT's VALUE as in a Text node. Allowed values are: NEW (create new text node before INPUT node), BEFORE (getFirstText of previous child), AFTER and ABOVE.
Warning: currently (Sep99), these generate a run-time null-pointer-exception in the *generated* code if an expected Text node isn't there. This will show up quickly in testing, and it's not easy to fix neatly, so this problem is staying.
This feature is mostly useful for debugging.