wiki:es:Documentation/ARexxAPI/ADDRNEW

Version 1 (modified by AmigaPhil, 10 months ago) (diff)

--

ADDRNEW

NOMBRE

AddrNew -- Crear una nueva ficha en el listín. (V2.0)

PLANTILLA

VAR/K,STEM/K,TYPE,ALIAS,NAME,EMAIL

FUNCIÓN

Crea una nueva ficha en el listín de direcciones y la inserta debajo de la ficha actual. Si la ventana del listín no ha sido abierta todavía durante esta sesión, la nueva ficha se añadirá a continuación de la primera.

ENTRADAS

VAR/K - variable donde se almacenará el alias de la ficha resultante
STEM/K - nombre base usado para el STEM donde se almacenará el alias de la ficha resultante
TYPE - tipo de ficha, puede ser G (grupo), L (lista de distribución) o P (persona, el valor por omisión)
ALIAS - alias para la nueva ficha
NAME - nombre real para la nueva ficha
EMAIL - dirección electrónica para la nueva ficha

RESULTADOS

VAR - alias de la ficha resultante
<STEM>ALIAS - alias de la ficha resultante

NOTAS

Debe indicarse alguno de los parámetros ALIAS, NAME o EMAIL. Los tipos de ficha no válidos son simplemente ignorados.

Si el alias indicado ya existe, se usará otro distinto que se construirá tomando la cadena indicada y añadiéndole un número, hasta obtener un alias único. La limitación de tamaño para esta cadena se tendrá en cuenta automáticamente.

Si no se indica ningún alias, se creará uno automáticamente utilizando una versión reducida de los argumentos NAME o EMAIL; por ejemplo, "José Luis Feliciano" se convertiría en "J_Feliciano", mientras que "Jose" sería el resultado de indicar "Jose@…" como único parámetro. La regla mencionada arriba también se aplica en este caso.

Si la ventana del listín no está abierta en el momento en el que se añade la nueva ficha, la operación no será contabilizada como un cambio en el listín, con lo cual no recibirá aviso alguno si luego intenta salir de YAM sin grabar el listín en disco.

Si bien se admite usar espacios en los alias, esto es algo que se desaconseja hacer.

EJEMPLO

/* Crear un nuevo grupo */

ADDRNEW G 'Cantantes'

/* Crear una nueva lista de distribución */

ADDRNEW L 'Hispanos'

FALLOS

VÉASE TAMBIÉN

ADDREDIT ?