Saltar al contenido

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
Nombre Descripción
Accesses Recuperar, otorgar y denegar permisos de acceso a Proyectos y Calendarios en Basecamp.
CalendarEvents Recupere, cree, actualice y elimine eventos de calendario en Basecamp.
Calendars Recupere, cree, actualice y elimine calendarios en Basecamp.
Documents Recupere, cree, actualice y elimine documentos en Basecamp.
People Recupere y elimine Personas en Basecamp.
Projects Recupere, cree, actualice y elimine proyectos en 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
Nombre Tipo Solo lectura Referencias Descripción
Id [KEY] String Verdadero El identificador único de la persona con acceso al proyecto o calendario.
Admin Boolean Verdadero Valor booleano para mostrar si la persona actual es administrador o no.
AppUrl String Verdadero La URL de la aplicación.
AvatarUrl String Verdadero La URL del avatar de la persona.
CanCreateProjects Boolean Verdadero Si la persona puede crear proyectos o no.
CreatedAt Datetime Verdadero La fecha y hora en que se creó el registro.
EmailAddress String Verdadero La dirección de correo de la persona con acceso al proyecto o calendario.
FullsizeAvatarUrl String Verdadero La URL del avatar de tamaño completo de la persona.
IdentityId String Verdadero El DNI de la persona con acceso al proyecto o calendario.
IsClient Boolean Falso ¿Es el usuario devuelto un cliente o no?
Name String Verdadero El nombre de la persona con acceso al proyecto o calendario.
Trashed Boolean Falso Valor booleano para personas eliminadas.
UpdatedAt Datetime Verdadero La fecha y hora en que se actualizó el registro por última vez.
URL String Verdadero La URL de la persona.
Ids String Falso Una lista separada por comas de ID de usuario a los que se les otorgará acceso a un proyecto o calendario.
EmailAddresses String Falso Una lista separada por comas de las direcciones de correo de los usuarios a las que se les otorgará acceso a un proyecto o calendario.
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.

Nombre Tipo Descripción
ProjectId String El ID del proyecto asociado con el acceso.
CalendarId String El ID de calendario asociado con el acceso.
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
Nombre Tipo Solo lectura Referencias Descripción
Id [KEY] String Verdadero El identificador único para el evento del calendario.
AllDay Boolean Falso Si el evento del calendario es un evento de todo el día.
AppUrl String Verdadero La URL de la aplicación.
BucketAppUrl String Verdadero La URL de la aplicación del depósito de eventos del calendario.
BucketColor String Verdadero El color del depósito de eventos del calendario.
BucketId String Verdadero El ID del depósito de eventos del calendario.
BucketName String Verdadero El nombre del depósito de eventos del calendario.
BucketType String Verdadero El tipo de depósito de eventos del calendario.
BucketUrl String Verdadero La URL del depósito de eventos del calendario.
CommentsCount Integer Verdadero El número de comentarios sobre este evento del calendario.
CreatedAt Datetime Verdadero La fecha y la hora en que se creó el evento del calendario.
CreatorAvatarUrl String Falso URL del avatar del creador.
CreatorFullsizeAvatarUrl String Falso URL de avatar de tamaño completo del creador.
CreatorId String Falso El ID del creador del evento del calendario.
CreatorName String Falso El nombre del creador del evento del calendario.
Description String Falso La descripción del evento del calendario.
EndsAt Datetime Falso La fecha y hora de finalización del evento del calendario.
Past Boolean Falso Valor booleano para eventos de calendario pasados.
Private Boolean Falso Si este evento de calendario es privado.
RemindAt Datetime Falso La fecha y la hora del recordatorio de eventos del calendario.
StartsAt Datetime Falso La fecha y hora de inicio del evento del calendario.
SubscribersId String Falso El ID del suscriptor del evento del calendario.
SubscribersName String Falso El nombre del suscriptor del evento del calendario.
Summary String Falso El resumen del evento del calendario.
Trashed Boolean Falso Valor booleano para eventos de calendario eliminados.
UpdatedAt Datetime Verdadero La fecha y la hora en que se actualizó el evento del calendario.
Url String Verdadero La URL del evento del calendario.
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.

Nombre Tipo Descripción
ProjectId String El ID del Proyecto asociado con el evento del calendario.
CalendarId String El ID de calendario asociado con el evento de calendario.
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
Nombre Tipo Solo lectura Referencias Descripción
Id [KEY] String Verdadero El identificador único para el calendario.
AccessesAppUrl String Verdadero La URL de la aplicación de acceso.
AccessesCount Integer Verdadero Los accesos cuentan.
AccessesUpdatedAt Datetime Verdadero La hora en que se actualizaron los accesos.
AccessesUrl String Verdadero La URL de acceso.
AppUrl String Verdadero La URL de la aplicación.
CalendarEventsCount Integer Verdadero Número de eventos del calendario.
CalendarEventsUpdatedAt Datetime Verdadero La fecha y la hora en que se actualizó por última vez el evento del calendario.
CalendarEventsUrlsPast String Verdadero URL del evento de calendario anterior.
CalendarEventsUrlsUpcoming String Verdadero La fecha y la hora en que se actualizó el calendario por última vez.
Color String Verdadero El color del calendario.
CreatedAt Datetime Verdadero La fecha y hora en que se creó el documento.
CreatorAvatarUrl String Falso URL del avatar del creador.
CreatorFullsizeAvatarUrl String Falso Url de avatar de tamaño completo del creador.
CreatorId String Falso El ID del creador del calendario.
CreatorName String Falso El nombre del creador del calendario.
Name String Falso El nombre del calendario.
UpdatedAt Datetime Verdadero La fecha y la hora en que se actualizó el calendario por última vez.
Url String Verdadero La URL del calendario.
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
Nombre Tipo Solo lectura Referencias Descripción
Id [KEY] String Verdadero El identificador único del documento.
AppUrl String Verdadero La URL de la aplicación.
BucketAppUrl String Verdadero La URL de la aplicación del depósito de temas.
BucketColor String Verdadero El color del cubo de tareas pendientes.
BucketId String Verdadero El Id. del depósito de tareas pendientes.
BucketName String Verdadero El nombre del depósito de tareas pendientes.
BucketType String Verdadero El tipo de depósito de tareas pendientes.
BucketUrl String Verdadero La URL del depósito de tareas pendientes.
Content String Falso El contenido del documento.
CreatedAt Datetime Verdadero La fecha y hora en que se creó el documento.
CreatorAvatarUrl String Falso URL del avatar del creador.
CreatorFullsizeAvatarUrl String Falso URL de avatar de tamaño completo del creador.
CreatorId String Falso El ID del creador del documento.
CreatorName String Falso El nombre del creador del documento.
LastUpdaterId String Falso El DNI de la última persona que actualizó el documento.
LastUpdaterName String Falso El nombre de la persona que actualizó el documento por última vez.
Private Boolean Falso Si esta tarea pendiente es privada.
SubscribersId String Falso El ID del suscriptor del documento.
SubscribersName String Falso El nombre del suscriptor del documento.
Title String Falso El título del documento.
Trashed Boolean Falso Valor booleano para tareas eliminadas.
UpdatedAt Datetime Verdadero La fecha y hora en que se actualizó el documento por última vez.
URL String Verdadero La URL del documento.
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.

Nombre Tipo Descripción
ProjectId String El ID del Proyecto asociado con el documento.
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
Nombre Tipo Solo lectura Referencias Descripción
Id [KEY] String Verdadero El identificador único de la persona.
AccountOwner Boolean Verdadero Valor booleano para mostrar si la persona actual es el propietario de la cuenta.
Admin Boolean Verdadero Valor booleano para mostrar si la persona actual es administrador o no.
AssignedTodosCount Integer Verdadero Número de tareas asignadas.
AssignedTodosUpdatedAt Datetime Verdadero La fecha y hora en que se actualizó el registro.
AssignedTodosUrl String Verdadero La URL de la tarea asignada.
AppUrl String Verdadero La URL de la aplicación.
AvatarUrl String Verdadero La URL del avatar de la persona.
CalendarEventsTodayCount Integer Verdadero Número de eventos para hoy.
CanCreateProjects Boolean Verdadero Si la persona puede crear proyectos o no.
CreatedAt Datetime Verdadero La fecha y hora en que se creó el registro.
EmailAddress String Verdadero La dirección de correo de la persona.
EventsAppUrl String Verdadero La URL de la aplicación de eventos.
EventsCount Integer Verdadero Número de eventos.
EventsUpdatedAt Datetime Verdadero La fecha y hora en que se actualizó el evento.
EventsUrl String Verdadero La URL de la tarea asignada.
FullsizeAvatarUrl String Verdadero La URL del avatar de tamaño completo de la persona.
HasBasecampSiblings Boolean Falso Valor booleano para los hermanos de Basecamp.
IdentityId String Verdadero El documento de identidad de la persona.
Name String Verdadero El nombre de la persona.
OutstandingTodosCount Integer Verdadero Número de tareas pendientes.
Trashed Boolean Falso Valor booleano para personas eliminadas.
UpdatedAt Datetime Verdadero La fecha y hora en que se actualizó el registro por última vez.
Url String Verdadero La URL de la persona.
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
Nombre Tipo Solo lectura Referencias Descripción
Id [KEY] String Verdadero El identificador único del proyecto.
AccessesAppUrl String Verdadero La URL de la aplicación de acceso.
AccessesCount Integer Verdadero Los accesos cuentan.
AccessesUpdatedAt Datetime Verdadero Hora en que se actualizaron los accesos.
AccessesUrl String Verdadero La URL de acceso.
AppUrl String Verdadero La URL de la aplicación.
Archived Boolean Falso Cuando el usuario archive un proyecto, este valor se establecerá en verdadero.
AttachmentsAppUrl String Verdadero La URL de la aplicación de archivos adjuntos.
AttachmentsCount Integer Verdadero Los archivos adjuntos cuentan.
AttachmentsUpdatedAt Datetime Verdadero Hora en que se actualizaron los archivos adjuntos.
AttachmentsUrl String Verdadero La URL de los archivos adjuntos.
CalendarEventsAppUrl String Verdadero La URL de la aplicación de eventos del calendario.
CalendarEventsCount Integer Verdadero Los eventos del calendario cuentan.
CalendarEventsUpdatedAt Datetime Verdadero Hora en que se actualizaron los eventos del calendario.
CalendarEventsUrl String Verdadero La URL de los eventos del calendario.
Color String Verdadero Color.
CreatedAt Datetime Verdadero La hora de creación del proyecto.
CreatorAvatarUrl String Falso URL del avatar del creador.
CreatorFullsizeAvatarUrl String Falso Creador URL de avatar de tamaño completo.
CreatorId String Falso El DNI del creador.
CreatorName String Falso El nombre del creador.
Description String Falso La descripción del proyecto.
DocumentsAppUrl String Verdadero La URL de la aplicación de documentos.
DocumentsCount Integer Verdadero Los documentos cuentan.
DocumentsUpdatedAt Datetime Verdadero Hora en que se actualizaron los documentos.
DocumentsUrl String Verdadero La URL de los documentos.
Drafts Boolean Falso Valor booleano para un borrador de proyecto.
ForwardsAppUrl String Verdadero La URL de la aplicación de reenvío.
ForwardsCount Integer Verdadero Los delanteros cuentan.
ForwardsUpdatedAt Datetime Verdadero Hora en que se actualizaron los reenvíos.
ForwardsUrl String Verdadero La URL de reenvío.
IsClientProject Boolean Falso Si el proyecto está relacionado con los clientes o no.
LastEventAt Datetime Falso Hora en que se modificó por última vez el proyecto.
Name String Falso El nombre del proyecto.
Starred Boolean Falso Valor booleano para un proyecto destacado.
Template Boolean Falso Valor booleano para un proyecto de modelo.
TodolistsAppUrl String Verdadero La URL de la aplicación de listas de tareas.
TodolistsCompletedCount Integer Verdadero Los todolists completaron el conteo.
TodolistsRemainingCount Integer Verdadero Las listas de todo restantes cuentan.
TodolistsUpdatedAt Datetime Verdadero Hora en que se actualizaron las listas de tareas pendientes.
TodolistsUrl String Verdadero La URL de listas de tareas pendientes.
TopicsAppUrl String Verdadero La URL de la aplicación de temas.
TopicsCount Integer Verdadero Los temas cuentan.
TopicsUpdatedAt Datetime Verdadero Momento en que se actualizaron los temas.
TopicsUrl String Verdadero La URL de los temas.
Trashed Boolean Falso Valor booleano para un proyecto desechado.
UpdatedAt Datetime Verdadero Hora en que se actualizó el proyecto.
URL String Verdadero La URL del proyecto.

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
Nombre Descripción
Attachments Recuperar archivos adjuntos en Basecamp.
Comments Recupere, cree, actualice y elimine calendarios en Basecamp.
Events Recuperar eventos de actividad en Basecamp.
Forwards Recuperar Delanteros en Basecamp.
ToDoLists Recupere ToDoLists en Basecamp.
ToDos Recupera tareas pendientes en Basecamp.
Topics Recuperar temas en Basecamp.
Archivos Adjuntos

