Emails, respuestas pre-definidas y ayudas

• EscribirIconoEmail:Para poner el icono que al pinchar permita escribir un email
• EnviarMens: Enviar un mensaje (y eventualmente un email) a un usuario del sistema (alguien que esté en la tabla AGE).
• EnvioEmail: Enviar un correo electrónico tanto a un usuario del sistema como a cualquier persona fuera del mismo.
• Predefinido: Obtener el texto de un enlatado (texto pre-definido)
• Ayuda: Poner el icono de ayuda

EscribirIconoEmail

Esta función permite escribir una "variable a escribir " (que puede ser una dirección de email o cualquier otra variable), y si el usuario tiene autorización para enviar emails, añadir el icono de envio de emails. Si no lo tiene, sencillamente se escribe la "variable a escribir ", sin el icono.:

Ubicación

Disponible automáticamente desde programas invocados a través de versup.php, verextendido.php. También está disponible en:

rutinas/utilitiesasesor.php

Parámetros

La función no escribe el email, sino que devuelve el HTML con la dirección de email y todo lo necesario para invocar el programa de envios de email, siempre y cuando el usuario esté autorizado. Muy comunmente, "Valor" va a ser el mismo valor contenido en la variable "Escribir".

Ejemplo de invocación

$Icono=EscribirConIconoEmail("701PER",$row4[AR4EnlaceP],$Email,$NbePtoFocal);
.
.
.
<p class=nbecampo>Asesor $Icono</p>

Este ejemplo es el que produce la salida mostrada previamente. En la llamada, se está poniendo dentro de la variable Icono el HTML para escribir el nombre del Asesor, que en este ejemplo fue:

<p class=nbecampo>Asesor</p></td><td><p>
<form name='FormEmail1'
   method='POST' action='emailsup.htm'>
   <input type='hidden' name='TablasAListar' value='701PER'>
   <input type='hidden' name='NombreCampoEmail' value='PEREmail1'>
   <input type='hidden' name='CLAUSULAWHERE' value="WHERE PERCodigo='6'">
   <img border='0' src='imagenes/email.gif' 
   alt='Haga clic aquí para enviar un email'
   onClick='document.FormEmail1.submit();'>
   Busato, Andrés
</form></p>

Nótese que el número de registro es el 6, el campo $EmailContacto contiene la dirección de Email, de forma que si viene vacío, no se ponga el icono de envio. En el código producido, se llama al programa emailsup.htm que es el que permite escribir y enviar el email

Para enviar mensajes (e Emails) a usuarios del sistema

EnviarMens

Comunmente, es necesario enviar un mensaje interno a uno o varios usuarios del sistema (personas en la tabla AGE). Para poder lograr esto con más facilidad, existe la rutina "EnviarMens", la cual está en el archivo rutinas/utilitiesasesor.htm.

Esta función está en rutinas/utilitiesasesor.php, la cual es invocada automáticamente desde versup.php y verextendido.php. También está disponible desde los programas tipo "pre", "post" y "formula".

Esta función recibe los parámetros que se indican a continuación, y devuelve el valor 0 si hubo un problema y 1 si todo funcionó correctamente.

Parámetros

Ejemplo de invocación

$Resultado=EnviarMens($CookieAGENTE,$Receptores,$Asunto,
    $CHANGE_MATRIX,"",$MensajesError,"");
if ($Resultado==0)
  echo "<p class=mensajeerror>Error enviando mensaje:<br>$MensajesError</p>"
else
 echo "<p class=mensaje>Enviados mensajes a: $Notificados</p>";

