Saltar al contenido

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

Nombre Descripción
BugAssociatedTasks Obtiene los detalles de la tarea asociada con un error.
BugComments Obtener comentarios para el error.
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.
BugFollowers Obtenga una lista de seguidores para el error.
Bugs Obtiene todas las tareas en el proyecto dado. Obtiene solo las tareas principales y no las subtareas.
BugTimelogs Obtiene los registros de tiempo bajo un error específico.
Contacts Obtiene todos los contactos de clientes de un portal.
Events Obtiene todas las etiquetas presentes en un portal específico.
ForumCategories Obtiene todas las categorías del foro.
ForumComments Obtiene todos los comentarios del foro.
Forums Obtiene todos los foros en el proyecto dado.
Milestones Obtiene una lista de diseños de proyectos.
PortalClients Devuelve la lista de empresas clientes en el portal.
Portals Obtiene todos los portales del usuario que ha iniciado sesión.
ProjectEntityProperties 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.
ProjectGroups Obtiene todos los grupos del proyecto especificado.
Projects Obtiene todos los proyectos del usuario que ha iniciado sesión.
ProjectUsers Obtiene los detalles de todos los usuarios en un proyecto específico.
Statuses Obtiene los estados para el proyecto dado.
Tags Obtiene todas las etiquetas presentes en un portal específico.
TaskActivities Recupere detalles de quién modificó una tarea específica y cuándo.
TaskComments Obtenga todos los comentarios de la tarea.
TaskCustomfields Información de uso para la operación TaskCustomfields.rsd.
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.
Tasklists Obtenga todas las listas de tareas en el proyecto dado.
Tasks Obtiene todas las tareas en el proyecto dado. Obtiene solo las tareas principales y no las subtareas.
TaskSubtasks Ver todas las subtareas de la tarea dada.
TaskTimelogs Obtiene los registros de tiempo en una tarea específica.
Teams Obtenga los detalles del equipo del portal.
TeamUsers Obtener detalles de un equipo en particular.
Users Obtiene los detalles de todos los usuarios en un proyecto específico.

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
Nombre Tipo Solo lectura Descripción
BugId String Falso Identificación de error.
TaskId String Falso ID de tarea asociada.
TaskName String Falso Nombre de la tarea asociada.
Prefix String Falso Prefijo de tarea asociado.
ProjectId String Falso ID de proyecto de tarea asociada.
TaskOwners String Falso Propietarios de tareas asociadas.
TaskPercentageCompleted String Falso Porcentaje de tareas asociadas completadas.
TaskPriority String Falso Prioridad de la tarea asociada.
TaskListId String Falso ID de la lista de tareas asociada.

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
Nombre Tipo Solo lectura Descripción
BugId [KEY] String Falso Identificación de error.
Id [KEY] String Falso ID de comentario de error.
Comment String Falso Contenido de comentarios de errores.
AddedBy String Falso Comentario de error agregado por.
AddedPersonName String Falso Comentario de error Nombre de persona agregado.
CreatedDate Date Falso Fecha de creación del comentario de error.
CreatedDateTime Datetime Falso Comentario de error Fecha de creación Hora.
UpdatedBy String Falso Comentario de error actualizado por.
UpdatedPerson String Falso Comentario de error Persona actualizada.
UpdatedDate Date Falso Fecha de actualización del comentario de error.
UpdatedDateTime Datetime Falso Comentario de error Actualizado Fecha Hora.

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
Nombre Tipo Solo lectura Descripción
Id [KEY] String Falso ID de propiedad de entidad de error.
BugId [KEY] String Falso Identificación de error.
PropertyKey [KEY] String Falso Clave de propiedad de entidad de errores.
PropertyValue String Falso Valor de la propiedad de la entidad del error.

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
Nombre Tipo Solo lectura Descripción
BugId [KEY] String Falso Identificación de error.
FollowerId String Falso ID de seguidor de error.
FollowerName String Falso Nombre del seguidor de errores.
BugFollowers String Falso Seguidores de errores.

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
Nombre Tipo Solo lectura Descripción
Id [KEY] String Falso Identificación de error.
Key String Falso Clave de errores.
Title String Falso Título del error.
AssigneeId String Falso ID del responsable del error.
AssigneeName String Falso Nombre del responsable del error.
AssigneeZpuid String Falso Error asignado ZPUID.
AttachmentCount String Falso Recuento de errores adjuntos.
BugNumber String Falso Número de error.
BugPrefix String Falso Prefijo de error.
ClassificationId Long Falso Identificación de clasificación de error.
ClassificationType String Falso Tipo de clasificación de errores.
Closed Boolean Falso Error cerrado.
CommentCount String Falso Recuento de comentarios de errores.
CreatedTime Date Falso Hora de creación del error.
CreatedDateTime Datetime Falso Fecha de creación del error Hora.
Description String Falso Descripción del error.
DueDate Date Falso Fecha de vencimiento del error.
DueDateTime Datetime Falso Fecha de vencimiento del error Hora.
EscalationLevel String Falso Nivel de escalada de errores.
Flag String Falso Bandera de error. Los valores permitidos son interno, externo.
LinkSelfUrl String Falso URL propia de enlace de error.
LinkTimesheetUrl String Falso Url del parte de horas del vínculo del error.
LinkWebUrl String Falso Url web de enlace de error.
ModuleId Long Falso ID del módulo de errores.
ModuleName String Falso Nombre del módulo de error.
ReportedPerson String Falso Persona reportada por error.
ReporterEmail String Falso Correo del informador de errores.
ReporterId String Falso Identificación del informador de errores.
ReporterNonZuser String Falso Informador de errores No usuario.
ReproducibleId Long Falso Identificación del error reproducible.
ReproducibleType String Falso Tipo de error reproducible.
SeverityId Long Falso Identificación de la gravedad del error.
SeverityType String Falso Tipo de gravedad del error.
StatusColorcode String Falso Código de color del estado del error.
StatusId String Falso Identificación del estado del error.
StatusType String Falso Tipo de estado de error. Los valores permitidos son abierto, cerrado.
UpdatedDate Date Falso Fecha de actualización del error.
UpdatedDateTime Datetime Falso Fecha de actualización del error Hora.
GroupNameAssociatedTeamsAnyTeam String Falso Nombre del grupo de errores Equipos asociados por cualquier equipo.
GroupNameAssociatedTeamsCount Integer Falso Nombre del grupo de errores Recuento de equipos asociados.
GroupNameIsTeamUnassigned Boolean Falso El nombre del grupo de errores es el equipo sin asignar.
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
HourlyRate String Tarifa por hora de error.
BugFollowers String Seguidores de errores.
CustomViewId String ID de vista personalizada del error.
MilestoneId String ID de hito de error.
AffectedMilestoneId String Id. de hito afectado por error.

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
Nombre Tipo Solo lectura Descripción
BugId [KEY] String Falso Identificación de error.
Id [KEY] String Falso ID de registro de tiempo de error.
AddedByName String Falso Registro de tiempo de errores agregado por nombre.
AddedByZpuid String Falso Registro de tiempo de error agregado por ZPUID.
AddedByZuid Long Falso Registro de tiempo de error agregado por ZUID.
ApprovalStatus String Falso Estado de aprobación del registro de tiempo de error.
ApproverName String Falso Nombre del aprobador del registro de tiempo de errores.
BillStatus String Falso Estado de factura de registro de tiempo de error. Los valores permitidos son Facturable, No facturable.
BugTitle String Falso Título del error de registro de tiempo de errores.
CreatedDate Date Falso Fecha de creación del registro de hora del error.
CreatedDateTime Datetime Falso Registro de hora del error Fecha de creación Hora.
Hours Integer Falso Horas de registro de tiempo de error.
Minutes Integer Falso Minutos de registro de tiempo de errores.
HoursDisplay String Falso Visualización de horas de registro de tiempo de errores.
LastModifiedDate Date Falso Fecha de última modificación del registro de hora del error.
LastModifiedDateTime Datetime Falso Error Hora Registro Última modificación Fecha Hora.
LinkSelfUrl String Falso Url propia de enlace de registro de tiempo de error.
LogDate Date Falso Fecha de registro de hora del error.
LogDateTime Datetime Falso Error Hora Registro Fecha Hora.
Notes Unknown Falso Notas de registro de tiempo de error.
OwnerId String Falso ID del propietario del registro de tiempo de error.
OwnerName String Falso Nombre del propietario del registro de tiempo de errores.
TotalMinutes Integer Falso Minutos totales de registro de tiempo de errores.

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
Nombre Tipo Solo lectura Descripción
ClientId String Falso Identificación del cliente de contacto.
Id [KEY] String Falso Identificación de contacto.
CrmContactId String Falso Póngase en contacto con CRM ID de contacto.
DisplayName String Falso Nombre para mostrar del contacto.
FirstName String Falso Nombre de contacto.
LastName String Falso Apellido del contacto.
Email String Falso Correo de contacto.
InvoiceRate String Falso Tasa de facturación de contacto.
WorkProjects String Falso Matriz de ID de proyectos. Varias identificaciones se pueden separar con comas.

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
Nombre Tipo Solo lectura Descripción
Id [KEY] String Falso Identificación del evento.
Title String Falso Título del evento.
CreatedBy String Falso Evento creado por.
CreatedByZpuid String Falso Evento creado por ZPUID.
CreatedOn Long Falso Evento creado el.
DurationHour String Falso Hora de duración del evento.
DurationMinutes String Falso Minutos de duración del evento.
Location String Falso Lugar del evento.
Occurred Integer Falso Evento ocurrido.
Occurrences Integer Falso Ocurrencias de eventos.
Participants String Falso Participantes del evento.
ProjectName String Falso Nombre del proyecto del evento.
Reminder String Falso Recordatorio de eventos. Los valores permitidos son a tiempo, 15 min, 30 min, 1 hora, 2 horas, 6 horas, 12 horas, 1 día.
Repeat String Falso Repetición de eventos. Los valores permitidos son solo una vez, todos los días, todas las semanas, todos los meses, todos los años.
ScheduledOn String Falso Evento programado el.
ScheduledOnLong String Falso Evento programado en Long.
ScheduledOnTo String Falso Evento programado el hasta.
ScheduledOnToLong String Falso Evento programado para demasiado largo.
RepeatTimes String Falso Tiempos de repetición de eventos. Los valores permitidos son 2, 3, 4, 5, 6, 7, 8, 9, 10.
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
Status String Estado del evento. Los valores permitidos son abierto, cerrado.

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
Nombre Tipo Solo lectura Descripción
Id [KEY] String Falso Id. de la categoría del foro.
Name String Falso Nombre de la categoría del foro.

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
Nombre Tipo Solo lectura Descripción
ForumId [KEY] Long Falso ID del foro.
Id [KEY] String Falso Id. de comentario del foro.
Content String Falso Contenido del comentario del foro.
Type String Falso Tipo de comentario del foro.
Attachments String Falso Archivos adjuntos de comentarios del foro.
IsBestAnswer Boolean Falso El comentario del foro es la mejor respuesta.
Level String Falso Nivel de comentario del foro.
ParentId String Falso Comentario del foro Id. del padre.
ParentPostedBy String Falso Comentario del foro Padre publicado por.
ParentPostedByZpuid String Falso Foro Comentario Padre Publicado por ZPUID.
PostDate Date Falso Fecha de publicación del comentario del foro.
PostDateTime Datetime Falso Foro Comentario Publicar Fecha Hora.
PostedBy String Falso Comentario del foro publicado por.
PostedByZpuid String Falso Comentario del foro publicado por Zpuid.
PostedPerson String Falso Comentario del foro Persona publicada.
RootId String Falso Id. de la raíz del comentario del foro.
ThirdPartyAttachments String Falso Comentarios del foro Archivos adjuntos de terceros.

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
Nombre Tipo Solo lectura Descripción
Id [KEY] String Falso ID del foro.
Name String Falso Nombre del Foro.
Type String Falso Tipo de foro. Los valores permitidos son normal, pregunta.
Attachments String Falso Archivos adjuntos del foro.
CategoryId String Falso Id. de la categoría del foro.
CategoryName String Falso Nombre de la categoría del foro.
CommentCount Integer Falso Recuento de comentarios del foro.
Content String Falso Contenido del foro.
Flag String Falso Bandera del foro.
IsAnnouncementPost Boolean Falso El foro es una publicación de anuncio.
IsStickyPost Boolean Falso El foro es una publicación fija.
LastActivityDate Date Falso Fecha de última actividad del foro.
LastActivityDateTime Datetime Falso Última actividad del foro Fecha Hora.
LastModifiedDate Date Falso Fecha de última modificación del foro.
LastModifiedDateTime Datetime Falso Fecha de última modificación del foro Hora.
LinkSelfUrl String Falso Url propia del enlace del foro.
PostDate Date Falso Fecha de publicación del foro.
PostDateTime Datetime Falso Hora de la fecha de publicación del foro.
PostedBy String Falso Foro publicado por.
PostedByZpuid String Falso Foro publicado por ZPUID.
PostedPerson String Falso Persona publicada en el foro.
ThirdPartyAttachments String Falso Archivos adjuntos de terceros del foro.
Notify String Falso Ingrese las ID de correo electrónico del usuario para recibir la notificación ( los correos múltiples pueden estar separados por comas).

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
Nombre Tipo Solo lectura Descripción
Id [KEY] String Falso Id. de hito del proyecto.
Name String Falso Nombre del hito del proyecto.
Flag String Falso Bandera de hito. Los valores permitidos son interno, externo.
Closed Boolean Falso Hito cerrado.
CreatedDate Date Falso Fecha de creación del hito.
CreatedDateTime Datetime Falso Fecha y hora de creación del hito.
StartDate Date Falso Fecha de inicio del hito.
StartDateTime Datetime Falso Hora de la fecha de inicio del hito.
EndDate Date Falso Fecha de finalización del hito.
EndDateTime Datetime Falso Hora de la fecha de finalización del hito.
Actual Integer Falso Hito Real.
ActualCostFormatted String Falso Costo real de hito formateado.
ActualHoursFormatted String Falso Horas reales de hitos formateadas.
Balance Integer Falso Saldo de hitos.
BalanceCostFormatted String Falso Costo de saldo de hitos formateado.
BcyActual Integer Falso Hito Bcy Real.
BcyActualCost String Falso Milestone Bcy Coste real.
BcyForecasted Integer Falso Hito Bcy Pronosticado.
BcyForecastedCost String Falso Milestone Bcy Coste previsto.
BcyPlanned Integer Falso Hito Bcy Planeado.
BcyPlannedCost String Falso Milestone Bcy Coste planificado.
BudgetType Integer Falso Tipo de presupuesto de hito.
CurrencyCode String Falso Código de moneda de hito.
Difference Integer Falso Diferencia de hitos.
DifferenceFormatted String Falso Diferencia de hitos formateada.
Forecasted Integer Falso Hito previsto.
ForecastedCostFormatted String Falso Costo pronosticado de hito formateado.
ForecastedHoursFormatted String Falso Horas pronosticadas de hitos formateadas.
LastCalculatedTime String Falso Última hora calculada del hito.
Planned Integer Falso Hito planeado.
PlannedCostFormatted String Falso Costo planificado de hitos con formato.
PlannedHoursFormatted String Falso Horas planificadas de hitos formateadas.
IsWorkfieldRemoved Boolean Falso El hito es el campo de trabajo eliminado.
LastUpdatedDate Date Falso Fecha de última actualización del hito.
LastUpdatedDateTime Datetime Falso Hito Fecha de última actualización Hora.
SelfUrl String Falso Url propia de hito.
StatusUrl String Falso Url de estado de hito.
OwnerId String Falso Identificación del propietario del hito.
OwnerName String Falso Nombre del propietario del hito.
OwnerZpuid String Falso Milestone Propietario ZPUID.
ProjectId String Falso Projecto ID.
ProjectName String Falso Nombre del proyecto.
Sequence Integer Falso Secuencia de hitos.
Status String Falso Estado. Los valores permitidos son completed, notcompleted.
StatusColorCode String Falso Código de color de estado.
StatusId String Falso Identificación de estado.
StatusName String Falso Nombre de estado.
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
DisplayType String Tipo de visualización de hitos. Los valores permitidos son próximo, retrasado.
LastModifiedTime Datetime Hora de la última modificación del hito.

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
Nombre Tipo Solo lectura Descripción
Id [KEY] String Falso Identificación del cliente.
Name String Falso Nombre del cliente.
City String Falso Ciudad del Cliente.
Country String Falso País del cliente.
State String Falso Estado del cliente.
CrmAccountId String Falso ID de la cuenta CRM del cliente.
FirstAddress String Falso Primera dirección del cliente.
SecondAddress String Falso Segunda dirección del cliente.
WebAddress String Falso Dirección web del cliente.
ZipCode String Falso Código postal del cliente.
UserId String Falso ID de usuario del cliente.
UserName String Falso Nombre de usuario del cliente.
UserEmail String Falso Correo del usuario del cliente.
UserZpuid String Falso Cliente Usuario Zpuid.
WorkProjects String Falso Proyectos de trabajo del cliente.
PrimaryClient String Falso Cliente Cliente principal. Los valores permitidos son Sí, No.

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
Nombre Tipo Solo lectura Descripción
Id [KEY] String Falso Identificación del portal.
Name String Falso Nombre del Portal.
CompanyName String Falso Nombre de la empresa del portal.
AvailableClients Integer Falso Portal Clientes Disponibles.
AvailableUsers Integer Falso Usuarios Disponibles del Portal.
AvailableProjects Integer Falso Portal de Proyectos Disponibles.
BugPlan String Falso Plan de errores del portal.
BugPlural String Falso Bicho Plural.
BugSingular String Falso Bicho Singular.
CanAddTemplate Boolean Falso Puede agregar una plantilla de portal.
CanCreateProject Boolean Falso Puede crear un proyecto de portal.
Default Boolean Falso Portal predeterminado.
ExtensionsAppSettings String Falso Configuración de la aplicación Ubicaciones de extensiones de portal.
ExtensionsAttachmentPicker String Falso Selector de archivos adjuntos de ubicaciones de extensiones de portal.
ExtensionsBlueprintDuring String Falso Blueprint de ubicaciones de extensiones de portal durante.
ExtensionsIssueTab String Falso Pestaña Problema de ubicaciones de extensiones de portal.
ExtensionsIssuedetailsRightpanel String Falso Portal Extensions Ubicaciones Problema Detalles Panel derecho.
ExtensionsProjectTab String Falso Pestaña Proyecto de ubicaciones de extensiones de portal.
ExtensionsTaskTab String Falso Pestaña de tareas Ubicaciones de extensiones de portal.
ExtensionsTaskTransition String Falso Transición de tareas de ubicaciones de extensiones de portal.
ExtensionsTaskdetailsRightpanel String Falso Extensiones del portal Ubicaciones Tarea Detalles Panel derecho.
ExtensionsTopBand String Falso Portal Extensiones Ubicaciones Top Band.
GmtTimeZone String Falso Huso Horario GMT del portal.
GmtTimeZoneOffset Integer Falso Compensación de Huso Horario GMT del portal.
MeetingEnabled Boolean Falso Reunión del portal habilitada.
PeopleEnabled Boolean Falso Gente del portal habilitada.
CrmPartner Boolean Falso Socio del Portal CRM.
DisplayProjectPrefix Boolean Falso Prefijo del proyecto de visualización del portal.
DisplayTaskPrefix Boolean Falso Prefijo de tarea de visualización del portal.
NewPlan Boolean Falso Portal Nuevo Plan.
SprintsIntegrated Boolean Falso Sprints de portal integrados.
TagsAvailable Boolean Falso Etiquetas de portal disponibles.
TimeLogRestricted Boolean Falso Registro de tiempo del portal restringido.
ProjectsModuleId String Falso ID del módulo de proyectos del portal.
TasksModuleId String Falso ID del módulo de tareas del portal.
ProjectUrl String Falso URL del proyecto del portal.
LocaleCode String Falso Código de configuración regional del portal.
LocaleCountry String Falso País de la configuración regional del portal.
Language String Falso Lenguaje de portales.
LoginZpuid Long Falso Acceso al portal ZPUID.
MaxClients Integer Falso Clientes de Portal Max.
MaxUsers Integer Falso Usuarios de Portal Max.
NewUserPlan Boolean Falso Portal Plan Nuevo Usuario.
PercentageCalculation String Falso Cálculo del Porcentaje del Portal.
Plan String Falso Plano Portales.
ProfileId Long Falso Identificación del perfil del portal.
ProfileName String Falso Nombre del perfil del portal.
ProfileType Integer Falso Tipo de perfil de portal.
ActiveProjects Integer Falso Portal Proyectos Activos.
ProjectPrefix String Falso Prefijo del proyecto del portal.
Role String Falso Función de portal.
RoleId String Falso Id. de rol del portal.
RoleName String Falso Nombre del rol del portal.
BusinessHoursEnd Integer Falso Fin del horario comercial del portal.
BusinessHoursStart Integer Falso Inicio del horario comercial del portal.
DateFormat String Falso Formato de fecha del portal.
DefaultCurrency String Falso Moneda predeterminada del portal.
DefaultDependencyType String Falso Tipo de dependencia predeterminado del portal.
BudgetPermission Boolean Falso Permiso de presupuesto del portal.
Holidays String Falso Vacaciones del Portal.
BudgetEnabled Boolean Falso Presupuesto del portal habilitado.
LastSyncTime String Falso Hora de la última sincronización del portal.
StartDayOfWeek String Falso Día de inicio de portal de la semana.
TaskDateFormat String Falso Formato de fecha de la tarea del portal.
TaskDurationType String Falso Tipo de duración de la tarea del portal.
TimeZone String Falso Huso Horario del portal.
EditTimeLogRestricted Boolean Falso Registro de tiempo de edición del portal restringido.
LogFutureTimeAllowed Boolean Falso Registro del portal Tiempo futuro permitido.
LogPastTimeAllowed Boolean Falso Registro del portal Pasado el tiempo permitido.
DefaultBillingStatus String Falso Estado de facturación predeterminado del portal.
TimesheetApprovalEnabled Boolean Falso Aprobación del parte de horas del portal habilitada.
WorkingDays String Falso Días Laborables del Portal.
SprintsProjectPermission Boolean Falso Permiso de proyecto de Sprints de portal.
StorageType String Falso Tipo de almacenamiento del portal.
TrialEnabled Boolean Falso Prueba del portal habilitada.
LogHrRestrictedByWorkHr Boolean Falso Portal Log Hr restringido por Work Hr.
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
ViewId String

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
Nombre Tipo Solo lectura Descripción
Id [KEY] String Falso ID de propiedad de la entidad del proyecto.
PropertyKey [KEY] String Falso Clave de propiedad de la entidad del proyecto.
PropertyValue String Falso Valor de la propiedad de la entidad del proyecto.

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
Nombre Tipo Solo lectura Descripción
Id [KEY] String Falso ID del grupo de proyectos.
Name String Falso Nombre del grupo de proyectos.
Default Boolean Falso Es el grupo de proyecto predeterminado.

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
Nombre Tipo Solo lectura Descripción
Id [KEY] String Falso Projecto ID.
Name String Falso Nombre del proyecto.
Key String Falso Clave del proyecto.
BugsEnabled Boolean Falso Errores del proyecto habilitados.
BillingStatus String Falso Estado de facturación del proyecto. Los valores permitidos son Facturable, No facturable.
BillingType String Falso Mencione el método de facturación para la facturación. (1 = Basado en horas de proyecto, 2 = Basado en horas de personal, 3 = Costo fijo por proyecto, 4 = Basado en horas de tarea/problema). Los valores permitidos son 1, 2, 3, 4.
BugClientPermission String Falso Permiso de cliente de error de proyecto.
BugsClosed Integer Falso Errores del proyecto cerrados.
BugsOpen Integer Falso Errores del proyecto abiertos.
BugsDefaultView String Falso Vista predeterminada de errores del proyecto.
BugsPrefix String Falso Prefijo de errores del proyecto.
CreatedDate Date Falso Fecha de creación del proyecto.
CreatedDateTime Datetime Falso Fecha de creación del proyecto Hora.
CustomStatusColor String Falso Color de estado personalizado del proyecto.
CustomStatusId String Falso ID de estado personalizado del proyecto.
CustomStatusName String Falso Nombre de estado personalizado del proyecto.
Currency String Falso La moneda predeterminada de su proyecto. Ejemplo: USD, INR, etc.
CurrencySymbol String Falso Símbolo de moneda del proyecto.
Description String Falso Descripción del Proyecto.
EnabledTabs String Falso Pestañas habilitadas para proyectos.
ChatEnabled Boolean Falso Chat de proyecto habilitado.
ClientAssignBug String Falso Error de asignación de cliente de proyecto.
Public String Falso Proyecto Público. Los valores permitidos son sí, no.
SprintsProject Boolean Falso Proyecto Proyecto Sprint.
Strict String Falso Proyecto estricto.
BugLayoutId String Falso ID de diseño de error del proyecto.
BugLayoutName String Falso Nombre del diseño del error del proyecto.
ProjectLayoutId String Falso Proyecto ID de diseño de proyecto.
ProjectLayoutName String Falso Proyecto Nombre del diseño del proyecto.
TaskLayoutId String Falso ID de diseño de tarea de proyecto.
TaskLayoutName String Falso Nombre del diseño de la tarea del proyecto.
ActivityUrl String Falso Url de actividad del proyecto.
BugUrl String Falso URL del error del proyecto.
DocumentUrl String Falso URL del documento del proyecto.
EventUrl String Falso URL del evento del proyecto.
FolderUrl String Falso URL de la carpeta del proyecto.
ForumUrl String Falso URL del foro del proyecto.
MilestoneUrl String Falso Url de hito del proyecto.
SelfUrl String Falso URL propia del proyecto.
StatusUrl String Falso URL de estado del proyecto.
TaskUrl String Falso URL de la tarea del proyecto.
TasklistUrl String Falso Url de la lista de tareas del proyecto.
TimesheetUrl String Falso URL del parte de horas del proyecto.
UserUrl String Falso URL de usuario del proyecto.
MilestoneClosed Integer Falso Hito del proyecto cerrado.
MilestoneOpen Integer Falso Proyecto Hito Abierto.
OwnerId String Falso Identificación del propietario del proyecto.
OwnerName String Falso Nombre del propietario del proyecto.
OwnerZpUid String Falso Propietario del proyecto Zp Uid.
ProfileId Long Falso Identificación del perfil del proyecto.
ProjectPercent String Falso Proyecto Proyecto Porcentaje.
Role String Falso Rol del proyecto.
ShowProjectOverview Boolean Falso Proyecto Mostrar descripción general del proyecto.
Status String Falso Estado del proyecto. Los valores permitidos son activo, archivado, modelo.
SettingsDate Boolean Falso Fecha de configuración del proyecto.
SettingsLogHours Boolean Falso Horas de registro de configuración del proyecto.
SettingsPercentage Boolean Falso Porcentaje de configuración del proyecto.
SettingsPlan Boolean Falso Plan de configuración del proyecto.
SettingsWorkHours Boolean Falso Configuración del proyecto Horas de trabajo.
TaskClosed Integer Falso Tarea de proyecto cerrada.
TaskOpen Integer Falso Tarea de proyecto abierta.
TaskbugPrefix String Falso Prefijo de Taskbug del proyecto.
UpdatedDate Date Falso Fecha de actualización del proyecto.
UpdatedDateTime Datetime Falso Fecha de actualización del proyecto Hora.
WorkspaceId String Falso ID del espacio de trabajo del proyecto.
BudgetType String Falso Tipo de su presupuesto. Valores aceptados 0, 1, 2, 3, 4, 5 y 6. (0 = Ninguno, 1 = Basado en monto, 2 = Basado en horas, 3 = Basado en monto hito, 4 = Basado en horas hito, 5 = Basado en la cantidad de la tarea y 6 = Basado en las horas de la tarea). Los valores permitidos son 1, 2, 3, 4, 5, 6.
BudgetTypeValue String Falso Valor del tipo de presupuesto del proyecto.
BudgetValue String Falso Valor del presupuesto del proyecto.
Rate String Falso Tasa de proyecto.
BudgetTrackingMethod String Falso Método para realizar un seguimiento del presupuesto de su proyecto. Valores aceptados 1, 2 y 4. (1 = Horas de proyecto, 2 = Horas de personal, 4 = Horas de tareas/problemas).
FixedCost String Falso Costo fijo del proyecto.
TemplateId String Falso ID de plantilla de proyecto.
Threshold String Falso Especifique el límite del umbral del presupuesto (cantidad u horas).
StartDate String Falso Fecha de inicio del proyecto.
EndDate String Falso Fecha de finalización del proyecto.
EnableRollup String Falso Proyecto Habilitar paquete acumulativo. Los valores permitidos son Sí, No.
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
LastModifiedTime Datetime Hora de la última modificación del proyecto.
GroupId String ID del grupo de proyectos.
Assignee String Cesionario del proyecto.

