BMC Helix Remedyforce

Integrationsversion: 11.0

Anwendungsbereiche

  1. Vorgänge für die Aufnahme von Vorfällen ausführen
  2. Triage-Aktion ausführen (Datensätze aktualisieren/erstellen/löschen)

OAuth-Authentifizierung konfigurieren

Manchmal funktioniert die Basisauthentifizierung mit Nutzername und Passwort nicht. Das kann passieren, wenn die MFA für das Konto aktiviert ist. In diesen Fällen müssen Sie die OAuth-Authentifizierung konfigurieren.

Schritte:

  1. Gehen Sie zu „Einrichtung“ -> „App-Manager“.
  2. Klicken Sie auf die Schaltfläche „Neue verbundene App“.
  3. Geben Sie „Name der verbundenen App“, „API-Name“ und „E‑Mail-Adresse für Kontakt“ an.
  4. „OAuth-Einstellungen aktivieren“ muss auf „true“ gesetzt sein.
  5. Legen Sie „Callback-URL“ auf „https://localhost“ fest.
  6. Fügen Sie die Bereiche full und refresh_token hinzu. Beide sind für den Zugriff auf die API erforderlich.
  7. Speichern Sie die Anwendung.
  8. Öffnen Sie die App-Konfiguration und kopieren Sie „Consumer Key“ und „Consumer Secret“. „Consumer-Key“ entspricht „Client-ID“ und „Consumer-Secret“ entspricht „Clientschlüssel“ in der Integrationskonfiguration.
  9. Rufen Sie die Aktion „OAuth-Autorisierungscode abrufen“ auf. „Weiterleitungs-URL“ ist „Callback-URL“.
  10. Führen Sie die Aktion aus. Im JSON-Ergebnis finden Sie eine Autorisierungs-URL. Sie müssen ihn kopieren und in Ihren Browser einfügen. Am Ende werden Sie weitergeleitet und Ihre URL sieht so aus: https://localhost/?code=aPrxyeILZDvX2Hhmz2gymvtuE4aow6hMnAKw_98FyXJvaN7l69bJZFr1z.ylZ3qXd0KZlXjn0g%3D%3D. Kopieren Sie alles nach „code=“ und führen Sie eine URL-Decodierung durch. %3D ist das Gleichheitszeichen (=).
  11. Rufen Sie die Aktion „OAuth-Aktualisierungstoken abrufen“ auf. „Weiterleitungs-URL“ ist „Callback-URL“ und „Autorisierungscode“ ist der „Code“ aus der vorherigen Anfrage.
  12. Wenn alles richtig gemacht wurde, sehen Sie im JSON-Ergebnis „refresh_token“.
  13. Kopieren Sie dieses Aktualisierungstoken in die Integrationskonfiguration und führen Sie einen Testlauf durch.

BMC Helix Remedyforce-Integration in Google Security Operations konfigurieren

Eine detaillierte Anleitung zum Konfigurieren einer Integration in Google SecOps finden Sie unter Integrationen konfigurieren.

Integrationsparameter

Verwenden Sie die folgenden Parameter, um die Integration zu konfigurieren:

Anzeigename des Parameters Typ Standardwert Ist obligatorisch Beschreibung
API-Stamm String https://.my.salesforce.com Ja API-Stamm der BMC Helix Remedyforce-Instanz.
Nutzername String – Nein BMC Helix Remedyforce-Nutzername.
Passwort Passwort – Nein BMC Helix Remedyforce-Passwort.
Client-ID String – Nein Die BMC Helix Remedyforce-Client-ID der verbundenen App. Dieser Parameter ist für die OAuth-Authentifizierung erforderlich. Hinweis: Dieser Parameter hat Vorrang vor der Authentifizierung mit Nutzername und Passwort.
Clientschlüssel Passwort – Nein BMC Helix Remedyforce-Client-Secret der verbundenen App. Dieser Parameter ist für die OAuth-Authentifizierung erforderlich. Hinweis: Dieser Parameter hat Vorrang vor der Authentifizierung mit Nutzername und Passwort.
Aktualisierungstoken Passwort – Nein Aktualisierungstoken für die OAuth-Autorisierung.
SSL überprüfen Kästchen Aktiviert Ja Wenn diese Option aktiviert ist, wird geprüft, ob das SSL-Zertifikat für die Verbindung zum BMC Helix Remedyforce-Server gültig ist.
Login API Root String https://login.salesforce.com Ja API-Stamm, der zur Authentifizierung in BMC Helix Remedyforce verwendet wird.

