Detalhes da Conexão Basecamp

Introdução

Versão do conector

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

Começando

Suporte à versão do Basecamp

O conector modela as contas Basecamp 2 e Basecamp 3 como tabelas bidirecionais.

Estabelecendo uma Conexão

Conectando ao Basecamp

Além da autenticação, defina as seguintes propriedades de conexão para acessar as tabelas do Basecamp.

• Schema: Defina como "V2" ou "V3" para se conectar a uma conta Basecamp 2 ou Basecamp 3.

• ProjectId: Este é um parâmetro obrigatório para a maioria das operações de tabela. Você pode consultar a tabela Projetos para obter esse valor.

  Se você não especificar o ProjectId propriedade da conexão, o conector usará o primeiro ID do projeto retornado da tabela Projetos em sua primeira autenticação no Basecamp.

• AccountId: Você pode encontrar o AccountId na URL depois de fazer login no Basecamp em um navegador da web:

  http://basecamp.com/<AccountId>
  

Autenticação no Basecamp

Basecamp 2 usa autenticação básica ou OAuth 2.0. Você pode usar autenticação básica para se conectar à sua própria conta ou pode usar OAuth para permitir que outros usuários façam login em suas próprias contas.

Basecamp 3 requer OAuth 2.0.

Autenticar Via Autenticação Básica

Na autenticação básica, você usa suas credenciais de login para se conectar. Defina as seguintes propriedades:

• User: Este é o nome de usuário que você usa para fazer login no Basecamp.
• Password: Esta é a senha que você usa para entrar no Basecamp.
• AuthScheme: Defina como Básico.

Autenticar Via Autenticação OAuth

Para usar OAuth, defina o AuthScheme para OAuth.

Você pode se conectar sem definir nenhuma propriedade de conexão para suas credenciais de usuário. Definir InitiateOAuth para GETANDREFRESH para evitar repetir a troca OAuth e definir manualmente o OAuthAccessToken.

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

1. Extrai o token de acesso da 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.

Consulte Usando autenticação OAuth para outros fluxos de autenticação OAuth.

Usando Autenticação OAuth

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

Credenciais Incorporadas

Consulte Credenciais incorporadas para se conectar com as credenciais incorporadas do conector e pule a criação de um aplicativo OAuth personalizado.

Credenciais Personalizadas

Em vez de se conectar com as credenciais incorporadas do conector, você pode registrar um aplicativo para obter o OAuthClientId e OAuthClientSecret.

Quando Criar um Aplicativo OAuth Personalizado

A criação de um aplicativo OAuth personalizado é opcional, pois o conector já está registrado no Basecamp e você pode se conectar com suas credenciais incorporadas. Talvez você queira criar um aplicativo OAuth personalizado para alterar as informações exibidas quando os usuários fazem login no endpoint Basecamp OAuth para conceder permissões ao conector.

Criando um Aplicativo OAuth Personalizado

Consulte Criando um aplicativo OAuth personalizado para um procedimento.

Credenciais Incorporadas

Autenticar Usando as Credenciais OAuth Incorporadas

Autenticação de Desktop com o Aplicativo OAuth Integrado

Você pode se conectar sem definir nenhuma propriedade de conexão para suas credenciais de usuário. Depois de definir o seguinte, você está pronto para se conectar:

• InitiateOAuth: Defina como GETANDREFRESH. Você pode usar InitiateOAuth para evitar repetir a troca de OAuth e configurar manualmente o OAuthAccessToken.

• AccountId: Copie isso da URL depois de fazer login no Basecamp:

  https://basecamp.com/<AccountId>
  

• Schema: Defina como "V2" ou "V3" para conectar-se às contas Basecamp 2 ou Basecamp 3.

• ProjectId: Para a maioria das operações de tabela, um ProjectId é um parâmetro obrigatório. Você pode consultar a tabela Projetos para obter esse valor.

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.

Credenciais Personalizadas

Quando Usar um Aplicativo OAuth Personalizado

A criação de um aplicativo OAuth personalizado é opcional, pois o conector já está registrado no Basecamp e você pode se conectar com suas credenciais incorporadas.

Talvez você queira criar um aplicativo OAuth personalizado para alterar as informações exibidas quando os usuários fazem login no Basecamp para conceder permissões ao conector.

Autenticação de Desktop com um Aplicativo OAuth Personalizado

Siga as etapas abaixo para autenticar com as credenciais de um aplicativo OAuth personalizado. Consulte Criando um aplicativo OAuth personalizado Para maiores informações.

Obtenha e Atualize o Token de Acesso OAuth

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

• OAuthClientId: Defina isso para o ID do cliente atribuído quando você registrou seu aplicativo.

• OAuthClientSecret: Defina isso como o segredo do cliente atribuído quando você registrou seu aplicativo.

