Utilities

You can generate business objects from user defined tables created in the Advanced Accounting Console. Refer to Business Objects for details on business objects. When you click Build All, the Build Results area will display a log of the business objects that were built, compiled, and published.
Some reasons to generate business objects from user defined tables include:
- You want the business objects to be available for IQA to create queries on the data.
- You want the business objects to be available to be exposed using the Panel Editor content item.
Note: In order for the business object properties to be available to the panel editor, any timestamp and/or text column must be removed from the resulting business object, and Is available to UI must be enabled in the Definition tab of the Business Object.
Note: Rerunning the Build All command will cause your changes to be overwritten and lost. The business objects for user defined tables are recreated by that operation.

From the Staff site, go to Settings > Utilities > Update iMIS. This will take you to the ASI Support Portal. From here you can review all Product Release information.

In the Staff site, go to Settings > Utilities > Package installer:
Use Package Installer Utility to select packages for installation, view currently installed packages, and view failed installations. Although making content items deployable is the most common use for packages, they can also include:
- iMIS document system objects, such as queries, business objects, and content types
- SQL Scripts, which run against the iMIS database during installation
- Files, such as ASCX pages, images, and Word templates

You can use the Package Installer to install, update, or revert content items on a system. For example, if you have multiple application servers on which you need to install something, and you run the Package Installer more than once for the same package, the Package Installer will only install one item in the database. It is safe to install the same package multiple times. This is true even if you install multiple packages that contain the same content item. The Package Installer is smart enough to only install the duplicated package content once. If the packages have different versions of the content item, the last version (not necessarily the newest version) of the content item installed wins.
- Save the .ipackage file to the C:\Program Files (x86)\ASI\iMIS\Net\package\pending folder. Create the pending folder if it does not exist yet.
- Go to Settings > Utilities > Package installer.
- Select Packages to be Installed from the Show drop-down list.
- Click Install.
- If you installed any ActiveX controls, register the OCX files.
- If your package includes a control (content item or ActiveX), repeat this process on each additional application server that needs to host it. For example, if you have an application server only install of a second application server using the same database as your main application server install, add the Package Installer to a content record that displays in both websites. Make sure you set up the correct security permissions to the content item's page so that only authorized users are able to access it.
Since iMIS runs with a single database, you do not have to install a package on multiple servers if it only includes database-related objects. But a control is an application component, so you need to deploy it on each server that hosts it. A package can install multiple times on the same database.
If you have not visited the packages installer page in the Staff site (Settings > Utilities > Packages installer), neither the \package nor the \pending folders will exist. Visit the packages installer page in the Staff site prior to trying to install a package to ensure the existence of these folders.

- From the command line, change the directory to the following folder:
cd C:\Program Files (x86)\ASI\iMIS\Net\bin
- Execute the command to create the manifest:
PackageBuilder.exe -create <packageFolder>
- Replace
<packageFolder>
with a path to the folder that contains the source files to be included in the package. For example:PackageBuilder.exe -create C:\MyNewContentItem
- A package.manifest file is created for you in the
<packageFolder>
location.
Note: If a package.manifest file already exists in that folder, it is overwritten when you run this command.
- Replace
- In a text editor, edit package.manifest to specify the package description and the install path for each of the package's files. The install path is relative to the Net directory, which defaults to C:\Program Files (x86)\ASI\iMIS\Net.
- ASCX files (content items) usually install to: <InstallPath>iparts/Custom</InstallPath>
- DLL files usually install to: <InstallPath>bin</InstallPath>
- For <Type>Document</Type>, the <InstallPath> refers to a path in the document system. You can either enter a file system path or a document system path, such as $/Folder/SubFolder.
- For <Type>Sql</Type>, the <InstallPath> is not required, because the SQL in the file specified by <Name> is executed. If the <InstallPath> is specified, then the corresponding SQL file is saved to that path. Additionally, the file extension for an SQL file must be .sql, or it will be treated as the File type during the PackageBuilder -create step.
- Execute the command to build the package:
PackageBuild.exe -build <packageFolder> <packageFileName>
packageFolder
is the path to the folder that contains the source files to be included in the package, such as: C:\MyNewContentItempackageFileName
is the pathname of the package file to be generated (which must have the extension .ipackage), such as: C:\Program Files (x86)\ASI\iMIS\Net\package\pending\ASIEUGiftAidWebPart.ipackage

