Esta página es de solo lectura. Puedes ver la fuente pero no puedes cambiarla. Pregunta a tu administrador si crees que esto es incorrecto.

<h1>ENTORNO DE DESARROLLO</h1> <div class="level1"> <p> Al ser un proyecto MAVEN, no requiere un IDE en específico, sin embargo esta es la configuración usada: </p> <ul> <li class="level1"> JDK 7 o mayor</li> <li class="level2"> IDE:<a href="https://projects.eclipse.org/releases/luna" class="urlextern" title="https://projects.eclipse.org/releases/luna" rel="nofollow">Eclipse Luna</a></li> <li class="level2 node"> Marketplace:<ul> <li class="level3"> Spring Tools</li> </ul> </li> <li class="level2"> Maven 3.0 o mayor</li> </ul> </div> <h1>Configuración del proyecto</h1> <div class="level1"> </div> <h2>Apache maven</h2> <div class="level2"> <p> El proyecto requiere de maven 3 para su configuración, si está instalando Maven a través de los repositorios de las distribuciones linux, asegurese que la versión es igual o mayor a la 3, en caso de que no, puede descargarlo de <a href="http://maven.apache.org/download.cgi" class="urlextern" title="http://maven.apache.org/download.cgi" rel="nofollow">maven.apache.org/download.cgi</a>, e instalarlo simplemente descomprimiendo el archivo descargado. </p> <p> Si existe alguna otra instalación de Maven, asegúrese de modificar el path de ejecución del sistema para que utilice la instalación que descargó del sitio maven, para verificar la versión utilice el comando <b>mvn –version</b> . </p> </div> <h2>Git</h2> <div class="level2"> <p> Git es el sistema de control de versiones, para descargar el proyecto siga los siguientes pasos </p> <ol> <li class="level1"> Cree una llave rsa pública y envíela al administrador del sistema Git para que la registre como permitida. Una guía la encuentra en <a href="https://help.github.com/articles/generating-ssh-keys/" class="urlextern" title="https://help.github.com/articles/generating-ssh-keys/" rel="nofollow">help.github.com/articles/generating-ssh-keys/</a></li> <li class="level2"> Ubíquese en el directorio donde desea descargar el proyecto y clónelo utilizando el siguiente comando: <b>git clone git@190.27.194.177:/home/git/SIGECA</b>, esto creará un subdirectorio SIGECA con las fuentes del proyecto, incluyendo un proyecto preconfigurado para eclipse.</li> <li class="level2"> Cuando realice cambios al proyecto, utilice los comandos git commit y git push para actualizar los cambios en GIT</li> </ol> </div> <h2>Eclipse</h2> <div class="level2"> <p> El IDE de desarrollo recomendado es Eclipse Luna for Java EE developers o una versión superior, se recomienda instalar la versión que se descarga de <a href="https://eclipse.org/downloads/packages/eclipse-ide-java-ee-developers/lunasr1" class="urlextern" title="https://eclipse.org/downloads/packages/eclipse-ide-java-ee-developers/lunasr1" rel="nofollow">eclipse.org/downloads/packages/eclipse-ide-java-ee-developers/lunasr1</a> </p> <p> Adicionalmente se recomienda instalar el conjunto de herramientas de desarrollo de Spring, para ello, una vez instalado Eclipse, ejecutelo y acceda a Eclipse <a href="/cnscwiki/doku.php?id=ea:tobe:aplicaciones:sigeca:implementacion:marketplace" class="wikilink2" title="ea:tobe:aplicaciones:sigeca:implementacion:marketplace" rel="nofollow">MarketPlace</a> en el menú Help, allí busque el plugin Spring Tool Suite e instale la versión 4.4 o una más reciente que sea adecuada para su versión de Eclipse </p> <p> <a href="/cnscwiki/lib/exe/detail.php?id=ea%3Atobe%3Aaplicaciones%3Asigeca%3Aimplementacion%3Aide&media=ea:tobe:aplicaciones:sigeca:implementacion:sts.png" class="media" title="ea:tobe:aplicaciones:sigeca:implementacion:sts.png"><img src="/cnscwiki/lib/exe/fetch.php?media=ea:tobe:aplicaciones:sigeca:implementacion:sts.png" class="media" alt="" /></a> </p> <p> Adicionalmente, si queremos controlar el proyecto maven desde Eclipse, debemos tener el plugin Maven Integration for Eclipse, aunque es muy posible que este plugin ya venga instalado con Eclipse por defecto, si no es así, instale el plugin desde Eclipse <a href="/cnscwiki/doku.php?id=ea:tobe:aplicaciones:sigeca:implementacion:marketplace" class="wikilink2" title="ea:tobe:aplicaciones:sigeca:implementacion:marketplace" rel="nofollow">MarketPlace</a> de manera similar al anterior </p> <p> <a href="/cnscwiki/lib/exe/detail.php?id=ea%3Atobe%3Aaplicaciones%3Asigeca%3Aimplementacion%3Aide&media=ea:tobe:aplicaciones:sigeca:implementacion:m2e.png" class="media" title="ea:tobe:aplicaciones:sigeca:implementacion:m2e.png"><img src="/cnscwiki/lib/exe/fetch.php?w=1366&h=768&tok=dcb0a3&media=ea:tobe:aplicaciones:sigeca:implementacion:m2e.png" class="media" alt="" width="1366" height="768" /></a> </p> </div> <h2>PostgreSQL</h2> <div class="level2"> <p> El motor de base de datos a utilizar en el proyecto es <a href="/cnscwiki/doku.php?id=ea:tobe:aplicaciones:sigeca:implementacion:postgresql" class="wikilink2" title="ea:tobe:aplicaciones:sigeca:implementacion:postgresql" rel="nofollow">PostgreSQL</a> versión 9 o mayor. Esta versión es fácilmente instalable, utilizando los repositorios de las distribuciones Linux o descargando los instaladores directamente del sitio <a href="http://www.postgresql.org/" class="urlextern" title="http://www.postgresql.org/" rel="nofollow">www.postgresql.org/</a>. </p> <p> Se recomienda crear una base de datos y un usuario de postgres específicos para el proyecto, el código contenido en el repositorio está configurado para utilizar un usuario con nombre <b>sigeca</b>, con password idéntico y dueño de una base de datos también llamada <b>sigeca.</b> Para crear estos artefactos puede ejecutar los siguientes comandos desde el usuario <b>postgres</b> del sistema operativo (En Linux). </p> <p> <b>createuser -P sigeca</b> Este comando creará el usuario <b>sigeca</b> y preguntará por su password </p> <p> <b>createdb sigeca -O sigeca</b> </p> <p> Este comando creará la base de datos <b>sigeca </b> y le asignará como dueño el usuario <b>sigeca </b> recién creado. </p> <p> Recuerde que para poder acceder a esta base de datos desde el servidor que ejecuta el código del proyecto se recomienda otorgar permisos de acceso por red en el archivo <b>pg_hba.conf</b> a la dirección ip del computador que ejecuta el servidor Tomcat con la aplicación. </p> <p> Si desea utilizar otros parámetros de configuración, debe alterar el archivo <b>src/main/resources/application.properties</b> para reflejar la configuración deseada. </p> </div> <h2>Compilación</h2> <div class="level2"> <p> Para compilar el proyecto desde Eclipse, seleccione la raíz del proyecto, de click derecho y aplique la opción <b>Maven Update Project</b>, esta opción actualizará las dependencias Maven del proyecto y luego lanzará un proceso de construcción que debe concluir con la compilación exitosa del proyecto. </p> <p> Es posible que encuentre algunos errores en archivos XSL o Javascript, estos errores pueden ser ignorados puesto que son utilitarios del Framework de interfaz gráfica DOJO y no deben afectar la ejecución de la aplicación. </p> </div> <h2>Ejecución</h2> <div class="level2"> <p> El proyecto está construido con base en el framework Spring Boot, este framework, permite el desarrollo rápido de aplicaciones sin necesidad de realizar actividades de despliegue en servidores de aplicaciones o contenedores Web. </p> <p> Esto se debe a que el framework contiene un servidor Apache Tomcat embebido y liviano que es levantado cada vez que se ejecuta la aplicación. Para ejecutar entonces la aplicación utilice el comando </p> <p> <b>mvn spring-boot:run <br/> </b> </p> <p> Este comando se encarga de realizar todas las configuraciones necesarias, levantar el servidor y desplegar en este la aplicación, tenga en cuenta que el servidor embebido se ejecuta por defecto en el puerto <b>8080</b> por tanto debe tener cuidado con que no haya otro servidor Apache Tomcat ejecutándose o algún otro programa ocupando este puerto. </p> <p> Por último, el proyecto esta configurado para que autogenere las tablas necesarias en base de datos, de esta forma es posible mantener actualizada la base de datos a partir del código, si bien <b>Hibernate</b> intentará actualizar las tablas inteligentemente, no es posible garantizar que el proceso este libre de errores completamente, en tal caso debe eliminar la base de datos y volverla a crear o corregir los errores manualmente. </p> <p> Por último, este comando es posible ejecutarlo desde Eclipse, si instaló las herramientas Spring para Eclipse (Spring Tool Suite), puede utilizar el menú <b>run as –> Spring Boot App</b>, que se puede acceder haciendo click derecho sobre algún artefacto del proyecto o desde la raíz. </p> </div>