BMC Helix Remedyforce

Version de l'intégration : 11.0

Cas d'utilisation

  1. Ingérer les incidents
  2. Effectuer une action de triage (mettre à jour/créer/supprimer des enregistrements)

Configurer l'authentification OAuth

Il arrive que la méthode d'authentification de base utilisant un nom d'utilisateur et un mot de passe ne fonctionne pas. Cela peut se produire lorsque MFA est activée pour le compte. Dans ce cas, vous devez configurer l'authentification OAuth.

Étapes :

  1. Accédez à Configuration > Gestionnaire d'applications.
  2. Appuyez sur le bouton "New Connected App" (Nouvelle application connectée).
  3. Indiquez le nom de l'application connectée, le nom de l'API et l'adresse e-mail du contact.
  4. "Enable OAuth Settings" (Activer les paramètres OAuth) doit être défini sur "true".
  5. Définissez "URL de rappel" sur "https://localhost".
  6. Ajoutez les niveaux d'accès full et refresh_token. Les deux sont nécessaires pour accéder à l'API.
  7. Enregistrez l'application.
  8. Ouvrez la configuration de l'application, puis copiez la clé client et le code secret client. Dans la configuration de l'intégration, "Clé client" correspond à "ID client" et "Code secret client" correspond à "Code secret".
  9. Accédez à l'action "Obtenir le code d'autorisation OAuth". "URL de redirection" devient "URL de rappel".
  10. Exécutez l'action. L'URL d'autorisation figure dans le résultat JSON. Vous devez le copier et le coller dans votre navigateur. Vous serez redirigé et votre URL ressemblera à ceci : "https://localhost/?code=aPrxyeILZDvX2Hhmz2gymvtuE4aow6hMnAKw_98FyXJvaN7l69bJZFr1z.ylZ3qXd0KZlXjn0g%3D%3D". Vous devez copier tout ce qui se trouve après "code=" et veiller à décoder l'URL. %3D est un caractère "=".
  11. Accédez à l'action "Get OAuth Refresh Token" (Obtenir un jeton d'actualisation OAuth). "URL de redirection" correspond à "URL de rappel" et "Code d'autorisation" correspond au "code" de la requête précédente.
  12. Si tout a été fait correctement, vous verrez "refresh_token" dans le résultat JSON.
  13. Copiez ce jeton d'actualisation dans la configuration de l'intégration et effectuez un test.

Configurer l'intégration de BMC Helix Remedyforce dans Google Security Operations

Pour obtenir des instructions détaillées sur la configuration d'une intégration dans Google SecOps, consultez Configurer des intégrations.

Paramètres d'intégration

Utilisez les paramètres suivants pour configurer l'intégration :

Nom à afficher du paramètre Type Valeur par défaut Obligatoire Description
Racine de l'API Chaîne https://.my.salesforce.com Oui Racine de l'API de l'instance BMC Helix Remedyforce.
Nom d'utilisateur Chaîne N/A Non Nom d'utilisateur BMC Helix Remedyforce.
Mot de passe Mot de passe N/A Non Mot de passe BMC Helix Remedyforce.
ID client Chaîne N/A Non ID client BMC Helix Remedyforce de l'application connectée. Ce paramètre est nécessaire pour l'authentification OAuth. Remarque : Ce paramètre est prioritaire sur l'authentification par nom d'utilisateur et mot de passe.
Code secret du client Mot de passe N/A Non Code secret du client BMC Helix Remedyforce de l'application connectée. Ce paramètre est nécessaire pour l'authentification OAuth. Remarque : Ce paramètre est prioritaire sur l'authentification par nom d'utilisateur et mot de passe.
Jeton d'actualisation Mot de passe N/A Non Jeton d'actualisation pour l'autorisation OAuth.
Vérifier le protocole SSL Case à cocher Cochée Oui Si cette option est activée, elle vérifie que le certificat SSL pour la connexion au serveur BMC Helix Remedyforce est valide.
Racine de l'API de connexion Chaîne https://login.salesforce.com Oui Racine de l'API utilisée pour l'authentification dans BMC Helix Remedyforce.

