Xurrent NodeHelper Methods

This guide explains which node helper methods are supported for xurrent.

Supported Methods

Method	Parameters	Return Type	Description
`getIssueType`	`issueTypeName: String`	`IHubIssueType`	Returns an issue type object with the given name
`getUser`	`userKey: String`	`IHubUser`	Returns a user by ID (delegates to `getUserById`)
`getUserById`	`userId: String`	`IHubUser`	Returns a user by Xurrent person ID; null if not found
`getUserByEmail`	`emailAddress: String`	`IHubUser`	Returns a user by email address; null if not found
`getLabel`	`label: String`	`IHubLabel`	Returns a label object with the given name
`getPriority`	`priorityName: String`	`IHubPriority`	Returns a priority object with the given name
`getStatus`	`statusName: String`	`IHubStatus`	Returns a status object with the given name
`isIssueEditable`	`issue: IHubIssue`	`boolean`	Always returns `true` for Xurrent requests
`stripHtml`	`htmlText: String`	`String`	Removes HTML tags from text using Jsoup

Xurrent-Specific Methods

Method	Parameters	Return Type	Description
`getCustomField`	`templateId: Long, fieldName: String, value: Object`	`BasicHubCustomField`	Creates a validated custom field with type checking
`getCustomFieldValueLabel`	`templateId: Long, fieldId: String, valueId: String`	`String`	Gets display label for a select option value
`getTemplateIdByName`	`templateName: String`	`Long`	Gets request template ID by name
`getServiceIdByName`	`serviceName: String`	`Long`	Gets service instance ID by name
`getTeamIdByName`	`teamName: String`	`Long`	Gets team ID by name

Rich Text Conversion Methods

Method	Parameters	Return Type	Description
`convertJiraWikiToXurrent`	`jiraWiki: String`	`String`	Converts Jira Wiki markup to Xurrent format
`convertHtmlToXurrent`	`html: String`	`String`	Converts HTML to Xurrent format
`convertXurrentToJiraWiki`	`xurrentText: String`	`String`	Converts Xurrent format to Jira Wiki markup
`convertXurrentToHtml`	`xurrentText: String`	`String`	Converts Xurrent format to HTML

NodeHelper Usage Examples

User Methods

// Get user by email
def user = nodeHelper.getUserByEmail("john.doe@example.com")
if (user) {
    entity.assignee = user
}

// Get user by ID
def member = nodeHelper.getUserById("12345")
if (member) {
    entity.member = member
}

Status, Priority, and Labels

// Set status
entity.status = nodeHelper.getStatus("In Progress")

// Set priority
entity.priority = nodeHelper.getPriority("High")

Template and Service Lookup

// Get template ID by name
def templateId = nodeHelper.getTemplateIdByName("IT Support Request")
entity.templateId = templateId

// Get service instance ID by name
def serviceId = nodeHelper.getServiceIdByName("IT Service Desk")
entity.serviceId = serviceId

// Get team ID by name
def teamId = nodeHelper.getTeamIdByName("IT Support Team")
entity.teamId = teamId

Rich Text Conversion

// Converting from Jira to Xurrent (incoming sync)
entity.description = nodeHelper.convertJiraWikiToXurrent(replica.description)

// Converting from Xurrent to Jira (outgoing sync)
replica.description = nodeHelper.convertXurrentToJiraWiki(entity.description)

// Converting HTML to Xurrent
entity.note = nodeHelper.convertHtmlToXurrent("<b>Important:</b> Please review")

// Strip HTML completely
def plainText = nodeHelper.stripHtml("<p>Hello <b>World</b></p>")
// Returns: "Hello World"

Supported Methods

Xurrent-Specific Methods

Rich Text Conversion Methods

NodeHelper Usage Examples

User Methods

Status, Priority, and Labels

Template and Service Lookup

Rich Text Conversion

Related Articles