Node Tableau Extract API - v1.2.0

This is a minor version release of the "official unofficial" node.js Tableau Extract API. Check the README for installation instructions

Highlights

• You can now pass an instance of a moment.js object as the value of a date or datetime field.
• Performance optimizations for larger extracts.

Node Tableau Extract API - v1.1.0

This is a minor version release of the "official unofficial" node.js Tableau Extract API. Check the README for installation instructions

Highlights

• Adds support for multi-table extracts.

Example

var ExtractAPI = require('tableau-sdk');

// ...

extract = new ExtractAPI('product-orders-js.tde');
extract.addTable('Products', productTableDef);
extract.addTable('Orders', orderTableDef);

extract.insert('Products', productData);
extract.insertMultiple('Orders', orderData);

extract.close();

Note: you must have the Tableau 2018.3 SDK installed to take advantage of multi-table extract features.

Node Tableau Extract API - v1.0.1

This is a patch version of the "official unofficial" node.js Tableau Extract API. This should be a simple upgrade from version 1.0.0. If you are on an older version, see the notes on the v1.0.0 release.

Highlights

• Adds support for node.js v10.x.
• Resolves security issues in dependencies of this module by upgrading to secure versions.

Node Tableau Extract API - v1.0.0

This is a major version release of the "official unofficial" node.js Tableau Extract API. If you were previously using a 0.x version of this library, you will likely need to make changes to your code or your runtime environment. Check the README for installation instructions.

Highlights

• Adds support for generating Hyper extracts, via the Extract API 2.0.
• Improves installation experience by using default compiler, rather than forcing clang++.
• Updates support for spatial data. If you previously used the spatial column type, you should now use geometry in its place.
• Drops support for publishing extracts to Tableau Server. You should use the Tableau Server REST API instead.

Note: you must have the Tableau Extract API 2.0 installed (available as of Tableau 10.5)

Node Tableau SDK - v0.3.0

This is a minor version release of the "official unofficial" node.js Tableau SDK. Check the README for installation instructions

Highlights

• Adds support for spatial column type.

Usage example

var TDE = require('tableau-sdk'),
    tableDefinition,
    extract;

// Define a table with a spatial column.
tableDefinition = {
  id: 'Extract',
  defaultAlias: 'Orders',
  columns: [
    {id: 'product', dataType: 'string'},
    {id: 'destination', dataType: 'spatial'}
  ]
}

// Create an extract and insert a row with spatial data.
extract = new TDE('order-js.tde', tableDefinition);
extract.insert({
  product: 'Beans',
  destination: 'POINT (30 10)'
});

extract.close();

Note: you must have the Tableau 10.2 SDK installed to take advantage of spatial features.

Node Tableau SDK - v0.2.1

This is a patch release of the "official unofficial" node.js Tableau SDK.

Highlights

• Adds support for Node v6 LTS releases.
• Now tested against TDE SDK versions 9.3, 10.0, and 10.2.

Node Tableau SDK - v0.2.0

This is a minor-version release of the "official unofficial" node.js Tableau SDK. It introduces a number of new features.

Highlights

• Improved API: The interface for creating extracts, inserting data, and publishing to Server has been simplified and made more JavaScript-y.
  • You no longer have to instantiate multiple objects and pass them into each other to create an extract. Everything you need is just a method on the top-level Extract object: new Extract(), Extract.insert, Extract.publish, Extract.close().
  • You can now use table definitions from the Tableau Web Data Connector API to define your extract's schema.
  • You can still access native API objects the same way as in v0.1.x for more advanced use-cases.
• Improved Exception handling: Exceptions thrown by the native Tableau SDK will now throw equivalent exceptions in JavaScript rather than exit in an unrecoverable way as in v0.1.x.
• Node and SDK version support
  • This package now officially supports v10.0 of the native Tableau SDK, in addition to v9.3.
  • This package now officially supports node v4.5.x.

New API example

var TDE = require('tableau-sdk'),
    extract;

// Open a reference to the TDE.
extract = new TDE('/path/to/Your DataSource.tde');

try {
  extract.publish('https://your-corp.internal', 'yourUser', process.env.TABPW);
}
catch (err) {
  console.error('There was a problem publishing the extract to Server:');
  console.error(err);
}

For details and code examples, check the updated README.md file. As always, install this package with npm.

Special thanks to @tfoldi for contributions to this release.