Saltar al contenido

Conexión Kintone

Introducción

Una conexión Kintone, creada utilizando el conector Kintone, establece acceso a Kintone. Estas actividades, una vez configuradas, interactúan con Kintone a través de la conexión.

Crear o editar una conexión Kintone

Se crea una nueva conexión Kintone utilizando el conector Kintone desde una de estas ubicaciones:

Se puede editar una conexión Kintone existente desde estas ubicaciones:

Configurar una conexión Kintone

Cada elemento de la interfaz de usuario de la pantalla de configuración de la conexión Kintone se describe a continuación.

Consejo

Los campos con un ícono de variable admiten el uso de variables globales, variables de proyecto, y variables de Jitterbit. Comience escribiendo un corchete cuadrado abierto [ en el campo o haciendo clic en el ícono de variable para mostrar una lista de las variables existentes de las que elegir.

  • Nombre de Conexión: Ingresa un nombre para identificar la conexión. El nombre debe ser único para cada conexión de Kintone y no debe contener barras inclinadas (/) ni dos puntos (:). Este nombre también se utiliza para identificar el endpoint de Kintone, que se refiere tanto a una conexión específica como a sus actividades.

  • URL: Ingresa la URL.

  • Esquema de Autenticación: Selecciona el esquema de autorización, uno de:

    • Contraseña

      • Usuario: Ingresa el usuario.

      • Contraseña: Ingresa la contraseña.

    • Token de API

      • ID de App: Ingresa el ID de la app.

      • Token de API: Ingresa el token de API.

    • OAuth

      • Iniciar OAuth: Selecciona la configuración de OAuth, una de:

        • APAGADO

          • Token de Acceso OAuth: Ingresa el token de acceso OAuth.

        • OBTENER Y REFRESCAR

        • REFRESCAR

          • Token de Acceso OAuth: Ingresa el token de acceso OAuth.

      • ID de Cliente OAuth: Ingresa el ID de cliente OAuth.

      • Secreto de Cliente OAuth: Ingresa el secreto de cliente OAuth.

      • Token de Refresco OAuth: Ingresa el token de refresco OAuth.

  • Usar Configuraciones de Proxy: Selecciona para usar configuraciones de proxy de agente privado.

  • Configuraciones Avanzadas: Cuando se selecciona, muestra la tabla de Propiedades de Configuraciones Avanzadas, que se utiliza para agregar propiedades de configuración adicionales como pares clave-valor.

    • Agregar: Agrega una fila a la tabla. Ingresa un par clave-valor para cada propiedad.
    • Enviar: Guarda el par clave-valor en la tabla. Visible al pasar el cursor sobre una fila en modo de edición.
    • Descartar: Descarta una nueva fila o cualquier edición realizada en una fila existente. Visible al pasar el cursor sobre una fila en modo de edición.
    • Editar: Permite editar un par clave-valor existente. Visible al pasar el cursor sobre una fila existente.
    • Eliminar: Elimina la fila de la tabla. Visible al pasar el cursor sobre una fila existente.
    • Eliminar Todo: Elimina todas las filas de la tabla.

    Nota

    Los nombres de columnas y tablas de Kintone pueden contener caracteres especiales que no son compatibles con otros servicios. Agregue la propiedad de configuración UseSimpleNames y configúrela en true para imponer un esquema de nombres restringido a caracteres alfanuméricos y guiones bajos para columnas y tablas. Los caracteres no alfanuméricos se convierten en guiones bajos cuando está habilitado.

    Importante

    Los campos en la tabla de Propiedades de Configuraciones Avanzadas muestran el ícono de variable solo en modo de edición. Para que los valores de variable de estos campos se completen en tiempo de ejecución, la versión del agente debe ser al menos 10.75 / 11.13.

    Los campos en la tabla de Propiedades de Configuraciones Avanzadas no admiten el uso de variables para pasar JSON sin procesar. Si su caso de uso no admite definir JSON sin procesar en los campos directamente, escape el contenido JSON antes de pasarlo con una variable. Por ejemplo, escapar {"success": "true"}; se convierte en {\"success\": \"true\"};.

  • Test: Haga clic para verificar la conexión utilizando la configuración especificada. Cuando se prueba la conexión, la última versión del conector es descargada por el(los) agente(s) en el grupo de agentes asociado con el entorno actual. Este conector admite suspender la descarga de la última versión del conector utilizando la política de organización Deshabilitar Actualización Automática del Conector.

  • Save Changes: Haga clic para guardar y cerrar la configuración de la conexión.

  • Discard Changes: Después de realizar cambios en una configuración nueva o existente, haga clic para cerrar la configuración sin guardar. Un mensaje le pide que confirme que desea descartar los cambios.

  • Delete: Después de abrir una configuración de conexión existente, haga clic para eliminar permanentemente la conexión del proyecto y cerrar la configuración (consulte Dependencias de componentes, eliminación y remoción). Un mensaje le pide que confirme que desea eliminar la conexión.

Próximos pasos

Después de que se ha creado una conexión del conector Kintone, se coloca un tipo de actividad en el lienzo de diseño para crear instancias de actividad que se utilizarán como fuentes (para proporcionar datos en una operación) o como destinos (para consumir datos en una operación).

Las acciones del menú para una conexión y sus tipos de actividad son accesibles desde el panel del proyecto y la paleta de componentes de diseño. Para más detalles, consulta los menús de acciones en Conceptos básicos del conector.

Estos tipos de actividad están disponibles:

  • Consulta: Recupera registros de una tabla en Kintone y está destinado a ser utilizado como fuente en una operación.

  • Crear: Inserta un registro en una tabla en Kintone y está destinado a ser utilizado como destino en una operación.

  • Actualizar: Actualiza un registro en una tabla en Kintone y está destinado a ser utilizado como destino en una operación.

  • Eliminar: Elimina un registro de una tabla en Kintone y está destinado a ser utilizado como destino en una operación.

  • Ejecutar: Ejecuta un procedimiento en Kintone y está destinado a ser utilizado como destino en una operación.