Programación con C/AL para Microsoft Business Solutions Navision

Programación en Lenguaje C/AL para Microsoft Business Solutions Navision Pablo Espada Bueno www.esbupa.com www.programadorautonomo.net Nota: Microsoft, Navision, C/AL, etc… son marcas registradas de Microsoft

Habitualmente me dedico a impartir formación y a labores de desarrollo y consultoría en .NET
También imparto formaciones sobre Desarrollo en Navision
Si desea que colabore con usted impartiéndoles una formación o desarrollando algún proyecto, puede contactarme:
Web
www.programadorautonomo.net
www.esbupa.com
Email
[email_address]
[email_address]
Espero que les guste la presentación
Contacto

Lenguaje C/AL - Indice
Tipos de datos
Variables
Funciones
Operadores
Sentencias
Asignación
Decisión (IF, CASE)
Iteración (FOR, REPEAT, WHILE)
Otras
Comentarios
Tablas
Acceso a objetos
Formularios
Informes
Unidades de código
DataPorts
Funciones comunes
SumIndexFields
Flowfields
Diálogos
Acceso a ficheros
Depurador
Seguimiento de Código
Asistente para código
OCX
BLOB
Formateo estándar

Introducción
Lenguaje 4GL para trabajar en entorno Navision
Especializado en trabajo sobre la BBDD relacional
Integrado en entorno Windows
OCX para acceso a datos de otras aplicaciones
Acceso a ficheros

Tipos de datos
Variables fundamentales: Numéricas
Integer
Números entre -2.147.483.647 y +2.147.483.647.
BigInteger
Número de 64 bits.
Se usa L para indicar que es un entero largo: bi := 3983200032984209L.
Decimal
Números entre -10E63 y +10E63.
18 dígitos significativos.
Char
Un carácter entre 0 y 255, convertible libremente de entero a carácter.
Operable como un integer o como un carácter:
C := 'A';
C := S[2];
C := C + 1;
Option
Número de opción entre -2.147.483.647 y +2.147.483.647 , convertible libremente de entero a opción. Las opciones se declaran simbólicamente con la propiedad OptionString de la variable: OptionString = Oferta,Pedido,Factura,Abono

Tipos de datos (II)
Variables fundamentales: De Cadena
Text
Cadenas de hasta 250 caracteres.
Sus caracteres son indizables:
Nombre[3]
Code
Cadenas de texto de hasta 250 caracteres.
En mayúsculas.
El sistema hace automáticamente la conversión, y quita espacios iniciales y finales. Sus caracteres son indizables:
CodFormasPago[3]

Tipos de datos (III)
Variables fundamentales: Fecha y Hora
Date
Almacena una fecha.
Se inicializa con 0D.
hoy := 220704D;
Time
Almacena una hora
Se inicializa con 0T
hora := 123000T;
DateTime
Almacena una hora UTC. Siempre se mostrará adaptada al horario local
Se inicializa con 0T
fechahora := December 31, 2004, 14:20:59.999.;

Tipos de Datos (y IV)
Variables fundamentales: Booleanas
Boolean
Valores lógicos: TRUE o FALSE

Tipos Complejos
C/AL incluye un conjunto de tipos complejos utilizados en ciertos casos
BLOB
Se utiliza para almacenar valores binarios (imágenes, ficheros, videos, etc..) y se almacena de forma externa al registro de la base de datos. Tamaño máx 2GB
Record
Un record se asocia con un registro de cada tabla.
El acceso a los campos se realiza escribiendo el nombre del registro, un punto y el nombre del campo:
EJ: Customer.”No.”

Tipos Complejos (II)
Form
Representa un Formulario. Cada formulario estará compuesto por un conjunto de controles
Report
Representa un Informe
Codeunit
Contenedores de código, organizado en funciones
File
Tipo Fichero. Permite acceder a un fichero del sistema de ficheros

Tipos Complejos (III)
Dialog
Representa un cuadro de diálogo.
DateFormula
Representa una fórmula para la función CALCDATE
GUID
Identificador Único del sistema. 16 bytes:
12345678-1234-1234-1234-1234567890AB
TableFilter
Permite aplicar un filtro a una tabla. Sólo utilizado para Permisos

Tipos Complejos (IV)
RecordRef
Puntero a un Registro. Se diferencia con el tipo Record en que, a priori, desconocemos la tabla a la que va a apuntar.
El equivalente para campos es el FieldRef
El equivalente para claves es el KeyRef
RecordID
Almacena el ID de la Tabla junto con la Clave Primaria.
InStream y OutStream
Permiten leer y escribir BLOB’s
Variant
Tipo Indefinido necesario para el uso de OCX
Contiene: record, file, action, codeunit, Automation, boolean, option, integer, decimal, char, text, code, date, time, binary, DateFormula, TransactionType, InStream and OutStream.
BigText
Similar al BLOB pero sólo para contenidos de texto. MAX 2GB

Variables
Inicialización
C/AL inicializa las variables por defecto a los siguientes valores:
Boolean: FALSE
Numeric: 0
Strings: ''
Date: 0D
Time: 0T

