What's new in TPL

New in TPL 1.19/BMC Discovery 21.05 (12.2)

TPL version 1.19 is available with BMC Discovery 20.05 (12.2). It is a minor update to TPL version 1.18.

The following update is available:

• Allow patterns to use non-taxonomy nodes, role and relationships with extra_node_kinds, extra_role_kinds, extra_rel_kinds in module metadata
• Add dialect parameter to discovery-runCommand to select the shell used for running a command
• Added with discovery-runPowerShell being a synonym for using powershell shell
• Add replace parameter to inference-primary to use supplied evidence for primary inference in place of rather than addition to current inferences
• The mail-send now supports cc_addrs and bcc_addrs parameters
• Allow search to access members of dictionaries
• The following convenience functions have been added:

• 
  
  • datatype
  • jmespath-evaluate
  • list-sorted
  • model-confirm
  • model-findCandidate
  • model-findCandidates
  • regex-escape
  • regex-replace
  • table-get
  • table-items
  • table-keys
  • table-values

New in TPL 1.18/BMC Discovery 20.08 (12.1)

TPL version 1.18 is available with BMC Discovery 20.08 (12.1). It is a minor update to TPL version 1.17.

The following update is available:

• The TPL discovery-scan function has been enhanced to include a new parameter scope. Scope is a string identifier used to distinguish between endpoints in different address spaces. If the scope is not specified, the default scope is used. For more information on scope, see Overlapping-IP-addresses.

New in TPL 1.17/BMC Discovery 20.02 (12.0.0.1)

TPL version 1.17 is available with BMC Discovery 20.02 (12.0.0.1). It is a minor update to TPL version 1.16.

The following update is available:

• The TPL discovery.scan function has been enhanced to specify the BMC Discovery Outpost or discovery service. The new parameter outpost_id enables you to specific the name or ID of the BMC Discovery Outpost that you want to perform the scan. You can determine the name or ID of the BMC Discovery Outpost using the tw_reasoningstatus utility. 

New in TPL 1.16/BMC Discovery 20.02 (12.0)

TPL version 1.16 is available with BMC Discovery 20.02 (12.0). It is a minor update to TPL version 1.15.

The following function has been added:

• discovery-sqlQuery – performs an SQL query on a relational database, returning a list of SQLResultRow nodes.

New in TPL 1.15/BMC Discovery 11.3

TPL version 1.15 is available with BMC Discovery 11.3. It is a minor update to TPL version 1.14.

The following functions have been added:

• discovery-restfulGet – performs a GET request on the target using the RESTful protocol specified and returns a node containing information on the discovered system. Adds "nimble_auth", a generic protocol for Nimble web API with token authentication. Intended for use discovering Nimble storage devices. An enhancement to the discovery.restfulGet function introduced in TPL 1.11.

New in TPL 1.14/BMC Discovery 11.2

TPL version 1.14 is available with BMC Discovery 11.2. It is a minor update to TPL version 1.13.

The following functions have been added:

• discovery.restfulGet – performs a GET request on the target using the RESTful protocol specified and returns a node containing information on the discovered system. An enhancement to the discovery.restfulGet function introduced in TPL 1.11.
• discovery.restfulPost – performs a POST request on the target using the RESTful system and returns a node containing information on the discovered system. An enhancement to the discovery.restfulPost function introduced in TPL 1.11.
• discovery.restfulDelete– performs a delete request on the target using the RESTful protocol specified and returns a node containing information on the discovered system
• discovery.restfulPatch – performs a patch request on the target using the RESTful protocol specified and returns a node containing information on the discovered system.

• discovery.restfulPut – performs a put request on the target using the RESTful protocol specified and returns a node containing information on the discovered system.

• discovery.lookupAddresses – performs a DNS lookup on the supplied DNS resolvable name and returns a list of IP addresses.

• discovery.startTime – returns the start time of the scan which discovered a given DDD node.

• Discovery-cloud-provider-requests – a set of discovery functions which query the cloud provider API, for information on the target.

New in TPL 1.13/BMC Discovery 11.1

TPL version 1.13 is available with BMC Discovery 11.1. It is a minor update to TPL version 1.12.

The following functions have been added:

• system-cmdbSync – adds a root node or nodes to the CMDB synchronization queue.
• discovery-scan – adds a snapshot scan for the given target. Requires that you have a scheduled scan defined that includes the address or addresses of the scan targets, and that the allow patterns checkbox is checked for that scan.

New in TPL 1.12/BMC Discovery 11.0.01

TPL version 1.12 is available with BMC Discovery 11.0.01 (Patch 1). It is a minor update to TPL version 1.10 which consists of some internal fixes. From the April 2016 TKU release, monthly TKUs for BMC Discovery 11.0.x require that you upgrade the system to version 11.0.01 (Patch 1).

New in TPL 1.11/BMC Discovery 11.0

TPL version 1.11 is available with BMC Discovery 11.0. It is a minor update to TPL version 1.10.

The following functions have been added:

• json.encode – Converts a string, table, or a list (including nested structures) to a JSON encoded string.
• json.decode – Decodes a JSON encoded string and returns a structure containing a string, table or list including nested structures.
• model.kind – Returns the node kind of a given node.
• related.hostingNode – Returns a node that is associated with the given triggers and is hosting the software instance.
• discovery.restfulGet – Performs a GET request on the target using the RESTful protocol specified and returns a node containing information on the discovered system.

