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.

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:

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 comandos Internet de 4D no permiten trabajar con archivos cuyo nombres tienen más de 31 carácteres (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.

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.