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

SSAP Protocol Improved

5

Introduction

In this post we present a new version of Sofia 2 SSAP interoperability protocol, what advantages brings and how to start using it. We also show how Sofia 2 keeps the compatibility with former versions in order to keep current clients working without any modification needed.

The main news are listed below:

  1. JSON navigation improvement. Thanks of changes in datatypes of two attributes in JSON Schema, usability and navigation of JSON strings have been improved. This fact makes easier integration with any JSON Libray of any programming language.
  2. Attribute version added. Tells the SSAP version of the current message, it’s also used to tell Sofia 2 the required version for response messages. The available versions are:
    1. LEGACY: SSAP reference until now
    2. ONE: New reference
  3. Attribute @type added. Tells the operation type stored in body attribute.

Seguir leyendo “SSAP Protocol Improved”

SSAP Protocol Improved

Mejoras en el soporte de almacenamiento de binarios

Con la última versión de la plataforma Sofia2, ha llegado la posibilidad de operar con archivos binarios fuera de una ontología, esto permite el envío de binarios con un tamaño mayor al soportado por el tipo de dato Binary.

2015-06-17_17-31-41Como se expone en el gráfico anterior esta nueva funcionalidad consta de los siguientes módulos.

  • APIClient cliente Java que facilita la operatividad de upload, update, delete y recuperación de los binarios depositados en la plataforma.
  • Service exposición de un Servicio REST para subir ficheros a la plataforma.
  • Imeplentaciones Plugables a traves de las extensiones en modo Plugin podemos añadir nuevas implementaciones para el almacenamiento de los binarios, Actualmente se dispone de dos. Almacenamiento en la base de datos de tiempo Real (BDTR) y en sistema de ficheros (File).

El Servicio REST que expone el SIB soporta la subida de binarios a través de multipart, lo que permite adjuntar binarios sin límite de tamaño, la plataforma permite a través de su parametrización configurar el tamaño máximo de los binarios añadidos.2015-06-17_17-38-15

Los métodos que expone el servicio son.

  • Post. Para añadir un nuevo binario en la plataforma, en la respuesta del servicio se nos indicará el ID del Binario que debemos usar en las siguientes operaciones.

2015-06-17_17-42-07

  • Put. Para modificar un binario ya gestionado por la plataforma.

2015-06-17_17-44-26

  • Delete. Nos permite dar de baja un recurso gestionado por la plataforma (Será una baja lógica)

2015-06-17_17-45-17

  • Get. Podremos recuperar el Binario gestionado por la plataforma.

2015-06-17_17-46-25

Podemos observar que en todas operaciones se nos solicita un SessionId que obtendremos a través de un Join previo en la plataforma, para obtener un SessionId válido deberemos solicitar al administrador de la plataforma que nos otorgue permisos a alguno de nuestro Kp para usar BinaryRepository y con el nivel de actuación que deseemos Consultas, Inserciones o Completo.

En función del tipo de permiso podremos realizar todas las operaciones expuestas por el Servicio o solo aquellas para las que estemos autorizados.

Mejoras en el soporte de almacenamiento de binarios

API .NET Sofia2

En la release 2.20 de SOFIA2 se ha incluido el nuevo API .NET que implementa el protocolo SSAP sobre el protocolo REST.

Este API se ha desarrollado con .Net Framework 4.5, por lo que puede ser incluido en desarrollos basados en .Net Framework 4.5 o superior.

El paquete de instalación se encuentra en el siguiente enlace:

http://sofia2.org/apis/SOFIA2_API_NET/SOFIA2_APINET.zip

Una vez descargado, la estructura del paquete es la siguiente:

Donde podemos encontrar:

· Las librerías del API en la carpeta lib,

· Un proyecto de prueba con tests implementados para las distintas operaciones soportadas por el API.

Este proyecto de test muestra las mejores prácticas en el uso del API y claros ejemplos de la invocación de cada operación.

De esta manera, desarrollar un cliente SSAP .NET, será tan fácil como incorporar el API en nuestro proyecto, y personalizar el método de invocación a partir del código encontrado en el proyecto de prueba.

API .NET Sofia2