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:

  1. Nella console Cloud, vai alla pagina Integration Connectors > Connessioni e poi seleziona o crea un progetto Google Cloud.

    Vai alla pagina Connessioni

  2. Fai clic su + CREA NUOVA per aprire la pagina Crea connessione.
  3. Nella sezione Località, scegli la località per la connessione.
    1. Regione: seleziona una località dall'elenco a discesa.

      Per l'elenco di tutte le regioni supportate, consulta Località.

    2. Fai clic su AVANTI.
  4. Nella sezione Dettagli connessione, completa quanto segue:
    1. Connettore: seleziona UKG dall'elenco a discesa dei connettori disponibili.
    2. Versione del connettore: seleziona la versione del connettore dall'elenco a discesa delle versioni disponibili.
    3. 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.
    4. (Facoltativo) Inserisci una Descrizione per l'istanza di connessione.
    5. (Facoltativo) Abilita Cloud Logging, quindi seleziona un livello di log. Per impostazione predefinita, il livello di log è impostato su Error.
    6. Service Account: seleziona un account di servizio con i ruoli richiesti.
    7. Servizio/Modulo: seleziona il modulo UKG.
    8. (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.

    9. (Facoltativo) Fai clic su + AGGIUNGI ETICHETTA per aggiungere un'etichetta alla connessione sotto forma di coppia chiave/valore.
    10. Fai clic su AVANTI.
  5. Nella sezione Destinazioni, inserisci i dettagli dell'host remoto (sistema di backend) a cui vuoi connetterti.
    1. 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.

    2. Fai clic su AVANTI.
  6. Nella sezione Autenticazione, inserisci i dettagli di autenticazione.
    1. 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
      • Per capire come configurare questi tipi di autenticazione, consulta Configurare l'autenticazione.

      • Fai clic su AVANTI.
  7. Rivedi: rivedi i dettagli di connessione e autenticazione.
  8. 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
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.

  1. Nella finestra di dialogo Configure connector task, fai clic su actions.
  2. Seleziona l'azione RetrieveAllEmployeeGroupsOrByName , quindi fai clic su Fine.
  3. Nella sezione Mappatura dei dati Open Data Mapping Editor e poi inserisci un valore simile al seguente nel campo 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\":\"}]
      

Esempio: crea PayCode

Questo esempio crea un codice paga.

  1. Nella finestra di dialogo Configure connector task, fai clic su actions.
  2. Seleziona l'azione Create PayCode, quindi fai clic su Fine.
  3. Nella sezione Mappatura dei dati Open Data Mapping Editor e poi inserisci un valore simile al seguente nel campo 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. 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.

  1. Nella finestra di dialogo Configure connector task, fai clic su actions.
  2. Seleziona l'azione DeletePayCodebyId , quindi fai clic su Fine.
  3. Nella sezione Mappatura dei dati Open Data Mapping Editor e poi inserisci un valore simile al seguente nel campo Input:
      {
      "Path parameters": {
        "id": 6002.0
      }
    } 
  4. 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.

  1. Nella finestra di dialogo Configure connector task, fai clic su actions.
  2. Seleziona l'azione Update Work Rule by ID , quindi fai clic su Fine.
  3. Nella sezione Mappatura dei dati Open Data Mapping Editor e poi inserisci un valore simile al seguente nel campo 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. 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.

  1. Nella finestra di dialogo Configure connector task, fai clic su actions.
  2. Seleziona l'azione Delete Fixed Rule by ID , quindi fai clic su Fine.
  3. Nella sezione Mappatura dei dati Open Data Mapping Editor e poi inserisci un valore simile al seguente nel campo Input:
     {
      "Path parameters": {
        "id": 1152.0
      }
    } 
  4. 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.

  1. Nella finestra di dialogo Configure connector task, fai clic su actions.
  2. Seleziona l'azione Retrieve Accrual Codes , quindi fai clic su Fine.
  3. Nella sezione Mappatura dei dati Open Data Mapping Editor e poi inserisci un valore simile al seguente nel campo Input:
     {
      "Query parameters": {
        "id": 1303.0
      }
    } 
  4. 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.

  1. Nella finestra di dialogo Configure connector task, fai clic su actions.
  2. Seleziona l'azione Create Hours of Operation , quindi fai clic su Fine.
  3. Nella sezione Mappatura dei dati Open Data Mapping Editor e poi inserisci un valore simile al seguente nel campo 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. 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à.

  1. Nella finestra di dialogo Configure connector task, fai clic su actions.
  2. Seleziona l'azione Update Timecard Setting by ID , quindi fai clic su Fine.
  3. Nella sezione Mappatura dei dati Open Data Mapping Editor e poi inserisci un valore simile al seguente nel campo 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. 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.

  1. Nella finestra di dialogo Configure connector task, fai clic su actions.
  2. Seleziona l'azione Retrieve People Information Profiles , quindi fai clic su Fine.
  3. Nella sezione Mappatura dei dati Open Data Mapping Editor e poi inserisci un valore simile al seguente nel campo Input:
      {
      "Headers": {
        "Content-Type": "application/json"
      },
      "RequestBody": {
        "where": {
          "ids": [-1.0, 651.0]
        }
      }
    }
  4. 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.

  1. Nella finestra di dialogo Configure connector task, fai clic su actions.
  2. Seleziona l'azione Retrieve All Employment Terms , quindi fai clic su Fine.
  3. Nella sezione Mappatura dei dati Open Data Mapping Editor e poi inserisci un valore simile al seguente nel campo Input:
       {
      "Query parameters": {
        "id": 2202.0
      }
    } 
  4. 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.

  1. Nella finestra di dialogo Configure connector task, fai clic su actions.
  2. Seleziona l'azione Create Attestation Profiles , quindi fai clic su Fine.
  3. Nella sezione Mappatura dei dati Open Data Mapping Editor e poi inserisci un valore simile al seguente nel campo Input:
     {
      "Headers": {
        "Content-Type": "application/json"
      },
      "RequestBody": {
        "versionCount": 0.0,
        "name": "Empty Profile 3",
        "deleted": false,
        "attestationAssignments": []
      }
    }
  4. 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.

  1. Nella finestra di dialogo Configure connector task, fai clic su actions.
  2. Seleziona l'azione Retrieve Leave Profile by Id , quindi fai clic su Fine.
  3. Nella sezione Mappatura dei dati Open Data Mapping Editor e poi inserisci un valore simile al seguente nel campo Input:
     {
      "Path parameters": {
        "id": 3.0
      }
    } 
  4. 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.

  1. Nella finestra di dialogo Configure connector task, fai clic su actions.
  2. Seleziona l'azione Retrieve Available Rules , quindi fai clic su Fine.
  3. Nella sezione Mappatura dei dati Open Data Mapping Editor e poi inserisci un valore simile al seguente nel campo Input:
     {
      "Query parameters": {
        "leave_case_id": 189.0
      }
    } 
  4. 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