Skip to content

docs(connectors): document ServiceDesk Plus custom fields, ticket templates and the mandatory-field error - #16574

Merged
Maffooch merged 2 commits into
DefectDojo:devfrom
Jino-T:docs/sdp-custom-fields-requester
Oct 31, 2026
Merged

Maffooch merged 2 commits into
DefectDojo:devfrom
Jino-T:docs/sdp-custom-fields-requester

Conversation

@Jino-T

@Jino-T Jino-T commented Oct 27, 2026

Copy link
Copy Markdown
Contributor

Description

Documents what the ServiceDesk Plus issue tracker connector now sends beyond its built-in fields, on the ServiceDesk Plus connector reference page:

  • The Custom Fields step, including setting a mandatory Requester, and how each Vendor Field is shaped for the ServiceDesk Plus v3 API: lookup fields by name, a field.attribute form such as requester.email_id, udf_* user-defined fields, and plain text for anything else.
  • When a mapping applies (Creation or Update), and that the built-in fields take precedence on a clash.
  • The Ticket Template step, which replaces the request description and falls back to the built-in one if it fails to render.
  • That a rejection for a missing mandatory field now names the field in the Integration errors table.

The connector change itself ships in the Pro integrators service in the same release.

Test results

Documentation only. The Markdown source was reviewed; the page was not rendered locally.

Documentation

This PR is the documentation change. English page only, matching recent connector reference updates.

Checklist

  • Make sure to rebase your PR against the very latest dev.
  • Submit all PRs, features and bug fixes alike, against the dev branch.
  • Give a meaningful name to your PR, as it may end up being used in the release notes.
  • Your code is Ruff compliant (see ruff.toml).
  • Your code is python 3.13 compliant.
  • If this is a new feature and not a bug fix, you've included the proper documentation in the docs at https://github.com/DefectDojo/django-DefectDojo/tree/dev/docs as part of this PR.
  • Model changes must include the necessary migrations in the dojo/db_migrations folder.
  • Add applicable tests to the unit tests.
  • Add the proper label to categorize your PR.

@Jino-T
Jino-T requested a review from Maffooch as a code owner October 27, 2026 19:22
@Jino-T Jino-T added this to the 3.5.0 milestone Oct 27, 2026
@Jino-T
Jino-T requested a review from blakeaowens as a code owner October 27, 2026 19:22
@github-actions github-actions Bot added the docs label Oct 27, 2026
@Maffooch
Maffooch added this pull request to the merge queue Oct 31, 2026
Merged via the queue into DefectDojo:dev with commit 71ab259 Oct 31, 2026
31 checks passed
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.

4 participants