Diferencia entre revisiones de «Colecciones»

De Egeasy
Saltar a: navegación, buscar
 
(No se muestran 189 ediciones intermedias del mismo usuario)
Línea 1: Línea 1:
−
dsfsdf
+
__TOC__
−
asdasdasd
+
==¿Qué es una colección?==
 +
<p>Una {{T|colección}} es un componente de ODL que se define a nivel de [[Contenedores|contenedores]], tanto en definiciones de tipo, como en definiciones de sistema. Permiten almacenar objetos de igual o distinto tipo, y para cada definición de colección que exista se generará una tabla en la base de datos. Además, es posible definir varias colecciones en una misma definición de contenedor.</p>
 +
<p>Es un componente importante, ya que para poder crear objetos o acceder a ellos, es necesario que su definición esté incluída en al menos una colección. Al entrar en una colección, podremos acceder a los objetos almacenados, así como crear objetos del tipo o tipos que estén contenidos en la definición de colección.</p>
 +
<p>Siempre que definamos una colección en un contenedor, no podremos declararla como una definición de tipo, sino que tendremos que definirla como una instancia. Podremos declarar un tipo de colección, pero nunca en un contenedor. Esto nos serviría para declarar nuevas definiciones a partir de la colección de tipo.</p>
 +
<p>Como hemos dicho, la definición de una colección genera una tabla en la base de datos. Para su creación, será necesario indicar el nombre de la tabla. Esto lo hacemos utilizando el atributo {{AT|nombre_tabla}}, que acepta una ristra como valor. El nombre de la tabla tendrá que estar '''siempre''' precedido del prefijo '''TC$''':</p>
 +
 
 +
