Infrastructure Modeling DevBlog

Getting Fusion object in flexible web layout

By Daniel Du

When developing with flexible web layout, we always need to get the global object Fusion. Sometimes you may get error message: ' Fusion is undefined' if you do not get it correctly.

Actually, how to get the Fusion object depends on how you embed the fusion viewer into your webpage and where you call your JavaScript to get it. Generally speaking, if you are not using <frame> or <iframe> when embedding fusion viewer, following code snippet should work for you.

var MainFusionWindow = GetFusionWindow();

var OpenLayers = MainFusionWindow.OpenLayers;

var Fusion = MainFusionWindow.Fusion;

 

alert(Fusion);

 

 

 

/* locate the Fusion window */

function GetFusionWindow() {

    var curWindow = window;

    while (!curWindow.Fusion) {

        if (curWindow.parent && curWindow != curWindow.parent) {

            curWindow = curWindow.parent;

        } else if (curWindow.opener) {

            curWindow = curWindow.opener;

        } else {

            alert('Could not find Fusion instance');

            break;

        }

    }

    return curWindow;

}

Hope this helps.

Retrieve the maps or web layouts from AIMS/MGE repository

By Daniel Du

I am asked how to get the list of maps from MapGuide repository. In this post, I will show you how to do it with code, actually it is possible to get a list of resource with specified type, it can be feature source, layer, map or web layout.

The resources can be retrieved by resource service. Here is the help information about EnumerateResources method:

MgByteReader* MgResourceService::EnumerateResources
(
MgResourceIdentifier * resource,
INT32 depth,
CREFSTRING type
)

Enumerates the resources in the specified repository.

Remarks:

You can enumerate all types or just a selected type. You can also choose what depth in the repository to examine. This method only works on "Library" repository. If you specify a repository that is not supported, this method will throw an MgInvalidRepositoryType exception.

Parameters:

resource

(MgResourceIdentifier) Resource identifier specifying the resource to enumerate. This can be a document or a folder.
If it is a folder, you must include the trailing slash in the identifier.

depth

(int) Recursion depth, relative to the specified resource.

• If the resource is a document, depth must be set to 0.
• If the resource is a folder:
  • If the depth is equal to 0, only information about the specified folder is returned.
  • If the depth is greater than 0, information about the folder and its descendants up to the specified depth are returned.
• If the depth is -1, information about the folder and all its descendants is returned.

type

(String/string) Type of the resource to be enumerated. (Case sensitive.) SeeMgResourceType for valid types.
Or, this can be set to null, in which case information about all resource types is returned.

Returns:

Returns an MgByteReader object containing a description of the resources in XML format using the ResourceList schema.

The resource type can be specified by member of MgResourceType.

 

For your information, following the implementation of MgResourceType, it is included in MapGuide WebExtension API, you DO NOT need to implement it yourself.

  public class MgResourceType

  {

    // For flexible weblayout

    public const string ApplicationDefinition = "ApplicationDefinition"; 

    public const string DrawingSource = "DrawingSource";

    public const string FeatureSource = "FeatureSource";

    public const string Folder = "Folder";

    public const string LayerDefinition = "LayerDefinition";

    public const string LoadProcedure = "LoadProcedure";

    // For runtime map

    public const string Map = "Map";

    // For map definition                                   

    public const string MapDefinition = "MapDefinition";                 

    public const string PrintLayout = "PrintLayout";

    public const string Selection = "Selection";

    public const string SymbolDefinition = "SymbolDefinition";

    public const string SymbolLibrary = "SymbolLibrary";

    // For basic weblayout 

    public const string WebLayout = "WebLayout";                     

 

    public MgResourceType();

  }

Following code snippet demonstrates how to get all maps, you make some minior changes to retrieve other type of resources very easily:

/// <summary>

///  enumberate all the map definitions in the

/// </summary>

/// <param name="resId"></param>

/// <returns></returns>

public Dictionary<string, string> GetAllMaps(MgResourceIdentifier resId)

