Paramétrage de ONYX Designer

<languages/>
<translate>
=Paramétrage de Designer= <!--T:1-->

<!--T:2-->
Après installation de Designer, la première étape clé est le paramétrage des ''Préférences'' (cf. '''1''') de l’application. Celles-ci sont accessibles depuis le menu ''Fichier'' (cf. '''2'''). Ces préférences sont <span class="underline">locales</span> à l’utilisateur en cours et elles sont conservées dans la base de registre du poste sous ''HKEY_CURRENT_USER''/''Software''/''Mapping''.

<!--T:3-->
[[File:onyxdesigner-image1.png]]

==Général== <!--T:4-->

<!--T:5-->
[[File:Onyxdesigner-image3.png]]

<!--T:6-->
Le premier onglet de la fenêtre de ''Préférences'' présente les options générales de l’application.

===Enregistrement automatique=== <!--T:7-->

<!--T:8-->
Cette option permet de forcer une sauvegarde automatique des projets en cours de conception (ouverts dans l’application) à intervalles réguliers définis en minutes dans la zone de saisie correspondante.

===Verrouiller les projets à l'ouverture=== <!--T:9-->

<!--T:10-->
Comme il sera mentionné dans la suite de ce Guide, plusieurs utilisateurs peuvent travailler en même temps avec Designer dans un répertoire commun pour les projets. Dans ce contexte, il est fortement conseillé d’activer cette option qui permet d’éviter les concurrences d’accès sur un même projet.

<!--T:11-->
Dès qu’un utilisateur ouvre un projet, il en verrouille les accès en écriture. Les autres utilisateurs ne pourront en consulter qu’une version en lecture seule.

===Créer les fichiers .bak=== <!--T:12-->

<!--T:13-->
Cette option permet, à l’enregistrement d’un projet provoqué par l’utilisateur, de conserver une version N-1 du projet juste avant l’enregistrement. Les fichiers correspondants sont alors suffixés de l’extension ''.bak''.

===Sélectionner l'objet avant déplacement=== <!--T:14-->

<!--T:15-->
Comme il sera mentionné dans la suite de ce Guide, tous les objets positionnés dans le modèle de document peuvent être modifiés et/ou déplacés. Cette option permet de forcer l’utilisateur à sélectionner un objet avant de pouvoir le déplacer à la souris. Cela peut éviter des déplacements intempestifs d’objets lors des sélections.

===Activer l'édition des scripts=== <!--T:16-->

<!--T:17-->
Cette option permet à l’utilisateur de créer, modifier ou supprimer ses propres scripts. (Cf. Lien édition des scripts)

===Afficher toutes les erreurs de composants=== <!--T:18-->

<!--T:19-->
Cette option agit sur le nombre de fenêtres d’erreur à l’ouverture d’un projet contenant des composants qui ne seraient pas ou plus disponibles dans le répertoire des projets.

<!--T:20-->
*<span class="underline">Activée par défaut</span>, une fenêtre par composant non disponible est affichée à l’utilisateur et il lui est proposé de retrouver le composant en question.
*<span class="underline">Désactivée</span>, les erreurs de composant sont mutualisées et affichées dans une seule fenêtre.

===Forcer le tracé de traits rectilignes=== <!--T:21-->

<!--T:22-->
Cette option permet de forcer le tracé de lignes horizontales ou verticales uniquement (les plus couramment utilisées) en désactivant la possibilité de lignes obliques.

===Répertoire temporaire=== <!--T:23-->

<!--T:24-->
Cette option permet de définir le chemin du répertoire temporaire. Par défaut, il s’agit du répertoire d’installation de l’application mais cette valeur peut être modifiée si besoin.

===Liste de caractères à afficher en double largeur=== <!--T:25-->

<!--T:26-->
Cette zone de saisie permet d’ajouter les valeurs (ou plages de valeurs) hexadécimales de caractères spécifiques à considérer et à afficher en double largeur.

<!--T:27-->
Cette option sert, côté Designer, pour l’affichage des flux de données dans la vue Spool et pour l’aperçu en temps réel du modèle de document. L’équivalent existe côté Onyx Server pour l’exécution, dans la variable de configuration ''MAPCPYSPLF_DBCSPITCH_LIST''.

===Style par défaut=== <!--T:28-->

<!--T:29-->
Cette liste permet de sélectionner ou non un modèle de style pour définir une liste définie de couleurs, de type de trait, de polices, etc., pour votre projet.

===Langue=== <!--T:30-->

