UKG

Konektor UKG memungkinkan Anda melakukan berbagai tindakan pada data UKG.

Sebelum memulai

Sebelum menggunakan konektor UKG, lakukan tugas berikut:

  • Di project Google Cloud Anda:
    • Pastikan konektivitas jaringan telah disiapkan. Untuk mengetahui informasi tentang pola jaringan, lihat Konektivitas jaringan.
    • Berikan peran IAM roles/connectors.admin kepada pengguna yang mengonfigurasi konektor.
    • Berikan peran IAM berikut ke akun layanan yang ingin Anda gunakan untuk konektor:
      • roles/secretmanager.viewer
      • roles/secretmanager.secretAccessor

      Akun layanan adalah jenis Akun Google khusus yang dimaksudkan untuk mewakili pengguna non-manusia yang perlu diautentikasi dan diberi otorisasi untuk mengakses data di Google API. Jika Anda tidak memiliki akun layanan, Anda harus membuat akun layanan. Untuk mengetahui informasi selengkapnya, lihat Membuat akun layanan.

    • Aktifkan layanan berikut:
      • secretmanager.googleapis.com (Secret Manager API)
      • connectors.googleapis.com (Connectors API)

      Untuk memahami cara mengaktifkan layanan, lihat Mengaktifkan layanan.

    Jika layanan atau izin ini belum diaktifkan untuk project Anda sebelumnya, Anda akan diminta untuk mengaktifkannya saat mengonfigurasi konektor.

Mengonfigurasi konektor

Koneksi khusus untuk sumber data. Artinya, jika Anda memiliki banyak sumber data, Anda harus membuat koneksi terpisah untuk setiap sumber data. Untuk membuat koneksi, lakukan hal berikut:

  1. Di Konsol Cloud, buka halaman Integration Connectors > Connections lalu pilih atau buat project Google Cloud.

    Buka halaman Koneksi

  2. Klik + BUAT BARU untuk membuka halaman Buat Koneksi.
  3. Di bagian Location, pilih lokasi untuk koneksi.
    1. Wilayah: Pilih lokasi dari menu drop-down.

      Untuk mengetahui daftar semua region yang didukung, lihat Lokasi.

    2. Klik NEXT.
  4. Di bagian Detail Koneksi, selesaikan langkah-langkah berikut:
    1. Konektor: Pilih UKG dari daftar drop-down Konektor yang tersedia.
    2. Versi konektor: Pilih versi Konektor dari daftar drop-down versi yang tersedia.
    3. Di kolom Connection Name, masukkan nama untuk instance Koneksi.

      Nama koneksi harus memenuhi kriteria berikut:

      • Nama koneksi dapat menggunakan huruf, angka, atau tanda hubung.
      • Huruf harus berupa huruf kecil.
      • Nama koneksi harus diawali dengan huruf dan diakhiri dengan huruf atau angka.
      • Nama koneksi tidak boleh melebihi 49 karakter.
    4. Secara opsional, masukkan Deskripsi untuk instance koneksi.
    5. Secara opsional, aktifkan Cloud Logging, lalu pilih level log. Secara default, level log ditetapkan ke Error.
    6. Akun Layanan: Pilih akun layanan yang memiliki peran yang diperlukan.
    7. Service/Module: Pilih modul UKG.
    8. Jika perlu, konfigurasikan Setelan node koneksi:

      • Jumlah minimum node: Masukkan jumlah minimum node koneksi.
      • Jumlah node maksimum: Masukkan jumlah maksimum node koneksi.

      Node adalah unit (atau replika) koneksi yang memproses transaksi. Jumlah node yang diperlukan untuk memproses lebih banyak transaksi untuk suatu koneksi akan bertambah dan sebaliknya, jumlah node yang diperlukan untuk memproses lebih sedikit transaksi akan berkurang. Untuk memahami pengaruh node terhadap harga konektor, lihat Harga untuk node koneksi. Jika Anda tidak memasukkan nilai apa pun, secara default node minimum ditetapkan ke 2 (untuk ketersediaan yang lebih baik) dan node maksimum ditetapkan ke 50.

    9. Secara opsional, klik + TAMBAHKAN LABEL untuk menambahkan label ke Koneksi dalam bentuk pasangan kunci/nilai.
    10. Klik NEXT.
  5. Di bagian Destinations, masukkan detail host jarak jauh (sistem backend) yang ingin Anda hubungkan.
    1. Jenis Tujuan: Pilih Jenis Tujuan.
      • Untuk menentukan nama host atau alamat IP tujuan, pilih Alamat host dan masukkan alamat di kolom Host 1.
      • Untuk membuat koneksi pribadi, pilih Endpoint attachment dan pilih lampiran yang diperlukan dari daftar Endpoint Attachment.

      Jika ingin membuat koneksi publik ke sistem backend dengan keamanan tambahan, Anda dapat mempertimbangkan mengonfigurasi alamat IP keluar statis untuk koneksi Anda, lalu mengonfigurasi aturan firewall untuk hanya mengizinkan alamat IP statis tertentu.

      Untuk memasukkan tujuan tambahan, klik +TAMBAHKAN TUJUAN.

    2. Klik NEXT.
  6. Di bagian Authentication, masukkan detail autentikasi.
    1. Pilih Jenis autentikasi dan masukkan detail yang relevan.

      Jenis autentikasi berikut didukung oleh koneksi UKG:

      • Autentikasi Dasar
      • OAUTH 2.0 - Kode otorisasi
      • Untuk memahami cara mengonfigurasi jenis autentikasi ini, lihat Mengonfigurasi autentikasi.

      • Klik NEXT.
  7. Tinjau: Tinjau detail koneksi dan autentikasi Anda.
  8. Klik Buat.

