Compartilhar via

Portal do Gerenciador de Serviços do Cireson

Criar e atualizar itens de trabalho por meio do Portal do Cireson para o System Center Service Manager

Esse conector está disponível nos seguintes produtos e regiões:

Service Class Regions
Copilot Studio Premium Todas as regiões do Power Automate , exceto as seguintes:
     – Governo dos EUA (GCC)
     – Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Aplicativos Lógicos Standard Todas as regiões dos Aplicativos Lógicos , exceto as seguintes:
     – Regiões do Azure Governamental
     - Regiões do Azure China
     - Departamento de Defesa dos EUA (DoD)
Power Apps Premium Todas as regiões do Power Apps , exceto as seguintes:
     – Governo dos EUA (GCC)
     – Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Power Automate Premium Todas as regiões do Power Automate , exceto as seguintes:
     – Governo dos EUA (GCC)
     – Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Contato
Nome Cireson
URL https://cireson.com
Email support@cireson.com
Metadados do conector
Publicador Cireson
Site https://cireson.com/
Política de privacidade https://cireson.com/privacy-statement/
Categorias IA; Site

Estenda o investimento do Portal do Cireson Service Manager no ecossistema do M365 com a capacidade de controlar itens de trabalho do Power Automate.

Pré-requisitos

Você precisará de uma licença ativa do Portal do Cireson Service Manager e seu portal deve estar voltado para a Internet.

Como obter credenciais

Crie um token de API (Plataforma) no portal do Service Manager, conforme descrito em https://kb.cireson.com/article/user-guide-authentication-tokens-and-knowledge-base-reporting/2507.

Introdução ao conector

Há suporte para várias operações comuns, como:

  • Quando um novo comentário é adicionado
    • Esse evento ocorre sempre que um comentário é adicionado a qualquer Item de Trabalho. Você pode filtrar esse evento para comentários de analista ou comentários do usuário final
  • Quando um novo item de trabalho é criado
    • Esse evento ocorre sempre que um Item de Trabalho é criado. Você pode filtrar esse evento para Incidente, Solicitação de Serviço, Solicitação de Alteração, Problema ou Registro de Versão
  • Criar/atualizar um item de trabalho
    • Essa ação pode ser usada para alterar propriedades comuns em um Item de Trabalho, como Título, Descrição, Prioridade, Urgência, bem como o Usuário Atribuído/Afetado por seu endereço de email. Usando o endereço de email de um usuário, você pode vincular outras integrações M365 em que um email é usado para identificar um usuário.

Criando uma conexão

O conector dá suporte aos seguintes tipos de autenticação:
Default Parâmetros para criar conexão. Todas as regiões Não compartilhável

Padrão

Aplicável: todas as regiões

Parâmetros para criar conexão.

Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Nome Tipo Description Obrigatório
URL do Portal cadeia Service Manager Portal URL Verdade
APIKey secureString A APIKey para esta api Verdade

Limitações

Nome Chamadas Período de renovação
Chamadas à API por conexão 100 60 segundos

Ações

Adicionar comentário ao item de trabalho

Adicionar comentários de log de ações a um item de trabalho
Atualizar registro de versão

Atualizar ReleaseRecord
Atualizar solicitação de alteração

Atualizar solicitação de alteração
Atualizar solicitação de serviço

Atualizar solicitação de serviço
Atualizar um incidente

Atualizar um incidente
Criar um incidente

Criar um incidente
Criar um problema

Criar um problema
Criar um registro de versão

Criar um registro de versão
Criar uma solicitação de alteração

Criar uma solicitação de alteração
Criar uma solicitação de serviço

Criar uma solicitação de serviço
Excluir Item de Trabalho

Excluir Item de Trabalho
Obter item de trabalho

Obter dados do Item de Trabalho considerando a ID
Problema de atualização

Problema de atualização

Adicionar comentário ao item de trabalho

ID da operação:
AddCommentLog

Adicionar comentários de log de ações a um item de trabalho

Parâmetros

Nome Chave Obrigatório Tipo Description
ID do item de trabalho
 id True string

ID do item de trabalho
Comment
 Description string

Comment
Adicionado por
 EnteredBy string

Adicionado por
É privado
 IsPrivate boolean

É privado
Tipo de comentário
 ActionType string

Tipo de comentário

Retornos

Corpo
WorkItem_ActionLogResponse

Atualizar registro de versão

ID da operação:
UpdateReleaseRecord

Atualizar ReleaseRecord

Parâmetros

Nome Chave Obrigatório Tipo Description
ID do item de trabalho
 Id True string

ID do item de trabalho
Title
 Title string

Title
Description
 Description string

Description
Tipo
 Type string

Tipo
Categoria
 Category string

Categoria
Impacto
 Impact string

Impacto
Risco
 Risk string

Risco
Priority
 Priority string

Priority
Situação
 Status string

Situação
Usuário Atribuído
 AssignedWorkItem string

Usuário Atribuído

Retornos

Corpo
WorkItem_CreatedSRResponse

Atualizar solicitação de alteração

ID da operação:
UpdateChangeRequest

Atualizar solicitação de alteração

Parâmetros

Nome Chave Obrigatório Tipo Description
ID do item de trabalho
 Id True string

ID do item de trabalho
Title
 Title string

Title
Description
 Description string

Description
Priority
 Priority string

Priority
Area
 Area string

Area
Impacto
 Impact string

Impacto
Risco
 Risk string

Risco
Situação
 Status string

Situação
Usuário Atribuído
 AssignedWorkItem string

Usuário Atribuído

Retornos

Corpo
WorkItem_CreatedSRResponse

Atualizar solicitação de serviço

ID da operação:
UpdateServiceRequest

Atualizar solicitação de serviço

Parâmetros

Nome Chave Obrigatório Tipo Description
ID do item de trabalho
 Id True string

ID do item de trabalho
Title
 Title string

Title
Description
 Description string

Description
Priority
 Priority integer

Priority
Classification
 Classification string

Classification
Urgência
 Urgency string

Urgência
Impacto
 Impact string

Impacto
Source
 Source string

Source
Grupo de Apoio
 SupportGroup string

Grupo de Apoio
Situação
 Status string

Situação
Usuário afetado
 RequestedWorkItem string

Usuário afetado
Usuário Atribuído
 AssignedWorkItem string

Usuário Atribuído

Retornos

Corpo
WorkItem_CreatedSRResponse

Atualizar um incidente

ID da operação:
UpdateIncident

Atualizar um incidente

Parâmetros

Nome Chave Obrigatório Tipo Description
ID do item de trabalho
 Id True string

ID do item de trabalho
Title
 Title string

Title
Description
 Description string

Description
Priority
 Priority integer

Priority
Classification
 Classification string

Classification
Urgência
 Urgency string

Urgência
Impacto
 Impact string

Impacto
Source
 Source string

Source
Grupo de Apoio
 SupportGroup string

Grupo de Apoio
Situação
 Status string

Situação
Usuário afetado
 RequestedWorkItem string

Usuário afetado
Usuário Atribuído
 AssignedWorkItem string

Usuário Atribuído

Retornos

Corpo
WorkItem_CreatedIRResponse

Criar um incidente

ID da operação:
CreateIncident

Criar um incidente

Parâmetros

Nome Chave Obrigatório Tipo Description
Title
 Title string

Title
Description
 Description string

Description
Priority
 Priority integer

Priority
Classification
 Classification True string

Classification
Urgência
 Urgency True string

Urgência
Impacto
 Impact True string

Impacto
Source
 Source True string

Source
Grupo de Apoio
 SupportGroup string

Grupo de Apoio
Situação
 Status string

Situação
Usuário afetado
 RequestedWorkItem string

Usuário afetado
Usuário Atribuído
 AssignedWorkItem string