En este ejemplo, podemos observar como se va a enviar un mensaje, desde el usuario $CookieAGENTE a los usuarios contenidos en la variable $Receptores. El Asunto del mensaje está contenido en la variable $Asunto, el texto en $CHANGE_MATRIX (que es una variable generada automáticamente por el programa rec.htm (ver capítulo 6.1). No se está solicitando el envío de email. Los posibles mensajes de error serán almacenados en la variabla $MensajesError y no se está utilizando la opción de "ECHO".

EnvioEmail

Es muy común el querer enviar un correo electrónico a uno o varios destinatarios para informales sobre la actualización de un registro en el sistema, o para enviar un mensaje de activación de cuenta de usuario. Para poder lograr esto con más facilidad, existe la rutina "EnvioEmail".

Esta función está en rutinas/utilitiesasesor.php, la cual es invocada automáticamente desde versup.php y verextendido.php. También está disponible desde los programas tipo "pre", "post" y "formula". Esta función recibe los parámetros que se indican a continuación:

Parámetros

Invocación desde versup.php,verextendido.php y los "pre", "post" y "formula"

EnvioEmail($NombreRemitente, $Emailemitente, $EmailDestino,$Asunto,$cuerpo);

Como se puede observar en el ejemplo anterior, no es necesario hacer ningún require a ningún programa, unicamente se invoca la función pasandole los parámetros necesarios.

Si se desea hacer uso de esta rutina desde un programa externo a versup, verextendido, un programa pre, post o formula, se puede proceder como lo explica el siguiente ejemplo:

Ubiquemos un panorama: supongamos que tenemos un programa en WIB desde donde queremos enviar un email, llamemoslo enviaremail.php, y este programa está ubicado en www.dominio.com/WIBempresaX/prg/. El directorio /WIBempresaX está al mismo nivel del directorio donde está instalado net2client, por ejemplo /sis.

 Para usar EnvioEmail en nuestro programa se deben seguir los siguientes pasos:

• Añadir un require del programa utilitiesasesor.php

require("../../sis/rutinas/utilitiesasesor.php");

• Agregar al código de la función donde va a ser llamado EnvioEmail, las variables globales $PP, $Nivel, $RutaPear.

global $PP,$Nivel,$RutaPear;
$Nivel="../";  //Función actual con respecto a sis
$RutaPear="../libext/PEAR"; //Directorio sis con respecto a EnvioEmail
/*Este código es un ejemplo general tomado de una función ya existente.

La distribución de directorio deben ser previstas para cada aplicación*/

• La variable $Nivel indica el nivel en que esta el programa o función actual que va hacer el llamado a EnvioEmail con respecto a sis. Indicara cuantos directorios habrá que retroceder para llegar a sis.
• $RutaPear Relaciona a la función EnvioEmail con respecto a sis. Esta nos indica cuanto tendremos que movernos a partir de sis para llegar a EnvioEmail

EnvioEmail($NombreRemitente, $Emailemitente, $EmailDestino,$Asunto,$cuerpo);

Para obtener un texto pre-definido (enlatado)

ObtenerPreDefinido

Rutina que recibe devuelve un texto. pre enlatado

Ubicación

Disponible automáticamente desde programas invocados a través de versup.php, verextendido.php. También está disponible en:

rutinas/utilitiesasesor.php

Parámetros

Requisitos:

Requiere que la BD esté abierta.

Ejemplos de invocación

$Texto=ObtenerPreDefinido("700","Email de Bienvenida",0);


$Texto=ObtenerPreDefinido("700","",25);

En el primer ejemplo se busca el texto pre-definido llamado "Email de Bienvenida", en cambio en el segundo se busca el texto pre-definido número 25.

Ayuda

Esta función, introduce el icono . Cuando el usuario pincha el icono, se abre una ventana con las ayudas indicadas en el parámetro.

Ubicación

Disponible automáticamente desde programas invocados a través de versup.php, verextendido.php, ya que está en utilities

Parámetros

Ejemplos de invocación

echo "<h1>Titulo".Ayuda(57,63)."</h1>";

Esta instrucción escribe el encabezado Titulo y al lado pone el icono de ayuda. Si es pinchado, abrirá una ventana con las ayudas 57 y 63

echo "<p>Para más detalles presione el icono siguiente".Ayuda(46)."</p>";

Esta instrucción escribe el encabezado Titulo y al lado pone el icono de ayuda. Si es pinchado, abrirá una ventana con las ayudas 57 y 63