Translator - Toolbar

From the Translator, you can control the status of the component to test what you are working on. Depending on the current status of the component you can START, STOP, or KILL a component in a pending state.

The status light will indicate the current state of the component:

• - Inactive

• - Active

• - Pending

• - Stopped on Error

The Translator is a data driven environment, meaning you can use real Sample Data to develop and test your integration logic. Use the toolbar to:

1. Navigate and use selected sample messages

2. Edit sample data

3. Add sample data

Open

The Translator’s Source Control tools help you manage your projects, saving changes locally and in connected remote git repositories for the rest of the team to access. In order, to leverage the source control features, you must configure your IguanaX Git settings and ensure your project is connected to a repository.

Open	Commit Changes When you are working on a project, its recommended to make incremental commits, saving your script locally at multiple milestones. When you make a commit, you can see a diff view of the changes made and leave a note to document your work. At any point in development, you can use a file’s menu to view changes and revert to a previous version if necessary.
Open	Pull Changes Pull down changes from the upstream repository into your local project to make sure you are working from the latest, most up to date code. When collaborating on a project with a team, its It's important to pull down the latest changes first so you can resolve any conflicts before you share your changes.
Open	Push Changes When you want to backup or share your changes with the rest of the team, you can push changes to an upstream repository. If there are files you don’t want pushed and stored in your repository, you can use a .gitignore file.
Open	Connect a Repository In order to use version control, every component must be connected to repository. The Repository Management Screen allows you to connect component’s to new or existing repositories to manage your project files.
Open	Show Current Branch Quickly see what project branch you are currently working on. You can also view this in the Translator - Project Pane.
Open	Git Terminal Allows users to interact with your Git repository using the command-line, offering precise control over version control tasks like committing changes, branching, pulling, and pushing code.

When working in the Translator, one of the many great benefits is the auto-execution of the script, enabling you to develop and test your code at the same time.

However, sometimes you may want to control when your script executes, for example when working with large data sets, testing one-time executions or debugging an error.

Open

1. Script Execution: Play and Stop buttons are available to start and stop script execution in the Translator.

2. Auto-Execution Toggle: By default, the Translator will auto-execute to enable the real-time view of results in the Annotation Windows. You can toggle this button on and off to control the script auto-execution and turn off/on the the annotations.

The Help Index can be accessed in the Translator to search and view Iguana’s Translator API documentation. This documentation provides information on how the API works, how to use it along with an example.

The Translator employs syntax highlighting to colour code functions, keywords, and variables to improve code readability and help developers quickly navigate scripts.

The Language dropdown controls how the Translator does code syntax highlighting. The Language is set to Lua by default, but can be changed if you are working in the Translator with different types of data.

For example, if you open a sample HL7 message, the Translator will auto detect the HL7 and change the language bar to the appropriate HL7 setting so the data is highlighted correctly. You can manually select the language if needed.