Pianifica un trasferimento ServiceNow

Anteprima

Questa funzionalità è soggetta ai "Termini delle Offerte pre-GA" nella sezione Termini generali del servizio dei Termini specifici dei servizi. Le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per saperne di più, consulta le descrizioni della fase di lancio.

Nota: per ricevere assistenza o fornire un feedback su questa funzionalità, contatta [e-mail].

BigQuery Data Transfer Service for ServiceNow consente di pianificare e gestire automaticamente i job di caricamento ricorrenti da ServiceNow a BigQuery.

Limitazioni

I trasferimenti di ServiceNow sono soggetti alle seguenti limitazioni:

• L'esecuzione di trasferimenti simultanei sulla stessa istanza ServiceNow non è consigliata.
• L'intervallo minimo tra trasferimenti ricorrenti è di 15 minuti. L'intervallo predefinito per un bonifico ricorrente è di 24 ore.

• ServiceNow trasferisce tabelle relative alle aziende da tre applicazioni: Approvvigionamento, Catalogo dei prodotti e Gestione dei contratti. Puoi trasferire le seguenti tabelle:

  • ast_contract
  • clm_condition_check
  • clm_condition_checker
  • clm_contract_history
  • clm_m2m_contract_and_terms
  • clm_m2m_contract_asset
  • clm_m2m_contract_user
  • clm_m2m_rate_card_asset
  • clm_terms_and_conditions
  • pc_hardware_cat_item
  • pc_product_cat_item
  • pc_software_cat_item
  • pc_vendor_cat_item
  • proc_po
  • proc_po_item
  • proc_rec_slip
  • proc_rec_slip_item

Prima di iniziare

Prima di creare un trasferimento ServiceNow, effettua le seguenti configurazioni per ServiceNow e BigQuery.

Prerequisiti di ServiceNow

• Per accedere alle API ServiceNow, crea credenziali OAuth.

• Le seguenti applicazioni ServiceNow devono essere tutte abilitate nell'istanza ServiceNow:

  • Approvvigionamento
  • Catalogo dei prodotti
  • Gestione dei contratti

Prerequisiti BigQuery

• Completa tutte le azioni necessarie per attivare BigQuery Data Transfer Service.
• Crea un set di dati BigQuery per l'archiviazione dei dati.
• Se intendi configurare le notifiche di esecuzione del trasferimento per Pub/Sub, assicurati di disporre dell'autorizzazione pubsub.topics.setIamPolicy Identity and Access Management (IAM). Se configuri solo le notifiche via email, le autorizzazioni Pub/Sub non sono necessarie. Per ulteriori informazioni, consulta Notifiche di esecuzione di BigQuery Data Transfer Service.

Ruoli BigQuery obbligatori

Per ottenere le autorizzazioni necessarie per creare un trasferimento, chiedi all'amministratore di concederti il ruolo IAM Amministratore BigQuery (roles/bigquery.admin). Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso.

Questo ruolo predefinito contiene le autorizzazioni necessarie per creare un trasferimento. Per visualizzare le autorizzazioni esatte necessarie, espandi la sezione Autorizzazioni richieste:

Autorizzazioni obbligatorie

Per creare un trasferimento sono necessarie le seguenti autorizzazioni:

• bigquery.transfers.update per l'utente
• bigquery.datasets.get sul set di dati di destinazione
• bigquery.datasets.update sul set di dati di destinazione

Potresti anche essere in grado di ottenere queste autorizzazioni con i ruoli personalizzati o altri ruoli predefiniti.

Configura un trasferimento di dati ServiceNow

I trasferimenti di dati di ServiceNow possono essere creati nella console Google Cloud o nello strumento a riga di comando bq.

Console

1. Nella console Google Cloud, vai alla pagina BigQuery.

   Vai a BigQuery

2. Fai clic su Trasferimenti di dati > Crea un trasferimento.

3. Nella sezione Tipo di origine, per Origine, seleziona ServiceNow.

4. Nella sezione Nome configurazione di trasferimento, in Nome visualizzato, inserisci un nome per il trasferimento.

5. Nella sezione Opzioni di pianificazione, procedi nel seguente modo:

   • Nell'elenco Frequenza di ripetizione, seleziona un'opzione per specificare la frequenza di esecuzione di questo trasferimento. Per specificare una frequenza di ripetizione personalizzata, seleziona Personalizzata. Se selezioni On demand, questo trasferimento viene eseguito quando attivi manualmente il trasferimento.

   • Se applicabile, seleziona Inizia ora o Inizia all'ora impostata e specifica una data di inizio e un'ora di esecuzione.

6. Nella sezione Impostazioni destinazione, per Set di dati, seleziona il set di dati creato per archiviare i dati.

7. Nella sezione Dettagli origine dati, procedi nel seguente modo:

   • In ID istanza, inserisci l'ID istanza ServiceNow. Puoi recuperarlo dal tuo URL ServiceNow, ad esempio https://INSTANCE_ID.service-now.com.
   • In Nome utente, inserisci il nome utente ServiceNow da utilizzare per la connessione.
   • In Password, inserisci la password ServiceNow.
   • In ID client, inserisci l'ID client delle tue credenziali OAuth. Per generare le credenziali, consulta Creare credenziali OAuth.
   • In Client secret, inserisci il client secret dalle tue credenziali OAuth.
   • Per Tipo di valore, scegli una delle seguenti opzioni:
     • Per trasferire i valori archiviati nel database, scegli Effettivo.
     • Per trasferire i valori visualizzati delle colonne, scegli Display.

