BMC Helix Remedyforce

Versión de integración: 11.0

Casos de uso

  1. Realiza la transferencia de los incidentes
  2. Realizar acciones de clasificación (actualizar, crear o borrar registros)

Cómo configurar la autenticación de OAuth

A veces, el método de autenticación básica que usa nombre de usuario y contraseña no funciona. Esto puede suceder cuando la MFA está habilitada para la cuenta. En esas situaciones, debes configurar la autenticación de OAuth.

Pasos:

  1. Navega a Configuración -> Administrador de apps.
  2. Presiona el botón "New Connected App".
  3. Proporciona el "Nombre de la app conectada", el "Nombre de la API" y el "Correo electrónico de contacto".
  4. "Enable OAuth Settings" debe establecerse como verdadero.
  5. Establece la "URL de devolución de llamada" en "https://localhost".
  6. Agrega los permisos "full" y "refresh_token". Ambos son necesarios para acceder a la API.
  7. Guarda la app.
  8. Abre la configuración de la app y copia la "Clave del consumidor" y el "Secreto del consumidor". "Consumer Key" es "Client ID" y "Consumer Secret" es Client Secret en la configuración de integración.
  9. Ve a la acción "Get OAuth Authorization Code". "URL de redireccionamiento" es "URL de devolución de llamada".
  10. Ejecuta la acción. En el resultado JSON, verás una URL de autorización. Debes copiarlo y pegarlo en tu navegador. Al final, se te redireccionará y tu URL se verá de la siguiente manera: "https://localhost/?code=aPrxyeILZDvX2Hhmz2gymvtuE4aow6hMnAKw_98FyXJvaN7l69bJZFr1z.ylZ3qXd0KZlXjn0g%3D%3D". Debes copiar todo lo que aparece después de "code=" y asegurarte de realizar la decodificación de URL. %3D es un carácter "=".
  11. Ve a la acción "Get OAuth Refresh Token". La "URL de redireccionamiento" es la "URL de devolución de llamada", y el "código de autorización" es el "código" de la solicitud anterior.
  12. Si todo se hizo 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 realiza una prueba de ejecución.

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

Si quieres obtener instrucciones detalladas para configurar una integración en Google SecOps, consulta Configura 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 String https://.my.salesforce.com Sí Es la raíz de la API de la instancia de BMC Helix Remedyforce.
Nombre de usuario String 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 String N/A No Es el ID de cliente de BMC Helix Remedyforce de la app 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 del cliente Contraseña N/A No Es el secreto del cliente de BMC Helix Remedyforce de la app 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 Es el token de actualización para la autorización de OAuth.
Verificar SSL Casilla de verificación Marcado Sí Si está habilitado, verifica que el certificado SSL para la conexión al servidor de BMC Helix Remedyforce sea válido.
Raíz de la API de acceso String https://login.salesforce.com Sí Es la raíz de la API que se usa para la autenticación 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 String N/A Sí Especifica el tipo de registro que se debe crear. Si no sabes qué tipo de registros están disponibles, ejecuta la acción "List Record Types".
Carga útil de registro JSON

{

"field":"value"

}

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

Ejecutar en

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": []
}
Muro de casos
Tipo de resultado Valor/Descripción Tipo (entidad\general)
Mensaje de salida*

La acción no debe fallar ni detener la ejecución de un playbook:
if 201 (is_success = true): "Successfully created {record type} record in BMC Helix Remedyforce.".

La acción debe fallar y detener la ejecución de un playbook:
Si se produce un error irrecuperable, como credenciales incorrectas, falta de conexión con el servidor o algún otro problema: "Error al ejecutar la acción "Crear registro". Reason: {0}''.format(error.Stacktrace)

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

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

Si la carga útil de JSON no es válida: "Error al ejecutar la acción "Create Record". Motivo: Se proporcionó una carga útil de JSON no válida en el parámetro "Carga útil del registro". Verifica la estructura.

 General

