Ir para o conteúdo principal
Documentação
Documentação
Adaptive Planning
Última atualização: 2024-08-23
Etapas: definir fontes de dados do NetSuite

Etapas: definir fontes de dados do NetSuite

Você pode usar a integração para extrair informações de sua instância do NetSuite.
Adaptive Planning
 os usuários podem acessar dados em uma instância do NetSuite por meio do adaptador do NetSuite.
Para definir uma fonte de dados do NetSuite, siga estas etapas:
  1. Acesse
    Integração > Design de integrações
    .
  2. Expanda a pasta
    Fontes de dados
     na
    Biblioteca de componentes
    .
    A fonte de dados do NetSuite é licenciada separadamente. Se o adaptador não estiver na lista de fontes de dados, abra um caso no Workday Customer Center.
  3. Clique na
    fonte de dados do NetSuite
    .
    A área central da tela exibe as configurações da nova fonte de dados e outras informações.
  4. Insira as informações da fonte de dados:
    • Habilitar autenticação baseada em token (TBA):
      marcada por padrão quando você atualiza para a versão mais recente do NetSuite. Exige a seleção de uma credencial do NetSuite que contém
      Chave do consumidor, Segredo do consumidor, ID do token
      e
      Segredo do token
       gerados por um administrador do NetSuite na interface de usuário do NetSuite.
    • Credencial
      : selecione a credencial do NetSuite que contém
      Chave do consumidor, Segredo do consumidor, ID do token
      e
      Segredo do token
       gerados por um administrador do NetSuite na interface de usuário do NetSuite. Para saber como definir uma credencial do NetSuite, acesse aqui.
    • Fuso horário da conta
      : na lista suspensa, selecione o fuso horário apropriado para a conta. (O fuso horário selecionado aqui deve ser o mesmo usado na interface de usuário do NetSuite para essa conta de usuário. No NetSuite, acesse
      Home > Set Preferences > Localization
      .)
    • Duração do lote de preenchimento
      : selecione a duração do lote de preenchimento. O padrão é uma semana (168 horas). Esse valor representa o número de horas de extração de dados de uma única execução de atualização de uma tabela NetSuite importada de forma diferencial. Essa opção permite definir o bloco de processamento da programação para manter um equilíbrio entre as tarefas com lotes grandes e pequenos. Reduza esse valor se você tiver grandes quantidades de dados do NetSuite. Quanto menor é o valor, mais ciclos de preenchimento são necessários para um determinado período.
      O valor específico inserido depende muito de uma série de variáveis locais específicas, como o tamanho das tarefas, a proporção entre tarefas pequenas e grandes, o tempo de resposta e os recursos do sistema.
    • Nível de registro
      : selecione um nível de registro na lista suspensa para especificar os detalhes de registro dessa fonte de dados. Suas opções são:
      • Erro
        : registra somente erros graves.
      • Informações
        : registra todas as informações básicas, como por exemplo, a data em que a fonte de dados foi atualizada.
      • Detalhado
        : apresenta informações muito detalhadas sobre todas as fases e ações. (Este nível é usado principalmente para depuração ou auditoria, pois pode produzir mais informações de registro do que as necessárias para o uso geral.)
  5. Clique em
    Salvar
     no menu Ações.
Você pode testar as informações de conexão no novo agente clicando em
Testar conexão
 no menu Ações. O sistema tenta se conectar ao NetSuite usando as informações dos campos da fonte de dados. Se o sistema conseguir se conectar ao NetSuite, clique em
OK
. Se ocorrerem problemas de conexão, abra um caso no Workday Customer Center.
Depois de se conectar ao NetSuite, você pode importar a estrutura de dados. Você vê as tabelas e colunas do NetSuite.

Importar estrutura da fonte de dados do NetSuite

  1. Clique em
    Importar estrutura
     no menu
    Ações
    . As tabelas e colunas são mostradas no menu
    Componentes de dados
    .
Os dados são sincronizados para a conta de usuário NetSuite da seguinte forma:
  • A Integração escolhe o melhor método de sincronização.
  • A Integração tenta inicialmente obter dados de forma incremental.
  • Se a fonte de dados subjacente não tiver suporte para a obtenção de dados de forma incremental, a Integração faz uma atualização completa dos dados na área de preparação.
Estrutura de importação e tabela de resumo de transação de contabilização do Adaptive para o NetSuite
A Integração disponibiliza uma tabela com informações iniciais do NetSuite chamada
AdaptivePostingTransactionSummary
.
A
AdaptivePostingTransactionSummary
 e respectivas tabelas associadas são exibidas por padrão durante o processo
Importar estrutura
. Essa tabela mostra os elementos de dados solicitados com mais frequência de um sistema de origem do NetSuite. Essa tabela cria junções automaticamente entre a tabela
PostingTransactionSummary
 e as tabelas associadas. Como resultado, essa opção apresenta os nomes para as categorias do Netsuite solicitadas com mais frequência:
  • Conta
  • Classificação
  • Itens
  • Departmento
  • Local
  • Subsidiária
  • Cliente
A coluna Nome é incluída em cada tabela. A coluna
Tipo de conta
 é habilitada automaticamente na guia
Contas
. As tabelas de categorias são importadas automaticamente quando o processo
Importar estrutura
 é executado.
Se for preciso filtrar os tipos de conta que não são necessários, use um filtro SQL no carregador do Planning, conforme descrito em Como criar filtro SQL.
Você também pode optar por remover uma ou mais dimensões disponíveis por padrão na tabela associada. Inclua somente as categorias de que você precisa para seu modelo. Todas as outras categorias devem ser removidas da junção, e a coluna subjacente deve ser excluída da importação de PostingTransactionsSummary.

Como adicionar tabelas a uma fonte de dados do NetSuite

Depois de importar a estrutura de dados, especifique as informações que você quer importar. Um conjunto padrão de tabelas NetSuite já está habilitado. Se quiser importar tabelas adicionais, use a seção Tabelas a serem importadas para configurar os dados importados do NetSuite.
Para especificar as tabelas a serem importadas da conta de usuário, siga estas etapas:
  1. Expanda a entrada da fonte de dados no menu
    Componentes de dados
    .
    Cada tabela aparece como um item separado.
  2. Para selecionar as tabelas que você quer importar, arraste-as e solte-as na seção Tabelas a serem importadas, no centro da tela.
    À medida que você arrasta cada tabela para a seção Tabelas a serem importadas, é exibida uma guia da tabela e as informações são exibidas na seção Tabelas a serem importadas, mostrando o tipo de informação que você adicionou. Cada guia da tabela também tem um menu suspenso que você pode acessar clicando na seta ao lado do nome.

Como gerenciar colunas

Se você trabalha com uma tabelas que têm um grande número de colunas, pode usar a caixa de diálogo Gerenciar colunas para fazer edições rápidas nas colunas que você quer importar. A caixa de diálogo Gerenciar colunas exibe as colunas da tabela para que você possa marcar ou desmarcar as colunas para importação.
Para gerenciar as colunas para importação, siga estas etapas:
  1. Na guia, clique na seta à direita do nome da tabela.
  2. Clique em Gerenciar colunas no menu flutuante.
  3. Marque a caixa ao lado da coluna para importá-la.
    Quando você marca uma coluna, ela também aparece na janela de pré-visualização depois que o conteúdo do pop-up é salvo. O ato de desmarcar a coluna a remove da janela de pré-visualização.
    Você não consegue alterar o status de importação em campos gerados pelo sistema, como o isDeleted.
    Você pode alterar o status da importação em colunas individuais quando:
    • Seleciona as propriedades da coluna e define a propriedade.
    • Arrasta e solta as colunas no designer

Como personalizar tabelas

