Conectar con Anaplan
Conecte PlaidCloud con Anaplan para que un flujo de trabajo pueda leer una vista guardada mediante la ruta de solicitudes de lectura de gran volumen de Anaplan, ejecutar una acción de exportación existente o leer una o más listas de Anaplan en una dimensión de PlaidCloud. La conexión llega a la propia API de integración de Anaplan directamente a la nube: estos pasos no tienen una ruta mediante un agente local. Esta guía cubre la conexión, la autenticación, una breve introducción a cada uno de los tres pasos de lectura y las consideraciones sobre la programación.
Requisitos previos
Sección titulada «Requisitos previos»Necesita, de su administrador del espacio de trabajo de Anaplan:
- Un nombre de usuario y contraseña de Anaplan, o bien un certificado de CA y su clave privada registrados a un usuario de Anaplan por su administrador del espacio de trabajo, con acceso de lectura al espacio de trabajo y a los modelos que leerán sus flujos de trabajo. Consulte Autenticación más abajo.
- El ID del espacio de trabajo y el ID del modelo de los modelos de los que leerá, visibles en la propia configuración del modelo de Anaplan. Ambos también pueden detectarse en vivo desde la conexión una vez creada.
- Para Anaplan: leer vista: una vista guardada, creada exactamente con el segmento de filas, columnas y filtros que desea. Consulte Anaplan: leer vista más abajo.
- Para Anaplan: leer exportación: una acción de exportación que ya exista en el modelo.
- Para Anaplan: leer lista: las listas de Anaplan que componen la jerarquía que desea leer.
Autenticación
Sección titulada «Autenticación»La conexión tiene un Modo de autenticación: Básica (el valor predeterminado) o Certificado. Una conexión existente sigue funcionando sin cambios como Básica.
- Básica inicia sesión con un nombre de usuario y una contraseña de Anaplan.
- Certificado inicia sesión con un certificado emitido por una CA y su clave privada, ambos pegados como texto PEM. La clave privada debe ser RSA y no estar cifrada, y el certificado debe ser el que su administrador del espacio de trabajo de Anaplan ha registrado a su usuario de Anaplan, emitido por una CA en la que Anaplan confíe para su inquilino. PlaidCloud firma un desafío aleatorio con la clave y lo intercambia por un token de Anaplan, siguiendo el propio flujo de autenticación por certificado de Anaplan; no hay nada más que hacer una vez pegados el certificado y la clave, y la renovación del token funciona igual que en el modo Básica. Ambos campos enmascaran lo que pega, y ambos secretos se almacenan cifrados, igual que una contraseña Básica; además, cambiar de modo nunca envía las credenciales del otro modo: si cambia una conexión existente de Básica a Certificado, tendrá que pegar el certificado y la clave, ya que no se trasladan.
La autenticación multifactor de Anaplan se aplica a los usuarios que inician sesión con correo electrónico y contraseña. La autenticación por certificado es la opción sin contraseña para una conexión automatizada y programada.
El modo Certificado rechaza la operación antes de contactar con Anaplan si no se puede leer la clave o el certificado pegados, si la clave está cifrada o no es RSA, o si la clave no corresponde al certificado. Si es Anaplan quien rechaza el certificado, el error indica si ha caducado; las causas habituales son un certificado que no está registrado a un usuario de Anaplan o una CA en la que no se confía para su inquilino.
Crear la conexión
Sección titulada «Crear la conexión»-
Abra Tools > Connections y haga clic en
New Connection. -
Elija Anaplan en el menú.
-
Complete los campos:
Campo Valor Nombre Un nombre descriptivo, por ejemplo Anaplan Prod.Host de la API Opcional. Déjelo en blanco para usar el valor estándar de Anaplan, https://api.anaplan.com.Host de autenticación Opcional. Déjelo en blanco para usar el valor estándar de Anaplan, https://auth.anaplan.com.Modo de autenticación Básica (predeterminado) o Certificado. Consulte Autenticación más arriba. Nombre de usuario El nombre de usuario de la cuenta de Anaplan. Solo en el modo Básica. Contraseña La contraseña de la cuenta de Anaplan. Solo en el modo Básica. Certificado de CA Texto PEM del certificado X.509 registrado en Anaplan. Solo en el modo Certificado. Clave privada Texto PEM de la clave privada RSA del certificado, sin cifrar. Solo en el modo Certificado. ID de espacio de trabajo predeterminado Opcional. Un valor precargado por comodidad para el campo Workspace de un paso de lectura. ID de modelo predeterminado Opcional. Un valor precargado por comodidad para el campo Model de un paso de lectura. Timeout (seconds) El valor predeterminado es 30. -
Haga clic en
Test Connection. Una prueba correcta informa del correo electrónico de la cuenta de Anaplan al que corresponden las credenciales. -
Haga clic en
Create.
Anaplan: leer vista
Sección titulada «Anaplan: leer vista»Agregue un paso Anaplan: leer vista para leer una vista guardada mediante la ruta de solicitudes de lectura de gran volumen de Anaplan. La vista se lee exactamente como se guardó en Anaplan: este paso no permite seleccionar filas, columnas ni páginas. Para leer otro segmento, cree otra vista guardada en Anaplan; una partida booleana más una vista guardada es la forma habitual de filtrar allí. Una columna de datos llega con su tipo declarado de Anaplan solo cuando la vista coloca las partidas (Line Items) en el eje de columnas; con las partidas en las filas (un diseño habitual de pérdidas y ganancias) o ausentes de la vista, todas las columnas llegan como texto, y el paso lo indica. Una vista cuyo filtro no coincide con nada carga una tabla vacía con una advertencia. Un valor numérico que el paso no puede leer sin ambigüedad (con mayor frecuencia, uno que podría ser igualmente un decimal simple o una representación al estilo europeo) se rechaza en lugar de adivinarse, a menos que otro valor de la misma columna determine qué lectura es la correcta; un valor que sí se interpreta llega con precisión completa, sin error de redondeo. Consulte Anaplan: leer vista para ver la referencia completa de campos y comportamiento.
Anaplan: leer exportación
Sección titulada «Anaplan: leer exportación»Agregue un paso Anaplan: leer exportación para ejecutar una acción de exportación de Anaplan ya existente y cargar el archivo que genera. La API no puede crear una acción de exportación: créela o edítela primero en Anaplan; además, el paso no puede restringir lo que se emite: se carga exactamente lo que la acción esté configurada para exportar en Anaplan. Todas las columnas llegan como texto. Los números se solicitan con formato de EE. UU.; una columna que aun así llega con separadores de miles se carga sin cambios, como texto, con una advertencia con nombre en lugar de hacer fallar la ejecución. El paso se detiene en lugar de cargar una tabla cuando la exportación falla, se cancela, no produce datos, sigue en ejecución una vez agotado el presupuesto de sondeo del paso, o produce un archivo que no se puede vincular con la exportación o cuyo recuento de filas no coincide con el que informa la propia Anaplan. Consulte Anaplan: leer exportación para ver la referencia completa.
Anaplan: leer lista
Sección titulada «Anaplan: leer lista»Agregue un paso Anaplan: leer lista para leer una o más listas de Anaplan en una dimensión de PlaidCloud. Un solo paso lee una jerarquía compuesta completa: indique todas las listas que abarca, empezando por la raíz (por ejemplo, Region, luego Country y luego Store), en lugar de dividirla en varios pasos; la tabla de preparación se reemplaza en cada ejecución, de modo que varios pasos dirigidos a una misma tabla de preparación borrarían cada uno las filas del anterior. Cada arista se consolida con un simple +, ya que las jerarquías de listas de Anaplan no tienen peso ni signo por arista que leer. Los controles de acceso a las listas de Anaplan y la pertenencia a subconjuntos no se importan: son metadatos, no datos de la dimensión. Los ID de nodo duplicados, una referencia a un padre que no se puede resolver, referencias a padres en conflicto y un nombre de propiedad que choca con los metadatos importados se rechazan antes de cargar nada. Consulte Anaplan: leer lista para ver la referencia completa.
Anaplan como origen de Data Foundation
Sección titulada «Anaplan como origen de Data Foundation»Data Foundation puede leer el plan que contiene Anaplan (un presupuesto, un pronóstico o los resultados de un modelo de consolidación) en su Common Finance Model. Trae el plan, nunca el libro contable, y solo lee.
Data Foundation ejecuta una acción de exportación del modelo tal como está guardada, de modo que su administrador de Anaplan crea primero esa exportación. La pestaña Foundation redacta la solicitud para él. La exportación debe ser una cuadrícula plana con una fila por cada entidad, período, cuenta y departamento, y con estos encabezados de columna exactos:
| Columna | Contiene |
|---|---|
Entity |
El código de la entidad. |
Period |
El mes, en el formato YYYY-MM. |
Account |
El código de la cuenta. |
Department |
El código del departamento, en blanco cuando el plan no tiene ninguno. |
Currency |
La moneda del importe. |
Amount |
Un número simple sin separador de miles, con el signo en que se mantiene el plan (ingresos positivos). |
Luego agregue la conexión como origen en la pestaña Foundation, como con cualquier otra (consulte Conectar su ERP). Una conexión nueva solicita el User name, la Contraseña, el Workspace ID y el Model ID. Anaplan no lista entidades para marcar, así que el formulario pide una: introduzca en Nombre la entidad de la exportación que desea conservar, o déjelo en blanco para conservar todas las entidades. A continuación complete la configuración del sistema, que aparece con estos nombres:
| Configuración | Qué significa |
|---|---|
export |
El ID de la acción de exportación que se ejecutará. |
scenario |
Budget (el valor predeterminado), Forecast o Consolidated, para los resultados de un modelo de consolidación con los que cuadran las pérdidas y ganancias del grupo. |
version |
Una etiqueta que se estampa en cada fila. El valor predeterminado es Anaplan. |
Los importes se leen tal cual, con su signo natural. Una columna que llega todavía agrupada con separadores de miles se señala, no se adivina, igual que en Anaplan: leer exportación.
Consideraciones sobre la programación
Sección titulada «Consideraciones sobre la programación»El presupuesto de frecuencia de solicitudes de Anaplan está compartido en todo el inquilino: entre todas las integraciones que su organización ejecuta contra ese inquilino de Anaplan, no solo las de PlaidCloud; además, PlaidCloud no coordina las programaciones entre ejecuciones simultáneas. Varios pasos de Anaplan que se activen en el mismo minuto de cron pueden agotar ese presupuesto antes de que alguno termine. Escalone las programaciones de sus flujos de trabajo de Anaplan en lugar de ejecutarlos todos a la vez.
Relacionado
Sección titulada «Relacionado»- Anaplan: leer vista: leer una vista guardada, referencia de campos.
- Anaplan: leer exportación: ejecutar una acción de exportación, referencia de campos.
- Anaplan: leer lista: leer listas en una dimensión, referencia de campos.
- Crear y administrar una conexión