ProyectoUsuarios

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

Columnas
Nombre Tipo Solo lectura Descripción
Id [KEY] String Falso Identificación de usuario.
Name String Falso Nombre de usuario.
Active Boolean Falso Usuario Activo.
ChatAccess Boolean Falso Acceso al chat de usuario.
Email String Falso Correo del usuario.
PortalProfileName String Falso Nombre del perfil del portal de usuario.
PortalRoleId String Falso Id. de rol del portal de usuario.
PortalRoleName String Falso Nombre de la función del portal de usuario.
ProfileId String Falso Identificación del perfil de usuario.
ProfileType String Falso Tipo de perfil de usuario.
ProjectProfileId String Falso ID de perfil de proyecto de usuario.
Role String Falso Rol del usuario. Los valores permitidos son gerente, empleado, contratista.
RoleId String Falso Identificación del rol de usuario.
RoleName String Falso Nombre de la función de usuario.
Zpuid String Falso UsuarioZPUID.
WorkProjects String Falso Proyectos de trabajo del usuario.
UserType String Falso Usuario Tipo de usuario. Los valores permitidos son activo, inactivo.

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
Nombre Tipo Solo lectura Descripción
Id [KEY] String Falso Identificación de estado.
Content String Falso Contenido de estado.
PostedBy String Falso Estado publicado por.
PostedPerson String Falso Estado de la persona publicada.
PostedDate Date Falso Fecha de publicación del estado.
PostedDateTime Datetime Falso Estado Fecha de publicación Hora.

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
Nombre Tipo Solo lectura Descripción
Id [KEY] String Falso Identificación de la etiqueta.
Name String Falso Nombre de etiqueta.
ColorClass String Falso Clase de color de la etiqueta.
CreatedBy String Falso Etiqueta creada por.
CreatedByName String Falso Etiqueta creada por nombre.
CreatedByEmail String Falso Etiqueta creada por Correo.
CreatedByFirstName String Falso Etiqueta creada por nombre.
CreatedByLastName Unknown Falso Etiqueta creada por apellido.
CreatedByIsClientUser Boolean Falso Etiqueta creada por el usuario del cliente.
CreatedByZpuid String Falso Etiqueta creada por Zpuid.
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
Tags String

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
Nombre Tipo Solo lectura Descripción
TaskId String Falso identificación de la tarea
Id [KEY] String Falso Identificación de la actividad de la tarea.
Name String Falso Nombre de la actividad de la tarea.
ActivityBy String Falso Actividad de la tarea por.
OldValue Unknown Falso Valor antiguo de la actividad de la tarea.
NewValue Unknown Falso Tarea Actividad Nuevo Valor.
State String Falso Estado de la actividad de la tarea.
Time Date Falso Tiempo de actividad de la tarea.
DateTime Datetime Falso Tarea Actividad Fecha Hora.
Zuid String Falso Tarea Actividad ZUID.

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
Nombre Tipo Solo lectura Descripción
TaskId [KEY] String Falso identificación de la tarea
Id [KEY] String Falso ID de comentario de tarea.
Content String Falso Contenido del comentario de la tarea.
AddedPersonId String Falso Tarea Comentario ID de persona añadida.
AddedPersonName String Falso Tarea Comentario Agregado Nombre de persona.
AddedVia String Falso Comentario de tarea añadido a través de.
Attachments String Falso Archivos adjuntos de comentarios de tareas.
CreatedDate Date Falso Fecha de creación del comentario de la tarea.
CreatedDateTime Datetime Falso Tarea Comentario Creado Fecha Hora.
LastModifiedDate Date Falso Tarea Comentario Fecha de última modificación.
LastModifiedDateTime Datetime Falso Tarea Comentario Última modificación Fecha Hora.
ProjectName String Falso Tarea Comentario Nombre del proyecto.
SprintsNotesId Integer Falso Tarea Comentario Sprints Notas Id.
ThirdPartyAttachments String Falso Tarea Comentario Adjuntos de terceros.
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
LastModifiedTime Datetime Hora de última modificación del comentario de la tarea.

TaskCustomfields

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

Columnas
Nombre Tipo Solo lectura Descripción
ColumnName [KEY] String Falso Nombre de la columna del campo personalizado de la tarea.
ColumnType [KEY] String Falso Tipo de columna de campo personalizado de tarea.
DisplayName [KEY] String Falso Nombre para mostrar del campo personalizado de la tarea.
IsDefault [KEY] String Falso El campo personalizado de la tarea es predeterminado.
IsEncrypted [KEY] String Falso El campo personalizado de la tarea está cifrado.
IsMandatory String Falso El campo personalizado de la tarea es obligatorio.

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
Nombre Tipo Solo lectura Descripción
Id [KEY] String Falso ID de propiedad de la entidad de tarea.
TaskId [KEY] String Falso identificación de la tarea
PropertyKey [KEY] String Falso Clave de propiedad de la entidad de tarea.
PropertyValue String Falso Valor de la propiedad de la entidad de la tarea.

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
Nombre Tipo Solo lectura Descripción
Id [KEY] String Falso ID de la lista de tareas.
Name String Falso Nombre de la lista de tareas.
Completed Boolean Falso Lista de tareas completada.
CreatedDate Date Falso Fecha de creación de la lista de tareas.
CreatedDateTime Datetime Falso Fecha de creación de la lista de tareas Hora.
LastUpdatedDate Date Falso Fecha de última actualización de la lista de tareas.
LastUpdatedDateTime Datetime Falso Fecha de última actualización de la lista de tareas Hora.
LinkSelfUrl String Falso Enlace de lista de tareas URL propia.
LinkTaskUrl String Falso Url de tarea de enlace de lista de tareas.
MilestoneClosed Boolean Falso Hito de lista de tareas cerrado.
MilestoneCreatedDate Date Falso Fecha de creación del hito de la lista de tareas.
MilestoneCreatedDateTime Datetime Falso Fecha de creación del hito de la lista de tareas Hora.
MilestoneEndDate Date Falso Fecha de finalización del hito de la lista de tareas.
MilestoneEndDateTime Datetime Falso Fecha de finalización del hito de la lista de tareas Hora.
MilestoneFlag String Falso Indicador de hito de la lista de tareas.
MilestoneId String Falso Id. de hito de lista de tareas.
MilestoneIsWorkfieldRemoved Boolean Falso El hito de la lista de tareas es el campo de trabajo eliminado.
MilestoneLastUpdatedDate Date Falso Fecha de última actualización del hito de la lista de tareas.
MilestoneLastUpdatedDateTime Datetime Falso Lista de tareas Hito Fecha de última actualización Hora.
MilestoneLinkSelfUrl String Falso Url propia de enlace de hito de lista de tareas.
MilestoneLinkStatusUrl String Falso Url de estado de enlace de hito de lista de tareas.
MilestoneName String Falso Nombre del hito de la lista de tareas.
MilestoneOwnerId String Falso ID del propietario del hito de la lista de tareas.
MilestoneOwnerName String Falso Nombre del propietario del hito de la lista de tareas.
MilestoneOwnerZpuid String Falso Propietario de hito de lista de tareas Zpuid.
MilestoneProjectId String Falso ID de proyecto de hito de lista de tareas.
MilestoneProjectName String Falso Nombre del proyecto de hito de la lista de tareas.
MilestoneSequence Integer Falso Secuencia de hitos de la lista de tareas.
MilestoneStartDate Date Falso Fecha de inicio del hito de la lista de tareas.
MilestoneStartDateTime Datetime Falso Hora de fecha de inicio de hito de lista de tareas.
MilestoneStatus String Falso Estado del hito de la lista de tareas.
MilestoneStatusDetColorcode String Falso Lista de tareas Milestone Status Det Colorcode.
MilestoneStatusDetId String Falso Lista de tareas Hito Estado Det Id.
MilestoneStatusDetName String Falso Lista de tareas Hito Estado Det Nombre.
Rolled Boolean Falso Lista de tareas rodada.
Sequence Integer Falso Secuencia de lista de tareas.
TaskCountOpen Integer Falso Cuenta de tareas de lista de tareas abierta.
TaskTemplateId String Falso ID de la modelo de lista de tareas.
ShiftDays Datetime Falso La fecha y hora ISO 8601 a partir de la cual se calcula la fecha de inicio de la tarea, en función de los días de turno.
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
Flag String Indicador de lista de tareas. Los valores permitidos son interno, externo.

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
Nombre Tipo Solo lectura Descripción
Id [KEY] String Falso identificación de la tarea
Name String Falso Nombre de la tarea.
Key String Falso Clave de tareas.
BillingType String Falso Tipo de facturación de la tarea.
Completed Boolean Falso Tarea terminada.
CreatedBy String Falso Tarea creada por.
CreatedByEmail String Falso Tarea creada por Correo.
CreatedByZpuid String Falso Tarea creada por Zpuid.
CreatedPerson String Falso Persona creada por la tarea.
CreatedDate Date Falso Fecha de creación de la tarea.
CreatedDateTime Datetime Falso Fecha de creación de la tarea Hora.
Description String Falso Descripción de la tarea.
Owners String Falso Propietarios de tareas.
Duration String Falso Duración de la tarea.
DurationType String Falso Tipo de duración de la tarea. Los valores permitidos son días, horas.
EndDate Date Falso Fecha de finalización de la tarea.
EndDateTime Datetime Falso Hora de la fecha de finalización de la tarea.
CommentAdded Boolean Falso Comentario de tarea añadido.
DocsAssociated Boolean Falso Documentos de tareas asociados.
ForumAssociated Boolean Falso Tarea Foro Asociado.
RecurrenceSet Boolean Falso Conjunto de recurrencia de tareas.
ReminderSet Boolean Falso Conjunto de recordatorio de tareas.
Parent Boolean Falso Padre de la tarea.
LastUpdatedDate Date Falso Fecha de última actualización de la tarea.
LastUpdatedDateTime Datetime Falso Tarea Fecha de última actualización Hora.
LinkSelfUrl String Falso Url propia del enlace de la tarea.
LinkTimesheetUrl String Falso Url del parte de horas del enlace de la tarea.
LinkWebUrl String Falso Url web del enlace de la tarea.
LogHoursBillableHours String Falso Horas de registro de tareas Horas facturables.
LogHoursNonBillableHours String Falso Registro de tareas Horas Horas no facturables.
MilestoneId String Falso ID de hito de tarea.
OrderSequence Integer Falso Secuencia de orden de tareas.
PercentComplete String Falso Porcentaje de tarea completado.
Priority String Falso Prioridad de tareas. Los valores permitidos son ninguno, bajo, medio, alto.
StartDate Date Falso Fecha de inicio de la tarea.
StartDateTime Datetime Falso Hora de la fecha de inicio de la tarea.
StatusColorCode String Falso Código de color del estado de la tarea.
StatusName String Falso Nombre del estado de la tarea.
StatusId String Falso Identificación del estado de la tarea.
StatusType String Falso Tipo de estado de la tarea.
Subtasks Boolean Falso Subtareas de tareas.
TaskFollowers String Falso Tarea Seguidores de tareas.
TaskFollowerSize Integer Falso Tarea Tamaño del seguidor de tareas.
TasklistId String Falso ID de la lista de tareas.
TasklistName String Falso Nombre de la lista de tareas.
Work String Falso Tarea Trabajo.
WorkForm String Falso Formulario de trabajo de tareas.
WorkType String Falso Tipo de trabajo de la tarea. Los valores permitidos son work_hrs_per_day.
GroupNameAssociatedTeamsAnyTeam String Falso Nombre del grupo de tareas Equipos asociados Cualquier equipo.
GroupNameAssociatedTeamsCount Integer Falso Nombre del grupo de tareas Recuento de equipos asociados.
GroupNameIsTeamUnassigned Boolean Falso El nombre del grupo de tareas es Equipo sin asignar.
RatePerHour String Falso Tasa de tareas por hora.
ReminderString String Falso Cadena de recordatorio de tareas.
Recurrence String Falso Recurrencia de tareas.
BudgetValue String Falso Valor del presupuesto de la tarea.
BudgetThreshold String Falso Umbral de presupuesto de tareas.
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
Owner String Propietario de la tarea.
Status String Estado de la tarea. Los valores permitidos son completed, notcompleted.
Time String Tiempo de tarea. Los valores permitidos son vencido, hoy, mañana.
LastModifiedTime Datetime Hora de la última modificación de la tarea.
ViewId String ID de vista de tareas.

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
Nombre Tipo Solo lectura Descripción
TaskId String Falso identificación de la tarea
Id [KEY] String Falso Identificación de la subtarea.
Name String Falso Nombre de la subtarea.
Key String Falso Clave de subtarea.
BillingType String Falso Tipo de facturación de la subtarea.
Completed Boolean Falso Subtarea completada.
CreatedBy String Falso Subtarea creada por.
CreatedByEmail String Falso Subtarea creada por Correo.
CreatedByZpuid String Falso Subtarea creada por Zpuid.
CreatedPerson String Falso Subtarea persona creada.
CreatedTime Date Falso Hora de creación de la subtarea.
CreatedDateTime Datetime Falso Fecha de creación de la subtarea Hora.
Depth Integer Falso Profundidad de la subtarea.
Description String Falso Descripción de la subtarea.
DetailsOwners String Falso Propietarios de los detalles de la subtarea.
Duration String Falso Duración de la subtarea.
DurationType String Falso Tipo de duración de la subtarea. Los valores permitidos son días, horas.
IsCommentAdded Boolean Falso La subtarea es un comentario agregado.
IsDocsAssociated Boolean Falso La subtarea está asociada a documentos.
IsForumAssociated Boolean Falso La subtarea está asociada al foro.
IsRecurrenceSet Boolean Falso La subtarea es el conjunto de recurrencia.
IsReminderSet Boolean Falso La subtarea es un conjunto de recordatorios.
IsParent Boolean Falso La subtarea es principal.
LastUpdatedTime Date Falso Hora de la última actualización de la subtarea.
LastUpdatedDateTime Datetime Falso Subtarea Fecha de última actualización Hora.
LinkSelfUrl String Falso URL propia del vínculo de la subtarea.
LinkTimesheetUrl String Falso Url del parte de horas del vínculo de la subtarea.
LinkWebUrl String Falso URL web de vínculo de subtarea.
LogBillableHours String Falso Horas facturables del registro de subtareas.
LogNonBillableHours String Falso Registro de subtareas Horas no facturables.
MilestoneId String Falso Id. de hito de subtarea.
OrderSequence Integer Falso Secuencia de orden de las subtareas.
ParentTaskId String Falso Id. de la tarea principal de la subtarea.
PercentComplete String Falso Porcentaje de subtarea completado.
Priority String Falso Prioridad de las subtareas. Los valores permitidos son ninguno, bajo, medio, alto.
RootTaskId String Falso ID de la tarea raíz de la subtarea.
StatusColorCode String Falso Código de color de estado de subtarea.
StatusId String Falso Id. de estado de la subtarea.
StatusName String Falso Nombre del estado de la subtarea.
StatusType String Falso Tipo de estado de la subtarea.
Subtasks Boolean Falso Subtarea Subtareas.
TaskFollowers String Falso Seguidores de tareas de subtareas.
TaskFollowerSize Integer Falso Tamaño del seguidor de tareas de la subtarea.
TasklistId String Falso ID de la lista de tareas de la subtarea.
TasklistName String Falso Nombre de la lista de tareas de la subtarea.
Work String Falso Trabajo de subtareas.
WorkForm String Falso Formulario de trabajo de subtarea.
WorkType String Falso Tipo de trabajo de la subtarea.
GroupNameAssociatedTeamsAnyTeam String Falso Nombre del grupo de subtareas Equipos asociados Cualquier equipo.
GroupNameAssociatedTeamsCount Integer Falso Nombre del grupo de subtareas Número de equipos asociados.
GroupNameIsTeamUnassigned Boolean Falso El nombre del grupo de subtareas es Equipo sin asignar.
StartDate Date Falso Fecha de inicio de la subtarea.
EndDate Date Falso Fecha de finalización de la subtarea.
PersonResponsible String Falso Responsable de la subtarea.

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
Nombre Tipo Solo lectura Descripción
TaskId [KEY] String Falso identificación de la tarea
Id [KEY] String Falso ID de registro de tiempo de tarea.
AddedByName String Falso Registro de tiempo de tareas agregado por nombre.
AddedByZpuid String Falso Registro de tiempo de tareas agregado por Zpuid.
AddedByZuid Long Falso Registro de tiempo de tareas agregado por Zuid.
ApprovalStatus String Falso Estado de aprobación del registro de tiempo de la tarea.
ApproverName String Falso Nombre del aprobador del registro de tiempo de la tarea.
BillStatus String Falso Estado de la factura del registro de tiempo de la tarea. Los valores permitidos son Facturable, No facturable.
CreatedDate Date Falso Fecha de creación del registro de tiempo de la tarea.
CreatedDateTime Datetime Falso Registro de tiempo de la tarea Fecha de creación Hora.
StartTime Datetime Falso Hora de inicio del registro de la hora de la tarea.
EndTime Datetime Falso Hora de finalización del registro de tiempo de la tarea.
Notes String Falso Notas de registro de tiempo de tareas.
HoursDisplay String Falso Pantalla de horas de registro de tiempo de tareas.
Hours Integer Falso Horas de registro de tiempo de tareas.
Minutes Integer Falso Minutos de registro de tiempo de tarea.
IsParent Boolean Falso El registro de tiempo de la tarea es principal.
IsSubTask Boolean Falso El registro de tiempo de la tarea es una subtarea.
LastModifiedDate Date Falso Fecha de última modificación del registro de tiempo de la tarea.
LastModifiedDateTime Datetime Falso Tarea Hora Registro Última modificación Fecha Hora.
LinkSelfUrl String Falso Url propia de enlace de registro de tiempo de tarea.
LogDate Date Falso Fecha de registro de tiempo de la tarea.
LogDateTime Datetime Falso Tarea Hora Registro Fecha Hora.
OwnerId String Falso ID del propietario del registro de tiempo de la tarea.
OwnerName String Falso Nombre del propietario del registro de tiempo de la tarea.
SubTaskLevel String Falso Nivel de subtarea de registro de tiempo de tarea.
TaskName String Falso Nombre de tarea de registro de tiempo de tarea.
TaskListId Long Falso ID de la lista de tareas del registro de tiempo de la tarea.
TaskListName String Falso Nombre de la lista de tareas del registro de tiempo de la tarea.
TotalMinutes Integer Falso Minutos totales del registro de tiempo de la tarea.

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
Nombre Tipo Solo lectura Descripción
GroupId [KEY] String Falso ID de grupo del equipo.
GroupName String Falso Grupo Nombre del equipo.
CreatedBy String Falso Equipo creado por.
CreatedTime String Falso Tiempo de creación del equipo.
Description String Falso Descripción del equipo.
EmailAlias String Falso ID de Correo del equipo.
EmailVerified Boolean Falso Correo verificado del equipo.
OrgId String Falso ID de organización del equipo.
OwnerEmail String Falso Propietario Correo del equipo.
OwnerName String Falso Propietario Nombre del equipo.
OwnerZpuid String Falso Propietario Zpuid del equipo.
OwnerZuid String Falso Dueño Zuid del equipo.
Prefix String Falso Prefijo del equipo.
UpdatedBy String Falso Actualizado por del equipo.
UpdatedTime String Falso Tiempo actualizado del equipo.
HasGroupEdit Boolean Falso Tiene edición de grupo del equipo.
ProjectCount Integer Falso Proyecto Conteo del equipo.
UserCount Integer Falso Número de usuarios del equipo.
UserIdArr String Falso Matriz de múltiples Zpuid.
UserObj String Falso Objeto de usuario del equipo.
ProjIds String Falso Matriz de múltiples ID de proyecto.
TeamLead String Falso ZPuid del líder del equipo.

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
Nombre Tipo Solo lectura Descripción
ProjectId String Falso Projecto ID.
GroupId String Falso Identificación del equipo.
Id [KEY] String Falso Identificación de usuario.
Name String Falso Nombre de usuario.
AddedBy String Falso Usuario agregado por.
AddedTime String Falso Tiempo añadido por el usuario.
Confirmed String Falso Usuario confirmado.
CreatedBy String Falso Usuario creado por.
CreatedTime String Falso Hora de creación del usuario.
CreatedUser String Falso Usuario creado por el usuario.
Description String Falso Descripción de usuario.
DisplayName String Falso Nombre para mostrar del usuario.
Email String Falso Correo del usuario.
EntityType String Falso Tipo de entidad de usuario.
FirstName String Falso Nombre de usuario.
IsClient Boolean Falso El usuario es cliente.
IsDefault Boolean Falso El usuario es predeterminado.
LastAccessedTime String Falso Hora de último acceso del usuario.
LastName String Falso Apellido del usuario.
LastUpdatedTime String Falso Hora de última actualización del usuario.
RoleId String Falso Identificación del rol de usuario.
RoleName String Falso Nombre de la función de usuario.
Type String Falso Tipo de usuario.
UpdatedBy String Falso Usuario actualizado por.
UpdatedDate String Falso Fecha de actualización del usuario.
UpdatedDateTime String Falso Fecha y hora de actualización del usuario.
UserStatus String Falso Usuario Estado de usuario.
Zpuid String Falso Usuario Zpuid.
Zuid String Falso Usuario Zuid.