If you see the following message while attempting to publish a content item:
The control passed to ContentTypeHtml for rendering is not a ContentHTML
Then it might mean the content item DLL must be copied to the AsiScheduler folder. Because the AsiScheduler folder is not always found in a fixed location, and might be on another server, you might need to manually copy the content item DLL to the AsiScheduler folder.


You can import request activities. This is particularly useful if you have a large number of identical requests that you must enter and track.

- Choose your ID input method from one of the following:
- Input from file
- Click Browse. A browse dialog opens.
- Browse to and select the text file containing ID numbers, one ID per line.
- Input from Query
- Enter a SQL query to run against the Name table. A message shows how many IDs have been selected.
- Click OK to close the message.
- Input from file
- Click Step 1 - Load IDs to load the IDs and enable the Activity Type field, Trans.Date field, and Step 2 - Set Values option. The remaining fields and buttons remain disabled and grayed-out until an Activity Type is selected from the drop-down list.
- Select an Activity Type from the drop-down list. When an Activity Type is selected from the drop-down list, the user-defined fields and prompts that are set up for that activity type become available in the Import activities window.
- Enter values in the fields defined for the activity type.
- Click Step 2 - Set Values. When the step is complete, the Transformation Query field, and the options Optional Step 3 - Transform, Preview, and Step 4 - Generate Activity are activated.
- Click Preview to display a grid-view of the records in the Activity Importer table.
- Use the side and bottom scroll bars to check the data entered.
- Click Hide Preview to return to the Import activities window.
- (optional) Enter a SQL statement in the Transformation Query field to make any necessary modifications. For example, modify the Committee from Award Selection to Awards Presentation.
- (optional) Click Optional Step 3 - Transform to update the ActivityImporter table and display a Transformation Complete message.
- Click OK to continue.
- (optional) Click Preview to display the grid-view and verify your modifications.
- After verifying that the values entered in the activity fields are correct, click Step 4 - Generate Activity.
- Click Yes to create the activity records. After the activities have been created, the product displays a “Process is complete” message.
- Click OK.
Note: The fields from the Activity Type field thru and including the User Field 7 field in the Import activities window are defined in the Activity types window by your administrator. The remaining fields in the Import activities window are available whenever an Activity Type is selected from the drop-down list. These are not user-defined fields, and knowledge of iMIS business processes is required to use them successfully.
Note: At this point, nothing has been written to the Activity table.
At this point, you can click Hide Preview and continue with transformation queries. For example, you could update the Activity.CO_ID field by using the following query:
Update ActivityImporter Set CO_ID = Name.CO_ID From Name where Name.CO_ID = ActivityImporter.CO_ID
You can also use the transformation query to delete records from the ActivityImporter table before generating activities as in the following example:
Delete from ActivityImporter Where ID = 140
A system message informs you that activity records will be created.

The System Setup provides configuration options for a variety of iMIS features. You enter the license information here when you install iMIS for the first time, and you may need to modify the license information if you purchase additional iMIS modules or upgrades.
In addition to modifying the license control, the System Setup window is where you set Organization Names and SQL Security.

From File, select System Setup
- License Control - The following information should be entered from the data on the license sheet that accompanies an order:
- System Name - The title you want displayed on the main iMIS window
- Version - The current version of iMIS installed
- Install Date - The date the current version was installed
- Serial # - The iMIS serial number provided on your System Setup sheet
- Licensed To - Company name in which iMIS is licensed
- Products - The list of current features installed
- Users Allowed- The number of users allowed to access iMIS at one time
- Max Records - The maximum number records allowed for the license
- Expiration - The license expiration date
- Organization Names - Opens the Organization Names window where you can enter logos and addresses for each organization. This is also where the taxation method for the organization is selected.
- SQL Security Setup - Opens the SQL Security Setup window where you can set database passwords.
- Preferences:
- Date Format - (defaults to D/M/CY) If needed, override the default date format.
- Auto Logout After - Specifies a time, such as the end of your normal business hours, when you want iMIS to automatically log out any logged-in but inactive users. The logout will not interfere with users in the middle of actions or procedures in iMIS; rather, it waits for a period of inactivity (no keystrokes, mouse movements) before logging off the user. Those wanting to work later that this “auto logout” hour can log back in and work undisturbed.
- Lower Case Words - Specifies a list of words that you do not want capitalized
- Company Sort Excluded Prefixes - The list of prefixes to ignore when sorting company names, which can include prefixes in foreign languages.
- Upper/Lower - Select this option to allow iMIS to automatically apply capitalization rules to name and address fields so that the text appears in Title (upper and lower) case. When you enter text into these fields, iMIS will capitalize the first letter of each word, except for the words listed in the Lower Case Words field. For example, if you entered “the university of texas at austin,” iMIS would format it as The University of Texas at Austin.
- Choose Report Folder - Used to enter the location where stored Crystal reports are saved and accessed through the Print Manager (File > Print Manager).
- Save Reports for __ Days - Specifies the default number of days to store Crystal reports in the Print Manager. If a different period is specified in the Detail Report Parameters window of the report, the days set in the report overrides the System Setup.
- Choose MS Word Folder - Used to enter the location where MS Word templates are stored and accessed.
- Activity Attachments allowed - Select this option to enable the activity attachment feature that enables you to attach a file to an activity record and save it to the iMIS database. For example, you can attach a Microsoft Word document, PowerPoint slide presentation, spreadsheet, graphic, e-mail file, or HTML page. Once the file is saved to the iMIS database, you can open it on your system using the associated application and view, modify, or delete it from within iMIS.
- Web Server URL - Specifies the URL of your iMIS application server.
- Do not retain printer destination (Terminal Server environment) - Select this option if you do not want iMIS to store the path to your default printer in the database (for example, if you access iMIS through a Terminal Server or Citrix connection that may append a network identifier to the path to your default printer, causing iMIS to designate your printer setting as invalid), you can select the Do not retain printer destination (Terminal Server environments) option on the System Setup window (selectFile > System Setup). When you enable this option, iMIS does not save the path to your default printer destination to the database. You will still be able to print to your default printer when you select the Printer option on the Report Destination window. If when starting a subsequent session iMIS detects a conflict with your printer setting (for example, if you select a different default printer), an error message will display and you will be able to select a valid printer. You can also click the Reset All button to clear any existing report destination values.
- System Defaults button - Used to Change Font Tables and access Help Options menu items. When the Help Options menu item is selected, the Help Options window opens where you can select (enable) or deselect (disable) the following options:
- Help bar on – A dynamic, field-specific help line in the status bar at the bottom of the iMIS main window displays. This option must be enabled for the status bar to display. For example, when the cursor is positioned over the Joined Date field of the Name Maintenance window, the status bar displays Date membership began as additional information to help you know what to enter in the field.
- Show help codes - Internal help codes display the associated iMIS table and columns. For example, when the cursor is positioned over the Join Date field in the Name Maintenancewindow, the status bar displays the Name.JOIN_DATE.

You must modify your license configuration whenever you purchase new iMIS features or add users to an existing license. Have your updated license sheet (license key information) handy.
Do the following to modify the license configuration:
- Selec tFile > System Setup to open the System Setup window.
- Click in the lower left corner of the window until the hidden control button appears.
- Click Edit.
- Enter the license information exactly as shown on the license key.
- Click Save.

