BMC Helix Remedyforce

Versión de integración: 11.0

Casos prácticos

  1. Realizar la ingestión de los incidentes
  2. Realizar una acción de triaje (actualizar, crear o eliminar registros)

Cómo configurar la autenticación OAuth

A veces, el método de autenticación básica con nombre de usuario y contraseña no funciona. Esto puede ocurrir cuando la MFA está habilitada en la cuenta. En esos casos, debe configurar la autenticación OAuth.

Pasos:

  1. Ve a Configuración > Gestor de aplicaciones.
  2. Pulsa el botón "Nueva aplicación conectada".
  3. Proporciona el nombre de la aplicación conectada, el nombre de la API y el correo de contacto.
  4. "Enable OAuth Settings" debe tener el valor "true".
  5. Defina "URL de retrollamada" como "https://localhost".
  6. Añade los ámbitos "full" y "refresh_token". Ambos son necesarios para acceder a la API.
  7. Guarda la aplicación.
  8. Abre la configuración de la aplicación y copia "Consumer Key" y "Consumer Secret". "Clave de consumidor" es "ID de cliente" y "Secreto de consumidor" es "Secreto de cliente" en la configuración de la integración.
  9. Ve a la acción "Get OAuth Authorization Code" (Obtener código de autorización OAuth). "URL de redirección" es "URL de retrollamada".
  10. Ejecuta la acción. En el resultado JSON, verás una URL de autorización. Tienes que copiarlo y pegarlo en tu navegador. Al final, se le redirigirá y su URL tendrá este aspecto: "https://localhost/?code=aPrxyeILZDvX2Hhmz2gymvtuE4aow6hMnAKw_98FyXJvaN7l69bJZFr1z.ylZ3qXd0KZlXjn0g%3D%3D". Debes copiar todo lo que haya después de "code=" y asegurarte de descodificar la URL. %3D es el carácter "=".
  11. Ve a la acción "Get OAuth Refresh Token" (Obtener token de actualización de OAuth). "URL de redirección" es "URL de retrollamada" y "Código de autorización" es el "código" de la solicitud anterior.
  12. Si lo has hecho todo correctamente, verás "refresh_token" en el resultado JSON.
  13. Copia este token de actualización en la configuración de la integración y haz una prueba.

Configurar la integración de BMC Helix Remedyforce en Google Security Operations

Para obtener instrucciones detalladas sobre cómo configurar una integración en Google SecOps, consulta Configurar integraciones.

Parámetros de integración

Usa los siguientes parámetros para configurar la integración:

Nombre visible del parámetro Tipo Valor predeterminado Es obligatorio Descripción
Raíz de la API Cadena https://.my.salesforce.com Sí Raíz de la API de la instancia de BMC Helix Remedyforce.
Nombre de usuario Cadena N/A No Nombre de usuario de BMC Helix Remedyforce.
Contraseña Contraseña N/A No Contraseña de BMC Helix Remedyforce.
ID de cliente Cadena N/A No ID de cliente de BMC Helix Remedyforce de la aplicación conectada. Este parámetro es necesario para la autenticación de OAuth. Nota: Este parámetro tiene prioridad sobre la autenticación con nombre de usuario y contraseña.
Secreto de cliente Contraseña N/A No Secreto de cliente de BMC Helix Remedyforce de la aplicación conectada. Este parámetro es necesario para la autenticación de OAuth. Nota: Este parámetro tiene prioridad sobre la autenticación con nombre de usuario y contraseña.
Token de actualización Contraseña N/A No Token de actualización de la autorización de OAuth.
Verificar SSL Casilla Marcada Sí Si está habilitada, verifica que el certificado SSL de la conexión al servidor de BMC Helix Remedyforce sea válido.
Raíz de la API de inicio de sesión Cadena https://login.salesforce.com Sí Raíz de la API que se usa para autenticar en BMC Helix Remedyforce.

Acciones

Crear registro

Descripción

Crea un registro en BMC Helix Remedyforce.

Parámetros

Nombre visible del parámetro Tipo Valor predeterminado Es obligatorio Descripción
Tipo de registro Cadena N/A Sí Especifica el tipo de registro que se debe crear. Si no sabes qué tipo de registros hay disponibles, ejecuta la acción "List Record Types" (Mostrar tipos de registros).
Carga útil de registro JSON

