La arquitectura abierta basada en componentes mediante la cual los componentes software de Sap R/3 interactúan y se integran con otros componentes de software de terceros fabricantes está confirmandose como una alternativa con grandes posibilidades.

Los Objetos de Negocios de Sap R/3 conforman una parte esencial del marco de trabajo del mundo de los negocios.  Estos objetos cubren un amplio rango de los procesos de datos y negocio de Sap R/3 y pueden ser implementados usando metodos estables y estandarizados, las BAPIs o Business Application Programming Interfaces.

La funcionalidad de negocios de Sap R/3 es implementada con os objetos de negocio de Sap R/3 y las BAPIs que los soportan.

La aparición de BAPIs en Sap R/3 fué a partir de la versión 3.1 y se hizo para permitir la integración de software entre Sap R/3 y otros fabricantes de software.  En número total de BAPIs se ha ido incrementando con la liberación de nuevas versiones de Sap R/3.  Los conceptos técnicos de las BAPIs se circunscriben a los de la Programación Orientada a Objetos, por esta razón al sumergirnos en el entorno de BAPIs escucharemos con mucha frecuencia los términos siguientes:

.- Objeto
.- Propiedad
.- Atributo
.- Metodo
.- Evento
.- Herencia
.- Polimorfismo
.- Instancia

Esta página intenta proveer una introducción de como usar las BAPIs para crear nuestros própios desarrollos o add-on developments.  De lo dicho hasta ahora se debe inferir que para poder realizar desarrillos apoyandonos en BAPIs es necesario entender los conceptos generales y la terminología de la técnología y la Programación Orientada a Objetos.

Se pueden usar BAPIs sin un conocimiento profundo de Sap R/3, pero es necesario tener un conocimiento básico del sistema R/3.  Las BAPIs pueden ser accedidas de plataformas y entornos tan diversos como:

.- Delphi de Borland
.- Visual Studio de Microsoft, usando BAPI ActiveX Control
.- C++
.- Cualquier plataforma externa que soporte el Protocolo Remote Función Call( RFC ).   Si se van a realizar desarrollos en entornos no-Windows es necesario tener conocimientos de Programacióbn RFC, particularmente en la realizacion de llamadas RFC.


Objetos de Negocios Sap R/3

Los objetos de mundo real son modelados como objetos de negocio en los sistemas de aplicación de negocios, como Sap R/3.  Podemos imaginarnos a los objetos de negocio de Sap R/3 como Cajas Negras que encapsulan los datos y los procesos de negocio.

Para alcanzar la encapsulación, los objetos de negocio de Sap R/3 se construyen como entidades de multiples capas:

.- En la primera capa está el Kernel, que representa los datos inherentes del objeto.
.- La segunda capa, la de integridad, representa la lógica de negocio del objeto.
.- La tercera capa, la de interface, describe la implementación y estructura del objeto de negocio Sap y define la interfase con el mundo exterior.
.- La cuarta capa, y la más superficial, es la de acceso que define las tecnologías que pueden ser usadas para obtener acceso exterior a los datos del objeto, por ejemplo COM/DCOM( Component Object Model/Distributed Component Object Model ).  El gráfico siguiente muestra las distintas capas de un objeto de negocios en Sap R/3:

La capa de interface separa los datos del objeto y la aplicación de las tecnologías que pueden usarse para accederlos.  Los objetos de negocios de Sap revelan al mundo exterior solamente su interfase que en un conjunto claramente definido de métodos.   Las aplicaciones solo pueden acceder a los datos de los objetos mediante los métodos de estos.

Para que un programa de aplicación pueda acceder a los datos de un objeto solo necesita conocer la información requerida para ejecutar el método.  De esta forma los programadores pueden usar los objetos de Sap R/3 sin necesidad de conocer en detalle la implementación del objeto.

El conjunto de métodos de un objeto representa las distintas capacidades de hacer cosas de un objeto.  al ejecutarse un método del objeto este puede variar el estado interno de este, o sea sus datos.

