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 sudah 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 tidak memiliki akun layanan, Anda harus membuat akun layanan. Untuk 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

Untuk mengonfigurasi konektor, Anda harus membuat koneksi ke sumber data (sistem backend). Koneksi bersifat khusus untuk sumber data. Artinya, jika memiliki banyak sumber data, Anda harus membuat koneksi terpisah untuk setiap sumber data. Untuk membuat koneksi, lakukan langkah-langkah berikut:

  1. Di konsol Cloud, buka halaman Konektor Integrasi > Koneksi, lalu pilih atau buat project Google Cloud.

    Buka halaman Koneksi

  2. Klik + CREATE NEW untuk membuka halaman Create Connection.
  3. Di bagian Location, pilih lokasi untuk koneksi.
    1. Region: Pilih lokasi dari menu drop-down.

      Untuk mengetahui daftar semua region yang didukung, lihat Lokasi.

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

      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 Description untuk instance koneksi.
    5. Secara opsional, aktifkan Cloud Logging, lalu pilih level log. Secara default, level log ditetapkan ke Error.
    6. Service Account: Pilih akun layanan yang memiliki peran yang diperlukan.
    7. Layanan/Modul: Pilih modul UKG.
    8. Secara opsional, konfigurasikan Setelan node koneksi:

      • Jumlah node minimum: Masukkan jumlah minimum node koneksi.
      • Maximum number of nodes: Masukkan jumlah maksimum node koneksi.

      Node adalah unit (atau replika) koneksi yang memproses transaksi. Semakin banyak node yang diperlukan untuk memproses lebih banyak transaksi untuk koneksi, dan sebaliknya, semakin sedikit node yang diperlukan untuk memproses lebih sedikit transaksi. 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.
      • Pilih Host address dari daftar untuk menentukan nama host atau alamat IP tujuan.
      • Jika Anda ingin membuat koneksi pribadi ke sistem backend, pilih Endpoint attachment dari daftar, lalu pilih lampiran endpoint yang diperlukan dari daftar Endpoint Attachment.

      Jika ingin membuat koneksi publik ke sistem backend dengan keamanan tambahan, Anda dapat mempertimbangkan untuk mengonfigurasi alamat IP keluar statis untuk koneksi, 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 Create.

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 yang 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 untuk 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 Verbositas 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 memperlambat transaksi apa pun di luar batas ini. Secara default, Konektor Integrasi mengalokasikan 2 node (untuk ketersediaan yang lebih baik) untuk koneksi.

Untuk mengetahui informasi tentang batas yang berlaku untuk Konektor Integrasi, 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 berdasarkan nama.

Parameter input tindakan RetrieveAllEmployeeGroupsOrByName

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

Misalnya, 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 pembayaran.
codeNumber bilangan bulat Benar Nomor kode yang ditetapkan ke kode pembayaran.

Misalnya, 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.

Misalnya, cara mengonfigurasi tindakan DeletePayCodebyId, lihat Contoh.

Memperbarui Aturan Kerja berdasarkan tindakan 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.

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

Contoh tindakan

Contoh - RetrieveAllEmployeeGroupsOrByName

Contoh ini mengambil grup karyawan.

  1. Pada 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. Pada 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:

     
  [{
    "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. Pada 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:

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

Contoh - Memperbarui Aturan Kerja menurut ID

Contoh ini memperbarui aturan kerja.

  1. Pada 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:

     
 [{
  "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 - Menghapus Aturan Tetap menurut ID

Contoh ini menghapus aturan tetap tertentu.

  1. Pada 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:

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

Contoh - Mengambil Kode Akrual

Contoh ini mengambil kode akurasi.

  1. Pada 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:

     
 [{
  "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 buka.

  1. Pada 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:

     
[{
  "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 - Memperbarui Setelan Kartu Waktu berdasarkan ID

Contoh ini memperbarui setelan kartu waktu tertentu.

  1. Pada 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:

     
  [{
  "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 Orang

Contoh ini mengambil profil informasi orang.

  1. Pada 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:

     
   [{
  "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. Pada 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:

     
  [{
  "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. Pada 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:

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

Contoh - Mengambil Profil Izin berdasarkan ID

Contoh ini mengambil profil cuti berdasarkan ID.

  1. Pada 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:

     
 [{
  "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. Pada 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:

     
 [{
  "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"
    }
}]

Menggunakan terraform untuk membuat koneksi

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 mengautentikasi ke proxy ProxyServer. Nilai yang didukung adalah: BASIC, DIGEST, NONE
proxy_user STRING Salah Nama pengguna yang akan digunakan untuk mengautentikasi 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 Integration Apigee dan Integration Aplikasi. 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 Cloud Forums.

Langkah selanjutnya