Ejecutar SQL

Conexión a la base de datos

• Configuración de conexión a bases de datos: Inicia el asistente de configuración de bases de datos, donde puede conectarse a la base de datos relacional que quiere que utilice la acción. Para obtener más información sobre cómo utilizar el asistente de configuración de base de datos, consulte Diálogo de configuración de la base de datos.

• Tipo de base de datos: Muestra el tipo de base de datos después de completar el proceso de configuración de conexión a la base de datos.

• Ubicación: Muestra la ubicación del archivo de la base de datos después de completar el proceso de configuración de la conexión a la base de datos.

Origen de comandos SQL

• Origen: Especifica si el origen en la que quiera realizar la acción es una plantilla incrustada, una variable o un archivo externo.

  • Plantillas incrustadas:

    • Valor: Utilice el cuadro de entrada para indicar la plantilla que quiera que utilice la acción. Alternativamente, puede añadir una variable para especificar la plantilla o añadir un carácter especial al valor que haya introducido.

    • Importar: Abre el cuadro de diálogo Abrir archivo para que pueda navegar y seleccionar un archivo que contenga el archivo de comandos que quiere. El contenido del archivo se importa al cuadro de entrada Valor.

    • Exportar: Abre el cuadro de diálogo Guardar archivo para que pueda guardar el contenido del cuadro de entrada Valor como un archivo externo. Puede guardar el valor como un nuevo archivo, o sustituir el contenido de un archivo existente.

    • Editar valor incrustado : Abre el cuadro de diálogo Valor para donde puede editar el valor del origen incrustado.

  • Variable:

    • Variable: Escriba la variable que quiera utilizar como origen. Alternativamente, haga clic en para seleccionar una variable utilizada recientemente, o haga clic en Más variables para abrir el cuadro de diálogo Insertar variable.

  • Archivo externo:

    • Ubicación: Especifica el sistema de archivos donde se encuentra la carpeta de origen. Los sistemas o ubicaciones de archivos pueden incluir sistemas de archivos o recursos de red, Librarian, o una ubicación de almacenamiento en la nube compatible. Para obtener más información sobre las ubicaciones de almacenamiento en la nube compatibles, consulte la Cloud Storage Page de Administration Console.

    • Nombre de archivo: Especifica la ruta del archivo. Puede escribir la ubicación de la carpeta o el nombre del archivo, o hacer clic en Examinar para localizar y seleccionar el archivo que quiera. Alternativamente, puede añadir una variable para especificar el archivo o añadir un carácter especial al valor que haya introducido.

    • Codificación de archivos: Especifica la codificación que utiliza por un archivo de origen.

Salida

• Guardar registro establecido en variable: Especifica la variable en la que quiera guardar el conjunto de registros de salida si el resultado devuelve cualquier registro. Introduzca la variable que desee. Alternativamente, puede añadir una variable.

Acción

• Nombre: Especifica el nombre de la acción. Puede sustituir el nombre predeterminado escribiendo un nuevo nombre en este campo.

• Descripción: Especifica una descripción para la acción.

• Ejecutar acción: Especifica la frecuencia con la que quiere que la acción se ejecute.

  • Siempre: Especifica que la acción se ejecuta la acción cada vez que ocurre el evento.

  • Nunca: Especifica que la acción no se ejecuta cuando ocurre el evento.

  • Condicionalmente, en base a una variable: Especifica que la acción se ejecuta solo cuando una variable seleccionada cumple una condición específica. Utilice esta opción en situaciones en las que solo haya una condición que determine si la acción se ejecutará o no. Después de seleccionar esta opción, puede crear la instrucción condicional en el cuadro de entrada.

    Controles del cuadro de entrada

    • Variable: Especifica la variable que quiera utilizar como instrucción condicional. Introduzca la variable en el cuadro de entrada. Haga clic en para ver una lista de variables utilizadas recientemente, o haga clic en Más variables para abrir el cuadro de diálogo Insertar variable.

    • [Operador relacional]: Especifica el operador relacional que se utilizará para la instrucción condicional. Haga clic en el operador existente para que se muestre una lista de operadores adicionales y seleccione el que quiera utilizar. Para obtener más información, consulte Operadores ralacionales. Los operadores disponibles en la lista dependen de si ha seleccionado Texto o Decimal para la opción Tipo.

    • Valor: Especifica los valores que se utilizarán para la instrucción condicional. Para añadir un valor, haga clic en , haga clic en <introducir un valor>, introduzca el valor que desee y, a continuación, pulse Enter. Para eliminar un valor, utilice el botón secundario del ratón para hacer clic en él y, a continuación, haga clic en Eliminar. Algunos operadores, como Is blank y Is not blank, no requieren que se especifique ningún valor. En estas situaciones, el campo Valor no estará disponible.

    • Tipo: Especifica si la declaración condicional evalúa un valor de texto o decimal.

  • Condicionalmente, en base a una expresión: Especifica las condiciones en las que se ejecuta la acción. Utilice esta opción para situaciones que requieran más de una instrucción condicional. Cuando selecciona esta opción, puede crear la expresión condicional en el cuadro de entrada creando las instrucciones condicionales que desee. Cree y edite su expresión condicional en la ficha Vista del árbol. Haga clic en la ficha Vista del texto para ver una vista del texto de solo lectura de la expresión condicional.

    Controles del cuadro de entrada (Ficha Vista del árbol)

    • [Unión condicional]: Especifica la unión condicional para las instrucciones condicionales del grupo. La unión condicional predeterminada es Y.

      Haga clic en la unión condicional existente para que se muestre un menú que le permitirá configurar su expresión condicional de una de las siguientes maneras:

      • And, Or, NotAnd, NotOr: Haga clic en la unión condicional de la lista que quiera utilizar como instrucción condicional. Para obtener más información sobre las uniones condicionales compatibles, consulte Uniones condicionales.

      • Añadir condición: Haga clic para añadir otra instrucción condicional para el grupo actual.

      • Añadir grupo: Haga clic para añadir un subgrupo de instrucciones condicionales para el grupo actual.

      • Eliminar grupo: Haga clic para eliminar el subgrupo. Disponible cuando se abre el menú desde un subgrupo.

      • Eliminarlo todo: Haga clic para eliminar todas las declaraciones condicionales (incluyendo subgrupos). Disponible cuando se abre el menú desde el grupo más alto.

    • : Añade una declaración condicional para el grupo asociado con dicha unión. Visible a la derecha de cada unión condicional de su expresión.

    • :  Elimina la declaración condicional. Visible a la derecha de una expresión condicional existente cuando se señala la expresión.

    • Variable: Especifica la variable que quiera utilizar como instrucción condicional. Introduzca la variable en el cuadro de entrada. Haga clic en para ver una lista de variables utilizadas recientemente, o haga clic en Más variables para abrir el cuadro de diálogo Insertar variable.

    • [Operador relacional]: Especifica el operador relacional que se utilizará para la instrucción condicional. Haga clic en el operador existente para que se muestre una lista de operadores adicionales y seleccione el que quiera utilizar. Para obtener más información, consulte Operadores ralacionales. Los operadores disponibles en la lista dependen de si ha seleccionado Texto o Decimal para la opción Tipo.

    • Valor: Especifica los valores que se utilizarán para la instrucción condicional. Para añadir un valor, haga clic en , haga clic en <introducir un valor>, introduzca el valor que desee y, a continuación, pulse Enter. Para eliminar un valor, utilice el botón secundario del ratón para hacer clic en él y, a continuación, haga clic en Eliminar. Algunos operadores, como Is blank y Is not blank, no requieren que se especifique ningún valor. En estas situaciones, el campo Valor no estará disponible.

    • Tipo: Especifica si la declaración condicional evalúa un valor de texto o decimal.

Gestión de errores y diagnósticos

• Ignorar errores y continuar ejecutando acciones: Especifica que en caso de que la acción falle, las demás acciones siguen ejecutándose. Cuando no se selecciona esta opción y la acción falle, el comportamiento resultante depende de varios factores, como son:

  La acción está dentro de una Acción de grupo

  • Si ha especificado Secuencialmente para la propiedad Ejecutar acciones en la ficha Ejecución de la acción Agrupar, no se ejecutan más acciones dentro de esa Acción de grupo. No afecta a ninguna acción ajena a esta Acción de grupo.

  • Si ha especificado En paralelo para la propiedad Ejecutar acciones en la ficha Ejecución de la acción Agrupar, los errores se ignoran y se ejecutan las demás acciones de esa Acción de grupo. No afecta a ninguna acción ajena a esta Acción de grupo.

  La acción no está dentro de una Acción de grupo

  • Si ha especificado Secuencialmente para la propiedad Ejecutar acciones de la ficha Ejecución, no se ejecutan más acciones del evento.

  • Si ha especificado En paralelo para la propiedad Ejecutar acciones de la ficha Ejecución, los errores se ignoran y se ejecutan las demás acciones del evento.

• Reintentar si falla: Especifica que si la acción falla, BarTender intenta ejecutarla de nuevo.

  • Máximo de reintentos: Especifica la cantidad máxima de veces que BarTender volverá a intentar ejecutar la acción. Disponible cuando se haya seleccionado la opción Reintentar si falla.

  • Reintentar intervalo: Especifica el tiempo que BarTender esperará después de que la acción haya fallado y antes de volver a ejecutarla. Disponible cuando se haya seleccionado la opción Reintentar si falla.