Aktionen

Create Record

Beschreibung

Erstellen Sie einen Datensatz in BMC Helix Remedyforce.

Parameter

Anzeigename des Parameters Typ Standardwert Ist obligatorisch Beschreibung
Eintragtyp String – Ja Geben Sie den Typ des Datensatzes an, der erstellt werden muss. Wenn Sie nicht wissen, welche Arten von Einträgen verfügbar sind, führen Sie die Aktion „List Record Types“ aus.
Datensatznutzlast JSON

{

„field“:“value“

}

 Ja Geben Sie ein JSON-Objekt mit allen erforderlichen Feldern und Werten an.

Ausführen am

Die Aktion wird nicht für Entitäten ausgeführt und hat keine erforderlichen Eingabeparameter.

Aktionsergebnisse

Scriptergebnis
Name des Scriptergebnisses Wertoptionen
is_success is_success=False
is_success is_success=True
JSON-Ergebnis
{
    "id": "0015e000005dVbKAAU",
    "success": true,
    "errors": []
}
Fall-Repository
Ergebnistyp Wert/Beschreibung Typ (Entität \ Allgemein)
Ausgabemeldung*

Die Aktion darf nicht fehlschlagen oder die Ausführung eines Playbooks beenden:
if 201 (is_success = true): „Successfully created {record type} record in BMC Helix Remedyforce.“ (Der Datensatz „{record type}“ wurde in BMC Helix Remedyforce erstellt.)

Die Aktion sollte fehlschlagen und die Ausführung eines Playbooks beenden:
Bei schwerwiegenden Fehlern wie falschen Anmeldedaten, keiner Verbindung zum Server usw.: „Fehler beim Ausführen der Aktion ‚Datensatz erstellen‘. Grund: {0}''.format(error.Stacktrace)

Bei 400: „Fehler beim Ausführen der Aktion ‚Datensatz erstellen‘. Grund: {message}.

Wenn der Datensatztyp nicht gefunden wurde:Fehler beim Ausführen der Aktion „Datensatz erstellen“. Grund: {Record Type} wurde in BMC Helix Remedyforce nicht gefunden. Verwenden Sie die Aktion „Eintragstypen auflisten“, um eine Liste der verfügbaren Eintragstypen abzurufen.

Bei ungültiger JSON-Nutzlast: „Fehler beim Ausführen der Aktion ‚Datensatz erstellen‘. Grund: Im Parameter „Record Payload“ wurde eine ungültige JSON-Nutzlast angegeben. Bitte überprüfen Sie die Struktur.

 Allgemein

Eintrag löschen

Beschreibung

Einen Datensatz in BMC Helix Remedyforce löschen

Parameter

Anzeigename des Parameters Typ Standardwert Ist obligatorisch Beschreibung
Eintragtyp String – Ja Geben Sie den Typ des Datensatzes an, der gelöscht werden soll. Wenn Sie nicht wissen, welche Arten von Einträgen verfügbar sind, führen Sie die Aktion „List Record Types“ aus.
Datensatz-ID String – Ja Geben Sie die ID des Datensatzes an, der gelöscht werden soll.

Ausführen am

Die Aktion wird nicht für Entitäten ausgeführt und hat keine erforderlichen Eingabeparameter.

Aktionsergebnisse

Scriptergebnis
Name des Scriptergebnisses Wertoptionen
is_success is_success=False
is_success is_success=True
Fall-Repository
Ergebnistyp Wert/Beschreibung Typ (Entität \ Allgemein)
Ausgabemeldung*

Die Aktion darf nicht fehlschlagen oder die Ausführung eines Playbooks stoppen:
if 204 (is_success = true): „{Record Type}-Datensatz mit der ID {record id} wurde in BMC Helix Remedyforce gelöscht.

Wenn 404 (is_success=true): „{Record Type}-Datensatz mit ID {record id} ist in BMC Helix Remedyforce nicht vorhanden.

Die Aktion sollte fehlschlagen und die Playbook-Ausführung beenden:

Bei schwerwiegenden Fehlern wie falschen Anmeldedaten, fehlender Verbindung zum Server usw.: „Fehler beim Ausführen der Aktion ‚Datensatz löschen‘. Grund: {0}''.format(error.Stacktrace)

Wenn der Datensatztyp nicht gefunden wurde:Fehler beim Ausführen der Aktion „Datensatz löschen“. Grund: {Record Type} wurde in BMC Helix Remedyforce nicht gefunden. Verwenden Sie die Aktion „Eintragstypen auflisten“, um eine Liste der verfügbaren Eintragstypen abzurufen.

 Allgemein

