sauan03

Transporting Objects With AWA REST API v12.2

Discussion created by sauan03 Employee on Jul 16, 2018
Latest reply on Aug 9, 2018 by sauan03

DESCRIPTION

 

This set of objects will allow you to export a single object in json format and import it in a target environment under a different name, at a specific location.

 

It is possible to export most object types, but it will not work with users, hosts (agents), clients, folders.

 

The first webservice job exports the object, the second Powershell job edits the .json output, and the third job imports the object in the target client.

 

 

 

PRE-REQUISITES

 

  • BEFORE importing the objects, connect to Client 0.

 

In UC_SYSTEM_SETTINGS, set if not done already: 

 

In UC_EXT_INTERPRETERS_WINDOWS, there must be a ‘POWERSHELL’ entry like below:

 

  • You need a REST WebService Agent and a Windows agent. Both agents must reside on the same host.

 

 

 

PREPARATION STEPS

 

  • Import the xml.
  • Set the agents and login in the jobs’ attributes.
  • Adjust the REST Connection object ‘CONN.WEBSERVICEREST@AWA_REST_API’:

 

 

Replace <AESERVER> with the actual AE server’s hostname or IP.

The username and password must be the same for both clients (source and destination). In other words, the exact same user must exist twice: once in the source client, once in the destination client.

Also set the hostname.

 

  • The objects should now be ready for the first transport.

 

  

HOW IT WORKS

 

  • Start ‘JOBP@AWA_REST_API.EXP_CHG_IMP‘:

 

  • Fill in the Promptset

 

 

  • Then 

 The execution should complete within a few seconds.

  • Connect to the target Client.
  • The object as well as the target path have been created:

 

 

 

Feedback is welcome

 

 

Best regards,

Antoine

Outcomes