Azure DevOps Connector for SSASAzure DevOps Connector can be used to integrate Azure DevOps data in your App / BI Tools. You can create, read, query, modify, and delete WorkItems, Projects, Teams and more. In this article you will learn how to quickly and efficiently integrate Azure DevOps data in SSAS without coding. We will use high-performance Azure DevOps Connector to easily connect to Azure DevOps and then access the data inside SSAS. Let's follow the steps below to see how we can accomplish that! Azure DevOps Connector for SSAS is based on ZappySys API Driver which is part of ODBC PowerPack. It is a collection of high-performance ODBC drivers that enable you to integrate data in SQL Server, SSIS, a programming language, or any other ODBC-compatible application. ODBC PowerPack supports various file formats, sources and destinations, including REST/SOAP API, SFTP/FTP, storage services, and plain files, to mention a few. |
Connect to Azure DevOps in other apps
|
Create Data Source in ZappySys Data Gateway based on API Driver
-
Download and install ODBC PowerPack.
-
Search for gateway in start menu and Open ZappySys Data Gateway:
-
Go to Users Tab to add our first Gateway user. Click Add; we will give it a name tdsuser and enter password you like to give. Check Admin option and click OK to save. We will use these details later when we create linked server:
-
Now we are ready to add a data source. Click Add, give data source a name (Copy this name somewhere, we will need it later) and then select Native - ZappySys API Driver. Finally, click OK. And it will create the Data Set for it and open the ZS driver UI.
AzureDevopsDSN
-
When the Configuration window appears give your data source a name if you haven't done that already, then select "Azure DevOps" from the list of Popular Connectors. If "Azure DevOps" is not present in the list, then click "Search Online" and download it. Then set the path to the location where you downloaded it. Finally, click Continue >> to proceed with configuring the DSN:
AzureDevopsDSNAzure DevOps -
Now it's time to configure the Connection Manager. Select Authentication Type, e.g. Token Authentication. Then select API Base URL (in most cases, the default one is the right one). More info is available in the Authentication section.
Steps how to get and use Azure DevOps credentials
Connecting to your Azure DevOps data requires you to authenticate your REST API access. Follow the instructions below:- Go to https://app.vsaex.visualstudio.com/app/register to register your app.
-
Fill in your application and company's information as required, and then select the scopes that your application needs.
This should typically be Project and team (read and write) and Work items (read and write).
Your selected scopes when registering your app must match the scopes you enter here on the connector screen. If they don't match, the connector will not be able to work with your Azure DevOps account!If you need further information about the scopes used in Azure DevOps, or need to see what to enter into the connector screen to match up with your selected scopes, visit https://learn.microsoft.com/en-us/azure/devops/integrate/get-started/authentication/oauth?view=azure-devops.
NOTE: For Authorization callback URL use your company's OAuth Redirect URL (if IT administrator provides you one) or you can use
https://zappysys.com/oauth
(it's safe). - Select Create Application and then the Application Settings page will be displayed.
-
Record the App ID for us to use later:
-
And do the same with Client Secret:
- Then go to https://aex.dev.azure.com and select relevant organization on the left.
-
Then copy Organization's host name part (e.g.
acmeinc
, if full host name isacmeinc.visualstudio.com
), save it to a file, and click it: - Back at the connector screen, enter the App ID into the Client Id (App ID) field that was recorded in the previous step.
- Enter the Client Secret that was recorded in the previous step into the Client Secret field. In order to edit the text in this field, select the ellipses (...) button that appears when the textbox is clicked, and edit the Client Secret with the dialog box that appears.
- Enter the organization that was recorded in step 5 into the Organization name or Id for url field.
- Click Generate Token. If proper authentication occurs, you will see a notice saying so. You can click Yes to save a backup file of your generated tokens.
- Select the project you want to connect to by default from the Default Project (Choose after Generating Token) field.
- Select the Security tab.
-
Enter
https://auditservice.dev.azure.com,https://almsearch.dev.azure.com
into the Additional Trusted Domains field. - Select the Test Connection button at the bottom of the window to verify proper connectivity with your Azure DevOps account.
- If the connection test succeeds, select OK.
-
To edit previously created app you can visit
https://app.vsaex.visualstudio.com/me
and see Applications and services section. Click on your desired app name.
Fill in all required parameters and set optional parameters if needed:
AzureDevopsDSNAzure DevOpsOAuth [OAuth]https://dev.azure.comRequired Parameters Client Id (App ID) Fill-in the parameter... Client Secret Fill-in the parameter... Organization name or Id for url (e.g. mycompany) Fill-in the parameter... Return URL Fill-in the parameter... Scopes (Must match with App Registration) Fill-in the parameter... API Version Fill-in the parameter... Optional Parameters Default Project Name (Choose after Generating Token) RetryMode RetryWhenStatusCodeMatch RetryStatusCodeList 429 RetryCountMax 5 RetryMultiplyWaitTime True Steps how to get and use Azure DevOps credentials
To connect to Azure DevOps using a Personal Access Token (PAT), you must first create a valid PAT:- Start by by going to https://aex.dev.azure.com and selecting relevant organization on the left.
-
Then copy Organization's host name part (e.g.
acmeinc
, if full host name isacmeinc.visualstudio.com
), save it to a file, and click it: -
Next, click User settings icon and then click Personal access tokens:
-
Then click New Token button to create a new personal access token:
-
Continue by...
- naming your token
- selecting the right Organization
- setting token's Expiration date (it's recommended to use
Custom defined
option and make it expire after one year or later) - and setting the Scopes:
NOTE: You may be restricted from creating full-scoped PATs. If so, your Azure DevOps administrator in Azure AD has enabled a policy which limits you to a specific custom defined set of scopes.
-
Now click Copy button and save the newly created token into a file for quick access later:
- Go back to the connector screen, input the token you saved in a previous step into the Personal Access Token (PAT) field.
- Then enter the Organization host name part that you noted recorded in previous step into Organization name or Id for url field.
- Enter the name or Id of the project you want to connect to by default in the Default Project (Choose after above fields) field.
- Select the Security tab.
- Enter
https://auditservice.dev.azure.com,https://almsearch.dev.azure.com,https://analytics.dev.azure.com
into the Additional Trusted Domains field. - Select the Test Connection button at the bottom of the window to verify proper connectivity with your Azure DevOps account.
- Done!
Fill in all required parameters and set optional parameters if needed:
AzureDevopsDSNAzure DevOpsPersonal Access Token (PAT) [Http]https://dev.azure.comRequired Parameters Personal Access Token (PAT) Fill-in the parameter... Organization name or Id for url Fill-in the parameter... API Version Fill-in the parameter... Optional Parameters AuthScheme Bearer AuthHeader Authorization UserName Default Project Name (Choose after Generating Token) RetryMode RetryWhenStatusCodeMatch RetryStatusCodeList 429 RetryCountMax 5 RetryMultiplyWaitTime True -
Once the data source connection has been configured, it's time to configure the SQL query. Select the Preview tab and then click Query Builder button to configure the SQL query:
ZappySys API Driver - Azure DevOpsAzure DevOps Connector can be used to integrate Azure DevOps data in your App / BI Tools. You can create, read, query, modify, and delete WorkItems, Projects, Teams and more.AzureDevopsDSN -
Start by selecting the Table or Endpoint you are interested in and then configure the parameters. This will generate a query that we will use in SSAS to retrieve data from Azure DevOps. Hit OK button to use this query in the next step.
SELECT * FROM Projects
Some parameters configured in this window will be passed to the Azure DevOps API, e.g. filtering parameters. It means that filtering will be done on the server side (instead of the client side), enabling you to get only the meaningful datamuch faster . -
Now hit Preview Data button to preview the data using the generated SQL query. If you are satisfied with the result, use this query in SSAS:
ZappySys API Driver - Azure DevOpsAzure DevOps Connector can be used to integrate Azure DevOps data in your App / BI Tools. You can create, read, query, modify, and delete WorkItems, Projects, Teams and more.AzureDevopsDSNSELECT * FROM Projects
You can also access data quickly from the tables dropdown by selecting <Select table>.AWHERE
clause,LIMIT
keyword will be performed on the client side, meaning that thewhole result set will be retrieved from the Azure DevOps API first, and only then the filtering will be applied to the data. If possible, it is recommended to use parameters in Query Builder to filter the data on the server side (in Azure DevOps servers). -
Click OK to finish creating the data source.
Read Azure DevOps data in SSAS cube
With the data source created in the Data Gateway (previous step), we're now ready to read Azure DevOps data in an SSAS cube. Before we dive in, open Visual Studio and create a new Analysis Services project. Then, you're all set!
Create data source based on ZappySys Data Gateway
Let's start by creating a data source for a cube, based on the Data Gateway's data source we created earlier. So, what are we waiting for? Let's do it!
-
Create a new data source:
-
Once a window opens,
select Create a data source based on an existing or new connection option and
click New...:
-
Here things become a little complicated, but do not despair, it's only for a little while.
Just perform these little steps:
- Select Native OLE DB\SQL Server Native Client 11.0 as provider.
- Enter your Server name (or IP address) and Port, separated by a comma.
- Select SQL Server Authentication option for authentication.
- Input User name which has admin permissions in the ZappySys Data Gateway.
- In Database name field enter the same data source name you use in the ZappySys Data Gateway.
- Hopefully, our hard work is done, when we Test Connection.
AzureDevopsDSNAzureDevopsDSNIf SQL Server Native Client 11.0 is not listed as Native OLE DB provider, try using these:- Microsoft OLE DB Driver for SQL Server
- Microsoft OLE DB Provider for SQL Server
-
Indeed, life is easy again:
Add data source view
We have data source in place, it's now time to add a data source view. Let's not waste a single second and get on to it!
-
Start by right-clicking on Data Source Views and then choosing New Data Source View...:
-
Select the previously created data source and click Next:
- Ignore the Name Matching window and click Next.
-
Add the tables you will use in your SSAS cube:
For cube dimensions, consider creating a Virtual Table in the Data Gateway's data source. Use the
DISTINCT
keyword in theSELECT
statement to get unique values from the facts table, like this:SELECT DISTINCT Country FROM Customers
For demonstration purposes we are using sample tables which may not be available in Azure DevOps. -
Review your data source view and click Finish:
-
Add the missing table relationships and you're done!
Create cube
We have a data source view ready to be used by our cube. Let's create one!
-
Start by right-clicking on Cubes and selecting New Cube... menu item:
-
Select tables you will use for the measures:
-
And then select the measures themselves:
-
Don't stop and select the dimensions too:
-
Move along and click Finish before the final steps:
-
Review your cube before processing it:
-
It's time for the grand finale! Hit Process... to create the cube:
-
A splendid success!
Execute MDX query
The cube is created and processed. It's time to reap what we sow! Just execute an MDX query and get Azure DevOps data in your SSAS cube:

