What's new in the EMu Help

This version of the EMu Help was published on Tuesday, 20 July 2021. It has been prepared for EMu version 5.1 (and earlier).

Updates include:

Date

Page / Section

Details

19 Jul 21

Step 2: Create the report in Microsoft Word

Amendment to the example VB code to ensure that 64bit DSNs are used when a user has a 64bit version of Office installed; otherwise 32bit DSNs are used.

19 Jun 19

Scheduled Exports

Clarification: details on most tabs in the Schedules module, including the Schedule, Fields, Conditions, Exports and Security, are read-only.

06 May 19

Update to XML / XSL code examples. Previously, when creating a Page View and configuring an import using the Import Tool, encoding was specified as encoding="iso-8859-1"; with EMu's support for Unicode, encoding must now be specified as encoding="UTF-8".

30 Apr 19

 

EMu Help updated with Axiell's new look.

26 Jul 17

 

Added dynamic scroll-to-top feature.

25 Jul 17

Search filter

New search filter added to limit search results to documentation for Users (i.e. excluding Administrator documentation). To limit search results, select a filter from the drop list in the Search bar:

24 Jul 17

Usability

A couple of usability features added to the Help:

  • The Header bar (containing the main menu and search bar) is now fixed and remains in view when scrolling through a page's content.
  • A [Close] option has been added to the bottom of all Drop downs.

30 Jun 17

Quick Help

Added Quick Reference Guide pdf for download.

19 Jun 17

Types of Search

Explanation for why a NOT search does not return records that have no value in the searched field (and how to work around this).

02 Dec 16 EMu 5.1 Release Notes Details of the EMu 5.1 release.
01 Dec 16 Multimedia enhancements

New features include:

25 Nov 16 Copy List Items

Functionality has been added to support the copying of items in list dialogue boxes. This includes:

  • Insert and Query Defaults
  • List Columns
  • Record Templates
  • Reports
  • Shortcuts
  • Sorts

The copied item is named automatically and ownership of the copied item changes to the current user. For Report list items the report file is also copied and automatically assigned a new name.

05 Sep 16

ADO Reports

EMu's Reporting subsystem was modified in order to bypass some filtering which occurs when a Crystal Report or Microsoft report (Excel, Word, etc.) is generated out of EMu. Bypassing the filtering improves report generation and performance.

25 Aug 16

Thesaurus module

Details about the Browse View and Hierarchy View tab introduced with EMu 5.0.

24 Aug 16

Wildcards in a Global Replace

Updated. The introduction of full Unicode support with EMu 5.0 affects the use of wildcard characters when searching. Currently it is NOT necessary to escape wildcards in a Global Replace.

24 Aug 16

Punctuation in Lookup List values

While the introduction of full Unicode support with EMu 5.0 affects searching in particular, it does impact other parts of the system. The most notable change is that punctuation is now significant in Lookup List values.

18 Aug 16

Search

Full Unicode support was introduced with EMu 5.0. The impact of Unicode support is felt most when searching, which is greatly enhanced. The Search section of the Help has been updated with details of how searches are performed in EMu 5.0 onwards.

15 Aug 16

EMu's support for Unicode

Full Unicode support was introduced with EMu 5.0. Unicode support affects several areas of the system, especially searching. Full details are provided.

12 Aug 16

Texpress: optimising and configuring the database engine

Detailed documentation about the Texpress configuration subsystem and tools for achieving optimal indexing of database tables.

Includes details about:

  • The params file used for storing configuration settings.
  • texanalyse, texdensity, texconf.

09 Aug 16

Tabs Registry entry (Tab Switching) Clarification added: If two tab switching Registry entries specify the same tab name and one is preceded by a - and the other by a +, the tab will always display.

08 Aug 16

Tools>Move menu option

EMu 5.0 includes a new Tools>Move menu option for Events modules that use the Exhibition Objects extensions. Objects selected in the Objects Associated With Event table of the Objects tab can be moved to another event; associated Exhibition Objects records are simultaneously updated.

