UKG

El conector de UKG te permite realizar varias acciones en los datos de UKG.

Antes de comenzar

Antes de usar el conector UKG, realiza las siguientes tareas:

  • En tu proyecto de Google Cloud, haz lo siguiente:
    • Otorga el rol de IAM roles/connectors.admin al usuario. configurar 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

Para configurar el conector, debes crear una conexión a tu fuente de datos (sistema de backend). 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, sigue estos pasos:

  1. En la consola de Cloud, ve a la página Conectores de Integration > Conexiones y, luego, selecciona o crea un proyecto de Google Cloud.

    Ir a la página Conexiones

  2. Haz clic en + CREAR NUEVO para abrir la página Crear conexión.
  3. En la sección Ubicación, elige la ubicación para la conexión.
    1. Región: selecciona una ubicación de la lista desplegable.

      Para obtener la lista de todas las regiones compatibles, consulta Ubicaciones.

    2. Haz clic en SIGUIENTE.
  4. En la sección Detalles de la conexión, completa lo siguiente:
    1. Conector: Selecciona UKG en la lista desplegable de conectores disponibles.
    2. Versión del conector: selecciona la versión del conector de la lista desplegable de versiones disponibles.
    3. 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 63 caracteres.
    4. De manera opcional, ingresa una Descripción para la instancia de conexión.
    5. De manera opcional, habilita Cloud Logging y, luego, selecciona un nivel de registro. De forma predeterminada, el nivel de registro se establece en Error.
    6. Cuenta de servicio: Selecciona una cuenta de servicio que tenga los roles necesarios.
    7. Service/Module: Selecciona el módulo UKG.
    8. 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.

    9. De forma opcional, haz clic en + AGREGAR ETIQUETA para agregar una etiqueta a la conexión en forma de un par clave-valor.
    10. Haga clic en SIGUIENTE.
  5. En la sección Destinos, ingresa los detalles del host remoto (sistema de backend) al que deseas conectarte.
    1. Tipo de destino: Selecciona un Tipo de destino.
      • Selecciona Dirección de host en la lista para especificar el nombre de host o la dirección IP del destino.
      • Si deseas establecer una conexión privada a tus sistemas de backend, selecciona Adjunto de extremo en la lista y, luego, selecciona el archivo adjunto de extremo requerido en la lista Adjunto de extremo.

      Si deseas establecer una conexión pública con tus sistemas de backend con seguridad adicional, puedes considera configurar la configuración estática de direcciones IP internas para tus conexiones y, luego, para incluir en la lista de entidades permitidas solo las direcciones IP estáticas específicas.

      Para ingresar destinos adicionales, haz clic en +AGREGAR DESTINO.

    2. Haga clic en SIGUIENTE.
  6. En la sección Autenticación, ingresa los detalles de autenticación.
    1. Selecciona un Tipo de autenticación y, luego, ingresa los detalles relevantes.

      La conexión UKG admite los siguientes tipos de autenticación:

      • Autenticación básica
      • OAUTH 2.0: Código de autorización

        • Para comprender cómo configurar estos tipos de autenticación, consulta Configura la autenticación.

      • Haga clic en SIGUIENTE.
  7. Revisa: Revisa tus detalles de conexión y autenticación.
  8. 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: 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.
    • Permisos: Es una lista de permisos deseados separados por comas.
    • 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 quieres habilitar la clave de prueba de 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 acceder 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

Esta sección enumera los valores de muestra para los diversos que configuras cuando creas la conexión.

OAUTH 2.0: Tipo de conexión del 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 la API abierta Cronómetro
Nivel de verbosidad 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 del Reino Unido puede procesar 30 transacciones por segundo, por nodo, y throttles las transacciones supera este límite. De forma predeterminada, Integration Connectors asigna 2 nodos (para una mejor disponibilidad) por una conexión.

Para obtener información sobre los límites aplicables a Integration Connectors, consulta Límites.

de solución

Este conector te permite realizar varias acciones en los datos de UKG.

En esta sección, se enumeran las acciones que admite el conector del 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 Un valor booleano que indica si la respuesta es ligera, es decir, una respuesta que solo contiene campos de ID y nombre.
name string Verdadero El nombre de un grupo de empleados.

Por ejemplo, sobre cómo configurar la acción RetrieveAllEmployeeGroupsOrByName, consulta Ejemplos.

Crear acción de código de pago

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 El tipo de código de pago.
name string Verdadero Es el nombre del código de pago.
unidad string Verdadero La unidad del código de pago.
codeNumber integer Verdadero Es el número de código asignado a un código de pago.

Por ejemplo, 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.

Actualizar 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 La versión de la regla de trabajo asociada con una regla de trabajo.
name string Verdadero El nombre de una regla de trabajo.
version integer Verdadero Versión de la regla de trabajo.

Por ejemplo, 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.

  1. En el cuadro de diálogo Configure connector task, haz clic en actions.
  2. Selecciona la acción RetrieveAllEmployeeGroupsOrByName y haz clic en Listo.
  3. En la sección Asignación de datos Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el 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\":\"}]

Ejemplo: Crea un código de pago

En este ejemplo, se crea un código de pago.

  1. En el cuadro de diálogo Configure connector task, haz clic en actions.
  2. Selecciona la acción Create PayCode y haz clic en Listo.
  3. En la sección Asignación de datos, Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el 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. Si la acción tiene éxito, el 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.

  1. En el cuadro de diálogo Configure connector task, haz clic en actions.
  2. Selecciona la acción DeletePayCodebyId y haz clic en Listo.
  3. En la sección Asignación de datos, Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el campo Input: 
      {
  "Path parameters": {
    "id": 6002.0
  }
}

    4. Si la acción tiene éxito, el Respuesta connectorOutputPayload de la tarea DeletePayCodebyId tendrá un valor similar al siguiente:

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

Ejemplo: Actualizar regla de trabajo por ID

En este ejemplo, se actualiza la regla de trabajo.

  1. En el cuadro de diálogo Configure connector task, haz clic en actions.
  2. Selecciona la acción Update Work Rule by ID y haz clic en Listo.
  3. En la sección Asignación de datos Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el 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. Si la acción tiene éxito, el 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.

  1. En el cuadro de diálogo Configure connector task, haz clic en actions.
  2. Selecciona la acción Delete Fixed Rule by ID y haz clic en Listo.
  3. En la sección Asignación de datos Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el Campo Input: 
     {
  "Path parameters": {
    "id": 1152.0
  }
}

    4. Si la acción tiene éxito, el Respuesta connectorOutputPayload de la tarea Delete Fixed Rule by ID tendrá un valor similar al siguiente:

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

Ejemplo: Cómo recuperar códigos de acumulación

En este ejemplo, se recuperan códigos de precisión.

  1. En el cuadro de diálogo Configure connector task, haz clic en actions.
  2. Selecciona la acción Retrieve Accrual Codes y haz clic en Listo.
  3. En la sección Asignación de datos, Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el campo Input: 
     {
  "Query parameters": {
    "id": 1303.0
  }
}

    4. Si la acción tiene éxito, el 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 horas de funcionamiento

En este ejemplo, se crean horas de operación.

  1. En el cuadro de diálogo Configure connector task, haz clic en actions.
  2. Selecciona la acción Create Hours of Operation y haz clic en Listo.
  3. En la sección Asignación de datos Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el 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. Si la acción tiene éxito, el 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 el parámetro de configuración del horario por ID

En este ejemplo, se actualiza el parámetro de configuración específico de la tarjeta de horario.

  1. En el cuadro de diálogo Configure connector task, haz clic en actions.
  2. Selecciona la acción Update Timecard Setting by ID y haz clic en Listo.
  3. En la sección Asignación de datos Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el 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. Si la acción tiene éxito, el 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 los perfiles de información de personas.

  1. En el cuadro de diálogo Configure connector task, haz clic en actions.
  2. Selecciona la acción Retrieve People Information Profiles y haz clic en Listo.
  3. En la sección Asignación de datos, Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el campo Input: 
      {
  "Headers": {
    "Content-Type": "application/json"
  },
  "RequestBody": {
    "where": {
      "ids": [-1.0, 651.0]
    }
  }
}

    4. Si la acción tiene éxito, el 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: obtener todas las condiciones laborales

Este ejemplo recupera todos los términos de empleo.

  1. En el cuadro de diálogo Configure connector task, haz clic en actions.
  2. Selecciona la acción Retrieve All Employment Terms y haz clic en Listo.
  3. En la sección Asignación de datos Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el Campo Input: 
       {
  "Query parameters": {
    "id": 2202.0
  }
}

    4. Si la acción tiene éxito, el 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.

  1. En el cuadro de diálogo Configure connector task, haz clic en actions.
  2. Selecciona la acción Create Attestation Profiles y haz clic en Listo.
  3. En la sección Asignación de datos Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el Campo Input: 
     {
  "Headers": {
    "Content-Type": "application/json"
  },
  "RequestBody": {
    "versionCount": 0.0,
    "name": "Empty Profile 3",
    "deleted": false,
    "attestationAssignments": []
  }
}

    4. 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 abandono por ID

En este ejemplo, se recupera un perfil de salida basado en el ID.

  1. En el cuadro de diálogo Configure connector task, haz clic en actions.
  2. Selecciona la acción Retrieve Leave Profile by Id y haz clic en Listo.
  3. En la sección Asignación de datos, Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el campo Input: 
     {
  "Path parameters": {
    "id": 3.0
  }
}

    4. Si la acción tiene éxito, el 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.

  1. En el cuadro de diálogo Configure connector task, haz clic en actions.
  2. Selecciona la acción Retrieve Available Rules y haz clic en Listo.
  3. En la sección Asignación de datos Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el Campo Input: 
     {
  "Query parameters": {
    "leave_case_id": 189.0
  }
}

    4. Si la acción tiene éxito, el 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"
    }
}]

Usar Terraform para crear conexiones

Puedes usar Terraform resource 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.

Si quieres ver una plantilla de Terraform de muestra para crear conexiones, consulta la plantilla de muestra.

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 a fin de configurar un servidor proxy para la conexión.
proxy_auth_scheme ENUM Falso El tipo de autenticación que se utiliza para autenticarse en el proxy ProxyServer. Los valores admitidos son: BASIC, DIGEST, NONE
proxy_user STRING Falso Un nombre de usuario que se usará para autenticarse en el proxy ProxyServer.
proxy_password SECRET Falso Una contraseña que se usará para autenticarse en el proxy ProxyServer.

Usa la conexión del Reino Unido en una integración

Después de crear la conexión, estará disponible en la integración de Apigee y en la integración de aplicaciones. 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 Conectores en la integración de Apigee, consulta Tarea Conectores.
  • Para comprender cómo crear y usar la tarea Conectores en Application Integration, consulta la Tarea Conectores.

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?