Benutzerdefinierte Abfrage ausführen

Beschreibung

Führen Sie eine benutzerdefinierte SOQL-Abfrage in BMC Helix Remedyforce aus.

Parameter

Anzeigename des Parameters Typ Standardwert Ist obligatorisch Beschreibung
SOQL-Abfrage String – Ja Geben Sie an, welche Abfrage ausgeführt werden soll.

Ausführen am

Die Aktion wird nicht für Entitäten ausgeführt und hat keine erforderlichen Eingabeparameter.

Aktionsergebnisse

Scriptergebnis
Name des Scriptergebnisses Wertoptionen
is_success is_success=False
is_success is_success=True
JSON-Ergebnis
{
    "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
}
Fall-Repository
Ergebnistyp Wert/Beschreibung Typ (Entität \ Allgemein)
Ausgabemeldung*

Die Aktion darf nicht fehlschlagen oder die Ausführung eines Playbooks stoppen:
wenn mindestens ein Ergebnis gefunden wurde (is_success = true): „Successfully returned results for the query "{query}" in BMC Helix Remedyforce.

Wenn nichts gefunden wurde(is_success=true): „Für die Anfrage ‚{query}‘ wurden in BMC Helix Remedyforce keine Ergebnisse gefunden.“

Die Aktion sollte fehlschlagen und die Ausführung eines Playbooks beenden:
bei schwerwiegenden Fehlern wie falschen Anmeldedaten, keiner Verbindung zum Server usw.: „Fehler beim Ausführen der Aktion ‚Benutzerdefinierte Abfrage ausführen‘. Grund: {0}''.format(error.Stacktrace)

 Allgemein
Fall-Repository Name:Ergebnisse Allgemein

Einfache Abfrage ausführen

Beschreibung

Führen Sie eine SOQL-Abfrage basierend auf Parametern in BMC Helix Remedyforce aus.

Parameter

Anzeigename des Parameters Typ Standardwert Ist obligatorisch Beschreibung
Eintragtyp String – Ja Geben Sie an, welcher Datensatztyp abgefragt werden soll.
Where-Filter String – Nein Geben Sie den WHERE-Filter für die auszuführende Abfrage an. Hinweis: Sie müssen keinen Zeitfilter, keine Begrenzung und keine Sortierung angeben. Außerdem müssen Sie in der Nutzlast keinen WHERE-String angeben.
Zeitraum DDL

Letzte Stunde

Mögliche Werte:

Letzte Stunde

Letzte 6 Stunden

Letzte 24 Stunden

Letzte Woche

Letzter Monat

Benutzerdefiniert

 Nein Geben Sie einen Zeitraum für die Ergebnisse an. Wenn „Benutzerdefiniert“ ausgewählt ist, müssen Sie auch „Beginn“ angeben.
Beginn String – Nein Geben Sie die Startzeit für die Ergebnisse an. Dieser Parameter ist erforderlich, wenn für den Parameter „Zeitrahmen“ die Option „Benutzerdefiniert“ ausgewählt ist. Format: ISO 8601
Ende String – Nein Geben Sie die Endzeit für die Ergebnisse an. Format: ISO 8601. Wenn nichts angegeben ist und für den Parameter „Zeitrahmen“ die Option „Benutzerdefiniert“ ausgewählt ist, wird für diesen Parameter die aktuelle Zeit verwendet.
Zurückzugebende Felder CSV – Nein Geben Sie an, welche Felder zurückgegeben werden sollen. Wenn nichts angegeben ist, werden alle Felder zurückgegeben.
Sortierfeld String CreatedDate Nein Geben Sie an, welcher Parameter für die Sortierung verwendet werden soll.
Sortierreihenfolge DDL

ASC

Mögliche Werte:

ASC

DESC

 Nein Geben Sie die Sortierreihenfolge an.
Maximale Anzahl zurückzugebender Ergebnisse Ganzzahl 50 Nein Geben Sie an, wie viele Ergebnisse zurückgegeben werden sollen. Standard: 50. Der Höchstwert beträgt 200.

Ausführen am

Die Aktion wird nicht für Entitäten ausgeführt und hat keine erforderlichen Eingabeparameter.

Aktionsergebnisse

Scriptergebnis
Name des Scriptergebnisses Wertoptionen
is_success is_success=False
is_success is_success=True
JSON-Ergebnis
{
    "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
}
Fall-Repository
Ergebnistyp Wert/Beschreibung Typ (Entität \ Allgemein)
Ausgabemeldung*

