Egeasy - Contribuciones del usuario [es]

Tratamiento de moneda

2012-02-13T16:21:41Z

Jrodriguez: /* <code>$EurosEnLetras</code> */

__NOTOC__
===<code>$Moneda</code>===
<blockquote style="border: 2px solid #993365; background: #FFFFFF; margin:1em 1ex 1ex 1ex; padding: 1em; text-align:left">
<code>'''$Moneda'''(E: expresión, Moneda: texto={{STR|"euro"}}): {{T|moneda}}</code>
</blockquote>

:*'''Descripción'''Convierte una expresión numérica en un tipo moneda, pudiendo indicar la moneda, que por defecto será en euros. No realiza cálculo de conversión de moneda.

:*'''Ejemplos'''

<blockquote style="border: 1px dashed #2F6FAB; background: #FFFFFF; margin:1em 15ex 5ex 15ex; padding: 1em; text-align:left;">
<code style="background: #FFFFFF">$Moneda({{STR|"1200"}},{{STR|"peseta"}}) {{COM|// devuelve 1.200ptas}}</code>
</blockquote>

<blockquote style="border: 1px dashed #2F6FAB; background: #FFFFFF; margin:1em 15ex 5ex 15ex; padding: 1em; text-align:left;">
<code style="background: #FFFFFF">$Moneda({{STR|"680,20"}}) {{COM|//devuelve 680,20€}}</code>
</blockquote>

<blockquote style="border: 1px dashed #2F6FAB; background: #FFFFFF; margin:1em 15ex 5ex 15ex; padding: 1em; text-align:left;">
<code style="background: #FFFFFF">$Moneda([&Dominio]->[Datos generales].[Importe])</code>
</blockquote>

===<code>$Cifra</code>===
<blockquote style="border: 2px solid #993365; background: #FFFFFF; margin:1em 1ex 1ex 1ex; padding: 1em; text-align:left">
<code>'''$Cifra'''(E: expresión): {{T|texto}}</code>
</blockquote>

:*'''Descripción'''Convierte la cifra pasada como parámetro de entrada a formato texto especificado en euros y centimos. El parámetro de entrada debe ser una expresión que devuelva un campo de tipo moneda, entero o real.

:*'''Ejemplos'''

<blockquote style="border: 1px dashed #2F6FAB; background: #FFFFFF; margin:1em 15ex 5ex 15ex; padding: 1em; text-align:left;">
<code style="background: #FFFFFF">$Cifra($Real({{STR|"3,4"}})) {{COM|//devuelve}} {{STR|tres euros con cuarenta céntimos}}</code>
</blockquote>

<blockquote style="border: 1px dashed #2F6FAB; background: #FFFFFF; margin:1em 15ex 5ex 15ex; padding: 1em; text-align:left;">
<code style="background: #FFFFFF">$Cifra($Moneda({{STR|"30,40"}})) {{COM|//devuelve}} {{STR|treinta euros con cuarenta céntimos}}</code>
</blockquote>

===<code>$EurosEnLetras</code>===
<blockquote style="border: 2px solid #993365; background: #FFFFFF; margin:1em 1ex 1ex 1ex; padding: 1em; text-align:left">
<code>'''$EurosEnLetras'''(E: expresión): {{T|texto}}</code>
</blockquote>

:*'''Descripción'''Convierte la cifra pasada como parámetro de entrada a formato texto especificado en euros y centimos. El parámetro de entrada debe ser una expresión que devuelva un campo de tipo moneda, entero o real.

:*'''Ejemplos'''

<blockquote style="border: 1px dashed #2F6FAB; background: #FFFFFF; margin:1em 15ex 5ex 15ex; padding: 1em; text-align:left;">
<code style="background: #FFFFFF">$EurosEnLetras($Real({{STR|"3,4"}})) {{COM|//devuelve}} {{STR|tres euros con cuarenta céntimos}}</code>
</blockquote>

<blockquote style="border: 1px dashed #2F6FAB; background: #FFFFFF; margin:1em 15ex 5ex 15ex; padding: 1em; text-align:left;">
<code style="background: #FFFFFF">$EurosEnLetras($Moneda({{STR|"30,40"}})) {{COM|//devuelve}} {{STR|treinta euros con cuarenta céntimos}}</code>
</blockquote>

===<code>$NumeroEnLetras</code>===
<blockquote style="border: 2px solid #993365; background: #FFFFFF; margin:1em 1ex 1ex 1ex; padding: 1em; text-align:left">
<code>'''$NumeroEnLetras'''(Número: {{T|real}}, Género: {{T|entero}}, Unidad_Entera: {{T|texto}}, Decimales: {{T|entero}}, Unidad_Decimal: {{T|texto}}): {{T|texto}}</code>
</blockquote>

:*'''Descripción'''Convierte el valor pasado como parámetro de entrada Número a formato texto. Además de éste, se deben especificar los siguientes parámetros de entrada:<ul type=disk><li>Género: indica el género del valor devuelto. Femenino tiene el valor 0 y masculino tiene el valor 1.</li><li>Unidad_Entera: indica la unidad del entero. Se utiliza el formato "unidad_en_singular/unidad_en_plural".</li><li>Decimales: indica el número de decimales que se precisa.</li><li>Unidad_Decimal: indica la unidad de los decimales. Se utiliza el formato "unidad_en_singular/unidad_en_plural".</li></ul>

:*'''Ejemplos'''

<blockquote style="border: 1px dashed #2F6FAB; background: #FFFFFF; margin:1em 15ex 5ex 15ex; padding: 1em; text-align:left;">
<code style="background: #FFFFFF">$NumeroEnLetras($Entero({{STR|"223"}}),0,{{STR|"caja/cajas"}},0,{{STR|""}}) {{COM|//devuelve}} {{STR|Doscientas veintitrés cajas}}</code>
</blockquote>

<blockquote style="border: 1px dashed #2F6FAB; background: #FFFFFF; margin:1em 15ex 5ex 15ex; padding: 1em; text-align:left;">
<code style="background: #FFFFFF">$NumeroEnLetras($Real({{STR|"300,05"}}),1,{{STR|"kilómetro/kilómetros"}},3,{{STR|"metro/metros"}}) {{COM|//devuelve}} {{STR|Trescientos kilómetros con cincuenta metros}}</code>
</blockquote>

<blockquote style="border: 1px dashed #2F6FAB; background: #FFFFFF; margin:1em 15ex 5ex 15ex; padding: 1em; text-align:left;">
<code style="background: #FFFFFF">$NumeroEnLetras($Entero({{STR|"1"}}),1,{{STR|"mes/meses"}},0,{{STR|""}}) {{COM|//devuelve}} {{STR|un mes}}</code>
</blockquote>

<blockquote style="border: 1px dashed #2F6FAB; background: #FFFFFF; margin:1em 15ex 5ex 15ex; padding: 1em; text-align:left;">
<code style="background: #FFFFFF">$NumeroEnLetras([Importe],1,{{STR|"euro/euros"}},2,{{STR|"céntimo/céntimos"}}) {{COM|//devuelve el mismo resultado que la función $eurosEnLetras.}}</code>
</blockquote>

<blockquote style="border: 1px dashed #2F6FAB; background: #FFFFFF; margin:1em 15ex 5ex 15ex; padding: 1em; text-align:left;">
<code style="background: #FFFFFF">$NumeroEnLetras($Entero({{STR|"23"}}),1,{{STR|""}},0,{{STR|""}}) {{COM|//devuelve}} {{STR|veintitrés}}</code>
</blockquote>

[[Categoría:ODL]]
[[Categoría:Funciones]]

Tratamiento de moneda

2012-02-13T16:04:42Z

Jrodriguez:

__NOTOC__
===<code>$Moneda</code>===
<blockquote style="border: 2px solid #993365; background: #FFFFFF; margin:1em 1ex 1ex 1ex; padding: 1em; text-align:left">
<code>'''$Moneda'''(E: expresión, Moneda: texto={{STR|"euro"}}): {{T|moneda}}</code>
</blockquote>

:*'''Descripción'''Convierte una expresión numérica en un tipo moneda, pudiendo indicar la moneda, que por defecto será en euros. No realiza cálculo de conversión de moneda.

:*'''Ejemplos'''

<blockquote style="border: 1px dashed #2F6FAB; background: #FFFFFF; margin:1em 15ex 5ex 15ex; padding: 1em; text-align:left;">
<code style="background: #FFFFFF">$Moneda({{STR|"1200"}},{{STR|"peseta"}}) {{COM|// devuelve 1.200ptas}}</code>
</blockquote>

<blockquote style="border: 1px dashed #2F6FAB; background: #FFFFFF; margin:1em 15ex 5ex 15ex; padding: 1em; text-align:left;">
<code style="background: #FFFFFF">$Moneda({{STR|"680,20"}}) {{COM|//devuelve 680,20€}}</code>
</blockquote>

<blockquote style="border: 1px dashed #2F6FAB; background: #FFFFFF; margin:1em 15ex 5ex 15ex; padding: 1em; text-align:left;">
<code style="background: #FFFFFF">$Moneda([&Dominio]->[Datos generales].[Importe])</code>
</blockquote>

===<code>$Cifra</code>===
<blockquote style="border: 2px solid #993365; background: #FFFFFF; margin:1em 1ex 1ex 1ex; padding: 1em; text-align:left">
<code>'''$Cifra'''(E: expresión): {{T|texto}}</code>
</blockquote>

:*'''Descripción'''Convierte la cifra pasada como parámetro de entrada a formato texto especificado en euros y centimos. El parámetro de entrada debe ser una expresión que devuelva un campo de tipo moneda, entero o real.

:*'''Ejemplos'''

<blockquote style="border: 1px dashed #2F6FAB; background: #FFFFFF; margin:1em 15ex 5ex 15ex; padding: 1em; text-align:left;">
<code style="background: #FFFFFF">$Cifra($Real({{STR|"3,4"}})) {{COM|//devuelve}} {{STR|tres euros con cuarenta céntimos}}</code>
</blockquote>

<blockquote style="border: 1px dashed #2F6FAB; background: #FFFFFF; margin:1em 15ex 5ex 15ex; padding: 1em; text-align:left;">
<code style="background: #FFFFFF">$Cifra($Moneda({{STR|"30,40"}})) {{COM|//devuelve}} {{STR|treinta euros con cuarenta céntimos}}</code>
</blockquote>

===<code>$EurosEnLetras</code>===
<blockquote style="border: 2px solid #993365; background: #FFFFFF; margin:1em 1ex 1ex 1ex; padding: 1em; text-align:left">
<code>'''$EurosEnLetras'''(E: expresión): {{T|texto}}</code>
</blockquote>

:*'''Descripción'''Convierte la cifra pasada como parámetro de entrada a formato texto especificado en euros y centimos. El parámetro de entrada debe ser una expresión que devuelva un campo de tipo moneda, entero o real.

:*'''Ejemplos'''

<blockquote style="border: 1px dashed #2F6FAB; background: #FFFFFF; margin:1em 15ex 5ex 15ex; padding: 1em; text-align:left;">
<code style="background: #FFFFFF">$EurosEnLetras($Real({{STR|"3,4"}})) {{COM|//devuelve}} {{STR|tres euros con cuarenta céntimos}}</code>
</blockquote>

<blockquote style="border: 1px dashed #2F6FAB; background: #FFFFFF; margin:1em 15ex 5ex 15ex; padding: 1em; text-align:left;">
<code style="background: #FFFFFF">$Cifra($Moneda({{STR|"30,40"}})) {{COM|//devuelve}} {{STR|treinta euros con cuarenta céntimos}}</code>
</blockquote>

===<code>$NumeroEnLetras</code>===
<blockquote style="border: 2px solid #993365; background: #FFFFFF; margin:1em 1ex 1ex 1ex; padding: 1em; text-align:left">
<code>'''$NumeroEnLetras'''(Número: {{T|real}}, Género: {{T|entero}}, Unidad_Entera: {{T|texto}}, Decimales: {{T|entero}}, Unidad_Decimal: {{T|texto}}): {{T|texto}}</code>
</blockquote>

:*'''Descripción'''Convierte el valor pasado como parámetro de entrada Número a formato texto. Además de éste, se deben especificar los siguientes parámetros de entrada:<ul type=disk><li>Género: indica el género del valor devuelto. Femenino tiene el valor 0 y masculino tiene el valor 1.</li><li>Unidad_Entera: indica la unidad del entero. Se utiliza el formato "unidad_en_singular/unidad_en_plural".</li><li>Decimales: indica el número de decimales que se precisa.</li><li>Unidad_Decimal: indica la unidad de los decimales. Se utiliza el formato "unidad_en_singular/unidad_en_plural".</li></ul>

:*'''Ejemplos'''

<blockquote style="border: 1px dashed #2F6FAB; background: #FFFFFF; margin:1em 15ex 5ex 15ex; padding: 1em; text-align:left;">
<code style="background: #FFFFFF">$NumeroEnLetras($Entero({{STR|"223"}}),0,{{STR|"caja/cajas"}},0,{{STR|""}}) {{COM|//devuelve}} {{STR|Doscientas veintitrés cajas}}</code>
</blockquote>

<blockquote style="border: 1px dashed #2F6FAB; background: #FFFFFF; margin:1em 15ex 5ex 15ex; padding: 1em; text-align:left;">
<code style="background: #FFFFFF">$NumeroEnLetras($Real({{STR|"300,05"}}),1,{{STR|"kilómetro/kilómetros"}},3,{{STR|"metro/metros"}}) {{COM|//devuelve}} {{STR|Trescientos kilómetros con cincuenta metros}}</code>
</blockquote>

<blockquote style="border: 1px dashed #2F6FAB; background: #FFFFFF; margin:1em 15ex 5ex 15ex; padding: 1em; text-align:left;">
<code style="background: #FFFFFF">$NumeroEnLetras($Entero({{STR|"1"}}),1,{{STR|"mes/meses"}},0,{{STR|""}}) {{COM|//devuelve}} {{STR|un mes}}</code>
</blockquote>

<blockquote style="border: 1px dashed #2F6FAB; background: #FFFFFF; margin:1em 15ex 5ex 15ex; padding: 1em; text-align:left;">
<code style="background: #FFFFFF">$NumeroEnLetras([Importe],1,{{STR|"euro/euros"}},2,{{STR|"céntimo/céntimos"}}) {{COM|//devuelve el mismo resultado que la función $eurosEnLetras.}}</code>
</blockquote>

<blockquote style="border: 1px dashed #2F6FAB; background: #FFFFFF; margin:1em 15ex 5ex 15ex; padding: 1em; text-align:left;">
<code style="background: #FFFFFF">$NumeroEnLetras($Entero({{STR|"23"}}),1,{{STR|""}},0,{{STR|""}}) {{COM|//devuelve}} {{STR|veintitrés}}</code>
</blockquote>

[[Categoría:ODL]]
[[Categoría:Funciones]]

Funciones de librería

2012-02-13T13:46:46Z

Jrodriguez: /* Manejo de matrices */

__NOTOC__
====[[Conversión de tipos]]====
Funciones que transforman el resultado de una expresión a un tipo de dato específico.

<code>[[Conversión de tipos#$Entero|$Entero]] - [[Conversión de tipos#$Fecha|$Fecha]] - [[Conversión de tipos#$Logico|$Logico]] - [[Conversión de tipos#$Real|$Real]] - [[Conversión de tipos#$Texto|$Texto]]</code>

====[[Indicadores de tipo]]====
Funciones que indican el tipo de una expresión. La utilidad de estas funciones radica en devolver el tipo de expresiones que no son evaluadas, como pueden ser aquellas en las que se accede al dominio de algún componente o recurso.

<code>[[Indicadores de tipo#$Coleccion|$Coleccion]] - [[Indicadores de tipo#$Lista|$Lista]] - [[Indicadores de tipo#$Tabla|$Tabla]] - [[Indicadores de tipo#$Vinculo|$Vinculo]]</code>

====[[Tratamiento de textos]]====
Funciones que nos permitirán realizar operaciones con datos de tipo texto.

<code>[[Tratamiento de textos#$CopiarTexto|$CopiarTexto]] - [[Tratamiento de textos#$LongitudTexto|$LongitudTexto]] - [[Tratamiento de textos#$Texto|$Texto]]</code>

====[[Tratamiento de números]]====
Compendio de funciones que permiten tratar datos numéricos, tanto enteros como reales. Se podrá obtener la parte decimal o entera de un real, saber si un número es par o impar, etc.

<code>[[Tratamiento de números#$Entero|$Entero]] - [[Tratamiento de números#$EsPar|$EsPar]] - [[Tratamiento de números#$Max|$Max]] - [[Tratamiento de números#$Min|$Min]] - [[Tratamiento de números#$ParteDecimal|$ParteDecimal]] - [[Tratamiento de números#$ParteEntera|$ParteEntera]] - [[Tratamiento de números#$Real|$Real]] - [[Tratamiento de números#$Redondeo|$Redondeo]]</code>

====[[Tratamiento de horas y fechas]]====
Es muy habitual trabajar con fechas a la hora de programar un sistema de información en ODL. Por ello, se han creado numerosas funciones que nos permitirán manejar el tipo de dato "fecha". Por ejemplo, podremos obtener datos concretos como el día, mes o año, comparar dos fechas o calcular una fecha a partir de otra, entre otras.

<code>[[Tratamiento de horas y fechas#$Año|$Año]] - [[Tratamiento de horas y fechas#$CalculaFecha|$CalculaFecha]] - [[Tratamiento de horas y fechas#$Dia|$Dia]] - [[Tratamiento de horas y fechas#$DiferenciaDias|$DiferenciaDias]] - [[Tratamiento de horas y fechas#$DiferenciaFechas|$DiferenciaFechas]] - [[Tratamiento de horas y fechas#$Fecha|$Fecha]] - [[Tratamiento de horas y fechas#$FormatoFecha|$FormatoFecha]] - [[Tratamiento de horas y fechas#$Hoy|$Hoy]] - [[Tratamiento de horas y fechas#$Mes|$Mes]]</code>

====[[Tratamiento de moneda]]====
<code>[[Tratamiento de moneda#$Cifra|$Cifra]]</code> - <code>[[Tratamiento de moneda#$Moneda|$Moneda]]</code>

====[[Manejo de listas de comprobación]]====
Es posible que en el desarrollo de nuestro sistema de información en ODL nos interese realizar ciertas operaciones con las listas de comprobación. Una operación frecuente es invertir la selección de las filas. Accede al siguiente artículo para conocer, por ejemplo, esta función de uso muy común.

<code>[[Manejo de listas de comprobación#$InvertirSeleccion|$InvertirSeleccion]] - [[Manejo de listas de comprobación#$Lista|$Lista]]</code>

====[[Creación de matrices]]====
Crea matrices a partir de otros componentes o recursos de ODL. Además, se podrán crear matrices a partir de los resultados obtenidos en una petición a la base de datos.

<code>[[Creación de matrices#$Matriz(texto)|$Matriz(texto)]] - [[Creación de matrices#$Matriz(componente)|$Matriz(componente)]] - [[Creación de matrices#$Matriz(enumerado,exportación)|$Matriz(enumerado,exportación)]] - [[Creación de matrices#$MatrizSQL|$MatrizSQL]]</code>

====[[Cálculo con matrices]]====
Conjunto de funciones para realizar diversos cálculos sobre matrices. Sumar columnas, calcular medias, buscar un elemento concreto, buscar el valor máximo o mínimo de una columna, etc.

<code>[[Cálculo con matrices#$Elemento|$Elemento]] - [[Cálculo con matrices#$Max|$Max]] - [[Cálculo con matrices#$Media|$Media]] - [[Cálculo con matrices#$Min|$Min]] - [[Cálculo con matrices#$NumeroColumnas|$NumeroColumnas]] - [[Cálculo con matrices#$NumeroFilas|$NumeroFilas]] - [[Cálculo con matrices#$Suma|$Suma]]</code>

====[[Manejo de matrices]]====
En el siguiente artículo se muestran varias funciones que permiten realizar diversas operaciones con matrices. Por ejemplo, filtrar una matriz con un cierto valor, ordenar una matriz, renombrar columnas, etcétera...

<code>[[Manejo de matrices#$AgruparSuma|$AgruparSuma]] - [[Manejo de matrices#$Columnas|$Columnas]] - [[Manejo de matrices#$ConcatenarColumna|$ConcatenarColumna]] - [[Manejo de matrices#$EliminarFilasRepetidas|$EliminarFilasRepetidas]] - [[Manejo de matrices#$Filtrar|$Filtrar]] - [[Manejo de matrices#$MatrizFila|$MatrizFila]] - [[Manejo de matrices#$Ordenar|$Ordenar]] - [[Manejo de matrices#$RenombrarColumnas|$RenombrarColumnas]] - [[Manejo de matrices#$AsignarElemento|$AsignarElemento]]</code>

====[[Manejo de colecciones]]====
En este artículo facilitamos las funciones que nos permitirán seleccionar un objeto o varios de ellos de una colección concreta, cumpliendo con una definición determinada.

<code>[[Manejo de colecciones#$SeleccionarObjetoPorDefinicion|$SeleccionarObjetoPorDefinicion]] - [[Manejo de colecciones#$SeleccionarObjetosPorDefinicion|$SeleccionarObjetosPorDefinicion]]</code>

====[[Funciones especiales]]====
Conjunto de funciones que entre sí no tienen mucho en común, o que no actúan sobre un componente o recurso concreto. No por ello carecen de la misma importancia que las demás. Te recomendamos que accedas, quizás la función que buscas se encuentre en este artículo.

<code>[[Funciones especiales#$Crear|$Crear]] - [[Funciones especiales#$Decision|$Decision]] - [[Funciones especiales#$DRC|$DRC]] - [[Funciones especiales#$EsTipo|$EsTipo]] - [[Funciones especiales#$Si|$Si]] - [[Funciones especiales#$VariableCentro|$VariableCentro]]</code>

====[[Ejecución de sentencias SQL]]====
En este artículo se muestran dos funciones que nos permitirán obtener, o bien una matriz con los valores obtenidos de una sentencia SQL, o bien el primer valor encontrado.

<code>[[Ejecución de sentencias SQL#$MatrizSQL|$MatrizSQL]] - [[Ejecución de sentencias SQL#$ValorSQL|$ValorSQL]]</code>

====[[Funciones de método]]====
Aquí se especifican las funciones que se utilizan en el desarrollo de los métodos.

<code>[[Funciones de método#$Crear|$Crear]] - [[Funciones de método#$Ejecutar|$Ejecutar]] - [[Funciones de método#$Firmar|$Firmar]] - [[Funciones de método#$Guardar|$Guardar]] - [[Funciones de método#$Lanzar|$Lanzar]] - [[Funciones de método#$Mover|$Mover]] - [[Funciones de método#$Sellar|$Sellar]]</code>

[[Categoría:ODL]]
[[Categoría:Funciones]]

Manejo de matrices

2012-02-13T13:46:30Z

Jrodriguez: /* <code>$AsignarElemento</code> */

__NOTOC__
===<code>$Filtrar</code>===
<blockquote style="border: 2px solid #993365; background: #FFFFFF; margin:1em 1ex 1ex 1ex; padding: 1em; text-align:left">
<code>'''$Filtrar'''(M: {{T|matriz}}, Condicion: {{T|texto}}): {{T|matriz}}</code></blockquote>

:*'''Descripción'''Devuelve una matriz que introducimos como parámetro de la función, pero con aquellos elementos que cumplan la condición especificada en el segundo parámetro.

:*'''Ejemplos'''

<blockquote style="border: 1px dashed #2F6FAB; background: #FFFFFF; margin:1em 15ex 5ex 15ex; padding: 1em; text-align:left;">
<code style="background: #FFFFFF">$Filtrar([Municipios], '''"[#Isla]=[Gran Canaria]"''') {{COM|//devuelve una matriz de los municipios de una determinada isla, tras evaluar el campo [Isla]}}</code>
</blockquote>

<blockquote style="border: 1px dashed #2F6FAB; background: #FFFFFF; margin:1em 15ex 5ex 15ex; padding: 1em; text-align:left;">
<code style="background: #FFFFFF">$Filtrar($Matriz[Representantes], '''"([#Tipo] = 'Secundario') y ([#Cargo] ='Directivo')"''')</code>
</blockquote>

===<code>$Ordenar</code>===

<blockquote style="border: 2px solid #993365; background: #FFFFFF; margin:1em 1ex 1ex 1ex; padding: 1em; text-align:left">
<code>'''$Ordenar'''(M: {{T|matriz}}, Columna: {{T|texto}}, Ascendente: {{T|lógico}}): {{T|matriz}}</code></blockquote>

:*'''Descripción'''Devuelve una matriz cuyas filas estarán ordenadas en función de la columna que indiquemos como parámetro. Podrán ordenarse ascendentemente (verdadero) o descendentemente (falso).

:*'''Ejemplo'''

<blockquote style="border: 1px dashed #2F6FAB; background: #FFFFFF; margin:1em 15ex 5ex 15ex; padding: 1em; text-align:left;">
<code style="background: #FFFFFF">$Ordenar([Asignaturas], {{STR|"[#Curso]"}}, verdadero) {{COM|//devuelve una matriz con las
asignaturas ordenadas por curso de forma ascendente}}</code>
</blockquote>

===<code>$EliminarFilasRepetidas</code>===

<blockquote style="border: 2px solid #993365; background: #FFFFFF; margin:1em 1ex 1ex 1ex; padding: 1em; text-align:left">
<code>'''$EliminarFilasRepetidas'''(M: {{T|matriz}}): {{T|matriz}}</code></blockquote>

:*'''Descripción'''Elimina las filas repetidas de una matriz que pasamos a la función como parámetro de entrada.

:*'''Ejemplo'''

<blockquote style="border: 1px dashed #2F6FAB; background: #FFFFFF; margin:1em 15ex 5ex 15ex; padding: 1em; text-align:left;">
<code style="background: #FFFFFF">$EliminarFilasRepetidas($Columnas($Matriz([Islas]),{{STR|"[Provincia]"}}));</code>
</blockquote>

===<code>$MatrizFila</code>===

<blockquote style="border: 2px solid #993365; background: #FFFFFF; margin:1em 1ex 1ex 1ex; padding: 1em; text-align:left">
<code>'''$MatrizFila'''(Expresion: {{T|texto}} {, E: {{T|texto}}}): {{T|matriz}}</code></blockquote>

:*'''Descripción'''Devuelve una matriz de una sola fila, donde los valores son obtenidos de campos definidos. La expresión corresponderá a una asignación con el nombre de la columna y a continuación la expresión de un campo donde obtener el valor. La forma de la expresión es "Nombre_columna = [Campo]"

:*'''Ejemplo'''

<blockquote style="border: 1px dashed #2F6FAB; background: #FFFFFF; margin:1em 15ex 5ex 15ex; padding: 1em; text-align:left;">
<code style="background: #FFFFFF">$MatrizFila('''"[Nombre] = [Denominación]->[Datos del promotor].[Promotor]"''')</code>
</blockquote>

===<code>$RenombrarColumnas</code>===

<blockquote style="border: 2px solid #993365; background: #FFFFFF; margin:1em 1ex 1ex 1ex; padding: 1em; text-align:left">
<code>'''$RenombrarColumnas'''(M: {{T|matriz}}, Actual: {{T|texto}}, Nuevo: {{T|texto}} {, A: {{T|texto}}, N: {{T|texto}}}): {{T|matriz}}</code></blockquote>

:*'''Descripción'''Devuelve una matriz con las columnas «Actual» renombradas por «Nuevo».

:*'''Ejemplo'''

<blockquote style="border: 1px dashed #2F6FAB; background: #FFFFFF; margin:1em 15ex 5ex 15ex; padding: 1em; text-align:left;">
<code style="background: #FFFFFF">$RenombrarColumnas(M, {{STR|"Cod"}}, {{STR|"Código"}}, {{STR|"Den"}}, {{STR|"Denominación"}}) {{COM|//devuelve la matriz donde las columnas: "Cod" y "Den" se han renombrado por "Código" y "Denominación"}}</code>
</blockquote>

===<code>$Columnas</code>===

<blockquote style="border: 2px solid #993365; background: #FFFFFF; margin:1em 1ex 1ex 1ex; padding: 1em; text-align:left">
<code>'''$Columnas'''(M: {{T|matriz}}, Columna: {{T|texto}} {, C: {{T|texto}}}): {{T|matriz}}</code></blockquote>

:*'''Descripción'''Función que devuelve una matriz con las columnas seleccionadas de otra matriz que introducimos como parámetro de entrada.

:*'''Ejemplo'''

<blockquote style="border: 1px dashed #2F6FAB; background: #FFFFFF; margin:1em 15ex 5ex 15ex; padding: 1em; text-align:left;">
<code style="background: #FFFFFF">$Columnas([Municipios], {{STR|"[#Municipio]"}}, {{STR|"[#CodProvincia]"}})</code>
</blockquote>

===<code>$AgruparSuma</code>===

<blockquote style="border: 2px solid #993365; background: #FFFFFF; margin:1em 1ex 1ex 1ex; padding: 1em; text-align:left">
<code>'''$AgruparSuma'''(M: {{T|matriz}}, Suma: {{T|texto}}, Agrupa: {{T|texto}} {, A: {{T|texto}}}): {{T|matriz}}</code></blockquote>

:*'''Descripción'''Devuelve una matriz donde se agruparán las filas cuando exista una coincidencia entre los valores de las columnas «Agrupa» que se especifiquen. Al encontrar una coincidencia se sumarán los valores de las celdas «Suma» de cada coincidencia y el resultado se escribirá en la celda resultante de la columna «Suma». Se creará por tanto, una sola fila, con una columna «Suma» y la fusión de las columnas cuyos valores coincidan. La matriz devuelta sólo constará de las columnas «Agrupa» y la columna «Suma», que ha de ser numérica.

:*'''Ejemplo'''

<blockquote style="border: 1px dashed #2F6FAB; background: #FFFFFF; margin:1em 15ex 5ex 15ex; padding: 1em; text-align:left;">
<code style="background: #FFFFFF">$AgruparSuma(M, {{STR|"Importe"}}, {{STR|"Producto"}}, {{STR|"Categoría"}}) {{COM|//devuelve una matriz con las tres columnas donde siempre que coincida los valores del par «Producto» y «Categoría», los valores de «Importe» se suman}}</code>
</blockquote>

===<code>$ConcatenarColumna</code>===

<blockquote style="border: 2px solid #993365; background: #FFFFFF; margin:1em 1ex 1ex 1ex; padding: 1em; text-align:left">
<code>'''$ConcatenarColumna'''(M: {{T|matriz}}, Columna: {{T|texto}}, SímboloIntermedio: {{T|texto}}, SímboloFinal: {{T|Texto}}: {{T|texto}}</code></blockquote>

:*'''Descripción'''Concatena los valores de todas las celdas de una columna concreta de una matriz. Habrá que especificar como parámetros de entrada la matriz, la columna, el símbolo separador y el símbolo separador de los dos últimos valores de la columna. El valor devuelto será de tipo texto con todos los valores separados por el símbolo separador, salvo los dos últimos valores, que estarán separados por el segundo símbolo separador.

:*'''Ejemplo'''

<blockquote style="border: 1px dashed #2F6FAB; background: #FFFFFF; margin:1em 15ex 5ex 15ex; padding: 1em; text-align:left;">
<code style="background: #FFFFFF">$ConcatenarColumna($Matriz([Continentes]), {{STR|"Nombre_continente"}}, {{STR|","}}, {{STR|"y"}}) {{COM|//devuelve}} {{STR|África, América, Asia, Europa y Oceanía}}</code>
</blockquote>

===<code>$AsignarElemento</code>===

<blockquote style="border: 2px solid #993365; background: #FFFFFF; margin:1em 1ex 1ex 1ex; padding: 1em; text-align:left">
<code>'''$AsignarElemento'''(M: {{T|matriz}}, Fila: {{T|entero}}, Columna: {{T|texto}}, Valor: {{T|texto}}): {{T|lógico}}</code></blockquote>

:*'''Descripción'''Asigna un valor a una celda concreta de una tabla. Se debe especificar como parámetros de entradas la matriz, la fila, la columna y el valor que se desea asignar a la celda.<ul type=disk><li>Fila: entero que indica la fila de la celda a modificar. Ha de tener un valor mayor o igual a 0 y menor que el número total de filas de la tabla.</li><li>Columna: nombre de la columna de la celda a modificar.</li><li>Valor: puede ser de tipo texto, vínculo, lógico, entero, fecha o variable.</li></ul>La función devuelve verdadero si se ha realizado correctamente la asignación.Es imprescindible que la tabla en la que se va a realizar la asignación contenga al menos una fila.

:*'''Ejemplo'''

<blockquote style="border: 1px dashed #2F6FAB; background: #FFFFFF; margin:1em 15ex 5ex 15ex; padding: 1em; text-align:left;">
<code style="background: #FFFFFF">$AsignarElemento($Matriz([Continentes]), 0, {{STR|"[#Nombre_continente]"}}, $Texto({{STR|"Europa"}}))</code>
</blockquote>

[[Categoría:ODL]]
[[Categoría:Funciones]]

Manejo de matrices

2012-02-13T13:39:34Z

Jrodriguez: /* <code>$AsignarElemento</code> */

__NOTOC__
===<code>$Filtrar</code>===
<blockquote style="border: 2px solid #993365; background: #FFFFFF; margin:1em 1ex 1ex 1ex; padding: 1em; text-align:left">
<code>'''$Filtrar'''(M: {{T|matriz}}, Condicion: {{T|texto}}): {{T|matriz}}</code></blockquote>

:*'''Descripción'''Devuelve una matriz que introducimos como parámetro de la función, pero con aquellos elementos que cumplan la condición especificada en el segundo parámetro.

:*'''Ejemplos'''

<blockquote style="border: 1px dashed #2F6FAB; background: #FFFFFF; margin:1em 15ex 5ex 15ex; padding: 1em; text-align:left;">
<code style="background: #FFFFFF">$Filtrar([Municipios], '''"[#Isla]=[Gran Canaria]"''') {{COM|//devuelve una matriz de los municipios de una determinada isla, tras evaluar el campo [Isla]}}</code>
</blockquote>

<blockquote style="border: 1px dashed #2F6FAB; background: #FFFFFF; margin:1em 15ex 5ex 15ex; padding: 1em; text-align:left;">
<code style="background: #FFFFFF">$Filtrar($Matriz[Representantes], '''"([#Tipo] = 'Secundario') y ([#Cargo] ='Directivo')"''')</code>
</blockquote>

===<code>$Ordenar</code>===

<blockquote style="border: 2px solid #993365; background: #FFFFFF; margin:1em 1ex 1ex 1ex; padding: 1em; text-align:left">
<code>'''$Ordenar'''(M: {{T|matriz}}, Columna: {{T|texto}}, Ascendente: {{T|lógico}}): {{T|matriz}}</code></blockquote>

:*'''Descripción'''Devuelve una matriz cuyas filas estarán ordenadas en función de la columna que indiquemos como parámetro. Podrán ordenarse ascendentemente (verdadero) o descendentemente (falso).

:*'''Ejemplo'''

<blockquote style="border: 1px dashed #2F6FAB; background: #FFFFFF; margin:1em 15ex 5ex 15ex; padding: 1em; text-align:left;">
<code style="background: #FFFFFF">$Ordenar([Asignaturas], {{STR|"[#Curso]"}}, verdadero) {{COM|//devuelve una matriz con las
asignaturas ordenadas por curso de forma ascendente}}</code>
</blockquote>

===<code>$EliminarFilasRepetidas</code>===

<blockquote style="border: 2px solid #993365; background: #FFFFFF; margin:1em 1ex 1ex 1ex; padding: 1em; text-align:left">
<code>'''$EliminarFilasRepetidas'''(M: {{T|matriz}}): {{T|matriz}}</code></blockquote>

:*'''Descripción'''Elimina las filas repetidas de una matriz que pasamos a la función como parámetro de entrada.

:*'''Ejemplo'''

<blockquote style="border: 1px dashed #2F6FAB; background: #FFFFFF; margin:1em 15ex 5ex 15ex; padding: 1em; text-align:left;">
<code style="background: #FFFFFF">$EliminarFilasRepetidas($Columnas($Matriz([Islas]),{{STR|"[Provincia]"}}));</code>
</blockquote>

===<code>$MatrizFila</code>===

<blockquote style="border: 2px solid #993365; background: #FFFFFF; margin:1em 1ex 1ex 1ex; padding: 1em; text-align:left">
<code>'''$MatrizFila'''(Expresion: {{T|texto}} {, E: {{T|texto}}}): {{T|matriz}}</code></blockquote>

:*'''Descripción'''Devuelve una matriz de una sola fila, donde los valores son obtenidos de campos definidos. La expresión corresponderá a una asignación con el nombre de la columna y a continuación la expresión de un campo donde obtener el valor. La forma de la expresión es "Nombre_columna = [Campo]"

:*'''Ejemplo'''

<blockquote style="border: 1px dashed #2F6FAB; background: #FFFFFF; margin:1em 15ex 5ex 15ex; padding: 1em; text-align:left;">
<code style="background: #FFFFFF">$MatrizFila('''"[Nombre] = [Denominación]->[Datos del promotor].[Promotor]"''')</code>
</blockquote>

===<code>$RenombrarColumnas</code>===

<blockquote style="border: 2px solid #993365; background: #FFFFFF; margin:1em 1ex 1ex 1ex; padding: 1em; text-align:left">
<code>'''$RenombrarColumnas'''(M: {{T|matriz}}, Actual: {{T|texto}}, Nuevo: {{T|texto}} {, A: {{T|texto}}, N: {{T|texto}}}): {{T|matriz}}</code></blockquote>

:*'''Descripción'''Devuelve una matriz con las columnas «Actual» renombradas por «Nuevo».

:*'''Ejemplo'''

<blockquote style="border: 1px dashed #2F6FAB; background: #FFFFFF; margin:1em 15ex 5ex 15ex; padding: 1em; text-align:left;">
<code style="background: #FFFFFF">$RenombrarColumnas(M, {{STR|"Cod"}}, {{STR|"Código"}}, {{STR|"Den"}}, {{STR|"Denominación"}}) {{COM|//devuelve la matriz donde las columnas: "Cod" y "Den" se han renombrado por "Código" y "Denominación"}}</code>
</blockquote>

===<code>$Columnas</code>===

<blockquote style="border: 2px solid #993365; background: #FFFFFF; margin:1em 1ex 1ex 1ex; padding: 1em; text-align:left">
<code>'''$Columnas'''(M: {{T|matriz}}, Columna: {{T|texto}} {, C: {{T|texto}}}): {{T|matriz}}</code></blockquote>

:*'''Descripción'''Función que devuelve una matriz con las columnas seleccionadas de otra matriz que introducimos como parámetro de entrada.

:*'''Ejemplo'''

<blockquote style="border: 1px dashed #2F6FAB; background: #FFFFFF; margin:1em 15ex 5ex 15ex; padding: 1em; text-align:left;">
<code style="background: #FFFFFF">$Columnas([Municipios], {{STR|"[#Municipio]"}}, {{STR|"[#CodProvincia]"}})</code>
</blockquote>

===<code>$AgruparSuma</code>===

<blockquote style="border: 2px solid #993365; background: #FFFFFF; margin:1em 1ex 1ex 1ex; padding: 1em; text-align:left">
<code>'''$AgruparSuma'''(M: {{T|matriz}}, Suma: {{T|texto}}, Agrupa: {{T|texto}} {, A: {{T|texto}}}): {{T|matriz}}</code></blockquote>

:*'''Descripción'''Devuelve una matriz donde se agruparán las filas cuando exista una coincidencia entre los valores de las columnas «Agrupa» que se especifiquen. Al encontrar una coincidencia se sumarán los valores de las celdas «Suma» de cada coincidencia y el resultado se escribirá en la celda resultante de la columna «Suma». Se creará por tanto, una sola fila, con una columna «Suma» y la fusión de las columnas cuyos valores coincidan. La matriz devuelta sólo constará de las columnas «Agrupa» y la columna «Suma», que ha de ser numérica.

:*'''Ejemplo'''

<blockquote style="border: 1px dashed #2F6FAB; background: #FFFFFF; margin:1em 15ex 5ex 15ex; padding: 1em; text-align:left;">
<code style="background: #FFFFFF">$AgruparSuma(M, {{STR|"Importe"}}, {{STR|"Producto"}}, {{STR|"Categoría"}}) {{COM|//devuelve una matriz con las tres columnas donde siempre que coincida los valores del par «Producto» y «Categoría», los valores de «Importe» se suman}}</code>
</blockquote>

===<code>$ConcatenarColumna</code>===

<blockquote style="border: 2px solid #993365; background: #FFFFFF; margin:1em 1ex 1ex 1ex; padding: 1em; text-align:left">
<code>'''$ConcatenarColumna'''(M: {{T|matriz}}, Columna: {{T|texto}}, SímboloIntermedio: {{T|texto}}, SímboloFinal: {{T|Texto}}: {{T|texto}}</code></blockquote>

:*'''Descripción'''Concatena los valores de todas las celdas de una columna concreta de una matriz. Habrá que especificar como parámetros de entrada la matriz, la columna, el símbolo separador y el símbolo separador de los dos últimos valores de la columna. El valor devuelto será de tipo texto con todos los valores separados por el símbolo separador, salvo los dos últimos valores, que estarán separados por el segundo símbolo separador.

:*'''Ejemplo'''

<blockquote style="border: 1px dashed #2F6FAB; background: #FFFFFF; margin:1em 15ex 5ex 15ex; padding: 1em; text-align:left;">
<code style="background: #FFFFFF">$ConcatenarColumna($Matriz([Continentes]), {{STR|"Nombre_continente"}}, {{STR|","}}, {{STR|"y"}}) {{COM|//devuelve}} {{STR|África, América, Asia, Europa y Oceanía}}</code>
</blockquote>

===<code>$AsignarElemento</code>===

<blockquote style="border: 2px solid #993365; background: #FFFFFF; margin:1em 1ex 1ex 1ex; padding: 1em; text-align:left">
<code>'''$AsignarElemento'''(M: {{T|matriz}}, Fila: {{T|entero}}, Columna: {{T|texto}}, Valor: {{T|texto}}): {{T|lógico}}</code></blockquote>

:*'''Descripción'''Asigna un valor a una celda concreta de una tabla. Se debe especificar como parámetros de entradas la matriz, la fila, la columna y el valor que se desea asignar a la celda. Este valor puede ser de tipo texto, vínculo, lógico, entero, fecha o variable. La función devuelve verdadero si se ha realizado correctamente la asignación.Es imprescindible que la tabla en la que se va a realizar la asignación contenga al menos una fila.

:*'''Ejemplo'''

<blockquote style="border: 1px dashed #2F6FAB; background: #FFFFFF; margin:1em 15ex 5ex 15ex; padding: 1em; text-align:left;">
<code style="background: #FFFFFF">$AsignarElemento($Matriz([Continentes]), 0, {{STR|"[#Nombre_continente]"}}, $Texto({{STR|"Europa"}}))</code>
</blockquote>

[[Categoría:ODL]]
[[Categoría:Funciones]]

Manejo de matrices

2012-02-13T13:32:45Z

Jrodriguez:

__NOTOC__
===<code>$Filtrar</code>===
<blockquote style="border: 2px solid #993365; background: #FFFFFF; margin:1em 1ex 1ex 1ex; padding: 1em; text-align:left">
<code>'''$Filtrar'''(M: {{T|matriz}}, Condicion: {{T|texto}}): {{T|matriz}}</code></blockquote>

:*'''Descripción'''Devuelve una matriz que introducimos como parámetro de la función, pero con aquellos elementos que cumplan la condición especificada en el segundo parámetro.

:*'''Ejemplos'''

<blockquote style="border: 1px dashed #2F6FAB; background: #FFFFFF; margin:1em 15ex 5ex 15ex; padding: 1em; text-align:left;">
<code style="background: #FFFFFF">$Filtrar([Municipios], '''"[#Isla]=[Gran Canaria]"''') {{COM|//devuelve una matriz de los municipios de una determinada isla, tras evaluar el campo [Isla]}}</code>
</blockquote>

<blockquote style="border: 1px dashed #2F6FAB; background: #FFFFFF; margin:1em 15ex 5ex 15ex; padding: 1em; text-align:left;">
<code style="background: #FFFFFF">$Filtrar($Matriz[Representantes], '''"([#Tipo] = 'Secundario') y ([#Cargo] ='Directivo')"''')</code>
</blockquote>

===<code>$Ordenar</code>===

<blockquote style="border: 2px solid #993365; background: #FFFFFF; margin:1em 1ex 1ex 1ex; padding: 1em; text-align:left">
<code>'''$Ordenar'''(M: {{T|matriz}}, Columna: {{T|texto}}, Ascendente: {{T|lógico}}): {{T|matriz}}</code></blockquote>

:*'''Descripción'''Devuelve una matriz cuyas filas estarán ordenadas en función de la columna que indiquemos como parámetro. Podrán ordenarse ascendentemente (verdadero) o descendentemente (falso).

:*'''Ejemplo'''

<blockquote style="border: 1px dashed #2F6FAB; background: #FFFFFF; margin:1em 15ex 5ex 15ex; padding: 1em; text-align:left;">
<code style="background: #FFFFFF">$Ordenar([Asignaturas], {{STR|"[#Curso]"}}, verdadero) {{COM|//devuelve una matriz con las
asignaturas ordenadas por curso de forma ascendente}}</code>
</blockquote>

===<code>$EliminarFilasRepetidas</code>===

<blockquote style="border: 2px solid #993365; background: #FFFFFF; margin:1em 1ex 1ex 1ex; padding: 1em; text-align:left">
<code>'''$EliminarFilasRepetidas'''(M: {{T|matriz}}): {{T|matriz}}</code></blockquote>

:*'''Descripción'''Elimina las filas repetidas de una matriz que pasamos a la función como parámetro de entrada.

:*'''Ejemplo'''

<blockquote style="border: 1px dashed #2F6FAB; background: #FFFFFF; margin:1em 15ex 5ex 15ex; padding: 1em; text-align:left;">
<code style="background: #FFFFFF">$EliminarFilasRepetidas($Columnas($Matriz([Islas]),{{STR|"[Provincia]"}}));</code>
</blockquote>

===<code>$MatrizFila</code>===

<blockquote style="border: 2px solid #993365; background: #FFFFFF; margin:1em 1ex 1ex 1ex; padding: 1em; text-align:left">
<code>'''$MatrizFila'''(Expresion: {{T|texto}} {, E: {{T|texto}}}): {{T|matriz}}</code></blockquote>

:*'''Descripción'''Devuelve una matriz de una sola fila, donde los valores son obtenidos de campos definidos. La expresión corresponderá a una asignación con el nombre de la columna y a continuación la expresión de un campo donde obtener el valor. La forma de la expresión es "Nombre_columna = [Campo]"

:*'''Ejemplo'''

<blockquote style="border: 1px dashed #2F6FAB; background: #FFFFFF; margin:1em 15ex 5ex 15ex; padding: 1em; text-align:left;">
<code style="background: #FFFFFF">$MatrizFila('''"[Nombre] = [Denominación]->[Datos del promotor].[Promotor]"''')</code>
</blockquote>

===<code>$RenombrarColumnas</code>===

<blockquote style="border: 2px solid #993365; background: #FFFFFF; margin:1em 1ex 1ex 1ex; padding: 1em; text-align:left">
<code>'''$RenombrarColumnas'''(M: {{T|matriz}}, Actual: {{T|texto}}, Nuevo: {{T|texto}} {, A: {{T|texto}}, N: {{T|texto}}}): {{T|matriz}}</code></blockquote>

:*'''Descripción'''Devuelve una matriz con las columnas «Actual» renombradas por «Nuevo».

:*'''Ejemplo'''

<blockquote style="border: 1px dashed #2F6FAB; background: #FFFFFF; margin:1em 15ex 5ex 15ex; padding: 1em; text-align:left;">
<code style="background: #FFFFFF">$RenombrarColumnas(M, {{STR|"Cod"}}, {{STR|"Código"}}, {{STR|"Den"}}, {{STR|"Denominación"}}) {{COM|//devuelve la matriz donde las columnas: "Cod" y "Den" se han renombrado por "Código" y "Denominación"}}</code>
</blockquote>

===<code>$Columnas</code>===

<blockquote style="border: 2px solid #993365; background: #FFFFFF; margin:1em 1ex 1ex 1ex; padding: 1em; text-align:left">
<code>'''$Columnas'''(M: {{T|matriz}}, Columna: {{T|texto}} {, C: {{T|texto}}}): {{T|matriz}}</code></blockquote>

:*'''Descripción'''Función que devuelve una matriz con las columnas seleccionadas de otra matriz que introducimos como parámetro de entrada.

:*'''Ejemplo'''

<blockquote style="border: 1px dashed #2F6FAB; background: #FFFFFF; margin:1em 15ex 5ex 15ex; padding: 1em; text-align:left;">
<code style="background: #FFFFFF">$Columnas([Municipios], {{STR|"[#Municipio]"}}, {{STR|"[#CodProvincia]"}})</code>
</blockquote>

===<code>$AgruparSuma</code>===

<blockquote style="border: 2px solid #993365; background: #FFFFFF; margin:1em 1ex 1ex 1ex; padding: 1em; text-align:left">
<code>'''$AgruparSuma'''(M: {{T|matriz}}, Suma: {{T|texto}}, Agrupa: {{T|texto}} {, A: {{T|texto}}}): {{T|matriz}}</code></blockquote>

:*'''Descripción'''Devuelve una matriz donde se agruparán las filas cuando exista una coincidencia entre los valores de las columnas «Agrupa» que se especifiquen. Al encontrar una coincidencia se sumarán los valores de las celdas «Suma» de cada coincidencia y el resultado se escribirá en la celda resultante de la columna «Suma». Se creará por tanto, una sola fila, con una columna «Suma» y la fusión de las columnas cuyos valores coincidan. La matriz devuelta sólo constará de las columnas «Agrupa» y la columna «Suma», que ha de ser numérica.

:*'''Ejemplo'''

<blockquote style="border: 1px dashed #2F6FAB; background: #FFFFFF; margin:1em 15ex 5ex 15ex; padding: 1em; text-align:left;">
<code style="background: #FFFFFF">$AgruparSuma(M, {{STR|"Importe"}}, {{STR|"Producto"}}, {{STR|"Categoría"}}) {{COM|//devuelve una matriz con las tres columnas donde siempre que coincida los valores del par «Producto» y «Categoría», los valores de «Importe» se suman}}</code>
</blockquote>

===<code>$ConcatenarColumna</code>===

<blockquote style="border: 2px solid #993365; background: #FFFFFF; margin:1em 1ex 1ex 1ex; padding: 1em; text-align:left">
<code>'''$ConcatenarColumna'''(M: {{T|matriz}}, Columna: {{T|texto}}, SímboloIntermedio: {{T|texto}}, SímboloFinal: {{T|Texto}}: {{T|texto}}</code></blockquote>

:*'''Descripción'''Concatena los valores de todas las celdas de una columna concreta de una matriz. Habrá que especificar como parámetros de entrada la matriz, la columna, el símbolo separador y el símbolo separador de los dos últimos valores de la columna. El valor devuelto será de tipo texto con todos los valores separados por el símbolo separador, salvo los dos últimos valores, que estarán separados por el segundo símbolo separador.

:*'''Ejemplo'''

<blockquote style="border: 1px dashed #2F6FAB; background: #FFFFFF; margin:1em 15ex 5ex 15ex; padding: 1em; text-align:left;">
<code style="background: #FFFFFF">$ConcatenarColumna($Matriz([Continentes]), {{STR|"Nombre_continente"}}, {{STR|","}}, {{STR|"y"}}) {{COM|//devuelve}} {{STR|África, América, Asia, Europa y Oceanía}}</code>
</blockquote>

===<code>$AsignarElemento</code>===

<blockquote style="border: 2px solid #993365; background: #FFFFFF; margin:1em 1ex 1ex 1ex; padding: 1em; text-align:left">
<code>'''$AsignarElemento'''(M: {{T|matriz}}, Fila: {{T|entero}}, Columna: {{T|texto}}, Valor: {{T|texto}}: {{T|lógico}}</code></blockquote>

:*'''Descripción'''Asgina un valor a una celda concreta de una tabla. Habrá que especificar como parámetro de entrada la matriz, la fila, la columna y el valor que se desea asignar a la celda. Valor puede ser de tipo texto, vínculo, lógico, entero, fecha o variable. Devuelve verdadero si se ha realizado correctamente la asignación.Es imprescindible que la tabla en la que se va a realizar la asignación contenga al menos una fila.

:*'''Ejemplo'''

<blockquote style="border: 1px dashed #2F6FAB; background: #FFFFFF; margin:1em 15ex 5ex 15ex; padding: 1em; text-align:left;">
<code style="background: #FFFFFF">$AsignarElemento($Matriz([Continentes]), {{STR|"Nombre_continente"}}, {{STR|","}}, {{STR|"y"}}) {{COM|//devuelve}} {{STR|África, América, Asia, Europa y Oceanía}}</code>
</blockquote>

[[Categoría:ODL]]
[[Categoría:Funciones]]

Funciones de método

2012-02-13T13:29:44Z

Jrodriguez:

__NOTOC__
===<code>$Crear</code>===
<blockquote style="border: 2px solid #993365; background: #FFFFFF; margin:1em 1ex 1ex 1ex; padding: 1em; text-align:left">
<code>'''$Crear'''(C: {{RE|contenedor}}, Ámbito: {{T|definición}}): {{RE|contenedor}}</code>
</blockquote>

:*'''Descripción'''Permite crear un objeto en el ámbito especificado (colección, exportación, etc.).

:*'''Ejemplo'''

<blockquote style="border: 1px dashed #2F6FAB; background: #FFFFFF; margin:1em 15ex 5ex 15ex; padding: 1em; text-align:left;">
<code style="background: #FFFFFF">$Crear([Expediente], [Expedientes].[Contenido]);</code>
</blockquote>

===<code>$Ejecutar</code>===
<blockquote style="border: 2px solid #993365; background: #FFFFFF; margin:1em 1ex 1ex 1ex; padding: 1em; text-align:left">
<code>'''$Ejecutar'''(Método: {{T|texto}} {, Parámetro: {{T|texto}}}): {{T|lógico}}</code>
</blockquote>

:*'''Descripción'''Permite invocar a un método introduciendo los parámetros asociados a éste.

:*'''Ejemplo'''

<blockquote style="border: 1px dashed #2F6FAB; background: #FFFFFF; margin:1em 15ex 5ex 15ex; padding: 1em; text-align:left;">
<code style="background: #FFFFFF">$Ejecutar({{STR|"RevisarInforme"}}, Informe);</code>
</blockquote>

===<code>$ElaborarEscrito</code>===
<blockquote style="border: 2px solid #993365; background: #FFFFFF; margin:1em 1ex 1ex 1ex; padding: 1em; text-align:left">
<code>'''$ElaborarEscrito'''(Escrito: {{T|documento}}, Plantilla: {{T|texto}}}):</code>
</blockquote>

:*'''Descripción'''Permite elaborar un escrito a nivel de método, de manera que no sería necesario la elaboración del escrito por parte del usuario. Se pasará como primer parámetro el componente escrito, y como segundo parámetro la plantilla que elabora ese escrito.

:*'''Ejemplo'''

<blockquote style="border: 1px dashed #2F6FAB; background: #FFFFFF; margin:1em 15ex 5ex 15ex; padding: 1em; text-align:left;">
<code style="background: #FFFFFF">$ElaborarEscrito(Resolución de beca.[Escrito], {{STR|"Elaborar escrito de resolución de beca"}});</code>
</blockquote>

===<code>$Firmar</code>===

<blockquote style="border: 2px solid #993365; background: #FFFFFF; margin:1em 1ex 1ex 1ex; padding: 1em; text-align:left">
<code>'''$Firmar'''(Campo: {{T|firma}}): {{T|lógico}}</code>
</blockquote>

:*'''Descripción'''Permite firmar un campo firma con la información del usuario que realiza la tarea.

:*'''Ejemplo'''

<blockquote style="border: 1px dashed #2F6FAB; background: #FFFFFF; margin:1em 15ex 5ex 15ex; padding: 1em; text-align:left;">
<code style="background: #FFFFFF">$Firmar([&Destino]->[Datos generales].[Firma del escrito]);</code>
</blockquote>

===<code>$Guardar</code>===

<blockquote style="border: 2px solid #993365; background: #FFFFFF; margin:1em 1ex 1ex 1ex; padding: 1em; text-align:left">
<code>'''$Guardar'''(C: {{RE|contenedor}}[, L: {{T|lógico}}]):</code>
</blockquote>

:*'''Descripción'''Función que guarda el objeto que pasamos en el parámetro "C". En caso de existir un segundo parámetro lógico donde cuyo valor sea verdadero, ejecutará el código asociado al evento "Al_guardar" de la definición de contenedor desde la cuál se ejecuta la función $guardar. Su valor por defecto será falso.

:*'''Ejemplos'''

<blockquote style="border: 1px dashed #2F6FAB; background: #FFFFFF; margin:1em 15ex 5ex 15ex; padding: 1em; text-align:left;">
<code style="background: #FFFFFF">$Guardar([&Destino]);</code>
</blockquote>

<blockquote style="border: 1px dashed #2F6FAB; background: #FFFFFF; margin:1em 15ex 5ex 15ex; padding: 1em; text-align:left;">
<code style="background: #FFFFFF">$Guardar(this,verdadero);</code>
</blockquote>

===<code>$Lanzar</code>===

<blockquote style="border: 2px solid #993365; background: #FFFFFF; margin:1em 1ex 1ex 1ex; padding: 1em; text-align:left">
<code>'''$Lanzar'''(Tarea: {{T|texto}} [, Dominio: {{RE|contenedor}} [, H: {{RE|habitacion}}]]): {{RE|tarea}}</code>
</blockquote>

:*'''Descripción'''Permite lanzar una tarea especificando su nombre. Opcionalmente es posible pasar como parámetro el ''target'' con el que va a trabajar esa tarea o la habitación desde donde se podrá lanzar dicha tarea.

:*'''Ejemplo'''

<blockquote style="border: 1px dashed #2F6FAB; background: #FFFFFF; margin:1em 15ex 5ex 15ex; padding: 1em; text-align:left;">
<code style="background: #FFFFFF">$Lanzar({{STR|"FirmarInforme"}}, Informe);</code>
</blockquote>

===<code>$Mover</code>===

<blockquote style="border: 2px solid #993365; background: #FFFFFF; margin:1em 1ex 1ex 1ex; padding: 1em; text-align:left">
<code>'''$Mover'''(C: {{RE|contenedor}}, Ámbito: {{T|definición}}):</code>
</blockquote>

:*'''Descripción'''Mueve un objeto "C" de una colección origen a una colección destino "T". El objeto se pasa por parámetro al igual que la colección destino. Para que se produzca el cambio, la colección destino deberá aceptar la definición del objeto. En caso de mostrarse campos diferentes en la colección, no habrá problema siempre y cuando existan en la definición del objeto. Ahora bien, si en la colección destino se muestra un campo que no existe en la definición del objeto, se producirá un error.

:*'''Ejemplo'''

<blockquote style="border: 1px dashed #2F6FAB; background: #FFFFFF; margin:1em 15ex 5ex 15ex; padding: 1em; text-align:left;">
<code style="background: #FFFFFF">$Mover(Solicitud de beca, [Solicitudes denegadas].[Contenido]);</code>
</blockquote>

===<code>$Sellar</code>===

<blockquote style="border: 2px solid #993365; background: #FFFFFF; margin:1em 1ex 1ex 1ex; padding: 1em; text-align:left">
<code>'''$Sellar'''(Campo: {{T|timbre}}): {{T|lógico}}</code>
</blockquote>

:*'''Descripción'''Permite timbrar un campo timbre con la información del usuario que realiza la tarea.

:*'''Ejemplo'''

<blockquote style="border: 1px dashed #2F6FAB; background: #FFFFFF; margin:1em 15ex 5ex 15ex; padding: 1em; text-align:left;">
<code style="background: #FFFFFF">$Sellar([&Destino]->[Datos generales].[Nº de expediente]);</code>
</blockquote>

[[Categoría:ODL]]
[[Categoría:Funciones]]

Funciones de método

2012-02-13T13:29:21Z

Jrodriguez:

Funciones de librería

2012-02-13T13:26:56Z

Jrodriguez: /* Manejo de matrices */

__NOTOC__
====[[Conversión de tipos]]====
Funciones que transforman el resultado de una expresión a un tipo de dato específico.

<code>[[Conversión de tipos#$Entero|$Entero]] - [[Conversión de tipos#$Fecha|$Fecha]] - [[Conversión de tipos#$Logico|$Logico]] - [[Conversión de tipos#$Real|$Real]] - [[Conversión de tipos#$Texto|$Texto]]</code>

====[[Indicadores de tipo]]====
Funciones que indican el tipo de una expresión. La utilidad de estas funciones radica en devolver el tipo de expresiones que no son evaluadas, como pueden ser aquellas en las que se accede al dominio de algún componente o recurso.

<code>[[Indicadores de tipo#$Coleccion|$Coleccion]] - [[Indicadores de tipo#$Lista|$Lista]] - [[Indicadores de tipo#$Tabla|$Tabla]] - [[Indicadores de tipo#$Vinculo|$Vinculo]]</code>

====[[Tratamiento de textos]]====
Funciones que nos permitirán realizar operaciones con datos de tipo texto.

<code>[[Tratamiento de textos#$CopiarTexto|$CopiarTexto]] - [[Tratamiento de textos#$LongitudTexto|$LongitudTexto]] - [[Tratamiento de textos#$Texto|$Texto]]</code>

====[[Tratamiento de números]]====
Compendio de funciones que permiten tratar datos numéricos, tanto enteros como reales. Se podrá obtener la parte decimal o entera de un real, saber si un número es par o impar, etc.

<code>[[Tratamiento de números#$Entero|$Entero]] - [[Tratamiento de números#$EsPar|$EsPar]] - [[Tratamiento de números#$Max|$Max]] - [[Tratamiento de números#$Min|$Min]] - [[Tratamiento de números#$ParteDecimal|$ParteDecimal]] - [[Tratamiento de números#$ParteEntera|$ParteEntera]] - [[Tratamiento de números#$Real|$Real]] - [[Tratamiento de números#$Redondeo|$Redondeo]]</code>

====[[Tratamiento de horas y fechas]]====
Es muy habitual trabajar con fechas a la hora de programar un sistema de información en ODL. Por ello, se han creado numerosas funciones que nos permitirán manejar el tipo de dato "fecha". Por ejemplo, podremos obtener datos concretos como el día, mes o año, comparar dos fechas o calcular una fecha a partir de otra, entre otras.

<code>[[Tratamiento de horas y fechas#$Año|$Año]] - [[Tratamiento de horas y fechas#$CalculaFecha|$CalculaFecha]] - [[Tratamiento de horas y fechas#$Dia|$Dia]] - [[Tratamiento de horas y fechas#$DiferenciaDias|$DiferenciaDias]] - [[Tratamiento de horas y fechas#$DiferenciaFechas|$DiferenciaFechas]] - [[Tratamiento de horas y fechas#$Fecha|$Fecha]] - [[Tratamiento de horas y fechas#$FormatoFecha|$FormatoFecha]] - [[Tratamiento de horas y fechas#$Hoy|$Hoy]] - [[Tratamiento de horas y fechas#$Mes|$Mes]]</code>

====[[Tratamiento de moneda]]====
<code>[[Tratamiento de moneda#$Cifra|$Cifra]]</code> - <code>[[Tratamiento de moneda#$Moneda|$Moneda]]</code>

====[[Manejo de listas de comprobación]]====
Es posible que en el desarrollo de nuestro sistema de información en ODL nos interese realizar ciertas operaciones con las listas de comprobación. Una operación frecuente es invertir la selección de las filas. Accede al siguiente artículo para conocer, por ejemplo, esta función de uso muy común.

<code>[[Manejo de listas de comprobación#$InvertirSeleccion|$InvertirSeleccion]] - [[Manejo de listas de comprobación#$Lista|$Lista]]</code>

====[[Creación de matrices]]====
Crea matrices a partir de otros componentes o recursos de ODL. Además, se podrán crear matrices a partir de los resultados obtenidos en una petición a la base de datos.

<code>[[Creación de matrices#$Matriz(texto)|$Matriz(texto)]] - [[Creación de matrices#$Matriz(componente)|$Matriz(componente)]] - [[Creación de matrices#$Matriz(enumerado,exportación)|$Matriz(enumerado,exportación)]] - [[Creación de matrices#$MatrizSQL|$MatrizSQL]]</code>

====[[Cálculo con matrices]]====
Conjunto de funciones para realizar diversos cálculos sobre matrices. Sumar columnas, calcular medias, buscar un elemento concreto, buscar el valor máximo o mínimo de una columna, etc.

<code>[[Cálculo con matrices#$Elemento|$Elemento]] - [[Cálculo con matrices#$Max|$Max]] - [[Cálculo con matrices#$Media|$Media]] - [[Cálculo con matrices#$Min|$Min]] - [[Cálculo con matrices#$NumeroColumnas|$NumeroColumnas]] - [[Cálculo con matrices#$NumeroFilas|$NumeroFilas]] - [[Cálculo con matrices#$Suma|$Suma]]</code>

====[[Manejo de matrices]]====
En el siguiente artículo se muestran varias funciones que permiten realizar diversas operaciones con matrices. Por ejemplo, filtrar una matriz con un cierto valor, ordenar una matriz, renombrar columnas, etcétera...

<code>[[Manejo de matrices#$AgruparSuma|$AgruparSuma]] - [[Manejo de matrices#$Columnas|$Columnas]] - [[Manejo de matrices#$ConcatenarColumna|$ConcatenarColumna]] - [[Manejo de matrices#$EliminarFilasRepetidas|$EliminarFilasRepetidas]] - [[Manejo de matrices#$Filtrar|$Filtrar]] - [[Manejo de matrices#$MatrizFila|$MatrizFila]] - [[Manejo de matrices#$Ordenar|$Ordenar]] - [[Manejo de matrices#$RenombrarColumnas|$RenombrarColumnas]]</code>

====[[Manejo de colecciones]]====
En este artículo facilitamos las funciones que nos permitirán seleccionar un objeto o varios de ellos de una colección concreta, cumpliendo con una definición determinada.

<code>[[Manejo de colecciones#$SeleccionarObjetoPorDefinicion|$SeleccionarObjetoPorDefinicion]] - [[Manejo de colecciones#$SeleccionarObjetosPorDefinicion|$SeleccionarObjetosPorDefinicion]]</code>

====[[Funciones especiales]]====
Conjunto de funciones que entre sí no tienen mucho en común, o que no actúan sobre un componente o recurso concreto. No por ello carecen de la misma importancia que las demás. Te recomendamos que accedas, quizás la función que buscas se encuentre en este artículo.

<code>[[Funciones especiales#$Crear|$Crear]] - [[Funciones especiales#$Decision|$Decision]] - [[Funciones especiales#$DRC|$DRC]] - [[Funciones especiales#$EsTipo|$EsTipo]] - [[Funciones especiales#$Si|$Si]] - [[Funciones especiales#$VariableCentro|$VariableCentro]]</code>

====[[Ejecución de sentencias SQL]]====
En este artículo se muestran dos funciones que nos permitirán obtener, o bien una matriz con los valores obtenidos de una sentencia SQL, o bien el primer valor encontrado.

<code>[[Ejecución de sentencias SQL#$MatrizSQL|$MatrizSQL]] - [[Ejecución de sentencias SQL#$ValorSQL|$ValorSQL]]</code>

====[[Funciones de método]]====
Aquí se especifican las funciones que se utilizan en el desarrollo de los métodos.

<code>[[Funciones de método#$Crear|$Crear]] - [[Funciones de método#$Ejecutar|$Ejecutar]] - [[Funciones de método#$Firmar|$Firmar]] - [[Funciones de método#$Guardar|$Guardar]] - [[Funciones de método#$Lanzar|$Lanzar]] - [[Funciones de método#$Mover|$Mover]] - [[Funciones de método#$Sellar|$Sellar]]</code>

[[Categoría:ODL]]
[[Categoría:Funciones]]

Manejo de matrices

2012-02-13T13:26:47Z

Jrodriguez:

Manejo de matrices

2012-02-13T12:51:29Z

Jrodriguez:

__NOTOC__
===<code>$Filtrar</code>===
<blockquote style="border: 2px solid #993365; background: #FFFFFF; margin:1em 1ex 1ex 1ex; padding: 1em; text-align:left">
<code>'''$Filtrar'''(M: {{T|matriz}}, Condicion: {{T|texto}}): {{T|matriz}}</code></blockquote>

:*'''Descripción'''Devuelve una matriz que introducimos como parámetro de la función, pero con aquellos elementos que cumplan la condición especificada en el segundo parámetro.

:*'''Ejemplos'''

<blockquote style="border: 1px dashed #2F6FAB; background: #FFFFFF; margin:1em 15ex 5ex 15ex; padding: 1em; text-align:left;">
<code style="background: #FFFFFF">$Filtrar([Municipios], '''"[#Isla]=[Gran Canaria]"''') {{COM|//devuelve una matriz de los municipios de una determinada isla, tras evaluar el campo [Isla]}}</code>
</blockquote>

<blockquote style="border: 1px dashed #2F6FAB; background: #FFFFFF; margin:1em 15ex 5ex 15ex; padding: 1em; text-align:left;">
<code style="background: #FFFFFF">$Filtrar($Matriz[Representantes], '''"([#Tipo] = 'Secundario') y ([#Cargo] ='Directivo')"''')</code>
</blockquote>

===<code>$Ordenar</code>===

<blockquote style="border: 2px solid #993365; background: #FFFFFF; margin:1em 1ex 1ex 1ex; padding: 1em; text-align:left">
<code>'''$Ordenar'''(M: {{T|matriz}}, Columna: {{T|texto}}, Ascendente: {{T|lógico}}): {{T|matriz}}</code></blockquote>

:*'''Descripción'''Devuelve una matriz cuyas filas estarán ordenadas en función de la columna que indiquemos como parámetro. Podrán ordenarse ascendentemente (verdadero) o descendentemente (falso).

:*'''Ejemplo'''

<blockquote style="border: 1px dashed #2F6FAB; background: #FFFFFF; margin:1em 15ex 5ex 15ex; padding: 1em; text-align:left;">
<code style="background: #FFFFFF">$Ordenar([Asignaturas], {{STR|"[#Curso]"}}, verdadero) {{COM|//devuelve una matriz con las
asignaturas ordenadas por curso de forma ascendente}}</code>
</blockquote>

===<code>$EliminarFilasRepetidas</code>===

<blockquote style="border: 2px solid #993365; background: #FFFFFF; margin:1em 1ex 1ex 1ex; padding: 1em; text-align:left">
<code>'''$EliminarFilasRepetidas'''(M: {{T|matriz}}): {{T|matriz}}</code></blockquote>

:*'''Descripción'''Elimina las filas repetidas de una matriz que pasamos a la función como parámetro de entrada.

:*'''Ejemplo'''

<blockquote style="border: 1px dashed #2F6FAB; background: #FFFFFF; margin:1em 15ex 5ex 15ex; padding: 1em; text-align:left;">
<code style="background: #FFFFFF">$EliminarFilasRepetidas($Columnas($Matriz([Islas]),{{STR|"[Provincia]"}}));</code>
</blockquote>

===<code>$MatrizFila</code>===

<blockquote style="border: 2px solid #993365; background: #FFFFFF; margin:1em 1ex 1ex 1ex; padding: 1em; text-align:left">
<code>'''$MatrizFila'''(Expresion: {{T|texto}} {, E: {{T|texto}}}): {{T|matriz}}</code></blockquote>

:*'''Descripción'''Devuelve una matriz de una sola fila, donde los valores son obtenidos de campos definidos. La expresión corresponderá a una asignación con el nombre de la columna y a continuación la expresión de un campo donde obtener el valor. La forma de la expresión es "Nombre_columna = [Campo]"

:*'''Ejemplo'''

<blockquote style="border: 1px dashed #2F6FAB; background: #FFFFFF; margin:1em 15ex 5ex 15ex; padding: 1em; text-align:left;">
<code style="background: #FFFFFF">$MatrizFila('''"[Nombre] = [Denominación]->[Datos del promotor].[Promotor]"''')</code>
</blockquote>

===<code>$RenombrarColumnas</code>===

<blockquote style="border: 2px solid #993365; background: #FFFFFF; margin:1em 1ex 1ex 1ex; padding: 1em; text-align:left">
<code>'''$RenombrarColumnas'''(M: {{T|matriz}}, Actual: {{T|texto}}, Nuevo: {{T|texto}} {, A: {{T|texto}}, N: {{T|texto}}}): {{T|matriz}}</code></blockquote>

:*'''Descripción'''Devuelve una matriz con las columnas «Actual» renombradas por «Nuevo».

:*'''Ejemplo'''

<blockquote style="border: 1px dashed #2F6FAB; background: #FFFFFF; margin:1em 15ex 5ex 15ex; padding: 1em; text-align:left;">
<code style="background: #FFFFFF">$RenombrarColumnas(M, {{STR|"Cod"}}, {{STR|"Código"}}, {{STR|"Den"}}, {{STR|"Denominación"}}) {{COM|//devuelve la matriz donde las columnas: "Cod" y "Den" se han renombrado por "Código" y "Denominación"}}</code>
</blockquote>

===<code>$Columnas</code>===

<blockquote style="border: 2px solid #993365; background: #FFFFFF; margin:1em 1ex 1ex 1ex; padding: 1em; text-align:left">
<code>'''$Columnas'''(M: {{T|matriz}}, Columna: {{T|texto}} {, C: {{T|texto}}}): {{T|matriz}}</code></blockquote>

:*'''Descripción'''Función que devuelve una matriz con las columnas seleccionadas de otra matriz que introducimos como parámetro de entrada.

:*'''Ejemplo'''

<blockquote style="border: 1px dashed #2F6FAB; background: #FFFFFF; margin:1em 15ex 5ex 15ex; padding: 1em; text-align:left;">
<code style="background: #FFFFFF">$Columnas([Municipios], {{STR|"[#Municipio]"}}, {{STR|"[#CodProvincia]"}})</code>
</blockquote>

===<code>$AgruparSuma</code>===

<blockquote style="border: 2px solid #993365; background: #FFFFFF; margin:1em 1ex 1ex 1ex; padding: 1em; text-align:left">
<code>'''$AgruparSuma'''(M: {{T|matriz}}, Suma: {{T|texto}}, Agrupa: {{T|texto}} {, A: {{T|texto}}}): {{T|matriz}}</code></blockquote>

:*'''Descripción'''Devuelve una matriz donde se agruparán las filas cuando exista una coincidencia entre los valores de las columnas «Agrupa» que se especifiquen. Al encontrar una coincidencia se sumarán los valores de las celdas «Suma» de cada coincidencia y el resultado se escribirá en la celda resultante de la columna «Suma». Se creará por tanto, una sola fila, con una columna «Suma» y la fusión de las columnas cuyos valores coincidan. La matriz devuelta sólo constará de las columnas «Agrupa» y la columna «Suma», que ha de ser numérica.

:*'''Ejemplo'''

<blockquote style="border: 1px dashed #2F6FAB; background: #FFFFFF; margin:1em 15ex 5ex 15ex; padding: 1em; text-align:left;">
<code style="background: #FFFFFF">$AgruparSuma(M, {{STR|"Importe"}}, {{STR|"Producto"}}, {{STR|"Categoría"}}) {{COM|//devuelve una matriz con las tres columnas donde siempre que coincida los valores del par «Producto» y «Categoría», los valores de «Importe» se suman}}</code>
</blockquote>

===<code>$ConcatenarColumna</code>===

<blockquote style="border: 2px solid #993365; background: #FFFFFF; margin:1em 1ex 1ex 1ex; padding: 1em; text-align:left">
<code>'''$ConcatenarColumna'''(M: {{T|matriz}}, Columna: {{T|texto}}, SímboloIntermedio: {{T|texto}}, SímboloFinal: {{T|Texto}}: {{T|texto}}</code></blockquote>

:*'''Descripción'''Concatena los valores de todas las celdas de una columna concreta de una matriz. Habrá que especificar como parámetros de entrada la matriz, la columna, el símbolo separador y el símbolo separador de los dos últimos valores de la columna. El valor devuelto será de tipo texto con todos los valores separados por el símbolo separador, salvo los dos últimos valores, que estarán separados por el segundo símbolo separador.

:*'''Ejemplo'''

<blockquote style="border: 1px dashed #2F6FAB; background: #FFFFFF; margin:1em 15ex 5ex 15ex; padding: 1em; text-align:left;">
<code style="background: #FFFFFF">$ConcatenarColumna($Matriz([Continentes]), {{STR|"Nombre_continente"}}, {{STR|","}}, {{STR|"y"}}) {{COM|//devuelve}} {{STR|África, América, Asia, Europa y Oceanía}}</code>
</blockquote>

===<code>$AsignarElemento</code>=== $AsignarElemento(Matriz, Fila, Columna, Valor)

<blockquote style="border: 2px solid #993365; background: #FFFFFF; margin:1em 1ex 1ex 1ex; padding: 1em; text-align:left">
<code>'''$AsignarElemento'''(M: {{T|matriz}}, Fila: {{T|texto}}, Columna: {{T|texto}}, SímboloIntermedio: {{T|texto}}, SímboloFinal: {{T|Texto}}: {{T|texto}}</code></blockquote>

:*'''Descripción'''Concatena los valores de todas las celdas de una columna concreta de una matriz. Habrá que especificar como parámetros de entrada la matriz, la columna, el símbolo separador y el símbolo separador de los dos últimos valores de la columna. El valor devuelto será de tipo texto con todos los valores separados por el símbolo separador, salvo los dos últimos valores, que estarán separados por el segundo símbolo separador.

:*'''Ejemplo'''

<blockquote style="border: 1px dashed #2F6FAB; background: #FFFFFF; margin:1em 15ex 5ex 15ex; padding: 1em; text-align:left;">
<code style="background: #FFFFFF">$ConcatenarColumna($Matriz([Continentes]), {{STR|"Nombre_continente"}}, {{STR|","}}, {{STR|"y"}}) {{COM|//devuelve}} {{STR|África, América, Asia, Europa y Oceanía}}</code>
</blockquote>

[[Categoría:ODL]]
[[Categoría:Funciones]]

Manejo de matrices

2012-02-13T12:47:52Z

Jrodriguez:

__NOTOC__
===<code>$Filtrar</code>===
<blockquote style="border: 2px solid #993365; background: #FFFFFF; margin:1em 1ex 1ex 1ex; padding: 1em; text-align:left">
<code>'''$Filtrar'''(M: {{T|matriz}}, Condicion: {{T|texto}}): {{T|matriz}}</code></blockquote>

:*'''Descripción'''Devuelve una matriz que introducimos como parámetro de la función, pero con aquellos elementos que cumplan la condición especificada en el segundo parámetro.

:*'''Ejemplos'''

<blockquote style="border: 1px dashed #2F6FAB; background: #FFFFFF; margin:1em 15ex 5ex 15ex; padding: 1em; text-align:left;">
<code style="background: #FFFFFF">$Filtrar([Municipios], '''"[#Isla]=[Gran Canaria]"''') {{COM|//devuelve una matriz de los municipios de una determinada isla, tras evaluar el campo [Isla]}}</code>
</blockquote>

<blockquote style="border: 1px dashed #2F6FAB; background: #FFFFFF; margin:1em 15ex 5ex 15ex; padding: 1em; text-align:left;">
<code style="background: #FFFFFF">$Filtrar($Matriz[Representantes], '''"([#Tipo] = 'Secundario') y ([#Cargo] ='Directivo')"''')</code>
</blockquote>

===<code>$Ordenar</code>===

<blockquote style="border: 2px solid #993365; background: #FFFFFF; margin:1em 1ex 1ex 1ex; padding: 1em; text-align:left">
<code>'''$Ordenar'''(M: {{T|matriz}}, Columna: {{T|texto}}, Ascendente: {{T|lógico}}): {{T|matriz}}</code></blockquote>

:*'''Descripción'''Devuelve una matriz cuyas filas estarán ordenadas en función de la columna que indiquemos como parámetro. Podrán ordenarse ascendentemente (verdadero) o descendentemente (falso).

:*'''Ejemplo'''

<blockquote style="border: 1px dashed #2F6FAB; background: #FFFFFF; margin:1em 15ex 5ex 15ex; padding: 1em; text-align:left;">
<code style="background: #FFFFFF">$Ordenar([Asignaturas], {{STR|"[#Curso]"}}, verdadero) {{COM|//devuelve una matriz con las
asignaturas ordenadas por curso de forma ascendente}}</code>
</blockquote>

===<code>$EliminarFilasRepetidas</code>===

<blockquote style="border: 2px solid #993365; background: #FFFFFF; margin:1em 1ex 1ex 1ex; padding: 1em; text-align:left">
<code>'''$EliminarFilasRepetidas'''(M: {{T|matriz}}): {{T|matriz}}</code></blockquote>

:*'''Descripción'''Elimina las filas repetidas de una matriz que pasamos a la función como parámetro de entrada.

:*'''Ejemplo'''

<blockquote style="border: 1px dashed #2F6FAB; background: #FFFFFF; margin:1em 15ex 5ex 15ex; padding: 1em; text-align:left;">
<code style="background: #FFFFFF">$EliminarFilasRepetidas($Columnas($Matriz([Islas]),{{STR|"[Provincia]"}}));</code>
</blockquote>

===<code>$MatrizFila</code>===

<blockquote style="border: 2px solid #993365; background: #FFFFFF; margin:1em 1ex 1ex 1ex; padding: 1em; text-align:left">
<code>'''$MatrizFila'''(Expresion: {{T|texto}} {, E: {{T|texto}}}): {{T|matriz}}</code></blockquote>

:*'''Descripción'''Devuelve una matriz de una sola fila, donde los valores son obtenidos de campos definidos. La expresión corresponderá a una asignación con el nombre de la columna y a continuación la expresión de un campo donde obtener el valor. La forma de la expresión es "Nombre_columna = [Campo]"

:*'''Ejemplo'''

<blockquote style="border: 1px dashed #2F6FAB; background: #FFFFFF; margin:1em 15ex 5ex 15ex; padding: 1em; text-align:left;">
<code style="background: #FFFFFF">$MatrizFila('''"[Nombre] = [Denominación]->[Datos del promotor].[Promotor]"''')</code>
</blockquote>

===<code>$RenombrarColumnas</code>===

<blockquote style="border: 2px solid #993365; background: #FFFFFF; margin:1em 1ex 1ex 1ex; padding: 1em; text-align:left">
<code>'''$RenombrarColumnas'''(M: {{T|matriz}}, Actual: {{T|texto}}, Nuevo: {{T|texto}} {, A: {{T|texto}}, N: {{T|texto}}}): {{T|matriz}}</code></blockquote>

:*'''Descripción'''Devuelve una matriz con las columnas «Actual» renombradas por «Nuevo».

:*'''Ejemplo'''

<blockquote style="border: 1px dashed #2F6FAB; background: #FFFFFF; margin:1em 15ex 5ex 15ex; padding: 1em; text-align:left;">
<code style="background: #FFFFFF">$RenombrarColumnas(M, {{STR|"Cod"}}, {{STR|"Código"}}, {{STR|"Den"}}, {{STR|"Denominación"}}) {{COM|//devuelve la matriz donde las columnas: "Cod" y "Den" se han renombrado por "Código" y "Denominación"}}</code>
</blockquote>

===<code>$Columnas</code>===

<blockquote style="border: 2px solid #993365; background: #FFFFFF; margin:1em 1ex 1ex 1ex; padding: 1em; text-align:left">
<code>'''$Columnas'''(M: {{T|matriz}}, Columna: {{T|texto}} {, C: {{T|texto}}}): {{T|matriz}}</code></blockquote>

:*'''Descripción'''Función que devuelve una matriz con las columnas seleccionadas de otra matriz que introducimos como parámetro de entrada.

:*'''Ejemplo'''

<blockquote style="border: 1px dashed #2F6FAB; background: #FFFFFF; margin:1em 15ex 5ex 15ex; padding: 1em; text-align:left;">
<code style="background: #FFFFFF">$Columnas([Municipios], {{STR|"[#Municipio]"}}, {{STR|"[#CodProvincia]"}})</code>
</blockquote>

===<code>$AgruparSuma</code>===

<blockquote style="border: 2px solid #993365; background: #FFFFFF; margin:1em 1ex 1ex 1ex; padding: 1em; text-align:left">
<code>'''$AgruparSuma'''(M: {{T|matriz}}, Suma: {{T|texto}}, Agrupa: {{T|texto}} {, A: {{T|texto}}}): {{T|matriz}}</code></blockquote>

:*'''Descripción'''Devuelve una matriz donde se agruparán las filas cuando exista una coincidencia entre los valores de las columnas «Agrupa» que se especifiquen. Al encontrar una coincidencia se sumarán los valores de las celdas «Suma» de cada coincidencia y el resultado se escribirá en la celda resultante de la columna «Suma». Se creará por tanto, una sola fila, con una columna «Suma» y la fusión de las columnas cuyos valores coincidan. La matriz devuelta sólo constará de las columnas «Agrupa» y la columna «Suma», que ha de ser numérica.

:*'''Ejemplo'''

<blockquote style="border: 1px dashed #2F6FAB; background: #FFFFFF; margin:1em 15ex 5ex 15ex; padding: 1em; text-align:left;">
<code style="background: #FFFFFF">$AgruparSuma(M, {{STR|"Importe"}}, {{STR|"Producto"}}, {{STR|"Categoría"}}) {{COM|//devuelve una matriz con las tres columnas donde siempre que coincida los valores del par «Producto» y «Categoría», los valores de «Importe» se suman}}</code>
</blockquote>

===<code>$ConcatenarColumna</code>===

<blockquote style="border: 2px solid #993365; background: #FFFFFF; margin:1em 1ex 1ex 1ex; padding: 1em; text-align:left">
<code>'''$ConcatenarColumna'''(M: {{T|matriz}}, Columna: {{T|texto}}, SímboloIntermedio: {{T|texto}}, SímboloFinal: {{T|Texto}}: {{T|texto}}</code></blockquote>

:*'''Descripción'''Concatena los valores de todas las celdas de una columna concreta de una matriz. Habrá que especificar como parámetros de entrada la matriz, la columna, el símbolo separador y el símbolo separador de los dos últimos valores de la columna. El valor devuelto será de tipo texto con todos los valores separados por el símbolo separador, salvo los dos últimos valores, que estarán separados por el segundo símbolo separador.

:*'''Ejemplo'''

<blockquote style="border: 1px dashed #2F6FAB; background: #FFFFFF; margin:1em 15ex 5ex 15ex; padding: 1em; text-align:left;">
<code style="background: #FFFFFF">$ConcatenarColumna($Matriz([Continentes]), {{STR|"Nombre_continente"}}, {{STR|","}}, {{STR|"y"}}) {{COM|//devuelve}} {{STR|África, América, Asia, Europa y Oceanía}}</code>
</blockquote>

===<code>$AsignarElemento</code>===

<blockquote style="border: 2px solid #993365; background: #FFFFFF; margin:1em 1ex 1ex 1ex; padding: 1em; text-align:left">
<code>'''$AsignarElemento'''(M: {{T|matriz}}, Columna: {{T|texto}}, SímboloIntermedio: {{T|texto}}, SímboloFinal: {{T|Texto}}: {{T|texto}}</code></blockquote>

:*'''Descripción'''Concatena los valores de todas las celdas de una columna concreta de una matriz. Habrá que especificar como parámetros de entrada la matriz, la columna, el símbolo separador y el símbolo separador de los dos últimos valores de la columna. El valor devuelto será de tipo texto con todos los valores separados por el símbolo separador, salvo los dos últimos valores, que estarán separados por el segundo símbolo separador.

:*'''Ejemplo'''

<blockquote style="border: 1px dashed #2F6FAB; background: #FFFFFF; margin:1em 15ex 5ex 15ex; padding: 1em; text-align:left;">
<code style="background: #FFFFFF">$ConcatenarColumna($Matriz([Continentes]), {{STR|"Nombre_continente"}}, {{STR|","}}, {{STR|"y"}}) {{COM|//devuelve}} {{STR|África, América, Asia, Europa y Oceanía}}</code>
</blockquote>

[[Categoría:ODL]]
[[Categoría:Funciones]]

Funciones de librería

2012-02-13T12:47:35Z

Jrodriguez: /* Manejo de matrices */

Funciones de librería

2012-02-13T12:44:29Z

Jrodriguez: /* Manejo de matrices */

__NOTOC__
====[[Conversión de tipos]]====
Funciones que transforman el resultado de una expresión a un tipo de dato específico.

<code>[[Conversión de tipos#$Entero|$Entero]] - [[Conversión de tipos#$Fecha|$Fecha]] - [[Conversión de tipos#$Logico|$Logico]] - [[Conversión de tipos#$Real|$Real]] - [[Conversión de tipos#$Texto|$Texto]]</code>

====[[Indicadores de tipo]]====
Funciones que indican el tipo de una expresión. La utilidad de estas funciones radica en devolver el tipo de expresiones que no son evaluadas, como pueden ser aquellas en las que se accede al dominio de algún componente o recurso.

<code>[[Indicadores de tipo#$Coleccion|$Coleccion]] - [[Indicadores de tipo#$Lista|$Lista]] - [[Indicadores de tipo#$Tabla|$Tabla]] - [[Indicadores de tipo#$Vinculo|$Vinculo]]</code>

====[[Tratamiento de textos]]====
Funciones que nos permitirán realizar operaciones con datos de tipo texto.

<code>[[Tratamiento de textos#$CopiarTexto|$CopiarTexto]] - [[Tratamiento de textos#$LongitudTexto|$LongitudTexto]] - [[Tratamiento de textos#$Texto|$Texto]]</code>

====[[Tratamiento de números]]====
Compendio de funciones que permiten tratar datos numéricos, tanto enteros como reales. Se podrá obtener la parte decimal o entera de un real, saber si un número es par o impar, etc.

<code>[[Tratamiento de números#$Entero|$Entero]] - [[Tratamiento de números#$EsPar|$EsPar]] - [[Tratamiento de números#$Max|$Max]] - [[Tratamiento de números#$Min|$Min]] - [[Tratamiento de números#$ParteDecimal|$ParteDecimal]] - [[Tratamiento de números#$ParteEntera|$ParteEntera]] - [[Tratamiento de números#$Real|$Real]] - [[Tratamiento de números#$Redondeo|$Redondeo]]</code>

====[[Tratamiento de horas y fechas]]====
Es muy habitual trabajar con fechas a la hora de programar un sistema de información en ODL. Por ello, se han creado numerosas funciones que nos permitirán manejar el tipo de dato "fecha". Por ejemplo, podremos obtener datos concretos como el día, mes o año, comparar dos fechas o calcular una fecha a partir de otra, entre otras.

<code>[[Tratamiento de horas y fechas#$Año|$Año]] - [[Tratamiento de horas y fechas#$CalculaFecha|$CalculaFecha]] - [[Tratamiento de horas y fechas#$Dia|$Dia]] - [[Tratamiento de horas y fechas#$DiferenciaDias|$DiferenciaDias]] - [[Tratamiento de horas y fechas#$DiferenciaFechas|$DiferenciaFechas]] - [[Tratamiento de horas y fechas#$Fecha|$Fecha]] - [[Tratamiento de horas y fechas#$FormatoFecha|$FormatoFecha]] - [[Tratamiento de horas y fechas#$Hoy|$Hoy]] - [[Tratamiento de horas y fechas#$Mes|$Mes]]</code>

====[[Tratamiento de moneda]]====
<code>[[Tratamiento de moneda#$Cifra|$Cifra]]</code> - <code>[[Tratamiento de moneda#$Moneda|$Moneda]]</code>

====[[Manejo de listas de comprobación]]====
Es posible que en el desarrollo de nuestro sistema de información en ODL nos interese realizar ciertas operaciones con las listas de comprobación. Una operación frecuente es invertir la selección de las filas. Accede al siguiente artículo para conocer, por ejemplo, esta función de uso muy común.

<code>[[Manejo de listas de comprobación#$InvertirSeleccion|$InvertirSeleccion]] - [[Manejo de listas de comprobación#$Lista|$Lista]]</code>

====[[Creación de matrices]]====
Crea matrices a partir de otros componentes o recursos de ODL. Además, se podrán crear matrices a partir de los resultados obtenidos en una petición a la base de datos.

<code>[[Creación de matrices#$Matriz(texto)|$Matriz(texto)]] - [[Creación de matrices#$Matriz(componente)|$Matriz(componente)]] - [[Creación de matrices#$Matriz(enumerado,exportación)|$Matriz(enumerado,exportación)]] - [[Creación de matrices#$MatrizSQL|$MatrizSQL]]</code>

====[[Cálculo con matrices]]====
Conjunto de funciones para realizar diversos cálculos sobre matrices. Sumar columnas, calcular medias, buscar un elemento concreto, buscar el valor máximo o mínimo de una columna, etc.

<code>[[Cálculo con matrices#$Elemento|$Elemento]] - [[Cálculo con matrices#$Max|$Max]] - [[Cálculo con matrices#$Media|$Media]] - [[Cálculo con matrices#$Min|$Min]] - [[Cálculo con matrices#$NumeroColumnas|$NumeroColumnas]] - [[Cálculo con matrices#$NumeroFilas|$NumeroFilas]] - [[Cálculo con matrices#$Suma|$Suma]]</code>

====[[Manejo de matrices]]====
En el siguiente artículo se muestran varias funciones que permiten realizar diversas operaciones con matrices. Por ejemplo, filtrar una matriz con un cierto valor, ordenar una matriz, renombrar columnas, etcétera...

<code>[[Manejo de matrices#$AgruparSuma|$AgruparSuma]] - [[Manejo de matrices#$Columnas|$Columnas]] - [[Manejo de matrices#$ConcatenarColumna|$ConcatenarColumna]] - [[Manejo de matrices#$EliminarFilasRepetidas|$EliminarFilasRepetidas]] - [[Manejo de matrices#$Filtrar|$Filtrar]] - [[Manejo de matrices#$MatrizFila|$MatrizFila]] - [[Manejo de matrices#$Ordenar|$Ordenar]] - [[Manejo de matrices#$RenombrarColumnas|$RenombrarColumnas]] - [[Manejo de matrices#$Ordenar|$AsignarElemento]]</code>

====[[Manejo de colecciones]]====
En este artículo facilitamos las funciones que nos permitirán seleccionar un objeto o varios de ellos de una colección concreta, cumpliendo con una definición determinada.

<code>[[Manejo de colecciones#$SeleccionarObjetoPorDefinicion|$SeleccionarObjetoPorDefinicion]] - [[Manejo de colecciones#$SeleccionarObjetosPorDefinicion|$SeleccionarObjetosPorDefinicion]]</code>

====[[Funciones especiales]]====
Conjunto de funciones que entre sí no tienen mucho en común, o que no actúan sobre un componente o recurso concreto. No por ello carecen de la misma importancia que las demás. Te recomendamos que accedas, quizás la función que buscas se encuentre en este artículo.

<code>[[Funciones especiales#$Crear|$Crear]] - [[Funciones especiales#$Decision|$Decision]] - [[Funciones especiales#$DRC|$DRC]] - [[Funciones especiales#$EsTipo|$EsTipo]] - [[Funciones especiales#$Si|$Si]] - [[Funciones especiales#$VariableCentro|$VariableCentro]]</code>

====[[Ejecución de sentencias SQL]]====
En este artículo se muestran dos funciones que nos permitirán obtener, o bien una matriz con los valores obtenidos de una sentencia SQL, o bien el primer valor encontrado.

<code>[[Ejecución de sentencias SQL#$MatrizSQL|$MatrizSQL]] - [[Ejecución de sentencias SQL#$ValorSQL|$ValorSQL]]</code>

====[[Funciones de método]]====
Aquí se especifican las funciones que se utilizan en el desarrollo de los métodos.

<code>[[Funciones de método#$Crear|$Crear]] - [[Funciones de método#$Ejecutar|$Ejecutar]] - [[Funciones de método#$Firmar|$Firmar]] - [[Funciones de método#$Guardar|$Guardar]] - [[Funciones de método#$Lanzar|$Lanzar]] - [[Funciones de método#$Mover|$Mover]] - [[Funciones de método#$Sellar|$Sellar]]</code>

[[Categoría:ODL]]
[[Categoría:Funciones]]