es:Documentation ARexxAPI ADDRNEW

ADDRNEW

NOMBRE AddrNew -- Crear un nuevo contacto en la agenda. (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@example.com"
 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