Connect your Jira DC Instance in Sharepoint

If you want to connect content from a Jira DC instance to SharePoint, you must first make the instance available for the web part via a central configuration.

Prerequisites

• Steps have to be performed as Global Administrator in SharePoint Online

• You must have installed the SharePoint Online Management Shell on the client on which the configuration steps are to be carried out (and therefore also PowerShell)

Configure the SharePoint Online tenant property

If the prerequisites are met you have to perform the following steps to add your Jira DC instance as a SharePoint Online tenant property:

1. Sign in to the admin site of your SharePoint Online tenant using the Management Shell:

   # replace <my-company> with your companies SharePoint Online domain # replace <admin@mycompany.com> with the username of your administrator account Connect-SPOService -Url https://<my-company>-admin.sharepoint.com -Credential <admin@mycompany.com>

2. Prepare the configuration value for your Jira DC instance:

   $jira_dc_instance = [PSCustomObject]@{ # The name will be shown in the site selection of the webpart name = "Contoso Jira" # This has to be the url to your Jira DC instance url = "https://jira-dc.contoso.com" } #This variable will be used in the next step $myJiraDCConfig = @($jira_dc_instance) | ConvertTo-Json -Compress

3. Set the tenant property value:

   # The location of your global appcatalog (adjust the url) $global_app_catalog = "https://<my-company>.sharepoint.com/sites/appcatalog" # The property description $property_description = "Contains the list of Jira DC instances connected through the app SharePoint Connector for Jira" # Comment for updating the property value $comment = "Initial configuration to use Jira DC in the SharePoint Connector for Jira" # Don't change the key as the app will search for this one! Set-SPOStorageEntity -Site $global_app_catalog -Key senora-jira-dc-instances -Value $myJiraDCConfig -Description $property_description -Comments $comment

4. Check whether the Jira DC sites are available in the webpart:
   
   

   Open

   

   Picture 1: The configuration was successful when you can see the entry in the webpart property pane under Add another Jira

Configure multiple Jira DC instances

In case you want to make multiple Jira DC instances available for the webpart, you can use the same approach as shown above.

Here is an example how the configuration value could look like:

Delete the tenant property

In case you want to remove the Jira DC connection or you simply want to cleanup the system after uninstalling the app you can follow these steps to remove the tenant property:

1. Sign in to the admin site of your SharePoint Online tenant using the Management Shell:

2. Remove the tenant property: