Detalles de Conexión de Ebay

Introducción

Versión del conector

Esta documentación se basa en la versión 21.0.8257 del conector.

Empezando

Compatibilidad con la versión de eBay

El conector permite una vista relacional de las entidades de las APIs de Trading, FileTransfer, BulkData, Feedback y Merchandising.

Establecer una Conexión

Conexión a las APIs de Ebay

De forma predeterminada, el conector se conecta a ambientes de producción. Colocar UseSandbox a true para usar una cuenta sandbox de eBay.

Autenticación en Ebay

eBay utiliza el estándar de autenticación OAuth 2.0 y Auth'n'Auth, la autenticación tradicional utilizada por las APIs de eBay. Para autenticarse usando OAuth o Auth'n'Auth, según cómo esté configurada su aplicación, deberá crear una aplicación para obtener el OAuthClientId, OAuthClientSecret, DevID, y CallbackURL propiedades de conexión. Consulte Uso de la autenticación OAuth para obtener una guía de autenticación.

Uso de la Autenticación OAuth

OAuth requiere que el usuario que se autentica interactúe con eBay usando el navegador. El conector facilita esto de varias maneras, como se describe a continuación.

Credenciales Personalizadas

Deberá registrar una aplicación para obtener el OAuthClientId y OAuthClientSecret.

Creación de una Aplicación OAuth Personalizada

Consulte Crear una aplicación OAuth personalizada para un procedimiento.

Credenciales Personalizadas

Autenticación de Escritorio con Su Aplicación OAuth

Siga los pasos a continuación para autenticarse con las credenciales de una aplicación OAuth personalizada. Consulte Crear una aplicación OAuth personalizada.

Obtenga un Token de Acceso OAuth

Después de configurar lo siguiente, está listo para conectarse:

• OAuthClientId: establezca esto en la ID del cliente en la configuración de su aplicación.
• OAuthClientSecret: establezca esto en el secreto del cliente en la configuración de su aplicación.
• CallbackURL: establezca esto en la URL de redireccionamiento en la configuración de su aplicación.
• InitiateOAuth: Establézcalo en GETANDREFRESH. Puede usar InitiateOAuth para evitar repetir el intercambio de OAuth y configurar manualmente OAuthAccessToken..

Cuando se conecta, el conector abre el extremo de OAuth en su navegador predeterminado. Inicie sesión y otorgue permisos a la aplicación. Luego, el conector completa el proceso de OAuth:

1. Extrae el token de acceso de la URL de devolución de llamada y autentica las solicitudes.
2. Obtiene un nuevo token de acceso cuando caduca el antiguo.
3. Guarda los valores de OAuth en OAuthSettingsLocation para persistir a través de las conexiones.

Máquinas Sin Cabeza

Uso de OAuth en una Máquina Sin Cabeza

Para crear fuentes de datos de eBay en servidores autónomos u otras máquinas en las que el conector no puede abrir un navegador, debe autenticarse desde otra máquina. La autenticación es un proceso de dos pasos.

1. En lugar de instalar el conector en otra máquina, puede seguir los pasos a continuación para obtener el OAuthVerifier valor. O bien, puede instalar el conector en otra máquina y transferir los valores de autenticación de OAuth, después de autenticarse a través del flujo habitual basado en el navegador.
2. A continuación, puede configurar el conector para actualizar automáticamente el token de acceso desde la máquina sin periféricos.

Puede seguir el flujo de autenticación de OAuth sin cabeza usando las credenciales de OAuth integradas del conector o usando las credenciales de OAuth para su aplicación de OAuth personalizada.

Uso de las Credenciales para una Aplicación OAuth Personalizada

Cree una aplicación OAuth personalizada

Consulte Crear una aplicación OAuth personalizada para un procedimiento. Luego puede seguir los procedimientos a continuación para autenticarse y conectarse a los datos.

Obtenga un código verificador

Establezca las siguientes propiedades en la máquina sin periféricos:

• InitiateOAuth: Ajústelo a APAGADO.
• OAuthClientId: establezca esto en la ID de la aplicación en la configuración de su aplicación.
• OAuthClientSecret: establezca esto en el secreto de la aplicación en la configuración de su aplicación.

Luego puede seguir los pasos a continuación para autenticarse desde otra máquina y obtener el OAuthVerifier propiedad de conexión.

1. Llame a GetOAuthAuthorizationURL procedimiento almacenado* con el parámetro de entrada CallbackURL establecido en el URI de redirección exacto que especificó en la configuración de su aplicación.
2. Abra la URL devuelta en un navegador. Inicie sesión y otorgue permisos al conector. A continuación, se le redirige a la URL de devolución de llamada, que contiene el código verificador.
3. Guarde el valor del código verificador. Establecerá esto en el OAuthVerifier propiedad de conexión.

En la máquina sin periféricos, establezca las siguientes propiedades de conexión para obtener los valores de autenticación de OAuth:

• OAuthClientId: establezca esto en la clave de consumidor en la configuración de su aplicación.
• OAuthClientSecret: establezca esto en el secreto del consumidor en la configuración de su aplicación.
• OAuthVerifier: Establézcalo en el código del verificador.
• OAuthSettingsLocation: configure esto para conservar los valores de autenticación OAuth cifrados en el archivo especificado.
• InitiateOAuth: Establézcalo en ACTUALIZAR.

Conectarse a datos

Después de generar el archivo de configuración de OAuth, configure las siguientes propiedades para conectarse a los datos:

• OAuthSettingsLocation: Establézcalo en el archivo que contiene los valores de autenticación de OAuth cifrados. Asegúrese de que este archivo otorgue permisos de lectura y escritura al proveedor para habilitar la actualización automática del token de acceso.
• InitiateOAuth: Establézcalo en ACTUALIZAR.

Transferir configuración de OAuth

Siga los pasos a continuación para instalar el conector en otra máquina, autenticar y luego transferir los valores de OAuth resultantes.

En una segunda máquina, instale el conector y conéctese con el siguiente conjunto de propiedades:

• OAuthSettingsLocation: establezca esto en un archivo de texto grabable.
• InitiateOAuth: Establézcalo en GETANDREFRESH.
• OAuthClientId: establezca esto en la ID del cliente en la configuración de su aplicación.
• OAuthClientSecret: establezca esto en el secreto del cliente en la configuración de su aplicación.
• CallbackURL: establezca esto en la URL de devolución de llamada en la configuración de su aplicación.

Pruebe la conexión para autenticarse. Los valores de autenticación resultantes se escriben, se cifran, en la ruta especificada por OAuthSettingsLocation. Una vez que haya probado con éxito la conexión, copie el archivo de configuración de OAuth en su máquina sin periféricos. En la máquina sin periféricos, configure las siguientes propiedades de conexión para conectarse a los datos:

