Lenguaje AL – Sintaxis para la creación de campos

En el anterior artículo vimos cómo crear una nueva tabla en un proyecto de Visual Studio Code para crear extensiones para Dynamics NAV 2018.

En este artículo veremos la sintaxis para crear campos con todos los tipos de datos permitidos en tablas de Navision.

Cómo crear un campo nuevo

Para crear un campo nuevo con la sintaxis básica usaremos el snippet tfield.

Nos tenemos que situar dentro del àrea fields {}, y escribir el texto tfield.

El snippet insertará el siguiente trozo de código:

field(id;MyField;Type) { FieldPropertyName = FieldPropertyValue; }

Por el momento no vamos a asignar propiedades en los campos (lo veremos más adelante), por lo que vamos a borrar esa línea de código y lo vamos a dejar así:

field(id;MyField;Type) {}

En el campo id tenemos que darle un identificar único dentro del objeto.
Para el ejemplo voy a reproducir partes de tablas del estándar.

Voy a empezar con la tabla 17 G/L Entry (movimientos de contabilidad),  y cada vez que aparezca un tipo de datos nuevo, lo voy a crear en mi proyecto VSCode.

En la tabla de mov. de contabilidad, el primer campo con un tipo de datos “nuevo” es el 3 – G/L Account No.

En sintaxis de Visual Studio Code quedaría así:

Campo tipo Code

// Campo 3 de la tabla 17 G/L Entry field(3;"G/L Account No.";Code[20]) {}

• En los campos de tipo Code hay que indicar la longitud del campo.
• La longitud se indica entre corchetes, después del literal Code.
• La longitud permitida es entre 1 y 250 carácteres.
• La mayoría de campos Code del estándard tiene 10 o 20 carácteres.
• Podemos usar el snippet tfieldcode para crearlo.

Campo tipo Date

// Campo 4 de la tabla 17 G/L Entry field(4;"G/L Account No.";Code[20]) {}

• Podemos usar el snippet tfielddate para crearlo.

Campo tipo Option

// Campo 5 de la tabla 17 G/L Entry field(5;"Document Type";Option) {    OptionMembers = " ",Payment,Invoice,"Credit Memo","Finance Charge Memo",Reminder,Refund;  }

• Podemos usar el snippet tfieldoption para crearlo.
• En los campos tipo Option es obligatorio informar de la propiedad OptionMembers (nota: En C/AL esta propiedad se llama OptionString
• Los distintos valores del Option, deben ir separador por comas.
• Si el nombre de una de las opciones contiene espacios en blanco, debemos usar las comillas dobles.
• Para indicar una opción en blanco debemos escribir ” ”  <– Hay un espacio en blanco

Campo tipo Text

// Campo 7 de la tabla 17 G/L Entry field(7;Description;Text[50]){}

• Podemos usar el snippet tfieldtext para crearlo.
• La longitud se indica entre corchetes, después del literal Text.
• La longitud permitida es entre 1 y 250 carácteres.

Campo tipo Decimal

// Campo 17 de la tabla 17 G/L Entry field(17;Amount;Decimal){}

• Podemos usar el snippet tfielddecimal para crearlo.

Campo tipo Boolean

// Campo 29 de la tabla 17 G/L Entry field(29;"System-Created Entry";Boolean){}

• Podemos usar el snippet tfieldboolean para crearlo.

Campo tipo DateTime

// Campo 53 de la tabla 18 Customer field(53;"Last Modified Date Time";Datetime){}

• Podemos usar el snippet tfielddatetime para crearlo.

Campo tipo BLOB

// Campo 89 de la tabla 18 Customer field(89;Picture;Blob){}

• Podemos usar el snippet tfieldblob para crearlo.

Campo tipo DateFormula

// Campo 5790 de la tabla 18 Customer field(89;"Shipping Time";Dateformula){}

• Podemos usar el snippet tfielddateformula para crearlo.

Campo tipo GUID

// Campo 8000 de la tabla 18 Customer field(8000;Id;GUID){}

• Podemos usar el snippet tfieldguid para crearlo.

Hasta aquí un repaso a la sintaxis para la creación de los tipos de campos más habituales.

Por ahora solo hemos definido el campo y su tipo, pero no hemos entrado en cómo le indicamos sus propiedades. Esto lo veremos en el siguiente artículo.

Salut!
Laura Nicolàs