Mengonfigurasi autentikasi

Masukkan detail berdasarkan autentikasi yang ingin Anda gunakan.

  • Autentikasi Dasar
    • Nama pengguna: Nama pengguna yang digunakan untuk mengautentikasi konektor.
    • Sandi: Secret Manager Secret yang berisi sandi yang terkait dengan konektor.
  • OAUTH 2.0 - Kode otorisasi
    • Client ID: Client ID yang digunakan untuk meminta token akses.
    • Cakupan:Daftar cakupan yang diinginkan, dipisahkan koma.
    • Rahasia Klien: Secret Manager Secret yang berisi rahasia klien untuk aplikasi terhubung yang Anda buat.
    • Aktifkan PKCE: Pilih opsi ini jika Anda ingin mengaktifkan Kunci Bukti Pertukaran Kode (PKCE).
    • URL otorisasi: URL otorisasi untuk aplikasi Anda. Anda akan dialihkan ke halaman ini untuk login ke aplikasi Anda.
    • URL Token Akses: URL yang akan digunakan untuk menukar token akses. Berikan URL lengkap termasuk skema.

Contoh konfigurasi koneksi

Bagian ini mencantumkan contoh nilai untuk berbagai kolom yang Anda konfigurasi saat membuat koneksi.

OAUTH 2.0 - Jenis koneksi kode otorisasi

Nama kolom Detail
Lokasi us-central1
Konektor UKG
Versi konektor 1
Nama Koneksi gcp-ukg-oauth-conn
Mengaktifkan Cloud Logging Ya
Tingkat Log Error
Akun Layanan SERVICEACCOUNT_NAME@developer.gserviceaccount.com
Modul spesifikasi Open API Pengaturan waktu
Tingkat Keberbagaian 5
Jumlah minimum node 2
Jumlah maksimum node 50
Jenis Tujuan Alamat host
Alamat Host https://google-connect-dev.cfn.mykronos.com
ID Klien ZG******-****-****-****-*********uDN
Rahasia klien Rahasia
Versi Secret 1
URL otorisasi https://google-connect-dev.cfn.mykronos.com/oauth2/authorize
URL token akses https://google-connect-dev.cfn.mykronos.com/api/authentication/access_token

Batasan sistem

Konektor UKG dapat memproses 30 transaksi per detik, per node, dan membatasi transaksi apa pun di luar batas ini. Secara default, Integration Connectors mengalokasikan 2 node (untuk ketersediaan yang lebih baik) untuk koneksi.

Untuk mengetahui informasi tentang batas yang berlaku untuk Integration Connectors, lihat Batas.

tindakan

Konektor ini memungkinkan Anda melakukan berbagai tindakan pada data UKG.

Bagian ini mencantumkan tindakan yang didukung oleh konektor UKG. Untuk memahami cara mengonfigurasi tindakan, lihat Contoh tindakan.

Tindakan RetrieveAllEmployeeGroupsOrByName

Mengambil semua grup karyawan menurut nama.