• CallbackURL: Defina isso para o URI de redirecionamento definido quando você registrou seu aplicativo.

• InitiateOAuth: Defina como GETANDREFRESH. Você pode usar InitiateOAuth para evitar repetir a troca de OAuth e configurar manualmente o OAuthAccessToken.

• AccountId: Copie isso da URL depois de fazer login no Basecamp:

  https://basecamp.com/<AccountId>
  

• Schema: Defina como "V2" ou "V3" para conectar-se às contas Basecamp 2 ou Basecamp 3.

• ProjectId: Para a maioria das operações de tabela, um ProjectId é um parâmetro obrigatório. Você pode consultar a tabela Projetos para obter esse valor.

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. Atualiza o token de acesso quando ele 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 Basecamp em servidores headless ou outras máquinas nas quais o conector não pode abrir um navegador, você precisa autenticar de 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 OAuth Incorporadas

Obtenha um código verificador

Siga as etapas abaixo para autenticar em outra máquina e obter o OAuthVerifier propriedade da conexão:

1. Clique no link a seguir para abrir o endpoint Basecamp OAuth em seu navegador.
2. Efetue 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.

• OAuthVerifier: Defina isso para o código do verificador.

• InitiateOAuth: Configure para ATUALIZAR.

• OAuthSettingsLocation: Defina para manter os valores de autenticação OAuth criptografados no arquivo especificado.

• AccountId: Copie isso da URL depois de fazer login no Basecamp:

  https://basecamp.com/<AccountId>
  

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 conector para habilitar a atualização automática do token de acesso.

• InitiateOAuth: Configure para ATUALIZAR.

• AccountId: Copie isso da URL depois de fazer login no Basecamp:

  https://basecamp.com/<AccountId>
  

• Schema: Defina como "V2" ou "V3" para conectar-se às contas Basecamp 2 ou Basecamp 3.

• ProjectId: Para a maioria das operações de tabela, um ProjectId é um parâmetro obrigatório. Você pode consultar a tabela Projetos para obter esse valor.

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.

• AccountId: Copie isso da URL depois de fazer login no Basecamp:

  https://basecamp.com/<AccountId>
  

Teste a conexão para autenticar no navegador. 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.

• AccountId: Copie isso da URL depois de fazer login no Basecamp:

  https://basecamp.com/<AccountId>
  

• Schema: Defina como "V2" ou "V3" para conectar-se às contas Basecamp 2 ou Basecamp 3.

• ProjectId: Para a maioria das operações de tabela, um ProjectId é um parâmetro obrigatório. Você pode consultar a tabela Projetos para obter esse valor.

Usando as Credenciais para um Aplicativo OAuth Personalizado

Crie um aplicativo OAuth personalizado

A criação de um aplicativo OAuth customizado é opcional no fluxo OAuth headless; você pode ignorar a criação de um aplicativo conectando-se com as credenciais OAuth incorporadas do conector. Talvez você queira criar um aplicativo OAuth personalizado para alterar as informações exibidas quando os usuários fazem login no Basecamp para conceder permissões ao conector.

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 cliente nas configurações do aplicativo.

• OAuthClientSecret: Defina isso como o segredo do cliente nas configurações do aplicativo.

• AccountId: Copie isso da URL depois de fazer login no Basecamp:

  https://basecamp.com/<AccountId>
  

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.

• AccountId: Copie isso da URL depois de fazer login no Basecamp:

  https://basecamp.com/<AccountId>
  

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

• 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.

• 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.

• AccountId: Copie isso da URL depois de fazer login no Basecamp:

  https://basecamp.com/<AccountId>
  

• Schema: Defina como "V2" ou "V3" para conectar-se às contas Basecamp 2 ou Basecamp 3.

• ProjectId: Para a maioria das operações de tabela, um ProjectId é um parâmetro obrigatório. Você pode consultar a tabela Projetos para obter esse valor.

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 para o ID do cliente atribuído quando você registrou seu aplicativo.

• OAuthClientSecret: Defina isso como o segredo do cliente atribuído quando você registrou seu aplicativo.

• CallbackURL: Defina isso para o URI de redirecionamento que você especificou nas configurações do aplicativo.

• AccountId: Copie isso da URL depois de fazer login no Basecamp:

  https://basecamp.com/<AccountId>
  

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.

• 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.

• 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.

• AccountId: Copie isso da URL depois de fazer login no Basecamp:

  https://basecamp.com/<AccountId>
  

• Schema: Defina como "V2" ou "V3" para conectar-se às contas Basecamp 2 ou Basecamp 3.

• ProjectId: Para a maioria das operações de tabela, um ProjectId é um parâmetro obrigatório. Você pode consultar a tabela Projetos para obter esse valor.

