Riferimenti: Tabelle origine dati e tipi di dati NetSuite

Adaptive Planning

Tabelle NetSuite supportate

La tabella seguente mostra informazioni sulle tabelle supportate nell'ntegrazione NetSuite. Le colonne della tabella visualizzano le informazioni seguenti:

Tabella dell'integrazione
: nome della tabella visualizzata nell'origine dati dell'integrazione.

Origine
tabella
: nome della tabella utilizzato nel browser schemi di NetSuite.

Accesso
: meccanismo di accesso per ciascuna tabella NetSuite. I tipi sono i seguenti:

Ricerca: l'integrazione recupera tutti i record corrispondenti ai criteri di ricerca che utilizzano l'API specificata. Ricerca vincolata: l'integrazione aggiunge vincoli alla ricerca, oltre a quelli eventualmente imposti da NetSuite.

Recupera tutto: l'integrazione recupera tutti i record che utilizzano l'API specificata.

Differenziale: l'integrazione include solo i dati che sono stati modificati.

Commenti
: commenti relativi alle tabelle.

L'integrazione supporta anche le tabelle NetSuite personalizzate mostrate dall'API dei servizi web NetSuite. È possibile scegliere la tabella/le colonne da importare per ciascuna.

Tabella di integrazione	Origine tabella	Accesso	Commenti
Account	AccountSearchRowBasic	Ricerca
AccountingPeriod	AccountingPeriodSearchRowBasic	Ricerca
AdaptivePostingTransactionSummary			Tabella creata nell'origine dati Integration, non disponibile inNetSuite Si unisce aPostingTransactionTabella di riepilogo con le tabelle di categoria standard (Conto, Periodo, Azienda controllata, Reparto, Classe, Sede, Articolo, Cliente)
AllCustomLists	CustomList	Recupera tutto
Budget	BudgetSearchRowBasic	Ricerca
BudgetExchangeRate	Special:getBudgetExchangeRate	Ricerca vincolata
CalendarEvent	CalendarEventSearchRowBasic	Ricerca
Campaign	CampaignSearchRowBasic	Differenziale
CampaignCategory	CampaignCategory	Recupera tutto
CampaignFamily	CampaignFamily	Recupera tutto
Classification	ClassificationSearchRowBasic	Ricerca
ConsolidatedExchangeRate	Special:getConsolidatedExchangeRate	Ricerca vincolata
Contact	ContactSearchRowBasic	Ricerca
Currency	Currency	Recupera tutto
CustomerCategory	CustomerSearchRowBasic	Differenziale
CustomerStatus	CustomerCategorySearchRowBasic	Ricerca
DeletedRecord	Special: getDeleted	Ricerca vincolata	Non utilizzabile dall'utente finale
Department	DepartmentSearchRowBasic	Ricerca
Employee	EmployeeSearchRowBasic	Differenziale
EntityGroup	EntityGroupSearchRowBasic	Differenziale
ExpenseCategory	ExpenseCategorySearchRowBasic	Ricerca
Item	ItemSearchRowBasic	Differenziale
Job	JobSearchRowBasic	Differenziale
JobStatus	JobStatusSearchRowBasic	Ricerca
JobType	JobTypeSearchRowBasic	Ricerca
Location	LocationSearchRowBasic
NetSuiteServerTime	Special:getServerTime
Opportunità	OpportunitySearchRowBasic
Partner	PartnerSearchRowBasic
PostingTransactionBalance	Speciale:getPostingTransactionSummary	Ricerca vincolata	Tabella creata nell'origine dell'integrazione, non disponibile inNetSuite Questa tabella contiene i saldi di fine periodo.
PostingTransactionSummary	Speciale:getPostingTransactionSummary	Ricerca vincolata
ProjectTask	ProjectTaskSearchRowBasic	Differenziale
PromotionCode	PromotionCodeSearchRowBasic	Ricerca
SalesTaxItem	SalesTaxItem	Recupera tutto
Subsidiary	SubsidiarySearchRowBasic	Ricerca
SupportCase	SupportCaseSearchRowBasic	Differenziale
SupportCasePriority	SupportCasePriority	Recupera tutto
SupportCaseStatus	SupportCaseStatus	Recupera tutto
SupportIssue	IssueSearchRowBasic	Ricerca
SupportSolution	SolutionSearchRowBasic	Ricerca
SupportTopic	TopicSearchRowBasic	Ricerca
Task	TaskSearchRowBasic	Ricerca
TaxGroup	TaxGroup	Recupera tutto
TaxType	TaxType	Recupera tutto
TimeBill	TimeBillSearchRowBasic	Differenziale
Transaction	TransactionSearchRowBasic	Differenziale
Vendor	VendorSearchRowBasic	Differenziale

Tabelle di uso comune nell'integrazione

Le tabelle seguenti sono rese direttamente importabili nell'adattatore NetSuite:

AdaptivePostingTransactionSummary (tabella di origine principale per Planning)

Conto (mappato a

Adaptive Planning

Conti)

Classification (mappatura facoltativa)

Customer (mappatura facoltativa)

Department (mappatura facoltativa)

Items (mappatura facoltativa)

Location (mappatura facoltativa)

Posting Transaction Summary

Azienda controllata (in genere mappata a

Adaptive Planning

Livelli)

Le tabelle AdaptivePostingTransactionSummary e PostingTransactionSummary restituiscono un delta mensile, mentre la tabella PostingTransactionBalance restituisce saldi periodo. Le tabelle AdaptivePostingTransactionSummary e PostingTransactionSummary supportano le categorie standard (Conto, Periodo di tempo, Azienda controllata, Reparto, Classe, Sede, Elemento, Cliente). Se sono necessarie categorie aggiuntive, utilizzare la tabella Transaction.

Tabelle aggiornate in modo differenziale

Nell'origine dati NetSuite corrente, le tabelle seguenti vengono aggiornate in modo differenziale:

Campaign

Cliente

Employee

EntityGroup

Item

Job

Opportunity

Partner

ProjectTask

SupportCase

TimeBill

Transaction

Vendor

Inoltre, tutti i tipi di record personalizzati vengono aggiornati in modo differenziale. Non è possibile utilizzare la colonna della data differenziale nel filtro di importazione dati per le tabelle aggiornate in modo differenziale. Il sistema non impedisce di eseguire questa operazione, ma il meccanismo di aggiornamento differenziale non funziona.

È possibile limitare la quantità di dati importati in una tabella differenziale durante l'esplorazione, ovvero quando si modificano le colonne e le impostazioni dei filtri. Nell'origine dati è presente un meccanismo che impedisce il caricamento completo dei dati differenziali.

La tabella seguente contiene tutte le tabelle differenziali con le loro colonne relative alla data differenziale e di creazione.

Tabella	Colonna data differenziale	Colonna data di creazione
Campaign	LastModifiedDate	CreatedDate
Customer	LastModifiedDate	DateCreated
CustomRecord (*)	LastModified	Created
Employee	LastModifiedDate	CreatedDate
EntityGroup	LastModifiedDate	-- Nessuna --
Item	Modified	Created
Job	LastModifiedDate	DateCreated
Opportunity	LastModifiedDate	DateCreated
Partner	LastModifiedDate	DateCreated
ProjectTask	LastModifiedDate	CreatedDate
SupportCase	LastModifiedDate	CreatedDate
TimeBill	LastModified	DateCreated
Transaction	LastModifiedDate	DateCreated
Vendor	LastModifiedDate	DateCreated

(*) - Si applica a tutti i record personalizzati.

