Detalles de Conexión de Zoho Projects

Introducción

Versión del conector

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

Empezando

Compatibilidad con la versión de Zoho Projects

El conector aprovecha la API de Zoho Projects (se utilizan tanto restapi como la API v3) para habilitar el acceso bidireccional a los datos de gestión de Zoho Projects Projects.

Establecer una Conexión

Autenticación en Zoho Projects

El conector ya está registrado con Zoho Projects como una aplicación OAuth. Como tal, de forma predeterminada, utilizará automáticamente sus Credenciales integradas para conectar.

Si usa las credenciales incrustadas, no se requiere ninguna otra acción para establecer una conexión.

Si prefiere usar su propia aplicación OAuth personalizada, consulte Credenciales personalizadas.

Uso de la Autenticación OAuth

OAuth requiere que el usuario que se autentica interactúe con Zoho Projects mediante 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 en Zoho Projects 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 Zoho Projects 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

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

Autenticación de Escritorio con Su Aplicación OAuth

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

Obtenga un Token de Acceso OAuth

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

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

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

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

Máquinas Sin Cabeza

Uso de OAuth en una Máquina Sin Cabeza

Para crear fuentes de datos de Zoho Projects 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 para una Aplicación OAuth Personalizada

Cree una aplicación OAuth personalizada

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

Obtenga un código verificador

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

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

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

1. Llame a GetOAuthAuthorizationURL procedimiento almacenado* con el parámetro de entrada CallbackURL establecido en el URI de redirección exacto que especificó en la configuración de su aplicación.
2. Abra la URL devuelta en un navegador. Inicie sesión y otorgue permisos al conector. A continuación, se le redirige a la URL de devolución de llamada, que contiene el código verificador.
3. Guarde el valor del código verificador. Establecerá esto en el OAuthVerifier propiedad de conexión.
4. Guarde el valor del servidor de cuentas. Establecerá esto en el AccountsServer 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.
• AccountsServer: establezca esto en el servidor de cuentas que obtuvo de la redirección.
• OAuthVerifier: Establézcalo en el código del verificador.
• OAuthSettingsLocation: configure esto para conservar los valores de autenticación OAuth cifrados en el archivo especificado.
• InitiateOAuth: Establézcalo en ACTUALIZAR.

Conectarse a datos

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

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

Transferir configuración de OAuth

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

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

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

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

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

Creación de una Aplicación OAuth Personalizada

Zoho Projects utiliza el estándar de autenticación OAuth, que requiere que el usuario que se autentica interactúe con Zoho Projects a través del navegador. El conector facilita el intercambio de OAuth de varias maneras, como se describe a continuación.

Registro de una Aplicación OAuth

Antes de comenzar con la autorización y realizar cualquier llamada a la API de Zoho CRM, debe registrar su aplicación con Zoho CRM. Puede seguir el procedimiento a continuación para obtener el OAuthClientId, OAuthClientSecret, y CallbackURL propiedades de conexión.

1. Vaya a la Consola para desarrolladores de Zoho.

2. Haga clic en Agregar cliente y luego en Aplicación basada en servidor.

3. Introduzca el nombre del cliente, la URL de la página de inicio y la URL de redireccionamiento.

4. Si se está conectando desde una aplicación de escritorio, establezca la URL de devolución de llamada en http://localhost:33333, u otro número de puerto de su elección.

   Si se está conectando desde una aplicación web, configure la URL de devolución de llamada que desea que se use como una URL de redireccionamiento de confianza, donde el usuario regresará con el token que verifica que le ha otorgado acceso a su aplicación.

5. Haga clic en Create.

Autenticarse en Zoho Projects Desde una Aplicación de Escritorio

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

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

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.

Autenticarse en Zoho Projects Desde una Aplicación Web

Siga los pasos a continuación para obtener y administrar los valores del token de OAuth en el flujo web.

Obtenga un Token de Acceso

Establezca las siguientes propiedades de conexión para obtener OAuthAccessToken:

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

A continuación, puede llamar a procedimientos almacenados* para completar el intercambio de OAuth:

1. Llame a GetOAuthAuthorizationURL procedimiento almacenado. Configure la entrada AuthMode en WEB y configure la entrada CallbackURL en el URI de redirección que especificó en la configuración de su aplicación. El procedimiento almacenado* devuelve la URL al extremo de OAuth.
2. Inicie sesión y autorice la aplicación. Se le redirigirá a la URL de devolución de llamada.
3. Llame al GetOAuthAccessToken procedimiento almacenado. Establezca la entrada AuthMode en WEB. Establezca la entrada del Verificador en el parámetro "código" en la cadena de consultar de la URL de devolución de llamada.

Conéctese a los Datos y Actualice el Token

El OAuthAccessToken devuelto por GetOAuthAccessToken tiene una duración limitada. Para actualizar automáticamente el token, configure lo siguiente en la primera conexión de datos. Alternativamente, use el RefreshOAuthAccessToken procedimiento almacenado* para actualizar manualmente el token.

• InitiateOAuth: Establézcalo en ACTUALIZAR. Puede usar InitiateOAuth para evitar repetir el intercambio de OAuth y configurar manualmente OAuthAccessToken.
• OAuthSettingsLocation: Establézcalo en la ruta donde el conector guardará los valores de OAuth, para que se conserven entre las conexiones.
• 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.
• OAuthRefreshToken: establezca esto en el token de actualización devuelto por GetOAuthAccessToken.
• OAuthAccessToken: establezca esto en el token de acceso devuelto por GetOAuthAccessToken.

En conexiones de datos posteriores, establezca lo siguiente:

• InitiateOAuth
• OAuthSettingsLocation

Modelo de Datos

Descripción general

Esta sección muestra los objetos de la API disponibles y proporciona más información sobre cómo ejecutar SQL en la API de Zoho Projects.

Características clave

• El conector modela entidades de Zoho Projects como proyectos, eventos y usuarios como vistas relacionales, lo que le permite escribir SQL para consultar datos de Zoho Projects.
• Procedimientos almacenados* le permiten ejecutar operaciones en Zoho Projects.
• La conectividad en vivo con estos objetos significa que cualquier cambio en su cuenta de Zoho Projects se refleja de inmediato al usar el conector.

Mesas

Mesas describe las tablas disponibles. Las tablas se definen estáticamente para modelar proyectos, eventos, usuarios, etc.

Puntos de vista

Puntos de vista describe las vistas disponibles. Las vistas se definen estáticamente para modelar Clientes, Documentos, Actividades, etc.

Procedimientos almacenados

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

Procedimientos almacenados son interfaces similares a funciones para Zoho Projects. Procedimientos almacenados* le permiten ejecutar operaciones en Zoho Projects, incluida la aprobación de registros de tiempo y la reordenación de tareas.

Mesas

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

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

Conector Jitterbit para Tablas de Zoho Projects

BugAssociatedTasks

Obtiene los detalles de la tarea asociada con un error.

Información Específica de la Tabla

Esta tabla muestra asociaciones entre Errores y Tareas.

Seleccionar

• BugId admite el siguiente operador: =.

Por ejemplo, la siguiente consultar se procesa del lado del servidor:

SELECT * FROM BugAssociatedTasks WHERE BugId = '123439000000045005'

Insertar

Para agregar una nueva asociación error-tarea, especifique los campos BugId y TaskId.

INSERT INTO BugAssociatedTasks (BugId, TaskId) VALUES ('123418000000045005', '["123418000000044005"]') 

Borrar

Para eliminar una asociación error-tarea existente, especifique los campos BugId y TaskId.

DELETE FROM BugAssociatedTasks WHERE BugId = '123418000000045005' AND TaskId = '123418000000044005'

Columnas

ErrorComentarios

Obtener comentarios para el error.

Seleccionar

• BugId es necesario para recuperar los comentarios de errores.

Por ejemplo, la siguiente consultar se procesa del lado del servidor:

SELECT * FROM BugComments WHERE BugId = '123456000000045005'

Insertar

Para agregar un comentario de error, especifique los campos BugId y Comentario.

INSERT INTO BugComments (BugId, Comment) VALUES ('123456000000045005', 'Test Comment #1')

Borrar

Los comentarios de errores se pueden eliminar proporcionando la ID y emitiendo una instrucción DELETE.

DELETE FROM BugComments WHERE BugId = '123456000000045005' AND ID = '123456000000045042'

Columnas

BugEntityProperties

Recupera los datos almacenados contra una entidad. El argumento de este método debe ser la clave que se usó cuando se almacenaron los mismos datos.

Información Específica de la Tabla

Las propiedades de entidad son pares clave-valor almacenados en las entidades de errores. Se pueden usar para almacenar detalles necesarios para las integraciones de API, pero no es necesario que estén visibles en la interfaz de usuario. La clave debe ser una cadena y el valor podría ser una cadena simple o un objeto json. Puede almacenar múltiples par clave-valor para una sola entidad. Estas propiedades de entidad se pueden almacenar/recuperar/actualizar/eliminar mediante las siguientes consultas.

Seleccionar

• BugId y PropertyKey son necesarios para recuperar las propiedades de la entidad de error.

Por ejemplo, la siguiente consultar se procesa del lado del servidor:

SELECT * FROM BugEntityProperties WHERE BugId = '123456000000034087' AND PropertyKey = 'key1' 

Insertar

Para agregar una nueva propiedad de entidad de error, especifique los campos BugId, PropertyKey y PropertyValue.

INSERT INTO BugEntityProperties (BugId, PropertyKey, PropertyValue) VALUES ('123456000000034087', 'key1', 'This is a test value')

Actualizar

ZohoProjects permite actualizaciones para la columna PropertyValue.

UPDATE BugEntityProperties SET PropertyValue = 'This is an updated property value' WHERE BugId = '123456000000034087' AND PropertyKey = 'key1'

Borrar

Las propiedades de la entidad de error se pueden eliminar proporcionando Id, BugId, PropertyKey y emitiendo una instrucción DELETE.

DELETE FROM BugEntityProperties WHERE BugId = '166135000000034087' AND PropertyKey = 'key1' AND ID = '166135000000035001'

Columnas

BugSeguidores

Obtenga una lista de seguidores para el error.

Seleccionar

• BugId es necesario para recuperar los seguidores de errores.

Por ejemplo, la siguiente consultar se procesa del lado del servidor:

SELECT * FROM BugFollowers WHERE BugId = '123456000000042110'

Insertar

Para agregar un seguidor de errores, especifique los campos BugId y Seguidor.

INSERT INTO BugFollowers (BugId, BugFollowers) VALUES ('123456000000042110', '12345649448')

Borrar

Los seguidores de errores se pueden eliminar proporcionando la ID y emitiendo una instrucción DELETE.

DELETE FROM BugFollowers WHERE BugId = '123456000000042110'  AND  FollowerId = '12345649448'

Columnas

Insectos

Obtiene todas las tareas en el proyecto dado. Obtiene solo las tareas principales y no las subtareas.

Seleccionar

Columnas que admiten el operador =:

• Identificación
• Hora de creación
• Bandera
• Tipo de estado
• CustomViewId

Columnas que admiten el operador = y IN:

• ID del cesionario
• Identificación de clasificación
• EscalationLevel
• ID de módulo
• Id. de gravedad
• ID de estado
• ReporterId
• Identificador de hito
• Id de hito afectado

Por ejemplo, la siguiente consultar se procesa del lado del servidor:

SELECT * FROM Bugs
    WHERE ReporterId IN ('12341021738')
    AND AssigneeId IN ('12341021738')
    AND ClassificationId IN ('123456000000030015')
    AND EscalationLevel IN ('0')
    AND Flag = 'Internal'
    AND ModuleId IN ('123456000000030145')
    AND SeverityId IN ('123456000000030151')
AND StatusId IN ('123456000000030083')

Insertar

Para crear un nuevo Bug, puede especificar los siguientes campos:

• Título
• ID del cesionario
• Identificación de clasificación
• Descripción
• Fecha de vencimiento
• Bandera
• ID de módulo
• ID reproducible
• Id. de gravedad
• Tarifa por hora
• Seguidores de errores
• Identificador de hito

Para crear un nuevo Bug, especifique los siguientes campos:

INSERT INTO Bugs (Title, Description, AssigneeId, flag, ClassificationId, DueDate, ModuleId, SeverityId, ReproducibleId, HourlyRate, CustomField1)
VALUES ('SQL Inserted Bug #5', 'Test Description', '12341249448', 'Internal', '123456000000031015', '2022-03-20', '123456000000031145', '123456000000031149', '123456000000031053', '2', 'TestCustomField')

Actualizar

Puede utilizar la siguiente consultar para actualizar un error:

UPDATE Bugs
SET Title = 'SQL Inserted Bug #5',
    Description = 'Another Test Description',
    AssigneeId = '20081249448',
    ClassificationId = '165818000000031015',
    DueDate = '2022-03-20',
    ModuleId = '165818000000031145',
    SeverityId = '165818000000031149',
    ReproducibleId = '165818000000031053',
    HourlyRate = '2',
    cf1 = 'Custom Field Edited #1'
WHERE ID = '165818000000042126'

Borrar

Los errores se pueden eliminar proporcionando la ID y emitiendo una instrucción DELETE.

DELETE FROM Bugs WHERE ID = '123456000000042126' 

Columnas

Pseudo-Columnas

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

BugTimelogs

Obtiene los registros de tiempo bajo un error específico.

Seleccionar

• BugId es necesario para recuperar los registros de tiempo de error.

Por ejemplo, la siguiente consultar se procesa del lado del servidor:

SELECT * FROM BugTimelogs WHERE BugId = '123456000000045005'

Insertar

Para agregar un Bug TimeLog, especifique los campos BugId y Follower.

INSERT INTO BugTimelogs (BugId, LogDate, BillStatus, HoursDisplay, Notes)
VALUES ('123456000000045005', '2022-03-03', 'Non Billable', '01:20', 'This is a test timelog')

Actualizar

Para actualizar un Bug TimeLog, especifique los campos BugId e ID.

UPDATE BugTimelogs
    SET Notes = 'This is an updated SQL Note'
WHERE BugId = '165818000000045005' AND ID = '123456000000044025'

Borrar

Los TimeLogs de errores se pueden eliminar proporcionando el BugId y el ID y emitiendo una instrucción DELETE.

DELETE FROM BugTimelogs WHERE BugId = '123456000000045005' AND ID = '123456000000044025'

Columnas

Contactos

Obtiene todos los contactos de clientes de un portal.

Seleccionar

• ClientId es necesario para recuperar contactos.

Por ejemplo, la siguiente consultar se procesa del lado del servidor:

SELECT * FROM Contacts WHERE ClientId = '123456000000045005'

Insertar

Para crear un nuevo contacto, puede especificar los siguientes campos:

• Identificación del cliente
• Nombre de pila
• Apellido
• Correo
• Tasa de factura
• Proyectos de trabajo

INSERT INTO Contacts(WorkProjects, ClientId, FirstName, LastName, Email, Invoicerate)
VALUES ('123456000000031899', '123456000000039025', 'TestFirstname222', 'TestLastname222', 'testemail@example.com', '15')

Actualizar

Para actualizar un contacto, especifique el campo ID.

UPDATE Contacts
    SET FirstName = 'updatedname', LastName = 'updatedlastname', email = 'updatedemail@example.com'
WHERE ID = '166135000000038075'

Borrar

Los contactos se pueden eliminar proporcionando la identificación y emitiendo una instrucción DELETE.

DELETE FROM Contacts WHERE ID = '123456000000040053' 

Columnas

Eventos

Obtiene todas las etiquetas presentes en un portal específico.

Seleccionar

• Status admite el siguiente operador =.

Por ejemplo, la siguiente consultar se procesa del lado del servidor:

SELECT * FROM Events WHERE Status = 'open'

Insertar

Para crear un nuevo Evento puede especificar los siguientes campos:

• Título
• DuraciónHora
• DuraciónMinutos
• Ubicación
• Participantes
• Recordatorio
• Repetir
• Programado en
• Repetir tiempos

INSERT INTO Events (Title, ScheduledOn, DurationHour, DurationMinutes, Participants, Reminder, Repeat, Location)
VALUES ('SQL Event #2', '2022-03-20T18:00:00', '2', '30', '20081249448', '15 mins', 'only once', 'Test Location 2')

Actualizar

Para actualizar un evento, especifique el campo ID.

UPDATE Events
    SET title = 'Updated Title #1', DurationHour = '4', DurationMinutes = '10', ScheduledOn = '2022-05-01T23:12:00', Participants = '20081249448'
WHERE ID = '123456000000045018'

Borrar

Los eventos se pueden eliminar proporcionando la ID y emitiendo una instrucción DELETE.

DELETE FROM Events WHERE ID = '123456000000045018'  

Columnas

Pseudo-Columnas

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

ForoCategorías

Obtiene todas las categorías del foro.

Seleccionar

Puede utilizar la siguiente consultar para obtener todas las categorías del foro:

SELECT * FROM ForumCategories

Insertar

Para crear una nueva categoría de foro, puede utilizar la siguiente consultar:

INSERT INTO ForumCategories (name) VALUES ('New Forum Category')

Borrar

Las categorías de foro se pueden eliminar proporcionando el ID y emitiendo una instrucción DELETE.

DELETE FROM ForumCategories WHERE ID = '123456000000045018'

Columnas

ForoComentarios

Obtiene todos los comentarios del foro.

Seleccionar

• ForumId es necesario para recuperar los comentarios del foro.

Puede utilizar la siguiente consultar para obtener todos los comentarios del foro:

SELECT * FROM ForumComments WHERE ForumId = '123456000000045018'

Insertar

Para crear un nuevo comentario en el foro, puede utilizar la siguiente consultar:

INSERT INTO ForumComments (ForumId, Content, ParentId)
VALUES ('123456000000045028', 'Forum Comment Reply', '123456000000043083')

Borrar

Los comentarios del foro se pueden eliminar proporcionando el Id, ForumId y emitiendo una declaración DELETE.

DELETE FROM ForumComments WHERE ID = '123456000000043083' AND ForumId = '123456000000045028'

Columnas

Foros

Obtiene todos los foros en el proyecto dado.

Seleccionar

• Id y CategoryId admite el siguiente operador: =.

Por ejemplo, la siguiente consultar se procesa del lado del servidor:

SELECT * FROM Forums WHERE ID = '123456000000043771' 

Insertar

Para crear un nuevo Foro, puede especificar los siguientes campos:

• Nombre
• Tipo
• Categoria ID
• Contenido
• Bandera
• Es un mensaje de anuncio
• EsStickyPost
• Notificar

Para crear un nuevo foro, puede utilizar la siguiente consultar:

INSERT INTO Forums (Name, Type, CategoryId, Content, Flag, IsAnnouncementPost, IsStickyPost)
VALUES ('Forum Post', 'normal', '123456000000039039', 'Content for Forum Post', 'internal', false, false)

Actualizar

Para actualizar un foro, especifique el campo ID.

UPDATE Forums
    SET Name = 'Updated Post Name', CategoryId = '123456000000093039', Content = 'Updated forum post content' 
WHERE ID = '123456000000043771' 

Borrar

Los foros se pueden eliminar proporcionando la ID y emitiendo una instrucción DELETE.

DELETE FROM Forums WHERE ID = '123456000000043771' 

Columnas

Hitos

Obtiene una lista de diseños de proyectos.

Seleccionar

Columnas que admiten el operador =:

• Identificación
• Bandera
• ID de propietario
• Estado
• Tipo de visualización
• LastModifiedTime

Por ejemplo, la siguiente consultar se procesa del lado del servidor:

SELECT * FROM Milestones WHERE ID = '123456000000043771' WHERE flag = 'internal' 

