APSDU Página 1 de 28

Mantenimiento de tablas de forma externa

(MPSDU)

Mantenimiento de tablas de forma externa

INDICE

1. INTRODUCCIÓN 2

2. ENTRANDO AL APSDU 2

3. OPCIONES DE LA BARRA DE MENU 3

4. ABRIENDO Y CERRANDO UNA TABLA 5

5. ESTRUCTURA DE ARCHIVOS (TABLAS) 7

6. POSICIÓN DE COLUMNAS Y ESTATUS 11

7. IMPORTACIÓN DE DATOS 12

8. UTILIDADES 15

9. ÍNDICES DE TABLAS 24

10. MANIPULACIÓN EXTERNA DE TABLAS 25

11. OPCIONES DE BÚSQUEDA 27

LSCA Lilian Robles Quevedo Febrero - 2008

 APSDU Página 2 de 28
Mantenimiento de tablas de forma externa

1. INTRODUCCION

Muchas veces, se requiere manipular las tablas sin necesidad de entrar en alguno de los
módulos de Protheus. Ya sea que se quiera modifican algunos datos de determinados campos, o
de corregir algunos datos erróneos, o simplemente proporcionar datos de ejemplo para probar
algunos reportes nuevos. O corregir la estructura de la tabla o eliminar la tabla en su totalidad.

Esta es la utilidad de este programa de Protheus llamado APSDU, que es independiente

de los módulos pero que interactúa mucho con la información de todas las tablas. Por eso es muy
importante, al momento de trabajar en esta sección, el no eliminar tablas o datos, porque el
funcionamiento del programa Protheus sería desastroso. Hay que tener mucho cuidado al estar
manipulando datos en este programa.

Cuando se genera una nueva tabla, automáticamente se generan dos campos: RECNO
(número del registro) y D_E_L_E_T_ (campo para marcar el registro como borrado, sin borrarlo.
Se usa el asterisco (*)). Estos campos son invisibles en el entorno Protheus y solo se pueden
visualizar al manipular la tabla en SQL.

Cada vez que se genera una tabla o se modifica, se actualizan TABLAS propias del SISTEMA
PROTHEUS, las cuales no podemos borrar; pero si es necesario manipularlas, hay que tener mucho
cuidado porque sin estas tablas, el sistema se corrompería y no trabajaría en forma adecuada:

* SX1 (SX1010), aquí se guardan todas las preguntas para un rango

* SX2 (SX2010), aquí se guardan cada de las tablas generados por el usuario (nombre y
parámetros)
* SX3 (SX3010), aquí se guardan todos los campos de cada una de las tablas generadas por el
usuario (nombre, claves, tamaño, tipo,…)
* SIX (SIX010), aquí se guardan cada uno de los índices de cada tabla generada por el usuario.
* SX5 (SX5010), aquí se guardan las tablas propias del sistema Protheus
* SX6 (SX5010), aquí se guardan los parámetros del sistema

Las tres primeras son de mucha importancia, porque podemos modificar o borrar las tablas
que se haya generado por nosotros. No basta con solo darle DROP a la tabla a eliminar, sino que
hay que eliminar sus campos, índices y características de la tabla al abrir cada una de estas: SX2,
SX3 Y SIX. Hay que tener mucho cuidado para no borrar o modificar una tabla diferente.

NOTA: El diseño de las pantallas y/o ventanas pueden variar según la versión en que se
este trabajando.

2. ENTRANDO AL APSDU o MPSDU

a) Tener ejecutado el Servidor Protheus

b) Acceder al sistema mediante el Remote Protheus, y en

pantalla desplegada, se escribirá APSDU en la opción
“Programa inicial”, y modificar en la opción “Entorno en el
servidor” el ambiente en el que se quiera trabajar.

LSCA Lilian Robles Quevedo Febrero - 2008

 APSDU Página 3 de 28
Mantenimiento de tablas de forma externa

C) Después se desplegará la pantalla de login de acceso. Aquí se escribe la palabra

“admin.” en la opción usuario y se presiona la tecla <OK>

Se desaparece la pantalla de login y queda la

pantalla vacía, lista para trabajar con las
tablas.

3. OPCIONES DE LA BARRA DE
MENÚ

Una vez ya estando en la pantalla anterior,

podemos encontrar las siguientes opciones y cada una tiene otras sub-opciones, que nos servirán
para realizar diferentes trabajos.

En esta opción, podremos abrir o cerrar

tablas, ver la estructura de una tabla abierta o
crear nuevas estructuras; es decir, generar una
nueva tabla con sus campos y características de
cada una.

Aquí, también podremos importar Tablas

desde otro lugar, ver el estatus que tiene la tabla
en ese momento, o simplemente conocer en que
posición de la tabla se encuentran algunos
campos.

Y si ya no deseamos manipular ninguna tabla, podemos cerrar

este sistema al seleccionar la opción SALIR.

Con esta opción, podremos manipular una tabla, siempre y cuando, hayamos entrado con
la opción de “Compartido”.

Entre las opciones que podremos realizar están:

LSCA Lilian Robles Quevedo Febrero - 2008

 APSDU Página 4 de 28
