Ligar ao Anaplan

Ligue o PlaidCloud ao Anaplan para que um fluxo de trabalho possa ler uma vista guardada através do caminho de pedidos de leitura de grande volume do Anaplan, executar uma ação de exportação existente ou ler uma ou mais listas do Anaplan para uma dimensão do PlaidCloud. A ligação chega à própria API de integração do Anaplan diretamente na cloud — não existe um caminho por agente local para estes passos. Este guia abrange a ligação, a autenticação, uma breve introdução a cada um dos três passos de leitura e as considerações de agendamento.

Nota

Este conector é apenas de leitura. Nada é alguma vez escrito de volta no Anaplan — não existe passo de escrita de retorno nem modo de aplicação parcial.

Pré-requisitos

Precisa, junto do administrador da área de trabalho do Anaplan, de:

• Um nome de utilizador e palavra-passe do Anaplan, ou um certificado CA e a respetiva chave privada registados num utilizador do Anaplan pelo administrador da área de trabalho — com acesso de leitura à área de trabalho e aos modelos que os seus fluxos de trabalho vão ler. Consulte Autenticação abaixo.
• O ID da área de trabalho e o ID do modelo dos modelos de que vai ler, visíveis nas definições do modelo do próprio Anaplan. Ambos podem também ser descobertos em direto a partir da ligação depois de esta ser criada.
• Para Anaplan: Ler vista — uma vista guardada, construída exatamente com a fatia de linhas, colunas e filtros pretendida. Consulte Anaplan: Ler vista abaixo.
• Para Anaplan: Ler exportação — uma ação de exportação que já exista no modelo.
• Para Anaplan: Ler lista — as listas do Anaplan que compõem a hierarquia que pretende ler.

Autenticação

A ligação tem um Modo de autenticação: Básico (o predefinido) ou Certificado. Uma ligação existente continua a funcionar sem alterações como Básico.

• Básico inicia sessão com um nome de utilizador e uma palavra-passe do Anaplan.
• Certificado inicia sessão com um certificado emitido por uma CA e a respetiva chave privada, ambos colados como texto PEM. A chave privada tem de ser RSA e não estar cifrada, e o certificado tem de ser aquele que o administrador da área de trabalho do Anaplan registou no seu utilizador do Anaplan — emitido por uma CA em que o Anaplan confia para o seu inquilino. O PlaidCloud assina um desafio aleatório com a chave e troca-o por um token do Anaplan, seguindo o fluxo de autenticação por certificado do próprio Anaplan; não há mais nada a fazer depois de colar o certificado e a chave, e a renovação do token funciona como no modo Básico. Ambos os campos ocultam o que cola, e ambos os segredos são armazenados cifrados, tal como uma palavra-passe Básico, e mudar de modo nunca envia as credenciais do outro modo — se mudar uma ligação existente de Básico para Certificado, terá de colar o certificado e a chave, pois não são transportados.

A autenticação multifator do Anaplan aplica-se aos utilizadores que iniciam sessão com email e palavra-passe. A autenticação por certificado é a opção sem palavra-passe para uma ligação automatizada e agendada.

O modo Certificado recusa antes de contactar o Anaplan se não for possível ler a chave ou o certificado colados, se a chave estiver cifrada ou não for RSA, ou se a chave não corresponder ao certificado. Se o próprio Anaplan rejeitar o certificado, o erro indica se este expirou; as causas habituais são um certificado que não está registado num utilizador do Anaplan ou uma CA em que o seu inquilino não confia.

Criar a ligação

1. Abra Tools > Connections e clique em New Connection.

2. Escolha Anaplan no menu.

3. Preencha os campos:

   Campo	Valor
   Nome	Um nome amigável, por exemplo Anaplan Prod.
   Anfitrião da API	Opcional. Deixe em branco para o https://api.anaplan.com padrão do Anaplan.
   Anfitrião de autenticação	Opcional. Deixe em branco para o https://auth.anaplan.com padrão do Anaplan.
   Modo de autenticação	Básico (predefinido) ou Certificado. Consulte Autenticação acima.
   Nome de utilizador	O nome de utilizador da conta do Anaplan. Apenas no modo Básico.
   Palavra-passe	A palavra-passe da conta do Anaplan. Apenas no modo Básico.
   Certificado CA	Texto PEM do certificado X.509 registado no Anaplan. Apenas no modo Certificado.
   Chave privada	Texto PEM da chave privada RSA do certificado, não cifrada. Apenas no modo Certificado.
   ID da área de trabalho predefinida	Opcional. Um preenchimento prévio de conveniência para o campo Área de trabalho de um passo de leitura.
   ID do modelo predefinido	Opcional. Um preenchimento prévio de conveniência para o campo Modelo de um passo de leitura.
   Tempo limite (segundos)	Predefinido: 30.

