ABAPNet.Cluster

A library to convert data in .NET into the cluster format for ABAP

It provides functionality to import from or export to a SAP cluster format. Not all data types are supported yet.

Getting Started

ABAPNet.Cluster is distributed via NuGet as a NuGet package. It can be installed into your project using NuGet Package Manager in Visual Studio.

Package Manager CLI Install-Package ABAPNet.Cluster -Version 1.2.3

.NET CLI dotnet add package ABAPNet.Cluster --version 1.2.3

How it works

From .NET to SAP

Create a structure or class as the data interface and define the ABAP-types with the provided attributes

struct ClusterData
{
    [ClusterFieldName("EMPLOYEES")]
    [FlatTable]
    public Employee[] Employees { get; set; }
}

struct Employee
{
    [Int4]
    public int Id { get; set; }

    [Char(32)]
    public string Firstname { get; set; }

    [Char(32)]
    public string Lastname { get; set; }

    [String]
    public string Email { get; set; }

    [Dats]
    public DateOnly Birthday { get; set; }
}

The data can then be exported using the DataBuffer class. The resulting byte-array can be used in SAP for importing the data with IMPORT ... FROM DATA BUFFER ...

ClusterData data = new()
{
    Employees = new Employee[]
    {
        new() { Id = 1, Firstname = "Olivia", Lastname = "Bennett", Email = "olivia.benett@example.com", Birthday = new DateOnly(1990, 06, 15) },
        new() { Id = 2, Firstname = "Ethan", Lastname = "Mitchell", Email = "ethan.mitchell@example.com", Birthday = new DateOnly(1985, 11, 3) },
        new() { Id = 3, Firstname = "Sophia", Lastname = "Anderson", Email = "sophia.anderson@example.com", Birthday = new DateOnly(1995, 04, 22) }
    }
};

DataBuffer dataBuffer = new DataBuffer();
byte[] dataExport = dataBuffer.Export(data);

TYPES:
  BEGIN OF t_employee,
    id        TYPE i,
    firstname TYPE c LENGTH 32,
    lastname  TYPE c LENGTH 32,
    email     TYPE string,
    birthday  TYPE d,
  END OF t_employee.

DATA: lt_employees TYPE STANDARD TABLE OF t_employee WITH DEFAULT KEY.

DATA: lv_data_export TYPE xstring VALUE 'FF060201010280003431303300000000...'.
IMPORT employees = lt_employees FROM DATA BUFFER lv_data_export.

From ABAP to .NET

The structures can be defined as above. Only the export and import side are switched.

EXPORT employees = lt_employees TO DATA BUFFER lv_data_export.

DataBuffer dataBuffer = new DataBuffer();
data = dataBuffer.Import<ClusterData>(dataExport);

Supports/Features

This library was only tested on an R/3 750 SP17 and currently only supports a little-endian system. Extension for a big-endian system are foreseen but not yet fully implemented. Also only the codepage 4103 (utf-16le) is supported yet.

Supported types/attributes

The following attributes are provided to support the corresponding ABAP-types. For all attributes there is a corresponding table attribute, e.g. Char -> CharTable.

Attribute	Corresponding ABAP-types	Supported .NET-types
Char(Length)	c	string, char, char[]
Dats	d	DateOnly, DateTime
Decimal(Length, Decimals)	p	decimal, double, float
DeepStruct	deep structs	struct, class
DeepTable	tables with deep structs	IList
FlatStruct	flat structs	struct, class
FlatTable	tables with flat structs	IList
Float	f	float, double
Int1	int1	byte, sbyte
Int2	int2	short, ushort
Int4	int4	int, uint
Int8	int8	long, ulong
Numc(Length)	n	byte, sbyte, short, ushort, int, uint, long, ulong, string
RawStringType	xstring	byte[]
Raw(Length)	x	byte[], byte
String	string	string
Tims	t	TimeOnly, DateTime