Detalhes da Conexão do Ebay¶

Introdução¶

Versão do conector

Esta documentação é baseada na versão 21.0.8257 do conector.

Começando¶

Suporte à versão do eBay

O conector permite uma visualização relacional de entidades das APIs Trading, FileTransfer, BulkData, Feedback e Merchandising.

Estabelecendo uma Conexão¶

Conectando-se às APIs do Ebay¶

Por padrão, o conector se conecta a ambientes de produção. Definir UseSandbox para true para usar uma conta sandbox do eBay.

Autenticação no Ebay¶

O eBay usa o padrão de autenticação OAuth 2.0 e o Auth'n'Auth, a autenticação tradicional usada pelas APIs do eBay. Para autenticar usando OAuth ou Auth'n'Auth, dependendo de como seu aplicativo está configurado, você precisará criar um aplicativo para obter o OAuthClientId, OAuthClientSecret, DevID, e CallbackURL propriedades de conexão. Consulte Usando autenticação OAuth para obter um guia de autenticação.

Usando Autenticação OAuth¶

OAuth requer que o usuário autenticado interaja com o eBay usando o navegador. O conector facilita isso de várias maneiras, conforme descrito abaixo.

Credenciais Personalizadas¶

Você precisará registrar um aplicativo para obter o OAuthClientId e OAuthClientSecret.

Criando um Aplicativo OAuth Personalizado¶

Consulte Criando um aplicativo OAuth personalizado para um procedimento.

Credenciais Personalizadas¶

Autenticação de Área de Trabalho com Seu Aplicativo OAuth¶

Siga as etapas abaixo para autenticar com as credenciais de um aplicativo OAuth personalizado. Consulte Criando um aplicativo OAuth personalizado.

Obtenha um Token de Acesso OAuth¶

Depois de definir o seguinte, você está pronto para se conectar:

• OAuthClientId: Defina isso como o ID do cliente nas configurações do aplicativo.
• OAuthClientSecret: Defina isso como o segredo do cliente nas configurações do aplicativo.
• CallbackURL: Defina isso para o URL de redirecionamento nas configurações do aplicativo.
• InitiateOAuth: Defina como GETANDREFRESH. Você pode usar InitiateOAuth para evitar repetir a troca de OAuth e configurar manualmente o OAuthAccessToken..

Quando você conecta, o conector abre o endpoint OAuth em seu navegador padrão. Faça login e conceda permissões ao aplicativo. O conector então conclui o processo OAuth:

1. Extrai o token de acesso do URL de retorno de chamada e autentica as solicitações.
2. Obtém um novo token de acesso quando o antigo expira.
3. Salva valores OAuth em OAuthSettingsLocation para ser persistido nas conexões.

Máquinas Sem Cabeça¶

Usando OAuth em uma Máquina Sem Cabeça¶

Para criar fontes de dados do eBay em servidores headless ou outras máquinas nas quais o conector não pode abrir um navegador, você precisa se autenticar em outra máquina. A autenticação é um processo de duas etapas.

1. Ao invés de instalar o conector em outra máquina, você pode seguir os passos abaixo para obter o OAuthVerifier valor. Ou você pode instalar o conector em outra máquina e transferir os valores de autenticação OAuth, depois de autenticar por meio do fluxo normal baseado em navegador.
2. Em seguida, você pode configurar o conector para atualizar automaticamente o token de acesso da máquina sem periféricos.

Você pode seguir o fluxo de autenticação OAuth headless usando as credenciais OAuth incorporadas do conector ou usando as credenciais OAuth para seu aplicativo OAuth personalizado.

Usando as Credenciais para um Aplicativo OAuth Personalizado¶

Crie um aplicativo OAuth personalizado

Consulte Criando um aplicativo OAuth personalizado para um procedimento. Você pode seguir os procedimentos abaixo para autenticar e conectar-se aos dados.

Obtenha um código verificador

Defina as seguintes propriedades na máquina sem periféricos:

• InitiateOAuth: Defina como DESLIGADO.
• OAuthClientId: Defina isso como o ID do aplicativo nas configurações do aplicativo.
• OAuthClientSecret: Defina isso como o Segredo do aplicativo nas configurações do aplicativo.

Você pode seguir as etapas abaixo para autenticar em outra máquina e obter o OAuthVerifier propriedade de conexão.

1. Chame o GetOAuthAuthorizationURL procedimento armazenado* com o parâmetro de entrada CallbackURL definido para o URI de redirecionamento exato que você especificou nas configurações do aplicativo.
2. Abra o URL retornado em um navegador. Faça login e conceda permissões ao conector. Você será redirecionado para o URL de retorno de chamada, que contém o código do verificador.
3. Salve o valor do código do verificador. Você definirá isso no OAuthVerifier propriedade de conexão.

Na máquina sem periféricos, defina as seguintes propriedades de conexão para obter os valores de autenticação OAuth:

• OAuthClientId: Defina isso como a chave do consumidor nas configurações do aplicativo.
• OAuthClientSecret: Defina isso como o segredo do consumidor nas configurações do aplicativo.
• OAuthVerifier: Defina isso para o código do verificador.
• OAuthSettingsLocation: Defina para manter os valores de autenticação OAuth criptografados no arquivo especificado.
• InitiateOAuth: Configure para ATUALIZAR.

Conecte-se aos dados

Depois que o arquivo de configurações OAuth for gerado, defina as seguintes propriedades para se conectar aos dados:

• OAuthSettingsLocation: Defina isso para o arquivo que contém os valores de autenticação OAuth criptografados. Certifique-se de que este arquivo forneça permissões de leitura e gravação ao provedor para ativar a atualização automática do token de acesso.
• InitiateOAuth: Configure para ATUALIZAR.

Configurações de transferência OAuth

Siga as etapas abaixo para instalar o conector em outra máquina, autenticar e depois transferir os valores OAuth resultantes.

Em uma segunda máquina, instale o conector e conecte-se com o seguinte conjunto de propriedades:

• OAuthSettingsLocation: Defina isso como um arquivo de texto gravável.
• InitiateOAuth: Defina como GETANDREFRESH.
• OAuthClientId: Defina isso como o ID do cliente nas configurações do aplicativo.
• OAuthClientSecret: Defina isso como o segredo do cliente nas configurações do aplicativo.
• CallbackURL: Defina isso para o URL de retorno de chamada nas configurações do aplicativo.

Teste a conexão para autenticar. Os valores de autenticação resultantes são gravados, criptografados, no caminho especificado por OAuthSettingsLocation. Depois de testar a conexão com sucesso, copie o arquivo de configurações OAuth para sua máquina sem periféricos. Na máquina sem periféricos, defina as seguintes propriedades de conexão para se conectar aos dados:

• InitiateOAuth: Configure para ATUALIZAR.
• OAuthSettingsLocation: Defina isso como o caminho para o arquivo de configurações OAuth. Certifique-se de que este arquivo forneça permissões de leitura e gravação ao conector para habilitar a atualização automática do token de acesso.

Criando um Aplicativo OAuth Personalizado¶

Existem dois métodos de autenticação disponíveis para se conectar ao eBay: Usando um token gerado para acessar apenas dados pessoais ou usando tokens que permitem que outros usuários acessem seus próprios dados. Ambos os métodos exigem que você participe do Programa de Desenvolvedores do eBay.

Registre-se e Obtenha Suas Chaves¶

Depois de ingressar no Programa de Desenvolvedores do eBay, você pode obter os seguintes valores na página Chaves do aplicativo (Minha conta -> Chaves de acesso ao aplicativo).

1. OAuthClientId (ID do aplicativo)
2. DevID
3. OAuthClientSecret (ID do certificado)

Usando um Token Pessoal¶

Se você estiver trabalhando com sua própria conta, siga as etapas abaixo para gerar um token:

1. Acesse o Painel da sua conta de desenvolvedor e abra a página Chaves do aplicativo.

2. Na linha App ID (Client ID) para o conjunto de chaves que você deseja usar, clique em User Tokens.

   Use as chaves de produção se estiver procurando por itens reais ou listando itens reais no site do eBay ao vivo. Use as chaves do sandbox se estiver criando listagens de teste no sandbox.

3. Clique em Obter um token de usuário aqui e faça login com credenciais para sua caixa de proteção ou conta de produção do eBay. Certifique-se também de definir 'Sua URL aceita de autenticação' como sua URL de retorno de chamada preferida. Como o eBay requer um URI de redirecionamento seguro (https), para aplicativos de desktop, você pode definir isso para: https://localhost:33333 ou para https://oauth.cdata.com/oauth/ para aplicativos da Web.

Observação: Para ativar a autenticação OAuth 2.0, você deve marcar a caixa de seleção 'OAuth ativado' na aba aberta 'Suas configurações de login do eBay '. Se não estiver ativado, apenas o método de autenticação Auth'N'Auth será suportado.

Você pode então definir as seguintes propriedades de conexão e conectar:

• DevID: Defina isso como o ID do desenvolvedor do seu conjunto de chaves.
• OAuthClientId: Defina isso para o ID do aplicativo (ID do cliente) do seu conjunto de chaves.
• OAuthClientSecret: Defina isso como o ID do certificado (segredo do cliente) do seu conjunto de chaves.
• SiteID: Defina isso para o ID do site do eBay. Por padrão, é 0 (o site dos EUA).
• OAuthAccessToken: Defina isso para o token pessoal que você gerou no painel da sua conta de desenvolvedor.
• UseSandbox: Defina como verdadeiro se estiver usando uma conta de sandbox.
• AuthScheme: Defina como "OAuth" se desejar usar OAuth 2.0 como método de autenticação. Se for definido como "AuthNAuth" ou se não for especificado, Auth'n'Auth será usado para autenticar.
• CallbackURL: Defina para http://localhost:33333 ou outra porta de sua escolha. (Se você não configurou o https://oauth.cdata.com/oauth/ URL de redirecionamento, verifique se você está usando a mesma porta que a URL de redirecionamento configurada em seu aplicativo do eBay )

Obtendo Tokens para Aplicativos com Vários Usuários¶

O eBay implementa o padrão de autenticação OAuth, que você pode usar para permitir que outros usuários acessem seus próprios dados.

OAuth requer que o usuário autenticado interaja com o eBay usando o navegador. O conector facilita isso de várias maneiras, conforme descrito nas seções a seguir.

Configurar um Aplicativo OAuth¶

Siga as etapas abaixo para configurar o fluxo de consentimento do usuário:

1. Acesse o Painel da sua conta de desenvolvedor e abra a página Chaves do aplicativo.
2. Na linha ID do aplicativo (ID do cliente) do seu aplicativo, clique em Tokens do usuário.
3. Clique em Obter um token de usuário aqui e faça login com credenciais para sua caixa de proteção ou conta de produção do eBay. Certifique-se também de definir 'Sua URL aceita de autenticação' como sua URL de retorno de chamada preferida. Como o eBay requer um URI de redirecionamento seguro (https), para aplicativos de desktop, você pode definir isso para: https://localhost:33333 ou para https://oauth.cdata.com/oauth/ para aplicativos da Web.

Observação: Para ativar a autenticação OAuth 2.0, você deve marcar a caixa de seleção 'OAuth ativado' na aba aberta 'Suas configurações de login do eBay '. Se não estiver ativado, apenas o método de autenticação Auth'N'Auth será suportado.

Autenticar no Ebay a Partir de um Aplicativo de Desktop¶

Depois de definir as seguintes propriedades de conexão, você está pronto para se conectar:

• DevID: Defina isso como o ID do desenvolvedor do seu conjunto de chaves.
• OAuthClientId: Defina isso para o ID do aplicativo (ID do cliente) do seu conjunto de chaves.
• OAuthClientSecret: Defina isso como o ID do certificado (segredo do cliente) do seu conjunto de chaves.
• RuName: Defina isso como o nome da URL de redirecionamento no Token do eBay por meio da seção Aplicativo da página Tokens do usuário.
• SiteID: Defina isso para o ID do site do eBay. Por padrão, é 0 (o site dos EUA).
• CallbackURL: Defina para http://localhost:33333 ou outra porta de sua escolha. (Se você não configurou o https://oauth.cdata.com/oauth/ URL de redirecionamento, verifique se você está usando a mesma porta que a URL de redirecionamento configurada em seu aplicativo do eBay )
• InitiateOAuth: Defina como GETANDREFRESH.
• UseSandbox: Defina como verdadeiro se estiver usando uma conta de sandbox.
• AuthScheme: Defina como "OAuth" se desejar usar OAuth 2.0 como método de autenticação. Se for definido como "AuthNAuth" ou se não for especificado, Auth'n'Auth será usado para autenticar.

Quando você se conecta, o conector abre o endpoint OAuth ou Auth and Auth em seu navegador padrão. Faça login e conceda permissões ao aplicativo. O conector então conclui o processo de autenticação:

1. Extrai o token e autentica as solicitações.
2. Salva valores OAuth em OAuthSettingsLocation para ser persistido nas conexões.

Autenticar no Ebay a Partir de um Aplicativo da Web¶

Para obter o token de acesso, defina as seguintes propriedades de conexão:

• DevID: Defina isso como o ID do desenvolvedor em seu conjunto de chaves.
• OAuthClientId: Defina isso para o ID do aplicativo (ID do cliente) em seu conjunto de chaves.
• OAuthClientSecret: Defina isso como o ID do certificado (segredo do cliente) em seu conjunto de chaves.
• SiteID: Defina isso para o ID do site do eBay. Por padrão, é 0, (EUA)
• RuName: Defina isso como o nome da URL de redirecionamento no Token do eBay por meio da seção Aplicativo da página Tokens do usuário.
• UseSandbox: Defina como verdadeiro se estiver usando uma conta de sandbox.
• AuthScheme: Defina como "OAuth" se desejar usar OAuth 2.0 como método de autenticação. Se for definido como "AuthNAuth" ou se não for especificado, Auth'n'Auth será usado para autenticar.

Ao conectar por meio de um aplicativo da Web, ou se o conector não estiver autorizado a abrir uma janela do navegador, você precisará trocar um ID de sessão (se estiver usando Auth e Auth como método de autenticação) ou um código verificador (se estiver usando OAuth 2.0) para OAuthAccessToken:

1. Defina o UseSandbox propriedade de conexão como true se você estiver usando uma conta de sandbox.
2. Defina o AuthScheme propriedade de conexão para "OAuth" se você quiser usar a autenticação OAuth, ou definir como "AuthNAuth" para usar o Auth'n'Auth para autenticação.
3. Chame GetOAuthAuthorizationURL. O procedimento armazenado* retorna a URL para o endpoint OAuth.
4. Faça login e autorize o aplicativo. Você é redirecionado de volta para o URL de retorno de chamada.
5. Chame GetOAuthAccessToken. Defina o parâmetro AuthMode como "WEB". Se você estiver usando OAuth para autenticar, defina o valor do Verifier para o valor do código retornado na etapa anterior. Caso contrário, se você estiver usando Auth e Auth, defina o parâmetro SessionId para o parâmetro SessionId retornado na string de consultar da URL de retorno de chamada da etapa anterior.

Para fazer solicitações ao eBay, defina o OAuthAccessToken retornado além das propriedades de conexão anteriores. Definir InitiateOAuth para REFRESH para atualizar automaticamente o token de acesso quando ele expirar.

Anotações Importantes¶

Procedimentos Armazenados¶

• Os recursos de procedimentos armazenados descritos nesta documentação não são suportados no momento.
• Como os procedimentos armazenados não são suportados atualmente, qualquer recurso dependente de procedimentos armazenados também não é suportado atualmente.

Arquivos de Configuração e Seus Caminhos¶

• Todas as referências para adicionar arquivos de configuração e seus caminhos referem-se a arquivos e locais no Harmony Agente onde o conector está instalado. Esses caminhos devem ser ajustados conforme apropriado, dependendo do agente e do sistema operacional. Se vários agentes forem usados em um grupo de agentes, arquivos idênticos serão necessários em cada agente.

Características Avançadas¶

Esta seção detalha uma seleção de recursos avançados do conector eBay.

Visualizações definidas pelo usuário

O conector permite definir tabelas virtuais, denominadas visões definidas pelo usuário, cujo conteúdo é decidido por uma consultar pré-configurada. Essas exibições são úteis quando você não pode controlar diretamente as consultas enviadas aos drivers. Consulte Visualizações definidas pelo usuário para obter uma visão geral da criação e configuração de exibições personalizadas.

Configuração SSL

Use Configuração SSL para ajustar como o conector lida com as negociações de certificado TLS/SSL. Você pode escolher entre vários formatos de certificado; Veja o SSLServerCert propriedade em "Opções de cadeia de conexão" para obter mais informações.

Procurador

Para configurar o conector usando configurações de proxy do Agente Privado, selecione os Use Proxy Settings caixa de seleção na tela de configuração da conexão.

Visualizações Definidas pelo Usuário¶

O Jitterbit Connector for eBay permite definir uma tabela virtual cujo conteúdo é decidido por uma consultar pré-configurada. Elas são chamadas de Visualizações Definidas pelo Usuário, que são úteis em situações onde você não pode controlar diretamente a consultar que está sendo emitida para o driver, por exemplo, ao usar o driver do Jitterbit. As Visualizações Definidas pelo Usuário podem ser usadas para definir predicados que são sempre aplicados. Se você especificar predicados adicionais na consultar para a visualização, eles serão combinados com a consultar já definida como parte da visualização.

Há duas maneiras de criar exibições definidas pelo usuário:

• Crie um arquivo de configuração em formato JSON definindo as visualizações desejadas.
• declarações DDL.

Definindo Visualizações Usando um Arquivo de Configuração¶