Die Aktion darf nicht fehlschlagen oder die Ausführung eines Playbooks stoppen:
wenn mindestens ein Ergebnis gefunden wurde (is_success = true): „Successfully returned results for the query "{query}" in BMC Helix Remedyforce.

Wenn nichts gefunden wurde(is_success=true): „Für die Anfrage ‚{query}‘ wurden in BMC Helix Remedyforce keine Ergebnisse gefunden.“

Die Aktion sollte fehlschlagen und die Ausführung eines Playbooks beenden:
bei schwerwiegenden Fehlern wie falschen Anmeldedaten, keiner Verbindung zum Server usw.: „Fehler beim Ausführen der Aktion ‚Einfache Abfrage ausführen‘. Grund: {0}''.format(error.Stacktrace)

 Allgemein
Fall-Repository Name:Ergebnisse Allgemein

Details zur Aufnahme abrufen

Beschreibung

Detaillierte Informationen zum Datensatz aus BMC Helix Remedyforce abrufen

Parameter

Anzeigename des Parameters Typ Standardwert Ist obligatorisch Beschreibung
Eintragtyp String – Ja Geben Sie den Typ des Datensatzes an, für den Sie Details abrufen möchten. Wenn Sie nicht wissen, welche Arten von Einträgen verfügbar sind, führen Sie die Aktion „List Record Types“ aus.
Datensatz-IDs CSV – Ja Geben Sie die IDs der Datensätze an, für die Sie Details zurückgeben möchten.
Zurückzugebende Felder CSV – Nein Geben Sie an, welche Felder zurückgegeben werden sollen. Wenn keines der angegebenen Felder gefunden wurde, schlägt die Aktion fehl. Wenn nichts angegeben ist, werden alle Felder zurückgegeben.

Ausführen am

Die Aktion wird nicht für Entitäten ausgeführt und hat keine erforderlichen Eingabeparameter.

Aktionsergebnisse

Scriptergebnis
Name des Scriptergebnisses Wertoptionen
is_success is_success=False
is_success is_success=True
JSON-Ergebnis
{
    "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
}
Fall-Repository
Ergebnistyp Wert/Beschreibung Typ (Entität \ Allgemein)
Ausgabemeldung*

Die Aktion darf nicht fehlschlagen oder die Ausführung eines Playbooks stoppen.
Wenn Daten für mindestens eine ID verfügbar sind(is_success = true): „Details zum Datensatztyp {Record Type} für die folgenden IDs wurden zurückgegeben: {record ids}“.

Wenn für mindestens eine ID keine Daten verfügbar sind (is_success=true): „Action wasn't able to find details regarding record type {Record Type} for the following ids: {record ids}“.

Wenn keine Daten für alle verfügbar sind (is_success=false): Es wurden keine Datensätze gefunden.

Die Aktion sollte fehlschlagen und die Ausführung eines Playbooks beenden:
bei schwerwiegenden Fehlern wie falschen Anmeldedaten, keiner Verbindung zum Server usw.: „Fehler beim Ausführen der Aktion ‚Datensatzdetails abrufen‘. Grund: {0}''.format(error.Stacktrace)

Wenn der Datensatztyp nicht gefunden wurde:Fehler beim Ausführen der Aktion „Datensatzdetails abrufen“. Grund: {Record Type} wurde in BMC Helix Remedyforce nicht gefunden. Verwenden Sie die Aktion „Eintragstypen auflisten“, um eine Liste der verfügbaren Eintragstypen abzurufen.

Wenn keines der in „Zurückzugebende Felder“ angegebenen Felder gefunden wurde: „Fehler beim Ausführen der Aktion ‚Datensatzdetails abrufen‘. Grund: Keines der angegebenen Felder wurde gefunden. Bitte überprüfen Sie die Rechtschreibung.“

 Allgemein
Tabelle „Fall-Repository“

Name:Record {record Id}Details

Spalten:

Schlüssel

Wert

 Allgemein

OAuth-Autorisierungscode abrufen

Beschreibung

Generieren Sie einen OAuth-Autorisierungscode in BMC Helix Remedyforce. Weitere Informationen finden Sie im Dokumentationsportal.

Parameter

Anzeigename des Parameters Typ Standardwert Ist obligatorisch Beschreibung
Weiterleitungs-URL String https://localhost Ja Geben Sie die Weiterleitungs-URL an, die beim Erstellen der Connector-App verwendet wurde.

Ausführen am

