updateWirelessForm

Web Services

updateWirelessForm

Update Wireless Form.

Wireless Forms are electronic forms that can be assigned to devices. Employees can then fill out these forms and send the information back to the website. These forms enable dispatchers to provide and gather more information from the field. The forms that can be selected and attached to employee phones are considered "Active." You can create, edit, delete, or deactivate wireless forms. Forms must be set up before you create a timecard or job that uses form data.

Here are some of the kinds of forms you could include:

Example: Mileage and Fuel
Purpose: To know each vehicle's odometer mileage and fuel level at the start of every working day.
Method: Create a "Mileage and Fuel" form with "Mileage" as numbers-only field and "Fuel" as a list of choices:
Full, 3/4, 1/2, 1/4, Empty.

Example: Break Details
Purpose: To know why a mobile worker is taking a break.
Method: Create a "Break Reason" form with "Break Reason" as a list of choices: Meal, Rest, Appointment, Other, etc... Then attach this form to the Break Start event.

Example: Customer Feedback Survey
Purpose: To gather feedback from customers regarding a service.
Method: Create a "Customer Feedback" form with "free text" as the type so that customer comments could be recorded.

updateWirelessFormRequest

Request to update Wireless Form.

Object Fields

Name	Type	Required	Description
wsAdmin	TdxAdmin	Yes	Admin Credentials
form	TdxForm	Yes	Form to update

XML Example:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
 <soapenv:Body>
  <ns1:updateWirelessForm soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" xmlns:ns1="urn:tns">
   <wsAdmin href="#id0"/>
   <form href="#id1"/>
  </ns1:updateWirelessForm>
  <multiRef id="id1" soapenc:root="0" soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" xsi:type="ns2:TdxForm" xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/" xmlns:ns2="http://www.telenavtrack.net/schema">
   <adminId xsi:type="xsd:long" xsi:nil="true"/>
   <companyId xsi:type="xsd:long" xsi:nil="true"/>
   <formId href="#id2"/>
   <strFormName xsi:type="xsd:string">form_gxqin_test</strFormName>
   <strFormDescription xsi:type="xsd:string">formDesc</strFormDescription>
   <fields soapenc:arrayType="ns2:TdxField[1]" xsi:type="soapenc:Array">
    <fields href="#id3"/>
   </fields>
   <reportId xsi:type="xsd:long" xsi:nil="true"/>
   <createTime xsi:type="xsd:long" xsi:nil="true"/>
   <isActivity xsi:type="xsd:boolean" xsi:nil="true"/>
  </multiRef>
  <multiRef id="id0" soapenc:root="0" soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" xsi:type="ns3:TdxAdmin" xmlns:ns3="http://www.telenavtrack.net/schema" xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/">
   <email xsi:type="xsd:string">1251427860282@telenav.com</email>
   <password xsi:type="xsd:string">password</password>
  </multiRef>
  <multiRef id="id3" soapenc:root="0" soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" xsi:type="ns4:TdxField" xmlns:ns4="http://www.telenavtrack.net/schema" xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/">
   <fieldId xsi:type="xsd:long" xsi:nil="true"/>
   <fieldName xsi:type="xsd:string">fieldName</fieldName>
   <fieldTypeId href="#id4"/>
   <fieldTypeName xsi:type="xsd:string" xsi:nil="true"/>
   <choices soapenc:arrayType="xsd:string[3]" xsi:type="soapenc:Array">
    <choices xsi:type="xsd:string">Choice_0</choices>
    <choices xsi:type="xsd:string">Choice_1</choices>
    <choices xsi:type="xsd:string">Choice_2</choices>
   </choices>
   <allowEmpty href="#id5"/>
   <maxChar href="#id6"/>
   <fieldOrder xsi:type="xsd:int" xsi:nil="true"/>
   <defaultValue xsi:type="xsd:string">2</defaultValue>
   <fieldDesc xsi:type="xsd:string">fieldDesc</fieldDesc>
   <searchableId xsi:type="xsd:long" xsi:nil="true"/>
   <addressInfoId xsi:type="xsd:long" xsi:nil="true"/>
   <status xsi:type="xsd:int" xsi:nil="true"/>
   <treeId xsi:type="xsd:long" xsi:nil="true"/>
  </multiRef>
  <multiRef id="id2" soapenc:root="0" soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" xsi:type="xsd:long" xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/">19609</multiRef>
  <multiRef id="id5" soapenc:root="0" soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" xsi:type="xsd:boolean" xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/">true</multiRef>
  <multiRef id="id4" soapenc:root="0" soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" xsi:type="xsd:int" xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/">4</multiRef>
  <multiRef id="id6" soapenc:root="0" soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" xsi:type="xsd:int" xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/">99999</multiRef>
 </soapenv:Body>
</soapenv:Envelope>

updateWirelessFormResponse

Response is true if Wireless Form has been updated successfully.

Object Fields

Name	Type	Required	Description
addWirelessFormReturn	boolean	Yes	Do not get confused by the word "add" in the name. This is the result of a Wireless Form update. Boolean value is "true" if the Wireless Form has been updated successfully.

XML Example:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
 <soapenv:Body>
  <ns1:updateWirelessFormResponse soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" xmlns:ns1="urn:tns">
   <addWirelessFormReturn xsi:type="xsd:boolean">true</addWirelessFormReturn>
  </ns1:updateWirelessFormResponse>
 </soapenv:Body>
</soapenv:Envelope>