Usuarios

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

Columnas
Nombre Tipo Solo lectura Descripción
Id [KEY] String Falso Identificación de usuario.
Name String Falso Nombre de usuario.
Active Boolean Falso Usuario Activo.
ChatAccess Boolean Falso Acceso al chat de usuario.
Email String Falso Correo del usuario.
PortalProfileName String Falso Nombre del perfil del portal de usuario.
PortalRoleId String Falso Id. de rol del portal de usuario.
PortalRoleName String Falso Nombre de la función del portal de usuario.
ProfileId String Falso Identificación del perfil de usuario.
ProfileType String Falso Tipo de perfil de usuario.
ProjectProfileId String Falso ID de perfil de proyecto de usuario.
Role String Falso Rol del usuario. Los valores permitidos son gerente, empleado, contratista.
RoleId String Falso Identificación del rol de usuario.
RoleName String Falso Nombre de la función de usuario.
Zpuid String Falso Usuario Zpuid.
WorkProjects String Falso Proyectos de trabajo del usuario.
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
UserType String Tipo de usuario. Los valores permitidos son activo, inactivo.

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

Nombre Descripción
Activities Enumere todas las actividades recientes del proyecto.
BugActivities Obtiene todas las actividades para el error dado.
BugAttachments Obtenga detalles de los archivos adjuntos para un error.
BugCustomFields Obtiene todos los campos personalizados en el proyecto dado.
BugResolution Obtenga la resolución del error.
Clients Devuelve la lista de empresas cliente asociadas con un ID de proyecto específico.
Documents Enumere todas las actividades recientes del proyecto.
MyBugs Enumera todos los errores creados por usted o asignados a usted.
MyMilestones Obtenga todos los hitos asignados a un usuario en particular en el proyecto dado.
MyTasks Obtiene todas sus tareas en el portal.
MyTimelogs Obtiene los registros de tiempo bajo un error específico.
ProjectCustomFields Obtiene todos los campos personalizados del proyecto.
ProjectCustomStatus Obtiene una lista de todos los estados personalizados del proyecto.
ProjectLayouts Obtiene una lista de diseños de proyectos.
Timelogs Obtiene los registros de tiempo bajo un error específico.
TaskAttachments Recuperar detalles de archivos adjuntos asociados a la tarea.
TaskLayouts Vea la lista de todos los diseños de tareas disponibles en su portal.
TaskStatusHistory Obtiene el historial de estado de las tareas del Portal.
Timelogs Obtiene los registros de tiempo bajo un error específico.
TimesheetCustomFields Obtenga todos los campos personalizados de la hoja de tiempo en todo el proyecto.
PortalUsersRemaining Obtiene los detalles de todos los usuarios en un portal específico.

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
Nombre Tipo Descripción
Id [KEY] String Identificación de la actividad del proyecto.
Name String Nombre de la actividad del proyecto.
Activity By String Autor de la actividad del proyecto.
Activity For String Actividad de proyecto para la entidad.
Display Time String Tiempo de visualización de la actividad del proyecto.
State String Estado de actividad del proyecto.
Time String Tiempo de actividad del proyecto.

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
Nombre Tipo Descripción
BugId String Identificación de error.
Action String Acción de actividad de error.
Type String Tipo de actividad de error.
PreviousValue String Valor anterior de actividad de error.
CurrentValue String Valor actual de la actividad de errores.
ActionBy String Error Actividad Acción Por.
ActionField String Campo de acción de actividad de error.
ActionDate Date Error Actividad Acción Fecha.
ActionDateTime Datetime Error Actividad Acción Fecha Hora.
Zuid [KEY] String Actividad de error ZUID.

