DocumentaciónWorkfrontGuía de Workfront

Creación de filtros complejos de modo de texto mediante instrucciones EXISTS

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

Creado para:

  • Usuario
IMPORTANT
Este artículo requiere una comprensión exhaustiva de la API de Adobe Workfront y de la interfaz de informes del modo de texto. Para obtener información sobre la API de Workfront, consulte Conceptos básicos de API.
Para obtener información sobre el uso del modo de texto, consulte Introducción al modo de texto.

Información general sobre las relaciones de objetos en Workfront

Todos los objetos están vinculados a otros objetos de la base de datos de Workfront.

El conocimiento de la jerarquía y la interdependencia de los objetos ayuda a averiguar a qué objetos se puede hacer referencia en los informes.

Para obtener información sobre los objetos que están en Workfront y sobre su jerarquía e interdependencia, consulte Información general sobre objetos Adobe Workfront.

Al crear filtros, puede hacer referencia a otros objetos conectados al objeto del filtro en un máximo de 2 niveles de relación mediante la interfaz de sistema de informes estándar.

Por ejemplo, puede hacer referencia al ID de Portfolio en un filtro de problemas para mostrar solo los problemas de los proyectos asociados a un determinado portafolio mediante la interfaz estándar. En este caso, el portafolio está a 2 niveles de distancia de los problemas.

Sin embargo, no puede hacer referencia al Propietario del Portfolio en un filtro de problemas mediante la interfaz estándar para mostrar solo los problemas de los proyectos asociados a portafolios en los que el propietario sea un usuario específico. Debe utilizar el modo de texto para acceder al campo Nombre del propietario del Portfolio, que está a tres niveles de los problemas.

Problema con los iconos del propietario del portafolio

Para obtener una lista completa de los objetos de Workfront, consulte la Explorador de API.

Para obtener información sobre cómo navegar por el Explorador de API y buscar objetos, consulte Uso del Explorador de API.

Al crear filtros, debe crear instrucciones complejas en la interfaz de modo de texto para hacer referencia a estos tipos de objetos.

Para obtener información sobre la creación de filtros complejos, consulte la Información general sobre los filtros de modo de texto complejo que utilizan instrucciones EXISTS de este artículo.

Información general sobre los filtros de modo de texto complejo que utilizan instrucciones EXISTS overview-of-complex-text-mode-filters-that-use-exists-statements

Tenga en cuenta lo siguiente al crear filtros que abarquen varios niveles en la jerarquía de objetos o al filtrar los objetos que faltan:

  • Debe crear filtros complejos cuando desee hacer referencia a objetos que no están conectados directamente al objeto de filtro.

  • Debe utilizar una instrucción EXISTS para hacer lo siguiente:

    • Cree filtros que abarquen varios niveles.
    • Cree filtros que busquen los objetos que faltan.
      Por ejemplo, al crear un informe de usuario, puede filtrar por usuarios que no hayan registrado tiempo durante un período de tiempo determinado.

Tenga en cuenta las siguientes reglas al utilizar instrucciones EXISTS en un filtro:

  • Hay tres objetos a los que se puede hacer referencia en un filtro EXISTS:

    • El objeto del filtro (objeto original).
    • El objeto a cuyo campo desea hacer referencia (objeto de destino).
    • El objeto que conecta los objetos de destino y original, en caso de que no estén conectados directamente entre sí (objeto de vinculación).

  • Los filtros que utilizan EXISTS contienen dos instrucciones independientes vinculadas por un signo igual:

    • La instrucción antes del signo igual hace referencia al objeto al que se hace referencia (el objeto de vinculación o el objeto de destino).
    • La instrucción situada después del signo igual hace referencia al objeto desde el que hace referencia (el objeto original).

  • Debe utilizar el código de objeto del objeto de vinculación para conectar las instrucciones.
    Puede encontrar el código de objeto de todos los objetos en el Explorador de API.
    Para obtener información sobre el Explorador de API, consulte Explorador de API.

  • Cuando falta un objeto de vinculación porque los objetos original y de destino están conectados entre sí directamente, puede utilizar el código de objeto del objeto de destino en lugar del objeto de vinculación.

  • Puede hacer referencia a varios campos (campos de destino) en el mismo objeto (objeto de destino), en cuyo caso debe conectar las líneas que hacen referencia a los campos mediante AND.
    Para ver un ejemplo de filtrado para más de un campo que pertenece al objeto de destino, consulte la Ejemplo 4: Filtrar por varios campos: tareas por nombre de propietario del Portfolio e ID del cuadro de resultados de alineación del Portfolio de este artículo.

  • El único modificador admitido para una instrucción EXISTS es NOTEXISTS.

Requisitos de acceso

Expanda para ver los requisitos de acceso para la funcionalidad en este artículo.

Debe tener el siguiente acceso para realizar los pasos de este artículo:

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
plan de Adobe Workfront Cualquiera
Licencia de Adobe Workfront

Nuevo: estándar

O

Actual: plan
Configuraciones de nivel de acceso*

Editar acceso a filtros, vistas y agrupaciones

Editar el acceso a Informes, Paneles y Calendarios para editar filtros en un informe
Permisos de objeto

Administración de permisos de un informe para editar filtros en un informe

Administración de permisos de un filtro para editarlo

Para obtener más información sobre esta tabla, consulte Requisitos de acceso en la documentación de Workfront.

Crear filtros de modo de texto complejos que abarquen varios niveles en la jerarquía de objetos

Puede generar un filtro que haga referencia a objetos en varios niveles de la jerarquía de objetos en la que existe el objeto de filtro. Por ejemplo, puede crear un filtro de problemas para los problemas que se encuentran en proyectos que no están asociados a un determinado Propietario Portfolio.

Para crear este filtro, siempre debe utilizar una instrucción EXISTS y la interfaz de modo de texto.

Para ver ejemplos de filtros, consulte la Ejemplo 1: Filtrar problemas por nombre de propietario del Portfolio de este artículo.

Para crear un filtro que abarque varios niveles en la jerarquía de objetos:

  1. Identifique el objeto del filtro. Nos referimos a este objeto como el objeto original.
    Por ejemplo, Problema.

  2. Identifique el campo por el que desee filtrar. Nos referimos a este objeto como el Campo de destino que pertenece a un Objeto de destino.
    Por ejemplo, el campo ownerID (campo de destino), que pertenece a Portfolio (objeto de destino).

  3. (Condicional) Si el objeto original (Problema) y el campo de destino (ownerID) no están conectados directamente entre sí, debe encontrar un tercer objeto, un objeto de vinculación (Proyecto) que los conecte. El objeto de vinculación debe tener al menos un campo al que se haga referencia desde las pestañas Campos o Referencias del objeto original (Campo de vinculación mostrado en el objeto original), y también debe tener un campo de vinculación al objeto de destino mostrado en las pestañas Campos o Referencias del objeto de vinculación. El campo de vinculación al objeto de destino que se muestra en el objeto de vinculación (o el campo de vinculación que se muestra en el objeto de vinculación) debe coincidir con el campo de destino.

    Por ejemplo, se hace referencia a la ID de (proyecto) (campo de vinculación mostrado en el objeto original) desde Problemas (objeto original). (Portfolio) ownerID (Campo de vinculación al objeto de destino) se muestra en la pestaña Campos del proyecto (Objeto de vinculación). ownerID de Portfolio también es un campo en el objeto de destino (Portfolio). El campo de vinculación del objeto de vinculación coincide con el campo de destino.
    portfolio_id_in_the_project_api_object.PNG

  4. Mediante el Explorador de API, identifique el Código de objeto del objeto de vinculación (proyecto).
    Por ejemplo, el código de objeto de Project es PROJ.
    project_objCode_in_the_API.PNG

  5. Cree un filtro para el objeto original.
    Por ejemplo, cree un filtro de problema.
    Para obtener información sobre la creación de filtros, consulte Resumen de filtros.

  6. Clic Cambiar a modo de texto.

  7. Pegue el siguiente ejemplo de fórmula en la interfaz de modo de texto del nuevo filtro y reemplace el texto de ejemplo con los objetos y campos correctos:

    EXISTS:A:$$OBJCODE=<Object code of the Linking Object>

    EXISTS:A:<Linking Field on the Linking Object>=FIELD:<Linking Field displayed on the Original Object>

    EXISTS:A:<Target Object>:<Target Field>=<Your value for the Target Field>

    Para ver un ejemplo con los campos identificados anteriormente, consulte la Ejemplo 1: Filtrar problemas por nombre de propietario del Portfolio de este artículo.

  8. Haga clic en Guardar filtro.

Crear filtros de modo de texto complejos para objetos que faltan

Puede crear un filtro que haga referencia a los objetos que faltan. Por ejemplo, puede crear un filtro de usuario que muestre qué usuarios no han registrado horas en Workfront.

Siempre debe utilizar un EXISTE y la interfaz de modo de texto para crear este filtro.

Para ver ejemplos de filtros para objetos que faltan, consulte las siguientes secciones de este artículo:

Para crear un filtro que haga referencia a los objetos que faltan:

  1. Identifique el objeto del filtro. Nos referimos a este objeto como el objeto original.
    Por ejemplo, Parámetro o Campo personalizado.

  2. Identifique el campo por el que desee filtrar. Nos referimos a este objeto como el Campo de destino que pertenece a un Objeto de destino.
    Por ejemplo, el campo categoryID (Campo de destino), que pertenece a Categoría (Objeto de destino).

  3. Dado que el objeto original (Parámetro) y el campo de destino (categoryID) no están conectados directamente entre sí, debe encontrar un tercer objeto, un objeto de vinculación (un parámetro Category), que los conecte. El objeto de vinculación debe tener al menos un campo al que se haga referencia desde las pestañas Campos o Referencias del objeto original (Campo de vinculación mostrado en el objeto original), y también debe tener un campo de vinculación al objeto de destino mostrado en las pestañas Campos o Referencias del objeto de vinculación. El campo de vinculación al objeto de destino que se muestra en el objeto de vinculación (o el campo de vinculación que se muestra en el objeto de vinculación) debe coincidir con el campo de destino.

    Por ejemplo, se hace referencia al ID del parámetro Category (Campo de vinculación mostrado en el objeto original) desde Parameter (Objeto original). parameterID (Campo de vinculación al objeto de destino) se muestra en la pestaña Campos del parámetro de categoría (Objeto de vinculación). El campo de vinculación al objeto de destino que se muestra en el objeto de vinculación coincide con el campo de destino.

  4. Mediante el Explorador de API, identifique el Código de objeto del objeto de vinculación (parámetro Category).
    Por ejemplo, el código de objeto del parámetro Category es CTGYPA.
    category_parameter_objcode_in_api.PNG

  5. Cree un filtro para el objeto original.
    Por ejemplo, cree un filtro de Parámetro.
    Para obtener información sobre la creación de filtros, consulte Resumen de filtros.

  6. Clic Cambiar a modo de texto.

  7. (Condicional) Si está filtrando por objetos que faltan, pegue el siguiente ejemplo de fórmula en la interfaz de modo de texto del nuevo filtro y reemplace el texto de ejemplo por los objetos y campos correctos:

    EXISTS:A:$$OBJCODE=<Object code of the Linking Object>

    EXISTS:A:<Linking Field displayed on the Linking Object>=FIELD:<Linking Field displayed on the Original Object><br>EXISTS:A:$$EXISTSMOD=NOTEXISTS

    Para ver un ejemplo de creación de informes sobre campos personalizados que no están asociados con Forms personalizado, consulte la Ejemplo 2: Filtrar objetos que faltan: campos personalizados que no aparecen en ningún formulario personalizado de este artículo.

  8. Haga clic en Guardar filtro.

Ejemplos de filtros de modo de texto que abarcan varios niveles en la jerarquía de objetos

Utilice estos ejemplos para crear filtros de modo de texto con instrucciones EXISTS.

Ejemplo 1: Filtrar problemas por nombre de propietario del Portfolio example-1-filter-for-issues-by-portfolio-owner-name

Con la interfaz de modo de texto, puede crear un filtro para una lista de problemas a fin de mostrar solo los problemas que se encuentran en proyectos asociados con un portafolio cuyo propietario sea un usuario específico.

