BMC Helix Remedyforce

Versão da integração: 11.0

Exemplos de utilização

  1. Realize a carregamento dos incidentes
  2. 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:

  1. Navegue para Configuração -> Gestor de apps.
  2. Prima o botão "Nova app associada".
  3. Indique o "Nome da app associada", o "Nome da API" e o "Email de contacto".
  4. "Enable OAuth Settings" deve estar definido como verdadeiro.
  5. Defina o "URL de retorno" como "https://localhost".
  6. Adicione os âmbitos "full" e "refresh_token". Ambos são necessários para aceder à API.
  7. Guarde a app.
  8. 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.
  9. Aceda à ação "Obter código de autorização OAuth". "URL de redirecionamento" é "URL de callback".
  10. 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 "=".
  11. 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.
  12. Se tudo tiver sido feito corretamente, verá "refresh_token" no resultado JSON.
  13. 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:
if 201 (is_success = true): "Successfully created {record type} record in BMC Helix Remedyforce.".

A ação deve falhar e parar a execução de um playbook:
se ocorrer um erro fatal, como credenciais incorretas, sem ligação ao servidor, entre outros: "Erro ao executar a ação "Criar registo". Motivo: {0}''.format(error.Stacktrace)

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:
se 204 (is_success = true): "Successfully deleted {Record Type} record with ID {record id} in BMC Helix Remedyforce.

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 for encontrado, pelo menos, um (is_success = true): "Successfully returned results for the query "{query}" in BMC Helix Remedyforce.

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:
se ocorrer um erro fatal, como credenciais incorretas, sem ligação ao servidor, entre outros: "Erro ao executar a ação "Executar consulta personalizada". Motivo: {0}''.format(error.Stacktrace)

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 for encontrado, pelo menos, um (is_success = true): "Successfully returned results for the query "{query}" in BMC Helix Remedyforce.

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:
se ocorrer um erro fatal, como credenciais incorretas, nenhuma ligação ao servidor ou outro: "Erro ao executar a ação "Executar consulta simples". Motivo: {0}''.format(error.Stacktrace)

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 estiverem disponíveis para, pelo menos, um ID(is_success = true): "Foram devolvidos com êxito detalhes sobre o tipo de registo {Record Type} 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 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 ocorrer um erro fatal, como credenciais incorretas, sem ligação ao servidor, entre outros: "Erro ao executar a ação "Obter detalhes do registo". Motivo: {0}''.format(error.Stacktrace)

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
URL: {generated link}

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:
if 200 (is_success = true): "Successfully generated refresh token in BMC Helix Remedyforce.".

A ação deve falhar e parar a execução de um manual de procedimentos:
se ocorrer um erro fatal, como credenciais incorretas, nenhuma ligação ao servidor, entre outros: "Erro ao executar a ação "Obter token de atualização do OAuth". Motivo: {0}''.format(error.Stacktrace)

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 for encontrado, pelo menos, um (is_success = true): "Listou com êxito os tipos de registos disponíveis com base nos critérios fornecidos no BMC Helix Remedyforce.

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:
se ocorrer um erro crítico, como credenciais incorretas, nenhuma ligação ao servidor, entre outros:"Erro ao executar a ação "List Record Types". Motivo: {0}''.format(error.Stacktrace)

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:
se for bem-sucedida: "Ligação estabelecida com êxito ao servidor do BMC Helix Remedyforce com os parâmetros de ligação fornecidos!"

A ação deve falhar e parar a execução de um manual de soluções:
se não for bem-sucedida: "Falha ao estabelecer ligação ao servidor do BMC Helix Remedyforce! O erro é {0}".format(exception.stacktrace)

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:
se 204 (is_success = true): "Successfully updated {record type} record with {record id} in BMC Helix Remedyforce.".

A ação deve falhar e parar a execução de um manual de soluções:
se ocorrer um erro fatal, como credenciais incorretas, nenhuma ligação ao servidor ou outro: "Erro ao executar a ação "Atualizar registo". Motivo: {0}''.format(error.Stacktrace)

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 201 (is_success = true): "O registo de {record type} com o ID {record id} foi atualizado no BMC Helix Remedyforce.".

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 ocorrer um erro fatal, como credenciais incorretas, nenhuma ligação ao servidor ou outro: "Erro ao executar a ação "Aguardar atualização de campos". Motivo: {0}''.format(error.Stacktrace)

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.