Archivos Adjuntos

Obtenga detalles de los archivos adjuntos para un error.

Columnas
Nombre Tipo Descripción
BugId String Identificación de error.
AttachmentId Long Identificación del archivo adjunto.
FileName String Nombre del archivo adjunto.
FileType String Tipo de archivo adjunto.
FileSize Integer Tamaño del archivo adjunto.
FileEncAttachParam String Archivo Adjunto Enc Adjuntar Param.
FileUri String Archivo adjunto Uri.
AttachedDate Date Fecha adjunta.
AttachedDateTime Datetime Adjunto Fecha Hora.
AuthorId String ID del autor del archivo adjunto.
AuthorName String Nombre del autor del archivo adjunto.
IsDocsAttachment Boolean Es un archivo adjunto de documentos.

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
Nombre Tipo Descripción
LabelName String Nombre de etiqueta de campo personalizado de error.
ColumnName String Error en el nombre de la columna del campo personalizado.
DefaultValue String Error en el valor predeterminado del campo personalizado.
FieldType String Tipo de campo de campo personalizado de error.
IsEnc Boolean Error El campo personalizado es Enc.
IsMandatory Boolean El campo personalizado Error es obligatorio.
IsPi Boolean El campo personalizado del error es Pi.
IsVisible Boolean El campo personalizado de error es visible.
NewColumnName String Nombre de columna nuevo de campo personalizado de error.
PicklistValues String Error en los valores de lista de selección de campos personalizados.

Resolución de Errores

Obtenga la resolución del error.

Columnas
Nombre Tipo Descripción
BugId String Identificación de error.
Resolver String Solucionador de errores.
ResolverId String Identificación del solucionador de errores.
Resolution String Resolución de errores.
ResolutionThirdPartyAttachments String Resolución de errores de archivos adjuntos de terceros.
ResolvedDate Date Fecha de resolución del error.
ResolvedDateTime Datetime Error resuelto Fecha Hora.
ResolverZpuid String Resolución de errores ZPUID.

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
Nombre Tipo Descripción
Id [KEY] String Identificación del cliente.
Name String Nombre del cliente.
City String Ciudad del Cliente.
Country String País del cliente.
CrmAccountId String ID de la cuenta CRM del cliente.
FirstAddress String Primera dirección del cliente.
SecondAddress String Segunda dirección del cliente.
State String Estado del cliente.
WebAddress String Dirección web del cliente.
ZipCode String Código postal del cliente.
UserId String ID de usuario del cliente.
UserName String Nombre de usuario del cliente.
UserEmail String Correo del usuario del cliente.
UserZpuid String Cliente Usuario ZPUID.

Documentos

Enumere todas las actividades recientes del proyecto.

Columnas
Nombre Tipo Descripción
Id [KEY] String Identificación de la actividad del proyecto.
Name String Nombre de la actividad del proyecto.
Activity By String Autor de la actividad del proyecto.
Activity For String Actividad del proyecto para.
Display Time String Tiempo de visualización de la actividad del proyecto.
State String Estado de actividad del proyecto.
Time String Tiempo de actividad del proyecto.

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
Nombre Tipo Descripción
Id [KEY] String Identificación de error.
Key String Clave de errores.
Title String Título del error.
AssigneeId String ID del responsable del error.
AssigneeName String Nombre del responsable del error.
AssigneeZpuid String Error asignado ZPUID.
AttachmentCount String Recuento de errores adjuntos.
BugPrefix String Prefijo de error.
ClassificationId Long Identificación de clasificación de error.
ClassificationType String Tipo de clasificación de error.
Closed Boolean Error cerrado.
CommentCount String Recuento de comentarios de errores.
CreatedDate Date Fecha de creación del error.
CreatedDateTime Datetime Fecha de creación del error Hora.
Description String Descripción del error.
DueDate Date Fecha de vencimiento del error.
DueDateTime Date Fecha de vencimiento del error Hora.
Flag String Bandera de error.
LinkSelfUrl String URL propia de enlace de error.
LinkTimesheetUrl String Url del parte de horas del vínculo del error.
ModuleId Long ID del módulo de errores.
ModuleName String Nombre del módulo de errores.
ProjectId Long ID de proyecto de error.
ProjectIdString String Cadena de ID de proyecto de error.
ProjectName String Nombre del proyecto de error.
ReportedPerson String Persona reportada por error.
ReporterId String Identificación del informador de errores.
ReproducibleId Long Identificación del error reproducible.
ReproducibleType String Tipo de error reproducible.
SeverityId Long Identificación de la gravedad del error.
SeverityType String Tipo de gravedad del error.
StatusId Long Identificación del estado del error.
StatusType String Tipo de estado de error. Los valores permitidos son abierto, cerrado.
UpdatedDate Date Fecha de actualización del error.
UpdatedDateTime Datetime Fecha de actualización del error Hora.
UpdatedTimeLong Long Tiempo de actualización de error largo.
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
Owner String Dueño del error.
ViewType String Tipo de vista de error. Los valores permitidos son informados, propios.
LastModifiedTime Datetime Hora de la última modificación del error.

Mis Hitos

Obtenga todos los hitos asignados a un usuario en particular en el proyecto dado.

Seleccionar

Esta es una vista a nivel de portal.

  • ProjectId y Flag admite el siguiente operador: =.
  • ProjectId admite el operador: IN
  • CreatedDate y LastModifiedTime soporte: ORDEN

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

SELECT * FROM MyMilestones WHERE ProjectId IN ('12345000000030899', '12345000000033005') AND Flag = 'internal' ORDER BY CreatedDate
Columnas
Nombre Tipo Descripción
ProjectId String Projecto ID.
Id [KEY] String Identificación de hito.
Name String Nombre del hito.
Closed Boolean Hito cerrado.
CreatedDate Date Fecha de creación del hito.
CreatedDateTime Datetime Fecha y hora de creación del hito.
EndDate Date Fecha de finalización del hito.
EndDateTime Datetime Hora de la fecha de finalización del hito.
Flag String Bandera de hito. Los valores permitidos son interno, externo.
IsWorkfieldRemoved Boolean El hito es el campo de trabajo eliminado.
LastUpdatedDate Date Fecha de última actualización del hito.
LastUpdatedDateTime Datetime Hito Fecha de última actualización Hora.
SelfUrl String Url propia de hito.
StatusUrl String Url de estado de hito.
OwnerId String Identificación del propietario del hito.
OwnerName String Nombre del propietario del hito.
OwnerZpuid String Milestone Propietario ZPUID.
ProjectName String Nombre del proyecto hito.
Sequence Integer Secuencia de hitos.
StartDate Date Fecha de inicio del hito.
StartDateTime Datetime Hora de la fecha de inicio del hito.
Status String Estado del hito.
StatusColorCode String Código de color de estado de hito.
StatusId String Id. de estado de hito.
StatusName String Nombre del estado del hito.
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
LastModifiedTime Datetime Hora de la última modificación del hito.

Mis Tareas

Obtiene todas sus tareas en el portal.

Seleccionar

Esta es una vista a nivel de portal. Columnas que admiten el operador =:

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


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

SELECT * FROM MyTasks WHERE MilestoneId = '12345600000123' AND Priority = 'High' 
Columnas
Nombre Tipo Descripción
ProjectId String Projecto ID.
Id [KEY] String identificación de la tarea
Name String Nombre de la tarea.
Key String Clave de tareas.
BillingType String Tipo de facturación de la tarea.
Completed Boolean Tarea terminada.
CreatedBy String Tarea creada por.
CreatedByEmail String Tarea creada por Correo.
CreatedByZpuid String Tarea creada por Zpuid.
CreatedPerson String Persona creada por la tarea.
CreatedDate Date Fecha de creación de la tarea.
CreatedDateTime Datetime Fecha de creación de la tarea Hora.
Description String Descripción de la tarea.
Owners String Propietarios de tareas.
Duration String Duración de la tarea.
DurationType String Tipo de duración de la tarea.
EndDate Date Fecha de finalización de la tarea.
EndDateTime Datetime Hora de la fecha de finalización de la tarea.
CommentAdded Boolean Comentario de tarea añadido.
DocsAssociated Boolean Documentos de tareas asociados.
ForumAssociated Boolean Tarea Foro Asociado.
RecurrenceSet Boolean Conjunto de recurrencia de tareas.
ReminderSet Boolean Conjunto de recordatorio de tareas.
Parent Boolean Padre de la tarea.
LastUpdatedDate Date Fecha de última actualización de la tarea.
LastUpdatedDateTime Datetime Tarea Fecha de última actualización Hora.
LinkSelfUrl String Url propia del enlace de la tarea.
LinkTimesheetUrl String Url del parte de horas del enlace de la tarea.
LinkWebUrl String Url web del enlace de la tarea.
LogHoursBillableHours String Horas de registro de tareas Horas facturables.
LogHoursNonBillableHours String Registro de tareas Horas Horas no facturables.
MilestoneId String ID de hito de tarea.
OrderSequence Integer Secuencia de orden de tareas.
PercentComplete String Porcentaje de tarea completado.
Priority String Prioridad de tareas. Los valores permitidos son ninguno, bajo, medio, alto.
StartDate Date Fecha de inicio de la tarea.
StartDateTime Datetime Hora de la fecha de inicio de la tarea.
StatusColorCode String Código de color del estado de la tarea.
StatusId String Identificación del estado de la tarea.
StatusName String Nombre del estado de la tarea.
StatusType String Tipo de estado de la tarea.
Subtasks Boolean Subtareas de tareas.
TaskFollowers String Tarea Seguidores de tareas.
TaskFollowerSize Integer Tarea Tamaño del seguidor de tareas.
TasklistId String ID de la lista de tareas.
TasklistIdString String Tarea Cadena de ID de lista de tareas.
TasklistName String Tarea Nombre de la lista de tareas.
Work String Tarea Trabajo.
WorkForm String Formulario de trabajo de tareas.
WorkType String Tipo de trabajo de la tarea.
GroupNameAssociatedTeamsAnyTeam String Nombre del grupo de tareas Equipos asociados Cualquier equipo.
GroupNameAssociatedTeamsCount Integer Nombre del grupo de tareas Recuento de equipos asociados.
GroupNameIsTeamUnassigned Boolean El nombre del grupo de tareas es Equipo sin asignar.
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
Owner String Propietario de la tarea.
Status String Estado de la tarea. Los valores permitidos son completed, notcompleted.
Time String Tiempo de tarea. Los valores permitidos son vencido, hoy, mañana.
LastModifiedTime Datetime Hora de la última modificación de la tarea.
CustomViewId String ID de vista personalizada de tarea.

