Detalles de la Conexión del Basecamp

Introducción

Versión del conector

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

Empezando

Compatibilidad con la versión Basecamp

Los modelos de conector Basecamp 2 y Basecamp 3 cuentan como tablas bidireccionales.

Establecer una Conexión

Conexión a Basecamp

Además de la autenticación, establezca las siguientes propiedades de conexión para acceder a las tablas de Basecamp.

• Schema: Configure esto en "V2" o "V3" para conectarse a una cuenta de Basecamp 2 o Basecamp 3.

• ProjectId: Este es un parámetro requerido para la mayoría de las operaciones de tablas. Puede consultar la tabla Proyectos para obtener este valor.

  Si no especifica el ProjectId propiedad de conexión, el conector utilizará el primer ID de proyecto devuelto de la tabla Proyectos en su primera autenticación en Basecamp.

• AccountId: Puedes encontrar el AccountId en la URL después de iniciar sesión en Basecamp en un navegador web:

  http://basecamp.com/<AccountId>
  

Autenticación en Basecamp

Basecamp 2 usa autenticación básica o OAuth 2.0. Puede usar la autenticación básica para conectarse a su propia cuenta, o puede usar OAuth para permitir que otros usuarios inicien sesión en sus propias cuentas.

Basecamp 3 requiere OAuth 2.0.

Autenticar a Través de la Autenticación Básica

En la autenticación básica, utiliza sus credenciales de inicio de sesión para conectarse. Establezca las siguientes propiedades:

• User: Este es el nombre de usuario que utiliza para iniciar sesión en Basecamp.
• Password: Esta es la contraseña que usa para iniciar sesión en Basecamp.
• AuthScheme: Establézcalo en Básico.

Autenticar a Través de Autenticación OAuth

Para usar OAuth, establezca AuthScheme a OAuth.

Puede conectarse sin configurar ninguna propiedad de conexión para sus credenciales de usuario. Colocar InitiateOAuth a GETANDREFRESH para evitar repetir el intercambio de OAuth y configurar manualmente OAuthAccessToken.

Cuando te conectas, el conector abre el extremo de Basecamp OAuth en tu navegador predeterminado. Inicie sesión y otorgue permisos al conector. Luego, el conector completa el siguiente proceso de OAuth:

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

Consulte Uso de la autenticación OAuth para otros flujos de autenticación OAuth.

Uso de la Autenticación OAuth

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

Credenciales Integradas

Consulte Credenciales integradas para conectarse con las credenciales incrustadas del conector y omitir la creación de una aplicación OAuth personalizada.

Credenciales Personalizadas

En lugar de conectarse con las credenciales integradas del conector, puede registrar una aplicación para obtener OAuthClientId y OAuthClientSecret.

Cuándo Crear una Aplicación OAuth Personalizada

La creación de una aplicación OAuth personalizada es opcional, ya que el conector ya está registrado con Basecamp y puede conectarse con sus credenciales integradas. Es posible que desee crear una aplicación de OAuth personalizada para cambiar la información que se muestra cuando los usuarios inician sesión en el extremo de OAuth de Basecamp para otorgar permisos al conector.

Creación de una Aplicación OAuth Personalizada

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

Credenciales Integradas

Autenticarse con las Credenciales de OAuth Integradas

Autenticación de Escritorio con la Aplicación OAuth Integrada

Puede conectarse sin configurar ninguna propiedad de conexión para sus credenciales de usuario. Después de configurar lo siguiente, está listo para conectarse:

• InitiateOAuth: Establézcalo en GETANDREFRESH. Puede usar InitiateOAuth para evitar repetir el intercambio de OAuth y configurar manualmente OAuthAccessToken.

• AccountId: Copie esto de la URL después de iniciar sesión en Basecamp:

  https://basecamp.com/<AccountId>
  

• Schema: Configure esto en "V2" o "V3" para conectarse a las cuentas de Basecamp 2 o Basecamp 3.

• ProjectId: Para la mayoría de las operaciones con tablas, ProjectId es un parámetro obligatorio. Puede consultar la tabla Proyectos para obtener este valor.

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

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

Credenciales Personalizadas

Cuándo Usar una Aplicación OAuth Personalizada

La creación de una aplicación OAuth personalizada es opcional, ya que el conector ya está registrado con Basecamp y puede conectarse con sus credenciales integradas.

Es posible que desee crear una aplicación OAuth personalizada para cambiar la información que se muestra cuando los usuarios inician sesión en Basecamp para otorgar permisos al conector.

Autenticación de Escritorio con una Aplicación OAuth Personalizada

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

Obtenga y Actualice el Token de Acceso de OAuth

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

• OAuthClientId: Establézcalo en el ID de cliente asignado cuando registró su aplicación.

• OAuthClientSecret: establezca esto en el secreto de cliente asignado cuando registró su aplicación.

• CallbackURL: establezca esto en el URI de redirección definido cuando registró su aplicación.

• InitiateOAuth: Establézcalo en GETANDREFRESH. Puede usar InitiateOAuth para evitar repetir el intercambio de OAuth y configurar manualmente OAuthAccessToken.

• AccountId: Copie esto de la URL después de iniciar sesión en Basecamp:

  https://basecamp.com/<AccountId>
  

• Schema: Configure esto en "V2" o "V3" para conectarse a las cuentas de Basecamp 2 o Basecamp 3.

• ProjectId: Para la mayoría de las operaciones con tablas, ProjectId es un parámetro obligatorio. Puede consultar la tabla Proyectos para obtener este valor.

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

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

Máquinas Sin Cabeza

Uso de OAuth en una Máquina Sin Cabeza

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

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

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

Uso de las Credenciales de OAuth Integradas

Obtenga un código verificador

Siga los pasos a continuación para autenticarse desde otra máquina y obtener el OAuthVerifier propiedad de conexión:

1. Haga clic en el siguiente enlace para abrir el extremo de Basecamp OAuth en su navegador.
2. Inicie sesión y otorgue permisos al conector. A continuación, se le redirige a la URL de devolución de llamada, que contiene el código verificador.
3. Guarde el valor del código verificador. Establecerá esto en el OAuthVerifier propiedad de conexión.

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

• OAuthVerifier: Establézcalo en el código del verificador.

• InitiateOAuth: Establézcalo en ACTUALIZAR.

• OAuthSettingsLocation: configure esto para conservar los valores de autenticación OAuth cifrados en el archivo especificado.

• AccountId: Copie esto de la URL después de iniciar sesión en Basecamp:

  https://basecamp.com/<AccountId>
  

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

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

• InitiateOAuth: Establézcalo en ACTUALIZAR.

• AccountId: Copie esto de la URL después de iniciar sesión en Basecamp:

  https://basecamp.com/<AccountId>
  

• Schema: Configure esto en "V2" o "V3" para conectarse a las cuentas de Basecamp 2 o Basecamp 3.

• ProjectId: Para la mayoría de las operaciones con tablas, ProjectId es un parámetro obligatorio. Puede consultar la tabla Proyectos para obtener este valor.

Transferir configuración de OAuth

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

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

• OAuthSettingsLocation: establezca esto en un archivo de texto grabable.

• InitiateOAuth: Establézcalo en GETANDREFRESH.

• AccountId: Copie esto de la URL después de iniciar sesión en Basecamp:

  https://basecamp.com/<AccountId>
  

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

• InitiateOAuth: Establézcalo en ACTUALIZAR.

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

• AccountId: Copie esto de la URL después de iniciar sesión en Basecamp:

  https://basecamp.com/<AccountId>
  

• Schema: Configure esto en "V2" o "V3" para conectarse a las cuentas de Basecamp 2 o Basecamp 3.

• ProjectId: Para la mayoría de las operaciones con tablas, ProjectId es un parámetro obligatorio. Puede consultar la tabla Proyectos para obtener este valor.

Uso de las Credenciales para una Aplicación OAuth Personalizada

Cree una aplicación OAuth personalizada

La creación de una aplicación de OAuth personalizada es opcional en el flujo de OAuth sin interfaz; puede omitir la creación de una aplicación conectándose con las credenciales de OAuth integradas del conector. Es posible que desee crear una aplicación OAuth personalizada para cambiar la información que se muestra cuando los usuarios inician sesión en Basecamp para otorgar permisos al conector.

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

Obtenga un código verificador

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

• InitiateOAuth: Ajústelo a APAGADO.

• OAuthClientId: establezca esto en la ID del cliente en la configuración de su aplicación.

• OAuthClientSecret: establezca esto en el secreto del cliente en la configuración de su aplicación.

• AccountId: Copie esto de la URL después de iniciar sesión en Basecamp:

  https://basecamp.com/<AccountId>
  

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

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

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

• OAuthClientId: establezca esto en la clave de consumidor en la configuración de su aplicación.