Para cada tabela, você pode personalizar a forma como os dados são importados.
Para personalizar as configurações da tabela, siga estas etapas:
  1. Na guia, clique na seta à direita do nome da tabela.
  2. Clique em
    Configurações de tabela
     no menu flutuante.
  3. Insira as configurações da tabela:
    • Modo de importação de dados
      : há somente uma opção na lista suspensa:
      • Fonte de dados para selecionar automaticamente a melhor abordagem de sincronização:
        este é o padrão. A fonte de dados examina o NetSuite e usa automaticamente a melhor maneira de sincronizar os dados na área de preparação com as informações no NetSuite. (Algumas tabelas são lidas na íntegra todas as vezes, enquanto outras usam atualização diferencial.)
    • Filtro de importação de dados
      : use para inserir uma expressão SQL que filtre ou formate as informações que estão sendo importadas. O filtro SQL é aplicado antes que os dados sejam extraídos do Netsuite para reduzir a quantidade de informações que precisam ser importadas, proporcionando um nível adicional de controle dos dados que são trazidos para a área de preparação. Clique no campo para exibir a caixa de diálogo Editar expressão SQL (o filtro inserido aqui é aplicado aos dados reais no NetSuite e não nos dados pré-visualizados na área de preparação). Nem todas as fontes de dados têm suporte para o mesmo nível de recurso de filtragem de SQL.
    • Parâmetro de período:
       as tabelas do NetSuite
      PostingTransactionBalance
       e
      PostingTransactionSummary
       A importação é por padrão e exige a configuração de um parâmetro de período antes da importação. Se você optar por importar o
      ConsolidatedExchangeRate
      ou
      BudgetExchangeRate
       tabelas, também exigem a configuração de um parâmetro de período. Se o parâmetro de período não for configurado para essas tabelas, a importação falha com a mensagem:
      Required parameter is not configured
      O NetSuite tem uma capacidade de filtragem muito limitada para SQL. Somente expressões muito simples têm suporte.
  4. Clique em
    Aplicar
    para aplicar as configurações.
  5. Repita as etapas de 1 a 3 para cada tabela.
  6. Clique em
    Salvar
     para salvar as configurações na fonte de dados.

Como definir opções de coluna

Use a seção Tabelas a serem importadas para pré-visualizar os dados tal como estão na fonte de dados ou como ficaram na área de preparação após a importação. Você pode alterar as opções de cada coluna posicionando o cursor do mouse sobre o título e clicando no menu suspenso ao lado do nome:
  • Classificar em ordem crescente
    : classifica toda a tabela em ordem crescente com base nesta coluna.
  • Classificar em ordem decrescente
    : classifica toda a tabela em ordem decrescente com base nesta coluna.
  • Configurações de coluna
    : esta caixa de diálogo é usada para alterar as propriedades da coluna na tabela de preparação.
    • Nome
      : nome da coluna, exibido no cabeçalho.
    • Tipo de coluna
      : tipo de dados usados na coluna.
    • Converter tipo de coluna
      : selecione o novo tipo neste menu suspenso.
  • Excluir coluna da importação
    : selecione para remover esta coluna dos dados que estão sendo importados.
  • Excluir coluna personalizada
    : selecione para excluir a coluna. (Disponível somente para colunas personalizadas.)

Como criar colunas de subconsulta

As colunas de subconsulta permitem filtrar linhas do NetSuite com base nas condições com outra tabela relacionada. Por exemplo, você pode filtrar registros de Oportunidade do NetSuite com base na existência de um ou mais registros de Cotação.
Você pode usar colunas de subconsulta para:
  • Selecionar a tabela/coluna principal e a tabela/coluna relacionada.
  • Verificar certas condições nas tabelas relacionadas.
  • Inserir valores apropriados na tabela de controle com base nos resultados dessas verificações.
