Web services gestionados por el API manager de Sofia2

2-info-basica

Se ha incluido en el API manager y la consola de Sofia2 la posibilidad de gestionar web services utilizando un API rest y datos en formato JSON en lugar de XML.

Para disponibilizar de esta manera en el API manager un web service tendremos que seleccionar la casilla ‘web service’ cuando estemos creando un API nuevo. Esto cambiará el comportamiento del formulario en cierta manera, pidiendonos la URL donde encontrar la definición del web service a configurar (es decir, la dirección del fichero WSDL). Además no nos permitirá crear operaciones a mano, sino que nos dará la opción de reconocer el WSDL y generar las operaciones de forma automática:

2-info-basica

Después de crear un API, los detalles de cada operación ofrecerán un template del contenido JSON requerido por la operación.

Ciertas operaciones sobre el API no estarán disponibles, como por ejemplo editar el fichero WSDL o cambiar las operaciones. En caso de que algo cambie, se deberá provisionar otra versión del web service.

4-api-creada.jpg

Una vez provisionada, podrán hacerse consultar a través del API manager de Sofia2 usando el interfaz rest, tomando como URL base la que se ofrece bajo el nombre ‘Endpoint base’, por ejemplo: http://sofia2.com:8093/sib-api/api/ws/v1/demo-ws.

Nótese que los web service disponibilizados en el api manager tienen el prefijo ‘ws’, permitiendo saber con la url que tipo de servicio se está invocando.

Web services gestionados por el API manager de Sofia2

Data Model GSMA en Sofia2

1

Se ha disponibilizado en Sofia2 la documentación que define el soporte y funcionamiento de los Data Model GSMA en la plataforma Sofia2.

La asociación GSMA (asociación de operadores móviles) está trabajando en un IoT Big Data Harmonised Data Model. Por otro lado en la iniciativa FIWARE se han inspirado en el Data Model GSMA para crear los FIWARE Data Models.

Los Data Models GSMA (también llamados FIWARE DataModel) se definen en JSON, por lo que su representación como Ontología Sofia2 es inmediata. Para ello, haremos uso de las plantillas predefinidas en Sofia2 que soportan los anteriores modelos:

plantillas

En la documentación, que te puedes descargar aquí, o puedes consultar en versión web aquí, encontrarás cómo se definen los modelos de datos en Sofia2 para soportar los Data Models GSMA, ejemplos de uso, y un completo “Hands On” que abarca la creación de Ontologías, carga de datos mediante CRUD de Instancias, consulta de datos con la Consola BDTR y BDH, y cómo publicar Ontologías como API RESTFUL.

Data Model GSMA en Sofia2

Api .NET Updated

Sofia2 Api .Net  has been updated.

 

News in this new version are listed bellow:

  • Adapted to recently improvements added in SSAP protocol. You can see the improvements in this post SSAP Protocol Improved.
  • Bidirectional protocolo WebSockets added.
  • Test suites updated with usage samples of almost every possible query on Sofia2.
    • Rest TestSuite here.
    • WebSockets TestSuite here.
    • All tests are configured to work with Sofia2 sample data. It’s easy to run them and see how it works.

 

You can get Sofia2 Api .NET from two sources:

  1. Sofia2 Github page. https://github.com/Sofia2/dotnet-api.
  2. Developers download zone in sofia2.com  http://sofia2.com/desarrollador.html#descargas.

 

Api .NET Updated

Actualización Api .NET

Se ha actualizado el Api .NET de Sofia2

 

Las novedades introducidas son las siguientes:

  • Adaptación a las mejoras realizadas recientemente en protocolo SSAP. Puedes ver las mejoras en el siguiente POST Mejoras en protocolo SSAP.
  • Inclusión de WebSockes como protocolo bidireccional de comunicación.
  • Actualización de Test Suite con ejemplos de uso de cada posible consulta.
    • Test suite para REST aquí .
    • Test suite para WebSocket aquí.
    • Los tests están configurados para funcionar directamente contra los datos de prueba de Sofia2. Son muy fáciles de  ejecutar y ver cómo funciona.

Puedes conseguir el API .NET de Sofia2 desde dos fuentes:

 

Actualización Api .NET

Cómo trabajar con Data Model FIWARE/GSMA en Sofia2

