Saltar al contenido principal
Documentación
Documentación
Adaptive Planning
Última actualización: 2023-06-23
Cargadores de dimensiones de Planning

Cargadores de dimensiones 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.
Las solicitudes del cargador de dimensiones de Planning están limitadas a la actualización de un máximo de 10 000 valores de dimensión de una dimensión jerárquica o 40 000 valores de dimensión de una dimensión plana. Estos límites no se aplican a la creación de nuevos valores de dimensión en una solicitud del cargador.
El cargador de dimensiones de Planning le permite asignar metadatos sobre valores de dimensión de la zona de almacenamiento provisional a
Adaptive Planning
. El beneficio principal del cargador de dimensiones de Planning es que le permite importar valores de dimensión de forma masiva, en lugar de crearlos uno por uno en Modelado > Gestión de modelos > Dimensiones. Una vez que haya creado un cargador, puede ejecutarlo manualmente o programarlo para que se ejecute como parte de una tareade integración.

Para crear un cargador de dimensiones de Planning, siga este flujo:
  1. Introducción de la configuración del origen de datos
  2. Configuración de la asignación de columnas
  3. Creación de reglas de negocio
  4. Vista previa de datos de salida del cargador
  5. Ejecución o programación del cargador

Antes de comenzar

El cargador de dimensiones de Planning requiere datos de almacenamiento provisional de una importación de un origen de datosexistente.

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 desea usar de los datos del almacenamiento provisional, seleccionar la dimensión de Planning donde se cargarán y si se deben crearse o no nuevos valores de dimensión de forma automática.
  1. Navegue a
    Integración > Diseño de integraciones
    .
  2. Haga clic en
    Crear nuevo cargador
    en la sección Cargadores de la biblioteca de componentes.
  3. Seleccione
    Cargador de dimensiones de Planning
     como tipo de cargador. Introduzca un nombre para el cargador.
  4. Haga clic en
    Crear
    .
Recomendación: guarde con frecuencia mientras crea y edita el cargador haciendo clic en
Guardar
en el panel Acciones. Puede descartar cualquier cambio no guardado haciendo clic en
Cerrar
y luego en
No.
Introduzca la información de propiedades generales del cargador de dimensiones de Planning:
  • Tabla de origen
    : seleccione la tabla de origen de la lista desplegable. Las tablas de origen de la lista son todas las tablas disponibles en el área de almacenamiento provisional a las que tiene acceso.
  • Dimensión de Planning:
     elija una dimensión de todas las dimensiones donde cargar el origen. Las dimensiones que aparecen en la lista proceden de Modelado > Gestión de modelos > Dimensiones.
  • Crear valor de dimensión si no se encuentra en Planning:
     marque la casilla para crear automáticamente nuevos valores de dimensión que se encuentren en el sistema de origen, pero no en Modelado > Gestión de modelos > Dimensiones. Si esta opción no está marcada, solo se actualizarán los valores de dimensión existentes y no se crearán nuevas dimensiones.
    • Si la dimensión donde carga no tiene activada la opción "La importación de datos crea automáticamente valores de dimensión" en Modelado > Gestión de modelos > Dimensiones, el cargador le avisará.
  • Nivel de registro:
     elija el tipo de detalles que se registrarán al ejecutar el cargador.
    • Error
      :
       registra únicamente los errores graves.
    • Información
      :
       registra información básica, como el momento en que se actualiza el cargador.
    • Detallado
      :
       proporciona información detallada sobre todas las fases y acciones. Este nivel se utiliza principalmente para la depuración o la auditoría, ya que puede generar más información de registro de la que resulta práctica para el uso habitual.

Configuración de la asignación de columnas

La asignación de columnas le permite asignar columnas del origen de datos a los valores de dimensión disponibles en Modelado > Gestión de modelos > Dimensiones.
Si hay varias columnas para asignar, puede usar el filtro
Mostrar
para seleccionar:
  • Todo
    : muestra todas las columnas de Planning.
  • Obligatorio
    : muestra todas las columnas de Planning que son obligatorias.
  • Sin asignar
    : muestra todas las columnas de Planning que están sin asignar.
  • Asignado
    : muestra todas las columnas de Planning que están 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
    Asignación de columnas
    .
    La ficha Asignación de columnas contiene:
    • Estado:
      indica si se ha asignado una columna de Planning. 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 que no son obligatorias incluyen el nombre corto y la descripción.
    • 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 la lista 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.
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.
Consulte Ejemplo: carga de valores de dimensión de orígenes de datos de hoja de cálculo para ver un ejemplo de cómo se asignan los valores de dimensión y sus principales a Planning.
Cambio de nombre del valor de dimensión de Planning en la carga
Para cambiar el nombre de un valor de dimensión de Planning en el momento de su carga:
  1. Seleccione la columna Origen que identifica de forma exclusiva el valor de dimensión en el origen.
  2. Asigne la columna de ID con el ID de valor de dimensión.
  3. Asigne el nombre al nombre del valor de dimensión.
