Dela via

Cireson Service Manager Portal

  • Reference

Create and Update Work Items through the Cireson Portal for System Center Service Manager

This connector is available in the following products and regions:

Service Class Regions
Logic Apps Standard All Logic Apps regions except the following:
     -   Azure Government regions
     -   Azure China regions
     -   US Department of Defense (DoD)
Power Automate Premium All Power Automate regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Power Apps Premium All Power Apps regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Contact
Name Cireson
URL https://cireson.com
Email support@cireson.com
Connector Metadata
Publisher Cireson
Website https://cireson.com/
Privacy policy https://cireson.com/privacy-statement/
Categories AI;Website

Extend your Cireson Service Manager Portal investment into the M365 ecosystem with the ability to control Work Items from Power Automate.

Prerequisites

You will need an active Cireson Service Manager Portal license and your portal must be internet facing.

How to get credentials

Create a Platform (API) Token in your Service Manager Portal as outlined at https://kb.cireson.com/article/user-guide-authentication-tokens-and-knowledge-base-reporting/2507.

Get started with your connector

Several common operations are supported such as:

  • When a New Comment is Added
    • This event occurs anytime a comment is added to any Work Item. You can filter this event to either Analyst Comments or End User Comments
  • When a New Work Item is Created
    • This event occurs anytime a Work Item is created. You can filter this event to either Incident, Service Request, Change Request, Problem, or Release Record
  • Create/Update a Work Item
    • This action can be used to change common properties on a Work Item such as Title, Description, Priority, Urgency, as well as the Assigned/Affected User by their email address. By using a User's email address, you can tie in other M365 integrations where an email is used to identify a user.

Creating a connection

The connector supports the following authentication types:
Default Parameters for creating connection. All regions Not shareable

Default

Applicable: All regions

Parameters for creating connection.

This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.

Name Type Description Required
Portal URL string Service Manager Portal URL True
APIKey securestring The APIKey for this api True

Throttling Limits

Name Calls Renewal Period
API calls per connection 100 60 seconds

Actions

Add Comment to Work Item

Add action log comments to a work item
Create a Change Request

Create a Change Request
Create a Problem

Create a Problem
Create a Release Record

Create a Release Record
Create a Service Request

Create a Service Request
Create an Incident

Create an Incident
Delete Work Item

Delete Work Item
Get Work Item

Get Work Item data given the Id
Update an Incident

Update an Incident
Update Change Request

Update Change Request
Update Problem

Update Problem
Update Release Record

Update ReleaseRecord
Update Service Request

Update Service Request

Add Comment to Work Item

Operation ID:
AddCommentLog

Add action log comments to a work item

Parameters

Name Key Required Type Description
Work Item Id
 id True string

Work Item Id
Comment
 Description string

Comment
Added By
 EnteredBy string

Added By
Is Private
 IsPrivate boolean

Is Private
Comment Type
 ActionType string

Comment Type

Returns

Body
WorkItem_ActionLogResponse

Create a Change Request

Operation ID:
CreateChangeRequest

Create a Change Request

Parameters

Name Key Required Type Description
Title
 Title string

Title
Description
 Description string

Description
Priority
 Priority string

Priority
Area
 Area string

Area
Impact
 Impact string

Impact
Risk
 Risk string

Risk
Status
 Status string

Status
Assigned User
 AssignedWorkItem string

Assigned User

Returns

Body
WorkItem_CreatedSRResponse

Create a Problem

Operation ID:
CreateProblem

Create a Problem

Parameters

Name Key Required Type Description
Title
 Title string

Title
Description
 Description string

Description
Priority
 Priority string

Priority
Source
 Source string

Source
Category
 Category string

Category
Impact
 Impact string

Impact
Urgency
 Urgency string

Urgency
Status
 Status string

Status
Assigned User
 AssignedWorkItem string

Assigned User

Returns

Body
WorkItem_CreatedIRResponse

Create a Release Record

Operation ID:
CreateReleaseRecord

Create a Release Record

Parameters

Name Key Required Type Description
Title
 Title string

Title
Description
 Description string

Description
Type
 Type string

Type
Category
 Category string