Mantenimiento de tablas de forma externa

* Eliminar una tabla (estructura y contenido),

* Eliminar contenido de una tabla,
* Copiar registros de una tabla a otra,
* Realizar filtros, consultas
* Realizar operaciones

Hay que tener cuidado en el manejo de estas utilerías, porque podremos eliminar toda una
tabla o algunos registros que afectaran a otras tablas que tengan relación.

Aquí podremos trabajar con los índices de la tabla que se tenga abierta:

Visualizar, crear, borrar, ordenarlos

Claro que tienes que tener una Tabla abierta, para poder utilizar estas
opciones.

Con ellas, podemos insertar nuevos registros, modificarlos o eliminarlos

en la tabla que se tenga abierta

Hay que tener mucho cuidado cuando se modifique o se borre, porque

estaríamos afectando a otras tablas.

Se tiene que contar con una tabla abierta para poder realizar una
búsqueda de un campo en especial.

4. ABRIENDO Y CERRANDO UNA TABLA

LSCA Lilian Robles Quevedo Febrero - 2008

 APSDU Página 5 de 28
Mantenimiento de tablas de forma externa

4.1 ABRIENDO TABLA

a) Para poder accesar al conjunto de tablas, tenemos que ir a la barra de menú y

seleccionar opción ARCHIVO / ABRIR (File/Open). Esta opción abre el conjunto de tablas
según en donde se hayan hecho:

** De la carpeta de datos
-
-

** Base de datos controlada por

-

** Diccionario de datos
-

** Se selecciona “Compartido” (Compartilhado), si las tablas seguirán en uso por los

módulos u otros usuarios y queremos modificarlas (altas, bajas, cambios).

** Se selecciona “Solamente lectura” (Somente lectura), si las tablas a revisar no

queremos modificarlas, solo inspeccionarlas. Los demás usuarios pueden seguir trabajando
con estas tablas.

Nota: Ambas opciones pueden estar seleccionadas o no estar seleccionadas.

Por lo general, usamos la opción TOP CONNECT. Una vez elegido, se presiona el botón
<OK> para continuar.

a.1) Si la opción elegida fue TOP

CONNECT, se desplegará otra pantalla para
confirmar la conexión (figura derecha):

En “Servidor” tiene archivo, porque se está

trabajando en el servidor directamente.
En “DBMS/Base de datos” se tiene
MSSQL/MAFHER, indicando el nombre del
conjunto de datos al que queremos accesar.

Presionamos el botón <OK> para continuar, y el

sistema indicará que estará

“accesando al conjunto de
tablas” indicado.

b) Se desplegará otra
pantalla (figura izquierda),
donde deberemos de
seleccionar la tabla a analizar o
modificar.
E

LSCA Lilian Robles Quevedo Febrero - 2008

 APSDU Página 6 de 28
Mantenimiento de tablas de forma externa

En esta parte, recorreremos la lista con los flechas de la barra de desplazamiento o, si nos
acordamos como se llama la tabla, en la opción BUSCAR tecleamos el nombre… Ejemplo:
SZT
Después presionamos el botón <OK>.

Si presionamos el botón <Anular>, el proceso de búsqueda de tabla termina y regresamos

a la pantalla principal.

c) Una vez elegida la tabla, se desplegará una pantalla como la siguiente, mostrando la
tabla el lado izquierdo con su lista de índices; y del lado derecho sus campos y registros

Estando aquí ya se puede manipular o solo leer la información, según la forma en que haya
entrado.

Nota: Es posible que observe registros sombrados en color gris, esto es debido a que
están marcados como DELETE, y los puede quitar definitivamente de la tabla si presiona la opción
PACK. Se detalla más adelante esta característica.

4.2 CERRANDO TABLA

Una vez que ya se haya terminado de manipular la

tabla (agregar mas registros, modificarlos, borrarlos, filtrar,
etc.), se debe de cerrar. Para ello, se va a la barra de
menú y se elige la opción ARCHIVO / CERRAR y se
desplegará una cuadro de diálogo confirmando que se va a
cerrar la tabla actual.

Presionamos la tecla <OK> o la palomita para

cerrar y regresar a la pantalla principal.
Si presionamos <Anular> o la X, la tabla sigue
abierta.

LSCA Lilian Robles Quevedo Febrero - 2008

 APSDU Página 7 de 28
Mantenimiento de tablas de forma externa

5. ESTRUCTURA DE ARCHIVOS (TABLAS)

Una base de datos almacena sus datos en tablas.

Una tabla es una estructura de datos que organiza los datos en columnas y filas; cada
columna es un campo (o atributo) y cada fila, un registro. La intersección de una columna
con una fila, contiene un dato específico, un solo valor.

Cada campo (columna) debe tener un nombre. El nombre del campo hace referencia a la
información que almacenará. Cada campo (columna) también debe definir el tipo de dato que
almacenará.

Como ejemplo, se muestra una tabla en forma gráfica (tabla usuarios):

nombre clave
Mario Perez Marito
Maria Garcia Mary
Diego Rodriguez z8080

Que contiene dos campos llamados: nombre y clave. Luego tenemos tres registros
almacenados en esta tabla, el primero almacena en el campo nombre el valor "Mario Perez" y en el
campo clave "Marito", y así sucesivamente con los otros dos registros.

Una estructura de datos es una forma de organizar un conjunto de datos elementales (un
dato elemental es la mínima información que se tiene en el sistema) con el objetivo de facilitar la
manipulación de estos datos como un todo o individualmente.

Una estructura de datos define la organización e interrelación de éstos y un conjunto de

operaciones que se pueden realizar sobre ellos. Las operaciones básicas son:

 Alta, adicionar un nuevo valor a la estructura.

 Baja, borrar un valor de la estructura.
 Búsqueda, encontrar un determinado valor en la estructura para realizar una operación con
este valor, en forma SECUENCIAL o BINARIO (siempre y cuando los datos estén
ordenados)...

Otras operaciones que se pueden realizar son:

 Ordenamiento, de los elementos pertenecientes a la estructura.

 Apareo, dadas dos estructuras originar una nueva ordenada y que contenga a las
apareadas.

Entre los tipos de datos que puede tomar un campo está el tipo Carácter, el numérico (del
tipo entero), fecha (de longitud de 8 en formato YYYYMMDD), lógico (solo acepta .T. ó .F.), y el
memo

LSCA Lilian Robles Quevedo Febrero - 2008

 APSDU Página 8 de 28
Mantenimiento de tablas de forma externa

Ejemplo:
Supongamos que una persona de una abarrotera desea tener una AGENDA DE CLIENTES, y la
información que desea conservar son: Nombre, dirección, teléfono, e-mail y la fecha de contacto
(fecha desde que es cliente).

La estructura quedaría algo parecido a esto:

Tabla_Clientes
Nombre de Campo Tipo de Dato Tamaño Descripción
Nom Carácter 25 Nombre del cliente
Dir Carácter 30 Dirección del cliente
Tel Numérico 18 Número telefónico
Email Carácter 20 Correo electrónico
F_Con Fecha 8 Fecha de contacto

Y como sería complicado para la persona recordar el nombre completo de cada cliente, se la
añade un campo_clave, que será el que controle los datos y que no haya registros DUPLICADOS.
Ahora el diseño de la tabla quedó terminada:

Tabla clientes
Nombre de Campo Tipo de Dato Tamaño Descripción
Id_cli Carácter 5 Clave del cliente
Nom Carácter 25 Nombre del cliente
Dir Carácter 30 Dirección del cliente
Tel Numérico 18 Número telefónico
Email Carácter 20 Correo electrónico
F_Con Fecha 8 Fecha de contacto

5.1 CREAR NUEVA ESTRUCTURA

a) Seleccionamos de la barra de menú la opción ARCHIVO / NUEVA ESTRUCTURA

(FILE / NEW STRUCTURE), y es aquí donde el usuario va a crear una nueva tabla vacía a partir de
la estructura que el usuario haya definido previamente.

b) En la pantalla que se despliega, se debe de proporcionar el nombre de la TABLA y a que

servidor de Base de Datos será asignada:

Nombre del Servidor

de Base de Datos

Nombre de tabla

LSCA Lilian Robles Quevedo Febrero - 2008

 APSDU Página 9 de 28
Mantenimiento de tablas de forma externa

NOTA:
El nombre de la tabla que se vaya a generar, debe de empezar con los prefijos ZZ o SZ,
mas un letra o un número. Generalmente el nombre de la tabla no debe de ser mayor a
3 caracteres.

Ejemplo: SZP --- Películas

c) Creación de los campos

Aceptar
c.1) Presionamos el icono o botón “INCLUIR” y se
desplegará una segunda pantalla donde proporcionaremos cada uno de los Anular
campos de la tabla:
Incluir

c.2) Nombre del campo: Editar

En “Field Name“ (Nombre de
campo) se escribe el nombre del Borrar
campo, siempre antecedido por los tres
prefijos de la tabla y separado por un guión bajo.

Ejemplo: SZP_CVE

c.3) Tipo de Dato

En “Type” o Tipo eliges, del combo,
de que tipo va a hacer el campo

c.4) Tamaño del campo

En “Size” o Tamaño, se escribe la longitud que va a tener el campo

c.5) Numero de cifras decimales

En “Decimal” se pone cuantos decimales va a tener, siempre y cuando el tipo de dato haya
sigo numérico.

c.6) Agregar el campo a la tabla

Se presiona el botón <OK> o para terminar de agregarlo.

NOTA:
 Si se presiona el botón <Anular> o , no se guardará el nuevo campo y se
regresará a la pantalla de la tabla.
 Para agregar más campos, se siguen los mismos pasos de la c.1) a la c.6)

d) Edición de los campos

Si hay que modificar las características de alguno de los campos, se debe de realizar lo
siguiente:

LSCA Lilian Robles Quevedo Febrero - 2008

 APSDU Página 10 de 28
Mantenimiento de tablas de forma externa

d.1) Elegir el campo de la lista

d.2) Presionar el botón “Editar” o
d.3) Realizar los cambios en la pantalla que se despliegue
d.4) Presionar el botón <OK> para guardar los campos.

