DocumentaciónWorkfrontGuía de Workfront

Novedades de la versión 15 de la API

Last update: Wed Jul 17 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Temas:

Creado para:

  • Desarrollador

Adobe Workfront lanzó la versión 15 de la API el 14 de junio de 2022. La versión 15 de la API incorpora los siguientes cambios con respecto a la versión 14.

Recursos añadidos

Iniciativa (INITIV)

El objeto Initiative crea estimaciones en el Scenario Planner de Workfront para el tipo y el número de funciones del puesto, los costes fijos y el beneficio planificado.

Para obtener más información sobre Iniciativas, consulte Información general sobre iniciativas en el Scenario Planner.

Campos directos

  • customerID

    Este es un objeto interno.

  • duración

    Cantidad de tiempo entre endDate y startDate.

  • endDate

    Fecha planificada de finalización de la iniciativa.

  • enteredByID

    El ID asociado con el usuario que envió la solicitud.

  • ID

    El ID asociado con la acción

  • initiativeID

    El ID asociado con la iniciativa.

  • lastPublishedDate

    La fecha en la que se publicó por última vez la iniciativa en el Scenario Planner de Workfront.

  • nombre

    El nombre de la iniciativa

  • ID de plan

    El ID del plan asociado con la iniciativa.

  • nombreDePlan

    El nombre del plan asociado con la iniciativa.

  • ID de proyecto

    El ID del proyecto asociado con la iniciativa.

  • scenarioID

    El ID del escenario en Workfront Scenario Planner asociado con la iniciativa.

  • startDate

    La fecha planificada de inicio de la iniciativa.

Campos de referencia

  • cliente

  • enteredBy

  • proyecto

Campos principales

  • ID

  • nombre

  • objCode

Operaciones

  • RECUENTO

  • GET

  • INFORME

  • BUSCAR

IssueDef (ISSDEF)

El objeto IssueDef representa un conjunto de datos relativos al formato de los problemas. Este objeto se puede adjuntar a Proyectos o Plantillas y afecta a los problemas agregados a ese Proyecto o Plantilla.

Campos directos

  • ID

  • isInlineAddEnabled

Campos principales

  • ID

  • objCode

ObjectIntegration (OBJINT)

En algunos casos, es posible vincular elementos de trabajo de Workfront directamente a objetos de un producto de software externo. El objeto ObjectIntegration representa este vínculo.

Campos directos

  • customerID

    Este es un objeto interno.

  • entryDate

    La fecha y hora en que se ingresó la integración de objetos en el sistema de Workfront.

  • ID

    ID de Workfront único del objeto ObjectIntegration específico.

  • integrationType

    Software externo con el que el objeto ObjectIntegration crea un vínculo. Los valores posibles son:

    • JIRA

    • SALESFORCE

    • ANAPLAN

  • linkedObjectID

  • objID

    El objeto en Workfront con el que está asociado ObjectIntegration.

  • objObjCode

    El código de objeto del objeto en Workfront con el que está asociado ObjectIntegration.

  • param1

  • param2

  • param3

  • URL

Campos de referencia
  • cliente
Campos principales

  • ID

  • objCode

TaskDef (TSKDEF)

El objeto TaskDef representa un conjunto de datos relativos al formato de las tareas. Este objeto se puede adjuntar a Proyectos o Plantillas y afecta a las tareas agregadas a ese Proyecto o Plantilla.

Campos directos

  • autoCalcPlannedHours

  • ID

Campos de referencia
  • defaultApprovalProcess
Campos de colección
  • objectCategories
Campos principales

  • ID

  • objCode

Aprobación del usuario (USRAPV)

Campos directos

  • aprobador

  • customerID

  • ID

  • requestedDate

  • IDsolicitante

  • estado

  • idDeUsuario

Campos de referencia

  • aprobador

  • cliente

  • solicitante

  • usuario

Campos principales

  • ID

  • objCode

Campos predeterminados

  • aprobador

  • IDsolicitante

  • estado

  • idDeUsuario

Acciones

  • aprobar

  • rechazar