{

  Dictionary<string, string> mapList = new Dictionary<string, string>();

  MgResourceService resSvc = siteConnection.CreateService

    (MgServiceType.ResourceService) as MgResourceService;

 

  // Get all map def resources

  // MgResourceType.WebLayout for basic weblayout and

  // MgResourceType.ApplicationDefinition for flexible weblayout

 

  MgByteReader byteRdr = resSvc.EnumerateResources(resId, -1,

                          MgResourceType.MapDefinition);

 

  //Convert to string

 

  String MapResStr = byteRdr.ToString();

 

  //Load into XML document so we can parse and get the names of the maps

 

  XmlDocument doc = new XmlDocument();

  doc.LoadXml(MapResStr);

 

  //let's extract the map names and list them       

 

  XmlNodeList MapResIdNodeList;

  XmlElement root = doc.DocumentElement;

  MapResIdNodeList = root.SelectNodes("//ResourceId");

  int nRes = MapResIdNodeList.Count;

  for (int i = 0; i < nRes; i++)

  {

    XmlNode MapResIdNode = MapResIdNodeList.Item(i);

    String MapRes = MapResIdNode.InnerText;

    int index1 = MapRes.LastIndexOf('/') + 1;

    int index2 = MapRes.IndexOf("MapDefinition") - 2;

    int length = index2 - index1 + 1;

    string mapName = MapRes.Substring(index1, length);

    if (!mapList.ContainsKey(mapName))

    {

      mapList.Add(mapName, MapRes);

    }

  }

  return mapList;

 

}

Hope this helps.

Get Character while Pressing Shift Key using JavaScript

By Daniel Du

I am asked how to get the character using JavaScript when pressing Shift key, String.fromCharCode() does not take into account the shift modifier, you can only get the number “5” but actually you want to get the special character “%".

This is much be a very common request for web developers like developers working on AIMS, and I searched a little and find this page is very helpful. One customer argues that it does not work for Safari, I did a test, it does work for Safari and other browsers, including Firefox, Chrome and IE.

Here is my test code:

<html>

<head>

<title >mapKeyPressToActualCharacter test</title>

<script language="javascript" type="text/javascript">

    function onKeyPress() {

 

        var e = window.event || e;

        var keyCode = e.keyCode;

 

        if (keyCode == 8) {

            this.criteria.value = this.criteria.value.substring(

                    0, this.criteria.value.length - 1);

        }

        else {

            this.criteria.value

                += mapKeyPressToActualCharacter(event.shiftKey, keyCode);

        }

 

    }

 

    function mapKeyPressToActualCharacter(isShiftKey, characterCode) {

        if (characterCode === 27

            || characterCode === 8

            || characterCode === 9

            || characterCode === 20

            || characterCode === 16

            || characterCode === 17

            || characterCode === 91

            || characterCode === 13

            || characterCode === 92

            || characterCode === 18) {

            return false;

        }

        if (typeof isShiftKey != "boolean" || typeof characterCode != "number") {

            return false;

        }

        var characterMap = [];

        characterMap[192] = "~";

        characterMap[49] = "!";

        characterMap[50] = "@";

        characterMap[51] = "#";

        characterMap[52] = "$";

        characterMap[53] = "%";

        characterMap[54] = "^";

        characterMap[55] = "&";

        characterMap[56] = "*";

        characterMap[57] = "(";

        characterMap[48] = ")";

        characterMap[109] = "_";

        characterMap[107] = "+";

        characterMap[219] = "{";

        characterMap[221] = "}";

        characterMap[220] = "|";

        characterMap[59] = ":";

        characterMap[222] = "\"";

        characterMap[188] = "<";

        characterMap[190] = ">";

        characterMap[191] = "?";

        characterMap[32] = " ";

        var character = "";

        if (isShiftKey) {

            if (characterCode >= 65 && characterCode <= 90) {

                character = String.fromCharCode(characterCode);

            } else {

                character = characterMap[characterCode];

            }

        } else {

            if (characterCode >= 65 && characterCode <= 90) {

                character = String.fromCharCode(characterCode).toLowerCase();

            } else {

                character = String.fromCharCode(characterCode);

            }

        }

        return character;

    }

 

