Tool : TinderBox 2018-04-10T06:45:54+00:00

Tool : TinderBox

Application Menu Bar

The majority of functionality is controlled via the menu bar. The Menu items are described in order left to right:

  • The ‘Bundle List’ view shows a tabbed interface describing properties of the resource entry”
  • The ‘Bundle Tree’ shows a graphical representation of the resources in the tree based on their references
  • ‘View as XML’ displays the XML for the selected resource entry
  • ‘View as JSON’ displays the JSON for the selected resource entry
  • ‘Reload Bundle’ will reload the bundle and update based on any changes
  • ‘Focus on Root’ will ensure that the display context is on the root entry of the Bundle
  • ‘Validate Bundle’ will run the resource validator for each entry in the Bundles

Bundle Entries

When a bundle is loaded the individual entries are shown on the left-hand side of the screen as per the image above.

This shows information relating to the individual entry:

  • The number in the blue circle is the index of the entry within the Bundle
  • The smaller circle signifies the validation status of the entry (Green is valid, Red is invalid and Grey denotes no validation)

  • The resource type is shown in the large letters with the ‘FullURL’ of the entry shown below
  • The ‘out’ count in the form xx/yy where xx is the count of outbound references in the resource and yy is the number of references that have been located within the bundle. For most cases these should be the same, if they are not they are shown in Red to prompt further investigation

  • The ‘in’ count shows the number of references (in other resources) that refer to this resource

If a Bundle contains an inner Bundle then it as shown as above. By clicking on the Red Bundle button the focus changes to the inner bundle. To return to the root bundle click ‘Focus on Root’ on the menu bar.

Bundle List

When the Bundle List view is selected the right-hand side of the screen shows details relating to the bundle entry selected.

The ‘Entry Details’ tab shows details relating to the selected entry in the bundle and the resource type it contains.

The following is shown for each entry:

  • Resource Type – The type of resource in the bundle entry
  • Full URL – The ‘FullUrl’ of the bundle entry
  • Profile – The ‘URL’ of the profile that the resource asserts it is conformant to
  • Validation – The will have a value of ‘None” if the validation process has not been applied. If validation has taken place then it will either have a value of “OK” or a table of fault conditions that have been detected.

The ‘Outbound References’ tab shows details of any references within the resources and whether the reference can be resolved within the Bundle.

For each outbound reference, the following is shown:

  • Path – The location within the resource that has the outbound reference
  • Target – The value of the reference (i.e. where the reference is ‘pointing’ to)
  • Located – If the reference can be resolved within the bundle the location and resource type it resolves to are displayed. If the reference cannot be resolved then this is stated

The ‘Inbound References’ tab shows details of any references in other bundle entries that refer to this entry.

For each inbound reference, the following is shown:

  • Source – The bundle entry and type of resource that is referencing this entry
  • Path – The path within the referring resource that contains the reference

Bundle Tree

When the Bundle Tree view is selected the right-hand side of the screen shows a graphical view of the relationships between resources in the bundle.

Starting from the initial entry in the bundle the references of each resource are traversed to build a “tree” of relationships using the “outbound” references within each resource.

For each inbound reference, the following is shown:

  • Source – The bundle entry and type of resource that is referencing this entry

  • Path – The path within the referring resource that contains the reference

Resource Validation

The resources within the bundle can be validated against the profiles they assert they are conformant with. To do this use the “Validate Bundle” button on the menu bar.

Each resource will now be shown with a green tick or a red cross denoting the outcome of the validation process

When validating the resources there are a few points to consider:

  • For Bundles with a lot of entries, the validation process can take a little while – be patient.

  • The directory containing the profiles needs to be stated in the settings.

Technology Inside

The TinderBox application was originally constructed as a test case for using FHIR Path and grew into something different altogether. The different technology components used within the application include:

C#
.NET
XAML
FHIR STU3
FHIR PATH
.NET API

Release History

The recent releases of the application include the following enhancements and fixes.

Download ZIP

Download the product now

VERSION 2.1.2 is currently available as a free download.


The public version of this tool is available now. For those participating in the private beta then use the download link already supplied.

Download ZIP