

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 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.