Por ejemplo un método que se puede ejecutar sobre el objeto de negocio "Cliente" es verificar su existencia.

Tipos e Instancias de Objetos

Cada objeto de negocio individual pertenece a una clase específica de objeto, de acuerdo a las particularidades del objeto.  Estas clases representan los tipos de objetos, por ejemplo un "Cliente" individual que mantiene relaciones con una organización es parte del tipo de objeto "Cliente".

Cuando un programa usa la instancia de un objeto, esta responde solo al conjunto de características y métodos definidos para su propio tipo de objeto.  Los tipos de objetos de negocio de Sap R/3 están definidos por:

.- Tipo de objeto
.- Campos clave
.- Métodos
.- Atributos
.- Eventos
.- Interfases

Herencia y Polimorfismo

Una de las grandes ventajas de las tecnologías orientadas a objetos es la reusabilidad del código, esto se basa en la definición de objetos en base a otros existentes.   Cuando un tipo de objeto se crea en función de uno existente, este es llamdado un subtipo; mientras que el existente es llamado supertipo.  Por ejemplo el objeto del tipo "Empleado" es un subtipo creado en función del supertipo "Persona".  Estos términos son también conocidos como subclase y superclase.

El subtipo o subclase hereda las propiedades y métodos definidos para el supertipo en base al cual fué definido.  Un subtipo puede también implementar comportamientos diferentes de los heredados del supertipo.

Polimorfismo es el término usado para describir cuando el mismo método dispara tipos diferentes de comportamientos dependiendo el tipo de objeto de negocio.

Repositorio de Objetos de Negocio

La totalidad de objetos de negocios de Sap R/3 están identificados y descritos en el Repositorio de Objetos de Negocio, este repositorio fué originalmente introducido con la versión 3.0 en el mismo momento en que se introdujeron los Objetos de Negocio y el SAP Business Workflow.

El Repositorio de Objetos de Negocio incluye dos categorías de tipos de objetos:

.- Tipos de Objetos de Negocios
.- Tipos de Objetos Técnicos

Con el surgimiento de las BAPIs en la versión 3.1, el Repositorio de Objetos de Negocios asumió un nuevo e importante rol.  Ahora es el punto central de acceso a los objetos de negocio y sus BAPIs para las aplicaciones externas.  En este sentido el Repositorio de Objetos de Negocio sirve para dos propósitos esenciales:

.- Identificar y describir los Objetos de Negocio de Sap y sus BAPIs disponibles
.- Crear las instancias de objetos

Business Application Programming Interface( BAPI )

Los objetos contenidos en el repositorio encapsulan los datos y procesos.  De esta forma el acceso  a los datos y procesos, por agentes externos, es permitido solo mediante métodos específicos; representados estos por su BAPI correspondiente.  De esto último se desprende que una BAPI no es más que un método de un Objeto de Negocio de Sap R/3.

Por ejemplo, la funcionalidad implementada para el objeto tipo "Customer" incluye una verificación para la existencia del cliente.  De esta forma el tipo de objeto "Customer" posee una BAPI llamada "Customer.CheckExistence".

Para que un programa de aplicación sea capaz de usar la BAPI de un método, solo necesita saber como invocar el método; esto, es necesario conocer la definición de la interface del método.  La interfase de una BAPI se define por:

En la actualidad las BAPIs del sistema Sap R/3 se implementan como módulos de función que se tratan con el Function Builder del Workbench ABAP.  Cada módulo de función que da soporte a una BAPI debe cumplir los resiguitos siguientes:

.- Soportar el Protocolo Remote Function Call( RFC )
.- Haber sido asignada como un método a un Objeto de Negocio Sap
.- Debe procesarse sin retornar ventanas de diálogo al programa llamante

El gráfico siguiente muestra la relación entre Objetos de Negocio, BAPIs y módulos de función asociado.

Esta arquitectura permite a SAP AG cambiar los detalles de implementación de una BAPI sin afectar la forma en que están construidos los programas usuarios de las BAPIs modificadas

