Saltar al contenido principal
Documentación
Documentación
Adaptive Planning
Última actualización: 2023-06-23
Creación de cargadores de asociación de Planning

Creación de cargadores de asociación de Planning

El cargador de asociación de Planning le permite asignar metadatos sobre las asociaciones de dimensión y nivel de usuario del área de almacenamiento provisional a
Adaptive Planning
. Las asociaciones conectan niveles y dimensiones personalizadas con los usuarios. La propiedad de nivel es un tipo de asociación de usuario que conecta a los usuarios con los niveles. A diferencia de las asociaciones de nivel normal, la propiedad de nivel también incluye otros privilegios. Consulte
Una vez que haya creado un cargador, puede ejecutarlo manualmente o programarlo para que se ejecute como parte de una tarea de integración. Consulte Creación de tareas de integración.

Requisitos previos

  • El cargador de asociación de Planning requiere datos de almacenamiento provisional de una importación de un origen de datosexistente.
  • Permisos obligatorios: Modelo, Operador de integración, Diseñador de datos

Pasos básicos

  1. Configuración del origen de datos
  2. Configuración de asignación de columnas
  3. Creación de reglas de negocio
  4. Vista previa de datos de salida del cargador
  5. Ejecución o programado del cargador

Navegación

Compass.png En el menú de navegación, vaya a
Integración
Diseño de integraciones
.

Configuración del origen de datos

La configuración del origen de datos le permite elegir la tabla de origen que se va a utilizar para los datos de almacenamiento provisional de integración y seleccionar qué asociaciones cargar.
  1. Seleccione
    Crear nuevo cargador
    en el panel
    Cargadores
     de la Biblioteca de componentes.
  2. Seleccione
    Cargador de asociación
    de Planning
    como tipo de cargador. Introduzca un nombre para el cargador.
  3. Haga clic en
    Crear
    .
  4. Introduzca la información de
    Propiedades generales
     del cargador de asociaciones en la
    ficha Configuración de origen de datos
    :
    • Tabla de origen
      : permite seleccionar la tabla de origen de la lista desplegable. Las tablas de origen de la lista corresponden a todas las tablas disponibles en el área de almacenamiento provisional a la que tiene acceso.
    • Perfil de asignaciones
      : puede vincularlo a un perfil de asignación como parte del proceso de creación del cargador. Seleccione el perfil de asignaciones en la lista desplegable. Los perfiles de asignaciones de la lista son a los que tiene acceso. Consulte la sección del perfil de asignaciones del cargador de datos de Planning. Este perfil de asignaciones, junto con las asignaciones cargadas como parte de los cargadores de metadatos, asignan los niveles y las dimensiones de planificación. Consulte Creación de cargadores de datos de Planning. Ejemplo: si el cargador de asociación tiene el valor de columna de nivel "999999" (o para Workday, un ID), el perfil de asignaciones determina a qué nivel de planificación se refiere.
    • Nivel o dimensión
      : seleccione el nivel para la propiedad o la asociación de nivel. Seleccione una dimensión para cargar asociaciones de dimensiones.
    • Atributo:
       seleccione un atributo de Adaptive Planning para el nivel o la dimensión (opcional). Esto le permite asignar y cargar asociaciones para atributos de nivel o dimensión.
    • Modo
      : seleccione
      Actualizar
       para modificar asociaciones o asignaciones de propiedad en un subconjunto de niveles. Esto actualiza el nivel, no el usuario. Las actualizaciones del nivel requieren que todos los usuarios estén asociados con ese nivel en la carga útil. Seleccione
      Sustituir todo
       para eliminar todos los usuarios de las asociaciones mencionadas en la carga útil y sustituirlos.
      • Si utiliza Adaptive Planning con Workday Human Capital Management o Workday Financials,
        Modo
         se rellena automáticamente con la opción
        Actualizar
        .
      • Si no utiliza Adaptive Planning con Workday Human Capital Management o Workday Financials, el
        Modo
         se rellena automáticamente con la opción
        Sustituir todo
        .
    • Seguir con avisos
      : marque esta opción para seguir ejecutando el cargador con avisos. Si la deja sin marcar, el cargador se detendrá cuando encuentre una advertencia. Activar esta opción significa que el cargador omite las dimensiones o niveles no asignados y crea una advertencia en los registros mientras permite que el cargador continúe con el procesamiento.
    • Nivel de registro:
       elija el tipo de detalles que se van a capturar al ejecutar el cargador.
      • Desactivado
        : no se registran errores.
      • Error
        : registra únicamente los errores graves.
      • Información
        : registra la información básica, como cuándo se actualizó el cargador.
      • Detallado
        : información detallada sobre todas las fases y acciones. Se utiliza principalmente para depuración o auditoría.

