Procesamiento por lotes en SAP Business One Service Layer

Decía en una entrada anterior que el formador pasó por el procesamiento por lotes de puntillas, en plan «existe, pero es terriblemente complicado». Me he leído varias veces la documentación al respecto y sigo sin entender cómo montar el payload de una petición de procesamiento por lotes.

Pero con el cliente OData es otro cantar. Es tan simple como esto:

For Each Documento In Documentos
    oDocumentoSAP = New Document
    Documento.RellenarDocumento(oDocumentoSAP)
    Context.AddDocument(oDocumentoSAP, Documento.DocType)
Next
Dim responses = Await Context.SaveChangesAsync(options:=SaveChangesOptions.BatchWithSingleChangeset)

Hay dos opciones a indicar en el SaveChanges:

  • BatchWithIndependentOperations procesaría las operaciones de forma secuencial e independiente. Si se produce un error se para, pero todo lo que se haya creado o modificado antes queda hecho.
  • BatchWithSingleChangeset mete todo en una única transacción, como ocurría en Di Server. Si falla uno, falla todo.

La limitación con respecto a Di Server es que allí podíamos incluir cierres y cancelaciones dentro del lote de operaciones y aquí, no, al no ser operaciones propias de OData sino funciones específicas.

Scripts en SAP Business One Service Layer III — Consumirlo desde .Net

Esta pequeña serie sobre scripts en Service Layer consta de tres partes:

La parte realmente difícil de todo el tema de los scripts ha sido combinarlo con el cliente OData. Confieso que, entre unas cosas y otras, se me fueron 50 horas de trabajo hasta conseguir algo funcional. La documentación de Microsoft de un tiempo a esta parte no es ninguna maravilla y con OData es especialmente parca. Intentar salirme de lo básico me ha dado muchos dolores de cabeza.

Resumiendo, que tampoco quiero aburrir, mi idea original era utilizar el context y las entidades ya creadas y hacer algo como:

Dim cosa As New BodyOperationParameter("Recibo", oRecibo)
Dim cosa2 As New BodyOperationParameter("Emision", oEmision)
Dim responses = context.Execute(url, "POST", {cosa, cosa2})

Sigue leyendo

Scripts en SAP Business One Service Layer II — El script

Esta pequeña serie sobre scripts en Service Layer consta de tres partes:

Como dije en la anterior entrada, mi primer script iba a ser de una operación sencilla: crear dos documentos, un recibo de producción y su emisión de componentes correspondiente, en una transacción.