Recuperar archivos adjuntos en Basecamp.

Columnas
Nombre Tipo Referencias Descripción
Id [KEY] String El ID del archivo adjunto.
Key String La clave del archivo adjunto.
Name String El nombre del archivo adjunto.
ByteSize Int El tamaño del archivo adjunto en bytes.
CreatedAt Datetime La fecha en que se creó el archivo adjunto.
UpdatedAt Datetime La fecha en que se actualizó por última vez el archivo adjunto.
Url String La URL del archivo adjunto.
AppUrl String AppUrl del archivo adjunto.
ThumbnailUrl String La URL en miniatura del archivo adjunto.
Private Boolean Indica si el archivo adjunto es privado.
Trashed Boolean Indica si el archivo adjunto está en la papelera.
Tags String Las etiquetas del archivo adjunto.
CreatorId String El ID del creador del archivo adjunto.
CreatorName String El nombre del creador del archivo adjunto.
CreatorAvatarUrl String desc=
CreatorFullsizeAvatarUrl String desc=
AttachableId String El ID del adjuntable.
AttachableType String El tipo del adjuntable.
AttachableUrl String La URL del adjunto.
AttachableAppUrl String AppUrl del adjunto.
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.

Nombre Tipo Descripción
ProjectId String
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
Nombre Tipo Referencias Descripción
Id [KEY] String El identificador único del comentario.
ProjectId [KEY] String El identificador único del proyecto donde está contenido el comentario.
ItemId String El identificador único del tema que contiene el comentario.
ItemType String Tipo del objeto que contiene el comentario. Los valores válidos son: Mensaje, Documento, Reenviar, CalendarEvent, Subir, Todolist, Todo.
AttachmentsAggregate String Los archivos adjuntos relacionados con el comentario.
Content String El contenido del comentario.
Private Boolean Privacidad del comentario
Trashed Boolean Si el comentario fue descartado o no.
CreatedAt Datetime La fecha y hora en que se creó el documento.
CreatorAvatarUrl String URL del avatar del creador.
CreatorFullsizeAvatarUrl String Url de avatar de tamaño completo del creador.
CreatorId String El ID del creador del comentario.
CreatorName String El nombre del creador del comentario.
UpdatedAt Datetime La fecha y hora en que se actualizó por última vez el comentario.
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.

Columna Operadores
ProjectId =
PersonId =
CreatedAt >, >=

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
Nombre Tipo Referencias Descripción
Id [KEY] String El identificador único del evento.
Action String La descripción de la acción para el evento.
BucketAppUrl String La URL de la aplicación de eventos del calendario.
BucketColor String El color del evento del depósito.
BucketId String El ID del evento del depósito.
BucketName String El nombre del evento del depósito.
BucketType String El tipo de evento del depósito.
BucketUrl String La URL del evento del depósito.
CreatedAt Datetime La fecha y hora en que se creó el evento.
CreatorAvatarUrl String URL del avatar del creador.
CreatorFullsizeAvatarUrl String URL de avatar de tamaño completo del creador.
CreatorId String El ID del creador del evento.
CreatorName String El nombre del creador del evento.
EventableAppUrl String URL de la aplicación para eventos.
EventableId String Id. Eventable.
EventableType String Tipo Eventable.
EventableUrl String URL de eventos.
Excerpt String El tipo de extracto para este evento.
HtmlUrl String La URL HTML del evento.
Private Boolean Si el evento es privado.
RawExcerpt String El tipo de extracto sin procesar para este evento.
Summary String El resumen del evento.
Target String El proyecto objetivo de este evento.
UpdatedAt Datetime La fecha y hora en que se actualizó el evento por última vez.
URL String La URL del evento.
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.

Nombre Tipo Descripción
ProjectId String
PersonId String
Hacia Adelante

Recuperar Delanteros en Basecamp.

Columnas
Nombre Tipo Referencias Descripción
Id [KEY] String El DNI del delantero.
Subject String El tema del delantero.
From String
CreatedAt Datetime La fecha en que se creó el reenvío.
UpdatedAt Datetime La fecha en que se actualizó por última vez el reenvío.
Url String La URL del reenvío.
AppUrl String AppUrl del reenvío.
Private Boolean Indica si el reenvío es privado.
Trashed Boolean Indica si el delantero está descartado.
BucketId String El ID de depósito del reenvío.
BucketName String El nombre del depósito del reenvío.
BucketType String El tipo de cubo del delantero.
BucketUrl String La URL del depósito del delantero.
BucketAppUrl String La URL de la aplicación del depósito del reenvío.
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.

Nombre Tipo Descripción
ProjectId String
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
Nombre Tipo Referencias Descripción
Id [KEY] String El identificador único del tema.
AppUrl String La URL de la aplicación.
AssignedTodos String Tareas asignadas.
BucketAppUrl String La URL de la aplicación del depósito de temas.
BucketColor String El color del cubo de tareas pendientes.
BucketId String El Id. del depósito de tareas pendientes.
BucketName String El nombre del depósito de tareas pendientes.
BucketType String El tipo de depósito de tareas pendientes.
BucketUrl String La URL del depósito de tareas pendientes.
Completed Boolean Si la lista de tareas pendientes está completa.
CompletedCount Integer Número de tareas pendientes completadas.
CreatedAt Datetime La fecha y hora en que se creó el registro.
CreatorAvatarUrl String URL del avatar del creador.
CreatorFullsizeAvatarUrl String URL de avatar de tamaño completo del creador.
CreatorId String El DNI del creador.
CreatorName String El nombre del creador.
Description String La descripción de la lista de tareas pendientes.
Name String El nombre de la lista de tareas pendientes.
Position Integer Número de posición de la lista de tareas actual.
Private Boolean Si la lista de tareas pendientes es privada.
RemainingCount Integer Número de tareas pendientes.
SubscribersId String El ID del suscriptor.
SubscribersName String El nombre del suscriptor.
ToDos String Lista de tareas pendientes.
Trashed Boolean Valor booleano para listas de tareas eliminadas.
UpdatedAt Datetime La fecha y hora en que se actualizó el registro por última vez.
URL String La URL de la lista de tareas pendientes.
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.

Nombre Tipo Descripción
ProjectId String
PersonId String
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
Nombre Tipo Referencias Descripción
Id [KEY] String El identificador único del tema.
AppUrl String La URL de la aplicación.
AssigneeId String DNI de la persona asignada.
AssigneeName String Nombre de la persona asignada.
AssigneeType String Tipo de cesionario.
CommentsCount Integer Número de comentarios sobre esta tarea pendiente.
Completed Boolean Si la tarea pendiente está completa.
Content String Descripción de la tarea pendiente.
CreatedAt Datetime La fecha y hora en que se creó el registro.
CreatorAvatarUrl String URL del avatar del creador.
CreatorFullsizeAvatarUrl String URL de avatar de tamaño completo del creador.
CreatorId String El DNI del creador.
CreatorName String El nombre del creador.
DueAt Datetime La fecha y la hora en que la tarea pendiente vence.
DueOn Datetime La fecha y la hora en que la tarea pendiente vence.
Position Integer Número de posición de la tarea pendiente actual en la lista.
Private Boolean Si esta tarea pendiente es privada.
Remaining Boolean Valor booleano para las tareas pendientes restantes.
SubscribersId String El ID del suscriptor.
SubscribersName String El nombre del suscriptor.
ToDoList String Lista de quehaceres.
ToDoListId String El ID de la lista de tareas pendientes.
Trashed Boolean Valor booleano para tareas eliminadas.
UpdatedAt Datetime La fecha y hora en que se actualizó el registro por última vez.
URL String La URL de la tarea pendiente.
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.