Para filtrar problemas por el nombre del propietario del Portfolio:

  1. Cree un filtro de problema.
    Para obtener información sobre la creación de filtros, consulte Resumen de filtros.

  2. Clic Cambiar a modo de texto.

  3. Consulte el siguiente código genérico:

    EXISTS:A:$$OBJCODE=<Object code of the Linking Object>

    EXISTS:A:<Linking Field on the Linking Object>=FIELD:<Linking Field displayed on the Original Object>

    EXISTS:A:<Target Object>:<Target Field>=<Your value for the Target Field>

  4. Pegue el siguiente código en la Definición de reglas de filtro para el informe área para reemplazar el código genérico anterior:

    EXISTS:A:$$OBJCODE=PROJ

    EXISTS:A:ID=FIELD:projectID

    EXISTS:A:portfolio:ownerID=4d94d7da001699b19edf50de15682221

    note note
    NOTE
    • El objeto original es el objeto del informe: Problema
    • El objeto de destino es Portfolio.
    • El objeto de vinculación es un proyecto.
    • El campo de destino y el campo de vinculación al objeto de destino al que se hace referencia desde el objeto de vinculación son ownerID.
    • El código de objeto del objeto de vinculación aquí es PROJ.
    • El campo de vinculación mostrado en el objeto original es projectID y el campo de vinculación es ID.

  5. Reemplace el valor del campo de destino (ownerID) en la última instrucción con un ID de usuario de su entorno.

  6. Haga clic en Guardar filtro.

Ejemplo 2: Filtrar objetos que faltan: campos personalizados que no aparecen en ningún formulario personalizado example-2-filter-for-missing-objects-custom-fields-that-do-not-appear-in-any-custom-forms

Con la interfaz de modo de texto, puede crear un filtro para ver los campos personalizados (parámetros) que no están asociados con Forms personalizado (categorías). Este filtro vincula los parámetros a categorías, que están conectadas a través de otro objeto, Parámetro de categoría. Dado que los dos campos no están conectados directamente entre sí y que está filtrando la información que falta, debe utilizar una instrucción EXISTS.

IMPORTANT
Un parámetro es un campo tal como existe en la biblioteca de campos a la que se hace referencia en un formulario personalizado. Un parámetro de categoría es la versión de un campo que aparece en un formulario específico. Por ejemplo, si el mismo campo aparece en 5 formularios, habrá 1 parámetro y 5 parámetros de categoría en la base de datos de Workfront.

Para filtrar por campos personalizados que no están asociados a un formulario personalizado:

  1. Cree un parámetro o un filtro de campo personalizado.
    Para obtener información sobre la creación de filtros, consulte Resumen de filtros.

  2. Clic Cambiar a modo de texto.

  3. Consulte el siguiente código genérico:

    EXISTS:A:$$OBJCODE=<Object code of the Linking Object>

    EXISTS:A:<Linking Field displayed on the Linking Object>=FIELD:<Linking Field displayed on the Original Object><br>EXISTS:A:$$EXISTSMOD=NOTEXISTS

  4. Pegue el siguiente código en la Definición de reglas de filtro para el informe área para reemplazar el código genérico anterior:

    EXISTS:A:$$OBJCODE=CTGYPA

    EXISTS:A:parameterID=FIELD:ID

    EXISTS:A:$$EXISTSMOD=NOTEXISTS

    note note
    NOTE
    • El objeto original es el objeto del informe: Parámetro.
    • El objeto de destino es Categoría.
    • El objeto de vinculación es un parámetro de categoría.
    • El código de objeto del objeto de vinculación es CTGYPA.
    • El campo de vinculación al objeto de destino es parameterID, ya que parameterID existe tanto en la tabla de objetos de vinculación como en la tabla de objetos de destino.
    • El campo de vinculación que se muestra en el objeto original es ID (del parámetro Category).

  5. Haga clic en Guardar filtro.

Ejemplo 3: Filtrar objetos que faltan: usuarios que no registraron el tiempo durante un período determinado example-3-filter-for-missing-objects-users-who-did-not-log-time-for-a-certain-period-of-time

Con la interfaz de modo de texto, puede crear un filtro para ver los usuarios que no registraron el tiempo durante un período de tiempo determinado. Este filtro vincula a los usuarios con las horas, que están conectadas entre sí directamente. Sin embargo, debe utilizar una instrucción EXISTS y la interfaz de modo de texto para poder filtrar la información que falta.

