BMC Helix Remedyforce

Versão da integração: 11.0

Casos de uso

  1. Realizar a ingestão de incidentes
  2. Realizar uma ação de triagem (atualizar/criar/excluir registros)

Como configurar a autenticação OAuth

Às vezes, o método de autenticação básica usando nome de usuário e senha não funciona. Isso pode acontecer quando a MFA está ativada para a conta. Nesses casos, é necessário configurar a autenticação do OAuth.

Etapas:

  1. Acesse Configuração -> Gerenciador de apps.
  2. Pressione o botão "Novo app conectado".
  3. Informe o "Nome do app conectado", o "Nome da API" e o "E-mail de contato".
  4. "Enable OAuth Settings" precisa ser definido como "true".
  5. Defina "URL de callback" como "https://localhost".
  6. Adicione os escopos "full" e "refresh_token". Ambos são necessários para acessar a API.
  7. Salve o app.
  8. Abra a configuração do app e copie "Chave do cliente" e "Chave secreta do cliente". "Chave do consumidor" é "ID do cliente" e "Secret do consumidor" é "Chave secreta do cliente" na configuração da integração.
  9. Acesse a ação "Receber código de autorização do OAuth". "URL de redirecionamento" é "URL de callback".
  10. Execute a ação. No resultado JSON, você terá um URL de autorização. Copie e cole no navegador. No final, você vai ser redirecionado e seu URL vai ficar assim: "https://localhost/?code=aPrxyeILZDvX2Hhmz2gymvtuE4aow6hMnAKw_98FyXJvaN7l69bJZFr1z.ylZ3qXd0KZlXjn0g%3D%3D". Copie tudo depois de "code=" e faça a decodificação de URL. %3D é um caractere "=".
  11. Acesse a ação "Receber token de atualização do OAuth". "URL de redirecionamento" é "URL de retorno de chamada" e "Código de autorização" é o "código" da solicitação anterior.
  12. Se tudo foi feito corretamente, você vai encontrar "refresh_token" no resultado JSON.
  13. Copie esse token de atualização para a configuração da integração e faça um teste de execução.

Configurar a integração do BMC Helix Remedyforce no Google Security Operations

Para instruções detalhadas sobre como configurar uma integração no Google SecOps, consulte Configurar integrações.

Parâmetros de integração

Use os seguintes parâmetros para configurar a integração:

Nome de exibição do parâmetro Tipo Valor padrão É 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 usuário String N/A Não Nome de usuário do BMC Helix Remedyforce.
Senha Senha N/A Não Senha do BMC Helix Remedyforce.
ID do cliente String N/A Não ID do cliente do BMC Helix Remedyforce do app conectado. Esse parâmetro é necessário para a autenticação OAuth. Observação: esse parâmetro tem prioridade sobre a autenticação de nome de usuário e senha.
Chave secreta do cliente Senha N/A Não Chave secreta do cliente do BMC Helix Remedyforce do app conectado. Esse parâmetro é necessário para a autenticação OAuth. Observação: esse parâmetro tem prioridade sobre a autenticação de nome de usuário e senha.
Token de atualização Senha N/A Não Token de atualização para a autorização do OAuth.
Verificar SSL Caixa de seleção Selecionado Sim Se ativada, verifica se o certificado SSL da conexão com o servidor do BMC Helix Remedyforce é válido.
Raiz da API de login String https://login.salesforce.com Sim Raiz da API usada para autenticar no BMC Helix Remedyforce.

Ações

Criar registro

Descrição

Crie um registro no BMC Helix Remedyforce.

Parâmetros

Nome de exibição do parâmetro Tipo Valor padrão É obrigatório Descrição
Tipo de registro String N/A Sim Especifique o tipo de registro que precisa ser criado. Se você não souber quais tipos de registros estão disponíveis, execute a ação "List Record Types".
Payload de registro 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 valor
is_success is_success=False
is_success is_success=True
Resultado do JSON
{
    "id": "0015e000005dVbKAAU",
    "success": true,
    "errors": []
}
Painel de casos
Tipo de resultado Valor/descrição Tipo (entidade \ geral)
Mensagem de saída*

A ação não pode falhar nem interromper a execução de um playbook:
if 201 (is_success = true): "Successfully created {record type} record in BMC Helix Remedyforce.".

