gnue/gnuef/doc techref.lyx

commit-gnue
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
gnue/gnuef/doc techref.lyx

From:	Jason Cater
Subject:	gnue/gnuef/doc techref.lyx
Date:	Thu, 07 Jun 2001 15:08:53 -0700
CVSROOT:        /home/cvs
Module name:    gnue
Changes by:     Jason Cater <address@hidden>    01/06/07 15:08:53

Modified files:
        gnuef/doc      : techref.lyx 

Log message:
        Added section on libraries

CVSWeb URLs:
http://savannah.gnu.org/cgi-bin/viewcvs/gnue/gnuef/doc/techref.lyx.diff?cvsroot=OldCVS&tr1=1.4&tr2=1.5&r1=text&r2=text

Patches:
Index: gnue/gnuef/doc/techref.lyx
diff -u gnue/gnuef/doc/techref.lyx:1.4 gnue/gnuef/doc/techref.lyx:1.5
--- gnue/gnuef/doc/techref.lyx:1.4      Mon Apr 16 18:40:37 2001
+++ gnue/gnuef/doc/techref.lyx  Thu Jun  7 15:08:53 2001
@@ -889,7 +889,11 @@
  You can use either method to define any object's attributes.
  You can use both methods in the same gfd file without issues.
  The examples below will typically show the first method as it's less typing
- :)
+ :) 
+\layout Comment
+
+[TODO: This is no longer true as this method is not XML compliant and 
complicate
+s/confuses design]
 \layout Subsubsection
 
 Attributes inside the tag
@@ -923,21 +927,45 @@
 \SpecialChar ~
 \SpecialChar ~
 \SpecialChar ~
-<text>City</text>
+<option name=
+\begin_inset Quotes erd
+\end_inset 
+
+text
+\begin_inset Quotes erd
+\end_inset 
+
+>City</option>
 \layout Standard
 
 \SpecialChar ~
 \SpecialChar ~
 \SpecialChar ~
 \SpecialChar ~
-<x>1</x>
+<option name=
+\begin_inset Quotes erd
+\end_inset 
+
+x
+\begin_inset Quotes erd
+\end_inset 
+
+>1</option>
 \layout Standard
 
 \SpecialChar ~
 \SpecialChar ~
 \SpecialChar ~
 \SpecialChar ~
-<y>1</y>
+<option name=
+\begin_inset Quotes erd
+\end_inset 
+
+y
+\begin_inset Quotes erd
+\end_inset 
+
+>1</option>
 \layout Standard
 
 \SpecialChar ~
@@ -967,8 +995,24 @@
  to my entry object.
  So in my gfd file I put the following:
 \layout Standard
+
+<entry width="30"> 
+\layout Standard
+
+\SpecialChar ~
+\SpecialChar ~
+<option name=
+\begin_inset Quotes erd
+\end_inset 
+
+foo
+\begin_inset Quotes erd
+\end_inset 
+
+>bar</option>
+\layout Standard
 
-<entry width="30" foo="bar">
+</entry>
 \layout Standard
 
 Now, when that specific object instance is created a foo attribute with
@@ -1441,21 +1485,122 @@
 \layout Standard
 
 </form>
-\layout Section
+\layout Subsection
 
 <page>
-\layout Subsection
+\layout Subsubsection
 
 Attributes
 \layout Standard
 
-None
-\layout Subsection
 
+\begin_inset  Tabular
+<lyxtabular version="2" rows="2" columns="4">
+<features rotate="false" islongtable="false" endhead="0" endfirsthead="0" 
endfoot="0" endlastfoot="0">
+<column alignment="center" valignment="top" leftline="true" rightline="false" 
width="" special="">
+<column alignment="center" valignment="top" leftline="true" rightline="false" 
width="" special="">
+<column alignment="center" valignment="top" leftline="true" rightline="false" 
width="" special="">
+<column alignment="left" valignment="top" leftline="true" rightline="true" 
width="" special="">
+<row topline="true" bottomline="true" newpage="false">
+<cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+\begin_inset Text
+
+\layout Standard
+
+
+\lang english
+Attribute
+\end_inset 
+</cell>
+<cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+\begin_inset Text
+
+\layout Standard
+
+
+\lang english
+Datatype
+\end_inset 
+</cell>
+<cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+\begin_inset Text
+
+\layout Standard
+
+
+\lang english
+Default
+\end_inset 
+</cell>
+<cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="true" rotate="false" 
usebox="none" width="" special="">
+\begin_inset Text
+
+\layout Standard
+
+
+\lang english
+Description
+\end_inset 
+</cell>
+</row>
+<row topline="true" bottomline="false" newpage="false">
+<cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+\begin_inset Text
+
+\layout Standard
+
+name
+\end_inset 
+</cell>
+<cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+\begin_inset Text
+
+\layout Standard
+
+
+\lang english
+string
+\end_inset 
+</cell>
+<cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+\begin_inset Text
+
+\layout Standard
+
+
+\lang english
+none
+\end_inset 
+</cell>
+<cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="true" rotate="false" 
usebox="none" width="" special="">
+\begin_inset Text
+
+\layout Standard
+
+A unique ID for the widget.
+ This is only useful when importing pages from a library.
+\end_inset 
+</cell>
+</row>
+</lyxtabular>
+
+\end_inset 
+
+
+\layout Subsubsection
+
 Example
 \layout Standard
 
-<page>
+<page name=
+\begin_inset Quotes erd
+\end_inset 
+
+page1
+\begin_inset Quotes erd
+\end_inset 
+
+>
 \layout Standard
 
 