Ventajas de usar BAPI

Las BAPIs son métodos estandarizados de los Objetos de Negocio Sap R/3, que permiten la integración de los componentes de software de los clientes y de terceros.  Algunas de las ventajas de usar BAPIs son:

.- Es un Estándar de Negocio
.- Es un Estándar Consensuado
.- Garantiza estabilidad y compatibilidad futura
.- Garantiza orientación a objetos
.- Indenpendencia de entorno( apertura )

Usar BAPIs en programas de aplicación

Actualmente una BAPI puede ser invocada de dos formas diferentes:

.- Llamar la BAPI en el repositorio
.- Hacer llamada RFC a la función que implementa la BAPI

Acceso orientado a objeto a una BAPI

El acceso orientado a objetos de una BAPI se permite desde un variado número de plataformas de programación, entre estas están:

.- Usar el BAPI ActiveX Control que provee SAP para llamar los métodos desde plataformas Windows 95/NT.  BAPI     ActiveX Control permite que aplicaciones clientes externas accedan a los objetos del repositorio mediante la invocación de BAPIs por medio de Automatización OLE.
.- Desde Windows 95/NT usando SAP's BAPI C++ Class Library
.- SAP's BAPI Java Class Library permite el acceso a las BAPIs desde todas las plataformas con Java Virtual Machine que  soportan desarrollos con Java Development Kit 1.0.2
.- Delphi de Borland
.- IBM trabaja para lograr la integración con Visual Age para Java

La tabla siguiente muestra distintas plataformas desde las que puede hacerse llamadas orientada a objeto a las distintas BAPIs existentes en el repositorio de Sap R/3

Flujo del proceso

Las aplicaciones se ejecutan de forma diferente, dependiendo del entorno de desarrollo, y
consecuentemente los pasos para invocar las BAPIs de forma orientada a objeto son diferentes.

El ejemplo que se presenta a continuación muestra los pasos envueltos cuando se usa BAPI ActiveX
Control para acceder a las BAPIs desde un programa escrito en Visual Basic.

Una vez la aplicacion cliente se conecta a Sap R/3 los Objetos de Negocios de Sap se acceden, en
tiempo de ejecución, de acuerdo a llamadas de Automatización OLE al BAPI ActiveX Control.

Los pasos involucrados son los siguientes:

· Crear el objeto BAPI ActiveX Control object
· Crear el objeto logon control object:
· Crear el objeto connection object to the R/3 System:
· Acceder al Sistema Sap R/3 llamando el metodo logon del objeto connection
· Invocar la creación de una Instancia Local de Objeto de Negocio Sap
· Antes de que nuestras aplicaciones puedan llamar una BAPI de un Objeto de Negocio, debe verificar
  que se haya creado una instancia del objeto.
· Crear los objetos de parametros
· Asignar dato a los parametros
· Invocar las BAPIs de los Objetos de Negocio
· Liberar los Objetos de Negocio Sap y el BAPI ActiveX Control object.

Código en Visual Basic

Set oBAPICtrl = CreateObject("SAP.BAPI.1")
Set oLogonCtrl = CreateObject("SAP.Logoncontrol.1")
Set oBAPICtrl.Connection = oLogonCtrl.NewConnection
If oBAPICtrl.Connection.Logon(frmStart.hwnd,FALSE) = FALSE then
MsgBox"R/3 Connection failed"
Endif
Set boOrder = oBAPICtrl.GetSAPObject("SalesOrder")

Set oOrderHeader = oBAPICtrl.DimAs(boOrder, "CreateFromDat1", "OrderHeaderIn")
Set otabItems = oBAPICtrl.DimAs(boOrder, "CreateFromDat1", "OrderItemsIn")
Set otabPartners = oBAPICtrl.DimAs(boOrder, "CreateFromDat1", "OrderPartners")


