Procedura: Configurare le origini dati NetSuite
È possibile utilizzare l'integrazione per estrarre informazioni dall'istanza NetSuite.
Adaptive Planning
gli utenti possono accedere ai dati in un'istanza NetSuite tramite l'adattatore NetSuite.Per configurare un'origine dati NetSuite, attenersi alla seguente procedura:
- Accedere aIntegrazione > Progettazione integrazioni.
- Espandere la cartellaOrigini datinellaLibreria dei componenti.L'origine dati NetSuite è oggetto di una licenza separata. Se questo adattatore non viene visualizzato nell'elenco delle origini dati, aprire un ticket in Workday Customer Center.
- Fare clic sull'origine dati NetSuite.L'area centrale della schermata mostra le impostazioni della nuova origine dati e altre informazioni.
- Immettere le informazioni dell'origine dati:
- Abilitare autenticazione basata su token:questa opzione è selezionata per impostazione predefinita quando si esegue l'aggiornamento alla versione più recente di NetSuite. Richiede la selezione di credenziali NetSuite che contenganouna chiave consumer, una chiave privata consumer, un ID tokene unachiave privata tokengenerati da un amministratore NetSuite nell'interfaccia utente di NetSuite.
- Credenziale:selezionare credenziali NetSuite che contengonouna chiave consumer, una chiave privata consumer, un ID tokene unachiave privata tokengenerati da un amministratore NetSuite nell'interfaccia utente di NetSuite. Per informazioni su come configurare le credenziali NetSuite, fare clic qui.
- Fuso orario account: selezionare il fuso orario appropriato per l'account nell'elenco a discesa. Il fuso orario selezionato qui deve essere lo stesso utilizzato nell'interfaccia utente di NetSuite per l'account utente corrente. In NetSuite, accedere aHome > Set Preferences > Localization.
- Durata batch recupero informazioni: selezionare la durata del batch di recupero informazioni. Il valore predefinito è una settimana (168 ore). Questo valore indica il numero di ore di dati estratti durante un singolo aggiornamento da una tabella NetSuite importata in modalità differenziale. È possibile impostare la suddivisione in blocchi in modo che l'utilità di pianificazione mantenga un equilibrio tra job in batch grandi e piccoli. Ridurre questo valore se si hanno grandi quantità di dati NetSuite. Più piccolo è il valore, maggiore sarà il numero di cicli di recupero informazioni necessari per un determinato periodo di calendario.Il valore specifico immesso dipende in larga misura da una serie di variabili specifiche del sito, come le dimensioni dei job, il rapporto tra job piccoli e grandi, i tempi di elaborazione e le risorse di sistema.
- Livello registro:selezionare un livello di registro dall'elenco a discesa per specificare i dettagli della registrazione per questa origine dati. Le opzioni disponibili sono:
- Errore: registra solo gli errori gravi.
- Info: registra tutte le informazioni di base, ad esempio quando è stata aggiornata l'origine dati.
- Dettagli: fornisce informazioni dettagliate su tutte le fasi e le azioni. Questo livello viene utilizzato principalmente per il debug o la verifica, perché può aggiungere al registro una quantità di informazioni eccessiva.
- Fare clic suSalvanel menu Azioni.
È possibile testare le informazioni di connessione nel nuovo agente facendo clic su
Test di connessione
nel menu Azioni. Il sistema tenta di connettersi a NetSuite utilizzando le informazioni presenti nei campi dell'origine dati. Se il sistema riesce a connettersi a NetSuite, fare clic su OK
. In caso di problemi di connessione, aprire un ticket in Workday Customer Center.Quando è possibile connettersi a NetSuite, è possibile importare la struttura dati. La struttura visualizza le tabelle e le colonne in NetSuite.
Importare la struttura da origini dati NetSuite
- Fare clic suImporta strutturanel menuAzioni. Le tabelle e le colonne vengono visualizzate nel menuComponenti dati.
I dati vengono sincronizzati per un account utente NetSuite come segue:
- L'integrazione sceglie il metodo di sincronizzazione ottimale.
- L'integrazione tenta inizialmente di recuperare i dati in modo incrementale.
- Se l'origine dati sottostante non supporta il recupero dei dati incrementale, l'integrazione esegue un aggiornamento completo dei dati nell'area di gestione temporanea.
Importazione struttura e tabella Riepilogo transazioni di registrazione Adaptive per NetSuite
L'integrazione include una tabella introduttiva per NetSuite, la tabella
AdaptivePostingTransactionSummary
.AdaptivePostingTransactionSummary
e le tabelle associate vengono visualizzate per impostazione predefinita durante la fase Importazione struttura
. Questa tabella mostra gli elementi di dati richiesti più di frequente da un sistema di origine NetSuite. La tabella crea automaticamente join tra la tabella PostingTransactionSummary
e le tabelle associate. Di conseguenza, vengono visualizzati i nomi descrittivi per le categorie NetSuite richieste più di frequente:
- Account
- Classification
- Items
- Department
- Location
- Subsidiary
- Customer
Per ogni tabella viene inclusa la colonna Nome. La colonna
Tipo di conto
viene abilitata automaticamente dalla scheda Conti
. Le tabelle delle categorie vengono importate automaticamente durante l'esecuzione di Importazione struttura
.Potrebbe essere necessario escludere i tipi di conto non necessari utilizzando un filtro SQL nel Caricatore di pianificazione, come descritto in Creare un filtro SQL.
È anche possibile scegliere di rimuovere una o più dimensioni predefinite disponibili nella tabella congiunta. Includere solo le categorie necessarie per il modello. Tutte le altre categorie vanno rimosse dal join e la colonna sottostante va esclusa dall'importazione da PostingTransactionsSummary.
Aggiungere tabelle a un'origine dati NetSuite
Dopo aver importato la struttura dei dati, è possibile specificare le informazioni che si desidera importare. Un insieme standard di tabelle NetSuite è già abilitato. Se si desidera trasferire tabelle aggiuntive, utilizzare la sezione Tabelle da importare della schermata per configurare i dati NetSuite che verranno importati.
Per specificare le tabelle da importare dall'account utente, attenersi alla seguente procedura:
- Espandere la voce corrispondente all'origine dati nel menuComponenti dati.Ogni tabella viene visualizzata come voce separata.
- Trascinare e rilasciare le tabelle che si desidera importare nella sezione Tabelle da importare, al centro dello schermo.Ogni volta che si trascina una tabella nella sezione Tabelle da importare, viene visualizzata una scheda per la tabella, mentre le informazioni visualizzate nella sezione Tabelle da importare mostrano il tipo di informazioni aggiunte. La scheda di ciascuna tabella include anche un menu a discesa, al quale è possibile accedere facendo clic sulla freccia accanto al nome.
Gestire le colonne
Se una tabella in uso ha un numero di colonne elevato, è possibile utilizzare Gestisci colonne per apportare modifiche rapide alle colonne da importare. La finestra di dialogo Gestisci colonne mostra le colonne presenti in una tabella, e consente di selezionare o deselezionare le colonne da importare.
Per gestire le colonne per l'importazione, attenersi alla seguente procedura:
- Fare clic sulla freccia nella scheda a destra del nome della tabella.
- Fare clic su Gestisci colonne nel menu mobile.
- Per importare una colonna, selezionare la casella accanto alla colonna.Quando si seleziona una colonna, dopo il salvataggio del contenuto del popup la colonna viene visualizzata anche nella finestra di anteprima. Se si deseleziona una colonna, questa viene rimossa dalla finestra di anteprima.Non è possibile modificare lo stato dell'importazione nei campi generati dal sistema, ad esempio isDeleted.È possibile modificare lo stato dell'importazione nelle singole colonne:
- Selezionando le proprietà della colonna e impostando la proprietà
- Trascinando nel designer le colonne selezionate
Personalizzare le tabelle
Per ogni tabella, è possibile personalizzare la modalità di importazione dei dati.
Per personalizzare le impostazioni della tabella, attenersi alla seguente procedura:
- Fare clic sulla freccia nella scheda a destra del nome della tabella.
- Fare clic suImpostazioni tabellanel menu mobile.
- Immettere le impostazioni della tabella:
- Modalità di importazione dati:l'elenco a discesa contiene una sola opzione:
- Origine dati per selezionare automaticamente il migliore approccio di sincronizzazione. Si tratta dell'impostazione predefinita. L'origine dati esamina NetSuite e utilizza automaticamente la modalità ottimale per la sincronizzazione dei dati nell'area di gestione temporanea con le informazioni in NetSuite. Alcune tabelle vengono lette completamente ogni volta, mentre per altre viene utilizzato l'aggiornamento differenziale.
- Filtro importazione dati:consente di immettere un'espressione SQL per filtrare o formattare le informazioni da importare. Il filtro SQL viene applicato prima che i dati vengano estratti da NetSuite al fine di ridurre il volume di dati da importare, e offre un ulteriore livello di controllo sui dati da inserire nell'area di gestione temporanea. Fare clic sul campo per visualizzare la finestra di dialogo Modifica espressione SQL. Il filtro immesso qui viene applicato ai dati effettivi in NetSuite, anziché ai dati di anteprima nell'area di gestione temporanea. Non tutte le origini dati supportano lo stesso livello di funzionalità di filtro SQL.
- Parametro periodo:le tabelle NetSuitePostingTransactionBalanceePostingTransactionSummaryimport per impostazione predefinita e richiedono la configurazione di un parametro periodo prima dell'importazione. Se si sceglie di importare il fileConsolidatedExchangeRateoBudgetExchangeRatetabelle, richiedono anche la configurazione di un parametro periodo. Se non si configura un parametro periodo per queste tabelle, l'importazione ha esito negativo e viene visualizzato il messaggio seguente:Required parameter is not configuredNetSuite ha una capacità di filtro non SQL molto limitata. Supporta solo espressioni molto semplici.
- Fare clic suApplicaper applicare le impostazioni.
- Ripetere i passaggi da 1 a 3 per ciascuna tabella.
- Fare clic suSalvaper salvare le impostazioni nell'origine dati.
Impostare le opzioni per le colonne
Durante l'utilizzo delle tabelle da importare, è possibile visualizzare un'anteprima dei dati nello stato in cui si trovano nell'origine dati oppure nell'area Gestione temporanea dopo l'importazione. È possibile modificare le opzioni per ogni colonna passando il puntatore del mouse sull'intestazione della colonna e facendo clic sull'elenco a discesa accanto al nome:
- Ordinamento crescente:consente di ordinare l'intera tabella in ordine crescente in base a questa colonna.
- Ordinamento decrescente:consente di ordinare l'intera tabella in ordine decrescente in base a questa colonna.
- Impostazioni colonna:questa finestra di dialogo consente di modificare le proprietà della colonna all'interno della tabella di gestione temporanea.
- Nome:il nome della colonna, visualizzato nell'intestazione.
- Tipo di colonna:il tipo di dati utilizzati nella colonna.
- Converti tipo di colonna:selezionare il nuovo tipo da questo menu a discesa.
- Escludi colonna dall'importazione:selezionare questa opzione per rimuovere la colonna dai dati da importare.
- Elimina colonna:selezionare questa opzione per eliminare la colonna. L'opzione è disponibile solo per le colonne personalizzate.
Creare colonne query secondaria
Le colonne query secondaria consentono di filtrare le righe di NetSuite in base alle condizioni di un'altra tabella correlata. Ad esempio, è possibile filtrare i record Opportunità di NetSuite in base all'esistenza di uno o più record Preventivo.
È possibile utilizzare le colonne query secondaria per:
- Selezionare la tabella/colonna principale e la tabella/colonna correlata.
- Verificare la presenza di determinate condizioni nelle tabelle correlate.
- Inserire i valori appropriati nella tabella principale in base ai risultati di tali controlli.
Per ogni tabella è possibile personalizzare la modalità di importazione dei dati.
Per creare una colonna query secondaria:
- Espandere la cartella Colonna personalizzata nell'origine dati nel menu Componenti dati.
- Trascinare il componente Colonna query secondaria nella sezione Tabelle da importare al centro dello schermo.
- Immettere le impostazioni della colonna:
- Nome:immettere il nome della colonna query secondaria.
- Tipo di colonna:questo campo di sola visualizzazione identifica la colonna come colonna booleana.
- Tabella correlata:selezionare una tabella correlata da utilizzare per il confronto.
- Espressione join:fare clic su questo campo per immettere una condizione di join. Viene visualizzata la finestra di dialogo Modifica espressione join SQL. Ulteriori informazioni sulla creazione di join SQL sono disponibili in Procedura: Aggiungere tabelle e colonne di join SQL.
- Regola valore join:selezionare una delle opzioni relative al valore di join SQL dall'elenco a discesa: Esistente, Inesistente, Somma, Numero, Minimo o Massimo.
- Fare clic suApplicaper applicare le impostazioni.
- Fare clic suSalvaper salvare le impostazioni nell'origine dati.
Scaricare dati da una tabella di gestione temporanea
È possibile scaricare dati da una singola tabella di gestione temporanea.
Per scaricare i dati da una singola tabella di gestione temporanea, attenersi alla seguente procedura:
- Fare clic sulla freccia giù nell'intestazione di una tabella presente nella sezione Tabelle da importare.
- SelezionareScarica dati.
- Fare clic suInvianell'elenco valoriL'operazione invierà un'e-mail con un URL per scaricare i dati.L'integrazione invia all'account e-mail associato al designer dati un'e-mail contenente un URL.
- Aprire l'e-mail e fare clic sull'URL. I dati vengono scaricati in formato CSV.
Utilizzare il filtro avanzato
Nel menu a discesa Origine è possibile fare clic su Filtro avanzato per visualizzare le opzioni di filtro dei dati nell'area di anteprima Tabelle da importare. Il filtro avanzato include strumenti per visualizzare ed esplorare un sottoinsieme di dati in una tabella di gestione temporanea o direttamente nell'origine remota (se si seleziona NetSuite dal menu a discesa Origine).
L'area di anteprima serve appositamente per visualizzare in anteprima una piccola parte dei dati nell'area di gestione temporanea (o in NetSuite). È possibile esplorare i dati disponibili nel conto Foglio di calcolo e verificare di ottenere i dati previsti esaminando l'area di gestione temporanea. È anche possibile utilizzare questa opzione per perfezionare il filtro di importazione dati che si desidera utilizzare. I filtri impostati nella funzione di anteprima non influiscono sui dati effettivi presenti nell'area di gestione temporanea.
Le opzioni per il Filtro avanzato sono:
- Righe distinte:selezionare questa casella per nascondere le righe duplicate.
- Righe max:inserire un numero nella casella di testo per limitare il numero di righe visualizzate nell'area di anteprima.
- Colonne:selezionare o deselezionare colonne in questo menu a discesa per mostrare o nascondere le colonne visualizzate.
La rimozione di una colonna da questo elenco non comporta la rimozione della colonna dall'elenco di importazione.
- Filtro SQL:fare clic sulla casella di testo grande per visualizzare la finestra di dialogo Modifica espressione SQL, nella quale è possibile specificare un filtro SQL per limitare le righe visualizzate in anteprima. Fare clic su Applica per verificare automaticamente la sintassi SQL del filtro. Se sono presenti errori, l'errore viene indicato nell'espressione. L'espressione immessa viene visualizzata nella pagina Filtro importazione dati. Per informazioni dettagliate sulla sintassi SQL, fare clic qui nella sezione Note. NetSuite ha una capacità di filtro non SQL molto limitata. Supporta solo espressioni molto semplici.
Fare clic su
Rimuovi filtro
(accanto al menu a discesa Origine) per cancellare le impostazioni nella finestra di anteprima. In NetSuite alcune colonne vengono designate come colonne chiave. Queste informazioni vengono riportate nelle tabelle di gestione temporanea. Le informazioni non devono essere modificate.
Importare dati da NetSuite
Dopo aver impostato e salvato l'origine dati NetSuite, è possibile importare i dati.
Per importare dati da NetSuite, procedere come segue:
- Fare clic suImporta datinel menu Azioni. I dati selezionati vengono filtrati in base alle eventuali espressioni SQL e caricati nell'area di gestione temporanea. È possibile visualizzare in anteprima i dati nell'area di gestione temporanea.
I dati rimangono nell'area di gestione temporanea finché non vengono cancellati.
Per cancellare i dati dall'area di gestione temporanea, procedere come segue:
- Fare clic suCancella tabelle di gestione temporaneanel menu Azioni. Viene cancellata l'area di gestione temporanea di tutte le tabelle dell'origine dati.
Procedura consigliata:
quando si importano i tipi di transazione NetSuite, assicurarsi di utilizzare solo i tipi di transazione NetSuitesupportati.Importare ricerche salvate di NetSuite
L'importazione da ricerche salvate di NetSuite è disponibile solo se l'integrazione NetSuite è stata configurata prima del 12 agosto 2024.
Le ricerche salvate possono essere importate solo da adattatori NetSuite. È necessario configurare anche l'autenticazione SSO per questa origine dati.
L'importazione di ricerche salvate richiede la configurazione di una ricerca salvata di NetSuite in Designer dati e la successiva importazione della struttura della ricerca. Le ricerche salvate all'interno dell'integrazione supportano i record personalizzati, i campi personalizzati e i segmenti personalizzati di NetSuite.
Configurare una ricerca salvata in Designer dati
- Fare clic suGestisci ricerche salvatenel menu Azioni.
- Nella finestra di dialogoGestisci ricerche salvate, fare clic sul pulsante delle azioni sotto la struttura ad albero di navigazione e selezionare Aggiungi ricerca salvata oppure fare clic con il pulsante destro del mouse sulla cartella delle ricerche salvate e selezionare Aggiungi ricerca salvata. Assegnare un nome alla ricerca salvata.
- Selezionare ilTipo di record NetSuite.
- Selezionare laricerca salvata di NetSuite.
- Fare clic suApplica.
Importare la struttura di una ricerca salvata
- Nella finestra di dialogo Gestisci ricerche salvate, fare clic su una ricerca salvata creata in precedenza per selezionarla.
- Fare clic sul pulsante delle azioni sotto la struttura ad albero di navigazione e selezionareImporta strutturanel menu Azioni oppure fare clic con il pulsante destro del mouse sulla ricerca salvata e selezionareImporta struttura.
- Al termine dell'importazione della struttura della ricerca salvata, chiudere la finestra di dialogo Gestisci ricerche salvate.
- L'area di gestione temporanea visualizzerà una scheda per ogni struttura di ricerca salvata importata.
Tenere presente che se si fa clic su Importa struttura nel riquadro Azioni, verranno importate tutte le ricerche salvate nel riquadro Componenti dati.
Best practice:
assicurarsi che i risultati dell'importazione della struttura della ricerca salvata non contengano colonne con risultati riepilogativi di NetSuite. Questa è una limitazione dell'API dei servizi Web NetSuite. È possibile importare fino a 1000 ricerche salvate di NetSuite.
Selezionare una modalità di importazione dati per le ricerche salvate di NetSuite
- Nell'area di gestione temporanea, fare clic sull'icona della freccia nella scheda della ricerca salvata di NetSuite corrispondente a una tabella.
- SelezionareImpostazioni tabelladall'elenco a discesa.Sono disponibili due opzioni:
- Tutti i record sostituiti ogni volta che viene eseguita un'importazione dati:questa è l'impostazione predefinita. Con questa opzione, quando viene eseguita l'importazione vengono sostituiti tutti i dati.
- Tutti i record che rientrano in un intervallo di tempo trasmesso:consente di selezionare un intervallo di tempo utilizzando un parametro, quindi di scegliere una colonna di data e ora della tabella della ricerca salvata a cui applicare il parametro. È possibile fare clic suModifica parametriall'interno di questa finestra di dialogo per creare un parametro intervallo di tempo da utilizzare. Se si sceglie di importare un intervallo di tempo, è necessario impostare un parametro periodo, altrimenti l'importazione non riuscirà.
- Fare clic suApplica.
- Fare clic suSalvanel riquadro Azioni.
Importare dati da una ricerca salvata
- Nel riquadro Azioni, fare clic suImporta dati.
- I dati della ricerca salvata di NetSuite vengono importati nell'area di gestione temporanea.
Eliminare ricerche salvate di NetSuite
- Fare clic suGestisci ricerche salvatenel riquadro Azioni.
- Fare clic con il pulsante destro del mouse sulla ricerca salvata in Gestisci ricerche salvate e selezionareElimina. La ricerca salvata viene rimossa dall'elenco Gestisci ricerche salvate, ma la sua struttura rimane nel riquadro Componenti dati e nell'area di gestione temporanea fino a quando non si esegue nuovamente l'importazione della struttura.
Se una ricerca salvata di NetSuite viene eliminata in NetSuite, un messaggio indicherà che non è più disponibile quando si esegue l'azione di importazione della struttura. Se una ricerca salvata già utilizzata per l'importazione dati nell'integrazione viene modificata in NetSuite, non è garantito che le importazioni di dati future abbiano esito positivo.
Best practice:
in NetSuite, creare ricerche salvate appositamente per l'utilizzo nell'integrazione e assegnare loro un nome, in modo che non vengano modificate o eliminate da altri utenti di NetSuite.Best practice:
assicurarsi di disporre delle autorizzazioni di NetSuite appropriate per la visualizzazione dei contenuti restituiti da una ricerca salvata. Se non si dispone dell'autorizzazione per il contenuto, la ricerca non restituirà alcun record e non visualizzerà un messaggio di errore. Questa è una limitazione in NetSuite indicata nella guida in linea: If you reference a saved search for which you do not have the permission, the exception is ignored and fields have no value (are not in the SOAP response at all).
Selezionare file schedario NetSuite per l'importazione
È possibile gestire e selezionare file CSV creati da schedari NetSuite per importarli come tabelle di gestione temporanea.
Drill-through da Adaptive Planning Tornare a NetSuite
Adaptive Planning
Tornare a NetSuite Il drill-through NetSuite è disponibile solo se l'integrazione NetSuite è stata configurata prima del 12 agosto 2024.
È possibile abilitare il drill-through sui dati importati da NetSuite. I collegamenti di drill-through diventeranno disponibili nei fogli e nei report di Planning per gli importi effettivi importati da NetSuite. Per configurare il drill-through per NetSuite, assicurarsi che gli identificatori interni vengano utilizzati nell'ambito della mappatura delle colonne nel caricatore di pianificazione. Sarà necessario configurare un sistema esterno NetSuite e collegarlo a un profilo utilizzato dal caricatore di pianificazione.
Se si configurano più colonne sul lato NetSuite per la mappatura a una singola dimensione di Planning, sarà necessario combinare le colonne NetSuite nell'origine dati utilizzando una colonna SQL tupla.
Per ulteriori dettagli, consultare la sezione Informazioni sulla mappatura dei profili di Creare caricatori dati di Planning.
- Procedura di alto livello per abilitare il drill-through da Planning a NetSuite
- Prima di iniziare, assicurarsi che la casella di controllo Drill-through avanzato basato su pacchetto sia selezionata nel menuIntegrazione > Configurazione di NetSuitedi Planning.Configurare un NetSuiteExternal System, che definisce la mappatura dimensionale.Apportare le rettifiche necessarie all'origine dati per le mappature dimensionali definite.
- Se sono presenti più categorie NetSuite mappate alla stessa dimensione di pianificazione, rivedere l'origine dati NetSuite e aggiungere una colonna SQL tupla per una mappatura molti-a-uno delle colonne.
- In Tabelle da importare, fare clic sulla tabellaRiepilogo transazioni di registrazione Adaptive.
- SelezionareGestisci colonnenell'elenco a discesaRiepilogo transazioni di registrazione Adaptive.
- AbilitaAccountInternalId.
- AbilitareInternalIdsper le altre dimensioni in base alle quali si prevede di eseguire il drill-down.
- Salvare l'origine dati.
Apportare le rettifiche necessarie al caricatore utilizzando le rettifiche dell'origine dati per la mappatura dimensionale.- Una volta completate le impostazioni dell'Origine dati Netsuite sopra, configurare un caricatore dati di Planning per importare i dati degli importi effettivi NetSuite.
- Collegare un profilo al sistema esterno configurato nello step Configurare un sistema esterno NetSuite.
- Allegare questo profilo al caricatore di pianificazione.
- Fare clic sulla schedaMappatura colonne.
- Per la riga Conto:
- Nella colonnaID origineselezionare ilaccountInternalIdcolonna dalla tabella di origine.
- Nella colonnaNome visualizzato di origine, selezionare il nome visualizzato.
- Ripetere il passaggio precedente per tutte le altre dimensioni standard in base alle quali si desidera eseguire il drilling.
- Salvare il caricatore
Una volta completati tutti questi passaggi sarà possibile eseguire il drilling.