APPEND FROM
 Importa registros de un fichero de base de datos (.DBF) o de un fichero ASCII de texto
------------------------------------------------------------------------------
 Sintaxis

     APPEND FROM <xcFichero>
        [FIELDS <idLista campos>]
        [<ámbito>] [WHILE <lCondición>] [FOR <lCondición>]
        [SDF | DELIMITED [WITH BLANK | <xcDelimitador>]|
        [VIA <xcControlador>]]

 Argumentos

     FROM <xcFichero> especifica el nombre del fichero fuente. Puede
     especificarse <xcFichero> como nombre en forma literal o como expresión
     de caracteres encerrada entre paréntesis. Si no se especifica la
     extensión de fichero, .dbf es el tipo de fichero de entrada por
     defecto. Si se especifica SDF o DELIMITED, se supone que la extensión
     de fichero es .txt si no se especifica lo contrario.

     FIELDS <idLista campos> especifica la lista de campos que se van a
     copiar de <xcFichero>. La opción por defecto es todos los campos.

     <ámbito> es la sección del fichero de base de datos fuente de la
     que se van a añadir los registros. NEXT <n> añade los <n> registros
     siguientes. RECORD <n> añade solamente el registro número <n> de
     <xcFichero>. El ámbito por defecto es todos los registros de
     <xcFichero>.

     WHILE <lCondición> especifica un grupo de registros que cumplen una
     condición, desde el registro actual del fichero fuente hasta que la
     condición deje de cumplirse.

     FOR <lCondición> especifica el grupo condicional de registros del
     ámbito dado que se van a añadir.

     SDF identifica ficheros ASCII en Formato de Datos del Sistema. Los
     registros y los campos tienen una longitud fija.

     DELIMITED identifica ficheros de texto ASCII en los que los campos
     de caracteres se encierran entre dobles comillas (delimitador por
     defecto). Recuerde que los delimitadores no son necesarios y que
     CA-Clipper puede añadir correctamente los campos que no estén
     delimitados. Los campos y los registros pueden tener una longitud
     variable.

     DELIMITED WITH BLANK identifica ficheros de texto ASCII en los que
     los campos se separan mediante un espacio y los campos de caracteres no
     se encierran entre delimitadores.

     DELIMITED WITH <xcDelimitador> identifica ficheros de texto ASCII
     en los que los campos de caracteres se encierran entre un delimitador
     especificado. <xcDelimitador> puede especificarse como un carácter
     literal o como una expresión de caracteres encerrada entre paréntesis.

     Consulte las tablas siguientes si desea más información sobre los
     requisitos de especificación de formato para los ficheros de texto
     ASCII que desee añadir con estos argumentos.

     VIA <xcControlador> especifica el controlador de bases de datos
     sustituible (RDD) que se va a utilizar para importar los datos
     deseados. <xcControladorx> es el nombre del RDD especificado como una
     expresión de caracteres. Si <cControlador> se especifica como un valor
     literal, debe ir entre comillas.

     Si se omite la cláusula VIA, APPEND FROM utiliza el controlador del
     área de trabajo actual. Si se especifica la cláusula VIA, debe enlazar
     a la aplicación los controladores de bases de datos apropiados mediante
     una sentencia REQUEST.

     ¡Advertencia! Si se especifica la cláusula DELIMITED WITH en un
     mandato COPY TO o APPEND FROM, debe ser la última cláusula
     especificada.

 Descripción

     APPEND FROM añade registros al fichero actual de base de datos, desde
     un fichero de texto ASCII u otro fichero de base de datos. Sólo se
     añaden los campos que tengan el mismo nombre y el mismo tipo. Es
     necesario que los campos del mismo nombre, tanto del fichero actual
     como de <xcFichero>, sean del mismo tipo de datos. En caso contrario,
     se produce un error de ejecución al invocar APPEND FROM.

     La información de fecha de <xcFichero> debe tener el formato aaaammdd
     para añadirse correctamente.

     En un entorno de red, APPEND FROM no requiere que el fichero actual de
     base de datos se utilice en modo exclusivo o se bloquee con FLOCK(). A
     medida que se añaden registros, CA-Clipper regula automáticamente los
     conflictos de utilización de los nuevos registros.

     Cuando se invoca APPEND FROM, CA-Clipper intenta abrir <xcFichero> en
     modo compartido y de sólo lectura. Si se deniega el acceso, APPEND FROM
     finaliza con un error de ejecución. Si desea más información, consulte
     el capítulo "Programación en Red" de la Guía de Programación y
     Utilidades. Si intenta abrir un fichero .dbf abierto, no se produce
     ningún error.

     La tabla siguiente muestra las especificaciones de formato para los
     ficheros de texto SDF.

     Especificaciones de Formato de Ficheros de Texto SDF
     ------------------------------------------------------------------------
     Elemento de Fichero           Formato
     ------------------------------------------------------------------------
     Campos de caracteres          Relleno con espacios en blanco finales
     Campos de fecha               aaaammdd
     Campos lógicos                T o F
     Campos memo                   Se ignora
     Campos numéricos              Relleno con espacios en blanco iniciales
                                   o con ceros
     Separador de campos           Ninguno
     Separador de registros        Retorno de carro/salto de línea
     Marcador de fin de fichero    1A hex o CHR(26)
     ------------------------------------------------------------------------

     La tabla siguiente muestra las especificaciones de formato para los
     ficheros de texto ASCII DELIMITED y DELIMITED WITH <xcDelimitador>.

     Especificaciones de Formato de Ficheros de Texto DELIMITED
     ------------------------------------------------------------------------
     Elemento de Fichero           Formato
     ------------------------------------------------------------------------
     Campos de caracteres          Pueden estar delimitados, truncándose
                                   los espacios en blanco finales
     Campos de fecha               aaaammdd
     Campos lógicos                T o F
     Campos memo                   Se ignora
     Campos numéricos              Los ceros iniciales pueden truncarse
     Separador de campos           Coma
     Separador de registros        Retorno de carro/salto de línea
     Marcador de fin de fichero    1A hex o CHR(26)
     ------------------------------------------------------------------------

     La tabla siguiente muestra las especificaciones de formato para los
     ficheros de texto ASCII DELIMITED WITH BLANK.

     Especificaciones de Formato de Ficheros de Texto DELIMITED WITH BLANK
     ------------------------------------------------------------------------
     Elemento de Fichero           Formato
     ------------------------------------------------------------------------
     Campos de caracteres          No están delimitados, los espacios en
                                   blanco finales pueden truncarse
     Campos de fecha               aaaammdd
     Campos lógicos                T o F
     Campos memo                   Se ignora
     Campos numéricos              Los ceros iniciales pueden truncarse
     Separador de campos           Un espacio en blanco
     Separador de registros        Retorno de carro/salto de línea
     Marcador de fin de fichero    1A hex o CHR(26)
     ------------------------------------------------------------------------

 Notas

     ■ Registros borrados: Si DELETED está desactivado, los registros
        borrados de <xcFichero> se añaden al fichero actual y conservan su
        estado de borrado. Si DELETED está activado, no se añaden los
        registros borrados de <xcFichero>.

     ■ Diferentes anchuras de campos: Si un campo del fichero actual es
        de tipo caracteres y tiene una longitud mayor que la de los datos
        procedentes de <xcFichero>, CA-Clipper añade espacios en blanco. Si
        el campo actual es de tipo de caracteres y su longitud es menor que
        la de los datos procedentes de <xcFichero>, los datos se truncan al
        ajustarlos. Si el campo actual es de tipo numérico y los datos
        procedentes de <xcFichero> tienen más cifras que la longitud de
        campo actual, se produce un error de ejecución.

 Ejemplos

      El ejemplo siguiente muestra un mandato APPEND FROM que
        utiliza una lista FIELDS y una condición FOR:

        USE Ventas NEW
        APPEND FROM FicheroSeccion FIELDS Seccion, Vendedor, Importe;
           FOR Seccion = 100

      El ejemplo siguiente muestra cómo puede especificarse un
        <ámbito> para importar un registro concreto desde otro fichero de
        base de datos:

        APPEND RECORD 5 FROM Temp

 Ficheros   La biblioteca asociada es CLIPPER.LIB.

 To download this example - click here.

See Also: COPY TO