@@ -1475,10 +1620,10 @@
 \layout Standard
 
 </page>
-\layout Section
+\layout Subsection
 
 <block>
-\layout Subsection
+\layout Subsubsection
 
 Attributes
 \layout Standard
@@ -1827,7 +1972,7 @@
 \end_inset 
 
 
-\layout Subsection
+\layout Subsubsection
 
 Example
 \layout Standard
@@ -1849,10 +1994,10 @@
  It does this by monitoring the entry named st_code in the state block,
  when that data changes it sets the entry within itself named state to match
  the value stored in st_code as querying data from the datasource.
-\layout Section
+\layout Subsection
 
 <label>
-\layout Subsection
+\layout Subsubsection
 
 Attributes
 \layout Standard
@@ -2129,16 +2274,16 @@
 \end_inset 
 
 
-\layout Subsection
+\layout Subsubsection
 
 Example
 \layout Standard
 
 <label text="City" x="2" y="9"/>
-\layout Section
+\layout Subsection
 
 <entry>
-\layout Subsection
+\layout Subsubsection
 
 Attributes
 \layout Standard
@@ -2845,7 +2990,7 @@
 \end_inset 
 
 
-\layout Subsection
+\layout Subsubsection
 
 Example
 \layout Standard
@@ -2865,17 +3010,17 @@
 
 foreign_key="validator.state" foreign_key_description="description" 
style="dropdo
 wn">
-\layout Section
+\layout Subsection
 
 <button>
-\layout Subsection
+\layout Subsubsection
 
 Attributes
 \layout Standard
 
 
 \begin_inset  Tabular
-<lyxtabular version="2" rows="7" columns="4">
+<lyxtabular version="2" rows="8" columns="4">
 <features rotate="false" islongtable="false" endhead="0" endfirsthead="0" 
endfoot="0" endlastfoot="0">
 <column alignment="center" valignment="top" leftline="true" rightline="false" 
width="" special="">
 <column alignment="center" valignment="top" leftline="true" rightline="false" 
width="" special="">
@@ -2931,6 +3076,50 @@
 
 
 \lang english
+name
+\end_inset 
+</cell>
+<cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+\begin_inset Text
+
+\layout Standard
+
+
+\lang english
+string
+\end_inset 
+</cell>
+<cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+\begin_inset Text
+
+\layout Standard
+
+
+\lang english
+none
+\end_inset 
+</cell>
+<cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="true" rotate="false" 
usebox="none" width="" special="">
+\begin_inset Text
+
+\layout Standard
+
+
+\lang english
+A unique ID for the widget.
+ Useful for importable buttons.
+ 
+\end_inset 
+</cell>
+</row>
+<row topline="true" bottomline="false" newpage="false">
+<cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+\begin_inset Text
+
+\layout Standard
+
+
+\lang english
 x
 \end_inset 
 </cell>
@@ -3177,17 +3366,17 @@
 \end_inset 
 
 
-\layout Subsection
+\layout Subsubsection
 
 Example
 \layout Standard
 
 <button label="Press Me" x="1" y="1" width="10" height="1" 
trigger="HelloWorld"/
 >
-\layout Section
+\layout Subsection
 
 <box>
-\layout Subsection
+\layout Subsubsection
 
 Attributes
 \layout Standard
@@ -3460,13 +3649,13 @@
 \end_inset 
 
 
-\layout Subsection
+\layout Subsubsection
 
 Example
 \layout Standard
 
 <box x="1" y="8" width="37" height="8" label="State Cities"/>
-\layout Section
+\layout Subsection
 
 <scrollbar>
 \layout Standard
@@ -3475,7 +3664,7 @@
 \series bold 
 Only partially implemented at this time.
  Will show on form but do nothing.
-\layout Subsection
+\layout Subsubsection
 
 Attributes
 \layout Standard
@@ -3706,30 +3895,27 @@
 \end_inset 
 
 
-\layout Subsection
+\layout Subsubsection
 
 Example
 \layout Standard
 
 <scrollbar x="40" y="2" width="1" height="15"/>
-\layout Section
-
-<database>
 \layout Subsection
 
-Attributes
+<datasource>
 \layout Subsubsection
 
-Postgresql Provider
+Attributes
 \layout Standard
 
 
 \begin_inset  Tabular
-<lyxtabular version="2" rows="5" columns="4">
+<lyxtabular version="2" rows="7" columns="4">
 <features rotate="false" islongtable="false" endhead="0" endfirsthead="0" 
endfoot="0" endlastfoot="0">
-<column alignment="center" valignment="top" leftline="true" rightline="true" 
width="" special="">
-<column alignment="center" valignment="top" leftline="false" rightline="false" 
width="" special="">
 <column alignment="center" valignment="top" leftline="true" rightline="false" 
width="" special="">
+<column alignment="center" valignment="top" leftline="true" rightline="false" 
width="" special="">
+<column alignment="center" valignment="top" leftline="true" rightline="false" 
width="" special="">
 <column alignment="left" valignment="top" leftline="true" rightline="true" 
width="" special="">
 <row topline="true" bottomline="true" newpage="false">
 <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
@@ -3779,6 +3965,8 @@
 
 \layout Standard
 
+
+\lang english
 name
 \end_inset 
 </cell>
@@ -3787,6 +3975,8 @@
 
 \layout Standard
 
+
+\lang english
 string
 \end_inset 
 </cell>
@@ -3795,6 +3985,8 @@
 
 \layout Standard
 