A ação precisa falhar e interromper a execução de um playbook:
se houver um erro fatal, como credenciais incorretas, sem conexão com o servidor, outro: "Erro ao executar a ação "Criar registro". Motivo: {0}''.format(error.Stacktrace)

Se 400: "Erro ao executar a ação "Criar registro". Motivo: {message}.

Se o tipo de registro não foi encontrado:erro ao executar a ação "Criar registro". Motivo: {Record Type} não foi encontrado no BMC Helix Remedyforce. Use a ação "List Record Types" para receber uma lista dos tipos de registro disponíveis.

Se o payload JSON for inválido: "Erro ao executar a ação "Criar registro". Motivo: payload JSON inválido fornecido no parâmetro "Payload do registro". Verifique a estrutura.

 Geral

Excluir registro

Descrição

Exclua um registro no BMC Helix Remedyforce.

Parâmetros

Nome de exibição do parâmetro Tipo Valor padrão É obrigatório Descrição
Tipo de registro String N/A Sim Especifique o tipo de registro que precisa ser excluído. Se você não souber quais tipos de registros estão disponíveis, execute a ação "List Record Types".
ID do registro String N/A Sim Especifique o ID do registro que precisa ser excluído.

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 valor
is_success is_success=False
is_success is_success=True
Painel de casos
Tipo de resultado Valor/descrição Tipo (entidade \ geral)
Mensagem de saída*

A ação não pode falhar nem interromper a execução de um playbook:
if 204 (is_success = true): "Successfully deleted {Record Type} record with ID {record id} in BMC Helix Remedyforce.

Se 404 (is_success=true): "O registro de {Record Type} com ID {record id} não existe no BMC Helix Remedyforce.

A ação precisa falhar e interromper a execução de um playbook:

Se houver um erro fatal, como credenciais incorretas, sem conexão com o servidor, outro: "Erro ao executar a ação "Excluir registro". Motivo: {0}''.format(error.Stacktrace)

Se o tipo de registro não foi encontrado:erro ao executar a ação "Excluir registro". Motivo: {Record Type} não foi encontrado no BMC Helix Remedyforce. Use a ação "List Record Types" para receber uma lista dos tipos de registro disponíveis.

 Geral

Executar consulta personalizada

Descrição

Execute uma consulta SOQL personalizada no BMC Helix Remedyforce.

Parâmetros

Nome de exibição do parâmetro Tipo Valor padrão É obrigatório Descrição
Consulta SOQL String N/A Sim Especifique qual consulta 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 valor
is_success is_success=False
is_success is_success=True
Resultado do 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
}
Painel de casos
Tipo de resultado Valor/descrição Tipo (entidade \ geral)
Mensagem de saída*

A ação não pode falhar nem interromper a execução de um playbook:
se pelo menos um for encontrado (is_success = true): "Resultados retornados com sucesso para a consulta "{query}" no BMC Helix Remedyforce.

Se nada for encontrado(is_success=true): "Nenhum resultado foi encontrado para a consulta "{query}" no BMC Helix Remedyforce"

A ação precisa falhar e interromper a execução de um playbook:
se houver um erro fatal, como credenciais incorretas, sem conexão com o servidor, outro: "Erro ao executar a ação "Executar consulta personalizada". Motivo: {0}''.format(error.Stacktrace)

 Geral
Painel de casos Nome:Resultados Geral

Executar consulta simples

Descrição

Executar uma consulta SOQL com base em parâmetros no BMC Helix Remedyforce.

Parâmetros

Nome de exibição do parâmetro Tipo Valor padrão É obrigatório Descrição
Tipo de registro String N/A Sim Especifique o tipo de registro que deve ser consultado.
Cláusula WHERE String N/A Não Especifique o filtro WHERE para a consulta que precisa ser executada. Observação: não é necessário fornecer filtro de tempo, limitação e classificação. Além disso, não é necessário fornecer a string WHERE no payload.
Período DDL

Última hora

Valores possíveis:

Última hora

Últimas 6 horas

Últimas 24 horas

Última semana

Mês anterior

Personalizado

 Não Especifique um período para os resultados. Se "Personalizado" estiver selecionado, você também precisará informar o "Horário de início".
