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

Creación de cargadores de nivel de Planning

Los cargadores de metadatos sincronizan la información jerárquica de los sistemas de origen en las jerarquías de su modelo de planificación. Sus jerarquías deben existir ya en su sistema de origen antes de intentar realizar la sincronización.
El cargador de niveles de Planning le permite asignar metadatos sobre jerarquías organizativas de la zona de almacenamiento provisional a
Adaptive Planning
Utilice el cargador de niveles de Planning para importar niveles de forma masiva, en lugar de crearlos uno por uno en el administrador de niveles. Una vez creado un cargador, puede ejecutarlo manualmente o programarlo para que se ejecute como parte de un
Integración
 tarea
Vea el vídeo:
 1 min 36 s

Pasos básicos

  • Configuración del origen de datos
  • Configuración de asignación de columnas
  • Creación de reglas de negocio
  • Vista previa de datos de salida del cargador
  • Ejecución o programado del cargador

Requisitos previos

El cargador de niveles de Planning requiere datos de almacenamiento provisional de la importación de un origen de datos existente. Tome nota del origen de datos que quiera utilizar.
Permisos obligatorios: Operador de integración, Diseñador de datos

Navegación

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

Introducción de la 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, e indicar si quiere que se creen nuevos niveles de forma automática.
Recomendación: guarde con frecuencia mientras crea y edita el cargador. Haga clic en
Guardar
 en el panel Acciones. Para descartar los cambios que no se hayan guardado, haga clic en
Cerrar
 y, a continuación, en
No
.
  1. Haga clic en
    Crear nuevo cargador
     en la sección Cargadores de la Biblioteca de componentes.
  2. Seleccione
    Cargador de niveles 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 niveles de Planning:
    • Tabla de origen
      : seleccione 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.
    • Crear nivel si no se encuentra en Planning
      : marque esta opción para crear automáticamente nuevos niveles que se encuentren en el sistema de origen, pero que no se encuentren en
      Modeling
      Model Management
      Levels
      . Desmarque la opción de actualizar solo los niveles existentes en su modelo.
    • Propagar actualizaciones de nivel aplicables a elementos secundarios
      :
      marque la opción para
      actualizar los niveles secundarios si el cambio implica una propiedad en cascada. Si esta opción no está marcada, solo cambiará el nivel actualizado explícitamente.
    • Eliminar elementos de flujo de trabajo al desactivar flujo de trabajo
      :
      marque esta opción para eliminar
      elementos dentro del flujo de trabajo si desactiva los flujos. Si se desmarca, los elementos del flujo de trabajo no se eliminarán cuando el flujo de trabajo esté desactivado.
    • Eliminar cifras reales inaccesibles al actualizar disponibilidad de nivel
      : si la fecha inicial o final de las cifras reales de un nivel cambia para que las cifras reales sean inaccesibles, elimine los datos de cifras reales a los que no se pueda acceder.
    • Publicar cambios de publicación de administrador pendientes
      : si Concepto: publicación de administrador tiene cambios de flujo de trabajo pendientes, marque esta opción para publicar los cambios.
    • Maintain existing order in Planning:
       seleccione esta opción para mantener el criterio de clasificación del nivel existente que ya se utiliza en Adaptive Planning.
    • Seguir con avisos
      : seleccione esta opción para continuar la carga cuando encuentre mensajes de aviso.
    • 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 la asignación de columnas

La asignación de columnas le permite asignar columnas del origen de datos a los niveles disponibles en
Modelado
de niveles
de gestión de modelos
. 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 cada ejecución del cargador para solucionar los problemas de las columnas que generan errores en los registros.
La única forma de obtener una lista de los ID de nivel existentes es utilizar la API exportLevels . El ID de nivel no aparece en ninguna parte de la interfaz de usuario de la aplicación. La columna de ID de origen para niveles se convierte en el ID de nivel cuando se carga.
Si hay varias columnas para asignar, utilice el filtro
Mostrar
 para seleccionar:
  • Todo
    : muestra todas las columnas de Planning.
  • Obligatorio
    : muestra todas las columnas de Planning que son obligatorias, como las columnas ID de elemento principal y Nivel.
  • Sin asignar
    : muestra todas las columnas de Planning que están sin asignar.
  • Asignado
    : muestra todas las columnas de Planning que están asignadas.
