PC SOFT

AYUDA EN LÍNEA
DE WINDEV, WEBDEV Y WINDEV MOBILE


Este contenido proviene de una traducción automática.. Haga clic aquí para ver la versión original en inglés.
  • Protocolos POP3 y SMTP
  • SMTP autenticado
  • Timeout
  • Creación de un perfil de Outlook Exchange
  • Perspectiva de bolsillo: Crear una cuenta
  • Gestión de correos electrónicos en modo asíncrono
  • Característica de aplicación requerida
  • Gmail: ¿Qué hacer si falla una conexión a Gmail (SMTP, IMAP, POP3) con un error de certificado?
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReportes y ConsultasCódigo de Usuario (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Código Navegador
WINDEV Mobile
AndroidWidget Android iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Otros
Procedimientos almacenados
Inicia una sesión para la gestión del correo electrónico según el modo de gestión seleccionado:
  • correos electrónicos gestionados mediante los protocolos POP3, SMTP o IMAP: EmailStartSession se utiliza para iniciar la sesión POP3, SMTP o IMAP.
  • WINDEVWEBDEV - Código ServidorWindows Mobile correos electrónicos gestionados a través del cliente MS Exchange o a través de Pocket Outlook: EmailStartSession se utiliza para iniciar la sesión de MS Exchange o Pocket Outlook. En este caso, el directorio actual se modifica automáticamente cuando se utiliza EmailStartSession.
Java Sólo se admiten las sesiones POP3 y SMTP.
Versiones 17 y posteriores
iPhone/iPad Esta función ahora está disponible para aplicaciones iPhone/iPad.
Nueva funcionalidad versión 17
iPhone/iPad Esta función ahora está disponible para aplicaciones iPhone/iPad.
iPhone/iPad Esta función ahora está disponible para aplicaciones iPhone/iPad.
Versiones 21 y posteriores
Universal Windows 10 App Esta función ahora está disponible en modo Universal Windows 10 App.
Nueva funcionalidad versión 21
Universal Windows 10 App Esta función ahora está disponible en modo Universal Windows 10 App.
Universal Windows 10 App Esta función ahora está disponible en modo Universal Windows 10 App.
Notas:
  • WINDEVWEBDEV - Código Servidor Para iniciar una sesión con el software de mensajería Lotus Notes, utilice EmailStartNotesSession.
  • WINDEVWEBDEV - Código Servidor Para iniciar una sesión con el software de mensajería Outlook, utilice EmailStartOutlookSession.
  • Para iniciar una sesión de lectura de mensajes de correo electrónico (sólo para el protocolo POP3), utilice EmailStartPOP3Session.
  • Para iniciar una sesión de envío de correos electrónicos (sólo protocolo SMTP), utilice EmailStartSMTPSession. Esta función también se puede utilizar para iniciar una sesión SMTP autenticada.
Versiones 22 y posteriores
Widget Android Esta función ahora está disponible en modo Android Widget.
Android Esta función ahora está disponible para aplicaciones Android.
Nueva funcionalidad versión 22
Widget Android Esta función ahora está disponible en modo Android Widget.
Android Esta función ahora está disponible para aplicaciones Android.
Widget Android Esta función ahora está disponible en modo Android Widget.
Android Esta función ahora está disponible para aplicaciones Android.
Ejemplo
// Send an email via the POP3 protocol
IF EmailStartSession(USER, PASSWORD, ...
"pop3.gmail.com", "smtp.gmail.com") = True THEN
UserName = USER
ELSE
UserName = ""
Error("Unable to establish the connection")
END
Sintaxis

Starting an email session (POP3, SMTP, IMAP, Notes or Outlook) Ocultar los detalles

<Result> = EmailStartSession(<Session>)
<Result>: Boolean
  • True si la sesión comenzaba,
  • en casoFalse contrario. La ErrorOcurrió variable se establece en True si se produce un error.
    Para conocer los detalles del error, utilice ErrorInfo el comando Mensaje de error constante.
<Session>: emailPOP3Session, emailSMTPSession, emailIMAPSession, emailNotesSession or emailOutlookSession variable
Nombre de la variable que contiene la descripción de los parámetros para conectarse al servidor de correo electrónico. Todas las propiedades de conexión se especifican en las propiedades de la variable. Para obtener más detalles, consulte:
  • Sesión emailPOP3Session variable: para iniciar una sesión hacia un servidor POP3 para leer los mensajes.
  • Sesión emailIMAPSession fluctuante: para iniciar una sesión hacia un servidor IMAP con el fin de leer los mensajes.
  • Sesión de emailSMTPSession variable: para iniciar una sesión hacia un servidor SMTP para enviar mensajes.
  • WINDEVWEBDEV - Código ServidorReportes y ConsultasAjaxCódigo de Usuario (UMC) emailNotesSesión fluctuante: para iniciar una sesión hacia un servidor de Lotus Domino con el fin de enviar manipular mensajes.
  • WINDEVWEBDEV - Código ServidorReportes y ConsultasWindows MobileAjaxCódigo de Usuario (UMC) emailOutlookSession variable: para iniciar una sesión hacia el software de mensajería Outlook.
Nota: Esta sintaxis se mantiene para la compatibilidad con versiones anteriores.. Se recomienda utilizar las emailOutlookSession variables o EmailStartOutlookSession.
WINDEVWEBDEV - Código ServidorReportes y ConsultasWindows MobileAjaxCódigo de Usuario (UMC)

Starting an email session via MS Exchange or Pocket Outlook Ocultar los detalles

<Result> = EmailStartSession(<Profile> [, <Asynchronous>])
<Result>: Integer
  • Identificador de la sesión de correo electrónico actual.
  • 0 (o False) si se ha producido un error. La ErrorOcurrió variable se establece en True. Para conocer los detalles del error, utilice ErrorInfo el comando Mensaje de error constante.
<Profile>: Character string (with quotes)
Identifica el perfil de conexión (véanse las Notas).
Si este parámetro corresponde a una cadena vacía ("""):
  • si se definen varios perfiles en el ordenador actual, EmailStartSession muestra una ventana que contiene todos los perfiles entre los cuales el usuario puede elegir su propio perfil.
  • si se define un único perfil en el ordenador actual, EmailStartSession selecciona automáticamente este perfil.
Windows Mobile Cuenta de usuario a utilizar. Si este parámetro contiene una cadena vacía (""), se utilizará la cuenta de usuario "ActiveSync".
<Asynchronous>: Optional constant or boolean
emailAsíncrono o TrueLos correos electrónicos enviados durante la sesión se iniciaron por EmailStartSession debe transmitirse en modo asíncrono (véanse las Notas).
emailSynchronous o False
(Valor predeterminado)
Los correos electrónicos enviados durante la sesión se iniciaron por EmailStartSession debe transmitirse en modo síncrono (véanse las Notas).
WINDEVWindows Mobile Este parámetro debe corresponder a emailSynchronous o False.
Nota: Esta sintaxis se mantiene para la compatibilidad con versiones anteriores.. Recomendamos que utilice las variables Sesión emailPOP3Session, Sesión de emailSMTPSession o EmailStartPOP3Session bien EmailStartSMTPSession.

Starting an email session by using the POP3 and SMTP protocols simultaneously Ocultar los detalles

<Result> = EmailStartSession(<User name> , <Password> , <Address of POP3 server> [, <Address of SMTP server> [, <Number of POP3 port> [, <Number of SMTP port> [, <Asynchronous>]]]])
<Result>: Boolean
  • True si la sesión comenzaba,
  • en casoFalse contrario. La ErrorOcurrió variable se establece en True si se produce un error. Para conocer los detalles del error, utilice ErrorInfo el comando Mensaje de error constante.
<User name>: Character string
Identifica al usuario. Este nombre es suministrado por el proveedor de servicios o por el administrador de la red.. Este nombre se utilizará para identificar la sesión de correo electrónico en las diferentes funciones de gestión de correo electrónico.
<Password>: Character string
Contraseña de usuario. Esta contraseña es proporcionada por el proveedor de servicios o por el administrador de la red.
<Address of POP3 server>: Character string
Dirección IP del servidor de correo electrónico (protocolo entrante). Esta dirección IP es proporcionada por el proveedor de servicio o por el administrador de red.. Esta dirección IP puede tener el siguiente formato:
  • Dirección IP en formato XXX.XXX.XXX.XXX.XXX (125.5.110.100 por ejemplo).
  • Dirección IP que contiene el nombre del servidor (pop3.freesbee.eu por ejemplo). Se recomienda esta sintaxis.
  • Dirección IP devuelta porNetIPAddress
<Address of SMTP server>: Optional character string
Dirección IP del servidor de correo electrónico (protocolo de salida). Esta dirección IP es proporcionada por el proveedor de servicio o por el administrador de red..
Esta dirección sólo se debe especificar si la cuenta POP3 y la cuenta SMTP no pasan por el mismo equipo.
<Number of POP3 port>: Optional integer
Identifica el puerto utilizado para el protocolo POP3 (110 por defecto).
<Number of SMTP port>: Optional integer
Identifica el puerto utilizado para el protocolo SMTP (25 por defecto).
<Asynchronous>: Optional constant or boolean
emailAsíncrono o TrueLos correos electrónicos enviados durante la sesión se iniciaron por EmailStartSession debe transmitirse en modo asíncrono (véanse las Notas).
emailSynchronous o False
(Valor predeterminado)
Los correos electrónicos enviados durante la sesión se iniciaron por EmailStartSession debe transmitirse en modo síncrono (véanse las Notas).
WINDEVWindows Mobile Este parámetro debe corresponder a emailSynchronous o False.
Observaciones

Protocolos POP3 y SMTP

Los diferentes parámetros pasados a EmailStartSession son suministrados por el Proveedor de Servicios de Internet o por el administrador de la red.
Se requiere una conexión a Internet para administrar los correos electrónicos. Pueden ocurrir varios casos:
  • El usuario está utilizando una conexión directa a Internet (cable o ADSL): no se requiere ninguna operación específica.
  • El usuario está utilizando un módem para conectarse a Internet: NetOpenRemoteAcceso remoto se utiliza para establecer la conexión a Internet.
De forma predeterminada, si sólo se especifica la dirección IP del servidor POP3, esta dirección será utilizada por el servidor de correo electrónico que utiliza el protocolo SMTP.. La dirección IP del protocolo SMTP sólo debe especificarse si la cuenta POP3 y la cuenta SMTP no utilizan el mismo equipo.

SMTP autenticado

La autenticación SMTP no puede ser realizada por EmailStartSession. Para iniciar una sesión POP3 y una sesión SMTP autenticada al mismo tiempo, debe utilizar ambos EmailStartPOP3Session y EmailStartSMTPSession.

Timeout

El timeout puede configurarse medianteEmailSetTimeOut
WINDEVWEBDEV - Código ServidorReportes y ConsultasWindowsAjaxCódigo de Usuario (UMC)

Creación de un perfil de Outlook Exchange

Para iniciar una nueva sesión de correo electrónico, se debe definir un "perfil".. Este "perfil" se define en la configuración de la conexión a Internet.
Para crear un perfil:
  1. Abra el panel de control.
  2. Haga doble clic en la opción "Correo electrónico".
  3. Haga clic en el botón "Mostrar los perfiles".
  4. En la ventana "Elegir un perfil", haga clic en el botón "Añadir".
  5. Dar un nombre al perfil. Este nombre se utilizará en los programas WINDEV.
  6. Seleccione "Añadir una nueva cuenta de correo electrónico".
  7. Seleccione el servicio "Microsoft Exchange Server".
  8. Introduzca el nombre del servidor Microsoft Exchange.
Windows Mobile

Perspectiva de bolsillo: Crear una cuenta

Para iniciar una nueva sesión de correo electrónico con Pocket Outlook, se debe definir una "cuenta".. Ver Gestión de correos electrónicos a través de CEMAPI para más detalles.
WEBDEV - Código ServidorAjax

Gestión de correos electrónicos en modo asíncrono

Las funciones de correo electrónico son funciones de bloqueo por defecto. Lo que significa que no se puede ejecutar ningún otro código durante su ejecución.. El programa se reanudará sólo cuando se hayan ejecutado las funciones de correo electrónico actuales.
WEBDEV le ofrece la posibilidad de gestionar los correos electrónicos en modo asíncrono. Este modo permite a sus sitios enviar correos electrónicos sin bloquear la ejecución de otros procesos.
Para utilizar el modo asíncrono, es necesario:
  1. Desactive la casilla "Deshabilitar el spooler de correo electrónico" en el administrador de WEBDEV (pestaña"Configuración").
  2. Habilite el modo asíncrono al iniciar la sesión SMTP (con EmailStartSMTPSession o sin EmailStartSession).
  3. Todos los correos electrónicos salientes serán transmitidos a un "spooler".. Los correos electrónicos se ponen en cola antes de ser enviados.
La ejecución de las funciones de correo electrónico ya no bloquea el resto del programa.. EmailStatus se utiliza para averiguar el estado del correo electrónico.
Nota: si el administrador de WEBDEV está cerrado, el spooler de correo electrónico se borra: los emails pendientes no se envían y se eliminan del spooler.
Si la opción "Desactivar el administrador de trabajos de impresión de correo electrónico" está seleccionada mientras los trabajos se encuentran en el administrador de trabajos de impresión, estos mensajes no se perderán.: el administrador sigue enviándolas pero el spooler no acepta ningún correo nuevo.
Atención: El modo asíncrono sólo se puede utilizar al iniciar una sesión en un servidor SMTP (EmailStartSMTPSession EmailStartSession). El modo asíncrono se ignora en todos los demás casos.
Versiones 21 y posteriores
Universal Windows 10 App

Característica de aplicación requerida

El uso de esta función desencadena la declaración de una característica de aplicación en el asistente para generar la aplicación.
Característica necesaria: Redes domésticas y profesionales
Esta característica permite a las aplicaciones utilizar accesos entrantes y salientes a las redes familiares y corporativas..
Nueva funcionalidad versión 21
Universal Windows 10 App

Característica de aplicación requerida

El uso de esta función desencadena la declaración de una característica de aplicación en el asistente para generar la aplicación.
Característica necesaria: Redes domésticas y profesionales
Esta característica permite a las aplicaciones utilizar accesos entrantes y salientes a las redes familiares y corporativas..
Universal Windows 10 App

Característica de aplicación requerida

El uso de esta función desencadena la declaración de una característica de aplicación en el asistente para generar la aplicación.
Característica necesaria: Redes domésticas y profesionales
Esta característica permite a las aplicaciones utilizar accesos entrantes y salientes a las redes familiares y corporativas..

Gmail: ¿Qué hacer si falla una conexión a Gmail (SMTP, IMAP, POP3) con un error de certificado?

Desde agosto de 2017, Google ha implantado un nuevo certificado: Autoridad de Internet de Google G3. Desafortunadamente, la API de Windows para la comprobación de certificados no valida este certificado.
Por lo tanto, el inicio de una sesión POP3, IMAP o SMTP puede fallar con el error "La cadena de certificado no fue emitida por una autoridad de confianza".
Para validar el certificado, basta con modificar el modo de gestión de los correos electrónicos. La función WLanguage EmailConfigure le permite cambiar este modo y dejar de utilizar la API de Windows que bloquea este certificado.. El siguiente código debe ser añadido antes de iniciar la sesión a través de EmailStartSession:
// Enable the multi-platform implementation
EmailConfigure(emailParameterMode, 1)
señalar: A partir de la versión 23 de la actualización 1, la llamada ya no EmailConfigure es necesaria.: WLanguage utiliza automáticamente el modo de gestión de los correos electrónicos adaptados a la sesión.
Componente : wd240com.dll
Versión mínima requerida
  • Versión 9
Esta página también está disponible para…
Comentarios
Haga clic en [Agregar] para publicar un comentario