Parameter input tindakan RetrieveAllEmployeeGroupsOrByName

Nama Parameter Jenis Data Wajib Deskripsi
all_details boolean Benar Boolean yang menunjukkan apakah respons ringan, yaitu respons yang hanya berisi kolom ID dan nama.
nama string Benar Nama grup karyawan.

Untuk contoh cara mengonfigurasi tindakan RetrieveAllEmployeeGroupsOrByName, lihat Contoh.

Membuat tindakan PayCode

Membuat kode pembayaran.

Parameter input tindakan Create PayCode

Nama Parameter Jenis Data Wajib Deskripsi
jenis string Benar Jenis kode pembayaran.
nama string Benar Nama kode pembayaran.
unit string Benar Unit untuk kode bayar.
codeNumber bilangan bulat Benar Nomor kode yang ditetapkan ke kode pembayaran.

Untuk contoh cara mengonfigurasi tindakan CreatePayCode, lihat Contoh.

Tindakan DeletePayCodebyId

Menghapus kode pembayaran berdasarkan ID.

Parameter input tindakan DeletePayCodebyId

Nama Parameter Jenis Data Wajib Deskripsi
id bilangan bulat Benar ID kode pembayaran.

Untuk contoh cara mengonfigurasi tindakan DeletePayCodebyId, lihat Contoh.

Tindakan Perbarui Aturan Kerja menurut ID

Memperbarui aturan kerja menggunakan ID.

Parameter input tindakan Update Work Rule by ID

Nama Parameter Jenis Data Wajib Deskripsi
workRuleId bilangan bulat Benar ID aturan kerja
workRuleVersion json Benar Versi aturan kerja yang terkait dengan aturan kerja.
nama string Benar Nama aturan kerja.
versi bilangan bulat Benar Versi aturan kerja.

Untuk contoh cara mengonfigurasi tindakan Update Work Rule by ID, lihat Contoh.

Contoh tindakan

Contoh - RetrieveAllEmployeeGroupsOrByName

