Listar plugins de community plugins en resources plugins

[gdtel-cnig-develop]

La idea es que cuando se llame al servicio https://componentes-desarrollo.idee.es/api-idee/api/actions/resourcesPlugins se listen también los plugins que están en community plugins.

Se pone en un comentario el resultado del análisis realizados previo a esta implementación.

Issue: #799

PR: #800

Rama: https://github.com/guadaltel/API-IDEE/tree/feat_799_resouces_external

Pruebas: https://componentes-desarrollo.idee.es/api-idee/api/actions/resourcesPlugins
https://componentes-desarrollo.idee.es/api-idee/api/actions/resourcesPlugins
https://componentes-desarrollo.idee.es/api-idee/api/actions/resourcesPlugins?name=mousesrs
https://componentes-desarrollo.idee.es/api-idee/api/actions/resourcesPlugins?name=mousesrs&version=1.1.0
https://componentes-desarrollo.idee.es/api-idee/api/actions/resourcesPlugins?name=mousesrs&version=1.1.0&type=js
https://componentes-desarrollo.idee.es/api-idee/api/actions/resourcesPlugins?name=archetype
https://componentes-desarrollo.idee.es/api-idee/api/actions/resourcesPlugins?name=archetype&version=1.0.0
https://componentes-desarrollo.idee.es/api-idee/api/actions/resourcesPlugins?name=archetype&version=1.0.0&type=js

Changelog: se implementa la funcionalidad de listar los plugins de Community Plugins al llamar al servicio https://componentes.idee.es/api-idee/api/actions/resourcesPlugins

Wiki:

[gdtel-cnig-develop]

Análisis

Partimos del recurso "resourcesPlugins" disponible en el CORE de API-IDEE: https://componentes-desarrollo.idee.es/api-idee/api/actions/resourcesPlugins
Este recurso devuelve el listado de plugins disponibles en API IDEE, consiste en un array de objetos con la siguiente estructura:

{
	"name": "backimglayer",
	"resources": [
		{
			"css": "https://componentes-desarrollo.idee.es/api-idee/plugins/backimglayer/backimglayer-1.0.1.ol.min.css",
			"js": "https://componentes-desarrollo.idee.es/api-idee/plugins/backimglayer/backimglayer-1.0.1.ol.min.js",
			"api-idee": "1.1.0"
		},
		{
			"css": "https://componentes-desarrollo.idee.es/api-idee/plugins/backimglayer/backimglayer-1.0.0.ol.min.css",
			"js": "https://componentes-desarrollo.idee.es/api-idee/plugins/backimglayer/backimglayer-1.0.0.ol.min.js",
			"api-idee": "1.0.0"
		},
		{
			"css": "https://componentes-desarrollo.idee.es/api-idee/plugins/backimglayer/backimglayer.ol.min.css",
			"js": "https://componentes-desarrollo.idee.es/api-idee/plugins/backimglayer/backimglayer.ol.min.js",
			"api-idee": "latest"
		}
	]
}

En la que se indica el nombre del plugin y los recursos disponibles.
Los recursos se dividen por tantos objetos como versión del plugin compatible hay compatible con las versiones del CORE.
Se dispone de la versión latest del CORE en la que se deben enlazar con los recursos sin versión del plugin.
Además, por cada versión disponible del CORE se debe indicar la versión compatible del plugin.

Esta información le sirve al usuario para consultar qué versión del plugin debe importar según la versión del CORE.

El servicio dispone de varios filtros:

• Por nombre del plugin: https://componentes-desarrollo.idee.es/api-idee/api/actions/resourcesPlugins?name=mousesrs
  -- Muestra la información del plugin especificado
• Por versión el CORE: https://componentes-desarrollo.idee.es/api-idee/api/actions/resourcesPlugins?version=1.1.0
  -- Muestra la información de los plugins disponibles en la versión especificada