Horário de início String N/A Não Especifique o horário de início dos resultados. Esse parâmetro é obrigatório se "Personalizado" for selecionado para o parâmetro "Período". Formato: ISO 8601
Horário de término String N/A Não Especifique o horário de término dos resultados. Formato: ISO 8601. Se nada for fornecido e "Personalizado" for selecionado para o parâmetro "Período", esse parâmetro usará a hora atual.
Campos a serem retornados CSV N/A Não Especifique quais campos retornar. Se nada for fornecido, a ação vai retornar todos os campos.
Campo de classificação String CreatedDate Não Especifique qual parâmetro deve ser usado para a classificação.
Ordem de classificação DDL

ASC

Valores possíveis:

ASC

DESC

 Não Especifique a ordem de classificação.
Número máximo de resultados a serem retornados Número inteiro 50 Não Especifique quantos resultados retornar. Padrão: 50. O valor 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 valor
is_success is_success=False
is_success is_success=True
Resultado do 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
}
Painel de casos
Tipo de resultado Valor/descrição Tipo (entidade \ geral)
Mensagem de saída*

A ação não pode falhar nem interromper a execução de um playbook:
se pelo menos um for encontrado (is_success = true): "Resultados retornados com sucesso para a consulta "{query}" no BMC Helix Remedyforce.

Se nada for encontrado(is_success=true): "Nenhum resultado foi encontrado para a consulta "{query}" no BMC Helix Remedyforce"

A ação precisa falhar e interromper a execução de um playbook:
se houver um erro fatal, como credenciais incorretas, sem conexão com o servidor, outro: "Erro ao executar a ação "Executar consulta simples". Motivo: {0}''.format(error.Stacktrace)

 Geral
Painel de casos Nome:Resultados Geral

Acessar detalhes da gravação

Descrição

Receba informações detalhadas sobre o registro do BMC Helix Remedyforce.

Parâmetros

Nome de exibição do parâmetro Tipo Valor padrão É obrigatório Descrição
Tipo de registro String N/A Sim Especifique o tipo de registro para o qual você quer recuperar detalhes. Se você não souber quais tipos de registros estão disponíveis, execute a ação "List Record Types".
IDs de registro CSV N/A Sim Especifique os IDs dos registros para os quais você quer retornar detalhes.
Campos a serem retornados CSV N/A Não Especifique quais campos retornar. Se nenhum dos campos fornecidos for encontrado, a ação vai falhar. Se nada for fornecido, a ação vai retornar 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 valor
is_success is_success=False
is_success is_success=True
Resultado do 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
}
Painel de casos
Tipo de resultado Valor/descrição Tipo (entidade \ geral)
Mensagem de saída*

A ação não pode falhar nem interromper a execução de um playbook:
se os dados estiverem disponíveis para pelo menos um ID(is_success = true): "Os detalhes do tipo de registro {Record Type} foram retornados com êxito para os seguintes IDs: {record ids}".

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 registro {Record Type} para os seguintes IDs: {record ids}".

Se os dados não estiverem disponíveis para todos (is_success=false): nenhum registro foi encontrado.

A ação precisa falhar e interromper a execução de um playbook:
se houver um erro fatal, como credenciais incorretas, sem conexão com o servidor, outro: "Erro ao executar a ação "Receber detalhes do registro". Motivo: {0}''.format(error.Stacktrace)

Se o tipo de registro não foi encontrado:erro ao executar a ação "Receber detalhes do registro". Motivo: {Record Type} não foi encontrado no BMC Helix Remedyforce. Use a ação "List Record Types" para receber uma lista dos tipos de registro disponíveis.

Se nenhum dos campos fornecidos em "Campos a serem retornados" for encontrado: "Erro ao executar a ação "Receber detalhes do registro". Motivo: nenhum dos campos fornecidos foi encontrado. Verifique a ortografia.""

 Geral
Tabela do painel de casos

Nome:Record {record Id}Details

Colunas:

Chave

Valor

 Geral

Receber código de autorização OAuth

Descrição

Gere um código de autorização do OAuth no BMC Helix Remedyforce. Consulte o portal de documentação para mais informações.

Parâmetros

