RSIRPIRL: recolocando los contenidos de SOFFCONT1

En la transacción DB12 se puede comprobar el tamaño de la tabla SOFFCONT1:

• Transacción DB12 -> Space -> Single Table Analysis -> SOFFCONT1

DB12 tamaño de la tabla SOFFCONT1

Si el tamaño de la tabla es muy grande, con el programa estándar RSIRPIRL es posible mover el contenido de una categoría de archivo a otra es decir, podemos liberar espacio en la tabla SOFFCONT1 y traspasar el contenido de los archivos y documentos anexados a un repositorio externo. 

Antes de ejecutar el programa, recomiendo aplicar los cambios de la siguiente nota de SAP:

• Note 1536325 - Enhancement for report RSIRPIRL

Esta nota amplia la pantalla de selección del programa para poder seleccionar por la fecha de creación. Esto es muy útil para poder realizar pruebas o mover solamente algunos anexos.

Una vez aplicada la nota, podemos ejecutar el programa. Por ejemplo, vamos a traspasar desde la categoría de archivo SOFFDB ( base de datos , tabla SOFFCONT1 ) a la nueva categoría SOFFHTTP todos los anexos creados en el mes de septiembre de 2012:

El enlace entre Clase y Categoría puede verse en la Transacción SKPR08.

Las categorías de archivo están en la transacción OACT.

Notas OSS de interés:

Note 1536325 - Enhancement for report RSIRPIRL

Entradas Anteriores:

I ain't afraid of no GOS

Cambiar la categoría de archivo para GOS

Entradas siguientes:
Crear, Visualizar y Borrar anexos con CL_GOS_DOCUMENT_SERVICE 
Carga masiva de anexos en SAP

Cambiar la categoría de archivo para GOS

Como hemos comentado en la entrada anterior, el contenido de los archivos anexados se guardan en la tabla SOFFCONT1 de la base de datos. Si los archivos anexados son muy grandes o vamos a anexar un gran numero de archivos, esta tabla puede llegar a ocupar una gran cantidad de espacio y ralentizar el sistema. Imaginar por ejemplo una empresa que anexa cada mes 100 facturas a sus respectivos documentos contables cada mes; con el paso del tiempo, la tabla SOFFCONT1 puede llegar a contener miles de archivos anexados.

Podemos comprobar el tamaño de la tabla SOFFCONT1:

   Transacción DB12 -> Space -> Single Table Analysis -> SOFFCONT1

DB12 - tamaño de la tabla SOFFCONT1

SAP recomienda que si el volumen de archivos va ha ser muy alto,  se configure el sistema para almacenar los archivos en un contenedor de archivos  o content server en ingles. Existen varios sistemas de gestión de contenido que ofrecen contenedor de archivos co  con SAP, aquí solamente comentare alguno de ellos:

• SAP Content Server es una aplicación stand-alone para el almacenamiento de archivos y documentos que puedan ser usados por las aplicaciones SAP. Si nuestro cliente tiene instalado el SAP Content Server podemos utilizarlo para almacenar en él los archivos anexados. Tiene ciertas limitaciones como que no podemos almacenar y anexar automáticamente un documento desde un escaner. 
• OpenText Content Suite Platform es la solución de OpenText para la gestión documental o Enterprise Content Management (ECM). Es mucho mas potente que el SAP Content Server y recomendable si estamos pensado más a largo. Permite gestionar y controlar todo el proceso desde la creación o captura del documento hasta su archivado.

A continuación, explico el proceso para crear un repositorio externo y la categoría de archivo .

1.- Crear el repositorio de contenido y la conexión al content server. Transacción OAC0.

Este repositorio debe contener los datos de conexión al content servet como la IP. puerto, etc...

2.- Crear una nueva categoría de archivo SOFFHTTP  y enlazar con el repositorio creado. Transacción OACT

Si ya existe SOFFHTTP o no queréis utilizar esta categoría de archivo, podéis crear una nueva, por ejemplo ZPDF_IMAGE.

3.- Asignar la categoría de archivo a la categoría para clases de documentos físicos.
Transacción SKPR08

Asignamos la nueva categoría de archivo SOFFHTTP a la clase SOFFPHIO.

Si no aparece la clase SOFFPHIO en la SKPR08, hay que aplicar la nota de SAP:

• 668271 - The entry SOFFPHIO is not displayed in TR SKPR08

Desde la transacción SE16 abrimos la tabla SDOKPHCL , buscamos el registro PH CLASS=SOFFPHIO. Modificar el registro para quede como en la imagen:

Si ahora, por ejemplo, anexais un pdf a un documento contable. el contenido del archivo ya no se almacenara en la tabla SOFFCONT1. Podréis seguir visualizando el pdf pero ahora esta almacenado en el repositorio Z1. 

Si aun no os creeis que ahora esta almacenado el archivo en el repositorio Z1, podéis cambiar  la IP al repositorio Z1.  Si lo haceis, comprobareis que ya no podremos acceder al anexo, porque nuestro repositorio ya no apunta al content server que lo guarda; esto es la prueba que el archivo se ha almacenado en el  content server y no a la base de datos de SAP.

Referencias:

Create Attachment issue in storing the document

SAP Content server

Notas OSS de interes:

668271 - The entry SOFFPHIO is not displayed in TR SKPR08

Entradas anteriores:

I ain't afraid of no GOS

Entradas siguientes:

RSIRPIRL: recolocando los contenidos de SOFFCONT1

Crear, Visualizar y Borrar anexos con CL_GOS_DOCUMENT_SERVICE 

Carga masiva de anexos en SAP

Bapis para cambiar la moneda

En muchos  empresas  facturan con mas de una moneda ( euros, dolares ). En estos casos cuando tratamos los importes tenemos que tener en cuenta la moneda. Toda sociedad de una empresa tiene especificada una moneda local, que es la moneda por defecto con la que trabaja, viene indicada en la tabla T001-WAERS.

Los factores de cambio entre las monedas salen de la tabla TCURF.

Si tenemos el importe en moneda local y queremos cambiar a otra moneda:

  CALL FUNCTION 'CONVERT_TO_FOREING_CURRENCY'
         EXPORTING
             CLIENT                             = SY-MANDT
             date                                    = SY-DATUM
             foreign_currency                 = wl_foreing_waers
             local_amount                      = wl_item_data-netpr
             local_currency                    = wl_item_data-waers
*           RATE = 0
*           TYPE_OF_RATE              = 'M'
*           READ_TCURR                 = 'X'
        IMPORTING
             FOREING_AMOUNT          = wl_foreing_netpr
        EXCEPTIONS
             NO_RATE_FOUND           = 1
             OVERFLOW                      = 2
            NO_FACTORS_FOUND    = 3
            NO_SPREAD_FOUND       = 4
            DERIVED_2_TIMES            = 5
            OTHERS                               = 6.

   IF sy-subrc <> 0.
         MESSAGE ID SY-MSGID TYPE SY-MSGTY NUMBER SY-MSGNO
             WITH SY-MSGV1 SY-MSGV2 SY-MSGV3 SY-MSGV4.
   ENDIF.



Si tenemos el importe una moneda diferente a al local y queremos convertirlo a moneda local:

  CALL FUNCTION 'CONVERT_TO_LOCAL_CURRENCY'
         EXPORTING
             CLIENT                             = SY-MANDT
             date                                    = SY-DATUM
             foreign_amount                   = wl_item_data-netpr
             foreign_currency                 = wl_item_data-waers
             local_currency                    = wl_waers
*           RATE = 0
*           TYPE_OF_RATE              = 'M'
*           READ_TCURR                 = 'X'
        IMPORTING
             LOCAL_AMOUNT          = wl_local_netpr
        EXCEPTIONS
             NO_RATE_FOUND           = 1
             OVERFLOW                      = 2
            NO_FACTORS_FOUND    = 3
            NO_SPREAD_FOUND       = 4
            DERIVED_2_TIMES            = 5
            OTHERS                               = 6.

   IF sy-subrc <> 0.
         MESSAGE ID SY-MSGID TYPE SY-MSGTY NUMBER SY-MSGNO
             WITH SY-MSGV1 SY-MSGV2 SY-MSGV3 SY-MSGV4.
   ENDIF.

I ain't afraid of no GOS

G.O.S ( Generic Object Services )  nos ofrecen una serie de servicios  con los que poder anexar  archivos (pdf, doc, xml, jpg, bmp,.. ),  URL y notas personales a un objeto de negocio de Sap ( Facturas, Doc. contables, pedidos de venta, doc. del material...). Un ejemplo real seria, cuando a un pedido de venta, le adjuntamos una hoja donde esta detalladas las características del producto y lo agarramos con un clip.

Es mucho mas recomendable crear URLs que anexar un archivo, Una URL es simplemente un link a un archivo existente localmente en el pc o en un servidor, mientras que anexar un archivo implica subir ese archivo a la base de datos de SAP lo que puede generar un problema de espacio y si anexamos un gran numero de archivos puede sobrecargar la base de datos, tampoco existe la opción de actualizar un archivo anexado, tendríamos que borrar el archivo anexado actual y subir el nuevo archivo.