NOTA:
* Se siguen los mismos pasos para modificar o editar cada campo.

e) Borrado de los campos

Si hay que quitar uno de los campos, se debe de realizar lo siguiente:
d.1) Elegir el campo de la lista

d.2) Presionar el botón “Borrar” o

d.3) Aceptar que eliminas el campo presionando el botón <OK>

NOTA:
* Se siguen los mismos pasos para borrar cada campo.

NOTA DE INTERÉS:
o Si terminaste de crear la tabla y presionaste <OK>, y después te diste cuenta que
un campo esta mal definido,… tienes que hacer los cambios desde el
CONFIGURADOR / BASE DE DATOS /DICCIONARIO / BASE DE DATOS, siempre y
cuando la tabla se encuentra en la lista.
o Si en el CONFIGURADOR NO APARECE, entonces se tiene que borrar la tabla
creada desde APSDU.
o Se recomienda que la CRECIÓN DE TABLAS y CAMPOS se haga desde el
“Configurador”, ya que esta más seguro y tiene validaciones.

5.2 VISUALIZAR ESTRUCTURA

De la barra de menú se elige la opción ARCHIVO / ESTRUCTURA (FILE / STRUCTURE) para

visualizar la estructura de la tabla actual, y se desplegará una pantalla como la siguiente:

En esta ventana no podremos

modificar ninguno de sus campos, solo
observaremos como está constituido
cada campo, y si en la ventana no se
despliegan todos los campos, podemos
utilizar las barras de desplazamiento.

P a r a c e r r a r l

LSCA Lilian Robles Quevedo Febrero - 2008

 APSDU Página 11 de 28
Mantenimiento de tablas de forma externa

6 POSICION DE COLUMNAS Y ESTATUS

6.1 POSICIÓN DE COLUMNAS

Edita la lista de campos de la tabla actual para

establecer si se visualizan y en que orden. Por
default, se visualizan en la columna “ACTIVO”
todos los campos de la tabla en el orden que
fueron creados.

Para utilizar esta opción, de la barra de

menú se elige ARCHIVO / POSICIÓN DE LOS
CAMPOS (FILE / FIELD POSITION), y se despliega
la siguiente pantalla:

NOTA: Si todos los botones están deshabilitados, da un clic derecho sobre la columna
“Activo”, para que se habiliten los botones permitidos.

Los campos se pueden reordenar utilizando los botones:

<Remove> o <borrar> para mover uno por uno, hacia la columna “Disable” o
“Deshabilitado”.

<Remove all> o <Borrar todos> para mover todos a la vez a la columna

“Deshabilitado”.

<Up> o <Arriba>, para mover el campo seleccionado hacia arriba de los otros campos.
Un espacio a la vez.

<Down> o <Abajo>, para mover el campo seleccionado un lugar abajo.

<OK> para aceptar los cambios realizados

<Cancel> o <Anular> para deshacer los cambios hechos y cerrar la ventana sin que se
guarden.

NOTA: Si los campos están en la columna “Deshabilitado”, se activaran los

botones <Add> o <Agregar> y <Add All> o <Agregar todos>, cuando le des un clic con el
Mouse en esta columna. El primer botón, pasa el campo seleccionado hacia la columna “Activo” y
el segundo, pasa todos los campos.

Presionas el botón <OK>, para aceptar los cambios, y regresarás a la pantalla principal
donde tienes la tabla abierta.

LSCA Lilian Robles Quevedo Febrero - 2008

 APSDU Página 12 de 28
Mantenimiento de tablas de forma externa

6.2 ESTATUS DE LA TABLA

Despliega información acerca de la tabla que se está visualizando.

Para utilizarlo, selecciona la opción de la

barra de menú: ARCHIVO / ESTATUS
(FILE / STATUS)

y se desplegará la pantalla que se

muestra del lado izquierdo, proporcionando
información importante sobre las
condiciones en la que se está trabajando la
tabla:

El nombre del archivo o tabla

El tipo de Servidor de Base de
Datos.
Si la tabla es compartida para otro
usuario o no
El numero de campos que contiene
Área de trabajo que está utilizando

Se cierra la ventana, presionando en la

“X“

7. IMPORTACION DE DATOS

Con esta opción se importa tablas desde otra tabla en la misma BD o externa en alguno de los
formatos que puede leer Protheus. Sustituye la tabla actual con la estructura de la tabla a
importar, también se borran los índices que hubiere.

a) De la barra de menú se elige la opción ARCHIVO / IMPORTAR (FILE / IMPORT), para que
se despliegue la siguiente pantalla:

b) Elección del Origen de Datos

En Rdd Origen se tiene que elegir el
rigen de donde va a provenir la tabla:

LSCA Lilian Robles Quevedo Febrero - 2008

 APSDU Página 13 de 28
Mantenimiento de tablas de forma externa

NOTA 1: La siguiente opción está disponible si

se elige como origen, cualquiera de los tipos de datos
que no sean Top Connect

En Informe el directorio, se indica la carpeta

en donde se encuentran las tablas; si no se supiera se
presiona el botón con tres puntos para que se
desplegara otra ventana con los directorios (carpetas) y
elegir el adecuado, después se presiona el botón
<Abrir> para cerrar esta segunda ventana.

