Translator - Toolbar

The Translator’s Toolbar, located at the top of the screen, provides access to key functions such as developing against multiple samples, running tests, and managing projects.

1) Control your components - Start, Stop or Kill a component

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

2) Add, edit and navigate between sample messages

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

Navigate Samples

The current sample message is passed in as the argument to the main function for the script to execute against the specified sample. This allows you to run quick test cases with your various sample use cases.

The sample data navigation controls allow you to:

Move to the first or last message
Move to the next or previous message
Navigate to a particular message by number

Edit Sample Data

Edit sample data will open your selected sample message in the code editor for you to view or apply modifications to the sample.

Add Sample Data

Add sample messages. There are three easy ways to add sample data to the Translator:

Paste in individual sample messages
Import bulk file of sample messages
Import a sample message from the Iguana Logs

3) Manage the project - make commits and interact with connected git repositories

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.

See Git Workflow in the Translator for an example use case.

	Commit Changes Commit and Push Changes to Git
	Pull Changes Pull Changes from an upstream repo
	Push Changes
	Connect a Repository Repository Management Screen
	Show Current Branch
	Git Terminal

Link to other related docs in Translator - Project Pane
- Revert changes, see change history
- Using .gitignore to control Git file tracking - under File Types? or Dev strategy?

4) Execute the script

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.

Script Execution

Play and Stop buttons are available to start and stop script execution in the Translator.

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.

5) Open and search the Translator's help documentation

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.

6) Select the language

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.