Nome de exibição do parâmetro Tipo Valor padrão É obrigatório Descrição
URL de redirecionamento String https://localhost Sim Especifique o URL de redirecionamento usado quando o "App Connector" foi criado.

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 valor
is_success is_success=False
is_success is_success=True
Painel de casos
Tipo de resultado Valor/descrição Tipo (entidade \ geral)
Mensagem de saída*

A ação não pode falhar nem interromper a execução de um playbook:

"O URL do código de autorização foi gerado no BMC Helix Remedyforce. Copie e cole no navegador. Depois disso, copie a parte "code" do URL. Esse código de autorização é usado na ação "Receber token de atualização do OAuth".

 Geral
Link

Nome:link do código de autorização
URL: {generated link}

Receber token 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 usando "Receber código de autorização do OAuth". Consulte o portal de documentação para mais informações.

Parâmetros

Nome de exibição do parâmetro Tipo Valor padrão É obrigatório Descrição
URL de redirecionamento String https://localhost Sim Especifique o URL de redirecionamento usado quando o "App Connector" foi criado.
Código de autorização String N/A Sim Especifique o código de autorização da ação "Receber código de autorização do 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 valor
is_success is_success=False
is_success is_success=True
Resultado do 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"
}
Painel de casos
Tipo de resultado Valor/descrição Tipo (entidade \ geral)
Mensagem de saída*

A ação não pode falhar nem interromper a execução de um playbook:
if 200 (is_success = true): "Successfully generated refresh token in BMC Helix Remedyforce.".

A ação precisa falhar e interromper a execução de um playbook:
se houver um erro fatal, como credenciais incorretas, sem conexão com o servidor, outro: "Erro ao executar a ação "Receber token de atualização do OAuth". Motivo: {0}''.format(error.Stacktrace)

Se o código de status não for 200: "Erro ao executar a ação "Get OAuth Refresh Token". Motivo: {0}''.format(error_description)

 Geral

Listar tipos de registros

Descrição

Liste os tipos de registros disponíveis no BMC Helix Remedyforce.

Parâmetros

Nome de exibição do parâmetro Tipo Valor padrão É obrigatório Descrição
Lógica de filtro DDL

Igual

DDL

Igual

Contém

 Não Especifique qual lógica de filtro deve ser aplicada.
Valor do filtro String N/A Não Especifique o valor que será usado no filtro. Se "Igual" estiver selecionado, a ação vai tentar encontrar a correspondência exata entre os tipos de registro. Se "Contém" estiver selecionado, a ação vai tentar encontrar tipos de registro que contenham essa substring. Se nada for fornecido nesse parâmetro, o filtro não será aplicado.
Número máximo de tipos de registro a serem retornados Número inteiro 50 Não Especifique quantos tipos de registros retornar.

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 valor
is_success is_success=False
is_success is_success=True
Painel de casos
Tipo de resultado Valor/descrição Tipo (entidade \ geral)
Mensagem de saída*

A ação não pode falhar nem interromper a execução de um playbook:
se pelo menos um for encontrado (is_success = true): "Listou com êxito os tipos de registros disponíveis com base nos critérios fornecidos no BMC Helix Remedyforce.

Se nada for encontrado(is_success=true): "Nenhum tipo de registro foi encontrado com base nos critérios fornecidos no BMC Helix Remedyforce"

A ação precisa falhar e interromper a execução de um playbook:
se houver um erro fatal, como credenciais incorretas, sem conexão com o servidor, outro:"Erro ao executar a ação "List Record Types". Motivo: {0}''.format(error.Stacktrace)

 Geral
Painel de casos

Nome:tipos de registros disponíveis

Colunas:

Nome

Rótulo

Personalizado

Geral

Ping

Descrição

Teste a conectividade com o BMC Helix Remedyforce usando os parâmetros fornecidos na página de configuração da integração na guia "Marketplace" do Google Security Operations.

Executar em

Essa ação não é executada em entidades.

Resultados da ação

Resultado do script
Nome do resultado do script Opções de valor
is_success is_success=False
is_success is_success=True
Painel de casos
Tipo de resultado Valor/descrição Tipo (entidade \ geral)
Mensagem de saída*

A ação não pode falhar nem interromper a execução de um playbook:
se for bem-sucedida: "Conexão bem-sucedida com o servidor do BMC Helix Remedyforce usando os parâmetros de conexão fornecidos!"

