Module sap.businessone.humanresources

ballerinax/sap.businessone.humanresources Ballerina library

1.0.0

Overview

SAP Business One is an enterprise resource planning (ERP) solution designed for small and midsize businesses by SAP SE. Its Service Layer exposes the Business One business objects through an OData web service interface.

The SAP Business One Human Resources connector provides APIs for the human resources objects of SAP Business One: employee master data, teams, and HR setup, exposed through the SAP Business One Service Layer (OData).

Key Features

  • Manage employee master data and employee roles
  • Maintain teams, positions, and employment categories
  • Track employee transfers and statuses

Setup guide

The connector requires an SAP Business One installation with the Service Layer component enabled (available for SAP Business One, version for SAP HANA, and SAP Business One on Microsoft SQL Server 9.3 PL10+). The Service Layer endpoint is https://<host>:50000/b1s/v1 by default. A Business One user with a license and the relevant object authorizations is needed; sessions are opened against a specific company database (schema).

Quickstart

To use the sap.businessone.humanresources connector in your Ballerina application, modify the .bal file as follows:

Step 1: Import the module

Copy
import ballerinax/sap.businessone.humanresources;

Step 2: Instantiate a new connector

The connector authenticates with the Service Layer session protocol: it logs in with the configured company database, user name, and password, tracks the B1SESSION/ROUTEID cookies, and transparently re-logs in once when the session expires. Place the credentials in a Config.toml (never commit credentials to source control):

Copy
serviceUrl = "https://<host>:50000/b1s/v1"
companyDb = "<COMPANY_DB>"
username = "<USER>"
password = "<PASSWORD>"
Copy
configurable string serviceUrl = ?;
configurable string companyDb = ?;
configurable string username = ?;
configurable string password = ?;

humanresources:Client b1Client = check new (
    {companyDb, username, password},
    serviceUrl = serviceUrl
);

Step 3: Invoke the connector operation

Copy
humanresources:EmployeesInfo_CollectionResponse response = check b1Client->employeesInfoList();

Step 4: Run the Ballerina application

Copy
bal run

Examples

The SAP Business One connectors provide practical examples illustrating usage in various scenarios. Explore these examples, covering use cases like listing open sales orders, reporting inventory stock, and logging CRM activities.

Import

import ballerinax/sap.businessone.humanresources;Copy

Other versions

Metadata

Released date: 12 days ago

Version: 1.0.0

License: Apache-2.0


Compatibility

Platform: any

Ballerina version: 2201.13.0

GraalVM compatible: Yes


Pull count

Total: 0

Current verison: 0


Weekly downloads


Source repository


Keywords

Name/SAP Business One Human Resources

Area/ERP & Business Operations

Vendor/SAP

Cost/Paid

Type/Connector

SAP Business One

Human Resources

ERP


Contributors