Lenguaje AL – Sintaxis para la creación de campos

por | 25 septiembre, 2017

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

Categoría: Sin categoría

Acerca de Laura Nicolàs

Soy Laura Nicolàs, una de las gemelas del Navision. Llevo más de 14 años trabajando con Business Central (antes conocido como Dynamics NAV o Navision). Hago consultoría, análisis, desarrollo, implantación, migraciones, actualizaciones de versión (upgrade), instalación, soporte y formación. La formación es una de mis pasiones, así que estoy siempre grabando cursos que tienes disponibles en ClipDynamics.com +40 cursos y +450 lecciones. Hay cursos para usuarios, para consultores y para programadores.

Un pensamiento en “Lenguaje AL – Sintaxis para la creación de campos

  1. Pingback: Lenguaje AL - Sintaxis para la creación de tablas - CLIP Dynamics

Deja un comentario

Tu dirección de correo electrónico no será publicada. Los campos obligatorios están marcados con *

Este sitio usa Akismet para reducir el spam. Aprende cómo se procesan los datos de tus comentarios.