4. Clique em Test Connection. Um teste bem-sucedido indica o email da conta do Anaplan a que as credenciais correspondem.

5. Clique em Create.

Anaplan: Ler vista

Adicione um passo Anaplan: Ler vista para ler uma vista guardada através do caminho de pedidos de leitura de grande volume do Anaplan. A vista é lida exatamente como foi guardada no Anaplan — este passo não tem seleção de linhas, colunas ou páginas. Para ler uma fatia diferente, construa uma vista guardada diferente no Anaplan; um item de linha booleano mais uma vista guardada é a forma habitual de filtrar aí. Uma coluna de dados só chega com o seu tipo Anaplan declarado quando a vista coloca os Line Items no eixo das colunas; com os Line Items nas linhas (um esquema normal de demonstração de resultados) ou ausentes da vista, todas as colunas chegam como texto, e o passo di-lo. Uma vista cujo filtro não corresponde a nada resulta numa tabela vazia com um aviso. Um valor Number que o passo não consegue ler sem ambiguidade — na maioria das vezes um que pode ser igualmente um decimal simples ou uma representação ao estilo europeu — é recusado em vez de adivinhado, a menos que outro valor da mesma coluna esclareça qual a leitura correta; um valor que é interpretado chega com precisão total, sem erro de arredondamento. Consulte Anaplan: Ler vista para a referência completa de campos e comportamento.

Anaplan: Ler exportação

Adicione um passo Anaplan: Ler exportação para executar uma ação de exportação do Anaplan existente e carregar o ficheiro que produz. A API não consegue criar uma ação de exportação — construa-a ou edite-a primeiro no Anaplan — e o passo não consegue restringir o que ela emite: o que a ação estiver configurada para exportar no Anaplan é exatamente o que chega. Todas as colunas chegam como texto. Os números são pedidos com formatação dos EUA; uma coluna que ainda assim chegue com separadores de milhares é carregada inalterada, como texto, com um aviso nomeado em vez de fazer falhar a execução. O passo para, em vez de carregar uma tabela, quando a exportação falha, é cancelada, não produz dados, ainda está em execução quando o orçamento de consultas do passo se esgota, ou produz um ficheiro que não pode ser associado à exportação ou cuja contagem de linhas diverge da que o próprio Anaplan indica. Consulte Anaplan: Ler exportação para a referência completa.

Anaplan: Ler lista

Adicione um passo Anaplan: Ler lista para ler uma ou mais listas do Anaplan para uma dimensão do PlaidCloud. Um passo lê uma hierarquia composta inteira — indique todas as listas que ela abrange, começando pela raiz (por exemplo, Região, depois País, depois Loja), em vez de a repartir por vários passos; a tabela de preparação é substituída em cada execução, pelo que vários passos apontados para uma mesma tabela de preparação apagariam cada um as linhas do anterior. Cada aresta agrega com um simples +, uma vez que as hierarquias de listas do Anaplan não têm ponderação nem sinal por aresta para ler. Os controlos de acesso às listas e a pertença a subconjuntos do Anaplan não são importados — são metadados, não dados de dimensão. IDs de nó duplicados, uma referência a um pai que não pode ser resolvida, referências a pais em conflito e um nome de propriedade que colide com metadados importados são todos recusados antes de qualquer coisa ser carregada. Consulte Anaplan: Ler lista para a referência completa.

Considerações de agendamento

O orçamento de taxa de pedidos do Anaplan é partilhado por todo o inquilino — por todas as integrações que a sua organização executa nesse inquilino do Anaplan, e não apenas pelo PlaidCloud — e o PlaidCloud não coordena agendamentos entre execuções simultâneas. Vários passos do Anaplan que arranquem no mesmo minuto de cron podem esgotar esse orçamento antes de qualquer um deles terminar. Escalone os agendamentos dos seus fluxos de trabalho do Anaplan em vez de os executar todos ao mesmo tempo.

Relacionado

• Anaplan: Ler vista — ler uma vista guardada, referência de campos.
• Anaplan: Ler exportação — executar uma ação de exportação, referência de campos.
• Anaplan: Ler lista — ler listas para uma dimensão, referência de campos.
• Criar e gerir uma ligação