Insertar

Para crear un nuevo Hito puede especificar los siguientes campos:

• Nombre
• Bandera
• Fecha de inicio
• Fecha final
• ID de propietario

Para crear un nuevo hito, puede utilizar la siguiente consultar:

INSERT INTO Milestones (name, StartDate, EndDate, OwnerId, flag)
VALUES ('New Milestone name', '2022-03-01', '2022-03-10', '1234567890', 'internal')

Actualizar

Para actualizar un hito, especifique el campo ID.

UPDATE Milestones
    SET Name = 'Updated Name',
        Flag = 'external',
        StartDate = '2022-02-01',
        EndDate = '2022-03-01',
        OwnerId = '1234567890' " +
WHERE ID = '123456000000043021'

Borrar

Los hitos se pueden eliminar proporcionando el ID y emitiendo una instrucción DELETE.

DELETE FROM Milestones WHERE ID = '123456000000043021' 

Columnas

Pseudo-Columnas

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

PortalClientes

Devuelve la lista de empresas clientes en el portal.

Seleccionar

Puede utilizar la siguiente consultar para obtener todos los clientes del portal:

SELECT * FROM PortalClients

Insertar

Para crear un nuevo PortalClient puede especificar los siguientes campos:

• Nombre
• Ciudad
• País
• Estado
• Primera dirección
• Segunda Dirección
• Dirección web
• Código postal
• Correo electrónico del usuario
• Proyectos de trabajo
• Cliente primario

INSERT INTO PortalClients (Name, UserEmail, WebAddress, FirstAddress, SecondAddress, City, State, Country, PrimaryClient, ZipCode)
VALUES ('Company12', 'email1@example.com', 'www.example.com', 'Address line 1', 'Address line 2', 'Budapest', 'Hungary', 'Hungary', 'Yes', '1025')

Columnas

Portales

Obtiene todos los portales del usuario que ha iniciado sesión.

Seleccionar

El conector utilizará la API de Zoho Projects para procesar las condiciones de la cláusula WHERE creadas con las siguientes columnas y operadores. El resto del filtro se ejecuta del lado del cliente dentro del conector.

• Id y ViewId admite el siguiente operador: =.

Por ejemplo, la siguiente consultar se procesa del lado del servidor:

SELECT * FROM Portals WHERE ID = '20081021809'

Columnas

Pseudo-Columnas

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

ProyectoEntidadPropiedadesProyectoEntidadPropiedades

Recupera los datos almacenados contra una entidad. El argumento de este método debe ser la clave que se usó cuando se almacenaron los mismos datos.

Información Específica de la Tabla

Las propiedades de entidad son pares clave-valor almacenados en las entidades del proyecto. Se pueden usar para almacenar detalles necesarios para las integraciones de API, pero no es necesario que estén visibles en la interfaz de usuario. La clave debe ser una cadena y el valor podría ser una cadena simple o un objeto json. Puede almacenar múltiples par clave-valor para una sola entidad. Estas propiedades de entidad se pueden almacenar/recuperar/actualizar/eliminar utilizando las siguientes consultas.

Seleccionar

• PropertyKey es necesario para recuperar ProjectEntityProperties.

Por ejemplo, la siguiente consultar se procesa del lado del servidor:

SELECT * FROM ProjectEntityProperties WHERE PropertyKey = 'key1' 

Insertar

Para agregar una nueva propiedad de entidad de proyecto, especifique los campos PropertyKey y PropertyValue.

INSERT INTO ProjectEntityProperties (PropertyKey, PropertyValue) VALUES ('key1', 'This is a test value')

Actualizar

ZohoProjects permite actualizaciones para la columna PropertyValue.

UPDATE ProjectEntityProperties SET PropertyValue = 'This is an updated property value' WHERE PropertyKey = 'key1'

Borrar

Las propiedades de la entidad del proyecto se pueden eliminar proporcionando Id, PropertyKey y emitiendo una instrucción DELETE.

DELETE FROM ProjectEntityProperties WHERE PropertyKey = 'key1' AND ID = '166135000000035001'

Columnas

Grupos de Proyectos

Obtiene todos los grupos del proyecto especificado.

Seleccionar

Puede utilizar la siguiente consultar para obtener todos los grupos de proyectos:

SELECT * FROM ProjectGroups

Insertar

Para crear un nuevo ProjectGroup, puede utilizar la siguiente consultar:

INSERT INTO ProjectGroups(name) VALUES ('New Project Group')

Borrar

Los grupos de proyectos se pueden eliminar proporcionando el ID y emitiendo una instrucción DELETE.

DELETE FROM ProjectGroups WHERE ID = '123456000000045018'  

Columnas

Proyectos

Obtiene todos los proyectos del usuario que ha iniciado sesión.

Seleccionar

Columnas que admiten el operador =:

• Identificación
• Fecha de creación
• Estado
• LastModifiedTime

Columnas que admiten el operador = y IN:

• Identificación del grupo
• cesionario

Por ejemplo, la siguiente consultar se procesa del lado del servidor:

