Compartir a través de


Uso de la actividad Filter para filtrar elementos de una matriz

Puede usar una actividad de filtro en una canalización para aplicar una expresión de filtro a una matriz de entrada.

Requisitos previos

Para empezar, debe completar los siguientes requisitos previos:

Añadir una actividad Filtro a un pipeline con UI

Para usar una actividad de filtro en una canalización, complete los pasos siguientes:

Creación de la actividad

  1. Cree una canalización en el área de trabajo.

  2. Seleccione la pestaña Variables en el área de configuración de canalización y, a continuación, seleccione + Nuevo para agregar una nueva variable de canalización de tipo Matriz.

    Screenshot showing the creation of a new Array type pipeline variable called AnimalsArray with some animal names as its values.

  3. Busque Filtro en el panel Actividades de la canalización y selecciónelo para añadirlo al lienzo de la canalización. Es posible que tenga que expandir la lista completa de actividades seleccionando el + botón situado a la derecha de la barra de herramientas.

    Screenshot of the Fabric UI with the Activities pane and Lookup activity highlighted.

  4. Seleccione la nueva actividad Filtro en el lienzo si no está ya seleccionada.

    Screenshot showing the General settings tab of the Filter activity.

Consulte las instruccionesgenerales para configurar la pestaña de parámetros General.

Configuración de filtros

  1. Seleccione la pestaña Configuración, donde puede proporcionar una lista de matrices de elementos y una condición que se aplicará a cada elemento. Ambas configuraciones admiten contenido dinámico.

    Screenshot showing the Lookup activity settings tab highlighting the tab, and where to choose a new connection.

  2. En este ejemplo sencillo se filtra la matriz por perro, pero un uso real puede ser tan complejo como sea necesario, mediante cualquiera de las funciones y valores disponibles en el generador de expresiones dinámicas. Seleccione Agregar contenido dinámico para los elementos y, a continuación, seleccione la pestaña Variables en el Generador de expresiones de canalización y elija la instancia de AnimalsArray creada anteriormente. Después, seleccione Aceptar.

    Screenshot showing the Pipeline expression builder with the previously created AnimalsArray selected.

  3. Seleccione Agregar contenido dinámico de nuevo, esta vez para la configuración Condición. La expresión item() devuelve el valor del elemento actual, ya que la actividad Filter recorre en iteración la lista proporcionada de elementos de matriz. Con la función equals(), podemos compararla con el elemento para devolver true o false para cada elemento. Solo los elementos que devuelven true se incluirán en la matriz de salida de la actividad Filter, que luego se puede usar en cualquier otra actividad.

    Screenshot showing the Condition setting value to select for a specific animal.

Guardar y ejecutar o programar la canalización

Después de agregar actividades necesarias adicionales mediante la matriz de salida de la actividad Filter, cambie a la pestaña Inicio en la parte superior del editor de canalizaciones y seleccione el botón Guardar para guardar la canalización. Seleccione Ejecutar para ejecutarlo directamente o Planificar para programarlo. También puede ver el historial de ejecución aquí o configurar otras opciones.

Screenshot showing the Home tab in the pipeline editor with the tab name, Save, Run, and Schedule buttons highlighted.