UKG
El conector de UKG te permite realizar varias acciones en los datos de UKG.
Antes de comenzar
Antes de usar el conector de UKG, realiza las siguientes tareas:
- En tu proyecto de Google Cloud, haz lo siguiente:
- Asegúrate de que la conectividad de red esté configurada. Para obtener información sobre los patrones de red, consulta Conectividad de red.
- Otorga el rol de IAM roles/connectors.admin al usuario que configura el conector.
- Otorga los siguientes roles de IAM a la cuenta de servicio que deseas usar para el conector:
roles/secretmanager.viewer
roles/secretmanager.secretAccessor
Una cuenta de servicio es un tipo de Cuenta de Google especial que representa a un usuario no humano que debe autenticarse y tener autorización para acceder a los datos de las APIs de Google. Si no tienes una cuenta de servicio, debes crear una. Para obtener más información, consulta Crea una cuenta de servicio.
- Habilita los siguientes servicios:
secretmanager.googleapis.com
(API de Secret Manager)connectors.googleapis.com
(API de conectores)
Para comprender cómo habilitar servicios, consulta Habilita servicios.
Si estos servicios o permisos no se habilitaron antes para tu proyecto, se te solicitará que los habilites cuando configures el conector.
Configura el conector
Una conexión es específica de una fuente de datos. Significa que, si tienes muchas fuentes de datos, debes crear una conexión independiente para cada fuente. Para crear una conexión, haz lo siguiente:
- En la consola de Cloud, ve a la página Conectores de Integration > Conexiones y, luego, selecciona o crea un proyecto de Google Cloud.
- Haz clic en + CREAR NUEVO para abrir la página Crear conexión.
- En la sección Ubicación, elige la ubicación para la conexión.
- Región: selecciona una ubicación de la lista desplegable.
Para obtener la lista de todas las regiones compatibles, consulta Ubicaciones.
- Haz clic en SIGUIENTE.
- Región: selecciona una ubicación de la lista desplegable.
- En la sección Detalles de la conexión, completa lo siguiente:
- Conector: Selecciona UKG en la lista desplegable de conectores disponibles.
- Versión del conector: selecciona la versión del conector de la lista desplegable de versiones disponibles.
- En el campo Nombre de la conexión, ingresa un nombre para la instancia de conexión.
Los nombres de las conexiones deben cumplir con los siguientes criterios:
- Los nombres de las conexiones pueden usar letras, números o guiones.
- Las letras deben estar en minúsculas.
- Los nombres de las conexiones deben comenzar con una letra y terminar con una letra o un número.
- Los nombres de las conexiones no pueden superar los 49 caracteres.
- De manera opcional, ingresa una Descripción para la instancia de conexión.
- De manera opcional, habilita Cloud Logging y, luego, selecciona un nivel de registro. De forma predeterminada, el nivel de registro se establece en
Error
. - Cuenta de servicio: Selecciona una cuenta de servicio que tenga los roles necesarios.
- Servicio/Módulo: Selecciona el módulo de UKG.
- De manera opcional, configura los parámetros de nodo de conexión:
- Cantidad mínima de nodos: Ingresa la cantidad mínima de nodos de conexión.
- Cantidad máxima de nodos: Ingresa la cantidad máxima de nodos de conexión.
Un nodo es una unidad (o réplica) de una conexión que procesa transacciones. Se requieren más nodos para procesar más transacciones para una conexión y, del mismo modo, se requieren menos para procesar menos transacciones. Para comprender cómo los nodos afectan el precio del conector, consulta Precios de nodos de conexión. Si no ingresas ningún valor, se establecen de forma predeterminada los nodos mínimos en 2 (para una mejor disponibilidad) y los nodos máximos se establecen en 50.
- De forma opcional, haz clic en + AGREGAR ETIQUETA para agregar una etiqueta a la conexión en forma de un par clave-valor.
- Haga clic en SIGUIENTE.
- En la sección Destinos, ingresa los detalles del host remoto (sistema de backend) al que deseas conectarte.
- Tipo de destino: Selecciona un Tipo de destino.
- Para especificar el nombre de host o la dirección IP de destino, selecciona Dirección de host y, luego, ingresa la dirección en el campo Host 1.
- Para establecer una conexión privada, selecciona Adjunto de extremo y elige el adjunto requerido de la lista Adjunto de extremo.
Si deseas establecer una conexión pública con tus sistemas de backend con seguridad adicional, puedes configurar direcciones IP salientes estáticas para tus conexiones y, luego, configurar tus reglas de firewall para permitir solo las direcciones IP estáticas específicas.
Para ingresar destinos adicionales, haz clic en +AGREGAR DESTINO.
- Haga clic en SIGUIENTE.
- Tipo de destino: Selecciona un Tipo de destino.
-
En la sección Autenticación, ingresa los detalles de autenticación.
- Selecciona un Tipo de autenticación y, luego, ingresa los detalles relevantes.
La conexión de UKG admite los siguientes tipos de autenticación:
- Autenticación básica
- OAUTH 2.0: Código de autorización
- Haga clic en SIGUIENTE.
Para comprender cómo configurar estos tipos de autenticación, consulta Configura la autenticación.
- Selecciona un Tipo de autenticación y, luego, ingresa los detalles relevantes.
- Revisa: Revisa tus detalles de conexión y autenticación.
- Haz clic en Crear.
Configura la autenticación
Ingresa los detalles según la autenticación que desees usar.
- Autenticación básica
- Nombre de usuario: Es el nombre de usuario que se usa para autenticar el conector.
- Password: El Secret de Secret Manager que contiene la contraseña asociada con el conector.
OAUTH 2.0 - Código de autorización
- ID de cliente: el ID de cliente que se usa para solicitar tokens de acceso.
- Scopes:Es una lista separada por comas de los permisos deseados.
- Secreto de cliente: Secret de Secret Manager que contiene el secreto del cliente para la app conectada que creaste.
- Habilitar PKCE: Selecciona esta opción si deseas habilitar la clave de prueba para el intercambio de código (PKCE).
- URL de autorización: Es la URL de autorización de tu app. Se te redireccionará a esta página para que accedas a tu app.
- URL del token de acceso: Es la URL que se usará para intercambiar el token de acceso. Proporciona la URL completa, incluido el esquema.
Muestras de configuración de conexión
En esta sección, se enumeran los valores de muestra para los distintos campos que configuras cuando creas la conexión.
OAUTH 2.0: Tipo de conexión de código de autorización
Nombre del campo | Detalles |
---|---|
Ubicación | us-central1 |
Conector | UKG |
Versión del conector | 1 |
Nombre de la conexión | gcp-ukg-oauth-conn |
Habilita Cloud Logging | Sí |
Nivel de registro | Error |
Cuenta de servicio | SERVICEACCOUNT_NAME@developer.gserviceaccount.com |
Módulo de especificaciones de OpenAPI | Control de asistencia |
Nivel de detalle | 5 |
Cantidad mínima de nodos | 2 |
Cantidad máxima de nodos | 50 |
Tipo de destino | Dirección del host |
Dirección del host | https://google-connect-dev.cfn.mykronos.com |
ID de cliente | ZG******-****-****-****-*********uDN |
Secreto del cliente | Secreto |
Versión del Secret | 1 |
URL de autorización | https://google-connect-dev.cfn.mykronos.com/oauth2/authorize |
URL de token de acceso | https://google-connect-dev.cfn.mykronos.com/api/authentication/access_token |
Limitaciones del sistema
El conector de UKG puede procesar 30 transacciones por segundo, por nodo, y limita las transacciones que superen este límite. De forma predeterminada, Integration Connectors asigna 2 nodos (para una mejor disponibilidad) a una conexión.
Para obtener información sobre los límites aplicables a Integration Connectors, consulta Límites.
acciones
Este conector te permite realizar varias acciones en los datos de UKG.
En esta sección, se enumeran las acciones que admite el conector de UKG. Para comprender cómo configurar las acciones, consulta Ejemplos de acciones.
Acción RetrieveAllEmployeeGroupsOrByName
Recupera todos los grupos de empleados por nombre.
Parámetros de entrada de la acción RetrieveAllEmployeeGroupsOrByName
Nombre del parámetro | Tipo de datos | Obligatorio | Descripción |
---|---|---|---|
all_details | booleano | Verdadero | Es un valor booleano que indica si la respuesta es ligera, es decir, si contiene solo los campos de ID y nombre. |
nombre | string | Verdadero | Es el nombre de un grupo de empleados. |
Para ver ejemplos sobre cómo configurar la acción RetrieveAllEmployeeGroupsOrByName
, consulta Ejemplos.
Crea la acción de PayCode
Crea un código de pago.
Parámetros de entrada de la acción Create PayCode
Nombre del parámetro | Tipo de datos | Obligatorio | Descripción |
---|---|---|---|
tipo | string | Verdadero | Es el tipo de código de pago. |
nombre | string | Verdadero | Es el nombre del código de pago. |
unidad | string | Verdadero | Unidad del código de pago. |
codeNumber | integer | Verdadero | Es el número de código asignado a un código de pago. |
Para ver ejemplos sobre cómo configurar la acción CreatePayCode
, consulta Ejemplos.
Acción DeletePayCodebyId
Borra un código de pago según el ID.
Parámetros de entrada de la acción DeletePayCodebyId
Nombre del parámetro | Tipo de datos | Obligatorio | Descripción |
---|---|---|---|
id | integer | Verdadero | Es el ID de un código de pago. |
Para ver ejemplos sobre cómo configurar la acción DeletePayCodebyId
, consulta Ejemplos.
Actualiza la acción de regla de trabajo por ID
Actualiza la regla de trabajo con el ID.
Parámetros de entrada de la acción Update Work Rule by ID
Nombre del parámetro | Tipo de datos | Obligatorio | Descripción |
---|---|---|---|
workRuleId | integer | Verdadero | ID de la regla de trabajo |
workRuleVersion | json | Verdadero | Es la versión de la regla de trabajo asociada a una regla de trabajo. |
nombre | string | Verdadero | Es el nombre de una regla de trabajo. |
versión | integer | Verdadero | Es la versión de la regla de trabajo. |
Para ver ejemplos sobre cómo configurar la acción Update Work Rule by ID
, consulta Ejemplos.
Ejemplos de acciones
Ejemplo: RetrieveAllEmployeeGroupsOrByName
En este ejemplo, se recuperan grupos de empleados.
- En el cuadro de diálogo
Configure connector task
, haz clic enactions
. - Selecciona la acción
RetrieveAllEmployeeGroupsOrByName
y haz clic en Listo. - En la sección Asignación de datos, haz clic en
Open Data Mapping Editor
y, luego, ingresa un valor similar al siguiente en el 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:
Ejemplo: Crea un PayCode
En este ejemplo, se crea un código de pago.
- En el cuadro de diálogo
Configure connector task
, haz clic enactions
. - Selecciona la acción
Create PayCode
y haz clic en Listo. - En la sección Asignación de datos, haz clic en
Open Data Mapping Editor
y, luego, ingresa un valor similar al siguiente en el 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" } }
Si la acción se realiza correctamente, el parámetro de respuesta connectorOutputPayload
de la tarea CreatePayCode
tendrá un valor similar al siguiente:
[{ "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 }]
Ejemplo: DeletePayCodebyId
En este ejemplo, se borra un código de pago según el ID.
- En el cuadro de diálogo
Configure connector task
, haz clic enactions
. - Selecciona la acción
DeletePayCodebyId
y haz clic en Listo. - En la sección Asignación de datos, haz clic en
Open Data Mapping Editor
y, luego, ingresa un valor similar al siguiente en el campoInput
:{ "Path parameters": { "id": 6002.0 } }
Si la acción se realiza correctamente, el parámetro de respuesta connectorOutputPayload
de la tarea DeletePayCodebyId
tendrá un valor similar al siguiente:
[{ "ResponseBody": "", "StatusCode": 200.0 }]
Ejemplo: Actualiza una regla de trabajo por ID
En este ejemplo, se actualiza la regla de trabajo.
- En el cuadro de diálogo
Configure connector task
, haz clic enactions
. - Selecciona la acción
Update Work Rule by ID
y haz clic en Listo. - En la sección Asignación de datos, haz clic en
Open Data Mapping Editor
y, luego, ingresa un valor similar al siguiente en el 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" } }
Si la acción se realiza correctamente, el parámetro de respuesta connectorOutputPayload
de la tarea Update Work Rule by ID
tendrá un valor similar al siguiente:
[{ "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 }]
Ejemplo: Borra una regla fija por ID
En este ejemplo, se borra una regla fija específica.
- En el cuadro de diálogo
Configure connector task
, haz clic enactions
. - Selecciona la acción
Delete Fixed Rule by ID
y haz clic en Listo. - En la sección Asignación de datos, haz clic en
Open Data Mapping Editor
y, luego, ingresa un valor similar al siguiente en el campoInput
:{ "Path parameters": { "id": 1152.0 } }
Si la acción se realiza correctamente, el parámetro de respuesta connectorOutputPayload
de la tarea Delete Fixed Rule by ID
tendrá un valor similar al siguiente:
[{ "ResponseBody": "", "StatusCode": 204.0 }]
Ejemplo: Recupera códigos de acumulación
En este ejemplo, se recuperan códigos de acumulación.
- En el cuadro de diálogo
Configure connector task
, haz clic enactions
. - Selecciona la acción
Retrieve Accrual Codes
y haz clic en Listo. - En la sección Asignación de datos, haz clic en
Open Data Mapping Editor
y, luego, ingresa un valor similar al siguiente en el campoInput
:{ "Query parameters": { "id": 1303.0 } }
Si la acción se realiza correctamente, el parámetro de respuesta connectorOutputPayload
de la tarea Retrieve Accrual Codes
tendrá un valor similar al siguiente:
[{ "ResponseBody": "[{\"id\":1303,\"typeId\":2,\"hoursPerDayInSeconds\":28800,\"name\":\"$LC Dia Familia\",\"shortName\":\"$LC Dia Familia\",\"typeName\":\"Day\",\"allowEdit\":true}]", "StatusCode": 200.0 }]
Ejemplo: Crea un horario de atención
En este ejemplo, se crea un horario de atención.
- En el cuadro de diálogo
Configure connector task
, haz clic enactions
. - Selecciona la acción
Create Hours of Operation
y haz clic en Listo. - En la sección Asignación de datos, haz clic en
Open Data Mapping Editor
y, luego, ingresa un valor similar al siguiente en el 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" } }] }] } }
Si la acción se realiza correctamente, el parámetro de respuesta connectorOutputPayload
de la tarea Create Hours of Operation
tendrá un valor similar al siguiente:
[{ "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" } }] }] }]
Ejemplo: Actualiza la configuración de la tarjeta de tiempo por ID
En este ejemplo, se actualiza el parámetro de configuración específico de la tarjeta de tiempo.
- En el cuadro de diálogo
Configure connector task
, haz clic enactions
. - Selecciona la acción
Update Timecard Setting by ID
y haz clic en Listo. - En la sección Asignación de datos, haz clic en
Open Data Mapping Editor
y, luego, ingresa un valor similar al siguiente en el 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}
Si la acción se realiza correctamente, el parámetro de respuesta connectorOutputPayload
de la tarea Update Timecard Setting by ID
tendrá un valor similar al siguiente:
[{ "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}]
Ejemplo: Recupera perfiles de información de personas
En este ejemplo, se recuperan perfiles de información de personas.
- En el cuadro de diálogo
Configure connector task
, haz clic enactions
. - Selecciona la acción
Retrieve People Information Profiles
y haz clic en Listo. - En la sección Asignación de datos, haz clic en
Open Data Mapping Editor
y, luego, ingresa un valor similar al siguiente en el campoInput
:{ "Headers": { "Content-Type": "application/json" }, "RequestBody": { "where": { "ids": [-1.0, 651.0] } } }
Si la acción se realiza correctamente, el parámetro de respuesta connectorOutputPayload
de la tarea Retrieve People Information Profiles
tendrá un valor similar al siguiente:
[{ "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 }]
Ejemplo: Recupera todas las condiciones de empleo
En este ejemplo, se recuperan todas las condiciones de empleo.
- En el cuadro de diálogo
Configure connector task
, haz clic enactions
. - Selecciona la acción
Retrieve All Employment Terms
y haz clic en Listo. - En la sección Asignación de datos, haz clic en
Open Data Mapping Editor
y, luego, ingresa un valor similar al siguiente en el campoInput
:{ "Query parameters": { "id": 2202.0 } }
Si la acción se realiza correctamente, el parámetro de respuesta connectorOutputPayload
de la tarea Retrieve All Employment Terms
tendrá un valor similar al siguiente:
[{ "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 }]
Ejemplo: Crea perfiles de certificación
En este ejemplo, se crean los perfiles de certificación.
- En el cuadro de diálogo
Configure connector task
, haz clic enactions
. - Selecciona la acción
Create Attestation Profiles
y haz clic en Listo. - En la sección Asignación de datos, haz clic en
Open Data Mapping Editor
y, luego, ingresa un valor similar al siguiente en el campoInput
:{ "Headers": { "Content-Type": "application/json" }, "RequestBody": { "versionCount": 0.0, "name": "Empty Profile 3", "deleted": false, "attestationAssignments": [] } }
Si la acción se realiza correctamente, el parámetro de respuesta connectorOutputPayload
de la tarea Create Attestation Profiles
tendrá un valor similar al siguiente:
[{ "id": 434.0, "versionCount": 0.0, "name": "Empty Profile 3", "deleted": false }]
Ejemplo: Recupera el perfil de ausencia por ID
En este ejemplo, se recupera un perfil de ausencia según el ID.
- En el cuadro de diálogo
Configure connector task
, haz clic enactions
. - Selecciona la acción
Retrieve Leave Profile by Id
y haz clic en Listo. - En la sección Asignación de datos, haz clic en
Open Data Mapping Editor
y, luego, ingresa un valor similar al siguiente en el campoInput
:{ "Path parameters": { "id": 3.0 } }
Si la acción se realiza correctamente, el parámetro de respuesta connectorOutputPayload
de la tarea Retrieve Leave Profile by Id
tendrá un valor similar al siguiente:
[{ "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" } }]
Ejemplo: Recupera las reglas disponibles
En este ejemplo, se recuperan las reglas disponibles.
- En el cuadro de diálogo
Configure connector task
, haz clic enactions
. - Selecciona la acción
Retrieve Available Rules
y haz clic en Listo. - En la sección Asignación de datos, haz clic en
Open Data Mapping Editor
y, luego, ingresa un valor similar al siguiente en el campoInput
:{ "Query parameters": { "leave_case_id": 189.0 } }
Si la acción se realiza correctamente, el parámetro de respuesta connectorOutputPayload
de la tarea Retrieve Available Rules
tendrá un valor similar al siguiente:
[{ "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" } }]
Crea conexiones con Terraform
Puedes usar el recurso de Terraform para crear una conexión nueva.
Si deseas obtener más información para aplicar o quitar una configuración de Terraform, consulta los comandos básicos de Terraform.
Para ver una plantilla de Terraform de ejemplo para la creación de conexiones, consulta la plantilla de ejemplo.
Cuando crees esta conexión con Terraform, debes establecer las siguientes variables en tu archivo de configuración de Terraform:
Nombre del parámetro | Tipo de datos | Obligatorio | Descripción |
---|---|---|---|
proxy_enabled | BOOLEAN | Falso | Selecciona esta casilla de verificación para configurar un servidor proxy para la conexión. |
proxy_auth_scheme | ENUM | Falso | Tipo de autenticación que se usará para autenticarse en el proxy de ProxyServer. Los valores admitidos son BASIC, DIGEST y NONE. |
proxy_user | STRING | Falso | Nombre de usuario que se usará para autenticarse en el proxy de ProxyServer. |
proxy_password | SECRET | Falso | Contraseña que se usará para la autenticación en el proxy de ProxyServer. |
Usa la conexión de UKG en una integración
Después de crear la conexión, estará disponible en la integración de Apigee y en Application Integration. Puedes usar la conexión en una integración a través de la tarea Connectors.
- Para comprender cómo crear y usar la tarea Connectors en Apigee Integration, consulta Tarea Connectors.
- Para comprender cómo crear y usar la tarea Connectors en Application Integration, consulta Tarea Connectors.
Obtén ayuda de la Comunidad de Google Cloud
Puedes publicar tus preguntas y debatir sobre este conector en la comunidad de Google Cloud en Cloud Forums.¿Qué sigue?
- Obtén información para suspender y reanudar una conexión.
- Obtén información para supervisar el uso del conector.
- Comprende cómo ver los registros del conector.