Para cada tabela, você pode personalizar a forma como os dados são importados.
Para criar uma coluna de subconsulta:
  1. Expanda a pasta Coluna personalizada na fonte de dados no menu Componentes de dados.
  2. Arraste e solte o componente da Coluna de subconsulta na seção Tabelas a serem importadas, no centro da tela.
  3. Informe as configurações de coluna:
    • Nome
      : informe um nome para a coluna da subconsulta:
    • Tipo de coluna
      : este campo somente para exibição identifica o tipo como sendo uma coluna booliana.
    • Tabela relacionada
      : selecione a tabela relacionada a ser usada para comparação.
    • Expressão de junção
      : clique neste campo para inserir uma condição de junção. A caixa de diálogo Editar a expressão de junção SQL é exibida. (Mais informações sobre como criar junções SQL podem ser encontradas em Etapas: adicionar tabelas e colunas de junção SQL.)
    • Regra de valores de junção
      : selecione uma das opções de valor de junção na lista suspensa: Exists, Does Not Exist, Sum, Count, Min ou Max.
  4. Clique em
    Aplicar
    para aplicar as configurações.
  5. Clique em
    Salvar
     para salvar as configurações na fonte de dados.

Como baixar dados de uma tabela de preparação

Você pode baixar dados de uma única tabela de preparação.
Para baixar dados de uma única tabela de preparação, siga estas etapas:
  1. Clique na seta para baixo no cabeçalho da tabela na seção Tabelas a serem importadas.
  2. Selecione
    Baixar dados.
  3. Clique em
    Enviar
     na mensagem
    Esta operação enviará um e-mail com um URL para baixar os dados
    .
    A Integração envia um e-mail contendo um URL para a conta de e-mail associada ao designer de dados.
  4. Abra o e-mail e clique no URL. Os dados são baixados no formato .csv.

Como usar opções avançadas de filtro

Abaixo do menu suspenso Origem, clique em Opções avançadas de filtro para ver as opções para filtrar os dados na área de pré-visualização das Tabelas a serem importadas. O recurso Opções avançadas de filtro disponibiliza ferramentas para visualizar e navegar por um subconjunto dos dados em uma tabela de preparação ou diretamente da origem remota (se você selecionar NetSuite no menu suspenso Origem).
A área de pré-visualização serve especificamente para ver uma pequena parte dos dados na área de preparação (ou no NetSuite). Para verificar se está obtendo os dados esperados, examine a área de preparação e explore os dados disponíveis na planilha. Você também pode usar esse recurso para refinar o filtro de importação de dados que você quer usar. (Os filtros definidos na função de pré-visualização não afetam os dados reais na área de preparação.)
As Opções avançadas de filtro são:
  • Linhas distintas
    : marque esta caixa para ocultar linhas duplicadas.
  • Máx. de linhas
    : informe um número na caixa de texto para limitar o número de linhas exibidas na área de pré-visualização.
  • Colunas
    : marque ou desmarque as colunas neste menu suspenso para mostrar ou ocultar colunas.
A remoção de uma coluna desta lista não remove a coluna da lista de importação.
  • Filtro SQL
    : clique na caixa de texto grande para exibir a caixa de diálogo Editar a expressão SQL, em que você pode inserir um filtro SQL para restringir as linhas que estão sendo visualizadas. Clique em Aplicar para verificar automaticamente a sintaxe SQL do filtro. (Se houver algum erro, ele é indicado na expressão.) A expressão que você inseriu aparece no campo Filtro de importação de dados. Para obter ajuda detalhada sobre sintaxe SQL, clique aqui na seção Observações. O NetSuite tem uma capacidade de filtragem muito limitada para SQL. Somente expressões muito simples têm suporte.
Clique em
Remover filtro
 (ao lado do menu suspenso Origem) para limpar as configurações na janela de pré-visualização.
O NetSuite designa certas colunas como colunas-chave. Essas informações são trazidas para as tabelas de preparação. Essas informações não devem ser modificadas.

Como importar dados do NetSuite

Depois de definir e salvar a fonte de dados do NetSuite, você pode importar os dados.
Para importar os dados do NetSuite, faça o seguinte:
  1. Clique em
    Importar dados
     no menu Ações. Os dados selecionados são filtrados pelas expressões SQL e carregados na área de preparação. Você pode pré-visualizar os dados na área de preparação.
As informações permanecem na área de preparação até que você as limpe.
Para limpar os dados da área de preparação, faça o seguinte:
  1. Clique em
    Limpar tabelas de preparação
     no menu Ações. A área de preparação de todas as tabelas na fonte de dados é limpa.
