BMC Helix Remedyforce

Versione integrazione: 11.0

Casi d'uso

  1. Eseguire l'importazione degli incidenti
  2. Eseguire l'azione di triage (aggiornamento/creazione/eliminazione di record)

Come configurare l'autenticazione OAuth

A volte il metodo di autenticazione di base che utilizza nome utente e password non funziona. Ciò può accadere quando l'MFA è abilitata per l'account. In queste situazioni, devi configurare l'autenticazione OAuth.

Passaggi:

  1. Vai a Configurazione > Gestore app.
  2. Premi il pulsante "Nuova app connessa".
  3. Fornisci "Nome app collegata", "Nome API" ed "Email di contatto".
  4. "Enable OAuth Settings" (Attiva impostazioni OAuth) deve essere impostato su true.
  5. Imposta "URL di callback" su "https://localhost".
  6. Aggiungi gli ambiti "full" e "refresh_token". Entrambi sono necessari per accedere all'API.
  7. Salva l'app.
  8. Apri la configurazione dell'app e copia "Chiave utente" e "Secret consumer". "Chiave consumer" è "ID client" e "Secret consumer" è il client secret nella configurazione dell'integrazione.
  9. Vai all'azione "Recupera codice di autorizzazione OAuth". "URL di reindirizzamento" è "URL callback".
  10. Esegui azione. Nel risultato JSON avrai un URL di autorizzazione. Devi copiarlo e incollarlo nel browser. Alla fine, verrà eseguito il reindirizzamento e l'URL avrà questo aspetto: "https://localhost/?code=aPrxyeILZDvX2Hhmz2gymvtuE4aow6hMnAKw_98FyXJvaN7l69bJZFr1z.ylZ3qXd0KZlXjn0g%3D%3D". Devi copiare tutto ciò che segue "code=" e assicurarti di eseguire la decodifica dell'URL. %3D è il carattere "=".
  11. Vai all'azione "Ottieni token di aggiornamento OAuth". "URL di reindirizzamento" è "URL di callback" e "Codice di autorizzazione" è il "codice" della richiesta precedente.
  12. Se tutto è stato eseguito correttamente, nel risultato JSON verrà visualizzato "refresh_token".
  13. Copia questo token di aggiornamento nella configurazione dell'integrazione ed esegui un test.

Configurare l'integrazione di BMC Helix Remedyforce in Google Security Operations

Per istruzioni dettagliate su come configurare un'integrazione in Google SecOps, vedi Configurare le integrazioni.

Parametri di integrazione

Utilizza i seguenti parametri per configurare l'integrazione:

Nome visualizzato del parametro Tipo Valore predefinito È obbligatorio Descrizione
Root API Stringa https://.my.salesforce.com Radice API dell'istanza BMC Helix Remedyforce.
Nome utente Stringa N/D No Nome utente BMC Helix Remedyforce.
Password Password N/D No Password di BMC Helix Remedyforce.
ID client Stringa N/D No ID client BMC Helix Remedyforce dell'app connessa. Questo parametro è necessario per l'autenticazione OAuth. Nota: questo parametro ha la priorità sull'autenticazione con nome utente e password.
Client secret Password N/D No Il client secret di BMC Helix Remedyforce dell'app connessa. Questo parametro è necessario per l'autenticazione OAuth. Nota: questo parametro ha la priorità sull'autenticazione con nome utente e password.
Aggiorna token Password N/D No Token di aggiornamento per l'autorizzazione OAuth.
Verifica SSL Casella di controllo Selezionata Se abilitata, verifica che il certificato SSL per la connessione al server BMC Helix Remedyforce sia valido.
Root API di accesso Stringa https://login.salesforce.com Radice dell'API utilizzata per l'autenticazione in BMC Helix Remedyforce.

Azioni

Create Record

Descrizione

Crea un record in BMC Helix Remedyforce.

Parametri

Nome visualizzato del parametro Tipo Valore predefinito È obbligatorio Descrizione
Tipo di record Stringa N/D Specifica il tipo di record da creare. Se non sai quali tipi di record sono disponibili, esegui l'azione "Elenca tipi di record".
Payload del record JSON

{

"field":"value"

}