Actions

Create Record

Description

Créez un enregistrement dans BMC Helix Remedyforce.

Paramètres

Nom à afficher du paramètre Type Valeur par défaut Obligatoire Description
Type d'enregistrement Chaîne N/A Oui Spécifiez le type d'enregistrement à créer. Si vous ne savez pas quels types d'enregistrements sont disponibles, veuillez exécuter l'action "List Record Types" (Lister les types d'enregistrements).
Charge utile d'enregistrement JSON

{

"field":"value"

}

 Oui Spécifiez un objet JSON contenant tous les champs et valeurs nécessaires.

Exécuter sur

L'action ne s'exécute pas sur les entités et ne comporte pas de paramètres d'entrée obligatoires.

Résultats de l'action

Résultat du script
Nom du résultat du script Options de valeur
is_success is_success=False
is_success is_success=True
Résultat JSON
{
    "id": "0015e000005dVbKAAU",
    "success": true,
    "errors": []
}
Mur des cas
Type de résultat Valeur/Description Type (entité \ général)
Message de sortie*

L'action ne doit pas échouer ni arrêter l'exécution d'un playbook :
if 201 (is_success = true): "Successfully created {record type} record in BMC Helix Remedyforce.".

L'action doit échouer et arrêter l'exécution d'un playbook :
en cas d'erreur fatale, comme des identifiants incorrects, l'absence de connexion au serveur, etc. : "Erreur lors de l'exécution de l'action "Créer un enregistrement". Raison : {0}''.format(error.Stacktrace)

Si le code d'erreur est 400 : "Erreur lors de l'exécution de l'action "Créer un enregistrement". Motif : {message}.

Si le type d'enregistrement n'a pas été trouvé : erreur lors de l'exécution de l'action "Créer un enregistrement". Motif : {Record Type} n'a pas été trouvé dans BMC Helix Remedyforce. Veuillez utiliser l'action "Lister les types d'enregistrements" pour obtenir la liste des types d'enregistrements disponibles.

Si la charge utile JSON n'est pas valide : "Erreur lors de l'exécution de l'action "Créer un enregistrement". Motif : Charge utile JSON non valide fournie dans le paramètre "Record Payload" (Enregistrer la charge utile). Veuillez vérifier la structure.

 Général

Supprimer l'enregistrement

Description

Supprimez un enregistrement dans BMC Helix Remedyforce.

Paramètres

Nom à afficher du paramètre Type Valeur par défaut Obligatoire Description
Type d'enregistrement Chaîne N/A Oui Spécifiez le type d'enregistrement à supprimer. Si vous ne savez pas quels types d'enregistrements sont disponibles, veuillez exécuter l'action "List Record Types" (Lister les types d'enregistrements).
ID d'enregistrement Chaîne N/A Oui Spécifiez l'ID de l'enregistrement à supprimer.

Exécuter sur

L'action ne s'exécute pas sur les entités et ne comporte pas de paramètres d'entrée obligatoires.

Résultats de l'action

Résultat du script
Nom du résultat du script Options de valeur
is_success is_success=False
is_success is_success=True
Mur des cas
Type de résultat Valeur/Description Type (entité \ général)
Message de sortie*

L'action ne doit pas échouer ni arrêter l'exécution d'un playbook :
si 204 (is_success = true) : "L'enregistrement {Record Type} avec l'ID {record id} a bien été supprimé dans BMC Helix Remedyforce.

Si le code d'état est 404 (is_success=true) : "L'enregistrement {Record Type} avec l'ID {record id} n'existe pas dans BMC Helix Remedyforce.

L'action doit échouer et arrêter l'exécution d'un playbook :

Si une erreur fatale se produit (par exemple, des identifiants incorrects, une absence de connexion au serveur ou autre) : "Erreur lors de l'exécution de l'action "Supprimer l'enregistrement". Raison : {0}''.format(error.Stacktrace)

Si le type d'enregistrement n'a pas été trouvé : erreur lors de l'exécution de l'action "Supprimer l'enregistrement". Motif : {Record Type} n'a pas été trouvé dans BMC Helix Remedyforce. Veuillez utiliser l'action "Lister les types d'enregistrements" pour obtenir la liste des types d'enregistrements disponibles.

 Général

Exécuter une requête personnalisée

Description

Exécutez une requête SOQL personnalisée dans BMC Helix Remedyforce.

Paramètres

Nom à afficher du paramètre Type Valeur par défaut Obligatoire Description
Requête SOQL Chaîne N/A Oui Spécifiez la requête à exécuter.

Exécuter sur

L'action ne s'exécute pas sur les entités et ne comporte pas de paramètres d'entrée obligatoires.

Résultats de l'action

Résultat du script
Nom du résultat du script Options de valeur
is_success is_success=False
is_success is_success=True
Résultat 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
}
Mur des cas
Type de résultat Valeur/Description Type (entité \ général)
Message de sortie*

L'action ne doit pas échouer ni arrêter l'exécution d'un playbook :
si au moins un résultat est trouvé (is_success = true) : "Les résultats de la requête "{query}" ont été renvoyés avec succès dans BMC Helix Remedyforce.

Si aucun résultat n'a été trouvé(is_success=true) : "Aucun résultat n'a été trouvé pour la requête "{query}" dans BMC Helix Remedyforce"

L'action doit échouer et arrêter l'exécution d'un playbook :
en cas d'erreur fatale, comme des identifiants incorrects, l'absence de connexion au serveur, etc. : "Erreur lors de l'exécution de l'action "Exécuter une requête personnalisée". Raison : {0}''.format(error.Stacktrace)

 Général
Mur des cas Nom : Résultats Général

Exécuter une requête simple

Description

Exécutez une requête SOQL basée sur les paramètres de BMC Helix Remedyforce.

Paramètres

Nom à afficher du paramètre Type Valeur par défaut Obligatoire Description
Type d'enregistrement Chaîne N/A Oui Spécifiez le type d'enregistrement à interroger.
Filtre "Où" Chaîne N/A Non Spécifiez le filtre WHERE pour la requête à exécuter. Remarque : Vous n'avez pas besoin de fournir de filtre temporel, de limite ni de tri. De plus, vous n'avez pas besoin de fournir la chaîne WHERE dans la charge utile.
Période LDD

La dernière heure

Valeurs possibles :

La dernière heure

Les 6 dernières heures

Dernières 24 heures

La semaine dernière

Le mois dernier

Personnalisé

 Non Spécifiez une période pour les résultats. Si vous sélectionnez "Personnalisé", vous devez également indiquer une heure de début.
Heure de début Chaîne N/A Non Spécifiez l'heure de début des résultats. Ce paramètre est obligatoire si l'option "Personnalisé" est sélectionnée pour le paramètre "Période". Format : ISO 8601
Heure de fin Chaîne N/A Non Spécifiez l'heure de fin des résultats. Format : ISO 8601. Si aucune valeur n'est fournie et que "Personnalisée" est sélectionné pour le paramètre "Période", ce paramètre utilisera l'heure actuelle.
Champs à renvoyer CSV N/A Non Spécifiez les champs à renvoyer. Si aucune valeur n'est fournie, l'action renvoie tous les champs.
Champ de tri Chaîne CreatedDate Non Spécifiez le paramètre à utiliser pour le tri.
Ordre de tri LDD

ASC

Valeurs possibles :

ASC

DESC

 Non Spécifiez l'ordre de tri.
Nombre maximal de résultats à renvoyer Integer 50 Non Spécifiez le nombre de résultats à renvoyer. Valeur par défaut : 50. Le maximum est de 200.

Exécuter sur

L'action ne s'exécute pas sur les entités et ne comporte pas de paramètres d'entrée obligatoires.

Résultats de l'action

Résultat du script
Nom du résultat du script Options de valeur
is_success is_success=False
is_success is_success=True
Résultat 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
}
Mur des cas
Type de résultat Valeur/Description Type (entité \ général)
Message de sortie*

L'action ne doit pas échouer ni arrêter l'exécution d'un playbook :
si au moins un résultat est trouvé (is_success = true) : "Les résultats de la requête "{query}" ont été renvoyés avec succès dans BMC Helix Remedyforce.

Si aucun résultat n'a été trouvé(is_success=true) : "Aucun résultat n'a été trouvé pour la requête "{query}" dans BMC Helix Remedyforce"

L'action doit échouer et arrêter l'exécution d'un playbook :
en cas d'erreur fatale, comme des identifiants incorrects, l'absence de connexion au serveur, etc. : "Erreur lors de l'exécution de l'action "Exécuter une requête simple". Raison : {0}''.format(error.Stacktrace)

 Général
Mur des cas Nom : Résultats Général

Obtenir les détails d'un enregistrement

Description

Obtenez des informations détaillées sur l'enregistrement à partir de BMC Helix Remedyforce.

Paramètres

Nom à afficher du paramètre Type Valeur par défaut Obligatoire Description
Type d'enregistrement Chaîne N/A Oui Spécifiez le type d'enregistrement dont vous souhaitez récupérer les détails. Si vous ne savez pas quels types d'enregistrements sont disponibles, veuillez exécuter l'action "List Record Types" (Lister les types d'enregistrements).
ID d'enregistrement CSV N/A Oui Spécifiez les ID des enregistrements pour lesquels vous souhaitez renvoyer des détails.
Champs à renvoyer CSV N/A Non Spécifiez les champs à renvoyer. Si aucun des champs fournis n'est trouvé, l'action échoue. Si rien n'est fourni, l'action renverra tous les champs.

Exécuter sur

L'action ne s'exécute pas sur les entités et ne comporte pas de paramètres d'entrée obligatoires.

Résultats de l'action

Résultat du script
Nom du résultat du script Options de valeur
is_success is_success=False
is_success is_success=True
Résultat 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
}
Mur des cas
Type de résultat Valeur/Description Type (entité \ général)
Message de sortie*