Utilice el campo
Categoría
para seleccionar:
  • Detalles de nivel
    : muestra columnas relacionadas con los detalles de nivel, como Nombre corto, Moneda y En flujo de trabajo. En flujo de trabajo debe haber un valor booleano de 1 para verdadero o 0 para falso.
  • Configuración de eliminaciones
    : muestra columnas relacionadas con la configuración de eliminaciones, como nivel de eliminación y socio comercial de eliminación. Estos valores booleanos deben ser 1 para verdadero o 0 para falso.
  • Configuración de versión
    : muestra columnas relacionadas con la configuración de versión, como inicio y final de cifras reales. Estos valores deben tener formatos de fecha, como 01/01/2010.
  • Atributos de nivel
    : muestra columnas relacionadas con atributos de nivel.
  • Dimensiones de nivel
    : muestra columnas relacionadas con las dimensiones de nivel.
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
    Asignación de columnas
    .
  2. Seleccione una columna sin asignar del menú desplegable. Las columnas disponibles para asignar se muestran la lista. A medida que asigna las columnas, el indicador de estado cambia de un signo de exclamación IntegrationMappingUnmapped.png a una marca de verificación IntegrationMappingMapped.png.
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 en una hoja. La lista de columnas de Planning incluye un conjunto de columnas de Planning obligatorias, seguidas de todas las demás columnas de Planning. Las columnas de Planning obligatorias se indican mediante texto en negrita con un asterisco e incluyen una columna de valor. Las columnas no obligatorias incluyen el Nombre corto y la Moneda.
  • Columna de origen
    : muestra las columnas de la tabla de almacenamiento provisional elegida en la configuración de origen de datos.
Cuando está activada la opción
La importación de datos crea automáticamente valores de dimensión
, puede asignar atributos por código. El nombre de atributo se convierte en el código automáticamente.
Asignación de cuentas principales de niveles
La columna de ID de elemento principal indica el ID del principal de un nivel. Para cargar en el nivel más alto de una jerarquía, el valor de ID de elemento principal en los datos de origen debe estar vacío. El ID de elemento principal también debe estar vacío si desea crear un nivel secundario por debajo del nivel superior.
Consulte Ejemplo: carga de niveles desde orígenes de datos de hoja de cálculo para ver un ejemplo de cómo se asignan los niveles y sus principales a la planificación.
Anulación de la asignación de columnas
Para anular la asignación de columnas, haga clic en
Desasignar
 y elija:
  • 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.
Recomendación: además de utilizar la opción de desasignar para solucionar los errores e ignorar las columnas, puede usarla a modo de ayuda con la gestión de cambios. Cuando se introducen nuevas columnas en un origen de datos, puede anular la asignación de las columnas más antiguas para asignar las nuevas.

Descarga y carga de asignaciones

Puede descargar, modificar y luego cargar asignaciones para que los cargadores resuelvan rápidamente los errores de asignación. Al cargar, se ejecuta una acción de sustitución de todo o nada. Solo se procesa una hoja de asignaciones del archivo al cargarlo. Las hojas adicionales de asignaciones generarán errores y cancelarán la carga.
  1. Haga clic en
    Descargar asignaciones de miembros
     en el panel
    Acciones
    .
  2. Descargue el archivo .XLSX. También recibirá un correo electrónico o una notificación de Workday con un vínculo de descarga para el archivo de asignaciones.
  3. Abra el archivo y busque los valores de la tabla de almacenamiento provisional en la hoja de asignaciones que causa errores.
    Cualquier celda marcada como (NO VÁLIDA) en las columnas
    Código de Planning
     o
    Nombre de Planning
     indica que este código ya no existe en Workday Adaptive Planning.
  4. Corrija los errores y haga clic en
    Cargar asignaciones de miembros
     para cargar el archivo. La columna
    Solo lectura
     no se carga.
  5. Vuelva a ejecutar el cargador.