Specifica un oggetto JSON contenente tutti i campi e i valori necessari.

Run On

L'azione non viene eseguita sulle entità e non ha parametri di input obbligatori.

Risultati dell'azione

Risultato script
Nome risultato script Opzioni di valore
is_success is_success=False
is_success is_success=True
Risultato JSON
{
    "id": "0015e000005dVbKAAU",
    "success": true,
    "errors": []
}
Bacheca casi
Tipo di risultato Valore/Descrizione Tipo (entità/generale)
Messaggio di output*

L'azione non deve non riuscire né interrompere l'esecuzione di un playbook:
se 201 (is_success = true): "Successfully created {record type} record in BMC Helix Remedyforce.".

L'azione deve non riuscire e interrompere l'esecuzione di un playbook:
se si verifica un errore irreversibile, ad esempio credenziali errate, nessuna connessione al server, altro: "Errore durante l'esecuzione dell'azione "Crea record". Motivo: {0}''.format(error.Stacktrace)

Se 400: "Error executing action "Create Record". Motivo: {message}.

Se il tipo di record non è stato trovato:errore durante l'esecuzione dell'azione "Crea record". Motivo: {Record Type} non è stato trovato in BMC Helix Remedyforce. Utilizza l'azione "Elenca tipi di record" per ottenere un elenco dei tipi di record disponibili.

Se il payload JSON non è valido: "Error executing action "Create Record". Motivo: payload JSON non valido fornito nel parametro "Payload record". Controlla la struttura.

Generale

Elimina record

Descrizione

Elimina un record in BMC Helix Remedyforce.

Parametri

Nome visualizzato del parametro Tipo Valore predefinito È obbligatorio Descrizione
Tipo di record Stringa N/D Specifica il tipo di record da eliminare. Se non sai quali tipi di record sono disponibili, esegui l'azione "Elenca tipi di record".
ID record Stringa N/D Specifica l'ID del record da eliminare.

Run On

L'azione non viene eseguita sulle entità e non ha parametri di input obbligatori.

Risultati dell'azione

Risultato script
Nome risultato script Opzioni di valore
is_success is_success=False
is_success is_success=True
Bacheca casi
Tipo di risultato Valore/Descrizione Tipo (entità/generale)
Messaggio di output*

L'azione non deve non riuscire né interrompere l'esecuzione di un playbook:
se 204 (is_success = true): "Successfully deleted {Record Type} record with ID {record id} in BMC Helix Remedyforce.

Se 404 (is_success=true): "{Record Type} Record with ID {record id} doesn't exist in BMC Helix Remedyforce.

L'azione deve non riuscire e interrompere l'esecuzione di un playbook:

Se si verifica un errore irreversibile, ad esempio credenziali errate, nessuna connessione al server, altro: "Errore durante l'esecuzione dell'azione "Elimina record". Motivo: {0}''.format(error.Stacktrace)

Se il tipo di record non è stato trovato:errore durante l'esecuzione dell'azione "Elimina record". Motivo: {Record Type} non è stato trovato in BMC Helix Remedyforce. Utilizza l'azione "Elenca tipi di record" per ottenere un elenco dei tipi di record disponibili.

Generale

Esegui query personalizzata

Descrizione

Esegui una query SOQL personalizzata in BMC Helix Remedyforce.

Parametri

Nome visualizzato del parametro Tipo Valore predefinito È obbligatorio Descrizione
Query SOQL Stringa N/D Specifica la query da eseguire.

Run On

L'azione non viene eseguita sulle entità e non ha parametri di input obbligatori.

Risultati dell'azione

Risultato script
Nome risultato script Opzioni di valore
is_success is_success=False
is_success is_success=True
Risultato 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
}
Bacheca casi
Tipo di risultato Valore/Descrizione Tipo (entità/generale)
Messaggio di output*

L'azione non deve non riuscire né interrompere l'esecuzione di un playbook:
se viene trovato almeno un risultato (is_success = true): "Successfully returned results for the query "{query}" in BMC Helix Remedyforce.

Se non è stato trovato nulla(is_success=true): "Nessun risultato trovato per la query "{query}" in BMC Helix Remedyforce"