Notan 2: Si el origen de datos es

Top Connect, se despliega una
pantalla como la que se muestra a la
izquierda, donde se indica:

** El Servidor,
** El Nombre de la Base de Datos,
** y el Puerto.
Las podemos modificar de acuerdo a
lo que se necesite. Para continuar,
se presiona el botón <Avanzar>

c) Elección de la o las tablas a importar

En esta pantalla, se tiene que elegir la o las tablas que se desean importar a otra base de
datos, para ello se da doble clic sobre el cuadrito gris que le antecede a la columna Driver, y se
presiona <Avanzar> para continuar.

LSCA Lilian Robles Quevedo Febrero - 2008

 APSDU Página 14 de 28
Mantenimiento de tablas de forma externa

d) Elección del Destino de Datos

En esta pantalla, se debe de elegir el tipo de datos en el cual vamos a realizar una copia del
Origen, por lo tanto, se tiene que elegir en Rdd Destino. Las pantallas cambiarán, dependiendo
del tipo de Datos a elegir (observar notas 1 y 2, en el paso “b”), y después se presionará
<Finalizar> para terminar el proceso y que las tablas queden hechas en el directorio destino.

Nota
3:

*
Cuando ya existe una tabla con el mismo nombre pregunta la
acción a tomar: (Sobrescribir, Saltar, Para todos), se elige una
de ellas y se presiona <Ok>, si no se está seguro, presionar
<Anular>

* En caso de que se lleguen a corromper los índices, se necesita regenerar los índices y para ello
se tiene que:
- 1. Copiar la tabla
- 2. Hacer ZAP
- 3. y Efectuar APPEND FROM
(Ver la sección de Utilidades par mayores referencias)

8. UTILIDADES o UTILITARIO

Esta opción de la barra de menú, cuenta con diferentes herramientas para manipular las
tablas: Borrar, copiar, eliminar registros,… el manejo correcto de las mismas evitará problemas

LSCA Lilian Robles Quevedo Febrero - 2008

 APSDU Página 15 de 28
Mantenimiento de tablas de forma externa

serios en Protheus como: pérdida de información, colapsos de acceso en algunos de los

módulos, entre otros.

NOTA:
+ Para trabajar con estas utilerías es necesario que ya tenga una tabla abierta.
+ De la barra de menú, seleccionar UTILITARIO y la opción a utilizar…

8.1 (COPY TO)

Copia una tabla hacia otra nueva. Se puede copiar de un formato a otro, y además se pueden
realizar criterios de selección de registros
8.1.1) Tener abierta la tabla deseada
8.1.2) De la barra de menú seleccionar
Utilitario / Copiar para y se despliega la
pantalla que se muestra a la izquierda, donde:

8.1.3) En (Camino) Archivo, Se indica el

nombre de la NUEVA tabla y en que directorio se a
guardar.

8.1.4) En Driver, se indica de que tipo es la

NUEVA tabla.

8.1.5) En Para o Mientras se indica alguna

condición para que también se copien solo los
registros que la cumplan.

Nota: Se presiona el botón para que se abra la pantalla “Constructor de texto” para
indicar estas condiciones:

Cuando se abre la pantalla de FILTRO o “Constructor de texto”, se puede seleccionar el

CAMPO de la tabla, el OPERADOR (igual,
diferente de, menor que,…) y escribir el
TEXTO de comparación ( ‘125’ o ‘38080’ o
‘Narciso Mendoza’, etc.) y presionar el botón
<Agregar> para que aparezca en la sección
de Filtro, la primera condición.

Podemos también utilizar los paréntesis

, como los operadores , para
separar las condiciones.

++ Podemos quitar los filtros ya registrados, al seleccionarlos de la pantalla “Filtro” y

presionar el botón <Limpiar Filtro>, después solo presionamos el botón <Agregar>.

LSCA Lilian Robles Quevedo Febrero - 2008

 APSDU Página 16 de 28
Mantenimiento de tablas de forma externa

++ Podemos modificar el texto de nuestra condición si seleccionamos la condición

deseada en la pantalla “Filtro” y presionamos el botón <Texto>, después solo presionamos el
botón <Agregar>

Una vez terminada nuestra condición o filtro, presionamos el botón <OK> para salir y
regresar a la pantalla anterior. Si no deseamos registrar ningún filtro, presionamos el botón
<Anular>

8.1.6) En Opciones, generalmente se

deja TODOS, para que se copien todos
los registros.

8.1.7) Para aceptar que se haga la

copia, se presiona el botón <OK> y se
mostrará una pantalla indicando el
proceso de copiado.

8.2)

(Copiar
Registros desde)

Agrega registros desde otra tabla. Solo copia los campos que tienen los mismos nombres.
Si hay campos con nombres iguales pero de tipos diferentes causa errores. Opcionalmente se
pueden usar filtros de registros. Las tablas a leer pueden provenir de diversos formatos.

8.2.1 ) De la barra de menú seleccionar Utilitario / Append From para que se

despliegue la pantalla siguiente:

El proceso de
funcionamiento es muy similar al
de “Copiar para”, ya que las
ventanas son las mismas. La
diferencia es que no copia la
estructura de la tabla, solo los
registros de una tabla a la otra.
La información se agrega
al final de los registros existentes,
si se hace doble APPEND FROM de
la misma tabla, se agrega la
información dos veces.

8.3) (ELIMINAR REGISTROS BORRADOS)

Elimina físicamente de la tabla los registros marcados como borrados.

LSCA Lilian Robles Quevedo Febrero - 2008

 APSDU Página 17 de 28
Mantenimiento de tablas de forma externa

8.3.1) De la barra de menú

seleccionar Utilitario / Pack y se
desplegará el cuadro diálogo
preguntando si procede a realizar el
proceso.

8.3.2) Se presiona el botón

<Ok> para eliminar los registros, o
<Anular> si no estamos seguros.

8.4) (ELIMINAR TODOS LOS REGISTROS)

Elimina físicamente todos los registros de la tabla, sin eliminar la tabla ni sus índices. Deja
íntegra la estructura de la tabla.

8.4.1) De la barra de menú

seleccionar Utilitario / Zap, y se
desplegará el cuadro de diálogo
preguntando si procede a eliminar
todos los registro de la tabla activa
(abierta) o no.

8.5) (ELIMINAR TOTALMENTE LA TABLA)

Elimina la tabla abierta junto con sus registros y sus índices correspondientes de la BD.

9.5.1) De la barra de menú seleccionar Utilitario /

Drop Table y se desplegará el cuadro de diálogo
confirmando si en verdad se desea eliminar por completo la
tabla abierta.

NOTA: Se tiene que tener mucho cuidado con esta

utilería, ya que se perderían totalmente los registros.

8.6) (DESMARCAR REGISTROS BORRADOS)

Recupera registros marcados como borrados. Se pueden establecer criterios para

desmarcar registros previamente eliminados.

8.6.1) De la barra de menú seleccionar Utilitario / Recall, y se

desplegará una pantalla en donde se puede condicionar el desmarque de registros
LSCA Lilian Robles Quevedo Febrero - 2008
 APSDU Página 18 de 28
Mantenimiento de tablas de forma externa

borrados para que vuelvan a estar activos. Es una forma de recuperarlos antes de
eliminarlos físicamente de la tabla.

8.7) (BORRAR REGISTROS)

Borrar uno o un grupo de registros, es decir, los marca como borrados. Es lo que se llama
un borrado lógico dentro de una tabla. Protheus no borra registros físicamente, solo lo marca con
un ASTERISCO (*) en un campo llamado D_E_L_E_T_

8.7.1) De la barra de menú

seleccionar Utilitario / Delete, para que
se despliegue el cuadro de diálogo en
donde podremos poner alguna condición
de marcado. Después se presiona <OK>
para iniciar el proceso o <Anular> para
cancelar proceso.

8.8) (FILTRAR REGISTROS)

Filtra registros a mostrar a partir de una serie de criterios dados.

8.8.1) De la barra de
menú seleccionar Utilitario /
Filtrar, y se desplegará una
pantalla como la siguiente:

 Si se hace un filtro y después se copia la

tabla, solo copia la información filtrada.

LSCA Lilian Robles Quevedo Febrero - 2008

 APSDU Página 19 de 28
Mantenimiento de tablas de forma externa

La opción limpiar filtro reestablece la visualización de todos los registros.

NOTA:
Funciona de la misma manera que lo indicado en las utilerías de COPIAR PARA o
APPEND FROM

8.9) (MODIFICAR CONTENIDO DE CAMPO)

Remplaza la información de campos.

8.9.1) De la barra de menú seleccionar Utilitario / REPLACE

8.9.2) Seleccionar el campo a actualizar en Field o Campo,
8.9.3) Definir el valor de reemplazo y escribirlo en With o Con
8.9.4) y opcionalmente, definir los criterios de inclusión/omisión en While o For:

NOTA:
Si el campo es carácter definir el valor en WITH (CON) entre comillas dobles; si es
numérico va sin comillas; y si es fecha se deben usar las funciones de manejo de fechas:
CTOD()

A excepción de tablas DBF, los campos de fecha se guardan en las tablas (RDBMS) como
[Link] un campo tipo fechas se requiere usar en una expresión de índice, se debe usar la
función para convertir a cadena DTOS(campo fecha)

Si presionamos el botón
se desplegará una pantalla como la que

LSCA Lilian Robles Quevedo Febrero - 2008

 APSDU Página 20 de 28
Mantenimiento de tablas de forma externa

se muestra a la derecha; en el cual se puede realizar la expresión para la condición PARA (FOR) o
MIENTRAS (WHILE).

8.9.5) Presionar el botón <OK> para terminar y que se haga el reemplazo

correspondiente.

8.10) (CONTAR TOTAL DE REGISTROS)

Obtiene el total de registros, y opcionalmente se le puede condicionar.

8.10.1) De la barra de menú seleccionar Utilitario / CONTAR y se despliega un

cuadro de diálogo donde, podremos condicionar el conteo si así se requiere. Se presiona
<OK> para desplegar el total de registros.