• OAuthClientSecret: establezca esto en el secreto del consumidor en la configuración de su aplicación.

• OAuthVerifier: Establézcalo en el código del verificador.

• OAuthSettingsLocation: configure esto para conservar los valores de autenticación OAuth cifrados en el archivo especificado.

• InitiateOAuth: Establézcalo en ACTUALIZAR.

• AccountId: Copie esto de la URL después de iniciar sesión en Basecamp:

  https://basecamp.com/<AccountId>
  

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

• OAuthClientId: establezca esto en la clave de consumidor en la configuración de su aplicación.

• OAuthClientSecret: establezca esto en el secreto del consumidor en la configuración de su aplicación.

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

• InitiateOAuth: Establézcalo en ACTUALIZAR.

• AccountId: Copie esto de la URL después de iniciar sesión en Basecamp:

  https://basecamp.com/<AccountId>
  

• Schema: Configure esto en "V2" o "V3" para conectarse a las cuentas de Basecamp 2 o Basecamp 3.

• ProjectId: Para la mayoría de las operaciones con tablas, ProjectId es un parámetro obligatorio. Puede consultar la tabla Proyectos para obtener este valor.

Transferir configuración de OAuth

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

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

• OAuthSettingsLocation: establezca esto en un archivo de texto grabable.

• InitiateOAuth: Establézcalo en GETANDREFRESH.

• OAuthClientId: Establézcalo en el ID de cliente asignado cuando registró su aplicación.

• OAuthClientSecret: establezca esto en el secreto de cliente asignado cuando registró su aplicación.

• CallbackURL: establezca esto en el URI de redirección que especificó en la configuración de su aplicación.

• AccountId: Copie esto de la URL después de iniciar sesión en Basecamp:

  https://basecamp.com/<AccountId>
  

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

• InitiateOAuth: Establézcalo en ACTUALIZAR.

• OAuthClientId: establezca esto en la clave de consumidor en la configuración de su aplicación.

• OAuthClientSecret: establezca esto en el secreto del consumidor en la configuración de su aplicación.

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

• AccountId: Copie esto de la URL después de iniciar sesión en Basecamp:

  https://basecamp.com/<AccountId>
  

• Schema: Configure esto en "V2" o "V3" para conectarse a las cuentas de Basecamp 2 o Basecamp 3.

• ProjectId: Para la mayoría de las operaciones con tablas, ProjectId es un parámetro obligatorio. Puede consultar la tabla Proyectos para obtener este valor.

Creación de una Aplicación OAuth Personalizada

Cuándo Crear una Aplicación OAuth Personalizada

La creación de una aplicación OAuth personalizada es opcional, ya que el conector ya está registrado con Basecamp y puede conectarse con sus credenciales integradas.

Es posible que desee crear una aplicación de OAuth personalizada para cambiar la información que se muestra cuando los usuarios inician sesión en el extremo de OAuth de Basecamp para otorgar permisos al conector.

Siga los pasos a continuación para crear una aplicación OAuth personalizada y obtener las propiedades de conexión en un flujo de autenticación OAuth específico.

Crear una Aplicación OAuth Personalizada: Escritorio

Registre su aplicación Basecamp en integrate.37signals.com para obtener las siguientes propiedades de conexión:

• OAuthClientId
• OAuthClientSecret
• CallbackURL

Establezca el URI de redirección en http://localhost:portnumber y establecer CallbackURL para combinar. Puede especificar cualquier puerto disponible.

Características Avanzadas

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

Vistas definidas por el usuario

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

Configuración SSL

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

Apoderado

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

Vistas Definidas por el Usuario

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

Hay dos formas de crear vistas definidas por el usuario:

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

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

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

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

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

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

Por ejemplo:

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

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

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

Esquema para Vistas Definidas por el Usuario

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

Trabajar con Vistas Definidas por el Usuario

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

SELECT * FROM Customers WHERE City = 'Raleigh';

Un ejemplo de una consultar al controlador:

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

Dando como resultado la consultar efectiva a la fuente:

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

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

Configuración SSL

Personalización de la Configuración SSL

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

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

Modelo de Datos

Jitterbit Connector for Basecamp modela las APIs de Basecamp 2 y Basecamp como tablas relacionales, vistas y procedimientos almacenados. Estos se definen en archivos de esquema, que son archivos de configuración simples basados en texto.