• discovery.restfulPost – Performs a POST request on the target using the RESTful system and returns a node containing information on the discovered system.
• discovery.wbemEnumInstances – a new parameter, filter_locally has been added. When set, the function does not request specific properties so all are returned. Only the specified properties are stored as DDD. This parameter can be used if a particular system does not support the retrieval of specific properties.
• discovery.access – you no longer have to provide a DDD node. If no DDD node is specified, the function returns the DiscoveryAccess currently in use.
• discovery.vSphereFindObjects  – search from the root folder the instances of an object type and returns the requested properties for each object found.

• discovery.vSphereTraverseToObjects  – traverses from the initial object to instances of an object type and get properties on those objects.

• discovery.vSphereGetProperties   – retrieve properties from a given MOR and returns the requested properties for each object found.

• discovery-vSphereGetPropertyTable – retrieves a table of values from a given MOR and returns multiple NodeState objects, one for each DataObject in the list or array.

An 

 statement has been added which obsoletes (automatically deactivates) specified modules.

New in TPL 1.10/BMC Discovery 10.2

TPL version 1.10 is available with BMC Discovery 10.2. It is a minor update to TPL version 1.9.

The following functions have been added:

• binary-toValue

• overrides in syncmapping block

• Impacted and 

  ImpactWeight

   in syncmapping block

New in TPL 1.9/BMC Discovery 10.1

TPL version 1.9 is available with BMC Discovery 10.1. It is a minor update to TPL version 1.8.

The following functions have been added:

• discovery-wbemEnumInstances
• discovery-getNames
• number-toChar
• binary-toIPv4z
• binary-toIPv6z

New in TPL 1.8/BMC Discovery 10.0

TPL version 1.8 is available with BMC Discovery 10.0. It is a minor update to TPL version 1.7.

• Add model-addDisplayAttribute and model-removeDisplayAttribute to modify _tw_meta_data_attrs

• Extend 

  discovery.snmpGet

   and 

  discovery.snmpGetTable

   to allow caller to distinguish binary data

• Add 

  binary.toIPv4

  , binary-toIPv6(), binary-toMACAddress, 

  binary.toWWN

   and 

  binary.toHexString

   to convert binary data to text.

New in TPL 1.7/BMC Discovery 9.0

TPL version 1.7 is available with BMC Discovery 9.0. It is a minor update to TPL version 1.6.

TPL 1.7 adds the following new features:

• New text.ordinal function. See Text-functions.

New in TPL 1.6/BMC Discovery 8.3

TPL version 1.6 is available with BMC Discovery 8.3. It is a minor update to TPL version 1.5.

TPL 1.6 adds the following new features:

• Removal groups. See the following functions:
  • model-setRemovalGroup
  • model-anchorRemovalGroup
  • model-suppressRemovalGroup
• A new void keyword is added. Assigning this to an attribute in the model deletes the attributes. The statement node['attribute_name'] := void; is the equivalent of del node['attribute_name']
• String and list slicing

New in TPL 1.5/BMC Discovery 8.2

TPL version 1.5 is available with BMC Discovery 8.2. It is a minor update to TPL version 1.4.

TPL 1.5 adds the following new features:

• User defined functions. See User-defined-functions.
• You can now reference constants defined in a pattern from other patterns. See Constants.
• Version restrictions are now enforced according to the version specified in the pattern. Prior to TPL 1.5 the TPL version specified at the top of a pattern file was only checked against the supported version in BMC Discovery. Now functionality defined in a specific TPL version is available if that (or a later) version is specified in the pattern file.

New in TPL 1.4/BMC Discovery 8.1

TPL version 1.4 is available with BMC Discovery 8.1. It is a minor update to TPL version 1.3.

TPL 1.4 adds the following new features:

• Enumerations, this is described in Enumerations.
• New discovery.listRegistry function. See Discovery-functions.

New in TPL 1.3/Tideway Foundation 7.3

TPL version 1.3 is available with Tideway Foundation 7.3. It is a minor update to TPL version 1.2.

TPL 1.3 adds a number of new features:

• New discovery.listDirectory function. See Discovery-functions.

New in TPL 1.2/Tideway Foundation 7.2

TPL version 1.2 is available with Tideway Foundation 7.2. It is a minor update to TPL version 1.1.

TPL 1.2 adds a number of new features:

• Pattern configuration blocks allow end users to modify parameters without editing pattern text. See Pattern-Configuration.
• New definitions blocks support SQL Discovery (now Integration points and Configuring database credentials) See Definitions.
• Model maintenance is made easier with the addition of unique relationship functions. See Unique relationships.
• Lookup tables can be created and manipulated inside patterns. See Table-functions.
• New functions to manipulate dates and times are available. See Time-functions.

New in TPL 1.1/Tideway Foundation 7.1

TPL version 1.1 is available with Tideway Foundation 7.1. It is a minor update to TPL version 1.0.

It has the following new features:

• New confirmed trigger kind. See Trigger kind.
• New text.strip, text.leftStrip and text.rightStrip functions. See Text-functions.
• New mail.send function. See Email-functions.
• New discovery.snmpGet and discovery.snmpGetTable functions. See Discovery-functions.