As visualizações definidas pelo usuário são definidas em um arquivo de configuração formatado em JSON chamado UserDefinedViews.json. O conector detecta automaticamente as visualizações especificadas neste arquivo.

Você também pode ter várias definições de exibição e controlá-las usando o UserDefinedViews propriedade de conexão. Quando você usa essa propriedade, apenas as exibições especificadas são vistas pelo conector.

Este arquivo de configuração de exibição definida pelo usuário é formatado da seguinte forma:

• Cada elemento raiz define o nome de uma visualização.
• Cada elemento raiz contém um elemento filho, chamado query, que contém a consultar SQL personalizada para a exibição.

Por exemplo:

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

Use o UserDefinedViews propriedade de conexão para especificar a localização do seu arquivo de configuração JSON. Por exemplo:

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

Esquema para Exibições Definidas pelo Usuário¶

As visualizações definidas pelo usuário são expostas no UserViews esquema por padrão. Isso é feito para evitar que o nome da exibição entre em conflito com uma entidade real no modelo de dados. Você pode alterar o nome do esquema usado para UserViews definindo o UserViewsSchemaName propriedade.

Trabalhando com Exibições Definidas pelo Usuário¶

Por exemplo, uma instrução SQL com uma Visualização Definida pelo Usuário chamada UserViews.RCustomers lista apenas clientes em Raleigh:

SELECT * FROM Customers WHERE City = 'Raleigh';

Exemplo de consultar ao driver:

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

Resultando na consultar efetiva à fonte:

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

Esse é um exemplo muito simples de uma consultar a uma exibição definida pelo usuário que é efetivamente uma combinação da consultar de exibição e da definição de exibição. É possível compor essas consultas em padrões muito mais complexos. Todas as operações SQL são permitidas em ambas as consultas e são combinadas quando apropriado.

Configuração SSL¶

Personalizando a Configuração SSL¶

Por padrão, o conector tenta negociar SSL/TLS verificando o certificado do servidor em relação ao armazenamento de certificados confiáveis do sistema.

Para especificar outro certificado, consulte o SSLServerCert propriedade para os formatos disponíveis para fazê-lo.

Modelo de Dados¶

O Jitterbit Connector for eBay modela entidades na API do eBay como tabelas, exibições e procedimentos armazenados. Eles são definidos em arquivos de esquema, que são arquivos de configuração simples baseados em texto.

As limitações e requisitos da API estão documentados nesta seção; você pode usar o SupportEnhancedSQL recurso, definido por padrão, para contornar a maioria dessas limitações.

Mesas

O Conector Jitterbit para eBay modela Listagens de itens em tabelas para que possam ser facilmente consultadas, atualizadas e excluídas. Você pode listar itens em sua loja eBay chamando o procedimento armazenado AddItem.

Visualizações

Visualizações são tabelas que não podem ser modificadas. Normalmente, os dados somente leitura são mostrados como exibições.

Procedimentos armazenados

NOTE: Procedimentos armazenados não são suportados atualmente. Veja a nota para detalhes.

Procedimentos armazenados são interfaces semelhantes a funções para a fonte de dados. Eles podem ser usados para pesquisar, atualizar e modificar informações na fonte de dados.

Tabelas¶

O conector modela os dados no eBay em uma lista de tabelas que podem ser consultadas usando instruções SQL padrão.

Geralmente, consultar tabelas do eBay é o mesmo que consultar uma tabela em um banco de dados relacional. Às vezes, há casos especiais, por exemplo, incluir uma determinada coluna na cláusula WHERE pode ser necessário para obter dados para determinadas colunas na tabela. Isso geralmente é necessário para situações em que uma solicitação separada deve ser feita para cada linha para obter determinadas colunas. Esses tipos de situações estão claramente documentados na parte superior da página da tabela vinculada abaixo.

Conector Jitterbit para Tabelas do Ebay¶

Listagem de Itens¶

Atualize, exclua e consultar Listagens de itens para vendedores.

Informações Específicas da Tabela¶

Selecione¶

A consultar a seguir recupera itens do vendedor. Por padrão, essa consultar retorna itens que foram adicionados nos últimos 100 dias.

SELECT * FROM ItemListing

ItemListing é a única tabela que suporta ORDER BY. Apenas duas colunas podem ser usadas para ordenação: StartTime e EndTime. A consultar a seguir recupera itens que terminam entre o horário especificado, ordenados pelo item que termina antes.

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

Inserir¶

O AddItem procedimento armazenado* fornece a funcionalidade para adicionar um novo item.

Atualizar¶

As entradas necessárias para uma atualização dependem do tipo de item e sua categoria. Pelo menos o ItemId e uma propriedade do item devem ser fornecidos em uma atualização.

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

Após a venda de um item em uma listagem de várias quantidades, os vendedores não podem alterar os valores nos campos Título, Categoria principal, Categoria secundária, Duração da listagem e Tipo de listagem. No entanto, todos os outros campos ainda são editáveis.

Excluir¶

O ItemId e EndingReason devem ser especificados para excluir um item.

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

Colunas¶

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Variações de Itens¶

Variações de itens são vários itens semelhantes (mas não idênticos) em uma única listagem de preço fixo. Por exemplo, uma listagem de camisetas pode conter vários itens da mesma marca que variam de cor e tamanho; cada variação especificaria uma combinação de uma dessas cores e tamanhos. Cada variação pode ter uma quantidade e preço diferentes. Você pode comprar vários itens de uma variação ao mesmo tempo. (Ou seja, um item de linha de pedido pode conter vários itens de uma única variação.)

Informações Específicas da Tabela¶

Selecione¶

Um ID de item deve ser especificado para obter variações para o item que esse ID representa.

SELECT * FROM ItemVariations WHERE ItemId = '110187147205'

Inserir¶

Os campos obrigatórios para inserção são ItemId, VariationSpecificsAggregate, StartPrice e Quantity. VariationSpecificsAggregate deve conter especificações de variação estruturadas no formato XML. Por exemplo, o seguinte VariationSpecificsAggregate adiciona um grande item azul:

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

A consultar a seguir adiciona uma variação de um grande item azul com um StartPrice de 15 e uma Quantity 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')

Atualizar¶

ItemId e VariationSpecificsAggregate são necessários para atualizar uma variação. Opcionalmente, outros detalhes podem ser fornecidos para variações, como StartPrice e Quantity. VariationSpecificsAggregate deve estar no formato XML e deve conter todas as especificações que identificam uma variação.

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>'

Excluir¶

ItemId e VariationSpecificsAggregate são necessários para excluir uma variação.

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

Colunas¶

Tarefas¶

Recupera todas as tarefas para o mercado especificado usando o parâmetro de consultar MarketplaceId.

Selecione¶

FeedType é um filtro obrigatório na consultar Selecionar. Você pode seguir a consultar abaixo para obter os valores necessários através do SQL:

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

Alguns dos campos são nomeados com o sufixo Aggr. Esses campos exibem o conteúdo da tag JSON com o mesmo nome que é retornado do endpoint da API.

Inserir¶

FeedType, MarketplaceID e SchemaVersion são obrigatórios na consultar Insert. Você pode seguir a consultar abaixo para obter os valores necessários através do SQL:

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

Colunas¶

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Visualizações¶

As exibições são compostas por colunas e pseudocolunas. As exibições são semelhantes às tabelas na forma como os dados são representados; no entanto, as exibições não oferecem suporte a atualizações. Entidades que são representadas como exibições são normalmente entidades somente leitura. Frequentemente, um procedimento armazenado* está disponível para atualizar os dados se tal funcionalidade for aplicável à fonte de dados.

As consultas podem ser executadas em uma exibição como se fosse uma tabela normal, e os dados retornados são semelhantes nesse aspecto. Para saber mais sobre tabelas e procedimentos armazenados, navegue até as entradas correspondentes neste documento de ajuda.

Conector Jitterbit para Visualizações do Ebay¶

Licitantes¶

Consulte os usuários do eBay que fazem lances em uma listagem especificada, independentemente de a listagem ter terminado.

Informações Específicas da Tabela¶

Selecione¶

As únicas colunas com suporte para filtragem são ItemId e ListMode. Um ItemId deve ser especificado para recuperar dados desta exibição.

Select * FROM Bidders WHERE ItemId = '1234567'

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

Colunas¶

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Categorias¶

Consulte as categorias do eBay.

Informações Específicas da Tabela¶

Selecione¶

As únicas colunas com suporte para filtragem são CategorySiteId, LevelLimit e CategoryParentId.

SELECT * FROM Categories.

Você pode retornar mais informações sobre uma categoria específica e suas subcategorias com a seguinte consultar:

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

Colunas¶

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

CategoriaCaracterísticas¶

Consulte as configurações suportadas pelas categorias do eBay.

Informações Específicas da Tabela¶

Selecione¶

As únicas colunas com suporte para filtragem são CategoryId, LevelLimit, AllFeaturesForCategory e FeatureId. Se nenhum CategoryId for especificado, todos os recursos para categorias de nível superior serão retornados.

SELECT * FROM CategoryFeatures                          

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

Colunas¶

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Específicos da Categoria¶

Consultar Lista de Compatibilidade de Itens para vendedores.

Colunas¶

Países¶

Lista o código do país e o nome associado dos países suportados pelo sistema eBay, independentemente do site especificado na solicitação.

Colunas¶

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Moedas¶

Consulte as moedas suportadas no eBay.

Informações Específicas da Tabela¶

Selecione¶

Retorna todas as moedas suportadas. Nenhuma coluna é suportada para filtragem.

SELECT * FROM Currencies 

Colunas¶

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

DSRSummary¶

Consultar informações de classificação de relatórios de resumo DSR.

Informações Específicas da Tabela¶

Selecione¶

A coluna JobId deve ser especificada para recuperar dados desta exibição.

SELECT * FROM DSRSummary WHERE JobId = '123456' 

Colunas¶

Políticas de Cumprimento¶

Recupera todas as políticas de atendimento configuradas para o mercado especificado usando o parâmetro de consultar MarketplaceId.

Selecione¶

MarketplaceId é um filtro obrigatório na consultar Selecionar. Você pode seguir a consultar abaixo para obter os valores necessários através do SQL:

SELECT * FROM FulfillmentPolicies WHERE MarketplaceId='EBAY_US'

Alguns dos campos são nomeados com o sufixo Aggr. Esses campos exibem o conteúdo da tag JSON com o mesmo nome que é retornado do endpoint da API.

Colunas¶

Maior Apostador¶

Consulte o lance mais alto dos usuários do eBay que deram lances em uma listagem especificada, independentemente de a listagem ter terminado.

Informações Específicas da Tabela¶

Selecione¶

As únicas colunas com suporte para filtragem são ItemId e ListMode. Um ItemId deve ser especificado para recuperar dados desta exibição.

Select * FROM HighestBidder WHERE ItemId = '1234567'

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

Colunas¶

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

ItemCompatibilityList¶

Consulte categorias de compatibilidade e possíveis valores de compatibilidade para um item específico.

Colunas¶

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

ItemEnvio¶

Detalhes da consulta pertinentes a um ou mais itens para os quais o frete calculado foi oferecido pelo vendedor, como dimensão da embalagem, peso e custos de embalagem/manuseio.

Informações Específicas da Tabela¶

Selecione¶

Os filtros DestinationCountryCode e ItemId devem ser especificados para recuperar dados dessa exibição. Além disso, o filtro QuantitySold pode ser usado, mas é opcional.

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

Colunas¶

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Específicos do Artigo¶

Consultar itens específicos para um item específico.

Colunas¶

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

ItemTransactions¶

Consulte as informações do item de linha do pedido (transação) para uma listagem especificada. Para listagens de leilão, os itens de linha de pedido não são criados até que o leilão termine com um licitante vencedor ou se o recurso Comprar agora estiver ativado para a listagem e usado pelo comprador para comprar o item. Para listagens de preço fixo, os itens de linha do pedido são criados depois que um comprador se compromete a comprar o(s) item(ns).

