

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Convertir el SQL de la aplicación mediante AWS SCT
<a name="CHAP_Converting.App"></a>

Al convertir su esquema de base de datos de un motor a otro, también deberá actualizar el código SQL de las aplicaciones para interactuar con el nuevo motor de base de datos en lugar del antiguo. Puede ver, analizar, editar y guardar el código SQL convertido.

Puede usar el AWS Schema Conversion Tool (AWS SCT) para convertir el código SQL de su código de aplicación en C\$1\$1, C\$1, Java u otro código de aplicación. Para una conversión de Oracle a PostgreSQL, puede AWS SCT utilizar para convertir el código de SQL\$1Plus a PSQL. Además, para una conversión de Oracle a PostgreSQL, puede utilizar AWS SCT para convertir el código SQL incrustado en aplicaciones de C\$1, C\$1\$1, Java y Pro\$1C.

**Topics**
+ [

## Información general de la conversión del SQL de las aplicaciones
](#CHAP_Converting.App.Overview)
+ [

# Convierte el código SQL de tus aplicaciones con AWS SCT
](CHAP_Converting.App.Generic.md)
+ [

# Convierte el código SQL en aplicaciones de C\$1 con AWS Schema Conversion Tool
](CHAP_Converting.App.Csharp.md)
+ [

# Convertir código SQL en aplicaciones de C\$1\$1 con AWS Schema Conversion Tool
](CHAP_Converting.App.Cplusplus.md)
+ [

# Convertir código SQL en aplicaciones Java con AWS Schema Conversion Tool
](CHAP_Converting.App.Java.md)
+ [

# Convertir código SQL en aplicaciones Pro\$1C con AWS Schema Conversion Tool
](CHAP_Converting.App.ProC.md)

## Información general de la conversión del SQL de las aplicaciones
<a name="CHAP_Converting.App.Overview"></a>

Para convertir el código SQL de su aplicación, siga estos pasos de alto nivel: 
+ **Cree un proyecto de conversión de la aplicaciones**: el proyecto de conversión de aplicaciones es secundario al proyecto de conversión del esquema de la base de datos. Cada proyecto de conversión de esquema de base de datos puede tener uno o varios proyectos de conversión de aplicaciones secundarios. Para obtener más información, consulte [Crear proyectos de conversión de aplicaciones genéricas en AWS SCT](CHAP_Converting.App.Generic.md#CHAP_Converting.App.Project). 
+ **Analice y convierta su código SQL** – AWS SCT analiza su aplicación, extrae el código SQL y crea una versión local del SQL convertido para que pueda analizarlo y editarlo. La herramienta no cambia el código en su aplicación hasta que esté listo. Para obtener más información, consulte [Analizar y convertir su código SQL en AWS SCT](CHAP_Converting.App.Generic.md#CHAP_Converting.App.Convert). 
+ **Cree un informe de evaluación de la aplicación**: el informe de evaluación de la aplicación proporciona información importante sobre la conversión del código SQL de la aplicación desde el esquema de la base de datos de origen al esquema de la base de datos de destino. Para obtener más información, consulte [Creación y uso del informe AWS SCT de evaluación en AWS SCT](CHAP_Converting.App.Generic.md#CHAP_Converting.App.AssessmentReport). 
+ **Edite, aplique los cambios y guarde el código SQL convertido**: el informe de evaluación incluye una lista de elementos de código SQL que no se pueden convertir automáticamente. Para estos elementos, puede editar el código SQL manualmente para realizar la conversión. Para obtener más información, consulte [Edita y guarda el código SQL convertido con AWS SCT](CHAP_Converting.App.Generic.md#CHAP_Converting.App.Edit). 

# Convierte el código SQL de tus aplicaciones con AWS SCT
<a name="CHAP_Converting.App.Generic"></a>

Puede utilizarlo AWS SCT para convertir el código SQL incrustado en sus aplicaciones. El conversor genérico de aplicaciones de AWS SCT trata el código de la aplicación como texto sin formato. Analiza el código de la aplicación y extrae el código SQL con expresiones regulares. Este conversor admite diferentes tipos de archivos de código fuente y funciona con el código de la aplicación escrito en cualquier lenguaje de programación.

El conversor genérico de aplicaciones tiene las siguientes limitaciones. No profundiza en la lógica de la aplicación que es específica del lenguaje de programación de la aplicación. Además, el conversor genérico no admite sentencias SQL de diferentes objetos de la aplicación, como funciones, parámetros, variables locales, etc.

Para mejorar la conversión del código SQL de la aplicación, utilice conversores de código SQL de aplicaciones específicos del lenguaje correspondiente. Para obtener más información, consulte [Código SQL de aplicaciones de C\$1](CHAP_Converting.App.Csharp.md), [Código SQL en Java](CHAP_Converting.App.Java.md) y [Código SQL en Pro\$1C](CHAP_Converting.App.ProC.md).

## Crear proyectos de conversión de aplicaciones genéricas en AWS SCT
<a name="CHAP_Converting.App.Project"></a>

En el AWS Schema Conversion Tool, el proyecto de conversión de la aplicación es un elemento secundario del proyecto de conversión del esquema de la base de datos. Cada proyecto de conversión de esquema de base de datos puede tener uno o varios proyectos de conversión de aplicaciones secundarios.

**nota**  
AWS SCT no admite la conversión entre las siguientes fuentes y destinos:  
Oracle a Oracle
PostgreSQL a PostgreSQL o Aurora PostgreSQL
MySQL a MySQL
SQL Server a SQL Server
Amazon Redshift a Amazon Redshift
SQL Server a Babelfish
Servicios de integración de SQL Server a AWS Glue
Apache Cassandra a Amazon DynamoDB

 Utilice el siguiente procedimiento para crear un proyecto de conversión genérica de aplicación. 

**Para crear un proyecto de conversión de aplicación**

1. En el AWS Schema Conversion Tool, seleccione **Nueva aplicación genérica** en el menú **Aplicaciones**. 

   Aparecerá el cuadro de diálogo **Proyecto de conversión de aplicación nuevo**.   
![\[Cuadro de diálogo Proyecto de conversión de aplicación nuevo\]](http://docs.aws.amazon.com/es_es/SchemaConversionTool/latest/userguide/images/applications-new-project.png)

1. Agregue la siguiente información del proyecto.   
****    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/SchemaConversionTool/latest/userguide/CHAP_Converting.App.Generic.html)

1. Seleccione **No convertir las variables de enlace en tipos de SQL** para evitar la conversión de los tipos de variables de enlace en tipos de SQL. Esta opción solo está disponible para una conversión de Oracle a PostgreSQL.

   Por ejemplo, el código fuente de la aplicación incluye la siguiente consulta de Oracle:

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

   Si selecciona **No convertir las variables de enlace en tipos de SQL**, AWS SCT convierte esta consulta como se muestra a continuación.

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

   Si desactiva la opción **No convertir las variables de enlace en tipos de SQL**, AWS SCT cambia el tipo de variable de enlace por el tipo de datos `NUMERIC`. El resultado de la conversión se muestra a continuación.

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

1. Seleccione **Conservar nombres de objetos** para evitar agregar el nombre del esquema al nombre del objeto convertido. Esta opción solo está disponible para una conversión de Oracle a PostgreSQL.

   Por ejemplo, imagino que el código fuente de la aplicación incluye la siguiente consulta de Oracle.

   ```
   SELECT * FROM ACCOUNT
   ```

   Al seleccionar **Conservar nombres de objetos**, AWS SCT convierte esta consulta como se muestra a continuación.

   ```
   SELECT * FROM account
   ```

   Si desactiva **Conservar nombres de objetos**, AWS SCT agrega el nombre del esquema al nombre de la tabla. El resultado de la conversión se muestra a continuación.

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

   Si el código fuente incluye los nombres de los objetos principales en los nombres de los objetos, AWS SCT utilizará este formato en el código convertido. En este caso, ignore la opción **Conservar nombres de objetos** porque AWS SCT agrega los nombres de los objetos principales al código convertido.

1. Seleccione **Aceptar** para crear su proyecto de conversión de aplicaciones. 

   Se abrirá la ventana de proyecto.  
![\[La ventana de proyecto\]](http://docs.aws.amazon.com/es_es/SchemaConversionTool/latest/userguide/images/applications-project-window.png)

## Administrar proyectos de conversión de aplicaciones en AWS SCT
<a name="CHAP_Converting.App.Manage"></a>

Puede abrir un proyecto de conversión de aplicaciones existente y agregar varios proyectos de conversión de aplicaciones.

Después de crear un proyecto de conversión de aplicaciones, la ventana de proyecto se abrirá automáticamente. Puede cerrar la ventana del proyecto de conversión de aplicaciones y volver a ella más adelante.

**Para crear un proyecto de conversión de aplicaciones**

1. En el panel izquierdo, elija el nodo del proyecto de conversión de aplicaciones y abra el menú contextual (clic secundario).

1. Elija **Administrar aplicación**.

**Para agregar un proyecto de conversión de aplicaciones adicional**

1. En el panel izquierdo, elija el nodo del proyecto de conversión de aplicaciones y abra el menú contextual (clic secundario).

1. Elija **Aplicación nueva**.

1. Introduzca la información necesaria para crear un proyecto de conversión de aplicaciones nuevo. Para obtener más información, consulte [Creación de proyectos de conversión genérica de aplicaciones](#CHAP_Converting.App.Project).

## Analizar y convertir su código SQL en AWS SCT
<a name="CHAP_Converting.App.Convert"></a>

Utilice el siguiente procedimiento para analizar y convertir su código SQL en AWS Schema Conversion Tool. 

**Para analizar y convertir su código SQL**

1. Abra un proyecto de conversión de aplicaciones existente y elija **Analizar**. 

   AWS SCT analiza el código de la aplicación y extrae el código SQL. AWS SCT muestra el código SQL extraído en la lista **de scripts SQL analizados**. 

1. En el **caso de los scripts SQL analizados**, elija un elemento para revisar el código SQL extraído. AWS SCT muestra el código del elemento seleccionado en el panel de **scripts SQL extraídos**.

1. Seleccione **Convertir** para convertir el código SQL en el panel de **scripts de SQL extraído**. AWS SCT convierte el código a un formato compatible con la base de datos de destino. 

   Puede editar el código SQL convertido. Para obtener más información, consulte [Edición y guardado del código SQL convertido](#CHAP_Converting.App.Edit).  
![\[Código SQL para analizar\]](http://docs.aws.amazon.com/es_es/SchemaConversionTool/latest/userguide/images/applications-project-analyze.png)

1. Al crear un informe de evaluación de conversión de aplicaciones, AWS SCT convierte todos los elementos de código SQL extraídos. Para obtener más información, consulte [Creación y uso del informe de evaluación](#CHAP_Converting.App.AssessmentReport). 

## Creación y uso del informe AWS SCT de evaluación en AWS SCT
<a name="CHAP_Converting.App.AssessmentReport"></a>

El *informe de evaluación de la conversión de aplicaciones* proporciona información sobre cómo convertir el código SQL de la aplicación a un formato compatible con la base de datos de destino. El informe detalla todo el código SQL extraído, todo el código SQL convertido y los elementos de acción del código SQL que no AWS SCT se puede convertir. 

### Creación de un informe de evaluación de la conversión de aplicaciones
<a name="CHAP_Converting.App.AssessmentReport.Create"></a>

Utilice el siguiente procedimiento para crear un informe de evaluación de la conversión de aplicaciones.

**Para crear un informe de evaluación de la conversión de aplicaciones**

1. En la ventana del proyecto de conversión de aplicaciones, seleccione **Crear informe** en el menú **Acciones**. 

   AWS SCT crea el informe de evaluación de la conversión de la aplicación y lo abre en la ventana del proyecto de conversión de la aplicación. 

1. Consulte la pestaña **Resumen**. 

   En la pestaña **Resumen** que se muestra a continuación aparece la información resumida del informe de evaluación de aplicaciones. Muestra los elementos del código SQL que convirtieron automáticamente y los elementos que no se convirtieron automáticamente.   
![\[Pestaña Resumen del informe de evaluación de aplicaciones.\]](http://docs.aws.amazon.com/es_es/SchemaConversionTool/latest/userguide/images/applications-summary.png)

1. Seleccione **Acciones de extracción de SQL**. 

   Revise la lista de elementos de código SQL que no se AWS SCT pueden extraer del código fuente. 

1. Seleccione **Acciones de conversión de SQL**. 

   Revisa la lista de elementos de código SQL que no AWS SCT se pueden convertir automáticamente. Utilice las acciones recomendadas para convertir manualmente el código SQL. Para obtener información acerca de cómo editar el código SQL convertido, consulte [Edita y guarda el código SQL convertido con AWS SCT](#CHAP_Converting.App.Edit). 

1. (Opcional) Guarde una copia local del informe como archivo PDF o como un archivo de valores separados por comas (CSV):
   + Seleccione **Guardar en PDF** en la parte superior derecha para guardar el informe como un archivo PDF.

      El archivo PDF contiene el resumen ejecutivo, los elementos de acción y las recomendaciones para la conversión de aplicaciones.
   + Seleccione **Guardar en CSV** en la parte superior derecha para guardar el informe como un archivo CSV.

     El archivo CSV contiene elementos de acción, acciones recomendadas y una estimación de la complejidad del esfuerzo manual necesario para convertir el código SQL.

## Edita y guarda el código SQL convertido con AWS SCT
<a name="CHAP_Converting.App.Edit"></a>

El informe de evaluación incluye una lista de elementos de código SQL que no AWS SCT se pueden convertir. Para cada elemento, AWS SCT crea un elemento de acción en la pestaña de **acciones de conversión de SQL**. Para estos elementos, puede editar el código SQL manualmente para realizar la conversión. 

Utilice el siguiente procedimiento para editar su código SQL convertido, aplique los cambios y, a continuación, guárdelos. 

**Para editar, aplicar cambios y guardar su código SQL convertido**

1. Edite su código SQL convertido directamente en el panel **Target SQL script**. Si no se muestra ningún código convertido, puede hacer clic en el panel y empezar a escribir. 

1. Una vez que haya terminado de editar su código SQL convertido, seleccione **Aplicar**. En este punto, los cambios se guardan en memoria, pero aún no se escriben en el archivo. 

1. Seleccione **Guardar** para guardar los cambios en su archivo. 

   Al seleccionar **Guardar**, sobrescribirá su archivo original. Realice una copia de su archivo original antes de guardar, a fin de que disponga de un registro de su código de aplicación original. 

# Convierte el código SQL en aplicaciones de C\$1 con AWS Schema Conversion Tool
<a name="CHAP_Converting.App.Csharp"></a>

Para una conversión de Oracle a PostgreSQL, puede AWS Schema Conversion Tool usar AWS SCT() para convertir el código SQL incrustado en sus aplicaciones de C\$1. Este conversor de aplicaciones de C\$1 específico comprende la lógica de la aplicación. Recopila las declaraciones que se encuentran en diferentes objetos de la aplicación, como funciones, parámetros, variables locales, etc. 

Gracias a este análisis profundo, el conversor de código SQL de aplicaciones de C\$1 proporciona mejores resultados de conversión que el conversor genérico. 

## Creación de proyectos de conversión de aplicaciones en C\$1 en AWS SCT
<a name="CHAP_Converting.App.Csharp.Create"></a>

Puede crear un proyecto de conversión de aplicaciones de C\$1 solo para convertir esquemas de bases de datos Oracle en esquemas de bases de datos PostgreSQL. Agregue una regla de asignación a su proyecto que incluya un esquema de Oracle de origen y una base de datos PostgreSQL de destino. Para obtener más información, consulte [Asignación de tipos de datos en AWS Schema Conversion Tool](CHAP_Mapping.md). 

Puede añadir varios proyectos de conversión de aplicaciones en un solo AWS SCT proyecto. Utilice el siguiente procedimiento para crear un proyecto de conversión de aplicaciones de C\$1. 

**Para crear un proyecto de conversión de aplicaciones de C\$1**

1. Cree un proyecto de conversión de bases de datos y agregue una base de datos Oracle de origen. Para obtener más información, consulte [Iniciar y gestionar proyectos en AWS SCT](CHAP_UserInterface.Project.md) y [Añadir servidores al proyecto en AWS SCT](CHAP_UserInterface.AddServers.md). 

1. Agregue una regla de asignación que incluya la base de datos Oracle de origen y una base de datos PostgreSQL de destino. Puede agregar una base de datos PostgreSQL de destino o utilizar una plataforma de base de datos PostgreSQL de destino virtual en una regla de asignación. Para obtener más información, consulte [Asignación de tipos de datos en AWS Schema Conversion Tool](CHAP_Mapping.md) y [Asignación a destinos virtuales en AWS Schema Conversion Tool](CHAP_Mapping.VirtualTargets.md). 

1. En el menú **Ver**, seleccione **Vista principal**.

1. En el menú **Aplicaciones**, elija **Aplicación de C\$1 nueva**.

   Aparecerá el cuadro de diálogo **Creación de un proyecto de conversión de aplicación de C\$1 nuevo**.   
![\[Cuadro de diálogo Proyecto de conversión de aplicación de C# nuevo\]](http://docs.aws.amazon.com/es_es/SchemaConversionTool/latest/userguide/images/csharp-application-new-project.png)

1. En **Nombre**, escriba un nombre para el proyecto de conversión de aplicaciones de C\$1. Puesto que cada proyecto de conversión de esquemas de bases de datos puede tener uno o varios proyectos secundarios de conversión de aplicaciones, elija un nombre significativo si va agrega varios proyectos. 

1. En **Ubicación**, escriba la ubicación del código fuente de su aplicación. 

1. En el árbol de origen, elija el esquema utilizado por la aplicación. Asegúrese de que este esquema forme parte de una regla de mapeo. AWS SCT resalta los esquemas que forman parte de una regla de mapeo en negrita. 

1. Seleccione **Aceptar** para crear su proyecto de conversión de aplicaciones de C\$1.

1. Busque su proyecto de conversión de aplicaciones de C\$1 en el nodo **Aplicaciones** del panel izquierdo.

## Convertir el código SQL de su aplicación C\$1 en AWS SCT
<a name="CHAP_Converting.App.Csharp.Convert"></a>

Tras añadir la aplicación C\$1 al AWS SCT proyecto, convierta el código SQL de esta aplicación a un formato compatible con la plataforma de base de datos de destino. Utilice el siguiente procedimiento para analizar y convertir su código SQL incrustado en su aplicación de C\$1 en AWS Schema Conversion Tool. 

**Para convertir el código SQL**

1. Expanda el nodo **C\$1** en **Aplicaciones** en el panel izquierdo.

1. Elija la aplicación que desea convertir y abra el menú contextual (clic secundario).

1.  Seleccione **Convertir**. AWS SCT analiza los archivos de código fuente, determina la lógica de la aplicación y carga los metadatos del código en el proyecto. Estos metadatos de código incluyen clases, objetos, métodos, variables globales, interfaces, etc. de C\$1. 

   En el panel de la base de datos de destino, AWS SCT crea una estructura de carpetas similar a la del proyecto de la aplicación de origen. Aquí puede revisar el código de la aplicación convertida.  
![\[Código SQL para analizar\]](http://docs.aws.amazon.com/es_es/SchemaConversionTool/latest/userguide/images/csharp-applications-project-analyze.png)

1. Guarde el código de la aplicación convertida. Para obtener más información, consulte [Guardado del código de la aplicación convertida](#CHAP_Converting.App.Csharp.Save).

Sus aplicaciones de C\$1 pueden incluir código SQL que interactúa con diferentes bases de datos de origen. Puede migrar a PostgreSQL varias de estas bases de datos de origen. En este caso, asegúrese de no convertir el código SQL que interactúa con las bases de datos que excluyó del ámbito de la migración. Puede excluir los archivos de origen de la aplicación de C\$1 del ámbito de la conversión. Para ello, desactive las casillas de verificación de los nombres de los archivos que desee excluir del ámbito de la conversión.

Tras cambiar el ámbito de conversión, AWS SCT seguirá analizando el código SQL de todos los archivos fuente de sus aplicaciones de C\$1. A continuación, AWS SCT copia en la carpeta de destino todos los archivos fuente que excluyó del ámbito de conversión. Esta operación permite compilar la aplicación después de guardar los archivos de la aplicación convertidos.

## Guarde el código de la aplicación convertida con AWS SCT
<a name="CHAP_Converting.App.Csharp.Save"></a>

Utilice el siguiente procedimiento para guardar el código de la aplicación convertida.

**Para guardar el código de la aplicación convertida**

1. Expanda el nodo **C\$1** en **Aplicaciones** en el panel de la base de datos de destino.

1. Elija la aplicación convertida y elija **Guardar**.

1. Introduzca la ruta a la carpeta para guardar el código de la aplicación convertida y seleccione **Seleccionar carpeta**.

## Administrar proyectos de conversión de aplicaciones en C\$1 en AWS SCT
<a name="CHAP_Converting.App.Csharp.Manage"></a>

Puede añadir varios proyectos de conversión de aplicaciones de C\$1, actualizar el código de la aplicación del AWS SCT proyecto o eliminar un proyecto de conversión de C\$1 de su proyecto. AWS SCT 

**Para agregar un proyecto de conversión de aplicaciones de C\$1 adicional**

1. Expanda el nodo **Aplicaciones** en el panel izquierdo.

1. Seleccione el nodo **C\$1** y abra el menú contextual (clic secundario).

1. Elija **Aplicación nueva**.

1. Introduzca la información necesaria para crear un proyecto de conversión de aplicaciones de C\$1 nuevo. Para obtener más información, consulte [Creación de proyectos de conversión de aplicaciones de C\$1](#CHAP_Converting.App.Csharp.Create).

Tras realizar los cambios en el código fuente de la aplicación, cárguelo en el AWS SCT proyecto.

**Para actualizar el código de la aplicación actualizado**

1. Expanda el nodo **C\$1** en **Aplicaciones** en el panel izquierdo.

1. Elija la aplicación que desea actualizar y abra el menú contextual (clic secundario).

1. Seleccione **Actualizar** y, a continuación, elija **Sí**.

   AWS SCT carga el código de la aplicación desde los archivos fuente y elimina los resultados de la conversión. Para conservar los cambios de código que ha realizado AWS SCT y los resultados de la conversión, cree un nuevo proyecto de conversión de C\$1.

**Para eliminar un proyecto de conversión de aplicaciones de C\$1**

1. Expanda el nodo **C\$1** en **Aplicaciones** en el panel izquierdo.

1. Elija la aplicación que desea eliminar y abra el menú contextual (clic secundario).

1. Elija **Eliminar** y a continuación haga clic en **Aceptar**.

## Crear un informe de evaluación de conversiones de aplicaciones de C\$1 en AWS SCT
<a name="CHAP_Converting.App.Csharp.AssessmentReport"></a>

El *Informe de evaluación de la conversión de aplicaciones de C\$1* proporciona información sobre cómo convertir el código SQL incrustado en su aplicación de C\$1 a un formato compatible con la base de datos de destino. El informe de evaluación proporciona detalles de la conversión para todos los puntos de ejecución de SQL y todos los archivos de código fuente. El informe de evaluación también incluye elementos de acción para el código SQL que no AWS SCT se puede convertir. 

Utilice el siguiente procedimiento para crear un informe de evaluación de la conversión de aplicaciones de C\$1.

**Para crear un informe de evaluación de la conversión de aplicaciones de C\$1**

1. Expanda el nodo **C\$1** en **Aplicaciones** en el panel izquierdo.

1. Elija la aplicación que desea convertir y abra el menú contextual (clic secundario).

1. Seleccione **Convertir**.

1. En el menú **Ver**, seleccione **Ver informe de evaluación**.

1. Consulte la pestaña **Resumen**.

   En la pestaña **Resumen** que se muestra a continuación aparece la información del resumen ejecutivo del informe de evaluación de la aplicación de C\$1. Muestra los resultados de la conversión de todos los puntos de ejecución de SQL y de todos los archivos de código fuente.   
![\[Pestaña Resumen del informe de evaluación de la aplicación de C#\]](http://docs.aws.amazon.com/es_es/SchemaConversionTool/latest/userguide/images/csharp-applications-summary.png)

1. Seleccione **Guardar instrucciones en JSON** para guardar el código SQL extraído de la aplicación de C\$1 como un archivo JSON.

1. (Opcional) Guarde una copia local del informe como archivo PDF o como un archivo de valores separados por comas (CSV):
   + Seleccione **Guardar en PDF** en la parte superior derecha para guardar el informe como un archivo PDF.

      El archivo PDF contiene el resumen ejecutivo, los elementos de acción y las recomendaciones para la conversión de aplicaciones.
   + Seleccione **Guardar en CSV** en la parte superior derecha para guardar el informe como un archivo CSV.

     El archivo CSV contiene elementos de acción, acciones recomendadas y una estimación de la complejidad del esfuerzo manual necesario para convertir el código SQL.

# Convertir código SQL en aplicaciones de C\$1\$1 con AWS Schema Conversion Tool
<a name="CHAP_Converting.App.Cplusplus"></a>

Para una conversión de Oracle a PostgreSQL, puede AWS SCT utilizarla para convertir el código SQL incrustado en sus aplicaciones de C\$1\$1. Este conversor de aplicaciones de C\$1\$1 específico comprende la lógica de la aplicación. Recopila las declaraciones que se encuentran en diferentes objetos de la aplicación, como funciones, parámetros, variables locales, etc. 

Gracias a este análisis profundo, el conversor de código SQL de aplicaciones de C\$1\$1 proporciona mejores resultados de conversión que el conversor genérico. 

## Creación de proyectos de conversión de aplicaciones de C\$1\$1 en AWS SCT
<a name="CHAP_Converting.App.Cplusplus.Create"></a>

Puede crear un proyecto de conversión de aplicaciones de C\$1\$1 solo para convertir esquemas de bases de datos Oracle en esquemas de bases de datos PostgreSQL. Agregue una regla de asignación a su proyecto que incluya un esquema de Oracle de origen y una base de datos PostgreSQL de destino. Para obtener más información, consulte [Asignación de tipos de datos en AWS Schema Conversion Tool](CHAP_Mapping.md). 

Puede agregar varios proyectos de conversión de aplicaciones en un único proyecto de AWS SCT .

**Para crear un proyecto de conversión de aplicaciones de C\$1\$1**

1. Cree un proyecto de conversión de bases de datos y agregue una base de datos Oracle de origen. Para obtener más información, consulte [Iniciar y gestionar proyectos en AWS SCT](CHAP_UserInterface.Project.md) y [Añadir servidores al proyecto en AWS SCT](CHAP_UserInterface.AddServers.md). 

1. Agregue una regla de asignación que incluya la base de datos Oracle de origen y una base de datos PostgreSQL de destino. Puede agregar una base de datos PostgreSQL de destino o utilizar una plataforma de base de datos PostgreSQL de destino virtual en una regla de asignación. Para obtener más información, consulte [Asignación de tipos de datos en AWS Schema Conversion Tool](CHAP_Mapping.md) y [Asignación a destinos virtuales en AWS Schema Conversion Tool](CHAP_Mapping.VirtualTargets.md). 

1. En el menú **Ver**, seleccione **Vista principal**.

1. En el menú **Aplicaciones**, elija **Aplicación de \$1\$1 nueva**. 

   Aparecerá el cuadro de diálogo **Creación de un proyecto de conversión de aplicaciones de C\$1\$1 nuevo**.   
![\[Cuadro de diálogo Proyecto de conversión de aplicaciones de C++ nuevo\]](http://docs.aws.amazon.com/es_es/SchemaConversionTool/latest/userguide/images/cplusplus-application-new-project.png)

1. En **Nombre**, escriba un nombre para el proyecto de conversión de aplicaciones de C\$1\$1. Puesto que cada proyecto de conversión de esquemas de bases de datos puede tener uno o varios proyectos secundarios de conversión de aplicaciones, elija un nombre significativo si va agrega varios proyectos. 

1. En **Ubicación**, escriba la ubicación del código fuente de su aplicación. 

1. En el árbol de origen, elija el esquema utilizado por la aplicación. Asegúrese de que este esquema forma parte de una regla de mapeo. AWS SCT resalta los esquemas que forman parte de una regla de mapeo en negrita. 

1. Seleccione **Aceptar** para crear su proyecto de conversión de aplicaciones de C\$1\$1.

1. Busque su proyecto de conversión de aplicaciones de C\$1\$1 en el nodo **Aplicaciones** del panel izquierdo.

## Convertir el código SQL de su aplicación C\$1\$1 en AWS SCT
<a name="CHAP_Converting.App.Cplusplus.Convert"></a>

Tras añadir la aplicación de C\$1\$1 al AWS SCT proyecto, convierta el código SQL de esta aplicación a un formato compatible con la plataforma de base de datos de destino. Utilice el siguiente procedimiento para analizar y convertir su código SQL incrustado en su aplicación de C\$1\$1 en AWS SCT. 

**Para convertir el código SQL**

1. Expanda el nodo **C\$1\$1** en **Aplicaciones** en el panel izquierdo y elija la aplicación que desee convertir.

1. En **Proyecto de la aplicación Oracle de origen**, seleccione **Configuración**. Revise y edite la configuración de conversión de aplicaciones de C\$1\$1 seleccionada. También puede especificar la configuración de conversión para todas las aplicaciones de C\$1\$1 que haya agregado al AWS SCT proyecto. Para obtener más información, consulte [Administración de proyectos de conversión de aplicaciones de C\$1\$1](#CHAP_Converting.App.Cplusplus.Manage).

1. En **Tipo de compilador**, elija el compilador que utilizará para el código fuente de la aplicación de C\$1\$1. AWS SCT **admite los siguientes compiladores de C\$1\$1: **Microsoft Visual C\$1\$1**, **GCC, GNU Compiler Collection** y Clang.** La opción predeterminada es **Microsoft Visual C\$1\$1**.

1. En **Macros definidas por el usuario**, introduzca la ruta al archivo que incluye las macros definidas por el usuario del proyecto de C\$1\$1. Asegúrese de que este archivo tiene la siguiente estructura: `#define name value`. Al igual que en el ejemplo anterior, el parámetro `value` es opcional. El valor predeterminado para este parámetro es `1`.

   Para crear este archivo, abra el proyecto en Microsoft Visual Studio y, a continuación, elija **Proyecto**, **Propiedades**, **C/C\$1\$1** y **Preprocesador**. En **Definiciones del preprocesador**, elija **Editar** y copie los nombres y valores en un nuevo archivo de texto. A continuación, para cada cadena del archivo, agregue el siguiente prefijo: `#define `.

1. En **Directorios de inclusión externa**, introduzca las rutas a las carpetas que incluyen las bibliotecas externas que utiliza en su proyecto de C\$1\$1.

1. En el panel izquierdo, seleccione la aplicación que desea convertir y abra el menú contextual (clic secundario).

1.  **Selecciona Convertir.** AWS SCT analiza los archivos de código fuente, determina la lógica de la aplicación y carga los metadatos del código en el proyecto. Estos metadatos de código incluyen clases, objetos, métodos, variables globales, interfaces, etc. de C\$1\$1. 

   En el panel de la base de datos de destino, AWS SCT crea una estructura de carpetas similar a la del proyecto de la aplicación de origen. Aquí puede revisar el código de la aplicación convertida, como se muestra a continuación.  
![\[Código SQL para analizar\]](http://docs.aws.amazon.com/es_es/SchemaConversionTool/latest/userguide/images/cplusplus-applications-project-analyze.png)

1. Guarde el código de la aplicación convertida. Para obtener más información, consulte [Guardado del código de la aplicación convertida](#CHAP_Converting.App.Cplusplus.Save).

## Guarde el código de la aplicación convertida con AWS SCT
<a name="CHAP_Converting.App.Cplusplus.Save"></a>

Utilice el siguiente procedimiento para guardar el código de la aplicación convertida. 

**Para guardar el código de la aplicación convertida**

1. Expanda el nodo **C\$1\$1** en **Aplicaciones** en el panel de la base de datos de destino.

1. Elija la aplicación convertida y elija **Guardar**.

1. Introduzca la ruta a la carpeta para guardar el código de la aplicación convertida y seleccione **Seleccionar carpeta**.

## Administrar proyectos de conversión de aplicaciones de C\$1\$1 en AWS SCT
<a name="CHAP_Converting.App.Cplusplus.Manage"></a>

Puede añadir varios proyectos de conversión de aplicaciones de C\$1\$1, editar la configuración de conversión, actualizar el código de la aplicación de C\$1\$1 o eliminar un proyecto de conversión de C\$1\$1 de su AWS SCT proyecto.

**Para agregar un proyecto de conversión de aplicaciones de C\$1\$1 adicional**

1. Expanda el nodo **Aplicaciones** en el panel izquierdo.

1. Seleccione el nodo **C\$1\$1** y abra el menú contextual (clic secundario).

1. Elija **Aplicación nueva**.

1. Introduzca la información necesaria para crear un proyecto de conversión de aplicaciones de C\$1\$1 nuevo. Para obtener más información, consulte [Creación de proyectos de conversión de aplicaciones de C\$1\$1](#CHAP_Converting.App.Cplusplus.Create).

Puede especificar la configuración de conversión para todos los proyectos de conversión de aplicaciones de C\$1\$1 de su AWS SCT proyecto.

**Para editar la configuración de conversión de todas las aplicaciones de C\$1\$1**

1. En el menú **Configuración**, elija **Configuración del proyecto** y, a continuación, elija **Conversión de aplicación**.

1. En **Tipo de compilador**, elija el compilador que utilizará para el código fuente de la aplicación de C\$1\$1. AWS SCT **admite los siguientes compiladores de C\$1\$1: **Microsoft Visual C\$1\$1**, **GCC, GNU Compiler Collection** y Clang.** La opción predeterminada es **Microsoft Visual C\$1\$1**.

1. En **Macros definidas por el usuario**, introduzca la ruta al archivo que incluye las macros definidas por el usuario del proyecto de C\$1\$1. Asegúrese de que este archivo tiene la siguiente estructura: `#define name value`. Al igual que en el ejemplo anterior, el parámetro `value` es opcional. El valor predeterminado para este parámetro es `1`.

   Para crear este archivo, abra el proyecto en Microsoft Visual Studio y, a continuación, elija **Proyecto**, **Propiedades**, **C/C\$1\$1** y **Preprocesador**. En **Definiciones del preprocesador**, elija **Editar** y copie los nombres y valores en un nuevo archivo de texto. A continuación, para cada cadena del archivo, agregue el siguiente prefijo: `#define `.

1. En **Directorios de inclusión externa**, introduzca las rutas a las carpetas que incluyen las bibliotecas externas que utiliza en su proyecto de C\$1\$1.

1. Pulse **Aceptar** para guardar la configuración del proyecto y cerrar la ventana.

O especifique la configuración de la conversión para cada proyecto de conversión de aplicaciones de C\$1\$1. Para obtener más información, consulte [Conversión del código SQL de la aplicación de C\$1\$1](#CHAP_Converting.App.Cplusplus.Convert).

Tras realizar los cambios en el código fuente de la aplicación, cárguelo en el proyecto. AWS SCT 

**Para actualizar el código de la aplicación actualizado**

1. Expanda el nodo **C\$1\$1** en **Aplicaciones** en el panel izquierdo.

1. Elija la aplicación que desea actualizar y abra el menú contextual (clic secundario).

1. Seleccione **Actualizar** y, a continuación, elija **Sí**.

   AWS SCT carga el código de la aplicación desde los archivos fuente y elimina los resultados de la conversión. Para conservar los cambios de código que ha realizado AWS SCT y los resultados de la conversión, cree un nuevo proyecto de conversión a C\$1\$1.

   Además, AWS SCT elimina la configuración de conversión de aplicaciones que especificó para la aplicación seleccionada. Tras cargar el código de aplicación actualizado, AWS SCT aplica los valores predeterminados de la configuración del proyecto.

**Para eliminar un proyecto de conversión de aplicaciones de C\$1\$1**

1. Expanda el nodo **C\$1\$1** en **Aplicaciones** en el panel izquierdo.

1. Elija la aplicación que desea eliminar y abra el menú contextual (clic secundario).

1. Elija **Eliminar** y a continuación haga clic en **Aceptar**.

## Crear un informe de evaluación de la conversión de aplicaciones de C\$1\$1 en AWS SCT
<a name="CHAP_Converting.App.Cplusplus.AssessmentReport"></a>

El *Informe de evaluación de la conversión de aplicaciones de C\$1\$1* proporciona información sobre cómo convertir el código SQL incrustado en su aplicación de C\$1\$1 a un formato compatible con la base de datos de destino. El informe de evaluación proporciona detalles de la conversión para todos los puntos de ejecución de SQL y todos los archivos de código fuente. El informe de evaluación también incluye elementos de acción para el código SQL que no AWS SCT se puede convertir. 

**Para crear un informe de evaluación de la conversión de aplicaciones de C\$1\$1**

1. Expanda el nodo **C\$1\$1** en **Aplicaciones** en el panel izquierdo.

1. Elija la aplicación que desea convertir y abra el menú contextual (clic secundario).

1. Seleccione **Convertir**.

1. En el menú **Ver**, seleccione **Ver informe de evaluación**.

1. Consulte la pestaña **Resumen**.

   En la pestaña **Resumen** que se muestra a continuación aparece la información resumida del informe de evaluación de la aplicación de C\$1\$1. Muestra los resultados de la conversión de todos los puntos de ejecución de SQL y de todos los archivos de código fuente. 

1. Seleccione **Guardar instrucciones en JSON** para guardar el código SQL extraído de la aplicación de Java como un archivo JSON.

1. (Opcional) Guarde una copia local del informe como archivo PDF o como un archivo de valores separados por comas (CSV):
   + Seleccione **Guardar en PDF** en la parte superior derecha para guardar el informe como un archivo PDF.

      El archivo PDF contiene el resumen ejecutivo, los elementos de acción y las recomendaciones para la conversión de aplicaciones.
   + Seleccione **Guardar en CSV** en la parte superior derecha para guardar el informe como un archivo CSV.

     El archivo CSV contiene elementos de acción, acciones recomendadas y una estimación de la complejidad del esfuerzo manual necesario para convertir el código SQL.

# Convertir código SQL en aplicaciones Java con AWS Schema Conversion Tool
<a name="CHAP_Converting.App.Java"></a>

Para una conversión de Oracle a PostgreSQL, puede AWS Schema Conversion Tool utilizarla para convertir el código SQL incrustado en sus aplicaciones Java. Este conversor de aplicaciones de Java específico comprende la lógica de la aplicación. Recopila las declaraciones que se encuentran en diferentes objetos de la aplicación, como funciones, parámetros, variables locales, etc. 

Gracias a este análisis profundo, el conversor de código SQL de aplicaciones de Java proporciona mejores resultados de conversión que el conversor genérico.

Si su aplicación Java usa el MyBatis marco para interactuar con las bases de datos, puede usarlo AWS SCT para convertir sentencias SQL incrustadas en anotaciones y archivos MyBatis XML. Para entender la lógica de estas sentencias SQL, AWS SCT utiliza el archivo de MyBatis configuración. AWS SCT puede detectar automáticamente este archivo en la carpeta de la aplicación o puede introducir la ruta de acceso a este archivo manualmente.

## Creación de proyectos de conversión de aplicaciones Java en AWS SCT
<a name="CHAP_Converting.App.Java.Create"></a>

Puede crear un proyecto de conversión de aplicaciones de Java solo para convertir esquemas de bases de datos Oracle en esquemas de bases de datos PostgreSQL. Agregue una regla de asignación a su proyecto que incluya un esquema de Oracle de origen y una base de datos PostgreSQL de destino. Para obtener más información, consulte [Asignación de tipos de datos en AWS Schema Conversion Tool](CHAP_Mapping.md).

Puede añadir varios proyectos de conversión de aplicaciones en un solo AWS SCT proyecto. Utilice el siguiente procedimiento para crear un proyecto de conversión de aplicaciones de Java. 

**Para crear un proyecto de conversión de aplicaciones de Java**

1. Cree un proyecto de conversión de bases de datos y agregue una base de datos Oracle de origen. Para obtener más información, consulte [Iniciar y gestionar proyectos en AWS SCT](CHAP_UserInterface.Project.md) y [Añadir servidores al proyecto en AWS SCT](CHAP_UserInterface.AddServers.md). 

1. Agregue una regla de asignación que incluya la base de datos Oracle de origen y una base de datos PostgreSQL de destino. Puede agregar una base de datos PostgreSQL de destino o utilizar una plataforma de base de datos PostgreSQL de destino virtual en una regla de asignación. Para obtener más información, consulte [Asignación de tipos de datos en AWS Schema Conversion Tool](CHAP_Mapping.md) y [Asignación a destinos virtuales en AWS Schema Conversion Tool](CHAP_Mapping.VirtualTargets.md). 

1. En el menú **Ver**, seleccione **Vista principal**.

1. En el menú **Aplicaciones**, elija **Aplicación de Java nueva**. 

   Aparecerá el cuadro de diálogo **Creación de un proyecto de conversión de aplicaciones de Java nuevo**.   
![\[Cuadro de diálogo Proyecto de conversión de aplicaciones de Java nuevo\]](http://docs.aws.amazon.com/es_es/SchemaConversionTool/latest/userguide/images/java-application-new-project.png)

1. En **Nombre**, escriba un nombre para el proyecto de conversión de aplicaciones de Java. Puesto que cada proyecto de conversión de esquemas de bases de datos puede tener uno o varios proyectos secundarios de conversión de aplicaciones, elija un nombre significativo si va agrega varios proyectos. 

1. En **Ubicación**, escriba la ubicación del código fuente de su aplicación. 

1. (Opcional) Para **el archivo de MyBatis configuración**, introduzca la ruta al archivo MyBatis de configuración. AWS SCT escanea la carpeta de la aplicación para detectar este archivo automáticamente. Si este archivo no se encuentra en la carpeta de la aplicación o si utiliza varios archivos de configuración, introduzca la ruta manualmente.

1. En el árbol de origen, elija el esquema utilizado por la aplicación. Asegúrese de que este esquema forma parte de una regla de mapeo. AWS SCT resalta los esquemas que forman parte de una regla de mapeo en negrita. 

1. Seleccione **Aceptar** para crear su proyecto de conversión de aplicaciones de Java.

1. Busque su proyecto de conversión de aplicaciones de Java en el nodo **Aplicaciones** del panel izquierdo.

## Convertir el código SQL de su aplicación Java en AWS SCT
<a name="CHAP_Converting.App.Java.Convert"></a>

Tras añadir la aplicación Java al AWS SCT proyecto, convierta el código SQL de esta aplicación a un formato compatible con la plataforma de base de datos de destino. Utilice el siguiente procedimiento para analizar y convertir su código SQL incrustado en su aplicación de Java en AWS Schema Conversion Tool. 

**Para convertir el código SQL**

1. Expanda el nodo **Java** en **Aplicaciones** en el panel izquierdo.

1. Elija la aplicación que desea convertir y abra el menú contextual (clic secundario).

1.  Seleccione **Convertir**. AWS SCT analiza los archivos de código fuente, determina la lógica de la aplicación y carga los metadatos del código en el proyecto. Estos metadatos de código incluyen clases, objetos, métodos, variables globales, interfaces, etc. de Java. 

   En el panel de la base de datos de destino, AWS SCT crea una estructura de carpetas similar a la del proyecto de la aplicación de origen. Aquí puede revisar el código de la aplicación convertida.  
![\[Código SQL para analizar\]](http://docs.aws.amazon.com/es_es/SchemaConversionTool/latest/userguide/images/java-applications-project-analyze.png)

1. Guarde el código de la aplicación convertida. Para obtener más información, consulte [Guardado del código de la aplicación convertida](#CHAP_Converting.App.Java.Save).

Sus aplicaciones de Java pueden incluir código SQL que interactúa con diferentes bases de datos de origen. Puede migrar a PostgreSQL varias de estas bases de datos de origen. En este caso, asegúrese de no convertir el código SQL que interactúa con las bases de datos que excluyó del ámbito de la migración. Puede excluir los archivos de origen de su aplicación de Java del ámbito de la conversión. Para ello, desactive las casillas de verificación de los nombres de los archivos que desee excluir del ámbito de la conversión.

Tras cambiar el ámbito de conversión, AWS SCT seguirá analizando el código SQL y todos los archivos fuente de sus aplicaciones Java. A continuación, AWS SCT copia en la carpeta de destino todos los archivos fuente que excluyó del ámbito de conversión. Esta operación permite compilar la aplicación después de guardar los archivos de la aplicación convertidos.

## Guarde el código de la aplicación convertida con AWS SCT
<a name="CHAP_Converting.App.Java.Save"></a>

Utilice el siguiente procedimiento para guardar el código de la aplicación convertida.

**Para guardar el código de la aplicación convertida**

1. Expanda el nodo **Java** en **Aplicaciones** en el panel de la base de datos de destino.

1. Elija la aplicación convertida y elija **Guardar**.

1. Introduzca la ruta a la carpeta para guardar el código de la aplicación convertida y seleccione **Seleccionar carpeta**.

Si la aplicación Java de origen utiliza el MyBatis marco, asegúrese de actualizar el archivo de configuración para que funcione con la nueva base de datos.

## Administrar proyectos de conversión de aplicaciones Java en AWS SCT
<a name="CHAP_Converting.App.Java.Manage"></a>

Puede añadir varios proyectos de conversión de aplicaciones Java, actualizar el código de la aplicación en el AWS SCT proyecto o eliminar un proyecto de conversión a Java de su AWS SCT proyecto.

**Para agregar un proyecto de conversión de aplicaciones de Java adicional**

1. Expanda el nodo **Aplicaciones** en el panel izquierdo.

1. Seleccione el nodo **Java** y abra el menú contextual (clic secundario).

1. Elija **Aplicación nueva**.

1. Introduzca la información necesaria para crear un proyecto de conversión de aplicaciones de Java nuevo. Para obtener más información, consulte [Creación de proyectos de conversión de aplicaciones de Java](#CHAP_Converting.App.Java.Create).

Tras realizar los cambios en el código fuente de la aplicación, cárguelo en el proyecto de AWS SCT .

**Para actualizar el código de la aplicación actualizado**

1. Expanda el nodo **Java** en **Aplicaciones** en el panel izquierdo.

1. Elija la aplicación que desea actualizar y abra el menú contextual (clic secundario).

1. Seleccione **Actualizar** y, a continuación, elija **Sí**.

   AWS SCT carga el código de la aplicación desde los archivos fuente y elimina los resultados de la conversión. Para conservar los cambios de código que ha realizado AWS SCT y los resultados de la conversión, cree un nuevo proyecto de conversión de Java.

Si la aplicación Java de origen utiliza el MyBatis marco, AWS SCT utilizará el archivo de MyBatis configuración para analizar el código SQL. Después de cambiar este archivo, cárguelo en el AWS SCT proyecto.

**Para editar la ruta al archivo MyBatis de configuración**

1. Expanda el nodo **Java** en **Aplicaciones** en el panel izquierdo.

1. Elija la aplicación y, a continuación, elija **Configuración**.

1. Seleccione **Examinar** y, a continuación, elija el archivo MyBatis de configuración.

1. Seleccione **Aplicar**.

1. En el panel izquierdo, elija la aplicación, abra el menú contextual (clic secundario) y elija **Actualizar**.

**Para eliminar un proyecto de conversión de aplicaciones de Java**

1. Expanda el nodo **Java** en **Aplicaciones** en el panel izquierdo.

1. Elija la aplicación que desea eliminar y abra el menú contextual (clic secundario).

1. Elija **Eliminar** y a continuación haga clic en **Aceptar**.

## Creación de un informe de evaluación de la conversión de aplicaciones Java en AWS SCT
<a name="CHAP_Converting.App.Java.AssessmentReport"></a>

El *Informe de evaluación de la conversión de aplicaciones de Java* proporciona información sobre cómo convertir el código SQL incrustado en su aplicación de Java a un formato compatible con la base de datos de destino. El informe de evaluación proporciona detalles de la conversión para todos los puntos de ejecución de SQL y todos los archivos de código fuente. El informe de evaluación también incluye elementos de acción para el código SQL que no AWS SCT se puede convertir. 

Utilice el siguiente procedimiento para crear un informe de evaluación de la conversión de aplicaciones de Java.

**Para crear un informe de evaluación de la conversión de aplicaciones de Java**

1. Expanda el nodo **Java** en **Aplicaciones** en el panel izquierdo.

1. Elija la aplicación que desea convertir y abra el menú contextual (clic secundario).

1. Seleccione **Convertir**.

1. En el menú **Ver**, seleccione **Ver informe de evaluación**.

1. Consulte la pestaña **Resumen**.

   En la pestaña **Resumen** que se muestra a continuación aparece la información del resumen ejecutivo del informe de evaluación de la aplicación de Java. Muestra los resultados de la conversión de todos los puntos de ejecución de SQL y de todos los archivos de código fuente.   
![\[Pestaña Resumen del informe de evaluación de la aplicación de Java\]](http://docs.aws.amazon.com/es_es/SchemaConversionTool/latest/userguide/images/java-applications-summary.png)

1. Seleccione **Guardar instrucciones en JSON** para guardar el código SQL extraído de la aplicación de Java como un archivo JSON.

1. (Opcional) Guarde una copia local del informe como archivo PDF o como un archivo de valores separados por comas (CSV):
   + Seleccione **Guardar en PDF** en la parte superior derecha para guardar el informe como un archivo PDF.

      El archivo PDF contiene el resumen ejecutivo, los elementos de acción y las recomendaciones para la conversión de aplicaciones.
   + Seleccione **Guardar en CSV** en la parte superior derecha para guardar el informe como un archivo CSV.

     El archivo CSV contiene elementos de acción, acciones recomendadas y una estimación de la complejidad del esfuerzo manual necesario para convertir el código SQL.

# Convertir código SQL en aplicaciones Pro\$1C con AWS Schema Conversion Tool
<a name="CHAP_Converting.App.ProC"></a>

Para una conversión de Oracle a PostgreSQL, puede usar AWS SCT() para convertir AWS Schema Conversion Tool el código SQL incrustado en sus aplicaciones Pro\$1C. Este conversor de aplicaciones de Pro\$1C específico comprende la lógica de la aplicación. Recopila las declaraciones que se encuentran en diferentes objetos de la aplicación, como funciones, parámetros, variables locales, etc. 

Gracias a este análisis profundo, el conversor de código SQL de aplicaciones de Pro\$1C proporciona mejores resultados de conversión que el conversor genérico. 

## Creación de proyectos de conversión de aplicaciones Pro\$1C en AWS SCT
<a name="CHAP_Converting.App.ProC.Create"></a>

Puede crear un proyecto de conversión de aplicaciones de Pro\$1C solo para convertir esquemas de bases de datos Oracle en esquemas de bases de datos PostgreSQL. Agregue una regla de asignación a su proyecto que incluya un esquema de Oracle de origen y una base de datos PostgreSQL de destino. Para obtener más información, consulte [Asignación de tipos de datos en AWS Schema Conversion Tool](CHAP_Mapping.md).

Puede añadir varios proyectos de conversión de aplicaciones en un solo AWS SCT proyecto. Utilice el siguiente procedimiento para crear un proyecto de conversión de aplicaciones de Pro\$1C. 

**Para crear un proyecto de conversión de aplicaciones de Pro\$1C**

1. Cree un proyecto de conversión de bases de datos y agregue una base de datos Oracle de origen. Para obtener más información, consulte [Iniciar y gestionar proyectos en AWS SCT](CHAP_UserInterface.Project.md) y [Añadir servidores al proyecto en AWS SCT](CHAP_UserInterface.AddServers.md). 

1. Agregue una regla de asignación que incluya la base de datos Oracle de origen y una base de datos PostgreSQL de destino. Puede agregar una base de datos PostgreSQL de destino o utilizar una plataforma de base de datos PostgreSQL de destino virtual en una regla de asignación. Para obtener más información, consulte [Asignación de tipos de datos en AWS Schema Conversion Tool](CHAP_Mapping.md) y [Asignación a destinos virtuales en AWS Schema Conversion Tool](CHAP_Mapping.VirtualTargets.md). 

1. En el menú **Ver**, seleccione **Vista principal**.

1. En el menú **Aplicaciones**, elija **Aplicación de Pro\$1C nueva**. 

   Aparecerá el cuadro de diálogo **Creación de un proyecto de conversión de aplicaciones de Pro\$1C nuevo**.   
![\[Cuadro de diálogo Proyecto de conversión de aplicación de Pro*C nuevo\]](http://docs.aws.amazon.com/es_es/SchemaConversionTool/latest/userguide/images/proc-application-new-project.png)

1. En **Nombre**, escriba un nombre para el proyecto de conversión de aplicaciones de Pro\$1C. Puesto que cada proyecto de conversión de esquemas de bases de datos puede tener uno o varios proyectos secundarios de conversión de aplicaciones, elija un nombre significativo si va agrega varios proyectos. 

1. En **Ubicación**, escriba la ubicación del código fuente de su aplicación. 

1. En el árbol de origen, elija el esquema utilizado por la aplicación. Asegúrese de que este esquema forme parte de una regla de mapeo. AWS SCT resalta los esquemas que forman parte de una regla de mapeo en negrita. 

1. Seleccione **Aceptar** para crear su proyecto de conversión de aplicaciones de Pro\$1C.

1. Busque su proyecto de conversión de aplicaciones de Pro\$1C en el nodo **Aplicaciones** del panel izquierdo.

## Convertir el código SQL de su aplicación Pro\$1C en AWS SCT
<a name="CHAP_Converting.App.ProC.Convert"></a>

Después de añadir la aplicación Pro\$1C al AWS SCT proyecto, convierta el código SQL de esta aplicación a un formato compatible con la plataforma de base de datos de destino. Utilice el siguiente procedimiento para analizar y convertir su código SQL incrustado en su aplicación de Pro\$1C en AWS Schema Conversion Tool. 

**Para convertir el código SQL**

1. Expanda el nodo **Pro\$1C** en **Aplicaciones** en el panel izquierdo.

1. Elija la aplicación de que desea convertir y, seguidamente, seleccione **Configuración**.

   1. En **Ruta del archivo de encabezado global**, introduzca la ruta de acceso a los archivos de encabezado que utiliza el proyecto de la aplicación.

   1. Seleccione **Interpretar todas las variables de host no resueltas como** para ver todas las variables no resueltas en el código convertido.

   1. Seleccione **Utilizar la función de conversión de cadenas de ancho fijo del paquete de extensión** para utilizar las funciones del paquete de extensión en el código SQL convertido. AWS SCT incluye los archivos del paquete de extensión en el proyecto de la aplicación.

   1. Seleccione **Transformar PL/SQL bloques anónimos en llamadas SQL independientes o funciones almacenadas para crear procedimientos almacenados** en la base de datos de destino para todos los bloques anónimos. PL/SQL AWS SCT a continuación, incluye las ejecuciones de estos procedimientos almacenados en el código de la aplicación convertida.

   1. Seleccione **Utilizar un flujo de cursores personalizado** para mejorar la conversión de los cursores de las bases de datos Oracle.

1. En el panel izquierdo, seleccione la aplicación que desea convertir y abra el menú contextual (clic secundario).

1.  Seleccione **Convertir**. AWS SCT analiza los archivos de código fuente, determina la lógica de la aplicación y carga los metadatos del código en el proyecto. Estos metadatos de código incluyen clases, objetos, métodos, variables globales, interfaces, etc. de Pro\$1C. 

   En el panel de la base de datos de destino, AWS SCT crea una estructura de carpetas similar a la del proyecto de la aplicación de origen. Aquí puede revisar el código de la aplicación convertida.  
![\[Código SQL para analizar\]](http://docs.aws.amazon.com/es_es/SchemaConversionTool/latest/userguide/images/proc-applications-project-analyze.png)

1. Guarde el código de la aplicación convertida. Para obtener más información, consulte [Edición y guardado del código de la aplicación convertida](#CHAP_Converting.App.ProC.Save).

## Edita y guarda el código de la aplicación convertida con AWS SCT
<a name="CHAP_Converting.App.ProC.Save"></a>

Puede editar las sentencias SQL convertidas y utilizarlas AWS SCT para incrustar este código editado en el código de la aplicación Pro\$1C convertida. Utilice el siguiente procedimiento para editar el código SQL convertido.

**Para editar el código SQL convertido**

1. Expanda el nodo **Pro\$1C** en **Aplicaciones** en el panel izquierdo.

1. Elija la aplicación que desea convertir, abra el menú contextual (clic secundario) y seleccione **Convertir**.

1. En el menú **Ver**, seleccione **Ver informe de evaluación**.

1. Seleccione **Guardar instrucciones en CSV** para guardar el código SQL extraído de la aplicación de Pro\$1C como un archivo CSV.

1. Introduzca el nombre del archivo CSV para guardar el código SQL extraído y seleccione **Guardar.**

1. Edite el código SQL extraído.

1. En el menú **Ver**, seleccione **Vista principal**.

1. Expanda el nodo **Pro\$1C** en **Aplicaciones** en el panel de la base de datos de destino.

1. Elija la aplicación convertida, abra el menú contextual (clic secundario) y elija **Importar instrucciones de CSV**.

1. Seleccione **Sí**, seleccione el archivo con el código SQL editado y, seguidamente, selecciona **Abrir**.

AWS SCT divide las sentencias SQL convertidas en partes y las coloca en los objetos correspondientes del código fuente de la aplicación. Utilice el siguiente procedimiento para guardar el código de la aplicación convertida.

**Para guardar el código de la aplicación convertida**

1. Expanda el nodo **Pro\$1C** en **Aplicaciones** en el panel de la base de datos de destino.

1. Elija la aplicación convertida y elija **Guardar**.

1. Introduzca la ruta a la carpeta para guardar el código de la aplicación convertida y seleccione **Seleccionar carpeta**.

## Gestión de proyectos de conversión de aplicaciones Pro\$1C en AWS SCT
<a name="CHAP_Converting.App.ProC.Manage"></a>

Puede añadir varios proyectos de conversión de aplicaciones Pro\$1C, actualizar el código de la aplicación en el AWS SCT proyecto o eliminar un proyecto de conversión de Pro\$1C de su proyecto. AWS SCT 

**Para agregar un proyecto de conversión de aplicaciones de Pro\$1C adicional**

1. Expanda el nodo **Aplicaciones** en el panel izquierdo.

1. Seleccione el nodo **Pro\$1C** y abra el menú contextual (clic secundario).

1. Elija **Aplicación nueva**.

1. Introduzca la información necesaria para crear un proyecto de conversión de aplicaciones de Pro\$1C nuevo. Para obtener más información, consulte [Creación de proyectos de conversión de aplicaciones de Pro\$1C](#CHAP_Converting.App.ProC.Create).

Después de realizar los cambios en el código fuente de la aplicación, cárguelo en el proyecto. AWS SCT 

**Para actualizar el código de la aplicación actualizado**

1. Expanda el nodo **Pro\$1C** en **Aplicaciones** en el panel izquierdo.

1. Elija la aplicación que desea actualizar y abra el menú contextual (clic secundario).

1. Seleccione **Actualizar** y, a continuación, elija **Sí**.

   AWS SCT carga el código de la aplicación desde los archivos fuente y elimina los resultados de la conversión. Para conservar los cambios de código que ha realizado AWS SCT y los resultados de la conversión, cree un nuevo proyecto de conversión de Pro\$1C.

**Para eliminar un proyecto de conversión de aplicaciones de Pro\$1C**

1. Expanda el nodo **Pro\$1C** en **Aplicaciones** en el panel izquierdo.

1. Elija la aplicación que desea eliminar y abra el menú contextual (clic secundario).

1. Elija **Eliminar** y a continuación haga clic en **Aceptar**.

## Crear un informe de evaluación de la conversión de una aplicación Pro\$1C en AWS SCT
<a name="CHAP_Converting.App.ProC.AssessmentReport"></a>

El *Informe de evaluación de la conversión de aplicaciones de Pro\$1C* proporciona información sobre cómo convertir el código SQL incrustado en su aplicación de Pro\$1C a un formato compatible con la base de datos de destino. El informe de evaluación proporciona detalles de la conversión para todos los puntos de ejecución de SQL y todos los archivos de código fuente. El informe de evaluación también incluye elementos de acción para el código SQL que no AWS SCT se puede convertir. 

Utilice el siguiente procedimiento para crear un informe de evaluación de la aplicación de Pro\$1C.

**Para crear un informe de evaluación de la conversión de aplicaciones de Pro\$1C**

1. Expanda el nodo **Pro\$1C** en **Aplicaciones** en el panel izquierdo.

1. Elija la aplicación que desea convertir y abra el menú contextual (clic secundario).

1. Seleccione **Convertir**.

1. En el menú **Ver**, seleccione **Ver informe de evaluación**.

1. Consulte la pestaña **Resumen**.

   En la pestaña **Resumen** que se muestra a continuación aparece la información resumida del informe de evaluación de la aplicación de Pro\$1C. Muestra los resultados de la conversión de todos los puntos de ejecución de SQL y de todos los archivos de código fuente.   
![\[Pestaña Resumen del informe de evaluación de la aplicación de Pro*C\]](http://docs.aws.amazon.com/es_es/SchemaConversionTool/latest/userguide/images/proc-applications-summary.png)

1. Seleccione **Guardar instrucciones en CSV** para guardar el código SQL extraído de la aplicación de Pro\$1C como un archivo de valores separados por comas (CSV).

1. (Opcional) Guarde una copia local del informe como archivo PDF o como un archivo de valores separados por comas (CSV):
   + Seleccione **Guardar en PDF** en la parte superior derecha para guardar el informe como un archivo PDF.

      El archivo PDF contiene el resumen ejecutivo, los elementos de acción y las recomendaciones para la conversión de aplicaciones.
   + Seleccione **Guardar en CSV** en la parte superior derecha para guardar el informe como un archivo CSV.

     El archivo CSV contiene elementos de acción, acciones recomendadas y una estimación de la complejidad del esfuerzo manual necesario para convertir el código SQL.