• Por nombre y versión: https://componentes-desarrollo.idee.es/api-idee/api/actions/resourcesPlugins?name=mousesrs&version=1.1.0
  -- Muestra la información del plugin especificado en la versión del CORE especificada
• Por nombre, versión y tipo: https://componentes-desarrollo.idee.es/api-idee/api/actions/resourcesPlugins?name=mousesrs&version=1.1.0&type=js
  -- Muestra la información del plugin especificado en la versión del CORE especificada mostrando solo el recurso del tipo especificado
• NO permite el filtrado de recursos por tipo sin estar acompañado de name y version

La información que se muestra se actualiza de forma manual y está disponible en: https://github.com/Desarrollos-IDEE/API-IDEE/blob/develop/api-idee-rest/src/main/resources/properties/resourcesPlugins.json
y el proceso de mostrar la información y aplicar filtros si lo necesita se encuentra en:

API-IDEE/api-idee-rest/src/main/java/es/api_idee/api/ActionsWS.java

Line 339 in 10492b0

public Response getResourcesPlugins(

Los plugins internos hacen referencia resourcesPlugins filtrando por nombre del plugin.

• Los plugins externos actualmente no disponen de resourcesPlugins

Acciones a realizar

• Opción 1: añadir manualmente a https://github.com/Desarrollos-IDEE/API-IDEE/blob/develop/api-idee-rest/src/main/resources/properties/resourcesPlugins.json los plugins externos
  -- Ventaja: más rápido
  -- Inconveniente: más difícil de mantener para otras copias de API-IDEE.

• Opción 2 (*): disponer de otro fichero "resourcesPlugins.json" en https://github.com/Desarrollos-IDEE/API-IDEE_CommunityPlugins/blob/develop/data/
  -- Este fichero se podrá consultar desde el despliegue de API-IDEE pero no realizar filtrados ya que implicaría un desarrollo más completo, sería como consultar https://componentes.idee.es/api-idee-communityplugins/data/plugins.json
  -- En el CORE, en concreto

  API-IDEE/api-idee-rest/src/main/java/es/api_idee/api/ActionsWS.java

  Line 350 in 10492b0

  JSONArray arrayResults = new JSONArray();

  
  ya se dispone del contenido en formato JSON del fichero https://github.com/Desarrollos-IDEE/API-IDEE/blob/develop/api-idee-rest/src/main/resources/properties/resourcesPlugins.json.
  En ese momento se debe realizar una petición al fichero https://github.com/Desarrollos-IDEE/API-IDEE_CommunityPlugins/blob/develop/data/resourcesPlugins.json y unificar la información (es parecido a lo que se hace en la unión del community plugins JDA y CNIG)
  -- Hay que tener en cuenta que el resultado se debe mostrar de forma ordenada alfabéticamente
  -- Los filtros se deben aplicar tanto a los externos como internos en el despliegue de api-idee
  -- Los externos deben apuntar a la URL del despliegue de community plugins

• Los plugins externos también deben hacer referencia en la wiki a resourcesPlugins (hay que tener en cuenta tanto los del CNIG como los de JDA)

Dudas:

• ¿Los plugins obsoletos deben desaparecer por completo de resourcesPlugins o quedarse en la última versión disponible? Actualmente no están.
• En caso afirmativo, en API IDEE existen más de 20 plugins marcados como obsoletos ¿los tendríamos que añadir? Son plugins que se almacenaron por tener una copia de los disponibles de API-CORE pero
  no sé hasta que punto podrían dejar de ser compatibles con al menos la versión 1.0.0.
  -- Obsoletos desde ahora.
• En caso afirmativo, también surge la duda si mantener la versión latest en los obsoletos. Se mantiene
• ¿https://github.com/Desarrollos-IDEE/API-IDEE_CommunityPlugins/blob/develop/data/resourcesPlugins.json tendrán siempre la url de producción? sí

[jjsalcedo2025]

JdA - OK

[aelopy]

IGN/CNIG - OK