+
+\lang english
 none
 \end_inset 
 </cell>
@@ -3802,8 +3994,10 @@
 \begin_inset Text
 
 \layout Standard
+
 
-The name of the database used within the form.
+\lang english
+A unique ID for the widget.The name of the widget.
 \end_inset 
 </cell>
 </row>
@@ -3813,7 +4007,9 @@
 
 \layout Standard
 
-provider
+
+\lang english
+database
 \end_inset 
 </cell>
 <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
@@ -3821,6 +4017,8 @@
 
 \layout Standard
 
+
+\lang english
 string
 \end_inset 
 </cell>
@@ -3838,9 +4036,10 @@
 \begin_inset Text
 
 \layout Standard
+
 
-The name of the database driver.
- Would be set to postgresql here.
+\lang english
+The name of the database object the datasource will utilize.
 \end_inset 
 </cell>
 </row>
@@ -3850,7 +4049,9 @@
 
 \layout Standard
 
-host
+
+\lang english
+table
 \end_inset 
 </cell>
 <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
@@ -3858,6 +4059,8 @@
 
 \layout Standard
 
+
+\lang english
 string
 \end_inset 
 </cell>
@@ -3866,6 +4069,8 @@
 
 \layout Standard
 
+
+\lang english
 none
 \end_inset 
 </cell>
@@ -3874,17 +4079,21 @@
 
 \layout Standard
 
-The DNS name or IP address of the postgresql database server.
-\end_inset 
+
+\lang english
+The name of the table the datasource to which the datasourse must attach.
+\end_inset 
 </cell>
 </row>
-<row topline="true" bottomline="true" newpage="false">
+<row topline="true" bottomline="false" newpage="false">
 <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
 \begin_inset Text
 
 \layout Standard
 
-dbname
+
+\lang english
+order_by
 \end_inset 
 </cell>
 <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
@@ -3892,6 +4101,8 @@
 
 \layout Standard
 
+
+\lang english
 string
 \end_inset 
 </cell>
@@ -3900,6 +4111,8 @@
 
 \layout Standard
 
+
+\lang english
 none
 \end_inset 
 </cell>
@@ -3907,29 +4120,58 @@
 \begin_inset Text
 
 \layout Standard
+
 
-The name of the postgresql database to which we will connect.
+\lang english
+A comma seperated list of fields within the table.
+ The datasource will present the information sorted by this list of fields.
 \end_inset 
 </cell>
 </row>
-</lyxtabular>
+<row topline="true" bottomline="false" newpage="false">
+<cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+\begin_inset Text
+
+\layout Standard
+
 
+\lang english
+prequery
 \end_inset 
+</cell>
+<cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+\begin_inset Text
+
+\layout Standard
 
 
-\layout Subsubsection
+\lang english
+string
+\end_inset 
+</cell>
+<cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
+\begin_inset Text
 
-MySQL Provider
 \layout Standard
 
 
-\begin_inset  Tabular
-<lyxtabular version="2" rows="5" columns="4">
-<features rotate="false" islongtable="false" endhead="0" endfirsthead="0" 
endfoot="0" endlastfoot="0">
-<column alignment="center" valignment="top" leftline="true" rightline="true" 
width="" special="">
-<column alignment="center" valignment="top" leftline="false" rightline="false" 
width="" special="">
-<column alignment="center" valignment="top" leftline="true" rightline="false" 
width="" special="">
-<column alignment="left" valignment="top" leftline="true" rightline="true" 
width="" special="">
+\lang english
+none
+\end_inset 
+</cell>
+<cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="true" rotate="false" 
usebox="none" width="" special="">
+\begin_inset Text
+
+\layout Standard
+
+
+\lang english
+Causes the datasource to load all data from the table into memory.
+ Usefull for validation purposes and obtaining values to dropdown style
+ entry objects.
+\end_inset 
+</cell>
+</row>
 <row topline="true" bottomline="true" newpage="false">
 <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
 \begin_inset Text
@@ -3938,7 +4180,7 @@
 
 
 \lang english
-Attribute
+sql
 \end_inset 
 </cell>
 <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
@@ -3948,7 +4190,7 @@
 
 
 \lang english
-Datatype
+string
 \end_inset 
 </cell>
 <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
@@ -3958,7 +4200,7 @@
 
 
 \lang english
-Default
+none
 \end_inset 
 </cell>
 <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="true" rotate="false" 
usebox="none" width="" special="">
@@ -3967,18 +4209,53 @@
 \layout Standard
 
 
+\series bold 
 \lang english
-Description
+No longer active.
+
+\series default 
+ A way of overriding the internal sql generation functions of the datasource
+ with hard coded sql.
 \end_inset 
 </cell>
 </row>
-<row topline="true" bottomline="false" newpage="false">
+</lyxtabular>
+
+\end_inset 
+
+
+\layout Subsubsection
+
+Example
+\layout Standard
+
+<datasource name="customers" database="gnue" table="customer" 
order_by="name_las
+t,name_first" prequery="" />
+\layout Subsection
+
+<trigger>
+\layout Subsubsection
+
+Attributes
+\layout Standard
+
+
+\begin_inset  Tabular
+<lyxtabular version="2" rows="4" columns="4">
+<features rotate="false" islongtable="false" endhead="0" endfirsthead="0" 
endfoot="0" endlastfoot="0">
+<column alignment="center" valignment="top" leftline="true" rightline="false" 
width="" special="">
+<column alignment="center" valignment="top" leftline="true" rightline="false" 
width="" special="">
+<column alignment="center" valignment="top" leftline="true" rightline="false" 
width="" special="">
+<column alignment="left" valignment="top" leftline="true" rightline="true" 
width="" special="">
+<row topline="true" bottomline="true" newpage="false">
 <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
 \begin_inset Text
 
 \layout Standard
 
-name
+
+\lang english
+Attribute
 \end_inset 
 </cell>
 <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
@@ -3986,7 +4263,9 @@
 
 \layout Standard
 
-string
+
+\lang english
+Datatype
 \end_inset 
 </cell>
 <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
@@ -3994,15 +4273,19 @@
 
 \layout Standard
 
-none
+
+\lang english
+Default
 \end_inset 
 </cell>
 <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="true" rotate="false" 
usebox="none" width="" special="">
 \begin_inset Text
 
 \layout Standard
+
 
-The name of the database used within the form.
+\lang english
+Description
 \end_inset 
 </cell>
 </row>
@@ -4012,7 +4295,9 @@
 
 \layout Standard
 
-provider
+
+\lang english
+name
 \end_inset 
 </cell>
 <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
@@ -4020,6 +4305,8 @@
 
 \layout Standard
 
+
+\lang english
 string
 \end_inset 
 </cell>
@@ -4037,9 +4324,10 @@
 \begin_inset Text
 
 \layout Standard
+
 
-The name of the database driver.
- Would be set to mysql here.
+\lang english
+A unique ID for the widget.The name of the widget.
 \end_inset 
 </cell>
 </row>
@@ -4049,7 +4337,9 @@
 
 \layout Standard
 
-host
+
+\lang english
+type
 \end_inset 
 </cell>
 <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
@@ -4057,6 +4347,8 @@
 
 \layout Standard
 
+
+\lang english
 string
 \end_inset 
 </cell>
@@ -4065,6 +4357,8 @@
 
 \layout Standard
 
+
+\lang english
 none
 \end_inset 
 </cell>
@@ -4072,8 +4366,11 @@
 \begin_inset Text
 
 \layout Standard
+
 
-The DNS name or IP address of the mysql database server.
+\lang english
+Specifies when the trigger should fire.
+ For a list of available triggers see the Trigger section of Chapter 2
 \end_inset 
 </cell>
 </row>
@@ -4083,7 +4380,7 @@
 
 \layout Standard
 
-dbname
+src
 \end_inset 
 </cell>
 <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
@@ -4107,7 +4404,7 @@
 
 \layout Standard
 
-The name of the mysql database to which we will connect.
+Used to call named triggers.
 \end_inset 
 </cell>
 </row>
@@ -4117,17 +4414,130 @@
 
 
 \layout Subsubsection
+
+Example
+\layout Quotation
+
+Simple Embedded
+\layout Standard
+
+<entry>
+\layout Standard
+
+<trigger type ="Pre-FocusOut"> 
+\layout Standard
+
+block1.fields.one = self.value
+\layout Standard
+
+</trigger>
+\layout Standard
+
+</entry>
+\layout Quotation
+
+Named
+\layout Standard
+
+This was taken from the sample/po form.
+\layout Standard
+
+<form>
+\layout Standard
+
+<trigger type="named" id="trggrAmount">
+\layout Standard
+
+# 
+\layout Standard
+
+#Calculate Amount 
+\layout Standard
+
+# import sys 
+\layout Standard
+
+blckPOItem.fields.ntryAmount=str(int(blckPOItem.fields.ntryQuantity)*float(blckPOIte
+m.fields.ntryUnitPrice)) 
+\layout Standard
+
+</trigger>
+\layout Standard
+
+
+\emph on 
+more form stuff
+\layout Standard
+
+<entry ......>
+\layout Standard
+
+<trigger type="Pre-FocusOut" src="trggrAmount" /> 
+\layout Standard
+
+</entry>
+\layout Standard
+
+
+\emph on 
+more form stuff
+\layout Standard
+
+</form>
+\layout Section
+
+Form Libraries
+\layout Subsection
+
+Overview
+\layout Standard
+
+Forms supports libraries of common objects.
+ There are two approaches to importing data in forms: 1) importing form-wide
+ objects such as named triggers, pages, and datasources; and 2) importing
+ individual objects, such as blocks, entries, triggers, pages, and datasources.
+ Note that the first method works only for form-level objects, whereas the
+ second method works for any 
+\begin_inset Quotes eld
+\end_inset 
+
+namable
+\begin_inset Quotes erd
+\end_inset 
+
+ form object (including namable form-level objects).
+ 
+\layout Standard
+
+There is no markup difference between a form library and a form definition.
+ Forms can pull objects from other forms just as easily as from a library.
+ For convenience, form definitions that are only used as libraries use the
+ .gfl extension.
+ 
+\layout Standard
+
+All child objects of an imported item are imported as well.
+ For example, when importing a page, all blocks, labels, etc.
+ belowing to that page are imported as well.
+\layout Subsection
+
+Importing Form-Level Objects
+\layout Subsubsection
+
+Summary
+\layout Standard
 
-Oracle Provider
+The first method of importing uses the <import> tag.
+ The import tag takes four attributes: 
 \layout Standard
 
 
 \begin_inset  Tabular
 <lyxtabular version="2" rows="5" columns="4">
 <features rotate="false" islongtable="false" endhead="0" endfirsthead="0" 
endfoot="0" endlastfoot="0">
-<column alignment="center" valignment="top" leftline="true" rightline="true" 
width="" special="">
-<column alignment="center" valignment="top" leftline="false" rightline="false" 
width="" special="">
 <column alignment="center" valignment="top" leftline="true" rightline="false" 
width="" special="">
+<column alignment="center" valignment="top" leftline="true" rightline="false" 
width="" special="">
+<column alignment="center" valignment="top" leftline="true" rightline="false" 
width="" special="">
 <column alignment="left" valignment="top" leftline="true" rightline="true" 
width="" special="">
 <row topline="true" bottomline="true" newpage="false">
 <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
@@ -4177,7 +4587,7 @@
 
 \layout Standard
 
-name
+library
 \end_inset 
 </cell>
 <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
@@ -4185,6 +4595,8 @@
 
 \layout Standard
 
+
+\lang english
 string
 \end_inset 
 </cell>
@@ -4193,6 +4605,8 @@
 
 \layout Standard
 
+
+\lang english
 none
 \end_inset 
 </cell>
@@ -4201,7 +4615,7 @@
 
 \layout Standard
 
-The name of the database used within the form.
+The URL or file name of the form or library to pull the imported data from.
 \end_inset 
 </cell>
 </row>
@@ -4211,7 +4625,7 @@
 
 \layout Standard
 
-provider
+datasources
 \end_inset 
 </cell>
 <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
@@ -4219,6 +4633,8 @@
 
 \layout Standard
 
+
+\lang english
 string
 \end_inset 
 </cell>
@@ -4237,9 +4653,18 @@
 
 \layout Standard
 
-The name of the database driver.
- Would be set to oracle here.
+Specifies a comma separated list of datasources by name to import.
+ If set to 
+\begin_inset Quotes eld
 \end_inset 
+
+*
+\begin_inset Quotes eld
+\end_inset 
+
+, then loads all datasources from the library.
+ 
+\end_inset 
 </cell>
 </row>
 <row topline="true" bottomline="false" newpage="false">
@@ -4248,7 +4673,7 @@
 
 \layout Standard
 
-host
+triggers
 \end_inset 
 </cell>
 <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
@@ -4256,6 +4681,8 @@
 
 \layout Standard
 
+
+\lang english
 string
 \end_inset 
 </cell>
@@ -4264,6 +4691,8 @@
 
 \layout Standard
 
+
+\lang english
 none
 \end_inset 
 </cell>
@@ -4271,8 +4700,18 @@
 \begin_inset Text
 
 \layout Standard
+
+Specifies a comma separated list of named triggers by id to import.
+ If set to 
+\begin_inset Quotes eld
+\end_inset 
+
+*
+\begin_inset Quotes eld
+\end_inset 
 
-The DNS name or IP address of the oracle database server.
+, then loads all named triggers from the library.
+ 
 \end_inset 
 </cell>
 </row>
@@ -4282,7 +4721,7 @@
 
 \layout Standard
 
-dbname
+pages
 \end_inset 
 </cell>
 <cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
@@ -4290,6 +4729,8 @@
 
 \layout Standard
 
+
+\lang english
 string
 \end_inset 
 </cell>
@@ -4298,548 +4739,6 @@
 
 \layout Standard
 
