The MRP Collection Manager User’s Guide

 

Frequently Asked Questions (FAQ)

 

Using the Collection Manager:

Are there any restrictions on the fields that I can add to my collection database?

Can I change the order of fields in either the Item Details display or in the List display?

Can I get text to be displayed in italics in the Item Details view?

Can I get text to be underlined in the Item Details view?

Can I get a large amount of text in a long text field to be broken into separate paragraphs for display in the Item Details view?

How do I create a link for text in the Item Details view that will jump from one collection record to another one when I click on it?

Can I get a larger text-entry window in the data-entry/editing dialog, for entering large amounts of text into a field?

I made some errors editing or adding data. How can I undo my changes?

Can I have more than one collection database?

How do I back up my collection database?

 

Troubleshooting (more complicated, sometimes technical, stuff):

Can I make changes to my collection outside of the Collection Manager, by editing the collection file in a text editor?

Can I rename an existing collection?

Can I change the currency or dimension units that I initially specified for my collection?

How can I move my collection to a different location (or different computer), or rename the collection file?

How can I delete a collection? (I was just testing out the Collection Manager and I made a “pretend” collection, but now it shows up in the list of my collections, but I just want it to go away.)

How can I get the Collection Manager to recognize a collection that I deleted but have now restored from a backup?

Will my collection be lost when I upgrade to the next edition of the MRP Collection Manager?

I really messed up doing data-entry and just exited the program. Can I undo the mess I made?

I added some jump-to links. They show up OK (as blue-underlined links), but when I click on them nothing happens.

 

Are there any restrictions on the fields that I can add to my collection database?

 

Not really.  When you initially create a database, you choose from one of the available templates, which provides you with a starting set of fields.  But this is really just a convenience, so at least some of the fields that you will have in your database are there right from the start, without your having to individually specify them.  But you are free to add any additional fields that you want (or modify or delete any of the fields provided by the template).  There is no limit to the number of fields that a collection can have (though, of course, if your collection has hundreds of fields, you will likely find it somewhat cumbersome to edit and view your collection entries).  The only restrictions regarding fields:

 

·        Your collection must have an ID # field (though you are free to change its name, and you are free to never actually put any data into this field, if you don’t want to use it).

·        Fields must be one of the eight provided data types; you cannot create new data types.

·        Each field must have a name, and field names must be distinct.

 

Can I change the order of fields in either the Item Details display or in the List display?

 

Yes, you can change the field order in both places. To change the field order in the Item Details display, pick Detail Field Order from the Options menu on the collection viewer window. Use the dialog box that comes up to select and move fields to new positions.  The choices you make here will affect not only the field order displayed in the Item Details display, but also the field order displayed when printing single records, and the field order shown in the data-entry/editing window.

 

The order of fields in the List view of the collection window is completely separate. It is controlled by the dialog that you access by choosing Field Selection from the Options  menu.  You can also change the order of fields in the List view by clicking and dragging on the column headers in the List display: Click a column header and then, still holding the mouse button down, drag to the right or left until you get to the place to which you want the column moved.

 

Both kinds of field order (Item Details and List) are saved as part of the collection, so these choices will be remembered from one session to the next.

 

Can I get text to be displayed in italics in the Item Details view?

 

For long text fields (displayed in the data-entry window as scrollable multi-line editing boxes), select the text that you wish to display in italics.  Then right-click on the text box bring up the options menu, and choose Italic.  This will convert the selected text to italics.  If you want to display as italics text that is in short text or one-line text fields (displayed in the data-entry window as one-line-high text boxes, without scrollbars), place the text between a pair of caret characters (^). For example, if you enter the following into a single-line text entry box within the data-entry window:

    From ^Voyage autour du Monde^.

this will appear in the Item Details display (or when printed) as:

    From Voyage autour du Monde.

 

Can I get text to be underlined in the Item Details view?

 

