The Bulk Import Utility enables the automation of fire department and incident data processing at the National Database without using the USFA NFIRS 5.0 client software. Data files created by the USFA NFIRS 5.0 software Version 4.0 or later as well as data files created by Active Vendors' software can be placed on the server one at a time or in a batch mode. Export files created with NFIRS 5.0 software Version 3 can be sent, however, they will be processed under the most current rules and codes.
There is an upload limit of 10 files per zipped file, which allows a maximum of 30 files per upload.
While the transmission of data to the National Database is performed in a secure environment, the email receipt of the transmission and validation logs are only as secure as the user's email environment.
The amount of network and internet traffic may affect the transfer rate. The amount of files in queue on the server may affect the processing rate. The size of the import log files may affect the download rate. They are zipped to expedite download time.
Users sending files to the National Database using the Bulk Import Utility should confirm that the FDID header records for the FDIDs included in the file have been created in the National Database before proceeding with file transmission. Contact the State Program Manager or the NFIRS Support Center for more information.
File Format
Files must be in ASCII text format (created and saved in a text editor which does not add hidden or unprintable characters to the file contents). Zip files are allowed, with a limit of 10 files per zipped file. Zip files will speed upload performance of import.
A trial version of Winzip can be obtained at no cost at
www.winzip.com.
Necessary Specifications
The user must make the following selections before submitting the file(s) using the Bulk Import Utility:
- Accept Invalid Incidents
- Overwrite Existing incidents
- The User's Email address
If a zipped file contains multiple files, the selections must be valid for each of the files. The selections will be applied to each of the files contained in the zipped file. Valid 4.1 incidents will be marked as Released when imported to the National Database, in the same manner as the USFA Client Import/Export Tool validation and import functions. Browser Requirements and Connectivity Information
- Minimum Recommended Modem Speed: 28.8 kbps or better
- Internet Explorer Version 5.5 or later is necessary.
- Netscape Communicator Version 4.7 or later is necessary.
- The PC must have frames enabled to view all necessary pages.
- The PC must have cookies enabled. Non-persistent (or session cookies), are used for login authentication. This practice meets FEMA guidelines as stated in the CIO Guidance Memorandum 01-XX Draft.
- The user will be notified by email of the final import success or failure.
The email message will contain a URL. The user will click on the URL which takes them to the Bulk Import Utility Login. After the user logs in and their account is authenticated, a file download box will be displayed. The user must specify to save the file to the hard drive. Winzip is necessary to extract the log files. The log files contain processing and validation information and should be rviewed by the user to verify import results.
Below are sections which provide additional information on Browser Versions and Settings.
Keep Alive Frame
If the PC has frames enabled, the lower frame is used as a dialup "keep alive." Some ISP's will terminate your connection if you are inactive for a period of time. The keep alive function will transmit some http traffic every 30 seconds in an attempt to keep the connection alive.
Also in this frame, when the file transfer is complete the message "Upload Status Successful" or "Upload Status Unsuccessful" will be displayed. A brief summary lists the name of the file uploaded, the file length (amount of records, not incidents), the file name as logged in the system, and the state for which the file was processed. A separate email including the validation log files will be sent to the address the user entered in the Bulk Import Utility submission form.
Additional information on Browser Versions and Settings
Internet Explorer Users: To verify the browser version, open Internet Explorer. Under the Help menu, select About Internet Explorer. The version number will be included in the information that is displayed. To upgrade to Internet Explorer 5.5, click on the Upgrade Information link in the About Internet Explorer window. Locate the appropriate upgrade for the PC.
To verify or change settings for Session Cookies:
- Open the Internet Explorer browser. Under the Tools menu, select Internet Options. Click on the Security Tab.
- In the "Select a web content zone to verify its security settings" area, highlight the Internet icon.
- Click on the Custom Settings button. The Security Settings window will be displayed.
- Locate the Cookies section, specifically Allow per session cookies (not Stored) options.
- Verify Enable is selected.
Netscape Users: To verify the browser version, under the Help menu, select About Netscape Communicator. The version number will be included in the information that is displayed. Netscape users can check for upgrades by clicking on the My Netscape icon on the browser, and clicking on the Downloads link. Locate the appropriate upgrade for the PC.
To verify or change settings for Session Cookies:
- Open the Netscape Communicator browser. Under the Edit menu, select Preferences. Click on the Security Tab.
- In the Category hierarchy, highlight Advanced.
- Locate the Cookies section at the right and verify Accept all cookies is selected.
- Click OK.
Completion and Notification of the Import Processing:
As of March 26, 2004, a new method of receiving log files was implemented and is outlined as follows:
- The email message sent to the Bulk Import Utility user notifies them the processing has been performed, and the email will contain a URL.
- The user will click on the URL which will take the user to the Bulk Import Utility Login page.
- The user will enter their login information and their account will be authenticated. A file download box will be displayed.
- The user must specify to save the file to the computer. The filename will include a long, numeric identifier, as it did prior to March 26, 2004.
- The zipped file will be downloaded and saved to the PC. Close the download box.
- To extract and review the files, locate and double click on the file. The Winzip program is necessary for this operation. All log files for an upload session (maximum: 30 files) will be included in the single, zipped file.
Users who have been assigned the necessary permissions and have been activated can
start a BIU Import.