{

"field":"value"

}

 Sí Especifica un objeto JSON que contenga todos los campos y valores necesarios.

Fecha de ejecución

La acción no se ejecuta en entidades ni tiene parámetros de entrada obligatorios.

Resultados de la acción

Resultado de secuencia de comandos
Nombre del resultado de la secuencia de comandos Opciones de valor
is_success is_success=False
is_success is_success=True
Resultado de JSON
{
    "id": "0015e000005dVbKAAU",
    "success": true,
    "errors": []
}
Panel de casos
Tipo de resultado Valor/Descripción Tipo (entidad o general)
Mensaje de salida*

La acción no debe fallar ni detener la ejecución de un libro de jugadas:
si 201 (is_success = true): "Se ha creado correctamente el registro {record type} en BMC Helix Remedyforce".

La acción debería fallar y detener la ejecución de un libro de jugadas:
si se produce un error grave, como credenciales incorrectas, no hay conexión con el servidor u otro: "Error al ejecutar la acción "Crear registro". Motivo: {0}''.format(error.Stacktrace)

Si es 400: "Error al ejecutar la acción "Crear registro". Motivo: {message}.

Si no se ha encontrado el tipo de registro: error al ejecutar la acción "Crear registro". Motivo: no se ha encontrado {Record Type} en BMC Helix Remedyforce. Usa la acción "List Record Types" para obtener una lista de los tipos de registro disponibles.

Si la carga útil de JSON no es válida: "Error al ejecutar la acción "Crear registro". Motivo: se ha proporcionado una carga útil JSON no válida en el parámetro "Carga útil de registro". Comprueba la estructura.

 General

Eliminar registro

Descripción

Eliminar un registro en BMC Helix Remedyforce.

Parámetros

Nombre visible del parámetro Tipo Valor predeterminado Es obligatorio Descripción
Tipo de registro Cadena N/A Sí Especifica el tipo de registro que se debe eliminar. Si no sabes qué tipo de registros hay disponibles, ejecuta la acción "List Record Types" (Mostrar tipos de registros).
ID de registro Cadena N/A Sí Especifica el ID del registro que se debe eliminar.

Fecha de ejecución

La acción no se ejecuta en entidades ni tiene parámetros de entrada obligatorios.

Resultados de la acción

Resultado de secuencia de comandos
Nombre del resultado de la secuencia de comandos Opciones de valor
is_success is_success=False
is_success is_success=True
Panel de casos
Tipo de resultado Valor/Descripción Tipo (entidad o general)
Mensaje de salida*

La acción no debe fallar ni detener la ejecución de un libro de jugadas:
si 204 (is_success = true): "Se ha eliminado correctamente el registro {Record Type} con el ID {record id} en BMC Helix Remedyforce.

Si se devuelve el error 404 (is_success=true): "No existe el registro {Record Type} con el ID {record id} en BMC Helix Remedyforce.

La acción debería fallar y detener la ejecución de la guía:

Si se produce un error grave, como credenciales incorrectas, no hay conexión con el servidor u otro: "Error al ejecutar la acción "Eliminar registro". Motivo: {0}''.format(error.Stacktrace)

Si no se ha encontrado el tipo de registro: error al ejecutar la acción "Eliminar registro". Motivo: no se ha encontrado {Record Type} en BMC Helix Remedyforce. Usa la acción "List Record Types" para obtener una lista de los tipos de registro disponibles.

 General

Ejecutar consulta personalizada

Descripción

Ejecuta una consulta SOQL personalizada en BMC Helix Remedyforce.

Parámetros

Nombre visible del parámetro Tipo Valor predeterminado Es obligatorio Descripción
Consulta SOQL Cadena N/A Sí Especifica qué consulta se debe ejecutar.

Fecha de ejecución

La acción no se ejecuta en entidades ni tiene parámetros de entrada obligatorios.

Resultados de la acción

Resultado de secuencia de comandos
Nombre del resultado de la secuencia de comandos Opciones de valor
is_success is_success=False
is_success is_success=True
Resultado de 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
}
Panel de casos
Tipo de resultado Valor/Descripción Tipo (entidad o general)
Mensaje de salida*

La acción no debe fallar ni detener la ejecución de un libro de jugadas:
si se encuentra al menos un resultado (is_success = true): "Se han devuelto resultados correctamente para la consulta "{query}" en BMC Helix Remedyforce.