<!--T:31-->
Cette option permet à l’utilisateur de choisir la langue d’affichage des interfaces de l’application. La langue, par défaut, de Designer sera la même que celle de votre système d'exploitation. Les langages proposés actuellement sont le français, l'anglais et le japonais.

<!--T:32-->
Le changement de la langue d’affichage de Designer impacte les autres outils de la Suite, notamment Connect, et tout changement nécessite un redémarrage de l’application.

==Paramétrage des serveurs== <!--T:33-->

<!--T:34-->
L’onglet ''Serveurs'' de la vue ''Préférences'' permet de configurer les accès dont doit disposer l’application :

<!--T:35-->
*Au répertoire partagé des sources des projets Designer.
*Au(x) répertoire(s) d’importation des formats dans Onyx Server.

<!--T:36-->
Le répertoire partagé des sources contient l’ensemble des projets développés par tous les utilisateurs Designer.

<!--T:37-->
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.

<!--T:38-->
Voici les chemins par défaut du répertoire d’importation de Onyx Server suivant le type de plateforme :

<!--T:39-->
*<span class="underline">Unix</span> : '''/apps/mapping/import/'''
*<span class="underline">Windows</span>: '''C:\Mapping\M-Processing Server\Import\'''

<!--T:40-->
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é=== <!--T:41-->

<!--T:42-->
[[File:Onyxdesigner-image6.png]]

<!--T:43-->
<span class="underline">Paramètres requis</span> :

<!--T:44-->
*'''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".


<!--T:45-->
Le répertoire d’accès au serveur peut être :

<!--T:46-->
*Un chemin UNC <span class="underline">Exemples</span>:  <code>\\test_server\ProgramData\M-Processing Server\Import\ (sous Windows)</code>  <code>\\test_server \home\mapping\ (sous iSeries)</code>

<!--T:47-->
*Un lecteur réseau pointant sur le répertoire d’importation <span class="underline">Exemple</span> : 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\ ».

<!--T:48-->
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=== <!--T:49-->

<!--T:50-->
Dans ce cas, une connexion FTP (ou SFTP) doit être établie entre le poste de développement et le serveur de production.

<!--T:51-->
[[File:onyxdesigner-image8.png]]

<!--T:52-->
<span class="underline">Paramètres requis</span> :

<!--T:53-->
*'''Nom du serveur''' : Nom donné à la configuration.
*'''FTP/FTP Passif/Secure FTP''' : Choix du mode de connexion : FTP, FTP Passif, Secure FTP.
*'''Adresse IP ou 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".


Une fois la configuration terminée, utiliser le bouton "Test connexion" afin de vérifier que la communication FTP ou sFTP avec le serveur est correcte.

====Erreur: Connexion sFTP avec le serveur refusée...====
Jusqu'en version v9.x.x , Mapping Designer établissait une connexion sFTP basée sur le protocole ''diffie-hellman-group1-sha1''.

Si le serveur '''sshd''' ne permet pas l'utilisation de ce protocole, il faut prévoir de l'ajouter en modifiant sa configuration comme suit :  

Fichier de configuration du serveur ssh : <code>/etc/ssh/sshd_config</code> 

Ajouter les 2 lignes suivantes : 

 KexAlgorithms diffie-hellman-group1-sha1,curve25519-sha256@libssh.org,ecdh-sha2-nistp256,ecdh-sha2-nistp384,ecdh-sha2-nistp521,diffie-hellman-group-exchange-sha256,diffie-hellman-group14-sha1
 Ciphers 3des-cbc,blowfish-cbc,aes128-cbc,aes128-ctr,aes256-ctr

==Police== <!--T:54-->

<!--T:55-->
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 « ''';''' »'''.'''

<!--T:56-->
'''<span class="underline">Note</span> :''' 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.

<!--T:57-->
[[File:onyxdesigner-image9.jpeg]]

<!--T:58-->
[[File:onyxdesigner-image10.jpeg]]

==Options de calcul== <!--T:59-->

<!--T:60-->
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.

<!--T:61-->
Elles n’ont pas d’influence sur la génération des projets.

<!--T:62-->
Deux variables équivalentes existent côté M-Processing Server pour l’exécution : ''MAPCPYSPLF_THOUSAND'' et ''MAPCPYSPLF_DECIMAL''.

<!--T:63-->
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.

= Troubleshooting =
== Test connexion : contient un chemin non valide ==

 mon serveur\TestConnect.tmp contient un chemin non valide

* Répertoire de partage DOIT finir par un anti-slash.
**  Il doit aussi s'agit d'un répertoire contenant un répertoire intitulé "docpc".
* Chemin d'accès ne doit pas comporter de symbole final.

</translate>