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

Creación de cargadores de atributos 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 atributos de Planning le permite asignar metadatos sobre atributos de la zona de almacenamiento provisional a
Adaptive Planning
. Utilice el cargador de atributos para importar atributos de forma masiva desde un sistema externo y sincronizarlos, en lugar de crearlos uno por uno en el campo de atributos Administración. Una vez que haya creado un cargador, puede ejecutarlo manualmente o programarlo para que se ejecute como parte de una tarea de integración.
Vea el vídeo:
 1 m 32 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 atributos de Planning requiere datos de almacenamiento provisional de una 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, Modelo

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 de origen de datos le permite elegir la tabla de origen que se va a utilizar de los datos de almacenamiento provisional, e indicar si se deben crear nuevos atributos automáticamente.
Recomendación: guarde con frecuencia mientras crea su cargador y lo actualiza. 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. Seleccione
    Crear nuevo cargador
    en la sección Cargadores de la Biblioteca de componentes.
  2. Seleccione
    Cargador de atributos de Planning
     como tipo de cargador. Introduzca un nombre para el cargador.
  3. Seleccione
    Crear
    .
  4. Introduzca la siguiente información de propiedades generales del cargador de atributos:
    • Tabla de origen
      : permite seleccionar la tabla de origen de la lista desplegable. La lista contiene todas las tablas disponibles en el área de almacenamiento provisional a las que tiene acceso.
    • Atributo de Planning
      : seleccione el atributo dentro de
      Adaptive Planning
       para cargar en.
    • Crear valor de atributo si no se encuentra en Planning
      : seleccione esta opción para crear automáticamente nuevos valores de atributo que se hayan encontrado en el sistema de origen, pero que no se hayan encontrado en Modelado> Gestión de modelos> Atributos. Al anular la selección, solo se actualizan los valores de atributo existentes en su modelo.
    • Publicar cambios de publicación de administrador pendientes
      : si Concepto: publicación de administrador tiene cambios de flujo de trabajo pendientes, seleccione esta opción para publicar los cambios.
    • 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 propiedades de los atributos disponibles en
Modelado
 >
Gestión de modelos
 >
Atributos
. 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.
Si hay varias columnas para asignar, utilice el filtro
Mostrar
para seleccionar lo siguiente:
  • Todas
    : muestra todas las columnas de Planning.
  • Obligatorias
    : muestra todas las columnas de Planning obligatorias, como las de ID de elemento principal y Atributo.
  • Sin asignar
    : muestra todas las columnas de Planning sin asignar.
  • Asignadas
    : muestra todas las columnas de Planning asignadas.
Utilice
Categoría
para seleccionar lo siguiente:
  • Todas
    : muestra todas las columnas. Los atributos no utilizan categorías.
Puede usar el campo
Búsqueda
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
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 Descripción.
  • Columna de origen
    : muestra las columnas de la tabla de almacenamiento provisional elegida en la Configuración de origen de datos.
  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.
Asignación de atributos principales
La columna ID de elemento principal indica el ID de un valor de atributo principal. Para cargar en el atributo que está en la posición más alta 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 valores de atributos secundarios por debajo del nivel superior.
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.
  • 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 de Editar filtro SQL. Consulte Referencia: 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 valor de atributo sin indicar su atributo principal.
  • A un atributo se le asigna un valor de atributo que no puede encontrar.
  • Falta el valor de ID de origen del atributo (vacío) en los datos.
  • Hay ID de origen o nombres de atributo 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.
  • Un nodo existente movido a un nuevo nodo y
    la opción Crear valor de atributo si no se encuentra en Planning
     está desactivada. Un atributo existente se mueve a un nuevo nodo cuando el cargador se configuró para no crear nuevos valores de atributo.
  • Los datos tienen una referencia cíclica en su jerarquía. Un ParentID se refiere a su propio elemento secundario como principal.
También puede descargar el resultado de vista previa como un archivo XML para comparar manualmente los atributos de su origen de datos con sus requisitos 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 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 atributos de Planning. Al cambiar la configuración desde aquí, importará 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 irá mostrando los pasos a medida que se ejecuta el cargador. Si hay atributos 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 atributos, el archivo zip contendrá un mensaje que indica que no se ha cargado ninguno.
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 la cantidad de atributos y el tamaño del archivo.

Ejecución del cargador

Después de guardar un Cargador de cuenta de Planning con la configuración requerida, ejecútelo manualmente o como una tarea de integración programada.
Espere entre 15 y 30 minutos entre cada ejecución del cargador de atributos 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.
Para ejecutar el cargador manualmente, haga clic en
Ejecución manual
 en el panel Acciones.
Puede cargar atributos directamente desde el sistema de origen o ejecutar el cargador utilizando valores de almacenamiento provisional que ya se hayan importado. Cuando se ejecute el cargador, seleccione cuál de estos comportamientos desea. 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.
Introducción del cargador de atributos 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
Tableros de control
 cargadores de métricas y cargadores con secuencia de comandos.
Recomendación: use tareas de integración diferentes 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.