Conexión con Shopify¶

Introducción¶

Una conexión de Shopify, creada usando el conector de Shopify, establece acceso a Shopify. Una vez configurada una conexión, puedes crear instancias de actividades de Shopify asociadas con esa conexión para usarlas como fuentes (para proporcionar datos en una operación) o como destinos (para consumir datos en una operación).

Crear o Editar una Conexión de Shopify¶

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

• La pestaña extremos y conectores del proyecto de la paleta de componentes de diseño (consulte paleta de componentes de diseño).
• La página Conexiones globales (vea Crear un extremo global en Conexiones globales).

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

• La pestaña extremos y conectores del proyecto de la paleta de componentes de diseño (consulte paleta de componentes de diseño).
• La pestaña Componentes del panel del proyecto (vea menú de acciones de componentes en la pestaña Componentes del panel Proyecto).
• La página Conexiones globales (vea Editar un extremo global en Conexiones globales).

Configurar una Conexión a Shopify¶

A continuación se describe cada elemento de la interfaz de usuario de la pantalla de configuración de la conexión de Shopify.

• Nombre de la conexión: Ingrese un nombre para identificar la conexión. El nombre debe ser único para cada conexión de Shopify y no debe contener barras diagonales. /o dos puntos : Este nombre también se utiliza para identificar el extremo de Shopify, que hace referencia tanto a una conexión específica como a sus actividades.

• Nombre de la tienda: Ingrese el nombre de la tienda Shopify.

• Tipo de autenticación: Seleccione el tipo de autenticación, uno de los siguientes: Autenticación básica o Token de acceso de Shopify. Si está utilizando una aplicación privada, seleccione Autenticación básica. Si está utilizando una aplicación personalizada creada en el panel de control de Shopify, seleccione Token de acceso de Shopify.

• Clave API: Si se seleccionó Autenticación básica como Tipo de autenticación, ingrese la clave API para la instancia de Shopify.

• Contraseña: Si se seleccionó Autenticación básica como Tipo de autenticación, ingrese la contraseña para la instancia de Shopify.

• Token de acceso a la API: Si se seleccionó Token de acceso de Shopify como Tipo de autenticación, ingrese el Token de acceso a la API para la instancia de Shopify.

• Configuración opcional: Haga clic para expandir configuraciones adicionales:

  • Usar configuración de proxy (solo Agente Privado): Al usar un agente privado, se puede seleccionar esta configuración para usar configuración de proxy de agente privado.

  • Versión de API: Seleccione API de administración REST de Shopify versión, una de 2022-04 (predeterminada), 2023-01, 2023-04, 2023-07, 2023-10, 2024-01, 2024-04 o 2024-07. Según los extremos de API compatibles con Shopify en la versión de API que se esté utilizando, los objetos y subobjetos que están disponibles para su selección durante la configuración de la actividad pueden variar. Si cambia la versión de API para una conexión que tiene actividades configuradas existentes, consulte consideraciones adicionales en Cambiar la versión de API abajo.

    Importante

    Shopify lanza una nueva versión de API cada tres meses y mantiene cada versión de lanzamiento durante un mínimo de doce meses. Una vez que una versión de API quede obsoleta, Shopify ya no mantendrá esa versión y cualquier llamada de API que solicite esa versión se enrutará automáticamente a la versión estable más antigua que se admita actualmente.

    Shopify puede dejar obsoletos ciertos extremos con la introducción de una nueva versión de API. Como resultado, es posible que deba cambiar sus aplicaciones y configuraciones de actividad debido a funciones modificadas o retiradas.

Las versiones y los extremos de API obsoletos se anuncian en el registro de cambios de Shopify, donde se encuentran disponibles más detalles y cualquier información relevante sobre migración.