Actions supported by Azure DevOps Connector
Learn how to perform common Azure DevOps actions directly in SSAS with these how-to guides:
- Create Project
- Create Team
- Create Work Item
- Create Work Item Comment
- Delete Project
- Delete Team
- Delete Work Item
- Delete Work Item Comment
- Get List of Projects
- Get List of Queries
- Get List of Teams
- Get Project Details
- Get Query Fileds
- Get Team Details
- Get Team Iteration Capacities
- Get Team Iterations
- Get Team Members
- Get Work Item Column Fields
- Get Work Item Comment by Comment Id and Work Item Id
- Get Work Item Comments (by WorkItem Id)
- Get Work Item Types
- Get Work Items by Ids
- Get Work Items for Specified Query Id
- Query Work Item Comments
- Query Work Items
- Search for Work Items by Text
- Update Project
- Update Team
- Update Work Item
- Update Work Item Comment
- Generic Request
- Generic Request (Bulk Write)
Conclusion
In this article we showed you how to connect to Azure DevOps in SSAS and integrate data without any coding, saving you time and effort. It's worth noting that ZappySys API Driver allows you to connect not only to Azure DevOps, but to any Java application that supports JDBC (just use a different JDBC driver and configure it appropriately).
We encourage you to download Azure DevOps Connector for SSAS and see how easy it is to use it for yourself or your team.
If you have any questions, feel free to contact ZappySys support team. You can also open a live chat immediately by clicking on the chat icon below.
Download Azure DevOps Connector for SSAS Documentation
More integrations
Other connectors for SSAS
Other application integration scenarios for Azure DevOps
How to connect Azure DevOps in SSAS?
How to get Azure DevOps data in SSAS?
How to read Azure DevOps data in SSAS?
How to load Azure DevOps data in SSAS?
How to import Azure DevOps data in SSAS?
How to pull Azure DevOps data in SSAS?
How to push data to Azure DevOps in SSAS?
How to write data to Azure DevOps in SSAS?
How to POST data to Azure DevOps in SSAS?
Call Azure DevOps API in SSAS
Consume Azure DevOps API in SSAS
Azure DevOps SSAS Automate
Azure DevOps SSAS Integration
Integration Azure DevOps in SSAS
Consume real-time Azure DevOps data in SSAS
Consume real-time Azure DevOps API data in SSAS
Azure DevOps ODBC Driver | ODBC Driver for Azure DevOps | ODBC Azure DevOps Driver | SSIS Azure DevOps Source | SSIS Azure DevOps Destination
Connect Azure DevOps in SSAS
Load Azure DevOps in SSAS
Load Azure DevOps data in SSAS
Read Azure DevOps data in SSAS
Azure DevOps API Call in SSAS