Nombre Tipo Descripción
ProjectId String
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
Nombre Tipo Referencias Descripción
Id [KEY] String El identificador único del tema.
Archived Boolean Valor booleano para temas archivados.
Attachments Integer El número de archivos adjuntos al tema.
BucketAppUrl String La URL de la aplicación del depósito de temas.
BucketColor String El color del tema del depósito.
BucketId String El ID del tema del depósito.
BucketName String El nombre del tema del depósito.
BucketType String El tipo de tema del depósito.
BucketUrl String La URL del tema del depósito.
CreatedAt Datetime La fecha y hora en que se creó el registro.
Excerpt String El extracto del último comentario sobre el tema.
LastUpdaterId String El ID de la persona que hizo el último comentario.
LastUpdaterName String El nombre de la persona que actualizó el tema por última vez.
Private Boolean Si el tema es privado.
Title String El título del tema.
TopicableAppUrl String La URL de la entidad de Basecamp tematizable.
TopicableId String El ID de la entidad de Basecamp tematizable.
TopicableType String El tipo de la entidad Basecamp tematizable.
TopicableUrl String La URL de la entidad de Basecamp tematizable.
Trashed Boolean Valor booleano para temas eliminados.
UpdatedAt Datetime La fecha y hora en que se actualizó el registro por última vez.
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.

Nombre Tipo Descripción
ProjectId String

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
Nombre Descripción
GetOAuthAccessToken Obtiene el token de acceso de OAuth de Basecamp.
GetOAuthAuthorizationURL 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.
PublishProject Publicará (activará) un proyecto creado a partir de una modelo (borrador de proyecto).
RefreshOAuthAccessToken Actualiza el token de acceso de OAuth utilizado para la autenticación con varios servicios de Basecamp.
StarProject Protagonizará un proyecto específico.
UnstarProject Desmarcará un proyecto específico.
Obtener Token de Acceso de OAuth

Obtiene el token de acceso de OAuth de Basecamp.

Aporte
Nombre Tipo Obligatorio Descripción
AuthMode String Cierto WEB o APLICACIÓN. El modo de autenticación Basecamp. El valor predeterminado es APLICACIÓN. El valor predeterminado es APLICACIÓN.
CallbackUrl String Falso La URL a la que se redirigirá al usuario después de autorizar su aplicación.
Verifier String Falso El token verificador devuelto por Basecamp. Requerido solo para Web AuthMode.
State String Falso Este campo indica cualquier estado que pueda ser de utilidad para su solicitud al recibir la respuesta. Su aplicación recibe el mismo valor que envió, ya que este parámetro realiza un viaje de ida y vuelta al servidor de autorización de Basecamp y viceversa. Los usos incluyen redirigir al usuario al recurso correcto en su sitio, usar nonces y mitigar la falsificación de solicitudes entre sitios.
Columnas del Conjunto de Resultados
Nombre Tipo Descripción
OAuthAccessToken String El token de OAuth.
OAuthRefreshToken String El token de actualización de OAuth.
ExpiresIn String El tiempo de vida restante para el token de acceso en segundos.
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
Nombre Tipo Obligatorio Descripción
CallbackUrl String Falso La URL a la que volverá Basecamp después de que el usuario haya autorizado su aplicación.
State String Falso Este campo indica cualquier estado que pueda ser de utilidad para su solicitud al recibir la respuesta. Su aplicación recibe el mismo valor que envió, ya que este parámetro realiza un viaje de ida y vuelta al servidor de autorización de Basecamp y viceversa. Los usos incluyen redirigir al usuario al recurso correcto en su sitio, usar nonces y mitigar la falsificación de solicitudes entre sitios.
Columnas del Conjunto de Resultados
Nombre Tipo Descripción
URL String La URL que se ingresará en un navegador web para obtener el token verificador y autorizar al proveedor de datos.
PublicarProyecto

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

Aporte
Nombre Tipo Obligatorio Descripción
ProjectId String Cierto ID del proyecto.
Columnas del Conjunto de Resultados
Nombre Tipo Descripción
Result String Resultado de la creación del proyecto.
RefreshOAuthAccessToken

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

Aporte
Nombre Tipo Obligatorio Descripción
OAuthRefreshToken String Cierto El token de actualización devuelto con el token de acceso anterior.
Columnas del Conjunto de Resultados
Nombre Tipo Descripción
OAuthAccessToken String El token de autenticación devuelto de Basecamp. Esto se puede usar en llamadas posteriores a otras operaciones para este servicio en particular.
OAuthRefreshToken String Un token que puede usarse para obtener un nuevo token de acceso.
ExpiresIn String El tiempo de vida restante en el token de acceso.
Proyecto Estrella

Protagonizará un proyecto específico.

Aporte
Nombre Tipo Obligatorio Descripción
ProjectId String Cierto ID del proyecto.
Columnas del Conjunto de Resultados
Nombre Tipo Descripción
Result String Resultado estrella del proyecto.
UnstarProject

Desmarcará un proyecto específico.

Aporte
Nombre Tipo Obligatorio Descripción
ProjectId String Cierto ID del proyecto.
Columnas del Conjunto de Resultados
Nombre Tipo Descripción
Result String Resultado de quitar estrella del proyecto.

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
Nombre Descripción
CalendarEvents Recupera eventos del calendario en Basecamp 3.
Comments Recuperar comentarios en una grabación de Basecamp 3.
Documents Recupere, cree, actualice y elimine documentos en Basecamp 3.
Messages Recupera mensajes en Basecamp 3.
Projects Recupere, cree, actualice y elimine proyectos en Basecamp 3.
ToDoLists Recuperar ToDoLists en Basecamp 3.
ToDos Recupera tareas pendientes en Basecamp 3.
Vaults Recupere bóvedas (carpetas) en las carpetas de Basecamp 3.
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
Nombre Tipo Solo lectura Referencias Descripción
Id [KEY] Long Verdadero El identificador único del evento del calendario.
ProjectId Long Verdadero Proyectos.Id El ID del proyecto asociado con el cronograma.
CalendarId Long Verdadero Proyectos.CalendarId El ID de calendario al que pertenece el evento.
Status String Verdadero El estado del evento del calendario.
Type String Verdadero El tipo del registro devuelto.
CreatedAt Datetime Verdadero La fecha y la hora en que se creó el evento del calendario.
UpdatedAt Datetime Verdadero La fecha y la hora en que se actualizó por última vez el evento del calendario.
Description String Falso Descripción proporcionada para el evento del calendario.
AllDay Boolean Falso Indica que el evento es un evento de todo el día.
StartsAt Datetime Falso La fecha y la hora en que comienza el evento del calendario.
EndsAt Datetime Falso La fecha y la hora en que finaliza el evento del calendario.
Summary String Falso Resumen proporcionado para el evento del calendario.
ParticipantsIds String Falso Una lista de ID de participantes separados por comas.
ParticipantsNames String Verdadero Una lista de nombres de participantes separados por comas.
ParentTitle String Verdadero Título del padre.
ParentType String Verdadero Tipo de padre.
BucketName String Verdadero Nombre del depósito contenedor.
BucketType String Verdadero Tipo de cubeta contenedora.
CreatorId Long Verdadero Gente.Id El DNI del creador.
CreatorName String Verdadero El nombre del creador.
CommentsCount Integer Verdadero Número de comentarios que tiene el documento.
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.

Nombre Tipo Descripción
Notify String Cuando se establece en verdadero, notificará a los participantes sobre el evento.
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
Nombre Tipo Solo lectura Referencias Descripción
Id [KEY] String Verdadero El ID del comentario.
Content String Falso El contenido del comentario.
Title String Verdadero El título del comentario.
Status String Verdadero El estado del comentario.
CreatedAt Datetime Verdadero La hora en que se creó el comentario.
UpdatedAt Datetime Verdadero La hora en que se actualizó el comentario por última vez.
InheritsStatus Boolean Verdadero Si este comentario hereda su estado o no.
URL String Verdadero La URL del comentario.
VisibleToClients Boolean Verdadero Si este comentario es visible para los clientes o no.
ProjectId Long Falso Proyectos.Id El ID del proyecto del que es hijo este comentario. Un proyecto contiene grabaciones.
ProjectName String Verdadero El nombre del proyecto del que es hijo este comentario.
RecordingId Long Falso Grabaciones.Id El ID de la grabación en la que está escrito el comentario. Una grabación puede ser un comentario, documento, mensaje, pregunta:respuesta, programación:entrada, tarea, lista de tareas o carga.
CommenterId String Verdadero El ID del comentarista.
CommenterName String Verdadero El nombre del comentarista.
CommenterIsAdmin Boolean Verdadero Si el comentarista es un administrador o no.
CommenterIsOwner Boolean Verdadero Si el comentarista es el propietario de la grabación o no.
CommenterTitle String Verdadero El título del comentarista.
CommenterEmail String Verdadero La dirección de correo del comentarista.
CommenterAvatarURL String Verdadero La URL del avatar del comentarista.
CommenterCompanyId String Verdadero El ID de la empresa del comentarista.
CommenterCompanyName String Verdadero El nombre de la empresa del comentarista.
AppURL String Verdadero La URL de la aplicación a la que pertenece este comentario.
BookmarkURL String Verdadero La URL del marcador.
CommenterAttachableSGID String Verdadero El SGID adjuntable del comentarista.
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
Nombre Tipo Solo lectura Referencias Descripción
Id [KEY] Long Verdadero El identificador único del documento.
ProjectId Long Verdadero Proyectos.Id El ID del Proyecto asociado con el documento.
VaultId Long Verdadero Bóvedas.Id El ID de Vault asociado con el documento.
Status String Falso El estado de la bóveda.
Title String Falso El título del documento.
Content String Falso El contenido del Documento
Type String Verdadero El tipo del registro devuelto.
CreatedAt Datetime Verdadero La fecha y hora en que se creó el documento.
UpdatedAt Datetime Verdadero La fecha y hora en que se actualizó el documento por última vez.
ParentTitle String Verdadero Título del padre.
ParentType String Verdadero Tipo de padre.
BucketName String Verdadero Nombre del depósito contenedor.
BucketType String Verdadero Tipo de cubeta contenedora.
CreatorId Long Verdadero Gente.Id El DNI del creador.
CreatorName String Verdadero El nombre del creador.
CommentsCount Integer Verdadero Número de comentarios que tiene el documento.
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
Nombre Tipo Solo lectura Referencias Descripción
Id [KEY] Long Verdadero El identificador único del mensaje.
ProjectId Long Verdadero Proyectos.Id El ID del proyecto asociado con el cronograma.
MessageBoardId Long Verdadero Proyectos.MessageBoardId El ID del tablero de mensajes al que pertenece el mensaje.
Status String Falso El estado del mensaje
Type String Verdadero El tipo del registro devuelto.
CreatedAt Datetime Verdadero La fecha y hora en que se creó el mensaje.
UpdatedAt Datetime Verdadero La fecha y hora en que se actualizó el mensaje por última vez.
Content String Falso Contenido proporcionado para el mensaje
Subject String Falso Asunto del mensaje
ParentTitle String Verdadero Título del padre.
ParentType String Verdadero Tipo de padre.
BucketName String Verdadero Nombre del depósito contenedor.
BucketType String Verdadero Tipo de cubeta contenedora.
CreatorId Long Verdadero Gente.Id El DNI del creador.
CreatorName String Verdadero El nombre del creador.
CategoryId Long Falso El ID de la categoría.
CategoryName String Verdadero El nombre de la categoría.
CommentsCount Integer Verdadero Número de comentarios que tiene el documento.
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.

