AYUDA EN LÍNEA
 WINDEVWEBDEV Y WINDEV MOBILE

Este contenido se ha traducido automáticamente.  Haga clic aquí  para ver la versión en inglés.
Ayuda / WLanguage / Administrar bases de datos / HFSQL / Tipos de variables HFSQL
  • Propiedades específicas de la descripción de las variables hScheduledTask
  • Cómo manipular los parámetros pasados al Procedure almacenado
  • Funciones que utilizan variables hScheduledTask
  • Compatibilidad
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReportes y ConsultasCódigo de Usuario (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Código Navegador
WINDEV Mobile
AndroidWidget Android iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Otros
Procedimientos almacenados
hScheduledTask (Tipo de Variable)
 
HFSQL ClassicHFSQL Client/ServerDisponible solo con estos tipos de conexión
El tipo hScheduledTask se utiliza para gestionar una tarea HFSQL Client/Server programada mediante la programación. Las características de esta tarea de programación pueden ser definidas y modificadas por varios Propiedades de WLanguage.
Observación: Para obtener más información sobre la declaración de este tipo de variable y el uso de propiedades WLanguage, consulte Declarar una variable.
Ejemplo
MyTask is hScheduledTask
MyTask.Description = "Scheduled backup"
MyTask.Month = "*"
MyTask.DayOfWeek = "*"
MyTask.DayOfMonth = "*"
MyTime is Time
MyTime = EDT_Time
MyTask.Hour = MyTime.Hour
MyTask.Minute = MyTime.Minute
MyTask.NumberExecution = 1
MyTask.Procedure = "HBackup"
Add(MyTask.Parameter, NameCSDatabase + "/LOG_TASKSFIC")
Add(MyTask.Parameter, NameCSDatabase + ".ScheduledBackup")
Add(MyTask.Parameter, True)
Add(MyTask.Parameter, MyTask.Description)
nID is int = HAddTask(CSConnection, MyTask)
Observaciones

Propiedades específicas de la descripción de las variables hScheduledTask

Las siguientes propiedades pueden utilizarse para manipular una variable de tipo hScheduledTask:
Nombre de la propiedadTipo utilizadoEfecto
DayOfMonthCadena de caracteresNúmero del día para el que se debe ejecutar la tarea programada (por ejemplo,"31").. Este número se incluye entre 0 y 31.
Este parámetro también puede corresponder a:
  • una lista de números separados por comas: usado para especificar varios meses.
  • a interval. Por ejemplo, "9-13" (la tarea se programa del 9 al 13 del mes).
  • una estrella ("*" ") para especificar el rango completo.
  • un intervalo regular, por ejemplo "*/2" para iniciar la tarea los días pares del mes.
DayOfMonthOrDayOfWeekbooleanoGestionar la ejecución de una tarea programada especificando el número de día de la semana o el número de día del mes. Ejemplo: ejecución cada lunes 1er día del mes.
Esta propiedad puede corresponder a:
  • True para ejecutar la tarea programada todos los lunes Y el primer día del mes (condiciones acumuladas).
  • False para ejecutar una tarea solo los lunes 1.º (condiciones exclusivas).
DayOfWeekCadena de caracteresNúmero del día para el que se debe ejecutar la tarea programada (por ejemplo,"2").. Este número se incluye entre 1 y 7 (1 = Lunes, 2 = Martes, ....).
Este parámetro también puede corresponder a:
  • una lista de números separados por comas: usado para especificar varios días.
  • a interval. Por ejemplo, "1-3" (la tarea está programada para el lunes, martes y miércoles).
  • una estrella ("*" ") para especificar el rango completo.
  • un intervalo regular, por ejemplo "*/2" para iniciar la tarea los días pares de la semana.
  • el día de la semana en letras ("lunes", "martes", "miércoles", "jueves", "viernes").
description (*)Cadena de caracteresdescription associated con la tarea programada. La description de la tarea programada corresponde a una cadena vacía de Default.
Este Property es opcional.
drogadictaCadena de caracteresUsuario que creó la tarea programada.
Esta propiedad es de solo lectura.
En el inicioConstante de tipo IntegerIndica si la tarea debe realizarse al iniciar el servidor HFSQL así como su modo de ejecución.:
  • hBlocking: La tarea es bloquear. El servidor HFSQL no será accesible durante la ejecución de la tarea..
  • hBackgroundTask: La tarea no es bloquear. El servidor HFSQL será accesible durante la ejecución de la tarea. La tarea se ejecuta en la tarea Background.
  • No: La tarea no debe ser ejecutada al iniciar el servidor (valor de Default).
Habilitadobooleano
  • True si la programación de la tarea está activada,
  • False en caso contrario.
HoraCadena de caracteres
Tiempo de ejecución de la tarea programada. Si TimeUTC es set a True, esta hora estará en UTC.Los valores posibles son:
  • un dígito comprendido entre 0 y 23.
  • una lista de números separados por comas: usado para especificar varias horas.
  • a interval. Por ejemplo, "9-13".
  • una estrella ("*" ") para especificar el rango completo.
  • un intervalo regular, por ejemplo "*/2" para iniciar la tarea cada hora par.
MesCadena de caracteresNúmero del mes de ejecución de la tarea programada (por ejemplo,"11"). Los valores posibles son:
  • un dígito comprendido entre 1 y 12.
  • una lista de números separados por comas: usado para especificar varios meses.
  • a interval. Por ejemplo, "9-11".
  • una estrella ("*" ") para especificar el rango completo.
  • un intervalo regular, por ejemplo "*/2" para iniciar la tarea los meses pares.
MinutoCadena de caracteres
Minutos del tiempo de ejecución de la tarea programada. Si TimeUTC es set a True, esta hora estará en UTC.
Los valores posibles son:
  • un dígito comprendido entre 0 y 59.
  • una lista de números separados por comas: se utiliza para especificar varios minutos.
  • a interval. Por ejemplo, "9-13".
  • una estrella ("*" ") para especificar el rango completo.
  • un intervalo regular, por ejemplo "*/2" para iniciar la tarea cada minuto par.
NúmeroEjecuciónIntegroNúmero de veces que se debe ejecutar la medida. Esta propiedad también puede corresponder a la constante Infinite.
paramétricoArrayParámetros del Procedure almacenado que será ejecutado por la tarea programada. Para obtener más información, consulte "¿Cómo manipular los parámetros pasados al Procedure almacenado?".
ProcedureCadena de caracteresNombre del Procedure almacenado que será ejecutado por la tarea programada.
Este Property tiene el siguiente formato: <Nombre de la base de datos>:<Nombre del conjunto de Procedure s>.<Nombre del Procedure almacenado>>..
Para realizar una copia de seguridad, esta Property debe corresponder a "HBackup".
TiempoUTCbooleano
  • True (valor Default) si la hora está en UTC (propiedades Hora y Minuto),
  • False en caso contrario.
Las propiedades seguidas de una estrella (*) son opcionales.

Cómo manipular los parámetros pasados al Procedure almacenado

La propiedad Parameter de la variable hScheduledTask es un array de cadenas.
Para definir los parámetros de una Procedure almacenada al activar una tarea programada, utilice añadir o ArrayAdd. Ejemplo:
Add(MyTask.Parameter, gsNameCSDatabase + ".ScheduledBackup")
Para manipular los parámetros, la sintaxis FOR EACH le permite navegar por un array.
Para conocer el número de elementos de array, puede utilizar:

Funciones que utilizan variables hScheduledTask

Nombre de la funciónEfecto
HAddTaskAgrega una tarea programada en el servidor definido por la conexión. Esta tarea se definió con una variable avanzada de tipo hScheduledTask.
HInfoTaskDevuelve las características de una tarea programada en una variable avanzada de tipo hScheduledTask.
HModifyTaskModifica una tarea programada en el servidor definida por la conexión.. Esta tarea está contenida en una variable avanzada de tipo hScheduledTask.

Compatibilidad

El tipo hScheduledTask sustituye al estructura global de hScheduledTask disponible en la versión 12. Esta estructura se mantiene para la compatibilidad hacia atrás.
Versión mínima requerida
  • Versión 14
Esta página también está disponible para…
Comentarios
Haga clic en [Agregar] para publicar un comentario

Última modificación: 27/05/2022

Señalar un error o enviar una sugerencia | Ayuda local