Saltar al contenido principal
Versión: Siguiente

GET FIELD RELATION

GET FIELD RELATION ( campoN ; uno ; muchos {; *} )

ParámetroTipoDescripción
campoNFieldCampo de inicio de una relación
unoIntegerEstado de la relación Muchos a Uno
muchosIntegerEstado de la relación Uno a Muchos
*Operador• Si se pasa: uno y muchos devuelven el estado actual de la relación (valores 2 o 3 únicamente) • Si se omite (por defecto): uno y muchos puede devolver el valor 1 si la relación no ha sido modificada por programación

Descripción

El comando GET FIELD RELATION permite conocer el estado automático/manual de la relación comenzando desde el campoN para el proceso actual. Todas las relaciones pueden ser consultadas, incluyendo las relaciones automáticas en la ventana de Estructura.

  • Pase en campoN, el nombre del campo de la tabla N desde donde comienza la relación cuyo estado quiere conocer. Si ninguna relación se origina desde el campo campoN, los parámetros uno y muchos devuelven 0, se genera un error y la variable sistema OK toma el valor 0 (ver a continuación).
  • Después de la ejecución del comando, la variable uno contiene un valor indicando si la relación Muchos a Uno especificada está definida como automática:
    0 = no hay relación desde campoN. Se genera el error de sintaxis No. 16 (“El campo no tiene relación”) y la variable sistema OK toma el valor 0.
    1 = el estado automático/manual de la relación Muchos a Uno especificado está definido por la opción Relación Muchos a Uno automática en las propiedades de la relación en el entorno Diseño (no ha sido modificado por programación).
    2 = la relación Muchos a Uno es manual para el proceso.
    3 = la relación Muchos a Uno es automática para el proceso.
  • Después de la ejecución del comando, el parámetro muchos contiene un valor indicando si la relación Uno a Muchos especificada está definida como automática:
    0 = no hay relación desde campoN. Se genera el error de sintaxis No. 16 (“El campo no tiene relación”) y la variable sistema OK toma el valor 0.
    1 = el estado automático/manual de la relación Uno a Muchos especificada está definido por la opción Relación Uno a Muchos automática en las propiedades de la relación en el entorno Diseño (no ha sido modificado por programación).
    2 = la relación Uno a Muchos es manual para el proceso.
    3 = la relación Uno a Muchos es automática para el proceso.

Puede comparar los valores recibidos en los parámetros uno y muchos con las constantes del tema “”:

ConstanteTipoValor
AutomaticEntero largo3
ManualEntero largo2
No relationEntero largo0
Structure configurationEntero largo1
  • El parámetro opcional * permite “forzar” la lectura del estado actual de la relación, incluso si no ha sido modificado por programación. En otras palabras, cuando pasa el parámetro opcional *, sólo pueden devolverse los valores 2 ó 3 en los parámetros uno y muchos.

Ejemplo

Dada la siguiente estructura:

Las propiedades de la relación que une el campo [Empleados]Empresa con el campo[Empresas]Nombre son las siguientes:

El siguiente código ilustra las diferentes posibilidades ofrecidas por los comandos GET FIELD RELATION, GET AUTOMATIC RELATIONS y SET FIELD RELATION, SET AUTOMATIC RELATIONS así como sus efectos:

 GET AUTOMATIC RELATIONS(one;many) //devuelve False, False
 GET FIELD RELATION([Empleados]Empresa;one;many) //devuelve 1,1
 GET FIELD RELATION([Empleados]Empresa;one;many;*) //devuelve 3,2
 
 SET FIELD RELATION([Empleados]Empresa;2;0) //cambia la relación Muchos a uno a manual
 
 GET FIELD RELATION([Empleados]Empresa;one;many) //devuelve 2,1
 GET FIELD RELATION([Empleados]Empresa;one;many;*) //devuelve 2, 2
 
 SET FIELD RELATION([Empleados]Empresa;1;0) //restablece los parámetros definidos en el entorno Diseño para la relación Muchos a Uno
 
 GET FIELD RELATION([Empleados]Empresa;one;many) //devuelve 1,1
 GET FIELD RELATION([Empleados]Empresa;one;many;*) //devuelve 3,2
 
 SET AUTOMATIC RELATIONS(True;True) //cambia todas las relaciones de todas las tablas a automática
 
 GET AUTOMATIC RELATIONS(one;many) //devuelve True, True
 GET FIELD RELATION([Employees]Company;one;many) //devuelve 1,1
 GET FIELD RELATION([Employees]Company;one;many;*) //devuelve 3,3

Ver también

GET AUTOMATIC RELATIONS
GET RELATION PROPERTIES
SET AUTOMATIC RELATIONS
SET FIELD RELATION