Category
Impact
 Impact string

Impact
Risk
 Risk string

Risk
Priority
 Priority string

Priority
Status
 Status string

Status
Assigned User
 AssignedWorkItem string

Assigned User

Returns

Body
WorkItem_CreatedSRResponse

Create a Service Request

Operation ID:
CreateServiceRequest

Create a Service Request

Parameters

Name Key Required Type Description
Title
 Title string

Title
Description
 Description string

Description
Priority
 Priority string

Priority
Area
 Area True string

Area
Urgency
 Urgency True string

Urgency
Source
 Source True string

Source
Support Group
 SupportGroup string

Support Group
Status
 Status string

Status
Affected User
 RequestedWorkItem string

Affected User
Assigned User
 AssignedWorkItem string

Assigned User

Returns

Body
WorkItem_CreatedSRResponse

Create an Incident

Operation ID:
CreateIncident

Create an Incident

Parameters

Name Key Required Type Description
Title
 Title string

Title
Description
 Description string

Description
Priority
 Priority integer

Priority
Classification
 Classification True string

Classification
Urgency
 Urgency True string

Urgency
Impact
 Impact True string

Impact
Source
 Source True string

Source
Support Group
 SupportGroup string

Support Group
Status
 Status string

Status
Affected User
 RequestedWorkItem string

Affected User
Assigned User
 AssignedWorkItem string

Assigned User

Returns

Body
WorkItem_CreatedIRResponse

Delete Work Item

Operation ID:
DeleteWorkItem

Delete Work Item

Parameters

Name Key Required Type Description
Work Item Id
 Id True string

Work Item Id

Returns

Name Path Type Description
message
 message string

message
success
 success boolean

success
data
 data string

data
exception
 exception string

exception
BaseId
 BaseId string

BaseId

Get Work Item

Operation ID:
GetWorkItem

Get Work Item data given the Id

Parameters

Name Key Required Type Description
Work Item Id
 WorkItemId True string

Work Item Id

Returns

Body
WorkItem_GetResponse

Update an Incident

Operation ID:
UpdateIncident

Update an Incident

Parameters

Name Key Required Type Description
Work Item Id
 Id True string

Work Item Id
Title
 Title string

Title
Description
 Description string

Description
Priority
 Priority integer

Priority
Classification
 Classification string

Classification
Urgency
 Urgency string

Urgency
Impact
 Impact string

Impact
Source
 Source string

Source
Support Group
 SupportGroup string

Support Group
Status
 Status string

Status
Affected User
 RequestedWorkItem string

Affected User
Assigned User
 AssignedWorkItem string

Assigned User

Returns

Body
WorkItem_CreatedIRResponse

Update Change Request

Operation ID:
UpdateChangeRequest

Update Change Request

Parameters

Name Key Required Type Description
Work Item Id
 Id True string

Work Item Id
Title
 Title string

Title
Description
 Description string

Description
Priority
 Priority string

Priority
Area
 Area string

Area
Impact
 Impact string

Impact
Risk
 Risk string

Risk
Status
 Status string

Status
Assigned User
 AssignedWorkItem string

Assigned User

Returns

Body
WorkItem_CreatedSRResponse

Update Problem

Operation ID:
UpdateProblem

Update Problem

Parameters

Name Key Required Type Description
Work Item Id
 Id True string

Work Item Id
Title
 Title string

Title
Description
 Description string

Description
Priority
 Priority string

Priority
Source
 Source string

Source
Category
 Category string

Category
Impact
 Impact string

Impact
Urgency
 Urgency string

Urgency
Status
 Status string

Status
Assigned User
 AssignedWorkItem string

Assigned User

Returns

Body
WorkItem_CreatedIRResponse

Update Release Record

Operation ID:
UpdateReleaseRecord

Update ReleaseRecord

Parameters

Name Key Required Type Description
Work Item Id
 Id True string

Work Item Id
Title
 Title string

Title
Description
 Description string

Description
Type
 Type string

Type
Category
 Category string

Category
Impact
 Impact string

Impact
Risk
 Risk string

Risk
Priority
 Priority string

Priority
Status
 Status string

