En el desarrollo de código VBA para Excel, la declaración de variables es una práctica fundamental, aunque no siempre obligatoria. Una vez que nos decidimos a utilizar una variable en nuestro código VBA de Excel, lo ortodoxo es declararla previamente. La forma por medio de la cual se declara una variable depende de varios factores. Uno de ellos es dónde la vamos a utilizar posteriormente (sólo en la macro actual o en otras macros). De momento nos vamos a referir a variables que se utilizan en una misma macro.
Una declaración adecuada facilita la interpretación de la macro para otros usuarios que puedan necesitar leer el código VBA, e incluso para nosotros mismos en el futuro. Por último, decir que podemos hacer que el editor de VBA nos obligue a declarar las variables para evitar olvidos.
Significado de la Declaración Duplicada y los Conflictos de Nombres en VBA
Si intenta crear o usar un identificador que ya se ha definido con anterioridad, se producirá un conflicto de nombres. En algunos casos, los conflictos de nomenclatura generan errores como el "nombre ambiguo detectado" o la "declaración Duplicate en el ámbito actual".
Entre los errores típicos que generan los conflictos de nombres se encuentran:
- Nombre ambiguo detectado: Este error surge cuando un identificador (como una variable o un procedimiento) es referenciado sin una calificación específica, y su nombre existe en múltiples ámbitos accesibles dentro del proyecto. Por ejemplo, si una variable pública tiene el mismo nombre en dos módulos diferentes y se intenta usar sin especificar el módulo al que pertenece.
- Declaración Duplicate: Se produce cuando se intenta declarar una variable, procedimiento o constante con un nombre que ya ha sido utilizado en el mismo ámbito de declaración. Un ejemplo sería intentar Dim miVariable As Integer y luego Dim miVariable As String en el mismo procedimiento o módulo.
- Identificaciones no declaradas: Aunque no es un conflicto de nombres directo, este error se presenta cuando se utiliza una variable sin haber sido declarada previamente, especialmente si la directiva Option Explicit está activada en el módulo.
- Procedimientos que no se encuentran: Similar a la identificación no declarada, se refiere a la incapacidad de VBA para localizar o acceder a un procedimiento invocado.
El nombre especificado ya se ha usado en este nivel de ámbito. Por ejemplo, dos variables pueden tener el mismo nombre si se definen en distintos procedimientos, pero no si se definen en el mismo procedimiento. Una nueva variable o un nuevo procedimiento tiene el mismo nombre que una variable o un procedimiento existente. Una instrucción Const usa el mismo nombre que una variable o un procedimiento existente.
Lea también: ¿Qué es el Acuse de Recibo de la Declaración?
Resolución de Conflictos de Nombres y Declaraciones Duplicadas
La clave para resolver la mayor parte de los conflictos de nombres reside en entender el concepto de ámbito (scope) y, cuando sea necesario, calificar los identificadores. Visual Basic hace coincidir a cada referencia con un identificador que dispone de la declaración "más próxima" de un identificador coincidente.
Uso de Calificadores para Resolver Ambigüedades
La mayor parte de los conflictos de nombres pueden resolverse si se precede a cada identificador de un calificador consistente en el nombre del módulo y, si resulta necesario, de un nombre de proyecto. Por ejemplo, se puede asignar el mismo nombre a procedimientos ubicados en módulos distintos. Por ello, si lo desea, puede definir un procedimiento llamado MySub en cada uno de los módulos Mod1 y Mod2. Mientras se llame a cada procedimiento desde otros procedimientos ubicados en su propio módulo, no se producirá ningún conflicto.
Tenga en cuenta que una variable de nivel de módulo puede tener el mismo nombre que una variable declarada en un procedimiento, pero cuando quiera hacer referencia a una variable de nivel de módulo en el procedimiento, debe calificarlo con el nombre del módulo. Esto también es cierto si Mod2 está en un proyecto diferente pero al que se hace referencia directamente. Sin embargo, si Mod2 está en un proyecto al que se hace referencia indirectamente, es decir, un proyecto al que hace referencia directamente el proyecto al que hace referencia, las referencias a la variable de Mod2 denominada MyID siempre deben calificarse con el nombre del proyecto.
Un Caso Práctico: Error "Nombre Ambiguo" con Variables Públicas
Consideremos un escenario común que conduce al error "Se ha detectado un nombre ambiguo". Un usuario reportó un problema al usar Módulos en VBA y la declaración de variables públicas. Su configuración incluía un módulo llamado "ModuloImpresion" donde declaraba una variable booleana pública llamada MiFlag al inicio, antes de cualquier función. Con esa variable luego en el código VBA de los reports (son unos cuantos), hacía un chequeo para paginarlos de una forma u otra tal y como necesitaba.
Todo funcionaba bien hasta que creó otro módulo que también necesitaba utilizar la variable MiFlag. En ese momento, comenzó a aparecer el error "Se ha detectado un nombre ambiguo" en cuanto el código llegaba al primer informe que se encontraba con una instrucción que usaba MiFlag.
Lea también: Aprende a declarar el IVA correctamente
Para intentar resolverlo, el usuario probó a consolidar las funciones de ambos módulos en un único módulo. En esta configuración, la declaración Public MiFlag As Boolean se realizó al inicio, seguida de las definiciones de Function ImpresionEspañol() y Function ImpresionIngles() dentro del mismo módulo.
Sin embargo, esto resultó en un nuevo error: "La expresión contiene un nombre ambiguo." La solución, aparentemente sencilla pero fácil de pasar por alto, fue que el usuario se dio cuenta de que no había eliminado completamente el módulo original duplicado; solo lo había quitado de un grupo personalizado. Una vez que el módulo redundante fue eliminado del todo, el código volvió a funcionar sin problemas.
Este ejemplo subraya la importancia de asegurarse de que no existen múltiples declaraciones de la misma variable o procedimiento en ámbitos que puedan generar ambigüedad, especialmente con variables públicas que son accesibles desde múltiples puntos del proyecto.
Lea también: SAT: Anulación y Corrección