Die Aktion wird nicht für Entitäten ausgeführt und hat keine erforderlichen Eingabeparameter.

Aktionsergebnisse

Scriptergebnis
Name des Scriptergebnisses Wertoptionen
is_success is_success=False
is_success is_success=True
Fall-Repository
Ergebnistyp Wert/Beschreibung Typ (Entität \ Allgemein)
Ausgabemeldung*

Die Aktion darf nicht fehlschlagen und darf die Ausführung eines Playbooks nicht stoppen.

„Die Autorisierungscode-URL wurde in BMC Helix Remedyforce generiert. Kopieren Sie sie und fügen Sie sie in den Browser ein. Kopieren Sie dann den Teil „code“ aus der URL. Dieser Autorisierungscode wird in der Aktion „OAuth-Aktualisierungstoken abrufen“ verwendet.

 Allgemein
Link

Name:Autorisierungscode-Link
URL: {generated link}

OAuth-Aktualisierungstoken abrufen

Beschreibung

Generieren Sie das Aktualisierungstoken, das für die Konfiguration der Integration erforderlich ist. Der Autorisierungscode kann mit „Get OAuth Authorization Code“ (OAuth-Autorisierungscode abrufen) generiert werden. Weitere Informationen finden Sie im Dokumentationsportal.

Parameter

Anzeigename des Parameters Typ Standardwert Ist obligatorisch Beschreibung
Weiterleitungs-URL String https://localhost Ja Geben Sie die Weiterleitungs-URL an, die beim Erstellen der Connector-App verwendet wurde.
Autorisierungscode String – Ja Geben Sie den Autorisierungscode aus der Aktion „OAuth-Autorisierungscode abrufen“ an.

Ausführen am

Die Aktion wird nicht für Entitäten ausgeführt und hat keine erforderlichen Eingabeparameter.

Aktionsergebnisse

Scriptergebnis
Name des Scriptergebnisses Wertoptionen
is_success is_success=False
is_success is_success=True
JSON-Ergebnis
{
    "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"
}
Fall-Repository
Ergebnistyp Wert/Beschreibung Typ (Entität \ Allgemein)
Ausgabemeldung*

Die Aktion darf nicht fehlschlagen oder die Ausführung eines Playbooks stoppen:
if 200 (is_success = true): „Successfully generated refresh token in BMC Helix Remedyforce.“ (Aktualisierungstoken in BMC Helix Remedyforce wurde erfolgreich generiert.)

Die Aktion sollte fehlschlagen und die Ausführung eines Playbooks beenden:
bei schwerwiegendem Fehler, z. B. falsche Anmeldedaten, keine Verbindung zum Server, Sonstiges: „Fehler beim Ausführen der Aktion ‚OAuth-Aktualisierungstoken abrufen‘. Grund: {0}''.format(error.Stacktrace)

Wenn kein 200er-Statuscode: „Fehler beim Ausführen der Aktion ‚OAuth-Aktualisierungstoken abrufen‘. Grund: {0}''.format(error_description)

 Allgemein

Eintragstypen auflisten

Beschreibung

Verfügbare Eintragstypen aus BMC Helix Remedyforce auflisten

Parameter

Anzeigename des Parameters Typ Standardwert Ist obligatorisch Beschreibung
Filterlogik DDL

Gleich

DDL

Gleich

Enthält

 Nein Geben Sie an, welche Filterlogik angewendet werden soll.
Filterwert String – Nein Geben Sie an, welcher Wert im Filter verwendet werden soll. Wenn „Gleich“ ausgewählt ist, wird versucht, die genaue Übereinstimmung unter den Datensatztypen zu finden. Wenn „Enthält“ ausgewählt ist, wird versucht, Datensatztypen zu finden, die diese Teilzeichenfolge enthalten. Wenn für diesen Parameter nichts angegeben wird, wird der Filter nicht angewendet.
Maximale Anzahl zurückzugebender Datensatztypen Ganzzahl 50 Nein Geben Sie an, wie viele Datensatztypen zurückgegeben werden sollen.

Ausführen am

Die Aktion wird nicht für Entitäten ausgeführt und hat keine erforderlichen Eingabeparameter.

Aktionsergebnisse

Scriptergebnis
Name des Scriptergebnisses Wertoptionen
is_success is_success=False
is_success is_success=True
Fall-Repository
Ergebnistyp Wert/Beschreibung Typ (Entität \ Allgemein)
Ausgabemeldung*