L'action ne doit pas échouer ni arrêter l'exécution d'un playbook :
si des données sont disponibles pour au moins un ID(is_success = true) : "Les détails concernant le type d'enregistrement {Record Type} ont été renvoyés avec succès pour les ID suivants : {record ids}".

Si les données ne sont pas disponibles pour au moins un ID (is_success=true) : "L'action n'a pas pu trouver d'informations sur le type d'enregistrement {Record Type} pour les ID suivants : {record ids}".

Si les données ne sont pas disponibles pour tous (is_success=false) : aucun enregistrement n'a été trouvé.

L'action doit échouer et arrêter l'exécution d'un playbook :
en cas d'erreur fatale, comme des identifiants incorrects, une absence de connexion au serveur, etc. : "Erreur lors de l'exécution de l'action "Obtenir les détails de l'enregistrement". Raison : {0}''.format(error.Stacktrace)

Si le type d'enregistrement n'a pas été trouvé : erreur lors de l'exécution de l'action "Obtenir les détails de l'enregistrement". Motif : {Record Type} n'a pas été trouvé dans BMC Helix Remedyforce. Veuillez utiliser l'action "Lister les types d'enregistrements" pour obtenir la liste des types d'enregistrements disponibles.

Si aucun des champs fournis dans "Champs à renvoyer" n'a été trouvé : "Erreur lors de l'exécution de l'action "Obtenir les détails de l'enregistrement". Motif : aucun des champs fournis n'a été trouvé. Veuillez vérifier l'orthographe.""

 Général
Tableau du mur des cas

Nom : détails de l'enregistrement {record Id}

Colonnes :

Clé

Valeur

 Général

Obtenir un code d'autorisation OAuth

Description

Générez un code d'autorisation OAuth dans BMC Helix Remedyforce. Pour en savoir plus, veuillez consulter le portail de documentation.

Paramètres

Nom à afficher du paramètre Type Valeur par défaut Obligatoire Description
URL de redirection Chaîne https://localhost Oui Spécifiez l'URL de redirection utilisée lors de la création de l'application de connecteur.

Exécuter sur

L'action ne s'exécute pas sur les entités et ne comporte pas de paramètres d'entrée obligatoires.

Résultats de l'action

Résultat du script
Nom du résultat du script Options de valeur
is_success is_success=False
is_success is_success=True
Mur des cas
Type de résultat Valeur/Description Type (entité \ général)
Message de sortie*

L'action ne doit pas échouer ni arrêter l'exécution d'un playbook :

"L'URL du code d'autorisation a bien été générée dans BMC Helix Remedyforce. Veuillez la copier et la coller dans le navigateur. Copiez ensuite la partie "code" de l'URL. Ce code d'autorisation est utilisé dans l'action "Obtenir le jeton d'actualisation OAuth".

 Général
Lien

Nom : lien vers le code d'autorisation
URL : {lien généré}

Obtenir un jeton d'actualisation OAuth

Description

Générez le jeton d'actualisation nécessaire à la configuration de l'intégration. Le code d'autorisation peut être généré à l'aide de l'option "Obtenir le code d'autorisation OAuth". Pour en savoir plus, veuillez consulter le portail de documentation.

Paramètres

Nom à afficher du paramètre Type Valeur par défaut Obligatoire Description
URL de redirection Chaîne https://localhost Oui Spécifiez l'URL de redirection utilisée lors de la création de l'application de connecteur.
Code d'autorisation Chaîne N/A Oui Spécifiez le code d'autorisation de l'action "Obtenir le code d'autorisation OAuth".

Exécuter sur

L'action ne s'exécute pas sur les entités et ne comporte pas de paramètres d'entrée obligatoires.

Résultats de l'action

Résultat du script
Nom du résultat du script Options de valeur
is_success is_success=False
is_success is_success=True
Résultat 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"
}
Mur des cas
Type de résultat Valeur/Description Type (entité \ général)
Message de sortie*

L'action ne doit pas échouer ni arrêter l'exécution d'un playbook :
if 200 (is_success = true) : "Successfully generated refresh token in BMC Helix Remedyforce.".

L'action doit échouer et arrêter l'exécution d'un playbook :
en cas d'erreur fatale, comme des identifiants incorrects, l'absence de connexion au serveur, etc. : "Erreur lors de l'exécution de l'action "Obtenir le jeton d'actualisation OAuth". Raison : {0}''.format(error.Stacktrace)

Si le code d'état n'est pas 200 : "Erreur lors de l'exécution de l'action "Obtenir le jeton d'actualisation OAuth". Motif : {0}''.format(error_description)

 Général

Lister les types d'enregistrements

Description

Répertorie les types d'enregistrements disponibles dans BMC Helix Remedyforce.

Paramètres

Nom à afficher du paramètre Type Valeur par défaut Obligatoire Description
Logique de filtrage LDD

Égal à

LDD

Égal à

Contient

 Non Spécifiez la logique de filtrage à appliquer.
Valeur du filtre Chaîne N/A Non Spécifiez la valeur à utiliser dans le filtre. Si l'option "Égal à" est sélectionnée, l'action tentera de trouver la correspondance exacte parmi les types d'enregistrements. Si l'option "Contient" est sélectionnée, l'action tentera de trouver les types d'enregistrements contenant cette sous-chaîne. Si rien n'est fourni dans ce paramètre, le filtre ne sera pas appliqué.
Nombre maximal de types d'enregistrements à renvoyer Integer 50 Non Spécifiez le nombre de types d'enregistrements à renvoyer.

Exécuter sur

L'action ne s'exécute pas sur les entités et ne comporte pas de paramètres d'entrée obligatoires.

Résultats de l'action

Résultat du script
Nom du résultat du script Options de valeur
is_success is_success=False
is_success is_success=True
Mur des cas
Type de résultat Valeur/Description Type (entité \ général)
Message de sortie*

