webmethods.io-Tableau-Community-Connector

This is a Webmethods.io community connector for Tableau, a powerful and fast growing data visualization tool used in the Business Intelligence Industry. The connector uses the Tableau REST API to make HTTP requests to access or modify a resource. The actions supported by this community connector are:

1. Add User to Group

2. Create Group

3. Create Project

4. Delete Project

5. Get Users in Group

6. Query Groups

7. Query Projects

8. Update Project

Learn about other supported actions here.

Note:

The response contains two pieces of information that you will need to interact with the Tableau REST API:

1. The value of the credentials token: This token will allow the other calls to be authenticated as valid by your Tableau Server. To keep things secure, the token has a time limit, typically 2 hours. After that you'll need to sign in again and use the new token from the response for following requests.
2. The value of site id: This is the identifier for the site on your Tableau Server that you define in the contentUrl in your request body. Your users, workbooks and views are all children of your site object, and you need this identifier to make REST calls to them. If contentUrl is empty, then the default site’s id is returned.
3. Every REST call to the server after sign in needs to pass a valid credentials token to succeed. To pass the token you place it in the request header as a key/value pair:

Getting Started

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. See deployment for notes on how to deploy the project on a live system.

Prerequisites

This connector requires any Node version between 8.14.0 and 10.14.2.

Note: If you have installed any other Node version on your system, you can:

1. Use tools to switch between different versions of Node

• For Windows, use nvm-windows.

• For Mac, use homebrew.

2. Build your app using your existing Node version and then transpile your code using a transpiler like Babel.

The connector has been built with wmiocli, webmethod.io's iPaaS Connector Builder CLI tool, which must be installed.

Getting the access credentials

To generate the necessary access credentials, make a REST sign in request using Postman.

1. Open Postman and select +New > Request.
2. In Request name, type "Sign in".
3. Choose +Create collection and name the new collection “REST Tutorial Collection". 4 Choose the check mark on the right of the form field, then choose Save to REST Tutorial Collection.
4. Change the verb on the upper left to POST, and then replace "Enter request URL " with your URI.
5. Select Body, then select raw.
6. Copy/Paste the body XML from the preceding section into the raw body area, ensuring the placeholders have been replaced with valid values.
7. Choose Send, then scroll down to view the response panel.

Below is a GIF that shows the above steps in action.

Installing

1. Clone the repo https://github.com/yuvanmytri/webmethods.io-Tableau-Community-Connector.git.
2. Run npm install -g @webmethodsio/wmiocli.
3. Login to your webmethods.io tenant using wmio login.
4. Execute wmio init to get started.
5. Finally, execute wmio deploy to deploy this connector to your tenant.

Once deployed, it’ll be automatically registered with webMethods.io Integration and will be available to you locally in the Connectors panel under the Services tab.

Running the tests

To test, you can execute wmio test.

Deployment

Execute wmio deploy to deploy this connector to your webmethods.io tenant. And wmio unpublish to unpublish the published connector app along with triggers and actions associated with the app.

Tableau Server versions and REST API versions

Versions of the REST API are made available with releases of Tableau Server. The following table lists versions of Tableau Server and of the corresponding REST API and REST API schema versions.

Built With

Node v8.14.0 and wmiocli, webmethod.io's iPaaS Connector Builder CLI.

This community connector was built using Tableau Online and uses the 3.4 version of Tableau REST API.

Contributors

Anshuman Saikia | Dipankar Dutta | Nawajish Laskar

License

This project is licensed under the Apache 2.0 License - see the LICENSE.md file for details

---

These tools are provided as-is and without warranty or support. They do not constitute part of the Software AG product suite. Users are free to use, fork and modify them, subject to the license agreement. While Software AG welcomes contributions, we cannot guarantee to include every contribution in the master project.

Contact us at TECHcommunity if you have any questions.