boOrder.CreateFromDat1 OrderHeaderIn:=oOrderHeader, OrderPartners:=otabPartners, OrderItemsIn:=otabItems, Return:=oReturn


Acceso a una BAPI mediante llamadas a Módulos de Función

Se pueden hacer llamadas RFC directas a los módulos de función sobre los que las BAPIs se basan.  Las llamadas pueden ser hechas desde programas ABAP o desde plataformas de desarrollo externas que permitan el uso de C/C++ RFC Class Library.


Para incluir BAPIs en nuestros programas de aplicación es necesario realizar las tareas siguientes:

.- Identificar los objetos y BAPIs
.- Determinar la información de parámetros en torno a la interface de la BAPI
.- Incluir la llamada a BAPI o Función y la declaración de parámetros

A continuación se incluye un ejemplo en ABAP que accediendo al tipo de objeto BUS2031( SalesOrder ), mediante el módulo de función de la BAPI correspondiente a uno de sus métodos crea un pedido de ventas

REPORT ZFRBAPICREARPEDIDO.
* --------------------------------------------------------------------
* --------------------------------------------------------------------
* Programa     :      zfrbapicrearpedido
* autora       :      Francisco Reyes
* fecha        :      20 de marzo del 2001
* objetivo     :      Crear pedido de venta usando bapi con RFC
* --------------------------------------------------------------------
* tablas de base de datos utilizadas
* tabla               descripción
* bapisdhead          Cabecerra de pedidos para BAPIs
* bapiitemin          Posiciones de pedidos para BAPIs
* bapipartnr          Funciones de interlocutor para BAPIs
* bapireturn          Mensajes de retorno para BAPIs
* --------------------------------------------------------------------
* Descripción del proceso
* 1.- Asigna datos de tipo pedido, area de ventas y pedido cliente.
* 2.- Crea datos de posociones de pedido
* 3.- Imprimer contenido de posiciones de pedido
* 4.- Asigna funciones de interlocutor
* 5.- Imprimer funciones de interlocutor
* 6.- Invoca funcion, BAPI, para crear el pedido
* 7.- Imprime el estado del resultado de la accion
* --------------------------------------------------------------------
* --------------------------------------------------------------------

*=====================================================================
*** Cuerpo principal del programa
*=====================================================================
START-OF-SELECTION.
* Llamada a rutina de creacion de pedido
  PERFORM CREAPEDIDOCONBAPI.
*================ Final del cuerpo principal ========================

*&-------------------------------------------------------------------*
*& Form CREAPEDIDOCONBAPI
*&-------------------------------------------------------------------*
* text
*--------------------------------------------------------------------*
FORM CREAPEDIDOCONBAPI.
  DATA : CABPEDIDO LIKE BAPISDHEAD.

  DATA : BEGIN OF POSPEDIDO OCCURS 1.
          INCLUDE STRUCTURE BAPIITEMIN.
  DATA : END OF POSPEDIDO.

  DATA : BEGIN OF INTERLOCU OCCURS 1.
          INCLUDE STRUCTURE BAPIPARTNR.
  DATA : END OF INTERLOCU.

  DATA : NUMPEDIDOSD LIKE VBAK-VBELN.

  DATA: REGRETURN LIKE BAPIRETURN.

  CLEAR : CABPEDIDO , POSPEDIDO , INTERLOCU.

* Asigna tipo pedido, area ventas y pedido cliente
  CABPEDIDO-DOC_TYPE = 'TA'.
  CABPEDIDO-SALES_ORG = '0400'.
  CABPEDIDO-DISTR_CHAN = '40'.
  CABPEDIDO-DIVISION = '40'.
  CABPEDIDO-PURCH_NO = 'UAXTest'.

* Primera posicion del pedido
* pospedido-hg_lv_item = '10'.
  POSPEDIDO-MATERIAL = '000000000000001556'.
  POSPEDIDO-PLANT = '0400'.
  POSPEDIDO-REQ_QTY = '1000'.
  POSPEDIDO-SALES_UNIT = 'EA'.
  APPEND POSPEDIDO.