Anulación de la asignación de columnas
Para anular la asignación de columnas, haga clic en
Anular asignación
y elija:
  • Desasignar todo
    :
     anula la asignación de todas las columnas.
  • Unmap Selected
    :
     anula la asignación solo de las columnas seleccionadas.
Al anular la asignación de una columna, su icono de estado de asignación cambia a rojo IntegrationMappingUnmapped.png.
Asignación de atributos asociados a las dimensiones de lista
Puede asociar atributos con una dimensión de lista asignando columnas de una importación de origen de datos.
La asociación de atributos con dimensiones solo es posible en el caso de las dimensiones de lista. No puede asociar atributos con dimensiones jerárquicas.
Dentro de
Adaptive Planning
 puede visitar
Gestión de modelos
 >
Dimensiones
 y hacer clic en una dimensión para ver sus detalles y averiguar si se trata de una dimensión de lista.
En Configuración de origen de datos, seleccione una dimensión de lista como
Dimensión de Planning
.
Los atributos están disponibles como columnas en Asignación de columnas ya que la dimensión es una dimensión de lista.
Dado que las dimensiones de lista no son jerárquicas, parentId no es una opción para la columna de origen.

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 del almacenamiento provisional que están disponibles para cargar. Solo se cargarán los registros que cumplan sus criterios de filtro.
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 de SQL, puede hacer clic en "
    ayuda online
    " en la sección Notas del cuadro de diálogo Editar filtro SQL. También puede visitar la Referencia de 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 se ajustan a lo que necesita. También puede descargar su resultado como archivo XML para verificar manualmente los valores de dimensión de su origen de datos con sus requisitos antes de cargarlas.
  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 dimensiones 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 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 dimensión 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 archivo adjunto XML comprimido.
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 descarga puede tardar un momento en aparecer en función del número de valores de dimensión y el tamaño del archivo.
Corrección de errores de validación
Cuando se cargan valores de dimensión, se validan los datos de origen para detectar los siguientes errores:
  • Falta el valor de ID de origen del valor de dimensión (vacío) en los datos.
  • Hay IDs de origen duplicados en los datos. Los IDs de origen deben ser exclusivos.
  • Falta un nombre de valor de dimensión (vacío) en los datos.
  • Hay nombres de valores de dimensión duplicados en los datos.
  • Un ParentId coincide con el ID de origen de los datos. En este caso, la columna se refiere a sí misma como elemento principal.
  • Al importar un subárbol, la raíz del subárbol se asigna a un nodo existente en Planning. En este caso, el parentID no está en los datos de origen de un nuevo nodo que se va a introducir en Planning.
  • Un nodo existente se ha movido a un nuevo nodo y el indicador Crear nuevo está desactivado. En este caso, un valor de dimensión existente se mueve a un nuevo nodo cuando se le ha indicado explícitamente al cargador que no cree nuevos valores de dimensión.
  • Los datos tienen una referencia cíclica en su jerarquía. En este caso, un ParentId se refiere a su propio elemento secundario como principal.

Ejecución del cargador

Después de guardar un cargador de dimensiones 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 dimensiones 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.
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.
Inclusión del cargador de dimensiones 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 al crear los cargadores.
Mensajes y avisos de solución de problemas
Para obtener una explicación de los mensajes registrados durante una carga, consulte Referencia: mensajes de registro para cargadores de dimensiones de Planning.

Carga de cambios en un valor de dimensión de origen

El cargador de dimensiones de Planning puede cambiar el nombre de un valor de dimensión en la carga si ya se ha establecido una asignación con el valor de dimensión de origen.
Esta tabla ilustra las asignaciones que el cargador ya ha establecido. El valor de dimensión de origen "EE. UU." se asigna con la columna de ID de origen "1001".
Valor de dimensión de Planning
Columna de ID de origen
Valor de dimensión de origen
EE. UU.
1001
EE. UU.
Canadá
1002
Canadá
En el sistema de origen, si "EE. UU." cambia a "Estados Unidos", el cargador de dimensiones de Planning puede aplicar este cambio en la carga porque el cargador mantiene la asignación entre la columna de ID de origen "1001" y el ID interno de Planning para el valor de dimensión "Estados Unidos".
Valor de dimensión de Planning
Columna de ID de origen
Valor de dimensión de origen
EE. UU.
1001
Estados Unidos
Canadá
1002
Canadá
La ejecución del cargador cambiará el valor de dimensión en Planning de "EE. UU." a "Estados Unidos".