You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
[Data Collection for .NET](https://developers.arcgis.com/example-apps/data-collection-dotnet/) shows how a robust application can be built around the ArcGIS Platform using the ArcGIS Runtime SDK for .NET and WPF. It demonstrates best practices around some simple but key functionality of the ArcGIS Runtime. Using your organization's web maps, you can use Data Collection as is, or extend it to meet your specific needs.
3
+
Data Collection for .NET shows how a robust application can be built with the ArcGIS Platform using the ArcGIS Runtime SDK for .NET, WPF, and UWP. It demonstrates best practices around some simple but key functionality of the ArcGIS Runtime. Using your organization's web maps, you can use Data Collection as-is, or extend it to meet your specific needs.
4
+
5
+

4
6
5
7
## Features
6
-
* Taking your web map and data offline
7
-
* Editing your data both offline and online
8
-
* Synchronizing offline edits
9
-
* Viewing and editing your data with Popups
10
-
* Working with Features, Popups, and PopupManagers
11
-
* Editing and querying Feature Tables
12
-
* Working with related records
13
-
* Identifying map features
14
-
* Portal authentication with OAuth
15
-
* Using the World Geocoder service
16
-
* Using Popup configuration to drive app behavior
17
-
18
-
## Best Practices
8
+
9
+
* Take your web map and data offline
10
+
* Edit your data both offline and online
11
+
* Synchronize offline edits
12
+
* View and edit your data with Popups
13
+
* Work with Features, Popups, Attachments, and PopupManager
14
+
* Edit and query Feature Tables
15
+
* Work with related records
16
+
* Identify map features
17
+
* Authenticate with Portal using OAuth
18
+
* Use the World Geocoder service
19
+
* Use Popup configuration to drive app behavior
20
+
21
+
## Best practices
22
+
19
23
The project also demonstrates some patterns for building real-world apps around the ArcGIS Runtime SDK.
20
24
21
25
* Map-centric UI design
22
26
* ArcGIS asynchronous service pattern
23
-
* Cross-platform ready application design
27
+
* Cross-platform application design
24
28
* Model-View-ViewModel pattern
25
29
26
-
## Get Started
27
-
You will need [Visual Studio 2017](https://visualstudio.microsoft.com/downloads/) and the [ArcGIS Runtime SDK](https://developers.arcgis.com/downloads/apis-and-sdks?product=net) (v100.5 or later) installed locally.
30
+
## Get started
31
+
32
+
You will need [Visual Studio 2017](https://visualstudio.microsoft.com/downloads/) or later. You can use the [ArcGIS Runtime SDK](https://developers.arcgis.com/downloads/apis-and-sdks?product=net) extension (v100.7 or later) installed locally or install the Runtime packages from Nuget.org.
28
33
29
34
### Fork the repo
30
-
**Fork** the [Data Collection](https://github.com/Esri/data-collection-dotnet/fork) repo
35
+
36
+
**Fork** the [Data Collection](https://github.com/Esri/data-collection-dotnet/fork) repo.
31
37
32
38
### Clone the repo
39
+
33
40
Once you have forked the repo, you can make a clone and open `DataCollection.sln` in Visual Studio.
34
41
35
42
#### Command line Git
43
+
36
44
1.[Clone Data Collection](https://help.github.com/articles/fork-a-repo/#step-2-create-a-local-clone-of-your-fork)
37
45
2.`cd` into into the cloned repository's directory
38
46
3. Make your changes and create a [pull request](https://help.github.com/articles/creating-a-pull-request)
39
47
40
48
### Configuring a Remote for a Fork
49
+
41
50
If you make changes in the fork and would like to [sync](https://help.github.com/articles/syncing-a-fork/) those changes with the upstream repository, you must first [configure the remote](https://help.github.com/articles/configuring-a-remote-for-a-fork/). This will be required when you have created local branches and would like to make a [pull request](https://help.github.com/articles/creating-a-pull-request) to your upstream branch.
42
51
43
52
1. In the Terminal (for Mac users) or command prompt (for Windows and Linux users) type `git remote -v` to list the current configured remote repo for your fork.
@@ -52,21 +61,21 @@ If there are changes made in the original repository, you can sync the fork to k
52
61
53
62
### Configure the app
54
63
55
-
The app can be run asis, but it's recommended you do some configuration to set up OAuth to be relevant to your users. At minimum, the app should not be deployed without these changes:
64
+
The app can be run as-is, but it's recommended you do some configuration to set up OAuth to be relevant to your users. At minimum, the app should not be deployed without these changes:
56
65
57
66
1. Register an ArcGIS Portal Application.
58
67
2. Configure Data Collection project to reference that application.
59
68
3. License the app to remove the Developer Mode watermark and for deployment.
60
69
61
-
#### 1. Register an Application
70
+
#### 1. Register an application
62
71
63
72
For OAuth configuration, create a new Application in your ArcGIS Portal to obtain a `Client ID` and configure a `Redirect URL`. The **Client ID** configures the ArcGIS Runtime to show your users, during the login process, that the application was built by you and can be trusted. The **Redirect URL** configures the OAuth process to then return to your app once authentication is complete.
64
73
65
74
1. Log in to [https://developers.arcgis.com](https://developers.arcgis.com) with either your ArcGIS Organizational Account or an ArcGIS Developer Account.
66
75
2. Register a new Application. 
67
76
3. In the Authentication tab, note the **Client ID** and add a **Redirect URL**, e.g. `data-collection://auth`. We will use this URL in the **Configuring the project** section below. 
68
77
69
-
#### 2. Configuring the project
78
+
#### 2. Configure the project
70
79
71
80
1. Open the solution in Visual Studio and browse to the file named `Configuration.xml` located in the `Properties` directory of the `DataCollection.Shared` project.
72
81
2._(Optionally)_ configure the `WebmapURL` to match your organization's webmap.
@@ -75,24 +84,28 @@ For OAuth configuration, create a new Application in your ArcGIS Portal to obtai
75
84
4. Configure the Client ID.
76
85
* Set the `ClientID` property with the **Client ID** generated when you registered your application (see section above).
77
86
78
-
## Learn More
79
-
Learn more about Esri Example Apps [here](https://developers.arcgis.com/example-apps).
87
+
## Learn more
88
+
89
+
Learn more about Esri Open Source Apps [here](https://developers.arcgis.com/example-apps).
80
90
81
91
## Requirements
82
-
*[Visual Studio 2017](https://visualstudio.microsoft.com/downloads/)
92
+
93
+
*[Visual Studio 2017](https://visualstudio.microsoft.com/downloads/) or later
83
94
*[ArcGIS Runtime SDK for .NET](https://developers.arcgis.com/downloads/apis-and-sdks?product=net)
84
95
* To edit records or take a web map offline you will need an ArcGIS Online Organizational account, an ArcGIS Online Developer account or an ArcGIS Online account authenticated using a social login.
85
96
* To consume your own web map you will need an ArcGIS Online Organizational account.
86
97
87
-
## Contributing
98
+
## Contribute
99
+
88
100
Anyone and everyone is welcome to [contribute](CONTRIBUTING.md). We do accept pull requests.
89
101
90
102
1. Get involved
91
103
2. Report issues
92
104
3. Contribute code
93
105
4. Improve documentation
94
106
95
-
## Licensing
107
+
## License
108
+
96
109
Copyright 2019 Esri
97
110
98
111
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
@@ -105,7 +118,9 @@ A copy of the license is available in the repository's [LICENSE](LICENSE) file.
105
118
106
119
For information about licensing your deployed app, see [License your app](https://developers.arcgis.com/net/latest/wpf/guide/license-your-app.htm).
107
120
108
-
### 3rd Party Component Licensing
109
-
Some great open source components are available out there for .NET developers. The following have been used in this project, with much gratitude to their authors.
121
+
### 3rd-party component licensing
122
+
123
+
This project uses the following 3rd-party components:
110
124
111
-
*[Extended WPF Toolkit by XCeed](https://github.com/xceedsoftware/wpftoolkit) is licensed under the [Microsoft Public License] (https://github.com/xceedsoftware/wpftoolkit/blob/master/license.md)
125
+
*[Extended WPF Toolkit by XCeed](https://github.com/xceedsoftware/wpftoolkit) is licensed under the [Microsoft Public License](https://github.com/xceedsoftware/wpftoolkit/blob/master/license.md)
0 commit comments