No haga clic en
Borrar asignaciones de miembros
 a menos que se lo indique su socio de implementación o el servicio de asistencia técnica de Workday Adaptive Planning.

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 incorporar esa columna a 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 online
     en la sección Notas del cuadro de diálogo Editar filtro SQL. Consulte la Referencia de expresiones SQL para obtener más información.
  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 para comprobar las asignaciones y corregir los errores de validación antes de ejecutar el cargador.
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:
  • Se crea un subnivel sin indicar su nivel principal.
  • A un atributo de nivel se le asigna un valor de atributo que no puede encontrar.
  • Falta el valor de ID de origen del nivel (vacío) en los datos.
  • Hay ID de origen o nombres de nivel duplicados en los datos. Los ID de origen deben ser exclusivos.
  • Un ParentId coincide con el ID de origen de los datos. Si es así, la columna se refiere a sí misma como principal.
  • Al importar subniveles, la raíz del subnivel se asigna a un nodo existente en
    Adaptive Planning
    . El parentID no está en los datos de origen de un nuevo nodo introducido en
    Adaptive Planning
    .
  • Un nodo existente se ha movido a un nuevo nodo y el indicador Crear nuevo está desactivado. Se está moviendo un nivel existente a un nuevo nodo cuando el cargador estaba configurado para no crear nuevos niveles.
  • Los datos tienen una referencia cíclica en su jerarquía. Un ParentId se refiere a su propio elemento secundario como principal.
  • Un nivel está configurado como socio comercial de eliminación y uno de sus niveles secundarios como nivel de eliminación. Un nivel establecido como socio comercial de eliminación no puede tener un nivel secundario que sea un nivel de eliminación.
También puede descargar la vista previa de datos de salida como archivo XML para comprobar manualmente los niveles de su origen de datos con sus necesidad antes de cargarlos.
  1. Haga clic en
    Vista previa de datos de salida del cargador
     en el panel Acciones.
  2. Introduzca la configuración de la vista previa de datos de salida del cargador (opcional). La información que puede introducir varía en función del origen de datos que elija para este cargador de niveles de Planning. Al cambiar la configuración desde aquí se importan nuevos datos a las tablas y columnas de almacenamiento provisional.
  3. Haga clic en
    Vista previa de datos de salida del cargador
    .
El cargador se ejecutará, incluidas todas las transformaciones y reglas de negocio. Una ventana emergente de estado muestra los pasos a medida que los ejecuta el cargador. Si hay niveles disponibles para cargar, el cargador crea un archivo XML y envía una notificación por correo electrónico con los datos de salida como archivo adjunto XML comprimido. Si no se cargan niveles, el archivo zip contendrá un mensaje que indicará que no se ha cargado ninguno.
Otra ventana emergente le permite descargar la vista previa de datos de salida del cargador como archivo XML comprimido una vez ejecutado el cargador correctamente. La ventana emergente de la descarga puede tardar un poco en aparecer, en función del número de niveles y el tamaño del archivo.

Ejecución del cargador

Después de guardar un cargador de niveles de Planning con la configuración obligatoria, ejecútelo manualmente o como una tarea de integración programada.
Espere entre 15 y 30 minutos entre cada ejecución del cargador de niveles de Planning para que
Adaptive Planning
 tiene hora para sincronizar con su importación. Las importaciones de mayor tamaño tardan más tiempo en sincronizarse. El tiempo de espera depende del tamaño del modelo y otros factores.
Para ejecutar el cargador manualmente, haga clic en
Ejecución manual
 en el panel Acciones.
Puede cargar niveles directamente desde el sistema de origen o ejecutar el cargador con 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.
Inclusión del cargador de niveles de Planning en una tarea de integración
Cualquier tarea de integración puede tener uno o varios cargadores. Una tarea puede contener otras tareas de integración, como cargadores con secuencia de comandos.
Recomendación: tenga tareas de integración independientes para cada cargador.
Si una tarea contiene varios cargadores, los parámetros de cada cargador se muestran en una lista de valores cuando se ejecuta la tarea. Si hay un parámetro común o compartido en los cargadores de una tarea, la tarea solicita el parámetro solo una vez. Puede sustituir las listas de valores de parámetros.
Para ejecuciones programadas de la tarea, se utilizan los valores por defecto de los parámetros de los cargadores.
Mensajes y avisos de solución de problemas
Consulte Referencia: mensajes de registro para cargadores de niveles de Planning para obtener descripciones de los mensajes registrados durante una carga.