|
|
|
|
- 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
hScheduledTask (Tipo de Variable)
Disponible 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.
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 propiedad | Tipo utilizado | Efecto |
---|
DayOfMonth | Cadena de caracteres | Nú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.
| DayOfMonthOrDayOfWeek | booleano | Gestionar 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).
| DayOfWeek | Cadena de caracteres | Nú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 caracteres | description associated con la tarea programada. La description de la tarea programada corresponde a una cadena vacía de Default. Este Property es opcional. | drogadicta | Cadena de caracteres | Usuario que creó la tarea programada. Esta propiedad es de solo lectura. | En el inicio | Constante de tipo Integer | Indica 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).
| Habilitado | booleano | - True si la programación de la tarea está activada,
- False en caso contrario.
| Hora | Cadena 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.
| Mes | Cadena de caracteres | Nú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.
| Minuto | Cadena 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ón | Integro | Número de veces que se debe ejecutar la medida. Esta propiedad también puede corresponder a la constante Infinite. | paramétrico | Array | Pará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?". | Procedure | Cadena de caracteres | Nombre 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". | TiempoUTC | booleano | - 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ón | Efecto |
---|
HAddTask | Agrega una tarea programada en el servidor definido por la conexión. Esta tarea se definió con una variable avanzada de tipo hScheduledTask. | HInfoTask | Devuelve las características de una tarea programada en una variable avanzada de tipo hScheduledTask. | HModifyTask | Modifica una tarea programada en el servidor definida por la conexión.. Esta tarea está contenida en una variable avanzada de tipo hScheduledTask. |
Esta página también está disponible para…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|