TelFormFactory in brief
TelFormFactory is an application to produce Java data input forms called TelForms which run on PC's, in Web Browsers and on Java Mobile devices. To produce the TelForm output TelFormFactory is used to produce an XML Schema - an international standard for defining data. The advantage of this is that Systems departments are already familiar with XML Schema so for business' integrated changes to Client-Server systems may be rapidly executed and rich client forms are available in seconds for your customers.
Start the TelFormFactory Application
It is assumed that TelFormFactory and Java Development Kit are correctly installed. If not see installation page.
The TFF application consists of
See telformfactory_userguide.html for more detail.
TelForm data content design
TelFormFactory projects save information needed to re-create the XML Schema, and other information needed to reproduce TelForm Clients, and basic project management data, in a TelFormFactory file. This naturally conforms to an XML Schema, and is validated on opening.
Note that the TelFormFactory model does not affect the look or presentation of the client TelForm. It is involved with the Data structure and content. Some advanced options do affect the TelForm content, but the customer is allowed to choose colours, sounds and other preferences.
Demonstrating with AllTypesTelForm.xml
Under the 'File' menu, select 'Open TelFormFactory File' - choose the AllTypesTelForm.xml in the 'docs' folder in the TelFormFactory directory.
Expected outcome: The TelForm model will form consisting of all the TelFormFactory Datatypes on each page.
More information: TelFormFactory file corruption should be detected on opening and validation. Did you backup your data?
Save XML Schema
The XML Schema is the form that companies use to verify that the information is correct and thats the form they use to create the TelForm applets and midlets, the application that their customers fill in. You'd probably want to save that as say AllTypesTelForm.xsd. Save that.
Go to the XML Schema button, press that and it will ask you to save the name of the XML Schema. Save XML Schema as 'AllTypesTelForm.xsd'
Expected outcome: This will validate OK.
More information: If the TelForm model produced by AllTypesTelForm.xml has not changed then the schema should be valid. Ensure there is adequate disc space. Do you have Internet access? See telformfactory_userguide.html for more detail.
Generate TelForm Clients
A Customer uses a Java PC or Mobile device to input data using a TelForm. TelFormFactory can produce TelForms which correspond to the current XML Schema:
Select all clients, (Applet, Application and Midlet) and click on Generate TelForms Out and the 3 output processes progress bars are displayed as the different TelForms are generated. This should take less than 30 seconds.
Expected outcome: A Success message displaying time taken and output directory.
More information: See output messages and TelFormFactoryLog in case of problems. Rerun with debug enabled if required.
Exit TelFormFactory from the File menu, and confirm shutdown.
In the TelFormFactory directory 'out' is the TelForm output. Assuming 3 TelForm clients were selected there will be 3 directories for Java applet, (applet); application (main) and midlet (midp1) TelForms. The suffix indicates the Java version. Within each of the three directories pub directory, and optionally, a src directory.
Output directory contents
Some PC Operating Systems, web browsers and Mobile devices may give security warnings for unrecognised software, or even prevent them running. By 'signing' your output with a digital signature your TelForm customers may be spared this confusion. In the TelFormFactory directory are 3 script files:
Depending on your TelFormFactory platform - select the appropriate batch or shell file. This needs to be edited with your details and those of your Company, web domain and so on. Type signer (or signerMAC) from the command line which calls the batch file which digitally 'signs' those packages that have been generated. This is known as self-signing but the output may also be used to obtain commercial digital certificates.
For some platforms or systems it may be that no signature is better than an unrecognised issuer. By default the midlet jar is now not signed. Uncomment the lines in the signer batch file containing 'midp1' to over-ride this.
See TelForm Security for opinions on current security issues.
Run TelForm clients
Run the 3 types of demonstration clients. See TelForm Client Guides for details:
Press autodata to fill fields with valid data and then test. The Server will reply that the data is valid. Also:-
In case of problems - rerun the Client with debug enabled. Ask your TelFormHost provider to check server logs.
Customise a new TelForm
Imagine the details needed to register a new Customer for your business:-
Note: xsd:string will accept almost text. There is a powerful mechanism to use here called Regular Expressions. See regex.html
Change some preferences - Colours, Founts, XSD validators and others.
Expected outcome: The changes have registered in Java Preferences and will be restored even after reboot.
|Overview||TelFormFactory||TelForm Host||TelForm Clients||TelForm Security|
|Windows||TelForms on PCs||TelForms on Mobiles||Download PDFS||Download TelFormFactory|