See How to move objects from one event to another for details.

27 Jul 16

Unique Strict Registry entry

Updated with an explanation of the difference between the Unique Override and Unique Strict Registry entries.

2016

 

Conversion of EMu Help from .chm to HTML5.

16 Nov 15

EMu 5.0 Release notes

Release notes for EMu 5.0 added.

15 Jun 15

ServerPath Registry entry

Details about the ServerPath Registry entry.

20 May 15

How to import multimedia and attach it to a record

How to construct a .CSV import file to import an image and attach it to a record (a Catalogue record in this example).

28 Apr 15

Column CSS Registry entry

Used to specify the default font family and font size for EMu client controls that display HTML formatted text (i.e. KEHTMLFrame controls).

30 Mar 15

How do I copy and paste multiple values on which to search?

Details about copying and pasting multiple values (from MS Word or Excel for instance) into a search field.

26 Feb 15

Reporting with MS Excel

Updated to cover creation of reports with Excel (Office 2013).

Dec 14

Administration

Review of Administration section continues. Sections reviewed include:

13 Nov 14

Circa|Ranges Registry entry

Updated.

25 Sep 14

Integrated Pest Management (IPM)

Details about EMu's Integrated Pest Management.

12 Sep 14

Change to Scheduled Exports

It is now possible to exclude one or more scheduled exports from the standard scheduled run by specifying the -x parameter, e.g. -xirn[,irn,..] (where irn is the irn of a record for a scheduled export specified in the Schedules module).

26 Aug 14

System Technical Requirements

Details about EMu's technical requirements, as well as example system configurations.

15 Aug 14

EMu 4.3

Release Notes for EMu 4.3 added.

22 Jul 14

GUID Support

Details about EMu's support for GUID.

04 Jun 14

Registry entries

Reorganised.

May-Jun 14

Multimedia Registry entries Registry entries

Overhauled.

May 14

Record Level Security

Overhaul of Record Level Security documentation:

15 Apr 14

Fix applied to Animations

Error introduced with the previous build of Help meant that animations failed (stepping through processes). The animations work again.

07 Apr 14

Scheduled Operations module

Details about Scheduled Operations.

The Scheduled Operations facility introduced with EMu 4.3 enables the scheduling of operations to be run immediately or at a specified date and time.

03 Apr 14

Version Registry entry

Updated.

Mar 14

Administration

Review of Administration section continues. Sections reviewed:

Columns / Fields

Feb 14

Administration

Review of Administration section commences. Sections reviewed:

The EMu Registry

15 Jan 14

Correction to Import Tool documentation

Incorrect use of double quotes when referencing a value in a CSV Import file, e.g.:

LatSource_tab(+ group="opinion")

should be

LatSource_tab(+ group='opinion')

14 Jan 14

Release Notes

Section added: new features, improvements and resolved issues.

18 Dec 13

Import Tool Training

Minor corrections.

17 Dec 13

Column Access Registry entry

Explanation of the effect of hiding the first field in a group box.

16 Dec 13

(Record Level) Security Registry entry

Clarification regarding use of Attachment fields in Security Registry entries.

18 Nov 13

Various

Various updates as a result of the EMu 4.2 release, including details about:

02 Aug 13

Update to Ditto Skip Columns Registry entry

Clarification about the Ditto Skip Columns Registry entry: by design it does not apply to Ditto Current Field (F9).

02 Aug 13

Update to Column Access Modifier Registry entry

Description of limitations when performing a Global Replace: setting -duReplace on a column does not guarantee that users are unable to perform a Global Replace on that column, and in some circumstances a -duReplace permission set on a column in a record will be ignored when a Global Replace is performed.

06 May 13

Editing in a single language