Configuración de asignación de columnas

La asignación de columnas le permite asignar columnas del origen de datos a las asociaciones disponibles en
Modelado > Gestión de modelos > Niveles
 o
Modelado > Gestión de modelos > Dimensiones
. Debe asignar
Usuario
 y
Columnas de Planning
.
Si es un cliente de Workday que ejecuta una sincronización de usuario en este entorno, la columna Usuario debe asignarse a la columna de origen que contiene los ID de Workday. Si no ha ejecutado la sincronización de usuario o no es cliente de Workday, la columna de usuario debe asignarse a la columna de origen que contiene los nombres de usuario o los correos electrónicos.
Si hay varias
columnas de Planning
 para asignar, utilice el filtro
Mostrar
para seleccionar:
  • Todos:
     muestra todos los usuarios.
  • Obligatorias
    :
    muestra todas las columnas de Planning obligatorias, como Usuario y Nivel.
  • Sin asignar
    :
    muestra todas las columnas de Planning sin asignar.
  • Asignadas
    :
    muestra todas las columnas de Planning asignadas.
Puede usar el campo
Buscar
para buscar columnas. Introduzca un nombre completo o parcial para realizar la búsqueda y haga clic en la lupa. Cualquier columna de almacenamiento provisional que coincida con la búsqueda aparecerá en los resultados.
Asignación de columnas
  1. Haga clic en la ficha
    Asignación de columnas
    . La ficha Asignación de columnas tiene las siguientes columnas:
    • Estado
      : una marca de verificación Columna asignada indica una columna asignada. Un signo de exclamación Columna sin asignar indica una columna sin asignar.
    • Columna de Planning
      : muestra todas las columnas de Planning disponibles para asignar. Las columnas de Planning obligatorias se indican mediante texto en negrita con un asterisco.
    • Columna de origen
      : muestra las columnas de la tabla de almacenamiento provisional elegida en la Configuración de origen de datos.
  2. Seleccione una columna sin asignar y haga clic en el menú desplegable. Aparece una lista de columnas a las que puede asignarse en la lista desplegable. A medida que asigna las columnas, el indicador de estado cambia de rojo IntegrationMappingUnmapped.png a verde IntegrationMappingMapped.png.
Columnas de asignación para propiedad de nivel
Si desea cargar solo la propiedad del nivel, no asigne un identificador para el código de asociación del nivel en la
columna de origen
. La propiedad del nivel en
Administración
 >
Asociaciones
 proviene de dejar el código de asociación vacío.
Columnas de asignación para asociación de nivel y dimensión
Si desea cargar asociaciones de nivel y dimensión, asigne un identificador como el
ID de referencia
 para el código de asociación en la
columna de origen.
No puede cargar la propiedad de nivel y la asociación de nivel en un solo cargador. Cree un cargador para la propiedad del nivel y un cargador independiente para la asociación de nivel.
Columnas de asignación para asociación de atributos
Si desea cargar atributos de nivel o dimensión con asociaciones, asígnelos en la
Columna de origen
. Los atributos aparecen en la parte inferior de las asignaciones, debajo de Nombre de asociación.
Anulación de la asignación de columnas
Puede anular la asignación de columnas para ignorar los datos de almacenamiento provisional que no quiera cargar. También puede anular la asignación de las columnas de una en una después de las ejecuciones del cargador para solucionar los problemas de las columnas que generan errores en los registros.
Para anular la asignación de columnas, haga clic en
Anular asignación
 y elija una de las siguientes opciones:
  • Desasignar todo
    : anula la asignación de todas las columnas.
  • Desasignar selección
    : anula la asignación de las columnas seleccionadas.
Al anular la asignación de una columna, el icono de estado cambia a un signo de exclamación IntegrationMappingUnmapped.png.

Creación de reglas de negocio

Puede usar reglas de negocio para crear expresiones SQL que limiten los datos de almacenamiento provisional que están disponibles para cargar. Solo se cargarán los registros que cumplan sus criterios de filtro.
La ficha
Reglas de negocio
 contiene un área de texto para introducir SQL:
Para crear un filtro SQL, siga estos pasos:
  1. En la ficha
    Reglas de negocio
    , seleccione
    Filtro SQL
    . Haga clic en
    Editar
    .
  2. Introduzca una expresión SQL. Puede hacer clic en un elemento de la lista
    Columnas disponibles
     para introducir esa columna en la expresión SQL en lugar de escribirla.
  3. Haga clic en
    Aplicar
    para comprobar su sintaxis SQL. Los errores de sintaxis se indican con el borde alrededor de la expresión en color rojo. Mantenga el cursor sobre el editor de SQL para ver la información sobre el error de sintaxis.
    Para obtener ayuda detallada sobre la sintaxis SQL, haga clic en
    ayuda en línea
    en la sección Notas del cuadro de diálogo Editar filtro SQL. Consulte Referencia: expresiones SQL.
  4. Corrija los errores de sintaxis y haga clic en
    Aplicar
    . Solo se importarán las filas de almacenamiento provisional que coincidan con la expresión SQL cuando ejecute el cargador.

Vista previa de datos de salida del cargador

Puede obtener una vista previa de los datos de salida del cargador antes de realizar una carga completa para comprobar que las asignaciones funcionan como desea. También puede descargar su resultado como un archivo XML para verificar manualmente las asociaciones de propiedad a nivel de usuario de su origen de datos con sus requisitos antes de cargarlas.
Haga clic en
Vista previa de datos de salida del cargador
 en el panel Acciones.
El cargador se ejecuta y aplica todas las transformaciones y reglas de negocio como parte de la ejecución. Una ventana emergente de estado muestra los pasos que ha ejecutado el cargador. Si hay valores de asociación de usuario para cargar, el cargador crea un archivo XML y envía una notificación por correo electrónico con los datos de salida del cargador como un archivo adjunto XML comprimido.
Una ventana emergente adicional le permite descargar la vista previa de datos de salida del cargador como un archivo XML comprimido después de que el cargador se ejecute correctamente. La ventana emergente de descarga puede tardar un momento en aparecer, según el número de valores de asociación y el tamaño del archivo.
Corrección de errores de validación
Cuando se ejecuta la vista previa de datos de salida del cargador o la carga manual, se validan los datos de origen en busca de errores. Los ejemplos de validaciones incluyen comprobaciones si se dan los siguientes casos:
  • Falta el valor de ID de origen para el valor de Usuario o Nivel y Dimensión (vacío) en los datos.
  • El ID de origen no está asignado.

Ejecución del cargador

Después de guardar un Cargador de asociación de Planning con todos los parámetros de configuración obligatorios, el cargador se puede ejecutar manualmente o como una tarea de integración programada.
Espere entre 15 y 30 minutos entre cada ejecución del cargador de asociación de Planning para que
Adaptive Planning
 tiene hora para sincronizar con su importación. Las importaciones más grandes tardan más en sincronizarse. El tiempo de espera depende del tamaño del modelo y otros factores.
Puede importar directamente desde el sistema de origen o puede ejecutar el cargador utilizando valores de almacenamiento provisional que ya se hayan importado. Cuando se ejecute el cargador, seleccione de entre estas opciones el comportamiento que desee. Elija
Omitir importación de datos
para usar la tabla de almacenamiento provisional existente para la carga. No es posible omitir la importación de datos cuando se utilizan hojas de cálculo como origen de los datos.
Como parte del proceso de ejecución, el cargador comprueba que los datos de la tabla de almacenamiento provisional se hayan asignado correctamente. Se aplican varias validaciones durante la carga. Cualquier error que se produzca durante la carga indicará lo que se debe resolver para que la importación se lleve a cabo correctamente.
Incluir el Cargador de asociación de Planning en una tarea de integración
Cualquier tarea de integración puede contener uno o varios cargadores. Una tarea también puede contener otras tareas de integración, así como cargadores de métricas y cargadores con secuencias de comandos de Discovery.
Recomendación: tenga tareas de integración independientes para cada cargador.
Si una tarea contiene varios cargadores, se presenta la configuración de cada uno cuando se ejecuta la tarea. Si hay una configuración común/compartida utilizada en los cargadores dentro de una tarea, la tarea solo la solicita una vez. Puede sustituir las listas de valores de parámetros.
Para las ejecuciones programadas de la tarea, se utilizan los valores por defecto de la configuración almacenados cuando se crearon los cargadores.