Usuário Atribuído

Retornos

Corpo
WorkItem_CreatedIRResponse

Criar um problema

ID da operação:
CreateProblem

Criar um problema

Parâmetros

Nome Chave Obrigatório Tipo Description
Title
 Title string

Title
Description
 Description string

Description
Priority
 Priority string

Priority
Source
 Source string

Source
Categoria
 Category string

Categoria
Impacto
 Impact string

Impacto
Urgência
 Urgency string

Urgência
Situação
 Status string

Situação
Usuário Atribuído
 AssignedWorkItem string

Usuário Atribuído

Retornos

Corpo
WorkItem_CreatedIRResponse

Criar um registro de versão

ID da operação:
CreateReleaseRecord

Criar um registro de versão

Parâmetros

Nome Chave Obrigatório Tipo Description
Title
 Title string

Title
Description
 Description string

Description
Tipo
 Type string

Tipo
Categoria
 Category string

Categoria
Impacto
 Impact string

Impacto
Risco
 Risk string

Risco
Priority
 Priority string

Priority
Situação
 Status string

Situação
Usuário Atribuído
 AssignedWorkItem string

Usuário Atribuído

Retornos

Corpo
WorkItem_CreatedSRResponse

Criar uma solicitação de alteração

ID da operação:
CreateChangeRequest

Criar uma solicitação de alteração

Parâmetros

Nome Chave Obrigatório Tipo Description
Title
 Title string

Title
Description
 Description string

Description
Priority
 Priority string

Priority
Area
 Area string

Area
Impacto
 Impact string

Impacto
Risco
 Risk string

Risco
Situação
 Status string

Situação
Usuário Atribuído
 AssignedWorkItem string

Usuário Atribuído

Retornos

Corpo
WorkItem_CreatedSRResponse

Criar uma solicitação de serviço

ID da operação:
CreateServiceRequest

Criar uma solicitação de serviço

Parâmetros

Nome Chave Obrigatório Tipo Description
Title
 Title string

Title
Description
 Description string

Description
Priority
 Priority string

Priority
Area
 Area True string

Area
Urgência
 Urgency True string

Urgência
Source
 Source True string

Source
Grupo de Apoio
 SupportGroup string

Grupo de Apoio
Situação
 Status string

Situação
Usuário afetado
 RequestedWorkItem string

Usuário afetado
Usuário Atribuído
 AssignedWorkItem string

Usuário Atribuído

Retornos

Corpo
WorkItem_CreatedSRResponse

Excluir Item de Trabalho

ID da operação:
DeleteWorkItem

Excluir Item de Trabalho

Parâmetros

Nome Chave Obrigatório Tipo Description
ID do item de trabalho
 Id True string

ID do item de trabalho

Retornos

Nome Caminho Tipo Description
mensagem
 message string

mensagem
sucesso
 success boolean

sucesso
dados
 data string

dados
exceção
 exception string

exceção
BaseId
 BaseId string

BaseId

Obter item de trabalho

ID da operação:
GetWorkItem

Obter dados do Item de Trabalho considerando a ID

Parâmetros

Nome Chave Obrigatório Tipo Description
ID do item de trabalho
 WorkItemId True string

ID do item de trabalho

Retornos

Corpo
WorkItem_GetResponse

Problema de atualização

ID da operação:
UpdateProblem

Problema de atualização

Parâmetros

Nome Chave Obrigatório Tipo Description
ID do item de trabalho
 Id True string

ID do item de trabalho
Title
 Title string

Title
Description
 Description string

Description
Priority
 Priority string

Priority
Source
 Source string

Source
Categoria
 Category string

Categoria
Impacto
 Impact string

Impacto
Urgência
 Urgency string

Urgência
Situação
 Status string

Situação
Usuário Atribuído
 AssignedWorkItem string

Usuário Atribuído

Retornos

Corpo
WorkItem_CreatedIRResponse

Gatilhos

Quando um novo comentário é adicionado