Contoh ini mengambil grup karyawan.

  1. Dalam dialog Configure connector task, klik actions.
  2. Pilih tindakan RetrieveAllEmployeeGroupsOrByName , lalu klik Selesai.
  3. Di bagian Pemetaan Data Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input:
     {
      "Query parameters": {
        "all_details": true
      }
    } 
    

    If the action is successful, the RetrieveAllEmployeeGroupsOrByName task's connectorOutputPayload response parameter will have a value similar to the following:

     
      [{
        "ResponseBody": "[{\"name\":\"$U-South Region\",\"id\":1401,\"orgMapGroupRef\":{\"id\":2452,\"qualifier\":\"$U-South Region\"},\"version\":0,\"updateDtm\":\"2020-03-04T16:06:46\",\"persistentId\":\"$U-South#Region\"},{\"name\":\"$U-Canada Region\",\"id\":1451,\"orgMapGroupRef\":{\"id\":2453,\"qualifier\":\"$U-Canada Region\"},\"version\":0,\"updateDtm\":\"2020-03-04T16:07:21\",\"persistentId\":\"}]
      

Contoh - Membuat PayCode

Contoh ini membuat kode pembayaran.

  1. Dalam dialog Configure connector task, klik actions.
  2. Pilih tindakan Create PayCode, lalu klik Selesai.
  3. Di bagian Pemetaan Data Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input:
      {
        "RequestBody": {
          "type": "Regular",
          "unit": "HOUR",
          "visibleToTimecardSchedule": true,
          "name": "2nd Meal Premium qaazxse",
          "shortName": "2MP",
          "combined": false,
          "money": false,
          "totals": true,
          "excusedAbsence": false,
          "wageMultiplier": 1.0,
          "wageAddition": 0.0,
          "addToTimecardTotal": true,
          "visibleToUser": true,
          "visibleToReports": true,
          "checkAvailability": 0.0,
          "codeNumber": 7663.0,
          "cascadingDuration": false,
          "processDurationAsSeparateShift": false,
          "editCountsTowardsOvertimeLimits": false,
          "editCountsTowardsConsecutiveDayOT": false,
          "repeating": false,
          "payrollOnly": false,
          "timekeepingOnly": false,
          "netDown": false
        },
        "Headers": {
          "Content-Type": "application/json"
        }
      }
      
      
      
  4. Jika tindakan berhasil, parameter respons connectorOutputPayload tugas CreatePayCode akan memiliki nilai yang mirip dengan berikut ini:

     
      [{
        "type": "Regular",
        "unit": "HOUR",
        "visibleToTimecardSchedule": true,
        "id": 5904.0,
        "name": "2nd Meal Premium qaazxse",
        "shortName": "2MP",
        "combined": false,
        "money": false,
        "totals": true,
        "excusedAbsence": false,
        "wageMultiplier": 1.0,
        "wageAddition": 0.0,
        "addToTimecardTotal": true,
        "visibleToUser": true,
        "visibleToReports": true,
        "checkAvailability": 0.0,
        "codeNumber": 7663.0,
        "cascadingDuration": false,
        "processDurationAsSeparateShift": false,
        "editCountsTowardsOvertimeLimits": false,
        "editCountsTowardsConsecutiveDayOT": false,
        "repeating": false,
        "payrollOnly": false,
        "timekeepingOnly": false,
        "netDown": false
      }]

Contoh - DeletePayCodebyId

Contoh ini menghapus kode pembayaran berdasarkan ID.

  1. Dalam dialog Configure connector task, klik actions.
  2. Pilih tindakan DeletePayCodebyId , lalu klik Selesai.
  3. Di bagian Pemetaan Data Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input:
      {
      "Path parameters": {
        "id": 6002.0
      }
    } 
  4. Jika tindakan berhasil, parameter respons connectorOutputPayload tugas DeletePayCodebyId akan memiliki nilai yang mirip dengan berikut ini:

     
     [{
      "ResponseBody": "",
      "StatusCode": 200.0
    }] 

Contoh - Perbarui Aturan Kerja menurut ID

Contoh ini memperbarui aturan kerja.

  1. Dalam dialog Configure connector task, klik actions.
  2. Pilih tindakan Update Work Rule by ID , lalu klik Selesai.
  3. Di bagian Pemetaan Data Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input:
     {
      "Path parameters": {
        "id": 3701.0
      },
      "Headers": {
        "Content-Type": "application/json"
      },
      "RequestBody": {
        "version": 1.0,
        "workRuleId": 3701.0,
        "name": "$AU Call Back Sasori",
        "workRuleVersion": [{
          "effectiveWorkRuleId": 3801.0,
          "effectiveDateTime": "1853-01-01T00:00:00",
          "updateThisVersion": true,
          "expirationDateTime": "4000-01-01T00:00:00",
          "general": {
            "breaks": [],
            "coreHours": [],
            "includeMinimumWagesAdjustment": false,
            "deductions": [{
              "id": 651.0,
              "qualifier": "$AU Oncall Allowance",
              "name": "$AU Oncall Allowance"
            }]
          },
          "workRulePayCodeDistribution": {
            "payCodeDistributionName": "$AU Oncall",
            "deviations": [],
            "overtimes": [],
            "zones": [],
            "majorities": []
          },
          "workRuleAutoBreakPlacement": {
            "minimumTimeBetweenStartOfShiftAndFirstBreak": "0:0",
            "minimumTimeBetweenEndOfBreakAndShiftEnd": "0:0",
            "minimumTimeBetweenBreaks": "0:0",
            "shiftLengthsToExclude": [],
            "newShiftLengths": []
          },
          "version": 1.0
        }],
        "ivrAlias": "1234567890"
      }
    }
  4. Jika tindakan berhasil, parameter respons connectorOutputPayload tugas Update Work Rule by ID akan memiliki nilai yang mirip dengan berikut ini:

     
     [{
      "workRuleId": 3701.0,
      "name": "$AU Call Back Sasori",
      "ivrAlias": "1234567890",
      "workRuleVersion": [{
        "effectiveWorkRuleId": 3801.0,
        "effectiveDateTime": "1753-01-01T00:00:00",
        "updateThisVersion": false,
        "expirationDateTime": "3000-01-01T00:00:00",
        "general": {
          "breaks": [],
          "coreHours": [],
          "includeMinimumWagesAdjustment": false,
          "deductions": [{
            "id": 651.0,
            "qualifier": "$AU Oncall Allowance",
            "name": "$AU Oncall Allowance"
          }]
        },
        "workRulePayCodeDistribution": {
          "payCodeDistributionName": "$AU Oncall",
          "deviations": [],
          "overtimes": [],
          "zones": [],
          "majorities": []
        },
        "workRuleAutoBreakPlacement": {
          "minimumTimeBetweenStartOfShiftAndFirstBreak": "0:0",
          "minimumTimeBetweenEndOfBreakAndShiftEnd": "0:0",
          "minimumTimeBetweenBreaks": "0:0",
          "shiftLengthsToExclude": [],
          "newShiftLengths": []
        },
        "version": 3.0
      }],
      "version": 3.0
    }]

Contoh - Hapus Aturan Tetap menurut ID

Contoh ini menghapus aturan tetap tertentu.

  1. Dalam dialog Configure connector task, klik actions.
  2. Pilih tindakan Delete Fixed Rule by ID , lalu klik Selesai.
  3. Di bagian Pemetaan Data Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input:
     {
      "Path parameters": {
        "id": 1152.0
      }
    } 
  4. Jika tindakan berhasil, parameter respons connectorOutputPayload tugas Delete Fixed Rule by ID akan memiliki nilai yang mirip dengan berikut ini:

     
     [{
      "ResponseBody": "",
      "StatusCode": 204.0
    }] 

Contoh - Mengambil Kode Akrual

Contoh ini mengambil kode akrual.

  1. Dalam dialog Configure connector task, klik actions.
  2. Pilih tindakan Retrieve Accrual Codes , lalu klik Selesai.
  3. Di bagian Pemetaan Data Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input:
     {
      "Query parameters": {
        "id": 1303.0
      }
    } 
  4. Jika tindakan berhasil, parameter respons connectorOutputPayload tugas Retrieve Accrual Codes akan memiliki nilai yang mirip dengan berikut ini:

     
     [{
      "ResponseBody": "[{\"id\":1303,\"typeId\":2,\"hoursPerDayInSeconds\":28800,\"name\":\"$LC Dia Familia\",\"shortName\":\"$LC Dia Familia\",\"typeName\":\"Day\",\"allowEdit\":true}]",
      "StatusCode": 200.0
    }]

Contoh - Membuat Jam Operasional

Contoh ini membuat jam operasional.

  1. Dalam dialog Configure connector task, klik actions.
  2. Pilih tindakan Create Hours of Operation , lalu klik Selesai.
  3. Di bagian Pemetaan Data Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input:
     {
      "Headers": {
        "Content-Type": "application/json"
      },
      "RequestBody": {
        "name": "$E-HoO Store 501 dummy3",
        "active": true,
        "effectiveVersions": [{
          "effectiveSpan": {
            "startDate": "1900-01-01",
            "endDate": "3000-01-01"
          },
          "unrestrictedEdit": true,
          "items": [{
            "openTime": "09:00:00",
            "closeTime": "21:00:00",
            "closed": false,
            "holiday": false,
            "weekDay": {
              "id": -1.0,
              "qualifier": "EVERY_DAY"
            }
          }, {
            "openTime": "10:00:00",
            "closeTime": "17:00:00",
            "closed": false,
            "holiday": false,
            "weekDay": {
              "id": 1.0,
              "qualifier": "SUNDAY"
            }
          }, {
            "openTime": "10:00:00",
            "closeTime": "18:00:00",
            "closed": false,
            "holiday": false,
            "weekDay": {
              "id": 7.0,
              "qualifier": "SATURDAY"
            }
          }]
        }]
      }
    }
  4. Jika tindakan berhasil, parameter respons connectorOutputPayload tugas Create Hours of Operation akan memiliki nilai yang mirip dengan berikut ini:

     
    [{
      "id": 851.0,
      "name": "$E-HoO Store 501 dummy3",
      "active": true,
      "version": 1.0,
      "effectiveVersions": [{
        "effectiveSpan": {
          "startDate": "1900-01-01",
          "endDate": "3000-01-01"
        },
        "unrestrictedEdit": true,
        "items": [{
          "id": 1051.0,
          "openTime": "09:00:00",
          "closeTime": "21:00:00",
          "closed": false,
          "holiday": false,
          "weekDay": {
            "id": -1.0,
            "qualifier": "EVERY_DAY"
          }
        }, {
          "id": 1052.0,
          "openTime": "10:00:00",
          "closeTime": "17:00:00",
          "closed": false,
          "holiday": false,
          "weekDay": {
            "id": 1.0,
            "qualifier": "SUNDAY"
          }
        }, {
          "id": 1053.0,
          "openTime": "10:00:00",
          "closeTime": "18:00:00",
          "closed": false,
          "holiday": false,
          "weekDay": {
            "id": 7.0,
            "qualifier": "SATURDAY"
          }
        }]
      }]
    }]

Contoh - Perbarui Setelan Kartu Absensi menurut ID

Contoh ini memperbarui setelan kartu waktu tertentu.

  1. Dalam dialog Configure connector task, klik actions.
  2. Pilih tindakan Update Timecard Setting by ID , lalu klik Selesai.
  3. Di bagian Pemetaan Data Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input:
     {
      "Path parameters": {
        "id": 3872335.0
      },
      "RequestBody": {
        "id": 3872335.0,
        "name": "Hourly Timecard -Employee Sharp",
        "label": "Hourly Timecard - Employee View",
        "description": "Hourly Timecard - Employee View",
        "timecardType": {
          "id": "HourlyEmployee",
          "name": "Hourly Employee"
        },
        "canEditFutureTimecard": false,
        "numberOfFutureDays": 0.0,
        "includeOvertimes": true,
        "fourPunchRow": false,
        "columnsOrder": [{
          "id": "Date",
          "name": "Date"
        }, {
          "id": "Schedule",
          "name": "Schedule"
        }, {
          "id": "Absence",
          "name": "Absence"
        }, {
          "id": "In",
          "name": "In"
        }, {
          "id": "Transfer",
          "name": "Transfer"
        }, {
          "id": "Out",
          "name": "Out"
        }, {
          "id": "PayCode",
          "name": "Pay Code"
        }, {
          "id": "Amount",
          "name": "Amount"
        }, {
          "id": "Shift",
          "name": "Shift"
        }, {
          "id": "Daily",
          "name": "Daily"
        }, {
          "id": "Period",
          "name": "Period"
        }],
        "includeActivityEvent": false,
        "includeActivityAllocation": false,
        "includeActivityTotalActual": false,
        "includeActivityTotalAllocated": false,
        "includeActivityTotalVariance": false,
        "hidePaidCorrection": false}
  4. Jika tindakan berhasil, parameter respons connectorOutputPayload tugas Update Timecard Setting by ID akan memiliki nilai yang mirip dengan berikut ini:

     
      [{
      "id": 3872335.0,
      "name": "Hourly Timecard -Employee Sharp",
      "label": "Hourly Timecard - Employee View",
      "description": "Hourly Timecard - Employee View",
      "timecardType": {
        "id": "HourlyEmployee",
        "name": "Hourly Employee"
      },
      "canEditFutureTimecard": false,
      "numberOfFutureDays": 0.0,
      "includeOvertimes": true,
      "fourPunchRow": false,
      "columnsOrder": [{
        "id": "Date",
        "name": "Date"
      }, {
        "id": "Schedule",
        "name": "Schedule"
      }, {
        "id": "Absence",
        "name": "Absence"
      }, {
        "id": "In",
        "name": "In"
      }, {
        "id": "Transfer",
        "name": "Transfer"
      }, {
        "id": "Out",
        "name": "Out"
      }, {
        "id": "PayCode",
        "name": "Pay Code"
      }, {
        "id": "Amount",
        "name": "Amount"
      }, {
        "id": "Shift",
        "name": "Shift"
      }, {
        "id": "Daily",
        "name": "Daily"
      }, {
        "id": "Period",
        "name": "Period"
      }],
      "includeActivityEvent": false,
      "includeActivityAllocation": false,
      "includeActivityTotalActual": false,
      "includeActivityTotalAllocated": false,
      "includeActivityTotalVariance": false,
      "hidePaidCorrection": false,
      "paidCorrectionFilterEnabled": true}] 

Contoh - Mengambil Profil Informasi Pengguna

Contoh ini mengambil profil informasi orang.

  1. Dalam dialog Configure connector task, klik actions.
  2. Pilih tindakan Retrieve People Information Profiles , lalu klik Selesai.
  3. Di bagian Pemetaan Data Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input:
      {
      "Headers": {
        "Content-Type": "application/json"
      },
      "RequestBody": {
        "where": {
          "ids": [-1.0, 651.0]
        }
      }
    }
  4. Jika tindakan berhasil, parameter respons connectorOutputPayload tugas Retrieve People Information Profiles akan memiliki nilai yang mirip dengan berikut ini:

     
       [{
      "ResponseBody": "[{\"id\":-1,\"description\":\"Default People Information Profile with Default People Information Settings\",\"name\":\"Default People Information Profile\",\"peopleInfoSetting\":{\"id\":-1,\"description\":\"Default People Information Profile with All Hyperfind Query\",\"hfquery\":{\"id\":1,\"hfName\":\"&Person.All_Home\",\"name\":\"All Home\"},\"name\":\"Default People Information Profile\"}},{\"id\":651,\"description\":\"All Home Employees\",\"name\":\"$R-All Home\",\"peopleInfoSetting\":{\"id\":649,\"description\":\"All Home Employees\",\"hfquery\":{\"id\":1,\"hfName\":\"&Person.All_Home\",\"name\":\"All Home\"},\"name\":\"$R-All Home\"}}]",
      "StatusCode": 200.0
    }]

Contoh - Mengambil Semua Persyaratan Ketenagakerjaan

Contoh ini mengambil semua persyaratan kerja.

  1. Dalam dialog Configure connector task, klik actions.
  2. Pilih tindakan Retrieve All Employment Terms , lalu klik Selesai.
  3. Di bagian Pemetaan Data Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input:
       {
      "Query parameters": {
        "id": 2202.0
      }
    } 
  4. Jika tindakan berhasil, parameter respons connectorOutputPayload tugas Retrieve All Employment Terms akan memiliki nilai yang mirip dengan berikut ini:

     
      [{
      "ResponseBody": "[{\"allowsInheritance\":false,\"isActive\":true,\"name\":\"$AU-Casual\",\"id\":2202,\"processType\":\"ENFORCE_END_DATE\",\"versions\":{\"employmentTermVersion\":[{\"id\":702,\"accrualProfile\":{\"id\":1402,\"qualifier\":\"$AU-Casual\",\"name\":\"$AU-Casual\"},\"endDate\":\"3000-01-01\",\"holidayProfile\":{\"id\":152,\"qualifier\":\"AU Casual Holiday Profile\",\"name\":\"AU Casual Holiday Profile\"},\"startDate\":\"1900-01-01\",\"minimumWage\":{}}]},\"persistentId\":\"$AU-Casual\"}]",
      "StatusCode": 200.0
    }]

Contoh - Membuat Profil Pengesahan

Contoh ini membuat profil pengesahan.

  1. Dalam dialog Configure connector task, klik actions.
  2. Pilih tindakan Create Attestation Profiles , lalu klik Selesai.
  3. Di bagian Pemetaan Data Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input:
     {
      "Headers": {
        "Content-Type": "application/json"
      },
      "RequestBody": {
        "versionCount": 0.0,
        "name": "Empty Profile 3",
        "deleted": false,
        "attestationAssignments": []
      }
    }
  4. Jika tindakan berhasil, parameter respons connectorOutputPayload tugas Create Attestation Profiles akan memiliki nilai yang mirip dengan berikut ini:

     
    [{
      "id": 434.0,
      "versionCount": 0.0,
      "name": "Empty Profile 3",
      "deleted": false
    }]

Contoh - Mengambil Profil Cuti berdasarkan ID

Contoh ini mengambil profil cuti berdasarkan ID.

  1. Dalam dialog Configure connector task, klik actions.
  2. Pilih tindakan Retrieve Leave Profile by Id , lalu klik Selesai.
  3. Di bagian Pemetaan Data Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input:
     {
      "Path parameters": {
        "id": 3.0
      }
    } 
  4. Jika tindakan berhasil, parameter respons connectorOutputPayload tugas Retrieve Leave Profile by Id akan memiliki nilai yang mirip dengan berikut ini:

     
     [{
      "id": 3.0,
      "isActive": true,
      "leaveProfileCategory": [{
        "id": 1.0,
        "qualifier": "Military",
        "leaveProfileCategoryConfigurableData": [{
          "configurableData": {
            "id": 1.0,
            "qualifier": "Active Duty Period"
          }
        }],
        "leaveProfileCategoryRule": [],
        "leaveProfileCategoryType": [{
          "leaveType": [{
            "id": 21.0,
            "qualifier": "Military Duty Leave Tracking"
          }]
        }, {
          "leaveType": [{
            "id": 53.0,
            "qualifier": "Personal Leave"
          }]
        }, {
          "leaveType": [{
            "id": 59.0,
            "qualifier": "Vacation Leave"
          }]
        }]
      }, {
        "id": 2.0,
        "qualifier": "Self",
        "leaveProfileCategoryConfigurableData": [{
          "configurableData": {
            "id": 2.0,
            "qualifier": "Amount Paid"
          }
        }, {
          "configurableData": {
            "id": 4.0,
            "qualifier": "Disability Case Number"
          }
    }]

Contoh - Mengambil Aturan yang Tersedia

Contoh ini mengambil aturan yang tersedia.

  1. Dalam dialog Configure connector task, klik actions.
  2. Pilih tindakan Retrieve Available Rules , lalu klik Selesai.
  3. Di bagian Pemetaan Data Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input:
     {
      "Query parameters": {
        "leave_case_id": 189.0
      }
    } 
  4. Jika tindakan berhasil, parameter respons connectorOutputPayload tugas Retrieve Available Rules akan memiliki nilai yang mirip dengan berikut ini:

     
     [{
      "leaveCase": {
        "id": 189.0,
        "qualifier": "Physical Therapy",
        "name": "Physical Therapy"
      },
      "availableLeaveRules": [{
        "id": 20.0,
        "availableLeaveTypes": [{
          "id": 1.0,
          "paid": false,
          "enabled": true,
          "payCode": {
            "id": 107.0,
            "qualifier": "LV-ADAA Leave",
            "name": "LV-ADAA Leave"
          },
          "accrualCode": {
            "id": 2.0,
            "qualifier": "LV-ADA Leave",
            "name": "LV-ADA Leave"
          },
          "qualifier": "ADA Leave",
          "name": "ADA Leave"
        }, {
          "id": 11.0,
          "paid": false,
          "enabled": true,
          "presentedInLeaveRule": true,
          "payCode": {
            "id": 134.0,
            "qualifier": "LV-FMLA Injury Illness",
            "name": "LV-FMLA Injury Illness"
          },
          "accrualCode": {
            "id": 12.0,
            "qualifier": "LV-FMLA",
            "name": "LV-FMLA"
          },
          "qualifier": "FMLA Illness Injury",
          "name": "FMLA Illness Injury"
        }, {
          "id": 31.0,
          "paid": false,
          "enabled": true,
          "presentedInLeaveRule": true,
          "payCode": {
            "id": 165.0,
            "qualifier": "LV-Non FMLA Tracking",
            "name": "LV-Non FMLA Tracking"
          },
          "accrualCode": {
            "id": 24.0,
            "qualifier": "LV-Tracking",
            "name": "LV-Tracking"
          },
          "qualifier": "Non-FMLA Illness Injury",
          "name": "Non-FMLA Illness Injury"
        }
    }]

Membuat koneksi menggunakan Terraform

Anda dapat menggunakan resource Terraform untuk membuat koneksi baru.

Untuk mempelajari cara menerapkan atau menghapus konfigurasi Terraform, lihat Perintah dasar Terraform.

Untuk melihat contoh template terraform untuk pembuatan koneksi, lihat contoh template.

Saat membuat koneksi ini menggunakan Terraform, Anda harus menetapkan variabel berikut dalam file konfigurasi Terraform:

Nama parameter Jenis data Wajib Deskripsi
proxy_enabled BOOLEAN Salah Centang kotak ini untuk mengonfigurasi server proxy untuk koneksi.
proxy_auth_scheme ENUM Salah Jenis autentikasi yang akan digunakan untuk melakukan autentikasi ke proxy ProxyServer. Nilai yang didukung adalah: BASIC, DIGEST, NONE
proxy_user STRING Salah Nama pengguna yang akan digunakan untuk melakukan autentikasi ke proxy ProxyServer.
proxy_password SECRET Salah Sandi yang akan digunakan untuk melakukan autentikasi ke proxy ProxyServer.

Menggunakan koneksi UKG dalam integrasi

Setelah Anda membuat koneksi, koneksi tersebut akan tersedia di Apigee Integration dan Application Integration. Anda dapat menggunakan koneksi dalam integrasi melalui tugas Konektor.

  • Untuk memahami cara membuat dan menggunakan tugas Konektor di Apigee Integration, lihat Tugas konektor.
  • Untuk memahami cara membuat dan menggunakan tugas Konektor di Integrasi Aplikasi, lihat Tugas konektor.

Mendapatkan bantuan dari komunitas Google Cloud

Anda dapat memposting pertanyaan dan mendiskusikan konektor ini di komunitas Google Cloud di Forum Cloud.

Langkah berikutnya