Skip to main content
Omnitracs Knowledge Base

T.8.01.0

T.8.01.0 - MMS File Disposition Notification

 

Overview

This transaction type is published by Media Manager to indicate the disposition of a prior file delivery request. These notifications are published on a per-vehicle basis whenever files are delivered, consumed, or deleted at the mobile.

In the event that that the mobile had a problem downloading the file, there may be more than one ERROR message that is returned. This is due to the way the mobile units respond to failures.

Schema

The following diagram illustrates the transaction type's XML schema. Some of the Shared Complex Types are referenced within the transaction type.

 

 

Sample XML Transactions - Delete of the content

Indicates that a file has been deleted from a vehicle. Contains the date it was deleted.

<T.8.01.0>
  <eventTS>2011-08-08T23:30:26.0Z</eventTS>
  <equipment unitAddress="105000001" equipType="tractor" />
  <position lat="35.237222" lon="-80.923194" posTS="2011-08-08T23:30:22Z"/>
  <posType>3</posType>
  <ignitionStatus>1</ignitionStatus>
  <tripStatus>O</tripStatus>
  <ltdDistance>0.0</ltdDistance>
  <speed>0</speed>
  <heading>0</heading>
  <mmsMessageInfo>
    <requestId>6514</requestId>
    <reference>Ref12345</reference>
    <mmsFileInfo>
      <fileName>SampleFile.pdf</fileName>
      <fileSize>9999</fileSize>
      <duration>0</duration>
      <category>Default</category>
      <fileType>DOC</fileType>
      <container>PDF</container>
    </mmsFileInfo>
  </mmsMessageInfo>
  <mmsNotificationDetails>
    <mmsNotificationType>DELETED</mmsNotificationType>
     <mmsMessageDeletedOnMobile>
      <mmsDeleteDatetime>2011-08-08T23:30:20Z</mmsDeleteDatetime>
    </mmsMessageDeletedOnMobile>
  </mmsNotificationDetails>
</T.8.01.0>

Sample XML Transactions - Successful delivery of the content

Indicates that the vehicle has received the content.  Includes the date it was delivered, how long the download took and how many bytes were downloaded over wifi vs. terrestrial links.

<T.8.01.0>
<eventTS>2011-08-08T23:30:26.0Z</eventTS>
  <equipment unitAddress="105000001" equipType="tractor" />
  <position lat="35.237222" lon="-80.923194" posTS="2011-08-08T23:30:22Z"/>
  <posType>3</posType>
  <ignitionStatus>1</ignitionStatus>
  <tripStatus>O</tripStatus>
  <ltdDistance>0.0</ltdDistance>
  <speed>0</speed>
  <heading>0</heading>
  <mmsMessageInfo>
    <requestId>6514</requestId>
    <reference>Ref12345</reference>
    <mmsFileInfo>
      <fileName>SampleFile.pdf</fileName>
      <fileSize>9999</fileSize>
      <duration>0</duration>
      <category>Default</category>
      <fileType>DOC</fileType>
      <container>PDF</container>
    </mmsFileInfo>
  </mmsMessageInfo>
  <mmsNotificationDetails>
    <mmsNotificationType>DELIVERY</mmsNotificationType>
    <mmsMessageDeliveryInfo>
      <mmsDeliveredDatetime>2011-08-08T23:30:20Z</mmsDeliveredDatetime>
      <status>SUCCESS</status>
      <bytesWifi>8000</bytesWifi>
      <bytesTerrestrial>1999</bytesTerrestrial>
      <seconds>53</seconds>
    </mmsMessageDeliveryInfo>
  </mmsNotificationDetails>
</T.8.01.0>

 

Sample XML Transactions - Viewing of the content

Indicates the date the driver viewed the content, the date it was viewed,  the driver Id and an optional response entered by the driver.


<T.8.01.0>
<eventTS>2011-08-08T23:30:26.0Z</eventTS>
  <equipment unitAddress="105000001" equipType="tractor" />
  <position lat="35.2372222" lon="-80.923194" posTS="2011-08-08T23:30:22Z"/>
  <posType>3</posType>
  <ignitionStatus>1</ignitionStatus>
  <tripStatus>O</tripStatus>
  <ltdDistance>0.0</ltdDistance>
  <speed>0</speed>
  <heading>0</heading>
  <mmsMessageInfo>
    <requestId>6514</requestId>
    <reference>Ref12345</reference>
    <mmsFileInfo>
      <fileName>SampleFile.pdf</fileName>
      <fileSize>9999</fileSize>
      <duration>0</duration>
      <category>Default</category>
      <fileType>DOC</fileType>
      <container>PDF</container>
    </mmsFileInfo>
  </mmsMessageInfo>
  <mmsNotificationDetails>
    <mmsNotificationType>ACCESS</mmsNotificationType>
    <mmsMessageAccessInfo>
      <mmsConsumedDatetime>2011-08-08T23:30:20Z</mmsConsumedDatetime>
      <driverID>JOET</driverID>
      <driverResponse>Thank you for message</driverResponse>
    </mmsMessageAccessInfo>
  </mmsNotificationDetails>
</T.8.01.0>

  • Was this article helpful?