Prestazioni delle mutazioni del libro contabile in SnelStart / query folding

No, il “server-side filtering” (filtraggio lato server), come viene chiamata la variante Invantive UniversalSQL del “query folding” tra il motore Invantive UniversalSQL e il server API della piattaforma, non è attualmente implementato di proposito per SnelStart.

Per ulteriori spiegazioni e i passi successivi consigliati, vedere il testo qui sotto.

Sfida

SnelStart si basa su una specifica Swagger / OpenAPI che SnelStart mantiene aggiornata.

SnelStart supporta i filtri, come descritto su https://b2bapi-developer.snelstart.nl/odata (potrebbe essere necessario registrarsi come sviluppatore).

Per il filtraggio lato server è necessario poter passare una specifica di filtro. Il problema è che la specifica di filtro di SnelStart utilizza proprietà case-sensitive e in “UpperCamelCase”. Tuttavia, le proprietà che SnelStart riporta nella specifica sono scritte in un modo diverso. Questa diversa notazione si ritrova anche nel JSON.

Un esempio basato sugli articoli:

{
  "isHoofdartikel": false,
  "subartikelen": [],
  "artikelcode": "VOORBEELD",
  "omschrijving": "Diversen diensten hoog",
  "artikelOmzetgroep": {
    "id": "11a35e1b-dce0-48ef-bf25-7480fb0563ff",
    "uri": "/artikelomzetgroepen/11a35e1b-dce0-48ef-bf25-7480fb0563ff"
  },
  "verkoopprijs": 0,
  "inkoopprijs": 0,
  "eenheid": null,
  "modifiedOn": "2023-06-29T21:44:48.51",
  "relatie": null,
  "isNonActief": false,
  "voorraadControle": false,
  "technischeVoorraad": 0,
  "vrijeVoorraad": 0,
  "extraVelden": [],
  "id": "d691991a-9c3c-45d0-b6d0-aae11727e981",
  "uri": "/artikelen/d691991a-9c3c-45d0-b6d0-aae11727e981"
}

Il recupero filtrato di un articolo può essere effettuato con (chiamata nativa):

https://b2bapi.snelstart.nl/v2/artikelen?$filter=Artikelcode ge ''VANAF''

Un’alternativa è utilizzare la notazione artikelcode come nel JSON sopra:

https://b2bapi.snelstart.nl/v2/artikelen?$filter=artikelcode ge ''VANAF''

Questa restituisce un HTTP 400 Bad Request:

itgenoda137
The SnelStart server cannot or will not process the request due to an apparent client error (e.g., malformed request syntax, size too large, invalid request message framing, or deceptive request routing).
itgenclr217
The remote server returned an error:
(400) Bad Request.

Approccio

Come descritto sopra, tutti i filtri dovrebbero quindi essere individuati manualmente e implementati dove possibile. La maggior parte delle amministrazioni SnelStart ha dimensioni piuttosto limitate, poiché SnelStart è utilizzato prevalentemente da organizzazioni più piccole. Inoltre, l’API in sé è abbastanza veloce, con una velocità di elaborazione di diverse centinaia di righe al secondo.

Finora, quindi, non sono stati implementati filtri.

Qualora ci fosse necessità di filtri specifici, si prega di aggiungere una risposta indicando, per ogni tabella, i campi desiderati e l’operatore relazionale, ad esempio nel formato:

Tabella Campo Operatore
Artikelen artikelcode >=
GrootboekMutaties Mutatiedatum between
…

È utile indicare anche, per ogni tabella, quante righe contiene approssimativamente in totale (10.000, 100.000, 1 milione, ecc.).