Conexión Fuente SAP BW

Requisitos Previos

Antes de configurar la conexión de origen SAP BW en Crestone, asegúrese de contar con lo siguiente:

Requisito Principal: Un sistema SAP BW (BW clásico sobre ABAP o BW/4HANA ejecutándose en modo BW) accesible a través de RFC. Crestone se conecta utilizando la biblioteca SAP JCo mediante el microservicio crestone-abap-ms — exactamente el mismo mecanismo de destino RFC utilizado por el conector SAP ABAP (host del servidor de aplicaciones, número de instancia, mandante, usuario, contraseña). No se requiere ningún controlador de base de datos ni gateway adicional más allá de la conectividad estándar SAP RFC.

Nota: Este conector apunta a InfoProviders (InfoCubes/MultiProviders), BEx Queries y datos maestros de InfoObjects expuestos en el stack ABAP. No lee proveedores compuestos nativos de HANA modelados puramente mediante vistas CDS — ese es un conector diferente.

---

Requisitos Previos en el Lado de SAP (Autorizaciones del usuario RFC)

El usuario RFC con el que se conecta Crestone requiere:

Consejo: Comience con un rol personalizado de solo lectura acotado a los objetos anteriores en lugar de otorgar un acceso amplio estilo SAP_ALL. Consulte "Permisos Requeridos" a continuación para ver un resumen del rol mínimo.

---

Paso de Pre-Verificación

Antes de configurar la conexión en Crestone, verifique la conectividad y autorización RFC directamente en SAP:

1. En SAP GUI, ejecute la transacción SM59, localice (o cree) un destino RFC con las mismas credenciales de host/instancia/mandante/usuario que utilizará en Crestone.
2. Haga clic en Connection Test — confirma la accesibilidad básica por RFC.
3. Haga clic en Authorization Test — confirma que el usuario RFC puede iniciar sesión e identifica inmediatamente cualquier objeto de autorización faltante.
4. Opcionalmente, ejecute la transacción SE37 y pruebe la ejecución de RSR_MDX_CREATE_OBJECT (enviando un SELECT MDX simple contra un InfoProvider conocido) seguido de RSR_MDX_GET_FLAT_DATA con el DATASETID devuelto, para confirmar que el usuario puede leer datos de InfoProviders antes de configurar Crestone.

Un test de autorización exitoso junto con una llamada de prueba exitosa de RSR_MDX_CREATE_OBJECT/RSR_MDX_GET_FLAT_DATA son señales sólidas de que la conexión en Crestone funcionará correctamente.

---

Pasos de Configuración

Siga estos pasos para crear una nueva conexión de origen SAP BW en Crestone:

1. Navegue a Connections en la barra de navegación superior.
2. Seleccione la pestaña Source.
3. Haga clic en el botón + para crear una nueva conexión.
4. Complete el campo Connection Name con un nombre descriptivo (ej. SAP BW Producción).
5. En el menú desplegable Source Type, seleccione SAP BW.
6. Complete el formulario de credenciales:
   • Host Address — host del servidor de aplicaciones (ashost)
   • Instance Number — número de sistema de dos dígitos (sysnr)
   • User — usuario RFC
   • Client Number — mandante de tres dígitos (client)
   • SAP Router (opcional) — cadena SAProuter si el sistema solo es accesible a través de uno
   • Password — contraseña del usuario RFC
   • Select Language — idioma de inicio de sesión (por defecto Inglés)
7. Haga clic en Test Connection para validar que Crestone pueda abrir una conexión RFC.
8. Una vez superada la prueba, marque la conexión como Productive si debe ser programable y luego haga clic en Create Source para guardarla.

---

Edición de una Conexión Existente

Para actualizar las credenciales de una conexión de origen SAP BW existente:

1. Navegue a Connections y localice su origen SAP BW.
2. Haga clic en Edit.
3. Modifique los campos deseados en el formulario de credenciales.
4. Haga clic en Test Connection para verificar las nuevas credenciales.
5. Haga clic en Confirm para guardar los cambios.

---

Uso de SAP BW como Fuente en un Nodo de Extracción

Una vez creada la conexión, puede utilizarla como origen en un Nodo de Extracción. SAP BW utiliza un modelo OLAP — no hay tablas tradicionales, solo InfoProviders y Queries que exponen características (dimensiones) y cifras clave (key figures / medidas).

1. Abra o cree un Extraction Node y diríjase a la pestaña Source.
2. En Select Source, elija su conexión SAP BW.
3. Seleccione el Extraction Type: InfoProvider (Cube), BEx Query o InfoObject (Master Data).
   • Para extracción de InfoProvider, seleccione el nombre técnico del InfoCube o MultiProvider.
   • Para extracción de Query, seleccione el nombre técnico de una BEx Query liberada.
   • Para extracción de InfoObject, seleccione el nombre técnico de una característica que tenga habilitado "Characteristic is InfoProvider" — consulte la subsección dedicada a continuación.
4. Seleccione las Characteristics (campos dimensionales) y Key Figures (campos de medida) que desea incluir. El resultado extraído contiene una fila por cada combinación única de características seleccionadas, con las cifras clave como columnas adicionales — el mismo comportamiento de aplanamiento que la extracción BWCUBE de Theobald xtract Universal.
5. Include totals / aggregates (desmarcado por defecto) — la jerarquía de cada característica seleccionada tiene un miembro agregado raíz "All ..." junto a sus valores de detalle reales. Deje esta opción desmarcada para extraer solo filas de nivel de detalle (recomendado para la mayoría de los casos de extracción); márquela para incluir también la fila agregada por característica.
6. Opcionalmente, agregue Variables / Selections para restringir los datos — cada fila es {field or query variable, sign, option, low, high}, la misma semántica de select-options utilizada en todo el conector SAP ABAP de Crestone:
   • Sign: Include o Exclude
   • Option: Equal, Between, Contains Pattern, Greater/Less or Equal
   • Low / High: valor(es) sobre los que se restringe (High solo aplica a opciones de rango como Between)
