Installation
[Back To Page Map]
You should first download and install the latest version
of
eXtensible Programming
Script (XPS) v3.2p. At least v3.2p and above is necessary.
Once you have installed XPS v3.2p (or above), you can then
download and install the
UBLish v0p70.10 package
by unzipping it anywhere within your PC's harddisk. The UBLish script
("UBLish.xps")
is ready to go inside the ./bin/ directory.
In the description that
follows, we refer to the sub-directories and files with
the assumption of current directory being the top-level
directory of the unzipped UBLish archive, and referred to
as "./".
You will find the following sub-directories:
./bin/
[Back To Page Map]
This binary directory contains the UBLish application
"UBLish.xps" itself. It is an XPS application, which
means that you can also look at the content using a text
editor. As XPS carries a syntax similar to C or Perl,
it would not be too difficult for a programmer familiar
with them to read the script, even without prior knowledge
of XPS. However, you are not advised to modify the script
unless you are perfectly sure what you are doing.
You must have installed XPS with at least version 3.2p
or above in order to run UBLish v0p70.10 properly. If you
had done that, you should see the files displayed as a
little red inverted 3D prism. Once you double-click that,
you launch UBLish.
If you don't see the red inverted 3D prism, check that
you have installed XPS v3.2p. If you had installed earlier
versions of XPS, it is a good idea to uninstall them first
before installing v3.2p. To do that, go to
Start -> Control Panel -> Add/Remove Programs
and select the old XPS version to uninstall.
./doc
[Back To Page Map]
This directory contains two sub-directories. The spreadsheet
directory "0p70-xls-mod" contains spreadsheets suitable as
source files for UBLish's "Spreadsheet-->Schema" generation
functions. The schema directory "0p70-xsd" contains schema
files suitable to be used as source files for UBLish's
"Schema-->Spreadsheet" generation functions.
./doc/0p70-xls-mod
[Back To Page Map]
This contains a list of the 7 document types defined in
UBL 0p70's spreadsheet "xls" directory. These files have
the same content, except that a few areas where they hinder
UBLish from operating properly are fixed. Most notably,
they are all removed of macros as no macro was used anyway.
Other minor modifications include:
UBL_Library_0p70_Invoice.xls:
In row 1, all 36 columns have trailing column index integers
following the column name. Their presence is not in line
with the other spreadsheets and so have to be trimmed.
UBL_Library_0p70_OrderResponse.xls:
In row 1, the first 5 columns have trailing column index integers
following the column name. Their presence is not in line
with the other spreadsheets and so have to be trimmed.
It also appears to have a very large "logical" canvas as shown
by the horizontal scrollbar's small size. The large size
appears to exceed operating limits in UBLish and so extra
unused/invisible columns were trimmed.
UBL_Library_0p70_Reusable.xls:
It appears to have a very large "logical" canvas as shown
by the horizontal scrollbar's small size. The large size
appears to exceed operating limits in UBLish and so extra
unused/invisible columns were trimmed.
./doc/0p70-xsd
[Back To Page Map]
This sub-directory contains a set of the same schema files
as stored in the UBL 0p70 archive. This is provided for
convenience only. Users should always refer back to the
UBL site and UBL 0p70 archive for references.
./etc/
[Back To Page Map]
This contains the initial splash screen graphics bitmap.
./xls-dir/
[Back To Page Map]
This is the spreadsheet output directory used by UBLish to
store generated spreadsheets under the "Schema-->Spreadsheet"
functions.
./xls-template/
[Back To Page Map]
This sub-directory stores template files required by UBLish
to perform "Schema-->Spreadsheet" functions. They should not
be opened or modified.
./xsd-dir/
[Back To Page Map]
This is the schema output directory used by UBLish to store
generated schema files under the "Schema-->Spreadsheet" functions.
Note that all such functions require a previously generated
copy of "Reusable" schema file stored in the schema directory
"./xsd-dir/" with the filename "UBL_Library_0p70_Reusable.xsd".
If UBLish does not find the Reusable schema file, it will prompt
for you to specify the location of either the Reusable schema
file stored else where and make a copy, or the Reusable source
spreadsheet to generate a Reusable schema automatically.