| Applies To | |||
| Product(s): | MicroStation GeoGraphics | ||
| Version(s): | V8 | ||
| Environment: | N/A | ||
| Area: | N/A | ||
| Subarea: | N/A | ||
| Original Author: | Bentley Technical Support Group | ||
What are the prerequisites for MicroStation GeoGraphics V8?
At the time of writing this TechNote, you must have MicroStation V8 version 08.00.04.01 installed.
Always check the "Applicable To" field in the Web Downloads dialog for the current release of MicroStation GeoGraphics to determine the appropriate versions of all products. This will list the correct version of MicroStation V8 for the current release of MicroStation GeoGraphics.
Can I use Oracle 9i with MicroStation GeoGraphics V8?
Yes. When you install MicroStation GeoGraphics, you are asked whether you want to use Oracle 8i or 9i files and the correct MicroStation database files are installed. The path to the Oracle client files is stored in the configuration variable MS_ORACLE_HOME. If it becomes necessary after GeoGraphics has been installed, to change the version of Oracle, you must modify MS_ORACLE_HOME in the ..\Bentley\Program\MicroStation\config\appl\sdodgn.cfg file.
MicroStation GeoGraphics V8 is delivered configured for Oracle 8i as well as the other supported databases listed in the GeoGraphics readme file.
What can I do with the new coordinate system tools?
The coordinate system tools contain the functionality of the product formerly known as GeoCoordinator. These tools are now delivered as an integrated part of the GeoGraphics interface. These tools allow the user to assign a coordinate system to a design file. This information is saved and becomes a permanent part of the design file. Design files may be projected from one coordinate system to another, providing that the user-defined parameters of each file are set up correctly. Further, coordinates in a design file may be converted on the fly to another coordinate system, using the coordinate input readout tools. More detailed documentation is available in the MicroStation GeoGraphics online help User Guide - Coordinate Systems.
What is Reference Transform on-the-Fly?
Reference Transform On-the-Fly allows all maps attached as reference files to be re-projected from each of their own coordinate systems to the coordinate system of the master file. The re-projection is done in memory only so that duplicate data in alternate projections is not required. It simply requires that each file be assigned a coordinate system using the MicroStation GeoGraphics coordinate system tools and that this coordinate system be saved in each design file.
Where can I locate additional documentation for MicroStation GeoGraphics?
Delivered with the software, the Online Help is available through the Help > GeoGraphics Contents. Links to the help files are also delivered in the Start > Programs > MicroStation V8 > Documentation folder. Always download the documentation from SELECTservices Online. You will find the documentation button immediately underneath the Download button. This download an .exe file that you must unzip into a folder. You may choose to create a folder for this documentation under the \bentley\program\geographics directory. The exe contains the following documentation:
- GeoGraphics V8 Quick Reference Card
- MicroStation GeoGraphics Programmer Reference Guide
- GeoGraphics_v8_QuickStart Guide
Also included are the example files referenced in the User Guide.
Are there any configuration issues I should be aware of when setting up an Oracle 9I server?
We recommend keeping your Oracle server as up to date as possible. The best way to do this is by monitoring Oracle's support site for the most recent product patches made available. We also urge you to fully understand what each Oracle patch is for before installation, and that you keep detailed records of all alterations via patches to your database. Backing up your database before any alteration is also strongly encouraged.
Additionally, the certified Oracle database character set for use with GeoGraphics is the UTF8 character set, which is not the default character set for Oracle 9i.
Is Oracle Locator supported with MicroStation GeoGraphics V8?
Yes. Oracle Locator is supported with the Oracle Spatial option of MicroStation GeoGraphics.
I no longer see Image Manager on the menu, what do I use to display images?
Raster Manager, first introduced with MicroStation/J, is now delivered with MicroStation V8. It is fully integrated with Map Manager. Raster Manager supports a full range of images, both georeferenced and non-spatial. In addition, Raster Manager supports 24-bit color and iTiff (Internet TIFF) format. Please refer to the Raster Manager FAQ for a full list of supported image formats.
What is TML and what can I do with it?
TML stands for Topology Macro Language. TML was originally introduced with MicroStation GeoParcel and has now been incorporated into MicroStation GeoGraphics V8. Script files with a .tml extension are created in any text editor and executed from the MicroStation keyin window. With TML, you are able to create dynamic topology layers, which react to changes in the source data. Refer to the Topology Macro Language Command Syntax section in the GeoGraphics readme for documentation on TML. Examples of tml scripts are delivered in the \bentley\program\geographics\prj\mytown\tml directory.
I am receiving an Oracle 9i error message. How can I determine what this error means?
MicroStation GeoGraphics V8 will pass along messages that are generated by the Oracle Server. These error messages may be looked up in the following Oracle online documentation.
Note: The Oracle Web site will require a user ID and password, which may be obtained from the Oracle Technology Network web site.
What is the SpatialViewer and where can I get this application?
The SpatialViewer is a sample application developed using the SDODGN API and at this time is available only through a support request. This application is delivered as an example and should not be viewed as a supported product.
Is it possible to predetermine the location for a spatial posting operation's log file?
Yes, log files are automatically generated during each post operation with a *.log extension and are by default placed in the GeoGraphics projects' log directory: <project_directory>\log . If this directory does not exist, the files will be placed within the main <project_directory>. To modify the location where the file is produced, set the variable MS_GEOLOGDIR to the desired location. Log files can be viewed either within MicroStation via the Spatial Post dialog's FILE > VIEW LOG command, or independently within a text editor.
I am receiving the Oracle error "Non supported character set: oracle-character-set-178" when posting text to my Oracle Spatial database. Why?
You must make the following modifications to your geograph.ucf file located in the \bentley\workspace\users directory to add this file to your classpath:
%if exists ($(MS_ORACLE_HOME)jdbc/lib/nls_charset12.zip) CLASSPATH > $(MS_ORACLE_HOME)jdbc/lib/nls_charset12.zip%endif
See Also
Geospatial Product TechNotes And FAQs
External Links
Bentley Technical Support KnowledgeBase
Comments or Corrections?
Bentley's Technical Support Group requests that you please confine any comments you have on this Wiki entry to this "Comments or Corrections?" section. THANK YOU!