Criando um Aplicativo OAuth Personalizado

Quando Criar um Aplicativo OAuth Personalizado

A criação de um aplicativo OAuth personalizado é opcional, pois o conector já está registrado no Basecamp e você pode se conectar com suas credenciais incorporadas.

Talvez você queira criar um aplicativo OAuth personalizado para alterar as informações exibidas quando os usuários fazem login no endpoint Basecamp OAuth para conceder permissões ao conector.

Siga as etapas abaixo para criar um aplicativo OAuth personalizado e obter as propriedades de conexão em um fluxo de autenticação OAuth específico.

Crie um Aplicativo OAuth Personalizado: Área de Trabalho

Registre seu aplicativo Basecamp em integrado.37signals.com para obter as seguintes propriedades de conexão:

• OAuthClientId
• OAuthClientSecret
• CallbackURL

Definir URI de redirecionamento para http://localhost:portnumber e definir CallbackURL a combinar. Você pode especificar qualquer porta disponível.

Características Avançadas

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

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 Basecamp 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 em que você não pode controlar diretamente a consultar que está sendo emitida para o driver, por exemplo, ao usar o driver da 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 Projects 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 Basecamp modela as APIs Basecamp 2 e Basecamp como tabelas relacionais, 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 entidades disponíveis, bem como quaisquer limitações e requisitos de API para consultar essas entidades, estão documentadas em Basecamp 2 Data Model e Modelo de Dados Basecamp 3. Você pode usar o SupportEnhancedSQL recurso, definido por padrão, para contornar a maioria dessas limitações.

Visão geral

Os Modelos de Dados ilustram um exemplo de como pode ser o seu ambiente Basecamp. O modelo de dados real será obtido dinamicamente com base na sua conta do Basecamp.

Características principais

• Tabelas e visualizações são definidas dinamicamente para modelar calendários, documentos e projetos no Basecamp.
• Procedimentos armazenados* permitem que você execute operações no Basecamp, incluindo download e upload de objetos.
• A conectividade ao vivo com esses objetos significa que quaisquer alterações em sua conta do Basecamp são refletidas imediatamente ao usar o conector.

Modelo de Dados Basecamp 2

Modelo de Dados Basecamp 2 descreve os esquemas disponíveis para se conectar às contas do Basecamp 2. Você pode usar tabelas para trabalhar com dados ao vivo do Basecamp. Você pode usar procedimentos armazenados* fornecido pelo Jitterbit Connector for Basecamp para automatizar o trabalho com dados do Basecamp.

Modelo de Dados Basecamp 3

Modelo de Dados Basecamp 3 descreve os esquemas disponíveis para se conectar às contas do Basecamp 3. Você pode usar tabelas para trabalhar com dados ao vivo do Basecamp. Você pode usar procedimentos armazenados* fornecido pelo Jitterbit Connector for Basecamp para automatizar o trabalho com dados do Basecamp.

Modelo de Dados Basecamp 2

Esta seção documenta as Tabelas, Visualizações e Procedimentos armazenados disponível para conectar-se a contas do Basecamp 2.

Tabelas

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

Geralmente, consultar tabelas Basecamp é 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 Basecamp

Acessos

Recupere, conceda e negue permissões de acesso a projetos e calendários no Basecamp.

Informações Específicas da Tabela

Selecione

Você precisa especificar um ProjectId ou CalendarId para recuperar acessos. Essas colunas também são as únicas colunas suportadas pelo Basecamp como critérios de filtro; eles podem ser usados com o operador '='.

SELECT * FROM Accesses WHERE ProjectId = '11111111'
SELECT * FROM Accesses WHERE CalendarId = '11111111'

Inserir

Você pode conceder a alguém acesso a um projeto ou calendário usando seus endereços E-mail ou IDs (se já fizerem parte da organização).

INSERT INTO Accesses (ProjectId, EmailAddresses) VALUES ('11111111', 'someone@example.com, someoneelse@example.com')

INSERT INTO Accesses (CalendarId, Ids) VALUES ('11111111', '123456789, 987654321')

Atualizar

A atualização não é uma operação suportada para os acessos à tabela.

Excluir

Para revogar o acesso a alguém de um projeto ou calendário, especifique ProjectId ou CalendarId e o ID da pessoa.

DELETE FROM Accesses WHERE ProjectId = '11111111' AND Id = '123456789'
DELETE FROM Accesses WHERE CalendarId = '11111111' AND ID = '123456789'

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.

CalendárioEventos

Recupere, crie, atualize e exclua eventos do calendário no Basecamp.

Informações Específicas da Tabela

Selecione

O Basecamp suporta apenas um subconjunto limitado de colunas a serem usadas como critérios de filtro na cláusula WHERE. Todas as colunas booleanas desta tabela podem ser usadas com o operador '='. ProjectId, CalendarId, StartsAt e EndsAt também podem ser usados com o operador "=". Além disso, a coluna StartsAt pode ser usada com o operador '>='.

