Novedades de la versión 12 de la API
Creado para:
- Desarrollador
Workfront lanzó la versión 12 de la API el 12 de noviembre de 2020. 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.
RutaPan
Un objeto BreadCrumb representa un elemento en la jerarquía principal/secundario de un elemento de trabajo de Adobe Workfront. Las rutas de exploración indican cómo encaja un elemento de trabajo en la mayor estructura de Portfolio, 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
Los campos de texto enriquecido ahora están disponibles en más objetos. El objeto RichTextParameterValue se agregó 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
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 Funcionamiento de los niveles de acceso.
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.
-
coreAction
Se agregaron los siguientes valores posibles:
-
PLANNED_HOURS_CONTOURING
Un usuario con un nivel de acceso que incluya este permiso puede actualizar las horas planificadas en el Distribuidor de cargas de trabajo.
Para obtener más información, consulte Actualizar horas planificadas para la tarea al administrar asignaciones de usuarios en Administrar asignaciones de usuarios en el Distribuidor de cargas de trabajo.
-
ADD_TO_CUSTOM_FORMS
Un usuario con un nivel de acceso que incluya este permiso puede agregar campos a los formularios personalizados.
Para obtener más información, consulte Crear o editar un formulario personalizado.
-
EDIT_SYSTEMWIDE
Un usuario con un nivel de acceso que incluya este permiso puede compartir un campo personalizado en todo el sistema con acceso de eliminación.
-
-
acciones prohibidas
Se agregaron los siguientes valores posibles:
-
PLANNED_HOURS_CONTOURING
-
ADD_TO_CUSTOM_FORMS
-
EDIT_SYSTEMWIDE
-
-
secondaryActions
Se agregaron los siguientes valores posibles:
-
PLANNED_HOURS_CONTOURING
-
ADD_TO_CUSTOM_FORMS
-
EDIT_SYSTEMWIDE
-
AccessRequest
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.
-
acción
Se agregaron los siguientes valores posibles:
-
PLANNED_HOURS_CONTOURING
Un usuario con un nivel de acceso que incluya este permiso puede actualizar las horas planificadas en el Distribuidor de cargas de trabajo.
Para obtener más información, consulte Actualizar horas planificadas para la tarea al administrar asignaciones de usuarios en Administrar asignaciones de usuarios en el Distribuidor de cargas de trabajo.
-
ADD_TO_CUSTOM_FORMS
Un usuario con un nivel de acceso que incluya este permiso puede agregar campos a los formularios personalizados.
Para obtener más información, consulte Crear o editar un formulario personalizado.
-
EDIT_SYSTEMWIDE
Un usuario con un nivel de acceso que incluya este permiso puede compartir un campo personalizado en todo el sistema con acceso de eliminación.
-
AccessRule
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.
-
coreAction
Se agregaron los siguientes valores posibles:
-
PLANNED_HOURS_CONTOURING
Un usuario con un nivel de acceso que incluya este permiso puede actualizar las horas planificadas en el Distribuidor de cargas de trabajo.
Para obtener más información, consulte Actualizar horas planificadas para la tarea al administrar asignaciones de usuarios en Administrar asignaciones de usuarios en el Distribuidor de cargas de trabajo.
-
ADD_TO_CUSTOM_FORMS
Un usuario con un nivel de acceso que incluya este permiso puede agregar campos a los formularios personalizados.
Para obtener más información, consulte Crear o editar un formulario personalizado.
-
EDIT_SYSTEMWIDE
Un usuario con un nivel de acceso que incluya este permiso puede compartir un campo personalizado en todo el sistema con acceso de eliminación.
-
-
acciones prohibidas
Se agregaron los siguientes valores posibles:
-
PLANNED_HOURS_CONTOURING
-
ADD_TO_CUSTOM_FORMS
-
EDIT_SYSTEMWIDE
-
-
secondaryActions
Se agregaron los siguientes valores posibles:
-
PLANNED_HOURS_CONTOURING
-
ADD_TO_CUSTOM_FORMS
-
EDIT_SYSTEMWIDE
-
ActivityLog
Un objeto ActivityLog es una lista completa de todas las actividades que se han realizado en una cuenta de Workfront Proof determinada.
Se quitó la siguiente operación del objeto ActivityLog:
- AGREGAR
AnuncioAdjunto
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, vea Enviar anuncios
-
fileExtension
Se agregaron valores posibles:
-
qdoc (enum.fileextension.qdoc)
-
qslide (enum.fileextension.qslide)
-
qsheet (enum.fileextension.qsheet)
-
Aprobación
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.
-
pedidoRegistroAtrasado
Se han eliminado los siguientes indicadores:
-
DINÁMICO,
-
LAZY_READ,
-
NOT_GROUPABLE
-
-
Id. de grupo
Se agregaron los siguientes indicadores
-
AUTO_LOAD,
-
DINÁMICO,
-
READ_ONLY
-
-
esfuerzoDeTrabajo
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 (Medium)
-
3 (Grande)
Para obtener más información sobre el esfuerzo de trabajo en Workfront, consulte Resumen del esfuerzo de trabajo.
-
SecciónCalendario
Una sección de calendario es un informe de calendario.
Para obtener más información sobre los informes de calendario, consulte Resumen de informes de calendario.
Se agregaron 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
Un objeto Company representa una organización formada por una colección de personas.
Para obtener más información sobre las compañías, consulte Crear y editar compañías.
-
groupID
El ID del grupo con el que está asociada la compañía.
-
grupo
El grupo con el que está asociada la compañía. 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
Un objeto Customer representa una organización que utiliza una instancia de Workfront.
-
productEnabled
Esta acción toma un argumento CustomerProductTypeEnum y devuelve un valor booleano que indica si el cliente tiene una cuenta para ese producto.
Preferencias del cliente
Un objeto CustomerPreferences representa el conjunto de preferencias que un cliente ha establecido para su instancia de Workfront.
-
name
Se agregaron valores posibles:
- contraseña:zoomIntegrationEnabled (habilitar la integración de Zoom en el flujo de actualizaciones)
- contraseña:quipIntegrationEnabled (config.general.quip.enabled)
Documento
Un objeto Document representa un archivo (como material escrito, imágenes u otras formas de información).
-
createLinkedProofVersion
Agregado
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, vea Cargar una nueva versión de un documento.
-
externalIntegrationType
Se ha eliminado el valor posible:
- QUIP (Quip)
-
decisiónDeRevisión
Agregado
Se agregaron las siguientes acciones al objeto Document.
-
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 (cadena)
-
reviewerDecision (cadena)
-
comentario (cadena)
-
Grupo
Un objeto Group representa un conjunto de usuarios y equipos. Los grupos a menudo representan la estructura departamental.
-
businessLeaderID
El ID del coordinador empresarial asignado al grupo.
-
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 Resumen del líder empresarial.
-
assignMultiple
Esta acción emplea los argumentos siguientes:
-
userIDs (string[])
-
roleIDs (cadena[])
-
teamID (cadena)
-
-
getGroupMembers
-
updateMembersList
Esta acción emplea los argumentos siguientes:
-
newMemberIDs (string[])
-
removeMemberDs (cadena[])
-
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 Enlazar documentos desde aplicaciones externas.
-
externalIntegrationType
Se ha eliminado el valor posible:
- QUIP (Quip)
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.
-
pedidoRegistroAtrasado
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:
Estas acciones agregaron el estado del argumento para admitir la nueva funcionalidad del botón Inicio, que cambia el estado de un elemento de trabajo cuando un usuario hace clic en el botón para indicar que ha comenzado a trabajar en el elemento.
Para obtener más información, vea Reemplazar el botón Trabajar en ello por un botón Iniciar.
-
acceptWork
-
unacceptWork
Parámetro
Un objeto Parameter es un campo personalizado.
El recurso Parámetro agregó el indicador SHARABLE.
Para obtener más información sobre los campos personalizados, consulte Crear o editar un formulario personalizado en Crear o editar un formulario personalizado.
-
dataType
Se ha agregado el valor posible:
-
ENRIQUECIDO (texto enriquecido)
Para obtener más información, consulte Campos de texto enriquecido en la API de Adobe Workfront.
-
-
displayType
Se ha agregado el valor posible:
-
RICH (Campo de texto con formato)
Para obtener más información, consulte Campos de texto enriquecido en la API de Adobe Workfront.
-
-
etiqueta
Agregado
-
reglas de acceso
Agregado
-
etiqueta
Agregado
Portafolio
Un objeto Portfolio es una colección de proyectos que compiten por los mismos recursos, normalmente dinero o personas para completarlos.
Para obtener más información sobre portafolios, consulte descripción general del Portfolio en Adobe Workfront.
-
groupID
El ID del grupo al que está asociado el portafolio.
-
grupo
El grupo al que está asociado el portafolio.
Programar
Un objeto Program es un subconjunto de proyectos dentro de un portafolio, donde se pueden agrupar proyectos similares.
-
groupID
El ID del grupo al que está asociado el programa.
-
grupo
Grupo al que está asociado el programa.
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 enviar problemas al mismo.
Para obtener más información sobre las colas de solicitudes, vea Crear una cola de solicitudes.
-
requestorCoreAction
Se agregaron los siguientes valores posibles:
-
PLANNED_HOURS_CONTOURING
Un usuario con un nivel de acceso que incluya este permiso puede actualizar las horas planificadas en el Distribuidor de cargas de trabajo.
Para obtener más información, consulte Actualizar horas planificadas para la tarea al administrar asignaciones de usuarios en Administrar asignaciones de usuarios en el Distribuidor de cargas de trabajo.
-
ADD_TO_CUSTOM_FORMS
Un usuario con un nivel de acceso que incluya este permiso puede agregar campos a los formularios personalizados.
Para obtener más información, consulte Crear o editar un formulario personalizado.
-
EDIT_SYSTEMWIDE
Un usuario con un nivel de acceso que incluya este permiso puede compartir un campo personalizado en todo el sistema con acceso de eliminación.
-
PLANNED_HOURS_CONTOURING
-
ADD_TO_CUSTOM_FORMS
-
EDIT_SYSTEMWIDE
-
-
InformeProgramado
Un objeto ScheduledReport representa un informe que se ha configurado para que se programe su envío.
-
formato
Se agregaron valores posibles:
-
qdoc (enum.fileextension.qdoc)
-
qslide (enum.fileextension.qslide)
-
qsheet (enum.fileextension.qsheet)
-
ScoreCardQuestion
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.
-
displayType
Se ha agregado un posible valor ENRIQUECIDO (Campo de texto con formato)
Para obtener más información, consulte Campos de texto enriquecido en la API de Adobe Workfront.
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).
-
esfuerzoDeTrabajo
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 (Medium)
-
3 (Grande)
Para obtener más información sobre el esfuerzo de trabajo en Workfront, consulte Resumen del esfuerzo de trabajo.
-
Estas acciones agregaron el estado del argumento para admitir la nueva funcionalidad del botón Inicio, que cambia el estado de un elemento de trabajo cuando un usuario hace clic en el botón para indicar que ha comenzado a trabajar en el elemento.
Para obtener más información, vea Reemplazar el botón Trabajar en ello por un botón Iniciar.
-
acceptWork
-
unacceptWork
Equipo
Un objeto Team es una colección de usuarios que se pueden asignar a un elemento de trabajo.
Se agregaron los campos siguientes al recurso de equipo:
-
Id. de grupo
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, vea Reemplazar el botón Trabajar en ello por un botón Iniciar.
-
Se agregó el campo siguiente al recurso de equipo:
- grupo
TemplateTask
Un objeto TemplateTask representa un objeto Task que forma parte de un objeto Template. 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 una tarea de plantilla.
-
esfuerzoDeTrabajo
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 (Medium)
-
3 (Grande)
Para obtener más información sobre el esfuerzo de trabajo en Workfront, consulte Resumen del esfuerzo de trabajo.
-
Hoja de horas
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.
Para obtener más información sobre las hojas de horas, consulte Información general sobre hojas de horas
El campo siguiente se ha eliminado del recurso de plantilla de horas:
- código de objeto
Actualizar
-
updateType
Se agregaron los siguientes valores posibles:
-
initiativeAdd (enum.updatetype.initiativeadd)
-
initiativeEdit (enum.updatetype.initiativeedit)
Para obtener más información sobre las iniciativas, consulte Información general sobre iniciativas en el Scenario Planner.
-
Usuario
Un objeto User representa a una persona con una cuenta en Workfront que puede iniciar sesión e interactuar con el sistema.
Se agregaron 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 las Metas de Workfront. Los valores posibles son:
-
Sin acceso
-
Ver
-
Editar
-
Se ha añadido la siguiente acción al recurso de usuario:
-
getUserAccessPermissionsByObjCode
Esta acción emplea los argumentos siguientes
-
ids (cadena)
-
objCode (cadena)
-
Trabajo
Un objeto Work es una interfaz común que heredan Task y OpTask, y comparte código común entre ambos.
-
pedidoRegistroAtrasado
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
-
-
Id. de grupo
Este campo añadió los siguientes indicadores:
-
AUTO_LOAD,
-
DINÁMICO,
-
READ_ONLY
-
-
esfuerzoDeTrabajo
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 (Medium)
-
3 (Grande)
Para obtener más información sobre el esfuerzo de trabajo en Workfront, consulte Resumen del esfuerzo de trabajo.
-