Las entidades disponibles, así como las limitaciones y los requisitos de la API para consultar estas entidades, se documentan en Modelo de datos de Basecamp 2 y Modelo de datos de Basecamp 3. Puedes usar el SupportEnhancedSQL función, configurada de forma predeterminada, para eludir la mayoría de estas limitaciones.

Descripción general

Los modelos de datos ilustran un ejemplo de cómo podría ser su ambiente Basecamp. El modelo de datos real se obtendrá dinámicamente en función de su cuenta de Basecamp.

Características clave

• Las tablas y las vistas se definen dinámicamente para modelar calendarios, documentos y proyectos en Basecamp.
• Procedimientos almacenados* le permiten ejecutar operaciones en Basecamp, incluida la descarga y carga de objetos.
• La conectividad en vivo a estos objetos significa que cualquier cambio en su cuenta de Basecamp se refleja de inmediato al usar el conector.

Modelo de datos Basecamp 2

Modelo de datos de Basecamp 2 describe los esquemas disponibles para conectarse a las cuentas de Basecamp 2. Puede usar tablas para trabajar con datos de Basecamp en vivo. Puede usar procedimientos almacenados* proporcionado por Jitterbit Connector for Basecamp para automatizar el trabajo con datos de Basecamp.

Modelo de datos de Basecamp 3

Modelo de datos de Basecamp 3 describe los esquemas disponibles para conectarse a las cuentas de Basecamp 3. Puede usar tablas para trabajar con datos de Basecamp en vivo. Puede usar procedimientos almacenados* proporcionado por Jitterbit Connector for Basecamp para automatizar el trabajo con datos de Basecamp.

Modelo de Datos de Basecamp 2

Esta sección documenta las Tablas, Puntos de vista y Procedimientos almacenados disponible para conectarse a las cuentas de Basecamp 2.

Mesas

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

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

Conector Jitterbit para Tablas Basecamp

Accesos

Recuperar, otorgar y denegar permisos de acceso a Proyectos y Calendarios en Basecamp.

Información Específica de la Tabla

Seleccionar

Debe especificar un ProjectId o CalendarId para recuperar los accesos. Estas columnas también son las únicas columnas admitidas por Basecamp como criterio de filtro; se pueden usar con el operador '='.

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

Insertar

Puede dar acceso a alguien a un proyecto o calendario utilizando sus direcciones de Correo o ID (si ya forman parte de la organización).

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

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

Actualizar

La actualización no es una operación admitida para la tabla Accesos.

Borrar

Para revocar el acceso a alguien desde un proyecto o calendario, especifique ProjectId o CalendarId y el ID de la persona.

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

Columnas

Pseudo-Columnas

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

CalendarioEventos

Recupere, cree, actualice y elimine eventos de calendario en Basecamp.

Información Específica de la Tabla

Seleccionar

Basecamp solo admite un subconjunto limitado de columnas para usar como criterio de filtro en la cláusula WHERE. Todas las columnas booleanas de esta tabla se pueden utilizar con el operador '='. ProjectId, CalendarId, StartsAt y EndsAt también se pueden usar con el operador "=". Además, la columna StartsAt se puede usar con el operador '>='.

La siguiente consultar filtra en un rango de tiempo particular.

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

Las siguientes consultas obtienen eventos de calendario para un determinado proyecto o calendario.

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

Insertar

Especifique ProjectId o CalendarId y StartsAt al crear un nuevo CalendarEvent.

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

Actualizar y Eliminar

Especifique ProjectId o CalendarId y CalendarEvent ID cuando actualice o elimine 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'

Columnas

Pseudo-Columnas

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

Calendarios

Recupere, cree, actualice y elimine calendarios en Basecamp.

Información Específica de la Tabla

Seleccionar

Seleccione todo de Calendarios o especifique una ID para recuperar más detalles en un Calendario determinado (Id es la única columna admitida como criterio de búsqueda por Basecamp).

SELECT * FROM Calendars WHERE ID = '123456789'

Insertar

Especifique (al menos) la propiedad Nombre para crear un nuevo Calendario en la organización.

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

Actualizar y Eliminar

Especifique una ID de calendario para actualizar o eliminar calendarios. Establezca la propiedad Nombre nuevamente si está actualizando.

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

DELETE FROM Calendars WHERE ID = '123456789'

Columnas

Documentos

Recupere, cree, actualice y elimine documentos en Basecamp.

Información Específica de la Tabla

Seleccionar

Puede recuperar todos los Documentos (para todos los Proyectos), seleccionar Documentos que pertenezcan solo a un determinado Proyecto, o especificar un Proyecto y un determinado Documento al mismo tiempo (ProjectId e ID son las únicas columnas admitidas como criterios de búsqueda por Basecamp).