Prática recomendada:
 ao importar tipos de transação do NetSuite, certifique-se de usar somente os tipos de transação do NetSuitecom suporte.

Como importar pesquisas salvas do NetSuite

A importação de pesquisas salvas do NetSuite só estará disponível se você definir a integração com o NetSuite antes de 12 de agosto de 2024.
As pesquisas salvas só podem ser importadas de adaptadores NetSuite. A autenticação única (SSO) também deve ser configurada para essa fonte de dados.
A importação de pesquisas salvas requer a configuração de uma pesquisa salva do NetSuite no designer de dados e, em seguida, a importação da estrutura. As pesquisas salvas na integração têm suporte para registros personalizados, campos personalizados e segmentos personalizados do NetSuite.
Configurar pesquisa salva no designer de dados
  1. Clique em
    Gerenciar pesquisas salvas
     no menu Ações.
  2. Na caixa de diálogo
    Gerenciar pesquisas salvas
    , clique no botão de ações abaixo da árvore de navegação e selecione Adicionar pesquisa salva ou clique com o botão direito do mouse na pasta de pesquisas salvas e selecione Adicionar pesquisa salva. Atribua um nome à pesquisa salva.
  3. Selecione
    Tipo de registro do NetSuite
    .
  4. Selecione
    Pesquisa salva do NetSuite
    .
  5. Clique em
    Aplicar
    .
Importar estrutura de pesquisa salva
  1. Na caixa de diálogo Gerenciar pesquisas salvas, clique em uma pesquisa salva criada anteriormente para selecioná-la.
  2. Clique no botão de ações abaixo da árvore de navegação e selecione
    Importar estrutura
     no menu Ações ou clique com o botão direito do mouse na pesquisa salva e selecione
    Importar estrutura
    .
  3. Depois que as estruturas da pesquisa salva são importadas, feche a caixa de diálogo Gerenciar pesquisas salvas.
  4. A área de preparação exibe uma guia para cada estrutura da pesquisa salva que você importou.
Fique atento, pois se você clicar em Importar estrutura no painel Ações, todas as pesquisas salvas no painel Componentes de dados são importadas.
Prática recomendada:
 verifiquem se os resultados da importação da estrutura da pesquisa salva não incluem colunas com resultados do resumo do NetSuite. Essa é uma restrição da API de serviços Web do NetSuite.
O número máximo de pesquisas salvas do NetSuite que podem ser importadas é 1.000 (mil).
Selecionar um modo de importação de dados de pesquisa salva do NetSuite
  1. Na área de preparação, na guia de uma tabela da pesquisa salva no NetSuite, clique no ícone de seta.
  2. Selecione
    Configurações de tabela
     no menu suspenso.
    Há duas opções disponíveis:
    • Todos os registros são substituídos toda vez que a importação de dados é executada
      . Esse é o padrão. Essa opção substitui todos os dados quando a importação é executada.
    • Todos os registros que estão em um intervalo de tempo transmitido
      : essa ação permite que você selecione um intervalo de tempo usando um parâmetro e, depois, escolha uma coluna de data/hora da tabela da pesquisa salva à qual o parâmetro se aplica. Você pode clicar em
      Editar parâmetros
       nessa caixa de diálogo para criar um parâmetro de intervalo de tempo. Se você optar por importar um intervalo de tempo, deve definir um parâmetro de período ou a importação falha.
  3. Clique em
    Aplicar
  4. Clique em
    Salvar
    no painel Ações
Importar dados de uma pesquisa salva
  1. No painel Ações, clique em
    Importar dados
    .
  2. Os dados da pesquisa salva do NetSuite são importados para a área de preparação.
Como excluir pesquisas salvas do NetSuite
  1. Clique em
    Gerenciar pesquisas salvas
     no painel Ações.
  2. Clique com o botão direito do mouse na pesquisa salva em Gerenciar pesquisas salvas e selecione
    Excluir
    . A pesquisa salva é removida da lista da caixa de diálogo Gerenciar pesquisas salvas, mas sua estrutura permanece no painel Componentes de dados e na área preparação até que o processo Importar estrutura seja executado novamente.