Como siempre, nuestro punto de partida es el manual de Service Layer que tenemos en nuestro servidor (https://<miservidor>:50000/Working_with_SAP_Business_One_Service_Layer.pdf) y que también podemos consultar aquí. Todo el apartado 3.20 está dedicado a esto. El código de ejemplo que trae lo tenemos también en la carpeta de instalación de Service Layer y es un buen punto de partida.

Sigue leyendo

Scripts en SAP Business One Service Layer I — Preparando el entorno

Esta pequeña serie sobre scripts en Service Layer consta de tres partes:

Una vez montado el cliente OData de Service Layer, realizar las operaciones individuales que hasta ahora hacía por B1WS, como, no sé, hacer traslados, crear y modificar ofertas y pedidos, crear y modificar UDOs varios, ha sido sencillo. Otra cosa muy distinta son las operaciones complejas que encapsulo en una transacción por Di Server, algo que no permite B1WS.

En Service Layer tenemos dos opciones para atacar este problema: uno es el procesamiento por lotes. El formador que tuvimos para Service Layer ni lo tocó por lo complicado que es preparar la petición, pero podemos hacer casi lo mismo que en Di Server. La otra es a través de su propio SDK, que nos permite hacer una suerte de addons en JavaScript que, sin ser tan potentes como lo que podemos hacer por Di Api, es, en algunos aspectos, más potente que lo que nos ofrece Di Server.

Me he lanzado a probar este extraño mundo con una operación sencilla en mente, pero que en la empresa se hace con mucha frecuencia: un recibo de producción con su emisión de componentes correspondiente.

Sigue leyendo

Eliminar líneas de un objeto con Sap Business One Service Layer

En las primeras pruebas con SAP Service Layer y su cliente OData para .Net me he encontrado con un problema que, por otra parte, me esperaba. Quiero decir que la actualización en OData se basa en enviar el conjunto de los cambios y no toda la entidad, para tener un flujo de datos lo más reducido posible. En Service Layer esto implica que si, por ejemplo, quiero actualizar un pedido de ventas, enviaré los campos de la cabecera que cambian, así como las líneas que se cambian o se añaden.

Pero, ¿y si lo que quiero es eliminar una línea? En Di Server/B1WS debíamos enviar todas las líneas, por lo que, si faltaba alguna, SAP entendía que la queríamos eliminar.

¿Es posible hacer eso en Service Layer?

Atendiendo al manual del usuario que tenemos en https://<miservidor>:50000/Working_with_SAP_Business_One_Service_Layer.pdf, no.

Sigue leyendo

Sap Business One Service Layer

Después de meses de retrasos y problemas (que si falla la controladora RAID del nuevo servidor, que si hay que esperar a un parche de SAP que se retrasa, que si pruebas por aquí y por allá), en noviembre por fin actualizamos a SAP 10. De lo más interesante de esta versión es que por fin tenemos Service Layer en la versión para SQL Server (hasta entonces, estaba sólo para Hana).

Service Layer es una nueva api de datos para que nuestras aplicaciones puedan trabajar con SAP Business One. Es una api web moderna, Restful, con protocolo OData. Por supuesto, con algunas cosillas particulares, que para algo hablamos de SAP.

Yo esperaba con muchas ganas el poder meterle mano a Service Layer. El venerable Di Server se nos ha quedado pequeño y nos da mil y un extraños problemas. No cuento con que Service Layer sea la panacea, pero se supone que debe funcionar mejor que algo marcado como obsoleto años antes de que yo empezara a usarlo. El problema, como siempre, es la formación y la documentación. O la falta de. Como es habitual, me toca buscarme las habichuelas.

Sigue leyendo

SAP Business One B1WS: editar oferta de ventas II

Hace poco tuve que modificar unos documentos de márketing (ofertas y pedidos de ventas) vía B1WS/Di Server. Hasta el momento, sólo había creado documentos de SAP y supuse que la edición seguiría el mismo proceso que con los UDO, con los que tengo bastante más manejo. Básicamente, el proceso con un UDO es:

  • Obtengo el objeto sin modificar vía B1WS.
  • Modifico los campos de la cabecera con los datos nuevos.
  • Con el array de líneas, agrego las nuevas, elimino las que hay que borrar y modifico los campos de las que hay que modificar.
  • Le vuelvo a enviar todo a SAP.

Con las líneas, que es lo que me importa aquí, el proceso es como éste, siendo Origen el objeto con los cambios que envía la capa de lógica de negocio y Destino, el objeto sin modificar recuperado de SAP. Como pueden observar, hay una propiedad en las filas origen que me indica qué debo hacer con ellas:

Sigue leyendo

SAP Business One B1WS: editar oferta de ventas

Una breve entrada sobre SAP Business One:

Intento editar una oferta de ventas vía B1WS. Al obtener la misma mediante el consabido método de GetByParams, me da error al procesar el xml. Un error de conversión de algún campo de fecha/hora. Empezamos bien.

Ataco directamente el DiServer para conseguir la oferta en bruto, en texto plano, y busco los campos fecha/hora a ver cuál es el causante. Verán, SAP B1 guarda el tiempo como entero corto, en forma HHMM: 935, 1250, 1800… que son devueltos por correctamente formateados como 9:35:00, etc. Pero hay un campo de la oferta de ventas (y del resto de documentos de márketing), UpdateTS, que guarda HHMMSS: 125015. Y me encuentro con que el DiServer lo devuelve formateado, bajo el nombre de UpdateTime de la forma 1250:15:00. Ferpecto:

El maldito


Imagino que al que hizo la función que formatea los campos de hora para los servicios del DiServer le dirían que todos iban en forma HHMM o que los campos UpdateTS de los documentos de márketing son posteriores a dicha función y nadie se acordó de cambiarla/comprobarla.

Como el campo es irrelevante en la actualización (no necesito su valor y es algo que rellena el propio SAP), la solución es simple: editar manualmente el wsdl generado, buscar el campo de marras y cambiar el tipo de time a string.

Imagino que para la 9.3 lo habrán corregido, pero en la 9.2 parche 10, así están las cosas.

2020-04-14: pues no, no lo han actualizado. Entre el parche 10 de la 9.2 y el parche 13 de la 9.3 me he encontrado con un montón de cambios en la estructura de los documentos de márketing expuestos por Di Api/Di Server, pero el maldito UpdateTime sigue dando guerra.

Eficiencia alemana (II): actualizar listas de precios en SAP B1

Problema pintoresco este que menciono. Las veces anteriores, mi compañero había actualizado los precios importando a partir de una hoja Excel desde dentro de SAP, pero, ya sea por mi poca pericia, ya por la actualización a 9.0, he sido incapaz de preparar el maldito Excel. La otra opción, que en su día se dejó por imposible, es importar a través de esa bestia del averno llamada Data Transfer. Así, preparo mi plantilla para los precios, tabla ITM1, con las columnas ItemCode, LineNum, PriceList, Price y Currency. De ellas, ItemCode es el código del artículo, PriceList es el id de la lista de precios. Añadimos el importe y la moneda (EUR) y listo… Uhm, salvo LineNum, que ponemos a 0, que es lo habitual (LineNum, como regla general, es el número de línea por código de la tabla maestra, es decir, que será 0 si sólo vamos a actualizar un precio por artículo, como era el caso).

Bien, pues eso no funciona.

Después de buscar por los foros oficiales, encuentro una respuesta ante este problema que es absurda. O, por lo menos, yo no le encuentro la lógica. Decía así: quite la columna PriceList y en LineNum ponga el id de la lista de precios menos 1.

Y funciona.

Eficiencia alemana

Con la actualización a SAP Business One 9.0 se decidió cambiar la nomenclatura de los almacenes. En la práctica, esto supuso crear almacenes nuevos y mover masimavente la mercancía en el sistema (necesario, de todas formas, para aprovechar el nuevo sistema de ubicaciones). Para evitar que los usuarios metieran accidentalmente mercancía en los almacenes viejos, se marcaron como Inactivos (un bonito check en el formulario de almacenes, que se corresponde con el campo Inactive de la tabla correspondiente). Hasta ahí, sin problemas.

Como baja colateral, el enlace entre el gestor de proyectos (desarrollo propio) y SAP dejó de funcionar. El enlace permite tanto crear artículos en SAP desde el gestor como actualizarlos después y supuso un gran ahorro de trabajo en el departamento, que hasta entonces debía copiar los datos logísticos de un nuevo producto a mano desde el gestor a SAP.

El error que da al actualizar el artículo es que hay almacenes inactivos. Guay. La cosa se pone interesante porque el código del error no aparece en la documentación (he descubierto estos meses que lo raro es que aparezca). Es más, buscando en la documentación de la DI Api (la interfaz de datos que se usa para comunicarse con SAP) el dichoso campo Inactive no aparece en el objeto Almacén.

Vale, puede ser que yo sea un cegato y venga con otro nombre (no es raro), así que me voy a la documentación de la base de datos para ver si la descripción del campo me da alguna pista sobre qué nombre buscar en la DI Api.

Y no lo encuentro. En la documentación de la base de datos de la versión 9.0 no viene, para la tabla maestra de almacenes, el campo Inactive. Por más que exista y por más que tenga un bonito check en el formulario de gestión de almacenes. Con un par.

A eso se le llama «eficiencia alemana».