Konektor kustom

Halaman ini menyediakan ringkasan fitur konektor kustom dalam Konektor Integrasi, dan mengasumsikan bahwa Anda telah memahami konsep berikut:

Fitur konektor kustom memungkinkan Anda menggunakan konektor yang bukan bagian dari konektor standar yang disediakan oleh Konektor Integrasi. Misalnya, Anda mungkin memiliki Sistem Manajemen Sumber Daya Manusia (HRMS) internal dengan protokol konektivitas eksklusif, yang ingin Anda tampakkan ke Integrasi Aplikasi melalui konektor. Fitur konektor kustom berguna dalam skenario berikut:

  • Konektor bawaan tidak tersedia di Konektor Integrasi untuk sumber data atau layanan yang ingin Anda hubungkan.
  • Konektor bawaan tersedia di Konektor Integrasi, tetapi tidak memenuhi persyaratan Anda.

Bagaimana Integration Connectors mendukung konektor kustom?

Integration Connectors mendukung konektor kustom melalui spesifikasi Open API (versi 3.0.0 dan semua versi minornya). Anda dapat mengekspos backend sebagai endpoint publik, lalu menggunakan spesifikasi Open API endpoint untuk membuat konektor baru yang terhubung ke endpoint (backend).

Spesifikasi Open API endpoint menentukan kontrak antara Integration Connectors dan endpoint. Integration Connectors menggunakan spesifikasi API untuk membuat tindakan dan entity konektor. Spesifikasi API dapat berupa JSON atau YAML. Berikut adalah kutipan dari contoh spesifikasi Open API dari layanan backend:

{
"openapi":"3.0.2",
"info":{
	"title":"Swagger Petstore - OpenAPI 3.0",
	"description":"This is a sample Pet Store Server based on the OpenAPI 3.0 specification.
  You can find out more about\nSwagger at [
	http://swagger.io](http://swagger.io). In the third iteration of the pet store,
	we've switched to the design first approach!\nYou can now help us improve the API whether
  it's by making changes to the definition itself or to the code.\nThat way,
	with time, we can improve the API in general, and expose some of the new
  features in OAS3.\n\nSome useful links:\n-
  [
	   The Pet Store repository
	]
.....
.....
"paths":{
"/pet/{petId}/uploadImage":{
  "post":{
    "tags":[
},
.....
.....
"/pet/findByStatus":{
  "get":{
    "tags":[
      "pet"
    ],
.....
.....
},
"api_key":{
  "type":"apiKey",
  "name":"api_key",
  "in":"header"
}
}
}
}

Untuk melihat spesifikasi contoh lengkap, lihat Contoh repositori toko hewan peliharaan. Misalkan Anda menggunakan spesifikasi contoh ini untuk membuat konektor kustom, Integration Connectors akan menghasilkan tindakan terpisah untuk setiap elemen dalam path. Misalnya, uploadImage dan findByStatus akan dicantumkan sebagai tindakan yang didukung oleh konektor kustom.

Skenario konektivitas backend

Konektor Integrasi mendukung konektor kustom untuk skenario konektivitas backend berikut:

  • Konektivitas backend langsung
  • Konektivitas backend tidak langsung

Skenario - Konektivitas backend langsung

Dalam skenario ini, runtime Integration Connectors akan langsung membuat konektivitas ke backend yang mematuhi Open API. Ilustrasi berikut menunjukkan konektivitas konektor dalam skenario ini:

konektivitas backend langsung

Skenario - Konektivitas backend tidak langsung

Dalam skenario ini, runtime Integration Connectors akan menetapkan konektivitas ke backend Anda melalui layanan perantara (fasade) yang mematuhi Open API. Selanjutnya, layanan perantara akan terhubung ke backend Anda. Ilustrasi berikut menunjukkan konektivitas konektor dalam skenario ini:

konektivitas backend tidak langsung

Langkah selanjutnya

Pahami cara membuat konektor kustom.