-none
-\end_inset 
-</cell>
-<cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="true" rotate="false" 
usebox="none" width="" special="">
-\begin_inset Text
-
-\layout Standard
-
-The name of the oracle database to which we will connect.
-\end_inset 
-</cell>
-</row>
-</lyxtabular>
-
-\end_inset 
-
-
-\layout Subsubsection
-
-ODBC Provider
-\layout Standard
-
-The ODBC driver uses a slightly different provider attribute that should
- probably be made to conform to custom attributes.
- For now however the attribute is defined as 
-\layout Code
-
-provider="odbc|subpackage|DSN"
-\layout Standard
-
-An example showing the use of the MySQL ODBC driver is as follows
-\layout Code
-
-provider="odbc|mysql|mymysqldsn"
-\layout Subsubsection
-
-GEAS Provider
-\layout Standard
-
-
-\begin_inset  Tabular
-<lyxtabular version="2" rows="5" columns="4">
-<features rotate="false" islongtable="false" endhead="0" endfirsthead="0" 
endfoot="0" endlastfoot="0">
-<column alignment="center" valignment="top" leftline="true" rightline="true" 
width="" special="">
-<column alignment="center" valignment="top" leftline="false" rightline="false" 
width="" special="">
-<column alignment="center" valignment="top" leftline="true" rightline="false" 
width="" special="">
-<column alignment="left" valignment="top" leftline="true" rightline="true" 
width="" special="">
-<row topline="true" bottomline="true" newpage="false">
-<cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
-\begin_inset Text
-
-\layout Standard
-
-
-\lang english
-Attribute
-\end_inset 
-</cell>
-<cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
-\begin_inset Text
-
-\layout Standard
-
-
-\lang english
-Datatype
-\end_inset 
-</cell>
-<cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
-\begin_inset Text
-
-\layout Standard
-
-
-\lang english
-Default
-\end_inset 
-</cell>
-<cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="true" rotate="false" 
usebox="none" width="" special="">
-\begin_inset Text
-
-\layout Standard
-
-
-\lang english
-Description
-\end_inset 
-</cell>
-</row>
-<row topline="true" bottomline="false" newpage="false">
-<cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
-\begin_inset Text
-
-\layout Standard
-
-name
-\end_inset 
-</cell>
-<cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
-\begin_inset Text
-
-\layout Standard
-
-string
-\end_inset 
-</cell>
-<cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
-\begin_inset Text
-
-\layout Standard
-
-none
-\end_inset 
-</cell>
-<cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="true" rotate="false" 
usebox="none" width="" special="">
-\begin_inset Text
-
-\layout Standard
-
-The name of the database used within the form.
-\end_inset 
-</cell>
-</row>
-<row topline="true" bottomline="false" newpage="false">
-<cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
-\begin_inset Text
-
-\layout Standard
-
-provider
-\end_inset 
-</cell>
-<cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
-\begin_inset Text
-
-\layout Standard
-
-string
-\end_inset 
-</cell>
-<cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
-\begin_inset Text
-
-\layout Standard
-
-
-\lang english
-none
-\end_inset 
-</cell>
-<cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="true" rotate="false" 
usebox="none" width="" special="">
-\begin_inset Text
-
-\layout Standard
-
-The name of the database driver.
- Would be set to geas here.
-\end_inset 
-</cell>
-</row>
-<row topline="true" bottomline="false" newpage="false">
-<cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
-\begin_inset Text
-
-\layout Standard
-
-host
-\end_inset 
-</cell>
-<cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
-\begin_inset Text
-
-\layout Standard
-
-string
-\end_inset 
-</cell>
-<cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
-\begin_inset Text
-
-\layout Standard
-
-none
-\end_inset 
-</cell>
-<cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="true" rotate="false" 
usebox="none" width="" special="">
-\begin_inset Text
-
-\layout Standard
-
-The DNS name or IP address of the geas database server.
-\end_inset 
-</cell>
-</row>
-<row topline="true" bottomline="true" newpage="false">
-<cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
-\begin_inset Text
-
-\layout Standard
-
-dbname
-\end_inset 
-</cell>
-<cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
-\begin_inset Text
-
-\layout Standard
-
-string
-\end_inset 
-</cell>
-<cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
-\begin_inset Text
-
-\layout Standard
-
-none
-\end_inset 
-</cell>
-<cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="true" rotate="false" 
usebox="none" width="" special="">
-\begin_inset Text
-
-\layout Standard
-
-The name of the geas database to which we will connect.
-\end_inset 
-</cell>
-</row>
-</lyxtabular>
-
-\end_inset 
-
-
-\layout Subsection
-
-Example
-\layout Standard
-
-To provide the form a database object named prod which connects to a Postgresql
- server's production database.
- The server is running on host rdbms.example.com
-\layout Standard
-
-<database name="prod" provider="postgresql" dbname="production" 
host="rdbms.examp
-le.com"/>
-\layout Section
-
-<datasource>
-\layout Subsection
-
-Attributes
-\layout Standard
-
-
-\begin_inset  Tabular
-<lyxtabular version="2" rows="7" columns="4">
-<features rotate="false" islongtable="false" endhead="0" endfirsthead="0" 
endfoot="0" endlastfoot="0">
-<column alignment="center" valignment="top" leftline="true" rightline="false" 
width="" special="">
-<column alignment="center" valignment="top" leftline="true" rightline="false" 
width="" special="">
-<column alignment="center" valignment="top" leftline="true" rightline="false" 
width="" special="">
-<column alignment="left" valignment="top" leftline="true" rightline="true" 
width="" special="">
-<row topline="true" bottomline="true" newpage="false">
-<cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
-\begin_inset Text
-
-\layout Standard
-
-
-\lang english
-Attribute
-\end_inset 
-</cell>
-<cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
-\begin_inset Text
-
-\layout Standard
-
-
-\lang english
-Datatype
-\end_inset 
-</cell>
-<cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
-\begin_inset Text
-
-\layout Standard
-
-
-\lang english
-Default
-\end_inset 
-</cell>
-<cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="true" rotate="false" 
usebox="none" width="" special="">
-\begin_inset Text
-
-\layout Standard
-
-
-\lang english
-Description
-\end_inset 
-</cell>
-</row>
-<row topline="true" bottomline="false" newpage="false">
-<cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
-\begin_inset Text
-
-\layout Standard
-
-
-\lang english
-name
-\end_inset 
-</cell>
-<cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
-\begin_inset Text
-
-\layout Standard
-
-
-\lang english
-string
-\end_inset 
-</cell>
-<cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
-\begin_inset Text
-
-\layout Standard
-
-
-\lang english
-none
-\end_inset 
-</cell>
-<cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="true" rotate="false" 
usebox="none" width="" special="">
-\begin_inset Text
-
-\layout Standard
-
-
-\lang english
-A unique ID for the widget.The name of the widget.
-\end_inset 
-</cell>
-</row>
-<row topline="true" bottomline="false" newpage="false">
-<cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
-\begin_inset Text
-
-\layout Standard
-
-
-\lang english
-database
-\end_inset 
-</cell>
-<cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
-\begin_inset Text
-
-\layout Standard
-
-
-\lang english
-string
-\end_inset 
-</cell>
-<cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
-\begin_inset Text
-
-\layout Standard
-
-
-\lang english
-none
-\end_inset 
-</cell>
-<cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="true" rotate="false" 
usebox="none" width="" special="">
-\begin_inset Text
-
-\layout Standard
-
-
-\lang english
-The name of the database object the datasource will utilize.
-\end_inset 
-</cell>
-</row>
-<row topline="true" bottomline="false" newpage="false">
-<cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
-\begin_inset Text
-
-\layout Standard
-
-
-\lang english
-table
-\end_inset 
-</cell>
-<cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
-\begin_inset Text
-
-\layout Standard
-
-
-\lang english
-string
-\end_inset 
-</cell>
-<cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
-\begin_inset Text
-
-\layout Standard
-
-
-\lang english
-none
-\end_inset 
-</cell>
-<cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="true" rotate="false" 
usebox="none" width="" special="">
-\begin_inset Text
-
-\layout Standard
-
-
-\lang english
-The name of the table the datasource to which the datasourse must attach.
-\end_inset 
-</cell>
-</row>
-<row topline="true" bottomline="false" newpage="false">
-<cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
-\begin_inset Text
-
-\layout Standard
-
-
-\lang english
-order_by
-\end_inset 
-</cell>
-<cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
-\begin_inset Text
-
-\layout Standard
-
-
-\lang english
-string
-\end_inset 
-</cell>
-<cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
-\begin_inset Text
-
-\layout Standard
-
-
-\lang english
-none
-\end_inset 
-</cell>
-<cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="true" rotate="false" 
usebox="none" width="" special="">
-\begin_inset Text
-
-\layout Standard
-
-
-\lang english
-A comma seperated list of fields within the table.
- The datasource will present the information sorted by this list of fields.
-\end_inset 
-</cell>
-</row>
-<row topline="true" bottomline="false" newpage="false">
-<cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
-\begin_inset Text
-
-\layout Standard
-
-
-\lang english
-prequery
-\end_inset 
-</cell>
-<cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
-\begin_inset Text
-
-\layout Standard
-
-
-\lang english
-string
-\end_inset 
-</cell>
-<cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
-\begin_inset Text
-
-\layout Standard
-
-
-\lang english
-none
-\end_inset 
-</cell>
-<cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="true" rotate="false" 
usebox="none" width="" special="">
-\begin_inset Text
-
-\layout Standard
-
-
-\lang english
-Causes the datasource to load all data from the table into memory.
- Usefull for validation purposes and obtaining values to dropdown style
- entry objects.
-\end_inset 
-</cell>
-</row>
-<row topline="true" bottomline="true" newpage="false">
-<cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
-\begin_inset Text
-
-\layout Standard
-
-
-\lang english
-sql
-\end_inset 
-</cell>
-<cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
-\begin_inset Text
-
-\layout Standard
-
-
-\lang english
-string
-\end_inset 
-</cell>
-<cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
-\begin_inset Text
-
-\layout Standard
-
 
 \lang english
 none
