ember-arcgis-server-services

ember-arcgis-server-services

Ember Services for working with ArcGIS Server Services.

ArcGIS Server Services

After adding this to your project, you will have a number of services available for injection into your routes/controllers/services.

Dependencies

This project is now using ember-network/fetch to enable fastboot compatibility.

Installation

To consume this library in any ember application:

• ember install ember-arcgis-server-services

Shared Methods

All the services expose a set of shared helper methods:

Method	Returns	Description
encodeForm	string	This is used internally. Formats an object into a html form. In most cases, not necessary to call this.
request (url, options)	promise	This is used internally. Promisified xhr that does basic handling of Portal's 400-in-a-200 errors
parseServiceUrl (url)		Parses up the url and returns a hash of useful information - the service url, type, layerId if present, orgId if hosted
getServerInfo(url)	promise	Returns the f=json metadata for the server

Vector Service

All functions supported by the Vector Service are all supported by Feature Service and Map Service

Method	Returns	Description
query(url, options)	promise	Query the feature service
getById(url, id)	promise	Returns the record by Id
getLayerInfo(url)	promise	Returns the f=json for the service
getLayersInfo(url)	promise	Returns the f=json for all layers and tables in the service

Feature Service

All the services expose a set of shared helper methods:

Method	Returns	Description
updateFeature(url, feature, token)	promise	Update a Feature
updateFeatures(url, features, token)	promise	Update a set of Features
addFeature(url, feature, token)	promise	Adds a Feature
addFeatures(url, features, token)	promise	Adds a set of Features
deleteFeature(url, feature, token)	promise	Delete a Feature
deleteFeatures(url, features, token)	promise	Deletes a set of Features
applyEdits(url, adds, updated, deletes, token)	promise	Applies a set of edits to the service

Handling Error Conditions

Barring a catastrophic network or server failure, the ArcGIS Server API will always return a 200, which may contain error information in json.

Running

• ember server
• Visit your app at http://localhost:4200.

Running Tests

• ember test – Runs the test suite on the current Ember version
• ember test --server – Runs the test suite in "watch mode"
• ember try:each – Runs the test suite against multiple Ember versions
• npm run lint:hbs
• npm run lint:js
• npm run lint:js -- --fix

Building

• ember serve
• Visit the dummy application at http://localhost:4200.

For more information on using ember-cli, visit http://ember-cli.com/.

Resources

• ArcGIS Hub
• ArcGIS for Developers
• ArcGIS Blog
• twitter@esri

Issues

Find a bug or want to request a new feature? Please let us know by submitting an issue.

Contributing

Esri welcomes contributions from anyone and everyone. Please see our guidelines for contributing.

License

Copyright © 2017-2019 Esri

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

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

A copy of the license is available in the repository's LICENSE file.

Changelog

[2.0.0]

Fixed

• authenticated sessions are now passed through consistently, with appropriate behavior for both secure federated and public non-federated services

Changed

• ArcGIS REST JS v2.x is now used under the hood
• ember-auto-import is now used to load ArcGIS REST JS