Archivar adjuntos en SAP S/4HANA Cloud Public Edition

Respuesta breve

Para archivar adjuntos en SAP S/4HANA Cloud Public Edition, la planificación debe partir del objeto de negocio concreto: ¿qué aplicación genera el adjunto, qué framework documental lo gestiona, dónde se almacena el contenido y cómo se podrá recuperar más adelante? SAP documenta para el Attachment Service un repositorio estándar en SAP BTP y la posibilidad de conectar repositorios externos. Por tanto, integrar un repositorio de terceros mediante CMIS es una decisión de arquitectura, no un requisito automático para todos los adjuntos. [1] [2]

Que una carga se complete correctamente no demuestra que el documento vaya a seguir disponible de forma trazable durante todo el período de uso previsto. Para ello, el proyecto necesita reglas de conservación definidas, autorizaciones verificadas y un procedimiento de recuperación y exportación probado. Esta guía describe la planificación técnica y las pruebas de aceptación, no el reconocimiento jurídico de una solución de archivo.

Alcance y límites

La guía trata los archivos y las URL de adjuntos gestionados mediante objetos de negocio y frameworks documentales compatibles con SAP S/4HANA Cloud Public Edition. La documentación de SAP verificada corresponde a la versión 2608; la versión realmente utilizada y la configuración activada deben confirmarse por separado.

No aborda una configuración general para todas las aplicaciones Fiori, la aplicación de transacciones de sistemas on-premise a Public Edition, el archivado de datos del ERP ni la migración completa de cualquier archivo documental existente. No ofrece garantías de cumplimiento de las GoBD alemanas, certificación, costes ni acuerdos de nivel de servicio (SLA). Este artículo tampoco confirma la idoneidad de una solución concreta de arcana.

Para una decisión general sobre interfaces, puede consultar el artículo ¿ArchiveLink o CMIS?. Aquí, en cambio, el enfoque es específicamente el ciclo de vida de un adjunto de Public Edition.

Fase 1: Definir la aplicación, el objeto de negocio y el archivo original

Empiece con un caso piloto acotado: una aplicación concreta, un objeto de negocio y un tipo de documento relevante para el proceso. Documente el nombre de la aplicación, el tipo de objeto o de nodo, la clave del objeto, el framework utilizado y la finalidad de conservación prevista. Un piloto solo aporta resultados representativos cuando estos datos proceden del sistema propio, y no de un ejemplo genérico del producto.

La API de adjuntos API_CV_ATTACHMENT_SRV permite gestionar adjuntos y URL de adjuntos de objetos de negocio. Su documentación describe, entre otras operaciones, la creación, lectura, modificación del nombre y eliminación. También señala limitaciones: la API no admite la funcionalidad de borradores de objetos de negocio y, según la documentación, no es compatible con las aplicaciones consumidoras que utilizan esa funcionalidad. El contenido de un adjunto existente no se puede actualizar mediante esta API. Estas limitaciones deben comprobarse en el flujo de la aplicación concreta. [3]

Distinga también entre un archivo original cargado y una referencia URL almacenada. En el caso de un enlace, debe aclararse quién gestiona el destino y si el documento seguirá siendo accesible tras un cambio en el sistema de destino. La lista de adjuntos, por sí sola, no demuestra que el archivo original esté protegido a largo plazo.

Fase 2: Registrar por separado la vinculación en SAP y la ubicación de almacenamiento

SAP describe dos niveles: los datos estructurados, como el nombre del archivo y el tipo MIME, se gestionan en tablas de la base de datos de SAP; el contenido documental propiamente dicho se almacena en un repositorio basado en CMIS. A su vez, el repositorio conserva contenido y metadatos. La arquitectura estándar de SAP utiliza SAP Document Management Service en BTP a través de SAP Content Bridge. [1]

Por ello, para la aceptación del proyecto se recomienda establecer una correspondencia entre la clave del objeto de negocio, el ID lógico del documento, el ID físico del documento y la categoría de almacenamiento, siempre que estos campos estén disponibles en el flujo correspondiente. La documentación de la API menciona, por ejemplo, LogicalDocument, ArchiveDocumentID, LinkedSAPObjectKey y StorageCategory. [3]

Compruebe dos situaciones de fallo distintas: que un archivo exista en el repositorio, pero ya no sea accesible desde el objeto de negocio; o que la lista de adjuntos muestre una entrada cuyo archivo no se pueda cargar. Para ambos casos debe definirse un procedimiento de recuperación y escalamiento.

Fase 3: Elegir entre el repositorio estándar y la integración de terceros

Compare primero el repositorio estándar disponible con los requisitos del negocio. Si se elige un repositorio externo, SAP documenta el escenario de comunicación SAP_COM_0597, gestionado por el cliente, y la integración mediante SAP Document Management service, integration option, en BTP Cloud Foundry a través de CMIS. La configuración y la integración de productos no desarrollados por SAP son responsabilidad del cliente. [2]

SAP recomienda soluciones certificadas para esta vía de integración. Esto no confirma que un proveedor, una versión de producto o un caso de uso determinado cuenten actualmente con certificación. Antes de seleccionar una solución, compruebe la acreditación correspondiente para el escenario aplicable. [2]

La guía de integración de un repositorio documental CMIS en SAP BTP explica la conexión técnica con más detalle. No trate esta configuración como un proyecto de archivo independiente: para los adjuntos de Public Edition, el comportamiento de la aplicación, las vinculaciones en SAP y el repositorio deben superar conjuntamente las pruebas de aceptación.