Si no se ha encontrado nada(is_success=true): "No se han encontrado resultados para la consulta "{query}" en BMC Helix Remedyforce"

La acción debería fallar y detener la ejecución de un cuaderno de estrategias:
si se produce un error grave, como credenciales incorrectas, no hay conexión con el servidor u otro: "Error al ejecutar la acción "Ejecutar consulta personalizada". Motivo: {0}''.format(error.Stacktrace)

 General
Panel de casos Nombre: resultados General

Ejecutar consulta simple

Descripción

Ejecuta una consulta SOQL basada en parámetros de BMC Helix Remedyforce.

Parámetros

Nombre visible del parámetro Tipo Valor predeterminado Es obligatorio Descripción
Tipo de registro Cadena N/A Sí Especifica qué tipo de registro se debe consultar.
Where Filter Cadena N/A No Especifica el filtro WHERE de la consulta que se debe ejecutar. Nota: No es necesario que proporcione filtros de tiempo, límites ni ordenación. Además, no es necesario que proporcione la cadena WHERE en la carga útil.
Periodo DDL

Última hora

Valores posibles:

Última hora

Últimas 6 horas

Últimas 24 horas

La semana pasada

El mes pasado

Personalizado

 No Especifica un periodo para los resultados. Si se selecciona "Personalizado", también debe indicar la "Hora de inicio".
Hora de inicio Cadena N/A No Especifica la hora de inicio de los resultados. Este parámetro es obligatorio si se selecciona "Personalizado" en el parámetro "Periodo". Formato: ISO 8601
Hora de finalización Cadena N/A No Especifica la hora de finalización de los resultados. Formato: ISO 8601. Si no se proporciona nada y se selecciona "Personalizado" en el parámetro "Periodo", se usará la hora actual.
Campos que se van a devolver CSV N/A No Especifica qué campos quieres que se devuelvan. Si no se proporciona nada, la acción devolverá todos los campos.
Campo de ordenación Cadena CreatedDate No Especifica qué parámetro se debe usar para ordenar.
Orden de clasificación DDL

Ascendente

Valores posibles:

Ascendente

Descendente

 No Especifica el orden de clasificación.
Número máximo de resultados que se devolverán Entero 50 No Especifica el número de resultados que quieres devolver. Valor predeterminado: 50. El máximo es 200.

Fecha de ejecución

La acción no se ejecuta en entidades ni tiene parámetros de entrada obligatorios.

Resultados de la acción

Resultado de secuencia de comandos
Nombre del resultado de la secuencia de comandos Opciones de valor
is_success is_success=False
is_success is_success=True
Resultado de 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
}
Panel de casos
Tipo de resultado Valor/Descripción Tipo (entidad o general)
Mensaje de salida*

La acción no debe fallar ni detener la ejecución de un libro de jugadas:
si se encuentra al menos un resultado (is_success = true): "Se han devuelto resultados correctamente para la consulta "{query}" en BMC Helix Remedyforce.

Si no se ha encontrado nada(is_success=true): "No se han encontrado resultados para la consulta "{query}" en BMC Helix Remedyforce"

La acción debería fallar y detener la ejecución de un libro de jugadas:
si se produce un error grave, como credenciales incorrectas, no hay conexión con el servidor u otro: "Error al ejecutar la acción "Ejecutar consulta simple". Motivo: {0}''.format(error.Stacktrace)

 General
Panel de casos Nombre: resultados General

Obtener detalles de la grabación

Descripción

Obtén información detallada sobre el registro de BMC Helix Remedyforce.

Parámetros

Nombre visible del parámetro Tipo Valor predeterminado Es obligatorio Descripción
Tipo de registro Cadena N/A Sí Especifica el tipo de registro del que quieres obtener los detalles. Si no sabes qué tipo de registros hay disponibles, ejecuta la acción "List Record Types" (Mostrar tipos de registros).
IDs de registro CSV N/A Sí Especifica los IDs de los registros de los que quieras obtener detalles.
Campos que se van a devolver CSV N/A No Especifica qué campos quieres que se devuelvan. Si no se encuentra ninguno de los campos proporcionados, la acción fallará. Si no se proporciona nada, la acción devolverá todos los campos.

Fecha de ejecución

La acción no se ejecuta en entidades ni tiene parámetros de entrada obligatorios.

Resultados de la acción