EMu 4.2 has seen the introduction of a number of extensions that provide a more flexible mechanism for displaying and altering data within a single language:

  • When the All Languages option is selected, users may now select the order in which languages are displayed (but not, it is important to keep in mind, the order in which language data is stored in EMu, which is defined by the Supported Registry entry). This allows users who are dominant in a particular language to display this language first with other languages following.
  • User may now alter data while a single language is displayed. Any data entered into a field will only update the value of the language selected.
  • When displaying data in a single language and a value does not exist for a given field, the value of the first filled language may be displayed. The text is shown in a user selectable colour (grey by default) to indicate that it is not associated with the current language. When the field is entered, the text is removed, allowing data to be entered.
  • A number of data entry helpers always display all languages in the user defined order to assist data entry. For example, if a Lookup List is displayed, all languages are always shown so that users may select the correct entry based on context. This is particularly important where one term in a given language has multiple terms in another language.

    Many changes introduced to the Help to accommodate the new Language facilities, including a new section - Support for languages.

05 Apr 13

A warning about partial range searches

New topic added to explain how to perform a range search with a partial date / latitude / longitude, etc.

07 Mar 13

How to add multimedia to a report

Updated.

06 Mar 13

Unique Strict Registry entry

Correction.

28 Nov 12

Lookup List Maintenance background service

To reduce the nightly system maintenance and to allow the Lookup List table to be used as a regular module, EMu 4.1 has added a background service that ensures the Lookup List entries are always in sync with the records in the EMu system. The addition of the service removes the need to rebuild the Lookup Lists on a nightly basis, hence reducing system maintenance time.

Furthermore, as the Lookup List table is no longer reloaded, the Lookup List module has been extended to include support for attributed notes (Notes tab) and multimedia (Multimedia tab). Audit trails on individual records are now maintained and Record Level Security may be used as for any other module.

Although a Lookup List rebuild program is still provided, it now applies changes to the eluts table rather than rebuilding the table completely. The introduction of the Lookup List service means that rebuilds are only required if the Lookup List table becomes corrupted, or if users accidentally delete records that are still in use.

26 Oct 12

Mandatory Modifier Registry entry

The Mandatory Modifier Registry entry allows the mandatory setting on a column (set using the Mandatory Registry entry) to be adjusted based on the value in other field(s). Part of EMu's Dynamic Security options.

26 Oct 12

Archive View

Archives tab functionality is sufficient for viewing the structure of an Archive hierarchy for the current record, but it does not provide a simple mechanism for relocating other records within the hierarchy (i.e. records other than the current record), nor does it allow the hierarchy to be restructured easily. In order to address these two shortcomings and provide a constant visual reminder of the archive hierarchy, EMu 4.1 introduces the Archive View facility.

26 Jun 12

What to do if you've forgotten your password

Topic and FAQ added.

23 Jun 12

Dynamic Security

Minor corrections.

08 Jun 12

Collection Descriptions module

Details about the new Collection Descriptions module added.

25 May 12

Operations Registry entry

New daMerge operations privilege added and daReplace modified.

25 May 12

The EMu Collections Management System

Updated.

26 Mar 12

Reportable Registry entry

New Registry entry specifies whether a column can / cannot be included in a report.

22 Mar 12

Security

Two Registry entries added:

  • Security|Update Registry entry

    Allows the contents of one or more fields to be modified based on the value in a field whenever a record is saved.

  • Column Access Modifier Registry entry

    Used to modify the default Column Access values based on data found in the current record.

    A new Security section has been added to Working with EMu records. This contains general user information about Record Level Security and Dynamic Security. Information for Administrators has been added to a new Security section: Administration>The EMu Registry>Registry Settings. This contains security Registry entries (including Record Level Security and Security|Update). Note that the Users / Groups section (which holds access / permissions Registry entries) has been moved to this new Administration Security section.

28 Feb 12

Image File Extension Registry entry

Updated.

31 Jan 12

Index

Updated.

24 Nov 11

After Export facility

Introduced with EMu 4.1, the After Export facility allows a command to be executed once an export has completed. Amongst other things, the command can:

  • Email the export files to a list of users.
  • Email the results of the export to a list of users.
  • Copy the export files to another machine behind a secure firewall.
  • Copy the export files over the internet via a secure transfer mechanism.
  • Send an SMS to a list of telephone numbers.

