{"type":"doc","content":[{"type":"paragraph","content":[{"text":"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.","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"Jira Cloud sites can be connected without this configuration as they are provided by Atlassian","type":"text"}]}]},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"minLevel":{"value":"1"},"maxLevel":{"value":"6"},"outline":{"value":"false"},"style":{"value":"none"},"type":{"value":"list"},"printable":{"value":"true"}},"macroMetadata":{"macroId":{"value":"b4825e52-f168-4556-a42b-18fa1d7f8345"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"0fbf0e2f-0163-47ab-bc5c-a6644ce8272c"}},{"type":"heading","attrs":{"level":3},"content":[{"text":"Prerequisites","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Steps have to be performed as ","type":"text"},{"text":"Global Administrator","type":"text","marks":[{"type":"strong"}]},{"text":" in SharePoint Online","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"You must have installed the ","type":"text"},{"text":"SharePoint Online Management Shell","type":"text","marks":[{"type":"strong"},{"type":"link","attrs":{"href":"https://learn.microsoft.com/en-us/powershell/sharepoint/sharepoint-online/connect-sharepoint-online?view=sharepoint-ps"}}]},{"text":" on the client on which the configuration steps are to be carried out (and therefore also PowerShell)","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Configure the SharePoint Online tenant property","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"These steps can also be used the same way to edit an existing configuration","type":"text"}]}]},{"type":"paragraph","content":[{"text":"If the prerequisites are met you have to perform the following steps to add your Jira DC instance as a ","type":"text"},{"text":"SharePoint Online tenant property","type":"text","marks":[{"type":"link","attrs":{"href":"https://learn.microsoft.com/en-us/sharepoint/dev/spfx/tenant-properties?tabs=msposh"}}]},{"text":":","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Sign in to the admin site of your SharePoint Online tenant using the Management Shell:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"powershell"},"content":[{"text":"# replace with your companies SharePoint Online domain\n# replace with the username of your administrator account\n\nConnect-SPOService -Url https://-admin.sharepoint.com -Credential ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Prepare the configuration value for your Jira DC instance:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"powershell"},"content":[{"text":"$jira_dc_instance = [PSCustomObject]@{\n # The name will be shown in the site selection of the webpart\n name = \"Contoso Jira\"\n # This has to be the url to your Jira DC instance\n url = \"https://jira-dc.contoso.com\"\n}\n\n#This variable will be used in the next step\n$myJiraDCConfig = @($jira_dc_instance) | ConvertTo-Json -Compress","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Set the tenant property value:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"powershell"},"content":[{"text":"# The location of your global appcatalog (adjust the url)\n$global_app_catalog = \"https://.sharepoint.com/sites/appcatalog\"\n# The property description\n$property_description = \"Contains the list of Jira DC instances connected through the app SharePoint Connector for Jira\"\n# Comment for updating the property value\n$comment = \"Initial configuration to use Jira DC in the SharePoint Connector for Jira\"\n\n# Don't change the key as the app will search for this one!\nSet-SPOStorageEntity -Site $global_app_catalog -Key senora-jira-dc-instances -Value $myJiraDCConfig -Description $property_description -Comments $comment","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Check whether the Jira DC sites are available in the webpart:","type":"text"},{"type":"hardBreak"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":250,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":293,"id":"24651bdd-c8fd-4e3c-abaf-13cde8f30ba7","collection":"contentId-528777224","type":"file","height":259}},{"type":"caption","content":[{"text":"Picture 1: The configuration was successful when you can see the entry in the webpart property pane under Add another Jira","type":"text"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Configure multiple Jira DC instances","type":"text"}]},{"type":"paragraph","content":[{"text":"In case you want to make multiple Jira DC instances available for the webpart, you can use the same approach as shown above.","type":"text"}]},{"type":"paragraph","content":[{"text":"Here is an example how the configuration value could look like:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"powershell"},"content":[{"text":"$jira_dc_instance_1 = [PSCustomObject]@{\n name = \"First Contoso Jira\"\n url = \"https://jira-dc-1.contoso.com\"\n}\n\n$jira_dc_instance_2 = [PSCustomObject]@{\n name = \"Second Contoso Jira\"\n url = \"https://jira-dc-2.contoso.com\"\n}\n\n#This variable will be used in the next step\n$myJiraDCConfig = @($jira_dc_instance_1, $jira_dc_instance_2) | ConvertTo-Json -Compress","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Delete the tenant property","type":"text"}]},{"type":"paragraph","content":[{"text":"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:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Sign in to the admin site of your SharePoint Online tenant using the Management Shell:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"powershell"},"content":[{"text":"# replace with your companies SharePoint Online domain\n# replace with the username of your administrator account\n\nConnect-SPOService -Url https://-admin.sharepoint.com -Credential ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Remove the tenant property:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"powershell"},"content":[{"text":"# The location of your global appcatalog (adjust the url)\n$global_app_catalog = \"https://.sharepoint.com/sites/appcatalog\"\n\nRemove-SPOStorageEntity -Site $global_app_catalog -Key senora-jira-dc-instances","type":"text"}]}]}]}],"version":1}

Browser not supported