Informações Específicas da Tabela¶

Selecione¶

A coluna ItemId deve ser especificada para recuperar as informações da transação.

Obtenha todas as transações relacionadas a um item específico:

SELECT * FROM ItemTransactions WHERE ItemId='012345678901'

Filtre o número de transações retornadas especificando o número de dias no passado:

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

Obtenha informações para uma transação específica que foi feita para um item específico:

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

Colunas¶

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Itens Mais Assistidos¶

Consulte os itens com as contagens de exibição mais altas para todo o site ou para uma categoria específica. Os itens principais são determinados pelos totais de Watch Count do dia anterior. A classificação dos itens mais assistidos é calculada com as informações mais recentes da contagem de exibição.

Informações Específicas da Tabela¶

Selecione¶

As únicas colunas que podem ser usadas para filtrar são CategoryId, AffiliateCustomId, AffiliateNetworkId e AffiliateTrackingId. Esses filtros são opcionais.

SELECT * FROM MostWatchedItems

SELECT * FROM MostWatchedItems WHERE CategoryId = '277' 

Colunas¶

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

PedidoPagamentos¶

Consultar todos os pagamentos dos pedidos, em que o usuário autenticado seja o comprador ou o vendedor. Por defeito, são devolvidos apenas os dados de pagamento das encomendas realizadas nos últimos 90 dias. Detalhes de pagamento de pedidos com mais de 90 dias podem ser recuperados especificando OrderId.

Ver Informações Específicas¶

Selecione¶

Exemplos de consulta à visualização OrderPayments:

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

SELECT * FROM OrderPayments WHERE NumberOfDays = '30'

Colunas¶

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Pedidos¶

Consultar todos os pedidos em que o usuário autenticado seja o comprador ou o vendedor. Por padrão, apenas os pedidos feitos nos últimos 90 dias são devolvidos. Pedidos com mais de 90 dias podem ser recuperados especificando OrderId.

Ver Informações Específicas¶

Selecione¶

Exemplos de consulta à visualização 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'

Colunas¶

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

PedidoEnvio¶

Consulte os detalhes de envio dos pedidos em que o usuário autenticado seja o comprador ou o vendedor. Por defeito, são devolvidos apenas os dados de envio das encomendas efetuadas nos últimos 90 dias. Detalhes de envio de pedidos com mais de 90 dias podem ser recuperados especificando OrderId.

Ver Informações Específicas¶

Selecione¶

Exemplos de consulta à visualização OrderShipping:

SELECT * FROM OrderShipping WHERE NumberOfDays = '30'

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

Colunas¶

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Políticas de Pagamento¶

Recupera todas as políticas de pagamento configuradas para o mercado especificado usando o parâmetro de consultar MarketplaceId.

Selecione¶

MarketplaceId é um filtro obrigatório na consultar Selecionar. Você pode seguir a consultar abaixo para obter os valores necessários através do SQL:

SELECT * FROM PaymentPolicies WHERE MarketplaceId='EBAY_US'

Alguns dos campos são nomeados com o sufixo Aggr. Esses campos exibem o conteúdo da tag JSON com o mesmo nome que é retornado do endpoint da API.

Colunas¶

Políticas de Devolução¶

Recupera todas as políticas de devolução configuradas para o mercado especificado usando o parâmetro de consultar MarketplaceId.

Selecione¶

MarketplaceId é um filtro obrigatório na consultar Selecionar. Você pode seguir a consultar abaixo para obter os valores necessários através do SQL:

SELECT * FROM ReturnPolicies WHERE MarketplaceId='EBAY_US'

Alguns dos campos são nomeados com o sufixo Aggr. Esses campos exibem o conteúdo da tag JSON com o mesmo nome que é retornado do endpoint da API.

Colunas¶

Transportadoras¶

Consultar transportadoras suportadas pelo site especificado.

Colunas¶

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Categorias de Envio¶

Uma categoria de serviço de frete compatível com o site.

Colunas¶

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Locais de Envio¶

Lista as regiões e locais suportados pelos serviços de remessa do eBay. Retorna todos os locais de envio suportados pelo eBay, independentemente do site especificado na solicitação.

Colunas¶

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Serviços de Transporte¶

Consulte os serviços de remessa suportados pelo site eBay especificado.

Informações Específicas da Tabela¶

Selecione¶

A consultar a seguir recupera todos os serviços de remessa disponíveis. Não há filtros suportados para esta exibição.

SELECT * FROM ShippingServices

Colunas¶

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Sites¶

Lista todos os sites eBay disponíveis e seus números de SiteID associados.

Colunas¶

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Produtos Mais Vendidos¶

Consulte seus produtos mais vendidos no eBay.

Informações Específicas da Tabela¶

Selecione¶

As únicas colunas que podem ser usadas para filtrar são AffiliateCustomId, AffiliateNetworkId e AffiliateTrackingId. Esses filtros são opcionais.

SELECT * FROM TopSellingProducts

SELECT * FROM TopSellingProducts WHERE AffiliateCustomId='12345'

Colunas¶

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

TransaçõesPagamentos¶

Consultar todos os pagamentos das transações em que o usuário autenticado seja o comprador ou o vendedor. Por padrão, são devolvidos apenas os pagamentos das transações realizadas nos últimos 90 dias. Os pagamentos das transações em pedidos com mais de 90 dias podem ser recuperados especificando OrderIds.

Ver Informações Específicas¶

Selecione¶

Exemplos de consulta à visualização TransactionPayments:

SELECT * FROM TransactionPayments WHERE OrderRole = 'Seller'

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

Colunas¶

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Transações¶

Consulte todas as transações nas quais o usuário autenticado é o comprador ou o vendedor. Por padrão, são retornadas apenas as transações de pedidos feitos nos últimos 90 dias. As transações de pedidos com mais de 90 dias podem ser recuperadas especificando OrderId.

Ver Informações Específicas¶

Selecione¶

Exemplos de consulta da exibição Transações.

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'

Colunas¶

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

TransaçãoEnvio¶

Consulte os detalhes de envio das transações em que o usuário autenticado é o comprador ou o vendedor. Por defeito, são devolvidos apenas os dados de envio das transacções efectuadas nos últimos 90 dias. Os detalhes de envio das transações em pedidos com mais de 90 dias podem ser recuperados especificando OrderIds.

Ver Informações Específicas¶

Selecione¶

Exemplos de consulta à visualização 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')

Colunas¶

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Procedimentos Armazenados¶

Procedimentos armazenados* estão disponíveis para complementar os dados disponíveis no Modelo de Dados. Pode ser necessário atualizar os dados disponíveis em uma exibição usando um procedimento armazenado* porque os dados não fornecem atualizações bidirecionais diretas, semelhantes a tabelas. Nessas situações, a recuperação dos dados é feita usando a visualização ou tabela apropriada, enquanto a atualização é feita chamando um procedimento armazenado. Procedimentos armazenados* pega uma lista de parâmetros e retorna um conjunto de dados que contém a coleção de tuplas que constituem a resposta.

Conector Jitterbit para Procedimentos Armazenados do Ebay¶

Adicionar Item¶

Crie e publique uma nova listagem de itens em um site do eBay.

Procedimento Armazenado* Informações Específicas¶

Após a criação bem-sucedida de uma Listagem de Item, um ID de Item é retornado na resposta junto com as taxas estimadas para listar o Item. Depois de adicionar um item, você pode usar a tabela ItemListing para atualizar, excluir e consultar.

As entradas necessárias para adicionar qualquer item são as seguintes: Title, Description, CategoryId, StartPrice, ConditionId, Country, Currency, DispatchTimeMax, ListingDuration, ListingType, PaymentMethod, PayPalEmailAddress, Quantity, Location e ReturnsAcceptedOption.

Você também precisa especificar várias entradas necessárias para selecionar um tipo de remessa: Plana ou Calculada. Ambos os tipos de remessa exigem que um ShippingService seja especificado.

Adicionar um item¶

Você pode seguir o procedimento abaixo para obter os valores necessários e adicionar um item através do SQL:

1. Use a exibição Categorias para selecionar uma categoria de nível superior; por exemplo, Livros. Você pode usar a seguinte consultar:

   SELECT * FROM Categories
   

2. Use a exibição Categorias para selecionar uma categoria de folha; por exemplo, Ficção e Literatura. Um ID de categoria de folha é necessário para adicionar um item. Você pode usar uma consultar como a seguinte:

   SELECT * FROM Categories WHERE CategoryParentId='267'
   

3. Use a exibição ShippingServices para selecionar um serviço de remessa. O valor da coluna ValidForSellingFlow deve ser true; caso contrário, essa opção de serviço de frete específica não será mais válida e não poderá ser oferecida aos compradores por meio de uma listagem.

Selecionando frete fixo¶

As entradas a seguir são necessárias para o tipo de remessa Simples: ShippingType, ShippingService, ShippingServicePriority e ShippingServiceCost.

Selecionando frete calculado¶

O tipo de envio calculado requer informações adicionais relacionadas às estatísticas do pacote. As entradas a seguir são necessárias para esse tipo de remessa: ShippingType, WeightMajor, WeightMinor, OriginatingPostalCode, ShippingService e ShippingServicePriority.

Note: Este procedimento faz uso de indexed parameters. Esses parâmetros de entrada são indicados com um # no final de seus nomes.

Os parâmetros indexados facilitam o fornecimento de várias instâncias de um único parâmetro como entradas para o procedimento.

Suponha que haja um parâmetro de entrada chamado Param#. Insira várias instâncias de um parâmetro indexado como este:

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

Entrada¶

Colunas do conjunto de resultados¶

CompleteSale¶

Realize várias tarefas após a criação de um único item de linha ou pedido de vários itens de linha. Por exemplo, conclua uma venda e deixe um feedback.

Entrada¶

Colunas do conjunto de resultados¶

CreateDSRSummery¶

Recupere um relatório resumido de DSR, incluindo a precisão da descrição, comunicação, envio, etc. Essas informações podem ajudar os vendedores a determinar como práticas comerciais específicas podem estar contribuindo para pontuações DSR mais altas ou mais baixas.

Entrada¶

Colunas do conjunto de resultados¶

CreateReport¶

Começa a processar os dados para download de um arquivo de relatório.

Entrada¶

Colunas do conjunto de resultados¶

GetOAuthAccessToken¶

Obtém o token de acesso OAuth do eBay.

Entrada¶

Colunas do conjunto de resultados¶

GetOAuthAuthorizationURL¶

Obtém o URL de autorização do eBay. Acesse a URL retornada na saída em um navegador da Internet. Isso solicita o token de acesso que pode ser usado como parte da string de conexão para o eBay.

Entrada¶

Colunas do conjunto de resultados¶

GetReport¶

Baixa um relatório que foi criado anteriormente com o procedimento armazenado CreateReport. Para baixar o relatório, seu status deve ser Concluído.

Entrada¶

Colunas do conjunto de resultados¶

RefreshOAuthAccessToken¶

Atualiza o token de acesso OAuth usado para autenticação com o eBay.

Entrada¶

Colunas do conjunto de resultados¶

SetUserNotes¶

Adicione, substitua e exclua notas do Meu eBay para itens que estão sendo rastreados nas áreas de Vendas e Compras do Meu eBay.

Note: Este procedimento faz uso de indexed parameters. Esses parâmetros de entrada são indicados com um # no final de seus nomes.

Os parâmetros indexados facilitam o fornecimento de várias instâncias de um único parâmetro como entradas para o procedimento.

Suponha que haja um parâmetro de entrada chamado Param#. Insira várias instâncias de um parâmetro indexado como este:

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

Entrada¶

Colunas do conjunto de resultados¶

CarregarArquivo¶

Carrega um arquivo para a conta do eBay.

Procedimento armazenado* Informações específicas¶

Este procedimento associa o arquivo especificado ao ID de tarefa especificado e carrega o arquivo de entrada. Após o upload do arquivo, o processamento do arquivo é iniciado.

As entradas necessárias para carregar um arquivo são as seguintes: TaskID e FilePath.

Carregar um arquivo¶

Você pode seguir o procedimento abaixo para enviar um procedimento de upload de arquivo bem-sucedido:

1. Use a tabela Tarefas para criar uma nova Tarefa. Você pode usar a seguinte consultar:

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

2. Você pode obter o TaskID recém-gerado a partir das chaves geradas ou usando a tabela Tarefas novamente para selecionar.

       Statement stat = conn.createStatement();
       stat.executeUpdate("INSERT INTO [Tarefas] (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));
         }
   }
   

   ou

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

3. Use esse ID de tarefa como entrada junto com o FilePath do arquivo a ser carregado, no procedimento armazenado 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. Então seu arquivo deve estar processando. Para rastrear o status, você pode executar uma consultar SELECT na tabela Tasks com o TaskID e verificar a coluna Status.

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

Entrada¶

Colunas do conjunto de resultados¶

Tabelas do sistema¶

Você pode consultar as tabelas do sistema descritas nesta seção para acessar informações de esquema, informações sobre a funcionalidade da fonte de dados e estatísticas de operação em lote.

Tabelas de esquema¶

As tabelas a seguir retornam metadados de banco de dados para o eBay:

• sys_catalogs: Lista os bancos de dados disponíveis.
• sys_schemas: Lista os esquemas disponíveis.
• sys_tables: Lista as tabelas e exibições disponíveis.
• sys_tablecolumns: Descreve as colunas das tabelas e exibições disponíveis.
• sys_procedures: Descreve os procedimentos armazenados disponíveis.
• sys_procedureparameters: Descreve procedimento armazenado* parâmetros.
• sys_keycolumns: Descreve as chaves primárias e estrangeiras.
• sys_indexes: Descreve os índices disponíveis.

Tabelas de fonte de dados¶

As tabelas a seguir retornam informações sobre como se conectar e consultar a fonte de dados:

• sys_connection_props: Retorna informações sobre as propriedades de conexão disponíveis.
• sys_sqlinfo: Descreve as consultas SELECT que o conector pode descarregar para a fonte de dados.

Consultar tabelas de informações¶

A tabela a seguir retorna estatísticas de consultar para consultas de modificação de dados:

• sys_identity: Retorna informações sobre operações em lote ou atualizações únicas.

sys_catalogs¶

Lista os bancos de dados disponíveis.

A consultar a seguir recupera todos os bancos de dados determinados pela string de conexão:

SELECT * FROM sys_catalogs

Colunas¶

sys_schemas¶

Lista os esquemas disponíveis.

A consultar a seguir recupera todos os esquemas disponíveis:

SELECT * FROM sys_schemas

Colunas¶

sys_tables¶

Lista as tabelas disponíveis.

A consultar a seguir recupera as tabelas e exibições disponíveis:

SELECT * FROM sys_tables

Colunas¶

sys_tablecolumns¶

Descreve as colunas das tabelas e exibições disponíveis.

A consultar a seguir retorna as colunas e os tipos de dados da tabela ItemListing:

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

Colunas¶

sys_procedures¶

Lista os procedimentos armazenados disponíveis.

A consultar a seguir recupera os procedimentos armazenados disponíveis:

SELECT * FROM sys_procedures

Colunas¶

sys_procedureparameters¶

Descreve procedimento armazenado* parâmetros.

A consultar a seguir retorna informações sobre todos os parâmetros de entrada para o procedimento armazenado AddItem:

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

Colunas¶

sys_keycolumns¶

Descreve as chaves primárias e estrangeiras. A consultar a seguir recupera a chave primária da tabela ItemListing:

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

Colunas¶

sys_foreignkeys¶

Descreve as chaves estrangeiras. A consultar a seguir recupera todas as chaves estrangeiras que se referem a outras tabelas:

SELECT * FROM sys_foreignkeys WHERE ForeignKeyType = 'FOREIGNKEY_TYPE_IMPORT'

Colunas¶

sys_indexes¶

Descreve os índices disponíveis. Ao filtrar por índices, você pode escrever consultas mais seletivas com tempos de resposta de consultar mais rápidos.

A consultar a seguir recupera todos os índices que não são chaves primárias:

SELECT * FROM sys_indexes WHERE IsPrimary='false'

Colunas¶

sys_connection_props¶

Retorna informações sobre as propriedades de conexão disponíveis e as definidas na string de conexão.

Ao consultar esta tabela, a string de conexão de configuração deve ser usada:

jdbc:cdata:ebay:config:

Esta string de conexão permite que você consultar esta tabela sem uma conexão válida.

A consultar a seguir recupera todas as propriedades de conexão que foram definidas na string de conexão ou definidas por meio de um valor padrão:

SELECT * FROM sys_connection_props WHERE Value <> ''

Colunas¶

sys_sqlinfo¶

Descreve o processamento da consultar SELECT que o conector pode transferir para a fonte de dados.

Processamento colaborativo de consultas¶

Ao trabalhar com fontes de dados que não suportam SQL-92, você pode consultar a exibição sys_sqlinfo para determinar os recursos de consultar das APIs subjacentes, expressas na sintaxe SQL. O conector transfere o máximo possível do processamento da instrução SELECT para o servidor e, em seguida, processa o restante da consultar na memória.

Descobrindo os recursos SELECT da fonte de dados¶

Abaixo está um exemplo de conjunto de dados de recursos SQL. O conjunto de resultados a seguir indica a funcionalidade SELECT que o conector pode descarregar para a fonte de dados ou processar o lado do cliente. Sua fonte de dados pode suportar sintaxe SQL adicional. Alguns aspectos da funcionalidade SELECT são retornados em uma lista separada por vírgulas, se suportados; caso contrário, a coluna contém NO.