Se si specifica un filtro di tipo maggiore di o maggiore o uguale a nella colonna della data di creazione della tabella, il codice ignora l'importazione completa ed esegue un aggiornamento differenziale a partire dalla data e ora specificate. Questo è utile per limitare i dati importati, perché quando si inizia a esplorare una tabella di grandi dimensioni caricata in modo differenziale, è possibile impostare il filtro in modo da estrarre solo i dati degli ultimi giorni (o settimane). Questo tipo di caricamento è molto rapido. È quindi possibile determinare quali colonne sono necessarie e quali altre condizioni di filtro si desidera utilizzare. Quando il risultato è soddisfacente, è possibile rimuovere il filtro della data di creazione e riavviare il caricamento completo dei dati.

Per alcune tabelle, è possibile che non si desiderino mai record con data precedente a una data determinata. Per tali tabelle, è possibile continuare a utilizzare il filtro della data di creazione con un valore appropriato.

Tipi di dati NetSuite supportati

Quando i dati di NetSuite vengono importati nell'integrazione, il valore type di tali dati deve essere mappato a uno dei tipi di dati supportati dall'integrazione.

Campi di dati NetSuite standard: Per i campi di dati NetSuite standard nelle tabelle di ricerca, vengono utilizzate le mappature seguenti:

Tipo di dati di ricerca standard NetSuite
Tipo di dati dell'integrazione

SearchColumnStringField
Testo

SearchColumnSelectField
Testo

SearchColumnEnumSelectField
Testo

SearchColumnDoubleField
A virgola mobile

SearchColumnBooleanField
Booleano

SearchColumnLongField
Intero

SearchColumnTextNumberField
Testo

SearchColumnDateField
Data/Ora
Campi di dati NetSuite standard nelle tabelle: Per i campi di dati NetSuite standard nelle tabelle (che vengono sempre recuperati completamente), si utilizzano le mappature seguenti:

Tipo di dati standard NetSuite
Tipo di dati dell'integrazione

String
Testo

RecordRef
Testo

Double
Testo

Booleano
A virgola mobile

Long
Booleano

System.DateTimeFloat
Intero
Campi personalizzati: L'origine dati NetSuite supporta un sottoinsieme dei possibili campi personalizzati NetSuite.

I campi personalizzati sono supportati nei tipi di record seguenti:

Campi personalizzati CRM
CalendarEvent
Campaign
SupportCase
SupportIssue
SupportSolution
ProjectTask

Task
Campi entità personalizzati
Contact
Cliente
Employee
Entity Group
Job
Partner
Vendor
Campi elemento personalizzati
Item
Campi transazione personalizzati
Transaction Body
Transaction Column
Transaction Item
Altri campi personalizzati
Conto
Classificazione
Reparto
Sede
PromotionCode

Perché un campo personalizzato venga visualizzato nell'API dei servizi web NetSuite, deve avere l'attributo "STORE VALUE" selezionato.
Tipi di dati dei campi personalizzati: L'integrazione supporta tutti i tipi di dati dei campi personalizzati NetSuite definiti. Tuttavia, poiché l'integrazione implementa internamente solo cinque tipi di dati di base, i tipi di dati dei campi personalizzati NetSuite vengono mappati ai tipi di dati dell'integrazione più appropriati. La mappatura è illustrata nella tabella seguente:

Tipo di dati NetSuite
Tipo di dati dell'integrazione
Commento

_checkBox
A virgola mobile

_currency
Data/Ora

_date
Data/Ora

_decimalNumber
A virgola mobile

_document
Testo
Riferimento a un altro record

_eMailAddress
Testo

_freeFormText
Testo

_help
Testo
StoreValue non impostato.NetSuite non consentirà il recupero di questo tipo.

_hyperlink
Testo

_image
Testo
Riferimento a un altro record

_inlineHTML
Testo

_integerNumber
Intero

_listRecord
Testo
Riferimento a un altro record

_longText
Testo

_multipleSelect
Testo
Riferimento a zero o più altri record di un tipo specifico

_password
Testo

_percent
A virgola mobile

_phoneNumber
Testo

_richText
Testo

_textArea
Testo

_timeOfDay
Data/Ora

