ArcGIS Pro SDK Blog - Page 5

cancel
Showing results for 
Show  only  | Search instead for 
Did you mean: 

Latest Activity

(83 Posts)
by Anonymous User
Not applicable

Original Author: @ChristopherZent 

 

ArcGIS Pro 2.2 is now available, and included are many new updates to the ArcGIS Pro SDK.   Information on installing and upgrading to the latest SDK can be found in this ProGuide.

 

Some of the 2.2 SDK update highlights include:

 

API updates

New classes and methods for customizing Pro in the areas of:

  • Editing  The Editing API has additional capabilities for management of annotation features, with new control over annotation properties.  Also, there are split operations which are now available in the API.
  • Framework  The Framework API has added support for the checking in and out of extension licenses in a concurrent licensing environment. Also, there is new support for sub-groups in DAML providing more control over the layout of controls on the Pro ribbon.
  • Geodatabase – The Geodatabase API has added new capabilities for table sorting and calculating statistics on fields in a table.
  • Utility Network – The Utility Network API has added new routines to better integrate operations such as Validate Network Topology, and enabling/disabling controllers in the Pro UI.  There is also the ability to change the layout of network diagrams, and new classes to describe tier groups and network attributes.
  • Performance improvements – the new AccelerateForRelationalOperations method provides a new accelerated geometry which can speed up relational operations on polyline and polygon geometries.

For a full listing of all the API changes, see the “What’s New for Developers at 2.2” page in the Pro API reference.

 

New code samples and documentation

The SDK team has developed several new samples, and updated concept and guide documentation, which can be found at the community samples site and the SDK documentation site.

 

There are now 135 Pro SDK community samples on GitHub.  The samples are ready-to-run Visual Studio solutions which illustrate many of the SDK coding patterns, and they are organized by topic area.  Each sample includes a short set of walk-through steps to get it started.

 

Some of the new samples include:

 

The new Edit Events Sample, illustrates how to create a dockpane which listens and displays the results of editing Row, Completing, and Completed events.

 

Another new sample, Datastores, Definitions and Datasets, demonstrates the use of the Geodatabase API to retrieve metadata from a set of data sources.

 

Finally, for those of you heading to the Esri User Conference, plan to drop by the ArcGIS Pro Area in the Esri Expo to see demonstrations of ArcGIS Pro and the Pro SDK, and discuss more about the 2.2 updates with the team!

 

more
0 0 470
by Anonymous User
Not applicable

Original Author: @ChristopherZent 

 

The ArcGIS Pro SDK technical session videos from the 2018 Esri Developer Summit are now online at the Esri Events Channel on YouTube.  Also, slides are available at the Proceedings site.

Below is a list of the Pro SDK sessions with video and session slide links, where currently available.

The sessions are a great way to get introduced to, and updated on, the latest SDK information and development patterns.

 

 

Technical Sessions

ArcGIS Pro SDK for .NET: Beginning Pro Customization and Extensibility

Learn how to customize and extend ArcGIS Pro with its .NET SDK. We’ll show you how you can get up and running quickly with the Add-in and Configuration customization patterns, declarative programming with DAML, and asynchronous programming with ArcGIS Pro’s QueuedTask.    Session slides

ArcGIS Pro SDK for .NET: Advanced Pro Customization

In this session we cover advanced customization patterns including custom project and application properties, command filtering, UI customization across multiple add-in solutions, plug and play UI extensibility with embeddable controls and DAML categories.  Session slides

ArcGIS Pro SDK for .NET: Beginning Editing and Editing UI Patterns

Learn how to create editing tools in Pro. We introduce construction tools and editing tools and how to integrate your custom editing functionality into the Pro UI. We introduce the Inspector class for creating and updating features as well as attribute editing. We show customizing the galleries, integration into modify dockpane, and how to modify the sketch.  Session slides

ArcGIS Pro SDK for .NET:  Advanced Editing and Edit Operations

This session focuses on use of Edit Operation and Edit events. We will cover key edit operation capabilities and edit operation usage to include: versioned edits; combine operations to span across multiple datasets; chaining edit operations. We will investigate edit events and row-level events as well as edit Undo/Redo.  Session slides

ArcGIS Pro SDK for .NET:  Pro Application Architecture Overview and API Patterns

