Skip to content

Tutorial desarrollo del núcleo de API IDEE (Servidor)

Álvaro Ramírez edited this page Jan 23, 2025 · 1 revision

** ! Página en desarrollo**

En esta página vamos a guiar paso por paso cómo comenzar con el desarrollo de la parte servidor de API-IDEE

1./ Creamos un "fork" o bifurcación del repositorio de API-IDEE a nuestro GitHub personal desde: https://github.com/Desarrollos-IDEE/API-IDEE/fork . Si se van a hacer desarrollos de forma activa, es recomendable no marcar la opción de copiar sólo la rama máster. Con este paso, tendremos una copia del repositorio de API-IDEE donde podremos desarrollar.

2./ Realizamos un "clone" del repositorio en la máquina donde se vaya a desarrollar:

    cd {ruta de la carpeta donde se quiera hacer el clone}
    git clone https://github.com/{nuestro_repositorio}/API-IDEE.git

3./ Vamos a la carpeta del proyecto y nos cambiamos a la rama "develop":

    cd API-IDEE
    git checkout develop
    git pull

4./ Una vez descargado el repo y estando posicionados en "develop", creamos una rama de trabajo y nos posicionamos en ella, en este caso la vamos a llamar "prueba":

    git checkout -b prueba

5./ Abrimos eclipse en un nuevo proyecto. Desde file -> Import -> Maven -> Existing Maven Projects -> Next -> y seleccionamos la carpeta api-idee-parent -> seleccionamos todas las carpetas del proyecto -> finish. Esperamos a que se carguen todas las dependencias.

6./ Una vez importadas todas las dependencias: en la pestaña de servers -> create new server -> Apache -> tomcat -> next -> añadimos api-idee-rest -> finish. Al desplegar el servidor, debe aparecer api-idee-rest, y al desplegarlo, api-idee-proxy y api-idee-database

7./ Botón derecho sobre el servidor tomcat -> start

8./ Al abrir un navegador en la dirección : http://localhost:8080/api-idee/api/actions/version , por ejemplo, debemos ver la versión en la que estamos desarrollando

9./ Una vez realizado el desarrollo, subimos el código a nuestro repositorio. Desde este enlace: https://git-scm.com/docs se puede obtener documentación sobre Git y sus comandos.

    cd ../ # volvemos a la carpeta API-IDEE
    git add ./{ruta del archivo que se ha modificado}
    git commit -m "{comentario descriptivo del desarrollo realizado}"
    git push

10./ Ya subido el código a nuestro repositorio, realizamos un Pull Request para integrar estos desarrollos al repositorio de API-IDEE. Para ello, en la parte de la izquierda seleccionaremos nuestro repositorio y la rama "prueba" y a la izquierda el repositorio de API-IDEE y la rama "develop"

11./ En este punto, el equipo de desarrollo de API-IDEE hará el control de calidad y las pruebas necesarias para validar la incorporación del nuevo código al repositorio y poder ser utilizado por al comunidad en próximas versiones de API-IDEE

1.INICIO
   1.1. Componentes de la API-IDEE
   1.2. Documentación y Puntos de acceso
   1.3. Primeros pasos
   1.4. Diagrama API IDEE

2. MAPA
2.1. Capas

 ■ 2.1.1. Fuentes
   • 2.1.1.1. Capas vectoriales
     + Vector
     + WFS
     + GeoJSON
     + KML
     + MVT
     + OGCAPIFeatures
     + MBTilesVector
     + GenericVector
     + MapLibre
   • 2.1.1.2. Capas ráster
     + WMS
     + WMC
     + WMTS
     + TMS
     + XYZ
     + OSM
     + MBTiles
     + GenericRaster
     + GeoTIFF
     + GeoPackageTile
   • 2.1.1.3. Capas 3D
     + Terreno
     + 3DTiles
       + info 3DTiles
   • 2.1.1.4. Capas rápidas
   • 2.1.1.5. Grupo de capas
   • 2.1.1.6. Secciones
   • 2.1.1.7. GeoPackage
   • 2.1.1.8. Capas externas

 ■ 2.1.2. Simbolización
   • 2.1.2.1. Genérica
     + Puntos
     + Líneas
     + Polígonos
   • 2.1.2.2. Básica
     + Puntos
     + Líneas
     + Polígonos
   • 2.1.2.3. Avanzada
     + Coropletas
     + Proporcional
     + Categorías
     + Estadísticos
     + Mapas de Calor
     + Cluster
     + Línea de flujo
     + Composición

 ■ 2.1.3. Filtros

2.3.-Plugins

  > Creación de plugin en cliente

  » Tutorial de creación de un plugin

2.4. Paneles

  » Creación de panel desde cero sin controles

  » Tutorial Panel de un único control

  » Tutorial Panel de un único control con más de un botón

  » Tutorial Panel con más de un control

2.5. Eventos

  » Gestión de eventos
  » Gestión de eventos en controles personalizados

    2.6. Internacionalización

    2.7. Configuración

    2.8. Acceso librerías base

3. UTILIDADES

4. PROXY

5. API REST
 5.1. Parametrización API-REST
 5.2. Base de Datos API-REST
 5.3. API REST Actions
 5.4. Servicio de correos electrónicos
 5.5. Capas rápidas
 5.6. Parametrización API-REST plugins externos

6. PARAMETRIZACIÓN VISUALIZADORES

7. SOLUCIÓN DE PROBLEMAS

8. PROCESO DE VERSIONADO

9. GUÍA DE DESARROLLO
  > Guía para colaborar en el repositorio
  > Guía para el desarrollo de API-IDEE
  > Guía de test de API-IDEE
  » Tutorial desarrollo del núcleo de API-IDEE - (Cliente)
  > Guía de desarrollo de componentes
  » Tutorial desarrollo del núcleo de API-IDEE - (Servidor)
  > Guía de desarrollo de plugins
  » Tutorial desarrollo de plugins ya creados
  » Tutorial desarrollo de nuevos plugins
  > Guía de desarrollo de visualizadores con React

  > Compilación proyecto API-IDEE

Clone this wiki locally