The Date Format field in the System Setup window is blank by default, which causes iMIS to use the U.S. English short date and time formats used in most U.S.-based computers. For example:
- 11/16/2016 is the short date format that represents November 16, 2016
- 2:16:26 PM is the time format that represents 14:16:26
Note: Use a format that displays the entire four-digit year so that users can verify the correct century. iMIS typically assumes a year of 29 or less to refer to the 21st century (30/3/22 = 30 March 2022) and 30 or higher as the 20th century (30/3/30 = 30 March 1930).

Whenever you have the operating system of an iMIS server set for a region other than U.S. English, be sure to specify a matching Date Format in iMIS. The region is set through Control Panel > Regional and Language Options, Regional Options.
For example, if the server specifies English (United Kingdom) for the regional language, 16/11/2016 for the Short date format, and 14:16:26 for the Time format, you must make iMIS match by specifying D/M/CY H:N:S in iMIS.

- Choose File > System Setup.
- Click Edit.
- In the Date Format field, specify a combination of variables that represents the Short date and Time formats used by the operating system of the iMIS application server. Examples:
- m D CY H:N.S.s returns "JUN 12 2016 15:45.00.00"
- D m Y H:N A returns "12 JUN 16 3:45 PM"
- M/D/Y H.N returns "06/12/16 15.45"
- YMD returns "160612"
- Click Save.
- Restart iMIS.
Refer to the table below for details.

Variable | Description | Example |
---|---|---|
Y | Year, 2-digit | 99 |
y | Year, 2-digit | 1999 |
C | Century, 2-digit | 19 |
M | Month, numeric | 06 |
m | Month, 3-character abbr. In caps | JUN |
D | Day of month, cardinal | 12 |
d | Day of month, ordinal | 12th |
W | Day of week, numeric, Sunday=0, Saturday=6 | 5 |
w | Day of week, full name | Friday |
H | Hour of day, 24-hour format | 0-23 |
h | Hour of day, 12-hour format | 1-12 |
N | Minutes, 2-digit, with leading zero | 07 |
S | Seconds, 2-digit, with leading zero | 02 |
s | Hundredths of seconds, 2-digit | 37 |
A | AM/PM, all caps | AM |

iMIS runs a customizable stored procedure that replaces foreign characters (ASCII 128 to 256) with standard equivalents (see Foreign language character replacement map) (ASCII 0 to 127) before it adds a name or address to a search index. Likewise, when you search for a name or address, iMIS runs the same stored procedure on the search text before it performs the search. The stored procedure works with all Microsoft SQL Server code page settings.
iMIS supports foreign language prefixes such as l' and d'.
- The lower-case word list accepts prefixes that contain an apostrophe.
- A customizable list (the Company Sort Excluded Prefixes list) can exclude prefixes that contain an apostrophe from the Name.COMPANY_SORT field.
Both lists are available on the System Setup window (in iMIS Desktop, select File > System Setup).

Original | Replacement | Original | Replacement | Original |
Replacement |
---|---|---|---|---|---|
Š | S | È | E | ä | a |
€ | E | É | E | å | a |
Œ | C | Ê | E | Æ | a |
Ž | Z | Ë | E | ç | c |
™ | T | Ì | I | è | e |
š | s | Í | I | é | e |
ž | z | Î | I | ê | e |
Ÿ | Y | Ï | I | ë | e |
Ÿ | y | Ð | D | ì | i |
§ | S | Ñ | N | í | i |
© | c | Ò | O | î | i |
ª | a | Ó | O | ï | i |
® | R | Ô | O | ð | o |
² | 2 | Õ | O | ñ | n |
³ | s | Ö | O | ò | o |
µ | u | × | x | ó | o |
¹ | 1 | Ø | O | ô | o |
¼ | 4 | Ù | U | õ | o |
½ | 2 | Ú | U | ö | o |
¾ | 3 | Û | U | ø | o |
À | A | Ü | U | ù | u |
Á | A | Ý | Y | ú | u |
 | A | Þ | P | û | u |
à | A | ß | s | ü | u |
Ä | A | à | a | ý | y |
Å | A | á | a | þ | b |
Æ | A | â | a | ÿ | Y |
Ç | C |