@@ -4849,283 +4748,163 @@
 \begin_inset Text
 
 \layout Standard
-
-
-\series bold 
-\lang english
-No longer active.
-
-\series default 
- A way of overriding the internal sql generation functions of the datasource
- with hard coded sql.
-\end_inset 
-</cell>
-</row>
-</lyxtabular>
-
-\end_inset 
-
-
-\layout Subsection
-
-Example
-\layout Standard
-
-<datasource name="customers" database="gnue" table="customer" 
order_by="name_las
-t,name_first" prequery="" />
-\layout Section
-
-<trigger>
-\layout Subsection
-
-Attributes
-\layout Standard
-
-
-\begin_inset  Tabular
-<lyxtabular version="2" rows="4" columns="4">
-<features rotate="false" islongtable="false" endhead="0" endfirsthead="0" 
endfoot="0" endlastfoot="0">
-<column alignment="center" valignment="top" leftline="true" rightline="false" 
width="" special="">
-<column alignment="center" valignment="top" leftline="true" rightline="false" 
width="" special="">
-<column alignment="center" valignment="top" leftline="true" rightline="false" 
width="" special="">
-<column alignment="left" valignment="top" leftline="true" rightline="true" 
width="" special="">
-<row topline="true" bottomline="true" newpage="false">
-<cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
-\begin_inset Text
-
-\layout Standard
-
-
-\lang english
-Attribute
-\end_inset 
-</cell>
-<cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
-\begin_inset Text
-
-\layout Standard
-
 
-\lang english
-Datatype
+Specifies a comma separated list of names of pages to import.
+ If set to 
+\begin_inset Quotes eld
 \end_inset 
-</cell>
-<cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
-\begin_inset Text
-
-\layout Standard
-
 
-\lang english
-Default
+*
+\begin_inset Quotes eld
 \end_inset 
-</cell>
-<cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="true" rotate="false" 
usebox="none" width="" special="">
-\begin_inset Text
-
-\layout Standard
-
 
-\lang english
-Description
+, then loads all pages INCLUDING unnamed pages from the library.
+ 
 \end_inset 
 </cell>
 </row>
-<row topline="true" bottomline="false" newpage="false">
-<cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
-\begin_inset Text
-
-\layout Standard
-
-
-\lang english
-name
-\end_inset 
-</cell>
-<cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
-\begin_inset Text
-
-\layout Standard
-
+</lyxtabular>
 
-\lang english
-string
 \end_inset 
-</cell>
-<cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
-\begin_inset Text
-
-\layout Standard
 
 
-\lang english
-none
-\end_inset 
-</cell>
-<cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="true" rotate="false" 
usebox="none" width="" special="">
-\begin_inset Text
+\layout Subsubsection
 
+Example
 \layout Standard
-
 
-\lang english
-A unique ID for the widget.The name of the widget.
+Import all datasources and the pages identified as 
+\begin_inset Quotes eld
 \end_inset 
-</cell>
-</row>
-<row topline="true" bottomline="false" newpage="false">
-<cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
-\begin_inset Text
-
-\layout Standard
-
 
-\lang english
-type
+page1
+\begin_inset Quotes erd
 \end_inset 
-</cell>
-<cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
-\begin_inset Text
-
-\layout Standard
 
-
-\lang english
-string
+ and 
+\begin_inset Quotes eld
 \end_inset 
