Especificaci�n de una lista de par�metros para una macro

Para obtener un tratamiento m�s detallado de este tema, consulte Passing a parameter list to a macro en la publicaci�n Macro Programming Guide (destinada principalmente a administradores de sistemas y a creadores de macros).

�Qu� es una lista de par�metros?

Algunas macros permiten que se especifique una lista de par�metros al reproducir la macro. La lista de par�metros puede ser necesaria u opcional.

Una lista de par�metros es un conjunto de valores que indican a la macro c�mo llevar a cabo su tarea. Por ejemplo, se podr�a esperar que en una macro denominada FileDownload se especificara una lista de par�metros con los siguientes valores:

• Un nombre de archivo remoto (el nombre del archivo que debe descargarse del sistema principal remoto); por ejemplo, NewData.123 y
• Un nombre de archivo local (el nombre que debe asignarse a este archivo despu�s de descargarlo); por ejemplo, MyData.123.

�Qu� par�metros deben especificarse?

La lista de par�metros es distinta en cada macro. El administrador del sistema o el autor de la macro deben proporcionarle instrucciones y ejemplos para especificar la lista de par�metros.

Puede consultar el campo Descripci�n de la macro para ver si contiene una descripci�n de una lista de par�metros. Para consultar el campo Descripci�n de la macro, abra la ventana Propiedades de la macro desde una de las siguientes ventanas:

• La ventana Macros disponibles (Propiedades)
• La ventana Reproducir macro (Propiedades)

El formato de una lista de par�metros

Esta secci�n describe brevemente el formato de una lista de par�metros. Para obtener m�s informaci�n, consulte Format of a parameter list en la publicaci�n Macro Programming Guide (principalmente para administradores del sistema y creadores de macros)

El patr�n de una lista de par�metros para una macro es:

Normas de formato:

• Lista de par�metros

  Una lista de par�metros es una serie de parejas de nombre-valor. Puede especificar el n�mero de parejas que desee, siempre y cuando cada pareja haga referencia a una variable real definida en la macro. Utilice un espacio en blanco, una coma o los dos, para separar una pareja de nombre-valor de la siguiente. En el ejemplo anterior, hay dos parejas de nombre-valor:

  • strRemoteFile="NewData.123" es el primer par de nombre-valor.
  • strLocalFile="MyData.123" es el segundo par de nombre-valor.
  Adem�s, en el ejemplo anterior, adem�s del ejemplo anterior, una coma y un espacio (, ) despu�s del primer par de nombre-valor lo separan del segundo.

• Parejas de nombre-valor

  Cada pareja de nombre valor est� formada de:

  • El nombre de una variable que ya est� definida en la macro (como strRemoteFile en la primera pareja de nombre-valor en el ejemplo anterior); seguido de
  • Un signo igual (=); seguido de
  • Un valor inicial para la variable, especificado entre comillas ("NewData.123" en la primera pareja nombre-valor en el ejemplo anterior.)

• Nombre de variable

  Escriba el nombre de variable exactamente tal como aparece escrito en la macro, por ejemplo strRemoteFile. La variable debe ser una variable que pertenece a un tipo de datos est�ndar (entero, doble, serie o booleano). No puede especificar una variable que pertenezca a un tipo importado.

• Signo igual (=)

  Es necesario indicar un signo igual entre el nombre de variable y el valor.

• Valor de variable

  El valor de variable debe especificarse entre comillas (""), por ejemplo "NewData.123". El valor debe ser un valor simple, no una expresi�n.

  Normas para las variables de serie:

  • No especifique la serie entre comillas simples. Incorrecto: "'123 Elm Street'". Correcto: "123 Elm Street".
  • Para especificar una serie vac�a, utilice dos grupos de comillas sin especificar nada entre ellas ("" ).
  • Secuencias de escape:
    • Para especificar una comilla simple (' ), utilice \'. Por ejemplo: "John\'s Business Plan"
    • Para especificar una barra inclinada invertida (\ ), utilice \\. Por ejemplo: "c:\\Documents and Settings"

  Ejemplo con una pareja de nombre-valor de cada tipo de datos est�ndar:
  
  intLineCount="24", dblLength="1441.25", strName="John Smith", boolComplete="true"

Tema relacionado