Mis Registros de Tiempo

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

Seleccionar

Esta es una vista a nivel de portal. Columnas que admiten el operador =:

  • Estado de la factura
  • Fecha
  • Usuario
  • Tipo de vista
  • Tipo de componente


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

SELECT * FROM MyTimelogs WHERE User = '123450000123'
Columnas
Nombre Tipo Descripción
Id [KEY] String ID de registro de tiempo.
AddedByName String Registro de tiempo agregado por nombre.
AddedByZpuid String Registro de tiempo agregado por Zpuid.
AddedByZuid Long Registro de tiempo agregado por Zuid.
ApprovalStatus String Estado de aprobación del registro de tiempo.
ApproverName String Nombre del aprobador del registro de tiempo.
BillStatus String Estado de facturación de registro de tiempo. Los valores permitidos son todos, facturables, no facturables.
CreatedDate Date Fecha de creación del registro de tiempo.
CreatedDateTime Datetime Hora Registro Creado Fecha Hora.
StartTime Datetime Hora Hora de inicio del registro.
EndTime Datetime Hora de finalización del registro de tiempo.
Notes String Notas de registro de tiempo.
HoursDisplay String Visualización de horas de registro de tiempo.
Hours Integer Horas de registro de tiempo.
Minutes Integer Minutos de registro de tiempo.
IsParent Boolean El registro de tiempo es principal.
IsSubTask Boolean El registro de tiempo es una subtarea.
LastModifiedDate Date Fecha de última modificación del registro de tiempo.
LastModifiedDateTime Datetime Hora Registro Fecha de última modificación Hora.
LinkSelfUrl String Enlace de registro de tiempo Url propia.
LogDate Date Hora Fecha de registro.
LogDateTime Datetime Hora Fecha de registro Hora.
OwnerId String ID del propietario del registro de tiempo.
OwnerName String Nombre del propietario del registro de tiempo.
SubTaskLevel String Nivel de subtarea de registro de tiempo.
TaskName String Nombre de la tarea de registro de tiempo.
TaskListId Long Id. de lista de tareas de registro de tiempo.
TaskListName String Nombre de la lista de tareas del registro de tiempo.
TotalMinutes Integer Registro de tiempo Minutos totales.
ProjectId String ID del proyecto de registro de tiempo.
ProjectName String Nombre del proyecto de registro de tiempo.
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
Date Date Hora Fecha de registro.
User String Usuario de registro de tiempo.
ViewType String Tipo de vista de registro de tiempo. Los valores permitidos son día, semana, mes.
ComponentType String Tipo de componente de registro de tiempo. Los valores permitidos son error, tarea, general.

ProyectoCamposPersonalizados

Obtiene todos los campos personalizados del proyecto.

Seleccionar

Puede utilizar la siguiente consultar para obtener todos los campos personalizados del proyecto:

SELECT * FROM ProjectCustomFields
Columnas
Nombre Tipo Descripción
Id [KEY] String Id. de campo personalizado.
Name String Nombre de campo personalizado.
FieldType String Tipo de campo personalizado.
FieldId String Identificación de campo.
PII Boolean PII de campo personalizado.
Encrypted Boolean Encriptado.
DefaultValue String Valor predeterminado del campo personalizado.
PickList String Opciones de lista de selección de campos personalizados.

Estado Personalizado del Proyecto

Obtiene una lista de todos los estados personalizados del proyecto.

Seleccionar

Puede utilizar la siguiente consultar para obtener todos los estados personalizados del proyecto:

SELECT * FROM ProjectCustomStatus
Columnas
Nombre Tipo Descripción
Id [KEY] String Identificación del portal.
Name String Nombre del portal.
Closed Boolean Portal Cerrado.
Default Boolean Predeterminado del portal.
HasDefaultValue Boolean El portal tiene un valor predeterminado.
Sequence Int Secuencia de portales.
StatusColor String Color de estado del portal.
StatusColorHexcode String Código hexadecimal de color de estado del portal.

ProyectoLayouts

Obtiene una lista de diseños de proyectos.

Seleccionar

Puede utilizar la siguiente consultar para obtener todos los diseños de proyecto:

SELECT * FROM ProjectLayouts
Columnas
Nombre Tipo Descripción
Id [KEY] String Identificación del diseño del proyecto.
Name String Nombre del diseño del proyecto.
Default Boolean Es el diseño de proyecto predeterminado.

Registros de Tiempo

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

Seleccionar

Esta es una vista a nivel de proyecto. Columnas que admiten el operador =:

  • Estado de la factura
  • Fecha
  • Usuario
  • Tipo de vista
  • Tipo de componente


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

SELECT * FROM ProjectLayouts
Columnas
Nombre Tipo Descripción
Id [KEY] String ID de registro de tiempo.
AddedByName String Registro de tiempo agregado por nombre.
AddedByZpuid String Registro de tiempo agregado por ZPUID.
AddedByZuid Long Registro de tiempo agregado por ZUID.
ApprovalStatus String Estado de aprobación del registro de tiempo.
ApproverName String Nombre del aprobador del registro de tiempo.
BillStatus String Estado de facturación de registro de tiempo. Los valores permitidos son todos, facturables, no facturables.
CreatedDate Date Fecha de creación del registro de tiempo.
CreatedDateTime Datetime Hora Registro Creado Fecha Hora.
StartTime Datetime Hora Hora de inicio del registro.
EndTime Datetime Hora de finalización del registro de tiempo.
Notes String Notas de registro de tiempo.
HoursDisplay String Visualización de horas de registro de tiempo.
Hours Integer Horas de registro de tiempo.
Minutes Integer Minutos de registro de tiempo.
IsParent Boolean El registro de tiempo es principal.
IsSubTask Boolean El registro de tiempo es una subtarea.
LastModifiedDate Date Fecha de última modificación del registro de tiempo.
LastModifiedDateTime Datetime Hora Registro Fecha de última modificación Hora.
LinkSelfUrl String Enlace de registro de tiempo Url propia.
LogDate Date Hora Fecha de registro.
LogDateTime Datetime Hora Fecha de registro Hora.
OwnerId String ID del propietario del registro de tiempo.
OwnerName String Nombre del propietario del registro de tiempo.
SubTaskLevel String Nivel de subtarea de registro de tiempo.
TaskName String Nombre de la tarea de registro de tiempo.
TaskListId Long Id. de lista de tareas de registro de tiempo.
TaskListName String Nombre de la lista de tareas del registro de tiempo.
TotalMinutes Integer Registro de tiempo Minutos totales.
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
Date Date Hora Fecha de registro.
User String Usuario de registro de tiempo.
ViewType String Tipo de vista de registro de tiempo. Los valores permitidos son día, semana, mes.
ComponentType String Tipo de componente de registro de tiempo. Los valores permitidos son error, tarea, general.

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

Seleccionar

Esta es una vista a nivel de proyecto. Columnas que admiten el operador =:

  • Estado de la factura
  • Fecha
  • Usuario
  • Tipo de vista
  • Tipo de componente


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

SELECT * FROM ProjectLayouts
Columnas
Nombre Tipo Descripción
Id [KEY] String ID de registro de tiempo.
AddedByName String Registro de tiempo agregado por nombre.
AddedByZpuid String Registro de tiempo agregado por Zpuid.
AddedByZuid Long Registro de tiempo agregado por Zuid.
ApprovalStatus String Estado de aprobación del registro de tiempo.
ApproverName String Nombre del aprobador del registro de tiempo.
BillStatus String Estado de facturación de registro de tiempo. Los valores permitidos son todos, facturables, no facturables.
CreatedDate Date Fecha de creación del registro de tiempo.
CreatedDateTime Datetime Hora Registro Creado Fecha Hora.
StartTime Datetime Hora Hora de inicio del registro.
EndTime Datetime Hora de finalización del registro de tiempo.
Notes String Notas de registro de tiempo.
HoursDisplay String Visualización de horas de registro de tiempo.
Hours Integer Horas de registro de tiempo.
Minutes Integer Minutos de registro de tiempo.
IsParent Boolean El registro de tiempo es principal.
IsSubTask Boolean El registro de tiempo es una subtarea.
LastModifiedDate Date Fecha de última modificación del registro de tiempo.
LastModifiedDateTime Datetime Hora Registro Fecha de última modificación Hora.
LinkSelfUrl String Enlace de registro de tiempo Url propia.
LogDate Date Hora Fecha de registro.
LogDateTime Datetime Hora Fecha de registro Hora.
OwnerId String ID del propietario del registro de tiempo.
OwnerName String Nombre del propietario del registro de tiempo.
SubTaskLevel String Nivel de subtarea de registro de tiempo.
TaskName String Nombre de la tarea de registro de tiempo.
TaskListId Long Id. de lista de tareas de registro de tiempo.
TaskListName String Nombre de la lista de tareas del registro de tiempo.
TotalMinutes Integer Registro de tiempo Minutos totales.
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
Date Date Hora Fecha de registro.
User String Usuario de registro de tiempo.
ViewType String Tipo de vista de registro de tiempo. Los valores permitidos son día, semana, mes.
ComponentType String Tipo de componente de registro de tiempo. Los valores permitidos son error, tarea, general.

Archivos Adjuntos de Tareas

Recuperar detalles de archivos adjuntos asociados a la tarea.

Seleccionar

Esta es una vista a nivel de proyecto.

  • TaskId es necesario para recuperar TaskAttachments.

Puede utilizar la siguiente consultar para obtener todos los archivos adjuntos de tareas:

SELECT * FROM TaskAttachments WHERE TaskId = '123456000000112'
Columnas
Nombre Tipo Descripción
TaskId String identificación de la tarea
Id [KEY] String ID del archivo adjunto de la tarea.
AuthorId String ID del autor del archivo adjunto de la tarea.
ContentType String Tipo de contenido del adjunto de la tarea.
DocsDownloadUrl String Url de descarga de documentos adjuntos de tareas.
DownloadUrl String Descarga de archivos adjuntos de tareas.
Extension String Extensión de datos adjuntos de tareas.
Filename String Nombre de archivo adjunto de la tarea.
Owner String Propietario del archivo adjunto de la tarea.
Size Integer Tarea Tamaño del archivo adjunto en bytes..
TaskId Long Adjunto de tarea ID de tarea.
ThumbnailUrl String Url en miniatura del archivo adjunto de la tarea.
UploadedTime Long Hora de carga del archivo adjunto de la tarea.

Diseños de Tareas

Vea la lista de todos los diseños de tareas disponibles en su portal.

Seleccionar

Esta es una vista a nivel de portal. Puede utilizar la siguiente consultar para obtener todos los diseños de tareas:

SELECT * FROM TaskLayouts
Columnas
Nombre Tipo Descripción
Id [KEY] String ID de diseño de tarea.
Name String Nombre del diseño de la tarea.
Default Boolean Predeterminado del diseño de la tarea.

TaskStatusHistory

Obtiene el historial de estado de las tareas del Portal.

Seleccionar

Esta es una vista a nivel de portal.

  • LastModifiedTime admite: ORDEN

Puede utilizar la siguiente consultar para obtener todos los diseños de tareas:

SELECT * FROM TaskStatusHistory ORDER BY LastModifiedTime
Columnas
Nombre Tipo Descripción
Id [KEY] String Identificación del historial de estado de la tarea.
Name String Nombre del historial del estado de la tarea.
StatusId String Id. de estado del historial de estado de la tarea.
StatusName String Nombre del estado del historial del estado de la tarea.
PreviousStatusId String Historial de estado de la tarea Id. de estado anterior.
PreviousStatusName String Historial de estado de tarea Nombre de estado anterior.
UpdatedStatusId String Id. de estado actualizado del historial de estado de la tarea.
UpdatedStatusName String Historial de estado de la tarea Nombre de estado actualizado.
TransitionTimeMillis String Tarea Estado Historial Tiempo de transición Mili.
TransitionTimeDuration String Duración del tiempo de transición del historial del estado de la tarea.
UpdatedBy String Historial de estado de tareas actualizado por.
UpdatedByName String Historial de estado de tareas actualizado por nombre.
UpdatedByEmail String Historial de estado de tareas actualizado por Correo.
UpdatedOn Datetime Historial de estado de tareas actualizado el.
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
LastModifiedTime Datetime Historial de estado de tareas Hora de última modificación.

TimesheetCustomFields

Obtenga todos los campos personalizados de la hoja de tiempo en todo el proyecto.

Seleccionar

Esta es una vista a nivel de portal. Puede usar la siguiente consultar para obtener todos los campos personalizados de la hoja de tiempo:

SELECT * FROM TimesheetCustomFields
Columnas
Nombre Tipo Descripción
Id [KEY] String Id. de campo personalizado de la hoja de horas.
FieldName String Nombre del campo personalizado de la hoja de horas.
DataType String Tipo de datos de campo personalizado de la hoja de horas.
UniqueColumn String Columna única del campo personalizado de la hoja de horas.

