BMC Helix Remedyforce
Versão da integração: 11.0
Exemplos de utilização
- Realize a carregamento dos incidentes
- Realizar ação de triagem (atualizar/criar/eliminar registos)
Como configurar a autenticação OAuth
Por vezes, o método de autenticação básica que usa o nome de utilizador e a palavra-passe não funciona. Isto pode acontecer quando a MFA está ativada para a conta. Nessas situações, tem de configurar a autenticação OAuth.
Passos:
- Navegue para Configuração -> Gestor de apps.
- Prima o botão "Nova app associada".
- Indique o "Nome da app associada", o "Nome da API" e o "Email de contacto".
- "Enable OAuth Settings" deve estar definido como verdadeiro.
- Defina o "URL de retorno" como "https://localhost".
- Adicione os âmbitos "full" e "refresh_token". Ambos são necessários para aceder à API.
- Guarde a app.
- Abra a configuração da app e copie a "Chave do consumidor" e o "Segredo do consumidor". A "chave de consumidor" é o "ID de cliente" e o "segredo do consumidor" é o segredo do cliente na configuração da integração.
- Aceda à ação "Obter código de autorização OAuth". "URL de redirecionamento" é "URL de callback".
- Executar ação. No resultado JSON, tem um URL de autorização. Tem de o copiar e colar no seu navegador. No final, vai ser redirecionado e o seu URL vai ter o seguinte aspeto: "https://localhost/?code=aPrxyeILZDvX2Hhmz2gymvtuE4aow6hMnAKw_98FyXJvaN7l69bJZFr1z.ylZ3qXd0KZlXjn0g%3D%3D". Tem de copiar tudo o que estiver depois de "code=" e certificar-se de que faz a descodificação do URL. %3D é o caráter "=".
- Aceda à ação "Get OAuth Refresh Token" (Obter token de atualização do OAuth). O "URL de redirecionamento" é o "URL de retorno de chamada" e o "código de autorização" é o "código" do pedido anterior.
- Se tudo tiver sido feito corretamente, verá "refresh_token" no resultado JSON.
- Copie este token de atualização para a configuração da integração e execute um teste.
Configure a integração do BMC Helix Remedyforce no Google Security Operations
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:
Nome a apresentar do parâmetro | Tipo | Valor predefinido | É obrigatório | Descrição |
---|---|---|---|---|
Raiz da API | String | https://.my.salesforce.com | Sim | Raiz da API da instância do BMC Helix Remedyforce. |
Nome de utilizador | String | N/A | Não | Nome de utilizador do BMC Helix Remedyforce. |
Palavra-passe | Palavra-passe | N/A | Não | Palavra-passe do BMC Helix Remedyforce. |
ID do cliente | String | N/A | Não | ID de cliente do BMC Helix Remedyforce da app associada. Este parâmetro é necessário para a autenticação OAuth. Nota: este parâmetro tem prioridade sobre a autenticação de nome de utilizador + palavra-passe. |
Segredo do cliente | Palavra-passe | N/A | Não | O segredo do cliente do BMC Helix Remedyforce da app associada. Este parâmetro é necessário para a autenticação OAuth. Nota: este parâmetro tem prioridade sobre a autenticação de nome de utilizador + palavra-passe. |
Símbolo de atualização | Palavra-passe | N/A | Não | Token de atualização para a autorização OAuth. |
Validar SSL | Caixa de verificação | Marcado | Sim | Se estiver ativada, verifica se o certificado SSL para a ligação ao servidor do BMC Helix Remedyforce é válido. |
Raiz da API de início de sessão | String | https://login.salesforce.com | Sim | Raiz da API usada para autenticar no BMC Helix Remedyforce. |
Ações
Criar registo
Descrição
Crie um registo no BMC Helix Remedyforce.
Parâmetros
Nome a apresentar do parâmetro | Tipo | Valor predefinido | É obrigatório | Descrição |
---|---|---|---|---|
Tipo de registo | String | N/A | Sim | Especifique o tipo de registo que tem de ser criado. Se não souber que tipo de registos estão disponíveis, execute a ação "List Record Types" (Listar tipos de registos). |
Payload de registo | JSON | { "field":"value" } |
Sim | Especifique um objeto JSON que contenha todos os campos e valores necessários. |
Executar em
A ação não é executada em entidades nem tem parâmetros de entrada obrigatórios.
Resultados da ação
Resultado do script
Nome do resultado do script | Opções de valores |
---|---|
is_success | is_success=False |
is_success | is_success=True |
Resultado JSON
{
"id": "0015e000005dVbKAAU",
"success": true,
"errors": []
}
Case Wall
Tipo de resultado | Valor/descrição | Tipo (entidade \ geral) |
---|---|---|
Mensagem de saída* | A ação não deve falhar nem parar a execução de um playbook:
A ação deve falhar e parar a execução de um playbook:
Se 400: "Erro ao executar a ação "Criar registo". Motivo: {message}. Se o tipo de registo não foi encontrado: erro ao executar a ação "Criar registo". Motivo: não foi possível encontrar {Record Type} no BMC Helix Remedyforce. Use a ação "List Record Types" para obter uma lista dos tipos de registos disponíveis. Se o payload JSON for inválido: "Erro ao executar a ação "Criar registo". Motivo: payload JSON inválido fornecido no parâmetro "Record Payload". Verifique a estrutura. |
Geral |
Eliminar registo
Descrição
Elimine um registo no BMC Helix Remedyforce.
Parâmetros
Nome a apresentar do parâmetro | Tipo | Valor predefinido | É obrigatório | Descrição |
---|---|---|---|---|
Tipo de registo | String | N/A | Sim | Especifique o tipo de registo que tem de ser eliminado. Se não souber que tipo de registos estão disponíveis, execute a ação "List Record Types" (Listar tipos de registos). |
ID do registo | String | N/A | Sim | Especifique o ID do registo que tem de ser eliminado. |
Executar em
A ação não é executada em entidades nem tem parâmetros de entrada obrigatórios.
Resultados da ação
Resultado do script
Nome do resultado do script | Opções de valores |
---|---|
is_success | is_success=False |
is_success | is_success=True |
Case Wall
Tipo de resultado | Valor/descrição | Tipo (entidade \ geral) |
---|---|---|
Mensagem de saída* | A ação não deve falhar nem parar a execução de uma estratégia:
If 404 (is_success=true): "O registo de {Record Type} com o ID {record id} não existe no BMC Helix Remedyforce. A ação deve falhar e parar a execução de um guia interativo: Se ocorrer um erro fatal, como credenciais incorretas, sem ligação ao servidor, entre outros: "Erro ao executar a ação "Eliminar registo". Motivo: {0}''.format(error.Stacktrace) Se não foi encontrado o tipo de registo: erro ao executar a ação "Eliminar registo". Motivo: não foi possível encontrar {Record Type} no BMC Helix Remedyforce. Use a ação "List Record Types" para obter uma lista dos tipos de registos disponíveis. |
Geral |
Executar consulta personalizada
Descrição
Execute uma consulta SOQL personalizada no BMC Helix Remedyforce.
Parâmetros
Nome a apresentar do parâmetro | Tipo | Valor predefinido | É obrigatório | Descrição |
---|---|---|---|---|
Consulta SOQL | String | N/A | Sim | Especifique a consulta que deve ser executada. |
Executar em
A ação não é executada em entidades nem tem parâmetros de entrada obrigatórios.
Resultados da ação
Resultado do script
Nome do resultado do script | Opções de valores |
---|---|
is_success | is_success=False |
is_success | is_success=True |
Resultado JSON
{
"attributes": {
"type": "BMCServiceDesk__Incident__c",
"url": "/services/data/v51.0/sobjects/BMCServiceDesk__Incident__c/a2U5e000000kl6NEAQ"
},
"Id": "a2U5e000000kl6NEAQ",
"OwnerId": "00G5e000001mqf7EAA",
"IsDeleted": false,
"Name": "00000002",
"CreatedDate": "2021-05-10T19:00:26.000+0000",
"CreatedById": "0055e000001zFloAAE",
"LastModifiedDate": "2021-05-10T19:00:26.000+0000",
"LastModifiedById": "0055e000001zFloAAE",
"SystemModstamp": "2021-05-10T19:00:26.000+0000",
"LastActivityDate": null,
"LastViewedDate": "2021-05-14T10:26:38.000+0000",
"LastReferencedDate": "2021-05-14T10:26:38.000+0000",
"BMCServiceDesk__ACApprovalStatus__c": null,
"BMCServiceDesk__ACSeverity__c": null,
"BMCServiceDesk__Actual_Outage_Time_Hours__c": 0.0,
"BMCServiceDesk__Additional_email_information__c": null,
"BMCServiceDesk__AllTaskCloseController__c": false,
"BMCServiceDesk__Approved__c": false,
"BMCServiceDesk__BLANK__c": null,
"BMCServiceDesk__Category_ID__c": "Hardware",
"BMCServiceDesk__RecurringParentRecordId__c": null,
"BMCServiceDesk__RequestDetailCloneId__c": null,
"BMCServiceDesk__VIP_Client__c": "-",
"BMCServiceDesk__WorkflowController__c": null,
"BMCServiceDesk__actualDuration__c": null,
"BMCServiceDesk__actualOutageDuration__c": null,
"BMCServiceDesk__call__c": 1.0,
"BMCServiceDesk__clientEmail__c": "bmcremedyforcetrial@example.com",
"BMCServiceDesk__Deep_View__c": "<a href=\"/apex/BMCServiceDesk__DeepView?id=a2U5e000000kl6N\" target=\"_blank\"><img src=\"/resource/BMCServiceDesk__SDEFStyles/SDEFbuttons/deep-view.png\" alt=\" \" style=\"height:18px; width:18px;\" border=\"0\"/></a>",
"BMCServiceDesk__RF_TimeToClose__c": null,
"BMCServiceDesk__RF_FKLayout__c": null,
"BMCServiceDesk__RF_LTEC__c": null,
"BMCServiceDesk__RF_SkipTriggerExecution__c": false,
"BMCServiceDesk__Categorization_Mode__c": null,
"BMCServiceDesk__RF_Attachments__c": null,
"BMCServiceDesk__RF_HasAttachments__c": null,
"BMCServiceDesk__RF_IntegrationData__c": null
}
Case Wall
Tipo de resultado | Valor/descrição | Tipo (entidade \ geral) |
---|---|---|
Mensagem de saída* | A ação não deve falhar nem parar a execução de um playbook:
Se não foi encontrado nada(is_success=true): "Não foram encontrados resultados para a consulta "{query}" no BMC Helix Remedyforce" A ação deve falhar e parar a execução de um guião:
|
Geral |
Case Wall | Nome: resultados | Geral |
Executar consulta simples
Descrição
Executar uma consulta SOQL com base em parâmetros no BMC Helix Remedyforce.
Parâmetros
Nome a apresentar do parâmetro | Tipo | Valor predefinido | É obrigatório | Descrição |
---|---|---|---|---|
Tipo de registo | String | N/A | Sim | Especifique o tipo de registo que deve ser consultado. |
Filtro Where | String | N/A | Não | Especifique o filtro WHERE para a consulta que tem de ser executada. Nota: não tem de fornecer um filtro de tempo, limites nem ordenação. Além disso, não tem de fornecer a string WHERE na carga útil. |
Intervalo de tempo | LDD | Última hora Valores possíveis: Última hora Últimas 6 horas Últimas 24 horas Semana passada Mês passado Personalizado |
Não | Especifique um período para os resultados. Se selecionar "Personalizado", também tem de indicar a "Hora de início". |
Hora de início | String | N/A | Não | Especifique a hora de início dos resultados. Este parâmetro é obrigatório se "Personalizado" estiver selecionado para o parâmetro "Intervalo de tempo". Formato: ISO 8601 |
Hora de fim | String | N/A | Não | Especifique a hora de fim dos resultados. Formato: ISO 8601. Se não for indicado nada e "Personalizado" for selecionado para o parâmetro "Intervalo de tempo", este parâmetro usa a hora atual. |
Campos a devolver | CSV | N/A | Não | Especifique os campos a devolver. Se não for fornecido nada, a ação devolve todos os campos. |
Campo de ordenação | String | CreatedDate | Não | Especifique o parâmetro que deve ser usado para a ordenação. |
Disposição da Ordenação | LDD | ASC Valores possíveis: ASC DESC |
Não | Especifique a ordem de ordenação. |
Máximo de resultados a devolver | Número inteiro | 50 | Não | Especifique quantos resultados devolver. Predefinição: 50. O máximo é 200. |
Executar em
A ação não é executada em entidades nem tem parâmetros de entrada obrigatórios.
Resultados da ação
Resultado do script
Nome do resultado do script | Opções de valores |
---|---|
is_success | is_success=False |
is_success | is_success=True |
Resultado JSON
{
"attributes": {
"type": "BMCServiceDesk__Incident__c",
"url": "/services/data/v51.0/sobjects/BMCServiceDesk__Incident__c/a2U5e000000kl6NEAQ"
},
"Id": "a2U5e000000kl6NEAQ",
"OwnerId": "00G5e000001mqf7EAA",
"IsDeleted": false,
"Name": "00000002",
"CreatedDate": "2021-05-10T19:00:26.000+0000",
"CreatedById": "0055e000001zFloAAE",
"LastModifiedDate": "2021-05-10T19:00:26.000+0000",
"LastModifiedById": "0055e000001zFloAAE",
"SystemModstamp": "2021-05-10T19:00:26.000+0000",
"LastActivityDate": null,
"LastViewedDate": "2021-05-14T10:26:38.000+0000",
"LastReferencedDate": "2021-05-14T10:26:38.000+0000",
"BMCServiceDesk__ACApprovalStatus__c": null,
"BMCServiceDesk__ACSeverity__c": null,
"BMCServiceDesk__Actual_Outage_Time_Hours__c": 0.0,
"BMCServiceDesk__Additional_email_information__c": null,
"BMCServiceDesk__AllTaskCloseController__c": false,
"BMCServiceDesk__Approved__c": false,
"BMCServiceDesk__BLANK__c": null,
"BMCServiceDesk__Category_ID__c": "Hardware",
"BMCServiceDesk__RecurringParentRecordId__c": null,
"BMCServiceDesk__RequestDetailCloneId__c": null,
"BMCServiceDesk__VIP_Client__c": "-",
"BMCServiceDesk__WorkflowController__c": null,
"BMCServiceDesk__actualDuration__c": null,
"BMCServiceDesk__actualOutageDuration__c": null,
"BMCServiceDesk__call__c": 1.0,
"BMCServiceDesk__clientEmail__c": "bmcremedyforcetrial@example.com",
"BMCServiceDesk__Deep_View__c": "<a href=\"/apex/BMCServiceDesk__DeepView?id=a2U5e000000kl6N\" target=\"_blank\"><img src=\"/resource/BMCServiceDesk__SDEFStyles/SDEFbuttons/deep-view.png\" alt=\" \" style=\"height:18px; width:18px;\" border=\"0\"/></a>",
"BMCServiceDesk__RF_TimeToClose__c": null,
"BMCServiceDesk__RF_FKLayout__c": null,
"BMCServiceDesk__RF_LTEC__c": null,
"BMCServiceDesk__RF_SkipTriggerExecution__c": false,
"BMCServiceDesk__Categorization_Mode__c": null,
"BMCServiceDesk__RF_Attachments__c": null,
"BMCServiceDesk__RF_HasAttachments__c": null,
"BMCServiceDesk__RF_IntegrationData__c": null
}
Case Wall
Tipo de resultado | Valor/descrição | Tipo (entidade \ geral) |
---|---|---|
Mensagem de saída* | A ação não deve falhar nem parar a execução de um playbook:
Se não foi encontrado nada(is_success=true): "Não foram encontrados resultados para a consulta "{query}" no BMC Helix Remedyforce" A ação deve falhar e parar a execução de um manual de soluções:
|
Geral |
Case Wall | Nome: resultados | Geral |
Obtenha detalhes do registo
Descrição
Obtenha informações detalhadas sobre o registo do BMC Helix Remedyforce.
Parâmetros
Nome a apresentar do parâmetro | Tipo | Valor predefinido | É obrigatório | Descrição |
---|---|---|---|---|
Tipo de registo | String | N/A | Sim | Especifique o tipo do registo para o qual quer obter detalhes. Se não souber que tipo de registos estão disponíveis, execute a ação "List Record Types" (Listar tipos de registos). |
IDs dos registos | CSV | N/A | Sim | Especifique os IDs dos registos para os quais quer devolver detalhes. |
Campos a devolver | CSV | N/A | Não | Especifique os campos a devolver. Se não for encontrado nenhum dos campos fornecidos, a ação falha. Se não for fornecido nada, a ação devolve todos os campos. |
Executar em
A ação não é executada em entidades nem tem parâmetros de entrada obrigatórios.
Resultados da ação
Resultado do script
Nome do resultado do script | Opções de valores |
---|---|
is_success | is_success=False |
is_success | is_success=True |
Resultado JSON
{
"attributes": {
"type": "BMCServiceDesk__Incident__c",
"url": "/services/data/v51.0/sobjects/BMCServiceDesk__Incident__c/a2U5e000000kl6NEAQ"
},
"Id": "a2U5e000000kl6NEAQ",
"OwnerId": "00G5e000001mqf7EAA",
"IsDeleted": false,
"Name": "00000002",
"CreatedDate": "2021-05-10T19:00:26.000+0000",
"CreatedById": "0055e000001zFloAAE",
"LastModifiedDate": "2021-05-10T19:00:26.000+0000",
"LastModifiedById": "0055e000001zFloAAE",
"BMCServiceDesk__Total_Duration__c": 0.0,
"BMCServiceDesk__Incorrect_category__c": false,
"Client_VIP__c": false,
"BMCServiceDesk__Incorrect_owner__c": false,
"BMCServiceDesk__LockedRecordTimestamp__c": null,
"BMCServiceDesk__Queue__c": "Incident Queue",
"BMCServiceDesk__Reassigned_Count__c": null,
"BMCServiceDesk__isServiceRequest__c": false,
"BMCServiceDesk__Approval_Status__c": null,
"Alternate_Contact_Name__c": null,
"Alternate_Contact_Number__c": null,
"Client_Phone__c": null,
"External_Ticket_Ref__c": null,
"Affected_Application__c": null,
"Affected_Hardware__c": null,
"BMCServiceDesk__Deep_View__c": "<a href=\"/apex/BMCServiceDesk__DeepView?id=a2U5e000000kl6N\" target=\"_blank\"><img src=\"/resource/BMCServiceDesk__SDEFStyles/SDEFbuttons/deep-view.png\" alt=\" \" style=\"height:18px; width:18px;\" border=\"0\"/></a>",
"BMCServiceDesk__RF_TimeToClose__c": null,
"BMCServiceDesk__RF_FKLayout__c": null,
"BMCServiceDesk__RF_LTEC__c": null,
"BMCServiceDesk__RF_SkipTriggerExecution__c": false,
"BMCServiceDesk__Categorization_Mode__c": null,
"BMCServiceDesk__RF_Attachments__c": null,
"BMCServiceDesk__RF_HasAttachments__c": null,
"BMCServiceDesk__RF_IntegrationData__c": null
}
Case Wall
Tipo de resultado | Valor/descrição | Tipo (entidade \ geral) |
---|---|---|
Mensagem de saída* | A ação não deve falhar nem parar a execução de um playbook:
Se os dados não estiverem disponíveis para, pelo menos, um ID (is_success=true): "Não foi possível encontrar detalhes sobre o tipo de registo {Record Type} para os seguintes IDs: {record ids}". Se os dados não estiverem disponíveis para todos (is_success=false): não foram encontrados registos. A ação deve falhar e parar a execução de um playbook: Se o tipo de registo não foi encontrado: erro ao executar a ação "Obter detalhes do registo". Motivo: não foi possível encontrar {Record Type} no BMC Helix Remedyforce. Use a ação "List Record Types" para obter uma lista dos tipos de registos disponíveis. Se nenhum dos campos fornecidos em "Campos a devolver" tiver sido encontrado: "Erro ao executar a ação "Obter detalhes do registo". Motivo: nenhum dos campos indicados foi encontrado. Verifique a ortografia." |
Geral |
Tabela de parede da caixa | Nome: detalhes do registo {record Id} Colunas: Chave Valor |
Geral |
Obtenha o código de autorização OAuth
Descrição
Gere um código de autorização OAuth no BMC Helix Remedyforce. Consulte o portal de documentação para mais informações.
Parâmetros
Nome a apresentar do parâmetro | Tipo | Valor predefinido | É obrigatório | Descrição |
---|---|---|---|---|
URL de redireccionamento | String | https://localhost | Sim | Especifique o URL de redirecionamento que foi usado quando a "app Connector" foi criada. |
Executar em
A ação não é executada em entidades nem tem parâmetros de entrada obrigatórios.
Resultados da ação
Resultado do script
Nome do resultado do script | Opções de valores |
---|---|
is_success | is_success=False |
is_success | is_success=True |
Case Wall
Tipo de resultado | Valor/descrição | Tipo (entidade \ geral) |
---|---|---|
Mensagem de saída* | A ação não deve falhar nem parar a execução de um guia interativo: "URL do código de autorização gerado com êxito no BMC Helix Remedyforce. Copie e cole-o no navegador. Depois disso, copie a parte "code" do URL. Este código de autorização é usado na ação "Obter token de atualização do OAuth". |
Geral |
Link | Nome: link do código de autorização |
Obtenha o símbolo de atualização do OAuth
Descrição
Gere o token de atualização necessário para a configuração da integração. O código de autorização pode ser gerado através da opção "Obter código de autorização OAuth". Consulte o portal de documentação para mais informações.
Parâmetros
Nome a apresentar do parâmetro | Tipo | Valor predefinido | É obrigatório | Descrição |
---|---|---|---|---|
URL de redireccionamento | String | https://localhost | Sim | Especifique o URL de redirecionamento que foi usado quando a "app Connector" foi criada. |
Código de autorização | String | N/A | Sim | Especifique o código de autorização da ação "Obter código de autorização OAuth". |
Executar em
A ação não é executada em entidades nem tem parâmetros de entrada obrigatórios.
Resultados da ação
Resultado do script
Nome do resultado do script | Opções de valores |
---|---|
is_success | is_success=False |
is_success | is_success=True |
Resultado JSON
{
"access_token": "00D090000083B1p!ARkAQHJhzO.oDwNuldyoWlNDlLV9805VyWlZmcBvMF7qetVGpQWXi6pND0riSCiFs4fnrxmuVjBv.Io..ooN_JAIlGdGT_Gk",
"signature": "6+xAwCccuYI0ivDbXtZzlguynNuKGRHaj+HpyZXM6ms=",
"scope": "refresh_token api full",
"instance_url": "https://202107220535170700.my.salesforce.com",
"id": "https://login.salesforce.com/id/00D090000083B1pEAE/00509000007hMVJAA2",
"token_type": "Bearer",
"issued_at": "1626958668640"
}
Case Wall
Tipo de resultado | Valor/descrição | Tipo (entidade \ geral) |
---|---|---|
Mensagem de saída* | A ação não deve falhar nem parar a execução de um manual de soluções:
A ação deve falhar e parar a execução de um manual de procedimentos:
Se o código de estado não for 200: "Erro ao executar a ação "Obter token de atualização do OAuth". Motivo: {0}''.format(error_description) |
Geral |
Apresentar tipos de registos
Descrição
Liste os tipos de registos disponíveis do BMC Helix Remedyforce.
Parâmetros
Nome a apresentar do parâmetro | Tipo | Valor predefinido | É obrigatório | Descrição |
---|---|---|---|---|
Lógica de filtragem | LDD | Igual LDD Igual Contém |
Não | Especifique a lógica de filtro que deve ser aplicada. |
Valor do filtro | String | N/A | Não | Especifique o valor que deve ser usado no filtro. Se a opção "Igual a" estiver selecionada, a ação tenta encontrar a correspondência exata entre os tipos de registos. Se a opção "Contém" estiver selecionada, a ação tenta encontrar tipos de registos que contenham essa substring. Se não for fornecido nada neste parâmetro, o filtro não é aplicado. |
Max Record Types To Return | Número inteiro | 50 | Não | Especifique quantos tipos de registos devolver. |
Executar em
A ação não é executada em entidades nem tem parâmetros de entrada obrigatórios.
Resultados da ação
Resultado do script
Nome do resultado do script | Opções de valores |
---|---|
is_success | is_success=False |
is_success | is_success=True |
Case Wall
Tipo de resultado | Valor/descrição | Tipo (entidade \ geral) |
---|---|---|
Mensagem de saída* | A ação não deve falhar nem parar a execução de um playbook:
Se não foi encontrado nada(is_success=true): "Não foram encontrados tipos de registos com base nos critérios fornecidos no BMC Helix Remedyforce" A ação deve falhar e parar a execução de um manual de soluções:
|
Geral |
Case Wall | Nome: tipos de registos disponíveis Colunas: Nome Etiqueta Personalizado |
Geral |
Tchim-tchim
Descrição
Teste a conetividade ao BMC Helix Remedyforce com os parâmetros fornecidos na página de configuração da integração no separador Google Security Operations Marketplace.
Executar em
Esta ação não é executada em entidades.
Resultados da ação
Resultado do script
Nome do resultado do script | Opções de valores |
---|---|
is_success | is_success=False |
is_success | is_success=True |
Case Wall
Tipo de resultado | Valor/descrição | Tipo (entidade \ geral) |
---|---|---|
Mensagem de saída* | A ação não deve falhar nem parar a execução de um manual de soluções:
A ação deve falhar e parar a execução de um manual de soluções:
|
Geral |
Atualize o registo
Descrição
Atualize o registo no BMC Helix Remedyforce.
Parâmetros
Nome a apresentar do parâmetro | Tipo | Valor predefinido | É obrigatório | Descrição |
---|---|---|---|---|
Tipo de registo | String | N/A | Sim | Especifique o tipo de registo que tem de ser atualizado. Se não souber que tipo de registos estão disponíveis, execute a ação "List Record Types" (Listar tipos de registos). |
ID do registo | String | N/A | Sim | Especifique o ID do registo que precisa de ser atualizado. |
Campos a atualizar | JSON | { "field":"value" } |
Sim | Especifique um objeto JSON que contenha todos os campos necessários e os valores que precisam de ser atualizados. |
Executar em
A ação não é executada em entidades nem tem parâmetros de entrada obrigatórios.
Resultados da ação
Resultado do script
Nome do resultado do script | Opções de valores |
---|---|
is_success | is_success=False |
is_success | is_success=True |
Case Wall
Tipo de resultado | Valor/descrição | Tipo (entidade \ geral) |
---|---|---|
Mensagem de saída* | A ação não deve falhar nem parar a execução de um playbook:
A ação deve falhar e parar a execução de um manual de soluções:
Se for 404 ou 400: "Erro ao executar a ação "Atualizar registo". Motivo: {message}. Se o tipo de registo não foi encontrado: erro ao executar a ação "Atualizar registo". Motivo: não foi possível encontrar {Record Type} no BMC Helix Remedyforce. Use a ação "List Record Types" para obter uma lista dos tipos de registos disponíveis. Se o payload JSON for inválido: "Erro ao executar a ação "Atualizar registo". Motivo: payload JSON inválido fornecido no parâmetro "Fields To Update" (Campos a atualizar). Verifique a estrutura. |
Geral |
Wait For Fields Update
Descrição
Aguarde a atualização dos campos no BMC Helix Remedyforce.
Parâmetros
Nome a apresentar do parâmetro | Tipo | Valor predefinido | É obrigatório | Descrição |
---|---|---|---|---|
Tipo de registo | String | N/A | Sim | Especifique o tipo de registo para o qual está a aguardar uma atualização. Se não souber que tipo de registos estão disponíveis, execute a ação "List Record Types" (Listar tipos de registos). |
ID do registo | String | N/A | Sim | Especifique o ID do registo que precisa de ser atualizado. |
Campos a verificar | JSON | { "field":"value" } |
Sim | Especifique um objeto JSON que contenha todos os campos e valores necessários. |
Fail If Timeout | Caixa de verificação | Marcado | Sim | Se estiver ativado, a ação falha se nem todos os campos forem atualizados. |
Executar em
A ação não é executada em entidades nem tem parâmetros de entrada obrigatórios.
Resultados da ação
Resultado do script
Nome do resultado do script | Opções de valores |
---|---|
is_success | is_success=False |
is_success | is_success=True |
Resultado JSON
{
"attributes": {
"type": "BMCServiceDesk__Incident__c",
"url": "/services/data/v51.0/sobjects/BMCServiceDesk__Incident__c/a2U5e000000kl6NEAQ"
},
"Id": "a2U5e000000kl6NEAQ",
"BMCServiceDesk__FKImpact__c": "a2M5e000000l1HxEAI",
"BMCServiceDesk__FKIncident__c": null,
"BMCServiceDesk__FKLead__c": null,
"BMCServiceDesk__FKOpenBy__c": "0055e000001zFloAAE",
"BMCServiceDesk__FKPriority__c": "a2h5e000000nHTnAAM",
"BMCServiceDesk__FKRequestDefinition__c": null,
"BMCServiceDesk__FKRequestDetail__c": null,
"BMCServiceDesk__FKServiceOffering__c": null,
"BMCServiceDesk__FKStatus__c": "a3w5e000000U1xcAAC",
"BMCServiceDesk__FKTemplate__c": null,
"BMCServiceDesk__actualOutageDuration__c": null,
"BMCServiceDesk__call__c": 1.0,
"Client_VIP__c": false,
"BMCServiceDesk__Incorrect_owner__c": false,
"BMCServiceDesk__LockedRecordTimestamp__c": null,
"BMCServiceDesk__Queue__c": "Incident Queue",
"BMCServiceDesk__Reassigned_Count__c": null,
"BMCServiceDesk__isServiceRequest__c": false,
"BMCServiceDesk__Approval_Status__c": null,
"Alternate_Contact_Name__c": null,
"Alternate_Contact_Number__c": null,
"Client_Phone__c": null,
"External_Ticket_Ref__c": null,
"Affected_Application__c": null,
"Affected_Hardware__c": null,
"BMCServiceDesk__Deep_View__c": "<a href=\"/apex/BMCServiceDesk__DeepView?id=a2U5e000000kl6N\" target=\"_blank\"><img src=\"/resource/BMCServiceDesk__SDEFStyles/SDEFbuttons/deep-view.png\" alt=\" \" style=\"height:18px; width:18px;\" border=\"0\"/></a>",
"BMCServiceDesk__RF_TimeToClose__c": null,
"BMCServiceDesk__RF_FKLayout__c": null,
"BMCServiceDesk__RF_LTEC__c": null,
"BMCServiceDesk__RF_SkipTriggerExecution__c": false,
"BMCServiceDesk__Categorization_Mode__c": null,
"BMCServiceDesk__RF_Attachments__c": null,
"BMCServiceDesk__RF_HasAttachments__c": null,
"BMCServiceDesk__RF_IntegrationData__c": null
}
Case Wall
Tipo de resultado | Valor/descrição | Tipo (entidade \ geral) |
---|---|---|
Mensagem de saída* | A ação não deve falhar nem parar a execução de um guião:
Se um dos campos não tiver sido atualizado e a opção Falhar se o limite de tempo não estiver ativada (is_success=false): "Os seguintes campos não foram atualizados para o registo de {record type} com o ID {record id} no BMC Helix Remedyforce: {fields that were not updated}" Mensagem assíncrona: a aguardar a atualização dos seguintes campos para o registo {record type} com o ID {record id} no BMC Helix Remedyforce: {fields that were not updated} A ação deve falhar e parar a execução de um playbook:
Se alguns campos não foram encontrados: "Erro ao executar a ação "Aguardar atualização de campos". Motivo: não foram encontrados os seguintes campos na estrutura do registo: {fields that were not found}. Se o tipo de registo não foi encontrado: erro ao executar a ação "Aguardar atualização de campos". Motivo: não foi possível encontrar {Record Type} no BMC Helix Remedyforce. Use a ação "List Record Types" para obter uma lista dos tipos de registos disponíveis. Se um dos campos não tiver sido atualizado e a opção Falhar se o tempo limite estiver ativada (is_success=false): "Erro ao executar a ação "Aguardar atualização dos campos". Motivo: os seguintes campos não foram atualizados para o registo {record type} com o ID {record id} no BMC Helix Remedyforce: {fields that were not updated}" Se o payload JSON for inválido: "Erro ao executar a ação "Aguardar atualização de campos". Motivo: payload JSON inválido fornecido no parâmetro "Campos a verificar". Verifique a estrutura. |
Geral |
Conetor
BMC Helix Remedyforce - Incidents Connector
Descrição
Extraia informações sobre incidentes do BMC Helix Remedyforce.
Configure o conetor BMC Helix Remedyforce - Incidents no Google SecOps
Para ver instruções detalhadas sobre como configurar um conetor no Google SecOps, consulte o artigo Configurar o conetor.
Parâmetros do conetor
Use os seguintes parâmetros para configurar o conector:
Nome a apresentar do parâmetro | Tipo | Valor predefinido | É obrigatório | Descrição |
---|---|---|---|---|
Nome do campo do produto | String | Nome do produto | Sim | Introduza o nome do campo de origem para obter o nome do campo do produto. |
Nome do campo de evento | String | BMCServiceDesk__Type__c | Sim | Introduza o nome do campo de origem para obter o nome do campo do evento. |
Nome do campo do ambiente | String | "" | Não | Descreve o nome do campo onde o nome do ambiente está armazenado. Se o campo do ambiente não for encontrado, o ambiente é o ambiente predefinido. |
Padrão de regex do ambiente | String | .* | Não | Um padrão de regex a executar no valor encontrado no campo "Nome do campo do ambiente". A predefinição é .* para captar tudo e devolver o valor inalterado. Usado para permitir que o utilizador manipule o campo do ambiente através da lógica de regex. Se o padrão regex for nulo ou estiver vazio, ou o valor do ambiente for nulo, o resultado final do ambiente é o ambiente predefinido. |
Limite de tempo do script (segundos) | Número inteiro | 180 | Sim | Limite de tempo limite para o processo Python que executa o script atual. |
Raiz da API | String | https://.my.salesforce.com | Sim | Raiz da API da instância do BMC Helix Remedyforce. |
Nome de utilizador | String | N/A | Sim | Nome de utilizador do BMC Helix Remedyforce. |
Palavra-passe | Palavra-passe | N/A | Sim | Palavra-passe do BMC Helix Remedyforce. |
Prioridade mais baixa para obter | Número inteiro | 5 | Não | A prioridade mais baixa que vai ser usada para obter incidentes. Máximo: 5. Mínimo: 1. Se não for fornecido nada, o conetor vai carregar todos os incidentes. |
Carregamento de incidentes de prioridade vazios | Caixa de verificação | Marcado | Não | Se estiver ativado, o conector obtém incidentes que não têm prioridade. Os alertas do Google SecOps criados desta forma têm a prioridade definida como "Informativa" |
Tipo de filtro | CSV | Incident,Service Request | Não | Filtro de tipo para os incidentes. Se não for fornecido nada, o conetor vai carregar todos os incidentes. Exemplo: incidente, pedido de serviço. |
Máximo de horas para trás | Número inteiro | 1 | Não | Número de horas a partir das quais obter incidentes. |
Máximo de incidentes a obter | Número inteiro | 10 | Não | O número de incidentes a processar por iteração de um conetor. O máximo é 200. |
Use a lista de autorizações como uma lista negra | Caixa de verificação | Marcado | Sim | Se estiver ativada, a lista de autorizações é usada como uma lista negra. |
Validar SSL | Caixa de verificação | Marcado | Sim | Se estiver ativada, valide se o certificado SSL para a ligação ao servidor do BMC Helix Remedyforce é válido. |
Endereço do servidor proxy | String | N/A | Não | O endereço do servidor proxy a usar. |
Nome de utilizador do proxy | String | N/A | Não | O nome de utilizador do proxy para autenticação. |
Palavra-passe do proxy | Palavra-passe | N/A | Não | A palavra-passe do proxy para autenticação. |
ID do cliente | String | N/A | Não | ID de cliente do BMC Helix Remedyforce da app associada. Este parâmetro é necessário para a autenticação OAuth. Nota: este parâmetro tem prioridade sobre a autenticação de nome de utilizador + palavra-passe. |
Segredo do cliente | Palavra-passe | N/A | Não | O segredo do cliente do BMC Helix Remedyforce da app associada. Este parâmetro é necessário para a autenticação OAuth. Nota: este parâmetro tem prioridade sobre a autenticação de nome de utilizador + palavra-passe. |
Raiz da API de início de sessão | String | https://login.salesforce.com | Sim | Raiz da API usada para autenticar no BMC Helix Remedyforce. |
Regras do conetor
Suporte de proxy
O conetor suporta proxy.
Precisa de mais ajuda? Receba respostas de membros da comunidade e profissionais da Google SecOps.