19 Oct 11

Password Management

The implementation of password management in EMu 4.1 provides System Administrators with a range of options in terms of managing user authentication and ageing passwords. It also allows users to change their passwords from within the EMu Windows client.

17 Oct 11

Lookup Registry entry

Addition of the AutoWriteIgnore permission, combining the AutoWrite and WriteIgnore permissions.

17 Oct 11

Operations Registry entry

Addition of the daDittoAll operations privilege. Required in order for a user / group to use the Edit>Ditto>All Fields (SHIFT+F9) option.

17 Oct 11

Indexing Registry entries

New Indexing Registry setting that sets the unique attribute for one or more columns in a table. The Unique Index setting is available from EMu 4.1 onwards.

21 Jun 11

Supplementary Media

Introduced with EMu 4.1, the Supplementary tab in the Multimedia module allows associated resources to be stored with a master resource in the same Multimedia record.

10 May 11

Tools>New>[record]

In certain modules it is now possible to create an attachment record from the current record using the Tools>New menu. From the:

  • Events module it is possible to create a Loans record
  • Events module it is possible to create a Conservation record
  • Loans module it is possible to create a Movements record
  • Loans module it is possible to create a Conservation record
  • Movements module it is possible to create a Conservation record
  • Traps module it is possible to create a Trap Events record

09 May 11

Traps and Trap Events modules

Two modules, introduced with EMu 4.0.03, provide pest management support:

  • Traps

    Records information about the type and location of traps used by an institution to capture pests.

  • Trap Events

    Records information about what was found in a trap on a given date.

    A comprehensive set of reports provides graphical data about the prevalence of pests within your institution.

01 Apr 11

Exhibition Objects module

Replaces the Exhibit Items module.

The Exhibition Objects module is intended for Art based EMu clients. The module holds details about a particular object at a particular event, and includes:

  • Exhibition information, e.g. the location of the object within the exhibition.
  • Maintenance information, e.g. does the object need to be replaced or does it have any special requirements while the exhibition is under way.

    The Exhibition Objects module sits between the Events and Catalogue modules and holds details about an object that is associated with an event.

    When an object is attached to an Events record, an Exhibition Objects record is automatically created. Removing an object from an event deletes the associated Exhibition Objects record.

11 Mar 11

Read Only Registry entries Registry entries

Prior to EMu 4.0.03 it was possible to make the back-end tables read-only (and it still is), however the EMu client did not reflect the read-only nature of the table in the module interface: it was still possible to select the menu entry to insert a new record, but an error would then be displayed as the table was read-only. The ReadOnly Registry entries control the EMu client while still leaving the back-end tables operational. This means that the menu entry to insert a new record is now disabled if the table or system is marked as read-only.

10 Feb 11

Multi-group Support

EMu 4.0.03 introduces multi-group support, which allows a single user to be registered in more than one group:

  • A user who is a member of more than one group can select the group name to use from the Login dialogue box when logging into EMu.
  • At any time it is possible to switch to another group without logging out and back in again.
  • When switching groups the user decides whether opened modules should remain open or whether they should be closed.
  • Any new modules opened will use the group permissions assigned to the group that the user switched to.

    See How to log in and out of EMu for details about logging in to EMu when you are a member of more than one group.

    See Switching between groups for details about how to switch between groups in EMu.

    See Group Registry entry for details about assigning users to more than one group.

    See Multi-group Support: security profile extensions for details about how the EMu server security profiles provide support for multiple groups per user.

12 Dec 10

Encrypted Connections

EMu 4.0.03 has been extended to support an encrypted connection between the client and server programs.

27 Sep 10

How to edit a resource in the Multimedia module

Details about how to open the master multimedia resource, edit it and save it back to EMu.

16 Sep 10

emuperiodic

Updated.

06 Sep 10

Export Schedules