Operaciones

  • AGREGAR

  • RECUENTO

  • DELETE

  • GET

  • INFORME

  • BUSCAR

Recursos eliminados

No se ha eliminado ningún recurso para la versión 15 de la API.

Recursos modificados

AccessLevel (ACSLVL)

Un objeto AccessLevel está asociado a los usuarios y describe el conjunto de AccessLevelPermissions que determinan a qué puede tener acceso el usuario.

Para obtener más información sobre los niveles de acceso, vea Niveles de acceso.

Campos directos

  • fieldAccessPrivileges (cadena[])

    Se agregaron los siguientes valores posibles:

    • VTMAWMG (Ver equipos asociados con mis grupos)

    • VALLTM (Ver todos los equipos)

AccessLevelPermissions (ALVPER)

Un objeto AccessLevelPermissions representa un permiso específico para tener acceso, crear o modificar un objeto de Workfront. Estos permisos se pueden asociar a un nivel de acceso.

Campos directos

  • coreAction (cadena[])

    Se agregaron los siguientes valores posibles:

    • EDIT_TEAMS_I_AM_ON (Editar los equipos en los que estoy)

    • EDIT_TEAMS_I_GROUP_ADMIN (Editar equipos en grupos que administro (solo para Administradores de grupos))

  • forbiddenActions (cadena[])

    Se agregaron los siguientes valores posibles:

    • EDIT_TEAMS_I_AM_ON (Editar los equipos en los que estoy)

    • EDIT_TEAMS_I_GROUP_ADMIN (Editar equipos en grupos que administro (solo para Administradores de grupos))

  • secondaryActions (cadena[])

    Se agregaron los siguientes valores posibles:

    • EDIT_TEAMS_I_AM_ON (Editar los equipos en los que estoy)

    • EDIT_TEAMS_I_GROUP_ADMIN (Editar equipos en grupos que administro (solo para Administradores de grupos))

AccessRequest (ACSREQ)

Si un usuario no tiene acceso a un objeto de Workfront que necesite, puede solicitar acceso a ese objeto. El objeto AccessRequest representa esta solicitud.

Campos directos

  • acción (cadena)

    Se agregaron los siguientes valores posibles:

    • EDIT_TEAMS_I_AM_ON (Editar los equipos en los que estoy)

    • EDIT_TEAMS_I_GROUP_ADMIN (Editar equipos en grupos que administro (solo para Administradores de grupos))

  • autoShareAction (cadena)

    Se ha añadido el siguiente valor posible:

    • WDL

AccessRule (ACSRUL)

Un objeto AccessRule representa un conjunto de reglas en niveles de acceso personalizados que determina cómo los usuarios pueden compartir los proyectos que crean.

Campos directos

  • coreAction (cadena[])

    Se agregaron los siguientes valores posibles:

    • EDIT_TEAMS_I_AM_ON (Editar los equipos en los que estoy)

    • EDIT_TEAMS_I_GROUP_ADMIN (Editar equipos en grupos que administro (solo para Administradores de grupos))

  • forbiddenActions (cadena[])

    Se agregaron los siguientes valores posibles:

    • EDIT_TEAMS_I_AM_ON (Editar los equipos en los que estoy)

    • EDIT_TEAMS_I_GROUP_ADMIN (Editar equipos en grupos que administro (solo para Administradores de grupos))

  • secondaryActions (cadena[])

    Se agregaron los siguientes valores posibles:

    • EDIT_TEAMS_I_AM_ON (Editar los equipos en los que estoy)

    • EDIT_TEAMS_I_GROUP_ADMIN (Editar equipos en grupos que administro (solo para Administradores de grupos))

Aprobación (APPROVAL)

Un elemento de trabajo determinado, como una tarea, un documento o una plantilla de horas, puede requerir que un supervisor u otro usuario firme el elemento de trabajo. Un objeto Approval representa la acción de cerrar sesión en un elemento de trabajo.

Campos directos
  • resourcePlannerBudgetedHours
Campos de referencia

  • iniciativa

    Añadido.

    El objeto Initiative crea estimaciones en el Scenario Planner de Workfront para el tipo y el número de funciones del puesto, los costes fijos y el beneficio planificado.

  • issueDef

    Añadido.

  • taskDef

    Añadido.

Campos de colección

  • objectIntegrations

    Añadido.

    En algunos casos, es posible vincular elementos de trabajo de Workfront directamente a objetos de un producto de software externo. El objeto ObjectIntegration representa este vínculo.

Categoría (CTGY)

Un objeto Category es un formulario personalizado.

Campos directos

  • catObjCode (cadena)

    Se ha añadido el siguiente valor posible:

    • GROUP (grupo)

  • objTypes (cadena[])

    Añadido.

    Este parámetro es una matriz de objetos posibles a los que se puede adjuntar el formulario personalizado. Se agregó para admitir la capacidad de adjuntar un formulario personalizado a varios tipos de objetos.

    Valores posibles:

    CMPY, PUERTO, PRGM, PROJ, TAREA, OPTASK, USUARIO, DOCU, EXPNS, ITRN, FACTURA, GRUPO

Campos de colección

  • objTypes (cadena[])

    Añadido.

    Este parámetro es una matriz de objetos posibles a los que se puede adjuntar el formulario personalizado. Se agregó para admitir la capacidad de adjuntar un formulario personalizado a varios tipos de objetos.

    Valores posibles:

    CMPY, PUERTO, PRGM, PROJ, TAREA, OPTASK, USUARIO, DOCU, EXPNS, ITRN, FACTURA, GRUPO

Parámetro de categoría (CTGYPA)

Campos directos

  • hideFormulaFromDescription

    Añadido.

  • journalObjCodes

    Añadido.

  • rawCustomExpression

    Añadido.

Preferencias del cliente (CUSTPR)

Un objeto CustomerPreferences representa el conjunto de preferencias que un cliente ha establecido para su instancia de Workfront.

Campos directos

  • nombre

    Se agregaron los siguientes valores:

    • password:sharePointV2IntegrationEnabled (Integración de SharePoint (API de gráficos) habilitada)

      Este valor admite la integración actualizada con Sharepoint.

    • project.mgmt:default.project.allowcreatewithouttemplate (Permitir que los usuarios creen proyectos sin usar una plantilla)

    • project.mgmt:taskissue.delegate (config.taskissue.delegate)

Carpeta de documentos (DOCFDR)

Los documentos se pueden organizar en carpetas. Puede crear carpetas personales en el área de Documentos personales. El objeto DocumentFolder representa una de estas carpetas.

El objeto DocumentFolder agregó el marcador SHARABLE.

DocumentVersion (DOCV)

Un objeto DocumentVersion representa una versión específica de un archivo (como material escrito, imágenes u otras formas de información).

Para obtener más información acerca de las versiones de documentos, vea Cargar una nueva versión de un documento.

Campos directos

  • externalIntegrationType

    Se ha añadido el siguiente valor:

    • SHAREPOINT_V2 (SharePoint (API de gráficos))

      Este valor admite la integración actualizada con Sharepoint.

Grupo (GROUP)

Un objeto Group representa un conjunto de usuarios y equipos. Los grupos a menudo representan la estructura departamental.

Para obtener más información sobre los grupos, consulte Grupos frente a equipos.

El objeto Group agregó el marcador DATA_EXTENDIBLE

Campos directos

Se agregaron los campos siguientes:

  • categoryID

    Una categoría es un formulario personalizado. Este parámetro se ha agregado para admitir la posibilidad de agregar Forms personalizado a objetos de grupo.

  • isActive

    Es un parámetro booleano con un valor true si un objeto está activo y false si no lo está. Los objetos que se definen como Activos aparecen en menús desplegables y campos de escritura anticipada y pueden adjuntarse a otros objetos.

Campos de referencia

Se agregaron los campos siguientes:

  • aprobador

  • cliente

  • solicitante

  • usuario

Campos de colección

Se agregaron los campos siguientes:

  • objectCategories

  • objectIntegrations

    En algunos casos, es posible vincular elementos de trabajo de Workfront directamente a objetos de un producto de software externo. El objeto ObjectIntegration representa este vínculo.