</script>

 

</head>

<body>

    <input name="test" type="text" onkeypress="onKeyPress();"/>

</body>

</html>

 

And here is my test result:

 

Hope this helps.

Localization of Ajax viewer of MapGuide Enterprise/AIMS

By Daniel Du

Many developers are trying to localize viewer of MapGuide or AIMS to make it more user-friendly. Here are the basic steps to localize MapGuide Enterprise, This blog is based on MapGuide Enterprise 2011, it applies to AIMS as well with minor changes.

1. Prepare the resource file, which locates at C:\Program Files\Autodesk\MapGuideEnterprise2011\WebServerExtensions\www\localized by default.

2. Copy the file en to a new one named as zh for Chinese, fr for France, for example. Put it into the same directory. Please be note that this is NO extension for this file.

3. Open the copied resource file and translate the message into local language.

4. Save the file, please save it using Unicode if needed, especially for East Asian language.

5. Pass the locale parameter to the Ajax viewer.

<frameset rows="0,*" border="0" framespacing="0">
<frame />
<frame src="/mapguide2011/mapviewernet/ajaxviewer.aspx?SESSION=<%= sessionId %>&WEBLAYOUT=<%= webLayout %>&Locale=zh" name="ViewerFrame" />
</frameset>

6. For these build-in commands, it can be localized by substitute the built-in commands by “Add –> Built-In Command” and localizing the display name and tooltip in MapGuide Studio.

Add Build-in Commands in MapGuide Studio

Localize display name and tooltip

That's it, now your interface is localized!

Changing the format of measure result of fusion viewer

By Daniel Du

If you are using measure widget of Fusion viewer, you will notice that the measure result if in exponential format, like 4.91e+5m. Is it possible to the change the format?

Measure widget of fusion viewer uses following JavaScript code snippet to handle the output result:

C:\Program Files\Autodesk\Autodesk Infrastructure Web Server Extension 2012\www\fusion\widgets\Measure.js , around line 583:

value = value.toPrecision(this.areaPrecision);

You can change this code to show the result as your preferred format. To make your changes take effect, you need to change the template file, for example, it is C:\Program Files\Autodesk\Autodesk Infrastructure Web Server Extension 2012\www\fusion\templates\mapguide\slate\index.html for Slate template:

Change from:

<script type="text/javascript" src="../../../lib/fusionSF-compressed.js"></script>

To:

<script type="text/javascript" src="../../../lib/fusion.js"></script>

You may also want to check out this blog - Debugging Fusion Viewer or Mobile Viewer of AIMS in Firebug

How to change the delay of tooltip in fusion viewer of AIMS

By Daniel Du

I set up tooltip for some layers, but it seems that it is too slow to show up when cursor is hovering over the feature. Is it possible to make it a little faster?

For fusion viewer (flexible web layout), the configuration of map tip time of delay is stored in the application definition (flexible web layout) which is stored in repository.

You can edit the ApplicationDefinition resource in repository directly. It can be done by Resource Service API(MgResourceService:GetResourceContent and MgResourceService.SetResource), or by MapAgent,or Maestro, which is an open source tool and not supported by DevTech.

Here is a snippet of application definition resource content, you can increase the value of <Delay> tag of MapTip :

<Widget>

   <Name>Maptip</Name>

   <Type>Maptip</Type>

   <Location />

 <Extension>

         <Tolerance>2</Tolerance>

         <Target>MaptipWindow</Target>

         <WinFeatures>

            menubar=no,location=no,resizable=no,status=no

         </WinFeatures>

         <Delay>350</Delay>  <!-- millisecond-->

         <Layer />

   </Extension>

</Widget>

Hope this helps.

Opening map in fusion viewer

By Daniel Du

You may have been using following code snippet to open a map in basic layout (assuming a map resource named as “myMapName” is created in MapGuide Studio,):

MgMap map = new MgMap();
map.Open(resourceServices, “myMapName”);

But it does not work in fusion viewer, the error message is :

Error : " Invalid argument(s): [0] = " " The string cannot be empty "

 