A ação precisa falhar e interromper a execução de um playbook:
if not successful: "Failed to connect to the BMC Helix Remedyforce server! O erro é {0}".format(exception.stacktrace)

 Geral

Atualizar registro

Descrição

Atualizar registro no BMC Helix Remedyforce.

Parâmetros

Nome de exibição do parâmetro Tipo Valor padrão É obrigatório Descrição
Tipo de registro String N/A Sim Especifique o tipo de registro que precisa ser atualizado. Se você não souber quais tipos de registros estão disponíveis, execute a ação "List Record Types".
ID do registro String N/A Sim Especifique o ID do registro que precisa ser atualizado.
Campos a serem atualizados JSON

{

"field":"value"

}

 Sim Especifique um objeto JSON que contenha todos os campos e valores necessários que precisam 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 valor
is_success is_success=False
is_success is_success=True
Painel de casos
Tipo de resultado Valor/descrição Tipo (entidade \ geral)
Mensagem de saída*

A ação não pode falhar nem interromper a execução de um playbook:
if 204 (is_success = true): "Successfully updated {record type} record with {record id} in BMC Helix Remedyforce.".

A ação precisa falhar e interromper a execução de um playbook:
se houver um erro fatal, como credenciais incorretas, sem conexão com o servidor, outro: "Erro ao executar a ação "Atualizar registro". Motivo: {0}''.format(error.Stacktrace)

Se for 404 ou 400: "Erro ao executar a ação "Atualizar registro". Motivo: {message}.

Se o tipo de registro não for encontrado:erro ao executar a ação "Atualizar registro". Motivo: {Record Type} não foi encontrado no BMC Helix Remedyforce. Use a ação "List Record Types" para receber uma lista dos tipos de registro disponíveis.

Se o payload JSON for inválido: "Erro ao executar a ação "Atualizar registro". Motivo: payload JSON inválido fornecido no parâmetro "Campos a serem atualizados". Verifique a estrutura.

 Geral

Aguardar atualização de campos

Descrição

Aguarde a atualização dos campos no BMC Helix Remedyforce.

Parâmetros

Nome de exibição do parâmetro Tipo Valor padrão É obrigatório Descrição
Tipo de registro String N/A Sim Especifique o tipo de registro para o qual você está aguardando uma atualização. Se você não souber quais tipos de registros estão disponíveis, execute a ação "List Record Types".
ID do registro String N/A Sim Especifique o ID do registro que precisa ser atualizado.
Campos a serem verificados JSON

{

"field":"value"

}

 Sim Especifique um objeto JSON que contenha todos os campos e valores necessários.
Falhar se houver tempo limite Caixa de seleção Selecionado Sim Se ativada, a ação vai falhar 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 valor
is_success is_success=False
is_success is_success=True
Resultado do 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
}
Painel de casos
Tipo de resultado Valor/descrição Tipo (entidade \ geral)
Mensagem de saída*

A ação não pode falhar nem interromper a execução de um playbook:
if 201 (is_success = true): "O registro {record type} com ID {record id} foi atualizado no BMC Helix Remedyforce.".

Se um dos campos não foi atualizado e a opção "Falhar se o tempo limite não estiver ativado" não estiver marcada (is_success=false): "Os seguintes campos não foram atualizados para o registro {record type} com ID {record id} no BMC Helix Remedyforce: {fields that were not updated}"

Mensagem assíncrona:aguardando a atualização dos seguintes campos para o registro {record type} com ID {record id} no BMC Helix Remedyforce: {fields that were not updated}

A ação precisa falhar e interromper a execução de um playbook:
se houver um erro fatal, como credenciais incorretas, sem conexão com o servidor, outro: "Erro ao executar a ação "Aguardar atualização de campos". Motivo: {0}''.format(error.Stacktrace)

Se alguns campos não forem encontrados: "Erro ao executar a ação "Aguardar atualização de campos". Motivo: os seguintes campos não foram encontrados na estrutura do registro: {campos que não foram encontrados}.

Se o tipo de registro não foi encontrado:erro ao executar a ação "Aguardar atualização de campos". Motivo: {Record Type} não foi encontrado no BMC Helix Remedyforce. Use a ação "List Record Types" para receber uma lista dos tipos de registro disponíveis.