PortalUsersRemaining

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

Seleccionar

Esta es una vista a nivel de proyecto. Puede utilizar la siguiente consultar para obtener el número restante de usuarios para su portal:

SELECT * FROM PortalUsersRemaining
Columnas
Nombre Tipo Descripción
AvailableUsersCount String Número de usuarios disponibles.

Procedimientos Almacenados

Procedimientos almacenados* son interfaces similares a funciones que amplían la funcionalidad del conector más allá de las simples operaciones SELECCIONAR/INSERTAR/ACTUALIZAR/ELIMINAR con Zoho Projects.

Procedimientos almacenados* aceptar una lista de parámetros, realizar la función prevista y luego devolver, si corresponde, cualquier dato de respuesta relevante de Zoho Projects, junto con una indicación de si el procedimiento tuvo éxito o falló.

Conector Jitterbit para Procedimientos Almacenados de Zoho Projects

Nombre Descripción
AddUserToClientCompany Añade un usuario a una empresa cliente existente.
ApproveTimelog Aprobar el registro de tiempo general/error/tarea.
AssociateBugs Asociar errores relacionados a una tarea.
AssociateContacts Asocia una etiqueta con una entidad específica en un proyecto específico.
AssociateTags Asocia una etiqueta con una entidad específica en un proyecto específico.
DissociateBugs Asociar errores relacionados a una tarea.
DissociateContacts Disociar un contacto de cliente de un proyecto.
DissociateTags Disocia una etiqueta con una entidad específica en un proyecto específico.
ForumFollow Seguir una publicación del foro.
ForumSelectBestAnswer Dejar de seguir una publicación del foro.
ForumUnfollow Dejar de seguir una publicación del foro.
ForumUnselectBestAnswer Dejar de seguir una publicación del foro.
GetOAuthAccessToken Obtiene un token de autenticación de ZohoProjects.
GetOAuthAuthorizationURL Obtiene la URL de autorización que el usuario debe abrir por separado para otorgar acceso a su aplicación. Solo se necesita al desarrollar aplicaciones web. Solicitará el OAuthAccessToken desde esta URL.
RefreshOAuthAccessToken Actualiza el token de acceso de OAuth utilizado para la autenticación con ZohoProjects.
SelectTeamLead Actualice al líder del equipo.
TaskFollow Seguir una tarea en el proyecto dado.
TaskMove Mueve una tarea de una lista de tareas a otra lista de tareas. La lista de tareas de destino puede ser del mismo proyecto o de un proyecto diferente.
TaskReorder Reordena las tareas en el proyecto dado. La tarea se reordenará entre dos tareas en función de los ID de tarea anterior y siguiente.
TaskUnfollow Dejar de seguir una tarea en el proyecto dado.

AddUserToClientCompany

Añade un usuario a una empresa cliente existente.

Información Específica del Procedimiento

Una consultar de ejemplo para ejecutar este procedimiento almacenado* se muestra a continuación:

EXEC AddUserToClientCompany PortalId = '12345317133', CompanyId = '123456000000039025', ContactEmail = 'test@example.com'
Aporte
Nombre Tipo Obligatorio Descripción
PortalId String Cierto Especifique el ID del portal.
CompanyId String Cierto Especifique el ID de la empresa cliente.
ContactEmail String Cierto ID de Correo del usuario del cliente.
WorkProjects String Falso Los ID de varios proyectos se separan mediante comas.
ProfileId String Falso Especifique ID de perfil. profile_id se obtiene de la API Get Portal Users.
Columnas del Conjunto de Resultados
Nombre Tipo Descripción
Success String Especifica si la ejecución fue exitosa.

AppproveTimelog

Aprobar el registro de tiempo general/error/tarea.

Información Específica del Procedimiento

Una consultar de ejemplo para ejecutar este procedimiento almacenado* se muestra a continuación:

EXEC ApproveTimelog PortalId = '12345317133', ProjectId = '123456000000031899', LogId = '123456000000031977', Approval = 'approve', Reason = 'Submitted timelog is approved', EntityType = 'general', EntityId = '1234560001'
Aporte
Nombre Tipo Obligatorio Descripción
PortalId String Cierto Especifique el ID del portal.
ProjectId String Cierto Especifique la identificación del grupo.
LogId String Cierto Especifique el ID de registro.
EntityType String Falso Especifique el tipo de entidad para aprobar el tiempo de registro. Los valores permitidos son tarea, error, general.
EntityId String Falso ID de la entidad especificada por el parámetro 'EntityType'
Approval String Cierto El registro de tiempo se aprueba si el valor dado es aprobado. Los valores permitidos son aprobar, pendiente, rechazar.
Reason String Falso Debe mencionarse el motivo si se rechaza el registro de tiempo. El motivo no debe exceder los 250 caracteres.
Columnas del Conjunto de Resultados
Nombre Tipo Descripción
Success String Especifica si la ejecución fue exitosa.

AssociateBugs

Asociar errores relacionados a una tarea.

Información Específica del Procedimiento

Una consultar de ejemplo para ejecutar este procedimiento almacenado* se muestra a continuación:

EXEC AssociateBugs PortalId = '12345317133', ProjectId = '123456000000031899', TaskId = '123456000000031977', BugId = '123456000000034087'
Aporte
Nombre Tipo Obligatorio Descripción
PortalId String Cierto Especifique el ID del portal.
ProjectId String Cierto Especifique la identificación del grupo.
TaskId String Cierto Especifique el ID de la tarea.
BugId String Cierto La identificación de múltiples errores debe estar separada por comas.
Columnas del Conjunto de Resultados
Nombre Tipo Descripción
Success String Especifica si la ejecución fue exitosa.

AsociadoContactos

Asocia una etiqueta con una entidad específica en un proyecto específico.

Información Específica del Procedimiento

Una consultar de ejemplo para ejecutar este procedimiento almacenado* se muestra a continuación:

EXEC AssociateContacts PortalId = '12345317133', ProjectId = '123456000000031899', ContactId = '1234560000000123456'
Aporte
Nombre Tipo Obligatorio Descripción
PortalId String Cierto Especifique el ID del portal.
ProjectId String Cierto Especifique la identificación del grupo.
ContactId String Cierto Matriz de ID de contacto del cliente. Los ID múltiples se pueden separar con comas.
Columnas del Conjunto de Resultados
Nombre Tipo Descripción
Success String Especifica si la ejecución fue exitosa.

AsociarEtiquetas

Asocia una etiqueta con una entidad específica en un proyecto específico.

Información Específica del Procedimiento

Una consultar de ejemplo para ejecutar este procedimiento almacenado* se muestra a continuación:

EXEC AssociateTags PortalId = '12345317133', ProjectId = '123456000000031899', TagId = '123456000000031977', EntityType = 'Task',  EntityId = '123456000000034087'
Aporte
Nombre Tipo Obligatorio Descripción
PortalId String Cierto Especifique el ID del portal.
ProjectId String Cierto Especifique la identificación del grupo.
TagId String Cierto Especifique la identificación de la etiqueta.
EntityType String Cierto Especifique el tipo de entidad para aprobar el tiempo de registro. Los valores permitidos son Proyecto, Hito, Lista de tareas, Tarea, Error, Foro, Estado.
EntityId String Cierto ID de la entidad especificada por el parámetro 'EntityType'
Columnas del Conjunto de Resultados
Nombre Tipo Descripción
Success String Especifica si la ejecución fue exitosa.

DissociateBugs

Asociar errores relacionados a una tarea.

Información Específica del Procedimiento

Una consultar de ejemplo para ejecutar este procedimiento almacenado* se muestra a continuación:

EXEC DissociateBugs PortalId = '12345317133', ProjectId = '123456000000031899', TaskId = '123456000000031977', BugId = '123456000000034087'
Aporte
Nombre Tipo Obligatorio Descripción
PortalId String Cierto Especifique el ID del portal.
ProjectId String Cierto Especifique la identificación del grupo.
TaskId String Cierto Especifique el ID de la tarea.
BugId String Cierto La identificación de múltiples errores debe estar separada por comas.
Columnas del Conjunto de Resultados
Nombre Tipo Descripción
Success String Especifica si la ejecución fue exitosa.

Disociar Contactos

Disociar un contacto de cliente de un proyecto.

Información Específica del Procedimiento

Una consultar de ejemplo para ejecutar este procedimiento almacenado* se muestra a continuación:

EXEC DissociateContacts PortalId = '12345317133', ProjectId = '123456000000031899', ContactId = '1234560000000123456'
Aporte
Nombre Tipo Obligatorio Descripción
PortalId String Cierto Especifique el ID del portal.
ProjectId String Cierto Especifique la identificación del grupo.
ContactId String Cierto Matriz de ID de contacto del cliente.
Columnas del Conjunto de Resultados
Nombre Tipo Descripción
Success String Especifica si la ejecución fue exitosa.

Disociar Etiquetas

Disocia una etiqueta con una entidad específica en un proyecto específico.

Información Específica del Procedimiento

Una consultar de ejemplo para ejecutar este procedimiento almacenado* se muestra a continuación:

EXEC DissociateTags PortalId = '12345317133', ProjectId = '123456000000031899', TagId = '123456000000031977', EntityType = 'Task',  EntityId = '123456000000034087'
Aporte
Nombre Tipo Obligatorio Descripción
PortalId String Cierto Especifique el ID del portal.
ProjectId String Cierto Especifique la identificación del grupo.
TagId String Cierto Especifique la identificación de la etiqueta.
EntityType String Cierto Especifique el tipo de entidad para aprobar el tiempo de registro. Los valores permitidos son Proyecto, Hito, Lista de tareas, Tarea, Error, Foro, Estado.
EntityId String Cierto ID de la entidad especificada por el parámetro 'EntityType'
Columnas del Conjunto de Resultados
Nombre Tipo Descripción
Success String Especifica si la ejecución fue exitosa.

ForoSeguir

Seguir una publicación del foro.

Información Específica del Procedimiento

Una consultar de ejemplo para ejecutar este procedimiento almacenado* se muestra a continuación:

EXEC ForumFollow PortalId = '12345317133', ProjectId = '123456000000031899', ForumId = '123456000000034053'
Aporte
Nombre Tipo Obligatorio Descripción
PortalId String Cierto Especifique el ID del portal.
ProjectId String Cierto Especifique la identificación del grupo.
ForumId String Cierto Especifique la identificación de la etiqueta.
Columnas del Conjunto de Resultados
Nombre Tipo Descripción
Success String Especifica si la ejecución fue exitosa.

ForoSeleccionarMejorRespuesta

Dejar de seguir una publicación del foro.

Información Específica del Procedimiento

Una consultar de ejemplo para ejecutar este procedimiento almacenado* se muestra a continuación:

EXEC ForumSelectBestAnswer PortalId = '12345317133', ProjectId = '123456000000031899', ForumId = '123456000000034053', CommentId = '123456000000039021'
Aporte
Nombre Tipo Obligatorio Descripción
PortalId String Cierto Especifique el ID del portal.
ProjectId String Cierto Especifique la identificación del grupo.
ForumId String Cierto Especifique el ID del foro.
CommentId String Cierto Especifique el ID del comentario.
Columnas del Conjunto de Resultados
Nombre Tipo Descripción
Success String Especifica si la ejecución fue exitosa.

ForoDejar de Seguir

Dejar de seguir una publicación del foro.

Información Específica del Procedimiento

Una consultar de ejemplo para ejecutar este procedimiento almacenado* se muestra a continuación:

EXEC ForumUnfollow PortalId = '12345317133', ProjectId = '123456000000031899', ForumId = '123456000000034053'
Aporte
Nombre Tipo Obligatorio Descripción
PortalId String Cierto Especifique el ID del portal.
ProjectId String Cierto Especifique la identificación del grupo.
ForumId String Cierto Especifique la identificación de la etiqueta.
Columnas del Conjunto de Resultados
Nombre Tipo Descripción
Success String Especifica si la ejecución fue exitosa.

ForoUnselectBestAnswer

Dejar de seguir una publicación del foro.

Información Específica del Procedimiento

Una consultar de ejemplo para ejecutar este procedimiento almacenado* se muestra a continuación:

EXEC ForumUnselectBestAnswer PortalId = '12345317133', ProjectId = '123456000000031899', ForumId = '123456000000034053', CommentId = '123456000000039021'
Aporte
Nombre Tipo Obligatorio Descripción
PortalId String Cierto Especifique el ID del portal.
ProjectId String Cierto Especifique la identificación del grupo.
ForumId String Cierto Especifique el ID del foro.
CommentId String Cierto Especifique el ID del comentario.
Columnas del Conjunto de Resultados
Nombre Tipo Descripción
Success String Especifica si la ejecución fue exitosa.

Obtener Token de Acceso de OAuth

Obtiene un token de autenticación de Zoho Projects.