También puede ordenar los documentos por Fecha de actualización, Fecha de creación o Título.

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

SELECT * FROM Documents ORDER BY UpdatedAt

SELECT * FROM Documents ORDER BY Title DESC

Insertar

Para agregar un nuevo documento a un proyecto principal, especifique ProjectId y proporcione el título del documento o algún contenido.

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

Actualizar y Eliminar

Especifique ProjectId y Document ID para actualizar o eliminar un 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'

Columnas

Pseudo-Columnas

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

Gente

Recupere y elimine Personas en Basecamp.

Información Específica de la Tabla

Seleccionar

Recupere a todas las personas de la organización, especifique una ID para obtener más información o vea quién ha sido eliminado (se requiere acceso de administrador). ID y Trash son las columnas admitidas por Basecamp como criterios de búsqueda.

SELECT * FROM People WHERE Id = '123456789'

SELECT * FROM People WHERE Trashed = true

Insertar

Se puede invitar a nuevas personas directamente a Proyectos a través de la tabla Accesos.

Actualizar

Actualizar no es una operación admitida para la tabla Personas.

Borrar

Especifique el ID de la persona para eliminar el registro de la organización.

DELETE FROM People WHERE ID = '123456789'

Columnas

Proyectos

Recupere, cree, actualice y elimine proyectos en Basecamp.

Información Específica de la Tabla

Seleccionar

Puede recuperar todos los proyectos activos de la organización, filtrar registros por borradores y proyectos archivados, o simplemente establecer una ID de proyecto para obtener más información. Borradores, Archivados e ID son las columnas admitidas como criterios de búsqueda por Basecamp.

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

Insertar

Especifique las propiedades Nombre y Descripción como mínimo para crear un nuevo Proyecto.

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

Actualizar y Eliminar

Simplemente configure el ID del proyecto para actualizar o eliminar un proyecto al que tenga acceso.

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

DELETE FROM Projects WHERE ID = '11111111'

Columnas

Puntos de Vista

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

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

Conector Jitterbit para Vistas de Basecamp

Archivos Adjuntos

Recuperar archivos adjuntos en Basecamp.

Columnas

Pseudo-Columnas

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

Comentarios

Recupere, cree, actualice y elimine calendarios en Basecamp.

Información Específica de la Tabla

Seleccionar

Puede recuperar todos los comentarios activos en la plataforma y cualquier campo de la tabla puede filtrar el resultado.

SELECT * FROM Comments

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

Columnas

Eventos

Recuperar eventos de actividad en Basecamp.

Información Específica de la Tabla

Seleccionar

Puede recuperar todos los eventos de actividad o filtrar datos por fecha de creación. Las columnas y operadores admitidos por Basecamp como criterios de búsqueda se muestran a continuación.

Por ejemplo, la siguiente consultar recupera la actividad que ocurre después de la fecha especificada para la persona especificada:

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

Columnas

Pseudo-Columnas

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

Hacia Adelante

Recuperar Delanteros en Basecamp.

Columnas

Pseudo-Columnas

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

Listas de Tareas Pendientes

Recupere ToDoLists en Basecamp.

Información Específica de la Tabla

Seleccionar

Las siguientes columnas son compatibles con Basecamp como criterio de búsqueda:

• Projecto ID
• Identificación
• ID de persona
• Completado
• Tirado a la basura
• Creado en

CreatedAt se puede usar con el '>' o operadores '>='.

La siguiente consultar recupera solo ToDoLists completadas que pertenecen a un proyecto determinado desde una fecha determinada.

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

La siguiente consultar recupera una sola ToDoList de un proyecto determinado.

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

La siguiente consultar recupera ToDoLists que están asignadas a una persona determinada.

SELECT * FROM ToDoLists WHERE PersonId = '11111111'

Columnas

Pseudo-Columnas

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

Tareas Pendientes

Recupera tareas pendientes en Basecamp.

Información Específica de la Tabla

Seleccionar

Las siguientes son columnas admitidas como criterios de búsqueda por Basecamp:

• Projecto ID
• ToDoListId
• Identificación
• Completado
• Restante
• Tirado a la basura
• Debido a
• Debido a

DueAt y DueOn se pueden usar con el '>' operadores o'>='.

La siguiente consultar recupera solo las tareas pendientes completadas que pertenecen a un determinado proyecto.

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

