Unsupported content

 

This version of the documentation is no longer supported. However, the documentation is available for your convenience. You will not be able to leave comments.

Script adapter

The Script adapter executes Perl and Jython scripts. You can specify the initial values of variables in a script, and you can retrieve the values on execution. The Script adapter supports concurrent execution of scripts. This adapter does not support multiple configuration nodes, but you can configure multiple Script adapters within Grid Manager, each with a unique configuration node and an adapter name. For configuration instructions and to execute ActivePerl scripts in a Windows environment using a Script adapter, see Using ActivePerl scripts in a Windows environment.

The Script adapter supports the Character set feature of base adapters. For base adapters feature details, see Base adapter features.

Note

  • To ensure that processes using the Script adapter run successfully, check whether the Perl path designated in the Script adapter configuration exists on all the peers on which this adapter is enabled. Perl 5.8 or later is required.
  • The Script adapter does not support Perl version 5.8.8 (except on the Windows operating system). It supports earlier and later versions of Perl 5.8.8. For example, Perl 5.8.5 and Perl 5.10.

The information provided in this section applies to the use of the Script adapter in a Call Adapter activity in BMC Atrium Orchestrator Development Studio. See Script activity for details on using the Script activity.

Note

Starting with the 20.12.02 release, the Script adapter can also execute a request when the adapter is enabled on a peer that is compliant with the Internet Protocol version 6 (IPv6).

The Script adapter supports three basic data structures, scalar (single values), lists (arrays), and maps (hashes).

  • Scalar variables: Designated using an XML element with the same name as the variable that contains a value that is set to the variable value. Do not include the $ character used to designate Perl scalar values in the XML.
    Example: The Perl code $var1 = test is represented as <var1>test</var1> in the adapter request and response.
  • List variables: Designated using a parent and child relationship, where the parent defines the type, and the children contain the variable elements. Do not include the @ character used to designate Perl list variables in the XML. An XML sample for a list variable, var2, is as follows:
    
    <var2 type="array">
      <value>one</value>
      <value>two</value>
    </var2>
  • Map variables: Designated using a parent and child relationship, where the parent defines the type, and the children contain the variable elements. Do not include the % character used to designate Perl map variables in the XML. An XML sample for a map variable, var3 is as follows.
    
    <var3 type="map">
      <value key="one">1</value>
      <value key="two">2</value>
    </var3>
Was this page helpful? Yes No Submitting... Thank you

Comments