The reason is the map name will be changed during run time in fusion viewer, so please do not use hard-coded map name when programing.

If you are using “Invoke URL” command to invoke the page, MapGuide will add some parameters for you including SESSION, MAPNAME, etc. The value of these parameters can be retrieved by Request object. Here is a demonstration of how to get map name and open a map in fusion viewer:

string mapname = Request[“MapName”].ToString()
map.open(resSvc,mapname);

Firstly, create a custom command to "invoke URL" and point the URL to your custom page.

Specify the target as "Task Pane":

Code snippet goes as below:

<%@ Page Language="C#" AutoEventWireup="true"

   CodeBehind="MapInformation.aspx.cs"

   Inherits="AIMS2012WebApp.MapInformation" %>

 

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"

 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml">

<head runat="server">

    <title></title>

    <script language= "javascript" type="text/javascript">

        function Init() {

            var aa = '<%=mapNameXX %>' ;

            alert(aa);

        }

    </script>

</head>

<body onload="Init();">

    <form id="form1" runat="server">

    <div>

 

    </div>

    </form>

</body>

</html>

Code behind:

using System;

using System.Collections.Generic;

using System.Linq;

using System.Web;

using System.Web.UI;

using System.Web.UI.WebControls;

 

namespace AIMS2012WebApp

{

    public partial class MapInformation : System.Web.UI.Page

    {

        public string mapNameXX;

 

        protected void Page_Load(object sender, EventArgs e)

        {

            UtilityClass util = new UtilityClass();

            util.InitializeWebTier(Request);

 

            string sessionId = Request["Session"].ToString();

            util.ConnectToServer(sessionId);

 

            string mapName = Request["MapName"].ToString();

            //public variable, alert from client side

            mapNameXX = mapName;

         }

 

    }

}

The implementation of Utility class goes as below:

using System;

using System.Collections.Generic;

using System.Web;

using System.Collections;

using System.Xml;

using System.IO;

using System.Text;

using OSGeo.MapGuide;

 

/// <summary>

/// Summary description for Utility.

/// Created by Daniel Du, DevTech

/// </summary>

 

public class UtilityClass

{

    MgSiteConnection siteConnection;

 

    public void InitializeWebTier(HttpRequest Request)

    {

        string realPath =

                    Request.ServerVariables["APPL_PHYSICAL_PATH"];

 

        String configPath = realPath + "../webconfig.ini";

 

        MapGuideApi.MgInitializeWebTier(configPath);

    }

 

    public void ConnectToServer(String sessionID)

    {

        MgUserInformation userInfo =

            new MgUserInformation(sessionID);

 

        siteConnection = new MgSiteConnection();

 

        siteConnection.Open(userInfo);

 

    }

 

    public MgSiteConnection GetSiteConnection()

    {

        return siteConnection;

    }

 

}

The result will be similar as below, please the note the map name is different with the one defined in Infrastructure Studio.

How to change the tolerance of tooltip in Ajax viewer and Fusion viewer of AIMS or MapGuide

By Daniel Du

Have you ever run into following scenario? When I have tool tips enabled in the point data, I have to be exactly right on the center for the tool tip to show.  There doesn't seem to be any tolerance on the center or symbol.  Is there a way to increase the tolerance or sensitivity for the tool tip in the code?

Yes, There is. If you are using Ajax viewer (basic web layout), it can be done by making changes in: ajaxmappane.templ which is in Viewerfiles.

