Task

A Task could prepresent any form of work required in the council’s region, e.g.:

  • a scheduled bin collection
  • cleanup of a fly tip
  • maintenance of a street

Use cases and requirements

The Task model should have properties for:

name

What the Task is.

description

More details about the Task.

status

Whether the Task is pending, started, completed, etc.

location

A link to a property or street location.

start date

When the task was started.

end date

When the task ended.

scheduled start date

When the task was planned to start.

features

What features this task is acting on. Optional depending on whether system connects them.

Types

This Task type extends from the Action schema.org type.

Sub-types

Just as Action and other common types have a number of sub-types, here are specific Task sub-types for different kinds of services councils provide:

  • EmptyBinTask
  • StreetCleansingTask
  • FlytippingCleanupTask

Properties

Term Mapping Definition
name schema:name Identifer for the Task.
description schema:description A short description of the Task.
status schema:actionStatus The status of the Task.
location schema:location Location information.
start date schema:startDate Planned start date.
end date schema:date End date.
actual start date schema:date Actual start date.
features Feature List of related features.

Serialisation

  {
  "@id": "http://example.com/tasks/123",
  "@type": "EmptyBinTask",
  "name": "Empty Black 240L",
  "description": "Empty Black 240L",
  "start_date": "2015-09-27T21:04:00.743",
  "status": "not_started",
  "features": [
      {
        "@type": "WasteContainer",
        "id": "2140541",
        "status": "In use",
        "size": 240,
        "type": "http://example.com/feature-types/1"
      }
    ],
  "location": "http://example.com/sites/1"
}

  
  <?xml version="1.0" encoding="UTF-8"?>
<task>
  <href>http://example.com/tasks/123</href>
  <type>EmptyBinTask</type>
  <name>Empty Black 240L</name>
  <description>Empty Black 240L</description>
  <start-date>2015-09-27T21:04:00.743</start-date>
  <status>not_started</status>
  <features type="array">
    <feature>
      <type>http://example.com/feature-types/1</type>
      <id>2140541</id>
      <status>In use</status>
      <size type="integer">240</size>
    </feature>
  </features>
  <location>http://example.com/sites/1</location>
</task>

  

Codelists

Task statuses

  • Not started
  • In progress
  • On break
  • Closed / Complete
  • Closed / Not done
  • Closed / Not required
  • Closed / Part done
  • Blocked
  • Abandoned