• InitiateOAuth: Establézcalo en ACTUALIZAR.
• OAuthSettingsLocation: establezca esto en la ruta a su archivo de configuración de OAuth. Asegúrese de que este archivo otorgue permisos de lectura y escritura al conector para habilitar la actualización automática del token de acceso.

Creación de una Aplicación OAuth Personalizada

Hay dos métodos de autenticación disponibles para conectarse a eBay: usar un token generado para acceder solo a datos personales o usar tokens que permitan a otros usuarios acceder a sus propios datos. Ambos métodos requieren que te unas al Programa de desarrolladores de eBay.

Regístrese y Obtenga Sus Claves

Después de unirse al Programa de desarrolladores de eBay, puede obtener los siguientes valores en la página Claves de la aplicación (Mi cuenta -> Claves de acceso a la aplicación).

1. OAuthClientId (ID de la aplicación)
2. DevID
3. OAuthClientSecret (ID de certificado)

Uso de un Token Personal

Si está trabajando con su propia cuenta, siga los pasos a continuación para generar un token:

1. Vaya a su panel de cuenta de desarrollador y abra la página Claves de aplicación.

2. En la fila ID de aplicación (ID de cliente) para el conjunto de claves que desea usar, haga clic en Tokens de usuario.

   Use claves de producción si está buscando artículos reales o listando artículos reales en el sitio de eBay en vivo. Utilice las claves de la zona de pruebas si está creando listados de prueba en la zona de pruebas.

3. Haga clic en Obtener un token de usuario aquí e inicie sesión con las credenciales para su sandbox o su cuenta de eBay de producción. Asegúrese de establecer también 'Su URL aceptada de autenticación' en su URL de devolución de llamada preferida. Dado que eBay requiere un URI de redireccionamiento seguro (https), para las aplicaciones de escritorio puede configurarlo en: https://localhost:33333 o para https://oauth.cdata.com/oauth/ para aplicaciones web.

Nota: Para habilitar la autenticación OAuth 2.0, debe marcar la casilla de verificación 'OAuth habilitado' en la pestaña abierta 'Su configuración de inicio de sesión de eBay '. Si no está habilitado, solo se admitirá el método de autenticación Auth'N'Auth.

A continuación, puede establecer las siguientes propiedades de conexión y conectarse:

• DevID: Establézcalo en el ID de desarrollador de su conjunto de claves.
• OAuthClientId: establezca esto en la ID de la aplicación (ID del cliente) de su conjunto de claves.
• OAuthClientSecret: establezca esto en el ID de certificado (secreto del cliente) de su conjunto de claves.
• SiteID: Establézcalo en el ID del sitio de eBay. De forma predeterminada, es 0 (el sitio de EE. UU.).
• OAuthAccessToken: establezca esto en el token personal que generó desde el panel de control de su cuenta de desarrollador.
• UseSandbox: establezca esto en verdadero si está utilizando una cuenta de espacio aislado.
• AuthScheme: establezca esto en "OAuth" si desea utilizar OAuth 2.0 como método de autenticación. Si se establece en "AuthNAuth" o si no se especifica, se utilizará Auth'n'Auth para la autenticación.
• CallbackURL: Establézcalo en http://localhost:33333 u otro puerto de su elección. (Si no ha configurado el https://oauth.cdata.com/oauth/ URL de redirección, asegúrese de estar utilizando el mismo puerto que la URL de redirección configurada en su aplicación de eBay )

Obtención de Tokens para Aplicaciones con Múltiples Usuarios

eBay implementa el estándar de autenticación OAuth, que puedes usar para permitir que otros usuarios accedan a sus propios datos.

OAuth requiere que el usuario que se autentica interactúe con eBay usando el navegador. El conector facilita esto de varias maneras, como se describe en las siguientes secciones.

Configurar una Aplicación OAuth

Siga los pasos a continuación para configurar el flujo de consentimiento del usuario:

1. Vaya a su panel de cuenta de desarrollador y abra la página Claves de aplicación.
2. En la fila ID de aplicación (ID de cliente) de su aplicación, haga clic en Fichas de usuario.
3. Haga clic en Obtener un token de usuario aquí e inicie sesión con las credenciales para su sandbox o su cuenta de eBay de producción. Asegúrese de establecer también 'Su URL aceptada de autenticación' en su URL de devolución de llamada preferida. Dado que eBay requiere un URI de redireccionamiento seguro (https), para las aplicaciones de escritorio puede configurarlo en: https://localhost:33333 o para https://oauth.cdata.com/oauth/ para aplicaciones web.

Nota: Para habilitar la autenticación OAuth 2.0, debe marcar la casilla de verificación 'OAuth habilitado' en la pestaña abierta 'Su configuración de inicio de sesión de eBay '. Si no está habilitado, solo se admitirá el método de autenticación Auth'N'Auth.

Autenticarse en Ebay Desde una Aplicación de Escritorio

Después de configurar las siguientes propiedades de conexión, está listo para conectarse:

• DevID: Establézcalo en el ID de desarrollador de su conjunto de claves.
• OAuthClientId: establezca esto en la ID de la aplicación (ID del cliente) de su conjunto de claves.
• OAuthClientSecret: establezca esto en el ID de certificado (secreto del cliente) de su conjunto de claves.
• RuName: establezca esto en el nombre de URL de redireccionamiento en el token de eBay a través de su sección de aplicación de la página de tokens de usuario.
• SiteID: Establézcalo en el ID del sitio de eBay. De forma predeterminada, es 0 (el sitio de EE. UU.).
• CallbackURL: Establézcalo en http://localhost:33333 u otro puerto de su elección. (Si no ha configurado el https://oauth.cdata.com/oauth/ URL de redirección, asegúrese de estar utilizando el mismo puerto que la URL de redirección configurada en su aplicación de eBay )
• InitiateOAuth: Establézcalo en GETANDREFRESH.
• UseSandbox: establezca esto en verdadero si está utilizando una cuenta de espacio aislado.
• AuthScheme: establezca esto en "OAuth" si desea utilizar OAuth 2.0 como método de autenticación. Si se establece en "AuthNAuth" o si no se especifica, se utilizará Auth'n'Auth para la autenticación.

Cuando se conecta, el conector abre el extremo OAuth o Auth and Auth en su navegador predeterminado. Inicie sesión y otorgue permisos a la aplicación. Luego, el conector completa el proceso de autenticación:

1. Extrae el token y autentica las solicitudes.
2. Guarda los valores de OAuth en OAuthSettingsLocation para persistir a través de las conexiones.

Autenticarse en Ebay Desde una Aplicación Web

Para obtener el token de acceso, establezca las siguientes propiedades de conexión:

• DevID: establezca esto en la ID del desarrollador en su conjunto de claves.
• OAuthClientId: establezca esto en la ID de la aplicación (ID del cliente) en su conjunto de claves.
• OAuthClientSecret: establezca esto en el ID de certificado (secreto del cliente) en su conjunto de claves.
• SiteID: Establézcalo en el ID del sitio de eBay. Por defecto es 0, (EE. UU.)
• RuName: establezca esto en el nombre de URL de redireccionamiento en el token de eBay a través de su sección de aplicación de la página de tokens de usuario.
• UseSandbox: establezca esto en verdadero si está utilizando una cuenta de espacio aislado.
• AuthScheme: establezca esto en "OAuth" si desea utilizar OAuth 2.0 como método de autenticación. Si se establece en "AuthNAuth" o si no se especifica, se utilizará Auth'n'Auth para la autenticación.

Cuando se conecta a través de una aplicación web, o si el conector no está autorizado para abrir una ventana del navegador, debe intercambiar una ID de sesión (si está usando Auth y Auth como método de autenticación) o un código verificador (si está usando OAuth 2.0) para el OAuthAccessToken:

1. Configure el UseSandbox propiedad de conexión a verdadero si está utilizando una cuenta de espacio aislado.
2. Configure el AuthScheme propiedad de conexión a "OAuth" si desea usar la autenticación OAuth, o establecer en "AuthNAuth" para usar Auth'n'Auth para la autenticación.
3. Llame a GetOAuthAuthorizationURL. El procedimiento almacenado* devuelve la URL al extremo de OAuth.
4. Inicie sesión y autorice la aplicación. Se le redirigirá a la URL de devolución de llamada.
5. Llame a GetOAuthAccessToken. Establezca el parámetro AuthMode en "WEB". Si usa OAuth para autenticarse, establezca el valor del Verificador en el valor del código devuelto en el paso anterior. De lo contrario, si usa Auth y Auth, establezca el parámetro SessionId en el parámetro SessionId devuelto en la cadena de consultar de la URL de devolución de llamada del paso anterior.

Para realizar solicitudes a eBay, establezca OAuthAccessToken devuelto además de las propiedades de conexión anteriores. Colocar InitiateOAuth a REFRESH para actualizar automáticamente el token de acceso cuando caduca.

Notas Importantes

Procedimientos Almacenados

• Las funciones de procedimientos almacenados descritas en esta documentación no se admiten actualmente.
• Debido a que los procedimientos almacenados no se admiten actualmente, cualquier característica que dependa de los procedimientos almacenados tampoco se admite actualmente.

Archivos de Configuración y Sus Rutas

• Todas las referencias a la adición de archivos de configuración y sus rutas se refieren a archivos y ubicaciones en Harmony Agente donde está instalado el conector. Estas rutas deben ajustarse según corresponda según el agente y el sistema operativo. Si se utilizan varios agentes en un grupo de agentes, se requerirán archivos idénticos en cada agente.

Características Avanzadas

Esta sección detalla una selección de funciones avanzadas del conector de eBay.

Vistas definidas por el usuario

El conector le permite definir tablas virtuales, llamadas vistas definidas por el usuario, cuyo contenido se decide mediante una consultar preconfigurada. Estas vistas son útiles cuando no puede controlar directamente las consultas que se envían a los controladores. Consulte Vistas definidas por el usuario para obtener una descripción general de la creación y configuración de vistas personalizadas.

Configuración SSL

Usar Configuración SSL para ajustar cómo el conector maneja las negociaciones de certificados TLS/SSL. Puede elegir entre varios formatos de certificado; ver el SSLServerCert propiedad en "Opciones de cadena de conexión" para obtener más información.

Apoderado

Para configurar el conector mediante Configuración de proxy de Agente Privado, Selecciona el Use Proxy Settings casilla de verificación en la pantalla de configuración de la conexión.

Vistas Definidas por el Usuario

El Jitterbit Connector para eBay te permite definir una tabla virtual cuyos contenidos se deciden mediante una consultar preconfigurada. Estas se denominan Vistas definidas por el usuario, que son útiles en situaciones en las que no puede controlar directamente la consultar que se envía al controlador, por ejemplo, cuando se utiliza el controlador de Jitterbit. Las vistas definidas por el usuario se pueden utilizar para definir predicados que siempre se aplican. Si especifica predicados adicionales en la consultar a la vista, se combinan con la consultar ya definida como parte de la vista.

Hay dos formas de crear vistas definidas por el usuario:

• Cree un archivo de configuración con formato JSON que defina las vistas que desea.
• Declaraciones DDL.

Definición de Vistas Utilizando un Archivo de Configuración

Las vistas definidas por el usuario se definen en un archivo de configuración con formato JSON llamado UserDefinedViews.json. El conector detecta automáticamente las vistas especificadas en este archivo.

También puede tener múltiples definiciones de vista y controlarlas usando UserDefinedViews propiedad de conexión. Cuando utiliza esta propiedad, el conector solo ve las vistas especificadas.

Este archivo de configuración de vista definida por el usuario tiene el siguiente formato:

• Cada elemento raíz define el nombre de una vista.
• Cada elemento raíz contiene un elemento hijo, llamado query, que contiene la consultar SQL personalizada para la vista.

Por ejemplo:

{
    "MyView": {
        "query": "SELECT * FROM ItemListing WHERE MyColumn = 'value'"
    },
    "MyView2": {
        "query": "SELECT * FROM MyTable WHERE Id IN (1,2,3)"
    }
}

Utilizar el UserDefinedViews propiedad de conexión para especificar la ubicación de su archivo de configuración JSON. Por ejemplo:

"UserDefinedViews", "C:\Users\yourusername\Desktop\tmp\UserDefinedViews.json"

Esquema para Vistas Definidas por el Usuario

Las vistas definidas por el usuario se exponen en UserViews esquema por defecto. Esto se hace para evitar que el nombre de la vista entre en conflicto con una entidad real en el modelo de datos. Puede cambiar el nombre del esquema utilizado para UserViews configurando UserViewsSchemaName propiedad.

Trabajar con Vistas Definidas por el Usuario

Por ejemplo, una instrucción SQL con una vista definida por el usuario llamada UserViews.RCustomers solo enumera clientes en Raleigh:

SELECT * FROM Customers WHERE City = 'Raleigh';

Un ejemplo de una consultar al controlador:

SELECT * FROM UserViews.RCustomers WHERE Status = 'Active';

Dando como resultado la consultar efectiva a la fuente:

SELECT * FROM Customers WHERE City = 'Raleigh' AND Status = 'Active';

Ese es un ejemplo muy simple de una consultar a una vista definida por el usuario que es efectivamente una combinación de la consultar de vista y la definición de vista. Es posible componer estas consultas en patrones mucho más complejos. Todas las operaciones de SQL están permitidas en ambas consultas y se combinan cuando corresponde.

Configuración SSL

Personalización de la Configuración SSL

De forma predeterminada, el conector intenta negociar SSL/TLS comparando el certificado del servidor con el almacén de certificados de confianza del sistema.

Para especificar otro certificado, consulte SSLServerCert propiedad de los formatos disponibles para hacerlo.

Modelo de Datos

Jitterbit Connector for eBay modela entidades en la API de eBay como tablas, vistas y procedimientos almacenados. Estos se definen en archivos de esquema, que son archivos de configuración simples basados en texto.

Las limitaciones y los requisitos de la API se documentan en esta sección; puedes usar el SupportEnhancedSQL función, configurada de forma predeterminada, para eludir la mayoría de estas limitaciones.

Mesas

Jitterbit Connector para eBay modela listados de artículos en tablas para que puedan consultarse, actualizarse y eliminarse fácilmente. Puede enumerar artículos en su tienda eBay llamando al procedimiento almacenado AddItem.

Puntos de vista

Puntos de vista son tablas que no se pueden modificar. Normalmente, los datos de solo lectura se muestran como vistas.

Procedimientos almacenados

NOTE: Los procedimientos almacenados no se admiten actualmente. Consulte la nota anterior para detalles.

Procedimientos almacenados son interfaces similares a funciones para la fuente de datos. Se pueden utilizar para buscar, actualizar y modificar información en la fuente de datos.

Mesas

El conector modela los datos de eBay en una lista de tablas que se pueden consultar mediante instrucciones SQL estándar.

Generalmente, consultar las tablas de eBay es lo mismo que consultar una tabla en una base de datos relacional. A veces hay casos especiales, por ejemplo, incluir una determinada columna en la cláusula WHERE puede ser necesario para obtener datos para ciertas columnas de la tabla. Esto suele ser necesario para situaciones en las que se debe realizar una solicitud separada para cada fila para obtener ciertas columnas. Estos tipos de situaciones están claramente documentados en la parte superior de la página de la tabla vinculada a continuación.

Conector Jitterbit para Tablas de Ebay

ArtículoListado

Actualice, elimine y consultar Listados de artículos para vendedores.

Información Específica de la Tabla

Seleccionar

La siguiente consultar recupera artículos del vendedor. De forma predeterminada, esta consultar devuelve elementos que se agregaron en los últimos 100 días.

SELECT * FROM ItemListing

ItemListing es la única tabla que admite ORDER BY. Solo se pueden usar dos columnas para ordenar: StartTime y EndTime. La siguiente consultar recupera los elementos que finalizan entre el tiempo especificado, ordenados por el elemento que finaliza antes.

SELECT * FROM ItemListing WHERE EndTimeFrom='2016-01-25' AND EndTimeTo='2016-02-05' ORDER BY EndTime

Insertar

AddItem procedimiento almacenado* proporciona la funcionalidad para agregar un nuevo elemento.

Actualizar

Las entradas que se requieren para una actualización dependen del tipo de elemento y su categoría. Se debe proporcionar al menos el ItemId y una propiedad del elemento en una actualización.

UPDATE ItemListing SET Title='My Awesome Item' WHERE ItemId='123456789'

Después de que se haya vendido un artículo en un listado de cantidades múltiples, los vendedores no pueden cambiar los valores en los campos Título, Categoría principal, Categoría secundaria, Duración del listado y Tipo de listado. Sin embargo, todos los demás campos siguen siendo editables.

Borrar

Se deben especificar ItemId y EndingReason para eliminar un elemento.

DELETE FROM ItemListing WHERE ItemId='123456789' AND  EndingReason='LostOrBroken'

Columnas

Pseudo-Columnas

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Variaciones del Artículo

Las variaciones de artículos son varios artículos similares (pero no idénticos) en un solo listado de precio fijo. Por ejemplo, una lista de camisetas podría contener varios artículos de la misma marca que varían según el color y el tamaño; cada variación especificaría una combinación de uno de estos colores y tamaños. Cada variación puede tener una cantidad y precio diferente. Puede comprar varios artículos de una variación al mismo tiempo. (Es decir, una línea de pedido puede contener varios artículos de una sola variación).

Información Específica de la Tabla

Seleccionar

Se debe especificar un ID de artículo para obtener variaciones del artículo que representa este ID.

SELECT * FROM ItemVariations WHERE ItemId = '110187147205'

Insertar

Los campos que se requieren para la inserción son ItemId, VariationSpecificsAgregate, StartPrice y Cantidad. VariationSpecificsAggregate debe contener detalles de variación estructurados en formato XML. Por ejemplo, el siguiente VariationSpecificsAggregate agrega un elemento azul grande:

<NameValueList>
  <Name>Color</Name>
  <Value>Blue</Value>
</NameValueList>
<NameValueList>
  <Name>Size</Name>
  <Value>L</Value>
</NameValueList>

La siguiente consultar agrega una variación de un elemento azul grande con un precio inicial de 15 y una cantidad de 100.

INSERT INTO ItemVariations (ItemId,VariationSpecificsAggregate,Quantity,StartPrice) values ('110188946596','<NameValueList><Name>Color</Name><Value>Blue</Value></NameValueList><NameValueList><Name>Size</Name><Value>L</Value></NameValueList>','100','15')

Actualizar

ItemId y VariationSpecificsAgregate son necesarios para actualizar una variación. Opcionalmente, se pueden proporcionar otros detalles para las variaciones, como StartPrice y Cantidad. VariationSpecificsAgregate debe estar en formato XML y debe contener todos los detalles que identifican una variación.

UPDATE ItemVariations SET Quantity='5' WHERE ItemId='110188946596' AND VariationSpecificsAggregate='<NameValueList><Name>Color</Name><Value>Blue</Value></NameValueList><NameValueList><Name>Size</Name><Value>L</Value></NameValueList>'

Borrar

ItemId y VariationSpecificsAgregate son necesarios para eliminar una variación.

DELETE FROM ItemVariations WHERE ItemId='110188946596' AND VariationSpecificsAggregate='<NameValueList><Name>Color</Name><Value>Blue</Value></NameValueList><NameValueList><Name>Size</Name><Value>L</Value></NameValueList>'

Columnas

Tareas

Recupera todas las tareas para el mercado que especifique mediante el parámetro de consultar MarketplaceId.

Seleccionar

FeedType es un filtro obligatorio en la consultar Seleccionar. Puede seguir la consultar a continuación para obtener los valores requeridos a través de SQL:

SELECT * FROM [Tareas] WHERE FeedType = 'LMS_ADD_ITEM'

Algunos de los campos se nombran con el sufijo Aggr. Estos campos muestran el contenido de la etiqueta JSON con el mismo nombre que se devuelve desde el extremo de la API.

Insertar

Se requieren FeedType, MarketplaceID y SchemaVersion en la consultar de inserción. Puede seguir la consultar a continuación para obtener los valores requeridos a través de SQL:

INSERT INTO [Tareas] (FeedType, MarketplaceID, SchemaVersion) VALUES ('LMS_ADD_ITEM', 'EBAY_US', '1149')

Columnas

Pseudo-Columnas

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Puntos de Vista

Las vistas se componen de columnas y pseudocolumnas. Las vistas son similares a las tablas en la forma en que se representan los datos; sin embargo, las vistas no admiten actualizaciones. Las entidades que se representan como vistas suelen ser entidades de solo lectura. A menudo, un procedimiento almacenado* está disponible para actualizar los datos si dicha funcionalidad es aplicable a la fuente de datos.

Las consultas se pueden ejecutar contra una vista como si fuera una tabla normal, y los datos que regresan son similares en ese sentido. Para obtener más información sobre las tablas y los procedimientos almacenados, vaya a sus entradas correspondientes en este documento de ayuda.

Conector Jitterbit para Vistas de Ebay

Postores

Consulta a los usuarios de eBay que pujan por un listado específico, independientemente de si el listado ha finalizado.

Información Específica de la Tabla

Seleccionar

Las únicas columnas admitidas para el filtrado son ItemId y ListMode. Se debe especificar un ItemId para recuperar datos de esta vista.

Select * FROM Bidders WHERE ItemId = '1234567'

Select * FROM Bidders WHERE ItemId = '1234567' And ListMode = 'EndedListing'

Columnas

Pseudo-Columnas

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Categorías

Consulta las categorías de eBay.

Información Específica de la Tabla

Seleccionar

Las únicas columnas admitidas para el filtrado son CategorySiteId, LevelLimit y CategoryParentId.

SELECT * FROM Categories.

Puede devolver más información sobre una categoría específica y sus subcategorías con la siguiente consultar:

SELECT * FROM Categories WHERE LevelLimit = '2' AND CategoryParent = '267'

Columnas

Pseudo-Columnas

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

CategoríaCaracterísticas

Consulta la configuración admitida por las categorías de eBay.

Información Específica de la Tabla

Seleccionar

Las únicas columnas admitidas para el filtrado son CategoryId, LevelLimit, AllFeaturesForCategory y FeatureId. Si no se especifica CategoryId, se devolverán todas las características de las categorías de nivel superior.

SELECT * FROM CategoryFeatures                          

SELECT * FROM CategoryFeatures WHERE LevelLimit='2' And CategoryId='277'

Columnas

Pseudo-Columnas

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

CategoríaEspecificaciones

Lista de compatibilidad de artículos de consulta para vendedores.

Columnas

Países

Muestra el código de país y el nombre asociado de los países admitidos por el sistema de eBay, independientemente del sitio especificado en la solicitud.

Columnas

Pseudo-Columnas

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Monedas

Consulta las monedas admitidas en eBay.

Información Específica de la Tabla

Seleccionar

Devuelve todas las monedas admitidas. No se admiten columnas para el filtrado.

SELECT * FROM Currencies 

Columnas

Pseudo-Columnas

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Resumen de DSRS

Consulta la información de calificación de los informes resumidos de DSR.

Información Específica de la Tabla

Seleccionar

La columna JobId debe especificarse para recuperar datos de esta vista.

SELECT * FROM DSRSummary WHERE JobId = '123456' 

Columnas

Políticas de Cumplimiento

Recupera todas las políticas de cumplimiento configuradas para el mercado que especifique mediante el parámetro de consultar MarketplaceId.

Seleccionar

MarketplaceId es un filtro obligatorio en la consultar Seleccionar. Puede seguir la consultar a continuación para obtener los valores requeridos a través de SQL:

SELECT * FROM FulfillmentPolicies WHERE MarketplaceId='EBAY_US'

Algunos de los campos se nombran con el sufijo Aggr. Estos campos muestran el contenido de la etiqueta JSON con el mismo nombre que se devuelve desde el extremo de la API.

Columnas

Mejor Postor

Consulta al mejor postor de los usuarios de eBay que pujan por un listado específico, independientemente de si el listado ha finalizado.

Información Específica de la Tabla

Seleccionar

Las únicas columnas admitidas para el filtrado son ItemId y ListMode. Se debe especificar un ItemId para recuperar datos de esta vista.

Select * FROM HighestBidder WHERE ItemId = '1234567'

Select * FROM HighestBidder WHERE ItemId = '1234567' And ListMode = 'EndedListing'

Columnas

Pseudo-Columnas

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Lista de Compatibilidad de Elementos

Consulte las categorías de compatibilidad y los posibles valores de compatibilidad para un elemento específico.

Columnas

Pseudo-Columnas

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

ArtículoEnvío

Consulte los detalles pertinentes a uno o más artículos para los que el vendedor ha ofrecido el envío calculado, como la dimensión del paquete, el peso y los costos de embalaje/manejo.

Información Específica de la Tabla

Seleccionar

Los filtros DestinationCountryCode y ItemId deben especificarse para recuperar datos de esta vista. Además, se puede usar el filtro Cantidad vendida, pero es opcional.

SELECT * FROM ItemShipping WHERE ItemId='110177686055' AND DestinationCountryCode='US'

Columnas

Pseudo-Columnas

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Características del Artículo

Consulta los detalles del artículo para un artículo específico.

Columnas

Pseudo-Columnas

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Transacciones de Artículos

Consulta la información de la línea de pedido (transacción) de un listado específico. Para las listas de subastas, las líneas de pedido no se crean hasta que la subasta finaliza con un postor ganador, o si la función ¡Cómpralo ya! está habilitada para la lista y el comprador la utiliza para comprar el artículo. Para los listados de precio fijo, las líneas de pedido se crean después de que un comprador se haya comprometido a comprar los artículos.

Información Específica de la Tabla

Seleccionar

La columna ItemId debe especificarse para recuperar la información de la transacción.

Obtenga todas las transacciones relacionadas con un artículo específico:

SELECT * FROM ItemTransactions WHERE ItemId='012345678901'

Filtre el número de transacciones devueltas especificando el número de días en el pasado:

SELECT * FROM ItemTransactions WHERE ItemId='012345678901' AND NumberOfDays='25'

Obtenga información para una transacción específica que se realizó para un artículo específico:

SELECT * FROM ItemTransactions WHERE ItemId='012345678901' AND TransactionId='0'

Columnas

Pseudo-Columnas

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Elementos Más Vistos

Consulte los elementos con el mayor número de visitas para todo el sitio o para una categoría específica. Los elementos principales están determinados por los totales de Watch Count del día anterior. La clasificación de los elementos más vistos se calcula con la última información de Watch Count.

Información Específica de la Tabla

Seleccionar

Las únicas columnas que se pueden usar para filtrar son CategoryId, AffiliateCustomId, AffiliateNetworkId y AffiliateTrackingId. Estos filtros son opcionales.

SELECT * FROM MostWatchedItems

SELECT * FROM MostWatchedItems WHERE CategoryId = '277' 

Columnas

Pseudo-Columnas

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

PedidoPagos

Consulta todos los pagos de los pedidos, en los que el usuario autenticado es comprador o vendedor. Por defecto, solo se devuelven los datos de pago de los pedidos realizados en los últimos 90 días. Los detalles de pago de pedidos con más de 90 días se pueden recuperar especificando OrderId.

Ver Información Específica

Seleccionar

Ejemplos de consulta de la vista OrderPayments:

SELECT * FROM OrderPayments WHERE ModTimeFrom = '2/22/2018'

SELECT * FROM OrderPayments WHERE NumberOfDays = '30'

Columnas

Pseudo-Columnas

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Pedidos

Consulta todos los pedidos en los que el usuario autenticado sea el comprador o el vendedor. Por defecto, solo se devuelven los pedidos realizados en los últimos 90 días. Los pedidos de más de 90 días se pueden recuperar especificando OrderId.

Ver Información Específica

Seleccionar

Ejemplos de consulta de la vista Pedidos:

SELECT * FROM Orders WHERE OrderId = '110276240386-28854859001'

SELECT * FROM Orders WHERE OrderId IN ('110276240386-28854859001','110277719772-28859911001')

SELECT * FROM Orders WHERE CreateTimeFrom = '2018-02-10' AND CreateTimeTo = '2018-03-16'

SELECT * FROM Orders WHERE OrderStatus = 'Active'

SELECT * FROM Orders WHERE NumberOfDays = '26'

Columnas

Pseudo-Columnas

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

PedidoEnvío

Consultar detalles de envío de los pedidos en los que el usuario autenticado es comprador o vendedor. De forma predeterminada, solo se devuelven los detalles de envío de los pedidos realizados en los últimos 90 días. Los detalles de envío de pedidos con más de 90 días se pueden recuperar especificando OrderId.

Ver Información Específica

Seleccionar

Ejemplos de consulta de la vista OrderShipping:

SELECT * FROM OrderShipping WHERE NumberOfDays = '30'

SELECT * FROM OrderShipping WHERE CreateTimeFrom = '2018-02-10' AND CreateTimeTo = '2018-03-16'

Columnas

Pseudo-Columnas

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Políticas de Pago

Recupera todas las políticas de pago configuradas para el mercado que especifique mediante el parámetro de consultar MarketplaceId.

Seleccionar

MarketplaceId es un filtro obligatorio en la consultar Seleccionar. Puede seguir la consultar a continuación para obtener los valores requeridos a través de SQL:

SELECT * FROM PaymentPolicies WHERE MarketplaceId='EBAY_US'

Algunos de los campos se nombran con el sufijo Aggr. Estos campos muestran el contenido de la etiqueta JSON con el mismo nombre que se devuelve desde el extremo de la API.

Columnas

Políticas de Devolución

Recupera todas las políticas de devolución configuradas para el mercado que especifique mediante el parámetro de consultar MarketplaceId.

Seleccionar

MarketplaceId es un filtro obligatorio en la consultar Seleccionar. Puede seguir la consultar a continuación para obtener los valores requeridos a través de SQL:

SELECT * FROM ReturnPolicies WHERE MarketplaceId='EBAY_US'

Algunos de los campos se nombran con el sufijo Aggr. Estos campos muestran el contenido de la etiqueta JSON con el mismo nombre que se devuelve desde el extremo de la API.

Columnas

EnvíoTransportistas

Consulta de transportistas compatibles con el sitio especificado.

Columnas

Pseudo-Columnas

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

EnvíoCategorías

Una categoría de servicio de envío compatible con el sitio.

Columnas

Pseudo-Columnas

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Ubicaciones de Envío

Enumera las regiones y ubicaciones admitidas por los servicios de envío de eBay. Devuelve todas las ubicaciones de envío admitidas por eBay, independientemente del sitio especificado en la solicitud.

Columnas

Pseudo-Columnas

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Servicios de Transporte Marítimo

Consulte los servicios de envío admitidos por el sitio de eBay especificado.

Información Específica de la Tabla

Seleccionar

La siguiente consultar recupera todos los servicios de envío disponibles. No hay filtros admitidos para esta vista.

SELECT * FROM ShippingServices

Columnas

Pseudo-Columnas

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Sitios

Enumera todos los sitios de eBay disponibles y sus números SiteID asociados.

Columnas

Pseudo-Columnas

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Los Productos Más Vendidos

Consulte sus productos más vendidos de eBay.

Información Específica de la Tabla

Seleccionar

Las únicas columnas que se pueden usar para filtrar son AffiliateCustomId, AffiliateNetworkId y AffiliateTrackingId. Estos filtros son opcionales.

SELECT * FROM TopSellingProducts

SELECT * FROM TopSellingProducts WHERE AffiliateCustomId='12345'

Columnas

Pseudo-Columnas

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

TransacciónPagos

Consulta todos los pagos de las transacciones en las que el usuario autenticado es comprador o vendedor. Por defecto, solo se devuelven los pagos de las transacciones realizadas en los últimos 90 días. Los pagos de las transacciones en pedidos de más de 90 días se pueden recuperar especificando OrderIds.

Ver Información Específica

Seleccionar

Ejemplos de consulta de la vista TransactionPayments:

SELECT * FROM TransactionPayments WHERE OrderRole = 'Seller'

SELECT * FROM TransactionPayments WHERE OrderId = '110277719772-28859911001'

Columnas

Pseudo-Columnas

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Actas

Consulta todas las transacciones en las que el usuario autenticado es el comprador o el vendedor. Por defecto, solo se devuelven las transacciones de los pedidos realizados en los últimos 90 días. Las transacciones de pedidos de más de 90 días se pueden recuperar especificando OrderId.

Ver Información Específica

Seleccionar

Ejemplos de consulta de la vista Transacciones.

Select * FROM Transactions WHERE OrderRole = 'Seller'

Select * FROM Transactions WHERE OrderId = '110276240386-28854859001'

Select * FROM Transactions WHERE CreateTimeFrom = '2/10/2018' And CreateTimeTo = '3/16/2018'

Columnas

Pseudo-Columnas

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

TransacciónEnvío

Consulta los detalles de envío de las transacciones en las que el usuario autenticado es el comprador o el vendedor. De forma predeterminada, solo se devuelven los detalles de envío de la transacción realizada en los últimos 90 días. Los detalles de envío de las transacciones en pedidos de más de 90 días se pueden recuperar especificando OrderIds.

Ver Información Específica

Seleccionar

Ejemplos de consulta de la vista TransactionShipping:

SELECT * FROM TransactionShipping WHERE ModTimeFrom = '2/22/2018' And ModTimeTo = '3/4/2018'

SELECT * FROM TransactionShipping WHERE OrderId = '110277719772-28859911001'

SELECT * FROM TransactionShipping WHERE OrderId IN ('110277719772-28859911001', '110276240386-28854859001')

Columnas

Pseudo-Columnas

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Procedimientos Almacenados

Procedimientos almacenados* están disponibles para complementar los datos disponibles del Modelo de datos. Puede ser necesario actualizar los datos disponibles desde una vista usando un procedimiento almacenado* porque los datos no proporcionan actualizaciones bidireccionales directas, similares a tablas. En estas situaciones, la recuperación de los datos se realiza utilizando la vista o tabla adecuada, mientras que la actualización se realiza llamando a un procedimiento almacenado. Procedimientos almacenados* toman una lista de parámetros y devuelven un conjunto de datos que contiene la colección de tuplas que constituyen la respuesta.

Conector Jitterbit para Procedimientos Almacenados de Ebay

Añadir Artículo

Cree y publique una nueva lista de artículos en un sitio de eBay.

Procedimiento Almacenado* Información Específica

Tras la creación exitosa de un Listado de artículos, se devuelve un ID de artículo en la respuesta junto con las tarifas estimadas para listar el artículo. Después de agregar un elemento, puede usar la tabla ItemListing para actualizar, eliminar y consultar.

Las entradas requeridas para agregar cualquier artículo son las siguientes: Título, Descripción, Id. de categoría, Precio de inicio, Id. de condición, País, Moneda, Tiempo máximo de envío, Duración del listado, Tipo de listado, Método de pago, Dirección de correo electrónico de PayPal, Cantidad, Ubicación y Opción de devoluciones aceptadas.

También debe especificar varias entradas requeridas para seleccionar un tipo de envío: Plana o Calculada. Ambos tipos de envío requieren que se especifique un ShippingService.

Agregar un elemento

Puede seguir el procedimiento a continuación para obtener los valores requeridos y agregar un elemento a través de SQL:

1. Utilice la vista Categorías para seleccionar una categoría de nivel superior; por ejemplo, Libros. Puedes usar la siguiente consultar:

   SELECT * FROM Categories
   

2. Utilice la vista Categorías para seleccionar una categoría de hoja; por ejemplo, ficción y literatura. Se requiere un ID de categoría de hoja para agregar un artículo. Puede utilizar una consultar como la siguiente:

   SELECT * FROM Categories WHERE CategoryParentId='267'
   

3. Utilice la vista Servicios de envío para seleccionar un Servicio de envío. El valor de la columna ValidForSellingFlow debe ser verdadero; de lo contrario, esa opción de servicio de envío en particular ya no es válida y no se puede ofrecer a los compradores a través de un listado.

Selección de envío fijo

Se requieren las siguientes entradas para el tipo de envío Flat: ShippingType, ShippingService, ShippingServicePriority y ShippingServiceCost.

Selección de envío calculado

El tipo de envío Calculado requiere información adicional relacionada con las estadísticas del paquete. Se requieren las siguientes entradas para este tipo de envío: ShippingType, WeightMajor, WeightMinor, OriginatingPostalCode, ShippingService y ShippingServicePriority.

Note: Este procedimiento hace uso de indexed parameters. Estos parámetros de entrada se indican con un # carácter al final de sus nombres.

Los parámetros indexados facilitan el suministro de múltiples instancias de un solo parámetro como entradas para el procedimiento.

Supongamos que hay un parámetro de entrada llamado Param#. Ingrese múltiples instancias de un parámetro indexado como este:

EXEC ProcedureName Param#1 = "value1", Param#2 = "value2", Param#3 = "value3"

Entrada

Columnas del conjunto de resultados

Venta completa

Realice varias tareas después de la creación de un pedido de una sola línea o de varias líneas. Por ejemplo, complete una venta y deje comentarios.

Entrada

Columnas del conjunto de resultados

CreateDSRSummery

Recupere un informe de resumen de DSR que incluya la precisión de la descripción, la comunicación, el envío, etc. Esta información puede ayudar a los vendedores a determinar cómo las prácticas comerciales específicas pueden estar contribuyendo a puntajes de DSR más altos o más bajos.

Entrada

Columnas del conjunto de resultados

Crear informe

Comienza a procesar los datos para descargar un archivo de informe.

Entrada

Columnas del conjunto de resultados

GetOAuthAccessToken

Obtiene el token de acceso OAuth de eBay.

Entrada

Columnas del conjunto de resultados

GetOAuthAuthorizationURL

Obtiene la URL de autorización de eBay. Acceda a la URL devuelta en la salida en un navegador de Internet. Esto solicita el token de acceso que se puede utilizar como parte de la cadena de conexión a eBay.

Entrada

Columnas del conjunto de resultados

Obtener informe

Descarga un informe que se creó previamente con el procedimiento almacenado CreateReport. Para descargar el informe su estado debe ser Completado.

Entrada

Columnas del conjunto de resultados

RefreshOAuthAccessToken

Actualiza el token de acceso de OAuth utilizado para la autenticación con EBay.

Entrada

Columnas del conjunto de resultados

Establecer notas de usuario

Agregue, reemplace y elimine notas de Mi eBay para los artículos que se están rastreando en las áreas de Ventas y Compras de Mi eBay.

Note: Este procedimiento hace uso de indexed parameters. Estos parámetros de entrada se indican con un # carácter al final de sus nombres.

Los parámetros indexados facilitan el suministro de múltiples instancias de un solo parámetro como entradas para el procedimiento.

Supongamos que hay un parámetro de entrada llamado Param#. Ingrese múltiples instancias de un parámetro indexado como este:

EXEC ProcedureName Param#1 = "value1", Param#2 = "value2", Param#3 = "value3"

Entrada

Columnas del conjunto de resultados

Subir archivo

Sube un archivo a la cuenta de EBay.

Procedimiento almacenado* Información específica

Este procedimiento asocia el archivo especificado con el ID de tarea especificado y carga el archivo de entrada. Una vez cargado el archivo, comienza el procesamiento del archivo.

Las entradas requeridas para cargar un archivo son las siguientes: TaskID y FilePath.

Subir un archivo

Puede seguir el procedimiento a continuación para enviar un archivo de carga exitoso:

1. Utilice la tabla Tareas para crear una nueva Tarea. Puedes usar la siguiente consultar:

   INSERT INTO [Tareas] (FeedType, MarketplaceID, SchemaVersion) VALUES ('LMS_ADD_ITEM', 'EBAY_US', '1149')
   