Quando um novo comentário é adicionado
Quando um novo item de trabalho é criado

Quando um novo item de trabalho é criado

Quando um novo comentário é adicionado

ID da operação:
CreateActionLogWebhook

Quando um novo comentário é adicionado

Parâmetros

Nome Chave Obrigatório Tipo Description
Tipo de comentário
 WorkItemClassType True string

Tipo de comentário

Retornos

Corpo
WorkItem_ActionLogWebhookResponse

Quando um novo item de trabalho é criado

ID da operação:
CreateWebhook

Quando um novo item de trabalho é criado

Parâmetros

Nome Chave Obrigatório Tipo Description
Tipo de Item de Trabalho
 WorkItemClassType True string

Tipo de classe de item de trabalho

Retornos

Corpo
WorkItem_WebhookResponse

Definições

WorkItem_CreatedSRResponse

Nome Caminho Tipo Description
ID
 Id string

ID
Title
 Title string

Title
Description
 Description string

Description
Priority
 Priority object

Priority
Classification
 Classification object

Classification
Urgência
 Urgency object

Urgência
Impacto
 Impact object

Impacto
Source
 Source object

Source
Grupo de Apoio
 SupportGroup object

Grupo de Apoio
Situação
 Status object

Situação
Usuário Atribuído
 AssignedWorkItem object

Usuário Atribuído
Usuário afetado
 RequestedWorkItem object

Usuário afetado

WorkItem_CreatedIRResponse

Nome Caminho Tipo Description
ID
 Id string

ID
Title
 Title string

Title
Description
 Description string

Description
Priority
 Priority integer

Priority
Urgência
 Urgency object

Urgência
Impacto
 Impact object

Impacto
Source
 Source object

Source
Grupo de Apoio
 SupportGroup object

Grupo de Apoio
Situação
 Status object

Situação
Usuário Atribuído
 AssignedWorkItem object

Usuário Atribuído
Usuário afetado
 RequestedWorkItem object

Usuário afetado

WorkItem_GetResponse

Nome Caminho Tipo Description
ID
 Id string

ID
Title
 Title string

Title
Description
 Description string

Description
Priority
 PriorityText string

Priority
Classification
 Classification object

Classification
Urgência
 Urgency object

Urgência
Impacto
 Impact object

Impacto
Source
 Source object

Source
Grupo de Apoio
 SupportGroup object

Grupo de Apoio
Situação
 Status object

Situação
Usuário Atribuído
 AssignedWorkItem object

Usuário Atribuído
Usuário afetado
 RequestedWorkItem object

Usuário afetado

WorkItem_WebhookResponse

Nome Caminho Tipo Description
ID
 Id string

ID
Title
 Title string

Title
Description
 Description string

Description
Priority
 Priority

Priority
Classification
 Classification object

Classification
Urgência
 Urgency object

Urgência
Impacto
 Impact object

Impacto
Source
 Source object

Source
Grupo de Apoio
 SupportGroup object

Grupo de Apoio
Situação
 Status object

Situação
Usuário Atribuído
 AssignedWorkItem object

Usuário Atribuído
Usuário afetado
 RequestedWorkItem object

Usuário afetado

WorkItem_ActionLogResponse

Nome Caminho Tipo Description
ID
 Id string

ID
Title
 Title string

Title
Aplica-se ao tíquete de problemas
 AppliesToTroubleTicket

Entradas do Log de Ações para incidentes e problemas
Aplica-se ao WorkItem
 AppliesToWorkItem

Entradas do Log de Ações para workitems

WorkItem_ActionLogWebhookResponse

Nome Caminho Tipo Description
ID do item de trabalho
 WorkItemID string

ID do item de trabalho
Inserido por
 EnteredBy string

Inserido por
É privado
 IsPrivate boolean

É privado
Comment
 Description string

Comment
Data de entrada
 EnteredDate string

Data de entrada
Data da última modificação
 LastModified string

Data da última modificação