Resultado de secuencia de comandos
Nombre del resultado de la secuencia de comandos Opciones de valor
is_success is_success=False
is_success is_success=True
Resultado de 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
}
Panel de casos
Tipo de resultado Valor/Descripción Tipo (entidad o general)
Mensaje de salida*

La acción no debe fallar ni detener la ejecución de un libro de jugadas:
si hay datos disponibles para al menos un ID(is_success = true): "Se han devuelto correctamente los detalles del tipo de registro {Record Type} para los siguientes IDs: {record ids}".

Si no hay datos disponibles para al menos un ID (is_success=true): "No se han podido encontrar detalles sobre el tipo de registro {Record Type} para los siguientes IDs: {record ids}".

Si no hay datos disponibles para todos los registros (is_success=false): no se han encontrado registros.

La acción debería fallar y detener la ejecución de un cuaderno de estrategias:
si se produce un error grave, como credenciales incorrectas, no hay conexión con el servidor u otro error: "Error al ejecutar la acción "Obtener detalles del registro". Motivo: {0}''.format(error.Stacktrace)

Si no se ha encontrado el tipo de registro: error al ejecutar la acción "Obtener detalles del registro". Motivo: no se ha encontrado {Record Type} en BMC Helix Remedyforce. Usa la acción "List Record Types" para obtener una lista de los tipos de registro disponibles.

Si no se ha encontrado ninguno de los campos proporcionados en "Campos que devolver": "Error al ejecutar la acción "Obtener detalles del registro". Motivo: no se ha encontrado ninguno de los campos proporcionados. Comprueba la ortografía".

 General
Tabla del panel de casos

Nombre: Detalles del registro {record Id}

Columnas:

Clave

Valor

 General

Obtener código de autorización de OAuth

Descripción

Genera un código de autorización OAuth en BMC Helix Remedyforce. Consulta el portal de documentación para obtener más información.

Parámetros

Nombre visible del parámetro Tipo Valor predeterminado Es obligatorio Descripción
URL de redirección Cadena https://localhost Sí Especifica la URL de redireccionamiento que se usó al crear la aplicación Connector.

Fecha de ejecución

La acción no se ejecuta en entidades ni tiene parámetros de entrada obligatorios.

Resultados de la acción

Resultado de secuencia de comandos
Nombre del resultado de la secuencia de comandos Opciones de valor
is_success is_success=False
is_success is_success=True
Panel de casos
Tipo de resultado Valor/Descripción Tipo (entidad o general)
Mensaje de salida*

La acción no debe fallar ni detener la ejecución de una guía:

"Se ha generado correctamente la URL del código de autorización en BMC Helix Remedyforce. Cópiala y pégala en el navegador. Después, copia la parte "code" de la URL. Este código de autorización se usa en la acción "Get OAuth Refresh Token" (Obtener token de actualización de OAuth).

 General
Enlace

Nombre: enlace de código de autorización
URL: {generated link}

Obtener token de actualización de OAuth

Descripción

Genera el token de actualización necesario para configurar la integración. El código de autorización se puede generar con "Get OAuth Authorization Code" (Obtener código de autorización de OAuth). Para obtener más información, consulta el portal de documentación.

Parámetros

Nombre visible del parámetro Tipo Valor predeterminado Es obligatorio Descripción
URL de redirección Cadena https://localhost Sí Especifica la URL de redireccionamiento que se usó al crear la aplicación Connector.
Código de autorización Cadena N/A Sí Especifica el código de autorización de la acción "Get OAuth Authorization Code" (Obtener código de autorización de OAuth).

Fecha de ejecución

La acción no se ejecuta en entidades ni tiene parámetros de entrada obligatorios.

Resultados de la acción

Resultado de secuencia de comandos
Nombre del resultado de la secuencia de comandos Opciones de valor
is_success is_success=False
is_success is_success=True
Resultado de 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"
}
Panel de casos
Tipo de resultado Valor/Descripción Tipo (entidad o general)
Mensaje de salida*

La acción no debe fallar ni detener la ejecución de un playbook:
if 200 (is_success = true): "Successfully generated refresh token in BMC Helix Remedyforce.".

La acción debería fallar y detener la ejecución de un cuaderno de jugadas:
si se produce un error grave, como credenciales incorrectas, no hay conexión con el servidor u otro error: "Error al ejecutar la acción "Obtener token de actualización de OAuth". Motivo: {0}''.format(error.Stacktrace)

