UKG
Il connettore UKG consente di eseguire varie azioni sui dati UKG.
Prima di iniziare
Prima di utilizzare il connettore UKG, esegui le seguenti operazioni:
- Nel tuo progetto Google Cloud:
- Assicurati che la connettività di rete sia configurata. Per informazioni sui pattern di rete, consulta Connettività di rete.
- Concedi il ruolo IAM roles/connectors.admin all'utente che configura il connettore.
- Concedi i seguenti ruoli IAM al account di servizio che vuoi utilizzare per il connettore:
roles/secretmanager.viewer
roles/secretmanager.secretAccessor
Un account di servizio è un tipo speciale di Account Google destinato a rappresentare un utente non umano che deve eseguire l'autenticazione ed essere autorizzato ad accedere ai dati nelle API di Google. Se non hai un account di servizio, devi crearne uno. Per maggiori informazioni, vedi Creare un service account.
- Attiva i seguenti servizi:
secretmanager.googleapis.com
(API Secret Manager)connectors.googleapis.com
(API Connectors)
Per capire come abilitare i servizi, consulta Abilitazione dei servizi.
Se questi servizi o queste autorizzazioni non sono stati attivati in precedenza per il tuo progetto, ti viene chiesto di attivarli durante la configurazione del connettore.
Configura il connettore
Una connessione è specifica per un'origine dati. Ciò significa che se hai molte origini dati, devi creare una connessione separata per ciascuna origine dati. Per creare una connessione:
- Nella console Cloud, vai alla pagina Integration Connectors > Connessioni e poi seleziona o crea un progetto Google Cloud.
- Fai clic su + CREA NUOVA per aprire la pagina Crea connessione.
- Nella sezione Località, scegli la località per la connessione.
- Regione: seleziona una località dall'elenco a discesa.
Per l'elenco di tutte le regioni supportate, consulta Località.
- Fai clic su AVANTI.
- Regione: seleziona una località dall'elenco a discesa.
- Nella sezione Dettagli connessione, completa quanto segue:
- Connettore: seleziona UKG dall'elenco a discesa dei connettori disponibili.
- Versione del connettore: seleziona la versione del connettore dall'elenco a discesa delle versioni disponibili.
- Nel campo Nome connessione, inserisci un nome per l'istanza di connessione.
I nomi delle connessioni devono soddisfare i seguenti criteri:
- I nomi delle connessioni possono contenere lettere, numeri o trattini.
- Le lettere devono essere minuscole.
- I nomi delle connessioni devono iniziare con una lettera e terminare con una lettera o un numero.
- I nomi delle connessioni non possono contenere più di 49 caratteri.
- (Facoltativo) Inserisci una Descrizione per l'istanza di connessione.
- (Facoltativo) Abilita Cloud Logging,
quindi seleziona un livello di log. Per impostazione predefinita, il livello di log è impostato su
Error
. - Service Account: seleziona un account di servizio con i ruoli richiesti.
- Servizio/Modulo: seleziona il modulo UKG.
- (Facoltativo) Configura le impostazioni del nodo di connessione:
- Numero minimo di nodi: inserisci il numero minimo di nodi di connessione.
- Numero massimo di nodi: inserisci il numero massimo di nodi di connessione.
Un nodo è un'unità (o una replica) di una connessione che elabora le transazioni. Sono necessari più nodi per elaborare più transazioni per una connessione e, viceversa, sono necessari meno nodi per elaborare meno transazioni. Per capire in che modo i nodi influiscono sui prezzi dei connettori, consulta la sezione Prezzi dei nodi di connessione. Se non inserisci alcun valore, per impostazione predefinita i nodi minimi sono impostati su 2 (per una migliore disponibilità) e i nodi massimi su 50.
- (Facoltativo) Fai clic su + AGGIUNGI ETICHETTA per aggiungere un'etichetta alla connessione sotto forma di coppia chiave/valore.
- Fai clic su AVANTI.
- Nella sezione Destinazioni, inserisci i dettagli dell'host remoto (sistema di backend) a cui vuoi connetterti.
- Tipo di destinazione: seleziona un Tipo di destinazione.
- Per specificare il nome host o l'indirizzo IP di destinazione, seleziona Indirizzo host e inserisci l'indirizzo nel campo Host 1.
- Per stabilire una connessione privata, seleziona Collegamento endpoint e scegli il collegamento richiesto dall'elenco Collegamento endpoint.
Se vuoi stabilire una connessione pubblica ai tuoi sistemi di backend con maggiore sicurezza, puoi valutare la possibilità di configurare indirizzi IP statici in uscita per le tue connessioni e poi configurare le regole del firewall in modo da consentire solo gli indirizzi IP statici specifici.
Per inserire altre destinazioni, fai clic su +AGGIUNGI DESTINAZIONE.
- Fai clic su AVANTI.
- Tipo di destinazione: seleziona un Tipo di destinazione.
-
Nella sezione Autenticazione, inserisci i dettagli di autenticazione.
- Seleziona un Tipo di autenticazione e inserisci i dettagli pertinenti.
La connessione UKG supporta i seguenti tipi di autenticazione:
- Autenticazione di base
- OAUTH 2.0 - Authorization code
- Fai clic su AVANTI.
Per capire come configurare questi tipi di autenticazione, consulta Configurare l'autenticazione.
- Seleziona un Tipo di autenticazione e inserisci i dettagli pertinenti.
- Rivedi: rivedi i dettagli di connessione e autenticazione.
- Fai clic su Crea.
Configura l'autenticazione
Inserisci i dettagli in base all'autenticazione che vuoi utilizzare.
- Autenticazione di base
- Nome utente: il nome utente utilizzato per autenticare il connettore.
- Password: il secret di Secret Manager contenente la password associata al connettore.
OAUTH 2.0 - Authorization code
- ID client: l'ID client utilizzato per richiedere i token di accesso.
- Ambiti:un elenco separato da virgole degli ambiti desiderati.
- Client secret: secret di Secret Manager contenente il client secret per l'app connessa che hai creato.
- Attiva PKCE: seleziona questa opzione se vuoi attivare Proof Key of Code Exchange (PKCE).
- URL di autorizzazione: l'URL di autorizzazione per la tua app. Verrà visualizzata questa pagina per accedere all'app.
- URL token di accesso: l'URL da utilizzare per scambiare il token di accesso. Fornisci l'URL completo, incluso lo schema.
Esempi di configurazione della connessione
Questa sezione elenca i valori di esempio per i vari campi che configuri durante la creazione della connessione.
OAUTH 2.0 - Tipo di connessione con codice di autorizzazione
Nome campo | Dettagli |
---|---|
Località | us-central1 |
Connettore | UKG |
Versione del connettore | 1 |
Nome collegamento | gcp-ukg-oauth-conn |
Abilita Cloud Logging | Sì |
Livello di log | Errore |
Service account | SERVICEACCOUNT_NAME@developer.gserviceaccount.com |
Modulo delle specifiche API | Funzioni correlate al tempo |
Livello di verbosità | 5 |
Numero minimo di nodi | 2 |
Numero massimo di nodi | 50 |
Tipo di destinazione | Indirizzo host |
Indirizzo host | https://google-connect-dev.cfn.mykronos.com |
ID client | ZG******-****-****-****-*********uDN |
Client secret | Secret |
Versione secret | 1 |
URL di autorizzazione | https://google-connect-dev.cfn.mykronos.com/oauth2/authorize |
URL del token di accesso | https://google-connect-dev.cfn.mykronos.com/api/authentication/access_token |
Limitazioni di sistema
Il connettore UKG può elaborare 30 transazioni al secondo, per nodo, e limita le transazioni oltre questo limite. Per impostazione predefinita, Integration Connectors alloca due nodi (per una migliore disponibilità) per una connessione.
Per informazioni sui limiti applicabili a Integration Connectors, vedi Limiti.
di correzione
Questo connettore ti consente di eseguire varie azioni sui dati UKG.
Questa sezione elenca le azioni supportate dal connettore UKG. Per capire come configurare le azioni, consulta Esempi di azioni.
Azione RetrieveAllEmployeeGroupsOrByName
Recupera tutti i gruppi di dipendenti per nome.
Parametri di input dell'azione RetrieveAllEmployeeGroupsOrByName
Nome parametro | Tipo di dati | Obbligatorio | Descrizione |
---|---|---|---|
all_details | boolean | Vero | Un valore booleano che indica se la risposta è leggera, ovvero una risposta contenente solo i campi ID e nome. |
nome | string | Vero | Il nome di un gruppo di dipendenti. |
Per un esempio di come configurare l'azione RetrieveAllEmployeeGroupsOrByName
,
consulta Esempi.
Crea azione PayCode
Crea un codice paga.
Parametri di input dell'azione Crea PayCode
Nome parametro | Tipo di dati | Obbligatorio | Descrizione |
---|---|---|---|
tipo | string | Vero | Il tipo di codice paga. |
nome | string | Vero | Il nome del codice paga. |
unità | string | Vero | L'unità per il codice paga. |
codeNumber | integer | Vero | Il codice numerico assegnato a un codice paga. |
Per un esempio di come configurare l'azione CreatePayCode
,
vedi Esempi.
Azione DeletePayCodebyId
Elimina un paycode in base all'ID.
Parametri di input dell'azione DeletePayCodebyId
Nome parametro | Tipo di dati | Obbligatorio | Descrizione |
---|---|---|---|
ID | integer | Vero | L'ID di un codice di pagamento. |
Per un esempio di come configurare l'azione DeletePayCodebyId
,
vedi Esempi.
Aggiorna l'azione della regola di lavoro per ID
Aggiorna la regola di lavoro utilizzando l'ID.
Parametri di input dell'azione Aggiorna regola di lavoro per ID
Nome parametro | Tipo di dati | Obbligatorio | Descrizione |
---|---|---|---|
workRuleId | integer | Vero | ID della regola di lavoro |
workRuleVersion | json | Vero | La versione della regola di lavoro associata a una regola di lavoro. |
nome | string | Vero | Il nome di una regola di lavoro. |
versione | integer | Vero | Versione della regola di lavoro. |
Per un esempio di come configurare l'azione Update Work Rule by ID
,
vedi Esempi.
Esempi di azioni
Esempio: RetrieveAllEmployeeGroupsOrByName
Questo esempio recupera i gruppi di dipendenti.
- Nella finestra di dialogo
Configure connector task
, fai clic suactions
. - Seleziona l'azione
RetrieveAllEmployeeGroupsOrByName
, quindi fai clic su Fine. - Nella sezione Mappatura dei dati
Open Data Mapping Editor
e poi inserisci un valore simile al seguente nel campoInput
:{ "Query parameters": { "all_details": true } }
If the action is successful, the
RetrieveAllEmployeeGroupsOrByName
task'sconnectorOutputPayload
response parameter will have a value similar to the following:
Esempio: crea PayCode
Questo esempio crea un codice paga.
- Nella finestra di dialogo
Configure connector task
, fai clic suactions
. - Seleziona l'azione
Create PayCode
, quindi fai clic su Fine. - Nella sezione Mappatura dei dati
Open Data Mapping Editor
e poi inserisci un valore simile al seguente nel campoInput
:{ "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" } }
Se l'azione ha esito positivo, il parametro
CreatePayCode
della risposta connectorOutputPayload
dell'attività avrà un valore simile al seguente:
[{ "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 }]
Esempio - DeletePayCodebyId
Questo esempio elimina un codice paga in base all'ID.
- Nella finestra di dialogo
Configure connector task
, fai clic suactions
. - Seleziona l'azione
DeletePayCodebyId
, quindi fai clic su Fine. - Nella sezione Mappatura dei dati
Open Data Mapping Editor
e poi inserisci un valore simile al seguente nel campoInput
:{ "Path parameters": { "id": 6002.0 } }
Se l'azione ha esito positivo, il parametro
DeletePayCodebyId
della risposta connectorOutputPayload
dell'attività avrà un valore simile al seguente:
[{ "ResponseBody": "", "StatusCode": 200.0 }]
Esempio: aggiorna la regola di lavoro per ID
Questo esempio aggiorna la regola di lavoro.
- Nella finestra di dialogo
Configure connector task
, fai clic suactions
. - Seleziona l'azione
Update Work Rule by ID
, quindi fai clic su Fine. - Nella sezione Mappatura dei dati
Open Data Mapping Editor
e poi inserisci un valore simile al seguente nel campoInput
:{ "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" } }
Se l'azione ha esito positivo, il parametro
Update Work Rule by ID
della risposta connectorOutputPayload
dell'attività avrà un valore simile al seguente:
[{ "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 }]
Esempio: elimina regola fissa per ID
Questo esempio elimina una regola fissa specifica.
- Nella finestra di dialogo
Configure connector task
, fai clic suactions
. - Seleziona l'azione
Delete Fixed Rule by ID
, quindi fai clic su Fine. - Nella sezione Mappatura dei dati
Open Data Mapping Editor
e poi inserisci un valore simile al seguente nel campoInput
:{ "Path parameters": { "id": 1152.0 } }
Se l'azione ha esito positivo, il parametro di risposta connectorOutputPayload
dell'attività Delete Fixed Rule by ID
avrà un valore simile al seguente:
[{ "ResponseBody": "", "StatusCode": 204.0 }]
Esempio: recuperare i codici di maturazione
Questo esempio recupera i codici di maturazione.
- Nella finestra di dialogo
Configure connector task
, fai clic suactions
. - Seleziona l'azione
Retrieve Accrual Codes
, quindi fai clic su Fine. - Nella sezione Mappatura dei dati
Open Data Mapping Editor
e poi inserisci un valore simile al seguente nel campoInput
:{ "Query parameters": { "id": 1303.0 } }
Se l'azione ha esito positivo, il parametro
Retrieve Accrual Codes
della risposta connectorOutputPayload
dell'attività avrà un valore simile al seguente:
[{ "ResponseBody": "[{\"id\":1303,\"typeId\":2,\"hoursPerDayInSeconds\":28800,\"name\":\"$LC Dia Familia\",\"shortName\":\"$LC Dia Familia\",\"typeName\":\"Day\",\"allowEdit\":true}]", "StatusCode": 200.0 }]
Esempio: creare l'orario di apertura
Questo esempio crea l'orario di apertura.
- Nella finestra di dialogo
Configure connector task
, fai clic suactions
. - Seleziona l'azione
Create Hours of Operation
, quindi fai clic su Fine. - Nella sezione Mappatura dei dati
Open Data Mapping Editor
e poi inserisci un valore simile al seguente nel campoInput
:{ "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" } }] }] } }
Se l'azione ha esito positivo, il parametro
Create Hours of Operation
della risposta connectorOutputPayload
dell'attività avrà un valore simile al seguente:
[{ "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" } }] }] }]
Esempio: aggiornamento dell'impostazione della scheda attività per ID
Questo esempio aggiorna l'impostazione specifica della scheda attività.
- Nella finestra di dialogo
Configure connector task
, fai clic suactions
. - Seleziona l'azione
Update Timecard Setting by ID
, quindi fai clic su Fine. - Nella sezione Mappatura dei dati
Open Data Mapping Editor
e poi inserisci un valore simile al seguente nel campoInput
:{ "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}
Se l'azione ha esito positivo, il parametro
Update Timecard Setting by ID
della risposta connectorOutputPayload
dell'attività avrà un valore simile al seguente:
[{ "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}]
Esempio: recuperare i profili delle informazioni sulle persone
Questo esempio recupera i profili delle informazioni sulle persone.
- Nella finestra di dialogo
Configure connector task
, fai clic suactions
. - Seleziona l'azione
Retrieve People Information Profiles
, quindi fai clic su Fine. - Nella sezione Mappatura dei dati
Open Data Mapping Editor
e poi inserisci un valore simile al seguente nel campoInput
:{ "Headers": { "Content-Type": "application/json" }, "RequestBody": { "where": { "ids": [-1.0, 651.0] } } }
Se l'azione ha esito positivo, il parametro
Retrieve People Information Profiles
della risposta connectorOutputPayload
dell'attività avrà un valore simile al seguente:
[{ "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 }]
Esempio: recuperare tutti i termini di impiego
Questo esempio recupera tutti i termini di impiego.
- Nella finestra di dialogo
Configure connector task
, fai clic suactions
. - Seleziona l'azione
Retrieve All Employment Terms
, quindi fai clic su Fine. - Nella sezione Mappatura dei dati
Open Data Mapping Editor
e poi inserisci un valore simile al seguente nel campoInput
:{ "Query parameters": { "id": 2202.0 } }
Se l'azione ha esito positivo, il parametro
Retrieve All Employment Terms
della risposta connectorOutputPayload
dell'attività avrà un valore simile al seguente:
[{ "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 }]
Esempio: creare profili di attestazione
Questo esempio crea i profili di attestazione.
- Nella finestra di dialogo
Configure connector task
, fai clic suactions
. - Seleziona l'azione
Create Attestation Profiles
, quindi fai clic su Fine. - Nella sezione Mappatura dei dati
Open Data Mapping Editor
e poi inserisci un valore simile al seguente nel campoInput
:{ "Headers": { "Content-Type": "application/json" }, "RequestBody": { "versionCount": 0.0, "name": "Empty Profile 3", "deleted": false, "attestationAssignments": [] } }
Se l'azione ha esito positivo, il parametro
Create Attestation Profiles
della risposta connectorOutputPayload
dell'attività avrà un valore simile al seguente:
[{ "id": 434.0, "versionCount": 0.0, "name": "Empty Profile 3", "deleted": false }]
Esempio: recupera il profilo ferie per ID
Questo esempio recupera un profilo di assenza in base all'ID.
- Nella finestra di dialogo
Configure connector task
, fai clic suactions
. - Seleziona l'azione
Retrieve Leave Profile by Id
, quindi fai clic su Fine. - Nella sezione Mappatura dei dati
Open Data Mapping Editor
e poi inserisci un valore simile al seguente nel campoInput
:{ "Path parameters": { "id": 3.0 } }
Se l'azione ha esito positivo, il parametro
Retrieve Leave Profile by Id
della risposta connectorOutputPayload
dell'attività avrà un valore simile al seguente:
[{ "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" } }]
Esempio: recupera le regole disponibili
Questo esempio recupera le regole disponibili.
- Nella finestra di dialogo
Configure connector task
, fai clic suactions
. - Seleziona l'azione
Retrieve Available Rules
, quindi fai clic su Fine. - Nella sezione Mappatura dei dati
Open Data Mapping Editor
e poi inserisci un valore simile al seguente nel campoInput
:{ "Query parameters": { "leave_case_id": 189.0 } }
Se l'azione ha esito positivo, il parametro
Retrieve Available Rules
della risposta connectorOutputPayload
dell'attività avrà un valore simile al seguente:
[{ "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" } }]
Creare connessioni utilizzando Terraform
Puoi utilizzare la risorsa Terraform per creare una nuova connessione.
Per scoprire come applicare o rimuovere una configurazione Terraform, consulta Comandi Terraform di base.
Per visualizzare un modello Terraform di esempio per la creazione della connessione, consulta Modello di esempio.
Quando crei questa connessione utilizzando Terraform, devi impostare le seguenti variabili nel file di configurazione Terraform:
Nome parametro | Tipo di dati | Obbligatorio | Descrizione |
---|---|---|---|
proxy_enabled | BOOLEANO | Falso | Seleziona questa casella di controllo per configurare un server proxy per la connessione. |
proxy_auth_scheme | ENUM | Falso | Il tipo di autenticazione da utilizzare per l'autenticazione al proxy ProxyServer. I valori supportati sono: BASIC, DIGEST, NONE |
proxy_user | STRING | Falso | Un nome utente da utilizzare per l'autenticazione al proxy ProxyServer. |
proxy_password | SECRET | Falso | Una password da utilizzare per l'autenticazione al proxy ProxyServer. |
Utilizzare la connessione UKG in un'integrazione
Una volta creata la connessione, questa diventa disponibile sia in Apigee Integration che in Application Integration. Puoi utilizzare la connessione in un'integrazione tramite l'attività Connettori.
- Per capire come creare e utilizzare l'attività Connettori in Apigee Integration, consulta Attività Connettori.
- Per capire come creare e utilizzare l'attività Connettori in Application Integration, consulta Attività Connettori.
Ricevere assistenza dalla community Google Cloud
Puoi pubblicare le tue domande e discutere di questo connettore nella community di Google Cloud nei forum di Cloud.Passaggi successivi
- Scopri come sospendere e ripristinare una connessione.
- Scopri come monitorare l'utilizzo dei connettori.
- Scopri come visualizzare i log dei connettori.