## Prerequisites

/ORK/CORE targets systems with `SAP_BASIS >= 758`. Import it with [abapGit](https://abapgit.org/) as an [online repository](https://docs.abapgit.org/user-guide/projects/online/install.html):

```text
https://github.com/eplamsi/ork_core.git
```

Use the repository defaults (Folder Logic: Full), pull the objects into your target package, and activate the imported objects.

:::information
The development keys for `/ORK/` are listed in SAP's [ABAP Open Source Namespaces registry](https://github.com/SAP/abap-open-source-namespaces).
:::

## ABAP For Cloud

The library is designed for ABAP for Cloud use. The exception is `/ork/cl_weak_ref`, which depends on `cl_abap_weak_reference`; keep that object out of Cloud-restricted code paths.

:::information
SAP has been informed of the need for weak reference support in the cloud.
:::

## First Useful Call

The public entry points are usually static factories or singleton facades. A compact first check is to parse JSON and serialize it again:

```abap
DATA(json) = /ork/cl_json=>parse->string(
  `{ "name": "ORK", "active": true }`
).

DATA(text) = json->to_string( ).
```

Next, read the [Key Concepts guide](https://eplamsi.org/docs/ork_core/guides/key-concepts/) to understand the package layout and API conventions. For JSON-specific methods, see the `/ork/cl_json` reference and the node interfaces.