L'action ne doit pas échouer ni arrêter l'exécution d'un playbook :
si au moins un type d'enregistrement disponible est trouvé (is_success = true) : "La liste des types d'enregistrement disponibles a été établie avec succès en fonction des critères fournis dans BMC Helix Remedyforce.

Si aucun résultat n'a été trouvé(is_success=true) : "Aucun type d'enregistrement n'a été trouvé en fonction des critères fournis dans BMC Helix Remedyforce"

L'action doit échouer et arrêter l'exécution d'un playbook :
en cas d'erreur fatale, comme des identifiants incorrects, une absence de connexion au serveur, etc. : "Erreur lors de l'exécution de l'action "Lister les types d'enregistrements". Raison : {0}''.format(error.Stacktrace)

 Général
Mur des cas

Nom : types d'enregistrements disponibles

Colonnes :

Nom

Libellé

Personnalisé

Général

Ping

Description

Testez la connectivité à BMC Helix Remedyforce avec les paramètres fournis sur la page de configuration de l'intégration dans l'onglet Google Security Operations Marketplace.

Exécuter sur

Cette action ne s'applique pas aux entités.

Résultats de l'action

Résultat du script
Nom du résultat du script Options de valeur
is_success is_success=False
is_success is_success=True
Mur des cas
Type de résultat Valeur/Description Type (entité \ général)
Message de sortie*

L'action ne doit pas échouer ni arrêter l'exécution d'un playbook :
en cas de succès : "Connexion au serveur BMC Helix Remedyforce établie avec succès avec les paramètres de connexion fournis !"

L'action doit échouer et arrêter l'exécution d'un playbook :
if not successful : "Failed to connect to the BMC Helix Remedyforce server! Error is {0}".format(exception.stacktrace)

 Général

Mettre à jour l'enregistrement

Description

Mettez à jour l'enregistrement dans BMC Helix Remedyforce.

Paramètres