* Segunda posicion del pedido
* pospedido-hg_lv_item = '20'.
  POSPEDIDO-MATERIAL = '000000000000001557'.
  POSPEDIDO-PLANT = '0400'.
  POSPEDIDO-REQ_QTY = '1000'.
  POSPEDIDO-SALES_UNIT = 'EA'.
  APPEND POSPEDIDO.

* Tercera posicion del pedido
* pospedido-hg_lv_item = '30'.
  POSPEDIDO-MATERIAL = '000000000000001558'.
  POSPEDIDO-PLANT = '0400'.
  POSPEDIDO-REQ_QTY = '1000'.
  POSPEDIDO-SALES_UNIT = 'EA'.
  APPEND POSPEDIDO.

* Impresion de posiciones de pedido
  LOOP AT POSPEDIDO.
    WRITE : / SY-TABIX , POSPEDIDO-MATERIAL , POSPEDIDO-PLANT
    , POSPEDIDO-REQ_QTY , POSPEDIDO-SALES_UNIT.
  ENDLOOP.

* Funciones de interlocutor-Solicitante
  CLEAR : INTERLOCU.
  INTERLOCU-PARTN_ROLE = 'AG'.
  INTERLOCU-PARTN_NUMB = '0000000426'.
  APPEND INTERLOCU.
  CLEAR : INTERLOCU.

* Funciones de interlocutor-Destinatario mercancia
  INTERLOCU-PARTN_ROLE = 'WE'.
  INTERLOCU-PARTN_NUMB = '0000000426'.
  APPEND INTERLOCU.

* Impresion de funciones de interlocutor
  LOOP AT INTERLOCU.
    WRITE : / SY-TABIX , INTERLOCU-PARTN_ROLE , INTERLOCU-PARTN_NUMB.
  ENDLOOP.

  CLEAR : POSPEDIDO , INTERLOCU , REGRETURN..

* Llama funcion, BAPI, para crear pedido
  CALL FUNCTION 'BAPI_SALESORDER_CREATEFROMDATA'
  EXPORTING
  ORDER_HEADER_IN = CABPEDIDO
  IMPORTING
  SALESDOCUMENT = NUMPEDIDOSD
* SOLD_TO_PARTY =
* SHIP_TO_PARTY =
* BILLING_PARTY =
  RETURN = REGRETURN
  TABLES
  ORDER_ITEMS_IN = POSPEDIDO
  ORDER_PARTNERS = INTERLOCU
* ORDER_ITEMS_OUT =
* ORDER_CFGS_REF =
* ORDER_CFGS_INST =
* ORDER_CFGS_PART_OF =
* ORDER_CFGS_VALUE =
* ORDER_CCARD =
  EXCEPTIONS
  OTHERS = 1.

* Impresion de resultado de la accion
  WRITE : / 'sy-subrc = ' , SY-SUBRC.

  IF NOT NUMPEDIDOSD IS INITIAL.
    WRITE : / NUMPEDIDOSD , 'registerd'.
  ELSE.
    WRITE : / 'incorrect'.
    WRITE : / REGRETURN-TYPE , REGRETURN-CODE , REGRETURN-MESSAGE.
    WRITE : / REGRETURN-LOG_NO, REGRETURN-LOG_MSG_NO,
    REGRETURN-MESSAGE_V1.
  ENDIF.

ENDFORM.                               " creapedidoconbapi

Acceso usando BAPI ActiveX Control

Si se desarrolla software en entornos Windows 95/NT se se puede usar BAPI ActiveX Control para invocar las BAPIs desde nuestros programas de aplicación.  Esta tecnología fué incluida originalmente en SAP R/3 a partir de la versión 3.1G, funciona como un Servidor de Automatización OLE haciendo los Objetos de Sap disponibles como Objetos OLE para ser incluidos en nuestroas aplicaciones.