This lecture covers the Pro application architecture framework and its primary patterns to include context in the UI, DAML, extensibility and the module sub-system, and threading – concurrency, best practices, and cancellation. This lecture is appropriate for Pro application developers who want to learn more about the Pro internals and how to leverage that knowledge in their add-in and configuration designs.  Session slides

ArcGIS Pro SDK for .NET: Mapping and Layout

Learn how to create map tools for selection and identify, and custom pop-ups. We will examine the new Pro Layout API to create Layouts on-the-fly as well as integrate it with Layout Map Series. We will cover MVVM and integration of WPF to write compelling UIs in Pro including multi-threading considerations.

ArcGIS Pro SDK for .NET:  Working with Rasters and Imagery

Learn how to use the ArcGIS Pro SDK with Imagery and Raster data to create compelling add-ins. Developers can use the ArcGIS Pro SDK to control how their imagery and raster data is displayed, read/write pixels and properties and control how data is processed.  Session slides

ArcGIS Pro SDK for .NET: An Overview of the Geodatabase API

This session will provide an overview of the geodatabase .NET API (ArcGIS.Core.Data) for working with data in ArcGIS Pro, including working with datasets, fields, queries, selections, joins and relates.  Session slides

ArcGIS Pro SDK for .NET: An Overview of the Utility Network Management API

This session will provide an overview of the utility network .NET API in ArcGIS Pro to create custom tools and applications for electric, gas, water and waste water utilities.  Session slides

 

Demo Theater Sessions

ArcGIS Pro SDK for .NET: New UI Controls for the SDK

We cover the new user controls available in the ArcGIS Pro SDK for .NET including Query Builder control, Locator control, and Coordinate Systems picker control. Learn how to integrate these controls into your custom Pro UIs.

ArcGIS Pro SDK for .NET: Raster API and Manipulating Pixel Blocks

We cover use of the Raster API to select and iterate through raster data. The demo will include creating a raster cursor to iterate through raster data and reading and writing pixels from and to a raster dataset using pixel blocks.

ArcGIS Pro SDK for .NET: Custom States and Conditions

Learn how to take advantage of contextual behavior in ArcGIS Pro using states and conditions. This demo will focus on DAML elements in ArcGIS Pro add-ins, and how to manipulate the Pro UI and content based on what’s selected in the application.  Session slides

ArcGIS Pro SDK for .NET: Getting Started

Join us for quick tips and demos on building your first Pro add-in. We’ll show you how you can get up and running quickly with the DevLabs and samples, and introduce you to the many online resources.  Session slides

 

Hands-On Workshop

Getting Started with the ArcGIS Pro SDK for .NET

This new hands-on training workshop will introduce you to ArcGIS Pro SDK concepts, helpful tips and practical steps to help you get started developing add-ins to extend ArcGIS Pro. Participants will walk through topics with the workshop instructor and then work through exercises using their own device with the Pro SDK and the Microsoft Visual Studio development environment.

more
0 0 454
by Anonymous User
Not applicable

Original Author: @ChristopherZent 

 

Recently the ArcGIS Marketplace enabled the ability for organizations to market and distribute ArcGIS Pro add-ins and Web AppBuilder widgets directly from the Marketplace site.  This new capability provides users with the ability to create informative product listings from which they deploy their products.  You can learn more about becoming a Marketplace provider here.

ArcGIS Pro Add-In Listings

ArcGIS Pro add-in developers can now create listings to distribute and market their add-ins, allowing users to try, purchase and download their add-ins directly from the Marketplace site.  It provides a nice new option for developers to showcase and increase exposure for their add-ins.  The new capability also makes it easier for ArcGIS Pro users to find Pro add-ins for their work.  Users can now select the new content Type option of “ArcGIS Pro add-ins”, and if desired, refine further by selecting by Industry and more.

 

 
 
 

ArcGIS Pro add-ins extend the capabilities of ArcGIS Pro with custom functionality, and are developed with the ArcGIS Pro SDK for Microsoft .NET.  Many organizations have been developing Pro add-ins over the past few years.  Developers are taking advantage of the many new features available with ArcGIS Pro, and the streamlined development capabilities offered in the Pro SDK.  You can find information and resources on the Pro SDK here.

 

MobiGTFS, by MobiGIS