Status
Assigned User
 AssignedWorkItem string

Assigned User

Returns

Body
WorkItem_CreatedSRResponse

Update Service Request

Operation ID:
UpdateServiceRequest

Update Service Request

Parameters

Name Key Required Type Description
Work Item Id
 Id True string

Work Item Id
Title
 Title string

Title
Description
 Description string

Description
Priority
 Priority integer

Priority
Classification
 Classification string

Classification
Urgency
 Urgency string

Urgency
Impact
 Impact string

Impact
Source
 Source string

Source
Support Group
 SupportGroup string

Support Group
Status
 Status string

Status
Affected User
 RequestedWorkItem string

Affected User
Assigned User
 AssignedWorkItem string

Assigned User

Returns

Body
WorkItem_CreatedSRResponse

Triggers

When a New Comment is Added

When a New Comment is Added
When a New Work Item is Created

When a New Work Item is Created

When a New Comment is Added

Operation ID:
CreateActionLogWebhook

When a New Comment is Added

Parameters

Name Key Required Type Description
Comment Type
 WorkItemClassType True string

Comment Type

Returns

Body
WorkItem_ActionLogWebhookResponse

When a New Work Item is Created

Operation ID:
CreateWebhook

When a New Work Item is Created

Parameters

Name Key Required Type Description
Work Item Type
 WorkItemClassType True string

Work Item Class Type

Returns

Body
WorkItem_WebhookResponse

Definitions

WorkItem_CreatedSRResponse

Name Path Type Description
Id
 Id string

Id
Title
 Title string

Title
Description
 Description string

Description
Priority
 Priority object

Priority
Classification
 Classification object

Classification
Urgency
 Urgency object

Urgency
Impact
 Impact object

Impact
Source
 Source object

Source
Support Group
 SupportGroup object

Support Group
Status
 Status object

Status
Assigned User
 AssignedWorkItem object

Assigned User
Affected User
 RequestedWorkItem object

Affected User

WorkItem_CreatedIRResponse

Name Path Type Description
Id
 Id string

Id
Title
 Title string

Title
Description
 Description string

Description
Priority
 Priority integer

Priority
Urgency
 Urgency object

Urgency
Impact
 Impact object

Impact
Source
 Source object

Source
Support Group
 SupportGroup object

Support Group
Status
 Status object

Status
Assigned User
 AssignedWorkItem object

Assigned User
Affected User
 RequestedWorkItem object

Affected User

WorkItem_GetResponse

Name Path Type Description
Id
 Id string

Id
Title
 Title string

Title
Description
 Description string

Description
Priority
 PriorityText string

Priority
Classification
 Classification object

Classification
Urgency
 Urgency object

Urgency
Impact
 Impact object

Impact
Source
 Source object

Source
Support Group
 SupportGroup object

Support Group
Status
 Status object

Status
Assigned User
 AssignedWorkItem object

Assigned User
Affected User
 RequestedWorkItem object

Affected User

WorkItem_WebhookResponse

Name Path Type Description
Id
 Id string

Id
Title
 Title string

Title
Description
 Description string

Description
Priority
 Priority

Priority
Classification
 Classification object

Classification
Urgency
 Urgency object

Urgency
Impact
 Impact object

Impact
Source
 Source object

Source
Support Group
 SupportGroup object

Support Group
Status
 Status object

Status
Assigned User
 AssignedWorkItem object

Assigned User
Affected User
 RequestedWorkItem object

Affected User

WorkItem_ActionLogResponse

Name Path Type Description
Id
 Id string

Id
Title
 Title string

Title
Applies To Trouble Ticket
 AppliesToTroubleTicket

Action Log entries for incident and problem
Applies To WorkItem
 AppliesToWorkItem

Action Log entries for workitems

WorkItem_ActionLogWebhookResponse

Name Path Type Description
Work Item Id
 WorkItemID string

Work Item Id
Entered By
 EnteredBy string

Entered By
Is Private
 IsPrivate boolean

Is Private
Comment
 Description string

Comment
Entered Date
 EnteredDate string

Entered Date
Last Modified Date
 LastModified string

Last Modified Date