Variables (II)
Definición
Las variables en C/AL pueden ser :
Locales : Su ámbito es la función donde se definen
Globales : Su ámbito es el objeto donde se definen

Variables (III)
Ejemplo:
Crearemos una nueva CodeUnit
Definiremos un conjunto de variables (locales y globales)
Podemos crear una variable Option y mostrar sus valores así:
MESSAGE('The value of %1 is %2','LoopNo',LoopNo);

Variables (IV)
Arrays y matrices
Se definen con la propiedad Dimensions de la variable
Dimensions=4;3
Se las referencia con corchetes
SaldoCtaBanco[2,2]
los índices tienen rango 1…n
Funciones:
CLEAR (Borra todo el Array)
ARRAYLEN (Devuelve la Longitud del Array)

Variables del Sistema
Variables del sistema (system-defined variables)
C/SIDE las crea y deja disponibles para el programador en ciertos contextos
Rec
Cuando se modifica un registro, Rec contiene el registro en su estado modificado.
xRec
Cuando se modifica un registro, xRec contiene el registro antes de la modificación.
CurrForm
Variable que representa el objeto Form actual.
CurrReport
Variable que representa el objeto Report actual.
RequestOptionsForm
Variable que representa el formulario de diálogo de entrada al objeto Report actual.
CurrFieldNo
El número de campo del campo actual desde el que se llamó al disparador.

Funciones
Definición
La función se define con un nombre, una serie de parámetros opcionales y un valor de retorno opcional. Pueden tener variables locales.
Los parámetros pueden ser por referencia (se modifica su valor, ej: “valor”) o por valor (no se altera el valor, ej: “flag”)
Se pueden llamar desde otros objetos

Operadores
Operador de C/AL Significado
. campo de registro, control de formulario o informe
( ) paréntesis
[ ] indización
:: ámbito
+ suma
- resta
* multiplicación
/ división
DIV división entera
MOD resto
> mayor que
>= mayor o igual que
< menor que
<= menor o igual que
= igual a
<> diferente de
IN pertenencia a un rango (conjunto)
AND Y lógico
OR O lógico
NOT negación lógica
XOR O excluyente lógico
.. Rango

Operadores (II)
1. . campo de un registro
[] indización
() paréntesis
:: ámbito
2. NOT negación lógica
- inversión de signo o signo negativo
+ signo positivo
3. * multiplicación
/ división decimal
DIV división entera
MOD resto
AND Y lógico
XOR O excluyente lógico
4. + suma - resta OR O lógico 5. > mayor que < menor que >= mayor o igual que <= menor o igual que = igual que <> distinto de IN pertenencia a conjunto 6. .. rango Precedencia

Operadores (III)

Ejemplos
Creamos un nuevo formulario tipo Ficha
Añadimos 3 TextBox y un Botón (Ejecutar)
Asociamos los 3 TextBox con 3 variables:
Value1: Integer
Value2: Integer
Result: Boolean
Al pulsar Ejecutar, realizamos las siguientes comparaciónes:
Result := Value1 > Value2;
Result := (Value1 >= Value2) AND (Value1 <= Value2 * 2)

Sentencias - Normas
Notación y reglas
Una sentencia comienza en ; como separador de la anterior.
La parte ELSE de las sentencias IF es parte de la misma sentencia.
[ ] indica opcionalidad en esa parte de la sentencia.
Un bloque de sentencias contiene un conjunto de sentencias entre BEGIN y END;
Begin
<sentencia>
<sentencia>
..
End;
Una <expresion> devuelve un valor.
Una <expr-asignación> asigna el valor resultado de la expresión a una variable.
El nombre de los campos, si contiene espacios o caracteres especiales, se escribe entre “comillas”

Sentencias (I)
Asignación
Operador de asignación
hoy := 220704D;
valor := 4;
Como consecuencia de llamada a función
Valor de retorno de una función
Function Cuadrado (valor : Integer) cuad : Integer
Begin
cuad := valor * valor
End;
valor := Cuadrado(3); // Valor será igual a 9
Paso de parámetro por referencia a una función
Function Cubo (VAR valor : Integer)
Begin
valor := valor * valor * valor
End;
valor := 2;
Cubo(valor); // Valor será igual a 8

Operador de Cadenas
El símbolo ‘+’ se utiliza para concatenar cadenas
¿Qué ocurre si realizamos una asignación de una cadena con el resultado de concatenar otras dos, y dicho resultado es de mayor tamaño que la cadena?
Se produce un error de ejecución
Lo podemos solucionar comprobando primero dicho desbordamiento:
MAXSTRLEN nos devuelve el tamaño máximo de cadena
COPYSTR nos permite copiar n caracteres de una cadena a otra.
Usar F5 (Symbol Menu) para ayudarse