Una vez terminado el proceso, se

despliega la información solicitada.

8.11) (SUMATORIA DE
CAMPOS)

Sumariza (suma) un campo y visualiza el total obtenido. Esta operación solo debe
efectuarse sobre campos numéricos.

8.11.1) De la barra de menú seleccionar Utilitario / SUMAR

8.11.2) Elegir el campo en la opción FIELD o CAMPO
8.11.3) En ALL u OPCIONES, generalmente se deja Todo
8.11.4) Se puede indicar alguna condición FOR o WHILE
8.11.5) Se presiona el botón <OK> para obtener el resultado.

LSCA Lilian Robles Quevedo Febrero - 2008

 APSDU Página 21 de 28
Mantenimiento de tablas de forma externa

8.12) (MOSTRAR REGISTROS BORRADOS/NO BORRADOS)

Sólo muestra los registros que no están borrados.

8.12.1) De la barra de menú seleccionar Utilitario / SET DELETED

En esta pantalla, podemos elegir si deseamos ver los registros
** Borrados (Set Delete On)
** No Borrados (Set Delete Off)

8.12.2) Se presiona el botón <OK> para que se

muestra la lista

8.13) (BUSQUEDA POR INDICE ACTIVO)

Establece búsqueda de registros por medio del índice activo de la tabla a través de una
expresión parcial.
8.13.1) De la barra de menú seleccionar Utilitario / SET
SOFTSEEK
En esta pantalla, podemos elegir si
deseamos ver los registros
** usando el índice activo (Set Softseek On)
** no usar el índice activo (Set Softseek
Off)

8.12.2) Se presiona el botón <OK> para

que se muestre la lista

8.14) (ANALIZADOR DE CONSULTAS)

Esta opción solo está disponible en MP8. Se pueden hacer consultas a cualquier base
de datos controlada por el TopConnect.

LSCA Lilian Robles Quevedo Febrero - 2008

 APSDU Página 22 de 28
Mantenimiento de tablas de forma externa

8.13.1) De la barra de menú seleccionar Utilitario / QUERY ANALYZER

8.13.2) Se desplegará un
cuadro de diálogo de conexión
al Servidor de Base de Datos de
TOPConnect, en el Servidor
ARCHIVO , se presiona el botón
<OK> y pasar a la ventana de
TopConnect

En la ventana de consulta se pueden introducir las sentencias SQL como se codifican en un

programa AdvPL, con la opción “Change Query” activada, la sintaxis es validada y traducida si es
necesario a como la requiere el RDBMS correspondiente.

Nuevo…
Salir de
Conectarse Analizador
Desconectarse

Ejecutar Consulta o
Query
Abrir… Grabar… Área de trabajo

Ejemplo de una pequeña consulta:

** La primera ventana muestra una consulta de todos los campos de la tabla SA1010
** La segunda ventana muestra el listado de la consulta

LSCA Lilian Robles Quevedo Febrero - 2008

 APSDU Página 23 de 28
Mantenimiento de tablas de forma externa

9. INDICES DE TABLAS

En esta opción de la barra de menús (INDICE), se trabaja exclusivamente con los índices
de la tabla abierta.

9.1) ABRIR INDICE EXTERNO (OPEN)

Abre un índice externo de una tabla en DBF o Ctree.

Por default, todos los índices configurados de la tabla accesan
automáticamente.

Se desplegará una pantalla pidiendo el nombre del

índice, y se presiona <OK> para que se abra.

9.2) CREAR NUEVO INDICE (CREATE)

Crea un nuevo índice para la tabla actual.

10.1) En “Nombre del índice:“ tecleas el

nombre del índice a buscar (si lo conoces).

10.2) En “Clave:“ buscas el campo de la tabla que

funcionará como campo_clave. La expresión de llave
LSCA Lilian Robles Quevedo Febrero - 2008
 APSDU Página 24 de 28
Mantenimiento de tablas de forma externa

pueden tener varios campos. La opción temporal indica que el índice no

se almacenará en la lista de índices fijos de la tabla.
10.3) Indicarás si va a ser temporal o permanente este índice.
10.4) Presionas el botón <OK> para se genere el índice y se
despliegue una pantalla indicando que el índice se acaba de
generar.

9.3) CERRAR ÍNDICE (CLOSE)

Cierra los índices de la tabla actual, pero solo los de
las tablas Btrieve o Ctree.

9.4) BORRAR TODOS LOS INDICES (ERASE ALL)

Borra todos los archivos de índices de tablas
Btrieve o Ctree.

9.5) ESTABLER INDICE PRINCIPAL (ORDER)

Establece el índice que dará ordenamiento a la tabla en curso, pero solo para tablas
del tipo Btrieve o Ctree

10. MANIPULACION EXTERNAS DE TABLAS

LSCA Lilian Robles Quevedo Febrero - 2008
 APSDU Página 25 de 28
Mantenimiento de tablas de forma externa

En esta sección podremos manipular el contenido de los campos de la tabla abierta:

Insertar un nuevo registro, modificar o borrar un registro (marcar el registro con un * en el
campo .D_E_L_E_T_). Las opciones de modificar o borrar, se hacen sobre el campo seleccionado.

