Web Services

 
addWirelessForm
Create 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.
addWirelessFormRequest
Request to create Wireless Form.
Object Fields
NameTypeRequiredDescription
wsAdminTdxAdminYesAdmin Credentials
formTdxFormYesForm to be added



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:addWirelessForm soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" xmlns:ns1="urn:tns">
   <wsAdmin href="#id0"/>
   <form href="#id1"/>
  </ns1:addWirelessForm>
  <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 xsi:type="xsd:long" xsi:nil="true"/>
   <strFormName xsi:type="xsd:string">newform1</strFormName>
   <strFormDescription xsi:type="xsd:string">unit test</strFormDescription>
   <fields soapenc:arrayType="ns2:TdxField[1]" xsi:type="soapenc:Array">
    <fields href="#id2"/>
   </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">1251427667406@telenav.com</email>
   <password xsi:type="xsd:string">password</password>
  </multiRef>
  <multiRef id="id2" 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">test1</fieldName>
   <fieldTypeId href="#id3"/>
   <fieldTypeName xsi:type="xsd:string" xsi:nil="true"/>
   <choices xsi:type="xsd:string" xsi:nil="true"/>
   <allowEmpty href="#id4"/>
   <maxChar xsi:type="xsd:int" xsi:nil="true"/>
   <fieldOrder xsi:type="xsd:int" xsi:nil="true"/>
   <defaultValue xsi:type="xsd:string">10</defaultValue>
   <fieldDesc xsi:type="xsd:string">a lot of money</fieldDesc>
   <searchableId xsi:type="xsd:long" xsi:nil="true"/>
   <addressInfoId href="#id5"/>
   <status xsi:type="xsd:int" xsi:nil="true"/>
   <treeId xsi:type="xsd:long" xsi:nil="true"/>
  </multiRef>
  <multiRef id="id5" soapenc:root="0" soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" xsi:type="xsd:long" xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/">111</multiRef>
  <multiRef id="id4" 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="id3" soapenc:root="0" soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" xsi:type="xsd:int" xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/">9</multiRef>
 </soapenv:Body>
</soapenv:Envelope>



addWirelessFormResponse
Response has Wireless FormId if Wireless Form has been created successfully.
Object Fields
NameTypeRequiredDescription
addWirelessFormReturnlongYesID of created Wireless Form

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:addWirelessFormResponse soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" xmlns:ns1="urn:tns">
   <addWirelessFormReturn xsi:type="xsd:long">19608</addWirelessFormReturn>
  </ns1:addWirelessFormResponse>
 </soapenv:Body>
</soapenv:Envelope>