SELECT * FROM Projects WHERE ID = '123456000000039053' 

Insertar

Para crear un nuevo Proyecto puede especificar los siguientes campos:

• Nombre
• Estado de facturación
• Tipo de facturación
• Divisa
• Descripción
• Público
• ID de propietario
• Tipo de presupuesto
• Valor del presupuesto
• Tasa
• Método de seguimiento del presupuesto
• Costo fijo
• ID de plantilla
• Límite
• Fecha de inicio
• Fecha final
• Habilitar resumen

Para crear un nuevo Proyecto, especifique los siguientes campos:

INSERT INTO Projects (Name, BudgetType, BudgetValue, BillingStatus, BillingType, Currency, Description, Public, BudgetType, BudgetTrackingMethod)
VALUES ('New Project', '2', '2.5', 'Billable', '2', 'EUR', 'TestDescription 123', 'no', '2', '4')

Actualizar

Puede utilizar la siguiente consultar para actualizar un proyecto:

UPDATE Projects
    SET Currency = 'USD', SingleLinCustomField = 'New Custom Field Value' 
WHERE ID = '123456000000039053'

Borrar

Los proyectos se pueden eliminar proporcionando el ID y emitiendo una instrucción DELETE.

DELETE FROM Projects WHERE ID = '123456000000039053' 

Columnas

Pseudo-Columnas

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

ProyectoUsuarios

Obtiene los detalles de todos los usuarios en un proyecto específico.

Columnas

Estados

Obtiene los estados para el proyecto dado.

Seleccionar

Puede utilizar la siguiente consultar para obtener todos los estados:

SELECT * FROM Statuses

Insertar

Para crear un nuevo estado, puede especificar los siguientes campos:

INSERT INTO Statuses (Content) VALUES ('My Custom Status')

Columnas

Etiquetas

Obtiene todas las etiquetas presentes en un portal específico.

Seleccionar

Puede utilizar la siguiente consultar para obtener todas las etiquetas:

SELECT * FROM Tags

Insertar

Para crear una nueva etiqueta, puede especificar los siguientes campos:

INSERT INTO Tags (Name, ColorClass) VALUES ('New Tag', 'bg-tag16') 

Actualizar

Para actualizar una etiqueta, especifique el campo ID.

UPDATE Tags SET Name = 'Updated Name', ColorClass = 'bg-tag99' WHERE ID = '123456000000043057'

Borrar

Las etiquetas se pueden eliminar proporcionando la ID y emitiendo una instrucción DELETE.

DELETE FROM Tags WHERE ID = '123456000000043057' 

Columnas

Pseudo-Columnas

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

TareaActividades

Recupere detalles de quién modificó una tarea específica y cuándo.

Seleccionar

• TaskId es necesario para recuperar los comentarios del foro.

Puede utilizar la siguiente consultar para obtener todas las actividades de una tarea determinada:

SELECT * FROM TaskActivities WHERE TaskId = '123456789' 

Columnas

TareaComentarios

Obtenga todos los comentarios de la tarea.

Seleccionar

• TaskId es necesario para recuperar los comentarios de la tarea.
• LastModifiedTime admite el siguiente operador: =.

Por ejemplo, la siguiente consultar se procesa del lado del servidor:

SELECT * FROM TaskComments WHERE TaskId = '123456000000040013'

Insertar

Para agregar un comentario de tarea, especifique los campos TaskId y Comment.

INSERT INTO TaskComments (TaskId, content) VALUES ('123456000000040013', 'SQL Comment #6')

Actualizar

Para actualizar los comentarios de una tarea, especifique el campo ID.

UPDATE TaskComments
    SET Content = 'Updated forum post content' 
WHERE ID = '123456000000043771' AND TaskId = '123456000000040013'

Borrar

Los comentarios de tareas se pueden eliminar proporcionando el ID y emitiendo una instrucción DELETE.

DELETE FROM TaskComments WHERE TaskId = '123456000000045005' AND ID = '123456000000045042' 

Columnas

Pseudo-Columnas

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

TaskCustomfields

Información de uso para la operación TaskCustomfields.rsd.

Columnas

TaskEntityProperties

Recupera los datos almacenados contra una entidad. El argumento de este método debe ser la clave que se usó cuando se almacenaron los mismos datos.

Información Específica de la Tabla

Las propiedades de la entidad son pares clave-valor almacenados en las entidades de la tarea. Se pueden usar para almacenar detalles necesarios para las integraciones de API, pero no es necesario que estén visibles en la interfaz de usuario. La clave debe ser una cadena y el valor podría ser una cadena simple o un objeto json. Puede almacenar múltiples par clave-valor para una sola entidad. Estas propiedades de entidad se pueden almacenar/recuperar/actualizar/eliminar utilizando las siguientes consultas.

Seleccionar

• TaskId y PropertyKey son necesarios para recuperar las propiedades de la entidad de tarea.

Por ejemplo, la siguiente consultar se procesa del lado del servidor:

SELECT * FROM TaskEntityProperties WHERE TaskId = '123456000000034087' AND PropertyKey = 'key1' 