The first dedicated ArcGIS Pro add-in product listing on the ArcGIS Marketplace, MobiGTFS, can now be found on the site.  The add-in, from MobiGIS, extends ArcGIS Pro and provides tools which are focused on the transportation industry.

 

 

From MobiGIS’ new listing, GTFS stands for General Transit Feed Specification.  MobiGTFS provides the ability to explore public transportation schedules and associated geographic information in GTFS format. The add-in provides ArcGIS Pro users with tools to import, edit and export data using the specification.  Also, as seen in their listing, MobiGIS is currently offering a free 15-day trial of their new add-in.

Here are a couple screenshots of MobiGTFS:

 

 
 

Congratulations to MobiGIS on their new ArcGIS Pro add-in and Marketplace listing. 

 

Be sure to check back on the ArcGIS Marketplace for new add-in listings for your industry to help enhance and streamline your work with ArcGIS Pro.

more
1 0 616
by Anonymous User
Not applicable

Original Author: @ChristopherZent 

 

The Esri Developer Summit is just a month away, scheduled for March 6 – 9, 2018 in Palm Springs.

Many teams at Esri have been working to put together a comprehensive line-up of offerings to help you get started with the ArcGIS Pro SDK, and of course, caught up with the latest features and patterns at 2.1.  Here are the different offerings / formats available:

  • Pre-summit Hands-On Training
  • Getting Started Hands-On Workshop (New)
  • One-hour Technical Sessions
  • 30-minute Demo Theater Sessions
  • ArcGIS Pro Area in the Esri Showcase

Below is a list of all the Pro SDK offerings with descriptions.  For more information, you can search the online agenda here using keywords “Pro SDK”.  We look forward to seeing you at Dev Summit!

Pre-summit Hands-On Training

Once again, there will be a pre-summit hands-on SDK training course offered.  The course is titled “Introduction to Programming with the ArcGIS Pro SDK for .NET” and will be offered March 4th – 5th, 8:30 am – 5:30 pm at the Hilton Palm Springs Hotel.   If you’re looking for a comprehensive, in-depth introduction to the Pro SDK, this is it.  Plan to bring your own machine pre-loaded with ArcGIS Pro and Visual Studio, as well as your Visual Studio .NET skills and get ready to learn:

Introduction to Programming with the ArcGIS Pro SDK for .NET 

This two-day hands-on training course will introduce you to the fundamentals of using the ArcGIS Pro SDK for .NET to customize and extend ArcGIS Pro. Participants will work with Microsoft Visual Studio, the .NET Framework and the Pro SDK to create Pro add-ins to automate existing processes and to add new capabilities that you design and write. The ArcGIS Pro API exposes core aspects of Pro, including: 2D and 3D maps, sharing, integration with ArcGIS Online, Geodatabase, Geometry, Editing, Layouts, and more. The Pro API is also asynchronous and supports multi-threaded programming, and the Pro SDK patterns will be introduced in the workshop.

You can find out more on the Pre-Summit Training page.

Getting Started Hands-On Workshop

New at Dev Summit this year, there will be a hands-on training workshop offered during Dev Summit week.  The new 5-hour workshop is called “Getting Started with the ArcGIS Pro SDK. for .NET” and will be offered on Thursday, March 8th, 9:00 am – 3:30 pm in the Mojave Learning Center.  This is a great way to learn basic and intermediate-level skills with the Pro SDK.  Here’s the description.

Getting Started with the ArcGIS Pro SDK. for .NET

This new hands-on training workshop will introduce you to ArcGIS Pro SDK concepts, helpful tips and practical steps to help you get started developing add-ins to extend ArcGIS Pro. Participants will walk through topics with the workshop instructor and then work through exercises using their own device with the Pro SDK and the Microsoft Visual Studio development environment. Topics will include:

  • Pro SDK overview, online resources and community samples
  • Starting with DAML and UI customization
  • Basic solution configuration development
  • Working with common SDK patterns

Prerequisites:  This workshop assumes that participants have basic experience developing Windows applications using Microsoft Visual Studio 2015 or 2017 and .NET, as well as a few months of experience working with ArcGIS Pro.  Workshop participants must bring their own device, pre-installed with ArcGIS Pro 2.1 and Microsoft Visual Studio 2015 or 2017.

Technical Sessions

In these one-hour technical sessions, Esri teams will be presenting in-depth concept information and more on the Pro SDK’s latest API enhancements, customization and programming patterns, and resources.

ArcGIS Pro SDK for .NET: Beginning Pro Customization and Extensibility

Learn how to customize and extend ArcGIS Pro with its .NET SDK. We’ll show you how you can get up and running quickly with the Add-in and Configuration customization patterns, declarative programming with DAML, and asynchronous programming with ArcGIS Pro’s QueuedTask.

ArcGIS Pro SDK for .NET: Advanced Pro Customization and Extensibility

In this session we cover advanced customization patterns including custom project and application properties, command filtering, UI customization across multiple add-in solutions, plug and play UI extensibility with embeddable controls and DAML categories.

ArcGIS Pro SDK for .NET: Beginning Editing and Editing UI Patterns

Learn how to create editing tools in Pro. We introduce construction tools and editing tools and how to integrate your custom editing functionality into the Pro UI. We introduce the Inspector class for creating and updating features as well as attribute editing. We show customizing the galleries, integration into modify dockpane, and how to modify the sketch.

ArcGIS Pro SDK for .NET:  Advanced Editing and Edit Operations

This session focuses on use of Edit Operation and Edit events. We will cover key edit operation capabilities and edit operation usage to include: versioned edits; combine operations to span across multiple datasets; chaining edit operations. We will investigate edit events and row-level events as well as edit Undo/Redo.

ArcGIS Pro SDK for .NET:  Pro Application Architecture Overview and API Patterns

This lecture covers the Pro application architecture framework and its primary patterns to include context in the UI, DAML, extensibility and the module sub-system, and threading – concurrency, best practices, and cancellation. This lecture is appropriate for Pro application developers who want to learn more about the Pro internals and how to leverage that knowledge in their add-in and configuration designs.

ArcGIS Pro SDK for .NET: Mapping and Layout

Learn how to create map tools for selection and identify, and custom pop-ups. We will examine the new Pro Layout API to create Layouts on-the-fly as well as integrate it with Layout Map Series. We will cover MVVM and integration of WPF to write compelling UIs in Pro including multi-threading considerations.

ArcGIS Pro SDK for .NET: An Overview of the Geodatabase API

This session will provide an overview of the geodatabase .NET API (ArcGIS.Core.Data) for working with data in ArcGIS Pro, including working with datasets, fields, queries, selections, joins and relates.

ArcGIS Pro SDK for .NET: An Overview of the Utility Network Management API

This session will provide an overview of the utility network .NET API in ArcGIS Pro to create custom tools and applications for electric, gas, water and waste water utilities.

ArcGIS Pro SDK for .NET:  Working with Rasters and Imagery

Learn how to use the ArcGIS Pro SDK with Imagery and Raster data to create compelling add-ins. Developers can use the ArcGIS Pro SDK to control how their imagery and raster data is displayed, read/write pixels and properties and control how data is processed.

Demo Theater Sessions

These 30-minute sessions are concise and demonstration-focused in their content and presentation.

Demo Theater:  ArcGIS Pro SDK for .NET: Custom States and Conditions

Learn how to take advantage of contextual behavior in ArcGIS Pro using states and conditions. This demo will focus on DAML elements in ArcGIS Pro add-ins, and how to manipulate the Pro UI and content based on what’s selected in the application.

Demo Theater:  ArcGIS Pro SDK for .NET: New UI Controls for the SDK

We cover the new user controls available in the ArcGIS Pro SDK for .NET including Query Builder control, Locator control, and Coordinate Systems picker control. Learn how to integrate these controls into your custom Pro UIs.

Demo Theater:  ArcGIS Pro SDK for .NET: Raster API and Manipulating Pixel Blocks

We cover use of the Raster API to select and iterate through raster data. The demo will include creating a raster cursor to iterate through raster data and reading and writing pixels from and to a raster dataset using pixel blocks.

Demo Theater:  ArcGIS Pro SDK for .NET: Getting Started

Looking for a quick walk-through on how to get up and running with the ArcGIS Pro SDK? Join us for quick tips and demos on installing the Pro SDK and the SDK community samples and building your first Pro add-in. We’ll show you how you can get up and running quickly with the samples, and introduce you to the many online resources.

ArcGIS Pro Area in the Esri Showcase

The Desktop SDK Team and other ArcGIS Pro product teams will be available each day in the ArcGIS Pro Area in the Esri Showcase.  Stop by with your questions and discuss how you would like to customize ArcGIS Pro to meet your organization’s needs and workflows.

Register for Dev Summit 2018 here.  We look forward to seeing you there!

more
0 0 525
by Anonymous User
Not applicable

Original Author: @ChristopherZent 

 

ArcGIS Pro 2.1 is now available, and included are many new updates to the ArcGIS Pro SDK Information on installing the SDK can be found in this ProGuide.

Update highlights include:

API enhancements

  • Annotation – Create and edit annotation features
  • Layout – Create new layouts and layout elements, and manage layout views and selections
  • Utility Network – Create custom utility network tools, traces and workflows
  • Content – Manage project item metadata
  • Portal – Query portal and online for groups, folders, and content

New code samples and guides

The teams have developed many new samples, and new concept and guide documentation which can be found at thecommunity samples site and the SDK documentation site.

Also, the “What’s New for Developers at 2.1” page in the Pro API reference includes the full list of API Changes.

The new AnnoTools sample add-in showing examples performing updates via the new Annotation API:

Viewing metadata with the new MetadataViewer sample add-in, leveraging new Content API updates:

In the coming weeks, we’ll have new posts on the key enhancement areas listed above.

Developer Summit 2018 is coming – Search the Dev Summit agenda using “Pro SDK” to quickly find the many sessions available throughout the week.  Links to more learning opportunities at Dev Summit are found in this earlier post.

more
2 0 579
by Anonymous User
Not applicable

Original Author: @ChristopherZent 

 

Happy New Year!  Looking back at 2017, it was a great year for ArcGIS Pro extensibility. We saw many developers taking advantage of the Pro SDK in extending Pro to meet their organizations’ specific needs and workflows.  The ArcGIS Pro teams developed powerful new Pro SDK functionality, and grew the SDK significantly. Here’s a brief overview of some highlights from the 2017 Pro releases:

Pro SDK 1.4:

  • API enhancements –  New classes and methods for working with Geodatabase, Geometry and new UI controls.
  • Light/dark theme styling – with the new Pro 1.4 light and dark theme capability, the SDK was expanded to allow add-ins and configurations to be styled for optimal visibility.

Pro SDK 2.0:

  • API enhancements –  New classes and methods for working with Content, Editing, Geodatabase, Geometry, Mapping and Raster.
  • Visual Studio 2017 Support – the ability to build your add-ins and configurations in the latest version of Visual Studio.
  • Additional styling capabilities – New styling at 2.0 with updates for brushes and colors.

A custom start page from the sample solution configuration, ConfigWithStartWizard:

Solution Configurations offer developers a powerful new way to bring a new Pro user experience to their organizations.  Also, developers were able to take advantage of many new capabilities available in the API enhancements, such as the new Raster namespace, as well as many new community samples with ready-to-run solutions.

Also in 2017, new training resources became available with the early 2017 release of the instructor-led course, Extending ArcGIS Pro with Add-Ins, and the Pro SDK DevLabs were also made available.  Many developers were able to attend Dev Summit and UC and take advantage of the many Pro SDK sessions and get updates from the SDK team and other ArcGIS Pro teams.  We also saw excellent participation in the GeoNet Pro SDK Group, as more developers are finding their way to the group to collaborate, find resources and get their questions answered.

2017 also saw new Pro add-ins deployed in production workflows at several user organizations, and also new commercial add-ins from Esri Business Partners making their way onto the market.  2017 also brought new opportunities to distribute add-ins via the ArcGIS Marketplace.

Looking Ahead into 2018

Here in January, the ArcGIS Pro 2.1 EAC is wrapping up, with preparations underway for the final release.  There will be plenty of new SDK functionality made available in 2018 with Pro 2.1 and Pro 2.2.

Pro SDK 2.1 highlights:

  • Annotation – Create and edit annotation features
  • Layout – Create new layouts and layout elements, and manage layout views and selections
  • Metadata – Manage project item metadata
  • Portal – Query portal and online for groups, folders, and content
  • Utility Network – Create custom utility network tools, traces and workflows

Looking ahead to Pro 2.2 later this year, the teams are planning new SDK functionality for Metadata, Portal, Topology, and adding more UI controls.

The Layout Map Series add-in sample, coming at Pro 2.1:

In 2018, we’re very focused on helping more developers and organizations make their way forward in migrating ArcMap customizations to ArcGIS Pro.  The upcoming functionality in Pro 2.1 makes it a great release to begin working with the Pro SDK. As always, we want your feedback on what your needs are.

Learning Opportunities

The following are some great Pro SDK learning opportunities available early this year:

At Dev Summit, there will be many Pro SDK learning opportunities:

  • Pre-Summit Hands-On Training 

Introduction to Programming with the ArcGIS Pro SDK for .NET

Just prior to the Dev Summit, this workshop is a great way to leverage your Dev Summit trip and get two full days of in-person, hands-on training with the Esri Training Services team.

  • Technical sessions and demo theaters 

Search the Dev Summit agenda with keywords “Pro SDK” to quickly find the many sessions available throughout the week.

  • Getting Started with the Pro SDK Workshop 

There will be a new 5-hour introductory hands-on workshop available this year during Dev Summit.  Bring your own machine, pre-installed with ArcGIS Pro and Microsoft Visual Studio 2015 or 2017, and get started with the Pro SDK.  The workshop will have lectures and exercises which introduce SDK concepts, helpful tips and practical steps to help you get started developing add-ins to extend ArcGIS Pro.  As it’s offered during the Dev Summit week, no pre-registration is required.

We’ll have more information and updates on all these offerings as we get closer to Dev Summit.

Your Feedback

Again and as always, we encourage and invite your feedback on the Pro SDK.  We’re always keen to hear what you want to see added to make your Pro customization experience better.  Let us know, find out more and collaborate with others here in the GeoNet Pro SDK Group.

Thank you for sharing your Pro development accomplishments with us in 2017.  We look forward to seeing more of your great work and what you develop with ArcGIS Pro and the Pro SDK in 2018.

more
0 0 577
by Anonymous User
Not applicable

Original Author: @ChristopherZent 

 

The next ArcGIS Pro SDK release will soon arrive with ArcGIS Pro 2.1 This release will include significant additions to the API areas of Annotation, Layout and Utility Network.  Below are some of the new capabilities you’ll find in the new 2.1 SDK.

Annotation API:

  • Create and edit annotation features
  • Assign and manage annotation geometries

Layout API:

  • Create new layouts from scratch with dynamic settings
  • Author layout element types
  • Interact with layout views and manage element selections

Utility Network API:

  • Create custom utility network traces
  • Develop tools for utility-focused workflows
 
An example of dynamically creating layouts with the Layout API:
 

An example of running a custom network trace with the Utility Network API:

As with each release, there will be new ProConcept and ProGuide documentation and code samples to help you get up and running with the new SDK features.

Stay tuned for the Pro 2.1 release announcement in January, when we’ll provide additional information on the updates with links to the new content.  In the meantime, keep the ArcGIS Pro SDK page handy.

We always invite your feedback here in the ArcGIS Pro SDK Group on GeoNet.

For a look at what’s coming with Pro 2.1 in general, see this earlier What’s Coming post.

Happy Holidays!

 

more
0 0 429
by Anonymous User
Not applicable

Original Author: @ChristopherZent 

 

The ArcGIS Pro 2.1 Beta is now available, and with it are new SDK updates.

At Pro 2.1, there are some significant enhancements to the Pro SDK, most notably new API namespaces for Annotation, Layout and the Utility Network.  We’ll be discussing these areas in new posts over the coming weeks.

To try out the new Annotation and Layout functionality in the Pro Beta, you can sign up for the Early Adopter Community at the link above.  The utility network functionality will be available with the Pro 2.1 and ArcGIS 10.6 Final releases which are planned for January.

New Learning Resources Available

A helpful new Pro SDK blog post by Uma Harano, from the ArcGIS Desktop SDK Team, is now available on GeoNet – Create custom Project and Application settings using the ArcGIS Pro SDK.   The post walks through how these settings can be used and included with your add-in, and introduces a new Custom Settings ProGuide document.

Also, a new Live Training Seminar (LTS) is now available for Desktop Developers and GIS Managers:  Building ArcGIS Pro Add-Ins and Solution Configurations.   Rob Burke, an instructor with Esri Training Services, is back for another interesting seminar on the Pro SDK, and this time he dives into the topic of Solution Configurations.  Rob’s LTS is another helpful resource for new Pro SDK developers.