Tipo di dati di ricerca standard NetSuite	Tipo di dati dell'integrazione
SearchColumnStringField	Testo
SearchColumnSelectField	Testo
SearchColumnEnumSelectField	Testo
SearchColumnDoubleField	A virgola mobile
SearchColumnBooleanField	Booleano
SearchColumnLongField	Intero
SearchColumnTextNumberField	Testo
SearchColumnDateField	Data/Ora

Tipo di dati standard NetSuite	Tipo di dati dell'integrazione
String	Testo
RecordRef	Testo
Double	Testo
Booleano	A virgola mobile
Long	Booleano
System.DateTimeFloat	Intero

Tipo di dati NetSuite	Tipo di dati dell'integrazione	Commento
_checkBox	A virgola mobile
_currency	Data/Ora
_date	Data/Ora
_decimalNumber	A virgola mobile
_document	Testo	Riferimento a un altro record
_eMailAddress	Testo
_freeFormText	Testo
_help	Testo	StoreValue non impostato.NetSuite non consentirà il recupero di questo tipo.
_hyperlink	Testo
_image	Testo	Riferimento a un altro record
_inlineHTML	Testo
_integerNumber	Intero
_listRecord	Testo	Riferimento a un altro record
_longText	Testo
_multipleSelect	Testo	Riferimento a zero o più altri record di un tipo specifico
_password	Testo
_percent	A virgola mobile
_phoneNumber	Testo
_richText	Testo
_textArea	Testo
_timeOfDay	Data/Ora

Ulteriori informazioni

Le sezioni seguenti includono considerazioni aggiuntive sull'accesso ai dati di NetSuite.

Filtro importazione dati: Ogni campo di una ricerca può avere al massimo un filtro. Al momento dell'esecuzione della query di ricerca, NetSuite combina i filtri con AND.

Solo le tabelle accessibili tramite un meccanismo di tipo "search" possono avere filtri di sincronizzazione impostati.

Inoltre nei filtri di sincronizzazione possono essere utilizzati solo i campi presenti sia in [TableName]SearchRowBasic sia in [TableName]SearchBasic.
Eseguire query direttamente in NetSuite dalla gestione temporanea: Quando si eseguono query direttamente in NetSuite (anziché nei record importati da NetSuite nella gestione temporanea), le espressioni di filtro sono limitate alle funzionalità di NetSuite disponibili tramite i servizi Web.

Quando si eseguono query in NetSuite, è possibile utilizzare filtri di colonna semplici con espressioni di confronto e logiche.
I filtri possono essere combinati con AND, ma non con OR.
Non è consentito l'utilizzo degli operatori (+, -, /, *, $, ||).
Non è possibile utilizzare le funzioni scalari.
Non è possibile utilizzare le istruzioni CASE.
Per applicare un filtro a una colonna personalizzata, è necessario che la colonna personalizzata sia contrassegnata per l'importazione.
Per poter utilizzare alcuni filtri di colonna, è necessario che siano abilitate determinate funzionalità NetSuite.

Alcune tabelle e colonne non supportano l'applicazione di filtri.
Campi esclusi: Alcuni campi NetSuite sono esclusi dall'importazione per vari motivi. La tabella seguente mostra alcuni di questi campi esclusi.

Campo NetSuite
Motivi dell'esclusione

Cliente:ccExpDate
Le informazioni della carta di credito sono escluse per motivi di privacy.

Customer:ccInternalId
Le informazioni della carta di credito sono escluse per motivi di privacy.

Dipendente:socialSecurityNumber
Escluso per motivi di privacy.

SalesTaxItem: zip
Elenco delimitato di codici postali. Questo campo di testo può essere eccessivamente lungo (fino a superare il limite predefinito di 1024 caratteri per un campo di testo) e non è considerato particolarmente utile per le operazioni dell'integrazione.

Transazione:ccExpDate
Le informazioni della carta di credito sono escluse per motivi di privacy.

