Skip to main content

Veritran Docs

Easy VT Services

Easy VT Services are built-in action libraries that integrate with Veritran's services, such as AS or Notif. Easy VT Services help speed up the process of building a transaction that calls any of Veritran's internal services, since they are already configured with the service's URL and the operation they are going to execute.

Each Easy VT Service also comes with the default input and output parameters. You can see these parameters after dropping the Easy VT Service on the canvas, or you can contact your admin to learn about the Easy VT Services available.

Important

Currently, the Easy VT Services you can find in Studio connect with AS, Notif and EMS' GEO.

To see a list of the Easy VT Services available, open the transactions editor. On the left panel, click Services and scroll to the Easy VT Services category. Hover over the Easy VT service to see a short description of its functionality.

EasyVT.png

Read below to learn how to implement an Easy VT Service in your transaction.

Add a Get_User_Status Easy VT Service (AS)

The example below shows how to implement an Easy VT service that invokes AS and receives a user's status. This Easy VT Service's parameters are:

  • Input parameters: user, domain and url.

  • Output parameters: success, code, description, detail, userStatus, userStatusDescription, userPreviousStatus, userPreviousStatusDescription, tokenStatus, tokenStatusDescription.

Note

The steps below refer to the creation of this particular transaction, since each Easy VT service's parameters will differ.

  1. Create a new transaction or open the transaction you want to edit with an Easy VT Service.

  2. Drag the Get_User_Status Easy VT Service into the canvas and connect it to the Start and End nodes.

  3. Click the Start node to configure the output parameters. Click Outputs > Create from input.

  4. On the Create connection from modal, click the drop-down list and select the user parameter from the (Library:AS) node, which is the Easy VT Service.

    trx_example_easyvt.png

  5. The Add input parameter modal window opens. Set the Type as String, and, on the External variable field, add the register that receives the username. Set register number 3, which is, by default for every project, the register in charge of receiving and storing the username parameter. Click Add.

    trx_input.png

  6. Repeat the same process with the domain and url fields but set a different register for each one of them. The url will be configured in step X.

    Note

    Note that the domain is usually preconfigured in the app. Contact your admin to verify the register that is retrieving this information.

  7. Go to the End node to configure the input parameters, that is, the user's information that the transaction is receiving. Go to the End node, click the Inputs tab and click Create from output.

  8. On the Create connection from modal, click the drop-down list and select the success parameter from the (Library:AS) node, which is the Easy VT Service.

    Create_connection_output.png

  9. The Add input parameter modal window opens. On the External variable field, add a register to store the response. For this value, set register number 2000. Click Add.

  10. Repeat the same process with every parameter from the Action Library's node, making sure to add a different register for each parameter: (code, description, detail, userStatus, userStatusDescription, userPreviousStatus, userPreviousStatusDescription, tokenStatus, tokenStatusDescription).

Now, you have a transaction that receives a user's information and, by connecting to AS, retrieves the user's status.

In this section: