Manipulations obligatoires à la mise à jour vers ACE 5.0-00 ou ACE 1.0

Introduction

Ce document liste l’ensemble des mises en garde liées à une monté de version vers :

Une version 5.0-00 ou postérieure
Une version ACE 1.0 ou postérieure

Mise en garde

Avant de mettre à jour votre version ACE , nous vous invitons à lire ces quelques pages, et notamment les chapitres qui concernent la nouvelle gestion du mot de passe utilisateur et la nouvelle gestion des sociétés.

La lecture de l’ensemble des guides d’installation, et notamment le guide d’installation du paramétrage, est nécessaire.

Structure d’accueil

Lors du passage d’une version antérieure à la V5.0-00 vers une version postérieure ou égale à la V5.0-00 ou une version postérieure ou égale à ACE 1.0, une mise à jour est effectuée sur trois tables particulièrement sensibles :

les utilisateurs (UT_UTI),
les sociétés (UT_SOC),
les identifiants d’accès (UT_LOGIN).

Compatibilité avec Oracle

La mise à jour vers ACE 5.1-00 ou GCE1.0 ES2 implique au minimum une version Oracle 9.2 (0.4 minimum) avec une compatibilité égale à la version.

Mise en garde

Le passage d’une version Oracle 8i et inférieure vers une version Oracle 9i exige la présence de compétences spécifiques.

Toute installation d’ACE avec Oracle 9i nécessite de créer la base avec les outils Oracle (Database Configuration Assistant : DBA). Cette opération n’est pas réalisée par les outils d’installation fournis par ACE.

ACE propose des prestations pour vous aider à la mise en place du paramétrage nécessaire.

Nombre de copies sur les impressions

A partir de la version ACE 5.0-00 ou GCE1.0 , le nombre de copies est géré dans le fichier « modif_tty_print.exe ».

L'impression par ACE envoie un nouveau paramètre vers ce fichier :

· nombre_copies,

Le fichier « modif_tty_print » présent dans les versions antérieures à la V5.0-00 doit nécessairement être modifié pour bénéficier de cette évolution.

ACE fournit systématiquement, dans le répertoire des exécutables « exe », un nouveau fichier ayant valeur de modèle.

Nouvelle gestion des utilisateurs

Depuis les versions ACE 5.0-00 et GCE1.0 , un utilisateur possède un mot de passe unique pour l’ensemble des sociétés auxquelles il a accès au sein de la même instance physique.

Les utilisateurs sont toujours gérés au niveau de chaque société, les mots de passe dans la table UT_LOGIN indépendamment du code société.

Le champ "passe" de la table UT_UTI est supprimé et remplacé par le champ "password" de la table UT_LOGIN.

Règle de mise à jour de la table UT_LOGIN

Si le même utilisateur est présent dans plusieurs sociétés avec des mots de passe différents, on crée automatiquement cet utilisateur dans la table UT_LOGIN en y affectant le mot de passe associé au code société le plus petit (table UT_UTI).
La table UT_UTI est ensuite mise à jour (suppression du champ « passe »).

Exemple :

Œ Avant la mise à jour

Table UT_UTI

Nom du champ	UTI	PASSE	CODSOC
	GNC	INFOR1	1
	GNC	DIFFERENT	2
	Georges	Action	1

Après mise à jour

Table UT_LOGIN

Nom du champ	USERNAME	PASSWORD	UTI
	GNC	INFOR1	GNC
	Georges	Action	Georges

Table UT_UTI

Nom du champ	UTI	CODSOC
	GNC	1
	GNC	2
	Georges	1

Ces évolutions de la gestion des utilisateurs ont été prises en compte au niveau des fonctions GBLV, GCAI et GTIE.

En effet, l’écran GBLV_PASSE est remplacé par l’écran RMCR_PASSE :

Le champ « username » est ajouté dans les écrans GTIE_19 et GTIE_XCTC,
Le champ « password » est ajouté dans les écrans GTIE_19, GTIE_XCTC et GCAI_4.

Il vous faut par conséquent mettre à jour les écrans paramétrés GTIE_19, GTIE_XCTC et GCAI_4.

Nouvelle gestion des sociétés

Depuis les versions ACE 5.0-00 ou GCE1.0 , il ne peut y avoir de doublons dans la table les sociétés.

L’index est en effet unique sur le champ "soc" de la table UT_SOC.

Règle de mise à jour de la table UT_SOC