Changes made to the Export tab of the Export Properties dialogue box and to the layout of the Schedules tab of the Schedules module.

19 Jul 10

Example filter

Correction to Example Filter.

11 Jun 10

Export Schedules

EMu 4.0.02 introduces a new facility that enables data to be exported on a regular basis. Users can define:

  • A set of fields for export.
  • A sort order for the exported records.
  • A TexQL statement to determine which records to export.
  • Dates on which the export is to occur.

17 May 10

The ArcExplorer Report

Details about the new ArcExplorer report, which takes EMu records with location (latitude / longitude) information and displays them on maps in the third party application, ArcExplorer.

06 May 10

ShowTreeChildren Registry entry

The ShowTreeChildren Registry entry specifies the number of levels to display below the current node in a hierarchy on the Hierarchy tab of the Taxonomy module.

06 May 10

EMuWeb

Details about installing and configuring EMuWeb.

This content, which was previously available from the KE Website, is ONLY recommended for clients who already have an EMuWeb implementation.

19 Apr 10

How to append data using the Import facility

Details about using the Import tool to append data to tables and nested tables of values.

10 Mar 10

Right to Left Language Support

Details about EMu's support for display of right to left languages.

18 Feb 10

Multimedia Audio/Video|Exclude Registry entry

The Multimedia Audio/Video|Exclude Registry entry has been removed from EMu.

08 Dec 09

Introduction to EMu

Expanded.

29 Oct 09

Related objects

Clarification.

16 Sep 09

Geo-referencing Tabs

Details about the geo-referencing tabs and functionality added to the Sites and Collection Events modules.

10 Jul 09

Set|Property (Resolution) Registry entry

Two new Registry entries allowing the resolution of generated images to be specified.

09 Jul 09

Mail Merge Report

How to create a mail merge report has been updated due to changes with Microsoft Word.

30 Apr 09

Unique Registry entry

Updated. Unique Registry entry has been extended to apply to nested and double nested tables.

02 Apr 09

Taxonomy module: Tabs

Taxonomy section updated with details of four new tabs:

26 Mar 09

Archive|User Defined Ordering Registry entry

Details about the Archives Registry entry added. This entry specifies that the Make the current record a child of the selected record and Move the current record above the selected record buttons display on the Archives tab of the Catalogue module.

25 Mar 09

Reports

Updated further, in line with the new EMu Reports training course.

25 Mar 09

Uniqueness checking and Auto-incrementation

Clarification.

05 Mar 09

Multimedia compression quality

It is now possible to specify the compression quality of JPEG images generated in EMu.

The Resolutions Registry entry has also been extended to automatically include a compression quality for JPEGs.

04 Mar 09

Statistics Module

Details about the Statistics facility (introduced with EMu 4.0.01). This facility allows statistical information to be generated on a regular basis (hourly, daily, weekly or monthly) and stored in the Statistics module for later use.

22 Jan 09

Context IDs / Related Information

Context IDs have been added to the footer of most pages in this Help, making it easier to use the What's This Help utility to link directly to a page from within EMu.

19 Jan 09

Lookup Exact

Details of a new Registry entry that enforces a strict comparison of terms entered into a Lookup List.

15 Jan 09

How to view attachment records

Clarification.

14 Jan 09

Merge Records

View Attachments Registry entry

Clarification.

22 Dec 08

Reports

Overhaul of reports documentation. Sections that have been updated to date:

  • Introduction to EMu Reports
  • How to generate a report in EMu
  • How to create a report in Microsoft Excel (without needing Visual Basic code!)
  • How to create a report: Step 1: Create the report in EMu
  • How to create a report: Step 2: Design the report in a third party application: Crystal Reports
  • How to create a report: Step 3: Save the report to the EMu server.

26 Nov 08

Copy Special: Copy & Paste in List View

The Copy Special utility allows you to specify what character(s) or notation should be used at the end of a paragraph or row when copying records in List View and pasting them into another application.

08 Oct 08

DiGIR

