Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/SoftwareAG/webmethods.io-Tableau-Community-Connector

This is a community connector for Tableau
https://github.com/SoftwareAG/webmethods.io-Tableau-Community-Connector

community connectors webmethods webmethods-io-integration

Last synced: about 2 months ago
JSON representation

This is a community connector for Tableau

Awesome Lists containing this project

README 

        
# webmethods.io-Tableau-Community-Connector

This is a Webmethods.io community connector for [Tableau](https://www.tableau.com/), a powerful and fast growing data visualization tool used in the Business Intelligence Industry. The connector uses the [Tableau REST API](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_ref.htm#api-examples) to make HTTP requests to access or modify a resource. The actions supported by this community connector are:



#### 1. [Add User to Group](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_ref.htm#add_user_to_group)

#### 2. [Create Group](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_ref.htm#create_group)

#### 3. [Create Project](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_ref.htm#create_project)

#### 4. [Delete Project](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_ref.htm#delete_project)

#### 5. [Get Users in Group](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_ref.htm#get_users_in_group)

#### 6. [Query Groups](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_ref.htm#query_groups)

#### 7. [Query Projects](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_ref.htm#query_projects)

#### 8. [Update Project](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_ref.htm#update_project)



Learn about other supported actions [here](https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_ref.htm).



### 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:



![image](https://user-images.githubusercontent.com/20556391/75151087-dc552800-572b-11ea-8396-1f1dedd8ab83.png)



## 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](https://nodejs.org/dist/) 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](https://github.com/coreybutler/nvm-windows#installation--upgrades).

  

  - For Mac, use [homebrew](https://brew.sh/).

2. Build your app using your existing Node version and then transpile your code using a transpiler like [Babel](https://babeljs.io/).



The connector has been built with [wmiocli](https://docs.webmethods.io/integration/developer_guide/connector_builder/#gsc.tab=0), 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.

5. Change the verb on the upper left to POST, and then replace "Enter request URL " with your URI.

6. Select Body, then select raw.

7. Copy/Paste the body XML from the preceding section into the raw body area, ensuring the placeholders have been replaced with valid values.

8. Choose Send, then scroll down to view the response panel.



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

![gif](https://help.tableau.com/current/api/rest_api/en-us/Img/postman_auth.gif)



### 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.



![image](https://user-images.githubusercontent.com/20556391/75150886-605ae000-572b-11ea-85df-01c93df60705.png)



## 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.



![image](https://user-images.githubusercontent.com/20556391/75151490-d01d9a80-572c-11ea-9341-ca1ad30b70da.png)



## Built With

Node v8.14.0 and [wmiocli](https://docs.webmethods.io/integration/developer_guide/connector_builder/#gsc.tab=0), webmethod.io's iPaaS Connector Builder CLI.

#### This community connector was built using [Tableau Online](https://www.tableau.com/trial/tableau-online?utm_campaign_id=2017049&utm_campaign=Prospecting-PROD-ALL-ALL-ALL-ALL&utm_medium=Paid+Search&utm_source=Google+Search&utm_language=EN&utm_country=IND&kw=tableau%20online&adgroup=CTX-Brand-Tableau+Online-EN-E&adused=324827190946&matchtype=e&placement=&gclid=CjwKCAiAhc7yBRAdEiwAplGxXz7x0PHLLtyE5MtIP2J4oh3HLhS09giT0tcRhFLHw4IrpCCi-qXFohoCGaMQAvD_BwE&gclsrc=aw.ds) and uses the 3.4 version of Tableau REST API.



## Contributors

[Anshuman Saikia](https://github.com/anshu96788) |

[Dipankar Dutta](https://github.com/DipankarDDUT) |

[Nawajish Laskar](https://github.com/Nawajish)



## License

This project is licensed under the Apache 2.0 License - see the [LICENSE.md](https://github.com/SoftwareAG/webmethods-microservicesruntime-samples/blob/master/LICENSE) 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](mailto:[email protected]?subject=Github/SoftwareAG) if you have any questions.