Fase 4: Comprobar los tipos de documento, HDM y las categorías de almacenamiento

Harmonized Document Management, abreviado HDM, puede unificar frameworks documentales compatibles, como DMS y GOS, para el objeto de negocio configurado. Sin esta configuración, la API solo puede devolver adjuntos de DMS o de GOS para cada tipo de objeto indicado; para obtener ambos, pueden ser necesarias llamadas separadas. Con HDM debidamente configurado, se tienen en cuenta los frameworks mantenidos como activos para ese objeto. [3]

La documentación de configuración de SAP menciona las actividades 101090 – Define DMS Document Types, 105346 – Activate HDM for Attachment Object Type y 103583 – Maintain Storage Categories. Esta última actividad afecta a los clientes que eligen un repositorio externo para almacenar archivos. Utilice el entorno de configuración de su versión y compruebe las autorizaciones de configuración necesarias; estas actividades no constituyen una guía universal para todas las aplicaciones. [4]

Tras la configuración, registre qué tipos de documento están permitidos, qué framework se utiliza realmente y qué categoría de almacenamiento se asigna al caso piloto. Haga pruebas con un archivo recién creado y con un adjunto existente, no solo con una comprobación de conexión satisfactoria.

Fase 5: Probar el comportamiento del acceso, la conservación y la eliminación

Defina primero el comportamiento esperado. ¿Quién puede leer un documento? ¿Quién puede almacenar una nueva versión o cambiar el nombre? ¿Quién puede iniciar una eliminación y qué ocurre durante un período de conservación o de bloqueo? Estas reglas deben proceder del modelo funcional y jurídico de la empresa; la integración técnica no las establece automáticamente.

La API devuelve, entre otros, datos como AttachmentDeletionIsAllowed y AttachmentRenameIsAllowed. Estos campos ayudan a comprobar una operación concreta, pero no sustituyen un modelo completo de autorizaciones ni una prueba de cumplimiento de los requisitos legales de conservación. [3]

Se recomiendan los siguientes pasos para las pruebas de aceptación:

  1. Una persona autorizada descarga el original desde el objeto de negocio correcto y compara el archivo con el conjunto de referencia acordado.
  2. Una persona no autorizada no obtiene acceso indebido, ni a través de la aplicación ni mediante una vía técnica adicional incluida en las pruebas.
  3. Un cambio de nombre permitido y un intento no permitido de modificación o eliminación producen el comportamiento definido.
  4. Una interrupción del repositorio genera un error identificable, una recuperación del servicio documentada y ninguna pérdida silenciosa de la vinculación.
  5. Una vez transcurrido el plazo acordado, se registran de forma trazable la autorización para proceder, los posibles bloqueos y la decisión de eliminación.

Estos pasos son recomendaciones para el proyecto. El piloto debe demostrar si el producto concreto los admite.

Fase 6: Preparar la exportación y un futuro cambio de sistema

Planifique la recuperación fuera del proceso cotidiano de la aplicación antes de la puesta en producción. Una exportación no debe proporcionar únicamente archivos, sino también la correspondencia necesaria con el objeto de negocio, metadatos legibles y un registro verificable de cantidades e integridad del conjunto. Defina qué información debe estar realmente disponible para ello.

SAP describe el onboarding desde el repositorio gestionado por el cliente hacia el gestionado por SAP, y el offboarding en sentido inverso. Para el offboarding, SAP menciona Attachment Data Returns, que incluye contenido vinculado a objetos de negocio y determinados documentos de salida. Esto constituye una base de proceso documentada, pero no una garantía de migración automática entre repositorios de archivo de terceros cualesquiera. [5]

Si ya existe un archivo documental, la lista de verificación para migrar un archivo SAP a la nube complementa el piloto descrito aquí. Incluya una exportación de prueba en la aceptación: el archivo original debe ser legible, el objeto de negocio asociado debe poder identificarse, los metadatos necesarios deben estar presentes y la conciliación de cantidades debe ser trazable.

Preguntas frecuentes

¿Necesita cada adjunto de Public Cloud un repositorio de archivo externo de terceros?

No. De la documentación de SAP utilizada no se desprende una obligación general de este tipo. SAP describe un repositorio estándar y una alternativa de integración con terceros. Debe evaluarse por separado qué opción cumple los requisitos funcionales y jurídicos de la empresa. [1] [2]

¿Basta con una conexión CMIS operativa para aceptar la solución de archivo?

No. La conexión demuestra inicialmente que existe una vía de comunicación técnica. Para aceptar la solución que gestiona ese adjunto, también deben comprobarse la vinculación con el objeto de negocio, la recuperación del original, las autorizaciones, el ciclo de vida definido y una exportación adecuada.

¿Es una URL de adjunto almacenada lo mismo que un archivo original archivado?

No. La API admite tanto adjuntos como URL de adjuntos. En una referencia, la disponibilidad del contenido también depende del destino; la conservación del original a largo plazo debe demostrarse en el modelo definido para ese caso. [3]

Fuentes

arcana Solutions

Hablemos de su proyecto de archivado SAP

¿Desea revisar la migración de su archivo, la integración de repositorios o el modelo operativo? Elija una cita y hable con nuestro equipo sobre el siguiente paso adecuado.