Diálogo 'Configuración del análisis estático' - 'Convenciones de nomenclatura'Permalink

Función: En el cuadro de diálogo se definen los prefijos para los tipos de datos y los ámbitos de las variables, así como los prefijos para los POU y los tipos de datos definidos por el usuario (DUT). El análisis estático comprueba el cumplimiento de las convenciones de nomenclatura. Cuando no se respeta una convención, el análisis estático informa de un mensaje de error en la vista «Messages».

Llame a:

  • Barra de menús: «Proyecto  Configuración del proyecto», «Análisis estático» categoría, «Abrir diálogo de configuración» enlace

  • Barra de menús: «Construir  Análisis estático  Configuración»

Requisito:

  • El paquete CODESYS Static Analysis está instalado.

  • Un proyecto está abierto.

Los mensajes de error se muestran en el siguiente formato: sa_icon_message ‎NC <prefix convention number> :‎‎ <message text>‎. NC son las siglas de "Naming Convention". Por ejemplo, el mensaje de error "sa_icon_message«NC0102: Nombre no válido...»" significa una violación de la convención de nomenclatura 102 para POUs de tipo ‎PROGRAM‎.

Puede utilizar el pragma ‎'naming'‎ para desactivar las convenciones de nomenclatura para identificadores individuales. Los identificadores pueden empezar por cualquier cosa, no necesariamente por el prefijo.

«Filtro»

Campo de entrada para las cadenas que se van a buscar

Tabla con las convenciones de nomenclatura

«Nombres»

Nodos y elementos para los que se puede definir un prefijo.

El número entre paréntesis después de cada elemento (por ejemplo, «PROGRAMA (102)») es el número de la convención de prefijo que se comunica en caso de incumplimiento de una convención de denominación.

«Prefijo»

Campo de entrada del prefijo

  • Se pueden especificar varios prefijos mediante la separación por comas.

    Por ejemplo:

    «Prefijo para POUs», ‎PROGRAM (102)‎: ‎prog, PRG_‎

    «Prefijo para POUs», ‎FUNCTION (103)‎: ‎fun, FUN_‎

  • Las expresiones regulares (RegEx) también son posibles para los prefijos. Para ello, hay que añadir una dirección ‎@‎.

    Por ejemplo:

    El nombre debe comenzar por ‎x‎ y puede contener un carácter del ámbito ‎a-dA-D‎: ‎@x[a-dA-D]‎.

  • Para variables de tipo «Alias» y POUs de tipo «Propiedad», el prefijo puede definirse con el marcador de posición ‎{datatype}‎.

«Prefijos de variables»

Nodo de organización de todas las variables para las que se puede definir un prefijo en función del tipo de datos o del ámbito.

«Prefijos para POU»

Nodo organizativo para todos los tipos de POU y ámbitos de métodos para los que se puede definir un prefijo.

«Prefijos para DUT»

Nodo organizativo de los tipos de datos del DUT (estructura, enumeración, alias o unión) para los que puede definirse un prefijo.

«Prefijos para tipos personalizados»

Nodo de organización para tipos especiales personalizados (en particular, los procedentes de bibliotecas).

Puede ampliar la lista con convenciones: Haga clic en el espacio en blanco situado debajo. En el cuadro de diálogo «Input Assistant», especifique el nombre de un tipo personalizado o seleccione un tipo personalizado.

Para borrar una convención, selecciónela y pulse la tecla [Supr].

Nota: Estas convenciones tienen prioridad sobre los prefijos que se definen con el atributo ‎{attribute 'nameprefix' := '<prefix>'}‎.

Opciones

«El primer carácter después del prefijo debe ser una letra mayúscula»

_cds_icon_option_activated: El análisis estático informa de un error para una variable cuando el primer carácter del nombre de la variable después del prefijo definido no es una letra mayúscula.

«Combinar el prefijo de ámbito con el prefijo de tipo de datos»

_cds_icon_option_activated: Como espacio de nombres, una variable debe tener el prefijo definido seguido del prefijo definido para su tipo de datos.

Por ejemplo: Se definen los siguientes prefijos: ‎g_‎ para «VAR_GLOBAL», y ‎r‎ para el tipo de datos «REAL». El análisis de código informa de errores para las variables REAL globales que no tienen el prefijo ‎g_r‎.

_cds_icon_option_deactivated: Si se especifican convenciones para el espacio de nombres de una variable, se tendrán en cuenta dichas convenciones. En consecuencia, se ignoran las convenciones sobre tipos de datos.

Por ejemplo: Se definen los siguientes prefijos: ‎g_‎ para «VAR_GLOBAL», y ‎r‎ para el tipo de datos «REAL». El análisis del código informa exclusivamente de errores para las variables globales ‎REAL‎ que no tienen el prefijo ‎g_‎.

«Prefijos recursivos para tipos de datos combinables»

_cds_icon_option_activated: Las variables de tipos de datos combinados deben tener prefijos compuestos que sigan las convenciones de nomenclatura definidas.

Por ejemplo:

‎ppiVariable : POINTER TO POINTER TO INT;‎

El prefijo ‎p‎ se definió para variables de tipo de datos ‎POINTER‎, y el prefijo ‎I‎ se definió para el tipo de datos ‎INT‎. El análisis estático informa de errores para todas las variables de tipo ‎POINTER TO POINTER TO INT‎ que no tengan el prefijo ‎ppi‎.

‎refaiVar : REFERENCE TO ARRAY[1..3] OF INT;‎

El prefijo ‎ref‎ se definió para el tipo de datos ‎REFERENCE TO‎, el prefijo ‎a‎ para una matriz, y el prefijo ‎I‎ para el tipo de datos ‎INT‎. El análisis estático informa de errores para todas las variables de tipo ‎REFERENCE TO ARRAY[1..3] OF INT‎ que no tengan el prefijo ‎refai‎.

Ejemplo

La siguiente convención de nomenclatura corresponde en su mayor parte a las recomendaciones descritas en el capítulo "Identificadores".

_san_prefixes_for_variables_types
_san_prefixes_for_variables_scopes
_san_prefixes_for_pous_and_duts

Ejemplo

La convención de nomenclatura (1) hace referencia a la norma POU ‎TON‎. Como resultado, las declaraciones de la biblioteca especial POU se comprueban en busca del prefijo "ton_". Haga clic en el espacio en blanco (2) para insertar más convenciones de nomenclatura.

_san_img_prefixes_for_user_defined_types