Tag Archives: Code
By Lori Armstrong
The World Water Online (WWO) group in the ArcGIS Resource Center has 12 new web map applications based on the SSURGO soil survey database. These apps show soil characteristics that are useful for hydrologic modeling, such as drainage class, available water storage, water table depth, and ponding frequency. The hydrologic group code, which classifies soils based on infiltration rate, can be used to calculate curve number and model how much rain falling in an area will become runoff.
This month the Esri Defense team launched a series of ArcGIS for the Military GitHub Repositiories to share source code for our web, desktop, and mobile applications. For those that aren’t familiar with GitHub, it is a code sharing and … Continue reading
Esri builds tools to make decisions. The ArcGIS platform is the core of this system focused on geospatial data management, conversion, analysis, and visualization. This platform is built to be stable, secure, performant, scale, and provide the general capabilities that … Continue reading
We just posted two more updated templates, The Water Utilities Operations Dashboard and the Water Utilities Customer Interaction(formerly Citizen Service) template. You may have noticed we changed the names of the templates slightly. We switched to Water Utilities because these templates now cover more than just the Water Distribution network.
In the new version of the dashboard, you will find an updated basemap document with improved cartography. All the operational map documents have been updated to include layers for sewer and stormwater. You will also see a new set of widgets, some configured for the new data and some that were included in the most recent release of the sample flex viewer. Take some time and explore the new widgets and give us your feedback. We’re really happy about how user feedback is shaping this template into a true utility dashboard.
The Citizen Service template, now called the Customer Interaction template, underwent a big overhaul. The first release of this template was focused on getting information from the public. In this release, we wanted to expand how and what information can be captured. In the submit request web page, you can now overlay a map service from your utility. A user can click on an asset in that service and use the selected asset to power the request. The selected assets ID is silently submitted with the request, allowing you better identify the asset the request is tied to.
Not only did we want to provide a better way of capturing information, but we wanted to help you share information with your customers. There is a new web page allowing you to do just that. You can list any layers that you want to share with the public in the configuration file. We included two different configurations of this web page with the template. One that share main breaks, out of service hydrants and location of capital projects, the other is used to share boil water notices. The web page can also be used to summarize information by area and then display that to the public, so you can give the public a high level view of information by an operating district or administrative area. As they look closer, the overview will fade away and have access to the detailed feature locations.
Again, we are very happy and pleased with being able to roll out these enhancements. Which, came from all of you. So, please let us know what you like, do not like, what enhancement requests you may have, etc. You feedback drives the development of these. Thanks
We have updated the Water Operations Dashboard. This version is based on the ArcGIS API for Flex 1.2 libraries and the Sample Flex Viewer that was released on May 29th.
The Water Operations Dashboard is based on the Sample Flex Viewer with a few enhancments.
- Identification Widget: This widget allows the user to click on a asset to get a pop up of the information on that asset. To use this widget in another sample flex app, you need to copy the index.swf and the IdentifyWidget widget. This is because we made changes to the core components.
- ChartWidget/ChartWidgetBar: A widget to provide a bar chart or pie chart. This can be used with the sample viewer or the water dashboard
- LiveMapsWidgetWRefresh: Added code so the live maps can be refreshed at a certain interval
- Handle for null attributes: Added error checking to a few widgets so null values are handled, this should fix some of the 1009 errors you may have encountered(SearchWidget, LiveMapWidget were updated)
You can find the source code on the flex code gallery.
Since the ESRI Resource Centers were released over a year ago, the Code Galleries, organized by product and technology, have been a very popular place to upload and download ArcGIS code samples, models, and scripts. Many staff from ESRI and the global ArcGIS developer community have participated in uploading hundreds of samples, and to date, there have been thousands of downloads as well. As described in a previous post, they are quite an improvement over the otherwise very successful “ArcScripts” area on the ESRI Support Center.
But now that there are two places for accessing samples on ESRI’s website, a few questions have come up over the past year from the developer community. Here is a short Q&A below to help answer these.
When should I use the Code Galleries?
Searching: Use any of the dozen or so Code Galleries (here is one example) when you want to search for the latest code and application samples from ESRI and the developer community. Each entry is fully described, searchable, and many have video or Try It Live links for seeing the sample in action before you download it.
Sharing: Use the Code Galleries when you have created helpful samples and would like to share them with the rest of the commmunity.
When should I use ArcScripts instead of the Code Galleries?
ArcScripts continues to exist for older products and versions. If you cannot find a resource center and code gallery for the sample you are trying to search for or upload to, then feel free to use ArcScripts for those. Some examples of ESRI’s older products and technologies that are not represented on the ESRI Resource Centers are MapObjects, ArcView 3.x/Avenue, and ArcIMS.
Should I upload my entry to both ArcScripts and the Code Galleries?
That is not necessary. If you want your sample to reach the widest audience, and you are using current products and technologies, then the Code Galleries will give you the best results. However, you will need to continue using ArcScripts if you are searching for older technologies such as MapObjects, ArcView 3.x/Avenue, ArcIMS, or any other older product not represented in the ESRI Resource Centers.
Will ArcScripts be phased out?
Yes, over time. But as long as users and developers are finding those older code samples and tools helpful, it will remain.
- EDN Team
We’ve had a few questions about whether users and ESRI business partners can submit templates to the Water Utilities Resource Center. We wanted to tell everyone, the answer is yes!
We are encouraging our users and business partners to submit templates to the Water Utility Resource Center template gallery.
Keep in mind there are 5 items that a template must have and all of these items must be in your template zipfile:
1. An instruction document – with information on how to install and configure the template. Including what software is necessary.
2. Any MXD or MXDs necessary – the mxds are critically important to show everyone your cartography, geoprocessing tools, etc.
3. Any custom code – Including the source code.
4. Sample Data – a populated geodatabase with any necessary data for your template. This is so everyone can understand how your template works with sample data. If you can’t share your own data than you can use the sample data we’ve provided with the Mobile, Editing or Dashboard templates for your template.
5. A blank geodatabase – this is an empty geodatabase with the same schema as your sample geodatabase.
Here is an example of the folder structure your template should follow:
A few ground rules for submitting templates – we will review each template to ensure that the proper items are in them and they function as advertised. We won’t accept any templates that have trial software applications or extensions in them or don’t have the source code if there was custom programming in your template.
So anyone ready to share your good work?
If you have any questions about how to create your own template and post it email us at ArcGISTeamWater@ESRI.com
We would like to introduce this new blog series for the ArcGIS Resource Centers.
This series focuses specifically on the Resource Center Code Galleries. It will cover a wide range of topics including tips and tricks on how to use the galleries, posts highlighting new content, website updates, and hints on how to work with the galleries more effectively.
We’ll also be showcasing some of the best entries here as well, so be sure to stay tuned.
Let’s first get started with a little Q/A.
The code galleries are an online collaboration tool that you can use to share code and exchange ideas with others in the community.
If you browse the entries, you’ll find they contain a wide range of applications and samples. Some are short, specific examples of how to accomplish a given task, while others are more elaborate solutions to real-world problems. Others include code for applications that were shown in presentations at the DevSummit .
In total, there are 16 galleries available for a number of different developer communities:
ArcGIS Desktop and Engine: .NET Java
ArcGIS Mobile: .NET
Geoprocessing: Model and Script
Business Analyst Extension: Desktop Server
Water Utilities: Template
1. Navigate to one of the Code Galleries above.
2. Select a field (name, rating, date added…) to sort the entries.
3. Select the entry itself to get more information.
1. Navigate to one of the Code Galleries.
2. Type in a key word in the Search box at the top.
3. Filter your results by selecting the “Code Gallery” node.
1. Find the sample of interest.
2. If the “View it Live” link is available, click on the link.
Tip: This feature is only enabled if the author who uploaded the entry specified a URL to the application online or a URL to a video that demonstrates how the application works.
1. Find the sample of interest.
2. Click on the download link.
1. Package all of your code, data and a Readme.txt file in one .zip file (max size 30 MB).
2. Go to the appropriate code gallery and create a new entry.
3. Fill out the information for your submission (title, description and requirements…) and submit.
Tip: You will need to create or login to your ESRI Global Account to upload a sample. If you don’t have one, go here.
Tip: If you download code, you might also want to subscribe to the RSS feed so you can be notified of any new comments! Authors often post helpful information here or they’ll make a post when changes are made to the code or new versions are available.
Whether you are just browsing for a solution or you would like the upload and share something with the community, the code galleries are an important resource for everyone.
Tip: If you want to know when new entries are made, be sure to subscribe to the RSS feeds for each gallery so you are notified automatically.
Lastly, if you have any feedback on the galleries, feel free to leave them on the gallery pages themselves or on this post as well.
Welcome to ESRI’s first industry focused resource center. We are very excited about providing our water, wastewater and stormwater utility users with information specifically focused for your industry, such as free downloadable templates built around core ESRI software, a place for users to share their own templates and knowledge and this blog to assist water utilities in deploying our technology.
We would like to thank the Fort Pierce Water Authority and St Lucie County, Florida for allowing us to include a sample of their data in our templates. Allowing us to develop these sample templates with real customer data makes the samples a more powerful example of the benefits water utilities can expect from deploying ESRI technology.
We’ve posted three templates for the launch of the water utility resource center. These templates are for maintaining your water utility assets, sharing information with the field and enabling operational awareness. We are currently working on a fourth template for capital improvement planning, which we will post in the near future.
The goal of our templates is to give our water utility customers real world examples of how to deploy the ArcGIS product suite in your industry. There is a zip file for each of the templates we’ve posted. Each zip files include detailed installation instructions, map documents, an implementation of ESRI technology, including the source code, sample data schema and a sample dataset using this schema. We’ve also recorded videos with detail information on how to install and configure these templates.
We decided to create these templates because we wanted to pass on to our customers best practices, successful deployment patterns and share industry specific knowledge. Remember, the water resource center is for ESRI users – so we encourage you to post what you’ve developed to the template gallery. We also need your feedback on the templates we’ve provided and ask that you post comments for each template. We’ll be using your comments as a guide for changes to our templates and for new templates we’ll develop in the future.
Keep watching this blog; we’ll be sharing a great deal of valuable information here. We plan to post detailed information on our three launch templates, instructions on how to use your utility’s data with the templates and also share best practices we’ve observed from working with our water utility customers.
This is truly an exciting time to be using ArcGIS for water, wastewater and stormwater!
If you haven’t heard, the ArcGIS Development Team has just released a new .NET utility called the ESRI API Evaluator. This handy tool allows you to scan all of your ArcGIS .NET code and generate a complete set of API usage statistics. This will reveal the DLL dependencies, version information and the number of calls made to all ESRI assemblies, interfaces and members.
Help improve the product
One of the most important features of this tool is that it allows you to send your API usage information directly to the ArcGIS Development Team. Once received, this information will be used to:
1. Better understand the APIs that our customers are using (most popular).
2. Make improvements to focused areas of the SDK (documentation and samples).
3. Make decisions for future API development projects.
API Evaluator Scenarios
Scenario I – Help improve the SDK
You have been working on a number of ArcGIS projects and have had difficulty implementing various parts of the SDK. Use the API Evaluator to let ESRI know what areas of the API are most important to you by uploading the usage statistics without actually sending us the code!
Scenario II – Improve your code
You have been working on an agile development project with a team of developers. You would like to discover which parts of the API have been used the most by the team and if code reuse has been maximized. Use the API Evaluator to determine the number of calls to all interfaces, methods and properties in the .NET assemblies and look for areas of improvement.
Scenario III – Deployment
You would like to determine the .NET Framework version, and ArcGIS license and extension requirements for an application. Use this information to help determine the software and licensing requirements for deployment systems.
It’s easy to use!
Step 1. Start the tool and run a new scan.
Step 2. Select the folder(s) you wish to scan.
NOTE: If you are scanning a Visual Studio 2005/2008 web application, build and publish the website to generate the precompiled assemblies first.
Step 3. Optionally, supply your contact information if you plan to upload your scan to ESRI.
Step 4 – Confirm your selections.
Step 5 – Review the results.
Step 6 – Upload results to ESRI. Simply select the “Upload Scan” menu.
A few reasons to give it a try
I’m sure you can think of many different uses for this tool, but in general, you can use this tool to:
1. Determine the general API usage for larger or unknown code samples.
2. Determine the licensing required to run an application.
3. Locate redundant code sections and make improvements.
4. Detect library dependencies to help with deployment scenarios.
5. Detect .NET version dependencies.
6. And most importantly, help improve the product (see below).
Where can I download it? You can download the tool from the ArcGIS Engine Code Gallery.
Where can I find more information? You can find the documentation on the ArcGIS Engine Resource Center online.
We want your feedback!
Although the “Upload Scan” functionality is 100% optional, we do appreciate all feedback from the developer community, so we hope you find this tool useful and you can spend a few minutes uploading the results back to ESRI.
Let us know if you have any questions or feedback.
Thanks for your participation!
ArcGIS Development Team