Edit Asset Properties - Revision history

Lsilverman: formatting, fix urls (by SublimeText.Mediawiker)

2023-01-13T20:04:07Z

formatting, fix urls (by SublimeText.Mediawiker)

Jgreco: Initial proofread pass - docs

2021-11-29T20:03:14Z

Initial proofread pass - docs

Starafdar: Created page with "<< Back to Web Services === Overview === This webservice is used for modifying properties of assetrs. {{Service Protocol RESTful}} {{Service Authenticatio..."

2014-02-11T15:34:53Z

Created page with "<< Back to Web Services === Overview === This webservice is used for modifying properties of assetrs. {{Service Protocol RESTful}} {{Service Authenticatio..."

New page

[[Web_Services|<< Back to Web Services]]

=== Overview ===
This webservice is used for modifying properties of assetrs.

{{Service Protocol RESTful}}

{{Service Authentication RESTful}}

{{Service Metadata RESTful}}

{{Service Standard Params RESTful}}

=== Validations and Restrictions ===

The following validations are applicable to the data and parameters provided to this service. If one or more of these validations fail, the web service will return a response status code and error message that indicates the source of the failure.

* The username and password provided must be valid
* The XML submitted must conform to the expected schema as outlined in the service metadata.

=== Processing Rules ===
The web service uses the standard asset resolution process when trying to locate assets for a provided bar code and serial number. These are the same rules that are applied when an asset is scanned via a hand held device or a record is created by entering bar codes and serial numbers manually through the website. The details of the standard asset resolution process are outside the scope of this article, but it's important to note that this approach can lead to three potential outcomes:

* A single asset is found, and that asset is attached to the 'Edit Asset' record that is created by the web service.
* No matching asset is found, and the creation of the 'Edit Asset' record results in a new asset being created using the provided bar code and serial number.
* One or more partially matching assets are found and the 'Edit Asset' record is created with an asset collision. This collision will need to be resolved manually via the website.

=== Request Output ===

When all provided data is processed without any errors, the service returns a HTTP status code of 200. When one or more processing errors are encountered, the HTTP status will be set to an HTTP error code. The body of the response will contain text describing the error that occurred.

=== Usage ===

Production Environment

* '''Web Service URL:''' https://www.trackabout.com/EditAssetProperties.asmx
* '''Service WADL:''' https://www.trackabout.com/ws/EditAssetProperties.asmx?meta

Test Environment

* '''Web Service URL:''' https://test.trackabout.com/EditAssetProperties.asmx
* '''Service WADL:''' https://test.trackabout.com/ws/EditAssetProperties.asmx?meta

@@ Line 34: / Line 34: @@
 Production Environment
-* '''Web Service URL:''' https://www.trackabout.com/EditAssetProperties.asmx
+* '''Web Service URL:''' <nowiki>https://www.trackabout.com/ws/EditAssetProperties.asmx</nowiki>
 * '''Service WADL:''' https://www.trackabout.com/ws/EditAssetProperties.asmx?meta
 Test Environment
-* '''Web Service URL:''' https://test.trackabout.com/EditAssetProperties.asmx
+* '''Web Service URL:''' <nowiki>https://test.trackabout.com/ws/EditAssetProperties.asmx</nowiki>
 * '''Service WADL:''' https://test.trackabout.com/ws/EditAssetProperties.asmx?meta

@@ Line 2: / Line 2: @@
 === Overview ===
-This webservice is used for modifying properties of assetrs.
+This webservice is used for modifying properties of assets.
 {{Service Protocol RESTful}}
@@ Line 16: / Line 16: @@
 The following validations are applicable to the data and parameters provided to this service. If one or more of these validations fail, the web service will return a response status code and error message that indicates the source of the failure.
-* The username and password provided must be valid
+* The username and password provided must be valid.
 * The XML submitted must conform to the expected schema as outlined in the service metadata.