Nombre Tipo Descripción
IncludeReplies Boolean Establézcalo en verdadero para recuperar las respuestas de cada mensaje.
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
Nombre Tipo Solo lectura Referencias Descripción
Id [KEY] Long Verdadero El identificador único del proyecto.
Status String Verdadero El estado del proyecto.
Purpose String Verdadero El propósito del proyecto.
CreatedAt Datetime Verdadero La hora de creación del proyecto.
UpdatedAt Datetime Verdadero Hora en que se actualizó el proyecto.
Description String Falso La descripción del proyecto.
Name String Falso El nombre del proyecto.
Bookmarked Boolean Falso Valor booleano para un proyecto marcado.
CalendarId Long Verdadero Id del Calendario del proyecto.
ChatId Long Verdadero Id del Chat del proyecto.
ToDoSetId Long Verdadero ID del conjunto de tareas pendientes del proyecto.
MessageBoardId Long Verdadero Id del Tablero de Mensajes del proyecto.
QuestionnaireId Long Verdadero Id del Cuestionario del proyecto.
VaultId Long Verdadero ID de la bóveda del proyecto.
InboxId Long Verdadero Id de la bandeja de entrada del proyecto.
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
Nombre Tipo Solo lectura Referencias Descripción
Id [KEY] Long Verdadero El identificador único del tema.
ProjectId Long Verdadero Proyectos.Id El ID del Proyecto asociado con la lista de tareas pendientes.
ToDoSetId Long Verdadero Proyectos.ToDoSetId El ID del conjunto de tareas pendientes al que pertenece la lista de tareas pendientes.
Status String Verdadero El estado de las tareas pendientes.
Type String Verdadero El tipo de registro.
Name String Falso El nombre de la tarea.
Completed Boolean Verdadero El estado de tareas pendientes.
CompletedRatio String Verdadero El estado de tareas pendientes en proporción.
Description String Falso La descripción de la lista de tareas pendientes.
CreatedAt Datetime Verdadero La fecha y hora en que se creó el evento.
UpdatedAt Datetime Verdadero La fecha y hora en que se actualizó el registro por última vez.
BucketName String Verdadero El nombre del depósito de la lista de tareas pendientes.
BucketType String Verdadero El tipo de depósito de la lista de tareas pendientes.
ParentTitle String Verdadero Título del padre.
ParentType String Verdadero Tipo de padre.
CreatorId Long Verdadero Gente.Id Identificación del creador del evento.
CreatorAttachableSgid String Verdadero Creador de eventos SGID adjuntable.
CreatorName String Verdadero Nombre del creador del evento.
CreatorEmailAddress String Verdadero Dirección de Correo del creador del evento.
CreatorTitle String Verdadero Título del creador del evento.
CreatorBio String Verdadero Biografía del creador del evento.
CreatorCreatedAt Datetime Verdadero Fecha y hora de creación del creador del evento.
CreatorUpdatedAt Datetime Verdadero Fecha y hora de actualización del creador del evento.
CreatorAdmin Boolean Verdadero Indicación booleana si el creador del evento es un administrador.
CreatorOwner Boolean Verdadero Indicación booleana si el creador del evento es propietario.
CreatorTimeZone String Verdadero Zona horaria del creador del evento.
CreatorCompanyId Long Verdadero Id de la empresa del creador del evento.
CreatorCompanyName String Verdadero Nombre de la empresa del creador del evento.
CommentsCount Integer Verdadero Número de comentarios que tiene el documento.
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
Nombre Tipo Solo lectura Referencias Descripción
Id [KEY] Long Verdadero El identificador único de la tarea.
ProjectId Long Verdadero Proyectos.Id El ID del Proyecto asociado con la lista de tareas pendientes.
ToDoListId Long Verdadero Listas de Tareas.Id El ID de la lista de tareas pendientes a la que pertenece la tarea pendiente.
Status String Verdadero El estado el todo.
CreatedAt Datetime Verdadero La fecha y hora en que se creó el evento.
UpdatedAt Datetime Verdadero La fecha y hora en que se actualizó el registro por última vez.
StartsOn Date Falso La fecha y la hora en que debe comenzar la tarea pendiente.
DueOn Date Falso La fecha y hora en que vence la tarea pendiente.
CommentsCount Integer Verdadero Número de comentarios que tiene el documento.
Description String Falso La descripción de la lista de tareas pendientes.
Content String Falso Qué hacer.
AssigneesIds String Falso Lista de ID de usuario asignados.
Completed Boolean Falso El estado de tareas pendientes.
CompletedAt Datetime Verdadero La fecha y hora en que se completó la tarea pendiente.
CompletionCreatorId String Verdadero El ID del usuario que completó el todo.
CompletionCreatorName String Verdadero El nombre del usuario que completó el todo.
BucketName String Verdadero El nombre del depósito de la lista de tareas pendientes.
BucketType String Verdadero El tipo de depósito de la lista de tareas pendientes.
ParentTitle String Verdadero Título del padre.
ParentType String Verdadero Tipo de padre.
CreatorId Long Verdadero Gente.Id Identificación del creador del evento.
CreatorAttachableSgid String Verdadero Creador de eventos SGID adjuntable.
CreatorName String Verdadero Nombre del creador del evento.
CreatorEmailAddress String Verdadero Dirección de Correo del creador del evento.
CreatorTitle String Verdadero Título del creador del evento.
CreatorBio String Verdadero Biografía del creador del evento.
CreatorCreatedAt Datetime Verdadero Fecha y hora de creación del creador del evento.
CreatorUpdatedAt Datetime Verdadero Fecha y hora de actualización del creador del evento.
CreatorAdmin Boolean Verdadero Indicación booleana si el creador del evento es un administrador.
CreatorOwner Boolean Verdadero Indicación booleana si el creador del evento es propietario.
CreatorTimeZone String Verdadero Zona horaria del creador del evento.
CreatorCompanyId String Verdadero Id de la empresa del creador del evento.
CreatorCompanyName String Verdadero Nombre de la empresa del creador del evento.
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
Nombre Tipo Solo lectura Referencias Descripción
Id [KEY] Long Verdadero El identificador único del tema.
ProjectId Long Verdadero Proyectos.Id El ID del proyecto asociado con el almacén.
Status String Verdadero El estado de la bóveda.
Title String Falso El título del registro devuelto.
Type String Verdadero El tipo del registro devuelto.
CreatedAt Datetime Verdadero La fecha y hora en que se creó el registro.
UpdatedAt Datetime Verdadero La fecha y hora en que se actualizó el registro por última vez.
ParentId Long Verdadero Identificación del padre.
ParentTitle String Verdadero Título del padre.
ParentType String Verdadero Tipo de padre.
BucketId Long Verdadero ID del cubo contenedor.
BucketName String Verdadero Nombre del depósito contenedor.
BucketType String Verdadero Tipo de cubeta contenedora.
CreatorId Long Verdadero Gente.Id El DNI del creador.
CreatorName String Verdadero El nombre del creador.
DocumentsCount Integer Verdadero Número de documentos que contiene la bóveda.
UploadsCount Integer Verdadero Número de cargas que contiene el almacén.
VaultsCount Integer Verdadero Número de bóvedas que contiene la bóveda.
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.

Nombre Tipo Descripción
VaultId Long El ID de Vault al que pertenece el registro.

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
Nombre Descripción
Assignments Recuperar asignaciones en Basecamp 3.
Calendars Recupera calendarios en Basecamp 3.
Events Recuperar eventos de actividad en Basecamp 3.
People Recuperar personas en Basecamp 3.
Recordings Recupera grabaciones en carpetas de Basecamp 3.
Uploads Recuperar cargas en Basecamp 3.
Asignaciones

Recuperar asignaciones en Basecamp 3.

Columnas
Nombre Tipo Referencias Descripción
Id [KEY] Long El identificador único de la persona.
TodoListId Long Listas de Tareas.Id El identificador único para la lista de tareas pendientes.
ProjectId Long Proyectos.Id Use el filtro para recuperar personas activas en el proyecto con la ID dada.
Name String El nombre de la persona.
Owner Boolean Valor booleano para mostrar si la persona actual es el propietario de la cuenta.
Admin Boolean Valor booleano para mostrar si la persona actual es administrador o no.
Title String El título de la persona.
Bio String Bio descripción de la persona.
CreatedAt Datetime La fecha y hora en que se creó el registro.
UpdatedAt Datetime La fecha y hora en que se actualizó el registro por última vez.
EmailAddress String La dirección de correo de la persona.
AttachableSgid String El ID de grupo del conjunto que se puede adjuntar.
PersonableType String Tipo de la persona.
TimeZone String Zona horaria legible para el usuario.
CompanyId Long Id de la empresa de los usuarios.
CompanyName String Nombre de la empresa de los usuarios.
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
Nombre Tipo Referencias Descripción
Id [KEY] Long Proyectos.CalendarId El identificador único del calendario.
ProjectId Long Proyectos.Id El ID del proyecto asociado con el calendario.
Status String El estado del calendario.
Type String El tipo del registro devuelto.
CreatedAt Datetime La fecha y hora en que se creó el calendario.
UpdatedAt Datetime La fecha y la hora en que se actualizó el calendario por última vez.
Title String Título del calendario.
EntriesCount Integer Número de eventos del calendario.
BucketId Long ID del cubo contenedor.
BucketName String Nombre del depósito contenedor.
BucketType String Tipo de cubeta contenedora.
CreatorId Long Gente.Id El DNI del creador.
CreatorName String El nombre del creador.
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
Nombre Tipo Referencias Descripción
Id [KEY] Long El identificador único del evento.
ProjectId Long Proyectos.Id El ID del Proyecto asociado con el documento.
RecordingId Long Grabaciones.Id El ID de la Grabación asociada con este evento.
Action String La descripción de la acción para el evento.
Details String Detalles sobre el evento.
CreatedAt Datetime La fecha y hora en que se creó el evento.
CreatorId Long Gente.Id Identificación del creador del evento.
CreatorAttachableSgid String Creador de eventos SGID adjuntable.
CreatorName String Nombre del creador del evento.
CreatorEmailAddress String Dirección de Correo del creador del evento.
CreatorTitle String Título del creador del evento.
CreatorBio String Biografía del creador del evento.
CreatorCreatedAt Datetime Fecha y hora de creación del creador del evento.
CreatorUpdatedAt Datetime Fecha y hora de actualización del creador del evento.
CreatorAdmin Boolean Indicación booleana si el creador del evento es un administrador.
CreatorOwner Boolean Indicación booleana si el creador del evento es propietario.
CreatorTimeZone String Zona horaria del creador del evento.
CreatorCompanyId Long Id de la empresa del creador del evento.
CreatorCompanyName String Nombre de la empresa del creador del evento.
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
Nombre Tipo Referencias Descripción
Id [KEY] Long El identificador único de la persona.
Name String El nombre de la persona.
Owner Boolean Valor booleano para mostrar si la persona actual es el propietario de la cuenta.
Admin Boolean Valor booleano para mostrar si la persona actual es administrador o no.
Title String El título de la persona.
Bio String Bio descripción de la persona.
CreatedAt Datetime La fecha y hora en que se creó el registro.
UpdatedAt Datetime La fecha y hora en que se actualizó el registro por última vez.
EmailAddress String La dirección de correo de la persona.
AttachableSgid String El ID de grupo del conjunto que se puede adjuntar.
PersonableType String Tipo de la persona.
TimeZone String Zona horaria legible para el usuario.
CompanyId Long Id de la empresa de los usuarios.
CompanyName String Nombre de la empresa de los usuarios.
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.

Nombre Tipo Descripción
ProjectId Long
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
Nombre Tipo Referencias Descripción
Id [KEY] Long El identificador único del tema.
Status String El estado de la bóveda. Los valores permitidos son activo, archivado, desechado.
Type String El tipo de la bóveda. Los valores permitidos son Comentario, Documento, Mensaje, Pregunta:Respuesta, Programación:Entrada, Todo, Lista de todo, Cargar.
CreatedAt Datetime La fecha y hora en que se creó el evento.
UpdatedAt Datetime La fecha y hora en que se modificó el evento por última vez.
CreatorId Long Gente.Id Creador de eventos.
CreatorName String Creador de eventos.
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.

Nombre Tipo Descripción
Bucket String
Cargas

Recupera cargas en Basecamp 3.

Columnas
Nombre Tipo Referencias Descripción
Id [KEY] Long El identificador único del archivo cargado.
ProjectId Long Proyectos.Id El ID del Proyecto asociado con el archivo cargado.
VaultId Long Bóvedas.Id El ID de Vault asociado con el archivo cargado.
Status String El estado de la bóveda.
Title String El título del archivo cargado.
ContentType String El tipo de contenido del archivo subido
Type String El tipo del registro devuelto.
CreatedAt Datetime La fecha y hora en que se creó el archivo cargado.
UpdatedAt Datetime La fecha y hora en que se actualizó por última vez el archivo cargado.
ParentTitle String Título del padre.
ParentType String Tipo de padre.
BucketName String Nombre del depósito contenedor.
BucketType String Tipo de cubeta contenedora.
CreatorId Long Gente.Id El DNI del creador.
CreatorName String El nombre del creador.
CommentsCount Integer Número de comentarios que tiene el archivo subido.
DownloadURL String Número de comentarios que tiene el archivo subido.
ByteSize Integer Número de comentarios que tiene el archivo subido.

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
Nombre Descripción
GetOAuthAccessToken Obtiene el token de acceso de OAuth de Basecamp.
GetOAuthAuthorizationURL 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.
RefreshOAuthAccessToken Actualiza el token de acceso de OAuth utilizado para la autenticación con varios servicios de Basecamp.
Obtener Token de Acceso de OAuth

Obtiene el token de acceso de OAuth de Basecamp.

Aporte
Nombre Tipo Obligatorio Descripción
AuthMode String Cierto WEB o APLICACIÓN. El modo de autenticación Basecamp. El valor predeterminado es APLICACIÓN. El valor predeterminado es APLICACIÓN.
CallbackUrl String Falso La URL a la que se redirigirá al usuario después de autorizar su aplicación.
Verifier String Falso El token verificador devuelto por Basecamp. Requerido solo para Web AuthMode.
State String Falso Este campo indica cualquier estado que pueda ser de utilidad para su solicitud al recibir la respuesta. Su aplicación recibe el mismo valor que envió, ya que este parámetro realiza un viaje de ida y vuelta al servidor de autorización de Basecamp y viceversa. Los usos incluyen redirigir al usuario al recurso correcto en su sitio, usar nonces y mitigar la falsificación de solicitudes entre sitios.
Columnas del Conjunto de Resultados
Nombre Tipo Descripción
OAuthAccessToken String El token de OAuth.
OAuthRefreshToken String El token de actualización de OAuth.
ExpiresIn String El tiempo de vida restante para el token de acceso en segundos.
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
Nombre Tipo Obligatorio Descripción
CallbackUrl String Falso La URL a la que volverá Basecamp después de que el usuario haya autorizado su aplicación.
State String Falso Este campo indica cualquier estado que pueda ser de utilidad para su solicitud al recibir la respuesta. Su aplicación recibe el mismo valor que envió, ya que este parámetro realiza un viaje de ida y vuelta al servidor de autorización de Basecamp y viceversa. Los usos incluyen redirigir al usuario al recurso correcto en su sitio, usar nonces y mitigar la falsificación de solicitudes entre sitios.
Columnas del Conjunto de Resultados
Nombre Tipo Descripción
URL String La URL que se ingresará en un navegador web para obtener el token verificador y autorizar al proveedor de datos.
RefreshOAuthAccessToken

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

Aporte
Nombre Tipo Obligatorio Descripción
OAuthRefreshToken String Cierto El token de actualización devuelto con el token de acceso anterior.
Columnas del Conjunto de Resultados
Nombre Tipo Descripción
OAuthAccessToken String El token de autenticación devuelto de Basecamp. Esto se puede usar en llamadas posteriores a otras operaciones para este servicio en particular.
OAuthRefreshToken String Un token que puede usarse para obtener un nuevo token de acceso.
ExpiresIn String El tiempo de vida restante en el token de acceso.

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:

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
Nombre Tipo Descripción
CatalogName String El nombre de la base de datos.

Sys_schemas

Enumera los esquemas disponibles.

La siguiente consultar recupera todos los esquemas disponibles:

SELECT * FROM sys_schemas
Columnas
Nombre Tipo Descripción
CatalogName String El nombre de la base de datos.
SchemaName String El nombre del esquema.

Sys_tables

Enumera las tablas disponibles.

La siguiente consultar recupera las tablas y vistas disponibles:

SELECT * FROM sys_tables
Columnas
Nombre Tipo Descripción
CatalogName String La base de datos que contiene la tabla o vista.
SchemaName String El esquema que contiene la tabla o vista.
TableName String El nombre de la tabla o vista.
TableType String El tipo de tabla (tabla o vista).
Description String Una descripción de la tabla o vista.
IsUpdateable Boolean Si la tabla se puede actualizar.

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
Nombre Tipo Descripción
CatalogName String El nombre de la base de datos que contiene la tabla o vista.
SchemaName String El esquema que contiene la tabla o vista.
TableName String El nombre de la tabla o vista que contiene la columna.
ColumnName String El nombre de la columna.
DataTypeName String El nombre del tipo de datos.
DataType Int32 Un número entero que indica el tipo de datos. Este valor se determina en tiempo de ejecución en función del ambiente.
Length Int32 El tamaño de almacenamiento de la columna.
DisplaySize Int32 El ancho máximo normal de la columna designada en caracteres.
NumericPrecision Int32 El número máximo de dígitos en datos numéricos. La longitud de la columna en caracteres para datos de carácter y fecha y hora.
NumericScale Int32 La escala de columna o número de dígitos a la derecha del punto decimal.
IsNullable Boolean Si la columna puede contener nulo.
Description String Una breve descripción de la columna.
Ordinal Int32 El número de secuencia de la columna.
IsAutoIncrement String Si el valor de la columna se asigna en incrementos fijos.
IsGeneratedColumn String Si se genera la columna.
IsHidden Boolean Si la columna está oculta.
IsArray Boolean Si la columna es una matriz.

Sys_procedimientos

Enumera los procedimientos almacenados disponibles.

La siguiente consultar recupera los procedimientos almacenados disponibles:

SELECT * FROM sys_procedures
Columnas
Nombre Tipo Descripción
CatalogName String La base de datos que contiene el procedimiento almacenado.
SchemaName String El esquema que contiene el procedimiento almacenado.
ProcedureName String El nombre del procedimiento almacenado.
Description String Una descripción del procedimiento almacenado.
ProcedureType String El tipo de procedimiento, como PROCEDIMIENTO o FUNCIÓN.

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
Nombre Tipo Descripción
CatalogName String El nombre de la base de datos que contiene el procedimiento almacenado.
SchemaName String El nombre del esquema que contiene el procedimiento almacenado.
ProcedureName String El nombre del procedimiento almacenado* que contiene el parámetro.
ColumnName String El nombre del procedimiento almacenado* parámetro.
Direction Int32 Un número entero correspondiente al tipo de parámetro: entrada (1), entrada/salida (2) o salida (4). Los parámetros de tipo de entrada/salida pueden ser tanto parámetros de entrada como de salida.
DataTypeName String El nombre del tipo de datos.
DataType Int32 Un número entero que indica el tipo de datos. Este valor se determina en tiempo de ejecución en función del ambiente.
Length Int32 El número de caracteres permitidos para los datos de caracteres. El número de dígitos permitidos para datos numéricos.
NumericPrecision Int32 La máxima precisión para datos numéricos. La longitud de la columna en caracteres para datos de carácter y fecha y hora.
NumericScale Int32 El número de dígitos a la derecha del punto decimal en datos numéricos.
IsNullable Boolean Si el parámetro puede contener nulo.
IsRequired Boolean Si el parámetro es necesario para la ejecución del procedimiento.
IsArray Boolean Si el parámetro es una matriz.
Description String La descripción del parámetro.
Ordinal Int32 El índice del parámetro.

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
Nombre Tipo Descripción
CatalogName String El nombre de la base de datos que contiene la clave.
SchemaName String El nombre del esquema que contiene la clave.
TableName String El nombre de la tabla que contiene la clave.
ColumnName String El nombre de la columna clave.
IsKey Boolean Si la columna es una clave principal en la tabla a la que se hace referencia en el campo TableName.
IsForeignKey Boolean Si la columna es una clave externa a la que se hace referencia en el campo TableName.
PrimaryKeyName String El nombre de la clave principal.
ForeignKeyName String El nombre de la clave foránea.
ReferencedCatalogName String La base de datos que contiene la clave principal.
ReferencedSchemaName String El esquema que contiene la clave principal.
ReferencedTableName String La tabla que contiene la clave principal.
ReferencedColumnName String El nombre de la columna de la clave principal.

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
Nombre Tipo Descripción
CatalogName String El nombre de la base de datos que contiene la clave.
SchemaName String El nombre del esquema que contiene la clave.
TableName String El nombre de la tabla que contiene la clave.
ColumnName String El nombre de la columna clave.
PrimaryKeyName String El nombre de la clave principal.
ForeignKeyName String El nombre de la clave foránea.
ReferencedCatalogName String La base de datos que contiene la clave principal.
ReferencedSchemaName String El esquema que contiene la clave principal.
ReferencedTableName String La tabla que contiene la clave principal.
ReferencedColumnName String El nombre de la columna de la clave principal.
ForeignKeyType String Designa si la clave externa es una clave de importación (apunta a otras tablas) o de exportación (hace referencia desde otras tablas).

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
Nombre Tipo Descripción
CatalogName String El nombre de la base de datos que contiene el índice.
SchemaName String El nombre del esquema que contiene el índice.
TableName String El nombre de la tabla que contiene el índice.
IndexName String El nombre del índice.
ColumnName String El nombre de la columna asociada con el índice.
IsUnique Boolean True si el índice es único. Falso en caso contrario.
IsPrimary Boolean True si el índice es una clave principal. Falso en caso contrario.
Type Int16 Un valor entero correspondiente al tipo de índice: estadística (0), agrupado (1), hash (2) u otro (3).
SortOrder String El orden de clasificación: A para ascender o D para descender.
OrdinalPosition Int16 El número de secuencia de la columna en el índice.

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
Nombre Tipo Descripción
Name String El nombre de la propiedad de conexión.
ShortDescription String Una breve descripción.
Type String El tipo de datos de la propiedad de conexión.
Default String El valor predeterminado si no se establece uno explícitamente.
Values String Una lista separada por comas de valores posibles. Se lanza un error de validación si se especifica otro valor.
Value String El valor que establezca o un valor predeterminado preconfigurado.
Required Boolean Si la propiedad es necesaria para conectarse.
Category String La categoría de la propiedad de conexión.
IsSessionProperty String Si la propiedad es una propiedad de sesión, utilizada para guardar información sobre la conexión actual.
Sensitivity String El nivel de sensibilidad de la propiedad. Esto informa si la propiedad está ofuscada en los formularios de registro y autenticación.
PropertyName String Una forma truncada en mayúsculas y minúsculas del nombre de la propiedad de conexión.
Ordinal Int32 El índice del parámetro.
CatOrdinal Int32 El índice de la categoría de parámetro.
Hierarchy String Muestra las propiedades dependientes asociadas que deben configurarse junto con esta.
Visible Boolean Informa si la propiedad está visible en la interfaz de usuario de la conexión.
ETC String Diversa información miscelánea sobre la propiedad.

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.

Nombre Descripción Valores posibles
AGGREGATE_FUNCTIONS Funciones de agregación admitidas. AVG, COUNT, MAX, MIN, SUM, DISTINCT
COUNT Si se admite la función COUNT. YES, NO
IDENTIFIER_QUOTE_OPEN_CHAR El carácter de apertura utilizado para escapar de un identificador. [
IDENTIFIER_QUOTE_CLOSE_CHAR El carácter de cierre utilizado para escapar de un identificador. ]
SUPPORTED_OPERATORS Una lista de operadores de SQL admitidos. =, >, <, >=, <=, <>, !=, LIKE, NOT LIKE, IN, NOT IN, IS NULL, IS NOT NULL, AND, OR
GROUP_BY Si se admite GROUP BY y, de ser así, el grado de compatibilidad. NO, NO_RELATION, EQUALS_SELECT, SQL_GB_COLLATE
STRING_FUNCTIONS Funciones de cadena admitidas. LENGTH, CHAR, LOCATE, REPLACE, SUBSTRING, RTRIM, LTRIM, RIGHT, LEFT, UCASE, SPACE, SOUNDEX, LCASE, CONCAT, ASCII, REPEAT, OCTET, BIT, POSITION, INSERT, TRIM, UPPER, REGEXP, LOWER, DIFFERENCE, CHARACTER, SUBSTR, STR, REVERSE, PLAN, UUIDTOSTR, TRANSLATE, TRAILING, TO, STUFF, STRTOUUID, STRING, SPLIT, SORTKEY, SIMILAR, REPLICATE, PATINDEX, LPAD, LEN, LEADING, KEY, INSTR, INSERTSTR, HTML, GRAPHICAL, CONVERT, COLLATION, CHARINDEX, BYTE
NUMERIC_FUNCTIONS Funciones numéricas compatibles. ABS, ACOS, ASIN, ATAN, ATAN2, CEILING, COS, COT, EXP, FLOOR, LOG, MOD, SIGN, SIN, SQRT, TAN, PI, RAND, DEGREES, LOG10, POWER, RADIANS, ROUND, TRUNCATE
TIMEDATE_FUNCTIONS Funciones de fecha/hora admitidas. NOW, CURDATE, DAYOFMONTH, DAYOFWEEK, DAYOFYEAR, MONTH, QUARTER, WEEK, YEAR, CURTIME, HOUR, MINUTE, SECOND, TIMESTAMPADD, TIMESTAMPDIFF, DAYNAME, MONTHNAME, CURRENT_DATE, CURRENT_TIME, CURRENT_TIMESTAMP, EXTRACT
REPLICATION_SKIP_TABLES Indica tablas omitidas durante la replicación.
REPLICATION_TIMECHECK_COLUMNS Una matriz de cadenas que contiene una lista de columnas que se usarán para verificar (en el orden dado) para usar como una columna modificada durante la replicación.
IDENTIFIER_PATTERN Valor de cadena que indica qué cadena es válida para un identificador.
SUPPORT_TRANSACTION Indica si el proveedor admite transacciones como compromiso y reversión. YES, NO
DIALECT Indica el dialecto SQL a usar.
KEY_PROPERTIES Indica las propiedades que identifican la base de datos uniforme.
SUPPORTS_MULTIPLE_SCHEMAS Indica si pueden existir varios esquemas para el proveedor. YES, NO
SUPPORTS_MULTIPLE_CATALOGS Indica si pueden existir varios catálogos para el proveedor. YES, NO
DATASYNCVERSION La versión de sincronización de datos necesaria para acceder a este controlador. Standard, Starter, Professional, Enterprise
DATASYNCCATEGORY La categoría Sincronización de datos de este controlador. Source, Destination, Cloud Destination
SUPPORTSENHANCEDSQL Si se admite la funcionalidad de SQL mejorada más allá de lo que ofrece la API. TRUE, FALSE
SUPPORTS_BATCH_OPERATIONS Si se admiten las operaciones lote. YES, NO
SQL_CAP Todas las funciones de SQL admitidas para este controlador. SELECT, INSERT, DELETE, UPDATE, TRANSACTIONS, ORDERBY, OAUTH, ASSIGNEDID, LIMIT, LIKE, BULKINSERT, COUNT, BULKDELETE, BULKUPDATE, GROUPBY, HAVING, AGGS, OFFSET, REPLICATE, COUNTDISTINCT, JOINS, DROP, CREATE, DISTINCT, INNERJOINS, SUBQUERIES, ALTER, MULTIPLESCHEMAS, GROUPBYNORELATION, OUTERJOINS, UNIONALL, UNION, UPSERT, GETDELETED, CROSSJOINS, GROUPBYCOLLATE, MULTIPLECATS, FULLOUTERJOIN, MERGE, JSONEXTRACT, BULKUPSERT, SUM, SUBQUERIESFULL, MIN, MAX, JOINSFULL, XMLEXTRACT, AVG, MULTISTATEMENTS, FOREIGNKEYS, CASE, LEFTJOINS, COMMAJOINS, WITH, LITERALS, RENAME, NESTEDTABLES, EXECUTE, BATCH, BASIC, INDEX
PREFERRED_CACHE_OPTIONS Un valor de cadena especifica las cacheOptions preferidas.
ENABLE_EF_ADVANCED_QUERY Indica si el controlador admite directamente consultas avanzadas provenientes de Entity Framework. De lo contrario, las consultas se manejarán del lado del cliente. YES, NO
PSEUDO_COLUMNS Una matriz de cadenas que indica las pseudocolumnas disponibles.
MERGE_ALWAYS Si el valor es verdadero, el modo de combinación se ejecuta a la fuerza en la sincronización de datos. TRUE, FALSE
REPLICATION_MIN_DATE_QUERY Una consultar de selección para devolver la fecha y hora de inicio de la réplica.
REPLICATION_MIN_FUNCTION Permite que un proveedor especifique el nombre de la fórmula que se usará para ejecutar un min del lado del servidor.
REPLICATION_START_DATE Permite que un proveedor especifique una fecha de inicio de réplica.
REPLICATION_MAX_DATE_QUERY Una consultar de selección para devolver la fecha y hora de finalización de la réplica.
REPLICATION_MAX_FUNCTION Permite que un proveedor especifique el nombre de la fórmula que se usará para ejecutar un máx. del lado del servidor.
IGNORE_INTERVALS_ON_INITIAL_REPLICATE Una lista de tablas que omitirán dividir la réplica en fragmentos en la réplica inicial.
CHECKCACHE_USE_PARENTID Indica si la instrucción CheckCache debe realizarse en la columna de clave principal. TRUE, FALSE
CREATE_SCHEMA_PROCEDURES Indica procedimientos almacenados* que se puede utilizar para generar archivos de esquema.

La siguiente consultar recupera los operadores que se pueden usar en la cláusula WHERE:

SELECT * FROM sys_sqlinfo WHERE Name='SUPPORTED_OPERATORS'

Tenga en cuenta que las tablas individuales pueden tener diferentes limitaciones o requisitos en la cláusula WHERE; consulte el Modelo de datos para obtener más información.

Columnas
Nombre Tipo Descripción
NAME String Un componente de la sintaxis SQL o una capacidad que se puede procesar en el servidor.
VALUE String Detalles sobre el SQL o la sintaxis de SQL admitidos.

Sys_identidad

Devuelve información sobre los intentos de modificación.

La siguiente consultar recupera los Id. de las filas modificadas en una operación lote:

SELECT * FROM sys_identity
Columnas
Nombre Tipo Descripción
Id String El ID generado por la base de datos devuelto de una operación de modificación de datos.
Batch String Un identificador para el lote. 1 para una sola operación.
Operation String El resultado de la operación en el lote: INSERTADO, ACTUALIZADO o ELIMINADO.
Message String ÉXITO o un mensaje de error si falla la actualización en el lote.

Propiedades de Configuraciones Avanzadas

Las propiedades de configuraciones avanzadas son las diversas opciones que se pueden utilizar para establecer una conexión. Esta sección proporciona una lista completa de las opciones que puede configurar. Haga clic en los enlaces para obtener más detalles.

Autenticación

Propiedad Descripción
AuthScheme El tipo de autenticación que se utilizará al conectarse a Basecamp.
Schema Especifique la versión de Basecamp con la que conectarse.
User Nombre de usuario del usuario actualmente autenticado.
Password Contraseña del usuario actualmente autenticado.
AccountId ID de cuenta del usuario actualmente autenticado.
ProjectId El ID del proyecto del usuario autenticado actualmente.

OAuth

Propiedad Descripción
InitiateOAuth Establezca esta propiedad para iniciar el proceso para obtener o actualizar el token de acceso de OAuth cuando se conecte.
OAuthClientId El ID de cliente asignado cuando registra su aplicación con un servidor de autorización de OAuth.
OAuthClientSecret El secreto del cliente asignado cuando registra su aplicación con un servidor de autorización de OAuth.
OAuthAccessToken El token de acceso para conectarse mediante OAuth.
CallbackURL La URL de devolución de llamada de OAuth a la que volver cuando se autentica. Este valor debe coincidir con la URL de devolución de llamada que especifica en la configuración de su aplicación.
OAuthAuthorizationURL La URL de autorización para el servicio OAuth.
OAuthAccessTokenURL La URL desde la que recuperar el token de acceso de OAuth.
OAuthVerifier El código verificador devuelto desde la URL de autorización de OAuth.
OAuthRefreshToken El token de actualización de OAuth para el token de acceso de OAuth correspondiente.
OAuthExpiresIn La vida útil en segundos del AccessToken de OAuth.
OAuthTokenTimestamp La marca de tiempo de la época de Unix en milisegundos cuando se creó el token de acceso actual.

SSL

Propiedad Descripción
SSLServerCert El certificado que se aceptará del servidor al conectarse mediante TLS/SSL.

Esquema

Propiedad Descripción
Location Una ruta al directorio que contiene los archivos de esquema que definen tablas, vistas y procedimientos almacenados.
BrowsableSchemas Esta propiedad restringe los esquemas informados a un subconjunto de los esquemas disponibles. Por ejemplo, BrowsableSchemas=SchemaA, SchemaB, SchemaC.
Tables Esta propiedad restringe las tablas notificadas a un subconjunto de las tablas disponibles. Por ejemplo, Tablas=TablaA, TablaB, TablaC.
Views Restringe las vistas informadas a un subconjunto de las tablas disponibles. Por ejemplo, Vistas=VistaA, VistaB, VistaC.

Misceláneas

Propiedad Descripción
MaxRows Limita el número de filas devueltas cuando no se usa agregación o agrupación en la consultar. Esto ayuda a evitar problemas de rendimiento en el momento del diseño.
Other Estas propiedades ocultas se usan solo en casos de uso específicos.
PseudoColumns Esta propiedad indica si incluir o no pseudocolumnas como columnas en la tabla.
Timeout El valor en segundos hasta que se lanza el error de tiempo de espera, cancelando la operación.

Autenticación

Esta sección proporciona una lista completa de las propiedades de autenticación que puede configurar.

Propiedad Descripción
AuthScheme El tipo de autenticación que se utilizará al conectarse a Basecamp.
Schema Especifique la versión de Basecamp con la que conectarse.
User Nombre de usuario del usuario actualmente autenticado.
Password Contraseña del usuario actualmente autenticado.
AccountId ID de cuenta del usuario actualmente autenticado.
ProjectId El ID del proyecto del usuario autenticado actualmente.

AuthScheme

El tipo de autenticación que se utilizará al conectarse a Basecamp.

Valores Posibles

Auto, Basic, OAuth

Tipo de Datos

string

Valor por Defecto

"Auto"

Observaciones
  • Automático: permite que el controlador decida automáticamente según las otras propiedades de conexión que haya establecido.
  • Básico: configure esto para usar la autenticación de usuario/contraseña BÁSICA.
  • OAuth: Establézcalo para realizar la autenticación OAuth.

Esquema

Especifique la versión de Basecamp con la que conectarse.

Valores Posibles

V2, V3

Tipo de Datos

string

Valor por Defecto

"V2"

Observaciones

Los esquemas disponibles son V2 (para usar la API de Basecamp 2) y V3 (para usar la API de Basecamp 3).

Usuario

Nombre de usuario del usuario actualmente autenticado.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

Nombre de usuario del usuario actualmente autenticado. Esta propiedad es necesaria para ejecutar comandos.

Contraseña

Contraseña del usuario actualmente autenticado.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

Contraseña del usuario actualmente autenticado. Esta propiedad es necesaria para ejecutar comandos.

ID de la Cuenta

ID de cuenta del usuario actualmente autenticado.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

ID de cuenta del usuario actualmente autenticado. Esta propiedad es necesaria para ejecutar comandos.

Projecto ID

El ID del proyecto del usuario autenticado actualmente.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

El ID del proyecto del usuario autenticado actualmente. De forma predeterminada, se establecerá en el primer ID de proyecto de su lista de proyectos.

OAuth

Esta sección proporciona una lista completa de las propiedades de OAuth que puede configurar.

Propiedad Descripción
InitiateOAuth Establezca esta propiedad para iniciar el proceso para obtener o actualizar el token de acceso de OAuth cuando se conecte.
OAuthClientId El ID de cliente asignado cuando registra su aplicación con un servidor de autorización de OAuth.
OAuthClientSecret El secreto del cliente asignado cuando registra su aplicación con un servidor de autorización de OAuth.
OAuthAccessToken El token de acceso para conectarse mediante OAuth.
CallbackURL La URL de devolución de llamada de OAuth a la que volver cuando se autentica. Este valor debe coincidir con la URL de devolución de llamada que especifica en la configuración de su aplicación.
OAuthAuthorizationURL La URL de autorización para el servicio OAuth.
OAuthAccessTokenURL La URL desde la que recuperar el token de acceso de OAuth.
OAuthVerifier El código verificador devuelto desde la URL de autorización de OAuth.
OAuthRefreshToken El token de actualización de OAuth para el token de acceso de OAuth correspondiente.
OAuthExpiresIn La vida útil en segundos del AccessToken de OAuth.
OAuthTokenTimestamp La marca de tiempo de la época de Unix en milisegundos cuando se creó el token de acceso actual.

Iniciar OAuth

Establezca esta propiedad para iniciar el proceso para obtener o actualizar el token de acceso de OAuth cuando se conecte.

Valores Posibles

OFF, GETANDREFRESH, REFRESH

Tipo de Datos

string

Valor por Defecto

"OFF"

Observaciones

Las siguientes opciones están disponibles:

  1. OFF: Indica que el flujo de OAuth será manejado en su totalidad por el usuario. Se requerirá un OAuthAccessToken para la autenticación.
  2. GETANDREFRESH: indica que el conector manejará todo el flujo de OAuth. Si actualmente no existe ningún token, se obtendrá solicitándolo al usuario a través del navegador. Si existe un token, se actualizará cuando corresponda.
  3. REFRESH: indica que el conector solo manejará la actualización de OAuthAccessToken. El conector nunca le pedirá al usuario que se autentique a través del navegador. El usuario debe manejar la obtención de OAuthAccessToken y OAuthRefreshToken inicialmente.

OAuthClientId

El ID de cliente asignado cuando registra su aplicación con un servidor de autorización de OAuth.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

Como parte del registro de una aplicación OAuth, recibirá el OAuthClientId valor, a veces también llamado clave de consumidor, y un secreto de cliente, el OAuthClientSecret.

OAuthClientSecretOAuthClientSecret

El secreto del cliente asignado cuando registra su aplicación con un servidor de autorización de OAuth.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

Como parte del registro de una aplicación OAuth, recibirá el OAuthClientId, también denominada clave de consumidor. También recibirá un secreto de cliente, también llamado secreto de consumidor. Establezca el secreto del cliente en OAuthClientSecret propiedad.

Token de Acceso de OAuth

El token de acceso para conectarse mediante OAuth.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

El OAuthAccessToken la propiedad se usa para conectarse usando OAuth. El OAuthAccessToken se recupera del servidor OAuth como parte del proceso de autenticación. Tiene un tiempo de espera dependiente del servidor y se puede reutilizar entre solicitudes.

El token de acceso se utiliza en lugar de su nombre de usuario y contraseña. El token de acceso protege sus credenciales manteniéndolas en el servidor.

URL de Devolución de Llamada

La URL de devolución de llamada de OAuth a la que volver cuando se autentica. Este valor debe coincidir con la URL de devolución de llamada que especifica en la configuración de su aplicación.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

Durante el proceso de autenticación, el servidor de autorización de OAuth redirige al usuario a esta URL. Este valor debe coincidir con la URL de devolución de llamada que especifica en la configuración de su aplicación.

URL de Autorización de OAuth

La URL de autorización para el servicio OAuth.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

La URL de autorización para el servicio OAuth. En esta URL, el usuario inicia sesión en el servidor y otorga permisos a la aplicación. En OAuth 1.0, si se otorgan permisos, se autoriza el token de solicitud.

URL del Token de Acceso de OAuth

La URL desde la que recuperar el token de acceso de OAuth.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

La URL desde la que recuperar el token de acceso de OAuth. En OAuth 1.0, el token de solicitud autorizado se intercambia por el token de acceso en esta URL.

OAuthVerifier

El código verificador devuelto desde la URL de autorización de OAuth.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

El código verificador devuelto desde la URL de autorización de OAuth. Esto se puede usar en sistemas en los que no se puede iniciar un navegador, como los sistemas sin cabeza.

