DocumentaciónWorkfrontGuía de Workfront

Novedades de la versión 12 de la API

Last update: Wed Nov 05 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Temas:

Creado para:

  • Desarrollador

El 12 de noviembre de 2020, Workfront publicó la versión 12 de la API. La versión 12 de la API incorpora los siguientes cambios con respecto a la versión 11

Recursos añadidos

Los siguientes recursos son nuevos en la versión 12 de la API de Workfront.

Ruta de exploración breadcrumb

Un objeto BreadCrumb representa un elemento en la jerarquía principal/secundario de un elemento de trabajo de Adobe Workfront. Las rutas indican cómo encaja un elemento de trabajo en la mayor estructura de portafolios, proyectos, proyectos y tareas.

Para obtener más información sobre las rutas de exploración en Workfront, consulte Información general sobre las rutas de exploración en la nueva experiencia de Adobe Workfront

  • getObjectHierarchy

RichTextParameterValue richtextparametervalue

Los campos de texto enriquecido están ahora disponibles en más objetos. El objeto RichTextParameterValue se ha añadido a Workfront para admitir esta disponibilidad.

Para obtener más información, consulte Campos de texto enriquecido en la API de Adobe Workfront.

  • Identificador
  • Identificador
  • objCode

Recursos eliminados

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

Recursos modificados

Se han modificado los siguientes recursos para la versión 12 de la API de Workfront.

AccessLevel accesslevel

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, consulte Cómo funcionan los niveles de acceso.

AccessLevelPermissions accesslevelpermissions

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

    Se añadieron los siguientes valores posibles:

  • forbiddenActions

    Se añadieron los siguientes valores posibles:

    • PLANNED_HOURS_CONTOURING

    • ADD_TO_CUSTOM_FORMS

    • EDIT_SYSTEMWIDE

  • secondaryActions

    Se añadieron los siguientes valores posibles:

    • PLANNED_HOURS_CONTOURING

    • ADD_TO_CUSTOM_FORMS

    • EDIT_SYSTEMWIDE

AccessRequest accessrequest

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

Campos directos

AccessRule accessrule

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

Campos directos

  • coreAction

    Se añadieron los siguientes valores posibles:

  • forbiddenActions

    Se añadieron los siguientes valores posibles:

    • PLANNED_HOURS_CONTOURING

    • ADD_TO_CUSTOM_FORMS

    • EDIT_SYSTEMWIDE

  • secondaryActions

    Se añadieron los siguientes valores posibles:

    • PLANNED_HOURS_CONTOURING

    • ADD_TO_CUSTOM_FORMS

    • EDIT_SYSTEMWIDE

ActivityLog activitylog

Un objeto ActivityLog es una lista completa de todas las actividades que se han realizado en una cuenta de Workfront Proof determinada.

Operaciones

Se quitó la siguiente operación del objeto ActivityLog:

  • AÑADIR

AnnouncementAttachment announcementattachment

Un objeto AnnouncementAttachment representa un archivo que se ha adjuntado a un anuncio de Workfront.

Para obtener más información acerca de los archivos adjuntos de los anuncios, consulte Enviar anuncios

Campos directos

  • fileExtension

    Se añadieron los valores posibles:

    • qdoc (enum.fileextension.qdoc)

    • qslides (enum.fileextension.qslides)

    • qsheet (enum.fileextension.qsheet)

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 de aprobación representa la acción de cerrar sesión en un elemento de trabajo.

Campos directos

  • backlogOrder

    Se han eliminado los siguientes indicadores:

    • DINÁMICO,

    • LAZY_READ,

    • NOT_GROUPABLE

  • groupID

    Se añadieron los siguientes indicadores

    • AUTO_LOAD,

    • DINÁMICO,

    • READ_ONLY

  • workEffort

    Este campo se ha añadido y representa si un usuario necesita un esfuerzo diario pequeño, medio o grande para completar una tarea. Los valores posibles son:

    • 1 (Pequeño)

    • 2 (Medio)

    • 3 (Grande)

    Para obtener más información sobre el esfuerzo de trabajo en Workfront, consulte Información general de esfuerzo laboral.

CalendarSection calendarsection

Una sección de calendario es un informe de calendario.

Para obtener más información sobre los informes de calendario, consulte Información general de informes de calendario.

Campos directos

Se añadieron los campos siguientes al objeto CalendarSection para admitir la nueva funcionalidad de usar fechas personalizadas en los informes de calendario.

Para obtener más información, consulte Usar campos de fecha personalizados en un informe de calendario.

  • customDate

  • customEndDateParameterID

  • customStartDateParameterID

  • ignoreActualDates

Compañía company

Un objeto de compañía representa a una organización formada por una colección de personas.

Para obtener más información sobre las compañías, consulte Crear y editar empresas.

Campos directos

  • groupID

    El ID del grupo con el que está asociada la empresa.

Campos de referencia

  • grupo

    El grupo con el que la empresa está asociada. La asociación de una empresa con un grupo permite al administrador del grupo ampliar el acceso y los permisos del grupo a la empresa.

Cliente customer

Un objeto de cliente representa a una organización que utiliza una instancia de Workfront.

Acciones

  • productEnabled

    Esta acción toma un argumento CustomerProductTypeEnum y devuelve un valor booleano que indica si el cliente tiene una cuenta para ese producto.

CustomerPreferences customerpreferences

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

Campos directos

  • name

    Se añadieron los valores posibles:

    • password:zoomIntegrationEnabled (Habilitar integración de Zoom en el flujo de actualizaciones)
    • contraseña:quipIntegrationEnabled (config.general.quip.enabled)

Documento document

Un objeto de documento representa un archivo (como material escrito, imágenes u otras formas de información).

Acciones

  • createLinkedProofVersion

    Agregado

DocumentVersion documentversion

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, consulte Cargar una nueva versión de un documento.

Campos directos

  • externalIntegrationType

    Se ha eliminado el valor posible:

    • QUIP (Quip)

  • proofDecision

    Agregado

Acciones

Se han añadido las siguientes acciones al objeto de documento.

  • getDocumentReviewerDecision

    Esta acción toma el argumento documentVersionID (cadena) y devuelve un mapa que indica la decisión del revisor.

  • setDocumentReviewerDecision

    Esta acción emplea los argumentos siguientes:

    • documentVersionID (string)

    • reviewerDecision (string)

    • comment (string)

Grupo group

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

Campos directos

  • businessLeaderID

    El ID del coordinador empresarial asignado al grupo.

Campos de referencia

  • businessLeader

    El coordinador empresarial asignado al grupo. Un líder empresarial es alguien que toma decisiones comerciales para el grupo.

    Para obtener más información sobre los líderes empresariales, consulte Información general de líder empresarial.

Acciones

  • assignMultiple

    Esta acción emplea los argumentos siguientes:

    • userIDs (string[])

    • roleIDs (string[])

    • teamID (string)

  • getGroupMembers

  • updateMembersList

    Esta acción emplea los argumentos siguientes:

    • newMemberIDs (string[])

    • removedMemberDs (string[])

LinkedFolder linkedfolder

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 Vinculación de documentos desde aplicaciones externas.

Campos directos

  • externalIntegrationType

    Se ha eliminado el valor posible:

    • QUIP (Quip)

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

Campos directos

  • backlogOrder

    El orden indica la posición de una tarea o historia en el registro de asuntos pendientes de Agile.

    Este campo ha eliminado los siguientes indicadores:

    • DINÁMICO,
    • LAZY_READ,
    • NOT_GROUPABLE:
Acciones

Estas acciones añadieron el argumento de estado para admitir la nueva funcionalidad del botón Iniciar, que cambia el estado de un elemento de trabajo cuando un usuario haga clic en el botón para indicar que ha comenzado a trabajar en el elemento.

Para obtener más información, consulte Reemplazar el botón Trabajar en ello por un botón Iniciar.

  • acceptWork

  • unacceptWork

Parámetro parameter

Un objeto Parameter es un campo personalizado.

El recurso Parámetro ha añadido la bandera COMPARTIBLE.

Para obtener más información sobre los campos personalizados, consulte Crear o editar un formulario personalizado en Crear o editar un formulario personalizado.

Campos directos
Campos de colección

  • accessRules

    Agregado

Campos predeterminados

  • label

    Agregado

Portafolio portfolio

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

Para obtener más información sobre portafolios, consulte Información general del portafolio en Adobe Workfront.

Campos directos

  • groupID

    El ID del grupo al que está asociado el portafolio.

Campos de referencia

  • grupo

    El grupo al que está asociado el portafolio.

Programa program

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

Campos directos

  • groupID

    El ID del grupo al que está asociado el programa.

Campos de referencia

  • grupo

    Grupo al que está asociado el programa.

QueueDef queuedef

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

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

Campos directos

ScheduledReport scheduledreport

Un objeto ScheduledReport representa un informe que se ha configurado para que se programe su envío.

Campos directos

  • format

    Se añadieron los valores posibles:

    • qdoc (enum.fileextension.qdoc)

    • qslides (enum.fileextension.qslides)

    • qsheet (enum.fileextension.qsheet)

ScoreCardQuestion scorecardquestion

Un objeto ScoreCardQuestion representa una pregunta que se ha añadido a un informe de valoración. Estas preguntas suelen ser determinadas por el responsable del portafolio, y sus respuestas le permiten comprender cómo se ajusta un proyecto a las metas del portafolio.

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

Campos directos

Tarea task

Un objeto Tarea representa un elemento de trabajo que debe realizarse como un paso hacia la meta de un objetivo final (completar un proyecto).