For long text fields (displayed in the data-entry window as scrollable multi-line editing boxes), select the text that you wish to display as underlined.  Then right-click on the text box bring up the options menu, and choose Underlined.  This will convert the selected text to be underlined.  If you want to underline any text that is in a short text or one-line text field (displayed in the data-entry window as a one-line-high text box, without scrollbars), place the text between a pair of back-single-quote characters (`). For example, if you enter the following into a single-line text entry box within the data-entry window:

    From `Voyage autour du Monde`.

this will appear in the Item Details display (or when printed) as:

    From Voyage autour du Monde.

 

Can I get a large amount text in a long text field to be broken into separate paragraphs for display in the Item Details view?

 

To get text in a field to be formatted as multiple paragraphs, include an extra blank line between sections of text that you want to be separate paragraphs.  Separate paragraphs will be formatted in the Item Details display (or when printed) as hanging paragraphs (with a hanging indent).

 

How do I create a link for text in the Item Details view that will jump from one collection record to another one when I click on it?

 

To create a link that will function as a jump from one map record to another, you must use the “ID #” field of the record to which you want to link.  Include this ID # in the text for a field.  If the field is a long text field (displayed in the data-entry window as scrollable multi-line editing boxes), select the ID # text, and then right-click on the text box to bring up the options menu and choose Jump-to link.  The ID # will be displayed as a link (underlined and colored blue), and, in the Item Details view, when clicked on, the Item Details display will jump to the corresponding record. When selecting the text to use as a jump-to link, do not include any text other than the actual ID # value.

 

If you want to display a jump-to link in a field that is of type short text or one-line text (displayed in the data-entry window as a one-line-high text box, without scrollbars), place the text between a pair of tilde characters (~). For example, if you enter the following into a single-line text entry box within the data-entry window.  For example, to get a link to the item with ID # of 123, you might include the following in a short text or one-line text field in the data-entry window:

    This print appeared in the same book as print #~123~ in the collection.

This will be shown in the Item Details display as:

    This print appeared in the same book as print #123 in the collection.

The link (123), when clicked on, will cause the Item Details display to jump to collection record with ID # value of 123.

 

Can I get a larger text-entry window in the data-entry/editing dialog, for entering large amounts of text into a field?

 

Yes, right-button click in the text box for the field you wish to edit.  This will pop up the options menu.  Choose Edit field in larger pop-up window. As a short-cut, you can also hold down the <CTRL> key and double-click on the text box.  This will also bring up the larger text-entry window, however this method only works if the text box you double-click on is not completely empty.

 

Note also that when you type into a multi-line text-entry box (either within the data-entry dialog or in the larger window you can bring up), there is no auto-wrapping of text. As you reach the right-hand edge of the window, typed-in text continues on the same line and the window simply scrolls to the right.  At any point, if you want to re-wrap the text to fit, just right-button click on the text box to bring up the options menu, and choose Re-wrap text to fit.

 

I made some errors editing or adding data. How can I undo my changes?

 

The Collection Manager does not have an “Undo” menu choice.  (Text entry fields in the data editing window do have Undo choices on their right-click options menu; so you can undo just-performed typing or editing operations.) However you can use Revert, on the File menu, to undo all the changes you made since the last time in the session that your collection was saved to disk.  (If your collection has not yet been saved to disk in the current session, Revert will restore the collection to the state it was in when you began the current session.)

 

If you have saved your collection to disk in the current session, Revert will give you the choice of throwing away the changes made since the last save or all the changes in the current session.

 

In general, it is a good idea to do fairly frequent saves (Save, on the File menu) when you are making lots of changes to your collection (editing or adding new records).  That way, if you realize that you just made a mistake, doing a Revert will only throw away the changes made since the last save, and you will probably only have to re-do a small amount of work, if any.  To guarantee that changes are saved to disk on a timely basis, you can turn on auto-save from the Preferences dialog. Choose Preferences from the Options menu and select the Auto-save tab.  Pick “Auto-save” and select an auto-save interval.

 

If things get a bit more desperate, and you realize that you have made a number of mistakes, and you saved the collection to disk with mistakes present, you can always choose to Revert to the state of the collection as of the beginning of the session. You will have to re-do this session’s work, but at least you will have your collection in a state that excludes all the mistakes of the current session.

 

Can I have more than one collection database?

 

Yes, you can have as many different collections as you want. The Collection Manager keeps track of each new collection that you create in a separate file. Though you can only have one collection open at a time, click the Manage Collections / Select Current Collection button on the Collection Manager Control Window, to access your list of collections and switch to a different collection as your currently active one.

 

Each collection is completely independent of the others, so you can set up each collection with whatever choices are appropriate (fields to use, currency and dimension units choice, sorting order, etc.).

 

How do I back up my collection database?

 

Each collection is stored as a single ASCII file.  To back up a collection, you simply need to ensure that the collection file is included in the files that you specify when doing a backup for your system.  Or you can manually copy the collection file to a backup medium (floppy disk, CD-ROM, flash drive, etc.) to make a backup.

 

If you are unsure as to where your collection file is on your hard disk, select Summary from the File menu on the collection viewer window. The first line of the summary report shows the full pathname to your collection file.

 

If you have multiple collections, you will want to create backups for each of your collection files.

 

Can I make changes to my collection outside of the Collection Manager, by editing the collection file in a text editor?

 

No and yes. (Read on.)

 

No, in the sense that if you edit the collection file outside of the Collection Manager environment, you risk corrupting the file in such a way that you may not be able to open the file the next time you try to do so with the Collection Manager.

 

Yes, in the sense that the collection file is a text file, in XML format, which can be opened and modified by any text editor.  In other words, there is nothing, physically, that prevents you from opening the collection file with, for example, notepad, and making changes.

 

If you want to make changes to your collection, the way do this is within the MRP Collection Manager program, not outside of it by editing the collection file.  If you do have some really pressing reason to edit your collection outside of the Collection Manager program environment, you are probably better off exporting your entire collection (to Excel or to an ASCII file), editing it there, and then importing the edited data.

 

If you really feel compelled to edit the collection file directly (and you consider yourself a guru on XML file structure), you are obviously on your own. I can think of no good reason why this should ever be necessary.  At the least, you should make a backup copy of the collection file before making any changes to it, because in the likely case that the edited version can no longer be successfully opened by the Collection Manager, at least you will be able to gracefully fall back to restoring the file to its prior state from the backup copy.

 

Can I rename an existing collection?

 

Yes. Select Modify Fields or Image Directory from the Edit menu of the collection viewer window (or, equivalently, click the Modify Fields or Image Directory button on the Collection Manager Control window).  In the dialog that comes up, the collection name is shown in a text entry field at the upper right.  Edit the text in this box to change the collection name.

 

Can I change the currency or dimension units that I initially specified for my collection?

 

Yes. Select Modify Fields or Image Directory from the Edit menu of the collection viewer window (or, equivalently, click the Modify Fields or Image Directory button on the Collection Manager Control window).  In the dialog that comes up, the currency and dimension units are shown as radio buttons at the bottom right.  You can use the radio buttons to change the choices. 

 

How can I move my collection to a different location (or different computer), or rename the collection file?

 

Your collection is stored as a single file.  (If you have forgotten where your collection file is stored, choose Summary from the File menu.  The summary window shows the full pathname for the collection file.)  Exit the Collection Manager before moving the collection file. You can move this file to a new location (or rename the file) using any tools available on your computer for moving files (e.g. Windows Explorer).  Or you can copy the file to a different computer.  Of course it only makes sense to move the file to a different computer if you have also installed (or are planning to install) the MRP Collection Manager software on this computer.

 

If you moved (or renamed) the collection file on the same computer where it previously resided:

 

If the collection you moved was the current collection the last time you ran the Collection Manager, the program will notice that the collection file is not there, and you will be asked whether you want to browse for the collection file, or just have the program forget about that particular collection.  If you choose to browse, a file dialog will be shown which you can use to navigate to and select the new location (and/or name) of the collection file.  If you choose to forget about the collection, the program’s Collection Manager Control window will open, and you can proceed to either create a new collection or choose from among the other known collections, or browse for an existing collection file that the program does not yet know about.

 

If you moved the collection file to a new computer:

 

The Collection Manager will not yet be aware of the collection whose file you have just moved to this computer.  You should use the Collection Manager Control window and click the Manage Collections / Select Current Collection button.  On the dialog that comes up, choose Browse to Add. Use the subsequent file dialog to navigate to and select the collection file that you just moved here.  The collection will be added to the list and you can select it to be the current collection.

 

How can I delete a collection? (I was just testing out the Collection Manager and made a “pretend” collection, but now it shows up in the list of my collections, but I just want it to go away.)

 

In the Collection Manager Control window, click the Manage Collections / Select Current Collection button. Select the collection you want to delete in the list of collections and press the Remove from List button. A confirmation dialog will come up to make sure that you really want to remove the collection from the list.  As the dialog notes, the actual underlying collection file (the .xml file for this collection) will not be deleted; only the program’s notion of the currently available collections will be affected by the delete operation.  If you really want to get rid of all traces of the collection, you should then (carefully) delete the collection file (using, for example, Windows Explorer).

 

How can I get the Collection Manager to recognize a collection that I deleted but have now restored from a backup?

 

If you erased the Collection Manager’s memory of this collection (see the prior FAQ), then this situation is just the same as dealing with a collection whose file you have moved. See the earlier FAQ regarding moving collection files for how to get the Collection Manager to know about a collection file in a new location, which, in this case, applies to the file that you restored from backup.

 

If you had not previously erased the Collection Manager’s memory of the collection, then, if you restored the collection from backup to the identical location (and filename) that it had previously occupied, you won’t have to do anything: The Collection Manager will find the file (since the Collection Manager isn’t even aware that the file had been deleted and subsequently restored).  If you restored the backup file to a different location (or gave it a different name), then the Collection Manager will not find the file when you ask to open the collection, but the program will give you the opportunity to browse, using a file dialog, to locate the file.

 

Will my collection be lost when I upgrade to the next edition of the MRP Collection Manager?

 

No. When you move to the next edition of the Collection Manager, nothing is changed with regard to your collection.  Collection files contain version number information, and if a new version of the Collection Manager, containing new features, needs to update your collection file, it will do this automatically.  The only possible problem is using an older version of the Collection Manager on a collection file that was created by a newer version of the program.  The Collection Manager, however, recognizes this situation and an older-version program won’t let you open a later-version collection file – an error message will be shown indicating this situation.

 

I really messed up doing data-entry and just exited the program. Can I undo the mess I made?

 

You may be in luck. In each session, the first time that the Collection Manager saves your collection back to the disk it makes a backup copy of the collection file as it was before the session began. This file is located in the same directory as the collection file and it has the same name as the collection file, except with “.bak” appended (e.g. MyCollection.xml.bak). Before re-starting the Collection Manager, do the following:

1.        Navigate (using Windows Explorer) to the directory where your collection file is stored.

2.        Make a backup copy of the collection file; for example, copy MyCollection.xml to MyCollection.saved. This backup copy is just in case you really mess up and clobber the xml.bak file as well. At least you should still be able to get back to the way things were before you started this exercise.

3.        Delete the collection file (e.g. MyCollection.xml).

4.        Copy the xml.bak file, giving the new copy the name of the normal collection file (e.g., copy MyCollection.xml.bak to MyCollection.xml).

 

You should now be able to start the Collection Manager and, when you look at your collection, it should be exactly as it was the last time you invoked the program, before you made the (messed-up) changes to your collection.

 

I added some jump-to links. They show up OK (as blue-underlined links), but when I click on them nothing happens.

 

There are three possible reasons why clicking on a jump-to link doesn't perform the expected jump:

1.        The ID # shown in the link doesn't exist in the collection. Make sure that you actually have a record with this ID # in your collection.

2.        You currently have a subset defined, and the record with the ID # that you are trying to jump to is not included in the current subset.

3.        The text that you selected to turn into a jump-to link has some extra characters that aren't part of the actual ID #. For example, if the text that you have made into a jump-to link is #123, but the actual ID # for the corresponding record is just 123 (without the leading '#' character), then the jump-to link won't work. Change the jump-to link to include just the characters that form the ID # value of the record that you are trying to link to. In the current example, leave the '#' character out when selecting the text to turn into a jump-to link.

 

 


Back to: MRP Collection Manager - Home Page