La siguiente consultar filtra las tareas pendientes que vencen desde una fecha determinada.

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

La siguiente consultar enumera las tareas pendientes restantes que pertenecen a una lista de tareas pendientes.

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

Columnas

Pseudo-Columnas

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

Temas

Recuperar temas en Basecamp.

Información Específica de la Tabla

Seleccionar

Puede recuperar todos los temas activos, ordenar los temas que pertenecen a un proyecto o solo enumerar los temas archivados (ProjectId y Archivado son las únicas columnas admitidas como criterios de búsqueda por Basecamp).

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

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

Columnas

Pseudo-Columnas

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

Procedimientos Almacenados

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

Conector Jitterbit para Procedimientos Almacenados de Basecamp

Obtener Token de Acceso de OAuth

Obtiene el token de acceso de OAuth de Basecamp.

Aporte

Columnas del Conjunto de Resultados

Obtener URL de Autorización de OAuth

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

Aporte

Columnas del Conjunto de Resultados

PublicarProyecto

Publicará (activará) un proyecto creado a partir de una modelo (borrador de proyecto).

Aporte

Columnas del Conjunto de Resultados

RefreshOAuthAccessToken

Actualiza el token de acceso de OAuth utilizado para la autenticación con varios servicios de Basecamp.

Aporte

Columnas del Conjunto de Resultados

Proyecto Estrella

Protagonizará un proyecto específico.

Aporte

Columnas del Conjunto de Resultados

UnstarProject

Desmarcará un proyecto específico.

Aporte

Columnas del Conjunto de Resultados

Modelo de Datos de Basecamp 3

Esta sección documenta las Tablas, Puntos de vista y Procedimientos almacenados disponible para conectarse a las cuentas de Basecamp 3.

Mesas

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

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

Conector Jitterbit para Tablas Basecamp

CalendarioEventos

Recupera eventos del calendario en Basecamp 3.

Información Específica de la Tabla

Puede consultar eventos de calendario en el proyecto especificado.

Seleccionar

Basecamp admite las siguientes columnas como criterios de búsqueda:

• Projecto ID
• ID de calendario
• Estado (por defecto solo se recuperan los eventos activos)

Si no se especifica ProjectId en la consultar, se utilizará el ProjectId predeterminado.

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

También puede recuperar un solo evento de calendario especificando el Id.

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

Insertar

Puede insertar un nuevo evento de calendario proporcionando ProjectId, CalendarId, StartsAt, EndsAt y Summary como parámetros obligatorios.

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

Actualizar

También puede cambiar el evento del calendario proporcionando el Id. del proyecto y el Id. del evento.

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

Borrar

Los eventos del calendario no se pueden eliminar.

Columnas

Pseudo-Columnas

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

Comentarios

Recuperar comentarios en una grabación de Basecamp 3.

Información Específica de la Tabla

Seleccionar

Las columnas en Comentarios se filtran del lado del cliente. Puede obtener todos los comentarios de una grabación especificando el RecordingId o puede obtener un comentario determinado especificando su Id.

Si no se especifica ProjectId en la consultar, se utilizará el ProjectId predeterminado.

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

También puede recuperar un solo comentario especificando el ID (dado que ha especificado ProjectId en la conexión)

SELECT * FROM Comments WHERE ID = '1234567'

Insertar

Puede insertar un nuevo comentario proporcionando el ProjectId, RecordingId y Content requeridos.

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

Actualizar

Puede cambiar las columnas que no son de solo lectura proporcionando el Id, ProjectId y nuevos valores.

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

Borrar

Los comentarios no se pueden eliminar (no es compatible con la API).

Columnas

Documentos

Recupere, cree, actualice y elimine documentos en Basecamp 3.

Información Específica de la Tabla

Seleccionar

Puede recuperar todos los documentos que pertenezcan a un determinado Proyecto y Vault únicamente, o especificar un Proyecto y un determinado Documento al mismo tiempo (ProjectId, VaultId e ID son las únicas columnas admitidas como criterios de búsqueda por Basecamp).

Si no se especifica ProjectId en la consultar, se utilizará el ProjectId predeterminado.

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

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

Insertar

Para agregar un nuevo documento a un proyecto principal, debe especificar ProjectId, Vaultid, Title, Content y Status (opcional).

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

Actualizar

Especifique ProjectId y el ID del documento para actualizar un documento.

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

Borrar

DELETE no es compatible con esta tabla.

Columnas

Mensajes