2. Puede obtener el TaskID recién generado a partir de las claves generadas o utilizando la tabla Tareas nuevamente para seleccionar.

       Statement stat = conn.createStatement();
       stat.executeUpdate("INSERT INTO [Tareas] (FeedType, MarketplaceID, SchemaVersion) VALUES ('LMS_ADD_ITEM', 'EBAY_US', '1149')", Statement.RETURN_GENERATED_KEYS);
       ResultSet rs = stat.getGeneratedKeys();
       while (rs.next()) {
         for (int i = 1; i <= rs.getMetaData().getColumnCount(); i++) {
           System.out.println(rs.getMetaData().getColumnName(i) + "=" + rs.getString(i));
         }
   }
   

   o

   SELECT * FROM [Tareas] WHERE FeedType = 'LMS_ADD_ITEM' AND CreationDate > '2021-11-16 09:19:00'
   

3. Use este ID de tarea como entrada junto con FilePath del archivo que se va a cargar, en el procedimiento almacenado UploadFile.

       CallableStatement callableStatement = conn.prepareCall("UploadFile");
       callableStatement.setString("TaskID", "task-5-1XXXXX");
       callableStatement.setString("FilePath", "C:\Users\User\Documents\upload.csv");
   
       boolean ret = callableStatement.execute();
       if (!ret) {
         int count = callableStatement.getUpdateCount();
         if (count != -1) {
           System.out.println("Affected rows: " + count);
         }
       } else {
         ResultSet rs = callableStatement.getResultSet();
         while (rs.next()) {
           for (int i = 1; i <= rs.getMetaData().getColumnCount(); i++) {
             System.out.println(rs.getMetaData().getColumnName(i) + "=" + rs.getString(i));
           }
         }
   }
   

4. Entonces su archivo debería estar procesando. Para realizar un seguimiento del estado, puede ejecutar una consultar SELECCIONAR en la tabla Tareas con el TaskID y verificar la columna Estado.

   SELECT Status FROM [Tareas] WHERE TaskID = '{Generated Task ID}'
   

Entrada

Columnas del conjunto de resultados

Tablas del sistema

Puede consultar las tablas del sistema que se describen en esta sección para acceder a la información del esquema, la información sobre la funcionalidad del origen de datos y las estadísticas de operación lote.

Tablas de esquemas

Las siguientes tablas devuelven metadatos de la base de datos para eBay:

• sys_catalogs: enumera las bases de datos disponibles.
• sys_schemas: enumera los esquemas disponibles.
• sys_tablas: enumera las tablas y vistas disponibles.
• sys_tablecolumns: Describe las columnas de las tablas y vistas disponibles.
• procedimientos_sys: describe los procedimientos almacenados disponibles.
• parámetros_procedimiento_sys: Describe procedimiento almacenado* parámetros.
• sys_keycolumns: describe las claves principal y externa.
• índices_sys: Describe los índices disponibles.

Tablas de origen de datos

Las siguientes tablas devuelven información sobre cómo conectarse y consultar la fuente de datos:

• sys_connection_props: Devuelve información sobre las propiedades de conexión disponibles.
• sys_sqlinfo: describe las consultas SELECT que el conector puede descargar al origen de datos.

Consultar tablas de información

La siguiente tabla devuelve estadísticas de consultar para consultas de modificación de datos:

• identidad_sys: devuelve información sobre operaciones lote o actualizaciones individuales.

sys_catalogs

Enumera las bases de datos disponibles.

La siguiente consultar recupera todas las bases de datos determinadas por la cadena de conexión:

SELECT * FROM sys_catalogs

Columnas

sys_schemas

Enumera los esquemas disponibles.

La siguiente consultar recupera todos los esquemas disponibles:

SELECT * FROM sys_schemas

Columnas

sys_tables

Enumera las tablas disponibles.

La siguiente consultar recupera las tablas y vistas disponibles:

SELECT * FROM sys_tables

Columnas

sys_tablecolumns

Describe las columnas de las tablas y vistas disponibles.

La siguiente consultar devuelve las columnas y los tipos de datos de la tabla ItemListing:

SELECT ColumnName, DataTypeName FROM sys_tablecolumns WHERE TableName='ItemListing' 

Columnas

sys_procedures

Enumera los procedimientos almacenados disponibles.

La siguiente consultar recupera los procedimientos almacenados disponibles:

SELECT * FROM sys_procedures

Columnas

sys_procedureparameters

Describe procedimiento almacenado* parámetros.

La siguiente consultar devuelve información sobre todos los parámetros de entrada para el procedimiento almacenado AddItem:

SELECT * FROM sys_procedureparameters WHERE ProcedureName='AddItem' AND Direction=1 OR Direction=2

Columnas

sys_keycolumns

Describe las claves primarias y foráneas. La siguiente consultar recupera la clave principal de la tabla ItemListing:

SELECT * FROM sys_keycolumns WHERE IsKey='True' AND TableName='ItemListing'

Columnas

sys_foreignkeys

Describe las claves foráneas. La siguiente consultar recupera todas las claves foráneas que hacen referencia a otras tablas:

SELECT * FROM sys_foreignkeys WHERE ForeignKeyType = 'FOREIGNKEY_TYPE_IMPORT'

Columnas

sys_indexes

Describe los índices disponibles. Al filtrar en los índices, puede escribir consultas más selectivas con tiempos de respuesta de consultar más rápidos.

La siguiente consultar recupera todos los índices que no son claves principales:

SELECT * FROM sys_indexes WHERE IsPrimary='false'

Columnas

sys_connection_props

Devuelve información sobre las propiedades de conexión disponibles y las establecidas en la cadena de conexión.

Al consultar esta tabla, se debe usar la cadena de conexión de configuración:

jdbc:cdata:ebay:config:

Esta cadena de conexión le permite consultar esta tabla sin una conexión válida.

La siguiente consultar recupera todas las propiedades de conexión que se han establecido en la cadena de conexión o se han establecido a través de un valor predeterminado:

SELECT * FROM sys_connection_props WHERE Value <> ''

Columnas

sys_sqlinfo

Describe el procesamiento de consultar SELECT que el conector puede descargar al origen de datos.

Procesamiento de consultas en colaboración

Al trabajar con fuentes de datos que no admiten SQL-92, puede consultar la vista sys_sqlinfo para determinar las capacidades de consultar de las APIs subyacentes, expresadas en sintaxis SQL. El conector descarga la mayor cantidad posible del procesamiento de sentencias SELECT al servidor y luego procesa el resto de la consultar en la memoria.

Descubrimiento de las capacidades SELECT de la fuente de datos

A continuación se muestra un conjunto de datos de ejemplo de las capacidades de SQL. El siguiente conjunto de resultados indica la funcionalidad SELECT que el conector puede descargar en el origen de datos o en el lado del cliente del proceso. Su fuente de datos puede admitir sintaxis SQL adicional. Algunos aspectos de la funcionalidad SELECT se devuelven en una lista separada por comas si es compatible; de lo contrario, la columna contiene NO.