Borrar registro

Descripción

Borra un registro en BMC Helix Remedyforce.

Parámetros

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

Ejecutar en

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
Muro de casos
Tipo de resultado Valor/Descripción Tipo (entidad\general)
Mensaje de salida*

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

Si es 404 (is_success=true): "El registro {Tipo de registro} con el ID {ID de registro} no existe en BMC Helix Remedyforce.

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

Si se produce un error fatal, como credenciales incorrectas, falta de conexión con el servidor, etc.: "Error al ejecutar la acción "Borrar registro". Reason: {0}''.format(error.Stacktrace)

Si no se encontró el tipo de registro: Se produjo un error al ejecutar la acción "Borrar registro". Motivo: No se encontró {Record Type} en BMC Helix Remedyforce. Usa la acción "List Record Types" para obtener una lista de los tipos de registros 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 de SOQL String N/A Sí Especifica qué consulta se debe ejecutar.

Ejecutar en

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
}
Muro de casos
Tipo de resultado Valor/Descripción Tipo (entidad\general)
Mensaje de salida*

La acción no debe fallar ni detener la ejecución de una guía:
Si se encontró al menos un resultado (is_success = true): "Se devolvieron correctamente los resultados de la búsqueda "{query}" en BMC Helix Remedyforce.

Si no se encontró nada(is_success=true): "No se encontraron resultados para la búsqueda "{query}" en BMC Helix Remedyforce"

La acción debe fallar y detener la ejecución de un playbook:
si se produce un error fatal, como credenciales incorrectas, falta de conexión con el servidor, etc.: "Error al ejecutar la acción "Ejecutar consulta personalizada". Reason: {0}''.format(error.Stacktrace)

 General
Muro de casos Nombre: Resultados General

Ejecuta una consulta simple

Descripción

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

Parámetros

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

Última hora

Valores posibles:

Última hora

Últimas 6 horas

Últimas 24 horas

Última semana

Último mes

Personalizado

 No Especifica un período para los resultados. Si seleccionas "Personalizado", también debes proporcionar la "Hora de inicio".
Hora de inicio String N/A No Especifica la hora de inicio de los resultados. Este parámetro es obligatorio si se selecciona "Personalizado" para el parámetro "Período". Formato: ISO 8601
Hora de finalización String N/A No Especifica la hora de finalización de los resultados. Formato: ISO 8601. Si no se proporciona nada y se selecciona "Personalizado" para el parámetro "Período", este parámetro usará la hora actual.
Campos que se devolverán CSV N/A No Especifica qué campos se deben devolver. Si no se proporciona nada, la acción devolverá todos los campos.
Campo de orden String CreatedDate No Especifica qué parámetro se debe usar para la ordenación.
Orden de clasificación DDL

ASC

Valores posibles:

ASC

DESC

 No Especifica el orden de clasificación.
Cantidad máxima de resultados para devolver Número entero 50 No Especifica cuántos resultados se devolverán. El valor predeterminado es 50. El valor máximo es 200.

Ejecutar en

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
}
Muro de casos
Tipo de resultado Valor/Descripción Tipo (entidad\general)
Mensaje de salida*

La acción no debe fallar ni detener la ejecución de una guía:
Si se encontró al menos un resultado (is_success = true): "Se devolvieron correctamente los resultados de la búsqueda "{query}" en BMC Helix Remedyforce.

Si no se encontró nada(is_success=true): "No se encontraron resultados para la búsqueda "{query}" en BMC Helix Remedyforce"

La acción debe fallar y detener la ejecución de un playbook:
Si se produce un error fatal, como credenciales incorrectas, falta de conexión con el servidor o algún otro problema: "Error al ejecutar la acción "Ejecutar consulta simple". Reason: {0}''.format(error.Stacktrace)

 General
Muro de casos Nombre: Resultados General

