Collections Activities

Versión: 1.0.0  ·  ID: zoan-packages-collections  ·  Autor: Zoan Software

El paquete Collections crea y manipula los dos tipos de colección más usados: listas (secuencias de elementos) y diccionarios (pares clave→valor). Sirve para acumular resultados, llevar registros, agrupar datos relacionados o configurar opciones.

Antes de empezar

Conviene conocer estos dos tipos de datos: una lista es una secuencia ordenada (["Ana", "Luis"]); un diccionario asocia claves a valores ({ "ciudad": "Bogotá", "edad": 30 }). Los índices de lista empiezan en 0.

Actividad o expresión: las dos formas

Casi todo lo que hacen estas actividades tiene también un equivalente directo en una expresión. Por ejemplo:

Quieres…	Actividad	Equivalente en expresión
Contar elementos	List Count	= count(lista) o = lista.Count
Elemento por índice	Get List Item	= lista[0]
¿Contiene?	List Contains	= lista.Contains(valor)
Valor de una clave	Get Dictionary Value	= dictGet(d, "clave") o = d["clave"]
Agregar a lista	Add to List	= listAdd(lista, valor)

¿Cuál usar? Las actividades hacen el flujo más explícito y visual (útil para quien recién empieza). Las expresiones son más breves y cómodas cuando ya estás dentro de otra fórmula. Ambas son correctas — elige según prefieras claridad o concisión. Ver Expresiones › Colecciones.

El patrón outputVariable

Las actividades que devuelven un resultado (contar, obtener, comprobar) lo guardan en la variable que indiques en el campo outputVariable.

Actividades

Listas

Actividad	Tipo	Salida	Qué hace
Create List	list-create	List	Crea una lista vacía
Add to List	list-add	—	Agrega un elemento
Get List Item	list-get	object	Elemento por índice
List Count	list-count	int	Número de elementos
List Contains	list-contains	boolean	¿Contiene un elemento?
Remove from List	list-remove-at	—	Elimina por índice
Clear List	list-clear	—	Vacía la lista

Diccionarios

Actividad	Tipo	Salida	Qué hace
Create Dictionary	dict-create	Dictionary	Crea un diccionario vacío
Set Dictionary Value	dict-set	—	Asigna/actualiza una clave
Get Dictionary Value	dict-get	object	Valor de una clave
Dictionary Contains Key	dict-contains-key	boolean	¿Existe la clave?
Dictionary Count	dict-count	int	Número de pares
Get Dictionary Keys	dict-keys	List	Todas las claves
Remove Dictionary Key	dict-remove	—	Elimina una clave

Siguientes pasos

• Create List / Create Dictionary — crear una colección.
• Tipos de datos › Colecciones — sus propiedades y métodos.
• Expresiones › Colecciones — la alternativa en una sola línea.