Kemenkeu.Client.Hris.Referensi 0.1.1

Kemenkeu.Client.Hris.Referensi

This project is a NuGet package designed to provide functionalities related to the HRIS Referensi module for Kemenkeu applications.

Features

• Provides APIs for managing HRIS Referensi data.
• Simplifies integration with Kemenkeu systems.
• Lightweight and easy to use.

Installation

To install the package, use the NuGet Package Manager Console:

Install-Package Kemenkeu.Client.Hris.Referensi

Or via .NET CLI:

dotnet add package Kemenkeu.Client.Hris.Referensi

Configuration

Add the following configuration to your appsettings.json and adjust according the system config:

1. With User Token

{
  "ExternalService": {
    "BaseUrl": "https://server.net"
  }
}

2. With Application Token

{
  "Auth": {
    "AuthorityUrl": "https://authorizationserver.net",
  },
  "ExternalService": {
    "BaseUrl": "https://server.net",
    "Auth": {
      "ClientId": "client_id",
      "ClientSecret": "client_secret",
      "GrantType": "grant_type",
      "Scope": "scope"
    },
  }
}

or

{
  "ExternalService": {
    "BaseUrl": "https://server.net",
    "AuthorityUrl": "https://authorizationserver.net",
    "Auth": {
      "ClientId": "client_id",
      "ClientSecret": "client_secret",
      "GrantType": "grant_type",
      "Scope": "scope"
    },
  }
}

Usage

1. With User Token

a. Setup in Startup.cs

In .NET 5 or Older, use Startup.cs to configure services.

Register Kemenkeu.Client.Core in the ConfigureServices method:

public class Startup
{
    public IConfiguration Configuration { get; }

    public Startup(IConfiguration configuration)
    {
        Configuration = configuration;
    }

    public void ConfigureServices(IServiceCollection services)
    {
        services.AddKemenkeuClient(config =>
        {
            config.WithUserToken(Configuration)
                .AddHris()
                    .AddReferensi();
        });
            
        // Other services...
    }
}

b. Setup in Program.cs

In .NET 6 or later, configure services directly in Program.cs.

Configure services:

var builder = WebApplication.CreateBuilder(args);

// Add services to the container.
builder.Services.AddKemenkeuClient(config =>
{
    config.WithUserToken(builder.Configuration)
        .AddHris()
            .AddReferensi();
});

var app = builder.Build();

// Configure others.

app.Run();

2. With Application Token

a. Setup in Startup.cs

In .NET 5 or Older, use Startup.cs to configure services.

Register Kemenkeu.Client.Core in the ConfigureServices method:

public class Startup
{
    public IConfiguration Configuration { get; }

    public Startup(IConfiguration configuration)
    {
        Configuration = configuration;
    }

    public void ConfigureServices(IServiceCollection services)
    {
        services.AddKemenkeuClient(config =>
        {
            config.WithApplicationToken(Configuration)
                .AddHris()
                    .AddReferensi();
        });
            
        // Other services...
    }
}

b. Setup in Program.cs

In .NET 6 or later, configure services directly in Program.cs.

Configure services:

var builder = WebApplication.CreateBuilder(args);

// Add services to the container.
builder.Services.AddKemenkeuClient(config =>
{
    config.WithApplicationToken(builder.Configuration)
        .AddHris()
            .AddReferensi();;
});

var app = builder.Build();

// Configure others.

app.Run();

3. Setup in your Project Controller or Service via IKemenkeuClient and Hris() and Referensi() extension method

1. Add a reference to the Kemenkeu.Client.Core, Kemenkeu.Client.Hris.Core, and Kemenkeu.Client.Hris.Referensi package in your project.
2. Import the necessary namespaces in your code:

using Kemenkeu.Client.Core;
using Kemenkeu.Client.Hris.Core;
using Kemenkeu.Client.Hris.Referensi;

3. Utilize the provided classes and methods as needed.

Sample usage directly in controllers:

[ApiController]
[Route("[controller]")]
public class SampleController : ControllerBase
{
    private readonly IKemenkeuClient _kemenkeuClient;

    public SampleController(IKemenkeuClient kemenkeuClient)
    {
        _kemenkeuClient = kemenkeuClient;
    }

    [HttpGet]
    public async Task<ActionResult<HrisOrganisasiBasic>> GetAsync()
    {
        return await _kemenkeuClient.Hris().Referensi().Organisasi.GetRefOrganisasiById(0);
    }
}

Sample usage in services:

public class SampleService
{
    private readonly IKemenkeuClient _kemenkeuClient;

    public SampleService(IKemenkeuClient kemenkeuClient)
    {
        _kemenkeuClient = kemenkeuClient;
    }

    public async Task<HrisOrganisasiBasic> GetOrganisasiAsync()
    {
        return await _kemenkeuClient.Hris().Referensi().Organisasi.GetRefOrganisasiById(0);
    }
}

4. Setup in your Project Controller or Service using IHrisReferensiService directly

1. Add a reference to the Kemenkeu.Client.Hris.Referensi package in your project.
2. Import the necessary namespaces in your code:

using Kemenkeu.Client.Hris.Referensi;

3. Utilize the provided classes and methods as needed.

Sample usage directly in controllers:

[ApiController]
[Route("[controller]")]
public class SampleController : ControllerBase
{
    private readonly IHrisReferensiService _hrisReferensiService;

    public SampleController(IHrisReferensiService hrisReferensiService)
    {
        _hrisReferensiService = hrisReferensiService;
    }

    [HttpGet]
    public async Task<ActionResult<HrisOrganisasiBasic>> GetAsync()
    {
        return await _hrisReferensiService.Organisasi.GetRefOrganisasiById(0);
    }
}

Sample usage in services:

public class SampleService
{
    private readonly IHrisReferensiService _hrisReferensiService;

    public SampleService(IHrisReferensiService hrisReferensiService)
    {
        _hrisReferensiService = hrisReferensiService;
    }

    public async Task<HrisOrganisasiBasic> GetOrganisasiAsync()
    {
        return await _hrisReferensiService.Organisasi.GetRefOrganisasiById(0);
    }
}

Requirements

• .NET Version: This package compatible with .NET Core 2.1 (via .NET Standard 2.0), .NET Core 3.1 and later.
• Dependencies:
  • Kemenkeu.Client.Hris.Core