wiki:es:Documentation/ARexxAPI/ADDRNEW

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

--

En otros idiomas:


ARexx API

    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 ?