A consultar a seguir filtra um intervalo de tempo específico.

SELECT * FROM CalendarEvents WHERE StartsAt = '2016-01-01' AND EndsAt = '2016-02-01'

As consultas a seguir obtêm CalendarEvents para um determinado projeto ou calendário.

SELECT * FROM CalendarEvents WHERE ProjectId= '123456768'
SELECT * FROM CalendarEvents WHERE CalendarId = '123456768'

Inserir

Especifique ProjectId ou CalendarId e StartsAt ao criar um novo CalendarEvent.

INSERT INTO CalendarEvents (ProjectId, Summary, Description, AllDay, StartsAt) VALUES ('12345678', 'My single, all-day Project event', 'Details to follow', 'true', 2016-02-01)

Atualizar e Excluir

Especifique ProjectId ou CalendarId e CalendarEvent ID ao atualizar ou excluir CalendarEvents.

UPDATE CalendarEvents SET Summary = 'Updated, two-day Project event', Description = 'Details to follow', AllDay = 'true', StartsAt = '2016-01-01', EndsAt = '2016-01-03' WHERE ProjectId = '12345678' AND Id = '12345678'

DELETE FROM CalendarEvents WHERE ProjectId = '12345678' AND ID = '12345678'

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.

Calendários

Recupere, crie, atualize e exclua calendários no Basecamp.

Informações Específicas da Tabela

Selecione

Selecione tudo em Calendários ou especifique um ID para recuperar mais detalhes em um determinado Calendário (Id é a única coluna suportada como critério de pesquisa pelo Basecamp).

SELECT * FROM Calendars WHERE ID = '123456789'

Inserir

Especifique (pelo menos) a propriedade Nome para criar um novo Calendário na organização.

INSERT INTO Calendars (Name) VALUES ('New Test Calendar')

Atualizar e Excluir

Especifique uma ID de calendário para atualizar ou excluir calendários. Defina a propriedade Name novamente se estiver atualizando.

UPDATE Calendars SET Name = 'This is a new name for the Test Calendar.' WHERE Id = '123456789'

DELETE FROM Calendars WHERE ID = '123456789'

Colunas

Documentos

Recupere, crie, atualize e exclua documentos no Basecamp.

Informações Específicas da Tabela

Selecione

Você pode recuperar todos os documentos (para todos os projetos), selecionar documentos pertencentes apenas a um determinado projeto ou especificar um projeto e um determinado documento ao mesmo tempo (ProjectId e ID são as únicas colunas suportadas como critérios de pesquisa pelo Basecamp).

Você também pode classificar documentos por UpdatedAt, CreatedAt ou Title.

SELECT * FROM Documents WHERE ProjectId = '11111111' AND Id = '1234567689'

SELECT * FROM Documents ORDER BY UpdatedAt

SELECT * FROM Documents ORDER BY Title DESC

Inserir

Para adicionar um novo documento a um projeto principal, especifique o ProjectId e forneça o título do documento ou algum conteúdo.

INSERT INTO Documents (ProjectId, Title, Content) VALUES ('11111111', 'Memo', 'This is our document content')

Atualizar e Excluir

Especifique o ProjectId e o ID do documento para atualizar ou excluir um documento.

UPDATE Documents SET Title = 'Updated Memo3', Content = 'Updated Content of Memo.' WHERE ProjectId = '11111111' AND Id = '1234567689'

DELETE FROM Documents WHERE ProjectId = '11111111' AND ID = '12345678'

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.

Pessoas

Recupere e exclua pessoas no Basecamp.

Informações Específicas da Tabela

Selecione

Recupere todas as pessoas da organização, especifique um ID para obter mais informações ou veja quem foi excluído (é necessário acesso de administrador). ID e Trashed são as colunas suportadas pelo Basecamp como critérios de pesquisa.

SELECT * FROM People WHERE Id = '123456789'

SELECT * FROM People WHERE Trashed = true

Inserir

Novas Pessoas podem ser convidadas diretamente para Projetos através da tabela Acessos.

Atualizar

A atualização não é uma operação com suporte para a tabela Pessoas.

Excluir

Especifique o ID da pessoa para excluir o registro da organização.

DELETE FROM People WHERE ID = '123456789'

Colunas

Projetos

Recupere, crie, atualize e exclua projetos no Basecamp.

Informações Específicas da Tabela

Selecione

Você pode recuperar todos os projetos ativos da organização, filtrar registros por rascunhos e projetos arquivados ou simplesmente definir uma ID de projeto para obter mais informações. Rascunhos, Arquivados e ID são as colunas suportadas como critérios de pesquisa pelo Basecamp.

SELECT * FROM Projects WHERE Drafts = True
SELECT * FROM Projects WHERE Advanced = True
SELECT * FROM Projects WHERE ID = '11111111'

Inserir

Especifique as propriedades Nome e Descrição no mínimo para criar um novo Projeto.

INSERT INTO Projects (Name, Description) VALUES ('Test Proj', 'This is a new test project.')

Atualizar e Excluir

Basta definir o ID do projeto para atualizar ou excluir um projeto ao qual você tem acesso.

UPDATE Projects SET Name = 'Updated Proj', Description = 'This is an updated test project.' WHERE Id = '11111111'

DELETE FROM Projects WHERE ID = '11111111'

Colunas

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 Basecamp

Anexos

Recupere Anexos no Basecamp.

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.

Comentários

Recupere, crie, atualize e exclua calendários no Basecamp.

Informações Específicas da Tabela

Selecione

Você pode recuperar todos os Comentários ativos na plataforma, e qualquer campo da tabela pode filtrar o resultado.

SELECT * FROM Comments

SELECT * FROM Comments WHERE ProjectId = '1111111' AND ItemType = 'Message'

Colunas

Eventos

Recuperar eventos de atividade no Basecamp.

Informações Específicas da Tabela

Selecione

Você pode recuperar todos os eventos de atividade ou filtrar dados pela data de criação. As colunas e operadores suportados pelo Basecamp como critérios de pesquisa são mostrados abaixo.

Por exemplo, a consultar a seguir recupera a atividade que ocorre após a data especificada para a pessoa especificada:

SELECT * FROM Events WHERE CreatedAt >= '2016-01-01' AND PersonId = '1111111'

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.

Encaminha

Recupere Forwards no Basecamp.

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.

ToDoLists

Recupere ToDoLists no Basecamp.

Informações Específicas da Tabela

Selecione

As seguintes colunas são suportadas pelo Basecamp como critérios de pesquisa:

• ProjectId
• Eu ia
• PersonId
• Concluído
• Destruído
• Criado em

CreatedAt pode ser usado com '>' ou operadores '>='.

A consultar a seguir recupera apenas ToDoLists concluídos pertencentes a um determinado projeto desde uma determinada data.

SELECT * FROM ToDoLists WHERE ProjectId = '11111111' AND Completed = True AND CreatedAt > '2016-01-01'M

A consultar a seguir recupera um único ToDoList de um determinado projeto.

SELECT * FROM ToDoLists WHERE ProjectId = '11111111' AND ID = '123456789'

A consultar a seguir recupera ToDoLists atribuídos a uma determinada pessoa.

SELECT * FROM ToDoLists WHERE PersonId = '11111111'

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.

Tarefas

Recupere ToDos no Basecamp.

Informações Específicas da Tabela

Selecione

A seguir estão as colunas suportadas como critérios de pesquisa pelo Basecamp:

• ProjectId
• ToDoListId
• Eu ia
• Concluído
• Restante
• Destruído
• DueAt
• Devido a

DueAt e DueOn podem ser usados com '>' ou operadores'>='.

A consultar a seguir recupera apenas ToDos concluídos pertencentes a um determinado projeto.

SELECT * FROM ToDos WHERE ProjectId = '11111111' AND Completed = True

A consultar a seguir filtra os ToDos que vencem desde uma determinada data.

SELECT * FROM ToDos WHERE ProjectId = '11111111' AND DueAt > '2016-01-01'

A consultar a seguir lista os ToDos restantes que pertencem a uma lista ToDo.

SELECT * FROM ToDos WHERE ProjectId = '11111111' AND ToDoListId = '123456789' AND Remaining = true

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.

Tópicos

Recuperar Tópicos no Basecamp.

Informações Específicas da Tabela

Selecione

Você pode recuperar todos os tópicos ativos, classificar os tópicos que pertencem a um projeto ou apenas listar os tópicos arquivados (ProjectId e Archived são as únicas colunas suportadas como critérios de pesquisa pelo Basecamp).

SELECT * FROM Topics WHERE ProjectId = '1111111' ORDER BY UpdatedAt ASC

SELECT * FROM Topics WHERE ProjectId = '1111111' AND Archived = True

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 Basecamp

GetOAuthAccessToken

Obtém o token de acesso OAuth do Basecamp.

Entrada

Colunas do Conjunto de Resultados

GetOAuthAuthorizationURL

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

Entrada

Colunas do Conjunto de Resultados

PublishProject

Publicará (ativará) um projeto criado a partir de um modelo (rascunho do projeto).

Entrada

Colunas do Conjunto de Resultados

RefreshOAuthAccessToken

Atualiza o token de acesso OAuth usado para autenticação com vários serviços Basecamp.

Entrada

Colunas do Conjunto de Resultados

StarProject

Vai estrelar um projeto especificado.

Entrada

Colunas do Conjunto de Resultados

UnstarProject

Desmarcará um projeto especificado.

Entrada

Colunas do Conjunto de Resultados

Modelo de Dados do Basecamp 3

Esta seção documenta as Tabelas, Visualizações e Procedimentos armazenados disponível para se conectar a contas do Basecamp 3.

Tabelas

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

Geralmente, consultar tabelas Basecamp é 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 Basecamp

CalendárioEventos

Recupere eventos de calendário no Basecamp 3.

Informações Específicas da Tabela

Você pode consultar os eventos do calendário no projeto especificado.

Selecione

As seguintes colunas são suportadas como critérios de pesquisa pelo Basecamp:

• ProjectId
• CalendárioId
• Status (por padrão, apenas eventos ativos são recuperados)

Se ProjectId não for especificado na consultar, o ProjectId padrão será usado.

SELECT * FROM CalendarEvents WHERE ProjectId = '11111111' AND CalendarId = '22222222' AND Status = 'active'

Você também pode recuperar um único evento de calendário especificando o ID.

SELECT * FROM CalendarEvents WHERE  ProjectId = '11111111' AND ID = '33333333'

Inserir

Você pode inserir um novo evento de calendário fornecendo ProjectId, CalendarId, StartsAt, EndsAt e Summary como parâmetros necessários.

INSERT INTO CalendarEvents (ProjectId, CalendarId, Summary, StartsAt, EndsAt, Description, Notify, ParticipantsIds) VALUES ( '1111111', '2222222', 'summary test', '2017-11-11 09:00Z', '2017-11-11 11:00Z', 'description', 'false', '3333333, 4444444')

Atualizar

Você também pode alterar o evento do calendário fornecendo o ProjectId e o ID do evento.

UPDATE CalendarEvents SET Summary = 'Updated summary',  StartsAt =  '2017-11-12', EndsAt = '2017-11-12', AllDay = 'true' WHERE ProjectId = '11111111' AND ID = '1234567689'

Excluir

Os eventos do calendário não podem ser excluídos.

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.

Comentários

Recupere comentários em uma gravação do Basecamp 3.

Informações Específicas da Tabela

Selecione

As colunas em Comentários são filtradas no lado do cliente. Você pode obter todos os comentários de uma gravação especificando o RecordingId ou pode obter um determinado comentário especificando seu Id.

Se ProjectId não for especificado na consultar, o ProjectId padrão será usado.

SELECT * FROM Comments WHERE ProjectId = '11111111' AND RecordingId = '222222222' AND Content = 'Exempli gratia' AND CreatedAt < '2017-04-18T15:53:38.040-06:00'

Você também pode recuperar um único comentário especificando o ID (desde que tenha especificado o ProjectId na conexão)

SELECT * FROM Comments WHERE ID = '1234567'

Inserir

Você pode inserir um novo comentário, fornecendo ProjectId, RecordingId e Content necessários.

INSERT INTO Comments (Content, ProjectId, RecordingId) VALUES ('Very informative document. Thanks!', 114857506, 392946856)

Atualizar

Você pode alterar as colunas que não são somente leitura fornecendo Id, ProjectId e novos valores.

UPDATE Comments SET Content='I like this better now' WHERE ProjectId='18061798' AND Id='1308746423'

Excluir

Os comentários não podem ser excluídos (sem suporte da API).

Colunas

Documentos

Recupere, crie, atualize e exclua documentos no Basecamp 3.

Informações Específicas da Tabela

Selecione

Você pode recuperar todos os documentos pertencentes apenas a um determinado Projeto e Vault, ou especificar um Projeto e um determinado Documento ao mesmo tempo (ProjectId, VaultId e ID são as únicas colunas suportadas como critérios de pesquisa pelo Basecamp).

Se ProjectId não for especificado na consultar, o ProjectId padrão será usado.

SELECT * FROM Documents WHERE ProjectId = '11111111' AND VaultId = '222222222'

SELECT * FROM Documents WHERE ProjectId = '11111111' AND ID = '1234567689'

Inserir

Para adicionar um novo documento a um projeto importante, você precisa especificar ProjectId, Vaultid, Title, Content e Status (opcional).

INSERT INTO Documents (ProjectId, Vaultid, Title, Content, Status) VALUES ('11111111', '222222222', 'Memo', 'This is our document content', 'active')

Atualizar

Especifique o ProjectId e o ID do documento para atualizar um documento.

UPDATE Documents SET Title = 'Updated Memo3', Content = 'Updated Content of Memo.' WHERE ProjectId = '11111111' AND ID = '1234567689'

Excluir

DELETE não é compatível com esta tabela.

Colunas

Mensagens

Recupere mensagens no Basecamp 3.

Informações Específicas da Tabela

Você pode consultar as mensagens postadas no quadro de mensagens do projeto especificado.

Selecione

As colunas suportadas como critérios de pesquisa pelo Basecamp são ProjectId, MessageBoardId.

Se ProjectId não for especificado na consultar, o ProjectId padrão será usado.

SELECT * FROM Messages WHERE ProjectId = '11111111' AND MessageBoardId = '22222222'

Você também pode recuperar uma única mensagem especificando o ID.

SELECT * FROM Messages WHERE  ProjectId = '11111111' AND ID = '33333333'

Inserir

Você pode inserir uma nova mensagem, fornecendo o ProjectId, MessageBoardId e Subject necessários, além dos parâmetros relacionados à mensagem.

INSERT INTO Messages (ProjectId, MessageBoardId, Content, Subject, Status) VALUES ('1111111', '2222222', 'Content test', 'Subject test',  'active')

Atualizar

Você também pode atualizar as mensagens fornecendo o ProjectId e o ID da mensagem.

UPDATE Messages SET subject = 'Updated subject', content = 'Updated content'  WHERE ProjectId = '11111111' AND ID = '1234567689'

Excluir

As mensagens não podem ser excluídas.

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.

Projetos

Recupere, crie, atualize e exclua projetos no Basecamp 3.

Informações Específicas da Tabela

Selecione

Você pode recuperar todos os projetos ativos da organização ou definir um ID de projeto para recuperar um único projeto. ID é a única coluna suportada como critério de pesquisa pelo Basecamp.

SELECT * FROM Projects
SELECT * FROM Projects WHERE ID = '11111111'

Inserir

Especifique pelo menos as propriedades Nome e, opcionalmente, Descrição para criar um novo Projeto.

INSERT INTO Projects (Name, Description) VALUES ('Test Proj', 'This is a new test project.')

Atualizar e Excluir

Defina o ID do projeto para atualizar ou excluir um projeto ao qual você tem acesso.

UPDATE Projects SET Name = 'Updated Project', Description = 'This is an updated test project.' WHERE Id = '11111111'

DELETE FROM Projects WHERE ID = '11111111'

Colunas

ToDoLists

Recupere ToDoLists no Basecamp 3.

Informações Específicas da Tabela

Selecione

As seguintes colunas são suportadas pelo Basecamp como critérios de pesquisa:

• ProjectId
• ToDoSetId e Status
• ProjectId e ID

ToDoSetId pode ser recuperado na tabela Projetos.

A consultar a seguir recupera apenas listas de tarefas concluídas pertencentes a um determinado projeto e um determinado status. Se ProjectId não for especificado na consultar, o ProjectId padrão será usado.

SELECT * FROM ToDoLists WHERE ProjectId = '11111111' AND ToDoSetId = '2222222' AND Status = 'active'

A consultar a seguir recupera um único ToDoList de um determinado projeto.

SELECT * FROM ToDoLists WHERE ProjectId = '11111111' AND ID = '123456789'

Inserir

Especifique o Nome, ProjectId, Descrição (opcional) e o ToDoSetId para inserir uma lista de tarefas pendentes.

INSERT INTO ToDoLists (Name, Description, ProjectId, ToDoSetId) VALUES ('Name', 'desc', '11111111', '2222222')

Atualizar

O Basecamp permite alterar o nome e a descrição da lista de tarefas, desde que o ProjectId e o ID da lista de tarefas sejam incluídos na consultar:

UPDATE ToDoLists Set Name = 'Updated Name', Description = 'Updated desc' Where ProjectId = '11111111' AND ID = '1234567689'

Excluir

As listas de tarefas não podem ser excluídas.

Colunas

Tarefas

Recupere ToDos no Basecamp 3.

Informações Específicas da Tabela

Selecione

As seguintes colunas são suportadas como critérios de pesquisa pelo Basecamp:

• ProjectId
• ToDoListId
• Eu ia
• Concluído
• Status

Por padrão, apenas as tarefas ativas serão recuperadas.

Se ProjectId não for especificado na consultar, o ProjectId padrão será usado.

SELECT * FROM ToDos WHERE  ProjectId = '11111111' AND ToDoListId = '222222222' AND Status = 'active' AND Completed = True

Você também pode recuperar uma única tarefa especificando o Id.

SELECT * FROM ToDos WHERE  ProjectId = '11111111' AND ID = '33333333'

Inserir

Você pode inserir uma nova tarefa fornecendo o ProjectId, ToDoListId e Content necessários, além dos parâmetros relacionados à tarefa.

INSERT INTO ToDos (Content, Description, DueOn, StartsOn, AssigneeIds, ProjectId, ToDoListId) VALUES ('What to do','description','2017-11-11', '2017-11-12', '333333333','1111111111', '22222222')

Atualizar

Você pode alterar as colunas que não são somente leitura fornecendo ProjectId, ID de tarefa e novos valores.

UPDATE ToDos Set Content = 'Updated content' Where ProjectId = '11111111' AND ID = '1234567689'

Você pode alterar o estado Concluído da tarefa fornecendo o ProjectId e a ID da tarefa. A coluna Completed só pode ser atualizada de forma autônoma e outras colunas não podem ser atualizadas na mesma consultar.

UPDATE ToDos Set Completed = True Where ProjectId = '11111111' AND ID = '1234567689'

Excluir

As tarefas não podem ser excluídas.

Colunas

Cofres

Recupere Vaults (pastas) nas pastas do Basecamp 3.

Informações Específicas da Tabela

Todos os projetos têm um Vault principal (pasta). Vaults adicionais podem ser aninhados no Vault principal ou em qualquer Vault filho.

Selecione

As colunas suportadas como critérios de pesquisa pelo Basecamp são ProjectId, VaultId e Id. Se ProjectId não for especificado na consultar, o ProjectId padrão será usado.

SELECT * FROM Vaults WHERE  ProjectId = '11111111' AND VaultId = '222222222'

Você também pode recuperar uma única tarefa especificando o ID.

SELECT * FROM Vaults WHERE  ProjectId = '11111111' ID = '333333333'

Inserir

Você pode inserir um novo Vault fornecendo ProjectId, VaultId e Title, que são parâmetros obrigatórios.

INSERT INTO Vaults (Title, ProjectId, Vaultid) VALUES ('InsertedVault', '11111111', '222222222')

Atualizar

Você pode atualizar o título do Vault fornecendo ProjectId, VaultId e o novo título.

UPDATE Vaults SET Title = 'Updated title' WHERE ProjectId = '11111111' AND ID = '333333333'

Excluir

Os cofres não podem ser excluídos.

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 Basecamp

Atribuições

Recupere atribuições no Basecamp 3.

Colunas

Calendários

Recupere calendários no Basecamp 3.

Informações Específicas da Tabela

Existe apenas um Calendário (Agenda) em cada projeto Basecamp.

Selecione

Recupere mais detalhes em um calendário específico (ProjectId e ID são as únicas colunas suportadas como critérios de pesquisa pelo Basecamp). Se ProjectId não for especificado na consultar, o ProjectId padrão será usado.

SELECT * FROM Calendars WHERE ProjectId = '111111111' AND ID = '123456789'

Colunas

Eventos

Recuperar eventos de atividade no Basecamp 3.

Ver Informações Específicas

Um evento é criado sempre que uma gravação é alterada.

Selecione

Você pode recuperar todos os eventos de atividade no projeto e gravação especificados. As colunas suportadas como critérios de pesquisa pelo Basecamp são ProjectId e RecordingId.

Se ProjectId não for especificado na consultar, o ProjectId padrão será usado.

SELECT * FROM Events WHERE ProjectId = '1111111' AND RecordingId = '22222222'

Colunas

Pessoas

Recupere pessoas no Basecamp 3.

Ver Informações Específicas

Selecione

Recupere todas as pessoas visíveis para o usuário atual, liste as pessoas por projeto ou especifique uma ID para obter mais informações. ID e ProjectId são as colunas suportadas pelo Basecamp como critérios de pesquisa.

SELECT * FROM People

SELECT * FROM People WHERE Id = '123456789'

SELECT * FROM People WHERE ProjectId = '5168618'

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.

Gravações

Recupere as gravações nas pastas do Basecamp 3.

Ver Informações Específicas

Recupere a maioria das estruturas de dados no Basecamp 3, que são representadas como "Gravações".

Selecione

As colunas suportadas como critérios de pesquisa pelo Basecamp são Type (parâmetro obrigatório), Bucket e Status.

SELECT * FROM Recordings WHERE type = 'Upload' AND Bucket = '1111111, 22222222' AND Status = 'active'

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.

Uploads

Recuperar uploads no Basecamp 3.

Colunas

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 Basecamp

GetOAuthAccessToken

Obtém o token de acesso OAuth do Basecamp.

Entrada

Colunas do Conjunto de Resultados

GetOAuthAuthorizationURL

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

Entrada

Colunas do Conjunto de Resultados

RefreshOAuthAccessToken

Atualiza o token de acesso OAuth usado para autenticação com vários serviços Basecamp.

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 os metadados do banco de dados para o Basecamp:

• 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 Projetos:

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

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 RefreshOAuthAccessToken:

SELECT * FROM sys_procedureparameters WHERE ProcedureName='RefreshOAuthAccessToken' 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 Projetos:

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

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:basecamp: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 de Consultas Colaborativas

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.