SPS SAP INTERFACE

Serviço de comunicação de um servidor node com a service layer e execução de stored procedure ou execução de query através do Xsjs.

Batch

Para utilizar batch, envie a array operations com as operações a serem executadas, e a opção transaction se estas operações devem ser realizadas em uma transação.

"GET" não é suportado em transaction; retorna 500.

``javascript

const responseArray = await ServiceLayer.executeBatch({
transaction: true,
operations: [
{
method: "POST",
url: "BusinessPartners",
data: {
CardCode: "c001",
CardName: "c001",
CardType: "C"
},
{
method: "POST",
url: "Items",
data: {
ItemCode: "12345",
ItemName: "Teste item"
}
]
});

console.log(responseArray);
`
A resposta é um array contendo:

`javascript
[
{
httpCode: 204, // 400, 204, etc
httpStatus: "No Content", // "Bad Request", "Created", etc
contentId: 1, // só disponível quando usa transação, identifica cada retorno individual ### inicia em 1 ###
json: {...} // se houver retorno
},
{
httpCode: 204, // 400, 204, etc
httpStatus: "No Content", // "Bad Request", "Created", etc
contentId: 1, // só disponível quando usa transação, identifica cada retorno individual ### inicia em 1 ###
json: {...} // se houver retorno
},
...
]
`
Notas:

Quando há rollback em uma transação, somente é retornado o resultado da operação que causou o rollback. Quando não se usa transação, ou quando a transação é completa, o responseArray contém um elemento para cada operação.

A Service Layer suporta operações com e sem transação no mesmmo batch. Esta implementação somente suporta batches com todas operações em transação ou nenhuma.

O request de batch retorna 200 (Ok) mesmo que uma das operações tenha falhado; é necessário verificar o responseArray para cada httpCode individual!

DirectDb

Permite executar comandos e stored procedures diretamente no banco de dados sql e Hana;

Iniciando o serviço

Importar o módulo DirectDb e iniciar o serviço;

`javascript
const { DirectDb } = require("sps-sap-interface");

await DirectDb.init({
server: "IP:30015",
database: "SBO_DATABASE",
databaseType: DirectDb.DATABASE_TYPES.HANA,
username: "username",
password: "password",
});
`

Caso a conexão seja do tipo HANA, o valor da propriedade server deve conter a porta do servidor hana (normalmente a porta 30015) junto do nome, caso contrário, basta informar o nome ou ip do servidor.

Queries

Usar sempre o placeholder {db} nos comandos.

Exemplo:

`javascript
const response = await DirectDb.executeQuery(
SELECT TOP 10 * FROM {db}.OITM WHERE "ItmsGrpCod" > ? AND "ItemName" LIKE ?,
[1, "%A%"]
);
`
> O módulo substituirá o placeholder {db} pelo schema se for HANA e removerá se for MSSQL

ATENÇAO

* Prefira sempre usar binding de variáveis (protege contra sql injection), isto substitui a lista de parâmetros nos "?", sem precisar se preocupar com o tipo do dado.

Stored Procedures

`JAVASCRIPT
const response = await DirectDb.executeProcedure("SP_SPS_TESTSP", ["A%"]);
`

ATENÇÃO

* Nas SPs NÃO é necessário declarar o OUT REG;

Exemplo

HANA

`javascript
const { DirectDb } = require("sps-sap-interface");

await DirectDb.init({
server: "192.168.0.1:30015",
database: "SBO_DEMO_HANA",
databaseType: DirectDb.DATABASE_TYPES.HANA,
username: "user01",
password: "1234",
});

const response = await DirectDb.executeProcedure("SP_SPS_TESTSP", ["A%"]);

console.log(response);

`

SQL

`javascript
const { DirectDb } = require("sps-sap-interface");

await DirectDb.init({
server: "192.168.0.1",
database: "SBO_DEMO_SQL",
databaseType: DirectDb.DATABASE_TYPES.SQL,
username: "user1",
password: "5432",
});

const response = await DirectDb.executeProcedure("SP_SPS_TESTSP", ["A%"]);

console.log(response);

``