Details for Administrators about DiGIR implementation in EMu.

02 Sep 08

Narratives

Narratives content overhauled to include comprehensive documentation about how to use the module, in particular with a view to using it as the content management system for a website.

14 Aug 08

Image Display Registry entry

Update to the Image Display Registry entry that allows the Image Display feature to test for the existence of data in a field rather than for an exact value.

13 Aug 08

General options

Clarification about the Record Updates options.

16 Jul 08

Shortcut List

Registry entries documented for Shortcut Lists.

02 Jul 08

Tools for adding, updating and checking records

Restructure of the Working with EMu records section with the addition of a new section Tools for Adding and Updating Records that brings together Default Values, Ditto, Import and Record Templates.

02 Jul 08

Record Templates

Details about how to add records using the new Record Templates utility, which combines the functionality of the Ditto and Default Values facilities.

02 Jul 08

Operations Registry entry

New User/Group permission (daTemplates) added to the Operations Registry entry. Required for creating Record Templates.

20 May 08

iMu

Details about how to use iMu and how to prepare your data with iMu. Fully integrated with EMu, iMu is the next generation in guided tours, the personalised guided tour, combining the freedom of a self-guided tour with the convenience of a personal guide.

22 Apr 08

XSLT processing of XML import files

EMu 4.0.01 has added XSLT processing as part of the Import tool for XML files: it is now possible to import an XML file and have it transformed as part of the Import process.

18 Apr O8

Customising the EMu Portal

Details / clarification about customising the Portal.

09 Apr 08

Context IDs

All Context IDs for topics in this Help with a number < 500100 have been changed. This affects approximately 60 topics and is only an issue if you have used EMu's Related Information function to link the EMu client to an affected topic in this Help.

20 Mar 08

Global Replace

Clarification about use of Global Replace functionality: all substitutions defined in the current session and displaying in the Replace box will be run when either the Replace or Replace All button is selected.

19 Mar 08

Record Recall

Details about the extension to the Audit Trails functionality, allowing the current version of a record to be "replaced" by an earlier version of a record.

07 Mar 08

How do I search attached documents?

Clarification on how to search text based documents stored in the Multimedia module.

27 Feb 08

Range Indexing entries

Details about the Range Buckets Registry entry.

26 Feb 08

Indexing

Details added to the Understanding how EMu works section describing new Range indexing options - essentially how Administrators can fine-tune Range indexing.

Feb 08

The EMu Portal

The EMu Mapper

User and administrator documentation about the Portal and Mapper

15 Jan 08

Web Services

Documentation about the installation and customisation of EMu Web Services.

13 Dec 07

Various pages

Registry updated with new Registry entries:

Details about:

30 Nov 07

Groups

Details about the new Groups module.

22 Nov 07

The Auditing Facility

Details about EMu's fully integrated auditing facility.

25 Oct 07

Archives

Description of the EMu Archives utility.

07 Sep 07

Stage 2: Using the Sample Code

Addition of a sample xsl stylesheet that can be easily modified to produce a new Page View (rather than creating a stylesheet from scratch).

29 Aug 07

Case Sensitive

Details about performing a case sensitive text search.

10 Aug 07

Import Identifier Screen

Clarification about use of the System identifier.

25 Jun 07

Query Defaults Registry entry

Insert Defaults Registry entry

Updated with details about how to add multiple values to a search / new record by default.

25 Jun 07

Mandatory Registry entry

Updated.

22 Jun 07

Customising EMu

Help & Field Level Help

Various FAQs added for how to specify Related Information.

21 Jun 07

Related Information

How to add Related Information

Describes how to add a link to a webpage, a page within the EMu Help, etc. from the Field Help dialogue box for a field. In the example below, selecting the Party Type details link under the See Also heading will open the Party Types page in the EMu Help:

Field Level Help

21 Jun 07

Colours|Maximum Size Registry entry

Details added

24 May 07

Recording Objects

Section reworked

21 May 07

Standalone Registry entry

Correction to Registry entry format