En muchas transacciones de Sap esta opción esta disponible en la esquina superior izquierda:

Botón Anexos, en la esquina superior izquierda

Imaginemos que tienes una factura en PDF y quieres adjuntarla a su documento contable.

Accedemos al doc. contable en la FB03 y desplegamos el menú, seleccionamos "crear anexo".

A continuación, aparecerá el explorador de archivos del sistema, seleccionamos el archivo a exportar

Para poder visualizar, desplegamos el menú otra vez y seleccionamos "lista de anexos"

Doble click sobre el documento ara abrirlo.

Bien, ahora os estaréis preguntado " ¿Donde ha guardado SAP el documento anexado?".

Los archivos anexados, URL y notas se tratan como documentos del Sapoffice y su contenido, hasta la versión 4.6B, se guardaba en la tabla SOC3. Pero a partir de la versión 4.6B el almacenamiento de estos documentos pasa a ser responsabilidad del Knowledge Provider (Kpro) que permite un almacenamiento externo evitando la sobrecarga de la base de datos de SAP.

A partir de la versión 4.6B lsa notas personales y URL siguen almacenándose en la tabla SOC3, pero los archivos anexados pasan a almacenarse en la tabla SOFFCONT1, para gestionar estos anexos, SAP crea un vinculo entre el objeto de negocio y el archivo indexado, estos vínculos se almacenan en la tabla SRGBTBREL, enlaces en el entorno GOS.

En el ejemplo anterior, hemos anexado el pfd al doc. contable 131 de la sociedad 1000 del ejercicio 2011, si buscamos en la tabla  SRGBTBREL  encontramos:

Vamos a seguir tirando del hilo, nos quedamos con la cadena 'EXT37000000000105' del campo INSTID_B. Nos vamos a la SE37 y ejecutamos la bapi SO_OBJECT_GET_CONTENT , rellenamos el parámetro de entrada OBJECT_ID con los anteriores datos.

En la tabla se salida OBJCONT, encontramos el identificador lógico del objeto, necesitamos el identificador físico, la relación entre ambos esta almacenada en la tabla SOFFPHIO, instancias de objetos de información físicos.

Con este identificador físico , vamos a la SOFFCONT1 donde se almacena el archivo como cluster en formato hexadecimal. como veis un solo archivo anexado puede ocupar MUCHO espacio.

Para saber como esta parametrizado tu sistema SAP, nos vamos a la tabla SDOKPHCL, clases de objetos de información físicos. Buscamos la clase SOFFPHIO.

Si STOR_CAT = SOFFDB, significa que los anexos se suben a la base de datos de SAP en la tabla  SOFFCONT1.

transacción OACT: Categorías de archivo

Notas OSS de interes:
530792 - Storing documents in the generic object services
904711 - SAPoficce: Where are documents physically stored?

Entradas siguientes:
Cambiar la categoría de archivo para GOS
RSIRPIRL: recolocando los contenidos de SOFFCONT1
Crear, Visualizar y Borrar anexos con CL_GOS_DOCUMENT_SERVICE

Carga masiva de anexos en SAP

Sybase Unwired Platform

Este mes, Blag ( Alvaro Tejada Galindo ) y Tobias Hofmann, han escrito sendos artículos contando su experiencia desarrollando aplicaciones móviles con Sybase Unwired Platform (SUP) y los Amazon Web Services (AWS).

• Blag: SUP on AWS - A better Flights example
• Tobias Hofmann: SUP on AWS without limits: VPN

El articulo de Blag me ha gustado mucho, es un sencillo ejemplo de una aplicación móvil. Tomando como base un típico ejemplo de Sap con sus famosas tablas de vuelos,monta una aplicación para consultar los vuelos de las compañías desde un dispositivo móvil. 

En cuanto mi "agenda" me lo permita, tengo que probar Sybase.

Gracias Blag!!

Conseguir acceso a un servidor SAP - 2º parte

SAPGUI 

SAP R/3 es un software basado en la arquitectura cliente/servidor. SAPGUI o SAP FRONTEND es el programa cliente de SAP y hace las funciones de interfaces entre el usuario y el servidor sap. Trabaja en la capa de presentación y "presenta" la información al usuario, interactua con el usuario y le permite navegar por las diferentes aplicaciones integradas en SAP R/3 

Existen dos SAPGUI: 

- SAPGUI for Windows: Como su propio nombre indica, para sistemas operativos windows.
- SAPGUI for Java: Es un cliente multiplataforma ( Mac OS X, Windows, Linux, Solaris y AIX ).

