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.

AVACloud Key Features

• Can read all GAEB90, GAEB2000 and GAEB XML files. It includes many heuristics and eror corrections that can recover incorrect files
• Hassle-free import: Just pass the file to AVACloud, format detection and error recovery happens automatically
• Advanced code, built on years of experience, allows the preservation of most information even when converting to an earlier version of the GAEB standard
• Automatic calculation of prices, quantities and more - AVACloud can do much more beyond just converting your data
• Over 250.000 tests are run automatically on every commit. Tests range from unit tests in the conversion code up to full integration tests mirroring a full production environment

Supported Formats

... and many more!

UI Components

Easy integration with prebuilt UI components is possible within minutes:

• Either by using our Angular specific @dangl/angular-ava package: https://www.npmjs.com/package/@dangl/angular-ava
• Or with our framework agnostict Html web component implementation that run anywhere, either in web apps or locally in a web view: https://www.npmjs.com/package/@dangl/web-components-ava

---

License