Swiss Magic Data -- Form Relationships

En este artículo se dan las generalidades de la estructura del editor de datos swiss magic que se utilizó para crear la interfaz de la red para definir relaciones de formularios. Recuerde que un nodo swiss de tipo XXX se implementa por la clase I2CE_Swiss_XXX. Todas las clases mencionadas están contenidas en el directorio

I2CE/modules/Forms/modules/FormRelationships/lib

FormRelationship_Base

Esta es la clase base que esta contenida como sub-clase en todas las clases Swiss que se utilizan para editar Relaciones de Formularios.

FormRelationships

El root swiss node del editor de relaciones de formularios es de tipo FormRelationships. Tiene la siguiente funcionalidad:

• Es un nodo contenedor que contiene todas las relaciones de formularios.
• Crea una nueva relación de formulario con un "Display Name" dado y un "Short Name" al crear un Nuevo nodo de datos magic secundario. La nueva relación se puede basar en:
  • Escoger un formulario primario
  • Escoger una relación existente de la cual copiarla.

Todos los secundarios de este nodo swiss tienen tipo #FormRelationship.

FormRelationship

Este es el nodo swiss que contiene toda la información acerca de una relación de formularios particular.

Tiene la siguiente funcionalidad:

• Especifíca el formulario
• Especifíca el nombre de visualización de este formulario en la relación
• Especifíca la descripción de este formulario en la relación
• vincula al menú de formularios unidos
• vincula al menú de limitación de este formulario
• vincula al menú de funciones sql

Los nodos swiss secundarios se nombran:

• 'reporting_functions' with type #FormRelationship_ReportingFunctions
• 'joins' with type #FormRelationship_Joins
• 'where' #FormRelationship_Where

FormRelationship_Joins

Este es el nodo swiss que contiene toda la información acerca de los formularios unidos al formulario del nodo swiss primario. Tiene la funcionalidad:

• Unir en un formulario relacionado el formulario definido por el nodo swiss primario

Todos los secundarios de este nodo swiss tienen tipo #FormRelationship_Join.

FormRelationship_Join

Este es el nodo swiss que representa un formulario unido en la relación del formulario.

It subclasses #FormRelationship and has almost the same functionality and children. The difference is that:

• It does not link to the SQL Functions menu
• It shows how this form is joined to the parent form in the relationship (the primary form does not need this as it has no parent)
• It allows you to "drop empty rows."
  Note: The language should be cleaned up here as we use form relationships outside of the Custom

Reporting scenario. It means that a set of forms potentially satisfying a form relationship is will fail to satisfy the relationship if there is no form matching the where clause at this node.

FormRelationship_Where

This provides a where (sub)-clause for a form relationship. It has the following functionality:

• if not specified, allow you to specify the "type" of the node as either a logical operator (AND, OR, NOT, XOR) or as a limit on a field in the form
• if specifed, allows you to change the "type"

There is one child swiss node 'operands' which has type #FormRelationship_Where_Operands

Note: The functionality of this swiss node should probably be moved to a sub-module of the FormLimits modules

FormRelationship_Where_Operands

This node is used in the case where the parent swiss node is one of the logical operators AND, OR, NOT or XOR. It has the following functionality:

• Displays the existing operands
• Adds a new operand for the logical operators if possible (NOT has only one operand)
• Allows you to remove an operand

All children of this node are of type #FormRelationship_Where

Note: The functionality of this swiss node should probably be moved to a sub-module of the FormLimits modules

FormRelationship_ReportingFunctions

This swiss node is a container for all of the SQL functions that are defined for the form relationship. It has the following functionality:

• display the existing sql functions in the relationship
• adds in a place for a new sql function determined by "Short Name," a "Display Name" and a "Description"

All children of this node have type #FormRelationship_ReportingFunctions.

Note: This functionality should probably be moved to be a sub-module of Forms.

SQLFunction

This swiss node is used to define a SQL function in a relationship. It has the following functionality:

• edit the display name
• edit the description
• edit the SQL function which is applied to any of the form fields in the relationship
• choose the return type of the SQL function to be any of the (non-abstract) subclasses of I2CE_FormField.

Note: This functionality should probably be moved to be a sub-module of Forms.