Conexión con Shopify
Introducción
Una conexión de Shopify, creada mediante 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 (consulte 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ñaComponentes del panel Proyecto).
- La página Conexiones globales (vea Editar un extremo global en Conexiones globales)
Configurar una conexión de 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.
Consejo
Campos con un Compatibilidad con iconos variables mediante variables globales, variables del proyecto y variables de Jitterbit. Comience escribiendo un corchete abierto [
en el campo o haciendo clic en el ícono de variable para mostrar una lista de las variables existentes para elegir.
-
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 se refiere 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: Autenticación básica o Token de acceso de Shopify. Si usa una aplicación privada, seleccione Autenticación básica. Si usa 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 del agente privado.
-
Versión de API: Seleccione API de administración REST de Shopify versión, una de las siguientes: 2022-04 (predeterminada), 2023-01, 2023-04, 2023-07, 2023-10, 2024-01, 2024-04, 2024-07, 2024-10 o 2025-01. Según los extremos de la API compatibles con Shopify en la versión de la API utilizada, los objetos y subobjetos disponibles para su selección durante la configuración de la actividad pueden variar. Si se cambia la Versión de la API de una conexión con actividades configuradas, consulte las consideraciones adicionales en Cambiar la versión de la 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 dejará de mantenerla y cualquier llamada a la API que la solicite se redirigirá automáticamente a la versión estable más antigua compatible.
Shopify puede dejar obsoletos ciertos extremos con la introducción de una nueva versión de la API. Por lo tanto, es posible que tengas que cambiar la configuración de tus aplicaciones y actividades debido a funciones modificadas o retiradas.
Las versiones de API y los extremos obsoletos se anuncian en el registro de cambios de Shopify, donde se encuentren 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 añadido a la tabla se incluye en el esquema de solicitud de cada actividad.
- Añadir: Agrega una fila a la tabla. Introduzca 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.
- Borrar todo: Elimina todas las filas de la tabla.
Importante
Los campos de la tabla Encabezados de solicitud muestran la El icono de variable solo está disponible en modo de edición. Para que los valores de variable de estos campos se rellenen en tiempo de ejecución, la versión del agente debe ser al menos 10.75 / 11.13.
-
-
Prueba: Haga clic para verificar la conexión con la configuración proporcionada. Al probar la conexión, los agentes del grupo de agentes asociado al ambiente actual descargan la última versión del conector. Este conector permite suspender la descarga de la última versión mediante la política Deshabilitar actualización automática del conector política de la organización.
-
Guardar cambios: Haga clic para guardar y cerrar la configuración de la conexión.
-
Descartar cambios: Después de realizar cambios en una configuración nueva o existente, haga clic para cerrarla sin guardar. Un mensaje le pedirá que confirme que desea descartar los cambios.
-
Eliminar: Después de abrir una configuración de conexión existente, haga clic para eliminarla permanentemente del proyecto y cerrarla (consulte Dependencias de componentes, eliminación y eliminació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 ya tiene actividades configuradas, 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 utilizada. Si la configuración de la actividad utiliza extremos de API no compatibles con la versión de API a la que se está cambiando, dichas actividades fallarán a menos que se reconfiguren.
Para evitar que esto ocurra, siga estos pasos:
-
Cambie la versión de API en la conexión de Shopify.
-
Abra cada pantalla de configuración de actividad donde 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 la API que se llama, la selección podría cambiar al actualizar. Preste mucha atención para asegurarse de que las selecciones modificadas sean las previstas.
-
Seleccione el objeto y subobjeto adecuados compatibles con la versión de API que se está llamando.
-
Redistribuir operaciones que utilizan la conexión y las actividades.
Próximos pasos
Después de crear una conexión de Shopify, coloca un tipo de actividad en el tela de diseño para crear instancias de actividad que se usarán como fuentes (para proporcionar datos en una operación) o como destinos (para consumir datos en una operación).
Se puede acceder a las acciones de menú de una conexión y sus tipos de actividad desde el panel del proyecto y la paleta de componentes de diseño. Para más información, consulte Menús de acciones en Conceptos básicos del conector.
Estos tipos de actividades están disponibles:
-
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.