Si el código de estado no es 200: "Error al ejecutar la acción "Obtener token de actualización de OAuth". Motivo: {0}''.format(error_description)

 General

Mostrar tipos de registros

Descripción

Lista los tipos de registros disponibles de BMC Helix Remedyforce.

Parámetros

Nombre visible del parámetro Tipo Valor predeterminado Es obligatorio Descripción
Lógica de filtro DDL

Igual

DDL

Igual

Contiene

 No Especifica la lógica de filtro que se debe aplicar.
Valor de filtro Cadena N/A No Especifica el valor que se debe usar en el filtro. Si se selecciona "Igual", la acción intentará encontrar la coincidencia exacta entre los tipos de registro. Si se selecciona "Contiene", la acción intentará encontrar los tipos de registro que contengan esa subcadena. Si no se proporciona nada en este parámetro, no se aplicará el filtro.
Número máximo de tipos de registros que se devolverán Entero 50 No Especifica cuántos tipos de registros quieres que se devuelvan.

Fecha de ejecución

La acción no se ejecuta en entidades ni tiene parámetros de entrada obligatorios.

Resultados de la acción

Resultado de secuencia de comandos
Nombre del resultado de la secuencia de comandos Opciones de valor
is_success is_success=False
is_success is_success=True
Panel de casos
Tipo de resultado Valor/Descripción Tipo (entidad o general)
Mensaje de salida*

La acción no debe fallar ni detener la ejecución de un libro de jugadas:
si se encuentra al menos un elemento (is_success = true): "Se han enumerado correctamente los tipos de registro disponibles en función de los criterios proporcionados en BMC Helix Remedyforce.

Si no se ha encontrado nada(is_success=true): "No se han encontrado tipos de registro basados en los criterios proporcionados en BMC Helix Remedyforce"

La acción debería fallar y detener la ejecución de un libro de jugadas:
si se produce un error grave, como credenciales incorrectas, no hay conexión con el servidor u otro error:"Error al ejecutar la acción "List Record Types". Motivo: {0}''.format(error.Stacktrace)

 General
Panel de casos

Nombre: Tipos de registro disponibles

Columnas:

Nombre

Etiqueta

Personalizado

General

Ping

Descripción

Prueba la conectividad con BMC Helix Remedyforce con los parámetros proporcionados en la página de configuración de la integración de la pestaña Google Security Operations Marketplace.

Fecha de ejecución

Esta acción no se ejecuta en entidades.

Resultados de la acción

Resultado de secuencia de comandos
Nombre del resultado de la secuencia de comandos Opciones de valor
is_success is_success=False
is_success is_success=True
Panel de casos
Tipo de resultado Valor/Descripción Tipo (entidad o general)
Mensaje de salida*

La acción no debe fallar ni detener la ejecución de un libro de jugadas:
Si se realiza correctamente: "Successfully connected to the BMC Helix Remedyforce server with the provided connection parameters!" ("Se ha conectado correctamente al servidor de BMC Helix Remedyforce con los parámetros de conexión proporcionados").

La acción debería fallar y detener la ejecución de un libro de jugadas:
si no se ha completado correctamente: "Failed to connect to the BMC Helix Remedyforce server! Error: {0}".format(exception.stacktrace)

 General

Actualizar registro

Descripción

Actualiza el registro en BMC Helix Remedyforce.

Parámetros

Nombre visible del parámetro Tipo Valor predeterminado Es obligatorio Descripción
Tipo de registro Cadena N/A Sí Especifica el tipo de registro que se debe actualizar. Si no sabes qué tipo de registros hay disponibles, ejecuta la acción "List Record Types" (Mostrar tipos de registros).
ID de registro Cadena N/A Sí Especifica el ID del registro que se debe actualizar.
Campos que se van a actualizar JSON

{

"field":"value"

}

 Sí Especifica un objeto JSON que contenga todos los campos y valores que deban actualizarse.

Fecha de ejecución

La acción no se ejecuta en entidades ni tiene parámetros de entrada obligatorios.

Resultados de la acción

Resultado de secuencia de comandos
Nombre del resultado de la secuencia de comandos Opciones de valor
is_success is_success=False
is_success is_success=True
Panel de casos
Tipo de resultado Valor/Descripción Tipo (entidad o general)
Mensaje de salida*