Se uma pesquisa salva do NetSuite é excluída dentro do NetSuite, ao executar a ação Importar estrutura, uma mensagem indica que ela não está mais disponível. Se uma pesquisa salva que já está sendo usada na Integração para importação de dados é modificada no NetSuite, as importações de dados futuras podem não funcionar.
Prática recomendada:
 no NetSuite, crie suas pesquisas salvas especificamente para usar na integração e nomeie-as de forma que não sejam modificadas ou excluídas por outros usuários do NetSuite.
Prática recomendada:
 verifique se você tem as permissões apropriadas no NetSuite para visualizar o conteúdo retornado por um resultado de pesquisa salva. Se você não tiver permissão para acessar o conteúdo, sua pesquisa não retornará registros e também não retornará uma mensagem de erro. Essa é uma limitação do NetSuite indicada na ajuda on-line:
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).

Selecionar arquivos de gabinetes de arquivos do NetSuite para importação

Você pode gerenciar e selecionar arquivos CSV nos gabinetes de arquivos do NetSuite para importá-los como tabelas de preparação.

Detalhamento de
Adaptive Planning
 Voltar para o NetSuite

O detalhamento do NetSuite só estará disponível se você definir a integração com o NetSuite antes de 12 de agosto de 2024.
Você pode habilitar o detalhamento nos dados importados do NetSuite. Os links para o detalhamento estão disponíveis em planilhas e relatórios do Planning para valores reais importados do NetSuite. Para configurar o detalhamento até o NetSuite, você deve usar os identificadores internos como parte do mapeamento de colunas no carregador do Planning. Você precisa configurar um sistema externo ao NetSuite e anexá-lo a um perfil usado pelo carregador do Planning.
Se você está configurando várias colunas no NetSuite para mapear para uma única dimensão do Planning, essas colunas do NetSuite precisam ser combinadas na fonte de dados usando uma coluna SQL de tupla.
Para obter mais detalhes, consulte a seção Noções básicas sobre perfis de mapeamento de Criar carregadores de dados do Planning.
Resumo das etapas para habilitar o detalhamento dede o Planning até o NetSuite
Antes de começar, verifique se a caixa de seleção de detalhamento avançado baseado em pacote está marcada no menu
Integração > Definição do NetSuite
 do Planning.
Configure um NetSuiteExternal System, que define o mapeamento de dimensões.
Faça os ajustes necessários na fonte de dados para os mapeamentos de dimensões definidos.
  1. Se você tiver várias categorias do NetSuite mapeadas na mesma Dimensão do Planning, reveja a fonte de dados do NetSuite para adicionar uma coluna SQL de tupla para um mapeamento de muitos-para-um das colunas.
  2. Clique na tabela
    Resumo de transação de contabilização do Adaptive
     em Tabelas a serem importadas.
  3. Selecione
    Gerenciar colunas
     na lista suspensa
    Resumo de transação de contabilização do Adaptive
    .
  4. Habilitar
    AccountInternalId
    .
  5. Habilite o
    InternalIds
     para as outras dimensões que você planeja detalhar.
  6. Salve a fonte de dados.
Faça os ajustes necessários no carregador usando os ajustes feitos na fonte de dados para o mapeamento de dimensões.
  1. Depois que as configurações de fonte de dados do Netsuite forem concluídas, configure um carregador de dados do Planning para importar os dados de valores reais do NetSuite.
    • Vincule um perfil ao sistema externo que você configurou na etapa Configurar sistema externo do NetSuite.
    • Anexe este perfil ao Carregador do Planning.
  2. Clique na guia
    Mapeamento de colunas
    .
  3. Na linha Conta:
    • Na coluna
      ID da origem,
      selecione o
      accountInternalId
       coluna da tabela de origem.
    • Na coluna
      Nome de exibição da origem
      , selecione o nome de exibição.
  4. Repita a etapa acima para cada uma das outras dimensões padrão que você quer detalhar.
  5. Salve o carregador
Depois de concluir essas etapas, você pode fazer o detalhamento.