Autenticación en Máquinas Sin Cabeza

Ver para obtener el OAuthVerifier valor.

Establezca OAuthSettingsLocation junto con OAuthVerifier. Cuando se conecta, el conector intercambia el OAuthVerifier para los tokens de autenticación de OAuth y los guarda, encriptados, en el archivo especificado. Establecer Iniciar OAuth para GETANDREFRESH automatizar el intercambio.

Una vez que se haya generado el archivo de configuración de OAuth, puede eliminar OAuthVerifier desde las propiedades de conexión y conéctese con OAuthSettingsLocation colocar.

Para actualizar automáticamente los valores del token de OAuth, establezca OAuthSettingsLocation y además configure InitiateOAuth refrescar.

OAuthRefreshToken

El token de actualización de OAuth para el token de acceso de OAuth correspondiente.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

El OAuthRefreshToken la propiedad se usa para actualizar el OAuthAccessToken al usar la autenticación OAuth.

OAuthExpiresIn

La vida útil en segundos del AccessToken de OAuth.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

Empareje con OAuthTokenTimestamp para determinar cuándo caducará el AccessToken.

OAuthTokenTimestamp

La marca de tiempo de la época de Unix en milisegundos cuando se creó el token de acceso actual.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

Emparéjese con OAuthExpiresIn para determinar cuándo expirará AccessToken.

SSL

Esta sección proporciona una lista completa de las propiedades SSL que puede configurar.

Propiedad Descripción
SSLServerCert El certificado que se aceptará del servidor al conectarse mediante TLS/SSL.

SSLServerCert

El certificado que se aceptará del servidor al conectarse mediante TLS/SSL.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

Si usa una conexión TLS/SSL, esta propiedad se puede usar para especificar el certificado TLS/SSL que se aceptará del servidor. Se rechaza cualquier otro certificado que no sea de confianza para la máquina.

Esta propiedad puede tomar las siguientes formas:

Descripción Ejemplo
Un certificado PEM completo (ejemplo abreviado por brevedad) -----BEGIN CERTIFICATE----- MIIChTCCAe4CAQAwDQYJKoZIhv......Qw== -----END CERTIFICATE-----
Una ruta a un archivo local que contiene el certificado C:\cert.cer
La clave pública (ejemplo abreviado por brevedad) -----BEGIN RSA PUBLIC KEY----- MIGfMA0GCSq......AQAB -----END RSA PUBLIC KEY-----
La huella digital MD5 (los valores hexadecimales también pueden estar separados por espacios o dos puntos) ecadbdda5a1529c58a1e9e09828d70e4
La huella digital SHA1 (los valores hexadecimales también pueden estar separados por espacios o dos puntos) 34a929226ae0819f2ec14b4a3d904f801cbb150d

Si no se especifica, se acepta cualquier certificado en el que confíe la máquina.

La máquina valida los certificados como confiables según el almacén de confianza del sistema. El almacén de confianza utilizado es el valor 'javax.net.ssl.trustStore' especificado para el sistema. Si no se especifica ningún valor para esta propiedad, se utiliza el almacén de confianza predeterminado de Java (por ejemplo, JAVA_HOME\lib\security\cacerts).

Use '*' para indicar que acepta todos los certificados. Tenga en cuenta que esto no se recomienda debido a problemas de seguridad.

Esquema

Esta sección proporciona una lista completa de propiedades de esquema que puede configurar.

Propiedad Descripción
Location Una ruta al directorio que contiene los archivos de esquema que definen tablas, vistas y procedimientos almacenados.
BrowsableSchemas Esta propiedad restringe los esquemas informados a un subconjunto de los esquemas disponibles. Por ejemplo, BrowsableSchemas=SchemaA, SchemaB, SchemaC.
Tables Esta propiedad restringe las tablas notificadas a un subconjunto de las tablas disponibles. Por ejemplo, Tablas=TablaA, TablaB, TablaC.
Views Restringe las vistas informadas a un subconjunto de las tablas disponibles. Por ejemplo, Vistas=VistaA, VistaB, VistaC.

Ubicación

Una ruta al directorio que contiene los archivos de esquema que definen tablas, vistas y procedimientos almacenados.

Tipo de Datos

string

Valor por Defecto

"%APPDATA%\\\Basecamp Data Provider\\Schema"

Observaciones

La ruta a un directorio que contiene los archivos de esquema para el conector (archivos .rsd para tablas y vistas, archivos .rsb para procedimientos almacenados). La ubicación de la carpeta puede ser una ruta relativa desde la ubicación del ejecutable. El Location La propiedad solo es necesaria si desea personalizar las definiciones (por ejemplo, cambiar el nombre de una columna, ignorar una columna, etc.) o ampliar el modelo de datos con nuevas tablas, vistas o procedimientos almacenados.

Nota: Dado que este conector admite varios esquemas, la estructura de los archivos de esquema personalizados de Basecamp es la siguiente:

  • Cada esquema recibe una carpeta correspondiente a ese nombre de esquema.
  • Estas carpetas de esquema están contenidas en una carpeta principal.
  • El parent folder debe establecerse como Location, no la carpeta de un esquema individual.

Si no se especifica, la ubicación predeterminada es "%APPDATA%\\ Basecamp Data Provider\Schema" con %APPDATA% estando configurado en el directorio de configuración del usuario:

Plataforma %APPDATA%
Windows El valor de la variable de ambiente APPDATA
Mac ~/Biblioteca/Soporte de aplicaciones
Linux ~/.config

Esquemas Navegables

Esta propiedad restringe los esquemas informados a un subconjunto de los esquemas disponibles. Por ejemplo, BrowsableSchemas=SchemaA,SchemaB,SchemaC.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

Enumerar los esquemas de las bases de datos puede resultar costoso. Proporcionar una lista de esquemas en la cadena de conexión mejora el rendimiento.

Mesas

Esta propiedad restringe las tablas notificadas a un subconjunto de las tablas disponibles. Por ejemplo, Tablas=TablaA,TablaB,TablaC.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

Listar las tablas de algunas bases de datos puede resultar costoso. Proporcionar una lista de tablas en la cadena de conexión mejora el rendimiento del conector.

Esta propiedad también se puede utilizar como una alternativa a la lista automática de vistas si ya sabe con cuáles quiere trabajar y, de lo contrario, habría demasiadas para trabajar.

Especifique las tablas que desea en una lista separada por comas. Cada tabla debe ser un identificador SQL válido con cualquier carácter especial escapado usando corchetes, comillas dobles o acentos graves. Por ejemplo, Tables=TableA,[TableB/WithSlash],WithCatalog.WithSchema.`TableC With Space`.

Tenga en cuenta que al conectarse a una fuente de datos con varios esquemas o catálogos, deberá proporcionar el nombre completo de la tabla en esta propiedad, como en el último ejemplo aquí, para evitar la ambigüedad entre las tablas que existen en varios catálogos o esquemas.

Puntos de Vista

Restringe las vistas informadas a un subconjunto de las tablas disponibles. Por ejemplo, Vistas=VistaA,VistaB,VistaC.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

Listar las vistas de algunas bases de datos puede ser costoso. Proporcionar una lista de vistas en la cadena de conexión mejora el rendimiento del conector.

Esta propiedad también se puede utilizar como una alternativa a la lista automática de vistas si ya sabe con cuáles quiere trabajar y, de lo contrario, habría demasiadas para trabajar.

Especifique las vistas que desee en una lista separada por comas. Cada vista debe ser un identificador SQL válido con cualquier carácter especial escapado usando corchetes, comillas dobles o acentos graves. Por ejemplo, Views=ViewA,[ViewB/WithSlash],WithCatalog.WithSchema.`ViewC With Space`.

Tenga en cuenta que al conectarse a una fuente de datos con varios esquemas o catálogos, deberá proporcionar el nombre completo de la tabla en esta propiedad, como en el último ejemplo aquí, para evitar la ambigüedad entre las tablas que existen en varios catálogos o esquemas.

Misceláneas

Esta sección proporciona una lista completa de propiedades misceláneas que puede configurar.

Propiedad Descripción
MaxRows Limita el número de filas devueltas cuando no se usa agregación o agrupación en la consultar. Esto ayuda a evitar problemas de rendimiento en el momento del diseño.
Other Estas propiedades ocultas se usan solo en casos de uso específicos.
PseudoColumns Esta propiedad indica si incluir o no pseudocolumnas como columnas en la tabla.
Timeout El valor en segundos hasta que se lanza el error de tiempo de espera, cancelando la operación.

Filas Máximas

Limita el número de filas devueltas cuando no se usa agregación o agrupación en la consultar. Esto ayuda a evitar problemas de rendimiento en el momento del diseño.

Tipo de Datos

int

Valor por Defecto

-1

Observaciones

Limita el número de filas devueltas cuando no se usa agregación o agrupación en la consultar. Esto ayuda a evitar problemas de rendimiento en el momento del diseño.

Otro

Estas propiedades ocultas se usan solo en casos de uso específicos.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

Las propiedades enumeradas a continuación están disponibles para casos de uso específicos. Los casos de uso y la funcionalidad normales del controlador no deberían requerir estas propiedades.

Especifique varias propiedades en una lista separada por punto y coma.

Integración y Formateo
Propiedad Descripción
DefaultColumnSize Establece la longitud predeterminada de los campos de cadena cuando la fuente de datos no proporciona la longitud de columna en los metadatos. El valor predeterminado es 2000.
ConvertDateTimeToGMT Determina si se convierten los valores de fecha y hora a GMT, en lugar de la hora local de la máquina.
RecordToFile=filename Registra la transferencia de datos del socket subyacente al archivo especificado.

Pseudocolumnas

Esta propiedad indica si incluir o no pseudocolumnas como columnas en la tabla.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

Esta configuración es particularmente útil en Entity Framework, que no le permite establecer un valor para una pseudocolumna a menos que sea una columna de tabla. El valor de esta configuración de conexión tiene el formato "Tabla1=Columna1, Tabla1=Columna2, Tabla2=Columna3". Puede usar el carácter "*" para incluir todas las tablas y todas las columnas; por ejemplo, "*=*".

Se Acabó el Tiempo

El valor en segundos hasta que se lanza el error de tiempo de espera, cancelando la operación.

Tipo de Datos

int

Valor por Defecto

60

Observaciones

Si Timeout = 0, las operaciones no expiran. Las operaciones se ejecutan hasta que se completan correctamente o hasta que encuentran una condición de error.

Si Timeout caduca y la operación aún no se ha completado, el conector genera una excepción.