Instruments

Learn everything related to instruments, going from creation to modification! 

A - Context :

Instruments are one of the core components of the Ancitrak and ActKloud data structure. They store all collaborative information required to uniquely identify each instrument among all those in existence. At the writing time of thoses lines there here are the  informations that can be gathered.

Supplier (e.g. Aesculap) Reference (e.g. BC284R) Localized designation (e.g. MAYO-LEXER DUROTIP DISSECTING SCISSORS 16 CM) Normalized Pictures (e.g. 45 deg oriented picture shown as )

B - Use cases :

Identifying a cloud instrument is always done using the Supplier–Reference pair. As a result, the same Reference may exist across multiple suppliers. There is a wide range of possibilities regarding whether an instrument is marked or not. Ancitrak supports four distinct scenarios.

• (1) Supplier + Reference (e.g. Aesculap + FB402R)
• (2) Supplier + No Ref (e.g. Aesculap + NoRef)
• (3) No Supploer + Reference (e.g. NoSupp + 000129)
• (4) No Supplier + No Reference (e.g. NoSupp + NoRef) 

Note that Ancitrak and ActKloud always require an identifier. This means that if an instrument is missing either a Supplier or a Reference, a corresponding placeholder value (e.g., NOREF1920 or NOSUPP5939) will be automatically generated by the system. You may encounter this placeholder in various parts of the system.

ActKloud processes instrument references according to its own rules, removing unnecessary spaces, commas, dashes, and other characters. Don’t be surprised if the reference is automatically adjusted to something different from what you initially entered. These internal transformations are normally not visible to users, but this behaviour is completely normal and required for Ancitrak and its internal processes.

C - Features :

One specific aspect of our instrument pictures  is the concept of reinforcement. Reinforcement pictures are additional viewpoints of an instrument that are integrated into the database to help the system recognise it more accurately in the future. Note that the main picture (the one displayed in large) is also considered a reinforcement.

C1 - General Interface

In instrument Creation (related to a kit), you will always find 3 visual components for creation. All three areas must be completed with the required information in order to add the instrument.

• (1) Get instrument pictures (or/and reinforcements)
• (2) Indicate Instrument position on tray picture (if specific place) + set the quantity
• (3) Fill the instrument details form
  

Note at the bottom the action button, which changes depending on what you’re doing, more on it later!

See below for a detailed explanation of each area.

C2 - Instrument Reinforcement Area

Instrument Reinforcement area correspond to where we can take multiple pictures of an instrument to enhance its recognition. There is 3 states depending on the ongoing actions : 

• Left is when the instrument does NOT have any pictures
• Middle is when the instrument exists and there is at least one picture of it
• Right is when the instrument is being reinforced, multiples Reinforcements have been added

   Procedure   

(1)  Add first Reinforcement by clicking to the camera icon, the image will appear shortly, as shown below. Feel free to retake the picture by clicking the small camera icon.
(2) Add additional reinforcement images by repositioning the instrument and clicking the +camera icon. Each time you create a reinforcement image, you can choose to retake it or to discard/remove it. Its important to move the instrument between reinforcement giving the possibilité for the system to view the instrument from it's different perspectives.

Do not open instruments, keep them as they will usually be stored in the container!

C3 - Instruments tray positions and quantities Area

This area shows where the instruments are positioned in the tray. Placement is done by clicking the location the appropriate number of times, corresponding to the quantity of this instrument in the tray.

Exampe below for one instrument (MEDTRONIC+9568008), one yellow point for ine instrument.

Example below for two instruments (MEDTRONIC+955519), two yellow points for two instruments.

Green dots correspond to other instruments. When hovering over a dot, a small tooltip will display the instrument reference to help with localisation.

   Procedure   

(1)  Add first the quantity of instrument of this kind in the platform by adjusting the dedicated spinner
(1)   Adjust the position by clicking the map. See below the new position (in gray), the old position remain in yellow until the instrument validation.

C4 - Instruments details Area

The Instrument Detail Area is a form where all required instrument information is displayed or entered. Depending on the status or the creation step, the form may appear differently, as some fields can be greyed out (disabled from editing) to prevent incorrect usage.

There are two cases—either the instrument exists or not—and as you start typing in the Reference field, the software queries the cloud and displays autocompleted matches to verify its presence.

In the autocomplete list, some instruments already have images while others do not.   This means the instrument exists in the database but no images have been added yet. In this case, you are providing the first images for this instrument, and reinforcement photos will need to be added.

Instrument exists

When you select an instrument—whether it has a picture or not—the form auto-fills its values and locks the supplier name and supplier reference fields, while leaving the Designation editable so the user can locally override the instrument’s name within the composition. At this stage, you can also add a Comment that will be shown during the control step. 

Note that non-editable fields are greyed out. See below for a comparison between a greyed-out (non-editable) field (left) and a normal editable field (right).

Instrument does not exists 

If the reference doesn’t appear in the dropdown while typing, the form will wait until all mandatory fields (*) are filled. If your instrument does not have a supplier name or supplier reference, you can tick the corresponding opt-ins, which disable the related text fields, so you don't have to field them. 

Left image with typed reference, right with no reference and supplier names.

Note that creating a NOREFERENCE will prevent this instrument to ever be find again in autocompletion. While an NOSUPPLIER instrument that still have a reference can be proposed!

   Procedure   

(1)  Type the instrument reference in the corresponding field

(2a) Select the existing instrument and optionnaly overide the designation

(2b) If no instrument is found, simply complete the rest of the form with the designation and supplier name. 

This 2b setup is done once and for all: you or your colleagues won’t ever have to repeat this tedious step. This is the power of community! When you lean on the data from the cloud you make sure your reference is normalised accros the network.

C5 - Action Area (bonus)

At the bottom of the screen, you’ll find the validation button. It has two different displays: one when creating or adding a new instrument, and another when modifying an existing one.

1 - Here the create / add shape with a clear action.action :

Here the modification display

Note that when the form in not filled with all the mandatory information it will keep the button grayed out!

2 - Here the modification action : 

D - Full procedure

For now, adding an instrument is always done within the context of a composition. This means that when you add an instrument, it is first created, then immediately inserted into the composition. As a result, the add-instrument procedure must be performed during the kit creation process. You can find more details about kit creation here (link).

TODO : add picture to illustrate

For now, let’s sum up the steps to add an instrument.

• 1 reinforcement

Click

• 2the traytray’s position
contextual
• 3menu formand info
select
• 4Add validationinstrument.

• Type the first letters or digits of the reference.

• Select the instrument from the dropdown or complete the form if it doesn’t appear.

• Add one or more reinforcements, depending on whether the instrument already exists or not.

• Place the instrument localization on the tray by clicking directly on its image.

• Adjust the quantity,

• Once all required fields are completed, the Add button becomes active—click it to proceed.

Also, let's sum up the steps to modify an instrument

• click the instrument you want to modify
• adjust the values according to your needs, usually designation, quantity or localization in the basket.
• Click Modify

Note that, for now, there is no way to delete an instrument from the database. If something is wrong with an instrument, you can either modify it or simply remove it from the composition. The instrument will still exist in the database but will not be referenced in any composition. We periodically garbage-collect these orphan instruments and decide whether or not they should be globally deleted.