Restrictions de l'instantané Acumatica

Introduction

Cet article fait suite à l'article de blog restaurer des instantanés volumineux qui décrit comment restaurer un ensemble de données de plus d'un gigaoctet vers une nouvelle instance.

Bien qu'utile, nous avons constaté que tous nos clients ont au moins un champ défini par l'utilisateur qui doit être migré vers la nouvelle instance. Pour ce faire, veuillez suivre les étapes ci-dessous.

Préparation des données

1. Créez un instantané des données que vous souhaitez importer dans la nouvelle instance. Il est recommandé d'utiliser le format XML.
2. Naviguez jusqu'au dossier "Database/Data" dans l'installation de l'assistant Acumatica.
   Ex : C:\NProgram Files (x86)\NAcumatica ERP_19_201_0070\NAcumatica ERP\NDatabase\NData
3. Créez un dossier pour contenir les données de l'instantané.
   Ex : NonProfitPlus
4. Extraire tous les fichiers d'instantanés dans le dossier créé.
5. Supprimer le fichier Manifest.xml du dossier créé après l'extraction.

Modifier l'assistant

Pour permettre l'insertion de données provenant de colonnes et de tables personnalisées contenues dans votre instantané, vous devrez modifier le fichier ERPDatabaseSetup.ADC dans l'assistant Acumatica. Les fichiers à noter et leur fonction sont énumérés ci-dessous.

• ERPDatabaseSetup.ADC - Définit le processus d'installation et les références
• database_schema - Définit les tables et les champs à créer lors de l'installation
• database_afterschema - Définit le "nettoyage" des données après la création de tables et de champs et l'insertion de données.
• database_update - Définit la mise à jour des données à partir des versions précédentes du schéma des tables et des champs.
• database_procs_mssql - Définit la création de FUNCTION, VIEW, PROCEDURE pour mssql
• databse_procs_mysql - Définit la création de FUNCTION, VIEW, PROCEDURE pour mysql

1. Naviguez jusqu'au dossier "Database" dans l'installation de l'assistant Acumatica.
   Ex : C:\NProgram Files (x86)\NAcumatica ERP_19_201_0070\NAcumatica ERP\NDatabase
2. Ouvrez le fichier ERPDatabseSetup.ADC et modifiez-le en ajoutant la ligne suivante :GIST: https://gist.github.com/jvanhoesen/1ce49027a4bd62e8127982254bf1b14d
3. Créez le fichier XML database_schema_custom.xml dans le dossier "Database", son schéma générique est le suivant :
   
   
   
   GIST : https://gist.github.com/jvanhoesen/15bff372f40aa7e2d68373761d8649a6

La manière la plus simple de construire ce fichier est d'ouvrir le fichier project.xml des projets de personnalisation qui ont été chargés sur l'instance de snapshot et de trouver la section où les tables personnalisées sont définies. Supprimez la syntaxe supplémentaire et insérez-la dans votre fichier database_schema_custom.xml nouvellement créé.

Ex :

GIST : https://gist.github.com/jvanhoesen/df6066f1662c933168d26f7b517efef1

Devient :

GIST : https://gist.github.com/jvanhoesen/15bff372f40aa7e2d68373761d8649a6

Création d'une instance

1. Ouvrez l'assistant Acumatica et suivez les étapes normales de la création de l'instance.
2. À l'étape de la configuration du locataire, vous verrez que vos données personnalisées sont maintenant disponibles.
    
3. Après l'installation, téléchargez et publiez les paquets de personnalisation à partir de l'instance d'origine.

Conclusion

Bien qu'Acumatica limite par défaut la taille de la restauration d'un instantané à 1 Go, il est possible d'y remédier. La modification de l'assistant de configuration d'Acumatica ERP permet de créer une nouvelle instance à partir de l'instantané défini, en incluant les champs et les tables des projets de personnalisation publiés lors de la création de l'instantané.

Bon codage !