Organisation

Organisations are metadata for contacts and genotypes. A contact’s organisation may be their employer. Genotype organisations are intended to store the origin of a genotype.

An initial Katmandoo installation only includes one organisation, called Unknown Organisation.

Searching for an organisation

Searching the database for organisation records requires 3 fields. A column, a condition, and values. Clicking the search button will build the query based on the selected fields and will produce a table of results below the search box.

Quick Tip: To perform a quick search for all organisation records, simply click the search button after the page loads. This will run the search using the “All” condition.

To perform a filtered search, select a column to filter using the Column Name drop down.

Organisation Column Name
Please note that this will always have a default value – So it does not have to be changed for the search to work

After a column has been selected, select a filter condition to apply to the column. The filtering conditions available in the drop down are based on the based on the data type of the selected column name option.

Search Field Data Types

Text

String – Alpha Numeric

Eg. OrganisationName

Number

Decimal or Integer

Eg. OrganisationId

Boolean

True/False Value

Eg. IsActiveOrganisation

Date

Date/Time Value

Eg. OrganisationJoinDate

Changing the condition to “All” will clear any values entered for that rule.

With a Column Name and a Condition selected the values need to be entered to search for.

The Value(s) text box allows multiple line separated values. Entering multiple values works applies and “Or” operand to the filter.

Search Page Values
If the condition for search is “starts with”, then the above input will find all values starting with “A” or “1”.

To refine the search further, additional search rules can be added using the “Add Rule” button. This button adds an additional filter row to the search input area with the same selections as the previous row.

Search Page rule

Additional filter rows provide “And/Or” operands to separate filters. The order of operands may have an impact on the resulting data set.

Additional filter rules can be removed using the “Remove Rule” button. To reset the form click the “Clear Form” button.

Multiple Rules Added
More than the two rules can be added by clicking the “Add Rule button”

Search Controls

After a valid search has been completed, a table of results will be displayed below the search box. To sort and apply paged results additional search controls are available below the filters.

For a default the table only shows 10 Results per page. This can be adjusted by changing the dropdown and choosing a new value

Search Page Results Per Page

The table will also be displayed with pagination (split into multiple pages). To navigate between the pages there are three buttons that allow to move between pages.

Search Page Results Controls

Hitting the “First” Button will go to the first Page while the “Next” and “Prev” buttons will go to the next and previous page sequentially.

The page number of the page being displayed will be shown on the right of the table, just above it.

Search Page Results Page Number

The table also gives the option to change how it is sorted. If the “Sort By” dropdown is selected it allows the choosing of one of the Column Names to search by. After the desired Column Name to search by is selected the order (Ascending or Descending) will also need to be specified.

This is set to Ascending by default as represented by the “Down Arrow”. Selecting this Arrow button will change the arrows direction while also changing the order.

The table will not update until the search button is hit again.

Search Page Order Results Ascending Descending

Adding an organisation

In Katmandoo 3 there are two ways of adding an organisation, through Importing and through the search page.

While on the search page, there is a button in the top right labelled “Add Organisation”, selecting this button will take the system to the Add page.

Organisation Add Button

While on the Organisation add page, by default there will only be one field to enter data into, Organisation Name.

Organisation Add Page

However if there has been a factor (or multiple factors) created for organisations, then there will be multiple fields to enter data into.

Organisation Add Page with Factor
To add a factor for organisation the “Table name of Factor” needs to be “Organisation Table”

After the Organisation Name is supplied, hitting Save will add it to the database

Organisation add page with Data

If it was successfully added to the database the system will redirect to the View page for that Organisation

Organisation View page

Please note that the Id will be different depending on how many organisation have already been added.

Editing an organisation

To make a change to an organisation in the database it must be done through the Edit Page.

To get to an organisation’s edit page it must first be found in the database. Using the search methods above the organisation will appear in the results table on the search page.

Organisation Search Results Table

On the rightmost column of the organisation there is an “eye” icon. Clicking this will take the system to the view page for that organisation.

Detail Eye Icon

On this view page, there are two options; Back, which goes back to the search page.

Edit which goes to the edit page for the current Organisation.

Organisation view page edit button

As with the add page, the edit page allows for the addition of factors. On the edit page organisation factors can also be edited

Organisation edit page with factor

The edit page looks similar to the add page, but with the addition of the Organisation Id.

To make an edit to that particular organisation, alter the fields and hit save

Organisation edit page
While the Organisation Id it looks like a field that can be edited, it cannot as the Id is permanent.

If the database was successfully updated the system will return back to the view page for that organisation and the changes that were just made should be visible.

Importing organisations

In Katmandoo there is the ability to add multiple organisations all at once by importing data.

The system will only take a file with the type; .CSV or .XLXS/XLS anything else will be rejected.

To begin an import there are two points of entry. There is a global button on all pages on the left in the sidebar. Expanding out organisations will give the option to import organisations.

Organisation Import button sidebar

There is also a button that allows for importing organisations on the search page.

Import Organisation button on search page

The import page for Organisation will have two different ways for selecting the file to use for the import.

The first option, “Select Import File” gives the option to select a file from any of the previously uploaded files to the system.

If running an import for the first time, this should be empty.

Import Page

The other option allows files to be directly uploaded from the device Katmandoo is currently being accessed on.

On the import page there is also a button that will automatically generate a template XLXS file that has all the possible headers for organisations.

The template has two sheets with the first one where the headers are located and where data would be inserted. The second sheet merely has all the information surrounding the headers and any factors.

If an XLS or XLXS file is uploaded the system will come with another prompt if the spreadsheet has more than one sheet.

Once a sheet is selected and the “next” button is pressed the system will show all of the headers from the file and try to automatically map them to Columns in the Database.

Organisation Multiple sheets

If a CSV file is uploaded or if an XLSX /XLS with only one sheet in the spreadsheet, the system will skip the prompt for choosing the worksheet and will show the headers with their relevant mapping.

Import Page when using Template
If the downloaded template is being used, then the import mapping will look exactly like this

The system will try to match the column headers to the database fields automatically, but if it didn’t there it can be done manually.

Organisations successfully mapped

If there are any headers that need to be uploaded that are red and have a cross next to them, it means that they are not mapped to a database field and need to be set manually.

By clicking on the dropdown that says “–Not Mapped–“ the system will show all of the database fields that are linked to Organisation Table in the factors (columns). It also includes all the aliases of them as well.

If all of the required fields have been mapped to databases and the next button is hit, the system will come up with confirmation.

If there are new records in the data base the system will number the amount of new records it will be adding.

If records a just being updated then the system will give the number of records being updated also.

After hitting save, the system will attempt to make those changes to the database returning a positive message on the home screen if it was successful.

To confirm that the import was done without error. Go to the Search Page and run a search for the newly imported organisations

Exporting Organisations

On the organisation’s search page there is a button for exporting data.

By clicking the export button a the system will generate a pop-up

SearchPageExportButton

The export Organisation Data popup has several buttons and dropdowns with some being more useful than others.

The first dropdown cannot be changed as there is only one Export type for organisation

Under the heading “Available Columns” there is a full list of all of the available columns for export. Under the export type there is an option to choose an export template which will allow users to save a template of the columns they want form that list to export.
The two default settings are, all columns and no columns.

When doing a data export it can be time consuming having to go through very large lists of available columns.
However Katmandoo allows the creation of templates which can alleviate this issue.

When creating an export template, first the “new” button will have to be selected, in the Export Template Row

After this, a new row will appear asking for the new Template’s name.

To create a template first all the columns that are desired must be brought across from the available columns list. Then while in the Export Columns list, they can be ordered by using the up and down arrows.

If a name is supplied and the desired columns are added then hitting the save button will Save the template.

Then if the template is to be used, it will now appear in the dropdown

Going into any export and then hitting apply will automatically add what was save in the template (If it exists in the Available columns list).

To choose what columns are needed the blue buttons in the middle are used for this navigation.

Please note that by holding in shift multiple Columns can be selected at a time

This button moves the selected available column to the list of Export Columns
This button will move all of the available columns to the
export columns
Please note that for large amounts of columns the system
may take time to load
This button moves the Export Columns out of the list of
Export Columns
This button will move all of the export columns back to
the list of available columns
This button will move all of the selected columns up in
their order  
This button will move all of the selected columns down
in their order  

Another feature that exits for ease-of-use in the export window is the two search bars

There is also an option at the bottom of the window that is prompting for a file format to export to.

If there are large amounts of columns in either the available columns or the export columns lists. There is the ability to search for something specific.

The list will filter as characters are entered and if there is no possible match it will appear blank.

Please note: that the search is not case-sensitive

There is also an option at the bottom of the window that is prompting for a file format to export to.

By default this is set to be a CSV file, but it can be changed to be a XLSX file.

Export File format

Once a set of Export columns are selected, hitting the “Export” button will allow the system to download the exported file.