Todas las guías

User Manual

El Manual del usuario en su idioma está en preparación. Mientras tanto, aquí lo tiene en English.

The catalogue and its prices 1:24 Descargar el vídeo

Texto del vídeo

  1. The health cards: figures about the catalogue; a click on a card shows only its tests.
  2. The patient's price; whoever holds Manage prices, contracts and commissions can type it in the cell and it is saved at once.
  3. Start from a similar test: search a similar test by name or code. Its department, specimen, unit, turnaround and reference ranges come with it.
  4. On the Packages page press New panel or package. Under Add a test to the panel search by code or name (two letters at least) and choose each test.
  5. A row of nine tabs under the name Prices and contracts pages. Filters and search narrow the list below.
  6. On the page Test prices, find the test and choose its row. Press Edit the base price.
  7. On the page Price lists, choose the list and press The list's items.

Chapter 30Catalogue

Menu: Catalogue. Address: /setup/catalogue.

30.1 What this screen is for

This is the laboratory's list of everything it can test: each test with its code, names, department, specimen, price and reference intervals, the panels and packages that group tests, the consent forms linked to tests, and the referring doctors. The order screens read from here, so what is written here is what the reception and the result screens offer.

The chapter describes how you read and maintain this list. It does not suggest changing the catalogue the program ships with: that stays as it is, and the screen is used for the laboratory's own settings around it (prices, intervals the laboratory sets, new tests it writes, panels it builds).

30.2 Who sees it

You can……if your role holds
Open the screen and see its filters and the details of a test; change a test, its intervals and its external laboratories; switch a test on or off; export, import, write a new test, add from the master library; tick tests and act on many at onceManage settings
Press New panel or package, and open a panel from the Packages page to edit itManage the test catalogue (on top of the permission above, which the screen itself needs)
Type a price in the list or in the panel windowManage prices, contracts and commissions

Without Manage settings the test window is read-only: the definition is shown as plain lines and no edit buttons appear. The bulk tick boxes, the top buttons and the Stop the test switch are absent (not greyed) without it. Without Manage prices, contracts and commissions the price in the list is plain text, and the price field is absent from the panel window. Without Manage the test catalogue the New panel or package button is absent and a row on the Packages page does not open. Saving reference bands and importing are for the laboratory's administrator; otherwise the screen says so.

30.3 The screen at a glance

Figure 30-1: The Catalogue screen: 1 the pages, 2 the health cards, 3 the filters and search, 4 the list, 5 the chosen test.
Figure 30-1: The Catalogue screen: 1 the pages, 2 the health cards, 3 the filters and search, 4 the list, 5 the chosen test.
  1. The pages: Tests, Packages, Consents, Referring doctors.
  2. The health cards: figures about the catalogue; a click on a card shows only its tests.
  3. The filters and search: departments, the search box, and the filter in force.
  4. The list: The laboratory's tests, newest added first.
  5. The chosen test: its details beside the list.

30.4 The Tests page

30.4.1 The buttons at the top

ButtonWhat it does
ExportDownloads the catalogue as a file.
ImportOpens the import window.
New testOpens the window for writing a new test.
Add from the master libraryOpens the master library window.

They appear only to whoever holds Manage settings.

30.4.2 The health cards

The cards count the catalogue: Catalogue complete (Active and shown in full), Active, External (Sent to another laboratory), and cards for what is missing. Click a card to show only its tests. Counting chooses whether the figures count Active tests or All tests.

The filters the cards offer:

FilterShows
In use / Stopped / AllTests by their state.
Sent outTests sent to another laboratory.
No reference range / Incomplete reference range / Ages to setTests with no interval, an incomplete one, or a band whose ages are still to be set.
No critical limitTests with no critical limit.
No priceTests with no price.
No specimen type / No sample containerTests with no specimen type or no sample container.
No Arabic name / No LOINC code / No method / No turnaround timeTests with no Arabic name, LOINC code, method or turnaround time.
A choice with no optionsA choice test with no options.
A panel with no members / A panel with a stopped memberA panel with no members, or one with a stopped member.

All departments and the department chips limit the list to one department. The line Showing: … names the filter in force, with Clear the filter; Clear the filters clears everything. If nothing matches the screen says so (No tests in this choice.).

30.4.3 The list

ColumnMeaning
CodeThe test's code.
NameIts name.
DepartmentIts department.
Specimen · where doneThe specimen and whether it is done here or sent out.
State · what it lacksIts state and what it still lacks (for example No price or No reference range).
Patient priceThe patient's price; whoever holds Manage prices, contracts and commissions can type it in the cell and it is saved at once; for others it is plain text.

The tick beside a line (and Choose all shown) chooses it for a bulk change. Choosing a line shows The chosen test beside the list: its reference bands, members and the packages that hold it; Open the test opens the test window. For a test inside a panel, the switch Ordered on its own says whether it can be ordered on its own; if off it is ordered only inside its panel.

Figure 30-2: The list with a test chosen: 1 the price cell, 2 the details beside the list, 3 Open the test .
Figure 30-2: The list with a test chosen: 1 the price cell, 2 the details beside the list, 3 Open the test.

30.5 The Packages page

Lists the panels and packages: Code, Name, Kind, Members, Specimen and State. Kinds of package chooses All, Panels or Packages. New panel or package opens the panel window.

30.6 The Consents page

Lists the consent forms: code or name, Kind (general, genetic, HIV, informed consent, research) and Tests linked. It is for reading and searching. With none, the page says «No consent forms yet.».

30.7 The Referring doctors page

Lists Doctor, Specialty, Organisation and Phone; the search box finds by any of them. It is for reading. With none, the page says «No referring doctors yet.».

30.8 The test window

Press Open the test on a test. The head shows its code, name and whether it is Active or Stopped; whoever may edit has Stop the test or Start the test there. A stopped test leaves the order list and keeps its history. The tabs:

TabWhat it holds
DefinitionThe test's fields (below).
Reference intervalsThe reference bands, with a count.
External laboratoriesThe laboratories it is sent to. Always shown to whoever may edit; to others only if the test is sent out or lists one.
MembersThe tests it is made of; shown only for a panel.
Packages that hold itThe packages that hold this test; shown only when there are some.
ConsentsThe consents linked to it, each marked mandatory or optional; shown only when there are some.
Doctor's interpretationThe doctor's interpretation, when the test has one.
Figure 30-3: The test window: 1 the state and its switch, 2 the tabs, 3 the reference bands.
Figure 30-3: The test window: 1 the state and its switch, 2 the tabs, 3 the reference bands.

30.8.1 The Definition tab

FieldWhat it holds
English name, Arabic nameThe names. The English name and the sample are required. If the Arabic name is left empty, the catalogue's own Arabic name is shown.
Other names it is found byOther names the test can be found by.
DepartmentIts department (or No department).
MethodThe method.
Price, Largest discountThe patient's price and the largest discount allowed.
TurnaroundThe time to a result, in minutes.
Sample volumeThe sample volume.
Needs fastingWhether fasting is needed.
LOINC code, CPT codeThe LOINC and CPT codes.
Its group in the reportThe heading it prints under in the report.
Clinical significance, Processing instructions, Reasons a sample is rejectedClinical significance, processing instructions, and reasons to reject a sample.

Press Save the test; it is enabled only when something has changed.

30.8.2 The External laboratories tab

For a test sent out. Choose a laboratory from Add a laboratory from the list (or Add a new laboratory), and for each give Laboratory's cost, Turnaround in hours and The test's code at that laboratory; mark one as Default laboratory, or Remove one. The cost is what the laboratory charges us; the patient's price does not change with it. Then Save the laboratories. A sent-out test with no laboratory leaves its orders waiting until one is chosen.

30.9 The reference-range window

Open it from the Reference intervals tab with Add a band, or Edit on a band. A band whose ages are still to be set shows Needs review: set the ages; its chip opens the band.

FieldWhat it holds
SexAll, female or male.
From age, To ageThe ages, each with a unit: days, months or years.
Low limit, High limitThe reference limits.
Critical below, Critical aboveThe critical limits.
UnitThe unit.
ConditionNo condition, fasting, cycle phase or pregnant.
Normal result's words (for a text result)The normal result's words, for a text result.

Press Save the band. The window refuses a first age above the second, a low limit above the high one, a critical-below that is not lower than critical-above, and a band with no limit, words or critical limit at all.

Figure 30-4: The reference-range window: 1 sex and ages, 2 the limits, 3 Save the band .
Figure 30-4: The reference-range window: 1 sex and ages, 2 the limits, 3 Save the band.

30.10 Tasks, step by step

30.10.1 Task 1 — Find the tests that lack something

  1. Click a health card, for example the one for «No price». The list shows only those tests.
  2. Narrow by department or type in the search box.
  3. Choose a line and press Open the test to complete it.
  4. Press Clear the filter when done.

30.10.2 Task 2 — Write a new test

The window A test the laboratory writes has four steps and a preview.

Figure 30-5: The new-test window: 1 the steps, 2 the fields, 3 the next button.
Figure 30-5: The new-test window: 1 the steps, 2 the fields, 3 the next button.
  1. Press New test.
  2. Start from a similar test: search a similar test by name or code. Its department, specimen, unit, turnaround and reference ranges come with it, never its name or price; if the unit differs the ranges are not copied. Or skip it: the test then starts empty.
  3. Name, department and specimen: the English and Arabic names (both must be written before the next button works), alternate names, department, specimen and Where it is done (In the laboratory or Sent out; it starts as In the laboratory). The specimen is required only when the window was opened from a partner's printed line.
  4. Result and price: Kind of result (Number, From a list or Text), the unit, or the values to choose from, one a line or separated by commas; the turnaround; the base price (neither can be below zero); the report heading; and whether fasting is required.
  5. Preview and check: Print preview shows how the result prints, and The catalogue's rules lists what the server checked. The window says when nothing blocks.
  6. Press Save the test. It works only after the check has finished and no blocker is listed. The window shows the code the test will take, and the screen confirms the save. If the server refuses, its reason is shown in the window.

The step titles can be clicked to go back, and a back button is offered except while saving. A blocker (for example a name already used by another test) stops the save until it is fixed; a warning is only shown.

30.10.3 Task 3 — Set a reference band

  1. Open the test and its Reference intervals tab.
  2. Press Add a band, or Edit on a band.
  3. Fill the sex, ages, limits, unit and condition as the table above says.
  4. Press Save the band.

30.10.4 Task 4 — Build a panel or a package

The panel window needs Manage the test catalogue.

Figure 30-6: The panel window: 1 the code and names, 2 adding a member, 3 the members' order, 4 Save .
Figure 30-6: The panel window: 1 the code and names, 2 adding a member, 3 the members' order, 4 Save.
  1. On the Packages page press New panel or package.
  2. Type the Code (Latin letters and digits), the Name and the Arabic name (Arabic letters), choose the Kind (Panel or Package) and the Department.
  3. Under Add a test to the panel search by code or name (two letters at least) and choose each test. Use the move-up and move-down buttons to order them and the remove button to take one out. The search offers only active tests that are not panels and not already in the list, so a panel inside a panel cannot be chosen.
  4. Optionally set the Panel price (shown only to whoever holds Manage prices, contracts and commissions); it is saved through the same price path as a line's price and recorded in the audit trail.
  5. Press Save. It is blocked, with the reason as a tooltip, until the code, name, department and at least one member are present, the Arabic name (if written) has Arabic letters, and no other test already has the name.

The code is turned to capitals, its spaces to hyphens, and is limited to 40 characters. Only a row of kind panel opens for editing; a package row does not. When editing an existing panel the code and English name cannot be changed from here (the Arabic name can), and Stop the panel or Restart the panel switches it.

30.10.5 Task 5 — Change many tests at once

  1. Tick the tests, or press Choose all shown. The bar appears with … chosen.
  2. Under Action choose one: Switch on, Switch off, Move to a department, Where it is done or Change the specimen, and give the department, place or specimen the action needs.
  3. Press Apply and confirm: the action reaches all the chosen tests at once. The button is greyed until the department, place or specimen is given (for the three actions that need one), and while the action is running.
  4. Clear the choice drops the choice without applying.

When it succeeds the screen says how many tests it was applied to. If it fails, the screen shows the server's reason, or the message in the table below; the program applies it to all or none.

Figure 30-7: The bulk bar: 1 the count, 2 the action, 3 Apply .
Figure 30-7: The bulk bar: 1 the count, 2 the action, 3 Apply.

30.10.6 Task 6 — Export and import

  1. Press Export to download the catalogue (the button is greyed while the file is being prepared).
  2. To import, press Import. The window explains the file: a CSV with the template's columns, each line a test created or updated by its code.
  3. Press Download the template to get the template, fill it, then Choose a CSV file. The window says how many test lines it read.
  4. Note the warning: a line whose code matches an existing test updates it. Then press Import; it is greyed until a file with at least one test line is chosen, and it disappears once the result is shown.
  5. The result reports how many were created, updated and refused; each refused line is named with its number and code (the first 20 are listed). If the import fails, the window says so and nothing is shown as imported.

30.10.7 Task 7 — Add a test from the master library

  1. Press Add from the master library.
  2. Type two letters at least in Search by code or name.
  3. Press Add it on the test. A test already there shows In your catalogue. If adding fails, a message appears beside that test.

A test is added with its whole template: unit, specimen and reference bands.

30.11 Messages and what to do

The screen saysMeaningWhat to do
This server does not show the catalogue yet…The server is older than the screenUpdate the program.
The catalogue could not be loaded.A connection faultCheck the connection and reload.
The action could not be applied. Nothing was changed.A bulk change failedTry again, or check the connection.
Only the laboratory's administrator imports.Your role may not importAsk the administrator.
Only the laboratory's administrator saves reference bands.Your role may not save bandsAsk the administrator.
The server did not accept this band. Check its values.A limit or age is not validRead the red line under the field.
The panel was saved, but … members were not acceptedA member does not exist or is itself a panelReopen the panel and fix its members.
The panel was saved, but its price was not changed.The price path refusedRead the reason given with it.

30.12 See also

Prices and contracts for price lists, Results where the intervals are applied, and Orders where these tests are ordered.

Informar de un error de traducción
WhatsApp Enviar el enlace de descarga a su computadora