[Definición] {{PR|es}} {{RE|contenedor}}
 +
    [Contenido] {{PR|es}} {{T|coleccion}}    {{COM|//Declaración como instancia. Se creará la colección.}}
 +
        -{{AT|nombre_tabla}} = {{STR|"TC$NOMBRE"}};
 +
        ...
 +
        ...
 +
        ...
 +
    {{PR|fin}}
 +
{{PR|fin}}
 +
 
 +
{{PR|tipo}} [Definición] {{PR|es}} {{T|coleccion}}    {{COM|//Declaración como tipo, fuera de la definición de un contenedor. No se crea ninguna colección.}}
 +
    -{{AT|nombre_tabla}} = {{STR|"TC$NAME"}};    {{COM|//Se utilizará para definir otras colecciones.}}
 +
    ...
 +
    ...
 +
    ...
 +
{{PR|fin}}
 +
===Declaraciones de contenido===
 +
<p>A la hora de definir una colección, es necesario declarar el contenido que tendrá la colección. Es decir, se especificarán todas las definiciones de contenedor correspondientes a los tipos objetos que queramos almacenar en la colección.</p>
 +
<p>Para ello, utilizaremos la palabra reservada {{PR|contiene}}, de manera que incluiremos un <code>contiene</code> por cada definición de contenedor.</p>
 +
<p>Su sintaxis sería la siguiente:</p>
 +
 
 +
...
 +
{{PR|contiene}} [Definición de contenedor]
 +
...
 +
 
 +
===Declaraciones de columna===
 +
<p>Como hemos dicho, una colección genera una tabla en la base de datos del centro, pero también habrá que especificar las columnas que se crearán en ella.</p>
 +
<p>Con la palabra reservada {{PR|columna}} seguida de un nombre, detallaremos dichas columnas. El nombre especificado hará referencia al título de la columna a nivel de egExplorer, no de la base de datos. Para especificar el nombre de la columna en la base de datos utilizaremos el atributo {{AT|columna_bd.nombre}}. Ambos nombres no tienen por qué coincidir, el nombre de la columna en la tabla puede ser distinto al del listado en el egExplorer.</p>
 +
<p>Además, también es necesario indicar el campo que almacenará cada una de las columnas. El atributo {{AT|origen}} nos permite asignarle una expresión que especifique la definición de un campo, que tendrá que estar incluído en la definición de contenedor que contenga la colección.</p>
 +
 
 +
...
 +
{{PR|columna}} [Nombre de la columna]
 +
    -{{AT|columna_bd.nombre}} = {{STR|"NOMBRE"}};
 +
    -{{AT|origen}} = [Formulario].[Campo];
 +
...
 +
 
 +
<blockquote style="background: #ffffcc; border: 1px solid black; padding: 1em;">
 +
'''NOTA:''' En caso de que la colección contenga objetos de distinto tipo, los campos que se especifiquen en las columnas con el atributo {{AT|origen}} tendrán que estar definidos en los contenedores. Es decir, la ruta tendrá que ser exactamente igual en todas las definiciones de contenedor.
 +
</blockquote>
 +
 
 +
==Sintaxis y ejemplo==
 +
<p>Una vez sabemos los elementos necesarios que hay que incluir para una correcta definición de colección, veamos una sintaxis completa utilizando un ejemplo concreto.</p>
 +
<p>Partimos de una definición de tipo contenedor llamada '''Expediente'''. Por tanto, crearemos una colección que almacene objetos de ese tipo:</p>
 +
 
 +
{{PR|tipo}} [Expediente] {{PR|es}} {{RE|contenedor}}
 +
    [Datos generales] {{PR|es}} {{T|formulario}}
 +
        [Nº de expediente] {{PR|es}} {{T|timbre}}
 +
            -{{AT|certificado.valor}} = [&Valor_secuencia];
 +
            -{{AT|certificado.secuencia.nombre}} = {{STR|"STR$EXPEDIENTE"}};
 +
            -{{AT|certificado.secuencia.longitud}} = 5;
 +
        [Fecha de alta] {{PR|es}} {{T|fecha}}
 +
        [Tipo de solicitud] {{PR|es}} {{T|texto}}
 +
            -{{AT|edicion.seleccion}} = verdadero;
 +
            -{{AT|edicion.valores}} = $matriz({{STR|"Solicitud_1"}},{{STR|"Solicitud_2"}},{{STR|"Solicitud_3"}});
 +
            -{{AT|edicion.desplegable}} = verdadero;
 +
    {{PR|fin}}
 +
{{PR|fin}}
 +
 
 +
[Expedientes] {{PR|es}} {{RE|contenedor}}
 +
    [Contenido] {{PR|es}} {{T|coleccion}}
 +
        -{{AT|nombre_tabla}} = {{STR|"TC$EXPEDIENTES"}};<br/>
 +
        {{PR|contiene}} [Expediente]  {{COM|//Esta colección almacenará objetos de tipo Expediente}}<br/>
 +
        {{PR|columna}} [Número de expediente]
 +
            -{{AT|columna_bd.nombre}} = {{STR|"NUMERO_EXPEDIENTE"}};
 +
            -{{AT|origen}} = [Datos generales].[Nº expediente];<br/>
 +
        {{PR|columna}} [Fecha de creación]
 +
            -{{AT|columna_bd.nombre}} = {{STR|"FECHA"}};
 +
            -{{AT|origen}} = [Datos generales].[Fecha de alta];<br/>
 +
        {{PR|columna}} [Tipo de solicitud]
 +
            -{{AT|columna_bd.nombre}} = {{STR|"TIPO_SOLICITUD"}};
 +
            -{{AT|origen}} = [Datos generales].[Tipo de solicitud];
 +
    {{PR|fin}}
 +
{{PR|fin}}
 +
 
 +
<p>Para poder acceder a la colección, será necesario ubicar la instancia de contenedor donde está incluída la colección en una habitación:</p>
 +
 
 +
[Oficina] {{PR|es}} {{RE|habitacion}}
 +
    {{PR|ubicado}} [Expedientes]
 +
        -{{AT|lugar}} = {{STR|"Estantes"}};
 +
{{PR|fin}}
 +
 
 +
<p>Veamos el resultado en la aplicación de administración egExplorer:</p>
 +
 
 +
<center>
 +
{|
 +
|align="center" |[[Imagen:colecciones01.jpg|border|250px]]
 +
|}
 +
</center>
 +
 
 +
<p>Para acceder a la colección es necesario acceder a la instancia <code>'''Expedientes'''</code>. Al acceder, se nos abrirá directamente la colección. Vemos en la parte superior, que aparece la pestaña <code>'''Contenido'''</code> haciendo referencia a nuestra colección. En caso de haber definido más colecciones en Expedientes, aparecería una pestaña por cada una de ellas.</p>
 +
<p>Vemos también que los nombres de las columnas se corresponden con los declarados en el código. Además en la parte superior derecha, aparece un botón llamado '''Nuevo contenedor''' que al picar en él, nos permitirá crear un objeto de aquellas definiciones de contenedor que estén incluídas en la colección. En este caso, sólo podríamos crear un objeto de tipo Expediente.</p>
 +
 
 +
==Atributos==
 +
<p>A lo largo del artículo, hemos ido conociendo algunos de los atributos que intervienen en la definición de una colección, sobre todo, aquellos que son estrictamente necesarios.</p>
 +
<p>No obstante, existen algunos atributos más, tanto para la definición de colección, como para las declaraciones de contenido y columnas. Veámos cuáles son:</p>
 +
 
 +
===Atributos genéricos de la definición de un componente===
 +
 
 +
<br/>
 +
<center>
 +
{| border="2" cellpadding="4" cellspacing="0" style=" border: 1px #aaa solid; border-collapse: collapse; " .
 +
|-
 +
! style="width:170px; {{color tabla}} color:white" |'''Atributo'''
 +
! style="width:100px; {{color tabla}} color:white" |'''Tipo'''
 +
! style="width:140px; {{color tabla}} color:white" |'''Valor por defecto'''
 +
! style="width:550px; {{color tabla}} color:white" |'''Observaciones'''
 +
|-
 +
| align="center" |{{AT|ayuda}}
 +
| align="center" |Texto
 +
|
 +
| Marcador en la ayuda del centro.
 +
|-
 +
| align="center" |{{AT|descripcion}}
 +
| align="center" |Texto
 +
| align="center" |[Nombre]
 +
| Comentario sobre el componente.
 +
|-
 +
| align="center" |{{AT|etiqueta}}
 +
| align="center" |Texto
 +
| align="center" |[Nombre]
 +
| Etiqueta del componente.
 +
|-
 +
| align="center" |{{AT|orden}}
 +
| align="center" |Entero
 +
| align="center" |0
 +
| Indica la prioridad del componente al ordenarlo sobre el recurso.
 +
|-
 +
| align="center" |{{AT|visible}}
 +
| align="center" |Lógico
 +
| align="center" |Verdadero
 +
| Indica si el componente es visible.
 +
|}
 +
</center>
 +
<br/>
 +
 
 +
===Atributos de la definición de colección===
 +
 
 +
<br/>
 +
<center>
 +
{| border="2" cellpadding="4" cellspacing="0" style=" border: 1px #aaa solid; border-collapse: collapse; " .
 +
|-
 +
! style="width:170px; {{color tabla}} color:white" |'''Atributo'''
 +
! style="width:100px; {{color tabla}} color:white" |'''Tipo'''
 +
! style="width:140px; {{color tabla}} color:white" |'''Valor por defecto'''
 +
! style="width:550px; {{color tabla}} color:white" |'''Observaciones'''
 +
|-
 +
| align="center" |{{AT|nombre_tabla}}
 +
| align="center" |Texto
 +
|
 +
| Nombre de la tabla que se creará para la colección en la base de datos. Deberá incluir el prefijo '''TC$'''.
 +
|}
 +
</center>
 +
<br/>
 +
 
 +
===Atributos de la declaración de contenido===
 +
 
 +
<br/>
 +
<center>
 +
{| border="2" cellpadding="4" cellspacing="0" style=" border: 1px #aaa solid; border-collapse: collapse; " .
 +
|-
 +
! style="width:170px; {{color tabla}} color:white" |'''Atributo'''
 +
! style="width:100px; {{color tabla}} color:white" |'''Tipo'''
 +
! style="width:140px; {{color tabla}} color:white" |'''Valor por defecto'''
 +
! style="width:550px; {{color tabla}} color:white" |'''Observaciones'''
 +
|-
 +
| align="center" |{{AT|minimo}}
 +
| align="center" |Entero
 +
| align="center" |0
 +
| Número mínimo de objetos que se podrán crear en la colección. En caso de borrar objetos de la colección, siempre tendrán que existir al menos el número mínimo indicado.
 +
|-
 +
| align="center" |{{AT|maximo}}
 +
| align="center" |Entero
 +
| align="center" |Sin límite
 +
| Número máximo de objetos que se podrán almacenar en la colección.
 +
|}
 +
</center>
 +
<br/>
 +
 
 +
===Atributos de la declaración de columna===
 +
 
 +
<br/>
 +
<center>
 +
{| border="2" cellpadding="4" cellspacing="0" style=" border: 1px #aaa solid; border-collapse: collapse; " .
 +
|-
 +
! style="width:170px; {{color tabla}} color:white" |'''Atributo'''
 +
! style="width:100px; {{color tabla}} color:white" |'''Tipo'''
 +
! style="width:140px; {{color tabla}} color:white" |'''Valor por defecto'''
 +
! style="width:550px; {{color tabla}} color:white" |'''Observaciones'''
 +
|-
 +
| align="center" |{{AT|columna_bd.nombre}}
 +
| align="center" |Texto
 +
|
 +
| Nombre de la columna en la base de datos.
 +
|-
 +
| align="center" |{{AT|columna_bd.tipo}}
 +
| align="center" |Texto
 +
|
 +
| En caso de tener una expresión en el atributo origen, se especificará el tipo de la columna. Necesario para los campos código y vínculo.
 +
|-
 +
| align="center" |{{AT|columna_bd.longitud}}
 +
| align="center" |Entero
 +
| align="center" |50
 +
| En caso de tener una expresión en el atributo origen, se especificará la longitud del valor obtenido por la expresión. Por ejemplo, una cadena de caracteres.
 +
|-
 +
| align="center" |{{AT|columna_bd.precision}}
 +
| align="center" |Entero
 +
| align="center" |4
 +
| En caso de obtener un valor de tipo moneda o real en la expresión del atributo origen, limitará la parte decimal a la precisión indicada.
 +
|-
 +
| align="center" |{{AT|origen}}
 +
| align="center" |Expresión
 +
|
 +
| Expresión cuyo resultado almacenará en la columna.
 +
|-
 +
| align="center" |{{AT|visible}}
 +
| align="center" |Lógico
 +
| align="center" |Verdadero
 +
| Indica si la columna es visible.
 +
|}
 +
</center>
 +
<br/>
 +
 
 +
==Aumentando la complejidad==
 +
<p>Siguiendo con el ejemplo del [[#Sintaxis y ejemplo|apartado 2]] de este artículo, vamos a aumentar un poco la complejidad del mismo, para abordar algún caso más en el uso de las colecciones que pueden ser de utilidad a la hora de desarrollar nuestro sistema de información.</p>
 +
<p>En el ejemplo, simplemente definimos una colección '''Expedientes''' en la que se almacenan los objetos de tipo '''Expediente''', pero, imaginemos ahora, que por cada Expediente que se crea pueden existir varias entradas y salidas de información. Como ya sabemos, es necesario crear alguna colección donde almacenar dichas '''Entradas''' y '''Salidas''', pero, en este caso, no crearemos una colección para todas las Entradas y otra para las Salidas, sino que definiremos una colección en la definición de tipo Expediente. Esto provocará que cada vez que se cree un objeto de tipo Expediente, se incluirá en él una colección que almacenará sólamente las Entradas y Salidas que se creen desde esa colección. Por tanto, al acceder a un objeto de tipo Expediente, existirá una colección en la cual podremos ver el listado de las Entradas y Salidas asociadas a ese Expediente.</p>
 +
<p>Veamos la definición de '''Entrada''' y '''Salida''', además de la inclusión de la definición de colección en la definición de '''Expediente''':</p>
 +
 
 +
{{PR|tipo}} [Entrada] {{PR|es}} {{RE|contenedor}}
 +
    [Datos generales] {{PR|es}} {{T|formulario}}
 +
        [Número] {{PR|es}} {{T|timbre}}
 +
            -{{AT|certificado.subsecuencia.valor}} = $Copiartexto($texto($Año($Hoy)), 3, 2);
 +
            -{{AT|certificado.valor}} = [&Valor_subsecuencia] + {{STR|"/"}} + [&Valor_secuencia];
 +
            -{{AT|certificado.secuencia.nombre}} = {{STR|"STR$ENTRADA"}};
 +
            -{{AT|certificado.secuencia.longitud}} = 4;
 +
        [Fecha] {{PR|es}} {{T|fecha}}
 +
            -{{AT|edicion.modo}} = copia;
 +
            -{{AT|edicion.valor}} = [Número].[&Fecha];
 +
        [Remitente] {{PR|es}} {{T|texto}}
 +
        [Destinatario] {{PR|es}} {{T|texto}}
 +
    {{PR|fin}}
 +
{{PR|fin}}
 +
 
 +
{{PR|tipo}} [Salida] {{PR|es}} {{RE|contenedor}}
 +
    [Datos generales] {{PR|es}} {{T|formulario}}
 +
        [Número] {{PR|es}} {{T|timbre}}
 +
            -{{AT|certificado.subsecuencia.valor}} = $Copiartexto($texto($Año($Hoy)), 3, 2);
 +
            -{{AT|certificado.valor}} = [&Valor_subsecuencia] + {{STR|"/"}} + [&Valor_secuencia];
 +
            -{{AT|certificado.secuencia.nombre}} = {{STR|"STR$SALIDA"}};
 +
            -{{AT|certificado.secuencia.longitud}} = 4;
 +
        [Fecha] {{PR|es}} {{T|fecha}}
 +
            -{{AT|edicion.modo}} = copia;
 +
            -{{AT|edicion.valor}} = [Número].[&Fecha];
 +
        [Remitente] {{PR|es}} {{T|texto}}
 +
        [Destinatario] {{PR|es}} {{T|texto}}
 +
    {{PR|fin}}
 +
{{PR|fin}}
 +
 
 +
{{PR|tipo}} [Expediente] {{PR|es}} {{RE|contenedor}}
 +
    [Datos generales] {{PR|es}} {{T|formulario}}
 +
        [Nº de expediente] {{PR|es}} {{T|timbre}}
 +
            -{{AT|certificado.valor}} = [&Valor_secuencia];
 +
            -{{AT|certificado.secuencia.nombre}} = {{STR|"STR$EXPEDIENTE"}};
 +
            -{{AT|certificado.secuencia.longitud}} = 5;
 +
        [Fecha de alta] {{PR|es}} {{T|fecha}}
 +
        [Tipo de solicitud] {{PR|es}} {{T|texto}}
 +
            -{{AT|edicion.seleccion}} = verdadero;
 +
            -{{AT|edicion.valores}} = $matriz({{STR|"Solicitud_1"}},{{STR|"Solicitud_2"}},{{STR|"Solicitud_3"}});
 +
            -{{AT|edicion.desplegable}} = verdadero;
 +
    {{PR|fin}}<br/>
 +
    [Contenido] {{PR|es}} {{T|coleccion}}
 +
        -{{AT|nombre_tabla}} = {{STR|"TC$DOCUMENTOS"}}<br/>
 +
        {{PR|contiene}} [Entrada]<br/>
 +
        {{PR|contiene}} [Salida]<br/>
 +
        {{PR|columna}} [Nombre]
 +
            -{{AT|columna_bd.nombre}} = {{STR|"NOMBRE"}};
 +
            -{{AT|origen}} = [&Nombre];    {{COM|//Propiedad [&Nombre] de la definición de contenedor}}<br/>
 +
        {{PR|columna}} [Fecha]
 +
            -{{AT|columna_bd.nombre}} = {{STR|"FECHA"}};
 +
            -{{AT|origen}} = [Datos generales].[Fecha];<br/>
 +
    {{PR|fin}}
 +
{{PR|fin}}
 +
 
 +
*Primero creamos un objeto de tipo '''Expediente''' y accedemos a él desde la colección '''Expedientes'''. Vemos que aparece una etiqueta llamada '''Contenido''' para acceder a la colección del objeto.
 +
 
 +
<center>
 +
{|
 +
|align="center" |[[Imagen:colecciones02.jpg|border|250px]]
 +
|}
 +
</center>
 +
 
 +
*Una vez en la colección del objeto, vemos que picando en el botón "Nuevo contenedor" podremos crear objetos de tipo '''Entrada''' y '''Salida'''...
 +
 
 +
<center>
 +
{|
 +
|align="center" |[[Imagen:colecciones03.jpg|border|250px]]
 +
|}
 +
</center>
 +
 
 +
*...Y que una vez generados, podremos visualizar en la colección del propio objeto.
 +
 
 +
<center>
 +
{|
 +
|align="center" |[[Imagen:colecciones04.jpg|border|250px]]
 +
|}
 +
</center>
 +
 
 +
[[Categoría:ODL]]
 +
[[Categoría:Definiciones]]
 +
[[Categoría:Componentes]]

Revisión actual del 13:00 16 jun 2009

¿Qué es una colección?

Una colección es un componente de ODL que se define a nivel de contenedores, tanto en definiciones de tipo, como en definiciones de sistema. Permiten almacenar objetos de igual o distinto tipo, y para cada definición de colección que exista se generará una tabla en la base de datos. Además, es posible definir varias colecciones en una misma definición de contenedor.

Es un componente importante, ya que para poder crear objetos o acceder a ellos, es necesario que su definición esté incluída en al menos una colección. Al entrar en una colección, podremos acceder a los objetos almacenados, así como crear objetos del tipo o tipos que estén contenidos en la definición de colección.

Siempre que definamos una colección en un contenedor, no podremos declararla como una definición de tipo, sino que tendremos que definirla como una instancia. Podremos declarar un tipo de colección, pero nunca en un contenedor. Esto nos serviría para declarar nuevas definiciones a partir de la colección de tipo.

Como hemos dicho, la definición de una colección genera una tabla en la base de datos. Para su creación, será necesario indicar el nombre de la tabla. Esto lo hacemos utilizando el atributo nombre_tabla, que acepta una ristra como valor. El nombre de la tabla tendrá que estar siempre precedido del prefijo TC$:

[Definición] es contenedor
    [Contenido] es coleccion     //Declaración como instancia. Se creará la colección.
        -nombre_tabla = "TC$NOMBRE";
        ...
        ...
        ...
    fin
fin

tipo [Definición] es coleccion     //Declaración como tipo, fuera de la definición de un contenedor. No se crea ninguna colección.
    -nombre_tabla = "TC$NAME";     //Se utilizará para definir otras colecciones.
    ...
    ...
    ...
fin

Declaraciones de contenido

A la hora de definir una colección, es necesario declarar el contenido que tendrá la colección. Es decir, se especificarán todas las definiciones de contenedor correspondientes a los tipos objetos que queramos almacenar en la colección.

Para ello, utilizaremos la palabra reservada contiene, de manera que incluiremos un contiene por cada definición de contenedor.

Su sintaxis sería la siguiente:

...
contiene [Definición de contenedor]
...

Declaraciones de columna

Como hemos dicho, una colección genera una tabla en la base de datos del centro, pero también habrá que especificar las columnas que se crearán en ella.

Con la palabra reservada columna seguida de un nombre, detallaremos dichas columnas. El nombre especificado hará referencia al título de la columna a nivel de egExplorer, no de la base de datos. Para especificar el nombre de la columna en la base de datos utilizaremos el atributo columna_bd.nombre. Ambos nombres no tienen por qué coincidir, el nombre de la columna en la tabla puede ser distinto al del listado en el egExplorer.

Además, también es necesario indicar el campo que almacenará cada una de las columnas. El atributo origen nos permite asignarle una expresión que especifique la definición de un campo, que tendrá que estar incluído en la definición de contenedor que contenga la colección.

...
columna [Nombre de la columna]
    -columna_bd.nombre = "NOMBRE";
    -origen = [Formulario].[Campo];
...

NOTA: En caso de que la colección contenga objetos de distinto tipo, los campos que se especifiquen en las columnas con el atributo origen tendrán que estar definidos en los contenedores. Es decir, la ruta tendrá que ser exactamente igual en todas las definiciones de contenedor.

Sintaxis y ejemplo

Una vez sabemos los elementos necesarios que hay que incluir para una correcta definición de colección, veamos una sintaxis completa utilizando un ejemplo concreto.

Partimos de una definición de tipo contenedor llamada Expediente. Por tanto, crearemos una colección que almacene objetos de ese tipo:

tipo [Expediente] es contenedor
    [Datos generales] es formulario
        [Nº de expediente] es timbre
            -certificado.valor = [&Valor_secuencia];
            -certificado.secuencia.nombre = "STR$EXPEDIENTE"; 
            -certificado.secuencia.longitud = 5; 
        [Fecha de alta] es fecha
        [Tipo de solicitud] es texto
            -edicion.seleccion = verdadero;
            -edicion.valores = $matriz("Solicitud_1","Solicitud_2","Solicitud_3");
            -edicion.desplegable = verdadero;
   fin
fin

[Expedientes] es contenedor
    [Contenido] es coleccion
        -nombre_tabla = "TC$EXPEDIENTES";

        contiene [Expediente]   //Esta colección almacenará objetos de tipo Expediente

        columna [Número de expediente]
            -columna_bd.nombre = "NUMERO_EXPEDIENTE";
            -origen = [Datos generales].[Nº expediente];

        columna [Fecha de creación]
            -columna_bd.nombre = "FECHA";
            -origen = [Datos generales].[Fecha de alta];

        columna [Tipo de solicitud]
            -columna_bd.nombre = "TIPO_SOLICITUD";
            -origen = [Datos generales].[Tipo de solicitud];
    fin
fin

Para poder acceder a la colección, será necesario ubicar la instancia de contenedor donde está incluída la colección en una habitación:

[Oficina] es habitacion
    ubicado [Expedientes] 
        -lugar = "Estantes";
fin

Veamos el resultado en la aplicación de administración egExplorer:

Colecciones01.jpg

Para acceder a la colección es necesario acceder a la instancia Expedientes. Al acceder, se nos abrirá directamente la colección. Vemos en la parte superior, que aparece la pestaña Contenido haciendo referencia a nuestra colección. En caso de haber definido más colecciones en Expedientes, aparecería una pestaña por cada una de ellas.

Vemos también que los nombres de las columnas se corresponden con los declarados en el código. Además en la parte superior derecha, aparece un botón llamado Nuevo contenedor que al picar en él, nos permitirá crear un objeto de aquellas definiciones de contenedor que estén incluídas en la colección. En este caso, sólo podríamos crear un objeto de tipo Expediente.

Atributos

A lo largo del artículo, hemos ido conociendo algunos de los atributos que intervienen en la definición de una colección, sobre todo, aquellos que son estrictamente necesarios.

No obstante, existen algunos atributos más, tanto para la definición de colección, como para las declaraciones de contenido y columnas. Veámos cuáles son:

Atributos genéricos de la definición de un componente


Atributo Tipo Valor por defecto Observaciones
ayuda Texto Marcador en la ayuda del centro.
descripcion Texto [Nombre] Comentario sobre el componente.
etiqueta Texto [Nombre] Etiqueta del componente.
orden Entero 0 Indica la prioridad del componente al ordenarlo sobre el recurso.
visible Lógico Verdadero Indica si el componente es visible.


Atributos de la definición de colección


Atributo Tipo Valor por defecto Observaciones
nombre_tabla Texto Nombre de la tabla que se creará para la colección en la base de datos. Deberá incluir el prefijo TC$.


Atributos de la declaración de contenido


Atributo Tipo Valor por defecto Observaciones
minimo Entero 0 Número mínimo de objetos que se podrán crear en la colección. En caso de borrar objetos de la colección, siempre tendrán que existir al menos el número mínimo indicado.
maximo Entero Sin límite Número máximo de objetos que se podrán almacenar en la colección.


Atributos de la declaración de columna


Atributo Tipo Valor por defecto Observaciones
columna_bd.nombre Texto Nombre de la columna en la base de datos.
columna_bd.tipo Texto En caso de tener una expresión en el atributo origen, se especificará el tipo de la columna. Necesario para los campos código y vínculo.
columna_bd.longitud Entero 50 En caso de tener una expresión en el atributo origen, se especificará la longitud del valor obtenido por la expresión. Por ejemplo, una cadena de caracteres.
columna_bd.precision Entero 4 En caso de obtener un valor de tipo moneda o real en la expresión del atributo origen, limitará la parte decimal a la precisión indicada.
origen Expresión Expresión cuyo resultado almacenará en la columna.
visible Lógico Verdadero Indica si la columna es visible.


Aumentando la complejidad

Siguiendo con el ejemplo del apartado 2 de este artículo, vamos a aumentar un poco la complejidad del mismo, para abordar algún caso más en el uso de las colecciones que pueden ser de utilidad a la hora de desarrollar nuestro sistema de información.

En el ejemplo, simplemente definimos una colección Expedientes en la que se almacenan los objetos de tipo Expediente, pero, imaginemos ahora, que por cada Expediente que se crea pueden existir varias entradas y salidas de información. Como ya sabemos, es necesario crear alguna colección donde almacenar dichas Entradas y Salidas, pero, en este caso, no crearemos una colección para todas las Entradas y otra para las Salidas, sino que definiremos una colección en la definición de tipo Expediente. Esto provocará que cada vez que se cree un objeto de tipo Expediente, se incluirá en él una colección que almacenará sólamente las Entradas y Salidas que se creen desde esa colección. Por tanto, al acceder a un objeto de tipo Expediente, existirá una colección en la cual podremos ver el listado de las Entradas y Salidas asociadas a ese Expediente.

Veamos la definición de Entrada y Salida, además de la inclusión de la definición de colección en la definición de Expediente:

tipo [Entrada] es contenedor
    [Datos generales] es formulario
        [Número] es timbre
            -certificado.subsecuencia.valor = $Copiartexto($texto($Año($Hoy)), 3, 2);
            -certificado.valor = [&Valor_subsecuencia] + "/" + [&Valor_secuencia];
            -certificado.secuencia.nombre = "STR$ENTRADA";
            -certificado.secuencia.longitud = 4;
        [Fecha] es fecha
            -edicion.modo = copia;
            -edicion.valor = [Número].[&Fecha];
        [Remitente] es texto
        [Destinatario] es texto
    fin
fin

tipo [Salida] es contenedor
    [Datos generales] es formulario
        [Número] es timbre
            -certificado.subsecuencia.valor = $Copiartexto($texto($Año($Hoy)), 3, 2);
            -certificado.valor = [&Valor_subsecuencia] + "/" + [&Valor_secuencia];
            -certificado.secuencia.nombre = "STR$SALIDA";
            -certificado.secuencia.longitud = 4;
        [Fecha] es fecha
            -edicion.modo = copia;
            -edicion.valor = [Número].[&Fecha];
        [Remitente] es texto
        [Destinatario] es texto
    fin
fin

tipo [Expediente] es contenedor
    [Datos generales] es formulario
        [Nº de expediente] es timbre
            -certificado.valor = [&Valor_secuencia];
            -certificado.secuencia.nombre = "STR$EXPEDIENTE"; 
            -certificado.secuencia.longitud = 5; 
        [Fecha de alta] es fecha
        [Tipo de solicitud] es texto
            -edicion.seleccion = verdadero;
            -edicion.valores = $matriz("Solicitud_1","Solicitud_2","Solicitud_3");
            -edicion.desplegable = verdadero;
   fin

   [Contenido] es coleccion
       -nombre_tabla = "TC$DOCUMENTOS"

       contiene [Entrada]

       contiene [Salida]

       columna [Nombre]
           -columna_bd.nombre = "NOMBRE";
           -origen = [&Nombre];    //Propiedad [&Nombre] de la definición de contenedor

       columna [Fecha]
           -columna_bd.nombre = "FECHA";
           -origen = [Datos generales].[Fecha];

    fin
fin
  • Primero creamos un objeto de tipo Expediente y accedemos a él desde la colección Expedientes. Vemos que aparece una etiqueta llamada Contenido para acceder a la colección del objeto.
Colecciones02.jpg
  • Una vez en la colección del objeto, vemos que picando en el botón "Nuevo contenedor" podremos crear objetos de tipo Entrada y Salida...
Colecciones03.jpg
  • ...Y que una vez generados, podremos visualizar en la colección del propio objeto.
Colecciones04.jpg
Obtenido de «https://wiki.egeasy.es/index.php?title=Colecciones&oldid=5248»