Kemenkeu.Client.Hris.Profil 0.1.0

Kemenkeu.Client.Hris.Profil

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

Features

• Provides APIs for managing HRIS Profil 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.Profil

Or via .NET CLI:

dotnet add package Kemenkeu.Client.Hris.Profil

Configuration

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

1. With User Token

{
  "ExternalService": {
    "BaseUrl": "https://thegatewayservice.com"
  }
}

2. With Application Token

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

or

{
  "ExternalService": {
    "BaseUrl": "https://gatewayserver.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()
                    .AddProfil();
        });
            
        // 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()
            .AddProfil();
});

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()
                    .AddProfil();
        });
            
        // 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()
            .AddProfil();;
});

var app = builder.Build();

// Configure others.

app.Run();

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

1. Add a reference to the Kemenkeu.Client.Core, Kemenkeu.Client.Hris.Core, and Kemenkeu.Client.Hris.Profil 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.Profil;

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<HrisProfil>> GetAsync()
    {
        return await _kemenkeuClient.Hris().Profil().GetPegawaiById(0);
    }
}

Sample usage in services:

public class SampleService
{
    private readonly IKemenkeuClient _kemenkeuClient;

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

    public async Task<HrisProfil> GetProfilAsync()
    {
        return await _kemenkeuClient.Hris().Profil().GetPegawaiById(0);
    }
}

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

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

using Kemenkeu.Client.Hris.Profil;

3. Utilize the provided classes and methods as needed.

Sample usage directly in controllers:

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

    public SampleController(IHrisProfilService hrisProfilService)
    {
        _hrisProfilService = hrisProfilService;
    }

    [HttpGet]
    public async Task<ActionResult<HrisProfil>> GetAsync()
    {
        return await _hrisProfilService.GetPegawaiById(0);
    }
}

Sample usage in services:

public class SampleService
{
    private readonly IHrisProfilService _hrisProfilService;

    public SampleService(IHrisProfilService hrisProfilService)
    {
        _hrisProfilService = hrisProfilService;
    }

    public async Task<HrisProfil> GetProfilAsync()
    {
        return await _hrisProfilService.GetPegawaiById(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