You are here:

es.ActiveXperts.com > ActiveXperts Scripting Toolkit
ActiveXperts Scripting Toolkit

quicklinks

Visión general del producto

El kit de herramientas ActiveXperts Scripting les permite a los desarrolladores de Software ejecutar un programa VBScript o una herramienta de línea de órdenes sin la necesidad de apelar a un anfitrión (Host) de Windows Scripting o una ventana de consola. Con el Kit de herramientas ActiveXperts Scripting, se puede apelar a programas VBScript y herramientas de línea de órdenes desde cualquier aplicación o guión (Script).

How to use Scripting toolkit Visual Stuio.NET Web Application GUI Application Console Application
Startup screen after installation Use Scripting Toolkit with MS Visual Studio Scripting Toolkit in a .NET web application Scripting Toolkit in a .NET forms program Scripting Toolkit in a console application

Normalmente, se llaman a los programas VBScript mediante la apelación de un “Windows Script Host” (Anfitrión de Script de Windows), (ya sea WSCRIPT.EXE o CSCRIPT.EXE). El Kit de herramientas ActiveXperts Scripting comunica de manera directa con el motor VBScripting del sistema en funcionamiento. Algunos beneficios de utilizar ActiveXperts Scripting en vez de Windows Scripting Host son:

  • Los resultados de funciones se pueden utilizar de manera directa en cualquier aplicación
  • Se almacenan las salidas estándar y los errores estándar en variables, sin tener la necesidad de redirigir
  • Llama las funciones de manera directa en lugar de escribir un código “stub”.
  • Pasar parámetros de funciones de manera dinámica – pasar parámetros de funciones “sobre la marcha”, directamente desde su propia aplicación o script.
  • Establecer un intervalo para prevenir que las funciones no retornen, por ejemplo un resultado de un bucle sin salida.
  • Interceptar errores de programación que puedan causar normalmente la caída del Windows Scripting Host
  • Personalizar sus mensajes de error.
  • Asistencia para Servicios de Windows y aplicaciones Web – llamar una función de manera directa VBScript desde un servicio Windows o una aplicación Web.

Algunos beneficios de utilizar el Kit de herramientas ActiveXperts Scripting en lugar de ejecutar una línea de orden desde una ventana de consola:

  • Se almacenan las salidas estándar y los errores estándar en variables, sin tener la necesidad de redirigir.
  • Establecer un intervalo para prevenir que las funciones no retornen, por ejemplo un resultado de un bucle sin salida.
  • Asistencia para Servicios de Windows y aplicaciones Web – llamar una función de manera directa VBScript desde un servicio Windows o una aplicación Web.

ActiveXperts Scripting Toolkit can be distributed easily to any Windows computer. Once you have purchased the license, you copy the axscript.dll (or axscriptx64.dll) to the workstations or servers and register the DLL on those machines.

El componente de Kit de herramientas ActiveXperts Scripting se puede utilizar mediante cualquiera de estos lenguajes de desarrollo / scritpting:

  • Microsoft Visual Studio. NET: Visual Basic. NET, Visual C#. NET, ASP. NET
  • Microsoft Visual Studio: Visual Basic 5.x o más alto, Visual C++ 5.x o más alto
  • Borland Delphi 7.x o más alto, Borland C++ Builder 6.x o más alto
  • ASP 2.x, HTML, Javascript
  • PHP
  • VBScript
  • Cualquier otra plataforma de desarrollo que admita componentes ActiveX/COM

Requisitos del sistema

El Kit de herramientas ActiveXperts Scripting está disponible como un componente de 32 bit y como uno de 64 bit. (Siendo ambos parte del producto).

  • axscript.dll - componente 32-bit
  • axscriptx64.dll - componente 64-bit.

Se puede ejecutar el Kit de herramientas ActiveXperts en los siguientes Sistemas Operativos:

  • Windows 2008 (32 y 64 bit);
  • Windows 2003 (32 y 64 bit);
  • Windows 7 (32 y6 4 bit);
  • Windows Vista (32 y 64 bit);
  • Windows XP (32 y 64 bit).

Fragmentos de Códigos y Aplicaciones de Muestra

Los siguientes fragmentos de código ilustran cómo utilizar el objeto de Scripting.

Visual C# .NET sample showing how to run a VBScript program

using System;
using System.Collections.Generic;
using System.Text;
using vbscript-powershell-component;