Si des sociétés (SOC) sont présentes plusieurs fois dans la tableUT_SOC, on récupère les enregistrements du code société (CODSOC) le plus petit.

Exemple :

Œ Avant la mise à jour (table UT_SOC)

Nom du champ	SOC	CODSOC
	1	1
	2	1
	1	1000
	1000	1000

Après mise à jour (table UT_SOC)

Nom du champ	SOC	CODSOC
	1	1
	2	1
	1000	1000

Outils de contrôle sur le site support

Afin de préparer la migration, sans devoir faire l’installation d’ACE 5.0-00 ou GCE1.0 , il est possible de simuler les modifications qui seront apportées par ces nouvelles gestions des sociétés et des utilisateurs, à l'aide d'outils accessibles sur le site de support « https://support.aurea.com/ »

Ces outils sont fournis sous la forme de scripts SQL regroupés dans une archive nommée « check_uti_soc_v500 » et accessible dans la rubrique « Documentation »

à Documentations Techniques,

à Notices Thématiques,

à Installation,

à V5.0-00.

Principe

L'exécution de ces scripts SQL sur la base avant migration permet de visualiser quelles seront les modifications apportées à la gestion des sociétés et des utilisateurs.

Les scripts SQL sont à déclencher après s’être connecté à la base sur le compte Oracle propriétaire des tables ACE (SOCx).

Ils présentent, dans trois tableaux, la situation actuelle, la situation future et les différences entre les deux situations.

Présentation des scripts

check_soc_V500.sql

Affiche les évolutions prévues sur la gestion des sociétés.
check_uti_V500.sql

Affiche les évolutions prévues sur la gestion des utilisateurs
check_V500_txt.sql
Déclenche les 2 premiers scripts et génère dans le répertoire courant des fichiers de compte-rendu au format texte :
- check_soc_V500.txt
- check_uti_V500.txt
- check_V500_html.sql
Déclenche les 2 premiers scripts et génère dans le répertoire courant des fichiers de compte-rendu au format HTML (à partir d’Oracle 8i) :
- check_soc_V500.xml
- check_uti_V500.xml

UTILISATION : multi entités

Pré-requis pour le passage en version ACE 5.0-00 ou GCE1.0 : utilisation du mode multi entités.

Mode mono société avec code société à 0

Ce chapitre ne concerne que les clients utilisant auparavant le mode mono société avec un code société égal à 0.

Pré requis pour le passage en version ACE 5.0-00 ou GCE1.0 : utilisation du mode multi-entités.

Le code société ne peut pas être égal à 0, il est donc nécessaire d'affecter un code société à l'ensemble des tables.

Attention

Les opérations suivantes ne doivent être réalisées que si vous passez d’une version antérieure à la V5.0-00 vers une version postérieure ou égale à ACE 5.0-00ou GCE1.0 .

· Sauvegarder chaque société Physique (compte Oracle).

· Modifier le code société (champ « codsoc ») dans l'ensemble des tables ACE.

· Après avoir pris garde de vérifier dans chaque société physique que le nouveau code société n'est pas utilisé.

Pour chaque société physique, lancer la requête SQL de mise à jour du codsoc = 0:

@sql_o/update_codsoc.sql n (n = numéro du nouveau code société)

· Modification du fichier Generix.ini :

Positionner le mode société à « Oui ».

[Global]

Mode Multisociete=OUI

Vérifier le rattachement des sociétés

[Societes]

societe_1=1

· Spécifiques clients : points de contrôle indispensables

Vérifier et éventuellement modifier :

- les triggers et procédures stockées,

- les requêtes SQL,

- les vues.

Adapter les éventuels spécifiques client utilisant le MCD d’ACE.

Trucs et astuces

Pour toute prestation concernant la prise en charge de ces spécifiques, il est conseillé de se rapprocher de vos contacts habituels chez ACE.
Si plusieurs comptes Oracle étaient utilisés en mode mono société, il est fortement recommandé, pour simplifier l'utilisation d’ACE, de profiter du passage dans une nouvelle version pour regrouper l'ensemble de ces sociétés dans un même compte Oracle.

Modification du fichier « Generix.ini »

Partage de la table UT_SOC

Pour les versions antérieures à la V5.0-00, il était conseillé de partager la table des sociétés.

Depuis la version 5.0-00, le partage de la table UT_SOC, pour toutes les sociétés logiques d'une même instance physique, devient un impératif de fonctionnement.

Une instance physique par environnement

Dans le cas plus général d’une instance physique par environnement, il est conseillé d’utiliser la société de référence (codsoc) pour renseigner l’ensemble des sociétés.