function RequestHyperLinkData(id, x, y, exec) {

 

    if (lastMapRcv != mapId) return;

 

    if (isPopupOpen(tbMenu) || isPopupOpen(ctxMenu)) return;

 

    req = CreateRequestHandler();

    req.open("POST", webAgent, true);

    req.setRequestHeader("Content-Type",

                                        "application/x-www-form-urlencoded");

 

    // default tolerance is 2 pixies, you can edit this line

    // to change the tolerance

 

    // x1 = x - 2; x2 = x + 2; (original. changed to show tooltip)

    // y1 = y - 2; y2 = y + 2; (original)

 

    //Change the tolerance to 5 pixies

    x1 = x - 5; x2 = x + 5;

    y1 = y - 5; y2 = y + 5;

 

    pt1 = ScreenToMapUnits(x1, y1);

    pt2 = ScreenToMapUnits(x2, y2);

 

    geom = MakeWktPolygon(pt1.X, pt1.Y, pt2.X, pt2.Y);

    reqParams =

    "OPERATION=QUERYMAPFEATURES&VERSION=1.0.0

                &PERSIST=0&MAPNAME="

        +encodeURIComponent(mapName)

        + "&SESSION=" + sessionId + "&SEQ="

        + Math.random() + "&LAYERNAMES="

        + encodeURIComponent(GetVisLayers())

        + "&GEOMETRY=" + geom

        + "&SELECTIONVARIANT=INTERSECTS&MAXFEATURES=1";

 

    obj = new HlRequest(id, x, y, req, exec);

    req.onreadystatechange = obj.OnHl;

    try { req.send(reqParams); } catch (e) { }

}

 

For fusion viewer (flexible web layout), the configuration of map tip tolerance is stored in the application definition (flexible web layout) which is stored in repository.

To solve your problem, you need to edit the ApplicationDefinition resource in repository directly. It can be done by Resource Service API(MgResourceService:GetResourceContent and MgResourceService.SetResource), or by MapAgent, or Maestro, which is an open source tool and not supported by DevTech.

Here is a snippet of application definition resource content, you can increase the value of <Tolerance> tag of MapTip .

<Widget>

   <Name>Maptip</Name>

   <Type>Maptip</Type>

   <Location />

   <Extension>

         <Tolerance>2</Tolerance>

         <Target>MaptipWindow</Target>

        <WinFeatures>

            menubar=no,location=no,resizable=no,status=no

        </WinFeatures>

         <Delay>350</Delay>

         <Layer />

   </Extension>

</Widget>

 

Hope this helps.

Avoid freezing or memory leak of AIMS

By Daniel Du

You many run into the issue of memory leak when working with Autodesk Infrastructure Map Server or MapGuide Enterprise. The memory may increase to a very high level and finally brings down the server, or the server just gets frozen and does not response any more.

Here are some suggestions, hope it is helpful for you.

Firstly, if you are running custom applications, please check your code carefully, to make sure to close the feature reader and release resources as early as possible. You can use following code snippet:

MgFeatureReader reader = featureService.SelectFeatures();
try
{
 //your code here ...
}
finally
{
 Reader.close();
}

Or :

MgFeatureService featureService 
            = siteConnection.CreateService(..)

try
{
  using(MgFeatureReader reader 
            = featureService.SelectFeatures(..)) 
  { 
    // your code here …
    Reader.close();
  }

}
finally
{
  featureService.dispose();
}

Autodesk Infrastructure Map Server is designed very carefully to avoid memory leak, there are sometimes memory leaks in web-based applications and application servers, given the complexity and number of dependent processes. What might appear to be a minor memory leak can accumulate over time and affect general server performance.

One workaround is to write a routine to occasionally restart your web server service, thereby freeing up orphaned resources. Setting the Autodesk MapGuide service to restart automatically may also help in the event that the service has shut down. Following script to stop and start the service:

net stop InfrastructureMapServer2012
net start InfrastructureMapServer2012

You might want to look at the service log files to determine the cause for the service to stop and rectify it to prevent it in the future.

For more suggestions of best practice, please refer to the MapGuide Best Practice Wiki.

It is possible to deploy MapGuide Enterprise or AIMS on Amazon Cloud EC2?

By Daniel Du

Unfortunately at this stage, MapGuide Enterprise or AIMS is not supported to deploy on cloud environment.

From a licensing and warranty stand-point, we are not allowing cloud-based deployment of MapGuide Enterprise 2011 (or previous releases for that matter) – one of the primary reasons being that we have not yet dedicated resources to engineer and test the core server for cloud-based deployment. It’s one of the many things we are considering at the moment in our product plan for future releases.

I can also share with you a information, one Japanese customer did install MapGuide Open Source 2.0 in Amazon EC2 successfully.