AYUDA EN LÍNEA
 WINDEV, WEBDEV Y WINDEV MOBILE
Este contenido se ha traducido automáticamente.  Haga clic aquí  para ver la versión en inglés.
Ayuda / WLanguage / Sintaxis WLanguage / Declaración de variables
  • Lifespan of an automation object
  • Allocating an automation object
  • Passing parameters to a method
  • Using an OLE Automation object from a service
  • Automation objects and WEBDEV
WINDEV
WindowsLinuxJavaReportes y ConsultasCódigo de Usuario (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Código Navegador
WINDEV Mobile
AndroidWidget Android iPhone/iPadIOS WidgetApple WatchMac Catalyst
Otros
Procedimientos almacenados
The Automation keyword is used to declare an automation object. This object is allocated during the declaration. The Automation objects are used to handle software such as Office 2007 (Word, Excel, etc.).
Note: A dynamic automation object can also be used.. It is allocated upon request, during the program execution.
WEBDEV - Código Servidor Using the Automation type in a site may cause problems. In the Intranet, automation objects can be used with caution for quick, one-off situations: automation objects are a dangerous design and are strongly discouraged.
Ejemplo
// Déclaration d'un objet automation
MonObjetAutomation is object Automation MonServeur
// Appel d'une méthode d'un objet automation
MonObjetAutomation>>FichierOuvrir(NomDoc)
Sintaxis

Declaring an automation object Ocultar los detalles

<Automation object name> is automation object <Name of automation server>
<Automation object name>: Character string
Name of the automation object to declare.
<Name of automation server>: Character string
Name of the server for the automation object.

Calling a method of an automation object Ocultar los detalles

<Name of automation object>>><Method name>([<Parameters>])
<Automation object name>: Character string
Name of the automation object to use. This object was declared beforehand.
<Method name>: Character string
Name of the method of the automation object to run. This method is given by the server.
Note: The list of methods that can be used depends on the server. For more details, see the documentation about the server.
<Parameters>: Any type (optional)
Parameters passed to the method. To use the default value of an optional parameter, you have the ability to use "*" or the OLEIgnore constant.
Observaciones

Lifespan of an automation object

The automation object is created during its declaration.
The automation object is automatically destroyed at the end of the process containing its declaration.
An automation object declared "global" in the code:
  • that initializes a window (or page) will be destroyed at the end of the process that closes the window (or the page).
  • that initializes a project will be destroyed at the end of the closing process of the first window/page of the project.

Allocating an automation object

  • When allocating an automation object, the automation server is automatically started.
  • To allocate an automation object with an existing instance of an automation server, use GetActiveObject.

Passing parameters to a method

  • The methods of automation servers can accept one or more parameters.
  • When calling a method, the sequence of parameters must be respected (for more details, see the documentation about the server).
  • With some automation servers, some method parameters are not valued: only the presence of the parameter is important. The value taken by this parameter has no importance.
    For example, the "EditReplace" method of Word Basic accepts 10 parameters, the last one (ReplaceAll) being not valued.
    In WLanguage, any ordinary value can be passed to non-valued parameters.
  • The methods of some automation servers can accept optional parameters located anywhere in the list of parameters.
In WLanguage, the optional parameters must necessarily be found after the mandatory parameters.
To give any ordinary value to an optional parameter, assign the * character to the optional parameter. On the contrary, this character will not be required for the optional parameters found after the last mandatory parameter.
Windows

Using an OLE Automation object from a service

Some of the OLE Automation objects cannot be used by default from a service.
For example, the allocation of an OpenOffice object from a service run with the local system account may trigger an error such as "The automation object com.sun.star.ServiceManager is not installed on your system". 
m_oApplication = new object Automation "com.sun.star.ServiceManager"
In this case, the Windows configuration must be adapted to allow the OLE Automation object to be used from a service. The following operations must be performed:
  • Display the control panel of Windows,
  • Select "Management tools",
  • Select "Component service",
  • Expand the following tree structure: Computers/Workstation/DCOM configuration
  • Select "OpenOffice service manager" and display its properties ("Properties" in the context menu)
  • On the "Identity" tab, select a relevant identity (the user account that will run the application).
WEBDEV - Código Servidor

Automation objects and WEBDEV

Using the Automation type in a site may cause problems. In Intranet, the automation objects can be used with great care in specific cases. In Intranet, using the automation objects is a dangerous conception and they are not recommended.
The following problems may occur:
  • Large memory consumption.
  • Limit regarding the number of users.
  • Workload of the automation objects used not controlled properly.
  • Concurrent access to the resources and especially to the files.
  • Potential locking windows of the automation object that open on the server.
We recommend that you find another solution if possible. For example:
  • Using a Back Office: Save the elements to be executed in a file (HFSQL, Text, etc.) and execute it using a WINDEV application running in the background on the server.
  • Using web services, etc.
Remark: The use of automation objects often requires special server configuration (particularly for security aspects).. For more details, contact your provider.
Ver también
Versión mínima requerida
  • Versión 9
Esta página también está disponible para…
Comentarios
Haga clic en [Agregar] para publicar un comentario

Última modificación: 21/09/2024

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