Hedera Explorer Link Form Element

Introduction

The Hedera Explorer Link Form Element plugin creates a customizable button or hyperlink that allows users to navigate to a public Hedera ledger explorer. You can inspect accounts, tokens, topics, and transactions processed in Joget. The plugin verifies the retrieved value and can disable or hide the button or hyperlink if the value is invalid.

Get started

Prerequisites

  • You need access to a configured Operator ID and Operator Key as part of the Hedera Default Backend Configuration.
  • Ensure you are familiar with the types of values to retrieve, such as Transaction ID, Account Address, Token ID, or Topic ID.

Where to get the plugin

Download the Hedera Explorer Link Form Element from the JogetOSS GitHub repository.

How to install

  1. Click Download on this plugin screen (It will be a .jar file).
  2. Go to your Joget localhost or server. In the Joget Console, go to Admin Bar > Systems Settings > Manage Plugins and click the Upload Plugins button.
  3. Under Upload Plugin, select the plugin .jar file you downloaded and click Upload.
  4. Depending on the plugin type, you can now view your new plugin in your form, List, or UI Builder.
  5. Remember to uninstall the old plugin before uploading a new version.
  6. The Joget Knowledge Base has more information on managing and developing plugins.

Configure hedera explorer link properties

  • Operator ID: This corresponds to your Hedera Operator ID. For further details, see the Hedera Default Backend Configuration.
  • Operator Key: Enter your Hedera Operator Key to create an account.
  • Network Type: Choose PreviewnetTestnet, or Mainnet based on your environment.
Value retrieval
  • Explorer Type: Select the public Hedera ledger explorer of your choice:
  • Value Type: Select the type of value you are checking for:
    • Transaction ID
    • Account Address
    • Token ID
    • Topic ID
  • Get Value Via: Select the method you wish to retrieve the value:
    • Field ID
    • Hash Variable
    • Workflow Variable
  • Field ID: This property will only appear when Get Value Via is Field ID.

    Retrieves the value via an existing field in the current form.
    Selections here will show all available fields in the current form.

  • Hash Variable: This property will only appear when Get Value Via is Hash Variable.

    Retrieves the value via Hash Variable.

  • Workflow Variable: This property will only appear when Get Value Via is a Workflow Variable.

    Retrieves the value via workflow variable. To display a convenient autocomplete dropdown, simply type in the name of a related workflow variable.
    Note that this method only works when the current form is within an activity of a process flow.

Customize link UI
  • Display As: Display this explorer link as:
    • Button
    • Hyperlink
    Note:
    If you select Button, its design will follow the userview theme of the current app.
  • Button Label: This property appears if you choose to display the link as a button. Enter the button's label here.
  • Hyperlink Label: This property appears if you choose to display the link as a hyperlink. If left blank, the hyperlink label will default to the URL.
  • Link Target: Select whether to open the link in a new browser tab or the current window.
  • Invalid Value Behavior: If the retrieved value is invalid, choose from:
    • Show As Is
    • Disable Link
    • Hide Link

Download plugin

Created by Julieth Last modified by Aadrian on Nov 19, 2024