Sentencias (II)
Decisión
IF
Evalúa la condición, si es cierta se ejecuta el bloque de sentencias del IF , en otro caso el de la parte ELSE.
IF <condición> THEN
<bloque de sentencias>
[ ELSE
<bloque de sentencias> ]
Ejemplo
IF (Cantidad = 0) AND ("Cantidad facturada" <> 0) THEN
TESTFIELD("Nº orden mov. producto asoc.")
ELSE BEGIN
IF Cantidad <> "Cantidad facturada" THEN
TESTFIELD("Cantidad facturada",0);
TESTFIELD("Nº orden mov. producto asoc.",0);
END;

Ejemplos
Modificaremos el formulario anterior de la siguiente forma:
Definición Variables Execute OnPush Execute Clear

Ejemplos
Añadir lo necesario para calcular la media de unidades vendidas/compradas
Contadores de veces que se compra/vende
Totales de Ventas/Compras

Ejemplos
Sobre el ejemplo anterior, añadimos la opción una lista de 10 TextBox y un Array de 10 decimales
Debemos hacer que cada vez que pulsemos el botón Ejecutar, el resultado se muestre en una posición distinta del Array

Sentencias (III)
Decisión
CASE
Evalúa la expresión y ejecuta el bloque de sentencias del valor correspondiente. Si no hay un valor igual, ejecuta el bloque de sentencias del ELSE .
CASE <expresión> OF
<valor>: <bloque de sentencias>;
…
<valor>: <bloque de sentencias>
[ ELSE <bloque de sentencias> ]
END;
Ejemplo
CASE "Tipo importe" OF
"Tipo importe"::Saldo: ValorCol := CGCta."Importe pptdo.";
"Tipo importe"::Debe :
BEGIN
ValorCol := CGCta."Debe presupuestado";
Debe := TRUE;
END
ELSE ValorCol := CGCta."Haber presupuestado";
END;

Sentencias (IV)
Iteración
FOR
Repite un conjunto de sentencias hasta que el resultado de la expresión de asignación alcance el valor indicado
FOR <expr-asignación> TO/DOWNTO <valor> DO
< bloque de sentencias >
Ejemplo
FOR j := Tareas DOWNTO 1 DO BEGIN
Inclinacion[j] := Inclinacion[j - 1];
Constante[j] := Constante[j - 1];
MaxValImport[j] := MaxValImport[j - 1];
END;

Sentencias (V)
Iteración
REPEAT .. UNTIL
Repite un conjunto de sentencias hasta que la expresión evalúe a TRUE .
REPEAT
UNTIL <expresión>
Ejemplo
IF CGCta.FIND('-') THEN
REPEAT
Result := Result + CalcCGCta(CGCta,ColumEsqCta);
Num := Num + 1;
UNTIL CGCta.NEXT = 0;

Sentencias (VI)
Iteración
WHILE .. DO
Repite el conjunto de sentencias hasta el siguiente END si la expresión evalúa a TRUE
WHILE <expresión> DO
[ END; ]
Ejemplo
LinComentVenta.SETRANGE("Tipo documento","Tipo documento");
LinComentVenta.SETRANGE("Nº","Nº");
WHILE LinComentVenta.FIND('-') DO BEGIN
LinComentVenta.DELETE;
LinComentVenta."Tipo documento" := CabVta."Tipo documento";
LinComentVenta."Nº" := CabVta."Nº";
LinComentVenta.INSERT;
END;

Sentencias (y VII)
Otras
WITH
Las sentencias dentro del WITH se refieren al registro, formulario, etc.
WITH Clie DO BEGIN
"No." := '1';
Name := 'Pepe';
Address := 'Rue del Percebe, nº 13';
City := 'Niu llor';
END;
EXIT
Salir de un segmento de código o función (se puede retornar el valor)
FUNCTION Absoluto (valor : Integer) ret : Integer
BEGIN
IF (valor < 0) THEN BEGIN
ret := -valor;
EXIT;
END;
EXIT(valor);
END;

Comentarios
// - Una sola línea
// Find next register no.
IF ItemReg.FIND(‘+’) THEN
ItemRegNo := ItemReg.”Nº” + 1
ELSE
ItemRegNo := 1;
{} – Varias líneas
{ Find next
register no. }
IF ItemReg.FIND(‘+’) THEN
ItemRegNo := ItemReg.”Nº” + 1
ELSE
ItemRegNo := 1;

Ejemplos
Modificar el formulario para que se muestren siempre los 10 últimos resultados, mostrando siempre en la primera posición (la superior) el último resultado obtenido

Ejemplos
Añadimos al formulario un botón “Ordenar” y realizaremos una ordenación de los elementos a través del método de la burbuja

Ejemplos Repetimos la ordenación hasta que el array está ordenado

Ejemplos Mejoramos el Algoritmo sabiendo que en cada iteración el último elemento siempre queda “ordenado”

Tablas
Dónde introducir código
Disparadores de tabla:
OnInsert . Se ejecuta al insertar un registro en la tabla.
OnModify . Se ejecuta al modiicar un campo de un registro de la tabla.
OnDelete . Se ejecuta al borrar un registro de la tabla.
OnRename . Se ejecuta al modificar un campo que forma parte de la clave primaria de un registro de la tabla.
Disparadores de campos en la tabla:
OnValidate . Se ejecuta al modificar el valor de un campo.
OnLookup . Se ejecuta al pulsar F6 sobre el campo para buscar un valor.
Funciones definidas en una tabla
Se pueden definir funciones en la tabla y llamarlas desde el propio objeto o desde otros objetos.