Insertar

Para agregar una nueva propiedad de entidad de tarea, especifique los campos TaskId, PropertyKey y PropertyValue.

INSERT INTO TaskEntityProperties (TaskId, PropertyKey, PropertyValue) VALUES ('123456000000034087', 'key1', 'This is a test value')

Actualizar

ZohoProjects permite actualizaciones para la columna PropertyValue.

UPDATE TaskEntityProperties SET PropertyValue = 'This is an updated property value' WHERE TaskId = '123456000000034087' AND PropertyKey = 'key1'

Borrar

Las propiedades de la entidad de tarea se pueden eliminar proporcionando Id, TaskId, PropertyKey y emitiendo una instrucción DELETE.

DELETE FROM TaskEntityProperties WHERE TaskId = '166135000000034087' AND PropertyKey = 'key1' AND ID = '166135000000035001'

Columnas

Listas de Tareas

Obtenga todas las listas de tareas en el proyecto dado.

Seleccionar

• MilestoneId y Flag admite el siguiente operador: =.

Por ejemplo, la siguiente consultar se procesa del lado del servidor:

SELECT * FROM Tasklists WHERE MilestoneId = '12345600000123' AND Flag = 'internal' 

Insertar

Para crear una nueva lista de tareas, puede especificar los siguientes campos:

• Nombre
• Identificador de hito
• TaskTemplateId
• ShiftDays
• Bandera

INSERT INTO Tasklists (name, flag, ShiftDays)
VALUES ('New Tasklist #2', 'internal', '2022-03-10T01:00:00Z')

Actualizar

Para actualizar una lista de tareas, especifique el campo ID.

UPDATE Tasklists SET Name = 'SQL Updated tasklist #7' WHERE ID = '123456000000041033'

Borrar

Las listas de tareas se pueden eliminar proporcionando la ID y emitiendo una instrucción DELETE.

DELETE FROM Tasklists WHERE ID = '123456000000041033'

Columnas

Pseudo-Columnas

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

Tareas

Obtiene todas las tareas en el proyecto dado. Obtiene solo las tareas principales y no las subtareas.

Seleccionar

Columnas que admiten el operador =:

• Identificación
• Creado por
• Identificador de hito
• Prioridad
• TasklistId
• Dueño
• Estado
• Tiempo
• LastModifiedTime
• ID de vista

• CreatedDate y LastModifiedTime soporte: ORDEN

Por ejemplo, la siguiente consultar se procesa del lado del servidor:

SELECT * FROM Tasks WHERE MilestoneId = '12345600000123' AND Priority = 'High' ORDER BY CreatedDate

Insertar

Para crear una nueva Tarea, puede especificar los siguientes campos:

• Nombre
• Descripción
• Propietarios
• Duración
• Tipo de duración
• Fecha final
• Prioridad
• Fecha de inicio
• TasklistId
• Trabajar
• GroupNameAssociatedTeamsAnyTeam
• Índice por hora
• Cadena de recordatorio
• Recurrencia
• Valor del presupuesto
• Presupuesto Umbral

INSERT INTO Tasks (Name, Description, Duration, DurationType, Priority,  BudgetValue)
VALUES ('New Task #2', 'This is a test description', '5', 'hrs', 'High', '1000')

Actualizar

Para actualizar una tarea, especifique el campo ID.

UPDATE Tasks SET Priority = 'Low' WHERE ID = '123456000000034003'

Borrar

Las tareas se pueden eliminar proporcionando la ID y emitiendo una instrucción DELETE.

DELETE FROM Tasks WHERE ID = '123456000000034003'

Columnas

Pseudo-Columnas

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

TareaSubtareas

Ver todas las subtareas de la tarea dada.

Seleccionar

• TaskId es necesario para recuperar subtareas de tareas.

Puede utilizar la siguiente consultar para obtener todas las subtareas de tareas:

SELECT * FROM TaskSubtasks WHERE TaskId = '12345600000123' 

Insertar

Para crear una nueva Tarea, puede especificar los siguientes campos:

• ID de tarea
• Nombre
• Descripción
• Duración
• Tipo de duración
• Prioridad
• Fecha de inicio
• Fecha final
• Persona responsable

INSERT INTO TaskSubtasks (TaskId, Name, StartDate, EndDate, Duration, DurationType, Priority, Description)
VALUES ('165818000000040013', 'Sql Subtask #4', '2022-03-01', '2022-03-10', '2', 'hrs', 'High', 'Test description of the subtask')

Columnas

TaskTimelogs

Obtiene los registros de tiempo en una tarea específica.

Seleccionar

• TaskId es necesario para recuperar los registros de tiempo de tareas.

Por ejemplo, la siguiente consultar se procesa del lado del servidor:

SELECT * FROM TaskTimelogs WHERE TaskId = '123456000000045005'

Insertar

Para crear un nuevo registro de tiempo de tareas, puede especificar los siguientes campos:

• ID de tarea
• Estado de la factura
• Notas
• Visualización de horas
• Fecha de registro
• ID de propietario