Die Aktion darf nicht fehlschlagen und die Ausführung eines Playbooks nicht stoppen:
wenn mindestens ein Datensatz gefunden wurde (is_success = true): „Successfully listed available record types based on the provided criteria in BMC Helix Remedyforce.

Wenn nichts gefunden wurde (is_success=true): „No record types were found based on the provided criteria in BMC Helix Remedyforce“ (Es wurden keine Datensatztypen gefunden, die den angegebenen Kriterien in BMC Helix Remedyforce entsprechen.)

Die Aktion sollte fehlschlagen und die Ausführung eines Playbooks beenden:
bei schwerwiegendem Fehler, z. B. falsche Anmeldedaten, keine Verbindung zum Server, andere: „Fehler beim Ausführen der Aktion ‚List Record Types‘. Grund: {0}''.format(error.Stacktrace)

 Allgemein
Fall-Repository

Name:Verfügbare Eintragstypen

Spalten:

Name

Label

Benutzerdefiniert

Allgemein

Ping

Beschreibung

Testen Sie die Verbindung zu BMC Helix Remedyforce mit den Parametern, die auf der Seite mit der Integrationskonfiguration auf dem Tab „Google Security Operations Marketplace“ angegeben sind.

Ausführen am

Diese Aktion wird nicht für Elemente ausgeführt.

Aktionsergebnisse

Scriptergebnis
Name des Scriptergebnisses Wertoptionen
is_success is_success=False
is_success is_success=True
Fall-Repository
Ergebnistyp Wert/Beschreibung Typ (Entität \ Allgemein)
Ausgabemeldung*

Die Aktion darf nicht fehlschlagen und die Ausführung eines Playbooks nicht stoppen.
Bei Erfolg: „Successfully connected to the BMC Helix Remedyforce server with the provided connection parameters!“ (Erfolgreich mit dem BMC Helix Remedyforce-Server mit den angegebenen Verbindungsparametern verbunden!)

Die Aktion sollte fehlschlagen und die Ausführung eines Playbooks beenden:
if not successful: „Failed to connect to the BMC Helix Remedyforce server! Fehler: {0}".format(exception.stacktrace)

 Allgemein

Datensatz aktualisieren

Beschreibung

Aktualisieren Sie den Datensatz in BMC Helix Remedyforce.

Parameter

Anzeigename des Parameters Typ Standardwert Ist obligatorisch Beschreibung
Eintragtyp String – Ja Geben Sie den Typ des Datensatzes an, der aktualisiert werden muss. Wenn Sie nicht wissen, welche Arten von Einträgen verfügbar sind, führen Sie die Aktion „List Record Types“ aus.
Datensatz-ID String – Ja Geben Sie die ID des Datensatzes an, der aktualisiert werden soll.
Zu aktualisierende Felder JSON

{

„field“:“value“

}

 Ja Geben Sie ein JSON-Objekt mit allen erforderlichen Feldern und Werten an, die aktualisiert werden müssen.

Ausführen am

Die Aktion wird nicht für Entitäten ausgeführt und hat keine erforderlichen Eingabeparameter.

Aktionsergebnisse

Scriptergebnis
Name des Scriptergebnisses Wertoptionen
is_success is_success=False
is_success is_success=True
Fall-Repository
Ergebnistyp Wert/Beschreibung Typ (Entität \ Allgemein)
Ausgabemeldung*

Die Aktion darf nicht fehlschlagen oder die Ausführung eines Playbooks stoppen:
if 204 (is_success = true): "Successfully updated {record type} record with {record id} in BMC Helix Remedyforce.".

Die Aktion sollte fehlschlagen und die Ausführung eines Playbooks beenden:
Bei schwerwiegenden Fehlern wie falschen Anmeldedaten, keiner Verbindung zum Server usw.: „Fehler beim Ausführen der Aktion ‚Datensatz aktualisieren‘. Grund: {0}''.format(error.Stacktrace)

Bei 404 oder 400: „Fehler beim Ausführen der Aktion ‚Datensatz aktualisieren‘. Grund: {message}.

Wenn der Datensatztyp nicht gefunden wurde:Fehler beim Ausführen der Aktion „Datensatz aktualisieren“. Grund: {Record Type} wurde in BMC Helix Remedyforce nicht gefunden. Verwenden Sie die Aktion „Eintragstypen auflisten“, um eine Liste der verfügbaren Eintragstypen abzurufen.

Bei ungültiger JSON-Nutzlast: „Fehler beim Ausführen der Aktion ‚Datensatz aktualisieren‘. Grund: Im Parameter „Zu aktualisierende Felder“ wurde eine ungültige JSON-Nutzlast angegeben. Bitte überprüfen Sie die Struktur.

 Allgemein

