4D Internet Commands v16

Formato de los parámetros

Inicio

 
4D Internet Commands v16
Formato de los parámetros

Formato de los parámetros  


 

 

Las descripciones a continuación ofrecen detalles sobre el significado y el formato de los parámetros más utilizados en este manual.

ParámetroTipoDescripción
nomServidorCadenaNombre del servidor (Ej: "www.nombredelaempresa.com")
o Dirección IP (Ej: "204.118.90.2")
ip_EnteroLargoEntero largoReferencia de una dirección IP en forma de entero largo
direccionEmailTextoEj: "jsmith@4d.com"
listaDireccionesTextoEx: "jsmith@4d.com, jdupont@4d.fr" or
"jsmith@4d.com"+Char(13)+"jdupont@4d.fr"
rutaLocalTexto- Documento
Mac: "My Hard Drive:4DDB:SalesDB:Report"
Win: "C:\MyDrive\4DDB\SalesDB\Report.txt"
- Directorio
Mac: "My Hard Drive:CoolStuff:" (Note el ":" final)
Win: "C:\MyDrive\CoolStuff\"
rutaServidorText- Documento
"/usr/jsmith/reports/salesreport.txt"
- Directorio
"/usr/jsmith/reports/"(Note trailing "/")
tcp_IDEntero largoReferencia de una sesión TCP abierta
smtp_IDEntero largoReferencia de un nuevo mensaje
pop3_IDEntero largoReferencia de una sesión POP3 abierta
imap_IDEntero largoReferencia de una conexión IMAP abierta
ftp_IDEntero largoReferencia de una sesión FTP abierta
udp_IDEntero largoReferencia de una  sesión UDP
ResultadoEnteroCódigo de error

El parámetro nomServidor es el nombre o la dirección IP del servidor local (HostName), por ejemplo "dns.4d.com" o "204.118.90.2". Los nombres de servidores se convierten por medio de un sistema de nombres de dominio. Los nombres de dominios por defecto (primarios) y secundarios  normalmente se definen en el panel de control del driver TCP/IP instalado. Todo comando de Internet 4D necesita un nomServidor como parámetro aceptando su nombre ("www.4d.com") o su dirección IP ("204.118.90.2") . El formato "nombre" siempre es preferible, ya que protege a la aplicación de efectos nocivos debidos a los cambios de hardware en sitios remotos.

Los nombres de los servidores pueden resolverse vía los métodos descritos anteriormente aplicados a una dirección IP. Las fórmulas matemáticas pueden entonces aplicarse a las direcciones IP para convertirlas en enteros largor únicos. Los comandos NET_NameToAddr y NET_AddrToName   automatizan esta conversión. Este valor entero largo es designado como ip_EnteroLargo en esta documentación. Este valor sólo es utilizado en circunstancias especiales por los desarrolladores que establecen comunicación TCP directa. Algunos desarrolladores también prefieren almacenar el valor entero largo de un nombre de dominio para conservar el espacio en disco comparado con su cadena equivalente. Sin embargo, por razones de compatibilidad con IPV6, 4D no aconseja a los desarrolladores utilizar esta funcionalidad.

El parámetro direccionEmail es una especificación completa de correo electrónico en el formato "nombre_usuario@nombre_dominio". En este documento, direccionEmail se refiere a una sola dirección de correo electrónico. Todo parámetro 4D Internet Commands que pueda tomar más de una dirección especificará direccionEmail. Si un parámetro tiene direccionEmail como su único tipo, puede tomar una y sólo una dirección de correo electrónico. El formato de direccionEmail debe ser una referencia completa que contenga tanto el nombre de usuario y como el nombre de dominio:

  • "Felix Unger" <felix@pristine.com>
  • oscar@slobs.com (Oscar Madison)

