October 11-13, 2022

GitKon 2022

Git Integration for Jira Self-Managed (Data Center/Server) Documentation

ScriptRunner – Javadocs – Class IntegrationRequest

This is a POJO object containing an integration properties/settings.

Summary

Constructors

Visibility Signature
public IntegrationRequest()
public IntegrationRequest(IntegrationType type, String origin, String pat, String displayName)

Methods

Type and modifiers Method signature
public String getApiFilter()
public String getApiPath()
public String getAwsRegion()
public Boolean getDisableSslVerification()
public Boolean getDisabled()
public String getDisplayName()
public Integer getFolderDepth()
public Boolean getGitViewerEnabled()
public Boolean getGlobal()
public Integer getMaxMinsToCommitEmail()
public String getOrigin()
public String getPassword()
public String getPat()
public Set < Long > getProjectMappingIds()
public Boolean getRefSpecChanges()
public String getRefSpecCustom()
public Boolean getRefSpecNotes()
public Boolean getRequireUserPat()
public Boolean getRevisionIndexing()
public Boolean getSendCommitEmails()
public Boolean getSmartCommitsEnabled()
public Boolean getSourcesDiffViewEnabled()
public String getTagsFilter()
public String getTfsCollection()
public Boolean getTrustFolderStat()
public String getType()
public String getUsername()
public void setApiFilter( String apiFilter)
public void setApiPath( String apiPath)
public void setAwsRegion( String awsRegion)
public void setDisableSslVerification( Boolean disableSslVerification)
public void setDisabled( Boolean disabled)
public void setDisplayName( String displayName)
public void setFolderDepth( Integer folderDepth)
public void setGitViewerEnabled( Boolean gitViewerEnabled)
public void setGlobal( Boolean global)
public void setMaxMinsToCommitEmail( Integer maxMinsToCommitEmail)
public void setOrigin( String origin)
public void setPassword( String password)
public void setPat( String pat)
public void setProjectMappingIds( Set < Long > projectMappingIds)
public void setRefSpecChanges( Boolean refSpecChanges)
public void setRefSpecCustom( String refSpecCustom)
public void setRefSpecNotes( Boolean refSpecNotes)
public void setRequireUserPat( Boolean requireUserPat)
public void setRevisionIndexing( Boolean revisionIndexing)
public void setSendCommitEmails( Boolean sendCommitEmails)
public void setSmartCommitsEnabled( Boolean smartCommitsEnabled)
public void setSourcesDiffViewEnabled( Boolean sourcesDiffViewEnabled)
public void setTagsFilter( String tagsFilter)
public void setTfsCollection( String tfsCollection)
public void setTrustFolderStat( Boolean trustFolderStat)
public void setType( String type)
public void setUsername( String username)

Constructors

IntegrationRequest()

IntegrationRequest(IntegrationType, String, String, String)

Methods

getApiFilter()

Returns the JMESPath Filter property of the integration.

getApiPath()

Returns the Custom API Path property of the integration.

getAwsRegion()

Returns the AWS region property. Used for AWS integrations only.

getDisableSslVerification()

Returns the SSL Verify setting.

getDisabled()

Returns the whether the integration is disabled.

getDisplayName()

Returns the display name of the integration.

getFolderDepth()

Returns the Folder Depth property. Used for tracked folders only.

getGitViewerEnabled()

Returns whether Repository Browser feature is enabled (true) or not (false).
For more information, see section, Repository Browser.

getGlobal()

Returns whether the integration repositories are visible for all projects.

getMaxMinsToCommitEmail()

Returns the property "Max commit age in minutes" value.

getOrigin()

Returns the Origin of the integration.

getPassword()

Returns password.

getPat()

Returns PAT.

getProjectMappingIds()

Returns the numeric projects IDs associated with the repository.

getRefSpecChanges()

getRefSpecCustom()

getRefSpecNotes()

getRequireUserPat()

Returns the value of the Require User PAT property.

getRevisionIndexing()

getSendCommitEmails()

Returns the property "Send email notifications" value.

getSmartCommitsEnabled()

Returns whether smart commits processing for the integration repositories is enabled (true) or not (false).

getSourcesDiffViewEnabled()

getTagsFilter()

getTfsCollection()

Returns the TFS Collection property. Used for Microsoft integrations only.

getTrustFolderStat()

getType()

Returns the type of the integration.

getUsername()

Returns the username for the git host.

setApiFilter(String)

Sets the JMESPath Filter property.
It is a JMESPath filter expression. The expression will be used to filter API results such as repository names, etc.
For more information, see article Working with JMESPath filters.

GIJFacade.createIntegration(): Optional.
GIJFacade.updateIntegration(): Optional.

Parameters

  • apiFilter: new JMESPath Filter

setApiPath(String)

Sets Custom API Path property. The integration will use the relative REST API path starting with "/" to retrieve the list of tracked repositories.
For more information, see Working with Custom API path

GIJFacade.createIntegration(): Optional.
GIJFacade.updateIntegration(): Optional.

Parameters

  • apiPath:

setAwsRegion(String)

Sets AWS region; where CodeCommit repositories are located. The list of regions with their names can be found here.

Supported regions:

  • us-east-1
  • us-east-2
  • us-west-1
  • us-west-2
  • ap-south-1
  • ap-northeast-2
  • ap-southeast-1
  • ap-southeast-2
  • ap-northeast-1
  • ca-central-1
  • eu-central-1
  • eu-west-1
  • eu-west-2
  • eu-west-3
  • eu-north-1
  • me-south-1
  • sa-east-1

