Muestra las diferencias entre dos versiones de la página.
Ambos lados, revisión anterior Revisión previa Próxima revisión | Revisión previa | ||
ada:howto:sicoferp:database:repositorioscripts [2018/08/22 12:21] carlos.torres [Proceso de Gestión de Scripts] |
ada:howto:sicoferp:database:repositorioscripts [2018/08/22 14:58] (actual) carlos.torres [Repositorio de Scripts] |
||
---|---|---|---|
Línea 1: | Línea 1: | ||
- | ====== Repositorio de Scripts ====== | + | ====== Repositorio de Scripts (Utilitarios) ====== |
Es un repositorio que contiene scripts que han sido creados con el fin de brindar soluciones a procesos repetitivos o que brindan soluciones a situaciones de actualización de fallas en los procesos. ((La creación y uso de estos scripts no debe interpretarse como solución definitiva a problemas de la aplicación. Si una situación es recurrente y corresponde a errores en las aplicaciones estos scripts deberán considerarse como soluciones temporales y deben reportarse a fabrica para la corrección del problema en el código fuente.)) | Es un repositorio que contiene scripts que han sido creados con el fin de brindar soluciones a procesos repetitivos o que brindan soluciones a situaciones de actualización de fallas en los procesos. ((La creación y uso de estos scripts no debe interpretarse como solución definitiva a problemas de la aplicación. Si una situación es recurrente y corresponde a errores en las aplicaciones estos scripts deberán considerarse como soluciones temporales y deben reportarse a fabrica para la corrección del problema en el código fuente.)) | ||
Línea 13: | Línea 13: | ||
* **02 Módulos:** En este directorio se agrupan los scripts de acuerdo a los módulos del ERP. | * **02 Módulos:** En este directorio se agrupan los scripts de acuerdo a los módulos del ERP. | ||
+ | ==== SQL SERVER ==== | ||
+ | ((Pendiente por construcción)) | ||
+ | |||
+ | ==== My SQL ==== | ||
+ | ((Pendiente por construcción)) | ||
===== Proceso de Gestión de Scripts ===== | ===== Proceso de Gestión de Scripts ===== | ||
En esta sección se describe el proceso de registro y actualización de scripts en el repositorio. | En esta sección se describe el proceso de registro y actualización de scripts en el repositorio. | ||
- | * **Adición de Scripts:** Para adicionar un script copie el archivo que contiene la(s) sentencia(s) previamente validadas al directorio correspondiente, confirme los cambios y diligencie el archivo Leeme.txt - //Ver sección correspondiente//. | + | * **Adición de Scripts:** Para adicionar un script copie el archivo que contiene la(s) sentencia(s) previamente validadas al directorio correspondiente, confirme los cambios y diligencie el [[ada:howto:sicoferp:database:repositorioscripts#Archivo Leeme.txt|Archivo Leeme.txt]]. |
- | * **Edición de Scripts:** Para editar un script abra el archivo en un editor de texto de su preferencia, modifiquelo, valídelo, guardelo, confirme los cambios y diligencie el archivo Leeme.txt - //Ver sección correspondiente//. | + | * **Edición de Scripts:** Para editar un script abra el archivo en un editor de texto de su preferencia, modifiquelo, valídelo, guardelo, confirme los cambios y diligencie el [[ada:howto:sicoferp:database:repositorioscripts#Archivo Leeme.txt|Archivo Leeme.txt]]. |
- | * **Eliminación de Scripts:** Solo se permite la eliminación para los dueños de sus propios scripts, para realizar el proceso, actualice el repositorio, elimine el archivo del script, confirme los cambios y diligencie el archivo Leeme.txt - [[ada:howto:sicoferp:database:repositorioscripts#Archivo Leeme.txt|Ver sección correspondiente]]. | + | * **Eliminación de Scripts:** Solo se permite la eliminación para los dueños de sus propios scripts, para realizar el proceso, actualice el repositorio, elimine el archivo del script, confirme los cambios y diligencie el [[ada:howto:sicoferp:database:repositorioscripts#Archivo Leeme.txt|Archivo Leeme.txt]]. |
==== Archivo Leeme.txt ==== | ==== Archivo Leeme.txt ==== | ||
+ | Es un archivo muy importante para la adecuada gestión de los repositorios, esta contenido en todos los directorios y su objetivo es llevar el registro e historial de actualizaciones de cada script. | ||
+ | |||
+ | === Plantilla de Ejemplo === | ||
+ | A continuación se describe el contenido de la información que debe ser diligenciada al momento de agregar o actualizar un script teniendo presente la siguiente imagen: | ||
+ | |||
+ | {{:ada:howto:sicoferp:database:plantilla.png?600|}}. | ||
+ | == Descripción de los campos == | ||
+ | * **Desarrollador:** //Correo del usuario ADA// | ||
+ | * **Script N°:** //Identificador del Script// | ||
+ | * **Script Name:** //Nombre del Script// | ||
+ | * **Script File:** //Nombre del Archivo// | ||
+ | * **Objetivo/Funcionalidad:** //Describir lo que hace el script// | ||
+ | * **Observaciones:** //Consideraciones que se deben tener presente al momento de ejecutar el script, se debe registrar en forma de lista.// | ||
+ | === Diligenciamiento de un registro de script === | ||
+ | El siguiente ejemplo muestra como se debe registrar la información en el archivo. | ||
+ | {{:ada:howto:sicoferp:database:archivo.png?600|}} | ||
+ | ==== Observaciones ==== | ||
+ | Tener presente las siguientes observaciones para la correcta gestión de scripts. | ||
+ | * Todo script debe tener un registro en el archivo **Leeme.txt** debidamente diligenciado. | ||
+ | * Todo script debe ser validado antes de subirse al repositorio. | ||
+ | * Todos los archivos de scripts deben subirse con la extensión .sql | ||
+ | * Todos los usuarios que intervienen en la gestión de los scripts son responsables de su impacto por lo tanto la documentación debe ser clara y precisa. | ||
+ | * Los archivos de scripts deben crearse para un fin especifico no debe agrupar procesos en un mismo archivo si impactan procesos diferentes.((En estas situaciones por favor cree varios archivos)) | ||
+ | * Todos los scripts que contengan procesos secuenciales ó de varias sentencias deben incluirse en un bloque anónimo. | ||
+ | * Todos los scripts que incluyen procesos secuenciales ó de varias sentencias deben incluir un capturador de errores. | ||
+ | * No se pueden incluir **commit** parciales en los scripts a menos que esa condición sea controlada en caso que el script deba volverse a ejecutar en un mismo ambiente. Es responsabilidad del desarrollador evaluar ese impacto. | ||
+ | * //(Opcional)// No debe mezclar instrucciones **DDL** y **DML** en un mismo proceso. Es responsabilidad del desarrollador evaluar ese impacto. | ||