Getting Started with iClient for Flash

After you installed SuperMap iClient 8C for Flash according to the System Requirements, you can use this product to build map applications with characteristics of friendly interface, high interaction and excellent experience. The development workflow of SuperMap iClient 8C for Flash is shown as follows:

Figure 1 The Development Workflow of SuperMap iClient 8C for Flash

Here is an introduction about how to use SuperMap iClient 8C for Flash to build a simple map application.

Step 1: Download and Extract Library Files

1. Download SuperMap iClient 8C for Flash and unzip the package onto local computer.

2. Below is the catalog structure of the software package:
   

   

   Figure 2 SuperMap iClient 8C for Flash Package Structure

   • The help folder holds the SuperMap iClient 8C for Flash help documentation.

   • The libs folder holds script library files of SuperMap iClient 8C for Flash. The script library files are listed in the table below:

     SuperMap iClient 8C for Flash library files

     Library file	Function
     SuperMap.Web.swc	The core library for SuperMap iClient 8C for Flash includes 7 packages. Objects such as Map controls and other display controls, client layer, map actions, geographic features, service base class, etc., are included in the library. The 7 packages are: com.supermap.web.actions com.supermap.web.clustering com.supermap.web.components com.supermap.web.core com.supermap.web.events com.supermap.web.mapping com.supermap.web.rendering com.supermap.web.resources com.supermap.web.utils
     SuperMap.Web.iServer7C.swc	The library supporting SuperMap iServer 8C services, which includes 2 packages: com.supermap.web.iServer7C com.supermap.web.mapping

   • samplecode_iServer8C holds the SampleCode of SuperMap iClient 8C for Flash. Double click samplecode.html to view the sample code.Please refer to Sample Code Guide.

   • crossdomain.xml is the cross-domain file. When client applications and services are not in the same domain, the clientaccesspolicy.xml file is necessary. The crossdomain.xml will be held in different paths according to how the services are published. Take Tomcat and IIS as examples:

     • Tomcat: You must put the cross-domain file in < SuperMap_iServer_Install_Location>\webapps\ROOT.
     • IIS: SuperMap IS.NET 6 uses IIS to publish services, so the cross-domain file is located in C:\inetpub\wwwroot
     • Other services: If you use other ways to publish services, you must put the cross-domain file in the root directory of its server.

   • SuperMap_iClient_8C_for_Flash_Readme_ENG.pdf: SuperMap iClient for Flash Readme file. Before using iClient for Flash, it is recommended that you read this document first.

Step 2: Create a New Flex Project

1. In Flash Builder4, Select File > New >Flex Project, or right click in Package Explorer and click New > Flex Project to display the New Flex Project dialog box. Input the project name in the Project name text box.

   
   Figure 3 New Project

2. Click Next, and click Next again to go to the New Flex Project page.

3. Click Library path to add library files. Click Add SWC to siplay the Add SWC dialog box, and click Browse to navigate to the folder where the library files are located. To use client basic map functionalities, add SuperMap.Web.*.swc; to use SuperMap iServer 8C functionalities, add SuperMap.Web.iServer7C.*.swc. For instance, if you want to display maps of SuperMap iServer services, you need to add SuperMap.Web.*.swc and SuperMap.Web.iServer7C.*.swc. Also, you can add the folder where the library files are located to add the library files. Change the name of the main application in Main application name text box.

   
   Figure 4 Add library files
4. Click Finish to complete. A project named Flex is added to Package Explorer. Double click GettingStarted.mxml in the src folder to open it in the window on the right side. Now we can add code.

   

   Figure 5 Flex project

Step 3: Add Code to Realize Map Accessing

        Add code below into GettingStarted.mxml to realize the accessing of tiled dynamic layer of SuperMap iServer 8C service. Code in read is the added code:

<?xml version="1.0" encoding="utf-8"?>
<s:Application xmlns:fx="http://ns.adobe.com/mxml/2009"                       
               xmlns:s="library://ns.adobe.com/flex/spark"                       
               xmlns:mx="library://ns.adobe.com/flex/mx"                          
               xmlns:ic="http://www.supermap.com/iclient/2010"                        
               xmlns:is="http://www.supermap.com/iserverjava/2010"                    
               width="100%" height="100%">  
    <!--Add map-->   
    <!--scales: the map scale; url: Web service address; url: map service address-->   
    <ic:Map id="map" x="0" y="0" height="100%" width="100%"            
            scales="{[1.25e-9, 2.5e-9, 5e-9, 1e-8, 2e-8, 4e-8, 8e-8, 1.6e-7, 3.205e-7, 6.4e-7]}">          
        <is:TiledDynamicRESTLayer url="http://192.168.11.11:8090/iserver/services/maps/rest/maps/World Map"/>   
    </ic:Map>
</s:Application>

Note: The map service url in the code is only for demonstration. To guarantee the proper running of this sample, you need to make sure that SuperMap iServer 8C has been installed on the computer, the cross-domain file has been placed in <SuperMap_iServer_Install_Location>\webapps\ROOT, and the service has been started successfully.

Step 4: Run the Project and View the Map

Click Ctr+F11 to run the application, or right click GettingStarted.mxml and click Run Application to run it. You can see WorldMap published by SuperMap iServer 8C through service.

Figure 7 Access World Map of SuperMap iServer 8C service