FAQs

This page describes an older version, please read about the latest version at:
http://resources.arcgis.com/en/help/flex-viewer/concepts/

This topic contains questions or issues that you may face when working with ArcGIS Viewer for Flex, and some recommended solutions. If you don't find the problem you are looking for, see the the Flex Viewer Overview, post your question on the ArcGIS Viewer for Flex forum, or contact Technical Support.

General questions

Troubleshooting

For Flex developers

Do you need to download the Flex API to use the ArcGIS Viewer for Flex?

No. The ArcGIS Viewer for Flex is built with the Flex API, which is embedded within the Viewer.

Can you use older compiled widgets with the latest Flex Viewer?

In general, it is best if all widgets were compiled with the same application programming interface (API) version and the same Viewer version.

For example, if the widgets are version 2.2 or 2.3, they work with version 2.3.1. Version 2.4 had minor changes to IWidgetContainer, EditWidgetAttachmentInspectorSkin, and NavigationSkin, which require code changes in older widgets to be made (and recompiled). Still, it is recommended that you upgrade your widgets and applications to the current version.

In general, the aim is for backward compatibility. However, widgets compiled pre-2.4 do not work with the compiled 2.4 viewer. Also, compiled 2.1 widgets can only be used in version 2.1 as there was a minor, but breaking, change in the widget framework. As for using new widgets in earlier versions of the viewer, this is different and in general not supported, as new widgets often take advantage of new capabilities that were not available in earlier versions.

How do you add a logo on the map?

Option 1—Use the <logo> tag in the main configuration file to set the logo shown in the top left when using the HeaderController.

Option 2—Use the StaticImage widget to display any image (including a logo or a legend) anywhere in the application.

How do you remove the Esri logo at the bottom right on the map?

Turning off the Esri logo and adding your logo with a link is much easier as of version 2.2 than in earlier versions. In version 2.2, you can edit the config.xml file. There is no need to use the source code.

The <map> tag now has an esrilogovisible property (similar to the Flex API). To not show the Esri logo in the main configuration file, use the following code: 

<map esrilogovisible="false">

How do you remove the Bing logo at the bottom left on the map?

The Bing Maps license agreement does not allow removing the Bing logo.

What's the equivalent of the Live Layer widget from the Sample Flex Viewer?

The Query widget is similar to the old Live Layer widget. The Query Widget enables end users to query information from a map service, by executing a pre-defined query.

What is the relation between Flex Viewer and arcgis.com?

The ArcGIS Viewer for Flex is not directly tied to the ArcGIS.com website. The Viewer is a stand-alone application that is downloaded onto a local web server. Its purpose is to be configured and/or customized to work with custom data content from ArcGIS Server or ArcGIS Online Web services. Web maps published and shared on ArcGIS.com can be used with the itemid property in the main <map> tag, in the main configuration file, as an alternative to specifying basemaps and operational layers. Published web maps on ArcGIS.com can also be viewed by using Flex API applications, ArcGIS.com Viewer, ArcGIS Explorer Online, or with ArcGIS for iOS.

Which functionality requires ArcGIS 10?

Most functionality works with ArcGIS Server 9.3 or above. At 9.3, the REST API was introduced, which is what the ArcGIS API for Flex uses to communicate with ArcGIS Server. However, some functionality was introduced in later versions with different minimum requirements:

  1. The Edit Widget, which requires an editable layer in a FeatureService, and is only available with ArcGIS Server 10 or later.
  2. The Time Slider widget requires a time-aware layer, and is only available with ArcGIS Server 10 or later.

What about the next version?

The next 2.x version will be 2.6. It is currently scheduled for sometime in 2012. The following is a partial list of items currently being evaluated for inclusion in that version:

  • Improved Application builder for the Flex Viewer: support custom widgets, localized application builder, support widget groups
  • Bug fixes

As part of the ArcGIS 10.1 beta , there will also be a matching 3.0 beta for the Flex API and Flex Viewer that will support new features added in ArcGIS Server 10.1 beta. It requires Adobe Flex SDK 4.5 and requires end-users to have Adobe Flash Player 10.2 or higher.

How do you verify the integrity of the downloaded ArcGIS Viewer for Flex ZIP files?

Every download of the ArcGIS Viewer for Flex library has an associated MD5 checksum (see the following table). After downloading the ZIP file, calculate its checksum and make sure it matches the checksum in the following table.

You can use the checksum task of Apache ANT to generate an MD5 checksum of your downloaded file. On Mac OS X, bring up the Terminal and type, md5 flexviewer-2.5.zip.

Version

Ready-to-deploy zip

Zip with source code

2.5 (November 30, 2011)

flexviewer-2.5.zip 5593f9cbd6bec216cf818decf21c1833

flexviewer-2.5-src.zip c10fa4c7f4d70c1cc13f38eb2d3190f9

2.4 (July 25, 2011)

flexviewer-2.4.zip adfcce84dc673492d89fcf439dced834

flexviewer-2.4-src.zip 379bedbc1e52674ffe744d52b2eb1145

2.3.1 (April 26, 2011)

flexviewer-2.3.1.zip 29448cb3e34a0616126a6b1490bded93

flexviewer-2.3.1-src.zip 6f9ffa3533549757bf977ca31ee92e4a

2.3 (April 14, 2011)

flexviewer-2.3.zip f0cd9d00a5c4e76288bf4c53af65b302

flexviewer-2.3-src.zip 054b35d68a19eb0468630d23169cc323

2.2 (December 10, 2010)

flexviewer-2.2.zip 43374df2ff706ae6825948848e2de3ed

flexviewer-2.2-src.zip 8d5c7487befbee87276e0fe1eded208d

2.1 (September 21, 2010)

flexviewer-2.1.zip e6a474221cbd0767995af2a205f04256

flexviewer-2.1-src.zip 643baf65c4fbc6869f1667faa7a85fa8

Why can't you see changes to your application?

  1. The most common scenario is browser caching. There are two solutions, clear all your browser cache or refresh the specific file that you updated. If you modified the config.xml, open that specific page in your browser (for example, http://localhost/flexviewer/config.xml) and refresh the page (F5 in most browsers).
  2. Another common scenario is server modifications not reflected in your application. If you made changes to your mxd file in ArcMap, you need to re-publish the service, and clear the REST cache using ArcGIS REST API Admin.

Why does the Flex Viewer show "Fault code: InvokeFailed" and "Fault info: Error #2148..."?

This can happen if you open index.html from the file system. You need to run the Flex Viewer on a web server. If you get this error, make sure the uniform resource locator (URL) on the page shows, http://something (and not file://something).

For more information on possible runtime errors, see Run-Time Errors on the Adobe website.

Why does Flex Viewer show "SecurityError: Error #2048: Security sandbox violation"?

This is most likely a cross-domain issue. This happens if you are connecting from a Flash application to resources on another domain. Either have the application hosted on the same domain as the resource (usually the ArcGIS Server) or add a crossdomain.xml to your ArcGIS Server.

Why does Flex Viewer (and other Flex applications) show "Error #2032: Stream Error"?

This could be for many reason. One reason could be that your web server is not set up to handle .SWZ files. To modify the MIME types on IIS server to include the .SWZ file type, follow the steps at http://viveklakhanpal.wordpress.com/tag/error-2032-stream-error/.

Where is the equivalent of the old Developer's Guide PDF that came with the Sample Flex Viewer?

For developer information for ArcGIS Viewer for Flex, see Getting started for developers on the Resource Center.

Copyright © 1995-2012 Esri. All rights reserved.
2/15/2012