Actualmente puedes encontrar 4 versiones para SAPGUI for windows:
   - SAPGUI 6.20  sin soporte por parte de SAP desde 31.12.2010
   - SAPGUI 7.10  sin soporte por parte de SAP desde 31.04.2011
   - SAPGUI 7.20  con soporte por parte de SAP hasta 09.04.2013
   - SAPGUI 7.30  con soporte por parte de SAP hasta 15.07.2015

Y 3 versiones para SAPGUI for Java:
   - SAPGUI 7.10  sin soporte por parte de SAP desde 31.04.2011
   - SAPGUI 7.20  la ultima versión liberada es SAPGUI for Java rev11, no soporta Java SE 7.
                              Soporta OpenSUSE 12.1 y Fedora 16.
                              En la Nota 1400273 tenéis la lista completa de sistemas operativos que soporta.
   - SAPGUI 7.30  Soporta Java 7 y  Java de 64bits para windows
                              Soporta los siguientes sistemas operativos: 

• OpenSUSE 12.2
• Fedora 17
• Red Hat Enterprise Linux 6
• Ububtu 12.04
• OS X 10.8
• Microsoft Windows 8   

Aparte de la versión tenemos que tener en cuenta el nivel de parcheado, a mayor nivel de parcheado, menos bugs. Para ver el nivel de parcheado, hacer click en la esquina superior izquierda de la ventana del  SAPGUI-> Acerca de SAP Logon.

Para Windows 7 y Oficce 2012, necesitáis la versión 7.20 que va ya por el nivel de parcheado 14.
Para Windows XP, os vale con la 7.10 pero el nivel de parcheado dependerá de vuestro Explorer y Oficce.

SAP ,en la nota 30460, informa que siempre es posible conectarse a un sistema SAP R/3 antiguo con una versión mas actual de SAPGUI ya que  sus productos tiene retro-compatibilidad. Pero no aseguran que lo contrario, conectarnos con un SAPGUI antiguo a un sistema SAP R/3 mas actual,  funcione o si funciona no se responsabilizan de los fallos que puedan suceder.

Por ejemplo, es posible conectarse y trabajar  con un sistema SAP R/3  3.11I con SAPGUI 7.20, pero conectarse con un  SAPGUI inferior a 6.20 a un SAP ECC 6, puede dar problemas, ya que el sistema sap puede  llevar aplicaciones que no sean soportadas por el cliente SAPGUI antiguo .

Si vais a usar el "SAPGUI for Java", tenéis que utilizar la 7.30, las anteriores versiones han dejado de ser soportadas por SAP.
¿ Donde puedo conseguir e SAPGUI ?

El único problema es que para descargarlo, necesitas una cuenta en el  SAP Service Marketplace

Pero aquí os dejo un par de enlaces para conseguir la 7.20 con el parche 14 y la versión 7.30 de Java:

SAPGUI 7.20 for Windows + parche 12,13 y 14
SAPGUI 7.30 for Java - MAC OS 10.8
SAPGUI 7.30 for Java - Windows
SAPGUI 7.30 for Java - Linux

Crear una conexión a un servidor SAP

Lo primero, necesitas la dirección IP del servidor y un usuario/password.

En la anterior entrada ya explique como conseguir un acceso a un servidor sap para practicas.

Para crear la conexión al servidor sap, click en "Nuevo" -> "Continuar"

- Descripción: Descripción de la conexión
- Servidor de Aplicación: Ip del servidor del sistema SAP R/3
- Nº de Instancia: Pueden convivir varios sistemas SAP R/3 en un mismo servidor
- Id del sistema: Cadena de 3 caracteres que identifica el sistema

Una vez creada la nueva conexión, aparecerá su descripción en el SAPGUI.
Doble click en la descripción y se lanzara la conexión, si no hay errores, aparecera la pantalla de identificación del sisteam SAP R/3 solicitando que nos identifiquemos con un usuario/password valido.

Si hay otra persona usando nuestro usuario/password en el sistema cuando intentemos conectarnos. Aparecera una ventada informado sobre los usuarios conectados con el mismo usuario/passwd y tres opciones

• Cerrar todas las entradas con el mismo usuario y entrar nosotros en el sistema.
• Mantener el resto de entradas con el mismo usuario y entrar en el sistema
• Cerrar y salir del sistema

Navegando por SAP una guia rapida

Una vez autentificados, nos aparece la pantalla de inicio de SAP

