22.0 Edit an Asset

Modify an existing asset object. New values for any asset attributes may be assigned to the asset.
Note:This operation is only supported in version 2.X.

22.1 Request Data

Required Information
Name	Description
action	adminassets
operation	edit
format	xml
target	The asset to modify. If specified a reqtype (request type) must be specified as well.
reqtype	Flag to identify the key being used to identify the asset. Acceptable values: `tag` Key is a Zonar RFID tag number. In version 2.X a type must also be specified. `exsid` Key is the external system id. `vin` Key is the Vehicle Identification Number (VIN). `dbid` Key is the internal database id number. This is the most reliable key to use. `fleet` Key is the asset fleet number. In version 2.X a type must also be specified.
type	When using reqtype of tag or fleet this must also be specified in version 2. See asset types for more details.
fleet	Cust assigned ident Any text, 20 char max. Must be unique.
newtype	Asset type label. The type the asset will have when the edit is completed. Assets must have a type assigned to them.
location	Location name this asset is assigned to. Must be a valid location name.
Optional Information
If any optional information is omitted, the asset will be assigned an empty or default value.
name	License tag number. Any text, 20 character max.
vin	VIN number Any text, 40 char max Must be unique.
exsid	Unique identifier used by the external maint system. Any text, 40 Char max. Must be unique.
inservice	The asset inservice date. Unix epoch timestamp. (UTC)
tagid	Zonar RFID tag number. Integer, the tagid type combination must be unique if supplied.
mfg	Asset manufacturer.
mileoffset	Offset to be applied to mileage readings obtained from RFID equipped hubometers in inspections for this asset.
status	This gives the option to set an asset to active 1 or inactive 2. If no type is set then the default is active.
radioaddress	Address used by wireless data link for hand held download stations.
subtype	Label of the subtype for the new asset.
homeloi	Name of the home LOI* for this asset.

Required Information

Name

Description

action

adminassets

operation

edit

format

xml

target

The asset to modify.
If specified a reqtype (request type) must be specified as well.

reqtype

Flag to identify the key being used to identify the asset. Acceptable values:

tag Key is a Zonar RFID tag number. In version 2.X a type must also be specified.
exsid Key is the external system id.
vin Key is the Vehicle Identification Number (VIN).
dbid Key is the internal database id number. This is the most reliable key to use.
fleet Key is the asset fleet number. In version 2.X a type must also be specified.

type

When using reqtype of tag or fleet this must also be specified in version 2. See asset types for more details.

fleet

Cust assigned ident Any text, 20 char max. Must be unique.

newtype

Asset type label. The type the asset will have when the edit is completed. Assets must have a type assigned to them.

location

Location name this asset is assigned to. Must be a valid location name.

Optional Information

If any optional information is omitted, the asset will be assigned an empty or default value.

name

License tag number. Any text, 20 character max.

vin

VIN number Any text, 40 char max Must be unique.

exsid

Unique identifier used by the external maint system. Any text, 40 Char max. Must be unique.

inservice

The asset inservice date. Unix epoch timestamp. (UTC)

tagid

Zonar RFID tag number. Integer, the tagid type combination must be unique if supplied.

mfg

Asset manufacturer.

mileoffset

Offset to be applied to mileage readings obtained from RFID equipped hubometers in inspections for this asset.

status

This gives the option to set an asset to active 1 or inactive 2. If no type is set then the default is active.

radioaddress

Address used by wireless data link for hand held download stations.

subtype

Label of the subtype for the new asset.

homeloi

Name of the home LOI* for this asset.

22.2 Data Returned

Returned information:
A success or error message.

Example Request:


http://development.zonarsystems.net/interface.php?action=adminassets&operation=edit&format=xml&version=2&name=POE3134&vin=12345678989&fleet=FLT1234&type=Standard&location=Portland&newtype=Standard&exsid=7654

Example Success Reply,
Example Error Reply

*LOI means Location of Interest; called "Zone" in GPS tools and reports in Ground Traffic Control web application.