INSERT INTO TaskTimelogs (TaskId, LogDate, BillStatus, HoursDisplay, Notes) " +
VALUES ('123456000000040013', '2022-03-03', 'Non Billable', '01:20', 'This is a test timelog')

Actualizar

Para actualizar un registro de tiempo de tareas, especifique los campos TaskId e ID.

UPDATE TaskTimelogs
    SET Notes = 'This is an updated SQL Note'
WHERE TaskId = '165818000000040013' AND ID = '165818000000045001'

Borrar

Los TimeLogs de tareas se pueden eliminar proporcionando el TaskId y el ID y emitiendo una instrucción DELETE.

DELETE FROM TaskTimelogs WHERE TaskId = '123456000000045005' AND ID = '123456000000044025'

Columnas

Equipos

Obtenga los detalles del equipo del portal.

Seleccionar

Puede utilizar la siguiente consultar para obtener todos los equipos:

SELECT * FROM Teams

Insertar

Para crear un nuevo Equipo puede especificar los siguientes campos:

• Nombre del grupo
• Alias de correo electrónico
• UserIdArr
• Proyectos
• Jefe de equipo

INSERT INTO Teams (GroupName, UserIdArr, TeamLead, ProjIds)" +
VALUES ('TestTeam5', '["123456000000031003", "123456000000032055"]', '123456000000032055', '["123456000000031899"]

Actualizar

Para actualizar un equipo, especifique el campo GroupId.

UPDATE Teams
SET TeamLead = '123456000000031003', 
    UserIdArr = '["123456000000031003", "123456000000032055"]',
    ProjIds = '["123456000000031899"]', 
    GroupName = 'TestTeam5' 
WHERE GroupId = '123456000000036001'

Borrar

Los equipos se pueden eliminar proporcionando el GroupId y emitiendo una instrucción DELETE.

DELETE FROM Teams WHERE GroupId = '123456000000044025' 

Columnas

EquipoUsuarios

Obtener detalles de un equipo en particular.

Seleccionar

• GroupId es necesario para recuperar los usuarios del equipo.

Puede utilizar la siguiente consultar para obtener todos los usuarios del equipo:

SELECT * FROM TeamUsers WHERE GroupId = '123456000000033021'

Insertar

Para crear un nuevo Equipo debes especificar los siguientes campos:

• Identificación del grupo
• Zpuid

INSERT INTO TeamUsers (GroupId, ZPUID)
VALUES ('123456000000034163', '123456000000031003')

Borrar

TeamUsers se puede eliminar proporcionando GroupId e ID y emitiendo una instrucción DELETE.

DELETE FROM TeamUsers WHERE GroupId = '123456000000034163' AND ID = '123456000000031003'

Columnas

Usuarios

Obtiene los detalles de todos los usuarios en un proyecto específico.

Columnas

Pseudo-Columnas

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

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.

Se admiten las vistas dinámicas, como las consultas expuestas como vistas y las vistas para buscar combinaciones específicas de elementos de trabajo project_team.

Conector Jitterbit para Vistas de Zoho Projects

Actividades

Enumere todas las actividades recientes del proyecto.

Seleccionar

Esta es una vista a nivel de proyecto. Puede utilizar la siguiente consultar para obtener todas las actividades:

SELECT * FROM Activities

Columnas

ErrorActividades

Obtiene todas las actividades para el error dado.

Seleccionar

Esta es una vista a nivel de error.

• BugId es necesario para recuperar BugActivities.

Puede usar la siguiente consultar para obtener todas las BugActivities:

SELECT * FROM BugActivities WHERE BugId = '12345600001'

Columnas

Archivos Adjuntos

Obtenga detalles de los archivos adjuntos para un error.

Columnas

BugCustomFields

Obtiene todos los campos personalizados en el proyecto dado.

Seleccionar

Esta es una vista a nivel de proyecto. Puede utilizar la siguiente consultar para obtener todos los BugCustomFields:

SELECT * FROM BugCustomFields WHERE BugId = '12345600001'

Columnas

Resolución de Errores

Obtenga la resolución del error.

Columnas

Clientela

Devuelve la lista de empresas cliente asociadas con un ID de proyecto específico.

Seleccionar

Esta es una vista a nivel de proyecto.

• Id admite el siguiente operador: =.

Por ejemplo, la siguiente consultar se procesa del lado del servidor:

SELECT * FROM Clients WHERE ID = '12345600001'

Columnas

Documentos

Enumere todas las actividades recientes del proyecto.

Columnas

Mis Bichos

Enumera todos los errores creados por usted o asignados a usted.

Seleccionar

Esta es una vista a nivel de portal.

• StatusType, Owner, ViewType y ViewType admite el siguiente operador: =.
• CreatedDate y LastModifiedTime soporte: ORDEN

Por ejemplo, la siguiente consultar se procesa del lado del servidor:

SELECT * FROM MyBugs WHERE Owner = '12345021738' AND ViewType = 'owned' AND StatusType = 'open' ORDER BY CreatedDate

Columnas