El parámetro listaDirecciones contiene una o más direcciones electrónica en el formato de direccionEmail, separadas por coma o un retorno de carro. La delimitación por retorno de carro es útil para ofrecer a los usuarios un área de texto que permita introducir o pegar varias direcciones. Los siguientes tres ejemplos generan un valor $listaDirecciones valido:

 $AddressList:="jsmith@4d.com"
 $AddressList:="jsmith@4d.com,scott@4d.com,marcel@4d.fr"
 For($i;1;Size of array(aAddresses))
    $AddressList:=$AddressList+aAddresses{$i}+Char(13)
 End for
 

El parámetro rutaLocal indica la ubicación de un archivo o de un directorio en el ordenador del usuario (Mac o Windows).

En un Macintosh, los elementos al interior de  las carpetas están separados por los caracteres "dos puntos" (:). Por ejemplo, el  archivo "Mi informe" en la carpeta "Informes" en el disco duro "Mi disco duro" será como ruta de acceso "Mi disco duro:Informes:Mi informe". Una especificación de directorio en un Macintosh debe terminar con un carácter "dos puntos". Por ejemplo, si quiere poner un nuevo informe en la carpeta indicada anteriormente, debe pasar la cadena "Mi disco duro:Informes:". La decisión de hacer referencia a un nombre de archivo o de directorio está relacionada con el contexto del comando.

Bajo Windows, el principio utilizado es idéntico, a excepción de que una barra oblicua inversa "\" se utiliza en lugar de "dos puntos".

Nota: con el protocolo FTP, los nombres de los archivos manipulados por los comandos Internet de 4D tienen un tamaño limitado. Para mayor información consulte la sección (ver Transferencia de archivos, Presentación).

La rutaServidor es la ubicación de un archivo o de un directorio en un ordenador que funciona bajo el sistema operativo Unix. En el entorno Unix, los directorios están separados por barras oblicuas ("/"). Por ejemplo, el archivo "informe.txt" en el directorio "informes" del directorio "4D" será designado por "/4D/informes/informes.txt". La ruta de acceso de un directorio debe terminar con un carácter "/". Note que una ruta de acceso completa comienza por una barra oblicua "/" que representa la raíz del volumen.

Nota: con el protocolo FTP, los comandos Internet de 4D trabajan con archivos cuyos nombres tienen un tamaño limitado. Para más información, consulte la sección Transferencia de archivos, Presentación). 

A lo largo de cada sección de 4D Internet Commands, se hace referencia a un número "ID" en la mayoría de los comandos. Cada conjunto de funciones de comunicación establecerán su propia "sesión", representada por un número entero largo "ID". Los comandos posteriores relacionados con la sesión abierta usarán este valor para dirigir sus efectos por el canal adecuado.

Los números "ID" obtenidos en cada sección (SMTP, POP3, IMAP, FTP, TCP, UDP), no se pueden pasar como valores a las diferentes secciones. Sin embargo, para mayor flexibilidad, 4D Internet Commands le permite pasar una referencia de conexión POP3, IMAP o FTP directamente a comandos TCP de bajo nivel y viceversa. Para obtener más información, consulte la sección Rutinas de bajo nivel, Presentación.

Referencia de sesiónAbierta porCerrada por
tcp_IDTCP_Open or TCP_ListenTCP_Close
smtp_IDSMTP_NewSMTP_Clear
pop3_IDPOP3_LoginPOP3_Logout or POP3_VerifyID
imap_IDIMAP_LoginIMAP_Logout or IMAP_VerifyID
ftp_IDFTP_LoginFTP_Logout or FTP_VerifyID
udp_IDUDP_NewUDP_Delete

Todos los comandos de Internet  4D (con excepción de IT_ErrorText y IT_Version) devuelven un valor entero como resultado de la función. Este entero contiene todo número de error que el comando deba transmitir de nuevo a la base de datos 4D. Si un comando se ejecuta correctamente, se devuelve un cero. De lo contrario, se devuelve un código de error. Para obtener más información sobre los códigos de error de 4D Internet Commands, consulte Anexo C, Códigos de error de 4D Internet Commands.

 
PROPIEDADES 

Producto: 4D Internet Commands
Tema: Los comandos Internet de 4D

 
HISTORIA 

 
ARTICLE USAGE

4D Internet Commands ( 4D Internet Commands v16)