Auf Aktualisierung der Felder warten

Beschreibung

Warten Sie, bis die Felder in BMC Helix Remedyforce aktualisiert werden.

Parameter

Anzeigename des Parameters Typ Standardwert Ist obligatorisch Beschreibung
Eintragtyp String – Ja Geben Sie den Typ des Datensatzes an, für den Sie auf ein Update warten. Wenn Sie nicht wissen, welche Arten von Einträgen verfügbar sind, führen Sie die Aktion „List Record Types“ aus.
Datensatz-ID String – Ja Geben Sie die ID des Datensatzes an, der aktualisiert werden muss.
Zu prüfende Felder JSON

{

„field“:“value“

}

 Ja Geben Sie ein JSON-Objekt mit allen erforderlichen Feldern und Werten an.
Bei Zeitüberschreitung fehlgeschlagen Kästchen Aktiviert Ja Wenn diese Option aktiviert ist, schlägt die Aktion fehl, wenn nicht alle Felder aktualisiert wurden.

Ausführen am

Die Aktion wird nicht für Entitäten ausgeführt und hat keine erforderlichen Eingabeparameter.

Aktionsergebnisse

Scriptergebnis
Name des Scriptergebnisses Wertoptionen
is_success is_success=False
is_success is_success=True
JSON-Ergebnis
{
    "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
}
Fall-Repository
Ergebnistyp Wert/Beschreibung Typ (Entität \ Allgemein)
Ausgabemeldung*

Die Aktion darf nicht fehlschlagen oder die Ausführung eines Playbooks stoppen:
if 201 (is_success = true): "{record type} record with ID {record id} was updated in BMC Helix Remedyforce.".

Wenn eines der Felder nicht aktualisiert wurde und „Fail if timeout“ nicht aktiviert ist (is_success=false): „The following fields were not updated for {record type} record with ID {record id} in BMC Helix Remedyforce: {fields that were not updated}“ (Die folgenden Felder wurden für den Datensatz vom Typ „{record type}“ mit der ID „{record id}“ in BMC Helix Remedyforce nicht aktualisiert: {fields that were not updated})

Asynchrone Nachricht:Warten auf die Aktualisierung der folgenden Felder für den {record type}-Eintrag mit der ID {record id} in BMC Helix Remedyforce: {fields that were not updated}

Die Aktion sollte fehlschlagen und die Ausführung eines Playbooks beenden:
bei schwerwiegendem Fehler, z. B. falsche Anmeldedaten, keine Verbindung zum Server, andere: „Fehler beim Ausführen der Aktion ‚Auf Feldaktualisierung warten‘. Grund: {0}''.format(error.Stacktrace)

Wenn einige Felder nicht gefunden wurden: „Fehler beim Ausführen der Aktion ‚Auf Feldaktualisierung warten‘. Grund: Die folgenden Felder wurden in der Struktur des Datensatzes nicht gefunden: {fields that were not found}.

Wenn der Datensatztyp nicht gefunden wurde:Fehler beim Ausführen der Aktion „Auf Feldaktualisierung warten“. Grund: {Record Type} wurde in BMC Helix Remedyforce nicht gefunden. Verwenden Sie die Aktion „Eintragstypen auflisten“, um eine Liste der verfügbaren Eintragstypen abzurufen.

Wenn eines der Felder nicht aktualisiert wurde und „Fehler bei Zeitüberschreitung“ aktiviert ist (is_success=false): „Error executing action ‚Wait For Fields Update‘. Grund: Die folgenden Felder wurden für den Datensatz vom Typ „{record type}“ mit der ID „{record id}“ in BMC Helix Remedyforce nicht aktualisiert: {fields that were not updated}.“

Bei ungültiger JSON-Nutzlast: „Fehler beim Ausführen der Aktion ‚Auf Feldaktualisierung warten‘. Grund: Im Parameter „Zu prüfende Felder“ wurde eine ungültige JSON-Nutzlast angegeben. Bitte überprüfen Sie die Struktur.

 Allgemein

Connector

BMC Helix Remedyforce – Incidents Connector

Beschreibung

Informationen zu Vorfällen aus BMC Helix Remedyforce abrufen

BMC Helix Remedyforce – Incidents Connector in Google SecOps konfigurieren

Eine ausführliche Anleitung zum Konfigurieren eines Connectors in Google SecOps finden Sie unter Connector konfigurieren.

Connector-Parameter

