Azure DevOps Connector for MS AccessAzure 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 MS Access without coding. We will use high-performance Azure DevOps Connector to easily connect to Azure DevOps and then access the data inside MS Access. Let's follow the steps below to see how we can accomplish that! Azure DevOps Connector for MS Access 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 ODBC Data Source (DSN) based on ZappySys API Driver
Step-by-step instructions
To get data from Azure DevOps using MS Access we first need to create a DSN (Data Source) which will access data from Azure DevOps. We will later be able to read data using MS Access. Perform these steps:
-
Download and install ODBC PowerPack.
-
Open ODBC Data Sources (x64):
-
Create a User data source (User DSN) based on ZappySys API Driver
ZappySys API Driver-
Create and use User DSN
if the client application is run under a User Account.
This is an ideal option
in design-time , when developing a solution, e.g. in Visual Studio 2019. Use it for both type of applications - 64-bit and 32-bit. -
Create and use System DSN
if the client application is launched under a System Account, e.g. as a Windows Service.
Usually, this is an ideal option to use
in a production environment . Use ODBC Data Source Administrator (32-bit), instead of 64-bit version, if Windows Service is a 32-bit application.
-
Create and use User DSN
if the client application is run under a User Account.
This is an ideal option
-
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 MS Access 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 MS Access:
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.
Video Tutorial
Read data in Microsoft Access from the ODBC data source
-
First of all, open MS Access and create a new MS Access database.
-
In the next step, start loading ODBC data source we created:
-
Then click next until data source selection window appears. Select the data source we created in one of the previous steps and hit OK:
AzureDevopsDSN -
Continue with tables and views selection. You can extract multiple tables or views:
-
Finally, wait while data is being loaded and once done you should see a similar view:
Using Linked Table for Live Data (Slow)
Linked tables in Microsoft Access are crucial for online databases because they enable real-time access to centralized data, support scalability, facilitate collaboration, enhance data security, ease maintenance tasks, and allow integration with external systems. They provide a flexible and efficient way to work with data stored in online databases, promoting cross-platform compatibility and reducing the need for data duplication.
-
Real-Time Data Access:
Access can interact directly with live data in online databases, ensuring that users always work with the most up-to-date information. -
Centralized Data Management:
Online databases serve as a centralized repository, enabling efficient management of data from various locations. -
Ease of Maintenance:
Updates or modifications to the online database structure are automatically reflected in Access, streamlining maintenance tasks. -
Adaptability to Changing Requirements:
Linked tables provide flexibility, allowing easy adaptation to changing data storage needs or migration to different online database systems.
Let's create the linked table.
-
Launch Microsoft Access and open the database where you want to create the linked table.
-
Go to the "External Data" tab on the Ribbon. >> "New Data Source" >> "From Other Sources" >> "ODBC Database"
-
Select the option "Link to Data Source by creating a linked table:
-
Continue by clicking 'Next' until the Data Source Selection window appears. Navigate to the Machine Data Source tab and select the desired data source established in one of the earlier steps. Click 'OK' to confirm your selection.
AzureDevopsDSN -
Proceed to the selection of Tables and Views. You have the option to extract multiple tables or views:
-
When prompted to select Unique Key column DO NOT select any column(s) and just click OK:
-
Finally, Simply double-click the newly created Linked Table to load the data:
Guide to Effectively Addressing Known Issues
Discover effective strategies to address known issues efficiently in this guide. Get solutions and practical tips to streamline troubleshooting and enhance system performance, ensuring a smoother user experience.
Fewer Rows Imported
The reason for this is that MS Access has a default query timeout of 60 seconds, which means it stops fetching data if the query takes longer than that. As a result, only a limited number of rows are fetched within this time frame.
To address this, we can adjust the Query Timeout by following the steps below.
The path may vary depending on the MS Access bitness, such as 32-bit versus 64-bit.
\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Jet\4.0\Engines\ODBC
\HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\Jet\4.0\Engines\ODBC
\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Office\ClickToRun\REGISTRY\MACHINE\Software\Microsoft\Office\16.0\Access Connectivity Engine\Engines\ODBC
We can identify this issue by examining the Fiddler Log, as MS Access doesn't display any error regarding partial import, which is quite unusual
Please refer to this link : How to use Fiddler to analyze HTTP web requests
#Deleted word appears for column value in MS Access for Linked Table mode
If you used Linked Table mode to get external data and it shows #deleted word rather than actual value for column after you open then most likely its following issue.
Make sure to re-create Linked Table and DO NOT select any key column when prompted (Just click OK)
How to Fix
Table Selection UI Opening Delays
The Table selection UI takes a significant amount of time to open after clicking the 'New Data Source' -> 'Other Data Sources' -> 'ODBC'
The reason for this issue is that MS Access sends a dummy query, leading to several unnecessary pagination cycles before an error is thrown. To mitigate this, we can prevent wasted cycles by configuring the 'Throw error if no match' setting on the Filter Options Tab.
Enhancing Performance through Metadata Addition (Reduces Query Time)
We can optimize query performance by creating Virtual Tables (i.e. views with custom SQL) on Datasource and incorporating META=static columns. Learn how to capture static metadata in this guide.
Performance Options - Generate Metadata Manually
Execute the query initially, save the metadata by selecting 'Save to Meta' (choose Compact Format), and then click 'Save to Clipboard.' Utilize the resulting list by pasting it into the META attribute as follows: 'META=paste here.'
SELECT * FROM products
WITH(
META='id:String(20); title:String(100); description:String(500);'
)
Optimize Workflow with Automated Import
Employ Automated Import when Linked Tables are not feasible, and we need to depend on Imported Tables with static data.
While using Linked Tables sometime it encounter errors, and we are left with no alternative but to utilize Imported Tables, Automatic Refresh becomes crucial in such scenarios.
Here's a guide on automating refreshes. We can set up automatic refresh on different events, such as when the database opens, a form is opened, or a button is clicked.
To initiate the import process, follow these steps:
- Perform the data import using the standard manual steps.
- In the final step, we'll encounter a checkbox labeled 'Save Import Steps.' Ensure to check this option.
- After saving the steps, we can locate their name in the Save Imports UI. Identify the name associated with the saved steps.
- "Now, we can execute the code as shown below:"
Private Sub cmdYes_Click() Label0.Visible = True DoCmd.RunSavedImportExport "Import-DATA.products" Label0.Visible = False End Sub
Actions supported by Azure DevOps Connector
Learn how to perform common Azure DevOps actions directly in MS Access 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 MS Access 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 MS Access 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 MS Access Documentation
More integrations
Other connectors for MS Access
Other application integration scenarios for Azure DevOps
How to connect Azure DevOps in MS Access?
How to get Azure DevOps data in MS Access?
How to read Azure DevOps data in MS Access?
How to load Azure DevOps data in MS Access?
How to import Azure DevOps data in MS Access?
How to pull Azure DevOps data in MS Access?
How to push data to Azure DevOps in MS Access?
How to write data to Azure DevOps in MS Access?
How to POST data to Azure DevOps in MS Access?
Call Azure DevOps API in MS Access
Consume Azure DevOps API in MS Access
Azure DevOps MS Access Automate
Azure DevOps MS Access Integration
Integration Azure DevOps in MS Access
Consume real-time Azure DevOps data in MS Access
Consume real-time Azure DevOps API data in MS Access
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 MS Access
Load Azure DevOps in MS Access
Load Azure DevOps data in MS Access
Read Azure DevOps data in MS Access
Azure DevOps API Call in MS Access