Elementos de un paquete
Los elementos que puede utilizar dependen del tipo de conexión de SAP System:
- Conexión RFC: tablas, tablas virtuales, filtros, repositorios, objetos en tiempo real e informes
- Conexión OData: solamente tablas, tablas virtuales y filtros. Repositorios, objetos en tiempo real e informes no están disponibles.
La mayoría de las secciones de un elemento presentan las mismas acciones:
| Acción | Qué hace |
|---|---|
| Añadir | Añade una nueva entrada a la sección |
| Ir a, Abrir | Lleva a la sección enlazada dentro del paquete |
| Icono de engranaje | Abre la configuración de la entrada |
| Cubo | Elimina la entrada o el Link entre los dos elementos |
Si una sección tiene una lista desplegable, utilícela para elegir la entrada. Los propios elementos se agregan mediante el botón correspondiente en la parte superior. El resto de esta página solo describe lo que es específico de un elemento o sección.
Tablas
Las tablas definen qué tablas de SAP se extraen. Todas las tablas que agregue aquí se guardarán posteriormente como tablas de resultados.
Lo que añade depende de la conexión del paquete:
- Conexión RFC: busque la tabla SAP por nombre o introdúzcala directamente, por ejemplo
T001. - Conexión OData: agregue un conjunto de entidades. Un conjunto de entidades es un conjunto de datos ofrecido por un servicio OData, y dab Nexus lo trata como una tabla. Busque el servicio, expándalo y seleccione el conjunto de entidades. También puede introducir la ruta completa. La ruta se convierte en el nombre de la tabla, por ejemplo
/sap/opu/odata4/sap/cdi_cds/cdi_cds/sap/i_companycode/0001/MasterData.
Haga clic en una tabla agregada para introducir un alias (otro nombre para la tabla) o para eliminarla del paquete utilizando el cubo.
Tipo de carga
El tipo de carga solo aparece para los conjuntos de entidades OData que admiten seguimiento de cambios (delta tracking).
- Carga completa: extrae todos los datos
- Carga delta: extrae todos los datos en la primera ejecución y solo los registros modificados después de eso. Consulte CDC con SAP OData.
Estrategia
La estrategia controla el comportamiento de escritura en el destino. La estrategia de datos de la tarea puede sobrescribirla: "combinar" y "agregar" solo surten efecto si la estrategia de datos también es "combinar". Con Keep Database - Overwrite, por ejemplo, una tabla con la estrategia "combinar" es sobrescrita. Puede encontrar todas las combinaciones en Interacción entre estrategia de datos y de tabla.
- Combinar: las filas extraídas se combinan con los datos existentes y los actualizan
- Sobrescribir: elimina la tabla al inicio de la extracción
- Agregar: añade los datos a los existentes
- Estructura: crea solo la estructura de la tabla en el destino y no extrae datos
Campos de la tabla
Seleccione los campos que desea extraer. Las claves primarias siempre se seleccionan automáticamente y no pueden ser deseleccionadas.
- Lista de campos: contiene todos los campos de la tabla seleccionada. Seleccione o deseleccione un campo para incluir o no sus datos.
- Orden de los campos: lista todos los campos por defecto (el mismo orden que en SAP), por selección, por nombre, por descripción o por longitud del campo
- Actualizar: recarga la lista de campos
- Alternar selección: selecciona o deselecciona todos los campos excepto las claves primarias
- Buscar: localiza campos concretos
Filtros y repositorios de la tabla
Con una conexión OData, solo están disponibles los filtros, ya que no existen repositorios.
Los filtros aplican condiciones sobre los campos de la tabla. Añada un filtro existente, elíjalo bajo Filtro y utilice Campo para indicar en qué campo se aplica. "Ir al filtro" abre su configuración.
La dependencia consulta la tabla en función de los valores del repositorio. Seleccione un repositorio existente bajo Repositorio. Use el icono de engranaje para cambiar el tipo de dependencia o activar la asignación personalizada. dab Nexus enlaza los campos automáticamente si tienen el mismo nombre en el repositorio y en la tabla (distingue mayúsculas y minúsculas). Si los nombres difieren, Link los campos manualmente con la asignación personalizada. Consulte Dependencias de repositorios para conocer los tipos de dependencia.
La dependencia de eliminación elimina filas de esta tabla en el destino según los valores del repositorio. La tabla se convierte en el objetivo de eliminación. Una tabla solo puede tener una dependencia de eliminación. Seleccione un repositorio existente bajo Repositorio. Use el icono de engranaje para mapear los campos del repositorio a las claves primarias de la tabla. Consulte Dependencias de eliminación para una explicación completa.
Los repositorios de destino escriben los valores de la tabla en un repositorio. Use Añadir para agregar un repositorio de destino. Utilice el icono de engranaje para ajustar la asignación de los campos con la asignación personalizada, como en "Dependencia".
Tablas virtuales
Las tablas virtuales se extraen igual que las tablas, pero dab Nexus descarta sus datos tras la extracción. No aparecen como tablas de resultados.
Utilice una tabla virtual si no le interesa el dato en sí, sino que necesita ciertos valores para filtrar otras tablas. Generalmente, una tabla virtual aporta esos valores a un repositorio, y luego se consulta las tablas destino en función de ellos. Esto resulta útil para cargas delta, por ejemplo: la tabla virtual determina qué registros han cambiado y las tablas destino solo extraen esos.
Agregue una tabla virtual del mismo modo que una tabla. Puede asignar un alias aquí también. Todas las secciones son iguales que en las tablas, salvo la sección Estrategia, que no existe.
Filtros
Los filtros restringen los valores de una extracción. Puede aplicarlos a tablas o tablas virtuales, así como a informes y objetos en tiempo real a través de sus relaciones.
Puede elegir libremente el nombre de un filtro.
Si utiliza uno de los siguientes nombres para su filtro, el tipo se asigna automáticamente como "búsqueda": Fiscal Year, Companycode, Company Code, Time Period
Configuración del filtro
- Obligatorio: es necesario definir valores para este filtro al crear una tarea
- Sin conexión: aplica el filtrado del lado del cliente
- Determinación del ámbito del filtro: el nivel en que se introducen los valores, véase abajo
- Tipo de dato: tipo de dato del valor del filtro, puede ser cadena, fecha o numérico
- Tipo de filtro:
- Entrada: introduce los valores durante la creación de la tarea
- Valor fijo: los valores se fijan previamente en el paquete
- Búsqueda: selecciona valores de SAP durante la creación de la tarea
- Año fiscal: introduce el año fiscal o se establece según la programación de la tarea
Determinación del ámbito del filtro
El ámbito controla en qué nivel se introducen los valores del filtro al crear una tarea. Se aplica a los tipos de filtro "Entrada", "Búsqueda" y "Año fiscal". Los filtros de valor fijo ya tienen sus valores, por lo que el ámbito no los afecta.
- Por tarea: un conjunto de valores para toda la tarea. Úselo si los valores son iguales para todos los sistemas SAP y para las variantes inicial y delta.
- Por SAP System: valores separados para cada SAP System de la tarea. Úselo si los valores varían entre sistemas, por ejemplo códigos de empresa.
- Por variante: valores separados para la variante inicial y la variante delta. Úselo si la primera ejecución y las siguientes requieren valores diferentes, por ejemplo un periodo largo para la carga inicial y uno corto para la delta.
- Automático: dab Nexus elige el nivel basado en el tipo de filtro. Úselo salvo que necesite un nivel específico.
Automático selecciona estos niveles:
| Tipo de filtro | Nivel |
|---|---|
| Entrada con tipo de dato fecha | Por variante |
| Entrada con otro tipo de dato | Por tarea |
| Búsqueda | Por SAP System |
| Año fiscal | Por variante |
Condición
La condición determina qué cláusula de filtro se genera.
| Condición | Descripción | Ejemplo |
|---|---|---|
| Igual | Ambos valores son iguales | 100 = 100 |
| Distinto | Ambos valores no son iguales | 100 <> 99 |
| Mayor | Un valor es superior al otro | 100 > 99 |
| Mayor o igual | Un valor es superior o igual al otro | 100 >= 99/100 |
| Menor | Un valor es inferior al otro | 99 < 100 |
| Menor o igual | Un valor es inferior o igual al otro | 99/100 <= 100 |
| Contiene | Un valor contiene parte del otro | %est is contained in Test |
| No contiene | Un valor no contiene parte del otro | %ame is not contained in Test |
| Entre | Un valor dentro de un rango determinado | 5 is between 3 and 7 |
| En lista | Un valor existe entre una serie de valores | DE exists in the series 'DE, EN, IT, FR' |
| No en lista | Un valor no existe entre una serie de valores | DE doesn't exist in the series 'EN, IT, FR' |
| Vacío | Un valor (cadena de caracteres) debe estar vacío | Value = '' |
| No vacío | Un valor (cadena de caracteres) debe estar lleno | Value = 'Here is a text' |
Relaciones de filtro
Las relaciones definen dónde se aplica el filtro. En cada sección, agregue un elemento existente y seleccione dos opciones en las listas desplegables:
| Sección | Aplica el filtro sobre | Qué seleccionar |
|---|---|---|
| Relaciones de tabla | Tablas | Seleccione tabla y seleccione campo. Solo puede elegir campos que fueron seleccionados en la lista de campos |
| Relaciones de informe | Informes | Seleccione informe y seleccione parámetro |
| Relaciones de objetos en tiempo real | Objetos en tiempo real | Seleccione el objeto en tiempo real y el campo correspondiente |
Repositorios
Los repositorios almacenan resultados intermedios y los ponen a disposición para procesamiento adicional entre los elementos de un paquete.
Puede elegir libremente el nombre de un repositorio.
Un repositorio conecta elementos en un orden fijo. Las tablas de origen y los objetos en tiempo real primero escriben sus valores en el repositorio. Las tablas de destino se extraen tras sus tablas de origen y se consultan en función de esos valores. Un repositorio se llena de nuevo en cada ejecución, por lo que solo contiene los valores del proceso actual.
Buenas prácticas: utilice un repositorio si necesita los valores de una primera extracción para las consultas de las tablas siguientes. Puede consultar un recorrido completo en Ejemplos.
Descripción general del repositorio
Aquí establece de qué consta el repositorio y de dónde provienen sus valores.
Campos son los campos de los que consta el repositorio. Puede agregar uno o varios campos a la vez.
Tabla de origen muestra las tablas que aportan valores al repositorio. Añada una tabla y selecciónela como tabla de origen. El icono de engranaje abre la asignación para la relación:
- Asignación personalizada: si está activa, puede seleccionar manualmente el Link entre el campo de la tabla de origen y el del repositorio
- Tipos de relación (con asignación personalizada activa):
- Identidad: introduce el valor del campo de la tabla en el campo del repositorio
- Subcadena: introduce una parte del valor del campo de la tabla en el campo del repositorio
- Concatenar: introduce varios valores de campo de la tabla en un solo campo del repositorio
Objetos en tiempo real muestra los objetos en tiempo real que suministran valores al repositorio. Añada un objeto en tiempo real y selecciónelo como objeto de origen. El icono de engranaje abre la configuración de la dependencia:
- Números: número en el intervalo de números
- Subobjeto: subcategoría (a menudo el código de empresa, opcional según el intervalo)
- Año fiscal: año fiscal (opcional, según el intervalo de números)
Por ejemplo, EINKBELEG solo puede ser Números, mientras que RF_BELEG puede ser Números, Subobjeto o Año fiscal.
Dependencias del repositorio
Utilice un repositorio como fuente de datos para tablas de destino. Se consultan en función de los valores del repositorio.
Añada una tabla de destino y selecciónela como tal. Use el icono de engranaje para fijar el tipo de dependencia y la asignación personalizada. La asignación personalizada enlaza los campos del repositorio con los de la tabla de destino (consulte Filtros y repositorios de la tabla).
El tipo de dependencia define cómo se construye la consulta:
| Tipo de dependencia | Descripción | Ejemplo |
|---|---|---|
| En lista | Consulta con sentencia IN | BELNR IN (1,2,3,4,...) |
| Entre | Consulta con sentencia Between | BELNR Between 1 and 10 |
| Optimizado | Combinación de sentencias IN y Between | BELNR between 1 and 5 AND BELNR NOT IN (1,2,3,5) |
Dependencias de eliminación
Utilice una dependencia de eliminación para eliminar filas del destino, por ejemplo, registros eliminados en SAP que de otro modo permanecerían en sus datos delta de SAP. Solo elimina filas en el destino, nunca en SAP.
El objetivo de eliminación es la tabla que tiene la dependencia de eliminación. dab Nexus elimina filas de esta tabla en el destino. El repositorio aporta las claves de las filas a eliminar.
Un objetivo de eliminación no es igual a una tabla de destino. Una tabla de destino utiliza los valores del repositorio para restringir su consulta en SAP. Un objetivo de eliminación los utiliza para eliminar filas en el destino.
El proceso es el siguiente:
- Una tabla de origen escribe las claves de los registros a eliminar en el repositorio. Por ejemplo, lee documentos de cambio como CDPOS, filtrados a registros eliminados.
- dab Nexus extrae el objetivo de eliminación después de sus tablas de origen.
- dab Nexus elimina entonces cada fila del objetivo de eliminación en el destino cuya clave primaria coincida con una fila del repositorio. Si el repositorio está vacío, no se elimina nada.
Nota: se elimina toda fila coincidente, por lo que el repositorio solo debe contener registros que realmente deben ser eliminados.
Puede gestionar las dependencias de eliminación aquí o en la propia tabla (consulte Filtros y repositorios de la tabla). Aquí, añada un objetivo de eliminación y selecciónelo como tabla.
Utilice el icono de engranaje para enlazar los campos del repositorio con las claves primarias del destino de eliminación. Se aplican las siguientes reglas:
- Debe mapear todos los campos del repositorio.
- Solo puede emplear claves primarias del objetivo de eliminación.
- Cada campo de clave primaria solo puede usarse una vez.
Las dependencias de eliminación están soportadas para SQL Server, Snowflake y Microsoft Fabric (Lakehouse y Mirror) como destinos.
Objetos en tiempo real
Los objetos en tiempo real obtienen numerosos "Number Range Objects" de SAP y pueden escribir sus valores en un repositorio.
Puede elegir libremente el nombre de un objeto en tiempo real.
"Number Range Object" y valores
Elija un "Number Range Object" de la lista desplegable.
En SAP, los intervalos de números definen secuencias únicas de números asignados a objetos o documentos (por ejemplo, facturas, pedidos, etc.). Ayudan a mantener la unicidad y evitan duplicados. Bajo "Valores", puede usar:
- Añadir nuevo intervalo de números: seleccione uno o varios rangos de números disponibles en SAP. Dependen del "Number Range Object" que haya escogido.
- Disponibles: enumera todos los intervalos de números en el SAP System
- Seleccionados: enumera todos los intervalos de números que ya ha seleccionado. También puede eliminar la selección.
- Añadir valores: añade nuevos valores de forma manual
- Cubo: elimina un valor de la lista
Para obtener más información sobre los Number Range Objects, consulte Intervalos de números.
Filtros de objetos en tiempo real y repositorios de destino
Los filtros aplican condiciones sobre los valores del objeto en tiempo real. Funcionan igual que los filtros de una tabla.
Los repositorios de destino escriben los valores de los objetos en tiempo real en un repositorio. Use Añadir para agregar un repositorio de destino. Utilice el icono de engranaje para fijar la dependencia con Números, Subobjeto y Año fiscal (consulte Descripción general del repositorio).
Informes
Los informes extraen la salida de un informe de SAP (transacción SAP). Solo se pueden utilizar los informes que tienen salida tabular.
Los informes no están disponibles en el Managed App por razones técnicas.
Cuando agregue un informe, introduzca el nombre del informe (transacción SAP) en el cuadro emergente y continúe. dab Nexus carga los parámetros disponibles, si existen.
Los filtros aplican condiciones al informe. Funcionan igual que los filtros de una tabla.