La asociación GSMA (asociación de operadores móviles está trabajando en un IoT Big Data Harmonised Data Model

Que define estas entidades: AgriCrop, AgriGreenHouse, AgriParcel, AgriParcelOperation, AgriParcelRecord, AgriPest, AgriProduct, AgriProductType, AgriSoil, AirQualityObserved, Building, BuildingOperation, BuildingType, Device, DeviceModel, DeviceOperation, EnvironmentObserved, Machine, MachineModel, MachineOperation, PointOfInterest, Road, RoadSegment, Subscriber, SubscriptionService,Vehicle, VehicleFault, VehicleType, WaterQualityObserved, WeatherForecast y WeatherObserved.

Por otro lado en la iniciativa FIWAREse han inspirado en el Data Model GSMA para crear los FIWARE Data Models, donde además se han seleccionado un conjunto de Entidades sobre estas de GSMA:

  • Alarms Events related to risk or warning conditions which require action taking.
  • Parks & Gardens Data models intended to make an efficient, effective and sustainable management of green areas.
  • Environment Enable to monitor air quality and other environmental conditions for a healthier living.
  • Point of Interest Specific point locations that someone may find useful or interesting. For instance, weather stations, touristic landmarks, etc.
  • Civic Issue tracking Data models for civic issue tracking interoperable with the de-facto standard Open311.
  • Street Lighting Modeling street lights and all their controlling equipment towards energy-efficient and effective urban illuminance.
  • Device IoT devices (sensors, actuators, wearables, etc.) with their characteristics and dynamic status.
  • Transportation Transportation data models for smart mobility and efficient management of municipal services.
  • Indicators Key performance indicators intended to measure the success of an organization or of a particular activity in which it engages.
  • Waste Management Enable efficient, recycling friendly, municipal or industrial waste management using containers, litters, etc.
  • Parking Real time and static parking data (on street and off street) interoperable with the EU standard DATEX II.
  • Weather Weather observed, weather forecasted or warnings about potential extreme weather conditions.

Los Data Models GSMA y FIWARE se definen en JSON por lo que su representación como Ontología Sofia2 es inmediata (recomendamos al respecto leer el documento Gobierno de Ontologías o el conjunto de posts al respecto).

En Sofia2 se soportan ya estas entidades vía Plantillas (una plantilla sirve para crear ontologías partiendo de una definición):

A continuación veremos cómo Sofia2 permite trabajar con estas entidades, pongamos el ejemplo de la entidad WeatherObserved (This entity contains a harmonised description of the weather at a particular location and time. This entity is primarily associated with the vertical segments of the environment and agriculture but is applicable to many different applications):

Seguir leyendo “Cómo trabajar con Data Model FIWARE/GSMA en Sofia2”

Cómo trabajar con Data Model FIWARE/GSMA en Sofia2

Versiones de Sofia2 IoT Platform

En Sofia2 hablamos de 3 versiones de la Plataforma: Base Edition, IoT Edition y Advanced Analytics Edition, cada una de ellas incluye un conjunto de módulos:

-Adecuado para desarrollo ágil de aplicaciones que pueden incluir captación de información sensórica .

-Gestión del modelo de datos a través de UI unificada.

-Acceso CRUD automático a las entidades

-Definición de reglas de negocio desacopladas de forma sencilla y asistida.

-Simplifica las integraciones.

-Diseñada para flujos IoT: sistemas que gestionan grandes volúmenes de información producidos en poco tiempo.

-Sistemas con gran componente sensórica

-El ser humano como sensor: RRSS

-Sistemas altamente complejos: Smart Cities

Ampliamos el Internet of Things hacia el Analytics of Things sobre el gran volumen de datos generado:

-Integración con herramientas BI, reporting, visualización

-Gestión completa del ciclo de vida de modelos analíticos.

-Ingesta masiva de datos

Seguir leyendo “Versiones de Sofia2 IoT Platform”

Versiones de Sofia2 IoT Platform

API Manager: Clonado de APIs

En la última release de Sofia2 (2.23) se ha incorporado una nueva funcionalidad a la hora de gestionar los APIs para simplificar la creación de nuevas versiones: Clonar APIs.

Se seleccionará un API creado previamente y, tras acceder a la pantalla de consulta del mismo, se encontrará disponible la opción de clonarlo. El estado del API original es indiferente.

Tras pulsar sobre el botón clonar se generará una nueva versión del API (correlativa a la última versión existente) con todas sus propiedades y operaciones idénticas a la del original. El estado del nuevo API será Creado, para permitir introducir modificaciones y adecuarlo a las necesidades requeridas.

API Manager: Clonado de APIs