- **Encabezados de solicitud:** Use esta tabla para agregar los pares clave-valor que se enviarán con cada solicitud de actividad. Cada valor agregado a la tabla se incluye en el esquema de solicitud de cada actividad.

    -   <span class="icon-plus" style="color: #908c94"></span> **Agregar:** Agrega una fila a la tabla. Ingrese un par clave-valor para cada propiedad.
    -   <span class="icon-success" style="color: #908c94"></span> **Enviar:** Guarda el par clave-valor en la tabla. Es visible al pasar el cursor sobre una fila en el modo de edición.
    -   <span class="icon-fail" style="color: #908c94"></span> **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.
    - <span class="icon-edit" style="color: #908c94"></span> **Editar:** Le permite editar un par clave-valor existente. Es visible al pasar el cursor sobre una fila existente.
    -   <span class="icon-trash" style="color: #908c94"></span> **Eliminar:** Elimina la fila de la tabla. Visible al pasar el cursor sobre una fila existente. 
    - **Borrar todo:** Elimina todas las filas de la tabla.

    !!! important "Importante"
        Los campos de la tabla **Encabezados de solicitud** muestran <span class="icon-variable"></span> el icono de variable solo está 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](/es/release-notes/harmony-release-notes/summer-2023/10-75-11-13/).

• Prueba: Haz clic para verificar la conexión usando la configuración proporcionada. Cuando se prueba la conexión, los agentes del grupo de agentes asociado con el ambiente actual descargan la última versión del conector. Este conector admite la suspensión de la descarga de la última versión del conector mediante la política de la organización Deshabilitar actualización automática del conector.

• Guardar cambios: Haga clic para guardar y cerrar la configuración de conexión.

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

• Eliminar: 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 te pedirá que confirmes que deseas eliminar la conexión.

Cambiar la Versión de la API¶

Si una conexión de Shopify tiene actividades configuradas existentes, hay consideraciones adicionales que se deben tener en cuenta al cambiar la Versión de API seleccionada. Esto se debe a que los objetos y subobjetos disponibles para la selección en la configuración de la actividad dependen de los extremos de API compatibles con Shopify en la versión de API que se esté utilizando. Si la configuración de la actividad existente utiliza extremos de API que no son compatibles con la versión de API a la que está cambiando, esas actividades fallarán a menos que se reconfiguren.

Para evitar que esto ocurra, siga estos pasos:

1. Cambie la versión de API en la conexión de Shopify.

2. Abra cada pantalla de configuración de actividad donde se haya seleccionado un objeto o subobjeto y haga clic en Actualizar. Al actualizar, se recuperarán las listas de selección de objetos y subobjetos actuales utilizando la versión de API seleccionada en la conexión de Shopify. Tenga en cuenta que Shopify redirige automáticamente las llamadas de versiones de API no compatibles a la siguiente versión compatible más antigua.

   Importante

   Si el objeto o subobjeto seleccionado no es compatible con la versión de API que se está llamando, la selección puede cambiar al actualizar. Preste mucha atención para asegurarse de que las selecciones modificadas sean las previstas.

3. Seleccione el objeto y subobjeto adecuados compatibles con la versión de API que se está llamando.

4. Redistribuir operaciones que utilizan la conexión y actividades.

Próximos Pasos¶

Después de crear una conexión de Shopify, coloque un tipo de actividad en el tela 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 obtener más detalles, consulte Menús de acciones en Conceptos básicos del conector.

Están disponibles estos tipos de actividades:

• Leer: Recupera datos de objetos de Shopify y está destinado a ser utilizado como fuente en una operación.

• Consulta: Consulta datos de objetos de Shopify y está destinado a ser utilizado como fuente en una operación.

• Crear: Crea datos de objetos en Shopify y está destinado a ser utilizado como objetivo en una operación.

• Actualizar: Actualiza los datos de los objetos en Shopify y está destinado a ser utilizado como objetivo en una operación.

• Borrar: Elimina datos de objetos de Shopify y está destinado a ser utilizado como objetivo en una operación.