NOTA:
 Hay que tener mucho cuidado en tablas con registros existentes, porque podemos borrar o
modificar datos que son vitales para algunos de los módulos de Protheus.
 Cuando se tienen tablas nuevas (creadas desde el Configurador), se pueden introducir
nuevos registros (a modo de prueba) para ver su funcionamiento, sobre todo cuando se
hacen reportes. Y posteriormente eliminar estos registros.

Estas opciones se encuentran en la barra de menú, en la opción EDITAR.

10.1) INSETAR (INCLUDE)

11.1.1) Ve a la Barra de Menú / EDITAR / INSERTAR

11.1.2) Abre una ventana para que se
introduzcan datos de un nuevo
registro y se presiona el botón
<OK> para agregarlo a la tabla.

Se regresará a la pantalla anterior (Browse) y

observarás el registro agregado. Estando
sobre el último registro de la tabla, si se
mueve el cursor hacia abajo se podrá agregar
un nuevo registro estando en modo Browse.

Y un
cuadro de
diálogo

preguntará si deseas agregar: Si presionas <SI> se regresará el Browse y anexará

un nuevo registro en blanco, permitiendo que escribas los datos en cada campo.

10.2) MODIFICAR (CHANGE)

Modifica el registro actual o seleccionado.

LSCA Lilian Robles Quevedo Febrero - 2008

 APSDU Página 26 de 28
Mantenimiento de tablas de forma externa

10.2.1) Selecciona el campo a modificar

10.2.2) Ve a la Barra de Menú / EDITAR / MODIFICAR

Y se abrirá una ventana mostrando

los campos del registro actual para que se
puedan editar.
Una vez terminada las
modificaciones, se presiona el botón
<OK> para guardar los cambios. Si no
quieres modificar, presiona el botón
<Anular>.
Y regresarás el browse de la tabla.

NOTA: Si se hace doble clic o

[Enter] sobre algún campo, se pasa a
modo de edición en la misma línea del
Browse.

10.3) BORRAR (EXCLUDE)

10.3.1) Selecciona el campo a

modificar
10.3.2) Ve a la Barra de Menú
/ EDITAR / BORRAR

Elimina el registro actual. Tiene la

misma función que presionar [Supr] sobre el
registro requerido.

11. OPCIONES DE BUSQUEDA

En esta parte, podemos realizar búsquedas de determinados registros de la tabla abierta, y

posteriormente manipular su contenido. Estas herramientas son de mucha utilidad en tablas con
una cantidad enorme de registros, facilitando la manipulación de un determinado registro.

11.1) LOCALIZAR (LOCATE)

Localiza un registro con base en un criterio de búsqueda

12.1.1) Ve a la Barra de Menú / BUSCAR / LOCALIZAR

12.1.2) En la pantalla que se despliega, escribe la expresión de búsqueda

LSCA Lilian Robles Quevedo Febrero - 2008

 APSDU Página 27 de 28
Mantenimiento de tablas de forma externa

o presiona el botón para desplegar la pantalla

del Constructor de expresiones, y aquí, utilizando
las diferentes opciones, genera la expresión. Al
terminar presiona el botón <OK>.

12.1.3) Presiona el botón <Ok>

para terminar y ejecutar búsqueda.

11.2) IR PARA (GO TO)

Se mueve el puntero de la tabla hacia un registro específico.

12.2.1) Ve a la Barra de Menú / BUSCAR / IR PARA

Si la tabla es externa (DBF/ctree/btrieve) se refiere al registro físico, si una BD

controlada por TopConnect se basa en un campo interno denominado R_E_C_N_O_ y por
el cual existe un índice en cada tabla de la base de datos.

12.2.2) EN “Registro: “, se
teclea el número del renglón
que se desea localizar y se
presiona el botón <OK> para
que se ejecute y en el browse
ver el resultado de la
búsqueda.

11.3) BUSCAR (SEEK)

Localiza un registro de la tabla actual basando la búsqueda en alguno de los índices
existentes.

12.3.1) Ve a la Barra de Menú / BUSCAR / BUSCAR

12.3.2) En la pantalla que se despliega, en “Texto:“ se escribe una condición de
búsqueda y, en “Clave: “, se elige la clave por la cual se hará la búsqueda; después se
presiona el botón <OK> para que se ejecute y ver el resultado en el browse.

LSCA Lilian Robles Quevedo Febrero - 2008

 APSDU Página 28 de 28
Mantenimiento de tablas de forma externa

Parámetros comunes en opciones que actúan sobre un grupo de registros:

FOR – El APSDU procesará todos los registros de la tabla que cumplan la condición dada.
WHILE – Procesa los registros que cumplan la condición dada, desde el registro actual en la
ventana del browse, hasta encontrar un registro (físico o lógico) que no cumpla tal condición o
hasta el que indique “options”:
- ALL – Incluye todos los registros de la tabla, comenzado desde el primero.
- NEXT – Los siguientes # registros.
- REST – Desde el registro actual hasta el final de la tabla.

LSCA Lilian Robles Quevedo Febrero - 2008