namespace Scripting
{
  class Program
  {
    static void Main(string[] args)
    {
      VBScript objScripting = new VBScript ();

      Microsoft.Win32.RegistryKey regKey;

      // Display Version Info
      Console.WriteLine("Scripting Toolkit Version: " + objScripting.Version);
      Console.WriteLine("Scripting Toolkit Build  : " + objScripting.Build);
      Console.WriteLine("Scripting Toolkit Module : " + objScripting.Module);
      Console.WriteLine("Expiration date          : " + objScripting.ExpirationDate + "\r\n");

      // Set Scriptfile
      objScripting.ScriptFile = "Date.vbs";
      regKey.Close();
                 
      // Specify Function
      objScripting.Function = "GetDateString";

      // Set Parameters
      objScripting.Parameter1 = "\"New Datum: \"";
      objScripting.Parameter2 = "10";
      
      // Run Script
      VBScriptResult objResult = objScripting.Run() as VBScriptResult;

      // Display Result
      Console.WriteLine("{0}", objScripting.ScriptFile);

      Console.WriteLine("Completion Code              : {0}", objResult.RunResultCode);
      Console.WriteLine("Completion Description       : {0}", objResult.RunResultDescription);

      if (objResult.RunResultCode == 0)
      {
          Console.WriteLine("Return String   : {0}", objResult.FunctionReturnString);
          Console.WriteLine("Return Number   : {0}", objResult.FunctionReturnNumber);
      }
      else
      {
          Console.WriteLine("Error Source    : {0}", objResult.ErrorSource);
          Console.WriteLine("Error Description : {0}", objResult.ErrorDescription);
          Console.WriteLine("Error Line      : {0}", objResult.ErrorLineNum);
          Console.WriteLine("Error Char      : {0}", objResult.ErrorCharPos);
          Console.WriteLine("Error Code      : {0,8:X}", objResult.ErrorCode);
      }
    }
  }
}

Muestra VB.NET que ilustran cómo ejecutar una orden remota

using System;
using System.Collections.Generic;
using System.Text;
using vbscript-powershell-component;

namespace RemoteCommandDemo
{
  class Program
  {
    static void Main(string[] args)
    {
      RemoteCommand objRemoteCmd = new RemoteCommand();

      Console.WriteLine("Scripting Toolkit Version: " + objRemoteCmd.Version);
      Console.WriteLine("Scripting Toolkit Build  : " + objRemoteCmd.Build);
      Console.WriteLine("Scripting Toolkit Module : " + objRemoteCmd.Module);
      Console.WriteLine("Expiration date          : " + objRemoteCmd.ExpirationDate + "\r\n");

      // Clear all paramaters
      objRemoteCmd.Clear();

      // Set hostname of remote computer
      objRemoteCmd.Host = Ask("Hostname of remote computer", false);

      // Set user account
      objRemoteCmd.UserName = Ask("User account on remote computer", true);

      // Set user password
      objRemoteCmd.Password = Ask("Password on remote computer", true);

      // Set remote command
      objRemoteCmd.Command  = Ask("Enter command to execute on remote computer", false);

      // Set command timeout
      objRemoteCmd.CommandTimeout = 5000;

      // Set Logfile
      objRemoteCmd.Logfile = System.Environment.CurrentDirectory + "LogFile.Txt";

      // Run the command
      objRemoteCmd.Run();

      Console.WriteLine("StdOut received: {0}", objRemoteCmd.StdOut);
      Console.WriteLine("StdErr received: {0}", objRemoteCmd.StdErr);
      Console.WriteLine("Executed command, result: {0})", objRemoteCmd.LastError);
      Console.WriteLine("Ready.");

      Console.ReadKey();
    }

    static private string Ask(string strTitle, bool bAllowEmpty)
    {
      String strInput, strReturn = "";

      Console.WriteLine(strTitle);
      do
      {
        Console.Write("  > ");
        strInput = Console.ReadLine();
        if (strInput.Length > 1)
           strReturn = strInput;
      } 
      while (strReturn == "" && !bAllowEmpty);

      return strReturn;
    }
  }
}

Click here for more samples.

Arquitectura

El “núcleo” del Kit de herramientas de ActiveXperts Scripting es un componente ActiveX/COM y está distribuido en dos componentes: El Kit de herramientas de ActiveXperts Scripting está disponible como un componente de 32 bit y como uno de 64 bit. (Siendo ambos parte del producto).

  • axscript.dll - componente 32-bit;
  • axscriptx64.dll - componente 64-bit.

El Kit de herramientas de ActiveXperts Scripting puede ser distribuido fácilmente a muchas PC. Una vez que se hayan adquirido las licencias, usted sólo necesita copiar axscript.dll en las diferentes computadoras y registrar este DLL en esa computadora.

Instalación

Opciones de instalación de ActiveXperts Scripting

ActiveXperts Scripting posee las siguientes opciones de instalación:

  • El componente ActiveX/COM de ActiveXperts Scripting – la interfaz a las aplicaciones ActiveX/COM.
  • Los archivos de Ayuda de ActiveXperts Scripting – documentación.
  • Los archivos de Ejemplos de ActiveXperts Scripting – ejemplos.

Más información

Para conocer más acerca del Kit de herramientas de ActiveXperts, utilice uno de los siguientes enlaces: