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 já existente ou ler uma ou mais listas do Anaplan para uma dimensão do PlaidCloud. A ligação chega à Integration API do próprio Anaplan diretamente na nuvem — não existe um caminho por agente local para estes passos. Este guia aborda a ligação, a autenticação, uma breve introdução a cada um dos três passos de leitura e as considerações sobre agendamento.
Pré-requisitos
Seção intitulada “Pré-requisitos”Precisa de obter, junto do administrador da área de trabalho do Anaplan:
- Ou 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 mais abaixo.
- O ID da área de trabalho e o ID do modelo dos modelos 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 o segmento de linhas, colunas e filtros pretendido. Consulte Anaplan: Ler vista mais 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
Seção intitulada “Autenticação”A ligação tem um Modo de autenticação: Básico (a predefinição) ou Certificate. Uma ligação existente continua a funcionar sem alterações como Básico.
- O modo Básico inicia sessão com um nome de utilizador e uma palavra-passe do Anaplan.
- O modo Certificate 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 confie 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 guardados cifrados, tal como uma palavra-passe do modo Básico, e a mudança de modo nunca envia as credenciais do outro modo — se mudar uma ligação existente de Básico para Certificate, tem de colar o certificado e a chave, uma vez que 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 Certificate recusa a operação antes de contactar o Anaplan se a chave ou o certificado colados não puderem ser lidos, 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
Seção intitulada “Criar a ligação”-
Abra Tools > Connections e clique em
New Connection. -
Escolha Anaplan no menu.
-
Preencha os campos:
Campo Valor Nome Um nome intuitivo, por exemplo Anaplan Prod.Anfitrião da API Opcional. Deixe em branco para o https://api.anaplan.compredefinido do Anaplan.Anfitrião de autenticação Opcional. Deixe em branco para o https://auth.anaplan.compredefinido do Anaplan.Modo de autenticação Básico (predefinição) ou Certificate. 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 Certificate. Chave privada Texto PEM da chave privada RSA do certificado, sem cifra. Apenas no modo Certificate. ID da área de trabalho predefinida Opcional. Um preenchimento prévio por conveniência para o campo Área de trabalho de um passo de leitura. ID do modelo predefinido Opcional. Um preenchimento prévio por conveniência para o campo Modelo de um passo de leitura. Tempo limite (segundos) Por predefinição, 30. -
Clique em
Test Connection. Um teste bem-sucedido indica o email da conta do Anaplan a que as credenciais correspondem. -
Clique em
Create.
Anaplan: Ler vista
Seção intitulada “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 outro segmento, construa outra vista guardada no Anaplan; um item de linha booleano mais uma vista guardada é a forma habitual de filtrar aí. Uma coluna de dados só é carregada com o tipo Anaplan declarado quando a vista coloca os itens de linha (Line Items) no eixo das colunas; com os itens de linha nas linhas (uma disposição normal de demonstração de resultados) ou ausentes da vista, todas as colunas são carregadas como texto, e o passo di-lo. Uma vista cujo filtro não devolve nada carrega uma tabela vazia com um aviso. Um valor numérico que o passo não consiga ler sem ambiguidade — na maioria das vezes um que tanto poderia ser um decimal simples como 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 seja interpretado é carregado 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
Seção intitulada “Anaplan: Ler exportação”Adicione um passo Anaplan: Ler exportação para executar uma ação de exportação do Anaplan já existente e carregar o ficheiro que esta produz. A API não consegue criar uma ação de exportação — crie-a ou edite-a primeiro no Anaplan — e o passo não consegue restringir o que é emitido: tudo o que a ação estiver configurada para exportar no Anaplan é exatamente o que é carregado. Todas as colunas são carregadas como texto. Os números são pedidos com formatação dos EUA; uma coluna que ainda assim chegue com separadores de milhares é carregada sem alterações, como texto, com um aviso identificado, em vez de fazer a execução falhar. 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 se esgota o orçamento de sondagem do passo, ou produz um ficheiro que não pode ser associado à exportação ou cuja contagem de linhas diverge da que o próprio Anaplan comunica. Consulte Anaplan: Ler exportação para a referência completa.
Anaplan: Ler lista
Seção intitulada “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 dividir por vários passos; a tabela de preparação é substituída em cada execução, pelo que vários passos apontados para a 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 peso nem sinal por aresta para ler. Os controlos de acesso às listas do Anaplan e a pertença a subconjuntos não são importados — são metadados, não dados de dimensão. IDs de nó duplicados, uma referência a um elemento superior que não pode ser resolvida, referências a elementos superiores em conflito e um nome de propriedade que colide com metadados importados são todos recusados antes de ser carregado o que quer que seja. Consulte Anaplan: Ler lista para a referência completa.
Anaplan como origem do Data Foundation
Seção intitulada “Anaplan como origem do Data Foundation”O Data Foundation pode ler o plano que o Anaplan contém, um orçamento, uma previsão ou os resultados de um modelo de consolidação, para o seu Common Finance Model. Traz o plano, nunca o razão, e só lê.
O Data Foundation executa uma ação de exportação do modelo tal como está guardada, pelo que o seu administrador do Anaplan constrói essa exportação primeiro. O separador Base escreve o pedido para ele. A exportação tem de ser uma grelha plana com uma linha para cada entidade, período, conta e departamento, e com estes cabeçalhos de coluna exatamente:
| Coluna | Contém |
|---|---|
Entity |
O código da entidade. |
Period |
O mês, no formato YYYY-MM. |
Account |
O código da conta. |
Department |
O código do departamento, em branco quando o plano não tem nenhum. |
Currency |
A moeda do montante. |
Amount |
Um número simples, sem separador de milhares, no sinal em que o plano é mantido (receitas positivas). |
Depois, adicione a ligação como origem no separador Base, como para qualquer outra (consulte Ligar o seu ERP). Uma nova ligação pede o Nome de utilizador, a Palavra-passe, o ID da área de trabalho e o ID do modelo. O Anaplan não lista entidades para marcar, pelo que o formulário pede uma: introduza a entidade da exportação a manter em Nome, ou deixe em branco para manter todas as entidades. Depois, preencha as System settings, que se apresentam com estes nomes:
| Definição | O que significa |
|---|---|
export |
O ID da ação de exportação a executar. |
scenario |
Budget (a predefinição), Forecast ou Consolidated, para os resultados de um modelo de consolidação com que a demonstração de resultados do grupo é reconciliada. |
version |
Uma etiqueta aplicada a todas as linhas. Por predefinição, Anaplan. |
Os montantes são lidos tal como estão, no sinal natural. Uma coluna que chegue ainda agrupada com separadores de milhares é assinalada, não adivinhada, tal como em Anaplan: Ler exportação.
Considerações sobre agendamento
Seção intitulada “Considerações sobre 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 em simultâneo. Vários passos do Anaplan a carregar 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.
Relacionados
Seção intitulada “Relacionados”- 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