This window allows you to change the passwords of the SQL Server login accounts that perform transactions on behalf of iMIS Desktop users, and to enable iMIS to prevent data modification while reports are running.
Note: See Resetting the system-level SQL authentication passwords (see Resetting system SQL authentication passwords) in the Maintaining iMIS section of Installation.

From File, go to System setup, then click SQL Security Setup
This window contains the following fields:
- SQL User Password - (optional) Enter text here to generate a new password for the IMISUSER_[dbName] SQL Server login. Enter the text again in the Verify Password field.
Note: iMIS uses the password text to generate an SHA-1 hash, so enter a reasonably complex string. For example, a text string of 6-10 characters, including 1 or more digits and 1 or more non-alphanumeric characters, will result in a hash that should prevent dictionary-based attacks.
- SQL Manager Password - (optional) Enter text here to generate a new password for the MANAGER_[dbName] SQL Server login. Enter the text again in the Verify Password field.
- SQL Locking Control - (optional) Enter nolock here to enable iMIS to prevent data modification while a report is running.
Note: To prevent data modification while a report is running, enter NOLOCK in the report's Parameters field.
- Create SQL Logins - Resets the SQL Server passwords for the IMISUSER_[dbName] and MANAGER_[dbName] logins. iMIS prompts you to enter the password for the SQL Server sa login.
- Save - For the SQL password fields, this button generates password hashes and then stores them in the System_Params table. For the NOLOCK keyword field, this button saves the keyword in the System_Params table.

When you open an activity record and click the Attachment button on the Activity Detail window, you can attach a file to the activity record and save it to the iMIS database. For example, you can attach a Microsoft Word document, PowerPoint slide presentation, spreadsheet, graphic, email file, or HTML page.
Once the file is saved to the iMIS database, you can open it on your system using the associated application and view, modify, or delete it from within iMIS.

To enable the activity attachment feature, you must do the following:
- Enable the Activity Attachments allowed option on the System Setup window (select File > System Setup).
- Enter a value in the Maximum file size (KB) field on the System Setup window (displays when you enable the Activity Attachments allowed option).
- Enable the Allow user Edit option on the Set up activity types window (from Customers, select Set up module > Activity types) for the activity for which you want to add an attachment.
Note: Some activity types are system-generated (for example, Order) and are not intended for editing. However, if you want to attach a file to one of these activity types, you must enable the Allow user Edit option.
To enable the Activity attachments, do the following:
- Select File > System Setup to open the System Setup window.
- Click Edit.
- Enable the Activity Attachments allowed option.
- Enter a value in the Maximum file size (KB) field. (Displays when you enable the Activity Attachments allowed option.)
- A message warns you that the maximum you specified may have adverse effects on performance. Click OK.
- Click Save.

Although you can specify the maximum file size of activity attachments that can be stored in the database, the absolute maximum size is determined by many factors (for example, the maximum size of your database server). In most cases, specifying a small activity attachment size limit (for example, 500 for a 500 KB file) should be large enough. The maximum file size for a Word document, for example, is 32 MB.
Note: Do not increase this value until you have verified through testing that performance of your system remains acceptable at the new value. Storing a large number of attachments will increase the size of your database very rapidly, affecting backup requirements and the available disk space on your database server.

The Utilities menu is only available from the administrative views.
- Report Specs - Opens the Report Specifications window, where you can copy and modify standard reports.
- SQL Query - Opens the SQLQuery window, where you can enter and execute SQL commands.
- Reports and Queries... - Opens the System Reports and Queries window, where you have access to SQL scripts that can be run to manipulate your iMIS data.
- Run - For developers: Executes an iMIS procedure.
- Open Application - For developers: Opens a different Omnis library.
- Data Transfer Utility - Opens a sub-menu of the following items, which appear only if licensed:
- Export Utility – opens the Export Utility window
- Import Utility – opens the Import Utility window
- Export to ProSort – opens the ProSort Exports window