DocumentaciónWorkfrontGuía de Workfront

Novedades de la versión 12 de la API

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

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 breadcrumb

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 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 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 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 agregaron los siguientes valores posibles:

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

Campos directos

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

Campos directos

  • coreAction

    Se agregaron los siguientes valores posibles:

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

  • AGREGAR

AnuncioAdjunto 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, vea Enviar anuncios

Campos directos

  • fileExtension

    Se agregaron valores posibles:

    • qdoc (enum.fileextension.qdoc)

    • qslide (enum.fileextension.qslide)

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

Campos directos

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

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.

Campos directos

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 company

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.

Campos directos

  • groupID

    El ID del grupo con el que está asociada la compañía.

Campos de referencia

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

Un objeto Customer representa 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.

Preferencias del cliente customerpreferences

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

Campos directos

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

Un objeto Document 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, vea Cargar una nueva versión de un documento.

Campos directos

  • externalIntegrationType

    Se ha eliminado el valor posible:

    • QUIP (Quip)

  • decisiónDeRevisión

    Agregado

Acciones

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 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 Resumen del líder empresarial.

Acciones

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

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

  • 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:
Acciones

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 parameter

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.

Campos directos
Campos de colección

  • reglas de acceso

    Agregado

Campos predeterminados

  • etiqueta

    Agregado

Portafolio portfolio

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.

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.

Programar 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 enviar problemas al mismo.

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

Campos directos

InformeProgramado scheduledreport

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

Campos directos

  • formato

    Se agregaron valores posibles:

    • qdoc (enum.fileextension.qdoc)

    • qslide (enum.fileextension.qslide)

    • qsheet (enum.fileextension.qsheet)

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

Campos directos

Tarea task

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 directos

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

Acciones

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 team

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

Campos directos

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.

Campos de referencia

Se agregó el campo siguiente al recurso de equipo:

  • grupo

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

Campos directos

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

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

Campos principales

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

  • código de objeto

Actualizar

Campos directos

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

Acciones

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 work

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

Campos directos

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

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