

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Conversion du code SQL d'une application en utilisant AWS SCT
<a name="CHAP_Converting.App"></a>

Lorsque vous convertissez votre schéma de base de données à partir d'un moteur à un autre, vous devez également mettre à jour le code SQL dans vos applications pour interagir avec le nouveau moteur de base de données au lieu de l'ancien. Vous pouvez afficher, analyser, modifier et enregistrer le code SQL converti.

Vous pouvez utiliser le AWS Schema Conversion Tool (AWS SCT) pour convertir le code SQL dans votre code d'application C\$1\$1, C\$1, Java ou autre. Pour une conversion d'Oracle vers PostgreSQL, vous pouvez l' AWS SCT utiliser pour convertir le code SQL\$1Plus en PSQL. En outre, pour une conversion d'Oracle vers PostgreSQL, vous pouvez l' AWS SCT utiliser pour convertir le code SQL intégré dans les applications C\$1, C\$1\$1, Java et Pro\$1C.

**Topics**
+ [

## Présentation de la conversion du code SQL d'une application
](#CHAP_Converting.App.Overview)
+ [

# Convertissez le code SQL dans vos applications avec AWS SCT
](CHAP_Converting.App.Generic.md)
+ [

# Conversion de code SQL dans des applications C\$1 avec AWS Schema Conversion Tool
](CHAP_Converting.App.Csharp.md)
+ [

# Conversion de code SQL dans des applications C\$1\$1 avec AWS Schema Conversion Tool
](CHAP_Converting.App.Cplusplus.md)
+ [

# Conversion de code SQL dans des applications Java avec AWS Schema Conversion Tool
](CHAP_Converting.App.Java.md)
+ [

# Conversion de code SQL dans les applications Pro\$1C avec AWS Schema Conversion Tool
](CHAP_Converting.App.ProC.md)

## Présentation de la conversion du code SQL d'une application
<a name="CHAP_Converting.App.Overview"></a>

Pour convertir le code SQL dans votre application, suivez les étapes de haut niveau suivantes : 
+ **Créer un projet de conversion d'application : le projet** de conversion d'application est un enfant du projet de conversion de schéma de base de données. Chaque projet de conversion de schéma de base de données peut avoir un ou plusieurs projets de conversion d'application enfant. Pour de plus amples informations, veuillez consulter [Création de projets de conversion d'applications génériques dans AWS SCT](CHAP_Converting.App.Generic.md#CHAP_Converting.App.Project). 
+ **Analysez et convertissez votre code SQL** : AWS SCT analyse votre application, extrait le code SQL et crée une version locale du code SQL converti que vous pouvez consulter et modifier. L'outil ne change pas le code de votre application jusqu'à ce que vous soyez prêt. Pour de plus amples informations, veuillez consulter [Analyse et conversion de votre code SQL dans AWS SCT](CHAP_Converting.App.Generic.md#CHAP_Converting.App.Convert). 
+ **Création d'un rapport d'évaluation des applications** : le rapport d'évaluation des applications fournit des informations importantes sur la conversion du code SQL de l'application de votre schéma de base de données source vers le schéma de base de données cible. Pour de plus amples informations, veuillez consulter [Création et utilisation du rapport AWS SCT d'évaluation dans AWS SCT](CHAP_Converting.App.Generic.md#CHAP_Converting.App.AssessmentReport). 
+ **Modifiez, appliquez des modifications et enregistrez votre code SQL converti** : le rapport d'évaluation inclut une liste d'éléments de code SQL qui ne peuvent pas être convertis automatiquement. Pour ces éléments, vous pouvez modifier le code SQL manuellement pour exécuter la conversion. Pour de plus amples informations, veuillez consulter [Modifier et enregistrer votre code SQL converti avec AWS SCT](CHAP_Converting.App.Generic.md#CHAP_Converting.App.Edit). 

# Convertissez le code SQL dans vos applications avec AWS SCT
<a name="CHAP_Converting.App.Generic"></a>

Vous pouvez l'utiliser AWS SCT pour convertir le code SQL intégré à vos applications. Le convertisseur AWS SCT d'applications générique traite le code de votre application comme du texte brut. Il analyse le code de votre application et extrait le code SQL à l'aide d'expressions régulières. Ce convertisseur prend en charge différents types de fichiers de code source et fonctionne avec le code d'application écrit dans n'importe quel langage de programmation.

Le convertisseur d'applications génériques présente les limites suivantes. Il n'explore pas en profondeur la logique de l'application spécifique au langage de programmation de votre application. De plus, le convertisseur générique ne prend pas en charge les instructions SQL provenant de différents objets d'application, tels que les fonctions, les paramètres, les variables locales, etc.

Pour améliorer la conversion du code SQL de votre application, utilisez des convertisseurs de code SQL d'application spécifiques au langage. Pour plus d’informations, consultez [Code SQL dans les applications C\$1](CHAP_Converting.App.Csharp.md), [Code SQL en Java](CHAP_Converting.App.Java.md) et [Code SQL dans Pro\$1C](CHAP_Converting.App.ProC.md).

## Création de projets de conversion d'applications génériques dans AWS SCT
<a name="CHAP_Converting.App.Project"></a>

Dans le AWS Schema Conversion Tool, le projet de conversion de l'application est un enfant du projet de conversion du schéma de base de données. Chaque projet de conversion de schéma de base de données peut avoir un ou plusieurs projets de conversion d'application enfant.

**Note**  
AWS SCT ne prend pas en charge la conversion entre les sources et cibles suivantes :  
Oracle vers Oracle
PostgreSQL vers PostgreSQL ou Aurora PostgreSQL
MySQL vers MySQL
SQL Server vers SQL Server
Amazon Redshift vers Amazon Redshift
SQL Server vers Babelfish
Services d'intégration de SQL Server pour AWS Glue
Apache Cassandra vers Amazon DynamoDB

 Utilisez la procédure suivante pour créer un projet de conversion d'application générique. 

**Pour créer un projet de conversion d'application**

1. Dans le menu **Applications AWS Schema Conversion Tool**, choisissez **Nouvelle application générique**. 

   La boîte de dialogue **New application conversion project** s'affiche.   
![\[Boîte de dialogue New application conversion project (Nouveau projet de conversion d'application)\]](http://docs.aws.amazon.com/fr_fr/SchemaConversionTool/latest/userguide/images/applications-new-project.png)

1. Ajoutez les informations du projet suivantes.   
****    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/SchemaConversionTool/latest/userguide/CHAP_Converting.App.Generic.html)

1. Sélectionnez **Ne pas convertir les variables de liaison en types SQL pour** éviter la conversion des types de variables de liaison en types SQL. Cette option n'est disponible que pour une conversion d'Oracle vers PostgreSQL.

   Par exemple, le code source de votre application inclut la requête Oracle suivante :

   ```
   SELECT * FROM ACCOUNT WHERE id = ?
   ```

   Lorsque vous sélectionnez **Ne pas convertir les variables de liaison en types SQL**, AWS SCT convertit cette requête comme indiqué ci-dessous.

   ```
   SELECT * FROM account WHERE id = ?
   ```

   Lorsque vous désactivez la **case Ne pas convertir les variables de liaison en types SQL**, AWS SCT le type de variable de liaison est remplacé par le type de `NUMERIC` données. Le résultat de la conversion est affiché ci-dessous.

   ```
   SELECT * FROM account WHERE id = (?)::NUMERIC
   ```

1. Sélectionnez **Conserver les noms d'objets** pour éviter d'ajouter le nom du schéma au nom de l'objet converti. Cette option n'est disponible que pour une conversion d'Oracle vers PostgreSQL.

   Supposons, par exemple, que le code source de votre application inclut la requête Oracle suivante.

   ```
   SELECT * FROM ACCOUNT
   ```

   Lorsque vous sélectionnez **Conserver les noms d'objets**, AWS SCT convertit cette requête comme indiqué ci-dessous.

   ```
   SELECT * FROM account
   ```

   Lorsque vous désactivez **l'option Conserver les noms d'objets**, AWS SCT ajoute le nom du schéma au nom de la table. Le résultat de la conversion est affiché ci-dessous.

   ```
   SELECT * FROM schema_name.account
   ```

   Si votre code source inclut les noms des objets parents dans les noms des objets, AWS SCT utilise ce format dans le code converti. Dans ce cas, ignorez l'option **Conserver les noms des objets** car elle AWS SCT ajoute les noms des objets parents dans le code converti.

1. Choisissez **OK** pour créer votre projet de conversion d'application. 

   La fenêtre de projet s'ouvre.  
![\[Fenêtre de projet\]](http://docs.aws.amazon.com/fr_fr/SchemaConversionTool/latest/userguide/images/applications-project-window.png)

## Gestion des projets de conversion d'applications dans AWS SCT
<a name="CHAP_Converting.App.Manage"></a>

Vous pouvez ouvrir un projet de conversion d'applications existant et ajouter plusieurs projets de conversion d'applications.

Après avoir créé un projet de conversion d'applications, la fenêtre du projet s'ouvre automatiquement. Vous pouvez fermer la fenêtre du projet de conversion de l'application et y revenir ultérieurement.

**Pour ouvrir un projet de conversion d'applications existant**

1. Dans le panneau de gauche, choisissez le nœud du projet de conversion d'applications et ouvrez le menu contextuel (clic droit).

1. Choisissez **Gérer l'application**.

**Pour ajouter un projet de conversion d'applications supplémentaire**

1. Dans le panneau de gauche, choisissez le nœud du projet de conversion d'applications et ouvrez le menu contextuel (clic droit).

1. Choisissez **New application** (Nouvelle application).

1. Entrez les informations requises pour créer un nouveau projet de conversion d'applications. Pour de plus amples informations, veuillez consulter [Création de projets de conversion d'applications génériques](#CHAP_Converting.App.Project).

## Analyse et conversion de votre code SQL dans AWS SCT
<a name="CHAP_Converting.App.Convert"></a>

Utilisez la procédure suivante pour analyser et convertir votre code SQL dans le AWS Schema Conversion Tool. 

**Pour analyser et convertir votre code SQL**

1. Ouvrez un projet de conversion d'applications existant, puis choisissez **Analyser**. 

   AWS SCT analyse le code de votre application et extrait le code SQL. AWS SCT affiche le code SQL extrait dans la liste des **scripts SQL analysés**. 

1. Pour les **scripts SQL analysés**, choisissez un élément pour consulter le code SQL extrait. AWS SCT affiche le code de l'élément sélectionné dans le volet du **script SQL extrait**.

1. Choisissez **Convertir** pour convertir le code SQL dans le volet de **script SQL extrait**. AWS SCT convertit le code dans un format compatible avec votre base de données cible. 

   Vous pouvez modifier le code SQL converti. Pour de plus amples informations, veuillez consulter [Modification et enregistrement de votre code SQL converti](#CHAP_Converting.App.Edit).  
![\[Code SQL à analyser\]](http://docs.aws.amazon.com/fr_fr/SchemaConversionTool/latest/userguide/images/applications-project-analyze.png)

1. Lorsque vous créez un rapport d'évaluation de la conversion d'une application, il AWS SCT convertit tous les éléments de code SQL extraits. Pour de plus amples informations, veuillez consulter [Création et utilisation du rapport d'évaluation](#CHAP_Converting.App.AssessmentReport). 

## Création et utilisation du rapport AWS SCT d'évaluation dans AWS SCT
<a name="CHAP_Converting.App.AssessmentReport"></a>

Le *rapport d'évaluation de la conversion des applications* fournit des informations sur la conversion du code SQL de l'application dans un format compatible avec votre base de données cible. Le rapport détaille tout le code SQL extrait, tout le code SQL converti et les actions à effectuer pour le code SQL qui ne AWS SCT peut pas être converti. 

### Création d'un rapport d'évaluation de la conversion des applications
<a name="CHAP_Converting.App.AssessmentReport.Create"></a>

Utilisez la procédure suivante pour créer un rapport d'évaluation de la conversion des applications.

**Pour créer un rapport d'évaluation de la conversion des applications**

1. Dans la fenêtre du projet de conversion de l'application, choisissez **Créer un rapport** dans le menu **Actions**. 

   AWS SCT crée le rapport d'évaluation de la conversion des applications et l'ouvre dans la fenêtre du projet de conversion des applications. 

1. Vérifiez l'onglet **Summary**. 

   L'onglet **Résumé**, illustré ci-dessous, affiche les informations récapitulatives du rapport d'évaluation de l'application. Il indique les éléments du code SQL qui ont été convertis automatiquement et ceux qui ne l'ont pas été.   
![\[Onglet récapitulatif Application Assessment Report (Rapport d'évaluation d'application)\]](http://docs.aws.amazon.com/fr_fr/SchemaConversionTool/latest/userguide/images/applications-summary.png)

1. Choisissez les **actions d'extraction SQL**. 

   Consultez la liste des éléments de code SQL qui ne AWS SCT peuvent pas être extraits de votre code source. 

1. Choisissez les **actions de conversion SQL**. 

   Consultez la liste des éléments de code SQL qui ne AWS SCT peuvent pas être convertis automatiquement. Utilisez les actions recommandées pour convertir manuellement le code SQL. Pour plus d'informations sur la façon de modifier votre code SQL converti, consultez[Modifier et enregistrer votre code SQL converti avec AWS SCT](#CHAP_Converting.App.Edit). 

1. (Facultatif) Enregistrez une copie locale du rapport sous forme de fichier PDF ou de fichier de valeurs séparées par des virgules (CSV) :
   + Choisissez **Enregistrer au format PDF** en haut à droite pour enregistrer le rapport sous forme de fichier PDF.

      Le fichier PDF contient le résumé, les mesures à prendre et les recommandations relatives à la conversion des applications.
   + Choisissez **Enregistrer au format CSV en** haut à droite pour enregistrer le rapport sous forme de fichier CSV.

     Le fichier CSV contient des actions, des actions recommandées et une estimation de la complexité de l'effort manuel requis pour convertir le code SQL.

## Modifier et enregistrer votre code SQL converti avec AWS SCT
<a name="CHAP_Converting.App.Edit"></a>

Le rapport d'évaluation inclut une liste des éléments de code SQL qui ne AWS SCT peuvent pas être convertis. Pour chaque élément, AWS SCT crée une action dans l'onglet **Actions de conversion SQL**. Pour ces éléments, vous pouvez modifier le code SQL manuellement pour exécuter la conversion. 

Utilisez la procédure suivante pour modifier votre code SQL converti, appliquer les modifications et les enregistrer. 

**Pour modifier, appliquer des modifications à votre code converti de SQL et l'enregistrer**

1. Modifiez votre code SQL converti directement dans le volet **Target SQL script**. S'il n'y a aucun code converti affiché, vous pouvez cliquer dans le volet et commencer à taper. 

1. Une fois que vous avez terminé de modifier votre code SQL converti, choisissez **Apply**. A ce stade, les modifications sont enregistrées dans la mémoire, mais pas encore écrites dans votre fichier. 

1. Choisissez **Save** pour enregistrer vos modifications dans votre fichier. 

   Lorsque vous choisissez **Enregistrer**, vous remplacez votre fichier d'origine. Faites une copie de votre fichier d'origine avant d'enregistrer afin de conserver un enregistrement de votre code d'application d'origine. 

# Conversion de code SQL dans des applications C\$1 avec AWS Schema Conversion Tool
<a name="CHAP_Converting.App.Csharp"></a>

Pour une conversion d'Oracle vers PostgreSQL, vous pouvez AWS Schema Conversion Tool utiliser AWS SCT() pour convertir le code SQL intégré dans vos applications C\$1. Ce convertisseur d'application C\$1 spécifique comprend la logique de l'application. Il collecte des instructions situées dans différents objets d'application, tels que des fonctions, des paramètres, des variables locales, etc. 

Grâce à cette analyse approfondie, le convertisseur de code SQL de l'application C\$1 fournit de meilleurs résultats de conversion que le convertisseur générique. 

## Création de projets de conversion d'applications C\$1 dans AWS SCT
<a name="CHAP_Converting.App.Csharp.Create"></a>

Vous pouvez créer un projet de conversion d'application C\$1 uniquement pour convertir des schémas de base de données Oracle en schémas de base de données PostgreSQL. Assurez-vous d'ajouter une règle de mappage dans votre projet qui inclut un schéma Oracle source et une base de données PostgreSQL cible. Pour de plus amples informations, veuillez consulter [Cartographie des types de données dans AWS Schema Conversion Tool](CHAP_Mapping.md). 

Vous pouvez ajouter plusieurs projets de conversion d'applications dans un seul AWS SCT projet. Utilisez la procédure suivante pour créer un projet de conversion d'application C\$1. 

**Pour créer un projet de conversion d'applications C\$1**

1. Créez un projet de conversion de base de données et ajoutez une base de données Oracle source. Pour plus d’informations, consultez [Démarrage et gestion de projets dans AWS SCT](CHAP_UserInterface.Project.md) et [Ajouter des serveurs à un projet dans AWS SCT](CHAP_UserInterface.AddServers.md). 

1. Ajoutez une règle de mappage qui inclut votre base de données Oracle source et une base de données PostgreSQL cible. Vous pouvez ajouter une base de données PostgreSQL cible ou utiliser une plate-forme de base de données cible PostgreSQL virtuelle dans une règle de mappage. Pour plus d’informations, consultez [Cartographie des types de données dans AWS Schema Conversion Tool](CHAP_Mapping.md) et [Mappage vers des cibles virtuelles dans AWS Schema Conversion Tool](CHAP_Mapping.VirtualTargets.md). 

1. Dans le menu **Affichage**, choisissez **Vue principale**.

1. Dans le menu **Applications**, choisissez **Nouvelle application C\$1.**

   La boîte de dialogue **Création d'un projet de conversion d'application C\$1** apparaît.   
![\[La nouvelle boîte de dialogue du projet de conversion d'applications C#\]](http://docs.aws.amazon.com/fr_fr/SchemaConversionTool/latest/userguide/images/csharp-application-new-project.png)

1. Dans **Nom**, entrez le nom de votre projet de conversion d'application C\$1. Chaque projet de conversion de schéma de base de données pouvant comporter un ou plusieurs projets de conversion d'applications secondaires, choisissez un nom pertinent si vous ajoutez plusieurs projets. 

1. Dans **Emplacement**, entrez l'emplacement du code source de votre application. 

1. Dans l'arborescence des sources, choisissez le schéma utilisé par votre application. Assurez-vous que ce schéma fait partie d'une règle de mappage. AWS SCT met en évidence les schémas qui font partie d'une règle de mappage en gras. 

1. Cliquez **sur OK** pour créer votre projet de conversion d'application C\$1.

1. Trouvez votre projet de conversion d'applications C\$1 dans le nœud **Applications** du panneau de gauche.

## Conversion du code SQL de votre application C\$1 en AWS SCT
<a name="CHAP_Converting.App.Csharp.Convert"></a>

Après avoir ajouté votre application C\$1 au AWS SCT projet, convertissez le code SQL de cette application dans un format compatible avec votre plate-forme de base de données cible. Utilisez la procédure suivante pour analyser et convertir le code SQL intégré à votre application C\$1 dans le AWS Schema Conversion Tool. 

**Pour convertir votre code SQL**

1. Développez le nœud **C\$1** sous **Applications** dans le panneau de gauche.

1. Choisissez l'application à convertir et ouvrez le menu contextuel (clic droit).

1.  Choisissez **Convertir**. AWS SCT analyse vos fichiers de code source, détermine la logique de l'application et charge les métadonnées du code dans le projet. Ces métadonnées de code incluent les classes C\$1, les objets, les méthodes, les variables globales, les interfaces, etc. 

   Dans le panneau de base de données cible, AWS SCT crée une structure de dossiers similaire à celle de votre projet d'application source. Vous pouvez consulter ici le code d'application converti.  
![\[Code SQL à analyser\]](http://docs.aws.amazon.com/fr_fr/SchemaConversionTool/latest/userguide/images/csharp-applications-project-analyze.png)

1. Enregistrez le code d'application converti. Pour de plus amples informations, veuillez consulter [Sauvegarde du code d'application converti](#CHAP_Converting.App.Csharp.Save).

Vos applications C\$1 peuvent inclure du code SQL qui interagit avec différentes bases de données sources. Vous pouvez migrer vers PostgreSQL plusieurs de ces bases de données sources. Dans ce cas, assurez-vous de ne pas convertir le code SQL qui interagit avec les bases de données que vous avez exclues du périmètre de migration. Vous pouvez exclure les fichiers source de votre application C\$1 du champ de conversion. Pour ce faire, décochez les cases correspondant aux noms des fichiers que vous souhaitez exclure de la zone de conversion.

Après avoir modifié l'étendue de conversion, l'analyse du code SQL de tous les fichiers source de vos applications C\$1 se AWS SCT poursuit. AWS SCT Copie ensuite dans le dossier cible tous les fichiers source que vous avez exclus de la zone de conversion. Cette opération permet de créer votre application après avoir enregistré les fichiers d'application convertis.

## Enregistrez le code de votre application converti avec AWS SCT
<a name="CHAP_Converting.App.Csharp.Save"></a>

Pour enregistrer le code d'application converti, procédez comme suit.

**Pour enregistrer le code d'application converti**

1. Développez le nœud **C\$1** sous **Applications** dans le panneau de base de données cible.

1. Choisissez votre application convertie, puis cliquez **sur Enregistrer**.

1. Entrez le chemin d'accès au dossier pour enregistrer le code d'application converti, puis choisissez **Sélectionner un dossier**.

## Gestion des projets de conversion d'applications C\$1 dans AWS SCT
<a name="CHAP_Converting.App.Csharp.Manage"></a>

Vous pouvez ajouter plusieurs projets de conversion d'applications C\$1, mettre à jour le code d'application dans le AWS SCT projet ou supprimer un projet de conversion C\$1 de votre AWS SCT projet.

**Pour ajouter un projet de conversion d'application C\$1 supplémentaire**

1. Développez le nœud **Applications** dans le panneau de gauche.

1. Choisissez le nœud **C\$1** et ouvrez le menu contextuel (clic droit).

1. Choisissez **New application** (Nouvelle application).

1. Entrez les informations requises pour créer un nouveau projet de conversion d'application C\$1. Pour de plus amples informations, veuillez consulter [Création de projets de conversion d'applications C\$1](#CHAP_Converting.App.Csharp.Create).

Après avoir modifié le code source de votre application, chargez-le dans le AWS SCT projet.

**Pour télécharger le code d'application mis à jour**

1. Développez le nœud **C\$1** sous **Applications** dans le panneau de gauche.

1. Choisissez l'application à mettre à jour, puis ouvrez le menu contextuel (clic droit).

1. Choisissez **Actualiser**, puis **Oui**.

   AWS SCT télécharge le code de votre application depuis les fichiers source et supprime les résultats de conversion. Pour conserver les modifications de code que vous avez apportées AWS SCT et les résultats de la conversion, créez un nouveau projet de conversion en C\$1.

**Pour supprimer un projet de conversion d'application C\$1**

1. Développez le nœud **C\$1** sous **Applications** dans le panneau de gauche.

1. Choisissez l'application à supprimer, puis ouvrez le menu contextuel (clic droit).

1. Choisissez **Supprimer**, puis **OK**.

## Création d'un rapport d'évaluation de la conversion des applications C\$1 dans AWS SCT
<a name="CHAP_Converting.App.Csharp.AssessmentReport"></a>

Le *rapport d'évaluation de la conversion des applications C\$1* fournit des informations sur la conversion du code SQL intégré à votre application C\$1 en un format compatible avec votre base de données cible. Le rapport d'évaluation fournit les détails de conversion pour tous les points d'exécution SQL et tous les fichiers de code source. Le rapport d'évaluation inclut également des actions pour le code SQL qui ne AWS SCT peut pas être converti. 

Utilisez la procédure suivante pour créer un rapport d'évaluation de la conversion des applications C\$1.

**Pour créer un rapport d'évaluation de la conversion des applications C\$1**

1. Développez le nœud **C\$1** sous **Applications** dans le panneau de gauche.

1. Choisissez l'application à convertir et ouvrez le menu contextuel (clic droit).

1. Choisissez **Convertir**.

1. Dans le menu **Affichage**, choisissez **Affichage du rapport d'évaluation**.

1. Consultez l'onglet **Résumé**.

   L'onglet **Résumé**, illustré ci-dessous, affiche les informations de synthèse du rapport d'évaluation de l'application C\$1. Il affiche les résultats de conversion pour tous les points d'exécution SQL et tous les fichiers de code source.   
![\[Onglet récapitulatif du rapport d'évaluation des applications C#\]](http://docs.aws.amazon.com/fr_fr/SchemaConversionTool/latest/userguide/images/csharp-applications-summary.png)

1. Choisissez **Enregistrer les instructions au format JSON** pour enregistrer le code SQL extrait de votre application C\$1 sous forme de fichier JSON.

1. (Facultatif) Enregistrez une copie locale du rapport sous forme de fichier PDF ou de fichier de valeurs séparées par des virgules (CSV) :
   + Choisissez **Enregistrer au format PDF** en haut à droite pour enregistrer le rapport sous forme de fichier PDF.

      Le fichier PDF contient le résumé, les mesures à prendre et les recommandations relatives à la conversion des applications.
   + Choisissez **Enregistrer au format CSV en** haut à droite pour enregistrer le rapport sous forme de fichier CSV.

     Le fichier CSV contient des actions, des actions recommandées et une estimation de la complexité de l'effort manuel requis pour convertir le code SQL.

# Conversion de code SQL dans des applications C\$1\$1 avec AWS Schema Conversion Tool
<a name="CHAP_Converting.App.Cplusplus"></a>

Pour une conversion d'Oracle vers PostgreSQL, vous pouvez l' AWS SCT utiliser pour convertir le code SQL intégré à vos applications C\$1\$1. Ce convertisseur d'application C\$1\$1 spécifique comprend la logique de l'application. Il collecte des instructions situées dans différents objets d'application, tels que des fonctions, des paramètres, des variables locales, etc. 

Grâce à cette analyse approfondie, le convertisseur de code SQL de l'application C\$1\$1 fournit de meilleurs résultats de conversion que le convertisseur générique. 

## Création de projets de conversion d'applications C\$1\$1 dans AWS SCT
<a name="CHAP_Converting.App.Cplusplus.Create"></a>

Vous pouvez créer un projet de conversion d'application C\$1\$1 uniquement pour convertir des schémas de base de données Oracle en schémas de base de données PostgreSQL. Assurez-vous d'ajouter une règle de mappage dans votre projet qui inclut un schéma Oracle source et une base de données PostgreSQL cible. Pour de plus amples informations, veuillez consulter [Cartographie des types de données dans AWS Schema Conversion Tool](CHAP_Mapping.md). 

Vous pouvez ajouter plusieurs projets de conversion d'applications dans un seul AWS SCT projet.

**Pour créer un projet de conversion d'applications C\$1\$1**

1. Créez un projet de conversion de base de données et ajoutez une base de données Oracle source. Pour plus d’informations, consultez [Démarrage et gestion de projets dans AWS SCT](CHAP_UserInterface.Project.md) et [Ajouter des serveurs à un projet dans AWS SCT](CHAP_UserInterface.AddServers.md). 

1. Ajoutez une règle de mappage qui inclut votre base de données Oracle source et une base de données PostgreSQL cible. Vous pouvez ajouter une base de données PostgreSQL cible ou utiliser une plate-forme de base de données cible PostgreSQL virtuelle dans une règle de mappage. Pour plus d’informations, consultez [Cartographie des types de données dans AWS Schema Conversion Tool](CHAP_Mapping.md) et [Mappage vers des cibles virtuelles dans AWS Schema Conversion Tool](CHAP_Mapping.VirtualTargets.md). 

1. Dans le menu **Affichage**, choisissez **Vue principale**.

1. Dans le menu **Applications**, choisissez **Nouvelle application C\$1\$1**. 

   La boîte de dialogue **Création d'un projet de conversion d'applications C\$1\$1** apparaît.   
![\[La nouvelle boîte de dialogue du projet de conversion d'applications C++\]](http://docs.aws.amazon.com/fr_fr/SchemaConversionTool/latest/userguide/images/cplusplus-application-new-project.png)

1. Dans **Nom**, entrez le nom de votre projet de conversion d'application C\$1\$1. Chaque projet de conversion de schéma de base de données pouvant comporter un ou plusieurs projets de conversion d'applications secondaires, choisissez un nom pertinent si vous ajoutez plusieurs projets. 

1. Dans **Emplacement**, entrez l'emplacement du code source de votre application. 

1. Dans l'arborescence des sources, choisissez le schéma utilisé par votre application. Assurez-vous que ce schéma fait partie d'une règle de mappage. AWS SCT met en évidence les schémas qui font partie d'une règle de mappage en gras. 

1. Cliquez **sur OK** pour créer votre projet de conversion d'application C\$1\$1.

1. Trouvez votre projet de conversion d'applications C\$1\$1 dans le nœud **Applications** du panneau de gauche.

## Conversion du code SQL de votre application C\$1\$1 en AWS SCT
<a name="CHAP_Converting.App.Cplusplus.Convert"></a>

Après avoir ajouté votre application C\$1\$1 au AWS SCT projet, convertissez le code SQL de cette application dans un format compatible avec votre plate-forme de base de données cible. Utilisez la procédure suivante pour analyser et convertir le code SQL intégré à votre application C\$1\$1 dans AWS SCT. 

**Pour convertir votre code SQL**

1. Développez le nœud **C\$1\$1** sous **Applications** dans le panneau de gauche et choisissez l'application à convertir.

1. Dans le **projet d'application Source Oracle**, choisissez **Settings**. Vérifiez et modifiez les paramètres de conversion pour l'application C\$1\$1 sélectionnée. Vous pouvez également définir les paramètres de conversion pour toutes les applications C\$1\$1 que vous avez ajoutées à votre AWS SCT projet. Pour de plus amples informations, veuillez consulter [Gestion des projets de conversion d'applications C\$1\$1](#CHAP_Converting.App.Cplusplus.Manage).

1. Pour le **type de compilateur**, choisissez le compilateur que vous utilisez pour le code source de votre application C\$1\$1. AWS SCT **prend en charge les compilateurs C\$1\$1 suivants : **Microsoft Visual C\$1\$1**, **GCC, la collection de compilateurs GNU** et Clang.** L'option par défaut est **Microsoft Visual C\$1\$1**.

1. Pour les **macros définies par** l'utilisateur, entrez le chemin du fichier qui inclut les macros définies par l'utilisateur issues de votre projet C\$1\$1. Assurez-vous que ce fichier a la structure suivante : `#define name value` Dans l'exemple précédent, `value` il s'agit d'un paramètre facultatif. La valeur par défaut de ce paramètre facultatif est`1`.

   Pour créer ce fichier, ouvrez votre projet dans Microsoft Visual Studio, puis choisissez **Projet**, **Propriétés**, **C/C\$1\$1** et **Preprocessor**. Pour les **définitions du préprocesseur**, choisissez **Modifier** et copiez les noms et les valeurs dans un nouveau fichier texte. Ensuite, pour chaque chaîne du fichier, ajoutez le préfixe suivant : `#define `

1. Pour les **répertoires d'inclusion externes**, entrez les chemins d'accès aux dossiers contenant les bibliothèques externes que vous utilisez dans votre projet C\$1\$1.

1. Dans le volet de gauche, choisissez l'application à convertir et ouvrez le menu contextuel (clic droit).

1.  Choisissez **Convertir**. AWS SCT analyse vos fichiers de code source, détermine la logique de l'application et charge les métadonnées du code dans le projet. Ces métadonnées de code incluent les classes C\$1\$1, les objets, les méthodes, les variables globales, les interfaces, etc. 

   Dans le panneau de base de données cible, AWS SCT crée une structure de dossiers similaire à celle de votre projet d'application source. Ici, vous pouvez consulter le code d'application converti, comme indiqué ci-dessous.  
![\[Code SQL à analyser\]](http://docs.aws.amazon.com/fr_fr/SchemaConversionTool/latest/userguide/images/cplusplus-applications-project-analyze.png)

1. Enregistrez le code d'application converti. Pour de plus amples informations, veuillez consulter [Sauvegarde du code d'application converti](#CHAP_Converting.App.Cplusplus.Save).

## Enregistrez le code de votre application converti avec AWS SCT
<a name="CHAP_Converting.App.Cplusplus.Save"></a>

Pour enregistrer le code d'application converti, procédez comme suit. 

**Pour enregistrer le code d'application converti**

1. Développez le nœud **C\$1\$1** sous **Applications** dans le panneau de base de données cible.

1. Choisissez votre application convertie, puis cliquez **sur Enregistrer**.

1. Entrez le chemin d'accès au dossier pour enregistrer le code d'application converti, puis choisissez **Sélectionner un dossier**.

## Gestion des projets de conversion d'applications C\$1\$1 dans AWS SCT
<a name="CHAP_Converting.App.Cplusplus.Manage"></a>

Vous pouvez ajouter plusieurs projets de conversion d'applications C\$1\$1, modifier les paramètres de conversion, mettre à jour le code d'application C\$1\$1 ou supprimer un projet de conversion C\$1\$1 de votre AWS SCT projet.

**Pour ajouter un projet de conversion d'applications C\$1\$1 supplémentaire**

1. Développez le nœud **Applications** dans le panneau de gauche.

1. Choisissez le nœud **C\$1\$1** et ouvrez le menu contextuel (clic droit).

1. Choisissez **New application** (Nouvelle application).

1. Entrez les informations requises pour créer un nouveau projet de conversion d'application C\$1\$1. Pour de plus amples informations, veuillez consulter [Création de projets de conversion d'applications C\$1\$1](#CHAP_Converting.App.Cplusplus.Create).

Vous pouvez définir les paramètres de conversion pour tous les projets de conversion d'applications C\$1\$1 de votre AWS SCT projet.

**Pour modifier les paramètres de conversion pour toutes les applications C\$1\$1**

1. Dans le menu **Paramètres**, choisissez **Paramètres du projet**, puis sélectionnez **Conversion d'applications**.

1. Pour le **type de compilateur**, choisissez le compilateur que vous utilisez pour le code source de votre application C\$1\$1. AWS SCT **prend en charge les compilateurs C\$1\$1 suivants : **Microsoft Visual C\$1\$1**, **GCC, la collection de compilateurs GNU** et Clang.** L'option par défaut est **Microsoft Visual C\$1\$1**.

1. Pour les **macros définies par** l'utilisateur, entrez le chemin du fichier qui inclut les macros définies par l'utilisateur issues de votre projet C\$1\$1. Assurez-vous que ce fichier a la structure suivante : `#define name value` Dans l'exemple précédent, `value` il s'agit d'un paramètre facultatif. La valeur par défaut de ce paramètre facultatif est`1`.

   Pour créer ce fichier, ouvrez votre projet dans Microsoft Visual Studio, puis choisissez **Projet**, **Propriétés**, **C/C\$1\$1** et **Preprocessor**. Pour les **définitions du préprocesseur**, choisissez **Modifier** et copiez les noms et les valeurs dans un nouveau fichier texte. Ensuite, pour chaque chaîne du fichier, ajoutez le préfixe suivant : `#define `

1. Pour les **répertoires d'inclusion externes**, entrez les chemins d'accès aux dossiers contenant les bibliothèques externes que vous utilisez dans votre projet C\$1\$1.

1. Cliquez **sur OK** pour enregistrer les paramètres du projet et fermer la fenêtre.

Vous pouvez également définir des paramètres de conversion pour chaque projet de conversion d'applications C\$1\$1. Pour de plus amples informations, veuillez consulter [Conversion du code SQL de votre application C\$1\$1](#CHAP_Converting.App.Cplusplus.Convert).

Après avoir modifié le code source de votre application, chargez-le dans le AWS SCT projet.

**Pour télécharger le code d'application mis à jour**

1. Développez le nœud **C\$1\$1** sous **Applications** dans le panneau de gauche.

1. Choisissez l'application à mettre à jour, puis ouvrez le menu contextuel (clic droit).

1. Choisissez **Actualiser**, puis **Oui**.

   AWS SCT télécharge le code de votre application depuis les fichiers source et supprime les résultats de conversion. Pour conserver les modifications de code que vous avez apportées AWS SCT et les résultats de la conversion, créez un nouveau projet de conversion C\$1\$1.

    AWS SCT Supprime également les paramètres de conversion d'application que vous avez spécifiés pour l'application sélectionnée. Après avoir chargé le code d'application mis à jour, AWS SCT applique les valeurs par défaut issues des paramètres du projet.

**Pour supprimer un projet de conversion d'applications C\$1\$1**

1. Développez le nœud **C\$1\$1** sous **Applications** dans le panneau de gauche.

1. Choisissez l'application à supprimer, puis ouvrez le menu contextuel (clic droit).

1. Choisissez **Supprimer**, puis **OK**.

## Création d'un rapport d'évaluation de la conversion des applications C\$1\$1 dans AWS SCT
<a name="CHAP_Converting.App.Cplusplus.AssessmentReport"></a>

Le *rapport d'évaluation de la conversion des applications C\$1\$1* fournit des informations sur la conversion du code SQL intégré à votre application C\$1\$1 en un format compatible avec votre base de données cible. Le rapport d'évaluation fournit les détails de conversion pour tous les points d'exécution SQL et tous les fichiers de code source. Le rapport d'évaluation inclut également des actions pour le code SQL qui ne AWS SCT peut pas être converti. 

**Pour créer un rapport d'évaluation de la conversion des applications C\$1\$1**

1. Développez le nœud **C\$1\$1** sous **Applications** dans le panneau de gauche.

1. Choisissez l'application à convertir et ouvrez le menu contextuel (clic droit).

1. Choisissez **Convertir**.

1. Dans le menu **Affichage**, choisissez **Affichage du rapport d'évaluation**.

1. Consultez l'onglet **Résumé**.

   L'onglet **Résumé** affiche les informations de synthèse du rapport d'évaluation de l'application C\$1\$1. Il affiche les résultats de conversion pour tous les points d'exécution SQL et tous les fichiers de code source. 

1. Choisissez **Enregistrer les instructions au format JSON** pour enregistrer le code SQL extrait de votre application Java sous forme de fichier JSON.

1. (Facultatif) Enregistrez une copie locale du rapport sous forme de fichier PDF ou de fichier de valeurs séparées par des virgules (CSV) :
   + Choisissez **Enregistrer au format PDF** en haut à droite pour enregistrer le rapport sous forme de fichier PDF.

      Le fichier PDF contient le résumé, les mesures à prendre et les recommandations relatives à la conversion des applications.
   + Choisissez **Enregistrer au format CSV en** haut à droite pour enregistrer le rapport sous forme de fichier CSV.

     Le fichier CSV contient des actions, des actions recommandées et une estimation de la complexité de l'effort manuel requis pour convertir le code SQL.

# Conversion de code SQL dans des applications Java avec AWS Schema Conversion Tool
<a name="CHAP_Converting.App.Java"></a>

Pour une conversion d'Oracle vers PostgreSQL, vous pouvez l' AWS Schema Conversion Tool utiliser pour convertir le code SQL intégré à vos applications Java. Ce convertisseur d'application Java spécifique comprend la logique de l'application. Il collecte des instructions situées dans différents objets d'application, tels que des fonctions, des paramètres, des variables locales, etc. 

Grâce à cette analyse approfondie, le convertisseur de code SQL de l'application Java fournit de meilleurs résultats de conversion par rapport au convertisseur générique.

Si votre application Java utilise le MyBatis framework pour interagir avec les bases de données, vous pouvez l'utiliser AWS SCT pour convertir des instructions SQL incorporées dans des fichiers MyBatis XML et des annotations. Pour comprendre la logique de ces instructions SQL, utilisez AWS SCT le fichier MyBatis de configuration. AWS SCT peut détecter automatiquement ce fichier dans le dossier de votre application, ou vous pouvez saisir le chemin d'accès à ce fichier manuellement.

## Création de projets de conversion d'applications Java dans AWS SCT
<a name="CHAP_Converting.App.Java.Create"></a>

Vous pouvez créer un projet de conversion d'application Java uniquement pour convertir des schémas de base de données Oracle en schémas de base de données PostgreSQL. Assurez-vous d'ajouter une règle de mappage dans votre projet qui inclut un schéma Oracle source et une base de données PostgreSQL cible. Pour de plus amples informations, veuillez consulter [Cartographie des types de données dans AWS Schema Conversion Tool](CHAP_Mapping.md).

Vous pouvez ajouter plusieurs projets de conversion d'applications dans un seul AWS SCT projet. Utilisez la procédure suivante pour créer un projet de conversion d'application Java. 

**Pour créer un projet de conversion d'applications Java**

1. Créez un projet de conversion de base de données et ajoutez une base de données Oracle source. Pour plus d’informations, consultez [Démarrage et gestion de projets dans AWS SCT](CHAP_UserInterface.Project.md) et [Ajouter des serveurs à un projet dans AWS SCT](CHAP_UserInterface.AddServers.md). 

1. Ajoutez une règle de mappage qui inclut votre base de données Oracle source et une base de données PostgreSQL cible. Vous pouvez ajouter une base de données PostgreSQL cible ou utiliser une plate-forme de base de données cible PostgreSQL virtuelle dans une règle de mappage. Pour plus d’informations, consultez [Cartographie des types de données dans AWS Schema Conversion Tool](CHAP_Mapping.md) et [Mappage vers des cibles virtuelles dans AWS Schema Conversion Tool](CHAP_Mapping.VirtualTargets.md). 

1. Dans le menu **Affichage**, choisissez **Vue principale**.

1. Dans le menu **Applications**, choisissez **Nouvelle application Java**. 

   La boîte de dialogue **Création d'un projet de conversion d'applications Java** apparaît.   
![\[La nouvelle boîte de dialogue du projet de conversion d'applications Java\]](http://docs.aws.amazon.com/fr_fr/SchemaConversionTool/latest/userguide/images/java-application-new-project.png)

1. Dans **Nom**, entrez le nom de votre projet de conversion d'application Java. Chaque projet de conversion de schéma de base de données pouvant comporter un ou plusieurs projets de conversion d'applications secondaires, choisissez un nom pertinent si vous ajoutez plusieurs projets. 

1. Dans **Emplacement**, entrez l'emplacement du code source de votre application. 

1. (Facultatif) Pour **le fichier de MyBatis configuration**, entrez le chemin d'accès au fichier MyBatis de configuration. AWS SCT analyse le dossier de votre application pour découvrir automatiquement ce fichier. Si ce fichier ne se trouve pas dans le dossier de votre application ou si vous utilisez plusieurs fichiers de configuration, entrez le chemin manuellement.

1. Dans l'arborescence des sources, choisissez le schéma utilisé par votre application. Assurez-vous que ce schéma fait partie d'une règle de mappage. AWS SCT met en évidence les schémas qui font partie d'une règle de mappage en gras. 

1. Cliquez **sur OK** pour créer votre projet de conversion d'application Java.

1. Trouvez votre projet de conversion d'applications Java dans le nœud **Applications** du panneau de gauche.

## Conversion du code SQL de votre application Java en AWS SCT
<a name="CHAP_Converting.App.Java.Convert"></a>

Après avoir ajouté votre application Java au AWS SCT projet, convertissez le code SQL de cette application dans un format compatible avec votre plate-forme de base de données cible. Utilisez la procédure suivante pour analyser et convertir le code SQL intégré à votre application Java dans le AWS Schema Conversion Tool. 

**Pour convertir votre code SQL**

1. Développez le nœud **Java** sous **Applications** dans le panneau de gauche.

1. Choisissez l'application à convertir et ouvrez le menu contextuel (clic droit).

1.  Choisissez **Convertir**. AWS SCT analyse vos fichiers de code source, détermine la logique de l'application et charge les métadonnées du code dans le projet. Ces métadonnées de code incluent les classes Java, les objets, les méthodes, les variables globales, les interfaces, etc. 

   Dans le panneau de base de données cible, AWS SCT crée une structure de dossiers similaire à celle de votre projet d'application source. Vous pouvez consulter ici le code d'application converti.  
![\[Code SQL à analyser\]](http://docs.aws.amazon.com/fr_fr/SchemaConversionTool/latest/userguide/images/java-applications-project-analyze.png)

1. Enregistrez le code d'application converti. Pour de plus amples informations, veuillez consulter [Sauvegarde du code d'application converti](#CHAP_Converting.App.Java.Save).

Vos applications Java peuvent inclure du code SQL qui interagit avec différentes bases de données sources. Vous pouvez migrer vers PostgreSQL plusieurs de ces bases de données sources. Dans ce cas, assurez-vous de ne pas convertir le code SQL qui interagit avec les bases de données que vous avez exclues du périmètre de migration. Vous pouvez exclure les fichiers source de votre application Java de la zone de conversion. Pour ce faire, décochez les cases correspondant aux noms des fichiers que vous souhaitez exclure de la zone de conversion.

Après avoir modifié l'étendue de conversion, AWS SCT l'analyse du code SQL de tous les fichiers source de vos applications Java se poursuit. AWS SCT Copie ensuite dans le dossier cible tous les fichiers source que vous avez exclus de la zone de conversion. Cette opération permet de créer votre application après avoir enregistré les fichiers d'application convertis.

## Enregistrez le code de votre application converti avec AWS SCT
<a name="CHAP_Converting.App.Java.Save"></a>

Pour enregistrer le code d'application converti, procédez comme suit.

**Pour enregistrer le code d'application converti**

1. Développez le nœud **Java** sous **Applications** dans le panneau de base de données cible.

1. Choisissez votre application convertie, puis cliquez **sur Enregistrer**.

1. Entrez le chemin d'accès au dossier pour enregistrer le code d'application converti, puis choisissez **Sélectionner un dossier**.

Si votre application Java source utilise le MyBatis framework, assurez-vous de mettre à jour votre fichier de configuration pour qu'il fonctionne avec votre nouvelle base de données.

## Gestion des projets de conversion d'applications Java dans AWS SCT
<a name="CHAP_Converting.App.Java.Manage"></a>

Vous pouvez ajouter plusieurs projets de conversion d'applications Java, mettre à jour le code de l'application dans le AWS SCT projet ou supprimer un projet de conversion Java de votre AWS SCT projet.

**Pour ajouter un projet de conversion d'application Java supplémentaire**

1. Développez le nœud **Applications** dans le panneau de gauche.

1. Choisissez le nœud **Java** et ouvrez le menu contextuel (clic droit).

1. Choisissez **New application** (Nouvelle application).

1. Entrez les informations requises pour créer un nouveau projet de conversion d'applications Java. Pour de plus amples informations, veuillez consulter [Création de projets de conversion d'applications Java](#CHAP_Converting.App.Java.Create).

Après avoir modifié le code source de votre application, chargez-le dans le AWS SCT projet.

**Pour télécharger le code d'application mis à jour**

1. Développez le nœud **Java** sous **Applications** dans le panneau de gauche.

1. Choisissez l'application à mettre à jour, puis ouvrez le menu contextuel (clic droit).

1. Choisissez **Actualiser**, puis **Oui**.

   AWS SCT télécharge le code de votre application depuis les fichiers source et supprime les résultats de conversion. Pour conserver les modifications de code que vous avez apportées AWS SCT et les résultats de la conversion, créez un nouveau projet de conversion Java.

Si votre application Java source utilise le MyBatis framework, AWS SCT utilise le fichier MyBatis de configuration pour analyser votre code SQL. Après avoir modifié ce fichier, chargez-le dans le AWS SCT projet.

**Pour modifier le chemin d'accès au fichier MyBatis de configuration**

1. Développez le nœud **Java** sous **Applications** dans le panneau de gauche.

1. Choisissez votre application, puis sélectionnez **Paramètres**.

1. Choisissez **Parcourir**, puis choisissez le fichier MyBatis de configuration.

1. Cliquez sur **Appliquer**.

1. Dans le panneau de gauche, choisissez votre application, ouvrez le menu contextuel (clic droit) et choisissez **Actualiser**.

**Pour supprimer un projet de conversion d'applications Java**

1. Développez le nœud **Java** sous **Applications** dans le panneau de gauche.

1. Choisissez l'application à supprimer, puis ouvrez le menu contextuel (clic droit).

1. Choisissez **Supprimer**, puis **OK**.

## Création d'un rapport d'évaluation de la conversion d'une application Java dans AWS SCT
<a name="CHAP_Converting.App.Java.AssessmentReport"></a>

Le *rapport d'évaluation de la conversion des applications Java* fournit des informations sur la conversion du code SQL intégré à votre application Java en un format compatible avec votre base de données cible. Le rapport d'évaluation fournit les détails de conversion pour tous les points d'exécution SQL et tous les fichiers de code source. Le rapport d'évaluation inclut également des actions pour le code SQL qui ne AWS SCT peut pas être converti. 

Utilisez la procédure suivante pour créer un rapport d'évaluation de la conversion des applications Java.

**Pour créer un rapport d'évaluation de la conversion des applications Java**

1. Développez le nœud **Java** sous **Applications** dans le panneau de gauche.

1. Choisissez l'application à convertir et ouvrez le menu contextuel (clic droit).

1. Choisissez **Convertir**.

1. Dans le menu **Affichage**, choisissez **Affichage du rapport d'évaluation**.

1. Vérifiez l'onglet **Summary**.

   L'onglet **Résumé**, illustré ci-dessous, affiche les informations de synthèse du rapport d'évaluation de l'application Java. Il affiche les résultats de conversion pour tous les points d'exécution SQL et tous les fichiers de code source.   
![\[Onglet récapitulatif du rapport d'évaluation des applications Java\]](http://docs.aws.amazon.com/fr_fr/SchemaConversionTool/latest/userguide/images/java-applications-summary.png)

1. Choisissez **Enregistrer les instructions au format JSON** pour enregistrer le code SQL extrait de votre application Java sous forme de fichier JSON.

1. (Facultatif) Enregistrez une copie locale du rapport sous forme de fichier PDF ou de fichier de valeurs séparées par des virgules (CSV) :
   + Choisissez **Enregistrer au format PDF** en haut à droite pour enregistrer le rapport sous forme de fichier PDF.

      Le fichier PDF contient le résumé, les mesures à prendre et les recommandations relatives à la conversion des applications.
   + Choisissez **Enregistrer au format CSV en** haut à droite pour enregistrer le rapport sous forme de fichier CSV.

     Le fichier CSV contient des actions, des actions recommandées et une estimation de la complexité de l'effort manuel requis pour convertir le code SQL.

# Conversion de code SQL dans les applications Pro\$1C avec AWS Schema Conversion Tool
<a name="CHAP_Converting.App.ProC"></a>

Pour une conversion d'Oracle vers PostgreSQL, vous pouvez utiliser AWS Schema Conversion Tool le AWS SCT() pour convertir le code SQL intégré à vos applications Pro\$1C. Ce convertisseur d'application Pro\$1C spécifique comprend la logique de l'application. Il collecte des instructions situées dans différents objets d'application, tels que des fonctions, des paramètres, des variables locales, etc. 

Grâce à cette analyse approfondie, le convertisseur de code SQL de l'application Pro\$1C fournit de meilleurs résultats de conversion par rapport au convertisseur générique. 

## Création de projets de conversion d'applications Pro\$1C dans AWS SCT
<a name="CHAP_Converting.App.ProC.Create"></a>

Vous pouvez créer un projet de conversion d'application Pro\$1C uniquement pour convertir des schémas de base de données Oracle en schémas de base de données PostgreSQL. Assurez-vous d'ajouter une règle de mappage dans votre projet qui inclut un schéma Oracle source et une base de données PostgreSQL cible. Pour de plus amples informations, veuillez consulter [Cartographie des types de données dans AWS Schema Conversion Tool](CHAP_Mapping.md).

Vous pouvez ajouter plusieurs projets de conversion d'applications dans un seul AWS SCT projet. Utilisez la procédure suivante pour créer un projet de conversion d'application Pro\$1C. 

**Pour créer un projet de conversion d'applications Pro\$1C**

1. Créez un projet de conversion de base de données et ajoutez une base de données Oracle source. Pour plus d’informations, consultez [Démarrage et gestion de projets dans AWS SCT](CHAP_UserInterface.Project.md) et [Ajouter des serveurs à un projet dans AWS SCT](CHAP_UserInterface.AddServers.md). 

1. Ajoutez une règle de mappage qui inclut votre base de données Oracle source et une base de données PostgreSQL cible. Vous pouvez ajouter une base de données PostgreSQL cible ou utiliser une plate-forme de base de données cible PostgreSQL virtuelle dans une règle de mappage. Pour plus d’informations, consultez [Cartographie des types de données dans AWS Schema Conversion Tool](CHAP_Mapping.md) et [Mappage vers des cibles virtuelles dans AWS Schema Conversion Tool](CHAP_Mapping.VirtualTargets.md). 

1. Dans le menu **Affichage**, choisissez **Vue principale**.

1. Dans le menu **Applications**, choisissez **Nouvelle application Pro\$1C**. 

   La boîte de dialogue **Création d'un projet de conversion d'applications Pro\$1C** apparaît.   
![\[La nouvelle boîte de dialogue du projet de conversion d'applications Pro*C\]](http://docs.aws.amazon.com/fr_fr/SchemaConversionTool/latest/userguide/images/proc-application-new-project.png)

1. Dans **Nom**, entrez le nom de votre projet de conversion d'applications Pro\$1C. Chaque projet de conversion de schéma de base de données pouvant comporter un ou plusieurs projets de conversion d'applications secondaires, choisissez un nom pertinent si vous ajoutez plusieurs projets. 

1. Dans **Emplacement**, entrez l'emplacement du code source de votre application. 

1. Dans l'arborescence des sources, choisissez le schéma utilisé par votre application. Assurez-vous que ce schéma fait partie d'une règle de mappage. AWS SCT met en évidence les schémas qui font partie d'une règle de mappage en gras. 

1. Cliquez **sur OK** pour créer votre projet de conversion d'application Pro\$1C.

1. Trouvez votre projet de conversion d'applications Pro\$1C dans le nœud **Applications** du panneau de gauche.

## Conversion du code SQL de votre application Pro\$1C en AWS SCT
<a name="CHAP_Converting.App.ProC.Convert"></a>

Après avoir ajouté votre application Pro\$1C au AWS SCT projet, convertissez le code SQL de cette application dans un format compatible avec votre plate-forme de base de données cible. Utilisez la procédure suivante pour analyser et convertir le code SQL intégré à votre application Pro\$1C dans le. AWS Schema Conversion Tool

**Pour convertir votre code SQL**

1. Développez le nœud **Pro\$1C** sous **Applications** dans le panneau de gauche.

1. Choisissez l'application à convertir, puis sélectionnez **Paramètres**.

   1. Pour **le chemin du fichier d'en-tête global**, entrez le chemin des fichiers d'en-tête utilisés par votre projet d'application.

   1. Choisissez **Interpréter toutes les variables hôtes non résolues comme** pour voir toutes les variables non résolues dans le code converti.

   1. Choisissez **Utiliser la fonction de conversion de chaînes à largeur fixe dans le pack d'extensions** pour utiliser les fonctions du pack d'extensions dans le code SQL converti. AWS SCT inclut les fichiers du pack d'extension dans votre projet d'application.

   1. Choisissez **Transformer les PL/SQL blocs anonymes en appels SQL autonomes ou en fonctions stockées** pour créer des procédures stockées dans votre base de données cible pour tous les PL/SQL blocs anonymes. AWS SCT inclut ensuite les exécutions de ces procédures stockées dans le code d'application converti.

   1. Choisissez **Utiliser un flux de curseur personnalisé** pour améliorer la conversion des curseurs de base de données Oracle.

1. Dans le panneau de gauche, choisissez l'application à convertir et ouvrez le menu contextuel (clic droit).

1.  Choisissez **Convertir**. AWS SCT analyse vos fichiers de code source, détermine la logique de l'application et charge les métadonnées du code dans le projet. Ces métadonnées de code incluent les classes Pro\$1C, les objets, les méthodes, les variables globales, les interfaces, etc. 

   Dans le panneau de base de données cible, AWS SCT crée une structure de dossiers similaire à celle de votre projet d'application source. Vous pouvez consulter ici le code d'application converti.  
![\[Code SQL à analyser\]](http://docs.aws.amazon.com/fr_fr/SchemaConversionTool/latest/userguide/images/proc-applications-project-analyze.png)

1. Enregistrez le code d'application converti. Pour de plus amples informations, veuillez consulter [Modification et enregistrement du code d'application converti](#CHAP_Converting.App.ProC.Save).

## Modifier et enregistrer le code de votre application converti avec AWS SCT
<a name="CHAP_Converting.App.ProC.Save"></a>

Vous pouvez modifier les instructions SQL converties et les utiliser AWS SCT pour intégrer ce code modifié dans le code d'application Pro\$1C converti. Pour modifier le code SQL converti, procédez comme suit.

**Pour modifier votre code SQL converti**

1. Développez le nœud **Pro\$1C** sous **Applications** dans le panneau de gauche.

1. Choisissez l'application à convertir, ouvrez le menu contextuel (clic droit), puis choisissez **Convertir**.

1. Dans le menu **Affichage**, choisissez **Affichage du rapport d'évaluation**.

1. Choisissez **Enregistrer les instructions au format CSV** pour enregistrer le code SQL extrait de votre application Pro\$1C sous forme de fichier CSV.

1. Entrez le nom du fichier CSV pour enregistrer le code SQL extrait, puis choisissez **Enregistrer**.

1. Modifiez le code SQL extrait.

1. Dans le menu **Affichage**, choisissez **Vue principale**.

1. Développez le nœud **Pro\$1C** sous **Applications** dans le panneau de base de données cible.

1. Choisissez votre application convertie, ouvrez le menu contextuel (clic droit) et choisissez **Importer des relevés depuis un fichier CSV**.

1. Choisissez **Oui**, puis choisissez le fichier contenant votre code SQL modifié, puis choisissez **Ouvrir**.

AWS SCT divise les instructions SQL converties en plusieurs parties et les place dans les objets appropriés du code source de votre application. Pour enregistrer le code d'application converti, procédez comme suit.

**Pour enregistrer le code d'application converti**

1. Développez le nœud **Pro\$1C** sous **Applications** dans le panneau de base de données cible.

1. Choisissez votre application convertie, puis cliquez **sur Enregistrer**.

1. Entrez le chemin d'accès au dossier pour enregistrer le code d'application converti, puis choisissez **Sélectionner un dossier**.

## Gestion des projets de conversion d'applications Pro\$1C dans AWS SCT
<a name="CHAP_Converting.App.ProC.Manage"></a>

Vous pouvez ajouter plusieurs projets de conversion d'applications Pro\$1C, mettre à jour le code d'application dans le AWS SCT projet ou supprimer un projet de conversion Pro\$1C de votre projet. AWS SCT 

**Pour ajouter un projet de conversion d'applications Pro\$1C supplémentaire**

1. Développez le nœud **Applications** dans le panneau de gauche.

1. Choisissez le nœud **Pro\$1C** et ouvrez le menu contextuel (clic droit).

1. Choisissez **New application** (Nouvelle application).

1. Entrez les informations requises pour créer un nouveau projet de conversion d'applications Pro\$1C. Pour de plus amples informations, veuillez consulter [Création de projets de conversion d'applications Pro\$1C](#CHAP_Converting.App.ProC.Create).

Après avoir modifié le code source de votre application, chargez-le dans le AWS SCT projet.

**Pour télécharger le code d'application mis à jour**

1. Développez le nœud **Pro\$1C** sous **Applications** dans le panneau de gauche.

1. Choisissez l'application à mettre à jour, puis ouvrez le menu contextuel (clic droit).

1. Choisissez **Actualiser**, puis **Oui**.

   AWS SCT télécharge le code de votre application depuis les fichiers source et supprime les résultats de conversion. Pour conserver les modifications de code que vous avez apportées AWS SCT et les résultats de la conversion, créez un nouveau projet de conversion Pro\$1C.

**Pour supprimer un projet de conversion d'applications Pro\$1C**

1. Développez le nœud **Pro\$1C** sous **Applications** dans le panneau de gauche.

1. Choisissez l'application à supprimer, puis ouvrez le menu contextuel (clic droit).

1. Choisissez **Supprimer**, puis **OK**.

## Création d'un rapport d'évaluation de la conversion des applications Pro\$1C dans AWS SCT
<a name="CHAP_Converting.App.ProC.AssessmentReport"></a>

Le *rapport d'évaluation de la conversion des applications Pro\$1C* fournit des informations sur la conversion du code SQL intégré à votre application Pro\$1C en un format compatible avec votre base de données cible. Le rapport d'évaluation fournit les détails de conversion pour tous les points d'exécution SQL et tous les fichiers de code source. Le rapport d'évaluation inclut également des actions pour le code SQL qui ne AWS SCT peut pas être converti. 

Utilisez la procédure suivante pour créer un rapport d'évaluation de la conversion des applications Pro\$1C.

**Pour créer un rapport d'évaluation de la conversion des applications Pro\$1C**

1. Développez le nœud **Pro\$1C** sous **Applications** dans le panneau de gauche.

1. Choisissez l'application à convertir et ouvrez le menu contextuel (clic droit).

1. Choisissez **Convertir**.

1. Dans le menu **Affichage**, choisissez **Affichage du rapport d'évaluation**.

1. Vérifiez l'onglet **Summary**.

   L'onglet **Résumé**, illustré ci-dessous, affiche les informations de synthèse du rapport d'évaluation de l'application Pro\$1C. Il affiche les résultats de conversion pour tous les points d'exécution SQL et tous les fichiers de code source.   
![\[Onglet récapitulatif du rapport d'évaluation des applications Pro*C\]](http://docs.aws.amazon.com/fr_fr/SchemaConversionTool/latest/userguide/images/proc-applications-summary.png)

1. Choisissez **Enregistrer les instructions au format CSV** pour enregistrer le code SQL extrait de votre application Pro\$1C sous forme de fichier CSV (valeurs séparées par des virgules).

1. (Facultatif) Enregistrez une copie locale du rapport sous forme de fichier PDF ou de fichier de valeurs séparées par des virgules (CSV) :
   + Choisissez **Enregistrer au format PDF** en haut à droite pour enregistrer le rapport sous forme de fichier PDF.

      Le fichier PDF contient le résumé, les mesures à prendre et les recommandations relatives à la conversion des applications.
   + Choisissez **Enregistrer au format CSV en** haut à droite pour enregistrer le rapport sous forme de fichier CSV.

     Le fichier CSV contient des actions, des actions recommandées et une estimation de la complexité de l'effort manuel requis pour convertir le code SQL.