BackgroundJobsManager

Execute

Sintaxis:

Execute(<NombreDelMétodo>, <Parámetros>, <Clave>, <Descripción>)

Parámetros:

Tipo: Cadena.
El nombre del procedimiento exportado o una función de un módulo general no global que se puede ejecutar en el servidor, en la forma NombreDelMódulo.NombreDelMétodo.

Tipo: Array.
Un array de parámetros pasados a este método. El número de parámetros y sus tipos deben coincidir con los parámetros del método.
Todos los parámetros deben ser serializables. De lo contrario, el método genera una excepción y no inicia el trabajo en segundo plano.
Si los últimos parámetros del método tienen valores predeterminados, puedes omitirlos en el array.
Si todos los parámetros del método tienen valores predeterminados, puedes omitir completamente el array.
El tamaño máximo de los parámetros es de 1 GB. Si se excede el tamaño máximo, se generará una excepción. Se recomienda pasar los parámetros de gran tamaño a través de la base de datos.

Tipo: Cadena.
Una clave de trabajo. Si se especifica la clave del trabajo en segundo plano, debe ser única entre todas las claves de trabajos activos que comparten el nombre del método con este trabajo en segundo plano.

Tipo: Cadena.
Descripción de la tarea.

Valor devuelto:

Tipo: BackgroundJob.

Descripción:

Inicia la ejecución de un trabajo en segundo plano en nombre del usuario actual. El método agrega el trabajo en segundo plano a una cola, por lo que la ejecución del método se completa antes de que finalice la ejecución del trabajo en segundo plano. Si se especifica la clave del trabajo en segundo plano, debe ser única entre todas las claves de trabajos activos.
Si alguno de los parámetros del método no es serializable, el método no inicia un trabajo en segundo plano y genera una excepción.
En el modo de archivo, no se permite la ejecución simultánea de múltiples trabajos en segundo plano. Si hay otro trabajo en segundo plano en ejecución, los nuevos trabajos se encolan. Una vez que se completa un trabajo en segundo plano, se inicia el siguiente.
Si una aplicación cliente accede a un servidor utilizando una conexión COM o una conexión externa a una base de datos de información de archivo, no se pueden iniciar trabajos en segundo plano (aún se encolan).
Llamar al método WaitForCompletion desde una conexión externa o un trabajo en segundo plano en ejecución en modo de archivo resulta en esperar durante toda la duración del tiempo de espera especificado en este método (o una duración ilimitada si no se especifica el tiempo de espera).

Disponibilidad:

Servidor, cliente grueso, conexión externa, aplicación móvil (servidor), servidor independiente móvil.

Disponible desde:

Disponible desde la versión 8.1.