L'azione deve non riuscire e interrompere l'esecuzione di un playbook:
se si verifica un errore irreversibile, ad esempio credenziali errate, nessuna connessione al server, altro: "Error executing action "Execute Custom Query". Motivo: {0}''.format(error.Stacktrace)

Generale
Bacheca casi Nome: risultati Generale

Esegui query semplice

Descrizione

Esegui una query SOQL in base ai parametri in BMC Helix Remedyforce.

Parametri

Nome visualizzato del parametro Tipo Valore predefinito È obbligatorio Descrizione
Tipo di record Stringa N/D Specifica il tipo di record da interrogare.
Filtro Where Stringa N/D No Specifica il filtro WHERE per la query da eseguire. Nota: non è necessario fornire filtri temporali, limitazioni e ordinamento. Inoltre, non è necessario fornire la stringa WHERE nel payload.
Intervallo di tempo DDL

Ultima ora

Valori possibili:

Ultima ora

Ultime 6 ore

Ultime 24 ore

Settimana scorsa

Mese scorso

Personalizzato

No Specifica un periodo di tempo per i risultati. Se è selezionata l'opzione "Personalizzato", devi fornire anche l'"Ora di inizio".
Ora di inizio Stringa N/D No Specifica l'ora di inizio per i risultati. Questo parametro è obbligatorio se è selezionato "Personalizzato" per il parametro "Intervallo di tempo". Formato: ISO 8601
Ora di fine Stringa N/D No Specifica l'ora di fine per i risultati. Formato: ISO 8601. Se non viene fornito alcun valore e viene selezionato "Personalizzato" per il parametro "Intervallo di tempo", questo parametro utilizzerà l'ora corrente.
Campi da restituire CSV N/D No Specifica i campi da restituire. Se non viene fornito nulla, l'azione restituirà tutti i campi.
Campo di ordinamento Stringa CreatedDate No Specifica quale parametro deve essere utilizzato per l'ordinamento.
Ordinamento DDL

CRESC

Valori possibili:

CRESC

DECR

No Specifica l'ordine di ordinamento.
Numero massimo di risultati da restituire Numero intero 50 No Specifica il numero di risultati da restituire. Valore predefinito: 50. Il valore massimo è 200.

Run On

L'azione non viene eseguita sulle entità e non ha parametri di input obbligatori.

Risultati dell'azione

Risultato script
Nome risultato script Opzioni di valore
is_success is_success=False
is_success is_success=True
Risultato 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
}
Bacheca casi
Tipo di risultato Valore/Descrizione Tipo (entità/generale)
Messaggio di output*

L'azione non deve non riuscire né interrompere l'esecuzione di un playbook:
se viene trovato almeno un risultato (is_success = true): "Successfully returned results for the query "{query}" in BMC Helix Remedyforce.

Se non è stato trovato nulla(is_success=true): "Nessun risultato trovato per la query "{query}" in BMC Helix Remedyforce"

L'azione deve non riuscire e interrompere l'esecuzione di un playbook:
se si verifica un errore irreversibile, ad esempio credenziali errate, nessuna connessione al server, altro: "Errore durante l'esecuzione dell'azione "Esegui query semplice". Motivo: {0}''.format(error.Stacktrace)

Generale
Bacheca casi Nome: risultati Generale

Recupero dettagli registrazione

Descrizione

Ottieni informazioni dettagliate sul record da BMC Helix Remedyforce.

Parametri

Nome visualizzato del parametro Tipo Valore predefinito È obbligatorio Descrizione
Tipo di record Stringa N/D Specifica il tipo di record per cui vuoi recuperare i dettagli. Se non sai quali tipi di record sono disponibili, esegui l'azione "Elenca tipi di record".
ID record CSV N/D Specifica gli ID dei record per i quali vuoi restituire i dettagli.
Campi da restituire CSV N/D No Specifica i campi da restituire. Se non viene trovato nessuno dei campi forniti, l'azione non andrà a buon fine. Se non viene fornito nulla, l'azione restituirà tutti i campi.

Run On

L'azione non viene eseguita sulle entità e non ha parametri di input obbligatori.

Risultati dell'azione