Tablas (II)
Para acceder a tablas se definen variables tipo Record
Modificación de campos de la tabla:
Mediante asignación de valores.
Clie : Record (Cliente); // Variable Clie de tipo registro de // tabla cliente
Clie.”Nº” := ‘10’;
Clie.”Nombre” := ‘Pepe’;
Con la sentencia Validate, asigna el valor y ejecuta el disparador OnValidate de cada campo asignado de la tabla Cliente.
Clie : Record (Cliente);
Clie.VALIDATE(“Nº”, ’10’);
Clie.VALIDATE(Nombre, ‘Pepe’);

Tablas (III)
Trabajo con registros de la tabla:
Inicialización. Se establece cada campo del registro a su valor por defecto dependiendo de su tipo.
Clie : Record (Cliente);
Clie.INIT;
Inserción de registros en la tabla. Con la sentencia INSERT y un párámetro que indica si se ejecuta el disparador OnInsert de la tabla o no.
Clie.VALIDATE(“Nº”, ‘10’);
Clie.VALIDATE(Nombre, ‘Pepe’);
…
Clie.INSERT(TRUE);
Modificación de registros de la tabla. Sentencia MODIFY con un parámetro que indica si se ejecuta el disparador OnModify de la tabla.
Clie.VALIDATE(Nombre, ‘Luis’);
Clie.MODIFY(TRUE);

Tablas (IV)
Trabajo con registros de la tabla:
Borrado de registros en la tabla. Con la sentencia DELETE y un párámetro que indica si se ejecuta el disparador OnDelete de la tabla o no.
Clie.DELETE(TRUE);
Modificación de campos de registros de la tabla que forman parte de la clave primaria. Sentencia RENAME con un parámetro que indica si se ejecuta el disparador OnRename de la tabla.
Clie.VALIDATE(“Nº”, ‘21’);
Clie.RENAME(TRUE);

Tablas (V)
Buscar registros en una tabla:
Obtener un registro de una tabla por su clave primaria.
Job.GET(“Job Nº.”);
Job.TESTFIELD(Blocked,FALSE);
Con las sentencias anteriores obtenemos un registro de la tabla Job (sentencia GET) y comprobamos que uno de los campos del registro tenga el valor indicado (TESTFIELD)
Obtener uno o varios registro de una tabla por claves secundarias.
Clie.RESET;
Clie.SETCURRENTKEY(Name,Address,City);
Clie.SETRANGE(Name,’Luis’);
Clie.SETFILTER(City, ‘%1 | %2’, ‘Paris’, ‘Roma’);
Primero actuamos sobre la variable Clie eliminando todos los filtros y rangos anteriores ( RESET ). Activamos una clave por la que vamos a buscar ( SETCURRENTKEY ) para que el establecimiento de rangos y la búsqueda de registro se base en índices para esta clave y sea mucho más efectiva. Se establecen filtros con dos funciones: SETRANGE y SETFILTER , básicamente iguales aunque SETFILTER permite establecer condiciones más complejas. Es recomendable establecer los filtros sobre los campos en el orden en que aparecen en la clave primaria. En este momento Clie contiene todos los registros que cumplen las condiciones indicadas en los filtros.

Tablas (VI)
Buscar registros en una tabla:
Recorrer registros de la tabla
IF Clie.FIND(‘-’) THEN
REPEAT
<tratar registro>
UNTIL Clie.NEXT = 0;
FIND permite obtener un registro dentro del filtro establecido. El parámetro indica:
‘ -’ toma el primer registro del filtro
‘ +’ toma el último registro del filtro
‘ =‘ toma el registro que es igual a los valores de las claves (por defecto)
FIND devuelve un valor Boolean y si no encuentra un registro que cumpla con las condiciones del filtro provoca un error de ejecución. Para evitar este error se puede encerrar en una sentencia IF .
NEXT toma el siguiente registro del filtro y toma un parámetro:
> 0 busca el siguiente registro saltando el número indicado
< 0 busca el registro anterior saltando el número indicado
Por defecto busca el siguiente registro.

