Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

Version 1 Next »

The Translator is one of the most flexible channel components in Iguana in that it gives you the most freedom in customizing and designing your data workflow. Whether it’s connecting to web services, working with databases, mapping HL7 messages, or even monitoring Iguana itself, it is completely up to you how you want to use it.

In addition to its flexibility, it’s delightfully easy to learn and use, even for the newest of programmers! You may be wondering, what exactly makes the Translator so appealing to work in?

Some standout features:

 Code auto-completion

Think Google style of auto-completion, but for your code! You can just start typing and the Translator will suggest a list of functions you can use, as well as a short description of what they do. Or, if you’re working with tables or node trees, you can “search” the name or value of a node and the Translator will suggest a few nodes that match your text and auto-complete the code to access that node!

Let’s say I’m mapping an HL7 message and I want to access the field containing the patient’s name. Rather than navigating through all the nodes, I can just start typing the patient’s name or the field name. For example, I know the field is called “Given Name”:

Hitting the suggestion automatically fills in the rest of the code I need to access the field:

This makes it much easier (and faster!) than looking up all the indices you’d need to navigate to this field.

 Annotations and sample messages

The neat thing about the Translator is that you can insert sample messages and watch in real-time in the annotations as the data is transformed line by line in your script. You can also cycle through different sample messages and check how your code works with different types of messages. This makes it incredibly easy and intuitive to build your code, spot problems, and fix them!

Tip: use trace() statements frequently while coding to make full use of the annotations!

 Code navigation and searches

Not sure where an error is coming from? Often, debugging code can feel like searching for a needle in a haystack. In the Translator, you can easily jump in and out of functions as they’re called in your script, making it incredibly easy to trace an error in your code all the way from the output to the original source of the error. You can also use the search bar to quickly find snippets of code or navigate to specific functions, which is particularly useful if you have a lot of code to scroll through.

For more information on these features and several other nifty tips and tricks, check out our help documentation at https://help.interfaceware.com/category/reference/translator !

  • No labels