7. El panel de Preview muestra una muestra de los datos aplanados antes de ejecutar una extracción completa.

Nota: Para BEx Queries, la sección "Variables / Selections" también lista las variables OLAP declaradas en la query (nombre, descripción) como referencia — ingrese filas coincidentes utilizando el mismo campo para suministrar un valor a esa variable.

Extracción de Datos Maestros de InfoObject

Este tipo de extracción lee los datos maestros propios de una característica (su clave, textos y atributos de navegación) en lugar de los datos transaccionales de un cubo o query. Esto solo es posible cuando la característica tiene habilitada la opción "Characteristic is InfoProvider" en SAP (RSD1/RSA1), lo que publica sus datos maestros como un objeto consultable.

1. Seleccione InfoObject (Master Data) como el Extraction Type.
2. En el cuadro de búsqueda InfoObject, busque y seleccione la característica (ej. /ERP/COMPCODE). A diferencia de InfoProvider/Query, no hay un selector independiente de "Characteristics" para este tipo — el InfoObject seleccionado es automáticamente la única característica.
3. En Attributes / Properties, seleccione qué campos de datos maestros desea extraer — esto reutiliza la interfaz de la lista de "Key Figures", renombrada para este tipo. Cada entrada es uno de los campos de clave/texto propios de la característica (ej. "Key", "Medium Name") o la clave/texto de un atributo de navegación (ej. "Chart of Accounts (Key)", "Country (Name)"). Una casilla de verificación "Select all available" activa o desactiva todas las propiedades listadas a la vez.
4. "Include totals / aggregates" y "Variables / Selections" no aplican a los datos maestros y permanecen ocultos para este tipo — la extracción de datos maestros siempre devuelve cada miembro sin filas agregadas y sin restricciones de variables.
5. El Preview y la extracción completa funcionan exactamente igual que con los otros dos tipos.

---

Manejo de Tipos de Datos

Las características y cifras clave de SAP BW se extraen y se escriben como columnas de texto (string) en esta versión inicial, independientemente de su tipo de dato SAP subyacente:

Por qué strings para todo: SAP BW devuelve las cifras clave como valores de visualización con formato regional (símbolo de moneda, separadores de miles/decimales, ej. "$ -10.744.436,30"), no como números sin procesar — y ese formato depende del idioma de inicio de sesión de SAP del usuario solicitante, el cual no está garantizado que sea consistente entre sistemas o usuarios. Tratar todas las columnas como texto evita corromper silenciosamente los valores numéricos durante esa conversión; los destinos posteriores pueden convertir las columnas a tipos numéricos en su propio paso de transformación. La asignación de tipos numéricos nativos es una mejora planificada.

---

Cómo se Abordan Internamente los Tipos de Extracción

Crestone construye y ejecuta la consulta OLAP subyacente automáticamente en función del Extraction Type y los campos seleccionados — nunca es necesario redactar esta consulta manualmente. Esta sección sirve como referencia breve para la resolución avanzada de problemas (por ejemplo, interpretar un mensaje de error del lado de SAP), no como algo que deba configurar.

• InfoProvider (Cube): consulta directamente el InfoCube o MultiProvider por su nombre técnico.
• BEx Query: consulta la query liberada por su nombre técnico completo (InfoProvider + nombre de query).
• InfoObject (Master Data): consulta los datos maestros propios de la característica, devolviendo cada miembro con sus atributos/propiedades seleccionados — sin filas agregadas ni restricciones.
• Include totals / aggregates: cuando está desmarcado (predeterminado), solo se devuelven filas de detalle de nivel hoja para extracciones de InfoProvider/Query; al marcarlo se incluye también la fila agregada "All ..." de cada característica.
• Variables / Selections: las variables de BEx Query obligatorias u opcionales se proporcionan como filas {sign, option, low, high}, la misma semántica de select-options utilizada en todos los conectores SAP de Crestone.
• Nombres de columnas de salida: donde el nombre técnico de campo propio de SAP no resulta legible o presentable (por ejemplo, algunas cifras clave de BEx Query se direccionan internamente mediante un ID generado por el sistema), Crestone sustituye automáticamente la descripción del campo como nombre de columna.

---

Problemas Frecuentes

---

Permisos Requeridos

Crestone solo lee datos desde SAP BW (conector de origen). El usuario RFC necesita, como mínimo:

• S_RFC cubriendo los grupos de funciones listados en "Requisitos Previos en el Lado de SAP" arriba
• S_RS_ICUBE con Visualización (03) sobre los InfoProviders a extraer
• S_RS_COMP / S_RS_COMP1 con Ejecutar (16) acotado a las queries a extraer
• S_TABU_DIS (o S_TABU_NAM) con acceso de lectura a RSDCUBE, RSDCUBET, RSZCOMPDIR, RSZELTTXT para descubrimiento

Consejo: Cree un rol personalizado dedicado acotado a estos objetos en lugar de reutilizar un rol amplio de usuario avanzado de BW — este conector nunca escribe en SAP, por lo que un rol estrictamente de solo lectura es suficiente.