Tablas (y VII)
OnLookup :
Buscar valores de campos en otra tabla.
Clie.SETCURRENTKEY("Nº");
Clie.SETFILTER("Nº",'<40000');
ListaClientes.SETTABLEVIEW(Clie);
IF Clie.FIND('-') THEN;
ListaClientes.SETRECORD(Clie);
ListaClientes.LOOKUPMODE(TRUE);
IF ListaClientes.RUNMODAL = ACTION::LookupOK THEN BEGIN
ListaClientes.GETRECORD(Clie);
cliente.validate(Clie."Nº “);
CLEAR(ListaClientes);
END;
Se establecen los filtros adecuados en la variable Clie de tipo Record de Clientes .
ListaClientes es de tipo Form .
SETTABLEVIEW establece la vista del formulario ListaClientes y establecemos el cliente activo mediante SETRECORD .
LOOKUPMODE hace que el formulario sirva para obtener datos.
GETRECORD obtiene el registro marcado.
CLEAR elimina el formulario.

Acceso a Objetos
Form:
Acceso directo:
CGMov.FIND(‘-’);
FORM.RUN (FORM::"Movs. contabilidad", CGMov);
IF FORM.RUNMODAL (216, LinPptoProy)=ACTION::LookupOK THEN BEGIN
"Cód. fase" := LinPptoProy."Cód. fase";
"Cód. subfase" := LinPptoProy."Cód. subfase";
"Cód. tarea" := LinPptoProy."Cód. tarea";
END;
Acceso con variable:
ListCtaCG : Form “Lista de Cuentas”;
ListCtaCG.LOOKUPMODE(TRUE);
IF ListCtaCG. RUNMODAL = ACTION::LookupOK THEN …
FormNavegar : Form “Navegar”;
FormNavegar.DefDoc("Fecha registro","Nº");
FormNavegar. RUN ;

Acceso a Objetos (II)
Report:
Acceso directo:
Clie.SETRECFILTER; // coloca un filtro (en la clave primaria) // para que el Report se ejecute sólo sobre el // Cliente actual
REPORT. RUN (REPORT::"Inf-ejemplo",ReqForm,FALSE,Clie);
REPORT. RUNMODAL (REPORT::"Inf-ejemplo",FALSE,Impresora,Clie);
r : Report “Proveedor - Líneas pedidos”;
CLEAR(r);
Prov.SETRECFILTER;
r.SETTABLEVIEW(Prov);
r. RUNMODAL ;
…
r. RUN ;

Acceso a Objetos (y III)
Codeunit:
Se ejecuta la función RUN de la Codeunit
Acceso directo:
IF CODEUNIT. RUN (22, LinDiaProd) THEN
…
DiaGenTestLin : Codeunit “Dia. Gen-Test línea”;
DiaGenTestLin. RUN (LinDiaGen);
// LinDiaGen puede haber cambiado (VAR)

Formularios
Disparadores de formulario:
OnAfterGetRecord . Se ejecuta al recurperar un registro de la tabla, pero antes de mostrar el registro en el formulario.
Disparadores de controles del formulario.
Botones del formulario:
Command Button
Menu Button: En cada uno de los Menu Items
Funciones definidas en un formulario:
Se pueden definir funciones en el formulario y llamarlas desde el propio objeto o desde otros objetos.
¡¡ En cualquier caso el código debe escribirse en la tabla si es posible !!

Formularios (II)
Después de recuperar un registro de la tabla, pero antes de mostrarlo en el formulario se ejecuta el trigger OnAfterGetRecord.
Ej: Antes de mostrar el registro, aplica un filtro y calcula el valor de un SumIndexField que mostrará en el formulario.

Formularios (y III)
Al pulsar sobre un botón o sobre una opción de menú en un botón desplegable se ejecuta el trigger OnPush .
Ej: Podemos invocar una función en un Codeunit con un parámetro.

Informes
Disparadores del informe:
OnPreReport . Se procesa antes de ejecutar el informe.
Disparadores de cada DataItem:
OnPreDataItem. Se ejecuta antes de que el DataItem se procese.
OnAfterGetRecord. Se ejecuta cada vez que se obtiene un registro.
OnPostDataItem. Se ejecuta después del procesamiento del DataItem.
Request Form del informe.
Funciones definidas en un informe.
Secciones del formulario:
OnPreSection. Se ejecuta antes de que una sección sea procesada.
OnPostSection. Se ejecuta después de que una sección sea procesada.

Informes (II)
Antes de la ejecución de un Report se ejecuta el trigger OnPreReport.
Ej: Podemos utilizarlo para obtener los filtros con los que el Report se ha llamado, y después imprimirlos en una sección Header (FiltClient y FiltMovProducto) .

Informes (III)
Antes de la ejecución de un DataItem se dispara OnPreDataItem.
Ej: Podemos utilizarlo para mantener totales de un campo para una sección FOOTER con la función CREATETOTALS . También se puede establecer un registro por página con la función NEWPAGEPERRECORD , si hemos elegido la opción en el Request Form.
Después de obtener un registro del DataItem se ejecuta OnAfterGetRecord .
Ej: Podemos hacer cálculos para algún valor que se va a imprimir ( Bfº bruto ). También se puede llamar a NEWPAGE desde este disparador para cambiar de página.
Con CurrReport.SKIP podemos saltar la iteración del DataItem.

Informes (y IV)
Antes de mostrar una sección se ejecuta OnPreSection.
Ej: Podemos querer mostrar la sección o no (con la función SHOWOUTPUT ), o realizar los cáculos para un valor a imprimir.

Unidades de Código
Donde introducir código
Función OnRun :
Se crea por defecto con una nueva codeunit.
Es el punto de entrada para su ejecución por defecto .
Puede tener como parámetro una registro.
Funciones de la Codeunit:
Si se crea una función en una Codeunit se puede invocar desde otros objetos:
DiaGenTestLin : Codeunit “Dia. Gen-Test línea”;
DiaGenTestLin. Testear (LinDiaGen);

DataPorts
Disparadores de DataPort
OnPreDataport . Antes de la ejecución del Dataport.
OnPostDataport. Después de la ejecución del Dataport.
Disparadores de DataItem
OnPreDataItem(). Antes de procesar el DataItem.
OnBeforeExportRecord(). Antes de exportar un registro.
OnAfterExportRecord(). Después de exportar un registro.
OnBeforeImportRecord(). Antes de importar un registro.
OnAfterImportRecord(). Después de importar un registro.
OnPostDataItem(). Después de procesar un DataItem.
Request form del Dataport
Funciones del Dataport

DataPorts (II)
Un Dataport puede importar datos y añadirlos a una tabla.
Ej: Añade registros a un diario. Necesita antes de comenzar saber que “Nº línea” tendrá el primer registro de los importados

DataPorts (III)
Antes de procesar un DataItem.
Ej: Una función del Dataport es llamada antes de invocar el Dataport, después se ejecuta el Dataport y se establece un filtro sobre un campo del DataItem. La variable FiltroNoCampaña no pierde su valor entre las dos llamadas si no se ejecuta CLEAR .

DataPorts (y IV)
Después de importar el registro, y antes de insertarlo en la tabla.
Ej: Se busca un nuevo número de línea y se rellenan los campo de descripción.

Funciones Comunes
Otras funciones comunmente usadas:
RESET
Elimina filtros y selección de claves en una variable Record
DesdeLMComp.RESET;
DesdeLMComp.SETRANGE("Nº L.M.","Nº producto");
DesdeLMComp.SETRANGE(Tipo,DesdeLMComp.Tipo::Producto);
DesdeLMComp.FIND('-');
NoSigLin := "Nº línea“
COUNT
Cuenta el número de registros.
DesdeLMComp.SETRANGE("Nº L.M.","Nº producto");
DesdeLMComp.SETRANGE(Tipo,DesdeLMComp.Tipo::Producto);
NoCompoLM := DesdeLMComp.COUNT;

Funciones Comunes (II)
COPY
Copia una variable Record en otra de la misma tabla, incluyendo filtros y claves activas.
NuevoClie := COPY(Clie);
TRANSFERFIELDS
Copia el contenido de los campos de una variable Record a otra que no tiene que ser de la misma tabla. Tiene en cuenta para ello el número de campo.Los campos que no tengan correspondencia de número se establecen a sus valores por defecto.
RegHasta := TRANSFERFIELDS (RegDesde);

Funciones Comunes (III)
EVALUATE
Convertir un valor de un tipo a otro.
Valor := '010196'; // Tipo cadena
Ok := EVALUATE(VarInteger, Valor); // Entero = 10196
Ok := EVALUATE(VarDate, Valor); // Fecha = 010196D
FORMAT
Convertir un valor en una cadena de texto
MESSAGE('Today is %1', FORMAT(TODAY ));

Funciones Comunes (IV)
DELETEALL
Borrar una serie de registros de una tabla
LinExtCtaBanco.SETRANGE("Nº banco","Nº banco");
LinExtCtaBanco.SETRANGE("Nº extracto","Nº extracto");
LinExtCtaBanco.DELETEALL;
MODIFYALL
Modificar una serie de registros de una tabla
CGMov.RESET;
CGMov.SETCURRENTKEY("Nº cuenta");
CGMov.SETRANGE("Nº cuenta",CGCta."Nº");
CGMov.MODIFYALL("Nº cuenta",'');

Funciones Comunes (V)
COPYFILTER[S]
Copia los filtros de una variable a otra de tipo Record de la misma tabla (COPYFILTER sólo copia los filtros de un campo)
Clie1.SETFILTER("No.", '<1000');
Clie1.SETRANGE(Group, 1);
Clie2.COPYFILTERS(Clie1);
TESTFIELD
Comprueba que un campo contenga un valor dado. Si se omite el segundo parámetro se comprueba que contenga un valor distinto de 0 o blanco. Si esto no se cumple muestra un mensaje de ERROR.
Clie.TESTFIELD(Bloqueado, FALSE);
Clie.TESTFIELD(“Nº”);

Funciones Comunes (VI)
LOCKTABLE
Bloquea una tabla para procesos transaccionales
FIELDNAME
Obtiene el nombre de un campo

SumIndexFields
[Ok :=] Record. CALCSUMS (Campo1 [, Campo2] ,...)
Devuelve la suma para uno (o varios) SumIndexField.
Debe estar activa una clave para la que se haya definido el campo.
No debe haber filtros en campos fuera de la clave.
Si no se cumplen las condiciones anteriores, se devuelve FALSE (o se lanza un mensaje de error).
MovCli.SETCURRENTKEY("Nº cliente","Fecha registro");
MovCli.SETRANGE("Nº cliente", 'AAA 1050');
MovCli.SETRANGE("Fecha registro", 010199D, 123102D);
MovCli.CALCSUMS(Importe);

FlowFields
[Ok :=] Record. CALCFIELDS (Campo1 [, Campo2] ,...)
Los campos de una tabla que son FlowFields se deben recalcular al aplicar filtros.
Cliente.SETRANGE("Filtro fechas",010199D,123102D);
Cliente.CALCFIELDS(Saldo,"Saldo periodo");

Diálogos
Mensajes:
Mensaje asíncrono
MESSAGE
MESSAGE('Mensaje asíncrono informativo');
ERROR. Provoca Rollback.
ERROR('ERROR: Esto ejecuta RollBack');
. FIELDERROR. Muestra el Campo Erroneo
Mensaje + Ok/Cancel
CONFIRM
IF CONFIRM ('Desea continuar') THEN
<Código para SI>
ELSE
<Código para NO>

Diálogos (II)
Mensajes:
Menú de opciones
STRMENU
CASE STRMENU('&Insertar,&Modificar,&Borrar,&Terminar' ,4) OF
1: <Código para Insertar>
2: <Código para Modificar>
3: <Código para Borrar>
4: <Código para Terminar>
ELSE <Código para Cancelar>
END;

Diálogos (y III)
Mensajes:
Objetos de tipo Dialog
Ventana.OPEN('#1############################apos;+
'Cliente #2###############apos;+
'Nuevo Nombre #3###############apos;+
'@4@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@');
Num := 0;
Ventana.UPDATE(1, 'Tabla Cliente');
Clie.RESET;
IF Clie.FIND('-') THEN
REPEAT
Num := Num + 1;
Ventana.UPDATE(2, Clie.Nombre);
Ventana.INPUT(3, NuevoNombre);
Ventana.UPDATE(4, ROUND((Num / Clie.COUNT) * 10000));
Clie.VALIDATE(“Nombre”, NuevoNombre);
UNTIL Clie.NEXT = 0;
Ventana.CLOSE;

Acceso a Ficheros
Escribir en un fichero:
IF NombArch = '' THEN
ERROR('Introduzca el nombre del archivo.');
CLEAR(FicMovCont);
FicMovCont.TEXTMODE := TRUE;
FicMovCont.WRITEMODE := TRUE;
FicMovCont.QUERYREPLACE := TRUE;
FicMovCont.CREATE(NombArch);
FicMovCont.WRITE(
STRSUBSTNO(
'#1#################### #2####### #3####### #4#',
COMPANYNAME, FechInicConsol, FechFinConsol, FORMAT(TransfPorDia,0,2)));
FicMovCont.CLOSE;

Acceso a Ficheros (y II)
Leer de un fichero:
IF NombArch = '' THEN
ERROR('Introduzca el nombre del archivo.');
CLEAR(FicMovCont);
FicMovCont.TEXTMODE := TRUE;
FicMovCont.OPEN(NombArch);
WHILE FicMovCont.POS <> FicMovCont.LEN DO BEGIN
FicMovCont.READ(LinTexto);
CodEmpr.“Nombre" := DELCHR(COPYSTR(LinTexto,1,30),'>');
EVALUATE(FechInicConsol,COPYSTR(LinTexto,32,9));
EVALUATE(FechFinConsol,COPYSTR(LinTexto,42,9));
EVALUATE(TransfPorDia,COPYSTR(LinTexto,52,3));
END;
FicMovCont.CLOSE;

Constantes Globales del Sistema
USERID . Identificador del usuario que inició la sesión
Str := USERID;
COMPANYNAME . Devuelve la empresa actual
Str := COMPANYNAME;
OSVERSION. Devuelve una cadena indicando el sistema operativo actual
Str := OSVERSION;
WORKDATE . Devuelve la fecha de trabajo actual
TFecha := WORKDATE;
TODAY . Devuelve la fecha del sistema operativo
Fecha := TODAY;
TIME . Devuelve la hora del sistema operativo
Hora := TIME;

Funciones de Cadena
STRPOS
Posición de una cadena en otra
COPYSTR
Copia una cadena en otra
STRLEN
Tamaño de una Cadena
PADSTR
Añade caracteres a una Cadena
MAXSTRLEN
Tamaño máximo de una Cadena
LOWERCASE/UPPERCAS
Conversión a Mayúsculas/Minúsculas

Funciones de Cadena (II)
CONVERTSTR
Sustituye un conjunto de caracteres por otro, dentro de una cadena
DELCHR
Borra un conjunto de caracteres dentro de una cadena
INCSTR
Incrementa numéricamente una cadena
SELECTSTR
Devuelve una subcadena, dentro de un conjunto de cadenas separadas por comas
STRCHECKSUM
Calcula un Checksum para una cadena de números

Funciones de Fecha
DATE2DMY
Obtiene Día, Mes o Año de una Fecha
DATE2DWY
Obtiene Día, Semana o Año de una Fecha
CALCDATE
Calcula una Fecha en Base a una Fecha inicial y una DateFormula

Funciones de Fecha (II)
NORMALDATE
Convierte una Fecha a “Normal Date”
CLOSINGDATE
Convierte una Fecha a “Closing Date”

Funciones Matemáticas
ABS
Valor Absoluto
POWER
Potencia
ROUND
Redondeo
RANDOMIZE
Planta una semilla para el generador de números aleatorios
RANDOM
Obtiene un número aleatorio

Funciones de Arrays
ARRAYLEN
Devuelve el número de elementos de un array
COMPRESSARRAY
Elimina elementos blancos de un array de texto
COPYARRAY
Copia elementos de un array a otro

Ejemplos
Modificar el código del ejemplo anterior (Botón Execute) para dividirlo en funciones/procedimientos

Depurador
Se activa en: Tools / Debugger / Active
Breakpoint on Triggers detiene la ejecución en cada disparador o función.
Se pueden establecer puntos de ruptura para detener la ejecución (F9)
Código
Variables
Pila
Otras expresiones
Mensajes de salida

Seguimiento de código
Se activa en : Tools / Debugger / Code Coverage
Seguimiento del código ejecutado entre Start y Stop En Negro las sentencias ejecutadas, en Rojo las no ejecutadas

Asistente para código
Se activa en: View / C/AL Symbol Menu (F5)
Muy útil para no cometer errores sintácticos
Nos muestra las variables y sus campos, además de las sentencias y escribe el código por nosotros

BLOB
Tipo de datos de Microsoft Business Solutions Navision
Capaz de contener gran cantidad de información (ej: imágenes)
Definir una variable de tipo BLOB y Subtipo Bitmap

BLOB (y II)
Control: Picture Box
Source Expression: Producto.Imagen

Formateo estándar
Se recomiendan una serie de reglas al escribir código de forma que se integre en el existente y se pueda leer con facilidad.
Separar con un espacio ambos lados de un operador binario (+ / := etc)
BIEN y := (a + b) / 100;
MAL y := (a+b)/100;
Indentar siempre con dos espacios.
BIEN IF a <> '' THEN
Record.TESTFIELD(b);
Usar paréntesis sí y sólo si hay que modificar la precedencia de operadores.
BIEN IF Registrado AND ("No." <> '') THEN
x := a + b
ELSE
x := b / (a + b);
MAL IF (a > b) THEN
a := 0;

Formateo estándar (II)
No usar paréntesis en llamadas a funciones sin parámetros.
BIEN RegistrarLínea;
MAL RegistrarLínea();
IF y THEN van en la misma línea. ELSE va en línea separada.
BIEN IF x = y THEN
x := x + 1
ELSE
x := -x - 1;

Formateo estándar (III)
Las clásulas que incluyen un EXIT no deben tener parte ELSE .
BIEN IF x <> y THEN
EXIT(FALSE);
x := x * 2;
MAL IF x <> y THEN
EXIT(FALSE)
ELSE
x := x * 2;
Cuando BEGIN sigue a THEN o ELSE , va en su misma línea
BIEN IF x = y THEN BEGIN
x := x * 2;
a := a - 3;
END;
MAL IF x = y THEN
BEGIN
x := x * 2;
a := a - 3;
END;

Formateo estándar (y IV)
Expresar las opciones de campos o variables de forma explícita.
BIEN IF Tipo = Tipo::Oferta THEN
MAL IF Tipo = 0 THEN
REPEAT debe ir solo en su línea y UNTIL debe ir en una línea acompañado sólo de la condición de fin.
BIEN IF x < y THEN BEGIN
REPEAT
x := x + 1;
UNTIL x = y;
b := x;
END;
WHILE y DO van en la misma línea.
BIEN WHILE z < a DO BEGIN
a := a + 1;
b := b - 1;
END;

http://www.slideshare.net	165
http://soy-informatico.blogspot.com	22
http://rubenmejiadice.blogspot.mx	18
http://rubenmejiadice.blogspot.com	17
http://cccjir.blogspot.com	16
http://static.slideshare.net	13
http://micodigonestor.blogspot.com	13
http://soy-informatico.blogspot.com.es	6
http://www.rubenmejiadice.blogspot.mx	5
http://soy-informatico.blogspot.mx	5
http://micodigonestor.blogspot.mx	4
http://javierdotnet.com	4
http://static.slidesharecdn.com	3
http://cccjir.blogspot.com.es	3
http://www.filescon.com	2
http://rubenmejiadice.blogspot.com.es	2
http://www.filestube.com	1
http://webcache.googleusercontent.com	1
http://soy-informatico.blogspot.com.ar	1
http://www.grupovaughan.com	1
http://translate.googleusercontent.com	1
http://www.rubenmejiadice.blogspot.kr	1

Programación con C/AL para Microsoft Business Solutions Navision

by pabloesp

Accessibility

Categories

Upload Details

Usage Rights

22 Embeds 304

Statistics

Programación con C/AL para Microsoft Business Solutions Navision Presentation Transcript