En SAP, cuando queremos ejecutar  aplicación ( crear un pedido, facturar, etc... ) tenemos que ejecutar la transacción correspondiente. Una transacción es como un acceso directo del sistema, llama  a un programa con unos parámetros iniciales y se ejecuta dentro de la ventana o modo. Se pueden tener varias ventanas o modos abiertos en el escritorio, ejecutando diferentes transacciones en cada una y el limite por defecto , suele ser de 7 ventanas o modos abiertos para un usuario. Podríamos tener un modo para crear pedidos de compras, otro para la entrada de mercancías en el almacén, otro para facturación, hasta el máximo permitido por el sistema a cada usuario.

Se puede seleccionar la transacción desde el árbol de transacciones ( como los accesos directos del escritorio ) o introducir el nombre de la transacción directamente en el campo comandos (seria parecido a ejecutar un programa desde la linea de comandos del sistema ).


Para ejecutar una transacción desde el campo de comandos, primero se escribe el comando y después el código de la transacción,  por ejemplo, para acceder al editor ABAP:

- /n : Cierra la transacción actual, los datos no salvados se pierden y vuelve a la pantalla de inicio.
- /nXXXX  : Cierra la transacción actual y ejecuta la nueva transacción en la misma ventana.
- /o : Abre una nueva ventana en el sistema.
- /oXXXX : Abre una nueva ventana donde se ejecutara la nueva transacción.
- /i : Cierra la ventana actual, si es la única ventana, sale del sistema.
- /h : Activa el modo debugger.
- /nend : Pide confirmación del usuario y cierra todas las ventanas y transacciones y sale del sistema.
- /nex : Mi preferida del viernes, cierra todas las ventanas y transacciones, sale del sistema sin pedir confirmación.


Por ejemplo, para crear, modificar  o visualizar un pedido de venta tenemos las transacciones:

• VA01: crear pedido de ventas
• VA02: modificar pedido de venta
• VA03: visualizar pedido de venta

O si queremos crear, modificar o visualizar un pedido de compra.

• MM21N: Crear pedido de compra
• MM22N: Modificar pedido de compra
• MM23N: Visualizar pedido de compra

Pero estáis aquí por la programación en SAP, algunas de las transacciones que nos interesan son:

• SE38: editor de programas ABAP
• SE24: Generador de clases ( prog. orientada a objetos )
• SE37: Bapis, funciones del sistema
• SE80: Object Navigator

Encontrareis todas las transacciones para programación y desarrollo, en el árbol de transacciones siguiendo el camino Herramientas->Workbench ABAP -> Desarrollo

Fuentes:
SAP GUI Family

Entradas anteriores:
Conseguir acceso a un servidor SAP

ABAP Objects: Introduction to Programming SAP Applications

Unos de mis primeros libros sobre programación en ABAP, el lenguaje de programación de SAP. El libro esta pensado para gente que esta dando sus primeros pasos en la programación con ABAP o que quiere dar el salto a la  la programación orientada a objetos en ABAP, desde la  programación estructurada en ABAP.

Empieza con una breve introducción al  lector al sistema SAP R/3 y a la programación estructurada en ABAP. Después salta a la programación orienta a objetos en ABAP. Incluye muhos ejemplos para que el lectos practique y aprenda.


Este libro solo cubre hasta sistemas SAP R/3 release 4.6, es decir no incluye ni XML, ni Web Dynpro o Web Services, existe una segunda versión que cubre hasta SAP R/3 release 7.10.

No es un típico libro "Aprenda en 21 dias...". Son 600 paginas y solo lo encontrareis en ingles y alemán. Lleva su tiempo leerlo, a mi me costo varios meses, pero cumple su objetivo.

Incluye 2 CD con MiniSAP, una distribución de SAP con lo básico para practicar con los ejemplos del libro, personalmente, prefiero el SAP IDES 4.7 o acceder a un servidor sap para practicas en internet. 

El libro esta estructurado en 8 capítulos:

1. Introducción
2. Un introducción practica
3. Programación en ABAP basica
4. Elementos Básicos del lenguaje ABAP
5. Modelos de programación ABAP
6. Conceptos avanzados de programación orientada a objetos
7. Programación de pantallas 
8. Trabajando con datos externos

Poco mas que decir de este estupendo libro, cuando empeze a programar en SAP, su lectura me fue de mucha ayuda durante mi aprendizaje. Después de 6 años programando en ABAP, aun lo consulto cuando tengo alguna duda.

Para los que empezáis a programar con ABAP, encontrareis multitud de código para practicar y desarrollar aplicaciones SA, para los mas expertos , un buen libro de consulta a la hora de desarrolar aplicaciones en SAP.