WikiDgp21 - Contribuciones del usuario [es]

Manual de la aplicación

2009-02-19T10:00:08Z

Albert Castilla Querol:

Tipos de campos

2009-02-11T09:57:42Z

Albert Castilla Querol:

Define la apariencia y tipo de información que podrá contener el campo.

==Campos alfanuméricos==

*'''Tipo''' : 'C'
*'''Pestaña''': '0' si no pertenece a ninguna pestaña o el índice de la pestaña a que pertenece.
*'''Etiqueta''': Escoger el literal adecuado de la [[dmliter 01|tabla de literales]].
*'''Posición etiqueta''':
**‘E’: Encima, en principio se tomará por defecto esta posición.
**‘I’: A la izquierda, se utilizará cuando el campo sea pequeño, por ejemplo campos tipo S/N.
**‘N’: Sin etiqueta.
*'''Número de dígitos'''
*'''Pos.1: (x,y)''': Corresponde a la esquina superior izquierda de la caja.
*'''Pos.2: (x,y)''':
**x: Cuando se necesita crear un campo de una determinada extensión gráfica, pero que el número de dígitos es superior a esta, indicamos en la x de la posición 2 la coordenada final del campo gráfico, y automáticamente cuando escribamos i no quepan más letras, ellas solas correrán.
**y: Si és 0, el campo se dibuja con altura por defecto de 18 pixels, si indicamos un valor, podemos ajustar la altura del campo. Si la altura supera los 24 pixeles la fuente del control es mayor.
*'''Contenido''':
**'X': Alfanumérico.
**'C': Clave, se visualizan asteriscos.
*'''Signo''': 0, no se utiliza
*'''Editado''': 0, no se usa.

==Campos numéricos==

*'''Tipo''' : 'C'
*'''Pestaña''': '0' si no pertenece a ninguna pestaña o el índice de la pestaña a que pertenece.
*'''Etiqueta''': Escoger el literal adecuado de la [[dmliter 01|tabla de literales]].
*'''Posición etiqueta''':
**‘E’: Encima, en principio se tomará por defecto esta posición.
**‘I’: A la izquierda, se utilizará cuando el campo sea pequeño, por ejemplo campos tipo S/N.
**‘N’: Sin etiqueta.
*'''Número de dígitos:''' sin contar comas, separadores de miles o signo.
*'''Pos.1: (x,y)''': Corresponde a la esquina superior izquierda de la caja.
*'''Pos.2: (x,y)''':
**x: No se utiliza.
**y: Si és 0, el campo se dibuja con altura por defecto de 18 pixels, si indicamos un valor, podemos ajustar la altura del campo. Si la altura supera los 24 pixeles la fuente del control es mayor.
*'''Contenido''': '0' si no tiene decimales, si los tiene, el número de decimales.
*'''Signo''': 0, no se utiliza
*'''Editado''': 0, no se usa.

==Campos fecha==
Las fechas se muestran en el formato: dd/mm/aaaa. El usuario puede omitir las barras separadoras en la introducción así como los 2 dígitos del milenio. El programa cliente se encarga de formatear la entrada.

*'''Tipo''' : 'C'
*'''Pestaña''': '0' si no pertenece a ninguna pestaña o el índice de la pestaña a que pertenece.
*'''Etiqueta''': Escoger el literal adecuado de la [[dmliter 01|tabla de literales]].
*'''Posición etiqueta''':
**‘E’: Encima, en principio se tomará por defecto esta posición.
**‘I’: A la izquierda, se utilizará cuando el campo sea pequeño, por ejemplo campos tipo S/N.
**‘N’: Sin etiqueta.
*'''Número de dígitos:''' No se utiliza. Se toman siempre diez dígitos.
*'''Pos.1: (x,y)''': Corresponde a la esquina superior izquierda de la caja.
*'''Pos.2: (x,y)''':
**x: No se utiliza.
**y: Si és 0, el campo se dibuja con altura por defecto de 18 pixels, si indicamos un valor, podemos ajustar la altura del campo. Si la altura supera los 24 pixeles la fuente del control es mayor.
*'''Contenido''': 'F'
*'''Signo''': 0, no se utiliza
*'''Editado''': 0, no se usa.
*'''Valor def.''': Aquí podemos poner una fecha por defecto para que aparezca en el campo. Si nos interesa que tengamos siempre la fecha actual en este campo, o primero de mes, podemos usar estos valores de entorno:
**&$fecha: Fecha actual.
**&$fecha1m: Fecha de primero de mes.
**&$fecha1a: Fecha de primero de año.

==Campo de texto==

*'''Tipo''': 'T'
*'''Etiqueta''': Escoger el literal adecuado de la [[dmliter 01|tabla de literales]] para que aparezca traducido al lenguaje del usuario. Si no es un código de literal, aparece directamente lo introducido aquí.
*'''Número de dígitos''': se utiliza para calcular el tamaño del control, en caso de que no se haya introducido pos. 2.
*'''Pos.1: (x,y)''': esquina superior izquierda del cuadro
*'''Pos.2: (x,y)''':
**x: Cuando se necesita crear un campo de una determinada extensión gráfica, pero que el número de dígitos es superior a esta, indicamos en la x de la posición 2 la coordenada final del campo gráfico, y automáticamente cuando escribamos y no quepan más letras, ellas solas correrán.
**y: Si és 0, el campo se dibuja con altura por defecto de 18 pixels, si indicamos un valor, podemos ajustar la altura del campo. Si la altura supera los 24 pixeles la fuente del control es mayor.
*'''Posición etiqueta''': Tamaño de la fuente, posibles valores:
**'P': Fuente pequeña
**'M': Fuente mediana
**'G': Fuente grande
**'F': Fuente de espaciado fijo.
**'L': Espaciado fijo, fuente grande
*'''Contenido''': ‘X’ , no se utiliza
*'''Signo''': 0, no se utiliza
*'''Editado''': 0, no se usa
*'''Pasar el control al salir''' : 0, no se usa
*'''Orden de tabulación''': en principio no se usa
*'''Pestaña''': si pertenece a alguna pestaña, su número si no 0.

==Botones==

*'''Tipo''': ‘B’
*'''Número de dígitos''': Se tomará para dimensionar la anchura del botón.
*'''Pos.1: (x,y)''': esquina superior izquierda del botón
*'''Pos.2: (x,y)''':
**x: Número de tecla aceleradora asociada al botón: 1:F1, 2: F2, etc. Listado de [[hot_keys|teclas aceleradoras]].
**y: No se utiliza.
*'''Etiqueta''': Escoger el literal adecuado de la [[dmliter 01|tabla de literales]]. Aparecerá dentro del botón.
*'''Pasar el control''': 1.

==Botones herramienta==

*'''Tipo''': ‘H’
*'''Contenido''':
**Si no se especifica nada, se utiliza para realizar cualquier acción que establezcamos mediante programación.
**'Y' Botón que muestra una página de ayuda, para más información ver el apartado [[tipos_de_campos#Bot.C3.B3n_de_ayuda|Botón de ayuda]].
**'I' Botón que arranca una nueva instancia de la aplicación con los mismos parámetros de conexión que la actual
*'''Etiqueta''': Escoger el literal adecuado de la [[dmliter 01|tabla de literales]]. Aparecerá cuando el puntero del ratón pase por encima del control (tooltip).
*'''Posición etiqueta''':
**'M': Tamaño medio, 24x24 pixels, valor por defecto
**'P': Tamaño pequeño, 17x17 pixels.
**'G': Tamaño grande, 30x30 pixels, apropiado para usarse en pantallas táctiles.
* '''Pos.2: (x,y)''':
**x: número de tecla aceleradora asociada al botón: 1:F1, 2: F2, etc. Listado de [[hot_keys|teclas aceleradoras]].
**y: se utiliza parar indicar la imagen que será el número asignado en el fichero resource.h del proyecto dgp21i01.
*'''Pasar el control''': 1.

==Botón de ayuda==

Pulsando el botón de ayuda, mediante el ratón o pulsando F1, se accede a la pagina html de ayuda en la posición que corresponda. El prefijo para construir el path completo de la página de ayuda lo resuelve el programa cliente en función del fichero de configuración: puede apuntar a paginas en la intranet de la empresa, internet o páginas locales. Este prefijo se guarda en dgp21.cfg de la forma siguiente:

# --- Path ajuda

ajuda=l:\libs\man\;

El path completo se obtiene añadiendo el código del idioma del usuario.

Por ejemplo, si el usuario ha escogido en la pantalla de conexión el código de idioma 'Fr', francés, las pantallas de ayuda se buscaran en:

l:\libs\man\Fr

Es un control tipo botón de ayuda con las siguientes particularidades:

*'''Tipo''': 'H'
*'''Contenido''': 'Y', ayuda.
*'''Valor por defecto''': Dirección página web y marcador de situación en la página, por ejemplo:

control_presencia1.htm#CP

[[Normas_estilo|Normas de estilo para las páginas de ayuda]]

==Cuadro==

Recuadro planos transparente o con un bitmap.
Como recuadro transparente se usa para agrupar visualmente controles relacionados.

*'''Tipo:''' 'U'
*'''Contenido''': 'B', para mostrar un bitmap, 'N' o cualquier otro, para mostrar un recuadro transparente.
*'''Valor por defecto''': Número de referencia del bitmap.
*'''Pos.1''': Esquina superior izquierda del recuadro.
*'''Pos.2''': Esquina inferior derecha.

==Pantalla o ventana==

Recuadro opaco y con relieve. Para visualizar una ventana superpuesta. Para aplicar el titulo a la ventana debe añadirse un control de tipo texto estático con fondo azul y letras blancas.

*'''Tipo:''' 'P'.
*'''Pos.1 (x,y)''': Esquina superior izquierda del recuadro.
*'''Pos.2 (x,y)''': Esquina inferior derecha.
*'''Tabulador:''' Si és distinto de cero significa que se quiere llamar la atención del usuario y por tanto se muestra la pantalla aunque en aquel momento la aplicación esté minimizada u oculta por otra aplicación.

==Texto extenso==

Controles tipo caja para albergar un texto extenso. Si el texto sobrepasa el área del control, aparece la barra de scroll vertical.

*'''Tipo:''' 'X'
*'''Contenido: 'M', Indicamos tipo de letra mediana, en cualquier otro caso letra por defecto.
*'''Número de dígitos: Longitud máxima del campo
*'''Pos.1 (x,y)''': Esquina superior izquierda del recuadro.
*'''Pos.2 (x,y)''': Esquina inferior derecha.

==Menú==

Tipo de campo utilizado en los menús.

*'''Tipo''': 'M'.
*'''Contenido: irrelevante.
*'''Pos. 2''': irrelevante, la anchura se fija en función del número de dígitos.
*'''Tipo de fuente''': fijado por la aplicación.

==Línea de listado==

Se utiliza para las líneas de listado. Pinchando sobre ellas se resaltan y suelen utilizarse para realizar alguna acción relacionada con la línea de datos.

*'''Tipo:''' 'I'
*'''Pos. 2''': irrelevante, altura fija, la longitud se fija en función del número de dígitos.
*'''Fuente''': fija.

==Campos tipo pestaña==

Habrá que definir tantos controles de este tipo como pestañas distintas. Cada una de ellas tendrá un núm. de orden distinto empezando por 1. El tamaño del control lo tomará de la pestaña con núm. pestaña = 1. Para asignar los controles a las pestañas habrá que indicar en ellos el núm. de pestaña al que pertenecen. Si núm. Pestaña = 0 no pertenece a ninguna pestaña.

Limitación sólo es posible 1 pestaña por pantalla.

*'''Tipo''': 'N'
*'''Etiqueta''': nombre de la pestaña
*'''Pos.1: (x,y)''': esquina superior izquierda del cuadro
*'''Pos.2: (x,y)''': esquina inferior derecha, sólo se tiene en cuenta para la Pestaña = 1
*'''Posición etiqueta''': poner ‘P’, de momento no se utiliza.
*'''Contenido''': ‘X’ , no se utiliza
*'''Signo''': 0, no se utiliza
*'''Número de dígitos''': no se utiliza, el tamaño de la pestaña depende de su etiqueta.
*'''Editado''': 0, no se usa
*'''Pasar el control al salir''': 0, no se usa
*'''Orden de tabulación''': en principio no se usa.
*'''Pestaña''': Núm. De pestaña empezando por 1.

==Campo tipo “Checkbox”==

*'''Estado''': campo que sólo permite 2 estados:
**Chequeado
** No chequeado.

*'''Tipo''': 'K'
*'''Etiqueta''': Nombre del campo
*'''Pos.1: (x,y)''': esquina superior izquierda del cuadro de chequeo
*'''Pos.2: (x,y)''': no se utiliza
*'''Posición etiqueta''':
**‘I’: A la izquierda
**‘N’: Sin etiqueta
**'D': A la derecha
*'''Contenido''':
**‘X’ : Si el campo está chequeado su valor es 'S', en caso contrario su valor es ' ' (un espacio)
**'B': Campo boleano estricto, si está chequeado su valor es 'S', en caso contrario es 'N'.
*'''Signo''': 0, no se utiliza
*'''Número de dígitos''': no se utiliza.
*'''Editado''': 0, no se usa

==Texto interactivo==

Campo de texto que al clicar sobre él con el ratón cambia de color. Se utiliza para las líneas de una grid. Se juega con los atributos para darle un fondo de color y crear el listado con colores alternos para cada línea.

*'''Tipo''': 'I'
*'''Etiqueta''': No se usa
*'''Pos.1: (x,y)''': esquina superior izquierda del cuadro
*'''Pos.2: (x,y)''': No se usa.
*'''Posición etiqueta''': Tamaño de la fuente, posibles valores:
**'P': Fuente pequeña
**'M': Fuente mediana
**'G': Fuente grande
**'F': Fuente de espaciado fijo.
*'''Contenido''': ‘X’ , no se utiliza
*'''Signo''': 0, no se utiliza
*'''Número de dígitos''': se utiliza para calcular la longitud del control..
*'''Editado''': 0, no se usa
*'''Pasar el control''': al salir = 1
*'''Orden de tabulación''': en principio no se usa.
*'''Pestaña''': si pertenece a alguna pestaña, su número si no 0.
*'''Pertenencia''': 'L' indica que pertenece a una grid.
*'''Enlazar control''': Cuando la pantalla que contiene la “grid” tiene un área de detalle con los campos de la línea del listado, entonces enlaza con el control 36 que es el encargado de rellenar ese detalle a partir del oid correspondiente a la línea seleccionada.
*'''Nota''': Este campo debe tener la función g_fijar que tiene como misión obtener el “oid” de la línea seleccionada.

[[Categoría:desarrolladores]]

Funciones

2009-02-11T09:41:32Z

Albert Castilla Querol:

Funciones
Valores de entorno
En las funciones pueden utilizarse los siguientes valores de entorno:
*&$idi : Idioma de la sesión.
*&$ipn: Ip de la sesión.
*&$usu: Código de usuario conectado.
*&$fecha: Fecha actual.
*&$fecha1m: Fecha de primero de mes.
*&$fecha1a: Fecha de primero de año.
Referencias a controles
En los campos de sentencia SQL y parámetros de la función,
podemos hacer referencia al contenido de los campos de la pantalla
indicando el número de contorl (3 dígitos) precedido por #. De esta manera
se substituirá el contenido del campo indicado por el conjunto #XXX.

Ejemplos:
select * from abtdt where doid=#006;
msg0003 ,#078, ref001, 101

====g_aceptar====
*Sale de la pantalla devolviendo un 0 en el estatus.
*Si se han utilizado enlaces, devuelve los campos enlazados actualizados a la pantalla anterior.

====g_borrar====
*Pide confirmación del borrado de la fila
*Ejecuta la sentencia DELETE especificada en el campo sql.
*Después se ejecuta un [[Funciones#g_consulta|g_consulta]] (poner a modo consulta) de cabecera y detalle que coge los parámetros indicados al [[Funciones#g_borrar|g_borrar]] (ver parámetros de [[Funciones#g_consulta|g_consulta]]).
*Si no recibe ningún parámetro se comporta como si hubiera recibido un 0.
*Además de los parámetros del [[Funciones#g_consulta|g_consulta]], [[Funciones#g_borrar|g_borrar]] tiene un parámetro adicional, a continuación de los anteriores, que indica si se ha de registrar la operación (usuario, hora, ip...): s para registrar, n para no registrar, si no se indica nada coge por defecto n.
*Si el usuario aprieta el botón Aceptar el control 1 guardará el valor 0, si aprieta el botón Cancelar, dicho valor será mayor que 0.
*Ejemplo: 3 51 52 63,s

====g_list====
Se usa para rellenar una grid con los datos obtenidos la consulta SQL especificada. La grid puede ser la de la misma pantalla donde utilizamos la función o bien otra pantalla que especifiquemos.
*Uso: <br >para rellenar la grid de la misma pantalla en que se usa la función.
*Parámetros función:<br \>Ninguno.
*Sentencia SQL:<br \>Sentencia SQL cuyo resultado queremos mostrar.
*Pares de campos o descripción del listado:<br \>Formato o descripción del listado. Para cada columna del select deberemos indicar el formato: 'N' para campos numéricos, 'E' para campos numéricos con separacion con punto en los millares (en este caso debemos tener en cuenta los puntos a la hora de calcular la extensión del campo en el listado), 'X' para campos alfanuméricos y 'V' para campos de longitud variable; y seguidamente la longitud a reservar para cada columna indicada con 2 o 3 dígitos, separando los campos con comas. Podemos jugar con la longitud para truncar los datos de una columna o ampliar el espacio de una columna para poder mostrar un título mas extenso. <br >Como todos los campos tienen que ir seguido de dos dígitos, para el formato 'V', que no tiene función alguna, por convenio y para evitar confusiones pondremos siempre 99.
En los campos que sean numéricos ('E' y 'V') tenemos la opción de ocultar los valores que sean 0. Lo indicaremos mediante minúscula, o sea con la letra del parámetro en minúscula:
e14,n10...
*Ejemplo:<br >Sentencia SQL:
select cco_codi, cco_desc, cco_abierto, cco_descamp from cco
<br >Descripción del listado:
N06,X130,X07,e10,V99...
Uso de g_list para rellenar y mostar datos en una grid de una pantalla distinta a la pantalla en que se usa la función.
Parámetros función.
1.Nombre de la pantalla a mostrar con el resultado de la senetencia select especificada
2.Fijo, valor 033
3.Incluir 1º columna con oid de la tabla principal de la select: 's': incluirla, 'n': no incluirla.

La primera columna del select se utiliza como identificador de la fila, debe contener un valor que identifique de forma univoca la fila, este valor se situa en en el campo 006 de la pantalla cada vez que el usuario clica en una linea de la grid. Con este valor podemos identificar el valor que ha seleccionado el usuario y actuar en consecuencia.
Si no se especifica este parámetro o bien especificamos una 's', la función inserta de forma automática en el resultado de la select, una primera columna con el oid de la 1ª tabla especificada en la sentencia select. Si queremos utilizar una columna distinta para identificar la fila que seleccione el usuario especificamos una 'n' en el 3er parámetro, en este caso la 1ª columna del select especificado actuará como identificador de la fila.
Enlaces.
Pares de campos a enlazar con la pantalla especificada en el apartado anterior. Por lo menos enlazaremos el campo 033 y el campo 006 para recuperar el resultado de la selección efectuada por el usuario sobre la grid mostrada.
Sentencia SQL
Sentencia SQL cuyo resultado queremos mostrar.
Pares de campos o descripción del listado
Formato o descripción del listado. Para cada columna del select deberemos indicar el formato: 'N' para campos numéricos o 'X' para campos alfanuméricos y la longitud a reservar para cada columna indicada con 2 dígitos. Podemos jugar con la longitud para truncar los datos de una columna o ampliar el espacio de una columna para poder mostrar un título mas extenso.
Ejemplo:
Parámetros función:
dgsel 01,033
Enlaces:
006=006,033=033
Sentencia SQL:
select trn_nom,trn_codi from transporte where trn_nom ilike '#052%' order by trn_nom
Descripción del listado:
X20N08

====g_borrdoc====
Borra del ordenador local el archivo indicado mediante tres parámetros:
*1,2: Los dos primeros son los controles que identifican este archivo como único. Si el segundo no es necesario dejaremos el parámetro en blanco pero sin obviar las comas.
*3: El control que guardar la extensión del archivo a eliminar.

====g_buscar====
*Ejecuta el select especificado en el SQL.
*Rellena los campos de la pantalla en función de los pares de campos.
*Lanza un [[Funciones#g_consulta|g_consulta]] pasándole los parámetros especificados.
*Si no recibe ningún parámetro se comporta como si hubiera recibido un 0.
*Parámetros:
**0: No modifica ningún control.
**1: Inicializa todos los controles a su valor por defecto
**2: Inicializa los controles mayores que 50 a su valor por defecto.
**3: Inicializa todos los controles a excepción de los indicados, por ejemplo: 3,51,52,63

====g_consulta====
*Pone la pantalla en modo consulta
*Inicializa los controles de acuerdo con los parámetros que recibe
*Parámetros:
**0: No modifica ningún control.
**1: Inicializa todos los controles a su valor por defecto
**2: Inicializa los controles mayores que 50 a su valor por defecto.
**3: Inicializa todos los controles a excepción de los indicados a continuación, separados por espacios, por ejemplo: 3 51 52 63

====g_csv====
Transmite al programa cliente la selección de datos actual en formato csv y el programa cliente abre automáticamente el fichero con la aplicación asociada a este tipo de datos, habitualmente Excel u Open Office.
*Parámetros función: Esta función no tiene parámetros

====g_dupdoc====
*Se usa para ordenar al cliente que copie un documento como otro. El documento origen debe estar ya en la máquina cliente.
*Parámetros de la función:
*Referencia documento origen
*Versión documento origen
*Tipo de documento
*Referencia documento destino
*Versión documento destino

====g_ejecuta====
*Ejecuta la sentencia sql especificada.
*Número de parámetros: 3
**Parámetro 1:
***0: Da error si no hay filas o si hay un error devolviendo un 1 en el primer caso o un 2 en el segundo en el control de status, control 1. <br \>Podemos capturar el valor dentro del código de programación mediante un campo numérico, por ejemplo:
stat numeric(2,0)@1;
***1: Sólo avisa si hay un error de base de datos y devuelve un 2 en el control de status, control 1.
***2: No avisa nunca y devuelve un 0 en el control de status, control 1, como si no hubiese habido ningún error.
***3: No avisa nunca pero devuelve un 1 o un 2 en el control de status, control 1, dependiendo de si el error es que no hay filas o si es un error de base de datos.
**Parámetro 2:
***'s': La sentencia sql se depurará antes de ejecutarse. Por ejemplo en sentencias selects se eliminan las condiciones de la clausula where de los campos que no tienen ningún valor
***'n': La sentencia sql se ejecutará sin ningún cambio.
**Parámetro 3:
***Número de control donde se almacenaran el número de filas afectadas por el select de la función, si no se desea guardarlas en ningún control introducir el valor 0. Su aplicación tiene utilidad en la programación interna.
**Parámetro 4:
***'s': la operación se registrará (usuario, ip, hora...) en el log.
***'n': la operación no se registrará en el log, opción por defecto.

====g_envdoc====
Envía un documento desde el ordenador cliente al servidor. En el servidor mira cual es la versión actual y le cambia el nombre aumentando en uno el número de versión.
*Parámetros función:
**1,2: Los dos primeros son los controles que identifican este archivo como único. Si el segundo no es necesario dejaremos el parámetro en blanco pero sin obviar las comas.
**3: El control que guarda la extensión del archivo, para poder completar el nombre.

====g_envfit====
Transmite al programa cliente la selección de datos actual. El cliente transforma el fichero al formato especificado en Parámetros Función y abre el fichero para su consulta o edición.
*Parámetros función:
**a: Formato RTF
**b: Formato texto plano

====g_exeapl====
*Ejecuta el archivo indicado mediante tres parámetros:
**1,2: Los dos primeros son los controles que identifican este archivo como único. Si el segundo no es necesario dejaremos el parámetro en blanco pero sin obviar las comas.
**3: El control que guarda la extensión del archivo a ejecutar, para así sepa que aplicación ha de utilizar para realizar la acción.

====g_imprimir====
Manda el impreso en cuestión a imprimir en el formato y en la impresora especificados mediante los parámetros:
*1: Formato. Indica el formato del impreso ha imprimir.
*2: Impresora. Indica en que impresora se ha de imprimir el impreso
*3: Previsualizar. Indica si se ha de previsualizar el impreso.

====g_llamar====
Enlaza con la pantalla especificada y opcionalmente ejecuta un control.
*Parámetros:
**Nombre de la pantalla a enlazar, sin comillas.
**Núm de control a ejecutar. Si no se quiere ejecutar ningún control al inicio, omitimos este segundo parámetro

*Enlaces: <br >En los enlaces indicaremos los campos que van a intercanviar datos con la pantalla llamada, sin comillas, con 3 dígitos y separados por comas, mediante los signos siguientes:
**< : indica solo retorno.
**= : indica envío y retorno.
**> : indica solo envío.
**Ejemplo:
052<027,056=015, 057>067
El el campo 52 de la pantalla origen recibirá el valor del campo 27 de la pantalla destino, pero el 27 no recibirá nada;
el campo 56 de origen y el 15 de destino se intercambiaran el contenido, tanto al ir, como al volver;
el campo 57 enviará la información al 67 al ir, pero al volver no recojerá ningún dato..
Si queremos que al salir de la página llamada se pasen también los datos
la pantalla deberá salir con un [[Funciones#g_aceptar|g_aceptar]], si por el contrario sale con un [[Funciones#g_salir|g_salir]]no se pasará ningún dato.

*Ejemplo:
g_llamar, Parámetros: h_personal,011

====g_fijar====
*Pone el oid del registro seleccionado en la grid
**Par&aacutemetro 1: Indica el control que ha sido seleccionado, independientemenete de si
lo ha clickado el usuario o no.
====g_foco====
Coloca el foco en el control indicado en el parámetro.
*Parámetro: El número de control que deseamos reciba el foco.

====g_mens====
*Permite mostrar un mensaje por pantalla para el usuario.
*Esta función se llama con 4 parámetros, que son:
**1: La pantalla que se quiere utilizar para mostrar el error, 10 dígitos alfanuméricos. <br >Valores posibles (msg0001, msg0002, msg0003... msg0008).
**2: El código del error que quiere mostrarse, definido previamente en la tabla dgmens. 10 dígitos alfanumérico.
**3: Una referencia identificadora del error, 6 dígitos alfanuméricos.
**4: Un campo de la pantalla cuyo contenido quiera mostrarse en el mensaje, 3 dígitos numéricos.
***La pantalla que aparece con el mensaje siempre contendrá uno o dos botones (un “Aceptar” y un “Cancelar”). Si se clicka en aceptar la función devolverá un 0 en el campo 1 (estado), mientras que si se clicka en cancelar devolverá un 1.
*Los dos primero parámetros son obligatorios y deben existir, teniendo en cuenta de intercalar cuatro espacios entre el código de pantalla y el código de formato, si quiere omitirse la referencia pero en cambio se quiere poner el cuarto parámetro, deberá hacerse de la siguiente forma, por ejemplo:
msg0001, msg_err, , 53

Las pantallas con las que se muestran los errores se pueden crear o cogerlas ya predeterminadas:

[[Imagen:msg_0001.png|frame|none|msg0001]]
[[Imagen:msg_0002.png|frame|none|msg0002]]
[[Imagen:msg_0003.png|frame|none|msg0003]]
[[Imagen:msg_0004.png|frame|none|msg4 01]]
[[Imagen:msg_0005.png|frame|none|msg5 01]]
[[Imagen:msg_0006.png|frame|none|msg6 01]]
[[Imagen:msg_0007.png|frame|none|msg7 01]]
[[Imagen:msg_0009.png|frame|none|msg9 01]]

====g_modificar====
*Pone el estado 'Modificar' estableciendo los atributos de los campos para ese estado.
*Sentencia sql y pares de campos, existen dos opciones:
**Introducir una sentencia select específica (normalmente para bloquear el registro), indicando también los pares de campos que debe rellenar
**Dejar la sentencia select en blanco, en ese caso por programación hay que ejecutar previamente el control 36 (exeb(36)) para refrescar los datos que se vayan a modificar.
*Parámetros:
**0: No modifica ningún control.
**1: Inicializa todos los controles a su valor por defecto.
**2: Inicializa los controles mayores que 50 a su valor por defecto.
**3: Inicializa todos los controles a excepción de los indicados, separados por espacios, por ejemplo: 3 51 52 63

====g_nuevo====
*Pone en estado de altas
*Establece los atributos correspondientes al estado de altas.
*Inicializa los campos de acuerdo con sus valores por defecto en función de los parámetros recibidos.
*Si no recibe ningún parámetro se comporta como si hubiera recibido un 1.
*Parámetros:
**0: No modifica ningún control.
**1: Inicializa todos los controles a su valor por defecto.
**2: Inicializa los controles mayores que 50 a su valor por defecto.
**3: Inicializa todos los controles a excepción de los indicados, separados por espacios, por ejemplo: 3 51 52 63

====g_rebdoc====
Esta función envía una copia del archivo referenciado en pantalla desde el servidor al ordenador local.
Para ello se le pasan cuatro parámetros: el modo de apertura del archivo, los controles que identifican este archivo y la extensión del archivo.
*1: Tiene cuatro posibles valores: 'r','w','R','W'. En los dos primeros casos se indica como vamos a copiar el archivo (solo lectura o escritura, respectivamente). Los dos casos siguientes indican lo mismo, pero además abriendo el archivo con la aplicación correspondiente.
*2, 3: Los controles que identifican este archivo como único. Si el segundo no es necesario dejaremos el parámetro en blanco pero sin obviar las comas.
*4: La extensión del archivo a copiar, que utilizará el programa para saber con que aplicación se ha de abrir este archivo.

====g_rellena====
Rellena los controles de la pantalla a partir del resultado de una select. No inicializa los campos previamente. Si así se quiere hay que llamar la función [[Funciones#g_nuevo|g_nuevo]] con los parámetros pertinentes.
*Función: g_rellena
*Fichero funciones: nada (general)
*Tipo: B
*Parámetros función: 3 parámetros
**Primer parámetro:
***0: Da error si no hay filas o si hay un error devolviendo un 1 o un 2 respectivamente en el control de status, control 1.
***1: Sólo avisa si hay un error de base de datos y devuelve un 2 en el control de status, control 1.
***2: No avisa nunca y devuelve un 0 en el control de status, control 1, como si no hubiese habido ningún error.
***3: No avisa nunca pero devuelve un 1 o un 2 en el control de status, control 1, dependiendo de si el error es que no hay filas o si es un error de base de datos.
**Segundo parámetro:
***Número de control donde se almacenaran el número de filas afectadas por el select de la función, si no se desea guardarlas en ningún control introducir el valor 0. Su aplicación tiene utilidad en la programación interna
**Tercer parámetro:
***'s': La sentencia sql se depurará antes de ejecutarse. Por ejemplo en sentencias selects se eliminan las condiciones de la clausula where de los campos que no tienen ningún valor
***'n': La sentencia sql se ejecutará sin ningún cambio.

*Ejemplo: 1,99<br >En este ejemplo se avisa si hay un error de base de datos y almacena el número de filas afectadas por la sentencia select de la función en el control 99.
*Sentencia SQL: Sentencia a ejecutar, por ejemplo:
select fmh_codi,fmh_desc from h_famhor where oid=#006
*Pares de campos: Controles a rellenar con los datos de la select, por ejemplo:
001063,002064
Nota: Esta función no puede utilizarse para rellenar el contenido del campo donde está definida.
====g_salir====
*Sale de la pantalla devolviendo un 1 en el estatus.
*Anula el comportamiento del campo enlazar. Si un control contiene una función [[Funciones#g_salir|g_salir]], si se ejecuta, no se efectuará el enlace que se halla especificado en el campo "enlazar ctrl"

====g_seleccionar====
*Pone en estado de seleccionar
*Establece los atributos correspondientes al estado de seleccionar.
*Inicializa los campos de acuerdo con sus valores por defecto en función de los parámetros recibidos. Si no recibe ningún parámetro se comporta como si hubiera recibido un 0.
*Parámetros: 1
**0: No modifica ningún control.
**1: Inicializa todos los controles a su valor por defecto.
**2: Inicializa los controles mayores que 50 a su valor por defecto.
**3: Inicializa todos los controles a su valor por defecto a excepción de los indicados, por ejemplo: 3 51 52 63

====g_setatr====
*Se usa para cambiar un atributo en tiempo de ejecución a uno o varios controles. La función se asigna a cualquier control de la pantalla.
*Parámetros de la función: El primer parámetro será un digito, un 0 o un 1 que indicará si el atributo es dinámico o estático respectivamente, es decir, si cuando cambie el estado de la pantalla (altas, consultas, etc...), el atributo se modificará con su valor correspondiente o mantendrá el que le indiquemos en la función. A continuación se introducen tantos parámetros como controles queramos modificar. Para cada control escribimos el número de control de 3 dígitos, el signo igual y el atributo de 2 dígitos, los parámetros se separan por comas. Si tenemos muchos campos que tendrán el mismo atributo podemos agruparlos mediante guiones.
*Ejemplo:
1,051=10,052-056=20,053-062=00
En este ejemplo el campo 51 estará deshabilitado, los campos 52 y 56 estarán ocultos y los campos 53 y 62 estarán habilitados, y en los tres casos estos atributos se mantendrán en todos los estados.

====g_sustit====
Se usa principalmente en la búsqueda avanzada. Su función es sustituir el valor del control que se le pasa en “Páram. Func.” por los valores de los controles contenidos en “Sentencia SQL”, separados por comas. De esta forma si después has de pasar todos estos valores, los tendrás todos contenidos dentro de un único control.

====l_refresca====
*Se ejecuta siempre detrás de cualquier modificación en la base de datos (alta, baja, modificación de un registro) para que este cambio salga reflejado en la grid.
*Contiene dos parámetros: el control que queremos que se ejecute, y el número de orden.
*Parámetros: 2 parámetros y son obligatorios.
**1: El control que queremos que se ejecute, habitualmente el control 10 que es el que hace la búsqueda y rellena la grid.
**2: El número de orden que corresponde a la función que queremos que se ejecute en el control referido.

====g_crgimp====
*Función que envía el resultado de un select al generador de informes para hacer un report.
*Parámetros: 3 parámetros
**1: Cabecera o detalle ("c" o "d"): indicamos si el resultado del select corresponde a la cabecera del impreso o corresponde a un detalle.
**2: Write o Append ("w" o "a"): indicamos si creamos un nuevo impreso o añadimos a uno existente.
**3: El tercer parámetro nos indica si ha habido errores en la base de datos, debe contener 0, 1 o 2
***0: Da error si no hay filas o si hay un error devolviendo un 1 o un 2 respectivamente en el control de status, control 1.
***1: Sólo avisa si hay un error de base de datos y devuelve un 2 en el control de status, control 1.
***2: No avisa nunca y devuelve un 0 en el control de status, control 1, como si no hubiese habido ningún error.

*En sentencia SQL pondremos la sentencia que devuelva los datos que enviamos al impreso.
select cac_ejer, cac_num, cac_fecha from abclcb where cac_num=#061 and cac_ejer=#060 and cac_alm=#059
*En pares de campos pondremos el tipo de dato y tamaño de cada uno de los campos que mostramos con el select en el mismo orden. Para el ejemplo anterior sería:
N02,N06,X10
====g_email====
*Función que abre el gestor de correo con el mail, asunto y texto que se le indique desde la pantalla.
*Parámetro:
**Código de control dónde se guarda la información que necesita el gestor de correo. Previamente a llamar a [[Funciones#g_email|g_email]] se deberá hacer un [[Funciones#g_rellena|g_rellena]] de este control con una cadena con el mail, asunto y cuerpo del mensaje separado por pipes "|". Si no disponemos de asunto y cuerpo no hace falta ponerlos en blanco, si no que pasaremos solo el mail sin pipes.

[[Categoría:desarrolladores]]

Dmliter 01

2009-01-21T11:25:12Z

Albert Castilla Querol:

{| style="position:absolute; top:0; width:100%; background:#F8FCFF; color:#888;" valign="middle"
|-
|
<h1 style="margin:0; border-bottom:0;"><br>
Tabla de literales
|}

[[Media:Dmliter_01.png|Pantalla ejemplo]]

Desde esta pantalla podremos dar de alta, modificar o borrar literales que utilizaremos en diversas pantallas y que definen diferentes valores. Por ejemplo, los tipos de acciones comerciales tienen un código literal y una descripción para cada código.

Los literales serán comunes para todos los idiomas, no siendo así las descripciones de los literales, ya que si, por ejemplo una empresa tiene diferentes sucursales en diferentes países, el código literal de una acción comercial estará en el servidor (un único código común a las diferentes sucursales de la empresa), pero la descripción de cada código, estará en el idioma del país.

==Campos==

=====Idioma=====
En este campo se indica el idioma de la aplicación.

=====Código=====
Código del literal.

=====Descripción=====
Explicación ampliada del código.

=====Introducción de literales=====
Cuando vayamos a introducir un literal y cliquemos en altas F2, el programa, por defecto nos rellenará el campo del idioma automáticamente, dependiendo del ididoma con el que hayamos entrado en la aplicación. Introducimos un código y una descripción y clicamos en [[Imagen:boto_067.png]] o F9 (guarda y sigue); este icono lo que hace es guardar el código y la descripción e inmediatamente volver a poner la pantalla en altas para seguir introduciendo literales de una manera rápida.

Gestión de familias

2009-01-21T11:23:40Z

Albert Castilla Querol: Página nueva: {| style="position:absolute; top:0; width:100%; background:#F8FCFF; color:#888;" valign="middle" |- | <h1 style="margin:0; border-bottom:0;"><br> Gestión de familias |} [[Media:.pn...

{| style="position:absolute; top:0; width:100%; background:#F8FCFF; color:#888;" valign="middle"
|-
|
<h1 style="margin:0; border-bottom:0;"><br>
Gestión de familias
|}

[[Media:.png|Pantalla ejemplo]]

Esta pantalla nos servirá para dar de alta tantas familias como sea necesario dentro de cada tabla y el uso que tenga esta tabla.

==Campos==

=====Tabla=====
Por defecto tenemos tres tipos de tablas en la aplicación: Artículos, Marketing y Terceros. Dependiendo de la tabla tiene más de un uso, y se le pueden asignar tantas familias como necesitemos.

=====Uso=====
En este campo tendremos el uso de cada tabla. Así pues la tabla Artículos tendrá como uso Compras, Fabricación y Ventas, la tabla Marketing tendrá como uso Comercial y la tabla Terceros tendrá como uso Compras y Ventas

=====Familia=====
Campo alfanumérico en el que escribiremos las iniciales (tres como máximo) que describan qué tipo de familia es.

=====Descripción=====
La palabra completa que describa el uso.



=====Botón datos=====

Cuando clikemos en Datos hemos de tener seleccionada una de las familias que habremos dado de alta y accederemos a la descripción de todas las categorías que puede haber dentro de cada familia.

Generación de rutas de entrega

2009-01-19T11:11:57Z

Albert Castilla Querol:

{| style="position:absolute; top:0; width:100%; background:#F8FCFF; color:#888;" valign="middle"
|-
|
<h1 style="margin:0; border-bottom:0;"><br>
Generación de rutas de entrega
|}

Una ruta es una agrupación de recogidas o de entregas que realizará un mismo chofer en un mismo viaje. Las recogidas o entregas se asignan a la ruta mediante el botón de [[Detalles de la ruta]]. Cuando una recogida o una entrega se asigna a una ruta, esta recogida o entrega pasa a ser un detalle de la ruta, y en la ficha de la recogida o entrega quedará indicado a que ruta pertenece. En esta pantalla introduciremos los datos generales de la ruta.

Para ver el proceso de transportes detallado mirar [[Dgt0410e|aplicación de transportes]].

La pantalla dispone de un botón "imprimir", que imprimirá una hoja de ruta detallada para el chofer que se encargue de realizar la ruta.

==Campos==

=====Almacén=====

Código del almacén de trabajo. Por defecto es el almacén de trabajo establecido en la definición de [[usuarios]].

=====Ejercicio=====

Ejercicio actual se toma de los valores de [[configuración de la empresa]].

=====Código=====

Código de la ruta.

La aplicación asigna un número de forma automática al crear una ruta. La numeración es única para todos los almacenes.

=====Salida=====

Fecha de inicio de la ruta. Por defecto aparece la fecha actual.

Hora de salida.

Hora de inicio de la ruta, opcional.

=====Entrada=====

Fecha de finalización de la ruta. Por defecto aparece la fecha 1/1/3000. Mientras la ruta tenga este valor no se dará por finalizada. Para finalizar una ruta lo único que se ha de hacer es poner en este campo una fecha igual o anterior a la actual. Cuando se finaliza una ruta se le asigna a todas la recogidias o entregas de ésta la misma fecha de finalización que hayamos puesto en este campo. Para más detalles mirar [[Dgt0410e|aplicación de transportes]].

=====Hora de entrada=====

Hora de finalización de la ruta.

=====Chofer=====

Chofer al que se le ha asignado la ruta para su realización.

=====Observaciones=====

Campo extenso para introducir las observaciones que se crean convenientes.

Generación de rutas de entrega

2009-01-19T11:10:17Z

Albert Castilla Querol:

{| style="position:absolute; top:0; width:100%; background:#F8FCFF; color:#888;" valign="middle"
|-
|
<h1 style="margin:0; border-bottom:0;"><br>
Generación de rutas de entrega
|}

Una ruta es una agrupación de recogidas o de entregas que realizará un mismo chofer en un mismo viaje. Las recogidas o entregas se asignan a la ruta mediante el botón de [[Detalles de la ruta]]. Cuando una recogida o una entrega se asigna a una ruta, esta recogida o entrega pasa a ser un detalle de la ruta, y en la ficha de la recogida o entrega quedará indicado a que ruta pertenece. En esta pantalla introduciremos los datos generales de la ruta.

Para ver el proceso de transportes detallado mirar [[aplicación de transportes]].

La pantalla dispone de un botón "imprimir", que imprimirá una hoja de ruta detallada para el chofer que se encargue de realizar la ruta.

==Campos==

=====Almacén=====

Código del almacén de trabajo. Por defecto es el almacén de trabajo establecido en la definición de [[usuarios]].

=====Ejercicio=====

Ejercicio actual se toma de los valores de [[configuración de la empresa]].

=====Código=====

Código de la ruta.

La aplicación asigna un número de forma automática al crear una ruta. La numeración es única para todos los almacenes.

=====Salida=====

Fecha de inicio de la ruta. Por defecto aparece la fecha actual.

Hora de salida.

Hora de inicio de la ruta, opcional.

=====Entrada=====

Fecha de finalización de la ruta. Por defecto aparece la fecha 1/1/3000. Mientras la ruta tenga este valor no se dará por finalizada. Para finalizar una ruta lo único que se ha de hacer es poner en este campo una fecha igual o anterior a la actual. Cuando se finaliza una ruta se le asigna a todas la recogidias o entregas de ésta la misma fecha de finalización que hayamos puesto en este campo. Para más detalles mirar [[aplicación de transportes]].

=====Hora de entrada=====

Hora de finalización de la ruta.

=====Chofer=====

Chofer al que se le ha asignado la ruta para su realización.

=====Observaciones=====

Campo extenso para introducir las observaciones que se crean convenientes.

Funcionamiento de la aplicación de transportes

2009-01-19T11:01:06Z

Albert Castilla Querol:

{| style="position:absolute; top:0; width:100%; background:#F8FCFF; color:#888;" valign="middle"
|-
|
<h1 style="margin:0; border-bottom:0;"><br>
Funcionamiento de la aplicación de transportes
|}

Para clarificar el funcionamiento de transportes, explicaremos paso a paso todo el proceso desde que se da de alta una recogida hasta que se entrega su albarán. Para ello utilizaremos de ejemplo una ruta de recogidas con una sola recogida y una ruta de entregas con una sola entrega, pero se ha de tener en cuenta que este caso no se dará normalmente en la vida real, ya que lo normal es que una ruta consista en varias recogidas o entregas.

El primer paso será dar de alta la recogida, tal como se detalla en la [[ayuda de recogidas]]. Cuando se da de alta la recogida, los campos ej.ruta y ruta estarán incializados a ceros ya que aún no se ha asignado a ninguna ruta y la fecha de recogida mostrará el valor 01/01/3000 ya que la recogida aún no se ha realizado.

Una vez creada la nueva recogida, podremos crear la ruta que englobará la recogida, o se podrá asignar a un ruta ya existente. Supongamos que la ruta aún no existe. Iremos al mantenimiento de rutas de recogidas y daremos de alta la ruta tal como se especifica en [[dgt0103|rutas]]. Al darla de alta veremos que la fecha de entrada es 01/01/3000, lo que indica que la ruta no se ha realizado, y por extensión tampoco sus recogidas. Ahora accederemos mediante el botón Detalles a la pantalla de detalles de la ruta de recogidas. En esta pantalla veremos que disponemos de dos botones, "Incluir zona" e "Incluir recogidas". Con el primer botón añadiremos a la ruta todas las recogidas de la zona indicada, y mediante el segundo podremos añadir cada recogida por separado. Mirar [[detalles de rutas]]. A continuación, el siguiente paso lógico sería volver a la pantalla de rutas e imprimir la hoja de ruta mediante el botón imprimir, para así poder darsela al chófer.

Cuando el chofer haya finalizado la ruta, iremos a la pantalla de mantenimiento de rutas y pondremos la fecha y hora de finalización. Al hacerlo, daremos por finalizada la ruta y por extensión sus recogidas, es decir, si consultamos las recogidas veremos que la fecha de finalización es igual a la fecha que hemos puesto en la ruta. Si ahora accedemos a la pantalla de detalles de la ruta, veremos que los botones de "Incluir zona" e "Incluir recogida" ya no existen, pero si el botón de incidencias. Si al realizar la ruta, el chofer ha tenido algún problema con alguna de las recogidas (p.ej.: que la dirección no exista), podremos indicarlo mediante este botón. Para ello clickaremos sobre el detalle de la ruta que corresponde a la recogida y le daremos al botón de incidencia, accediendo así a la pantalla de incidéncias de transporte (mirar [[incidencias de transporte]]). En esta pantalla, además de dar de alta la incidencia, tenemos la posibilidad de liberar la recogida, desasignándolo de la ruta y poniendo la fecha de finalización a 01/01/3000 para poder asignarse en una nueva ruta.

El siguiente paso será dar de alta los albaranes o expediciones de estas recogidas. Para ello iremos al mantenimiento de [[albaranes de transportes]]. Aquí daremos de alta el albarán escogiendo todos los datos o rellenándolos a partir de la recogida. La fecha de entrega será 01/01/3000 y la ruta cero, ya que no está ni entregado ni asignado a ninguna ruta. Entonces podremos generar los detalles del albarán de forma automática y añadir los que deseemos de forma manual. Una vez dado de alta se tendrá que crear una nueva ruta de entregas o acceder a una ya existente y, siguiendo el mismo proceso que con las recogidas, asignar el albarán a la ruta. El funcionamiento de finalización de la ruta, detalles de la ruta e incidencias es igual que con las recogidas.

Funcionamiento de la aplicación de transportes

2009-01-19T10:43:39Z

Albert Castilla Querol:

{| style="position:absolute; top:0; width:100%; background:#F8FCFF; color:#888;" valign="middle"
|-
|
<h1 style="margin:0; border-bottom:0;"><br>
Funcionamiento de la aplicación de transportes
|}

Para clarificar el funcionamiento de transportes, explicaremos paso a paso todo el proceso desde que se da de alta una recogida hasta que se entrega su albarán. Para ello utilizaremos de ejemplo una ruta de recogidas con una sola recogida y una ruta de entregas con una sola entrega, pero se ha de tener en cuenta que este caso no se dará normalmente en la vida real, ya que lo normal es que una ruta consista en varias recogidas o entregas.

El primer paso será dar de alta la recogida, tal como se detalla en la [[ayuda de recogidas]]. Cuando se da de alta la recogida, los campos ej.ruta y ruta estarán incializados a ceros ya que aún no se ha asignado a ninguna ruta y la fecha de recogida mostrará el valor 01/01/3000 ya que la recogida aún no se ha realizado.

Una vez creada la nueva recogida, podremos crear la ruta que englobará la recogida, o se podrá asignar a un ruta ya existente. Supongamos que la ruta aún no existe. Iremos al mantenimiento de rutas de recogidas y daremos de alta la ruta tal como se especifica en [[rutas]]. Al darla de alta veremos que la fecha de entrada es 01/01/3000, lo que indica que la ruta no se ha realizado, y por extensión tampoco sus recogidas. Ahora accederemos mediante el botón Detalles a la pantalla de detalles de la ruta de recogidas. En esta pantalla veremos que disponemos de dos botones, "Incluir zona" e "Incluir recogidas". Con el primer botón añadiremos a la ruta todas las recogidas de la zona indicada, y mediante el segundo podremos añadir cada recogida por separado. Mirar [[detalles de rutas]]. A continuación, el siguiente paso lógico sería volver a la pantalla de rutas e imprimir la hoja de ruta mediante el botón imprimir, para así poder darsela al chófer.

Cuando el chofer haya finalizado la ruta, iremos a la pantalla de mantenimiento de rutas y pondremos la fecha y hora de finalización. Al hacerlo, daremos por finalizada la ruta y por extensión sus recogidas, es decir, si consultamos las recogidas veremos que la fecha de finalización es igual a la fecha que hemos puesto en la ruta. Si ahora accedemos a la pantalla de detalles de la ruta, veremos que los botones de "Incluir zona" e "Incluir recogida" ya no existen, pero si el botón de incidencias. Si al realizar la ruta, el chofer ha tenido algún problema con alguna de las recogidas (p.ej.: que la dirección no exista), podremos indicarlo mediante este botón. Para ello clickaremos sobre el detalle de la ruta que corresponde a la recogida y le daremos al botón de incidencia, accediendo así a la pantalla de incidéncias de transporte (mirar [[incidencias de transporte]]). En esta pantalla, además de dar de alta la incidencia, tenemos la posibilidad de liberar la recogida, desasignándolo de la ruta y poniendo la fecha de finalización a 01/01/3000 para poder asignarse en una nueva ruta.

El siguiente paso será dar de alta los albaranes o expediciones de estas recogidas. Para ello iremos al mantenimiento de [[albaranes de transportes]]. Aquí daremos de alta el albarán escogiendo todos los datos o rellenándolos a partir de la recogida. La fecha de entrega será 01/01/3000 y la ruta cero, ya que no está ni entregado ni asignado a ninguna ruta. Entonces podremos generar los detalles del albarán de forma automática y añadir los que deseemos de forma manual. Una vez dado de alta se tendrá que crear una nueva ruta de entregas o acceder a una ya existente y, siguiendo el mismo proceso que con las recogidas, asignar el albarán a la ruta. El funcionamiento de finalización de la ruta, detalles de la ruta e incidencias es igual que con las recogidas.

Funcionamiento de la aplicación de transportes

2009-01-19T10:40:07Z

{| style="position:absolute; top:0; width:100%; background:#F8FCFF; color:#888;" valign="middle"
|-
|
<h1 style="margin:0; border-bottom:0;"><br>
Funcionamiento de la aplicación de transportes
|}

Para clarificar el funcionamiento de transportes, explicaremos paso a paso todo el proceso desde que se da de alta una recogida hasta que se entrega su albarán. Para ello utilizaremos de ejemplo una ruta de recogidas con una sola recogida y una ruta de entregas con una sola entrega, pero se ha de tener en cuenta que este caso no se dará normalmente en la vida real, ya que lo normal es que una ruta consista en varias recogidas o entregas.

El primer paso será dar de alta la recogida, tal como se detalla en la ayuda de recogidas. Cuando se da de alta la recogida, los campos ej.ruta y ruta estarán incializados a ceros ya que aún no se ha asignado a ninguna ruta y la fecha de recogida mostrará el valor 01/01/3000 ya que la recogida aún no se ha realizado.

Una vez creada la nueva recogida, podremos crear la ruta que englobará la recogida, o se podrá asignar a un ruta ya existente. Supongamos que la ruta aún no existe. Iremos al mantenimiento de rutas de recogidas y daremos de alta la ruta tal como se especifica en rutas. Al darla de alta veremos que la fecha de entrada es 01/01/3000, lo que indica que la ruta no se ha realizado, y por extensión tampoco sus recogidas. Ahora accederemos mediante el botón Detalles a la pantalla de detalles de la ruta de recogidas. En esta pantalla veremos que disponemos de dos botones, "Incluir zona" e "Incluir recogidas". Con el primer botón añadiremos a la ruta todas las recogidas de la zona indicada, y mediante el segundo podremos añadir cada recogida por separado. Mirar detalles de rutas. A continuación, el siguiente paso lógico sería volver a la pantalla de rutas e imprimir la hoja de ruta mediante el botón imprimir, para así poder darsela al chófer.

Cuando el chofer haya finalizado la ruta, iremos a la pantalla de mantenimiento de rutas y pondremos la fecha y hora de finalización. Al hacerlo, daremos por finalizada la ruta y por extensión sus recogidas, es decir, si consultamos las recogidas veremos que la fecha de finalización es igual a la fecha que hemos puesto en la ruta. Si ahora accedemos a la pantalla de detalles de la ruta, veremos que los botones de "Incluir zona" e "Incluir recogida" ya no existen, pero si el botón de incidencias. Si al realizar la ruta, el chofer ha tenido algún problema con alguna de las recogidas (p.ej.: que la dirección no exista), podremos indicarlo mediante este botón. Para ello clickaremos sobre el detalle de la ruta que corresponde a la recogida y le daremos al botón de incidencia, accediendo así a la pantalla de incidéncias de transporte (mirar Incidencias de transporte ). En esta pantalla, además de dar de alta la incidencia, tenemos la posibilidad de liberar la recogida, desasignándolo de la ruta y poniendo la fecha de finalización a 01/01/3000 para poder asignarse en una nueva ruta.

El siguiente paso será dar de alta los albaranes o expediciones de estas recogidas. Para ello iremos al mantenimiento de albaranes de transportes. Aquí daremos de alta el albarán escogiendo todos los datos o rellenándolos a partir de la recogida. La fecha de entrega será 01/01/3000 y la ruta cero, ya que no está ni entregado ni asignado a ninguna ruta. Entonces podremos generar los detalles del albarán de forma automática y añadir los que deseemos de forma manual. Una vez dado de alta se tendrá que crear una nueva ruta de entregas o acceder a una ya existente y, siguiendo el mismo proceso que con las recogidas, asignar el albarán a la ruta. El funcionamiento de finalización de la ruta, detalles de la ruta e incidencias es igual que con las recogidas.

Archivo:Dgt0410.png

2009-01-09T11:56:10Z

Albert Castilla Querol: Albaranes de transporte

Albaranes de transporte

Archivo:Dmliter 01.png

2009-01-09T11:55:21Z

Albert Castilla Querol: Tabla literales

Tabla literales

Dmliter 01

2009-01-09T11:53:35Z

Archivo:Boto 067.png

2009-01-09T11:31:37Z

Albert Castilla Querol: Guarda y sigue

Guarda y sigue

Tipos de campos

2009-01-09T10:43:28Z

Albert Castilla Querol:

Define la apariencia y tipo de información que podrá contener el campo.

==Campos alfanuméricos==

*'''Tipo''' : 'C'
*'''Pestaña''': '0' si no pertenece a ninguna pestaña o el índice de la pestaña a que pertenece.
*'''Etiqueta''': Escoger el literal adecuado de la [[dmliter 01|tabla de literales]].
*'''Posición etiqueta''':
**‘E’: Encima, en principio se tomará por defecto esta posición.
**‘I’: A la izquierda, se utilizará cuando el campo sea pequeño, por ejemplo campos tipo S/N.
**‘N’: Sin etiqueta.
*'''Número de dígitos'''
*'''Pos.1: (x,y)''': Corresponde a la esquina superior izquierda de la caja.
*'''Pos.2: (x,y)''':
**x: Cuando se necesita crear un campo de una determinada extensión gráfica, pero que el número de dígitos es superior a esta, indicamos en la x de la posición 2 la coordenada final del campo gráfico, y automáticamente cuando escribamos i no quepan más letras, ellas solas correrán.
**y: Si és 0, el campo se dibuja con altura por defecto de 18 pixels, si indicamos un valor, podemos ajustar la altura del campo. Si la altura supera los 24 pixeles la fuente del control es mayor.
*'''Contenido''':
**'X': Alfanumérico.
**'C': Clave, se visualizan asteriscos.
*'''Signo''': 0, no se utiliza
*'''Editado''': 0, no se usa.

==Campos numéricos==

*'''Tipo''' : 'C'
*'''Pestaña''': '0' si no pertenece a ninguna pestaña o el índice de la pestaña a que pertenece.
*'''Etiqueta''': Escoger el literal adecuado de la [[dmliter 01|tabla de literales]].
*'''Posición etiqueta''':
**‘E’: Encima, en principio se tomará por defecto esta posición.
**‘I’: A la izquierda, se utilizará cuando el campo sea pequeño, por ejemplo campos tipo S/N.
**‘N’: Sin etiqueta.
*'''Número de dígitos:''' sin contar comas, separadores de miles o signo.
*'''Pos.1: (x,y)''': Corresponde a la esquina superior izquierda de la caja.
*'''Pos.2: (x,y)''':
**x: No se utiliza.
**y: Si és 0, el campo se dibuja con altura por defecto de 18 pixels, si indicamos un valor, podemos ajustar la altura del campo. Si la altura supera los 24 pixeles la fuente del control es mayor.
*'''Contenido''': '0' si no tiene decimales, si los tiene, el número de decimales.
*'''Signo''': 0, no se utiliza
*'''Editado''': 0, no se usa.

==Campos fecha==

Las fechas se muestran en el formato: dd/mm/aaaa. El usuario puede omitir las barras separadoras en la introducción así como los 2 dígitos del milenio. El programa cliente se encarga de formatear la entrada.

*'''Tipo''' : 'C'
*'''Pestaña''': '0' si no pertenece a ninguna pestaña o el índice de la pestaña a que pertenece.
*'''Etiqueta''': Escoger el literal adecuado de la [[dmliter 01|tabla de literales]].
*'''Posición etiqueta''':
**‘E’: Encima, en principio se tomará por defecto esta posición.
**‘I’: A la izquierda, se utilizará cuando el campo sea pequeño, por ejemplo campos tipo S/N.
**‘N’: Sin etiqueta.
*'''Número de dígitos:''' No se utiliza. Se toman siempre diez dígitos.
*'''Pos.1: (x,y)''': Corresponde a la esquina superior izquierda de la caja.
*'''Pos.2: (x,y)''':
**x: No se utiliza.
**y: Si és 0, el campo se dibuja con altura por defecto de 18 pixels, si indicamos un valor, podemos ajustar la altura del campo. Si la altura supera los 24 pixeles la fuente del control es mayor.
*'''Contenido''': 'F'
*'''Signo''': 0, no se utiliza
*'''Editado''': 0, no se usa.
.

==Campo de texto==

*'''Tipo''': 'T'
*'''Etiqueta''': Escoger el literal adecuado de la [[dmliter 01|tabla de literales]] para que aparezca traducido al lenguaje del usuario. Si no es un código de literal, aparece directamente lo introducido aquí.
*'''Número de dígitos''': se utiliza para calcular el tamaño del control, en caso de que no se haya introducido pos. 2.
*'''Pos.1: (x,y)''': esquina superior izquierda del cuadro
*'''Pos.2: (x,y)''':
**x: Cuando se necesita crear un campo de una determinada extensión gráfica, pero que el número de dígitos es superior a esta, indicamos en la x de la posición 2 la coordenada final del campo gráfico, y automáticamente cuando escribamos y no quepan más letras, ellas solas correrán.
**y: Si és 0, el campo se dibuja con altura por defecto de 18 pixels, si indicamos un valor, podemos ajustar la altura del campo. Si la altura supera los 24 pixeles la fuente del control es mayor.
*'''Posición etiqueta''': Tamaño de la fuente, posibles valores:
**'P': Fuente pequeña
**'M': Fuente mediana
**'G': Fuente grande
**'F': Fuente de espaciado fijo.
**'L': Espaciado fijo, fuente grande
*'''Contenido''': ‘X’ , no se utiliza
*'''Signo''': 0, no se utiliza
*'''Editado''': 0, no se usa
*'''Pasar el control al salir''' : 0, no se usa
*'''Orden de tabulación''': en principio no se usa
*'''Pestaña''': si pertenece a alguna pestaña, su número si no 0.

==Botones==

*'''Tipo''': ‘B’
*'''Número de dígitos''': Se tomará para dimensionar la anchura del botón.
*'''Pos.1: (x,y)''': esquina superior izquierda del botón
*'''Pos.2: (x,y)''':
**x: Número de tecla aceleradora asociada al botón: 1:F1, 2: F2, etc. Listado de [[hot_keys|teclas aceleradoras]].
**y: No se utiliza.
*'''Etiqueta''': Escoger el literal adecuado de la [[dmliter 01|tabla de literales]]. Aparecerá dentro del botón.
*'''Pasar el control''': 1.

==Botones herramienta==

*'''Tipo''': ‘H’
*'''Contenido''':
**Si no se especifica nada, se utiliza para realizar cualquier acción que establezcamos mediante programación.
**'Y' Botón que muestra una página de ayuda, para más información ver el apartado [[tipos_de_campos#Bot.C3.B3n_de_ayuda|Botón de ayuda]].
**'I' Botón que arranca una nueva instancia de la aplicación con los mismos parámetros de conexión que la actual
*'''Etiqueta''': Escoger el literal adecuado de la [[dmliter 01|tabla de literales]]. Aparecerá cuando el puntero del ratón pase por encima del control (tooltip).
*'''Posición etiqueta''':
**'M': Tamaño medio, 24x24 pixels, valor por defecto
**'P': Tamaño pequeño, 17x17 pixels.
**'G': Tamaño grande, 30x30 pixels, apropiado para usarse en pantallas táctiles.
* '''Pos.2: (x,y)''':
**x: número de tecla aceleradora asociada al botón: 1:F1, 2: F2, etc. Listado de [[hot_keys|teclas aceleradoras]].
**y: se utiliza parar indicar la imagen que será el número asignado en el fichero resource.h del proyecto dgp21i01.
*'''Pasar el control''': 1.

==Botón de ayuda==

Pulsando el botón de ayuda, mediante el ratón o pulsando F1, se accede a la pagina html de ayuda en la posición que corresponda. El prefijo para construir el path completo de la página de ayuda lo resuelve el programa cliente en función del fichero de configuración: puede apuntar a paginas en la intranet de la empresa, internet o páginas locales. Este prefijo se guarda en dgp21.cfg de la forma siguiente:

# --- Path ajuda

ajuda=l:\libs\man\;

El path completo se obtiene añadiendo el código del idioma del usuario.

Por ejemplo, si el usuario ha escogido en la pantalla de conexión el código de idioma 'Fr', francés, las pantallas de ayuda se buscaran en:

l:\libs\man\Fr

Es un control tipo botón de ayuda con las siguientes particularidades:

*'''Tipo''': 'H'
*'''Contenido''': 'Y', ayuda.
*'''Valor por defecto''': Dirección página web y marcador de situación en la página, por ejemplo:

control_presencia1.htm#CP

[[Normas_estilo|Normas de estilo para las páginas de ayuda]]

==Cuadro==

Recuadro planos transparente o con un bitmap.
Como recuadro transparente se usa para agrupar visualmente controles relacionados.

*'''Tipo:''' 'U'
*'''Contenido''': 'B', para mostrar un bitmap, 'N' o cualquier otro, para mostrar un recuadro transparente.
*'''Valor por defecto''': Número de referencia del bitmap.
*'''Pos.1''': Esquina superior izquierda del recuadro.
*'''Pos.2''': Esquina inferior derecha.

==Pantalla o ventana==

Recuadro opaco y con relieve. Para visualizar una ventana superpuesta. Para aplicar el titulo a la ventana debe añadirse un control de tipo texto estático con fondo azul y letras blancas.

*'''Tipo:''' 'P'.
*'''Pos.1 (x,y)''': Esquina superior izquierda del recuadro.
*'''Pos.2 (x,y)''': Esquina inferior derecha.
*'''Tabulador:''' Si és distinto de cero significa que se quiere llamar la atención del usuario y por tanto se muestra la pantalla aunque en aquel momento la aplicación esté minimizada u oculta por otra aplicación.

==Texto extenso==

Controles tipo caja para albergar un texto extenso. Si el texto sobrepasa el área del control, aparece la barra de scroll vertical.

*'''Tipo:''' 'X'
*'''Contenido: 'M', Indicamos tipo de letra mediana, en cualquier otro caso letra por defecto.
*'''Número de dígitos: Longitud máxima del campo
*'''Pos.1 (x,y)''': Esquina superior izquierda del recuadro.
*'''Pos.2 (x,y)''': Esquina inferior derecha.

==Menú==

Tipo de campo utilizado en los menús.

*'''Tipo''': 'M'.
*'''Contenido: irrelevante.
*'''Pos. 2''': irrelevante, la anchura se fija en función del número de dígitos.
*'''Tipo de fuente''': fijado por la aplicación.

==Línea de listado==

Se utiliza para las líneas de listado. Pinchando sobre ellas se resaltan y suelen utilizarse para realizar alguna acción relacionada con la línea de datos.

*'''Tipo:''' 'I'
*'''Pos. 2''': irrelevante, altura fija, la longitud se fija en función del número de dígitos.
*'''Fuente''': fija.

==Campos tipo pestaña==

Habrá que definir tantos controles de este tipo como pestañas distintas. Cada una de ellas tendrá un núm. de orden distinto empezando por 1. El tamaño del control lo tomará de la pestaña con núm. pestaña = 1. Para asignar los controles a las pestañas habrá que indicar en ellos el núm. de pestaña al que pertenecen. Si núm. Pestaña = 0 no pertenece a ninguna pestaña.

Limitación sólo es posible 1 pestaña por pantalla.

*'''Tipo''': 'N'
*'''Etiqueta''': nombre de la pestaña
*'''Pos.1: (x,y)''': esquina superior izquierda del cuadro
*'''Pos.2: (x,y)''': esquina inferior derecha, sólo se tiene en cuenta para la Pestaña = 1
*'''Posición etiqueta''': poner ‘P’, de momento no se utiliza.
*'''Contenido''': ‘X’ , no se utiliza
*'''Signo''': 0, no se utiliza
*'''Número de dígitos''': no se utiliza, el tamaño de la pestaña depende de su etiqueta.
*'''Editado''': 0, no se usa
*'''Pasar el control al salir''': 0, no se usa
*'''Orden de tabulación''': en principio no se usa.
*'''Pestaña''': Núm. De pestaña empezando por 1.

==Campo tipo “Checkbox”==

*'''Estado''': campo que sólo permite 2 estados:
**Chequeado
** No chequeado.

*'''Tipo''': 'K'
*'''Etiqueta''': Nombre del campo
*'''Pos.1: (x,y)''': esquina superior izquierda del cuadro de chequeo
*'''Pos.2: (x,y)''': no se utiliza
*'''Posición etiqueta''':
**‘I’: A la izquierda
**‘N’: Sin etiqueta
**'D': A la derecha
*'''Contenido''':
**‘X’ : Si el campo está chequeado su valor es 'S', en caso contrario su valor es ' ' (un espacio)
**'B': Campo boleano estricto, si está chequeado su valor es 'S', en caso contrario es 'N'.
*'''Signo''': 0, no se utiliza
*'''Número de dígitos''': no se utiliza.
*'''Editado''': 0, no se usa

==Texto interactivo==

Campo de texto que al clicar sobre él con el ratón cambia de color. Se utiliza para las líneas de una grid. Se juega con los atributos para darle un fondo de color y crear el listado con colores alternos para cada línea.

*'''Tipo''': 'I'
*'''Etiqueta''': No se usa
*'''Pos.1: (x,y)''': esquina superior izquierda del cuadro
*'''Pos.2: (x,y)''': No se usa.
*'''Posición etiqueta''': Tamaño de la fuente, posibles valores:
**'P': Fuente pequeña
**'M': Fuente mediana
**'G': Fuente grande
**'F': Fuente de espaciado fijo.
*'''Contenido''': ‘X’ , no se utiliza
*'''Signo''': 0, no se utiliza
*'''Número de dígitos''': se utiliza para calcular la longitud del control..
*'''Editado''': 0, no se usa
*'''Pasar el control''': al salir = 1
*'''Orden de tabulación''': en principio no se usa.
*'''Pestaña''': si pertenece a alguna pestaña, su número si no 0.
*'''Pertenencia''': 'L' indica que pertenece a una grid.
*'''Enlazar control''': Cuando la pantalla que contiene la “grid” tiene un área de detalle con los campos de la línea del listado, entonces enlaza con el control 36 que es el encargado de rellenar ese detalle a partir del oid correspondiente a la línea seleccionada.
*'''Nota''': Este campo debe tener la función g_fijar que tiene como misión obtener el “oid” de la línea seleccionada.

Albaranes de transporte

2009-01-09T10:31:10Z

Albert Castilla Querol:

{| style="position:absolute; top:0; width:100%; background:#F8FCFF; color:#888;" valign="middle"
|-
|
<h1 style="margin:0; border-bottom:0;"><br>
Albaranes de transporte
|}

[[Media:Dgt0410.png|Pantalla ejemplo]]

Pantalla de mantenimiento de albaranes. En esta pantalla será donde daremos de alta, consultaremos y modificaremos los albaranes de transporte. Mirar [[dgt0410e|aplicación de transportes]] para saber como funciona todo el proceso de transportes.

=Campos=

=====Almacén=====
Es el número de almacén que se obtiene de los datos por defecto del usuario

=====Ej. (Ejercicio)=====
Es el número del ejercicio de ventas actual de su empresa

=====Número=====
Es el número de albarán, único y proporcionado por la aplicación.

=====Fecha=====
Es la fecha en la que se hace el albarán, por defecto la fecha de hoy.

=====Código de agencia y agencia=====
Es el código y el nombre de la agencia de transportes elegida

=====Referencia=====

=====Código, Remitente, Domicilio, Código Postal, Población, Provincia, País=====
Es el código y el nombre del remitente, puede ser un tercero u otra persona. El resto de campos también son referentes al remitente.

=====Código, Destinatario, Domicilio, Código Postal, Población, Provincia, País, Zona=====
Es el código y el nombre del destinatario, también puede ser un tercero u otra persona. El resto de campos también son referentes al destinatario.

=====Persona de contacto=====
Nombre de la persona de contacto.

=====Horario=====
Horario en el cual se puede ponerse en contacto con la persona de contacto.

=====Teléf.=====
Número de contacto.

=====C.envío=====
Código de envío.

=====Bultos=====
Número de bultos del que consta el albarán

=====Kilos=====
Total de kilos que suman los bultos

=====Volumen=====
Volumen que ocupan los bultos

=====Transitario=====

=====Código, Pagador por defecto=====
Es el código y el nombre del pagador o cliente, éste debe ser un tercero cliente.

=====Cod., Servicio=====
Código y nombre del servicio de la agencia de transportes.

=====Porcentaje de seguro=====
Porcentaje de seguro del cliente o pagador

=====Valor mercancía=====
Valor total de la mercancía

=====DUA=====
Número de identificación para aduanas.

=====Valor desembolso=====
% comisión desembolso
Porcentaje de la comisión de desembolso relacionado directamente con la línea elegida

=====DUA 2=====

=====Valor reembolso=====
% comisión reembolso
Procentaje de la comisión de reembolso relacionado directamente con la línea elegida

=====Condiciones de pago=====
Condiciones de pago también en función del cliente

=====Recogida=====
Número de ejercicio y número de recogida

=====Observaciones=====
Observaciones del albarán

=====Fecha de ent.=====
Fecha de la entrega, por defecto 01/01/3000, a la espera de que se modifique introduciendo la fecha de entrega.

=====Ej. (Ejercicio), Ruta=====
Ejercicio y el número de ruta asignado a el albarán.

=====Doid=====

Albaranes de transporte

2009-01-09T09:28:26Z

{| style="position:absolute; top:0; width:100%; background:#F8FCFF; color:#888;" valign="middle"
|-
|
<h1 style="margin:0; border-bottom:0;"><br>
Albaranes de transporte
|}

[[Media:Dgt0410.png|Pantalla ejemplo]]

Pantalla de mantenimiento de albaranes. En esta pantalla será donde daremos de alta, consultaremos y modificaremos los albaranes de transporte. Mirar [|aplicación de transportes] para saber como funciona todo el proceso de transportes.

=Campos=

=====Almacén=====
Es el número de almacén que se obtiene de los datos por defecto del usuario

=====Ej. (Ejercicio)=====
Es el número del ejercicio de ventas actual de su empresa

=====Número=====
Es el número de albarán, único y proporcionado por la aplicación.

=====Fecha=====
Es la fecha en la que se hace el albarán, por defecto la fecha de hoy.

=====Código de agencia y agencia=====
Es el código y el nombre de la agencia de transportes elegida

=====Referencia=====

=====Código del remitente y remitente=====
Es el código y el nombre del remitente, puede ser un tercero u otra persona

=====Código del destinatario y destinatario=====
Es el código y el nombre del destinatario, también puede ser un tercero u otra persona

=====Código del pagador y pagador=====
Es el código y el nombre del pagador o cliente, éste debe ser un tercero cliente

=====Transitario=====

=====Bultos=====
Número de bultos del que consta el albarán

=====Kilos=====
Total de kilos que suman los bultos

=====Volumen=====
Volumen que ocupan los bultos

=====Código de línea y línea=====
Código y nombre de la línea que seguirá la agencia de transportes

=====Observaciones=====
Observaciones del albarán

=====Condiciones de envío=====
Condiciones de envío del cliente

=====Facturar separado=====
Campo Sí/No para especificar si se factura separado o no

=====Porcentaje de seguro=====
Porcentaje de seguro del cliente o pagador

=====Seguro sobre valor=====
Seguro sobre valor determinado por la línea elegida

=====Valor mercancía=====
Valor total de la mercancía

=====Reexpedición=====
Campo Sí/No para especificar se reexpediciona o no

=====Valor desembolso=====

% comisión desembolso
Porcentaje de la comisión de desembolso relacionado directamente con la línea elegida

=====Valor reembolso=====

% comisión reembolso
Procentaje de la comisión de reembolso relacionado directamente con la línea elegida

=====Grupo de facturación=====
Grupo de facturación elegido, valor en función del cliente

=====Condiciones de pago=====
Condiciones de pago también en función del cliente

=====Recogida=====
Número de ejercicio y número de recogida

=====Fecha de entrega=====
Fecha de la entrega, por defecto 01/01/1980, a la espera de que se modifique introduciendo la fecha de entrega

=====Factura=====
Dos campos, serie de facturación y número de factura

Uso general de una pantalla

2009-01-07T10:14:54Z

Albert Castilla Querol:

Casi todas las pantallas de las aplicaciones Dgp21 tienen un funcionamiento muy similar. Aquí explicamos la funcionalidad común de una pantalla de la aplicación en la que efectuamos un mantenimiento de datos.

Vamos a tomar como ejemplo la pantalla de fichas comerciales de l'ERP i-Globalgest.

Arriba a la izquierda tenemos el código de la empresa, el usuario con el que estamos conectados y la versión del programa.

Abajo tenemos el nombre de la empresa, la pantalla en la que estamos, el código de dicha pantalla y la fecha.

[[Imagen:dgc0101.png|thumb|200px|right|none|Pantalla ejemplo]]

==Botones comunes==

Al acceder a cualquier pantalla de la aplicación de este tipo, casi siempre entraremos en modo consulta. Las pantallas y ante cualquier acción que queramos realizar deberemos seleccionar el icono correspondiente.

Hay una serie de iconos que van a ser comunes a todas las pantallas de la Gestión Comercial, y siempre van a tener la misma función.

También existe la posibilidad, mediante el teclado, de realizar algunas de las funciones de los iconos; son las teclas de acceso rápido.

A continuación se detallan estos iconos con su representación gráfica, su función y la correspondiente tecla de acceso rápido:

[[Imagen:boto_006.png]] Nuevo, F2. Para cualquier nueva acción que vayamos a realizar.

[[Imagen:boto_007.png]] Seleccionar, F3. Para hacer una selección según el criterio más conveniente.

[[Imagen:boto_008.png]] Modificar, F6. Para realizar cualquier tipo de modificación.

[[Imagen:boto_011.png]] Guardar, F5. Este botón solo aparece si estamos en el modo modificar o nuevo. Para guardar los cambios o el nuevo registro.

[[Imagen:boto_009.png]] Borrar. Para eliminar el registro que tengamos seleccionado en ese momento.

[[Imagen:boto_025.png]] Enviar mensaje, F7. Sistema de mensajería interna.

[[Imagen:boto_021.png]] Ayuda. Para cualquier duda que tengamos, estemos en la pantalla que estemos.

[[Imagen:boto_023.png]] Abrir otra sesión. Iniciar otras sesiones sin cerrar en la que estemos.

==Dar de alta [[Imagen:boto_006.png]]==

Para dar de alta debemos clicar en Nuevo; se nos activarán una serie de campos que debemos rellenar. Acto seguido clicamos en el botón de guardar para salvar la información dentro de la base de datos.

==Seleccionar/Buscar [[Imagen:boto_007.png]]==

Si lo que queremos es hacer una selección o búsqueda clicamos en el correspondiente icono, y de inmediato se activan los campos por los cuales podemos realizar búsquedas, que seguirá los criterios que le hayamos marcado nosotros. Si no recordamos al detalle lo que queremos buscar podemos introducir el símbolo del tanto por cien ''%'' para que nos busque una palabra clave (un registro que contenga dicha palabra); escribiremos dicho signo seguido de la palabra a buscar.

Por ejemplo si queremos buscar una empresa llamada Luces García,S.A pero solo nos recordamos que contiene la palabra luces, escribimos:
''%luces''
Al tener la selección hecha, clicamos en Buscar y en la Grid (parrilla).
De este modo nos saldrá un listado con las empresas. En nuestro ejemplo nos saldran las empresas que contengan la palabra ''luces''.
Si clicamos sobre uno de los registros veremos que los campos inferiores se rellenan con los datos pertenecientes al registro que hemos marcado.
En este punto no podemos realizar ninguna modificación, ni alta.

[[Imagen:Ventana_de_control.jpg]] La ''Ventana de control'' nos indica el número de registros que contiene la búsqueda que hemos realizado.

En la parte superior del listado que tenemos, vemos que estan los campos con la información para cada registro que tenemos de la búsqueda. Si clicamos en ''Código'', por ejemplo,se nos ordenarán todos los registros por el campo de ''Código'' y asi con todos según nuestro interés.

Los botones de navegación nos permiten avanzar y retroceder registros, de uno en uno, toda la página o de principio a final.

==Modificar [[Imagen:boto_008.png]]==

En caso que queramos modificar algun registro debemos marcar en registro y seguidamente clicar en el botón de ''Modificar'' o usar el acceso de teclado presionando ''F6''.
En ese momento los campos que podemos modificar se activaran y podremos clicar en ellos y realizar las modificaciones pertinentes. Una vez realizadas las modificaciones clicamos en el botón ''Guardar'' o ''F5''.

==Borrar [[Imagen:boto_009.png]]==

Para borrar simplemente nos debemos colocar sobre el registro que queramos eliminar y clicar en el botón ''Borrar''. Antes de borrar, la aplicación abre un mensaje de confirmación de borrado de registro, si estamos seguro de querer borrar, le damos a ''Aceptar'' y nos lo borrará.

==Enviar mensaje [[Imagen:boto_025.png]]==

Enviar un mensaje interno clicamos en el icono de Mensajes.
Inmediatamente después se nos abrirá una ventana como esta.

[[Imagen:Pmens.jpg|thumb|200px|right|none|Clica en la imagen para ver los puntos]]

'''1 –''' Aquí pondremos sí el mensaje va destinado a un grupo, a un usuario en concreto o a todos. Podemos darle al desplegable para ver que opciones tenemos.

'''2 –''' En caso de seleccionar ''Todos'' esta pestaña no tiene función ya que aquí es donde escogeremos a que grupo o usuario queremos enviar el mensaje.

'''3 –''' Aquí es donde escribiremos el cuerpo del mensaje.

'''4 –'''

''Enviar SMS'': opción dehabilitada.

''Retardo'': opción deshabilitada.

''Fecha aviso'': es donde pondremos la fecha que queremos que llegue el mensaje al receptor.

''Hora'': hora de llegada del mensaje.

''Vigencia'': es el tiempo, en minutos, que le damos de “vida” el mensaje. Por ejemplo si enviaramos un mensaje a todos los jefes de departamento de que hay una reunión a las 15:00 y uno de los jefes esta fuera por algun motivo y no esta conectado a la aplicación. Una vez pasado el tiempo de vigencia el mensaje se elimina para evitar que, al día siguiente, entre en la aplicación y le llegue el mensaje de que ayer había una reunión.
Así que sí el mensaje no ha sido leído, se eliminará cuando el tiempo expire.

''Urgente'': simplemente para marcar el mensaje como urgente.

''Aviso de recepción'': te notifica cuando el receptor abre el mensaje.

'''5 -''' Ventana donde escribiremos el mensaje de SMS, pero por ahora la opción esta desahabilitada.

==Otros==

[[Imagen:boto_021.png|left]]
Con este botón podremos acceder a la ''Ayuda'' en cualquier momento para saber qué hacer en cada pantalla y para qué sirve.

[[Imagen:boto_023.png|left]]
Para abrir otra sesión con el mismo usuario y en la misma empresa (tantas como nos hagan falta) presionamos el botón ''Abrir otra sesión'' y se nos abrirá otra pantalla. En la nueva pantalla estaremos situados en el menú y desde allí podremos hacer otra función de forma paralela a la anterior.

[[Imagen:Boto_249.png|left]]
Este botón, que esta presente al lado de diversos campos, sirve para dirigirnos a la pantalla de la tabla directamente relacionada con el campo para poder añadir algún registro a la tabla, para luego poder ponerlo en el campo. Una vez introducidos los cambios solo tenemos que clicar en el botón de cerrar la pantalla ( [[Imagen:Boto_12.png]] o F8)para salir de la pantalla actual e ir a la pantalla anterior.

[[Imagen:Boto_032.png|left]]

Otro botón, aunque no es un botón en sí, es la barra de desplazamiento vertical. Este botón tiene gran utilidad cuando nuestra selección engloba muchos registros y queremos desplazar rápidamente por toda la lista. Hacemos clic en el punto al que nos queremos ir en la barra vertical y automáticamente nos colocar en ese punto. Para indicarnos en que altura de la lista estamos, aparecerá una linea en la barra. En el caso que hagamos clic al final de la barra, puede que la linea no se coloque donde hemos hecho el clic, eso es debido a que la linea tiene un grosor internamente en proporción al volumen de nuestra tabla, pero estamos situados en el punto elegido.

Archivo:Boto 032.png

2009-01-07T10:13:55Z

Albert Castilla Querol: uploaded a new version of "Imagen:Boto 032.png": Ascensor

Ascensor

Archivo:Boto 032.png

2009-01-07T10:06:59Z

Albert Castilla Querol: uploaded a new version of "Imagen:Boto 032.png": Ascensor

Ascensor

Archivo:Boto 032.png

2009-01-07T09:55:52Z

Albert Castilla Querol: Ascensor

Ascensor

Direcciones alternativas

2008-12-22T11:56:49Z

Albert Castilla Querol:

{| style="position:absolute; top:0; width:100%; background:#F8FCFF; color:#888;" valign="middle"
|-
|
<h1 style="margin:0; border-bottom:0;"><br>
Direcciones de envío de albarán
|}

[[Media:Dgg0104.png|Pantalla ejemplo]]

Podemos establecer un número ilimitado de direcciones alternativas para un tercero. Estas direcciones se utilizan como direcciones de entrega para pedidos y albaranes. Por defecto la aplicación toma como dirección de entrega la primera definida para el tercero, aunque se puede seleccionar otra en el momento de introducir el pedido o albarán. Si el tercero no tiene ninguna dirección alternativa, se toma la dirección general.

Los datos aquí consignados aparecerán en la documentación de entrega generada por la aplicación.

=Campos=
=====Num.(Número)=====
Identificador númerico de la dirección alternativa, empezando por 1.
=====Nombre=====
=====Punto operacional EDI=====
=====N.I.F.=====
=====Domicilio=====
=====Teléfono=====
=====Fax=====
=====C.P.=====
=====Población=====
=====Provincia=====
=====País=====
=====Persona de contacto=====
=====Horario=====
=====Correo eléctrónico=====
=====Muelle=====
=====Zona=====
Se toma de la tabla de [[dgg0202|zonas]]. Permite agrupar los terceros en zonas geográficas para facilitar las tareas de entrega o recogida.
=====Referencia Registro Mercantil (EDI)=====

Direcciones alternativas

2008-12-22T11:21:19Z

Albert Castilla Querol:

{| style="position:absolute; top:0; width:100%; background:#F8FCFF; color:#888;" valign="middle"
|-
|
<h1 style="margin:0; border-bottom:0;"><br>
Direcciones de envío de albarán
|}

[[Media:Dgg0104.png|Pantalla ejemplo]]

Podemos establecer un número ilimitado de direcciones alternativas para un tercero. Estas direcciones se utilizan como direcciones de entrega para pedidos y albaranes. Por defecto la aplicación toma como dirección de entrega la primera definida para el tercero, aunque se puede seleccionar otra en el momento de introducir el pedido o albarán. Si el tercero no tiene ninguna dirección alternativa, se toma la dirección general.

Los datos aquí consignados aparecerán en la documentación de entrega generada por la aplicación.

=Campos=
=====Número=====
Identificador númerico de la dirección alternativa, empezando por 1.
=====Nombre=====
=====Domicilio=====
=====Teléfono=====
=====Fax=====
=====C.P.=====
=====Población=====
=====Provincia=====
=====País=====
=====Persona de contacto=====
=====Horario=====
=====Correo eléctrónico=====
=====Muelle=====
=====Zona=====
Se toma de la tabla de [[dgg0202|zonas]]. Permite agrupar los terceros en zonas geográficas para facilitar las tareas de entrega o recogida.
=====Referencia Registro Mercantil (EDI)=====

Direcciones alternativas

2008-12-22T11:20:10Z

Albert Castilla Querol:

{| style="position:absolute; top:0; width:100%; background:#F8FCFF; color:#888;" valign="middle"
|-
|
<h1 style="margin:0; border-bottom:0;"><br>
Direcciones de envío de albarán
|}

[[Media:Dgg0104.png|Pantalla ejemplo]]

Podemos establecer un número ilimitado de direcciones alternativas para un tercero. Estas direcciones se utilizan como direcciones de entrega para pedidos y albaranes. Por defecto la aplicación toma como dirección de entrega la primera definida para el tercero, aunque se puede seleccionar otra en el momento de introducir el pedido o albarán. Si el tercero no tiene ninguna dirección alternativa, se toma la dirección general.

Los datos aquí consignados aparecerán en la documentación de entrega generada por la aplicación.

=Campos=
=====Número=====
Identificador númerico de la dirección alternativa, empezando por 1.
=====Nombre=====
=====Domicilio=====
=====Teléfono=====
=====Fax=====
=====C.P.=====
=====Población=====
=====Provincia=====
=====País=====
=====Persona de contacto=====
=====Horario=====
=====Correo eléctrónico=====
=====Muelle=====
=====Zona=====
Se toma de la tabla de [[dgg0202|zonas]]. Permite agrupar los terceros en zonas geográficas para facilitar las tareas de entrega o recogida.
=====Referencia Registro Mercantil (EDI)=====

Direcciones alternativas

2008-12-19T08:56:12Z

{| style="position:absolute; top:0; width:100%; background:#F8FCFF; color:#888;" valign="middle"
|-
|
<h1 style="margin:0; border-bottom:0;"><br>
Direcciones de envío de albarán
|}

[[Media:Dgg0104.png|Pantalla ejemplo]]

Podemos establecer un número ilimitado de direcciones alternativas para un tercero. Estas direcciones se utilizan como direcciones de entrega para pedidos y albaranes. Por defecto la aplicación toma como dirección de entrega la primera definida para el tercero, aunque se puede seleccionar otra en el momento de introducir el pedido o albarán. Si el tercero no tiene ninguna dirección alternativa, se toma la dirección general.

Los datos aquí consignados aparecerán en la documentación de entrega generada por la aplicación.

=Campos=
=====Número=====
Identificador númerico de la dirección alternativa, empezando por 1.
=====Nombre=====
=====Domicilio=====
=====Teléfono=====
=====Fax=====
=====C.P.=====
=====Población=====
=====Provincia=====
=====País=====
=====Persona de contacto=====
=====Horario=====
=====Correo eléctrónico=====
=====Muelle=====
=====Zona=====
Se toma de la tabla de [[dgg0202|zonas]]. Permite agrupar los terceros en zonas geográficas para facilitar las tareas de entrega o recogida.

Archivo:Dgg0104.png

2008-12-19T08:46:56Z

Albert Castilla Querol: Direcciones de envío de albarán

Direcciones de envío de albarán

Mantenimiento de Terceros

2008-12-17T11:29:09Z

Albert Castilla Querol:

{| style="position:absolute; top:0; width:100%; background:#F8FCFF; color:#888;" valign="middle"
|-
|
<h1 style="margin:0; border-bottom:0;"><br>
Terceros
|}
----

[[Media:Dgg0102.jpg|Pantalla ejemplo]]

Los terceros son todas aquellas aquellas entidades, empresas o personas físicas con las cuales se efectúan transacciones comerciales. Los clientes y proveedores de la empresa son todos ellos terceros. Si tercero actúa como cliente y proveedor a la vez, sólo debe introducirse una vez.

En la pantalla de introducción de datos vemos que hay 3 apartados o pestañas:

:*General, datos generales
:*Cliente, datos que actúan en la relación del tercero como cliente
:*Proveedor, datos que actúan en la relación del tercero como proveedor

==Campos==

=====Código=====
Número de hasta 8 dígitos que identifica unívocamente el tercero. Podemos fijar ese número o bien solicitar a la aplicación que nos suministre uno, clickando el botón [[Imagen:Boto_066.png]], en este caso obtendremos el primer código de tercero libre.

El código 1 se reservará para la figura "Cliente o proveedor varios" , para utilizarse en operaciones con terceros no habituales.

=====Nombre=====
Nombre del tercero

=====Alias=====
Nombre, normalmente más corto que el completo, para reconocer al tercero sin necesidad de escribir todo el nombre, como por ejemplo las siglas de la empresa.

==Pestaña General==

=====Segundo nombre=====
Si el nombre de la empresa es tan largo que no nos cabe en el campo Nombre, lo continuamos en esta otro campo.

=====Persona de contacto=====

=====Domicilio=====

=====Teléfono=====

=====Fax=====

=====Cliente=====
Si el tercero es cliente en esta casilla deberemos poner una S; si no es cliente ponemos una N

=====Proveedor=====
Si el tercero es proveedor en esta casilla deberemos poner una S; si no es proveedor ponemos una N

=====C.P.=====
Código Postal.

=====Población=====

=====CIF=====
Código de identificación fiscal.
Rellenarlo sin utilizar guiones u otros signos de separación

=====CIFP=====
Código propio del país para el CIF

=====Provincia=====

=====Horario=====

=====Zona=====
Se toma de la tabla de [[dgg0202|zonas]]. Permite agrupar los terceros en zonas geográficas para facilitar las tareas de entregas o recogidas.

=====País=====
Identificador de país (ES, FR, ...).Los diferentes países están definidos en la tabla de [[dgg0207 | países]]. Es importante no olvidar introducir este dato. En función de este código se consideraran las operaciones interiores, intracomunitarias o exportaciones a efectos de IVA. Se recomienda la utilización de la codificación estandard [http://es.wikipedia.org/wiki/ISO_3166-1 ISO 3166-1].

=====Correo electrónico=====

=====Grupo de facturación=====
Se elige de la tabla de grupos de facturación.

=====Idioma=====
Se tomará de la tabla de [[dgg0011 | idiomas]]. La aplicación permite definir descripciones para artículos y otros objetos en diferentes idiomas. El idioma se toma en cuenta cuando se utilizan dichos objetos. Por ejemplo: cuando se hace un albarán a un cliente se toman las descripciones de los artículos en su idioma si están definidas.

=====Observaciones=====
Observaciones internas.

=====Moneda=====
Se tomará de la tabla de [[divisas01 | divisas]]. En las operaciones que se realicen con el tercero se tomará la divisa aquí indicada por defecto.

=====IVA=====
(S/N) Indica si hay que aplicar IVA en sus operaciones tanto de venta como de compra.

=====Recargo de equivalencia=====
(S/N) Indica si hay que aplicar recargo de equivalencia en sus operaciones de compra.

=====Certificado de calidad=====
(S/N) Si el cliente requiere certificados de calidad para los productos entregados, se indica aquí. Los certificados se generarán de forma automática al hacer los albaranes de entrega.

=====Etiquetas Odette=====
(S/N) Indica si las entregas de material para este cliente deben acompañarse con etiquetas "Odette", en cuyo caso se generan automáticamente en el momento de hacer el albarán de entrega.

=====Agentes comerciales=====
Podemos indicar hasta 3 agentes comerciales asignados al cliente. Deben estar introducidos previamente como [[dgg0107|agentes comerciales]].

==Campos comunes Pestaña Cliente/Proveedor==

Datos particulares en función del tipo de tercero.

=====Persona de contacto=====
Persona con la que nos pondremos en contacto para comunicarnos con la empresa.

=====Condiciones de envío=====
Condiciones de envío por defecto para el tercero. Pueden cambiarse para una operación concreta desde la introducción de pedidos o albaranes. Las diferentes condiciones de envío están definidas en la tabla de [[dgg0203 | condiciones de envío]].

=====Condiciones de pago=====
Condición de pago/cobro establecida con el tercero. Se utilizará para calcular vencimientos y formas de pago en la generación de facturas al tercero, tanto de compras como de ventas.
Cada condición de pago corresponde a una combinación de valores definidos en la tabla de [[dgg0204 | condiciones de pago]].

=====Días de pago=====
Si para el tercero tenemos establecidos días de pago, lo indicamos aquí. Se utiliza para calcular los vencimientos de las operaciones de compra o venta en conjunción con las condiciones de pago. Pueden fijarse hasta 3 días de pago.

=====Mes de vacaciones=====
Si se indica, interviene el cálculo de vencimientos de las operaciones con el tercero, los vencimientos para el mes de vacaciones son retrasados al mes siguiente.

=====Dto comercial=====
Descuento comercial.
Porcentaje de descuento (nn,nn%) aplicado a pie de factura. Se utiliza en el cálculo de facturas del tercero.

=====Dto p.p./rec.fin=====
Descuento pronto pago o recargo de financiación
Porcentaje de descuento o recargo (nn,nn%). Si el porcentaje es de signo positivo toma la consideración de recargo de financiación, si es negativo es un descuento pronto pago. Se utiliza en el cálculo de facturas del tercero.

=====Seg. Transp.=====
Seguro de Transportes
Tiene efecto en la Gestión para Empresas de Transporte.
Indica si el cliente quiere que la mercancía viaje asegurada y en consecuencia se aplique el seguro en el cálculo de los transportes.

=====C.C.C.=====
Identificación de la cuenta en la que se domicilian los pagos.
Si se indica una cuenta de una entidad bancaria Española, deben ser 20 dígitos numéricos sin caracteres de separación.

=====Domicilio de pago=====
Domicilio en el que se atenderán los pagos/cobros de los efectos cuando difiera del domicilio del tercero.

=====Cuenta de cancelación=====
Es la cuenta contable por defecto en la que se prevee efectuar el pago/cobro de los efectos. Debe estar definida en el [[cuentas001 | plan contable]].

=====Dirección de correo electrónico=====

=====Cuenta contable=====
Es la cuenta en que se anotarán las operaciones con el tercero. Puede dejarse en blanco, en cuyo caso se dará de alta automáticamente de la forma: "grupo contable por defecto" + "código tercero". Si por el contrario se indica una cuenta, esta debe existir en el [[cuentas001 | plan contable]]. El grupo contable por defecto se fija en la configuración general de la empresa.

=====Referencia=====
Si el tercero nos ha asignado un código o referencia con el que nos identifica, lo podemos indicar aquí. Podrá aparecer en los documentos que se generen para él, por ejemplo: pedidos a proveedores, pedidos, albaranes y facturas a clientes.

=====Albarán valorado=====
(S/N) Indicamos si los albaranes de este tercero estarán valorados (tendrán importe) o no.

=====Riesgo=====
Importe máximo de riesgo que hemos asignado al cliente o que el proveedor nos ha asignado a nosotros. La aplicación nos alerta o bloquea las operaciones que van a superar este riesgo.

=====Bloqueado=====
(S/N) Mediante este campo podemos bloquear un tercero de forma que la aplicación no permita operar con él.

=====Intrastat=====
Son códigos de utilidad para la generación de la declaración del Intrastat.

=====Factura por albarán=====
En este campo indicaremos si por cada albarán se hace una factura (S) o si se facturan todos los albaranes de una sola vez (N).

=====Ret.Garantía=====
Porcentage de retención (nn,nn%). Informa si al efectuar una factura a cliente o al introducir una factura de proveedor hay que aplicar una retención por garantía.

=====Cuenta ret. garantía=====
Cuenta contable donde se contabilizará en su caso el importe de retención por garantía. Por defecto la aplicación propone una cuenta, pero puede cambiarse si se desea. Dicha cuenta se creará automáticamente

=====Ret. IRPF=====
Porcentaje de retención (nn,nn%) por IRPF que se aplica en las facturas del tercero. Si se indica un valor debe indicarse a su vez la cuenta de IRPF que recogerá la contabilización de las retenciones.

=====Cuenta I.R.P.F.=====
Cuenta contable utilizada para contabilizar las retenciones de las facturas del tercero. Si hemos especificado el porcentaje de retención del I.R.P.F, hemos de introducir esta cuenta.Dicha cuenta debe estar previamente definida en el [[cuentas001 | plan contable]].

=====IBAN=====
El Código Internacional de Cuenta Bancaria (IBAN) es un número de identificación que permite validar internacionalmente una cuenta que tenga un cliente en una entidad financiera.

Tanto el IBAN como el CCC (estándar español de cuentas) identifican la misma cuenta.

El IBAN puede utilizarse en todas las operaciones con el extranjero, con todos los países del mundo, y sirve principalmente para identificar la cuenta bancaria en los pagos internacionales.

=====BIC=====
Código internacional de identificación bancaria es aquel que permite identificar de forma única a cada entidad de crédito y/o sus oficinas.

Consiste en 8 u 11 caracteres alfanuméricos con el siguiente significado:

* Código entidad de crédito: son 4 caracteres identificativos de la institución financiera a nivel mundial.
* Código país: son 2 caracteres que identifican al país (o territorio geográfico) donde está ubicada la unidad central de negocio de la entidad de crédito.
* Código localidad: son 2 caracteres identificativos de la región o ciudad donde está ubicada la unidad central de negocio de la entidad de crédito.
* Código oficina: son 3 caracteres que identifican una determinada oficina o departamento de la institución financiera.

=====Agencia de transportes=====
Agencia de transportes asignada al tercero. Al introducir pedidos y albaranes del tercero, se tomará este valor por defecto. Se toma de la tabla de [[dgg0105 | agencias de transportes]].

=====Observaciones=====
Observaciones internas.

=====A1, A2=====
Campos alfanuméricos libres para guardar cualquier valor que el usuario desee.

=====N1, N2=====
Campos numéricos libres para guardar cualquier valor que el usuario desee.

==Campos exclusivos de Pestaña Cliente==

=====Serie de facturación=====
Este dato se utiliza en la generación de facturas para el tercero. La numeración de las facturas generadas se toma de la serie de facturación. Por defecto se toma la serie <nowiki>'General'</nowiki>, pero puede establecerse una serie específica para un tercero. Los posibles valores se definen en la tabla de [[dgg0213 | series de facturación]].

=====Riesgo aseg.=====
Riesgo asegurado.
Indica el importe de riesgo asegurado para el tercero
=====Entidad aseguradora=====
Entitad en la cual hemos asegurado el importe de riesgo anterior.

==Campos exclusivos de Pestaña Proveedor==

=====ISO Doc.=====
Referencia del documento ISO.
Referencia correspondiente al documento de certificación ISO del proveedor, incorporado en la [[dgd0101 | gestión de documentos]]. Clickando en el botón [[Imagen:Boto_063.png]], podremos consultarlo.

=====Hasta fecha (ISO Doc.)=====
Fecha de caducidad del documento anterior.

=====Reg. Sanitario.=====
Referencia del documento de registro sanitario.
Referencia correspondiente al documento de registro sanitario del proveedor, incorporado en la [[dgd0101 | gestión de documentos]]. Clickando en el botón [[Imagen:Boto_063.png]], podremos consultarlo.

=====Hasta fecha (Reg. Sanitario)=====
Fecha de caducidad del documento anterior.

==Botones especiales==
[[Imagen:Boto_160.png|left]] ''Direcciones de envío de factura'': Puede pasar que una misma empresa tenga distintas sedes a las que enviar las facturas; en caso de que sea así, este botón nos mostrará las que hay.

[[Imagen:Boto_150.png|left]]
''Direcciones de envío de albaranes'': lo mismo que el caso anterior, pero en lugar de ser facturas serán albaranes. Hacer clic para ver la ayuda de [[dgg0104|direcciones de envío de albaranes]]

[[Imagen:Boto_149.png|left]]
''Listado de impreso'': nos presenta un listado en el que podemos incluir Clientes, Proveedores o Agentes, y puede ser ordenado por código o por nombre.

[[Imagen:Boto_219.png|left]]
''Salir'': este botón sólo nos aparecerá cuando estemos en otra pantalla y vayamos a realizar cualquier consulta sobre un tercero; al realizar una búsqueda este botón nos permite salir cargando los datos de aquello que hemos buscado.

Mantenimiento de artículos

2008-12-17T11:21:40Z

Albert Castilla Querol:

{| style="position:absolute; top:0; width:100%; background:#F8FCFF; color:#888;" valign="middle"
|-
|
<h1 style="margin:0; border-bottom:0;"><br>
Artículos
|}

[[Media:Dgg0101.jpg|Pantalla Artículos]]

En esta pantalla se definirán los artículos que vaya a gestionar la aplicación. Cada artículo tendrá asignada una ficha que contendrá toda la información referente a él.

=Campos=
=====Artículo=====
=====Código=====
Valor alfanumérico de 15 dígitos y será único para cada artículo.

=Pestañas=

==General==
=====Tipo=====
=====Costes=====
Campo con un valor S/N para especificar si se quiere llevar a cabo un control de coste.
=====Centro de costes=====
Especifica el centro de coste en el que se compra o vende dicho artículo.
=====Peso neto=====
=====Neutro=====
(S/N)
=====Intrastat=====
=====Indice de revisión=====
=====Nº días de caducidad=====
=====Observaciones=====
=====A1,A2,A3=====
Son tres campos alfanuméricos para uso de la empresa, en los que pondrá lo que se considere necesario.
=====N1, N2, N3=====
Son tres campos numéricos para uso de la empresa, en los que pondrá lo que se considere necesario.
=====Código EAN=====

==Ventas==
=====Cambio tarifa=====
Última fecha en la que se produjo un cambio de tarifa sobre el precio del artículo.
=====Bloqueado ventas=====
Este campo especificará si el artículoestábloqueado para ventas o no.
=====Tipo kit=====
=====Tipo IVA=====
Número del 1 al 4 que indica qué tipo de IVA se le aplica al producto
=====Precio venta=====
Precio de venta al público del artículo, sin IVA. Podrá tener hasta cinco decimales.
=====Precio venta anterior=====
Precio de venta al público antes del último cambio de tarifa.
=====Cuenta ventas=====
Número de cuenta contable mediante el cual deben contabilizarse las ventas que se realicen de dicho artículo.
=====Descripción=====
=====C. vent. exportación=====
Número de cuenta contable mediante el cual deben contabilizarse las ventas que se realicen de exportaciones
=====Descripción=====
=====Se vende=====
Especifica si un artículo está en venta actualmente o no.
=====Descr. ampliada=====
=====Importe punto verde=====
=====Descuento P.P.=====
Casilla en la que se indica con un sí (S) o un no (n) si se aplica un descuento por pronto pago.
=====Dto. Comercial=====
Casilla en la que se indica con un sí (S) o un no (n) si se aplica algún descuento comercial.
=====Recargo financiero=====
Casilla en la que se indica con un sí (S) o un no (n) si se aplica algún recargo financiero.

==Compras==
=====Bloqueado c.=====
Campo que indica si el artículo está bloqueado o no. En caso que lo esté no se podrá unir a pedidos ni albaranes.
=====Precio de compra=====
=====Proveedor habitual=====
Proveedor habitual del producto
=====Num. serie=====
Especifica si tiene número de serie o no.
=====Garantía=====
=====Compra controlada=====
=====Cuentas compras=====
Número de cuenta contable desde donde se contabilizarán las facturas de los proveedores.
=====Descripción=====
=====C. com. importación=====
Número de cuenta contable desde donde se contabilizarán las facturas de los proveedores de compras de importación
=====Descripción=====
=====Descripción ampliada=====

==Fabricación==
=====Número de plano=====
=====Ficha técnica=====
=====Bloqueado fab.=====
Campo que especifica si el artículo está bloqueado o no en el proceso de fabricación.
=====Nivel escandallo=====
Número de nivel que le corresponderá al artículo en el escandallo al que pertenezca (valor entre 1 y 9).
=====Ctrl. Calidad Salida=====
=====Observaciones=====
=====Almacén origen=====
=====Almacén destino=====

==Stock==
=====Controlar stock=====
En este campo se especificará si se quiere llevar o no a cabo un control de stock.
=====Stock mínimo=====
=====Punto de pedido=====
=====Unidad primaria=====
=====Unidad secundaria=====
=====Lote lanzamiento=====
=====Plazo reaprov.=====
=====Tipo de aprovisionamiento=====
=====Factor conversión=====
=====Tipo factor=====
(F/V)
=====C. Ubica.=====
=====Ctrl. lote=====
=====Ud. ventas=====
=====Ud. compra=====
=====Ud. de fabricación=====
=====Ud. cons./coste=====

Funciones

2008-12-12T11:58:35Z

Albert Castilla Querol:

Funciones
Valores de entorno
En las funciones pueden utilizarse los siguientes valores de entorno:
*&$idi : Idioma de la sesión.
*&$ipn: Ip de la sesión.
*&$usu: Código de usuario conectado
Referencias a controles
En los campos de sentencia SQL y parámetros de la función,
podemos hacer referencia al contenido de los campos de la pantalla
indicando el número de contorl (3 dígitos) precedido por #. De esta manera
se substituirá el contenido del campo indicado por el conjunto #XXX.

Ejemplos:
select * from abtdt where doid=#006;
msg0003 ,#078, ref001, 101

====g_aceptar====
*Sale de la pantalla devolviendo un 0 en el estatus.
*Si se han utilizado enlaces, devuelve los campos enlazados actualizados a la pantalla anterior.

====g_borrar====
*Pide confirmación del borrado de la fila
*Ejecuta la sentencia DELETE especificada en el campo sql.
*Después se ejecuta un [[Funciones#g_consulta|g_consulta]] (poner a modo consulta) de cabecera y detalle que coge los parámetros indicados al [[Funciones#g_borrar|g_borrar]] (ver parámetros de [[Funciones#g_consulta|g_consulta]]).
*Si no recibe ningún parámetro se comporta como si hubiera recibido un 0.
*Además de los parámetros del [[Funciones#g_consulta|g_consulta]], [[Funciones#g_borrar|g_borrar]] tiene un parámetro adicional, a continuación de los anteriores, que indica si se ha de registrar la operación (usuario, hora, ip...): s para registrar, n para no registrar, si no se indica nada coge por defecto n.
*Si el usuario aprieta el botón Aceptar el control 1 guardará el valor 0, si aprieta el botón Cancelar, dicho valor será mayor que 0.
*Ejemplo: 3 51 52 63,s

====g_list====
Se usa para rellenar una grid con los datos obtenidos la consulta SQL especificada. La grid puede ser la de la misma pantalla donde utilizamos la función o bien otra pantalla que especifiquemos.
*Uso: <br >para rellenar la grid de la misma pantalla en que se usa la función.
*Parámetros función:<br \>Ninguno.
*Sentencia SQL:<br \>Sentencia SQL cuyo resultado queremos mostrar.
*Pares de campos o descripción del listado:<br \>Formato o descripción del listado. Para cada columna del select deberemos indicar el formato: 'N' para campos numéricos, 'E' para campos numéricos con separacion con punto en los millares (en este caso debemos tener en cuenta los puntos a la hora de calcular la extensión del campo en el listado), 'X' para campos alfanuméricos y 'V' para campos de longitud variable; y seguidamente la longitud a reservar para cada columna indicada con 2 o 3 dígitos, separando los campos con comas. Podemos jugar con la longitud para truncar los datos de una columna o ampliar el espacio de una columna para poder mostrar un título mas extenso. <br >Como todos los campos tienen que ir seguido de dos dígitos, para el formato 'V', que no tiene función alguna, por convenio y para evitar confusiones pondremos siempre 99.
En los campos que sean numéricos ('E' y 'V') tenemos la opción de ocultar los valores que sean 0. Lo indicaremos mediante minúscula, o sea con la letra del parámetro en minúscula:
e14,n10...
*Ejemplo:<br >Sentencia SQL:
select cco_codi, cco_desc, cco_abierto, cco_descamp from cco
<br >Descripción del listado:
N06,X130,X07,e10,V99...
Uso de g_list para rellenar y mostar datos en una grid de una pantalla distinta a la pantalla en que se usa la función.
Parámetros función.
1.Nombre de la pantalla a mostrar con el resultado de la senetencia select especificada
2.Fijo, valor 033
3.Incluir 1º columna con oid de la tabla principal de la select: 's': incluirla, 'n': no incluirla.

La primera columna del select se utiliza como identificador de la fila, debe contener un valor que identifique de forma univoca la fila, este valor se situa en en el campo 006 de la pantalla cada vez que el usuario clica en una linea de la grid. Con este valor podemos identificar el valor que ha seleccionado el usuario y actuar en consecuencia.
Si no se especifica este parámetro o bien especificamos una 's', la función inserta de forma automática en el resultado de la select, una primera columna con el oid de la 1ª tabla especificada en la sentencia select. Si queremos utilizar una columna distinta para identificar la fila que seleccione el usuario especificamos una 'n' en el 3er parámetro, en este caso la 1ª columna del select especificado actuará como identificador de la fila.
Enlaces.
Pares de campos a enlazar con la pantalla especificada en el apartado anterior. Por lo menos enlazaremos el campo 033 y el campo 006 para recuperar el resultado de la selección efectuada por el usuario sobre la grid mostrada.
Sentencia SQL
Sentencia SQL cuyo resultado queremos mostrar.
Pares de campos o descripción del listado
Formato o descripción del listado. Para cada columna del select deberemos indicar el formato: 'N' para campos numéricos o 'X' para campos alfanuméricos y la longitud a reservar para cada columna indicada con 2 dígitos. Podemos jugar con la longitud para truncar los datos de una columna o ampliar el espacio de una columna para poder mostrar un título mas extenso.
Ejemplo:
Parámetros función:
dgsel 01,033
Enlaces:
006=006,033=033
Sentencia SQL:
select trn_nom,trn_codi from transporte where trn_nom ilike '#052%' order by trn_nom
Descripción del listado:
X20N08

====g_borrdoc====
Borra del ordenador local el archivo indicado mediante tres parámetros:
*1,2: Los dos primeros son los controles que identifican este archivo como único. Si el segundo no es necesario dejaremos el parámetro en blanco pero sin obviar las comas.
*3: El control que guardar la extensión del archivo a eliminar.

====g_buscar====
*Ejecuta el select especificado en el SQL.
*Rellena los campos de la pantalla en función de los pares de campos.
*Lanza un [[Funciones#g_consulta|g_consulta]] pasándole los parámetros especificados.
*Si no recibe ningún parámetro se comporta como si hubiera recibido un 0.
*Parámetros:
**0: No modifica ningún control.
**1: Inicializa todos los controles a su valor por defecto
**2: Inicializa los controles mayores que 50 a su valor por defecto.
**3: Inicializa todos los controles a excepción de los indicados, por ejemplo: 3,51,52,63

====g_consulta====
*Pone la pantalla en modo consulta
*Inicializa los controles de acuerdo con los parámetros que recibe
*Parámetros:
**0: No modifica ningún control.
**1: Inicializa todos los controles a su valor por defecto
**2: Inicializa los controles mayores que 50 a su valor por defecto.
**3: Inicializa todos los controles a excepción de los indicados a continuación, separados por espacios, por ejemplo: 3 51 52 63

====g_csv====
Transmite al programa cliente la selección de datos actual en formato csv y el programa cliente abre automáticamente el fichero con la aplicación asociada a este tipo de datos, habitualmente Excel u Open Office.
*Parámetros función: Esta función no tiene parámetros

====g_dupdoc====
*Se usa para ordenar al cliente que copie un documento como otro. El documento origen debe estar ya en la máquina cliente.
*Parámetros de la función:
*Referencia documento origen
*Versión documento origen
*Tipo de documento
*Referencia documento destino
*Versión documento destino

====g_ejecuta====
*Ejecuta la sentencia sql especificada.
*Número de parámetros: 3
**Parámetro 1:
***0: Da error si no hay filas o si hay un error devolviendo un 1 en el primer caso o un 2 en el segundo en el control de status, control 1. <br \>Podemos capturar el valor dentro del código de programación mediante un campo numérico, por ejemplo:
stat numeric(2,0)@1;
***1: Sólo avisa si hay un error de base de datos y devuelve un 2 en el control de status, control 1.
***2: No avisa nunca y devuelve un 0 en el control de status, control 1, como si no hubiese habido ningún error.
***3: No avisa nunca pero devuelve un 1 o un 2 en el control de status, control 1, dependiendo de si el error es que no hay filas o si es un error de base de datos.
**Parámetro 2:
***'s': La sentencia sql se depurará antes de ejecutarse. Por ejemplo en sentencias selects se eliminan las condiciones de la clausula where de los campos que no tienen ningún valor
***'n': La sentencia sql se ejecutará sin ningún cambio.
**Parámetro 3:
***Número de control donde se almacenaran el número de filas afectadas por el select de la función, si no se desea guardarlas en ningún control introducir el valor 0. Su aplicación tiene utilidad en la programación interna.
**Parámetro 4:
***'s': la operación se registrará (usuario, ip, hora...) en el log.
***'n': la operación no se registrará en el log, opción por defecto.

====g_envdoc====
Envía un documento desde el ordenador cliente al servidor. En el servidor mira cual es la versión actual y le cambia el nombre aumentando en uno el número de versión.
*Parámetros función:
**1,2: Los dos primeros son los controles que identifican este archivo como único. Si el segundo no es necesario dejaremos el parámetro en blanco pero sin obviar las comas.
**3: El control que guarda la extensión del archivo, para poder completar el nombre.

====g_envfit====
Transmite al programa cliente la selección de datos actual. El cliente transforma el fichero al formato especificado en Parámetros Función y abre el fichero para su consulta o edición.
*Parámetros función:
**a: Formato RTF
**b: Formato texto plano

====g_exeapl====
*Ejecuta el archivo indicado mediante tres parámetros:
**1,2: Los dos primeros son los controles que identifican este archivo como único. Si el segundo no es necesario dejaremos el parámetro en blanco pero sin obviar las comas.
**3: El control que guarda la extensión del archivo a ejecutar, para así sepa que aplicación ha de utilizar para realizar la acción.

====g_imprimir====
Manda el impreso en cuestión a imprimir en el formato y en la impresora especificados mediante los parámetros:
*1: Formato. Indica el formato del impreso ha imprimir.
*2: Impresora. Indica en que impresora se ha de imprimir el impreso
*3: Previsualizar. Indica si se ha de previsualizar el impreso.

====g_llamar====
Enlaza con la pantalla especificada y opcionalmente ejecuta un control.
*Parámetros:
**Nombre de la pantalla a enlazar, sin comillas.
**Núm de control a ejecutar. Si no se quiere ejecutar ningún control al inicio, omitimos este segundo parámetro

*Enlaces: <br >En los enlaces indicaremos los campos que van a intercanviar datos con la pantalla llamada, sin comillas, con 3 dígitos y separados por comas, mediante los signos siguientes:
**< : indica solo retorno.
**= : indica envío y retorno.
**> : indica solo envío.
**Ejemplo:
052<027,056=015, 057>067
El el campo 52 de la pantalla origen recibirá el valor del campo 27 de la pantalla destino, pero el 27 no recibirá nada;
el campo 56 de origen y el 15 de destino se intercambiaran el contenido, tanto al ir, como al volver;
el campo 57 enviará la información al 67 al ir, pero al volver no recojerá ningún dato..
Si queremos que al salir de la página llamada se pasen también los datos
la pantalla deberá salir con un [[Funciones#g_aceptar|g_aceptar]], si por el contrario sale con un [[Funciones#g_salir|g_salir]]no se pasará ningún dato.

*Ejemplo:
g_llamar, Parámetros: h_personal,011

====g_fijar====
*Pone el oid del registro seleccionado en la grid
**Par&aacutemetro 1: Indica el control que ha sido seleccionado, independientemenete de si
lo ha clickado el usuario o no.
====g_foco====
Coloca el foco en el control indicado en el parámetro.
*Parámetro: El número de control que deseamos reciba el foco.

====g_mens====
*Permite mostrar un mensaje por pantalla para el usuario.
*Esta función se llama con 4 parámetros, que son:
**1: La pantalla que se quiere utilizar para mostrar el error, 10 dígitos alfanuméricos. <br >Valores posibles (msg0001, msg0002, msg0003... msg0008).
**2: El código del error que quiere mostrarse, definido previamente en la tabla dgmens. 10 dígitos alfanumérico.
**3: Una referencia identificadora del error, 6 dígitos alfanuméricos.
**4: Un campo de la pantalla cuyo contenido quiera mostrarse en el mensaje, 3 dígitos numéricos.
***La pantalla que aparece con el mensaje siempre contendrá uno o dos botones (un “Aceptar” y un “Cancelar”). Si se clicka en aceptar la función devolverá un 0 en el campo 1 (estado), mientras que si se clicka en cancelar devolverá un 1.
*Los dos primero parámetros son obligatorios y deben existir, teniendo en cuenta de intercalar cuatro espacios entre el código de pantalla y el código de formato, si quiere omitirse la referencia pero en cambio se quiere poner el cuarto parámetro, deberá hacerse de la siguiente forma, por ejemplo:
msg0001, msg_err, , 53

Las pantallas con las que se muestran los errores se pueden crear o cogerlas ya predeterminadas:

[[Imagen:msg_0001.png|frame|none|msg0001]]
[[Imagen:msg_0002.png|frame|none|msg0002]]
[[Imagen:msg_0003.png|frame|none|msg0003]]
[[Imagen:msg_0004.png|frame|none|msg4 01]]
[[Imagen:msg_0005.png|frame|none|msg5 01]]
[[Imagen:msg_0006.png|frame|none|msg6 01]]
[[Imagen:msg_0007.png|frame|none|msg7 01]]
[[Imagen:msg_0009.png|frame|none|msg9 01]]

====g_modificar====
*Pone el estado 'Modificar' estableciendo los atributos de los campos para ese estado.
*Sentencia sql y pares de campos, existen dos opciones:
**Introducir una sentencia select específica (normalmente para bloquear el registro), indicando también los pares de campos que debe rellenar
**Dejar la sentencia select en blanco, en ese caso por programación hay que ejecutar previamente el control 36 (exeb(36)) para refrescar los datos que se vayan a modificar.
*Parámetros:
**0: No modifica ningún control.
**1: Inicializa todos los controles a su valor por defecto.
**2: Inicializa los controles mayores que 50 a su valor por defecto.
**3: Inicializa todos los controles a excepción de los indicados, separados por espacios, por ejemplo: 3 51 52 63

====g_nuevo====
*Pone en estado de altas
*Establece los atributos correspondientes al estado de altas.
*Inicializa los campos de acuerdo con sus valores por defecto en función de los parámetros recibidos.
*Si no recibe ningún parámetro se comporta como si hubiera recibido un 1.
*Parámetros:
**0: No modifica ningún control.
**1: Inicializa todos los controles a su valor por defecto.
**2: Inicializa los controles mayores que 50 a su valor por defecto.
**3: Inicializa todos los controles a excepción de los indicados, separados por espacios, por ejemplo: 3 51 52 63

====g_rebdoc====
Esta función envía una copia del archivo referenciado en pantalla desde el servidor al ordenador local.
Para ello se le pasan cuatro parámetros: el modo de apertura del archivo, los controles que identifican este archivo y la extensión del archivo.
*1: Tiene cuatro posibles valores: 'r','w','R','W'. En los dos primeros casos se indica como vamos a copiar el archivo (solo lectura o escritura, respectivamente). Los dos casos siguientes indican lo mismo, pero además abriendo el archivo con la aplicación correspondiente.
*2, 3: Los controles que identifican este archivo como único. Si el segundo no es necesario dejaremos el parámetro en blanco pero sin obviar las comas.
*4: La extensión del archivo a copiar, que utilizará el programa para saber con que aplicación se ha de abrir este archivo.

====g_rellena====
Rellena los controles de la pantalla a partir del resultado de una select. No inicializa los campos previamente. Si así se quiere hay que llamar la función [[Funciones#g_nuevo|g_nuevo]] con los parámetros pertinentes.
*Función: g_rellena
*Fichero funciones: nada (general)
*Tipo: B
*Parámetros función: 3 parámetros
**Primer parámetro:
***0: Da error si no hay filas o si hay un error devolviendo un 1 o un 2 respectivamente en el control de status, control 1.
***1: Sólo avisa si hay un error de base de datos y devuelve un 2 en el control de status, control 1.
***2: No avisa nunca y devuelve un 0 en el control de status, control 1, como si no hubiese habido ningún error.
***3: No avisa nunca pero devuelve un 1 o un 2 en el control de status, control 1, dependiendo de si el error es que no hay filas o si es un error de base de datos.
**Segundo parámetro:
***Número de control donde se almacenaran el número de filas afectadas por el select de la función, si no se desea guardarlas en ningún control introducir el valor 0. Su aplicación tiene utilidad en la programación interna
**Tercer parámetro:
***'s': La sentencia sql se depurará antes de ejecutarse. Por ejemplo en sentencias selects se eliminan las condiciones de la clausula where de los campos que no tienen ningún valor
***'n': La sentencia sql se ejecutará sin ningún cambio.

*Ejemplo: 1,99<br >En este ejemplo se avisa si hay un error de base de datos y almacena el número de filas afectadas por la sentencia select de la función en el control 99.
*Sentencia SQL: Sentencia a ejecutar, por ejemplo:
select fmh_codi,fmh_desc from h_famhor where oid=#006
*Pares de campos: Controles a rellenar con los datos de la select, por ejemplo:
001063,002064
Nota: Esta función no puede utilizarse para rellenar el contenido del campo donde está definida.
====g_salir====
*Sale de la pantalla devolviendo un 1 en el estatus.
*Anula el comportamiento del campo enlazar. Si un control contiene una función [[Funciones#g_salir|g_salir]], si se ejecuta, no se efectuará el enlace que se halla especificado en el campo "enlazar ctrl"

====g_seleccionar====
*Pone en estado de seleccionar
*Establece los atributos correspondientes al estado de seleccionar.
*Inicializa los campos de acuerdo con sus valores por defecto en función de los parámetros recibidos. Si no recibe ningún parámetro se comporta como si hubiera recibido un 0.
*Parámetros: 1
**0: No modifica ningún control.
**1: Inicializa todos los controles a su valor por defecto.
**2: Inicializa los controles mayores que 50 a su valor por defecto.
**3: Inicializa todos los controles a su valor por defecto a excepción de los indicados, por ejemplo: 3 51 52 63

====g_setatr====
*Se usa para cambiar un atributo en tiempo de ejecución a uno o varios controles. La función se asigna a cualquier control de la pantalla.
*Parámetros de la función: El primer parámetro será un digito, un 0 o un 1 que indicará si el atributo es dinámico o estático respectivamente, es decir, si cuando cambie el estado de la pantalla (altas, consultas, etc...), el atributo se modificará con su valor correspondiente o mantendrá el que le indiquemos en la función. A continuación se introducen tantos parámetros como controles queramos modificar. Para cada control escribimos el número de control de 3 dígitos, el signo igual y el atributo de 2 dígitos, los parámetros se separan por comas. Si tenemos muchos campos que tendrán el mismo atributo podemos agruparlos mediante guiones.
*Ejemplo:
1,051=10,052-056=20,053-062=00
En este ejemplo el campo 51 estará deshabilitado, los campos 52 y 56 estarán ocultos y los campos 53 y 62 estarán habilitados, y en los tres casos estos atributos se mantendrán en todos los estados.

====g_sustit====
Se usa principalmente en la búsqueda avanzada. Su función es sustituir el valor del control que se le pasa en “Páram. Func.” por los valores de los controles contenidos en “Sentencia SQL”, separados por comas. De esta forma si después has de pasar todos estos valores, los tendrás todos contenidos dentro de un único control.

====l_refresca====
*Se ejecuta siempre detrás de cualquier modificación en la base de datos (alta, baja, modificación de un registro) para que este cambio salga reflejado en la grid.
*Contiene dos parámetros: el control que queremos que se ejecute, y el número de orden.
*Parámetros: 2 parámetros y son obligatorios.
**1: El control que queremos que se ejecute, habitualmente el control 10 que es el que hace la búsqueda y rellena la grid.
**2: El número de orden que corresponde a la función que queremos que se ejecute en el control referido.

====g_crgimp====
*Función que envía el resultado de un select al generador de informes para hacer un report.
*Parámetros: 3 parámetros
**1: Cabecera o detalle ("c" o "d"): indicamos si el resultado del select corresponde a la cabecera del impreso o corresponde a un detalle.
**2: Write o Append ("w" o "a"): indicamos si creamos un nuevo impreso o añadimos a uno existente.
**3: El tercer parámetro nos indica si ha habido errores en la base de datos, debe contener 0, 1 o 2
***0: Da error si no hay filas o si hay un error devolviendo un 1 o un 2 respectivamente en el control de status, control 1.
***1: Sólo avisa si hay un error de base de datos y devuelve un 2 en el control de status, control 1.
***2: No avisa nunca y devuelve un 0 en el control de status, control 1, como si no hubiese habido ningún error.

*En sentencia SQL pondremos la sentencia que devuelva los datos que enviamos al impreso.
select cac_ejer, cac_num, cac_fecha from abclcb where cac_num=#061 and cac_ejer=#060 and cac_alm=#059
*En pares de campos pondremos el tipo de dato y tamaño de cada uno de los campos que mostramos con el select en el mismo orden. Para el ejemplo anterior sería:
N02,N06,X10
====g_email====
*Función que abre el gestor de correo con el mail, asunto y texto que se le indique desde la pantalla.
*Parámetro:
**Código de control dónde se guarda la información que necesita el gestor de correo. Previamente a llamar a [[Funciones#g_email|g_email]] se deberá hacer un [[Funciones#g_rellena|g_rellena]] de este control con una cadena con el mail, asunto y cuerpo del mensaje separado por pipes "|". Si no disponemos de asunto y cuerpo no hace falta ponerlos en blanco, si no que pasaremos solo el mail sin pipes.

Programación

2008-12-12T11:52:49Z

Albert Castilla Querol:

{| style="position:absolute; top:0; width:100%; background:#F8FCFF; color:#888;" valign="middle"
|-
|
<h1 style="margin:0; border-bottom:0;"><br>
Programación DGP21
|}

*[[Tipos_de_campos|Tipos de campo]]
*[[Funciones|Funciones]]

Programación

2008-12-12T11:48:21Z

Albert Castilla Querol: Página nueva: *Tipos de campo *Funciones

*[[Tipos_de_campos|Tipos de campo]]
*[[Funciones|Funciones]]

Documentación del ERP i-Globalgest

2008-12-12T11:46:08Z

Albert Castilla Querol:

= Documentación del sistema Dgp21 y del ERP i-Globalgest =

Este portal está destinado a contener toda la documentación del sistema Dgp21 y todas sus aplicaciones. Se ha creado mediante el sofware MediaWiki.
Consulta la [http://meta.wikimedia.org/wiki/Help:Contents User's Guide] para obtener información sobre el uso del software wiki.

== Documentación para el usuario ==

* [[Que es Dgp21?]]
* [[Que es i-Globalgest?]]
* [[Como instalar Dgp21 e i-Globalgest]]
* [[Instalación_del_cliente|Instalación del cliente]]
* [[Como_empezar|Como empezar]]
* [[Uso_general_de_una_pantalla|Funcionamiento general de una pantalla de la aplicación]]
* [[Dgg0102|Terceros]]
* [[Dgg0101|Artículos]]
* [[Dgg0301|Pedidos de venta]]
* [[Programacion|Programación DGP21]]

Funciones

2008-12-12T11:42:42Z

Albert Castilla Querol: Página nueva: Funciones Valores de entorno En las funciones pueden utilizarse los siguientes valores de entorno: *&$idi : Idioma de la sesión. *&$ipn: Ip de la sesión. *&$usu: Código de usuario ...

Funciones
Valores de entorno
En las funciones pueden utilizarse los siguientes valores de entorno:
*&$idi : Idioma de la sesión.
*&$ipn: Ip de la sesión.
*&$usu: Código de usuario conectado
Referencias a controles
En los campos de sentencia SQL y parámetros de la función,
podemos hacer referencia al contenido de los campos de la pantalla
indicando el número de contorl (3 dígitos) precedido por #. De esta manera
se substituirá el contenido del campo indicado por el conjunto #XXX.

Ejemplos:
select * from abtdt where doid=#006;
msg0003 ,#078, ref001, 101

====g_aceptar====
*Sale de la pantalla devolviendo un 0 en el estatus.
*Si se han utilizado enlaces, devuelve los campos enlazados actualizados a la pantalla anterior.

====g_borrar====
*Pide confirmación del borrado de la fila
*Ejecuta la sentencia DELETE especificada en el campo sql.
*Después se ejecuta un [[Funciones#g_consulta|g_consulta]] (poner a modo consulta) de cabecera y detalle que coge los parámetros indicados al [[Funciones#g_borrar|g_borrar]] (ver parámetros de [[Funciones#g_consulta|g_consulta]]).
*Si no recibe ningún parámetro se comporta como si hubiera recibido un 0.
*Además de los parámetros del [[Funciones#g_consulta|g_consulta]], [[Funciones#g_borrar|g_borrar]] tiene un parámetro adicional, a continuación de los anteriores, que indica si se ha de registrar la operación (usuario, hora, ip...): s para registrar, n para no registrar, si no se indica nada coge por defecto n.
*Si el usuario aprieta el botón Aceptar el control 1 guardará el valor 0, si aprieta el botón Cancelar, dicho valor será mayor que 0.
*Ejemplo: 3 51 52 63,s

====g_list====
Se usa para rellenar una grid con los datos obtenidos la consulta SQL especificada. La grid puede ser la de la misma pantalla donde utilizamos la función o bien otra pantalla que especifiquemos.
*Uso: <br >para rellenar la grid de la misma pantalla en que se usa la función.
*Parámetros función:<br \>Ninguno.
*Sentencia SQL:<br \>Sentencia SQL cuyo resultado queremos mostrar.
*Pares de campos o descripción del listado:<br \>Formato o descripción del listado. Para cada columna del select deberemos indicar el formato: 'N' para campos numéricos, 'E' para campos numéricos con separacion con punto en los millares (en este caso debemos tener en cuenta los puntos a la hora de calcular la extensión del campo en el listado), 'X' para campos alfanuméricos y 'V' para campos de longitud variable; y seguidamente la longitud a reservar para cada columna indicada con 2 o 3 dígitos, separando los campos con comas. Podemos jugar con la longitud para truncar los datos de una columna o ampliar el espacio de una columna para poder mostrar un título mas extenso. <br >Como todos los campos tienen que ir seguido de dos dígitos, para el formato 'V', que no tiene función alguna, por convenio y para evitar confusiones pondremos siempre 99.
En los campos que sean numéricos ('E' y 'V') tenemos la opción de ocultar los valores que sean 0. Lo indicaremos mediante minúscula, o sea con la letra del parámetro en minúscula:
e14,n10...
*Ejemplo:<br >Sentencia SQL:
select cco_codi, cco_desc, cco_abierto, cco_descamp from cco
<br >Descripción del listado:
N06,X130,X07,e10,V99...
Uso de g_list para rellenar y mostar datos en una grid de una pantalla distinta a la pantalla en que se usa la función.
Parámetros función.
1.Nombre de la pantalla a mostrar con el resultado de la senetencia select especificada
2.Fijo, valor 033
3.Incluir 1º columna con oid de la tabla principal de la select: 's': incluirla, 'n': no incluirla.

La primera columna del select se utiliza como identificador de la fila, debe contener un valor que identifique de forma univoca la fila, este valor se situa en en el campo 006 de la pantalla cada vez que el usuario clica en una linea de la grid. Con este valor podemos identificar el valor que ha seleccionado el usuario y actuar en consecuencia.
Si no se especifica este parámetro o bien especificamos una 's', la función inserta de forma automática en el resultado de la select, una primera columna con el oid de la 1ª tabla especificada en la sentencia select. Si queremos utilizar una columna distinta para identificar la fila que seleccione el usuario especificamos una 'n' en el 3er parámetro, en este caso la 1ª columna del select especificado actuará como identificador de la fila.
Enlaces.
Pares de campos a enlazar con la pantalla especificada en el apartado anterior. Por lo menos enlazaremos el campo 033 y el campo 006 para recuperar el resultado de la selección efectuada por el usuario sobre la grid mostrada.
Sentencia SQL
Sentencia SQL cuyo resultado queremos mostrar.
Pares de campos o descripción del listado
Formato o descripción del listado. Para cada columna del select deberemos indicar el formato: 'N' para campos numéricos o 'X' para campos alfanuméricos y la longitud a reservar para cada columna indicada con 2 dígitos. Podemos jugar con la longitud para truncar los datos de una columna o ampliar el espacio de una columna para poder mostrar un título mas extenso.
Ejemplo:
Parámetros función:
dgsel 01,033
Enlaces:
006=006,033=033
Sentencia SQL:
select trn_nom,trn_codi from transporte where trn_nom ilike '#052%' order by trn_nom
Descripción del listado:
X20N08

====g_borrdoc====
Borra del ordenador local el archivo indicado mediante tres parámetros:
*1,2: Los dos primeros son los controles que identifican este archivo como único. Si el segundo no es necesario dejaremos el parámetro en blanco pero sin obviar las comas.
*3: El control que guardar la extensión del archivo a eliminar.

====g_buscar====
*Ejecuta el select especificado en el SQL.
*Rellena los campos de la pantalla en función de los pares de campos.
*Lanza un [[Funciones#g_consulta|g_consulta]] pasándole los parámetros especificados.
*Si no recibe ningún parámetro se comporta como si hubiera recibido un 0.
*Parámetros:
**0: No modifica ningún control.
**1: Inicializa todos los controles a su valor por defecto
**2: Inicializa los controles mayores que 50 a su valor por defecto.
**3: Inicializa todos los controles a excepción de los indicados, por ejemplo: 3,51,52,63

====g_consulta====
*Pone la pantalla en modo consulta
*Inicializa los controles de acuerdo con los parámetros que recibe
*Parámetros:
**0: No modifica ningún control.
**1: Inicializa todos los controles a su valor por defecto
**2: Inicializa los controles mayores que 50 a su valor por defecto.
**3: Inicializa todos los controles a excepción de los indicados a continuación, separados por espacios, por ejemplo: 3 51 52 63

====g_csv====
Transmite al programa cliente la selección de datos actual en formato csv y el programa cliente abre automáticamente el fichero con la aplicación asociada a este tipo de datos, habitualmente Excel u Open Office.
*Parámetros función: Esta función no tiene parámetros

====g_dupdoc====
*Se usa para ordenar al cliente que copie un documento como otro. El documento origen debe estar ya en la máquina cliente.
*Parámetros de la función:
*Referencia documento origen
*Versión documento origen
*Tipo de documento
*Referencia documento destino
*Versión documento destino

====g_ejecuta====
*Ejecuta la sentencia sql especificada.
*Número de parámetros: 3
**Parámetro 1:
***0: Da error si no hay filas o si hay un error devolviendo un 1 en el primer caso o un 2 en el segundo en el control de status, control 1. <br \>Podemos capturar el valor dentro del código de programación mediante un campo numérico, por ejemplo:
stat numeric(2,0)@1;
***1: Sólo avisa si hay un error de base de datos y devuelve un 2 en el control de status, control 1.
***2: No avisa nunca y devuelve un 0 en el control de status, control 1, como si no hubiese habido ningún error.
***3: No avisa nunca pero devuelve un 1 o un 2 en el control de status, control 1, dependiendo de si el error es que no hay filas o si es un error de base de datos.
**Parámetro 2:
***'s': La sentencia sql se depurará antes de ejecutarse. Por ejemplo en sentencias selects se eliminan las condiciones de la clausula where de los campos que no tienen ningún valor
***'n': La sentencia sql se ejecutará sin ningún cambio.
**Parámetro 3:
***Número de control donde se almacenaran el número de filas afectadas por el select de la función, si no se desea guardarlas en ningún control introducir el valor 0. Su aplicación tiene utilidad en la programación interna.
**Parámetro 4:
***'s': la operación se registrará (usuario, ip, hora...) en el log.
***'n': la operación no se registrará en el log, opción por defecto.

====g_envdoc====
Envía un documento desde el ordenador cliente al servidor. En el servidor mira cual es la versión actual y le cambia el nombre aumentando en uno el número de versión.
*Parámetros función:
**1,2: Los dos primeros son los controles que identifican este archivo como único. Si el segundo no es necesario dejaremos el parámetro en blanco pero sin obviar las comas.
**3: El control que guarda la extensión del archivo, para poder completar el nombre.

====g_envfit====
Transmite al programa cliente la selección de datos actual. El cliente transforma el fichero al formato especificado en Parámetros Función y abre el fichero para su consulta o edición.
*Parámetros función:
**a: Formato RTF
**b: Formato texto plano

====g_exeapl====
*Ejecuta el archivo indicado mediante tres parámetros:
**1,2: Los dos primeros son los controles que identifican este archivo como único. Si el segundo no es necesario dejaremos el parámetro en blanco pero sin obviar las comas.
**3: El control que guarda la extensión del archivo a ejecutar, para así sepa que aplicación ha de utilizar para realizar la acción.

====g_imprimir====
Manda el impreso en cuestión a imprimir en el formato y en la impresora especificados mediante los parámetros:
*1: Formato. Indica el formato del impreso ha imprimir.
*2: Impresora. Indica en que impresora se ha de imprimir el impreso
*3: Previsualizar. Indica si se ha de previsualizar el impreso.

====g_llamar====
Enlaza con la pantalla especificada y opcionalmente ejecuta un control.
*Parámetros:
**Nombre de la pantalla a enlazar, sin comillas.
**Núm de control a ejecutar. Si no se quiere ejecutar ningún control al inicio, omitimos este segundo parámetro

*Enlaces: <br >En los enlaces indicaremos los campos que van a intercanviar datos con la pantalla llamada, sin comillas, con 3 dígitos y separados por comas, mediante los signos siguientes:
**< : indica solo retorno.
**= : indica envío y retorno.
**> : indica solo envío.
**Ejemplo:
052<027,056=015, 057>067
El el campo 52 de la pantalla origen recibirá el valor del campo 27 de la pantalla destino, pero el 27 no recibirá nada;
el campo 56 de origen y el 15 de destino se intercambiaran el contenido, tanto al ir, como al volver;
el campo 57 enviará la información al 67 al ir, pero al volver no recojerá ningún dato..
Si queremos que al salir de la página llamada se pasen también los datos
la pantalla deberá salir con un [[Funciones#g_aceptar|g_aceptar]], si por el contrario sale con un [[Funciones#g_salir|g_salir]]no se pasará ningún dato.

*Ejemplo:
g_llamar, Parámetros: h_personal,011

====g_fijar====
*Pone el oid del registro seleccionado en la grid
**Par&aacutemetro 1: Indica el control que ha sido seleccionado, independientemenete de si
lo ha clickado el usuario o no.
====g_foco====
Coloca el foco en el control indicado en el parámetro.
*Parámetro: El número de control que deseamos reciba el foco.

====g_mens====
*Permite mostrar un mensaje por pantalla para el usuario.
*Esta función se llama con 4 parámetros, que son:
**1: La pantalla que se quiere utilizar para mostrar el error, 10 dígitos alfanuméricos. <br >Valores posibles (msg0001, msg0002, msg0003... msg0008).
**2: El código del error que quiere mostrarse, definido previamente en la tabla dgmens. 10 dígitos alfanumérico.
**3: Una referencia identificadora del error, 6 dígitos alfanuméricos.
**4: Un campo de la pantalla cuyo contenido quiera mostrarse en el mensaje, 3 dígitos numéricos.
***La pantalla que aparece con el mensaje siempre contendrá uno o dos botones (un “Aceptar” y un “Cancelar”). Si se clicka en aceptar la función devolverá un 0 en el campo 1 (estado), mientras que si se clicka en cancelar devolverá un 1.
*Los dos primero parámetros son obligatorios y deben existir, teniendo en cuenta de intercalar cuatro espacios entre el código de pantalla y el código de formato, si quiere omitirse la referencia pero en cambio se quiere poner el cuarto parámetro, deberá hacerse de la siguiente forma, por ejemplo:
msg0001, msg_err, , 53

Las pantallas con las que se muestran los errores se pueden crear o cogerlas ya predeterminadas:

[[Imagen:msg_0001.png|frame|none|msg0001]]
[[Imagen:msg_0002.png|frame|none|msg0002]]
[[Imagen:msg_0003.png|frame|none|msg0003]]
[[Imagen:msg_0004.png|frame|none|msg4 01]]
[[Imagen:msg_0005.png|frame|none|msg5 01]]
[[Imagen:msg_0006.png|frame|none|msg6 01]]
[[Imagen:msg_0007.png|frame|none|msg7 01]]
[[Imagen:msg_0009.png|frame|none|msg9 01]]

====g_modificar====
*Pone el estado 'Modificar' estableciendo los atributos de los campos para ese estado.
*Sentencia sql y pares de campos, existen dos opciones:
**Introducir una sentencia select específica (normalmente para bloquear el registro), indicando también los pares de campos que debe rellenar
**Dejar la sentencia select en blanco, en ese caso por programación hay que ejecutar previamente el control 36 (exeb(36)) para refrescar los datos que se vayan a modificar.
*Parámetros:
**0: No modifica ningún control.
**1: Inicializa todos los controles a su valor por defecto.
**2: Inicializa los controles mayores que 50 a su valor por defecto.
**3: Inicializa todos los controles a excepción de los indicados, separados por espacios, por ejemplo: 3 51 52 63

====g_nuevo====
*Pone en estado de altas
*Establece los atributos correspondientes al estado de altas.
*Inicializa los campos de acuerdo con sus valores por defecto en función de los parámetros recibidos.
*Si no recibe ningún parámetro se comporta como si hubiera recibido un 1.
*Parámetros:
**0: No modifica ningún control.
**1: Inicializa todos los controles a su valor por defecto.
**2: Inicializa los controles mayores que 50 a su valor por defecto.
**3: Inicializa todos los controles a excepción de los indicados, separados por espacios, por ejemplo: 3 51 52 63

====g_rebdoc====
Esta función envía una copia del archivo referenciado en pantalla desde el servidor al ordenador local.
Para ello se le pasan cuatro parámetros: el modo de apertura del archivo, los controles que identifican este archivo y la extensión del archivo.
*1: Tiene cuatro posibles valores: 'r','w','R','W'. En los dos primeros casos se indica como vamos a copiar el archivo (solo lectura o escritura, respectivamente). Los dos casos siguientes indican lo mismo, pero además abriendo el archivo con la aplicación correspondiente.
*2, 3: Los controles que identifican este archivo como único. Si el segundo no es necesario dejaremos el parámetro en blanco pero sin obviar las comas.
*4: La extensión del archivo a copiar, que utilizará el programa para saber con que aplicación se ha de abrir este archivo.

====g_rellena====
Rellena los controles de la pantalla a partir del resultado de una select. No inicializa los campos previamente. Si así se quiere hay que llamar la función [[Funciones#g_nuevo|g_nuevo]] con los parámetros pertinentes.
*Función: g_rellena
*Fichero funciones: nada (general)
*Tipo: B
*Parámetros función: 3 parámetros
**Primer parámetro:
***0: Da error si no hay filas o si hay un error devolviendo un 1 o un 2 respectivamente en el control de status, control 1.
***1: Sólo avisa si hay un error de base de datos y devuelve un 2 en el control de status, control 1.
***2: No avisa nunca y devuelve un 0 en el control de status, control 1, como si no hubiese habido ningún error.
***3: No avisa nunca pero devuelve un 1 o un 2 en el control de status, control 1, dependiendo de si el error es que no hay filas o si es un error de base de datos.
**Segundo parámetro:
***Número de control donde se almacenaran el número de filas afectadas por el select de la función, si no se desea guardarlas en ningún control introducir el valor 0. Su aplicación tiene utilidad en la programación interna
**Tercer parámetro:
***'s': La sentencia sql se depurará antes de ejecutarse. Por ejemplo en sentencias selects se eliminan las condiciones de la clausula where de los campos que no tienen ningún valor
***'n': La sentencia sql se ejecutará sin ningún cambio.

*Ejemplo: 1,99<br >En este ejemplo se avisa si hay un error de base de datos y almacena el número de filas afectadas por la sentencia select de la función en el control 99.
*Sentencia SQL: Sentencia a ejecutar, por ejemplo:
select fmh_codi,fmh_desc from h_famhor where oid=#006
*Pares de campos: Controles a rellenar con los datos de la select, por ejemplo:
001063,002064
Nota: Esta función no puede utilizarse para rellenar el contenido del campo donde está definida.
====g_salir====
*Sale de la pantalla devolviendo un 1 en el estatus.
*Anula el comportamiento del campo enlazar. Si un control contiene una función [[Funciones#g_salir|g_salir]], si se ejecuta, no se efectuará el enlace que se halla especificado en el campo "enlazar ctrl"

====g_seleccionar====
*Pone en estado de seleccionar
*Establece los atributos correspondientes al estado de seleccionar.
*Inicializa los campos de acuerdo con sus valores por defecto en función de los parámetros recibidos. Si no recibe ningún parámetro se comporta como si hubiera recibido un 0.
*Parámetros: 1
**0: No modifica ningún control.
**1: Inicializa todos los controles a su valor por defecto.
**2: Inicializa los controles mayores que 50 a su valor por defecto.
**3: Inicializa todos los controles a su valor por defecto a excepción de los indicados, por ejemplo: 3 51 52 63

====g_setatr====
*Se usa para cambiar un atributo en tiempo de ejecución a uno o varios controles. La función se asigna a cualquier control de la pantalla.
*Parámetros de la función: El primer parámetro será un digito, un 0 o un 1 que indicará si el atributo es dinámico o estático respectivamente, es decir, si cuando cambie el estado de la pantalla (altas, consultas, etc...), el atributo se modificará con su valor correspondiente o mantendrá el que le indiquemos en la función. A continuación se introducen tantos parámetros como controles queramos modificar. Para cada control escribimos el número de control de 3 dígitos, el signo igual y el atributo de 2 dígitos, los parámetros se separan por comas. Si tenemos muchos campos que tendrán el mismo atributo podemos agruparlos mediante guiones.
*Ejemplo:
1,051=10,052-056=20,053-062=00
En este ejemplo el campo 51 estará deshabilitado, los campos 52 y 56 estarán ocultos y los campos 53 y 62 estarán habilitados, y en los tres casos estos atributos se mantendrán en todos los estados.

====g_sustit====
Se usa principalmente en la búsqueda avanzada. Su función es sustituir el valor del control que se le pasa en “Páram. Func.” por los valores de los controles contenidos en “Sentencia SQL”, separados por comas. De esta forma si después has de pasar todos estos valores, los tendrás todos contenidos dentro de un único control.

====l_refresca====
*Se ejecuta siempre detrás de cualquier modificación en la base de datos (alta, baja, modificación de un registro) para que este cambio salga reflejado en la grid.
*Contiene dos parámetros: el control que queremos que se ejecute, y el número de orden.
*Parámetros: 2 parámetros y son obligatorios.
**1: El control que queremos que se ejecute, habitualmente el control 10 que es el que hace la búsqueda y rellena la grid.
**2: El número de orden que corresponde a la función que queremos que se ejecute en el control referido.

====g_crgimp====
*Función que envía el resultado de un select al generador de informes para hacer un report.
*Parámetros: 3 parámetros
**1: Cabecera o detalle ("c" o "d"): indicamos si el resultado del select corresponde a la cabecera del impreso o corresponde a un detalle.
**2: Write o Append ("w" o "a"): indicamos si creamos un nuevo impreso o añadimos a uno existente.
**3: El tercer parámetro nos indica si ha habido errores en la base de datos, debe contener 0, 1 o 2
***0: Da error si no hay filas o si hay un error devolviendo un 1 o un 2 respectivamente en el control de status, control 1.
***1: Sólo avisa si hay un error de base de datos y devuelve un 2 en el control de status, control 1.
***2: No avisa nunca y devuelve un 0 en el control de status, control 1, como si no hubiese habido ningún error.

*En sentencia SQL pondremos la sentencia que devuelva los datos que enviamos al impreso.
select cac_ejer, cac_num, cac_fecha from abclcb where cac_num=#061 and cac_ejer=#060 and cac_alm=#059
*En pares de campos pondremos el tipo de dato y tamaño de cada uno de los campos que mostramos con el select en el mismo orden. Para el ejemplo anterior sería:
N02,N06,X10
====g_email====
*Función que abre el gestor de correo con el mail, asunto y texto que se le indique desde la pantalla.
*Parámetro:
**Código de control dónde se guarda la información que necesita el gestor de correo. Previamente a llamar a [[Funciones#g_email|g_email]] se deberá hacer un [[Funcioes#g_rellena|g_rellena]] de este control con una cadena con el mail, asunto y cuerpo del mensaje separado por pipes "|". Si no disponemos de asunto y cuerpo no hace falta ponerlos en blanco, si no que pasaremos solo el mail sin pipes.

Archivo:Msg 0009.png

2008-12-12T10:43:31Z

Albert Castilla Querol:

Archivo:Msg 0007.png

2008-12-12T10:43:18Z

Albert Castilla Querol:

Archivo:Msg 0006.png

2008-12-12T10:43:04Z

Albert Castilla Querol:

Archivo:Msg 0005.png

2008-12-12T10:42:52Z

Albert Castilla Querol:

Archivo:Msg 0004.png

2008-12-12T10:42:38Z

Albert Castilla Querol:

Archivo:Msg 0003.png

2008-12-12T10:42:14Z

Albert Castilla Querol:

Archivo:Msg 0002.png

2008-12-12T10:42:04Z

Albert Castilla Querol:

Archivo:Msg 0001.png

2008-12-12T10:41:52Z

Albert Castilla Querol:

Tipos de campos

2008-12-12T08:22:28Z

Albert Castilla Querol:

Define la apariencia y tipo de información que podrá contener el campo.

==Campos alfanuméricos==

*'''Tipo''' : 'C'
*'''Pestaña''': '0' si no pertenece a ninguna pestaña o el índice de la pestaña a que pertenece.
*'''Etiqueta''': Escoger el literal adecuado de la [[dimliter|tabla de literales]].
*'''Posición etiqueta''':
**‘E’: Encima, en principio se tomará por defecto esta posición.
**‘I’: A la izquierda, se utilizará cuando el campo sea pequeño, por ejemplo campos tipo S/N.
**‘N’: Sin etiqueta.
*'''Número de dígitos'''
*'''Pos.1: (x,y)''': Corresponde a la esquina superior izquierda de la caja.
*'''Pos.2: (x,y)''':
**x: Cuando se necesita crear un campo de una determinada extensión gráfica, pero que el número de dígitos es superior a esta, indicamos en la x de la posición 2 la coordenada final del campo gráfico, y automáticamente cuando escribamos i no quepan más letras, ellas solas correrán.
**y: Si és 0, el campo se dibuja con altura por defecto de 18 pixels, si indicamos un valor, podemos ajustar la altura del campo. Si la altura supera los 24 pixeles la fuente del control es mayor.
*'''Contenido''':
**'X': Alfanumérico.
**'C': Clave, se visualizan asteriscos.
*'''Signo''': 0, no se utiliza
*'''Editado''': 0, no se usa.

==Campos numéricos==

*'''Tipo''' : 'C'
*'''Pestaña''': '0' si no pertenece a ninguna pestaña o el índice de la pestaña a que pertenece.
*'''Etiqueta''': Escoger el literal adecuado de la [[dimliter|tabla de literales]].
*'''Posición etiqueta''':
**‘E’: Encima, en principio se tomará por defecto esta posición.
**‘I’: A la izquierda, se utilizará cuando el campo sea pequeño, por ejemplo campos tipo S/N.
**‘N’: Sin etiqueta.
*'''Número de dígitos:''' sin contar comas, separadores de miles o signo.
*'''Pos.1: (x,y)''': Corresponde a la esquina superior izquierda de la caja.
*'''Pos.2: (x,y)''':
**x: No se utiliza.
**y: Si és 0, el campo se dibuja con altura por defecto de 18 pixels, si indicamos un valor, podemos ajustar la altura del campo. Si la altura supera los 24 pixeles la fuente del control es mayor.
*'''Contenido''': '0' si no tiene decimales, si los tiene, el número de decimales.
*'''Signo''': 0, no se utiliza
*'''Editado''': 0, no se usa.

==Campos fecha==

Las fechas se muestran en el formato: dd/mm/aaaa. El usuario puede omitir las barras separadoras en la introducción así como los 2 dígitos del milenio. El programa cliente se encarga de formatear la entrada.

*'''Tipo''' : 'C'
*'''Pestaña''': '0' si no pertenece a ninguna pestaña o el índice de la pestaña a que pertenece.
*'''Etiqueta''': Escoger el literal adecuado de la [[dimliter|tabla de literales]].
*'''Posición etiqueta''':
**‘E’: Encima, en principio se tomará por defecto esta posición.
**‘I’: A la izquierda, se utilizará cuando el campo sea pequeño, por ejemplo campos tipo S/N.
**‘N’: Sin etiqueta.
*'''Número de dígitos:''' No se utiliza. Se toman siempre diez dígitos.
*'''Pos.1: (x,y)''': Corresponde a la esquina superior izquierda de la caja.
*'''Pos.2: (x,y)''':
**x: No se utiliza.
**y: Si és 0, el campo se dibuja con altura por defecto de 18 pixels, si indicamos un valor, podemos ajustar la altura del campo. Si la altura supera los 24 pixeles la fuente del control es mayor.
*'''Contenido''': 'F'
*'''Signo''': 0, no se utiliza
*'''Editado''': 0, no se usa.
.

==Campo de texto==

*'''Tipo''': 'T'
*'''Etiqueta''': Escoger el literal adecuado de la [[dimliter|tabla de literales]] para que aparezca traducido al lenguaje del usuario. Si no es un código de literal, aparece directamente lo introducido aquí.
*'''Número de dígitos''': se utiliza para calcular el tamaño del control, en caso de que no se haya introducido pos. 2.
*'''Pos.1: (x,y)''': esquina superior izquierda del cuadro
*'''Pos.2: (x,y)''':
**x: Cuando se necesita crear un campo de una determinada extensión gráfica, pero que el número de dígitos es superior a esta, indicamos en la x de la posición 2 la coordenada final del campo gráfico, y automáticamente cuando escribamos y no quepan más letras, ellas solas correrán.
**y: Si és 0, el campo se dibuja con altura por defecto de 18 pixels, si indicamos un valor, podemos ajustar la altura del campo. Si la altura supera los 24 pixeles la fuente del control es mayor.
*'''Posición etiqueta''': Tamaño de la fuente, posibles valores:
**'P': Fuente pequeña
**'M': Fuente mediana
**'G': Fuente grande
**'F': Fuente de espaciado fijo.
**'L': Espaciado fijo, fuente grande
*'''Contenido''': ‘X’ , no se utiliza
*'''Signo''': 0, no se utiliza
*'''Editado''': 0, no se usa
*'''Pasar el control al salir''' : 0, no se usa
*'''Orden de tabulación''': en principio no se usa
*'''Pestaña''': si pertenece a alguna pestaña, su número si no 0.

==Botones==

*'''Tipo''': ‘B’
*'''Número de dígitos''': Se tomará para dimensionar la anchura del botón.
*'''Pos.1: (x,y)''': esquina superior izquierda del botón
*'''Pos.2: (x,y)''':
**x: Número de tecla aceleradora asociada al botón: 1:F1, 2: F2, etc. Listado de [[hot_keys|teclas aceleradoras]].
**y: No se utiliza.
*'''Etiqueta''': Escoger el literal adecuado de la [[dimliter|tabla de literales]]. Aparecerá dentro del botón.
*'''Pasar el control''': 1.

==Botones herramienta==

*'''Tipo''': ‘H’
*'''Contenido''':
**Si no se especifica nada, se utiliza para realizar cualquier acción que establezcamos mediante programación.
**'Y' Botón que muestra una página de ayuda, para más información ver el apartado [[tipos_de_campos#Bot.C3.B3n_de_ayuda|Botón de ayuda]].
**'I' Botón que arranca una nueva instancia de la aplicación con los mismos parámetros de conexión que la actual
*'''Etiqueta''': Escoger el literal adecuado de la [[dimliter|tabla de literales]]. Aparecerá cuando el puntero del ratón pase por encima del control (tooltip).
*'''Posición etiqueta''':
**'M': Tamaño medio, 24x24 pixels, valor por defecto
**'P': Tamaño pequeño, 17x17 pixels.
**'G': Tamaño grande, 30x30 pixels, apropiado para usarse en pantallas táctiles.
* '''Pos.2: (x,y)''':
**x: número de tecla aceleradora asociada al botón: 1:F1, 2: F2, etc. Listado de [[hot_keys|teclas aceleradoras]].
**y: se utiliza parar indicar la imagen que será el número asignado en el fichero resource.h del proyecto dgp21i01.
*'''Pasar el control''': 1.

==Botón de ayuda==

Pulsando el botón de ayuda, mediante el ratón o pulsando F1, se accede a la pagina html de ayuda en la posición que corresponda. El prefijo para construir el path completo de la página de ayuda lo resuelve el programa cliente en función del fichero de configuración: puede apuntar a paginas en la intranet de la empresa, internet o páginas locales. Este prefijo se guarda en dgp21.cfg de la forma siguiente:

# --- Path ajuda

ajuda=l:\libs\man\;

El path completo se obtiene añadiendo el código del idioma del usuario.

Por ejemplo, si el usuario ha escogido en la pantalla de conexión el código de idioma 'Fr', francés, las pantallas de ayuda se buscaran en:

l:\libs\man\Fr

Es un control tipo botón de ayuda con las siguientes particularidades:

*'''Tipo''': 'H'
*'''Contenido''': 'Y', ayuda.
*'''Valor por defecto''': Dirección página web y marcador de situación en la página, por ejemplo:

control_presencia1.htm#CP

[[Normas_estilo|Normas de estilo para las páginas de ayuda]]

==Cuadro==

Recuadro planos transparente o con un bitmap.
Como recuadro transparente se usa para agrupar visualmente controles relacionados.

*'''Tipo:''' 'U'
*'''Contenido''': 'B', para mostrar un bitmap, 'N' o cualquier otro, para mostrar un recuadro transparente.
*'''Valor por defecto''': Número de referencia del bitmap.
*'''Pos.1''': Esquina superior izquierda del recuadro.
*'''Pos.2''': Esquina inferior derecha.

==Pantalla o ventana==

Recuadro opaco y con relieve. Para visualizar una ventana superpuesta. Para aplicar el titulo a la ventana debe añadirse un control de tipo texto estático con fondo azul y letras blancas.

*'''Tipo:''' 'P'.
*'''Pos.1 (x,y)''': Esquina superior izquierda del recuadro.
*'''Pos.2 (x,y)''': Esquina inferior derecha.
*'''Tabulador:''' Si és distinto de cero significa que se quiere llamar la atención del usuario y por tanto se muestra la pantalla aunque en aquel momento la aplicación esté minimizada u oculta por otra aplicación.

==Texto extenso==

Controles tipo caja para albergar un texto extenso. Si el texto sobrepasa el área del control, aparece la barra de scroll vertical.

*'''Tipo:''' 'X'
*'''Contenido: 'M', Indicamos tipo de letra mediana, en cualquier otro caso letra por defecto.
*'''Número de dígitos: Longitud máxima del campo
*'''Pos.1 (x,y)''': Esquina superior izquierda del recuadro.
*'''Pos.2 (x,y)''': Esquina inferior derecha.

==Menú==

Tipo de campo utilizado en los menús.

*'''Tipo''': 'M'.
*'''Contenido: irrelevante.
*'''Pos. 2''': irrelevante, la anchura se fija en función del número de dígitos.
*'''Tipo de fuente''': fijado por la aplicación.

==Línea de listado==

Se utiliza para las líneas de listado. Pinchando sobre ellas se resaltan y suelen utilizarse para realizar alguna acción relacionada con la línea de datos.

*'''Tipo:''' 'I'
*'''Pos. 2''': irrelevante, altura fija, la longitud se fija en función del número de dígitos.
*'''Fuente''': fija.

==Campos tipo pestaña==

Habrá que definir tantos controles de este tipo como pestañas distintas. Cada una de ellas tendrá un núm. de orden distinto empezando por 1. El tamaño del control lo tomará de la pestaña con núm. pestaña = 1. Para asignar los controles a las pestañas habrá que indicar en ellos el núm. de pestaña al que pertenecen. Si núm. Pestaña = 0 no pertenece a ninguna pestaña.

Limitación sólo es posible 1 pestaña por pantalla.

*'''Tipo''': 'N'
*'''Etiqueta''': nombre de la pestaña
*'''Pos.1: (x,y)''': esquina superior izquierda del cuadro
*'''Pos.2: (x,y)''': esquina inferior derecha, sólo se tiene en cuenta para la Pestaña = 1
*'''Posición etiqueta''': poner ‘P’, de momento no se utiliza.
*'''Contenido''': ‘X’ , no se utiliza
*'''Signo''': 0, no se utiliza
*'''Número de dígitos''': no se utiliza, el tamaño de la pestaña depende de su etiqueta.
*'''Editado''': 0, no se usa
*'''Pasar el control al salir''': 0, no se usa
*'''Orden de tabulación''': en principio no se usa.
*'''Pestaña''': Núm. De pestaña empezando por 1.

==Campo tipo “Checkbox”==

*'''Estado''': campo que sólo permite 2 estados:
**Chequeado
** No chequeado.

*'''Tipo''': 'K'
*'''Etiqueta''': Nombre del campo
*'''Pos.1: (x,y)''': esquina superior izquierda del cuadro de chequeo
*'''Pos.2: (x,y)''': no se utiliza
*'''Posición etiqueta''':
**‘I’: A la izquierda
**‘N’: Sin etiqueta
**'D': A la derecha
*'''Contenido''':
**‘X’ : Si el campo está chequeado su valor es 'S', en caso contrario su valor es ' ' (un espacio)
**'B': Campo boleano estricto, si está chequeado su valor es 'S', en caso contrario es 'N'.
*'''Signo''': 0, no se utiliza
*'''Número de dígitos''': no se utiliza.
*'''Editado''': 0, no se usa

==Texto interactivo==

Campo de texto que al clicar sobre él con el ratón cambia de color. Se utiliza para las líneas de una grid. Se juega con los atributos para darle un fondo de color y crear el listado con colores alternos para cada línea.

*'''Tipo''': 'I'
*'''Etiqueta''': No se usa
*'''Pos.1: (x,y)''': esquina superior izquierda del cuadro
*'''Pos.2: (x,y)''': No se usa.
*'''Posición etiqueta''': Tamaño de la fuente, posibles valores:
**'P': Fuente pequeña
**'M': Fuente mediana
**'G': Fuente grande
**'F': Fuente de espaciado fijo.
*'''Contenido''': ‘X’ , no se utiliza
*'''Signo''': 0, no se utiliza
*'''Número de dígitos''': se utiliza para calcular la longitud del control..
*'''Editado''': 0, no se usa
*'''Pasar el control''': al salir = 1
*'''Orden de tabulación''': en principio no se usa.
*'''Pestaña''': si pertenece a alguna pestaña, su número si no 0.
*'''Pertenencia''': 'L' indica que pertenece a una grid.
*'''Enlazar control''': Cuando la pantalla que contiene la “grid” tiene un área de detalle con los campos de la línea del listado, entonces enlaza con el control 36 que es el encargado de rellenar ese detalle a partir del oid correspondiente a la línea seleccionada.
*'''Nota''': Este campo debe tener la función g_fijar que tiene como misión obtener el “oid” de la línea seleccionada.

Tipos de campos

2008-12-11T11:57:49Z

Albert Castilla Querol:

Define la apariencia y tipo de información que podrá contener el campo.

==Campos alfanuméricos==

*'''Tipo''' : 'C'
*'''Pestaña''': '0' si no pertenece a ninguna pestaña o el índice de la pestaña a que pertenece.
*'''Etiqueta''': Escoger el literal adecuado de la [[dimliter|tabla de literales]].
*'''Posición etiqueta''':
**‘E’: Encima, en principio se tomará por defecto esta posición.
**‘I’: A la izquierda, se utilizará cuando el campo sea pequeño, por ejemplo campos tipo S/N.
**‘N’: Sin etiqueta.
*'''Número de dígitos'''
*'''Pos.1: (x,y)''': Corresponde a la esquina superior izquierda de la caja.
*'''Pos.2: (x,y)''':
**x: Cuando se necesita crear un campo de una determinada extensión gráfica, pero que el número de dígitos es superior a esta, indicamos en la x de la posición 2 la coordenada final del campo gráfico, y automáticamente cuando escribamos i no quepan más letras, ellas solas correrán.
**y: Si és 0, el campo se dibuja con altura por defecto de 18 pixels, si indicamos un valor, podemos ajustar la altura del campo. Si la altura supera los 24 pixeles la fuente del control es mayor.
*'''Contenido''':
**'X': Alfanumérico.
**'C': Clave, se visualizan asteriscos.
*'''Signo''': 0, no se utiliza
*'''Editado''': 0, no se usa.

==Campos numéricos==

*'''Tipo''' : 'C'
*'''Pestaña''': '0' si no pertenece a ninguna pestaña o el índice de la pestaña a que pertenece.
*'''Etiqueta''': Escoger el literal adecuado de la [[dimliter|tabla de literales]].
*'''Posición etiqueta''':
**‘E’: Encima, en principio se tomará por defecto esta posición.
**‘I’: A la izquierda, se utilizará cuando el campo sea pequeño, por ejemplo campos tipo S/N.
**‘N’: Sin etiqueta.
*'''Número de dígitos:''' sin contar comas, separadores de miles o signo.
*'''Pos.1: (x,y)''': Corresponde a la esquina superior izquierda de la caja.
*'''Pos.2: (x,y)''':
**x: No se utiliza.
**y: Si és 0, el campo se dibuja con altura por defecto de 18 pixels, si indicamos un valor, podemos ajustar la altura del campo. Si la altura supera los 24 pixeles la fuente del control es mayor.
*'''Contenido''': '0' si no tiene decimales, si los tiene, el número de decimales.
*'''Signo''': 0, no se utiliza
*'''Editado''': 0, no se usa.

==Campos fecha==

Las fechas se muestran en el formato: dd/mm/aaaa. El usuario puede omitir las barras separadoras en la introducción así como los 2 dígitos del milenio. El programa cliente se encarga de formatear la entrada.

*'''Tipo''' : 'C'
*'''Pestaña''': '0' si no pertenece a ninguna pestaña o el índice de la pestaña a que pertenece.
*'''Etiqueta''': Escoger el literal adecuado de la [[dimliter|tabla de literales]].
*'''Posición etiqueta''':
**‘E’: Encima, en principio se tomará por defecto esta posición.
**‘I’: A la izquierda, se utilizará cuando el campo sea pequeño, por ejemplo campos tipo S/N.
**‘N’: Sin etiqueta.
*'''Número de dígitos:''' No se utiliza. Se toman siempre diez dígitos.
*'''Pos.1: (x,y)''': Corresponde a la esquina superior izquierda de la caja.
*'''Pos.2: (x,y)''':
**x: No se utiliza.
**y: Si és 0, el campo se dibuja con altura por defecto de 18 pixels, si indicamos un valor, podemos ajustar la altura del campo. Si la altura supera los 24 pixeles la fuente del control es mayor.
*'''Contenido''': 'F'
*'''Signo''': 0, no se utiliza
*'''Editado''': 0, no se usa.
.

==Campo de texto==

*'''Tipo''': 'T'
*'''Etiqueta''': Escoger el literal adecuado de la [[dimliter|tabla de literales]] para que aparezca traducido al lenguaje del usuario. Si no es un código de literal, aparece directamente lo introducido aquí.
*'''Número de dígitos''': se utiliza para calcular el tamaño del control, en caso de que no se haya introducido pos. 2.
*'''Pos.1: (x,y)''': esquina superior izquierda del cuadro
*'''Pos.2: (x,y)''':
**x: Cuando se necesita crear un campo de una determinada extensión gráfica, pero que el número de dígitos es superior a esta, indicamos en la x de la posición 2 la coordenada final del campo gráfico, y automáticamente cuando escribamos y no quepan más letras, ellas solas correrán.
**y: Si és 0, el campo se dibuja con altura por defecto de 18 pixels, si indicamos un valor, podemos ajustar la altura del campo. Si la altura supera los 24 pixeles la fuente del control es mayor.
*'''Posición etiqueta''': Tamaño de la fuente, posibles valores:
**'P': Fuente pequeña
**'M': Fuente mediana
**'G': Fuente grande
**'F': Fuente de espaciado fijo.
**'L': Espaciado fijo, fuente grande
*'''Contenido''': ‘X’ , no se utiliza
*'''Signo''': 0, no se utiliza
*'''Editado''': 0, no se usa
*'''Pasar el control al salir''' : 0, no se usa
*'''Orden de tabulación''': en principio no se usa
*'''Pestaña''': si pertenece a alguna pestaña, su número si no 0.

==Botones==

*'''Tipo''': ‘B’
*'''Número de dígitos''': Se tomará para dimensionar la anchura del botón.
*'''Pos.1: (x,y)''': esquina superior izquierda del botón
*'''Pos.2: (x,y)''':
**x: Número de tecla aceleradora asociada al botón: 1:F1, 2: F2, etc. Listado de teclas aceleradoras.
**y: No se utiliza.
*'''Etiqueta''': Escoger el literal adecuado de la [[dimliter|tabla de literales]]. Aparecerá dentro del botón.
*'''Pasar el control''': 1.

==Botones herramienta==

*'''Tipo''': ‘H’
*'''Contenido''':
**Si no se especifica nada, se utiliza para realizar cualquier acción que establezcamos mediante programación.
**'Y' Botón que muestra una página de ayuda, para más información ver el apartado Botón de ayuda
**'I' Botón que arranca una nueva instancia de la aplicación con los mismos parámetros de conexión que la actual
*'''Etiqueta''': Escoger el literal adecuado de la [[dimliter|tabla de literales]]. Aparecerá cuando el puntero del ratón pase por encima del control (tooltip).
*'''Posición etiqueta''':
**'M': Tamaño medio, 24x24 pixels, valor por defecto
**'P': Tamaño pequeño, 17x17 pixels.
**'G': Tamaño grande, 30x30 pixels, apropiado para usarse en pantallas táctiles.
* '''Pos.2: (x,y)''':
**x: número de tecla aceleradora asociada al botón: 1:F1, 2: F2, etc. Listado de teclas aceleradoras.
**y: se utiliza parar indicar la imagen que será el número asignado en el fichero resource.h del proyecto dgp21i01.
*'''Pasar el control''': 1.

==Botón de ayuda==

Pulsando el botón de ayuda, mediante el ratón o pulsando F1, se accede a la pagina html de ayuda en la posición que corresponda. El prefijo para construir el path completo de la página de ayuda lo resuelve el programa cliente en función del fichero de configuración: puede apuntar a paginas en la intranet de la empresa, internet o páginas locales. Este prefijo se guarda en dgp21.cfg de la forma siguiente:

# --- Path ajuda

ajuda=l:\libs\man\;

El path completo se obtiene añadiendo el código del idioma del usuario.

Por ejemplo, si el usuario ha escogido en la pantalla de conexión el código de idioma 'Fr', francés, las pantallas de ayuda se buscaran en:

l:\libs\man\Fr

Es un control tipo botón de ayuda con las siguientes particularidades:

*'''Tipo''': 'H'
*'''Contenido''': 'Y', ayuda.
*'''Valor por defecto''': Dirección página web y marcador de situación en la página, por ejemplo:

control_presencia1.htm#CP

Normas de estilo para las páginas de ayuda

==Cuadro==

Recuadro planos transparente o con un bitmap.
Como recuadro transparente se usa para agrupar visualmente controles relacionados.

*'''Tipo:''' 'U'
*'''Contenido''': 'B', para mostrar un bitmap, 'N' o cualquier otro, para mostrar un recuadro transparente.
*'''Valor por defecto''': Número de referencia del bitmap.
*'''Pos.1''': Esquina superior izquierda del recuadro.
*'''Pos.2''': Esquina inferior derecha.

==Pantalla o ventana==

Recuadro opaco y con relieve. Para visualizar una ventana superpuesta. Para aplicar el titulo a la ventana debe añadirse un control de tipo texto estático con fondo azul y letras blancas.

*'''Tipo:''' 'P'.
*'''Pos.1 (x,y)''': Esquina superior izquierda del recuadro.
*'''Pos.2 (x,y)''': Esquina inferior derecha.
*'''Tabulador:''' Si és distinto de cero significa que se quiere llamar la atención del usuario y por tanto se muestra la pantalla aunque en aquel momento la aplicación esté minimizada u oculta por otra aplicación.

==Texto extenso==

Controles tipo caja para albergar un texto extenso. Si el texto sobrepasa el área del control, aparece la barra de scroll vertical.

*'''Tipo:''' 'X'
*'''Contenido: 'M', Indicamos tipo de letra mediana, en cualquier otro caso letra por defecto.
*'''Número de dígitos: Longitud máxima del campo
*'''Pos.1 (x,y)''': Esquina superior izquierda del recuadro.
*'''Pos.2 (x,y)''': Esquina inferior derecha.

==Menú==

Tipo de campo utilizado en los menús.

*'''Tipo''': 'M'.
*'''Contenido: irrelevante.
*'''Pos. 2''': irrelevante, la anchura se fija en función del número de dígitos.
*'''Tipo de fuente''': fijado por la aplicación.

==Línea de listado==

Se utiliza para las líneas de listado. Pinchando sobre ellas se resaltan y suelen utilizarse para realizar alguna acción relacionada con la línea de datos.

*'''Tipo:''' 'I'
*'''Pos. 2''': irrelevante, altura fija, la longitud se fija en función del número de dígitos.
*'''Fuente''': fija.

==Campos tipo pestaña==

Habrá que definir tantos controles de este tipo como pestañas distintas. Cada una de ellas tendrá un núm. de orden distinto empezando por 1. El tamaño del control lo tomará de la pestaña con núm. pestaña = 1. Para asignar los controles a las pestañas habrá que indicar en ellos el núm. de pestaña al que pertenecen. Si núm. Pestaña = 0 no pertenece a ninguna pestaña.

Limitación sólo es posible 1 pestaña por pantalla.

*'''Tipo''': 'N'
*'''Etiqueta''': nombre de la pestaña
*'''Pos.1: (x,y)''': esquina superior izquierda del cuadro
*'''Pos.2: (x,y)''': esquina inferior derecha, sólo se tiene en cuenta para la Pestaña = 1
*'''Posición etiqueta''': poner ‘P’, de momento no se utiliza.
*'''Contenido''': ‘X’ , no se utiliza
*'''Signo''': 0, no se utiliza
*'''Número de dígitos''': no se utiliza, el tamaño de la pestaña depende de su etiqueta.
*'''Editado''': 0, no se usa
*'''Pasar el control al salir''': 0, no se usa
*'''Orden de tabulación''': en principio no se usa.
*'''Pestaña''': Núm. De pestaña empezando por 1.

==Campo tipo “Checkbox”==

*'''Estado''': campo que sólo permite 2 estados:
**Chequeado
** No chequeado.

*'''Tipo''': 'K'
*'''Etiqueta''': Nombre del campo
*'''Pos.1: (x,y)''': esquina superior izquierda del cuadro de chequeo
*'''Pos.2: (x,y)''': no se utiliza
*'''Posición etiqueta''':
**‘I’: A la izquierda
**‘N’: Sin etiqueta
**'D': A la derecha
*'''Contenido''':
**‘X’ : Si el campo está chequeado su valor es 'S', en caso contrario su valor es ' ' (un espacio)
**'B': Campo boleano estricto, si está chequeado su valor es 'S', en caso contrario es 'N'.
*'''Signo''': 0, no se utiliza
*'''Número de dígitos''': no se utiliza.
*'''Editado''': 0, no se usa

==Texto interactivo==

Campo de texto que al clicar sobre él con el ratón cambia de color. Se utiliza para las líneas de una grid. Se juega con los atributos para darle un fondo de color y crear el listado con colores alternos para cada línea.

*'''Tipo''': 'I'
*'''Etiqueta''': No se usa
*'''Pos.1: (x,y)''': esquina superior izquierda del cuadro
*'''Pos.2: (x,y)''': No se usa.
*'''Posición etiqueta''': Tamaño de la fuente, posibles valores:
**'P': Fuente pequeña
**'M': Fuente mediana
**'G': Fuente grande
**'F': Fuente de espaciado fijo.
*'''Contenido''': ‘X’ , no se utiliza
*'''Signo''': 0, no se utiliza
*'''Número de dígitos''': se utiliza para calcular la longitud del control..
*'''Editado''': 0, no se usa
*'''Pasar el control''': al salir = 1
*'''Orden de tabulación''': en principio no se usa.
*'''Pestaña''': si pertenece a alguna pestaña, su número si no 0.
*'''Pertenencia''': 'L' indica que pertenece a una grid.
*'''Enlazar control''': Cuando la pantalla que contiene la “grid” tiene un área de detalle con los campos de la línea del listado, entonces enlaza con el control 36 que es el encargado de rellenar ese detalle a partir del oid correspondiente a la línea seleccionada.
*'''Nota''': Este campo debe tener la función g_fijar que tiene como misión obtener el “oid” de la línea seleccionada.

Tipos de campos

2008-12-11T11:26:12Z

Albert Castilla Querol: Página nueva: Define la apariencia y tipo de información que podrá contener el campo. ==Campos alfanuméricos== *'''Tipo''' : 'C' *'''Pestaña''': '0' si no pertenece a ninguna pestaña o el í...

Define la apariencia y tipo de información que podrá contener el campo.

==Campos alfanuméricos==

*'''Tipo''' : 'C'
*'''Pestaña''': '0' si no pertenece a ninguna pestaña o el índice de la pestaña a que pertenece.
*'''Etiqueta''': Escoger el literal adecuado de la tabla de literales.
*'''Posición etiqueta''':
**‘E’: Encima, en principio se tomará por defecto esta posición.
**‘I’: A la izquierda, se utilizará cuando el campo sea pequeño, por ejemplo campos tipo S/N.
**‘N’: Sin etiqueta.
*'''Número de dígitos'''
*'''Pos.1: (x,y)''': Corresponde a la esquina superior izquierda de la caja.
*'''Pos.2: (x,y)''':
**x: Cuando se necesita crear un campo de una determinada extensión gráfica, pero que el número de dígitos es superior a esta, indicamos en la x de la posición 2 la coordenada final del campo gráfico, y automáticamente cuando escribamos i no quepan más letras, ellas solas correrán.
**y: Si és 0, el campo se dibuja con altura por defecto de 18 pixels, si indicamos un valor, podemos ajustar la altura del campo. Si la altura supera los 24 pixeles la fuente del control es mayor.
*'''Contenido''':
**'X': Alfanumérico.
**'C': Clave, se visualizan asteriscos.
*'''Signo''': 0, no se utiliza
*'''Editado''': 0, no se usa.

==Campos numéricos==

*'''Tipo''' : 'C'
*'''Pestaña''': '0' si no pertenece a ninguna pestaña o el índice de la pestaña a que pertenece.
*'''Etiqueta''': Escoger el literal adecuado de la tabla de literales.
*'''Posición etiqueta''':
**‘E’: Encima, en principio se tomará por defecto esta posición.
**‘I’: A la izquierda, se utilizará cuando el campo sea pequeño, por ejemplo campos tipo S/N.
**‘N’: Sin etiqueta.
*'''Número de dígitos:''' sin contar comas, separadores de miles o signo.
*'''Pos.1: (x,y)''': Corresponde a la esquina superior izquierda de la caja.
*'''Pos.2: (x,y)''':
**x: No se utiliza.
**y: Si és 0, el campo se dibuja con altura por defecto de 18 pixels, si indicamos un valor, podemos ajustar la altura del campo. Si la altura supera los 24 pixeles la fuente del control es mayor.
*'''Contenido''': '0' si no tiene decimales, si los tiene, el número de decimales.
*'''Signo''': 0, no se utiliza
*'''Editado''': 0, no se usa.

==Campos fecha==

Las fechas se muestran en el formato: dd/mm/aaaa. El usuario puede omitir las barras separadoras en la introducción así como los 2 dígitos del milenio. El programa cliente se encarga de formatear la entrada.

*'''Tipo''' : 'C'
*'''Pestaña''': '0' si no pertenece a ninguna pestaña o el índice de la pestaña a que pertenece.
*'''Etiqueta''': Escoger el literal adecuado de la tabla de literales.
*'''Posición etiqueta''':
**‘E’: Encima, en principio se tomará por defecto esta posición.
**‘I’: A la izquierda, se utilizará cuando el campo sea pequeño, por ejemplo campos tipo S/N.
**‘N’: Sin etiqueta.
*'''Número de dígitos:''' No se utiliza. Se toman siempre diez dígitos.
*'''Pos.1: (x,y)''': Corresponde a la esquina superior izquierda de la caja.
*'''Pos.2: (x,y)''':
**x: No se utiliza.
**y: Si és 0, el campo se dibuja con altura por defecto de 18 pixels, si indicamos un valor, podemos ajustar la altura del campo. Si la altura supera los 24 pixeles la fuente del control es mayor.
*'''Contenido''': 'F'
*'''Signo''': 0, no se utiliza
*'''Editado''': 0, no se usa.
.

==Campo de texto==

*'''Tipo''': 'T'
*'''Etiqueta''': Texto del control, debe indicarse un código de la tabla de literales para que aparezca traducido al lenguaje del usuario. Si no es un código de literal, aparece directamente lo introducido aquí.
*'''Número de dígitos''': se utiliza para calcular el tamaño del control, en caso de que no se haya introducido pos. 2.
*'''Pos.1: (x,y)''': esquina superior izquierda del cuadro
*'''Pos.2: (x,y)''':
**x: Cuando se necesita crear un campo de una determinada extensión gráfica, pero que el número de dígitos es superior a esta, indicamos en la x de la posición 2 la coordenada final del campo gráfico, y automáticamente cuando escribamos y no quepan más letras, ellas solas correrán.
**y: Si és 0, el campo se dibuja con altura por defecto de 18 pixels, si indicamos un valor, podemos ajustar la altura del campo. Si la altura supera los 24 pixeles la fuente del control es mayor.
*'''Posición etiqueta''': Tamaño de la fuente, posibles valores:
**'P': Fuente pequeña
**'M': Fuente mediana
**'G': Fuente grande
**'F': Fuente de espaciado fijo.
**'L': Espaciado fijo, fuente grande
*'''Contenido''': ‘X’ , no se utiliza
*'''Signo''': 0, no se utiliza
*'''Editado''': 0, no se usa
*'''Pasar el control al salir''' : 0, no se usa
*'''Orden de tabulación''': en principio no se usa
*'''Pestaña''': si pertenece a alguna pestaña, su número si no 0.

==Botones==

*'''Tipo''': ‘B’
*'''Número de dígitos''': Se tomará para dimensionar la anchura del botón.
*'''Pos.1: (x,y)''': esquina superior izquierda del botón
*'''Pos.2: (x,y)''':
**x: Número de tecla aceleradora asociada al botón: 1:F1, 2: F2, etc. Listado de teclas aceleradoras.
**y: No se utiliza.
*'''Etiqueta''': Escoger el literal adecuado de la tabla de literales. Aparecerá dentro del botón.
*'''Pasar el control''': 1.

==Botones herramienta==

*'''Tipo''': ‘H’
*'''Contenido''':
**Si no se especifica nada, se utiliza para realizar cualquier acción que establezcamos mediante programación.
**'Y' Botón que muestra una página de ayuda, para más información ver el apartado Botón de ayuda
**'I' Botón que arranca una nueva instancia de la aplicación con los mismos parámetros de conexión que la actual
*'''Etiqueta''': Escoger el literal adecuado de la tabla de literales. Aparecerá cuando el puntero del ratón pase por encima del control (tooltip).
*'''Posición etiqueta''':
**'M': Tamaño medio, 24x24 pixels, valor por defecto
**'P': Tamaño pequeño, 17x17 pixels.
**'G': Tamaño grande, 30x30 pixels, apropiado para usarse en pantallas táctiles.
* '''Pos.2: (x,y)''':
**x: número de tecla aceleradora asociada al botón: 1:F1, 2: F2, etc. Listado de teclas aceleradoras.
**y: se utiliza parar indicar la imagen que será el número asignado en el fichero resource.h del proyecto dgp21i01.
*'''Pasar el control''': 1.

==Botón de ayuda==

Pulsando el botón de ayuda, mediante el ratón o pulsando F1, se accede a la pagina html de ayuda en la posición que corresponda. El prefijo para construir el path completo de la página de ayuda lo resuelve el programa cliente en función del fichero de configuración: puede apuntar a paginas en la intranet de la empresa, internet o páginas locales. Este prefijo se guarda en dgp21.cfg de la forma siguiente:

# --- Path ajuda

ajuda=l:\libs\man\;

El path completo se obtiene añadiendo el código del idioma del usuario.

Por ejemplo, si el usuario ha escogido en la pantalla de conexión el código de idioma 'Fr', francés, las pantallas de ayuda se buscaran en:

l:\libs\man\Fr

Es un control tipo botón de ayuda con las siguientes particularidades:

*'''Tipo''': 'H'
*'''Contenido''': 'Y', ayuda.
*'''Valor por defecto''': Dirección página web y marcador de situación en la página, por ejemplo:

control_presencia1.htm#CP

Normas de estilo para las páginas de ayuda

==Cuadro==

Recuadro planos transparente o con un bitmap.
Como recuadro transparente se usa para agrupar visualmente controles relacionados.

*'''Tipo:''' 'U'
*'''Contenido''': 'B', para mostrar un bitmap, 'N' o cualquier otro, para mostrar un recuadro transparente.
*'''Valor por defecto''': Número de referencia del bitmap.
*'''Pos.1''': Esquina superior izquierda del recuadro.
*'''Pos.2''': Esquina inferior derecha.

==Pantalla o ventana==

Recuadro opaco y con relieve. Para visualizar una ventana superpuesta. Para aplicar el titulo a la ventana debe añadirse un control de tipo texto estático con fondo azul y letras blancas.

*'''Tipo:''' 'P'.
*'''Pos.1 (x,y)''': Esquina superior izquierda del recuadro.
*'''Pos.2 (x,y)''': Esquina inferior derecha.
*'''Tabulador:''' Si és distinto de cero significa que se quiere llamar la atención del usuario y por tanto se muestra la pantalla aunque en aquel momento la aplicación esté minimizada u oculta por otra aplicación.

==Texto extenso==

Controles tipo caja para albergar un texto extenso. Si el texto sobrepasa el área del control, aparece la barra de scroll vertical.

*'''Tipo:''' 'X'
*'''Contenido: 'M', Indicamos tipo de letra mediana, en cualquier otro caso letra por defecto.
*'''Número de dígitos: Longitud máxima del campo
*'''Pos.1 (x,y)''': Esquina superior izquierda del recuadro.
*'''Pos.2 (x,y)''': Esquina inferior derecha.

==Menú==

Tipo de campo utilizado en los menús.

*'''Tipo''': 'M'.
*'''Contenido: irrelevante.
*'''Pos. 2''': irrelevante, la anchura se fija en función del número de dígitos.
*'''Tipo de fuente''': fijado por la aplicación.

==Línea de listado==

Se utiliza para las líneas de listado. Pinchando sobre ellas se resaltan y suelen utilizarse para realizar alguna acción relacionada con la línea de datos.

*'''Tipo:''' 'I'
*'''Pos. 2''': irrelevante, altura fija, la longitud se fija en función del número de dígitos.
*'''Fuente''': fija.

==Campos tipo pestaña==

Habrá que definir tantos controles de este tipo como pestañas distintas. Cada una de ellas tendrá un núm. de orden distinto empezando por 1. El tamaño del control lo tomará de la pestaña con núm. pestaña = 1. Para asignar los controles a las pestañas habrá que indicar en ellos el núm. de pestaña al que pertenecen. Si núm. Pestaña = 0 no pertenece a ninguna pestaña.

Limitación sólo es posible 1 pestaña por pantalla.

*'''Tipo''': 'N'
*'''Etiqueta''': nombre de la pestaña
*'''Pos.1: (x,y)''': esquina superior izquierda del cuadro
*'''Pos.2: (x,y)''': esquina inferior derecha, sólo se tiene en cuenta para la Pestaña = 1
*'''Posición etiqueta''': poner ‘P’, de momento no se utiliza.
*'''Contenido''': ‘X’ , no se utiliza
*'''Signo''': 0, no se utiliza
*'''Número de dígitos''': no se utiliza, el tamaño de la pestaña depende de su etiqueta.
*'''Editado''': 0, no se usa
*'''Pasar el control al salir''': 0, no se usa
*'''Orden de tabulación''': en principio no se usa.
*'''Pestaña''': Núm. De pestaña empezando por 1.

==Campo tipo “Checkbox”==

*'''Estado''': campo que sólo permite 2 estados:
**Chequeado
** No chequeado.

*'''Tipo''': 'K'
*'''Etiqueta''': Nombre del campo
*'''Pos.1: (x,y)''': esquina superior izquierda del cuadro de chequeo
*'''Pos.2: (x,y)''': no se utiliza
*'''Posición etiqueta''':
**‘I’: A la izquierda
**‘N’: Sin etiqueta
**'D': A la derecha
*'''Contenido''':
**‘X’ : Si el campo está chequeado su valor es 'S', en caso contrario su valor es ' ' (un espacio)
**'B': Campo boleano estricto, si está chequeado su valor es 'S', en caso contrario es 'N'.
*'''Signo''': 0, no se utiliza
*'''Número de dígitos''': no se utiliza.
*'''Editado''': 0, no se usa

==Texto interactivo==

Campo de texto que al clicar sobre él con el ratón cambia de color. Se utiliza para las líneas de una grid. Se juega con los atributos para darle un fondo de color y crear el listado con colores alternos para cada línea.

*'''Tipo''': 'I'
*'''Etiqueta''': No se usa
*'''Pos.1: (x,y)''': esquina superior izquierda del cuadro
*'''Pos.2: (x,y)''': No se usa.
*'''Posición etiqueta''': Tamaño de la fuente, posibles valores:
**'P': Fuente pequeña
**'M': Fuente mediana
**'G': Fuente grande
**'F': Fuente de espaciado fijo.
*'''Contenido''': ‘X’ , no se utiliza
*'''Signo''': 0, no se utiliza
*'''Número de dígitos''': se utiliza para calcular la longitud del control..
*'''Editado''': 0, no se usa
*'''Pasar el control''': al salir = 1
*'''Orden de tabulación''': en principio no se usa.
*'''Pestaña''': si pertenece a alguna pestaña, su número si no 0.
*'''Pertenencia''': 'L' indica que pertenece a una grid.
*'''Enlazar control''': Cuando la pantalla que contiene la “grid” tiene un área de detalle con los campos de la línea del listado, entonces enlaza con el control 36 que es el encargado de rellenar ese detalle a partir del oid correspondiente a la línea seleccionada.
*'''Nota''': Este campo debe tener la función g_fijar que tiene como misión obtener el “oid” de la línea seleccionada.

Archivo:Boto 128.png

2008-12-10T09:37:43Z

Albert Castilla Querol: Efectos

Efectos

Fichas comerciales

2008-12-10T08:54:05Z

Albert Castilla Querol:

{| style="position:absolute; top:0; width:100%; background:#F8FCFF; color:#888;" valign="middle"
|-
|
<h1 style="margin:0; border-bottom:0;"><br>
Fichas comerciales
|}

[[Media:dgc0101.png|Pantalla ejemplo]]

Pantalla que nos sirve para dar de alta, modificar o borrar las fichas comerciales de los clientes i/o proveedores de marketing.

==Botones==

===Parte superior===

=====[[Imagen:boto_149.png]] Búsqueda avanzada por actividad=====

=====[[Imagen:boto_106.png]] Búsqueda avanzada=====
Nos sirve para realizar una búsqueda de una o varias fichas según diversos criterios.

=====[[Imagen:boto_114.png]] Alta o consulta tercero=====
Cada una de nuestras fichas figurará como terceros; en caso de que queramos consultar o modificar algún dato, accederemos a la información clicando este botón

=====[[Imagen:boto_122.png]] Consulta de pedidos=====
También podemos consultar y trabajar, desde esta pantalla, con los documentos relacionados con la ficha comercial en la que nos encontremos

=====[[Imagen:boto_105.png]] Imprimir ficha comercial=====
Cuando cliquemos en este botón se nos abrirá un cuadro y nos pedirá qué formato y qué impresora queremos utilizar para esa ficha. Nos imprimirá la que tengamos seleccionada.

=====[[Imagen:boto_110.png]] Documentos=====
Para poder ver los documentos relacionados con la ficha seleccionada.

=====[[Imagen:boto_120_2.png]] Nuevo documento=====

=====[[Imagen:boto_115.png]] Enviar e-mail=====
Con este botón abrimos nuestro gestor de correo , siempre y cuando el contacto que tengamos seleccionado disponga de una dirección de e-mail en el campo "Correo electrónico". La dirección de dicho contacto ya saldrá en el campo "Para" del correo.

=====[[Imagen:boto_101.png]] Informe impreso=====
Para abrir un documento, con un procesador de texto, y poder ver el listado de fichas de nuestra selección inicial.

=====[[Imagen:boto_102.png]] Exp. a hoja de cálculo=====
Podemos tener nuestra lista de fichas comerciales en una hoja de cálculo si clicamos en este botón

===Parte inferior===

=====[[Imagen:boto_099.png]] / [[Imagen:boto_100.png]] Agendas / Visitas=====
Teniendo seleccionada una ficha, accederemos a las agendas o a las visitas que tengamos de ese contacto.

=====[[Imagen:boto_098.png]] / [[Imagen:boto_097.png]] Generar agenda/Generar visitas=====
Teniendo seleccionada una ficha, podemos crear una agenda o una visita nueva para esa ficha.

=====[[Imagen:boto_092.png]] Familias=====
Mediante este botón y teniendo seleccionada una ficha, accederemos a una pantalla dónde nos aparecerán las familias asignadas esa ficha, y donde podremos añadir o borrar alguna.

==Campos==

=====Código=====
Valor númerico que identifica la ficha comercial. Ha de ser único en la tabla.
=====Nombre=====
=====Nombre, continuación=====
=====Alias cliente=====
=====Domicilio=====
=====Código postal=====
=====Población=====
=====Provincia=====
=====País=====
Por defecto España, viene precedido por un código identificativo de dos caracteres y se escoge mediante un botón de selección.
=====CIF=====
=====Teléfono=====
=====Fax=====
=====Zona=====
Se escoge mediante una pantalla de selección dónde aparecen las diferentes zonas.

=====Persona de contacto=====
=====Correo electrónico=====
=====Horario=====
=====Código, Agente=====
Tanto el código del agente como su nombre, se completan al escoger éste en la pantalla de selección que aparece al clickar sobre el botón de selección.

=====Idioma=====
=====Fecha de apertura=====
Por defecto, el primer dia del mes en curso, aunque se puede modificar para poner cualquier otra fecha. En cualquier caso, este campo siempre ha de contener algún valor.

=====Bloqueado=====
=====Tercero=====
Se puede dar el caso que un cliente de marketing sea al mismo tiempo un tercero, o sea un cliente de gestión o un proveedor. En este campo pondremos el código de este cliente dentro de la tabla de terceros.

=====Rotación=====
En este campo pondremos el tiempo, en dias, que habrá por defecto entre una visita y otra de este cliente.

=====Hora preferente=====
=====Observaciones=====

Uso general de una pantalla

2008-12-10T08:50:10Z

Albert Castilla Querol:

Archivo:Dgc0101.png

2008-12-10T08:49:24Z

Albert Castilla Querol: uploaded a new version of "Imagen:Dgc0101.png": Fichas comerciales

Fichas comerciales

Uso general de una pantalla

2008-12-09T11:40:29Z

Albert Castilla Querol:

Casi todas las pantallas de las aplicaciones Dgp21 tienen un funcionamiento muy similar. Aquí explicamos la funcionalidad común de una pantalla de la aplicación en la que efectuamos un mantenimiento de datos.

Vamos a tomar como ejemplo la pantalla de fichas comerciales de l'ERP i-Globalgest.

Arriba a la izquierda tenemos el código de la empresa, el usuario con el que estamos conectados y la versión del programa.

Abajo tenemos el nombre de la empresa, la pantalla en la que estamos, el código de dicha pantalla y la fecha.

[[Imagen:pantalla1.png|thumb|200px|right|none|Pantalla ejemplo]]

==Botones comunes==

Al acceder a cualquier pantalla de la aplicación de este tipo, casi siempre entraremos en modo consulta. Las pantallas y ante cualquier acción que queramos realizar deberemos seleccionar el icono correspondiente.

Hay una serie de iconos que van a ser comunes a todas las pantallas de la Gestión Comercial, y siempre van a tener la misma función.

También existe la posibilidad, mediante el teclado, de realizar algunas de las funciones de los iconos; son las teclas de acceso rápido.

A continuación se detallan estos iconos con su representación gráfica, su función y la correspondiente tecla de acceso rápido:

[[Imagen:boto_006.png]] Nuevo, F2. Para cualquier nueva acción que vayamos a realizar.

[[Imagen:boto_007.png]] Seleccionar, F3. Para hacer una selección según el criterio más conveniente.

[[Imagen:boto_008.png]] Modificar, F6. Para realizar cualquier tipo de modificación.

[[Imagen:boto_011.png]] Guardar, F5. Este botón solo aparece si estamos en el modo modificar o nuevo. Para guardar los cambios o el nuevo registro.

[[Imagen:boto_009.png]] Borrar. Para eliminar el registro que tengamos seleccionado en ese momento.

[[Imagen:boto_025.png]] Enviar mensaje, F7. Sistema de mensajería interna.

[[Imagen:boto_021.png]] Ayuda. Para cualquier duda que tengamos, estemos en la pantalla que estemos.

[[Imagen:boto_023.png]] Abrir otra sesión. Iniciar otras sesiones sin cerrar en la que estemos.

==Dar de alta [[Imagen:boto_006.png]]==

Para dar de alta debemos clicar en Nuevo; se nos activarán una serie de campos que debemos rellenar. Acto seguido clicamos en el botón de guardar para salvar la información dentro de la base de datos.

==Seleccionar/Buscar [[Imagen:boto_007.png]]==

Si lo que queremos es hacer una selección o búsqueda clicamos en el correspondiente icono, y de inmediato se activan los campos por los cuales podemos realizar búsquedas, que seguirá los criterios que le hayamos marcado nosotros. Si no recordamos al detalle lo que queremos buscar podemos introducir el símbolo del tanto por cien ''%'' para que nos busque una palabra clave (un registro que contenga dicha palabra); escribiremos dicho signo seguido de la palabra a buscar.

Por ejemplo si queremos buscar una empresa llamada Luces García,S.A pero solo nos recordamos que contiene la palabra luces, escribimos:
''%luces''
Al tener la selección hecha, clicamos en Buscar y en la Grid (parrilla).
De este modo nos saldrá un listado con las empresas. En nuestro ejemplo nos saldran las empresas que contengan la palabra ''luces''.
Si clicamos sobre uno de los registros veremos que los campos inferiores se rellenan con los datos pertenecientes al registro que hemos marcado.
En este punto no podemos realizar ninguna modificación, ni alta.

[[Imagen:Ventana_de_control.jpg]] La ''Ventana de control'' nos indica el número de registros que contiene la búsqueda que hemos realizado.

En la parte superior del listado que tenemos, vemos que estan los campos con la información para cada registro que tenemos de la búsqueda. Si clicamos en ''Código'', por ejemplo,se nos ordenarán todos los registros por el campo de ''Código'' y asi con todos según nuestro interés.

Los botones de navegación nos permiten avanzar y retroceder registros, de uno en uno, toda la página o de principio a final.

==Modificar [[Imagen:boto_008.png]]==

En caso que queramos modificar algun registro debemos marcar en registro y seguidamente clicar en el botón de ''Modificar'' o usar el acceso de teclado presionando ''F6''.
En ese momento los campos que podemos modificar se activaran y podremos clicar en ellos y realizar las modificaciones pertinentes. Una vez realizadas las modificaciones clicamos en el botón ''Guardar'' o ''F5''.

==Borrar [[Imagen:boto_009.png]]==

Para borrar simplemente nos debemos colocar sobre el registro que queramos eliminar y clicar en el botón ''Borrar''. Antes de borrar, la aplicación abre un mensaje de confirmación de borrado de registro, si estamos seguro de querer borrar, le damos a ''Aceptar'' y nos lo borrará.

==Enviar mensaje [[Imagen:boto_025.png]]==

Enviar un mensaje interno clicamos en el icono de Mensajes.
Inmediatamente después se nos abrirá una ventana como esta.

[[Imagen:Pmens.jpg|thumb|200px|right|none|Clica en la imagen para ver los puntos]]

'''1 –''' Aquí pondremos sí el mensaje va destinado a un grupo, a un usuario en concreto o a todos. Podemos darle al desplegable para ver que opciones tenemos.

'''2 –''' En caso de seleccionar ''Todos'' esta pestaña no tiene función ya que aquí es donde escogeremos a que grupo o usuario queremos enviar el mensaje.

'''3 –''' Aquí es donde escribiremos el cuerpo del mensaje.

'''4 –'''

''Enviar SMS'': opción dehabilitada.

''Retardo'': opción deshabilitada.

''Fecha aviso'': es donde pondremos la fecha que queremos que llegue el mensaje al receptor.

''Hora'': hora de llegada del mensaje.

''Vigencia'': es el tiempo, en minutos, que le damos de “vida” el mensaje. Por ejemplo si enviaramos un mensaje a todos los jefes de departamento de que hay una reunión a las 15:00 y uno de los jefes esta fuera por algun motivo y no esta conectado a la aplicación. Una vez pasado el tiempo de vigencia el mensaje se elimina para evitar que, al día siguiente, entre en la aplicación y le llegue el mensaje de que ayer había una reunión.
Así que sí el mensaje no ha sido leído, se eliminará cuando el tiempo expire.

''Urgente'': simplemente para marcar el mensaje como urgente.

''Aviso de recepción'': te notifica cuando el receptor abre el mensaje.

'''5 -''' Ventana donde escribiremos el mensaje de SMS, pero por ahora la opción esta desahabilitada.

==Otros==

[[Imagen:boto_021.png|left]]
Con este botón podremos acceder a la ''Ayuda'' en cualquier momento para saber qué hacer en cada pantalla y para qué sirve.

[[Imagen:boto_023.png|left]]
Para abrir otra sesión con el mismo usuario y en la misma empresa (tantas como nos hagan falta) presionamos el botón ''Abrir otra sesión'' y se nos abrirá otra pantalla. En la nueva pantalla estaremos situados en el menú y desde allí podremos hacer otra función de forma paralela a la anterior.

[[Imagen:Boto_249.png|left]]
Este botón, que esta presente al lado de diversos campos, sirve para dirigirnos a la pantalla de la tabla directamente relacionada con el campo para poder añadir algún registro a la tabla, para luego poder ponerlo en el campo. Una vez introducidos los cambios solo tenemos que clicar en el botón de cerrar la pantalla ( [[Imagen:Boto_12.png]] o F8)para salir de la pantalla actual e ir a la pantalla anterior.

Mantenimiento de Terceros

2008-12-09T11:17:00Z

Albert Castilla Querol:

{| style="position:absolute; top:0; width:100%; background:#F8FCFF; color:#888;" valign="middle"
|-
|
<h1 style="margin:0; border-bottom:0;"><br>
Terceros
|}
----

[[Media:Dgg0102.jpg|Pantalla ejemplo]]

Los terceros son todas aquellas aquellas entidades, empresas o personas físicas con las cuales se efectúan transacciones comerciales. Los clientes y proveedores de la empresa son todos ellos terceros. Si tercero actúa como cliente y proveedor a la vez, sólo debe introducirse una vez.

En la pantalla de introducción de datos vemos que hay 3 apartados o pestañas:

:*General, datos generales
:*Cliente, datos que actúan en la relación del tercero como cliente
:*Proveedor, datos que actúan en la relación del tercero como proveedor

==Campos==

=====Código=====
Número de hasta 8 dígitos que identifica unívocamente el tercero. Podemos fijar ese número o bien solicitar a la aplicación que nos suministre uno, clickando el botón [[Imagen:Boto_066.png]], en este caso obtendremos el primer código de tercero libre.

El código 1 se reservará para la figura "Cliente o proveedor varios" , para utilizarse en operaciones con terceros no habituales.

=====Nombre=====
Nombre del tercero

=====Alias=====
Nombre, normalmente más corto que el completo, para reconocer al tercero sin necesidad de escribir todo el nombre, como por ejemplo las siglas de la empresa.

==Pestaña General==

=====Segundo nombre=====
Si el nombre de la empresa es tan largo que no nos cabe en el campo Nombre, lo continuamos en esta otro campo.

=====Persona de contacto=====

=====Domicilio=====

=====Teléfono=====

=====Fax=====

=====Cliente=====
Si el tercero es cliente en esta casilla deberemos poner una S; si no es cliente ponemos una N

=====Proveedor=====
Si el tercero es proveedor en esta casilla deberemos poner una S; si no es proveedor ponemos una N

=====C.P.=====
Código Postal.

=====Población=====

=====CIF=====
Código de identificación fiscal.
Rellenarlo sin utilizar guiones u otros signos de separación

=====CIFP=====
Código propio del país para el CIF

=====Provincia=====

=====Horario=====

=====Zona=====
Se toma de la tabla de [[dgg0202|zonas]]. Permite agrupar los terceros en zonas geográficas para facilitar las tareas de entregas o recogidas.

=====País=====
Identificador de país (ES, FR, ...).Los diferentes países están definidos en la tabla de [[dgg0207 | países]]. Es importante no olvidar introducir este dato. En función de este código se consideraran las operaciones interiores, intracomunitarias o exportaciones a efectos de IVA. Se recomienda la utilización de la codificación estandard [http://es.wikipedia.org/wiki/ISO_3166-1 ISO 3166-1].

=====Correo electrónico=====

=====Grupo de facturación=====
Se elige de la tabla de grupos de facturación.

=====Idioma=====
Se tomará de la tabla de [[dgg0011 | idiomas]]. La aplicación permite definir descripciones para artículos y otros objetos en diferentes idiomas. El idioma se toma en cuenta cuando se utilizan dichos objetos. Por ejemplo: cuando se hace un albarán a un cliente se toman las descripciones de los artículos en su idioma si están definidas.

=====Observaciones=====
Observaciones internas.

=====Moneda=====
Se tomará de la tabla de [[divisas01 | divisas]]. En las operaciones que se realicen con el tercero se tomará la divisa aquí indicada por defecto.

=====IVA=====
(S/N) Indica si hay que aplicar IVA en sus operaciones tanto de venta como de compra.

=====Recargo de equivalencia=====
(S/N) Indica si hay que aplicar recargo de equivalencia en sus operaciones de compra.

=====Certificado de calidad=====
(S/N) Si el cliente requiere certificados de calidad para los productos entregados, se indica aquí. Los certificados se generarán de forma automática al hacer los albaranes de entrega.

=====Etiquetas Odette=====
(S/N) Indica si las entregas de material para este cliente deben acompañarse con etiquetas "Odette", en cuyo caso se generan automáticamente en el momento de hacer el albarán de entrega.

=====Agentes comerciales=====
Podemos indicar hasta 3 agentes comerciales asignados al cliente. Deben estar introducidos previamente como [[dgg0107|agentes comerciales]].

==Campos comunes Pestaña Cliente/Proveedor==

Datos particulares en función del tipo de tercero.

=====Persona de contacto=====
Persona con la que nos pondremos en contacto para comunicarnos con la empresa.

=====Condiciones de envío=====
Condiciones de envío por defecto para el tercero. Pueden cambiarse para una operación concreta desde la introducción de pedidos o albaranes. Las diferentes condiciones de envío están definidas en la tabla de [[dgg0203 | condiciones de envío]].

=====Condiciones de pago=====
Condición de pago/cobro establecida con el tercero. Se utilizará para calcular vencimientos y formas de pago en la generación de facturas al tercero, tanto de compras como de ventas.
Cada condición de pago corresponde a una combinación de valores definidos en la tabla de [[dgg0204 | condiciones de pago]].

=====Días de pago=====
Si para el tercero tenemos establecidos días de pago, lo indicamos aquí. Se utiliza para calcular los vencimientos de las operaciones de compra o venta en conjunción con las condiciones de pago. Pueden fijarse hasta 3 días de pago.

=====Mes de vacaciones=====
Si se indica, interviene el cálculo de vencimientos de las operaciones con el tercero, los vencimientos para el mes de vacaciones son retrasados al mes siguiente.

=====Dto comercial=====
Descuento comercial.
Porcentaje de descuento (nn,nn%) aplicado a pie de factura. Se utiliza en el cálculo de facturas del tercero.

=====Dto p.p./rec.fin=====
Descuento pronto pago o recargo de financiación
Porcentaje de descuento o recargo (nn,nn%). Si el porcentaje es de signo positivo toma la consideración de recargo de financiación, si es negativo es un descuento pronto pago. Se utiliza en el cálculo de facturas del tercero.

=====Seg. Transp.=====
Seguro de Transportes
Tiene efecto en la Gestión para Empresas de Transporte.
Indica si el cliente quiere que la mercancía viaje asegurada y en consecuencia se aplique el seguro en el cálculo de los transportes.

=====C.C.C.=====
Identificación de la cuenta en la que se domicilian los pagos.
Si se indica una cuenta de una entidad bancaria Española, deben ser 20 dígitos numéricos sin caracteres de separación.

=====Domicilio de pago=====
Domicilio en el que se atenderán los pagos/cobros de los efectos cuando difiera del domicilio del tercero.

=====Cuenta de cancelación=====
Es la cuenta contable por defecto en la que se prevee efectuar el pago/cobro de los efectos. Debe estar definida en el [[cuentas001 | plan contable]].

=====Dirección de correo electrónico=====

=====Cuenta contable=====
Es la cuenta en que se anotarán las operaciones con el tercero. Puede dejarse en blanco, en cuyo caso se dará de alta automáticamente de la forma: "grupo contable por defecto" + "código tercero". Si por el contrario se indica una cuenta, esta debe existir en el [[cuentas001 | plan contable]]. El grupo contable por defecto se fija en la configuración general de la empresa.

=====Referencia=====
Si el tercero nos ha asignado un código o referencia con el que nos identifica, lo podemos indicar aquí. Podrá aparecer en los documentos que se generen para él, por ejemplo: pedidos a proveedores, pedidos, albaranes y facturas a clientes.

=====Albarán valorado=====
(S/N) Indicamos si los albaranes de este tercero estarán valorados (tendrán importe) o no.

=====Riesgo=====
Importe máximo de riesgo que hemos asignado al cliente o que el proveedor nos ha asignado a nosotros. La aplicación nos alerta o bloquea las operaciones que van a superar este riesgo.

=====Bloqueado=====
(S/N) Mediante este campo podemos bloquear un tercero de forma que la aplicación no permita operar con él.

=====Intrastat=====
Son códigos de utilidad para la generación de la declaración del Intrastat.

=====Factura por albarán=====
En este campo indicaremos si por cada albarán se hace una factura (S) o si se facturan todos los albaranes de una sola vez (N).

=====Ret.Garantía=====
Porcentage de retención (nn,nn%). Informa si al efectuar una factura a cliente o al introducir una factura de proveedor hay que aplicar una retención por garantía.

=====Cuenta ret. garantía=====
Cuenta contable donde se contabilizará en su caso el importe de retención por garantía. Por defecto la aplicación propone una cuenta, pero puede cambiarse si se desea. Dicha cuenta se creará automáticamente

=====Ret. IRPF=====
Porcentaje de retención (nn,nn%) por IRPF que se aplica en las facturas del tercero. Si se indica un valor debe indicarse a su vez la cuenta de IRPF que recogerá la contabilización de las retenciones.

=====Cuenta I.R.P.F.=====
Cuenta contable utilizada para contabilizar las retenciones de las facturas del tercero. Si hemos especificado el porcentaje de retención del I.R.P.F, hemos de introducir esta cuenta.Dicha cuenta debe estar previamente definida en el [[cuentas001 | plan contable]].

=====IBAN=====
El Código Internacional de Cuenta Bancaria (IBAN) es un número de identificación que permite validar internacionalmente una cuenta que tenga un cliente en una entidad financiera.

Tanto el IBAN como el CCC (estándar español de cuentas) identifican la misma cuenta.

El IBAN puede utilizarse en todas las operaciones con el extranjero, con todos los países del mundo, y sirve principalmente para identificar la cuenta bancaria en los pagos internacionales.

=====BIC=====
Código internacional de identificación bancaria es aquel que permite identificar de forma única a cada entidad de crédito y/o sus oficinas.

Consiste en 8 u 11 caracteres alfanuméricos con el siguiente significado:

* Código entidad de crédito: son 4 caracteres identificativos de la institución financiera a nivel mundial.
* Código país: son 2 caracteres que identifican al país (o territorio geográfico) donde está ubicada la unidad central de negocio de la entidad de crédito.
* Código localidad: son 2 caracteres identificativos de la región o ciudad donde está ubicada la unidad central de negocio de la entidad de crédito.
* Código oficina: son 3 caracteres que identifican una determinada oficina o departamento de la institución financiera.

=====Agencia de transportes=====
Agencia de transportes asignada al tercero. Al introducir pedidos y albaranes del tercero, se tomará este valor por defecto. Se toma de la tabla de [[dgg0105 | agencias de transportes]].

=====Observaciones=====
Observaciones internas.

=====A1, A2=====
Campos alfanuméricos libres para guardar cualquier valor que el usuario desee.

=====N1, N2=====
Campos numéricos libres para guardar cualquier valor que el usuario desee.

==Campos exclusivos de Pestaña Cliente==

=====Serie de facturación=====
Este dato se utiliza en la generación de facturas para el tercero. La numeración de las facturas generadas se toma de la serie de facturación. Por defecto se toma la serie <nowiki>'General'</nowiki>, pero puede establecerse una serie específica para un tercero. Los posibles valores se definen en la tabla de [[dgg0213 | series de facturación]].

=====Riesgo aseg.=====
Riesgo asegurado.
Indica el importe de riesgo asegurado para el tercero
=====Entidad aseguradora=====
Entitad en la cual hemos asegurado el importe de riesgo anterior.

==Campos exclusivos de Pestaña Proveedor==

=====ISO Doc.=====
Referencia del documento ISO.
Referencia correspondiente al documento de certificación ISO del proveedor, incorporado en la [[dgd0101 | gestión de documentos]]. Clickando en el botón [[Imagen:Boto_063.png]], podremos consultarlo.

=====Hasta fecha (ISO Doc.)=====
Fecha de caducidad del documento anterior.

=====Reg. Sanitario.=====
Referencia del documento de registro sanitario.
Referencia correspondiente al documento de registro sanitario del proveedor, incorporado en la [[dgd0101 | gestión de documentos]]. Clickando en el botón [[Imagen:Boto_063.png]], podremos consultarlo.

=====Hasta fecha (Reg. Sanitario)=====
Fecha de caducidad del documento anterior.

==Botones especiales==
[[Imagen:Boto_160.png|left]] ''Direcciones de envío de factura'': Puede pasar que una misma empresa tenga distintas sedes a las que enviar las facturas; en caso de que sea así, este botón nos mostrará las que hay.

[[Imagen:Boto_150.png|left]]
''Direcciones de envío de albaranes'': lo mismo que el caso anterior, pero en lugar de ser facturas serán albaranes.

[[Imagen:Boto_149.png|left]]
''Listado de impreso'': nos presenta un listado en el que podemos incluir Clientes, Proveedores o Agentes, y puede ser ordenado por código o por nombre.

[[Imagen:Boto_219.png|left]]
''Salir'': este botón sólo nos aparecerá cuando estemos en otra pantalla y vayamos a realizar cualquier consulta sobre un tercero; al realizar una búsqueda este botón nos permite salir cargando los datos de aquello que hemos buscado.