Global Settings

The Global Settings page provides centralized management of core system configurations through a tabbed interface. Each tab controls a different aspect of system-wide settings that impact multiple modules across Musket.

The Company Settings tab displays your organisation's structure as a hierarchical tree. You can view and manage the primary company, subsidiaries, and departments in an expandable/collapsible view.

Understanding the hierarchy

The company structure follows this pattern:

• Primary Company: The top-level organisation (your company)
• Subsidiaries: Child companies owned by the primary company
• Departments: Divisions or departments within the primary company or subsidiaries

Viewing the structure

• The primary company appears at the top level
• Click the expand/collapse button ( / ) next to any item to show or hide its children
• Each item shows its name and type (Company, Subsidiary, or Department)
• Items can be active or deactivated—toggle between views using the radio buttons

Managing the structure

Common actions you can perform:

• Add Company/Subsidiary: Create new companies or subsidiaries in the structure
• Add Department: Create departments within companies
• Edit: Update details for existing entities
• Deactivate: Mark entities as inactive without deleting them
• Reactivate: Restore deactivated entities
• Reorder: Change the sort order of items at the same level

The Currencies tab manages the currencies available in Musket for financial transactions, invoicing, and reporting. You can add currencies, set conversion factors, and designate the system main currency.

Active and deactivated views

The tab shows two radio button views:

• Active: Currencies currently available for selection in financial forms and transactions
• Deactivated: Currencies removed from active use but retained for historical records

Currency table columns

Add a new currency

1. Click Add New Currency (top-right)
2. Enter the Currency name (e.g., "South African Rand")
3. Enter the Currency symbol (e.g., "ZAR" or "R")
4. Optionally check System main currency to set it as the default
5. Define conversion factors to/from other currencies
6. Click Submit to save

Edit currency and conversion rates

1. Click the Edit button () for the currency
2. Update the currency name or symbol if needed
3. Check or uncheck System main currency to change the default
4. Adjust conversion factors in the conversion rates table
5. Click Submit to apply changes

System main currency

The system main currency is the default for financial transactions and reports. Only one currency can be the main currency at a time. When you set a new main currency, the previous one automatically loses its main currency status.

Deactivate or reactivate a currency

To deactivate an active currency:

• Ensure it is not the system main currency
• Click the Deactivate button () for the currency
• The currency moves to the Deactivated view

To reactivate a deactivated currency:

• Switch to the Deactivated view
• Click the Activate button () for the currency
• The currency returns to the Active view

Search and pagination

• Search: Type in the search box to filter currencies by name
• Items per page: Change the number of currencies displayed per page (15, 30, or 60)
• Pagination: Use First, Previous, Next, and Last buttons to navigate pages

The Exchange Rates tab displays a historical log of exchange rate updates and allows you to submit new rates for currency conversions used throughout the system.

Historical exchange rates table

The table shows all previous exchange rate submissions with:

• Valid from (UTC): Date and time when the rates became effective
• Date submitted: When the rates were entered into the system
• Submitted by: User who submitted the rates
• Conversion rates: One column per non-main currency showing the exchange rate from the main currency

For example, if "USD" is the system main currency, you'll see columns like "1 USD : EUR", "1 USD : GBP", showing how many units of each currency equals one USD.

Update exchange rates

1. Click Update exchange rates (top-right)
2. The system pre-fills the form with the most recent exchange rates
3. Set the Valid from (UTC) date and time when these rates become effective
4. Update conversion factors for each currency pair as needed
5. Click Submit to save the new rates

The new exchange rates are recorded with a timestamp and your username, creating an audit trail of all rate changes.

Search and sort

• Search: Filter by date or submitter name
• Sort: Click column headers to sort by valid from date, submission date, or submitter
• Pagination: Navigate through historical submissions using page controls

The Active Countries tab controls which countries appear in dropdowns and forms throughout Musket. Countries are organized by continent for easier management.

Viewing countries by continent

The table groups countries by continent:

• Each continent shows a header row with its name
• A count displays the number of active countries in that continent
• Click the expand button () to show the list of countries
• Click the collapse button () to hide the list
• Countries display in a three-column layout within each continent

Manage countries

1. Click Manage countries (top-right)
2. A window opens showing all countries grouped by continent
3. Check the box next to countries you want to activate
4. Uncheck the box next to countries you want to deactivate
5. Use the search box to find specific countries by name, continent, or ISO code
6. Click Submit to apply changes

Search functionality

The search box filters countries by:

• Country name: e.g., "South Africa", "United Kingdom"
• Continent name: e.g., "Africa", "Europe"
• ISO code: e.g., "ZAF", "GBR"

Only active countries appear in dropdowns throughout the system, such as when selecting airport locations, client addresses, or crew nationalities.

The EFB (Electronic Flight Bag) Settings tab configures options for the Musket EFB application used by pilots on tablets and mobile devices.

EFB settings overview

The tab displays current EFB configuration options:

• Allow uploading flight documents (Pilot Flight Mode): Enables pilots to upload documents while using the EFB in flight mode
• Allow capturing post-flight actuals metrics (Pilot Flight Mode): Permits pilots to record actual flight data after completing a flight
• Allow creating flights (Pilot Flight Mode): Allows pilots to create new flights directly from the EFB application
• Allow Aircraft Mode: Enables a shared device mode where multiple pilots can use the same EFB device
• Aircraft Mode Password: Sets the password required to access Aircraft Mode (if enabled)

Edit EFB settings

1. Click Edit settings (top-right)
2. Check or uncheck the options to enable or disable features
3. If enabling Aircraft Mode, enter a secure password
4. Click Submit to apply changes

Changes to EFB settings apply immediately to all EFB users. Pilots may need to restart the EFB application to see the updated configuration.

Access to Global Settings is restricted to ensure only authorized administrators can modify system-wide configurations.

Required permission

Users must have the Global Settings (Full) permission to view or edit any tab on this page. This permission is typically assigned to:

• System administrators
• Operations managers
• IT support staff
• Senior management with system configuration responsibilities

What happens without permission

Users without the required permission see a "Not Authorised" message when they navigate to the Global Settings page. They cannot view or edit any settings on any tab.

Common issues and solutions

Global Settings is part of the Administration section. You may also need:

• User Management: Manage user accounts and permissions
• Role Management: Define roles and assign the Global Settings permission
• Organisation Settings: Configure equipment types and custom document library fields
• Services & Fees Settings: Manage financial services and fee structures