Aporte
Nombre Tipo Obligatorio Descripción
AuthMode String Falso El tipo de modo de autenticación a utilizar. Seleccione Aplicación para obtener tokens de autenticación a través de una aplicación de escritorio. Seleccione Web para obtener tokens de autenticación a través de una aplicación web. Los valores permitidos son APP, WEB. El valor predeterminado es APLICACIÓN.
Scope String Falso Una lista separada por comas de permisos para solicitar al usuario. Consulte la API de ZohoProjects para obtener una lista de los permisos disponibles. El valor predeterminado es ZohoProjects.portals.ALL, ZohoProjects.projects.ALL, ZohoProjects.status.ALL, ZohoProjects.milestones.ALL, ZohoProjects.tasklists.ALL, ZohoProjects.tasks.ALL, ZohoProjects.tags.ALL, ZohoProjects.bugs .TODOS, ZohoProjects.events.TODOS, ZohoProjects.forums.ALL, ZohoProjects.users.ALL, ZohoProjects.clients.ALL, ZohoProjects.documents.ALL, ZohoProjects.search.READ, ZohoProjects.entity_properties.ALL, ZohoProjects.activities.READ, ZohoProjects.hojas de horas trabajadas.TODO.
CallbackUrl String Falso La URL a la que se redirigirá al usuario después de autorizar su aplicación. Este valor debe coincidir con la URL de redirección que especificó en la configuración de la aplicación ZohoProjects. Solo es necesario cuando el parámetro Authmode es Web.
Verifier String Falso El verificador devuelto por ZohoProjects después de que el usuario haya autorizado su aplicación para tener acceso a sus datos. Este valor se devolverá como un parámetro para la URL de devolución de llamada.
State String Falso 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 ZohoProjects y viceversa. Los usos incluyen redirigir al usuario al recurso correcto en su sitio, nonces y mitigaciones de falsificación de solicitudes entre sitios.
AccountsServer String Falso La URL completa del servidor de cuentas que se usará para recuperar el token de acceso de OAuth.
Columnas del Conjunto de Resultados
Nombre Tipo Descripción
OAuthAccessToken String El token de acceso utilizado para la comunicación con ZohoProjects.
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. Un -1 indica que no caducará.
AccountsServer String La URL completa del servidor de cuentas.
APIDomain String La URL completa del dominio API.

Obtener URL de Autorización de OAuth

Obtiene la URL de autorización que el usuario debe abrir por separado para otorgar acceso a su aplicación. Solo se necesita al desarrollar aplicaciones web. Solicitará el OAuthAccessToken desde esta URL.

Aporte
Nombre Tipo Obligatorio Descripción
CallbackUrl String Falso La URL a la que se redirigirá al usuario después de autorizar su aplicación. Este valor debe coincidir con la URL de redireccionamiento en la configuración de la aplicación ZohoProjects.
Scope String Falso Una lista separada por comas de ámbitos para solicitar al usuario. Consulte la documentación de la API de ZohoProjects para obtener una lista de los permisos disponibles. El valor predeterminado es ZohoProjects.portals.ALL, ZohoProjects.projects.ALL, ZohoProjects.status.ALL, ZohoProjects.milestones.ALL, ZohoProjects.tasklists.ALL, ZohoProjects.tasks.ALL, ZohoProjects.tags.ALL, ZohoProjects.bugs .TODOS, ZohoProjects.events.TODOS, ZohoProjects.forums.ALL, ZohoProjects.users.ALL, ZohoProjects.clients.ALL, ZohoProjects.documents.ALL, ZohoProjects.search.READ, ZohoProjects.entity_properties.ALL, ZohoProjects.activities.READ, ZohoProjects.hojas de horas trabajadas.TODO.
State String Falso 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 ZohoProjects y viceversa. Los usos incluyen redirigir al usuario al recurso correcto en su sitio, nonces y mitigaciones de falsificación de solicitudes entre sitios.
Columnas del Conjunto de Resultados
Nombre Tipo Descripción
URL String La URL de autorización, ingresada en un navegador web para obtener el token de verificación y autorizar su aplicación.

RefreshOAuthAccessToken

Actualiza el token de acceso de OAuth utilizado para la autenticación con ZohoProjects.

Aporte
Nombre Tipo Obligatorio Descripción
OAuthRefreshToken String Cierto El token de actualización devuelto del intercambio de código de autorización original.
AccountsServer String Falso La URL completa del servidor de cuentas que se usará para recuperar un nuevo token de acceso.
Columnas del Conjunto de Resultados
Nombre Tipo Descripción
OAuthAccessToken String El token de acceso devuelto por ZohoProjects. 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.

Seleccionar Líder de Equipo

Actualice al líder del equipo.

Información Específica del Procedimiento

Una consultar de ejemplo para ejecutar este procedimiento almacenado* se muestra a continuación:

EXEC SelectTeamLead PortalId = '12345317133', ProjectId = '123456000000031899', UserId = '123456000000033053'
Aporte
Nombre Tipo Obligatorio Descripción
PortalId String Falso Especifique el ID del portal.
TeamId String Falso Especifique la identificación del grupo.
UserId String Falso ZPUID del líder del equipo.
Columnas del Conjunto de Resultados
Nombre Tipo Descripción
Success String Especifica si la actualización fue exitosa.

TareaSeguir

Seguir una tarea en el proyecto dado.

Información Específica del Procedimiento

Una consultar de ejemplo para ejecutar este procedimiento almacenado* se muestra a continuación:

EXEC TaskFollow PortalId = '12345317133', ProjectId = '123456000000031899', TaskId = '123456000000034053', UserId = '123456000000039021'
Aporte
Nombre Tipo Obligatorio Descripción
PortalId String Cierto Especifique el ID del portal.
ProjectId String Cierto Especifique la identificación del grupo.
TaskId String Cierto Especifique el ID de la tarea.
UserId String Cierto La identificación de usuario para múltiples seguidores debe estar separada por comas.
Columnas del Conjunto de Resultados
Nombre Tipo Descripción
Success String Especifica si la ejecución fue exitosa.

TaskMove

Mueve una tarea de una lista de tareas a otra lista de tareas. La lista de tareas de destino puede ser del mismo proyecto o de un proyecto diferente.

Información Específica del Procedimiento

Una consultar de ejemplo para ejecutar este procedimiento almacenado* se muestra a continuación:

EXEC TaskMove PortalId = '12345317133', ProjectId = '123456000000031899', TaskId = '123456000000034053', FromTasklist = '123456000000031932', ToTasklist = '123456000000031941'
Aporte
Nombre Tipo Obligatorio Descripción
PortalId String Cierto Especifique el ID del portal.
ProjectId String Cierto Especifique la identificación del grupo.
TaskId String Cierto Especifique el ID de la tarea.
FromTasklist String Cierto ID de la lista de tareas en la que existe la tarea.
ToTasklist String Cierto ID de la lista de tareas a la que se debe mover la tarea.
Columnas del Conjunto de Resultados
Nombre Tipo Descripción
Success String Especifica si la ejecución fue exitosa.

TaskReorder

Reordena las tareas en el proyecto dado. La tarea se reordenará entre dos tareas en función de los ID de tarea anterior y siguiente.

Información Específica del Procedimiento

Una consultar de ejemplo para ejecutar este procedimiento almacenado* se muestra a continuación:

EXEC TaskReorder PortalId = '12345317133', ProjectId = '123456000000031899', TaskId = '123456000000034053', PreviousTaskId = '123456000000031932', NextTaskId = '123456000000031941'
Aporte
Nombre Tipo Obligatorio Descripción
PortalId String Cierto Especifique el ID del portal.
ProjectId String Cierto Especifique la identificación del grupo.
TaskId String Cierto Especifique el ID de la tarea.
PreviousTaskId String Cierto Especifique el ID de la tarea anterior.
NextTaskId String Cierto Especifique el siguiente ID de tarea.
Columnas del Conjunto de Resultados
Nombre Tipo Descripción
Success String Especifica si la actualización fue exitosa.

TareaDejar de Seguir

Dejar de seguir una tarea en el proyecto dado.

Información Específica del Procedimiento

Una consultar de ejemplo para ejecutar este procedimiento almacenado* se muestra a continuación:

EXEC TaskUnfollow PortalId = '12345317133', ProjectId = '123456000000031899', TaskId = '123456000000034053', UserId = '123456000000039021'
Aporte
Nombre Tipo Obligatorio Descripción
PortalId String Cierto Especifique el ID del portal.
ProjectId String Cierto Especifique la identificación del grupo.
TaskId String Cierto ZPUID del líder del equipo.
UserId String Cierto La identificación de usuario para múltiples seguidores debe estar separada por comas.
Columnas del Conjunto de Resultados
Nombre Tipo Descripción
Success String Especifica si la ejecución fue exitosa.

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 la base de datos para Zoho Projects:

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

SELECT ColumnName, DataTypeName FROM sys_tablecolumns WHERE TableName='Portals' 
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 ApproveTimelog:

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

SELECT * FROM sys_keycolumns WHERE IsKey='True' AND TableName='Portals'
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_primarykeys

Describe las claves primarias. La siguiente consultar recupera las claves principales de todas las tablas y vistas:

SELECT * FROM sys_primarykeys
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.
KeySeq String El número de secuencia de la clave principal.
KeyName String El nombre de la clave principal.

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

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
Region El dominio de nivel superior en la URL del servidor.

Conexión

Propiedad Descripción
PortalID Restrinja las entidades expuestas en función del ID del portal. Si se deja vacío, se expondrán todos los portales disponibles.
ProjectID Restrinja las entidades expuestas en función del ID del proyecto. Si se deja vacío, se expondrán todos los portales disponibles.

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.
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
AccountsServer La URL completa del servidor de cuentas.
APIDomain La URL completa del dominio API.
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.
Pagesize La cantidad máxima de resultados para devolver por página de Zoho Projects.
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.
UserDefinedViews Una ruta de archivo que apunta al archivo de configuración JSON que contiene sus vistas personalizadas.

Autenticación

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

Propiedad Descripción
Region El dominio de nivel superior en la URL del servidor.

Región

El dominio de nivel superior en la URL del servidor.

Valores Posibles

US, Europe, India, Australia

Tipo de Datos

string

Valor por Defecto

"US"

Observaciones

Si su cuenta reside en un dominio diferente, entonces la Región debería cambiar en consecuencia.

Región Dominio
US .com
Europe .eu
India .en
Australia .com.au

Conexión

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

Propiedad Descripción
PortalID Restrinja las entidades expuestas en función del ID del portal. Si se deja vacío, se expondrán todos los portales disponibles.
ProjectID Restrinja las entidades expuestas en función del ID del proyecto. Si se deja vacío, se expondrán todos los portales disponibles.

Id. del Portal

Restrinja las entidades expuestas en función del ID del portal. Si se deja vacío, se expondrán todos los portales disponibles.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

Restrinja las entidades expuestas en función del ID del portal. Si se deja vacío, se expondrán todos los portales disponibles.

Projecto ID

Restrinja las entidades expuestas en función del ID del proyecto. Si se deja vacío, se expondrán todos los portales disponibles.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

Restrinja las entidades expuestas en función del ID del proyecto. Si se deja vacío, se expondrán todos los portales disponibles.

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

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 a GETANDREFRESH para 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%\\\ZohoProjects 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.

Si no se especifica, la ubicación predeterminada es "%APPDATA%\\ZohoProjects 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
AccountsServer La URL completa del servidor de cuentas.
APIDomain La URL completa del dominio API.
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.
Pagesize La cantidad máxima de resultados para devolver por página de Zoho Projects.
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.
UserDefinedViews Una ruta de archivo que apunta al archivo de configuración JSON que contiene sus vistas personalizadas.

Servidor de Cuentas

La URL completa del servidor de cuentas.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

Solo necesita proporcionar esto cuando ejecute RefreshOAuthAccessToken procedimiento almacenado* con InitiateOAuth=Off. La mayoría de las veces, el valor de esta propiedad será https://accounts.zoho.com/, pero si su cuenta reside en una ubicación diferente, entonces el dominio debería cambiar en consecuencia (.eu, .in, .com.au, ...).

Dominio API

La URL completa del dominio API.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

Solo necesita proporcionar esto cuando use su propio token de acceso OAuth con InitiateOAuth=Off. De lo contrario, el dominio de la API se recuperará del flujo de OAuth. La mayoría de las veces, el valor de esta propiedad será https://www.zohoapis.com, pero si su cuenta reside en una ubicación diferente, entonces el dominio debería cambiar en consecuencia (.eu, .in, .com.au, ...).

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.

Tamaño de Página

La cantidad máxima de resultados para devolver por página de Zoho Projects.

Tipo de Datos

int

Valor por Defecto

100

Observaciones

El Pagesize la propiedad afecta la cantidad máxima de resultados a devolver por página de Zoho Projects. Establecer un valor más alto puede resultar en un mejor rendimiento a costa de memoria adicional asignada por página consumida.

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.

Vistas Definidas por el Usuario

Una ruta de archivo que apunta al archivo de configuración JSON que contiene sus vistas personalizadas.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

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 Portals 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"