Recuperar mensajes en Basecamp 3.

Información Específica de la Tabla

Puede consultar los mensajes publicados en el tablero de mensajes del proyecto especificado.

Seleccionar

Las columnas admitidas como criterios de búsqueda por Basecamp son ProjectId, MessageBoardId.

Si no se especifica ProjectId en la consultar, se utilizará el ProjectId predeterminado.

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

También puede recuperar un solo mensaje especificando el Id.

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

Insertar

Puede insertar un nuevo mensaje proporcionando el ProjectId, MessageBoardId y Asunto requeridos además de los parámetros relacionados con el mensaje.

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

Actualizar

También puede actualizar los mensajes proporcionando el Id. del proyecto y el Id. del mensaje.

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

Borrar

Los mensajes no se pueden eliminar.

Columnas

Pseudo-Columnas

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

Proyectos

Recupere, cree, actualice y elimine proyectos en Basecamp 3.

Información Específica de la Tabla

Seleccionar

Puede recuperar todos los proyectos activos de la organización o establecer un ID de proyecto para recuperar un solo proyecto. ID es la única columna admitida como criterio de búsqueda por Basecamp.

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

Insertar

Especifique al menos las propiedades Nombre y, opcionalmente, Descripción para crear un nuevo Proyecto.

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

Actualizar y Eliminar

Configure el ID del proyecto para actualizar o eliminar un proyecto al que tenga acceso.

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

DELETE FROM Projects WHERE ID = '11111111'

Columnas

Listas de Tareas Pendientes

Recupere ToDoLists en Basecamp 3.

Información Específica de la Tabla

Seleccionar

Las siguientes columnas son compatibles con Basecamp como criterio de búsqueda:

• Projecto ID
• ToDoSetId y Estado
• ProyectoId e Id

ToDoSetId se puede recuperar en la tabla Proyectos.

La siguiente consultar recupera solo las listas de tareas completas que pertenecen a un proyecto determinado y un estado determinado. Si no se especifica ProjectId en la consultar, se utilizará el ProjectId predeterminado.

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

La siguiente consultar recupera una sola ToDoList de un proyecto determinado.

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

Insertar

Especifique el Nombre, ProjectId, Descripción (opcional) y ToDoSetId para insertar una lista de tareas pendientes.

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

Actualizar

Basecamp permite cambiar el nombre y la descripción de la lista de tareas, siempre que el ID del proyecto y la lista de tareas estén incluidos en la consultar:

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

Borrar

Las listas de tareas no se pueden eliminar.

Columnas

Tareas Pendientes

Recupera tareas pendientes en Basecamp 3.

Información Específica de la Tabla

Seleccionar

Basecamp admite las siguientes columnas como criterios de búsqueda:

• Projecto ID
• ToDoListId
• Identificación
• Completado
• Estado

De forma predeterminada, solo se recuperarán las tareas pendientes activas.

Si no se especifica ProjectId en la consultar, se utilizará el ProjectId predeterminado.

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

También puede recuperar una única tarea pendiente especificando el Id.

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

Insertar

Puede insertar una nueva tarea pendiente proporcionando el ProjectId, ToDoListId y Content requeridos además de los parámetros relacionados con la tarea pendiente.

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

Actualizar

Puede cambiar las columnas que no son de solo lectura proporcionando el Id. de proyecto, el Id. de tareas pendientes y nuevos valores.

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

Puede cambiar el estado Completado de la tarea pendiente proporcionando el Id. del proyecto y el Id. de la tarea pendiente. La columna Completada solo se puede actualizar de forma independiente y otras columnas no se pueden actualizar en la misma consultar.

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

Borrar

Las tareas pendientes no se pueden eliminar.

Columnas

Bóvedas

Recupere bóvedas (carpetas) en las carpetas de Basecamp 3.

Información Específica de la Tabla

Todos los proyectos tienen una bóveda principal (carpeta). Se pueden anidar bóvedas adicionales bajo la bóveda principal o cualquier bóveda secundaria.

Seleccionar

Las columnas admitidas como criterios de búsqueda por Basecamp son ProjectId, VaultId e Id. Si no se especifica ProjectId en la consultar, se utilizará el ProjectId predeterminado.

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

También puede recuperar una sola tarea pendiente especificando el Id.

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

Insertar

Puede insertar un nuevo Vault proporcionando ProjectId, VaultId y Title, que son parámetros obligatorios.

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

Actualizar