Obtén detalles del registro

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 String N/A Sí Especifica el tipo de registro del que deseas recuperar los detalles. Si no sabes qué tipo de registros están disponibles, ejecuta la acción "List Record Types".
IDs de registros CSV N/A Sí Especifica los IDs de los registros para los que deseas devolver detalles.
Campos que se devolverán CSV N/A No Especifica qué campos se deben devolver. 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.

Ejecutar en

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
}
Muro de casos
Tipo de resultado Valor/Descripción Tipo (entidad\general)
Mensaje de salida*

La acción no debe fallar ni detener la ejecución de una guía:
Si hay datos disponibles para al menos un ID(is_success = true): "Se devolvieron correctamente los detalles sobre el tipo de registro {Record Type} para los siguientes IDs: {record ids}".

Si no hay datos disponibles para al menos un ID (is_success=true): "La acción no pudo encontrar detalles sobre el tipo de registro {Record Type} para los siguientes IDs: {record ids}".

Si los datos no están disponibles para todos (is_success=false): No se encontraron registros.

La acción debe fallar y detener la ejecución de un playbook:
si se produce un error irrecuperable, como credenciales incorrectas, falta de conexión con el servidor, etc.: "Error al ejecutar la acción "Get Record Details". Reason: {0}''.format(error.Stacktrace)

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

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

 General
Tabla del muro de casos

Nombre: Detalles del registro {record Id}

Columnas:

Clave

Valor

 General

Obtén el código de autorización de OAuth

Descripción

Genera un código de autorización de 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 redireccionamiento String https://localhost Sí Especifica la URL de redireccionamiento que se usó cuando se creó la "app del conector".

Ejecutar en

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
Muro de casos
Tipo de resultado Valor/Descripción Tipo (entidad\general)
Mensaje de salida*

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

"Se generó 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".

 General
Vínculo

Nombre: Vínculo del código de autorización
URL: {vínculo generado}

Obtén el token de actualización de OAuth

Descripción

Genera el token de actualización necesario para la configuración de la integración. El código de autorización se puede generar con "Get OAuth Authorization Code". 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 redireccionamiento String https://localhost Sí Especifica la URL de redireccionamiento que se usó cuando se creó la "app del conector".
Código de autorización String N/A Sí Especifica el código de autorización de la acción "Obtener código de autorización de OAuth".

