• Package com.bigbrassband.jira.git.rest.integration
• Object > IntegrationRequest (This page)

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 String	getGithubAppClientId()
public String	getGithubAppClientSecret()
public String	getGithubAppHtmlUrl()
public Long	getGithubAppId()
public Integer	getGithubAppInstallationId()
public String	getGithubAppName()
public String	getGithubAppOrg()
public String	getGithubAppPem()
public String	getGithubAppSecret()
public String	getGithubAppSlug()
public Boolean	getGithubAppSuspended()
public String	getGithubAppWebhookSecret()
public Boolean	getGlobal()
public String	getGroup()
public Integer	getMaxMinsToCommitEmail()
public String	getOrigin()
public String	getPassword()
public String	getPat()
public String	getPrHideFilter()
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	setPrHideFilter( String prHideFilter)
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.

getGithubAppClientId()

getGithubAppClientSecret()

getGithubAppHtmlUrl()

getGithubAppId()

getGithubAppInstallationId()

getGithubAppName()

getGithubAppOrg()

getGithubAppPem()

getGithubAppSecret()

getGithubAppSlug()

getGithubAppSuspended()

getGithubAppWebhookSecret()

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.

getPrHideFilter()

Returns the regexp string of the pull request filter.

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
• af-south-1
• ap-east-1
• ap-south-1
• ap-south-2
• ap-northeast-3
• ap-northeast-2
• ap-southeast-1
• ap-southeast-3
• ap-southeast-2
• ap-northeast-1
• ca-central-1
• eu-central-1
• eu-central-2
• eu-west-1
• eu-west-2
• eu-west-3
• eu-south-1
• eu-south-2
• eu-north-1
• me-central-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)

setPrHideFilter(String)

Set the regexp for the pull request filter.

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: