OPALE - 10.0 - Usage
File Formats
Project/Format:
A Designer project is made up of an overlay (static part of the template) and a data file (variable part or dynamic part of the template). A project has a specific format name and sequence number which make it unique within the production Server.
A project is composed of three files (or five files when it is a double-sided project) :
- A .mpw file which contains the simplex of the overlay (another one can contain the duplex side of the overlay).
- A .mpi file which contains the data formatting (template) on the simplex side (another file can possibly contain the data formatting for the duplex side of the project).
- A .mpp file identifies the project and merges the .mpw and .mpi file(s).
- Project associations are files with *.MPA extensions
The name project is used as the template is designed in Designer. Once generated in the production server, we refer to it as a format with a sequence number.
Creating a project:
To create a new project, select New, then Project, in the File Menu.
The designing view then displays the project as a blank page with default configuration (portrait, A4, simplex mode).
First, fill in the project properties:
- Name of the format: identifies the format with 10 characters maximum.
- Sequence number: identifies the sequence numerically with 5 characters maximum.
These two first parameters are required.
Other parameters can be configured in the Properties window (Tick the box Properties in the Display Menu):
- Description: user information with 25 characters maximum.
- Comment: additional information.
- Shared folder: generation path of the project (also defined in Preferences).
- Mode: corresponds to the type of data to format: SPLF (text) or XML.
- Code Page: opens a non-Unicode spooled file with an XPS template by specifying the code page of the file in the project properties. This option is only accessible in SPLF mode.
- Designing language: defines the languages in which the template is designed, using a drop-down menu.
- Orientation: Portrait or Landscape, for the simplex and the duplex.
- Page size (standard ISO formats, or customized format) and margins.
- Simplex/Duplex project (flip the page on the long or the short edge)
- Page break: default setting of the application as it processes data one page at a time and adds a page break once the data of a page has been completely processed. If the break is deactivated, the data of the following page will be placed after that of the page processed.
- Position: if the page break is deactivated, this option lets you specify where to place the data of the following page: on the right of the page being currently processed (horizontal position shift) or underneath (vertical shift). This option is only available in XPS.
Format:
Opened in OPALE Server, a Format is a Designer project which was generated and imported on the production server. A format can be composed of several sequences.
Every sequence is conditioned to run on different pages of a data file (spooled file or XML file).
Here is an example to better understand the benefit of having several sequences for one project:
On an invoice with 3 pages:
- The first page includes the recipient's address, the sender's address as well as the start of the invoice table (Page type 1)
- The last page includes the price to pay (Page type 2)
- All the other pages contain the body of the invoice (Page type 3)
Processing the spooled file with the same format is difficult since formatting can differ depending on the page type. Three formats will then be created, one for each page type. These three formats will have the same name because the three together make THE document "invoice" template, however they will have different sequence numbers:
- Sequence 00010 runs on page type 1
- Sequence 00020 runs on page type 2.
- Sequence 00030 runs on page type 3.
When running the invoice format on a data file, a "MERGE" of these sequences is carried out to process the spooled file entirely.
Resources:
List all formats using a particular resource (a font, an overlay or a component).
MAPLNK is the file which links together all resources and formats available on OPALE Server.
On IBM i: DSPPFM FILE(MAPLNK)