/avacloud-demo-node

AVACloud demo in Node to read, write, convert and create GAEB files

Primary LanguageTypeScriptOtherNOASSERTION

avacloud-demo-node

AVACloud is a web based Software as a Service (SaaS) offering for GAEB files.
The GAEB standard is a widely used format to exchange tenderings, bills of quantities and contracts both in the construction industry and in regular commerce. AVACloud uses the GAEB & AVA .Net Libraries and makes them available to virtually all programming frameworks via a web service.

This project here contains example code in TypeScript / JavaScript for the NodeJS runtime to read and convert GAEB files. The client code is generated from the AVACloud Swagger Specification.

Step-By-Step Tutorial

Please find here a step-by-step tutorial how to use the Node client.

Build

Execute the following command in the root directory of the project:

npm i
npm run build

Run

Execute the following command in the root directory of the project:

npm run start

At the top of the app.ts file, the following parameters must be defined by you:

const clientId = 'InsertYourClientId';
const clientSecret = 'InsertYourClientSecret';

These are the credentials of your Dangl.Identity OAuth2 client that is configured to access AVACloud.
If you don't have values for ClientId and ClientSecret yet, you can check out the documentation for instructions on how to register for AVACloud and create an OAuth2 client.

This example app does four operations:

  1. The local GAEB file is transformed to Excel and saved next to the input file
  2. The local GAEB file is converted to the unified Dangl.AVA format and the total price as well as the number of positions in the bill of quantities is printed to the console.
  3. It creates a new GAEB file and saves it to CreatedGaebFile.X86. The GAEB file only has a single position in it and is in the latest GAEB XML format.
  4. It simulates the creation of a complex GAEB file with more content by first transforming the example file to a ProjectDto via AVACloud and then sending this again to the GAEB conversion endpoint, finally saving the result as Roundtrip.X86

Fetch Client

There is also a package without external dependencies, built on fetch. The app-fetch.ts file has an example for the @dangl/avacloud-client-fetch package.

License