Ejecutar en

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"
}
Muro de casos
Tipo de resultado Valor/Descripción Tipo (entidad\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 debe fallar y detener la ejecución de un playbook:
Si se produce un error fatal, como credenciales incorrectas, falta de conexión con el servidor o algún otro problema: "Error al ejecutar la acción "Obtener token de actualización de OAuth". Reason: {0}''.format(error.Stacktrace)

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

 General

Enumera los tipos de registros

Descripción

Enumera los tipos de registros disponibles en 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 qué lógica de filtro se debe aplicar.
Valor del filtro String N/A No Especifica qué valor se debe usar en el filtro. Si se selecciona "Igual a", la acción intentará encontrar la coincidencia exacta entre los tipos de registros. Si se selecciona "Contiene", la acción intentará encontrar los tipos de registros que contengan esa subcadena. Si no se proporciona nada en este parámetro, no se aplicará el filtro.
Cantidad máxima de tipos de registros que se pueden devolver Número entero 50 No Especifica cuántos tipos de registros se devolverán.

Ejecutar en

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
Muro de casos
Tipo de resultado Valor/Descripción Tipo (entidad\general)
Mensaje de salida*

La acción no debe fallar ni detener la ejecución de un playbook:
Si se encontró al menos uno (is_success = true): "Se enumeraron correctamente los tipos de registros disponibles según los criterios proporcionados en BMC Helix Remedyforce.

Si no se encontró nada(is_success=true): "No se encontraron tipos de registros según los criterios proporcionados en BMC Helix Remedyforce".

La acción debe fallar y detener la ejecución de un playbook:
Si se produce un error fatal, como credenciales incorrectas, falta de conexión con el servidor o algún otro problema:"Error al ejecutar la acción "List Record Types". Reason: {0}''.format(error.Stacktrace)

 General
Muro de casos

Nombre: Tipos de registros 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 en la pestaña Google Security Operations Marketplace.

Ejecutar en

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
Muro de casos
Tipo de resultado Valor/Descripción Tipo (entidad\general)
Mensaje de salida*

La acción no debe fallar ni detener la ejecución de un playbook:
Si se ejecuta correctamente: "Se conectó correctamente al servidor de BMC Helix Remedyforce con los parámetros de conexión proporcionados".

La acción debe fallar y detener la ejecución de la guía:
Si no se realiza correctamente: "No se pudo conectar con el servidor de BMC Helix Remedyforce. Error is {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 String N/A Sí Especifica el tipo de registro que se debe actualizar. Si no sabes qué tipo de registros están disponibles, ejecuta la acción "List Record Types".
ID de registro String N/A Sí Especifica el ID del registro que se debe actualizar.
Campos que se actualizarán JSON

{

"field":"value"

}

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

Ejecutar en

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
Muro de casos
Tipo de resultado Valor/Descripción Tipo (entidad\general)
Mensaje de salida*

La acción no debe fallar ni detener la ejecución de un playbook:
if 204 (is_success = true): "Se actualizó correctamente el registro {record type} con el ID {record id} en BMC Helix Remedyforce".

La acción debe fallar y detener la ejecución de un playbook:
si se produce un error no recuperable, como credenciales incorrectas, falta de conexión con el servidor, etc.: "Error al ejecutar la acción "Actualizar registro". Reason: {0}''.format(error.Stacktrace)

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

Si no se encontró el tipo de registro: Se produjo un error al ejecutar la acción "Update Record". Motivo: No se encontró {Record Type} en BMC Helix Remedyforce. Usa la acción "List Record Types" para obtener una lista de los tipos de registros disponibles.

Si la carga útil de JSON no es válida: "Error al ejecutar la acción "Actualizar registro". Motivo: Se proporcionó una carga útil de JSON no válida en el parámetro "Fields To Update". Verifica la estructura.

 General

Wait For Fields Update

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 String N/A Sí Especifica el tipo de registro para el que esperas una actualización. Si no sabes qué tipo de registros están disponibles, ejecuta la acción "List Record Types".
ID de registro String N/A Sí Especifica el ID del registro que se debe actualizar.
Campos para verificar 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 de verificación Marcado Sí Si se habilita, la acción fallará si no se actualizaron todos los campos.

Ejecutar en

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
}
Muro de casos
Tipo de resultado Valor/Descripción Tipo (entidad\general)
Mensaje de salida*

La acción no debe fallar ni detener la ejecución de un playbook:
if 201 (is_success = true): "Se actualizó el registro {tipo de registro} con el ID {ID de registro} en BMC Helix Remedyforce".

Si uno de los campos no se actualizó y la opción Fail if timeout no está habilitada (is_success=false): "Los siguientes campos no se actualizaron para el registro {record type} con el ID {record id} en BMC Helix Remedyforce: {campos que no se actualizaron}"

Mensaje asíncrono: Se espera que se actualicen los siguientes campos del registro {record type} con el ID {record id} en BMC Helix Remedyforce: {campos que no se actualizaron}

La acción debe fallar y detener la ejecución de un playbook:
Si hay un error fatal, como credenciales incorrectas, falta de conexión con el servidor o algún otro problema: "Error al ejecutar la acción "Wait For Fields Update". Reason: {0}''.format(error.Stacktrace)

Si no se encontraron algunos campos: "Error executing action "Wait For Fields Update". Motivo: No se encontraron los siguientes campos en la estructura del registro: {campos que no se encontraron}.

Si no se encontró el tipo de registro: Se produjo un error al ejecutar la acción "Wait For Fields Update". Motivo: No se encontró {Record Type} en BMC Helix Remedyforce. Usa la acción "List Record Types" para obtener una lista de los tipos de registros disponibles.