Nom à afficher du paramètre Type Valeur par défaut Obligatoire Description
Type d'enregistrement Chaîne N/A Oui Spécifiez le type d'enregistrement à mettre à jour. Si vous ne savez pas quels types d'enregistrements sont disponibles, veuillez exécuter l'action "List Record Types" (Lister les types d'enregistrements).
ID d'enregistrement Chaîne N/A Oui Spécifiez l'ID de l'enregistrement à mettre à jour.
Champs à mettre à jour JSON

{

"field":"value"

}

 Oui Spécifiez un objet JSON contenant tous les champs et valeurs à mettre à jour.

Exécuter sur

L'action ne s'exécute pas sur les entités et ne comporte pas de paramètres d'entrée obligatoires.

Résultats de l'action

Résultat du script
Nom du résultat du script Options de valeur
is_success is_success=False
is_success is_success=True
Mur des cas
Type de résultat Valeur/Description Type (entité \ général)
Message de sortie*

L'action ne doit pas échouer ni arrêter l'exécution d'un playbook :
if 204 (is_success = true): "Successfully updated {record type} record with {record id} in BMC Helix Remedyforce.".

L'action doit échouer et arrêter l'exécution d'un playbook :
en cas d'erreur fatale, comme des identifiants incorrects, l'absence de connexion au serveur, etc. : "Erreur lors de l'exécution de l'action "Mettre à jour l'enregistrement". Raison : {0}''.format(error.Stacktrace)

Si le code d'erreur est 404 ou 400 : "Erreur lors de l'exécution de l'action "Mettre à jour l'enregistrement". Motif : {message}.

Si le type d'enregistrement n'a pas été trouvé : erreur lors de l'exécution de l'action "Mettre à jour l'enregistrement". Motif : {Record Type} n'a pas été trouvé dans BMC Helix Remedyforce. Veuillez utiliser l'action "Lister les types d'enregistrements" pour obtenir la liste des types d'enregistrements disponibles.

Si la charge utile JSON n'est pas valide : "Error executing action "Update Record". Motif : Charge utile JSON non valide fournie dans le paramètre "Champs à mettre à jour". Veuillez vérifier la structure.

 Général

Attendre la mise à jour des champs

Description

Attendez que les champs soient mis à jour dans BMC Helix Remedyforce.

Paramètres

Nom à afficher du paramètre Type Valeur par défaut Obligatoire Description
Type d'enregistrement Chaîne N/A Oui Spécifiez le type d'enregistrement pour lequel vous attendez une mise à jour. Si vous ne savez pas quels types d'enregistrements sont disponibles, veuillez exécuter l'action "List Record Types" (Lister les types d'enregistrements).
ID d'enregistrement Chaîne N/A Oui Spécifiez l'ID de l'enregistrement à mettre à jour.
Champs à vérifier JSON

{

"field":"value"

}

 Oui Spécifiez un objet JSON contenant tous les champs et valeurs nécessaires.
Échec en cas de délai avant expiration Case à cocher Cochée Oui Si cette option est activée, l'action échouera si tous les champs n'ont pas été mis à jour.

Exécuter sur

L'action ne s'exécute pas sur les entités et ne comporte pas de paramètres d'entrée obligatoires.

Résultats de l'action

Résultat du script
Nom du résultat du script Options de valeur
is_success is_success=False
is_success is_success=True
Résultat 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
}
Mur des cas
Type de résultat Valeur/Description Type (entité \ général)
Message de sortie*

L'action ne doit pas échouer ni arrêter l'exécution d'un playbook :
if 201 (is_success = true): "{record type} record with ID {record id} was updated in BMC Helix Remedyforce.".

Si l'un des champs n'a pas été mis à jour et que l'option "Échec si le délai est dépassé" n'est pas activée (is_success=false) : "Les champs suivants n'ont pas été mis à jour pour l'enregistrement {record type} avec l'ID {record id} dans BMC Helix Remedyforce : {fields that were not updated}"

Message asynchrone : nous attendons la mise à jour des champs suivants pour l'enregistrement {record type} avec l'ID {record id} dans BMC Helix Remedyforce : {fields that were not updated}

L'action doit échouer et arrêter l'exécution d'un playbook :
en cas d'erreur fatale, comme des identifiants incorrects, une absence de connexion au serveur, etc. : "Erreur lors de l'exécution de l'action "Wait For Fields Update". Raison : {0}''.format(error.Stacktrace)

Si certains champs sont introuvables : "Erreur lors de l'exécution de l'action "Attendre la mise à jour des champs". Motif : les champs suivants sont introuvables dans la structure de l'enregistrement : {fields that were not found}.

Si le type d'enregistrement n'a pas été trouvé : erreur lors de l'exécution de l'action "Attendre la mise à jour des champs". Motif : {Record Type} n'a pas été trouvé dans BMC Helix Remedyforce. Veuillez utiliser l'action "Lister les types d'enregistrements" pour obtenir la liste des types d'enregistrements disponibles.

Si l'un des champs n'a pas été mis à jour et que l'option "Échec si délai dépassé" est activée (is_success=false) : "Erreur lors de l'exécution de l'action "Attendre la mise à jour des champs". Raison : Les champs suivants n'ont pas été mis à jour pour l'enregistrement {record type} avec l'ID {record id} dans BMC Helix Remedyforce : {fields that were not updated}"

Si la charge utile JSON n'est pas valide : "Erreur lors de l'exécution de l'action "Attendre la mise à jour des champs". Motif : Charge utile JSON non valide fournie dans le paramètre "Champs à vérifier". Veuillez vérifier la structure.

 Général

Connecteur

BMC Helix Remedyforce - Incidents Connector

Description

Extrayez des informations sur les incidents à partir de BMC Helix Remedyforce.

Configurer le connecteur BMC Helix Remedyforce - Incidents dans Google SecOps

Pour obtenir des instructions détaillées sur la configuration d'un connecteur dans Google SecOps, consultez Configurer le connecteur.

Paramètres du connecteur

Utilisez les paramètres suivants pour configurer le connecteur :

Nom à afficher du paramètre Type Valeur par défaut Obligatoire Description
Nom du champ de produit Chaîne Nom du produit Oui Saisissez le nom du champ source pour récupérer le nom du champ produit.
Nom du champ d'événement Chaîne BMCServiceDesk__Type__c Oui Saisissez le nom du champ source pour récupérer le nom du champ d'événement.
Nom du champ "Environnement" Chaîne "" Non

Décrit le nom du champ dans lequel le nom de l'environnement est stocké.

Si le champ "environment" (environnement) est introuvable, l'environnement est celui par défaut.
Modèle d'expression régulière de l'environnement Chaîne .* Non

Expression régulière à exécuter sur la valeur trouvée dans le champ "Nom du champ d'environnement".

La valeur par défaut est ".*" pour tout capturer et renvoyer la valeur inchangée.

Permet à l'utilisateur de manipuler le champ "environnement" à l'aide de la logique des expressions régulières.

Si le modèle d'expression régulière est nul ou vide, ou si la valeur d'environnement est nulle, l'environnement par défaut est utilisé comme résultat final.
Délai avant expiration du script (en secondes) Integer 180 Oui Délai avant expiration du processus Python exécutant le script actuel.
Racine de l'API Chaîne https://.my.salesforce.com Oui Racine de l'API de l'instance BMC Helix Remedyforce.
Nom d'utilisateur Chaîne N/A Oui Nom d'utilisateur BMC Helix Remedyforce.
Mot de passe Mot de passe N/A Oui Mot de passe BMC Helix Remedyforce.
Priorité de récupération la plus basse Integer 5 Non Priorité la plus faible qui sera utilisée pour récupérer les incidents. Maximum : 5. Minimum : 1. Si vous ne fournissez aucune valeur, le connecteur ingérera tous les incidents.
Ingérer les incidents de priorité vide Case à cocher Cochée Non Si cette option est activée, le connecteur récupère les incidents sans priorité. Les alertes Google SecOps créées de cette manière auront la priorité définie sur "Informationnel".
Filtre par type CSV Incident,Demande de service Non Filtre de type pour les incidents. Si vous ne fournissez aucune valeur, le connecteur ingérera tous les incidents. Exemple : "Incident", "Demande de service".
Nombre maximal d'heures en arrière Integer 1 Non Nombre d'heures à partir desquelles récupérer les incidents.
Nombre maximal d'incidents à extraire Integer 10 Non Nombre d'incidents à traiter par itération de connecteur. Le maximum est de 200.
Utiliser la liste blanche comme liste noire Case à cocher Cochée Oui Si cette option est activée, la liste blanche sera utilisée comme liste noire.
Vérifier le protocole SSL Case à cocher Cochée Oui Si cette option est activée, vérifiez que le certificat SSL pour la connexion au serveur BMC Helix Remedyforce est valide.
Adresse du serveur proxy Chaîne N/A Non Adresse du serveur proxy à utiliser.
Nom d'utilisateur du proxy Chaîne N/A Non Nom d'utilisateur du proxy pour l'authentification.
Mot de passe du proxy Mot de passe N/A Non Mot de passe du proxy pour l'authentification.
ID client Chaîne N/A Non ID client BMC Helix Remedyforce de l'application connectée. Ce paramètre est nécessaire pour l'authentification OAuth. Remarque : Ce paramètre est prioritaire sur l'authentification par nom d'utilisateur et mot de passe.
Code secret du client Mot de passe N/A Non Code secret du client BMC Helix Remedyforce de l'application connectée. Ce paramètre est nécessaire pour l'authentification OAuth. Remarque : Ce paramètre est prioritaire sur l'authentification par nom d'utilisateur et mot de passe.
Racine de l'API de connexion Chaîne https://login.salesforce.com Oui Racine de l'API utilisée pour l'authentification dans BMC Helix Remedyforce.

Règles du connecteur

Assistance de proxy

Le connecteur est compatible avec le proxy.

Vous avez encore besoin d'aide ? Obtenez des réponses de membres de la communauté et de professionnels Google SecOps.