Risultato script
Nome risultato script Opzioni di valore
is_success is_success=False
is_success is_success=True
Risultato 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
}
Bacheca casi
Tipo di risultato Valore/Descrizione Tipo (entità/generale)
Messaggio di output*

L'azione non deve non riuscire né interrompere l'esecuzione di un playbook:
se i dati sono disponibili per almeno un ID(is_success = true): "Successfully returned details regarding record type {Record Type} for the following ids: {record ids}".

Se i dati non sono disponibili per almeno un ID (is_success=true): "L'azione non è riuscita a trovare i dettagli relativi al tipo di record {Record Type} per i seguenti ID: {record ids}".

Se i dati non sono disponibili per tutti (is_success=false): non sono stati trovati record.

L'azione deve non riuscire e interrompere l'esecuzione di un playbook:
se si verifica un errore irreversibile, ad esempio credenziali errate, nessuna connessione al server, altro: "Errore durante l'esecuzione dell'azione "Recupera dettagli record". Motivo: {0}''.format(error.Stacktrace)

Se il tipo di record non è stato trovato: errore durante l'esecuzione dell'azione "Ottieni dettagli record". Motivo: {Record Type} non è stato trovato in BMC Helix Remedyforce. Utilizza l'azione "Elenca tipi di record" per ottenere un elenco dei tipi di record disponibili.

Se non è stato trovato nessuno dei campi forniti in "Campi da restituire": "Errore durante l'esecuzione dell'azione "Recupera dettagli record". Motivo: non è stato trovato nessuno dei campi forniti. Controlla l'ortografia.''

Generale
Tabella Bacheca casi

Nome: dettagli del record {record Id}

Colonne:

Chiave

Valore

Generale

Recuperare il codice di autorizzazione OAuth

Descrizione

Genera un codice di autorizzazione OAuth in BMC Helix Remedyforce. Per ulteriori informazioni, consulta il portale della documentazione.

Parametri

Nome visualizzato del parametro Tipo Valore predefinito È obbligatorio Descrizione
URL di reindirizzamento Stringa https://localhost Specifica l'URL di reindirizzamento utilizzato al momento della creazione dell'app connettore.

Run On

L'azione non viene eseguita sulle entità e non ha parametri di input obbligatori.

Risultati dell'azione

Risultato script
Nome risultato script Opzioni di valore
is_success is_success=False
is_success is_success=True
Bacheca casi
Tipo di risultato Valore/Descrizione Tipo (entità/generale)
Messaggio di output*

L'azione non deve non riuscire né interrompere l'esecuzione di un playbook:

"Generazione dell'URL del codice di autorizzazione riuscita in BMC Helix Remedyforce. Copia e incollalo nel browser. Dopodiché, copia la parte "code" dell'URL. Questo codice di autorizzazione viene utilizzato nell'azione "Ottieni token di aggiornamento OAuth".

Generale
Link

Nome: link al codice di autorizzazione
URL: {generated link}

Recupera token di aggiornamento OAuth

Descrizione

Genera il token di aggiornamento necessario per la configurazione dell'integrazione. Il codice di autorizzazione può essere generato utilizzando "Ottieni codice di autorizzazione OAuth". Per ulteriori informazioni, consulta il portale della documentazione.

Parametri

Nome visualizzato del parametro Tipo Valore predefinito È obbligatorio Descrizione
URL di reindirizzamento Stringa https://localhost Specifica l'URL di reindirizzamento utilizzato al momento della creazione dell'app connettore.
Codice di autorizzazione Stringa N/D Specifica il codice di autorizzazione dell'azione "Recupera codice di autorizzazione OAuth".

Run On

L'azione non viene eseguita sulle entità e non ha parametri di input obbligatori.

Risultati dell'azione

Risultato script
Nome risultato script Opzioni di valore
is_success is_success=False
is_success is_success=True
Risultato 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"
}
Bacheca casi
Tipo di risultato Valore/Descrizione Tipo (entità/generale)
Messaggio di output*

L'azione non deve non riuscire né interrompere l'esecuzione di un playbook:
if 200 (is_success = true): "Successfully generated refresh token in BMC Helix Remedyforce.".