[Global]

Societe de Reference=1

[Societes]

societe_1=1

societe_2=1

Un environnement avec deux instances physiques

Dans le cas d’un environnement avec deux instances physiques, la société de référence devra être renseignée avec l’ensemble des sociétés.

Pour chaque instance physique, les sociétés devront être renseignées dans une société (codsoc) qui sera utilisée comme partage pour l’ensemble des sociétés de l’instance physique.

[Global]

Societe de Reference=1

[Societes]

societe_1=1

societe_2=1

...

societe_1000=1000

societe_1001=1000

[Tables_2]

ut_soc=1

...

[Tables_1001]

ut_soc=1000

Partage des autres tables

Trucs et astuces

ACE rappelle qu‘il est fortement conseillé de partager les tables suivantes :

- messages (UT_MES) ,

- désignations des paramètres (PARAM),

- files d’attente (UT_FIL).

Reprise écrans paramétrés

Attention

Ce chapitre ne concerne que les clients réalisant une montée de version antérieure à la V 4.2-00 vers une version postérieure ou égale à ACE 5.0-00 ou GCE1.0 .

L’évolution permanente d’ACEa des impacts sur les écrans paramétrés créés par nos clients.

Cette évolution était importante lors du passage en version 4.2-00.

ACE conseille de procéder à cette reprise en plusieurs étapes :

1. Avant toute opération, sauvegarder les écrans paramétrés

2. Installation partielle de la version 4.2-00

Sur un poste client, installer le répertoire « upgrade vers 420 » sur le disque c : de préférence***

Contenu :

écrans de la version 4.2-00

exécutable de reprise des écrans paramétrés pour le passage d’une version < 4.2-00 vers une version 4.2-00

Generix.ini simplifié

Si l’installation est réalisée sur un autre disque et/ou vers un autre répertoire, il y a lieu de modifier

3. Copier les écrans paramétrés sur le poste client dans le répertoire :

C:\upgrade_420\langue\fra\cli

En cas de transfert des fichiers paramétrés d’une plate-forme Unix vers la plate-forme Windows, les fichiers *.pch_<langue> sont à transférés en BINAIRE ; les fichiers *.se_<langue> sont à transférés en ASCII

4. Se positionner en Invite de commande DOS

5. Se positionner dans le répertoire :

c:\upgrade_420

6. Lancer la moulinette de reprise :

exe\moul_pch_v3000

Valider par entrée les messages :

Liste des fichiers [ap$cli_fra:*.pch_fra] :

Mode DEBUG [N] ?

Après cette étape, les écrans paramétrés sont au niveau de la version 4.2-00.

Positionner les écrans dans l’environnement de la nouvelle version.

7. Suivre le guide d’installation de la nouvelle version pour le passage des écrans version 4.2-00 vers une version >= 5.0-00.

Pour les montées de version >= 4.2-00 vers une version >= 5.0-00, suivre le guide d'installation pour l'utilisation de la moulinette de reprise (pch_dse)

Pré requis techniques

Nous vous rappelons qu’il est nécessaire de vérifier que votre environnement matériel respecte les pré-requis mentionnés dans le guide d’installation fourni.

ACE : Convention de nommage

Pour réaliser de nouvelles pages ou modifier un scénario proposé dans les Web Module ACE, il est recommandé de respecter les conventions de nommage définies par ACE :

· Tout objet fourni par ACE, modifié à des fins spécifiques, doit être dupliqué.

· Tout nouvel objet spécifique doit être préfixé « S_ »

· Pour toute information complémentaire, il est conseillé de se rapprocher de l’équipe Projet d’ACE.

· Le respect de ces conventions permettra à ACE le suivi des évolutions chez l'ensemble des clients.

Système d’impression immédiate (S2I-UERP)

Attention

Ce chapitre ne concerne que les clients réalisant une montée de version vers ACE 1.0 ES2

Le système d’impression immédiate n’est disponible qu’à compter de la version ACE 1.0 ES2 sur les serveurs de traitement indiqués sur la matrice correspondante disponible sur le site du support ACE :https://support.aurea.com/

Trucs et astuces

Une prestation ACE est recommandée pour la mise en place du paramétrage de cette fonctionnalité,

Fonctionnalité Prix en unité de facturation

Cette fonctionnalité a évolué et nécessite de lancer une reprise. Pour d’avantage d’informations, se référer à la documentation de référence (recherche sur TARUF).