BMC Helix Remedyforce
Versione integrazione: 11.0
Casi d'uso
- Eseguire l'importazione degli incidenti
- 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:
- Vai a Configurazione > Gestore app.
- Premi il pulsante "Nuova app connessa".
- Fornisci "Nome app collegata", "Nome API" ed "Email di contatto".
- "Enable OAuth Settings" (Attiva impostazioni OAuth) deve essere impostato su true.
- Imposta "URL di callback" su "https://localhost".
- Aggiungi gli ambiti "full" e "refresh_token". Entrambi sono necessari per accedere all'API.
- Salva l'app.
- 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.
- Vai all'azione "Recupera codice di autorizzazione OAuth". "URL di reindirizzamento" è "URL callback".
- 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 "=".
- Vai all'azione "Ottieni token di aggiornamento OAuth". "URL di reindirizzamento" è "URL di callback" e "Codice di autorizzazione" è il "codice" della richiesta precedente.
- Se tutto è stato eseguito correttamente, nel risultato JSON verrà visualizzato "refresh_token".
- 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 | Sì | 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 | Sì | 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 | Sì | 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 | Sì | 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" } |
Sì | 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:
L'azione deve non riuscire e interrompere l'esecuzione di un playbook:
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 | Sì | 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 | Sì | 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 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 | Sì | 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 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:
|
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 | Sì | 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 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:
|
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 | Sì | 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 | Sì | 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 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 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 | Sì | 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 |
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 | Sì | Specifica l'URL di reindirizzamento utilizzato al momento della creazione dell'app connettore. |
Codice di autorizzazione | Stringa | N/D | Sì | 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:
L'azione deve non riuscire e interrompere l'esecuzione di un playbook:
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 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:
|
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:
L'azione dovrebbe non riuscire e interrompere l'esecuzione di un playbook:
|
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 | Sì | 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 | Sì | Specifica l'ID del record da aggiornare. |
Campi da aggiornare | JSON | { "field":"value" } |
Sì | 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:
L'azione deve non riuscire e interrompere l'esecuzione di un playbook:
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 | Sì | 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 | Sì | Specifica l'ID del record da aggiornare. |
Campi da controllare | JSON | { "field":"value" } |
Sì | Specifica un oggetto JSON contenente tutti i campi e i valori necessari. |
Errore in caso di timeout | Casella di controllo | Selezionata | Sì | 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 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 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 | Sì | Inserisci il nome del campo di origine per recuperare il nome del campo prodotto. |
Nome campo evento | Stringa | BMCServiceDesk__Type__c | Sì | 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 | Sì | Limite di timeout per il processo Python che esegue lo script corrente. |
Root API | Stringa | https://.my.salesforce.com | Sì | Radice API dell'istanza BMC Helix Remedyforce. |
Nome utente | Stringa | N/D | Sì | Nome utente BMC Helix Remedyforce. |
Password | Password | N/D | Sì | 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 | Sì | Se questa opzione è abilitata, la lista consentita verrà utilizzata come lista bloccata. |
Verifica SSL | Casella di controllo | Selezionata | Sì | 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 | Sì | 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.