Puede actualizar el título de Vault proporcionando ProjectId, VaultId y el nuevo título.

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

Borrar

Las bóvedas no se pueden eliminar.

Columnas

Pseudo-Columnas

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

Puntos de Vista

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

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

Conector Jitterbit para Vistas de Basecamp

Asignaciones

Recuperar asignaciones en Basecamp 3.

Columnas

Calendarios

Recupera calendarios en Basecamp 3.

Información Específica de la Tabla

Solo hay un Calendario (Horario) en cada proyecto de Basecamp.

Seleccionar

Obtenga más detalles sobre un Calendario específico (ProjectId e ID son las únicas columnas admitidas como criterios de búsqueda por Basecamp). Si no se especifica ProjectId en la consultar, se utilizará el ProjectId predeterminado.

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

Columnas

Eventos

Recuperar eventos de actividad en Basecamp 3.

Ver Información Específica

Se crea un evento cada vez que cambia una grabación.

Seleccionar

Puede recuperar todos los eventos de actividad en el proyecto y la grabación especificados. Las columnas admitidas como criterios de búsqueda por Basecamp son ProjectId y RecordingId.

Si no se especifica ProjectId en la consultar, se utilizará el ProjectId predeterminado.

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

Columnas

Gente

Recuperar personas en Basecamp 3.

Ver Información Específica

Seleccionar

Recupere todas las Personas visibles para el usuario actual, enumere las personas por Proyecto o especifique una ID para obtener más información. ID y ProjectId son las columnas admitidas por Basecamp como criterios de búsqueda.

SELECT * FROM People

SELECT * FROM People WHERE Id = '123456789'

SELECT * FROM People WHERE ProjectId = '5168618'

Columnas

Pseudo-Columnas

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

Grabaciones

Recupera grabaciones en carpetas de Basecamp 3.

Ver Información Específica

Recupere la mayoría de las estructuras de datos en Basecamp 3, que se representan como "Grabaciones".

Seleccionar

Las columnas admitidas como criterios de búsqueda por Basecamp son Tipo (parámetro obligatorio), Depósito y Estado.

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

Columnas

Pseudo-Columnas

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

Cargas

Recupera cargas en Basecamp 3.

Columnas

Procedimientos Almacenados

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

Conector Jitterbit para Procedimientos Almacenados de Basecamp

Obtener Token de Acceso de OAuth

Obtiene el token de acceso de OAuth de Basecamp.

Aporte

Columnas del Conjunto de Resultados

Obtener URL de Autorización de OAuth

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

Aporte

Columnas del Conjunto de Resultados

RefreshOAuthAccessToken

Actualiza el token de acceso de OAuth utilizado para la autenticación con varios servicios de Basecamp.

Aporte

Columnas del Conjunto de Resultados

Tablas del Sistema

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

Tablas de Esquema

Las siguientes tablas devuelven metadatos de base de datos para Basecamp:

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

Tablas de Fuentes de Datos

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

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

Tablas de Información de Consulta

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

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

Sys_catalogs

Enumera las bases de datos disponibles.

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

SELECT * FROM sys_catalogs

Columnas

Sys_schemas

Enumera los esquemas disponibles.

La siguiente consultar recupera todos los esquemas disponibles:

SELECT * FROM sys_schemas

Columnas

Sys_tables

Enumera las tablas disponibles.

La siguiente consultar recupera las tablas y vistas disponibles:

SELECT * FROM sys_tables

Columnas

Sys_tablecolumns

Describe las columnas de las tablas y vistas disponibles.

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

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

Columnas

Sys_procedimientos

Enumera los procedimientos almacenados disponibles.

La siguiente consultar recupera los procedimientos almacenados disponibles:

SELECT * FROM sys_procedures

Columnas

Sys_procedureparameters

Describe procedimiento almacenado* parámetros.

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

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

Columnas

Sys_keycolumns

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

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

Columnas

Sys_foreignkeys

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

SELECT * FROM sys_foreignkeys WHERE ForeignKeyType = 'FOREIGNKEY_TYPE_IMPORT'

Columnas

Sys_indexes

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

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

SELECT * FROM sys_indexes WHERE IsPrimary='false'

Columnas

Sys_connection_props

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

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

jdbc:cdata:basecamp:config:

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

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

SELECT * FROM sys_connection_props WHERE Value <> ''

Columnas

Sys_sqlinfo

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

Procesamiento Colaborativo de Consultas

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

Descubrimiento de las Capacidades SELECT de la Fuente de Datos

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