Campos predeterminados

Se ha añadido el siguiente campo:

  • isActive

    Es un parámetro booleano con un valor true si un objeto está activo y false si no lo está. Los objetos que se definen como Activos aparecen en menús desplegables y campos de escritura anticipada y pueden adjuntarse a otros objetos.

Acciones

Se agregaron los campos siguientes:

  • calculateDataExtension

    Esta acción vuelve a calcular las expresiones de los campos de formulario personalizados.

  • completeGroupInfo

  • linkExternalObject

  • unlinkExternalObject

Entrada de diario (JRNLE)

El objeto JournalEntry se puede configurar para que registre información sobre campos de objeto específicos cada vez que se modifiquen dichos campos. Cuando un campo está configurado para registrarse como parte del objeto Entrada de cuaderno, se creará una Entrada de cuaderno correspondiente cada vez que se modifique ese campo.

Campos directos

changeType

Se ha añadido el siguiente valor:

  • DW (descarga)

LinkedFolder (LNKFDR)

Un objeto LinkedFolder representa una carpeta vinculada desde un proveedor de documentos externo, como Google Drive o Dropbox.

Para obtener más información sobre las carpetas vinculadas, consulte Vincular documentos desde aplicaciones externas.

Campos directos

  • externalIntegrationType

    Se ha añadido el siguiente valor:

    • SHAREPOINT_V2 (SharePoint (API de gráficos))

      Este valor admite la integración actualizada con Sharepoint.

OpTask / Problema (OPTASK)

Un objeto OpTask suele conocerse como Problema. Un problema es un elemento de trabajo que normalmente indica que hay un problema que impide la finalización de una tarea o proyecto. Un problema también puede ser una solicitud del servicio de asistencia. Las solicitudes de cambio, las solicitudes y los errores también son problemas.

Acciones

Se agregaron las siguientes acciones:

  • bulkMoveWithOptions

  • getRequestPath

Se modificó la siguiente acción:

  • problemaDeCopia

    Campo añadido parentID

Parámetro (PARAM)

Un objeto Parameter es un campo personalizado.

Campos directos

Se ha añadido el siguiente campo:

  • fieldDefinition

Se han modificado los campos siguientes:

  • dataType

    Se agregó el valor posible WIDGET (Widget)

    Este valor admite el uso de imágenes en formularios personalizados.

  • displayType

    Se agregó el valor posible WIDGET (Widget)

    Este valor admite el uso de imágenes en formularios personalizados.

Portfolio (PUERTO)

Un objeto Portfolio es una colección de proyectos que compiten por los mismos recursos, normalmente dinero o personas para completarlos.

Campos de colección
  • objectIntegrations
Acciones

  • linkExternalObject

  • unlinkExternalObject

Programa (PRGM)

Un objeto Program es un subconjunto de proyectos dentro de un portafolio, donde se pueden agrupar proyectos similares.

Campos de colección
  • objectIntegrations
Acciones

  • linkExternalObject

  • unlinkExternalObject

Proyecto (PROJ)

Los proyectos son elementos de trabajo dentro de Workfront y son un bloque de creación principal en la forma en que Workfront ayuda a las personas a realizar su trabajo. Un objeto Project representa un grupo de tareas con un objetivo común y específico.

Campos directos
  • resourcePlannerBudgetedHours
Campos de referencia

  • iniciativa

    El objeto Initiative crea estimaciones en el Scenario Planner de Workfront para el tipo y el número de funciones del puesto, los costes fijos y el beneficio planificado.

  • issueDef

  • taskDef

Campos de colección

  • objectIntegrations

    En algunos casos, es posible vincular elementos de trabajo de Workfront directamente a objetos de un producto de software externo. El objeto ObjectIntegration representa este vínculo.

QueueDef (QUED)

Un objeto QueueDef representa una cola, que es un proyecto que se ha publicado en el área del servicio de asistencia para permitir a los usuarios enviar problemas al mismo.

Para obtener más información sobre las colas de solicitudes, vea Crear una cola de solicitudes.