8. Nel menu Account di servizio, seleziona un account di servizio dagli account di servizio associati al tuo progetto Google Cloud. L'account di servizio selezionato deve disporre dei ruoli richiesti per eseguire questo trasferimento.

   Se hai eseguito l'accesso con un'identità federata, è necessario un account di servizio per creare un trasferimento. Se hai eseguito l'accesso con un Account Google, un account di servizio per il trasferimento è facoltativo.

   Per maggiori informazioni sull'utilizzo degli account di servizio con trasferimenti di dati, consulta Utilizzare gli account di servizio.

9. (Facoltativo) Nella sezione Opzioni di notifica, segui questi passaggi:

   • Per abilitare le notifiche via email, fai clic sul pulsante di attivazione/disattivazione Notifica via email. Abilitando questa opzione, l'amministratore dei trasferimenti riceve una notifica via email quando un'esecuzione del trasferimento non va a buon fine.
   • Per abilitare le notifiche dell'esecuzione del trasferimento di Pub/Sub per questo trasferimento, fai clic sul pulsante di attivazione/disattivazione Notifiche Pub/Sub. Puoi selezionare il nome dell'argomento o fare clic su Crea un argomento per crearne uno.

10. Fai clic su Salva.

bq

Inserisci il comando bq mk e fornisci il flag di creazione del trasferimento --transfer_config:

bq mk \
    --transfer_config \
    --project_id=PROJECT_ID \
    --data_source=DATA_SOURCE \
    --display_name=DISPLAY_NAME \
    --target_dataset=DATASET \
    --params='PARAMETERS'

Sostituisci quanto segue:

• PROJECT_ID (facoltativo): l'ID del tuo progetto Google Cloud. Se non viene specificato un ID progetto, viene utilizzato il progetto predefinito.
• DATA_SOURCE: l'origine dati (ad esempio, servicenow).
• DISPLAY_NAME: il nome visualizzato per la configurazione di trasferimento. Il nome del trasferimento può essere qualsiasi valore che ti consenta di identificare il trasferimento se devi modificarlo in seguito.
• DATASET: il set di dati di destinazione per la configurazione del trasferimento.

• PARAMETERS: i parametri per la configurazione di trasferimento creata in formato JSON. Ad esempio: --params='{"param":"param_value"}'. Di seguito sono riportati i parametri per un trasferimento ServiceNow:

  	Parametro ServiceNow	Obbligatorio o facoltativo	Descrizione
  connector.instanceId	Obbligatorio	ID istanza dell'istanza ServiceNow
  connector.authentication.username	Obbligatorio	Nome utente delle credenziali
  connector.authentication.password	Obbligatorio	Password delle credenziali
  connector.authentication.oauth.clientId	Obbligatorio	ID client del OAuth generato
  connector.authentication.oauth.clientSecret	Obbligatorio	Client secret del OAuth generato
  connector.valueType	Facoltativo	Actual o Display (valore predefinito: Actual)

  Ad esempio, il seguente comando crea un trasferimento ServiceNow nel progetto predefinito con tutti i parametri richiesti:

    bq mk \
      --transfer_config \
      --target_dataset=mydataset \
      --data_source=servicenow \
      --display_name='My Transfer' \
      --params='{"connector.authentication.oauth.clientId": "1234567890",
          "connector.authentication.oauth.clientSecret":"ABC12345",
          "connector.authentication.username":"user1",
          "Connector.authentication.password":"abcdef1234",
          "connector.instanceId":"https://dev-instance.service-now.com"}'
  

API

Utilizza il metodo projects.locations.transferConfigs.create e fornisci un'istanza della risorsa TransferConfig.

Risolvere i problemi di trasferimento

Per saperne di più, vedi Risolvere i problemi relativi alle configurazioni di trasferimento.

Trasferimento non riuscito a causa dell'abilitazione di ServiceNow

Si verifica un problema che causa la mancata riuscita dei trasferimenti quando le applicazioni Procurement, Catalogo dei prodotti o Gestione dei contratti non sono abilitate in ServiceNow. Per risolvere il problema, abilita tutte e tre le applicazioni. Ad esempio, attiva Approvvigionamento.

Si è verificato un problema durante l'esecuzione del trasferimento

Si è verificato un problema a causa del quale l'esecuzione del trasferimento non viene creata come previsto. Per risolvere il problema:

• Verifica che le credenziali dell'account ServiceNow, ad esempio i valori Nome utente, Password, ID client e Client secret, siano valide.
• Verifica che l'ID istanza sia l'ID valido della tua istanza ServiceNow.

Prezzi

Non è previsto alcun costo per trasferire i dati di ServiceNow in BigQuery mentre questa funzionalità è in Anteprima.

Passaggi successivi

• Per una panoramica di BigQuery Data Transfer Service, consulta Introduzione a BigQuery Data Transfer Service.
• Per informazioni sull'utilizzo dei trasferimenti, tra cui il recupero di informazioni su una configurazione di trasferimento, l'elenco delle configurazioni di trasferimento e la visualizzazione della cronologia delle esecuzioni di un trasferimento, vedi Utilizzo dei trasferimenti.
• Scopri come caricare dati con le operazioni cross-cloud.