En tiempo de ejecución, los objetos son invocados haciendo llamdas OLE a BAPI ActiveX Control.  Estas llamadas consisten de los pasos siguientes:

.- Crear el Objeto BAPI ActiveX Control
.- Crear una instancia local del objeto
.- Asignar valor a las propiedades del objeto
.- Invocar los métodos del objeto
.- Liberar el Objeto BAPI ActiveX Control

Usar BAPIs mediante Remote Function Call( RFC )

El acceso directo con Programación Orientada a Objetos en plataformas no-Windows no está, por el momento, permitido como ocurre en plataformas Windows con BAPI ActiveX Control.  No obstante, es posible realizar llamadas RFC a los Módulos de Función sobre los que se apoyan las BAPIs correspondientes; esto siempre que la plataforma soporte el Protocolo RFC.  Esta metodología de acceso pretende ser una solución de bajo nivel que permita a los clientes acceder a los objetos de negocio Sap hasta que ABAP soporte completamente los Middleware y permita llamadas directas a los métodos de los Objetos de Negocio Sap.

Los programas de aplicación usan, en tiempo de ejecución, las librerías:

.- RFC Library o
.- C/C++ RFC Class Library

para hacer la llamada RFC al módulo de función que soporta la BAPI.  La librería es la encargada de mapear las llamadas de los clientes con los pasos de comunicación válidos de acuerdo al Protocolo RFC, las peticiones del cliente son dirigidas al módulo de función correspondiente en Sap R/3.

BAPIs Estándares

Existe un conjunto de BAPIs que ofrecen un servicio similar a los distintos objetos de negocio Sap, la función exacta de la BAPI la determina el objeto al cual pertenece.   Ejemplos de estas BAPIs son las siguientes:

.- GetList
.- GetDetail
.- CreateFromData
.- Create
.- Change
.- Delete

Restricciones de las BAPIs

.- Garantizar la consistencia en la Base de Datos
.- Jamas retornar ventanas de diálogo
.- Verificar niveles de autorización
.- Las BAPIs retornan los importes con cuatro decimales
.- Las BAPIs retornan las fechas en formato YYYYMMDD
.- Generalmente se procesan de forma sincrónica
.- Programas que hacen llamadas RFC no pueden asignar valores a los atributos

BAPI Browser

Los Objetos y BAPIs de Sap R/3 son manejados en el Repositorio de Objetos mediante una estructura jerárquica que se corresponde con la jerarquía de las aplicaciones de negocio de SAP R/3.

El BAPI Browser muestra los objetos en la jerarquía de las aplicaciones.  Para acceder al BAPI Browser se debe seguir la ruta:

.- Tools
.- Business Framework
.- BAPI Browser

Información de Parámetros Requeridos

.- Key Fields
.- Parámetros( Import, Export o Import/Export )
.- Nombre del módulo de función, si se van a hacer llamadas RFC

Una forma, de las varias existentes, para obtener toda la información necesaria para usar las BAPIs es la siguiente:

.- Acceder al Workbench ABAP
.- Seleccionar la opción Business Object Builder
.- Indicar el Nombre del Objeto, por ejemplo BUS2032 para SalesOrder, o usar el botón de comando Business Object Repository
.- Poner el puntero del ratón sobre el método que se desea analizar
.- Pulsar el botón de comando Parametros
.- Pulsar doble-click sobre el parámetro para ver la tabla o campo de referencia

Documentación de las BAPIs

Cada una de las BAPIs posee su propia documentación, en la que se describe la funcionalidad y se enumeran los parámetros.  Para acceder a la documentación de la BAPI se procede de la manera siguiente:

.- Abrir el objeto de negocio
.- Se expande el nodo de los métodos
.- Se pulsa sobre el icono de información

Modificaciones de cliente

Las modificaciones a las BAPIs pueden ser hachas, solo, en el rango de nombres permitidos a los usuarios.

Crear un tipo de objeto nuevo

Crear una BAPI nueva

Extender una BAPI existente

Página mantenida por Francisco A. Reyes