Campos directos

  • requestorCoreAction

    Se agregaron los siguientes valores posibles:

    • EDIT_TEAMS_I_AM_ON (Editar los equipos en los que estoy)

    • EDIT_TEAMS_I_GROUP_ADMIN (Editar equipos en grupos que administro (solo para Administradores de grupos))

  • requestorForbiddenActions

    Se agregaron los siguientes valores posibles:

    • EDIT_TEAMS_I_AM_ON (Editar los equipos en los que estoy)

    • EDIT_TEAMS_I_GROUP_ADMIN (Editar equipos en grupos que administro (solo para Administradores de grupos))

ScoreCardQuestion (SCOREQ)

Un objeto ScoreCardQuestion representa una pregunta que se ha agregado a un informe de valoración. Estas preguntas suelen ser determinadas por el gestor del Portfolio, y sus respuestas le permiten comprender cómo se ajusta un proyecto a los objetivos del portafolio.

Para obtener más información sobre las preguntas del informe de valoración, consulte Crear un informe de valoración.

Campos directos

  • displayType

    Se agregó el valor posible WIDGET (Widget)

Tarea (TAREA)

Un objeto Task representa un elemento de trabajo que debe realizarse como un paso hacia el logro de un objetivo final (completar un proyecto).

Campos de colección

  • objectIntegrations

    En algunos casos, es posible vincular elementos de trabajo de Workfront directamente a objetos de un producto de software externo. El objeto ObjectIntegration representa este vínculo.

Plantilla (TMPL)

Un objeto Template representa un patrón para un proyecto. Los proyectos se pueden crear a partir de plantillas para ahorrar tiempo. Una plantilla contiene un equipo y tareas, que se copiarán en cualquier proyecto creado a partir de la plantilla.

Campos de referencia

  • issueDef

  • taskDef

Hoja de horas (TSHET)

Un objeto Timesheet representa un parte de horas virtual que permite a los usuarios especificar horas trabajadas reales para tareas, proyectos y tipos de horas generales.

Campos principales

Se ha eliminado el siguiente campo:

  • objCode

Ver (UIVIEW)

Campos directos

  • uiviewType

    Se eliminaron los siguientes valores posibles:

    • FOUR_COL (Diseño de cuatro columnas)

    • UPDATES (Actualizaciones)

    • UPDATESTOOLBAR_FEED (Actualizaciones)

    • WORKINGON (Trabajando en)

    • CUSTOMDATA (Datos personalizados)

    • CUSTOMDATA_UPDATE (Actualizar datos personalizados)

    • STATUS_UPDATE (Actualización de estado)

    • OPTASK_STATUS_UPDATE (Actualización de estado)

    • PROJ_STATUS_UPDATE (Actualización de estado)

    • PROJECT_TIMEENTRY (Actualización de estado)

    • DLIST (Lista de detalles)

    • DLIST_SECTION (Sección de lista de detalles)

Actualizar (UPDATE)

Los elementos de trabajo de Workfront se pueden actualizar para mantener a los usuarios informados del estado actual. Un objeto Update representa una de estas actualizaciones. Los usuarios pueden introducir actualizaciones o el sistema de Workfront puede crearlas.

Campos directos

  • updateType

    Se agregó el valor posible documentVersionDownload (enum.updatetypenum.documentversiondownload)

Usuario (USER)

Un objeto User representa a una persona con una cuenta en Workfront que puede iniciar sesión e interactuar con el sistema.

Campos de referencia
  • userApproval
Acciones

  • getUsersAvailableTime

  • resetRopgPassword

UserNote (USRNOT)

Un objeto UserNote es una notificación.

Campos directos

  • eventType

    Se agregaron los siguientes valores posibles:

    • DUP (Se le ha solicitado que revise un documento)

    • DUV (Permite ver un documento)

Trabajo (TRABAJO)

Un objeto Work es una interfaz común que heredan Task y OpTask, y comparte código común entre ambos.

Campos de colección

  • objectIntegrations

    En algunos casos, es posible vincular elementos de trabajo de Workfront directamente a objetos de un producto de software externo. El objeto ObjectIntegration representa este vínculo.

recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43