Para filtrar por usuarios que no registraron tiempo durante la semana pasada:

  1. Cree un filtro de usuario.
    Para obtener información sobre la creación de filtros, consulte Resumen de filtros.

  2. Clic Cambiar a modo de texto.

  3. Consulte el siguiente código genérico:

    EXISTS:A:$$OBJCODE=<Object code of the Linking Object>

    EXISTS:A:<Linking Field displayed on the Linking Object>=FIELD:<Linking Field displayed on the Original Object><br>EXISTS:A:$$EXISTSMOD=NOTEXISTS

  4. Pegue el siguiente código en la Definición de reglas de filtro para el informe área para reemplazar el código genérico anterior:

    EXISTS:A:$$OBJCODE=HOUR<br>EXISTS:A:ownerID=FIELD:ID<br>EXISTS:A:entryDate=$$TODAYb-1w<br>EXISTS:A:entryDate_Range=$$TODAYe-1w<br>EXISTS:A:entryDate_Mod=between<br>EXISTS:A:$$EXISTSMOD=NOTEXISTS

    note note
    NOTE
    • El objeto original es el objeto del informe: Usuario.
    • El objeto de destino es Hour.
    • No necesita un objeto de vinculación en este ejemplo porque los usuarios y las horas están conectados directamente en la base de datos de Workfront.
    • Como no hay ningún objeto de vinculación, debe utilizar el código de objeto del objeto de destino: HOUR.
    • El campo de vinculación al objeto de destino es ownerID (que se muestra en el objeto original; falta el objeto de vinculación).
    • El campo de vinculación que se muestra en el objeto original es ID (de la hora) (que se muestra en el objeto de destino; falta el objeto de vinculación).
    • El EXISTELa instrucción entryDate hace referencia a campos que definen el objeto de destino (Hora) y utiliza la misma sintaxis que en una instrucción de filtro normal. Esto garantiza que se muestren solo los usuarios que no registraron tiempo durante un período de tiempo específico, en este caso, la semana anterior.
    • El modificador NOTEXISTS indica que estamos buscando elementos (Horas) que no existen para el objeto del informe (Usuarios).

  5. Haga clic en Guardar filtro.

Ejemplo 4: Filtrar por varios campos: tareas por nombre de propietario del Portfolio e ID del cuadro de resultados de alineación del Portfolio example-4-filter-by-multiple-fields-tasks-by-portfolio-owner-name-and-portfolio-alignment-scorecard-id

Con la interfaz de modo de texto, puede generar un filtro que haga referencia a más de un campo en el objeto de destino. En este caso, las instrucciones de filtro que hacen referencia a los campos de destino deben estar conectadas mediante AND.

Por ejemplo, puede filtrar una lista de tareas para mostrar solo las tareas que cumplan los siguientes criterios:

  • Se encuentran en un proyecto asociado a un portafolio cuyo propietario es un usuario específico.
  • Se encuentran en un proyecto asociado a un portafolio cuyos proyectos no están asociados a un cuadro de resultados de alineación específico.

Para filtrar tareas por nombre de propietario del Portfolio e ID de cuadro de resultados de alineación del Portfolio:

  1. Cree un filtro de tareas.
    Para obtener información sobre la creación de filtros, consulte Resumen de filtros.

  2. Clic Cambiar a modo de texto.

  3. Pegue el siguiente código en la Definición de reglas de filtro para el informe área:

    EXISTS:A:$$OBJCODE=PROJ
    EXISTS:A:ID=FIELD:projectID
    EXISTS:A:portfolio:ownerID=4d80ce5200000528787d57807732a33f
    AND:A:EXISTS:A:$$EXISTSMOD=NOTEXISTS
    AND:A:EXISTS:A:$$OBJCODE=PROJ
    AND:A:EXISTS:A:ID=FIELD:projectID
    AND:A:EXISTS:A:portfolio:alignmentScoreCardID=4da387b00001cbc732bb259355c33dad

    note note
    NOTE
    • El objeto original es el objeto del filtro: Tarea.
    • El objeto de destino es Portfolio.
    • El primer campo de destino es ownerID.
    • El segundo campo de destino es la ID del cuadro de resultados de alineación.
    • El objeto de vinculación es un proyecto.
    • El código de objeto del objeto de vinculación es PROJ.
    • El campo de vinculación al objeto de destino es el ID (del Portfolio).
    • El campo de vinculación mostrado en el objeto original es projectID.
    • Reemplace ownerID por un ID de usuario de su entorno.

  4. Haga clic en Guardar filtro.

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