L'azione deve non riuscire e interrompere l'esecuzione di un playbook:
se si verifica un errore irreversibile, ad esempio credenziali errate, nessuna connessione al server, altro: "Error executing action "Get OAuth Refresh Token". Motivo: {0}''.format(error.Stacktrace)

Se il codice di stato non è 200: "Errore durante l'esecuzione dell'azione "Ottieni token di aggiornamento OAuth". Motivo: {0}''.format(error_description)

Generale

Elenco tipi di record

Descrizione

Elenca i tipi di record disponibili da BMC Helix Remedyforce.

Parametri

Nome visualizzato del parametro Tipo Valore predefinito È obbligatorio Descrizione
Logica di filtro DDL

Uguale

DDL

Uguale

Contiene

No Specifica la logica di filtro da applicare.
Valore filtro Stringa N/D No Specifica il valore da utilizzare nel filtro. Se è selezionato "Uguale", l'azione tenterà di trovare la corrispondenza esatta tra i tipi di record. Se è selezionato "Contiene", l'azione tenterà di trovare i tipi di record che contengono quella sottostringa. Se non viene fornito alcun valore in questo parametro, il filtro non verrà applicato.
Numero massimo di tipi di record da restituire Numero intero 50 No Specifica il numero di tipi di record da restituire.

Run On

L'azione non viene eseguita sulle entità e non ha parametri di input obbligatori.

Risultati dell'azione

Risultato script
Nome risultato script Opzioni di valore
is_success is_success=False
is_success is_success=True
Bacheca casi
Tipo di risultato Valore/Descrizione Tipo (entità/generale)
Messaggio di output*

L'azione non deve non riuscire né interrompere l'esecuzione di un playbook:
se è stato trovato almeno un record (is_success = true): "Successfully listed available record types based on the provided criteria in BMC Helix Remedyforce.

Se non è stato trovato nulla(is_success=true): "Non sono stati trovati tipi di record in base ai criteri forniti in BMC Helix Remedyforce"

L'azione deve non riuscire e interrompere l'esecuzione di un playbook:
se si verifica un errore irreversibile, ad esempio credenziali errate, nessuna connessione al server, altro:"Error executing action "List Record Types". Motivo: {0}''.format(error.Stacktrace)

Generale
Bacheca casi

Nome:tipi di record disponibili

Colonne:

Nome

Etichetta

Personalizzato

Generale

Dindin

Descrizione

Verifica la connettività a BMC Helix Remedyforce con i parametri forniti nella pagina di configurazione dell'integrazione nella scheda Google Security Operations Marketplace.

Run On

Questa azione non viene eseguita sulle entità.

Risultati dell'azione

Risultato script
Nome risultato script Opzioni di valore
is_success is_success=False
is_success is_success=True
Bacheca casi
Tipo di risultato Valore/Descrizione Tipo (entità/generale)
Messaggio di output*

L'azione non deve non riuscire né interrompere l'esecuzione di un playbook:
se l'operazione va a buon fine: "Connessione al server BMC Helix Remedyforce riuscita con i parametri di connessione forniti."

L'azione dovrebbe non riuscire e interrompere l'esecuzione di un playbook:
se non va a buon fine: "Failed to connect to the BMC Helix Remedyforce server! Error is {0}".format(exception.stacktrace)

Generale

Aggiorna record

Descrizione

Aggiorna il record in BMC Helix Remedyforce.

Parametri

Nome visualizzato del parametro Tipo Valore predefinito È obbligatorio Descrizione
Tipo di record Stringa N/D Specifica il tipo di record da aggiornare. Se non sai quali tipi di record sono disponibili, esegui l'azione "Elenca tipi di record".
ID record Stringa N/D Specifica l'ID del record da aggiornare.
Campi da aggiornare JSON

{

"field":"value"

}

Specifica un oggetto JSON contenente tutti i campi e i valori necessari da aggiornare.

Run On

L'azione non viene eseguita sulle entità e non ha parametri di input obbligatori.

Risultati dell'azione

Risultato script
Nome risultato script Opzioni di valore
is_success is_success=False
is_success is_success=True
Bacheca casi
Tipo di risultato Valore/Descrizione Tipo (entità/generale)
Messaggio di output*

L'azione non deve non riuscire né interrompere l'esecuzione di un playbook:
se 204 (is_success = true): "Successfully updated {record type} record with {record id} in BMC Helix Remedyforce.".

L'azione deve non riuscire e interrompere l'esecuzione di un playbook:
se si verifica un errore irreversibile, ad esempio credenziali errate, nessuna connessione al server, altro: "Error executing action "Update Record". Motivo: {0}''.format(error.Stacktrace)

Se 404 o 400: "Errore durante l'esecuzione dell'azione "Aggiorna record". Motivo: {message}.

Se il tipo di record non è stato trovato:errore durante l'esecuzione dell'azione "Aggiorna record". Motivo: {Record Type} non è stato trovato in BMC Helix Remedyforce. Utilizza l'azione "Elenca tipi di record" per ottenere un elenco dei tipi di record disponibili.

Se il payload JSON non è valido: "Error executing action "Update Record". Motivo: payload JSON non valido fornito nel parametro "Campi da aggiornare". Controlla la struttura.

Generale

Attendi l'aggiornamento dei campi

Descrizione

Attendi l'aggiornamento dei campi in BMC Helix Remedyforce.

Parametri

Nome visualizzato del parametro Tipo Valore predefinito È obbligatorio Descrizione
Tipo di record Stringa N/D Specifica il tipo di record per cui stai aspettando un aggiornamento. Se non sai quali tipi di record sono disponibili, esegui l'azione "Elenca tipi di record".
ID record Stringa N/D Specifica l'ID del record da aggiornare.
Campi da controllare JSON

{

"field":"value"

}

Specifica un oggetto JSON contenente tutti i campi e i valori necessari.
Errore in caso di timeout Casella di controllo Selezionata Se abilitata, l'azione non verrà completata se non tutti i campi sono stati aggiornati.

Run On

L'azione non viene eseguita sulle entità e non ha parametri di input obbligatori.

Risultati dell'azione

Risultato script
Nome risultato script Opzioni di valore
is_success is_success=False
is_success is_success=True
Risultato 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
}
Bacheca casi
Tipo di risultato Valore/Descrizione Tipo (entità/generale)
Messaggio di output*

L'azione non deve non riuscire né interrompere l'esecuzione di un playbook:
se 201 (is_success = true): "{record type} record with ID {record id} was updated in BMC Helix Remedyforce.".

Se uno dei campi non è stato aggiornato e l'opzione Fail if timeout non è attivata (is_success=false): "I seguenti campi non sono stati aggiornati per il record {record type} con ID {record id} in BMC Helix Remedyforce: {fields that were not updated}"

Messaggio asincrono: in attesa dell'aggiornamento dei seguenti campi per il record {record type} con ID {record id} in BMC Helix Remedyforce: {fields that were not updated}

L'azione deve non riuscire e interrompere l'esecuzione di un playbook:
se si verifica un errore irreversibile, ad esempio credenziali errate, nessuna connessione al server, altro: "Error executing action "Wait For Fields Update". Motivo: {0}''.format(error.Stacktrace)

Se alcuni campi non sono stati trovati: "Errore durante l'esecuzione dell'azione "Attendi l'aggiornamento dei campi". Motivo: i seguenti campi non sono stati trovati nella struttura del record: {fields that were not found}.

Se il tipo di record non è stato trovato:errore durante l'esecuzione dell'azione "Attendi aggiornamento campi". Motivo: {Record Type} non è stato trovato in BMC Helix Remedyforce. Utilizza l'azione "Elenca tipi di record" per ottenere un elenco dei tipi di record disponibili.

Se uno dei campi non è stato aggiornato e l'opzione Non riuscita se timeout è abilitata (is_success=false): "Errore durante l'esecuzione dell'azione "Attendi l'aggiornamento dei campi". Motivo: i seguenti campi non sono stati aggiornati per il record {record type} con ID {record id} in BMC Helix Remedyforce: {fields that were not updated}"

Se il payload JSON non è valido: "Errore durante l'esecuzione dell'azione "Attendi aggiornamento campi". Motivo: payload JSON non valido fornito nel parametro "Campi da controllare". Controlla la struttura.