Verwenden Sie die folgenden Parameter, um den Connector zu konfigurieren:

Anzeigename des Parameters Typ Standardwert Ist obligatorisch Beschreibung
Produktfeldname String Produktname Ja Geben Sie den Namen des Quellfelds ein, um den Namen des Produktfelds abzurufen.
Name des Ereignisfelds String BMCServiceDesk__Type__c Ja Geben Sie den Namen des Quellfelds ein, um den Namen des Ereignisfelds abzurufen.
Name des Umgebungsfelds String "" Nein

Beschreibt den Namen des Felds, in dem der Umgebungsname gespeichert ist.

Wenn das Feld „environment“ nicht gefunden wird, ist die Umgebung die Standardumgebung.
Regex-Muster für Umgebung String .* Nein

Ein regulärer Ausdruck, der auf den Wert im Feld „Name des Umgebungsfelds“ angewendet wird.

Der Standardwert ist „.*“, um alle Werte zu erfassen und unverändert zurückzugeben.

Damit kann der Nutzer das Feld „environment“ über Regex-Logik bearbeiten.

Wenn das reguläre Ausdrucksmuster null oder leer ist oder der Umgebungswert null ist, ist das endgültige Umgebungsergebnis die Standardumgebung.
Zeitlimit für Script (Sekunden) Ganzzahl 180 Ja Zeitlimit für den Python-Prozess, in dem das aktuelle Skript ausgeführt wird.
API-Stamm String https://.my.salesforce.com Ja API-Stamm der BMC Helix Remedyforce-Instanz.
Nutzername String – Ja BMC Helix Remedyforce-Nutzername.
Passwort Passwort – Ja BMC Helix Remedyforce-Passwort.
Niedrigste Priorität für Abruf Ganzzahl 5 Nein Niedrigste Priorität, die zum Abrufen von Vorfällen verwendet wird. Maximal: 5 Mindestwert: 1. Wenn nichts angegeben ist, werden alle Vorfälle vom Connector aufgenommen.
Vorgänge mit leerer Priorität aufnehmen Kästchen Aktiviert Nein Wenn diese Option aktiviert ist, ruft der Connector Vorfälle ohne Priorität ab. Google SecOps-Benachrichtigungen, die auf diese Weise erstellt werden, haben die Priorität „Informational“.
Filtertyp CSV Vorfall,Dienstanfrage Nein Geben Sie einen Filter für die Vorfälle ein. Wenn nichts angegeben ist, werden alle Vorfälle vom Connector aufgenommen. Beispiel: Vorfall, Serviceanfrage.
Maximale Stunden zurück Ganzzahl 1 Nein Anzahl der Stunden, ab denen Vorfälle abgerufen werden sollen.
Maximale Anzahl abzurufender Vorfälle Ganzzahl 10 Nein Die Anzahl der Vorfälle, die pro Connector-Iteration verarbeitet werden sollen. Der Höchstwert beträgt 200.
Zulassungsliste als Sperrliste verwenden Kästchen Aktiviert Ja Wenn diese Option aktiviert ist, wird die Zulassungsliste als Sperrliste verwendet.
SSL überprüfen Kästchen Aktiviert Ja Wenn diese Option aktiviert ist, wird das SSL-Zertifikat für die Verbindung zum BMC Helix Remedyforce-Server geprüft.
Proxyserveradresse String – Nein Die Adresse des zu verwendenden Proxyservers.
Proxy-Nutzername String – Nein Der Proxy-Nutzername für die Authentifizierung.
Proxy-Passwort Passwort – Nein Das Proxy-Passwort für die Authentifizierung.
Client-ID String – Nein Die BMC Helix Remedyforce-Client-ID der verbundenen App. Dieser Parameter ist für die OAuth-Authentifizierung erforderlich. Hinweis: Dieser Parameter hat Vorrang vor der Authentifizierung mit Nutzername und Passwort.
Clientschlüssel Passwort – Nein BMC Helix Remedyforce-Client-Secret der verbundenen App. Dieser Parameter ist für die OAuth-Authentifizierung erforderlich. Hinweis: Dieser Parameter hat Vorrang vor der Authentifizierung mit Nutzername und Passwort.
Login API Root String https://login.salesforce.com Ja API-Stamm, der zur Authentifizierung in BMC Helix Remedyforce verwendet wird.

Connector-Regeln

Proxyunterstützung

Der Connector unterstützt Proxy.

Benötigen Sie weitere Hilfe? Antworten von Community-Mitgliedern und Google SecOps-Experten erhalten