GIJFacade.createIntegration(): Optional. Required for AWS integration creation.
GIJFacade.updateIntegration(): Optional.

Parameters

  • awsRegion:

setDisableSslVerification(Boolean)

Sets SSL Verify setting.

The SSL Verify setting is set to Enabled by default. If set to Disabled, the Git Integration for Jira app will ignore verification of SSL certificates when connecting to a git server.

GIJFacade.createIntegration(): Optional. The default value for this setting is false.
GIJFacade.updateIntegration(): Optional.

Parameters

  • disableSslVerification:

setDisabled(Boolean)

Sets the disabled flag for the integration.

Set the repository status to updated (enabled) or disabled. If left blank, the default setting for this field is false.

GIJFacade.createIntegration(): Optional. The default value is false

GIJFacade.updateIntegration(): Optional.

Parameters

  • disabled: the new value of ‘disabled’ flag

setDisplayName(String)

Sets the display name of the integration.
This is the name that will appear in the Git Integration for Jira app repositories list.

GIJFacade.createIntegration(): Optional. Autogenerated by default.

GIJFacade.updateIntegration(): Optional.

Parameters

  • displayName: the new display name

setFolderDepth(Integer)

Sets Folder Depth property. Used for tracked folders only.

GIJFacade.createIntegration(): Optional. The default value is 1.
GIJFacade.updateIntegration(): Optional.

Parameters

  • folderDepth:

setGitViewerEnabled(Boolean)

Enables or disables Repository Browser feature.

GIJFacade.createIntegration(): Optional. Is true by default.
GIJFacade.updateIntegration(): Optional.

Parameters

  • gitViewerEnabled: new value for "Repository Browser" parameter

setGlobal(Boolean)

If set to true, the projectMappingIds parameter is ignored. Otherwise, the projectMappingIds parameter value(s) are applied.

Parameters

  • global: new value for "Associate with all projects" property

setMaxMinsToCommitEmail(Integer)

Sets the property "Max commit age in minutes" for the integration email notification for commits.

GIJFacade.createIntegration(): Optional. The default value is 1440 minutes.
GIJFacade.updateIntegration(): Optional.

Parameters

  • maxMinsToCommitEmail: the new value of ‘Max commit age in minutes’ property

setOrigin(String)

Sets the Origin of the integration.
This is the URL to the hosted git service used on the project.

For example, you might host your repository on GitHub, Beanstalk or your own server.

GIJFacade.createIntegration(): Required.
GIJFacade.updateIntegration(): Optional.

Parameters

  • origin: the new origin.

setPassword(String)

setPat(String)

setProjectMappingIds(Set<Long>)

Sets numeric projects IDs associated with the repository.

This field accepts list of comma separated project IDs for project mapping. Trailing spaces are ignored (equivalent to unchecking the Associate to All Projects checkbox in the Advanced Setup dialog).

Example: “projectMappingIds”: [10000,10100]

GIJFacade.createIntegration(): Optional.
GIJFacade.updateIntegration(): Optional.

Parameters

  • projectMappingIds: new list of projects associated with the repository

setRefSpecChanges(Boolean)

setRefSpecCustom(String)

setRefSpecNotes(Boolean)

setRequireUserPat(Boolean)

Setting this parameter to true will require users to specify their own PAT for branch and pull/merge request management.

GIJFacade.createIntegration(): Optional. Is false by default.
GIJFacade.updateIntegration(): Optional.

Parameters

  • requireUserPat: new value for "Require User PAT" parameter

setRevisionIndexing(Boolean)

setSendCommitEmails(Boolean)

Sets the property "Send email notifications" for the integration.

GIJFacade.createIntegration(): Optional. The default value is false.
GIJFacade.updateIntegration(): Optional.

Parameters

  • sendCommitEmails: the new value of ‘Send email notifications’ property

setSmartCommitsEnabled(Boolean)

Enables or disables smart commits processing.

GIJFacade.createIntegration(): Optional. Is true by default.
GIJFacade.updateIntegration(): Optional.

Parameters

  • smartCommitsEnabled: new value for "Smart Commits" parameter

setSourcesDiffViewEnabled(Boolean)

setTagsFilter(String)

setTfsCollection(String)

Sets TFS Collection property. Used for Microsoft integrations only.

GIJFacade.createIntegration(): Optional.
GIJFacade.updateIntegration(): Optional.

Parameters

  • tfsCollection: new collection

setTrustFolderStat(Boolean)

setType(String)

Sets type of the integration. Available values are the following:

  • GITHUB – integration with Github.com
  • GITHUB_SERVER – integration with GitHub Enterprise
  • GITLAB – integration with GitLab.com
  • GITLAB_SERVER – integration with GitLab Server (CE/EE) (APIv4)
  • GITLAB_SERVER_LEGACY – integration with GitLab Server (CE/EE) Legacy (APIv3)
  • FILESPACE – integration for a tracked folder
  • AZURE_DEVOPS – integration with Azure DevOps Repos
  • VSTS – integration with Visual Studio Team Services (VSTS)
  • AZURE – integration with Azure DevOps Server
  • TFS_SERVER – integration with Team Foundation Server (TFS)
  • AWS – integration with AWS CodeCommit
  • GERRIT – integration with Gerrit Code Review

GIJFacade.createIntegration(): Required.
GIJFacade.updateIntegration(): is not allowed to be changed.

Parameters

  • type: type of a new integration

setUsername(String)

Sets as username for the git host. Leave blank and use PAT if 2FA is enabled on the git server.

Parameters

  • username:
Have feedback about this article? Did we miss something? Let us know!
On this page