Generale

Connettore

BMC Helix Remedyforce - Incidents Connector

Descrizione

Recupera informazioni sugli incidenti da BMC Helix Remedyforce.

Configura il connettore BMC Helix Remedyforce - Incidents in Google SecOps

Per istruzioni dettagliate su come configurare un connettore in Google SecOps, vedi Configurazione del connettore.

Parametri del connettore

Utilizza i seguenti parametri per configurare il connettore:

Nome visualizzato del parametro Tipo Valore predefinito È obbligatorio Descrizione
Nome campo prodotto Stringa Nome prodotto Inserisci il nome del campo di origine per recuperare il nome del campo prodotto.
Nome campo evento Stringa BMCServiceDesk__Type__c Inserisci il nome del campo di origine per recuperare il nome del campo evento.
Nome campo ambiente Stringa "" No

Descrive il nome del campo in cui è memorizzato il nome dell'ambiente.

Se il campo dell'ambiente non viene trovato, l'ambiente è quello predefinito.

Pattern regex ambiente Stringa .* No

Un pattern regex da eseguire sul valore trovato nel campo "Nome campo ambiente".

Il valore predefinito è .* per acquisire tutto e restituire il valore invariato.

Utilizzato per consentire all'utente di manipolare il campo dell'ambiente tramite la logica delle espressioni regolari.

Se il pattern regex è null o vuoto oppure il valore dell'ambiente è null, il risultato finale dell'ambiente è l'ambiente predefinito.

Timeout dello script (secondi) Numero intero 180 Limite di timeout per il processo Python che esegue lo script corrente.
Root API Stringa https://.my.salesforce.com Radice API dell'istanza BMC Helix Remedyforce.
Nome utente Stringa N/D Nome utente BMC Helix Remedyforce.
Password Password N/D Password di BMC Helix Remedyforce.
Priorità minima di recupero Numero intero 5 No La priorità più bassa che verrà utilizzata per recuperare gli incidenti. Massimo: 5. Minimo: 1. Se non viene fornito alcun valore, il connettore inserirà tutti gli incidenti.
Importa incidenti con priorità vuota Casella di controllo Selezionata No Se abilitato, il connettore recupererà gli incidenti senza priorità. Gli avvisi Google SecOps creati in questo modo avranno la priorità impostata su "Informativo".
Tipo di filtro CSV Incident,Service Request No Filtro per tipo per gli incidenti. Se non viene fornito alcun valore, il connettore inserirà tutti gli incidenti. Esempio: incidente, richiesta di servizio.
Ore massime indietro Numero intero 1 No Numero di ore da cui recuperare gli incidenti.
Numero massimo di incidenti da recuperare Numero intero 10 No Numero di incidenti da elaborare per un'iterazione del connettore. Il valore massimo è 200.
Utilizzare la lista consentita come lista nera Casella di controllo Selezionata Se questa opzione è abilitata, la lista consentita verrà utilizzata come lista bloccata.
Verifica SSL Casella di controllo Selezionata Se abilitato, verifica che il certificato SSL per la connessione al server BMC Helix Remedyforce sia valido.
Indirizzo del server proxy Stringa N/D No L'indirizzo del server proxy da utilizzare.
Nome utente proxy Stringa N/D No Il nome utente del proxy con cui eseguire l'autenticazione.
Password proxy Password N/D No La password del proxy per l'autenticazione.
ID client Stringa N/D No ID client BMC Helix Remedyforce dell'app connessa. Questo parametro è necessario per l'autenticazione OAuth. Nota: questo parametro ha la priorità sull'autenticazione con nome utente e password.
Client secret Password N/D No Il client secret di BMC Helix Remedyforce dell'app connessa. Questo parametro è necessario per l'autenticazione OAuth. Nota: questo parametro ha la priorità sull'autenticazione con nome utente e password.
Root API di accesso Stringa https://login.salesforce.com Radice dell'API utilizzata per l'autenticazione in BMC Helix Remedyforce.

Regole del connettore

Supporto proxy

Il connettore supporta il proxy.

Hai bisogno di ulteriore assistenza? Ricevi risposte dai membri della community e dai professionisti di Google SecOps.