La acción no debe fallar ni detener la ejecución de un cuaderno de estrategias:
si se devuelve el código 204 (is_success = true): "Se ha actualizado correctamente el registro {record type} con el ID {record id} en BMC Helix Remedyforce".

La acción debería fallar y detener la ejecución de un cuaderno de estrategias:
si se produce un error grave, como credenciales incorrectas, no hay conexión con el servidor u otro: "Error al ejecutar la acción "Update Record". Motivo: {0}''.format(error.Stacktrace)

Si se produce un error 404 o 400: "Error al ejecutar la acción "Update Record". Motivo: {message}.

Si no se ha encontrado el tipo de registro: error al ejecutar la acción "Update Record" (Actualizar registro). Motivo: no se ha encontrado {Record Type} en BMC Helix Remedyforce. Usa la acción "List Record Types" para obtener una lista de los tipos de registro disponibles.

Si la carga útil de JSON no es válida: "Error al ejecutar la acción "Actualizar registro". Motivo: Se ha proporcionado una carga útil de JSON no válida en el parámetro "Campos que actualizar". Comprueba la estructura.

 General

Esperar a que se actualicen los campos

Descripción

Espera a que se actualicen los campos en BMC Helix Remedyforce.

Parámetros

Nombre visible del parámetro Tipo Valor predeterminado Es obligatorio Descripción
Tipo de registro Cadena N/A Sí Especifique el tipo de registro del que espera una actualización. Si no sabes qué tipo de registros hay disponibles, ejecuta la acción "List Record Types" (Mostrar tipos de registros).
ID de registro Cadena N/A Sí Especifica el ID del registro que se debe actualizar.
Campos que se deben comprobar JSON

{

"field":"value"

}

 Sí Especifica un objeto JSON que contenga todos los campos y valores necesarios.
Falla si se agota el tiempo de espera Casilla Marcada Sí Si se habilita esta opción, la acción fallará si no se actualizan todos los campos.

Fecha de ejecución

La acción no se ejecuta en entidades ni tiene parámetros de entrada obligatorios.

Resultados de la acción

Resultado de secuencia de comandos
Nombre del resultado de la secuencia de comandos Opciones de valor
is_success is_success=False
is_success is_success=True
Resultado de 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
}
Panel de casos
Tipo de resultado Valor/Descripción Tipo (entidad o general)
Mensaje de salida*

La acción no debe fallar ni detener la ejecución de un cuaderno de estrategias:
si 201 (is_success = true): "Se ha actualizado el registro {record type} con el ID {record id} en BMC Helix Remedyforce".

Si no se ha actualizado uno de los campos y la opción Fallar si el tiempo de espera no está habilitado (is_success=false): "No se han actualizado los siguientes campos del registro {record type} con el ID {record id} en BMC Helix Remedyforce: {fields that were not updated}" ("No se han actualizado los siguientes campos del registro {record type} con el ID {record id} en BMC Helix Remedyforce: {fields that were not updated}")

Mensaje asíncrono: esperando a que se actualicen los siguientes campos del registro {record type} con el ID {record id} en BMC Helix Remedyforce: {fields that were not updated}

La acción debería fallar y detener la ejecución de un cuaderno de estrategias:
si se produce un error grave, como credenciales incorrectas, no hay conexión con el servidor u otro error: "Error al ejecutar la acción "Wait For Fields Update". Motivo: {0}''.format(error.Stacktrace)

Si no se han encontrado algunos campos: "Error al ejecutar la acción "Esperar a que se actualicen los campos". Motivo: no se han encontrado los siguientes campos en la estructura del registro: {fields that were not found}.

Si no se ha encontrado el tipo de registro: error al ejecutar la acción "Esperar a que se actualicen los campos". Motivo: no se ha encontrado {Record Type} en BMC Helix Remedyforce. Usa la acción "List Record Types" para obtener una lista de los tipos de registro disponibles.

Si no se ha actualizado uno de los campos y se ha habilitado la opción Fallar si se agota el tiempo de espera (is_success=false): "Error al ejecutar la acción "Esperar a que se actualicen los campos". Motivo: No se han actualizado los siguientes campos del registro {record type} con el ID {record id} en BMC Helix Remedyforce: {fields that were not updated}"

Si la carga útil de JSON no es válida: "Error al ejecutar la acción "Esperar a que se actualicen los campos". Motivo: Se ha proporcionado una carga útil de JSON no válida en el parámetro "Fields To Check". Comprueba la estructura.

 General