more
0 3 750
UmaHarano
Esri Regular Contributor

This blog will discuss defining custom Project and Application level settings using the Pro SDK. Project and Application settings can be accessed off the ArcGIS Pro Options property page dialog.


Custom project settings

Custom project settings are saved in the project and can be accessed each time the project is reopened. This is accomplished by the Module class’ overrides OnReadSettingsAsync and OnWriteSettingsAsync methods. A Property Sheet should be added to the Options dialog in ArcGIS Pro to provide a UI for users to view and modify these settings.
Add an ArcGIS Pro Property sheet item using the Pro SDK to your add-in project. Add any UI elements you need such as check boxes, radio buttons etc that define specific project settings.

Custom project settings

Insert your custom property sheet into the Options dialog by adding it to the property sheet collection of the "esri_core_optionsPropertySheet" (as shown below) in your Config.daml. Set the "group" attribute on your "insertPage" DAML element to "Project". 

</modules>
 <propertySheets>
 <updateSheet refID="esri_core_optionsPropertySheet">
 <!--Use group=Project for the options to appear under the Project section in the settings-->
 <!--assign the viewModel class to the className attribute; assign the view class to the 
 className attribute in the content tag-->
 <insertPage id="esri_sdk_PropertyPageProjectSettings" caption="Sample Project Settings" 
 className="ProjectSettingsViewModel" group="Project">
 <content className="ProjectSettingsView" />
 </insertPage>
</updateSheet>
 </propertySheets>
</ArcGIS>‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍


The ViewModel of your property sheet should be updated whenever the module OnReadSettingsAsync override gets called. Conversely, the property sheet ViewModel should be queried for its current settings whenever the module OnWriteSettingsAsync override gets called (which is on every project save). The settings themselves are persisted as strings in the project and so must be seriailizable.


Custom application settings

ArcGIS Pro Application level custom settings can be added to the existing Pro application settings via a .NET application settings file. Settings are modified via a Properties.Settings class that you define with your own custom properties and values. Settings are persisted to a user.config file in the logged-on user’s AppData folder and will be read at add-in initialization when the Settings class instance (in your add-in) is instantiated. Settings are saved when you explicitly call “save” on your Settings class instance (e.g. in response to a user changing settings on your custom application property sheet).

Custom application settings


To expose custom application settings in the UI, add another property sheet to the "esri_core_optionsPropertySheet" collection (as before for Project settings). This time set its "group" attribute to “Application”.

</modules>
 <propertySheets>
 <updateSheet refID="esri_core_optionsPropertySheet"> 
 <!--Use group=Application for the options to appear under the Application section in the settings-->
 <!--assign the viewModel class to the className attribute; assign the view class to the className attribute in the content tag-->
 <insertPage id="esri_sdk_PropertyPageAppSettings" caption="Sample App Settings" className="ApplicationSettingsViewModel" group="Application">
 <content className="ApplicationSettingsView" />
 </insertPage>
 </updateSheet>
 </propertySheets>
</ArcGIS>

To read step by step instructions on how to develop an add-in that creates custom project and application settings in ArcGIS Pro refer to the new ProGuide: Custom settings in the arcgis-pro-sdk-wiki.

more
1 5 4,152
by Anonymous User
Not applicable

Original Author: @ChristopherZent 

 

The ArcGIS for Developers site is a great location for developers to access the many resources available for building on the ArcGIS platform.  The ArcGIS DevLabs area of the site contains clear, easy-to-follow lab tutorials for data preparation, map design and styling, and application development.  The “Develop” section provides labs for developing with many of the ArcGIS APIs and SDKs.

The latest addition to the Develop section includes four new ArcGIS Pro SDK DevLabs.  The labs provide helpful walk-throughs for building your first Pro SDK add-in and solution configuration, and creating tools for map identification and feature construction.  The labs are a great way for developers new to the ArcGIS Pro SDK to quickly begin working with it and customizing ArcGIS Pro.

Following the initial four DevLabs, new developers can also find many “ProGuide” tutorials on the Pro SDK documentation site with additional walk-through’s on advanced topics.

Finally, if you’re looking for instructor-led training to jumpstart your development efforts, the Extending ArcGIS Pro with Add-Ins course provides a comprehensive introduction to the Pro SDK.

more
1 0 424
136 Subscribers