Setting up Azure Dev Ops as a Source

👥
Access needed
Guru Access: You need to be an Admin, Source Creator, or relevant custom role to set up Sources.
Azure Dev Ops: You need to have Admin access in Azure Dev Ops to connect as a source.

Connecting Azure Dev Ops Work Items

Go to Manage > Sources.
Select Add Source.
Choose Azure Dev Ops Work Items from the list of available integrations.
Select My Credentials.
Enter your Azure DevOps organization name:
- Sign in to your Azure DevOps account
- Go to Organizations
- Copy the organization name that appears after "dev.azure.com". For example, if you see "dev.azure.com/acme", enter acme
- Paste your organization name when prompted
Add a display name for the Source (optional) and select Connect Source.
Assign which Guru Groups should have access to this content.

Setting Up Azure Dev Ops Wiki

Go to Manage > Sources.
Select Add Source.
Choose Azure Dev Ops Wiki from the list of available integrations.
Name your source (optional).
Use your credentials to sign into Azure Dev Ops Wiki.
Select an account. This is set at the organization level in Azure Dev Ops wiki, so if you have multiple accounts you'd like to sync, you'll connect Azure Dev Ops Wiki multiple times.
Select which wikis you want to sync into Guru.
Add a display name for the Source (optional) and select Connect Source.
Assign which Guru Groups should have access to this content.

Objects Synced From Azure Dev Ops

Azure Dev Ops Work Items

Primary objects are the objects used to generate the search record.

Common Model / What You'll See During Setup	Objects/Data Brought In	Key Fields
Ticket	Primary Objects: All work item types (Tasks, Bugs, User Stories, Features, Epics, etc.)	• Name • Description • Ticket type • Status (Enum) • Priority (Enum) • Due date • Creator (UUID) • Parent ticket (UUID) • Project (Unknown) • Ticket URL • Completed at • Remote created at • Remote updated at • Remote ID • Remote data
Tag	Tags/labels on work items	• Name
Attachment	File attachments on work items	• File name • File URL • Ticket (UUID) • Remote created at • Remote ID • Remote data
Comment	Discussion comments on work items	• Body • HTML body • User (UUID) • Ticket (UUID) • Remote created at • Remote ID • Remote data
Project	Azure DevOps projects	• Name • Description • Remote ID • Remote data
Collection	Project collections	• Name • Description • Collection URL • Remote created at • Remote updated at • Remote ID • Remote data
RemoteFieldClass	Custom field definitions	• Display name • Description • Remote key name • Item format • Item type • Is common model field (Boolean) • Remote ID • Remote data
User	Project and team members	• Name • Email address • Avatar • Teams (Array) • Remote ID • Remote data
Role	User roles/permissions	• Name
Team	Project teams	• Name • Description • Remote ID • Remote data

Azure Dev Ops Wiki

Provisioned Wikis that you select
Code Wikis that you select

Permissions

When you connect Azure Dev Ops Work Items or Wiki as a source in Guru, you'll permission that content in Guru. Learn more here.
If someone is not provided with access in Guru to this source, they will not see Azure Dev Ops results in searches or when chatting with Guru.

Frequently Asked Questions

What if I have multiple Azure Dev Ops Wiki organizations?

The integration connects at the Azure DevOps Organization level. If you have multiple organizations, you'll need to connect them seperately.

What if I add a wiki to Azure Dev Ops after I initially sync it?**

You'll need to navigate back to Manage > Sources, to the source, then select Reauthorize