Campos directos

  • workEffort

    Este campo se ha añadido y representa si un usuario necesita un esfuerzo diario pequeño, medio o grande para completar una tarea. Los valores posibles son:

    • 1 (Pequeño)

    • 2 (Medio)

    • 3 (Grande)

    Para obtener más información sobre el esfuerzo de trabajo en Workfront, consulte Información general de esfuerzo laboral.

Acciones

Estas acciones añadieron el argumento de estado para admitir la nueva funcionalidad del botón Iniciar, que cambia el estado de un elemento de trabajo cuando un usuario haga clic en el botón para indicar que ha comenzado a trabajar en el elemento.

Para obtener más información, consulte Reemplazar el botón Trabajar en ello por un botón Iniciar.

  • acceptWork

  • unacceptWork

Equipo team

Un objeto de equipo es una colección de usuarios que se pueden asignar a un elemento de trabajo.

Campos directos

Se añadieron los campos siguientes al recurso de equipo:

  • groupID

    Este campo asocia un equipo con un grupo. Esto identifica al equipo como parte del grupo y permite al administrador del grupo administrar los equipos.

  • workOnItStatusChange

    Es un parámetro booleano que indica si el botón Trabajar en ello del equipo se ha configurado como botón Inicio. Cuando un miembro del equipo hace clic en un botón Iniciar para comenzar a trabajar en un elemento de trabajo, el estado del elemento cambia de Nuevo a un estado configurado en la configuración del equipo.

  • Los campos siguientes permiten especificar estados personalizados para el botón Inicio en los elementos de trabajo individuales.

    • workOnItOpTaskBugReportStatus

    • workOnItOpTaskChangeOrderStatuses

    • workOnItOpTaskIssueStatuses

    • workOnItOpTaskRequestStatuses

      workOnItTaskStatus

    Para obtener más información sobre el botón Inicio, consulte Reemplazar el botón Trabajar en ello por un botón Iniciar.

Campos de referencia

Se añadió el campo siguiente al recurso de equipo:

  • group

TemplateTask templatetask

Un objeto TemplateTask representa un objeto Tarea que forma parte de un objeto Plantilla. Las tareas de plantilla pasan a ser tareas en el proyecto en el que se utiliza la Plantilla.

Para obtener más información sobre las tareas de plantilla, consulte Editar tareas de plantilla.

Campos directos

  • workEffort

    Este campo se ha añadido y representa si un usuario necesita un esfuerzo diario pequeño, medio o grande para completar una tarea. Los valores posibles son:

    • 1 (Pequeño)

    • 2 (Medio)

    • 3 (Grande)

    Para obtener más información sobre el esfuerzo de trabajo en Workfront, consulte Información general de esfuerzo laboral.

Plantilla de horas timesheet

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

Para obtener más información sobre las hojas de horas, consulte Información general sobre hojas de horas

Campos principales

El campo siguiente se ha eliminado del recurso de plantilla de horas:

  • objcode

Actualizar

Campos directos

  • updateType

    Se añadieron los siguientes valores posibles:

    • initiativeAdd (enum.updatetypeenum.initiativeadd)

    • initiativeEdit (enum.updatetypeenum.initiativeedit)

    Para obtener más información sobre iniciativas, consulte Descripción de planes en el planificador de escenarios.

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 directos

Se añadieron los campos siguientes al recurso de usuario:

  • actualDeactivationDate

    Representa la fecha y la hora en que se desactivó un usuario.

    Para obtener más información sobre los usuarios desactivados, consulte Desactivar o reactivar un usuario.

  • alignAccessType

    Este campo muestra el acceso del usuario a Workfront Goals. Los valores posibles son:

    • Sin acceso

    • Ver

    • Editar

Acciones

Se ha añadido la siguiente acción al recurso de usuario:

  • getUserAccessPermissionsByObjCode

    Esta acción emplea los argumentos siguientes

    • ids (cadena de texto)

    • objCode (cadena de texto)

Trabajo work

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

Campos directos

  • backlogOrder

    El orden indica la posición de una tarea o historia en el registro de asuntos pendientes de Agile.

    Este campo ha eliminado los siguientes indicadores:

    • DINÁMICO,

    • LAZY_READ,

    • NOT_GROUPABLE

  • groupID

    Este campo añadió los siguientes indicadores:

    • AUTO_LOAD,

    • DINÁMICO,

    • READ_ONLY

  • workEffort

    Este campo se ha añadido y representa si un usuario necesita un esfuerzo diario pequeño, medio o grande para completar una tarea. Los valores posibles son:

    • 1 (Pequeño)

    • 2 (Medio)

    • 3 (Grande)

    Para obtener más información sobre Esfuerzo de trabajo en Workfront, consulte Información general de esfuerzo laboral.

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