Se um dos campos não foi atualizado e a opção "Falhar se o tempo limite estiver ativado" (is_success=false) estiver marcada: "Erro ao executar a ação "Aguardar atualização dos campos". Motivo: os seguintes campos não foram atualizados para o registro de {record type} com 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 dos campos". Motivo: payload JSON inválido fornecido no parâmetro "Campos a serem verificados". Verifique a estrutura.

 Geral

Conector

BMC Helix Remedyforce - conector de incidentes

Descrição

Extrai informações sobre incidentes do BMC Helix Remedyforce.

Configurar o conector de incidentes do BMC Helix Remedyforce no Google SecOps

Para instruções detalhadas sobre como configurar um conector no Google SecOps, consulte Configurar o conector.

Parâmetros do conector

Use os seguintes parâmetros para configurar o conector:

Nome de exibição do parâmetro Tipo Valor padrão É obrigatório Descrição
Nome do campo do produto String Nome do produto Sim Insira o nome do campo de origem para recuperar o nome do campo do produto.
Nome do campo do evento String BMCServiceDesk__Type__c Sim Insira o nome do campo de origem para recuperar o nome do campo de evento.
Nome do campo de ambiente String "" Não

Descreve o nome do campo em que o nome do ambiente é armazenado.

Se o campo de ambiente não for encontrado, o ambiente será o padrão.
Padrão de regex do ambiente String .* Não

Um padrão de regex a ser executado no valor encontrado no campo "Nome do campo de ambiente".

O padrão é ".*" para capturar tudo e retornar o valor sem alterações.

Usado para permitir que o usuário manipule o campo de ambiente usando a lógica de regex.

Se o padrão de regex for nulo ou vazio, ou se o valor do ambiente for nulo, o resultado final será o ambiente padrão.
Tempo limite 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 usuário String N/A Sim Nome de usuário do BMC Helix Remedyforce.
Senha Senha N/A Sim Senha do BMC Helix Remedyforce.
Menor prioridade a ser buscada Número inteiro 5 Não A prioridade mais baixa que será usada para buscar incidentes. Máximo: 5. Mínimo: 1. Se nada for informado, o conector vai ingerir todos os incidentes.
Ingerir incidentes de prioridade vazia Caixa de seleção Selecionado Não Se ativado, o conector vai buscar incidentes sem prioridade. Os alertas do Google SecOps criados dessa forma terão a prioridade definida como "Informativa".
Tipo de filtro CSV Incidente,Solicitação de serviço Não Filtro de tipo para os incidentes. Se nada for informado, o conector vai ingerir todos os incidentes. Exemplo: incidente, solicitação de serviço.
Máximo de horas para trás Número inteiro 1 Não Número de horas de onde buscar incidentes.
Número máximo de incidentes a serem buscados Número inteiro 10 Não Quantos incidentes processar por iteração de conector. O valor máximo é 200.
Usar a lista de permissões como uma lista de proibições Caixa de seleção Selecionado Sim Se ativada, a lista de permissões será usada como uma lista de bloqueios.
Verificar SSL Caixa de seleção Selecionado Sim Se ativada, verifique se o certificado SSL da conexão com o servidor do BMC Helix Remedyforce é válido.
Endereço do servidor proxy String N/A Não O endereço do servidor proxy a ser usado.
Nome de usuário do proxy String N/A Não O nome de usuário do proxy para autenticação.
Senha do proxy Senha N/A Não A senha do proxy para autenticação.
ID do cliente String N/A Não ID do cliente do BMC Helix Remedyforce do app conectado. Esse parâmetro é necessário para a autenticação OAuth. Observação: esse parâmetro tem prioridade sobre a autenticação de nome de usuário e senha.
Chave secreta do cliente Senha N/A Não Chave secreta do cliente do BMC Helix Remedyforce do app conectado. Esse parâmetro é necessário para a autenticação OAuth. Observação: esse parâmetro tem prioridade sobre a autenticação de nome de usuário e senha.
Raiz da API de login String https://login.salesforce.com Sim Raiz da API usada para autenticar no BMC Helix Remedyforce.

Regras de conector

Suporte a proxy

O conector é compatível com proxy.

Precisa de mais ajuda? Receba respostas de membros da comunidade e profissionais do Google SecOps.