Campo NetSuite	Motivi dell'esclusione
Cliente:ccExpDate	Le informazioni della carta di credito sono escluse per motivi di privacy.
Customer:ccInternalId	Le informazioni della carta di credito sono escluse per motivi di privacy.
Dipendente:socialSecurityNumber	Escluso per motivi di privacy.
SalesTaxItem: zip	Elenco delimitato di codici postali. Questo campo di testo può essere eccessivamente lungo (fino a superare il limite predefinito di 1024 caratteri per un campo di testo) e non è considerato particolarmente utile per le operazioni dell'integrazione.
Transazione:ccExpDate	Le informazioni della carta di credito sono escluse per motivi di privacy.

Informazioni sui campi: Informazioni aggiuntive sui campi standard e personalizzati di NetSuite:

I campi di testo sono limitati a una dimensione massima di 1024 caratteri.
Le personalizzazioni dei campi standard di NetSuite non sono supportate.
I campi personalizzati nascosti sono visibili. NetSuite li mostra tramite i propri servizi Web.
Nell'integrazione vengono importati solo i campi personalizzati NetSuite con l'attributo "Store Value" impostato.
Ricerche salvate: Per configurare una ricerca salvata di NetSuite, consultare la sezione Importare ricerche salvate di NetSuite in Procedura: Configurare le origini dati NetSuite.
Drill-through da Adaptive Planning Tornare a NetSuite: I clienti possono 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 le sezioni Integrazione sulla mappatura di colonne/dati e profili.

Suggerimenti e best practice

Best practice per configurare Planning per l'importazione di importi effettivi CoGe: Per importare gli importi effettivi CoGe utilizzando la tabella Transazione, impostare i conti CoGe in Planning su Importi effettivi in base a - Delta mensile
. Accedere ad Amministratore conto, selezionare il conto CoGe e visualizzare i dettagli del conto per trovare la sezione Importi effettivi in base a
. In questo metodo, la pianificazione accumula gli importi nei conti dello stato patrimoniale.

Best practice per la gestione dei messaggi di timeout di NetSuite: Uno degli errori che NetSuite può restituire è simile al seguente:

La ricerca è scaduta. Se la ricerca include l'operatore "contains", provare a sostituirlo con "hasKeywords". Se la ricerca include criteri di ricerca generici, provare a limitare i criteri.

Questo errore indica che l'elaborazione della richiesta ha richiesto un tempo eccessivo in NetSuite. Questa condizione si verifica in genere perché i criteri di filtro nella richiesta creerebbero un volume di risultati molto elevato. Il tempo massimo per l'elaborazione di una richiesta in NetSuite è pari a circa tre minuti. Tenere presente che questo è il tempo consentito per l'esecuzione della query nel database in NetSuite. Il tempo necessario per la restituzione di un risultato può essere molto più lungo, in quanto determinato anche dai criteri di traffico di NetSuite.

Esistono diversi modi per risolvere questo errore. Una buona regola generale è assicurarsi che la richiesta generata sia il più possibile specifica. Ad esempio, includere solo i tipi di transazione effettivamente utilizzati dai caricatori. Un altro modo per evitare o risolvere questo errore consiste nell'utilizzare la proprietà Durata batch recupero informazioni. Per le tabelle aggiornate in modo differenziale, questa proprietà determina le dimensioni del blocco di aggiornamento. Il valore predefinito per la Durata batch recupero informazioni è 168 ore (una settimana). Tuttavia, questo valore potrebbe essere troppo elevato se si tratta di una richiesta di dati ad alta densità. Riducendo questo valore si riducono le dimensioni della singola richiesta limitando il filtro temporale, e in tal modo evitando o risolvendo l'errore di timeout.

Il valore minimo della proprietà Durata batch recupero informazioni è di un'ora. Il compromesso è che in questo modo i dati vengono processati poco a poco anziché tutti insieme, il che significa che sarà necessario inviare molte più richieste a NetSuite per completare l'aggiornamento. Ad esempio, la riduzione del valore da 168 a 24 significa che si sta tentando di acquisire un solo giorno alla volta, ma questo comporta un numero di richieste sette volte superiore.

