ServiceDesk Plus
Versão de integração: 5.0
Configure o ServiceDesk Plus para funcionar com o Google Security Operations
- Para gerar a chave da API, em Bloqueio de utilizadores, navegue para Administração > Técnicos.
- Para gerar a chave da API para o técnico existente, clique no ícone de edição junto ao técnico. Por outro lado, se quiser gerar a chave da API para um novo técnico, clique no link Adicionar novo técnico e introduza os detalhes do técnico e conceda autorização de início de sessão.
- Clique em Gerar associação no bloco de detalhes da chave da API. Pode selecionar um período para a chave expirar através do ícone de calendário ou simplesmente manter a mesma chave perpetuamente.
- Se já tiver sido gerada uma chave para o técnico, é apresentado o link Voltar a gerar.
Configure a integração do ServiceDesk Plus no Google SecOps
Para obter instruções detalhadas sobre como configurar uma integração no Google SecOps, consulte o artigo Configure integrações.
Parâmetros de integração
Use os seguintes parâmetros para configurar a integração:
| Parâmetro | Tipo | Valor predefinido | Descrição |
|---|---|---|---|
| Raiz da API | String | http://{IP OR FQDN}:8080/api/v3/ | API Root do ServiceDesk Plus. |
Ações
Adicionar nota
Descrição
Quando quiser adicionar informações adicionais, incluindo informações técnicas, a um pedido específico com base nas suas observações, pode usar a opção para adicionar notas. Também pode usar notas para atualizar o estado do pedido.
Parâmetros
| Parâmetro | Tipo | Valor predefinido | Descrição |
|---|---|---|---|
| ID do pedido | String | N/A | O ID dos pedidos. |
| Nota | String | N/A | O conteúdo da nota. |
| É pública | Caixa de verificação | Desmarcado | Se a nota deve ser pública ou não. |
Executar em
Esta ação é executada em todas as entidades.
Resultados da ação
Enriquecimento de entidades
N/A
Estatísticas
N/A
Resultado do script
| Nome do resultado do script | Opções de valores | Exemplo |
|---|---|---|
| êxito | Verdadeiro/Falso | success:False |
Resultado JSON
N/A
Adicionar nota e aguardar resposta
Descrição
Adicione uma nota e aguarde que as novas notas sejam adicionadas ao pedido em questão.
Parâmetros
| Parâmetro | Tipo | Valor predefinido | Descrição |
|---|---|---|---|
| ID do pedido | String | N/A | O ID dos pedidos. |
| Nota | String | N/A | O conteúdo da nota. |
| É pública | Caixa de verificação | N/A | Se a nota deve ser pública ou não. |
Executar em
Esta ação é executada em todas as entidades.
Resultados da ação
Enriquecimento de entidades
N/A
Estatísticas
N/A
Resultado do script
| Nome do resultado do script | Opções de valores | Exemplo |
|---|---|---|
| new_notes | N/A | N/A |
Resultado JSON
N/A
Fechar pedido
Descrição
Quando um requerente tem a certeza de que o seu pedido foi atendido e o problema comunicado foi resolvido, o pedido pode ser encerrado
Parâmetros
| Parâmetro | Tipo | Valor predefinido | Descrição |
|---|---|---|---|
| ID do pedido | String | N/A | O ID do pedido. |
| Comentário | String | N/A | Fim do comentário. |
| Resolução confirmada | Caixa de verificação | N/A | Se a resolução da solicitação foi confirmada ou não. |
Executar em
Esta ação é executada em todas as entidades.
Resultados da ação
Enriquecimento de entidades
N/A
Estatísticas
N/A
Resultado do script
| Nome do resultado do script | Opções de valores | Exemplo |
|---|---|---|
| êxito | Verdadeiro/Falso | success:False |
Resultado JSON
N/A
Criar pedido de alerta
Descrição
Crie uma solicitação relacionada com um alerta do Google SecOps.
Parâmetros
| Parâmetro | Tipo | Valor predefinido | Descrição |
|---|---|---|---|
| Assunto | String | N/A | O assunto da solicitação. |
| Requerente | String | N/A | O requerente do pedido. Se não for especificado, é definido como o utilizador da chave da API. |
| Estado | String | N/A | O estado do pedido. |
| Técnico | String | N/A | O nome do técnico atribuído ao pedido. |
| Prioridade | String | N/A | A prioridade do pedido. |
| Urgência | String | N/A | A urgência do pedido. |
| Categoria | String | N/A | A categoria do pedido. |
| Modelo de pedido | String | N/A | O modelo do pedido. |
| Tipo de pedido | String | N/A | O tipo de solicitação. Exemplo: incidente, pedido de serviço |
| Tempo de vencimento (ms) | String | N/A | A data de conclusão do pedido em milissegundos. |
| Modo | String | N/A | O modo do pedido. |
| Nível | String | N/A | O nível do pedido. |
| Site | String | N/A | O site do pedido. |
| Grupo | String | N/A | O grupo do pedido. |
| Impacto | String | N/A | O impacto do pedido. |
Executar em
Esta ação é executada em todas as entidades.
Resultados da ação
Enriquecimento de entidades
N/A
Estatísticas
N/A
Resultado do script
| Nome do resultado do script | Opções de valores | Exemplo |
|---|---|---|
| êxito | Verdadeiro/Falso | success:False |
Resultado JSON
N/A
Criar pedido
Descrição
Se tiver uma falha ou um problema no seu sistema, apresente um problema, ou seja, envie um pedido à equipa do serviço de assistência técnica de TI. Existem diferentes modos de fazer um pedido: através de um formulário baseado na Web, do envio de uma notificação por email e de uma chamada telefónica. O ServiceDesk Plus oferece opções para registar detalhes de um pedido originado em qualquer um dos formulários mencionados acima.
Parâmetros
| Parâmetro | Tipo | Valor predefinido | Descrição |
|---|---|---|---|
| Assunto | String | N/A | O assunto da solicitação. |
| Requerente | String | N/A | O requerente do pedido. Se não for especificado, é definido como o utilizador da chave da API. |
| Descrição | String | N/A | A descrição do pedido. |
| Estado | String | N/A | O estado do pedido. |
| Técnico | String | N/A | O nome do técnico atribuído ao pedido. |
| Prioridade | String | N/A | A prioridade do pedido. |
| Urgência | String | N/A | A urgência do pedido. |
| Categoria | String | N/A | A categoria do pedido. |
| Modelo de pedido | String | N/A | O modelo do pedido. |
| Tipo de pedido | String | N/A | O tipo de solicitação. Exemplo: incidente, pedido de serviço |
| Tempo de vencimento (ms) | String | N/A | A data de conclusão do pedido em milissegundos. |
| Modo | String | N/A | O modo do pedido. |
| Nível | String | N/A | O nível do pedido. |
| Site | String | N/A | O site do pedido. |
| Grupo | String | N/A | O grupo do pedido. |
| Impacto | String | N/A | O impacto do pedido. |
Executar em
Esta ação é executada em todas as entidades.
Resultados da ação
Enriquecimento de entidades
N/A
Estatísticas
N/A
Resultado do script
| Nome do resultado do script | Opções de valores | Exemplo |
|---|---|---|
| request_id | N/A | N/A |
Resultado JSON
{
"isvipuser": "No",
"subcategory": null,
"resolvedtime": "0",
"site": "Chicago",
"timespentonreq": "0hrs 0min",
"technician": "Shawn Adams",
"responseduebytime": "1556101814544",
"shortdescription": "Testing the API adding request",
"fr_duetime": "1556101814544",
"subject": "Testing API 2",
"impact": "Affects Business",
"city": "London",
"group": null,
"approval_status": null,
"area": null,
"requesttype": "Convert the Incident to Change",
"yettoreplycount": null,
"priority": "High",
"respondedtime": "0",
"asset": null,
"createdby": "Demo",
"duebytime": "1556164814544",
"department": null,
"status": "Work Inprogress",
"category": "General",
"fcr": "false",
"description": "Testing the API adding request",
"closurecode": null,
"workorderid": "123",
"completedtime": "0",
"requesttemplate": "Default Request",
"requester": "Catrin Folkesson",
"createdtime": "1556092814544",
"technician_loginname": "adams",
"editing_status": "0",
"level": "Tier 1",
"country": "India",
"is_catalog_template": "false",
"sla": "High SLA",
"item": null,
"closurecomments": null,
"mode": "SMS",
"editorid": "null",
"impactdetails": null,
"urgency": "High"
}
Receber pedido
Descrição
Obter informações sobre um pedido.
Parâmetros
| Parâmetro | Tipo | Valor predefinido | Descrição |
|---|---|---|---|
| ID do pedido | String | N/A | O ID do pedido. |
Executar em
Esta ação é executada em todas as entidades.
Resultados da ação
Enriquecimento de entidades
N/A
Estatísticas
N/A
Resultado do script
| Nome do resultado do script | Opções de valores | Exemplo |
|---|---|---|
| êxito | Verdadeiro/Falso | success:False |
Resultado JSON
{
"isvipuser": "No",
"subcategory": null,
"resolvedtime": "0",
"site": "Chicago",
"timespentonreq": "0hrs 0min",
"technician": "Shawn Adams",
"responseduebytime": "1556101814544",
"shortdescription": "Testing the API adding request",
"fr_duetime": "1556101814544",
"subject": "Testing API 2",
"impact": "Affects Business",
"city": "London",
"group": null,
"approval_status": null,
"area": null,
"requesttype": "Convert the Incident to Change",
"yettoreplycount": null,
"priority": "High",
"respondedtime": "0",
"asset": null,
"createdby": "Demo",
"duebytime": "1556164814544",
"department": null,
"status": "Work Inprogress",
"category": "General",
"fcr": "false",
"description": "Testing the API adding request",
"closurecode": null,
"workorderid": "123",
"completedtime": "0",
"requesttemplate": "Default Request",
"requester": "Catrin Folkesson",
"createdtime": "1556092814544",
"technician_loginname": "adams",
"editing_status": "0",
"level": "Tier 1",
"country": "India",
"is_catalog_template": "false",
"sla": "High SLA",
"item": null,
"closurecomments": null,
"mode": "SMS",
"editorid": "null",
"impactdetails": null,
"urgency": "High"
}
Tchim-tchim
Descrição
Teste a conetividade à instância do ServiceDesk Plus.
Parâmetros
N/A
Executar em
Esta ação é executada em todas as entidades.
Resultados da ação
Enriquecimento de entidades
N/A
Estatísticas
N/A
Resultado do script
| Nome do resultado do script | Opções de valores | Exemplo |
|---|---|---|
| is_success | Verdadeiro/Falso | is_success:False |
Resultado JSON
N/A
Pedido de atualização
Descrição
Atualize um pedido.
Parâmetros
| Parâmetro | Tipo | Valor predefinido | Descrição |
|---|---|---|---|
| ID do pedido | String | N/A | O ID do pedido de atualização. |
| Requerente | String | N/A | O requerente do pedido. Se não for especificado, é definido como o utilizador da chave da API. |
| Descrição | String | N/A | A descrição do pedido. |
| Estado | String | N/A | O estado do pedido. |
| Técnico | String | N/A | O nome do técnico atribuído ao pedido. |
| Prioridade | String | N/A | A prioridade do pedido. |
| Urgência | String | N/A | A urgência do pedido. |
| Categoria | String | N/A | A categoria do pedido. |
| Modelo de pedido | String | N/A | O modelo do pedido. |
| Tipo de pedido | String | N/A | O tipo de solicitação. Exemplo: incidente, pedido de serviço |
| Tempo de vencimento (ms) | String | N/A | A data de conclusão do pedido em milissegundos. |
| Modo | String | N/A | O modo do pedido. |
| Nível | String | N/A | O nível do pedido. |
| Site | String | N/A | O site do pedido. |
| Grupo | String | N/A | O grupo do pedido. |
| Impacto | String | N/A | O impacto do pedido. |
Executar em
Esta ação é executada em todas as entidades.
Resultados da ação
Enriquecimento de entidades
N/A
Estatísticas
N/A
Resultado do script
| Nome do resultado do script | Opções de valores | Exemplo |
|---|---|---|
| êxito | Verdadeiro/Falso | success:False |
Resultado JSON
{
"isvipuser": "No",
"subcategory": null,
"resolvedtime": "0",
"site": "Chicago",
"timespentonreq": "0hrs 0min",
"technician": "Shawn Adams",
"responseduebytime": "1556101814544",
"shortdescription": "Testing the API adding request",
"fr_duetime": "1556101814544",
"subject": "Testing API 2",
"impact": "Affects Business",
"city": "London",
"group": null,
"approval_status": null,
"area": null,
"requesttype": "Convert the Incident to Change",
"yettoreplycount": null,
"priority": "High",
"respondedtime": "0",
"asset": null,
"createdby": "Demo",
"duebytime": "1556164814544",
"department": null,
"status": "Work Inprogress",
"category": "General",
"fcr": "false",
"description": "Testing the API adding request",
"closurecode": null,
"workorderid": "123",
"completedtime": "0",
"requesttemplate": "Default Request",
"requester": "Catrin Folkesson",
"createdtime": "1556092814544",
"technician_loginname": "adams",
"editing_status": "0",
"level": "Tier 1",
"country": "India",
"is_catalog_template": "false",
"sla": "High SLA",
"item": null,
"closurecomments": null,
"mode": "SMS",
"editorid": "null",
"impactdetails": null,
"urgency": "High"
}
Aguarde a atualização do campo
Descrição
Aguarde que um campo de pedido seja alterado para o valor pretendido.
Parâmetros
| Parâmetro | Tipo | Valor predefinido | Descrição |
|---|---|---|---|
| ID do pedido | String | N/A | O ID do pedido. |
| Nome do campo | String | N/A | O nome do campo a atualizar. |
| Valores | String | N/A | Valores desejados para o campo fornecido. |
Executar em
Esta ação é executada em todas as entidades.
Resultados da ação
Enriquecimento de entidades
N/A
Estatísticas
N/A
Resultado do script
| Nome do resultado do script | Opções de valores | Exemplo |
|---|---|---|
| new_value | N/A | N/A |
Resultado JSON
N/A
Aguarde pela atualização do estado
Descrição
Aguarde que o estado de um pedido seja atualizado para um estado desejado.
Parâmetros
| Parâmetro | Tipo | Valor predefinido | Descrição |
|---|---|---|---|
| ID do pedido | String | N/A | O ID do pedido. |
| Estados | String | N/A | Estados de pedidos desejados, separados por vírgulas. |
Executar em
Esta ação é executada em todas as entidades.
Resultados da ação
Enriquecimento de entidades
N/A
Estatísticas
N/A
Resultado do script
| Nome do resultado do script | Opções de valores | Exemplo |
|---|---|---|
| new_status | N/A | N/A |
Resultado JSON
N/A
Precisa de mais ajuda? Receba respostas de membros da comunidade e profissionais da Google SecOps.