Configuring ONYX Designer

Configuring Designer

After Designer was installed, the first step is to configure Preferences (see 1) of the application. They are accessed from the File menu (see 2). The preferences are local to the current user and are stored in the Windows registry of the workstation under HKEY_CURRENT_USER/Software/Mapping.

General

The first tab of the Preferences window displays the general options of the application.

Automatic save

This option programs an automatic save of the projects being designed (opened in the application). The projects are saved at regular intervals defined in minutes in the corresponding input field.

Lock projects upon opening

As will be referred to later in this guide, several users can work with Designer at the same time using a common folder for projects. In this case activating this feature is recommended as it will prevent concurrent access to the same project.

As soon as a user opens a project, writing access is denied to other users. Other users can then only access the project in read-only mode.

Create .bak files

This option allows you to keep N-1 versions of the project when saving it. The corresponding files then have the ".bak" suffix added as their extension.

Select object before moving

As will be referred to later in this guide, All objects positioned in the document template can be edited and moved around. This option forces the user to select an object before he can move it. This prevents objects from being moved accidentally as you select them.

Enable script editor

This option allows you to create, edit, or delete its very scripts. (see Script editing link)

Show all component’s errors

This option affects the number of error windows appearing when opening a project with components that are unavailable in the project folder.

• Activated by default, one window is displayed per missing component, asking for the user to provide said component.
• Deactivated, component errors are gathered and displayed in the same window.

Straight lines

This option forces the application to only draw horizontal or vertical lines (most currently used) by disabling oblique lines.

Temporary folder

This option defines the path of the temporary folder. By default, this is the folder for the installation of the application but this value can be changed if needed.

List of characters to be displayed in double width

This input field allows you to add hexadecimal values (or ranges of values) of specific characters to consider and display in double width.

This option is useful to display datastreams in the Spool view and preview the document template in real time. A similar feature can be found on Onyx Server in the configuration variable MAPCPYSPLF_DBCSPITCH_LIST.

Default style

This list is used to select or not select a style model for defining a specified list of colours, line type, fonts, etc. for your project.

Language

This option is used to choose the display language of the interfaces of the application. The default language of Designer is the same as that of your operating system. The available languages are English, French and Japanese.

Changing the language of Designer affects the other tools in the Suite, including Connect, and the application has to be restarted for any change to be registered.

Configuring the servers

The Servers tab of the Preferences view is used to configure the paths the application must have access to:

• The shared folder of the Designer projects sources.
• The import folders for formats in Onyx Server.

Le répertoire partagé des sources contient l’ensemble des projets développés par tous les utilisateurs Designer.

Une fois développés, les projets Designer doivent être générés sur le serveur de production dans le répertoire d’importation.

Voici les chemins par défaut du répertoire d’importation de Onyx Server suivant le type de plateforme :

• Unix : /apps/mapping/import/
• Windows: C:\Mapping\M-Processing Server\Import\

Afin de permettre cette génération, une connexion doit donc être établie entre les postes de développement et le serveur de production. Deux types de configuration sont possibles.

Accès au serveur via un répertoire partagé

Paramètres requis :

• Nom du serveur : Nom donné à la configuration.
• Répertoire de partage : Répertoire partagé pour les sources.
• Chemin d'accès : Chemin de destination de la génération.
• Répertoire d'importation : Répertoire d’importation de Onyx Server, utilisé uniquement pour l'option "Envoi mapping".

Le répertoire d’accès au serveur peut être :

• Un chemin UNC Exemples: \\test_server\ProgramData\M-Processing Server\Import\ (sous Windows) \\test_server \home\mapping\ (sous iSeries)

• Un lecteur réseau pointant sur le répertoire d’importation Exemple : soit un lecteur réseau « M: » pointant sur le dossier « ...\M-Processing Server » du serveur de production. Le répertoire d’accès contiendra donc « M:\Import\ ».

Dans le cas d’un serveur de production Unix, ce mode de connexion nécessite l’installation d’un logiciel de type « Samba » afin de faire communiquer le poste de développement et le serveur de production. La connexion en mode FTP sera préférée.

Accès au serveur via une connexion FTP

Dans ce cas, une connexion FTP (ou SFTP) doit être établie entre le poste de développement et le serveur de production.

Paramètres requis :

• Nom du serveur : Nom donné à la configuration.
• FTP/FTP Passif/Secure FTP : Choix du mode de connexion : FTP, FTP Passif, Secure FTP.
• Adresse IP on Nom : Adresse IP du serveur de production.
• Login : Nom d’utilisateur pour l’accès FTP.
• Mot de passe : Mot de passe associé.
• Répertoire de partage : Répertoire partagé pour les sources.
• Chemin d’accès : Chemin d’accès au répertoire d’importation de Onyx Server.
• Répertoire d'importation : Répertoire d’importation de Onyx Server, utilisé uniquement pour l'option "Envoi mapping".

Police

Le champ Génération des polices XPS par page de code permet de pré-charger les polices XPS en définissant un ou plusieurs code-pages afin d'optimiser les temps de traitement pendant le process. Le caractère de séparation des code-pages est le « ; ».

Note : Lors de l’importation d’un projet, si celui-ci est rédigé avec une police non enregistrée, une alerte signale alors que la police est manquante et elle apparaitra en rouge dans les Propriétés de la Zone concernée.

Options de calcul

Les deux options présentes dans l’onglet Calcul définissent les types de séparateurs de milliers et de décimales. Ces informations sont utilisées pour la récupération de valeurs entières ou réelles dans l’application (par des zones mémoires), les calculs effectués et l’affichage des résultats à l’aperçu.

Elles n’ont pas d’influence sur la génération des projets.

Deux variables équivalentes existent côté M-Processing Server pour l’exécution : MAPCPYSPLF_THOUSAND et MAPCPYSPLF_DECIMAL.

Ces paramètres sont pris en compte pour l’exécution de toutes les maquettes, cependant ils peuvent être substitués avant exécution de ces commandes Mapping afin de correspondre à des paramètres régionaux différents de ceux du serveur.