Si no se actualizó uno de los campos y la opción Fail if timeout está habilitada (is_success=false): "Error al ejecutar la acción "Wait For Fields Update". Motivo: No se actualizaron los siguientes campos para el registro {tipo de registro} con el ID {ID de registro} en BMC Helix Remedyforce: {campos que no se actualizaron}"

Si la carga útil de JSON no es válida: "Error al ejecutar la acción "Wait For Fields Update". Motivo: Se proporcionó una carga útil de JSON no válida en el parámetro "Campos para verificar". Verifica la estructura.

 General

Conector

BMC Helix Remedyforce: conector de incidentes

Descripción

Extrae información sobre incidentes de BMC Helix Remedyforce.

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

Si quieres obtener instrucciones detalladas para configurar un conector en Google SecOps, consulta Cómo configurar el conector.

Parámetros del conector

Usa los siguientes parámetros para configurar el conector:

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

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

Si no se encuentra el campo del entorno, se usa el entorno predeterminado.
Patrón de expresión regular del entorno String .* No

Es un patrón de regex que se ejecutará en el valor que se encuentra en el campo "Nombre del campo del entorno".

El valor predeterminado es .* para capturar todo y devolver el valor sin cambios.

Se usa para permitir que el usuario manipule el campo del entorno a través de la lógica de regex.

Si el patrón de regex es nulo o está vacío, o si el valor del entorno es nulo, el resultado final del entorno es el entorno predeterminado.
Tiempo de espera de la secuencia de comandos (segundos) Número entero 180 Sí Es el límite de tiempo de espera para el proceso de Python que ejecuta la secuencia de comandos actual.
Raíz de la API String https://.my.salesforce.com Sí Es la raíz de la API de la instancia de BMC Helix Remedyforce.
Nombre de usuario String 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 recuperar Número entero 5 No Es la prioridad más baja que se usará para recuperar incidentes. Máximo: 5 El mínimo es 1. Si no se proporciona nada, el conector transferirá todos los incidentes.
Transfiere incidentes vacíos de prioridad Casilla de verificación Marcado No Si está habilitado, el conector recuperará los incidentes que no tengan prioridad. Las alertas de SecOps de Google creadas de esta manera tendrán la prioridad establecida en "Informativa".
Tipo de filtro CSV Incidente,solicitud de servicio No Es el tipo de filtro para los incidentes. Si no se proporciona nada, el conector transferirá todos los incidentes. Ejemplo: Incidente, solicitud de servicio.
Horas máximas hacia atrás Número entero 1 No Cantidad de horas desde las que se recuperan los incidentes.
Cantidad máxima de incidentes para recuperar Número entero 10 No Cantidad de incidentes que se procesarán por iteración del conector. El valor máximo es 200.
Usar la lista blanca como lista negra Casilla de verificación Marcado Sí Si se habilita, la lista de entidades permitidas se usará como lista de entidades bloqueadas.
Verificar SSL Casilla de verificación Marcado Sí Si está habilitado, verifica que el certificado SSL para la conexión al servidor de BMC Helix Remedyforce sea válido.
Dirección del servidor proxy String N/A No Es la dirección del servidor proxy que se usará.
Nombre de usuario del proxy String N/A No Nombre de usuario del proxy con el que se realizará la autenticación.
Contraseña de proxy Contraseña N/A No Contraseña del proxy para la autenticación.
ID de cliente String N/A No Es el ID de cliente de BMC Helix Remedyforce de la app 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 del cliente Contraseña N/A No Es el secreto del cliente de BMC Helix Remedyforce de la app 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 acceso String https://login.salesforce.com Sí Es la raíz de la API que se usa para la autenticación en BMC Helix Remedyforce.

Reglas del conector

Compatibilidad con proxy

El conector admite proxy.

¿Necesitas más ayuda? Obtén respuestas de miembros de la comunidad y profesionales de Google SecOps.