Conector

BMC Helix Remedyforce - Incidents Connector

Descripción

Extrae información sobre incidentes de BMC Helix Remedyforce.

Configurar el conector de incidentes de BMC Helix Remedyforce en Google SecOps

Para obtener instrucciones detalladas sobre cómo configurar un conector en Google SecOps, consulta el artículo Configurar el conector.

Parámetros del conector

Utiliza los siguientes parámetros para configurar el conector:

Nombre visible del parámetro Tipo Valor predeterminado Es obligatorio Descripción
Nombre del campo de producto Cadena Nombre del producto Sí Introduce el nombre del campo de origen para obtener el nombre del campo de producto.
Nombre del campo de evento Cadena BMCServiceDesk__Type__c Sí Introduzca el nombre del campo de origen para obtener el nombre del campo de evento.
Nombre del campo de entorno Cadena "" No

Describe el nombre del campo en el que se almacena el nombre del entorno.

Si no se encuentra el campo de entorno, se utiliza el entorno predeterminado.
Patrón de regex de entorno Cadena .* No

Una expresión regular que se aplicará al valor encontrado en el campo "Nombre del campo de entorno".

El valor predeterminado es .* para captar todos los valores y devolverlos sin cambios.

Se usa para permitir que el usuario manipule el campo del entorno mediante la lógica de expresiones regulares.

Si el patrón de expresión regular es nulo o está vacío, o si el valor del entorno es nulo, el resultado final del entorno será el entorno predeterminado.
Tiempo de espera de secuencia de comandos (segundos) Entero 180 Sí Límite de tiempo de espera del proceso de Python que ejecuta la secuencia de comandos actual.
Raíz de la API Cadena https://.my.salesforce.com Sí Raíz de la API de la instancia de BMC Helix Remedyforce.
Nombre de usuario Cadena N/A Sí Nombre de usuario de BMC Helix Remedyforce.
Contraseña Contraseña N/A Sí Contraseña de BMC Helix Remedyforce.
Prioridad más baja para obtener Entero 5 No Prioridad más baja que se usará para obtener incidencias. Máximo: 5. Mínimo: 1. Si no se proporciona nada, el conector ingerirá todos los incidentes.
Ingest Empty Priority Incidents Casilla Marcada No Si está habilitada, el conector obtendrá las incidencias que no tengan prioridad. Las alertas de Google SecOps creadas de esta forma tendrán la prioridad "Informativa".
Tipo de filtro CSV Incident,Service Request No Tipo de filtro de los incidentes. Si no se proporciona nada, el conector ingerirá todos los incidentes. Por ejemplo, Incidencia o Solicitud de servicio.
Número máximo de horas hacia atrás Entero 1 No Número de horas desde las que se deben obtener los incidentes.
Número máximo de incidentes que se van a obtener Entero 10 No Número de incidentes que se procesan por cada iteración del conector. El máximo es 200.
Usar la lista blanca como lista negra Casilla Marcada Sí Si está habilitada, la lista de permitidos se usará como lista de denegados.
Verificar SSL Casilla Marcada Sí Si está habilitada, compruebe que el certificado SSL de la conexión al servidor de BMC Helix Remedyforce es válido.
Dirección del servidor proxy Cadena N/A No Dirección del servidor proxy que se va a usar.
Nombre de usuario del proxy Cadena N/A No Nombre de usuario del proxy para autenticarse.
Contraseña del proxy Contraseña N/A No La contraseña del proxy para autenticarte.
ID de cliente Cadena N/A No ID de cliente de BMC Helix Remedyforce de la aplicación conectada. Este parámetro es necesario para la autenticación de OAuth. Nota: Este parámetro tiene prioridad sobre la autenticación con nombre de usuario y contraseña.
Secreto de cliente Contraseña N/A No Secreto de cliente de BMC Helix Remedyforce de la aplicación conectada. Este parámetro es necesario para la autenticación de OAuth. Nota: Este parámetro tiene prioridad sobre la autenticación con nombre de usuario y contraseña.
Raíz de la API de inicio de sesión Cadena https://login.salesforce.com Sí Raíz de la API que se usa para autenticar en BMC Helix Remedyforce.

Reglas de conectores

Compatibilidad con proxy

El conector admite proxy.

¿Necesitas más ayuda? Recibe respuestas de los miembros de la comunidad y de los profesionales de Google SecOps.