-</cell>
-<cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
-\begin_inset Text
-
-\layout Standard
 
-
-\lang english
-none
+page2
+\begin_inset Quotes erd
 \end_inset 
-</cell>
-<cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="true" rotate="false" 
usebox="none" width="" special="">
-\begin_inset Text
-
-\layout Standard
 
+: 
+\layout Code
 
-\lang english
-Specifies when the trigger should fire.
- For a list of available triggers see the Trigger section of Chapter 2
+<import library=
+\begin_inset Quotes erd
 \end_inset 
-</cell>
-</row>
-<row topline="true" bottomline="true" newpage="false">
-<cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
-\begin_inset Text
-
-\layout Standard
 
-src
+mylibrary.gfl
+\begin_inset Quotes erd
 \end_inset 
-</cell>
-<cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
-\begin_inset Text
-
-\layout Standard
 
-string
+ datasources=
+\begin_inset Quotes erd
 \end_inset 
-</cell>
-<cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="false" rotate="false" 
usebox="none" width="" special="">
-\begin_inset Text
-
-\layout Standard
 
-none
+*
+\begin_inset Quotes erd
 \end_inset 
-</cell>
-<cell multicolumn="0" alignment="center" valignment="top" topline="true" 
bottomline="false" leftline="true" rightline="true" rotate="false" 
usebox="none" width="" special="">
-\begin_inset Text
 
-\layout Standard
-
-Used to call named triggers.
+ pages=
+\begin_inset Quotes erd
 \end_inset 
-</cell>
-</row>
-</lyxtabular>
 
+page1,page2
+\begin_inset Quotes erd
 \end_inset 
 
-
+/>
 \layout Subsection
 
-Example
+Importing Individual Objects
 \layout Subsubsection
-
-Simple Embedded
-\layout Standard
 
-<entry>
+Summary
 \layout Standard
 
-<trigger type ="Pre-FocusOut"> 
+The second method of importing involves importing named objects.
+ The currently importable objects are: datasource, page, block, trigger,
+ button, and entry.
+ 
 \layout Standard
 
-block1.fields.one = self.value
+The tag for importing these objects is the <import-[object]> tag, where
+ [object] is the type of object being imported.
+ For example, the tag for importing blocks is <import-block>.
+ 
 \layout Standard
 
-</trigger>
+All <import-[object]> style tags take a minimum of two tags, location and
+ name (or id for triggers), plus any tags available to the imported tag.
+ Location works the same as in the above table for form-level objects.
 \layout Standard
 
-</entry>
+Any of these extra tags override the values of the imported tag.
+ For example, the datasource tag supports the database tag.
+ Therefore, the import-datasource tag also supports the database tag.
+ If database is specified on the import-datasource tag, then this value
+ overrides the value set in the library file.
+ This is especially useful for master-detail datasources as a common detail
+ block can be defined in a library, but the master datasource may be different
+ in each form.
 \layout Subsubsection
-
-Named
-\layout Standard
-
-This was taken from the sample/po form.
-\layout Standard
 
-<form>
+Example
 \layout Standard
 
-<trigger type="named" id="trggrAmount">
-\layout Standard
+Import a datasource: 
+\layout Code
 
-# 
-\layout Standard
+<import-datasource location=
+\begin_inset Quotes erd
+\end_inset 
 
-#Calculate Amount 
-\layout Standard
+mylibrary.gfl
+\begin_inset Quotes erd
+\end_inset 
 
-# import sys 
-\layout Standard
+ name=
+\begin_inset Quotes erd
+\end_inset 
 
-blckPOItem.fields.ntryAmount=str(int(blckPOItem.fields.ntryQuantity)*float(blckPOIte
-m.fields.ntryUnitPrice)) 
-\layout Standard
+dszipcodes
+\begin_inset Quotes erd
+\end_inset 
 
-</trigger>
+/>
 \layout Standard
 
+Import an entry, overriding the bounded field: 
+\layout Code
 
-\emph on 
-more form stuff
-\layout Standard
+<import-entry location=
+\begin_inset Quotes erd
+\end_inset 
 
-<entry ......>
-\layout Standard
+mylibrary.gfl
+\begin_inset Quotes erd
+\end_inset 
 
-<trigger type="Pre-FocusOut" src="trggrAmount" /> 
-\layout Standard
+ name=
+\begin_inset Quotes erd
+\end_inset 
 
-</entry>
-\layout Standard
+zipentry
+\begin_inset Quotes erd
+\end_inset 
 
+ field=
+\begin_inset Quotes erd
+\end_inset 
 
-\emph on 
-more form stuff
-\layout Standard
+zipfield2
+\begin_inset Quotes erd
+\end_inset 
 
-</form>
+/>
 \layout Section
 
 Complete Example
@@ -5177,12 +4956,6 @@
 \SpecialChar ~
 \SpecialChar ~
 </options>
-\layout Quotation
-
-\SpecialChar ~
-\SpecialChar ~
-<database name="gnue" provider="postgresql" dbname="gnue" host="gnue"/>
- 
 \layout Quotation
 
 \SpecialChar ~
[Prev in Thread]
Current Thread
[Next in Thread]
gnue/gnuef/doc techref.lyx, Jason Cater <=
Prev by Date: gnue/geas/src/oql oql.c
Next by Date: gnue/geas/src geas-server.c geas-skeleton.c sec...
Previous by thread: gnue/geas/src/objectcache objectcache.c
Next by thread: gnue/geas/src geas-server.c geas-skeleton.c sec...
Index(es):
- Date
- Thread