Poiché non esiste un modo pratico per determinare in anticipo la densità dei dati, è consigliabile sperimentare con le query e adattare la proprietà Durata batch recupero informazioni in base alle esigenze.
Creare elenchi singoli dalla tabella di gestione temporanea AllCustomLists: È possibile utilizzare una tabella congiunta per estrarre/filtrare un elenco singolo dalla tabella di gestione temporanea AllCustomLists. Ad esempio, per creare una tabella che contiene i membri dell'elenco chiamato Resolutiontime (con InternalId 19):

In questa espressione di join il valore InternalId è il "selettore" che determina l'elenco personalizzato specifico desiderato.

Creare una nuova tabella congiunta. Un nome accettabile per la tabella può essere "CustomList[*]", dove [*] è il valore "Name" dell'elenco da estrarre. Per questo esempio, il nome sarebbe "CustomListResolutiontime".
Impostare la tabella principale su "AllCustomLists".
Aggiungere un join.
Tabella principale:
AllCustomLists
Tabella congiunta:
AllCustomLists
Tipo:
Interno
Prefisso colonna:
(vuoto)
Espressione join:

P."InternalId" = '19' and R."InternalId" = '19' and P."ValueId" = R."ValueId"

In questa espressione join, il valore InternalId funge da "selettore" e determina l'elenco personalizzato specifico desiderato.

Quindi, nella tabella congiunta, selezionare solo le colonne della tabella principale necessarie (in genere, solo "Value" e "ValueId").

Lo screenshot seguente mostra questo risultato:
Suggerimento per la preparazione dei dati di conti e livelli: Anche se i dati di conti e livelli variano da un cliente all'altro, di seguito sono riportati un paio di esempi per mostrare come un designer dati può creare colonne SQL nell'area di gestione temporanea per preparare i dati prima del caricamento in Planning.
Conto:: CASE WHEN "acct.Number" is null THEN TRIM("acct.Name") ELSE TRIM("acct.Number") END
Livello:: CASE WHEN "Department.Name" is null THEN 'No Department' ELSE TRIM("Department.Name") END || ' ' || "Location.Name"
Suggerimento per l'utilizzo delle regole aziendali: Il designer dati consente di creare regole aziendali per semplificare il caricamento. Di seguito sono riportati alcuni suggerimenti per la gestione delle regole relative alle informazioni sul conto:

I codici conto devono essere valori numerici, in modo che sia facile aggiungere l'intervallo di conti CoGe da stornare.
Evitare di utilizzare caratteri di sottolineatura per questo tipo di conti. Se si utilizza un carattere di sottolineatura, sarà necessario aggiungere manualmente tutti i codici conto dei quali si desidera modificare i segni.
I codici conto non possono includere spazi incorporati.
Configurazione del fuso orario: Il fuso orario dell'account per l'origine dati NetSuite nell'integrazione deve corrispondere al fuso orario presente nell'interfaccia utente grafica di NetSuite in Preferences > Localization Time Zone
.

Se i due valori non corrispondono, procedere come segue:

Modificare il fuso orario dell'account nell'integrazione in modo da farlo corrispondere.
Modificare l'impostazione del fuso orario in NetSuite per l'utente associato all'origine dati, in modo da farlo corrispondere.
Riferimenti esterni: La risorsa principale per l'API NetSuite è la guida online sul sito web di NetSuite, http://www.netsuite.com. NetSuite genera un PDF della guida online a ogni release del prodotto. È possibile trovare una copia recente cercando "SuiteTalk (Web Services) Records Guide".

Informazioni su NetSuite sono disponibili all'indirizzo https://www.oracle.com/technical-resources/. Se si esegue la registrazione per un account, è possibile richiedere l'accesso alle aree relative a NetSuite.