Skip to content

docs(jira): Jira integrator guide — custom fields, ticket templates, test render#15226

Merged
Maffooch merged 3 commits into
bugfixfrom
docs/jira-integrator-guide
Jul 13, 2026
Merged

docs(jira): Jira integrator guide — custom fields, ticket templates, test render#15226
Maffooch merged 3 commits into
bugfixfrom
docs/jira-integrator-guide

Conversation

@Maffooch

@Maffooch Maffooch commented Jul 13, 2026

Copy link
Copy Markdown
Contributor

Shortcut: sc-13661

What

The Pro Jira integrator guide (docs-only; audience pro).

  • Authentication: Jira Cloud (API token, OAuth 2.0, service-account) and Data Center / Server (PAT, username + password); the api.atlassian.com gateway vs site-URL split; OAuth app setup; minimum classic & granular scopes; credentials encrypted at rest.

Added in this change — integrations_toolreference.md (Jira section)

  • Custom Fields: the source / value / vendor-field / application-point model — including the Vendor Field display-name → internal-id picker (e.g. DD Close Justificationcustomfield_10255) and transition-scoped fields (e.g. a resolution your workflow requires on close).
  • Ticket Templates: customer-authored Finding & Finding Group summary and description, each with built-in-default fallback, plus Test render to preview output against sample data before saving.

🤖 Generated with Claude Code

… OAuth setup

- Document the Basic, PAT, OAuth 2.0 (3LO), and service-account token auth methods.
- Absolute-minimum classic and granular scopes.
- OAuth app setup: Resource-level access type and 3LO callback registration.
- Behavioral notes: internal gateway API base vs public browse URL.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@Maffooch
Maffooch requested a review from mtesauro as a code owner July 13, 2026 15:01
@github-actions github-actions Bot added the docs label Jul 13, 2026
Extend the Jira integrator guide with the mapping features shipped in the
Jira work:

- Custom Fields: source / value / vendor-field / application-point model,
  including the Vendor Field display-name -> internal-id picker
  (e.g. "DD Close Justification" -> customfield_10255) and transition-scoped
  fields (e.g. a resolution required on close).
- Ticket Templates: customer-authored Finding & Finding Group summary and
  description with built-in-default fallback, plus Test render to preview
  output against sample data before saving.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@Maffooch
Maffooch force-pushed the docs/jira-integrator-guide branch from f4023fa to 07771dd Compare July 13, 2026 15:06
@Maffooch Maffooch changed the title docs(integrators): Pro Integrators guide — Jira Cloud OAuth, custom fields, ticket templates + new vendors docs(jira): Jira integrator guide — custom fields, ticket templates, test render Jul 13, 2026
@github-actions

Copy link
Copy Markdown
Contributor

This pull request has conflicts, please resolve those before we can evaluate the pull request.

@Maffooch
Maffooch requested review from Jino-T and paulOsinski July 13, 2026 15:46
@github-actions

Copy link
Copy Markdown
Contributor

Conflicts have been resolved. A maintainer will review the pull request shortly.

@paulOsinski

Copy link
Copy Markdown
Contributor

changed a few things

  • reordered the lists to be alphabetical
  • removed the "link paths to nowhere" from the first list
  • corrected link paths on the 2nd list to point to the correct URL

@Maffooch Maffooch added this to the 3.1.100 milestone Jul 13, 2026
@Maffooch
Maffooch merged commit d82d4c3 into bugfix Jul 13, 2026
151 checks passed
@Maffooch
Maffooch deleted the docs/jira-integrator-guide branch July 13, 2026 16:49
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants