...
Name | Summary of use |
---|---|
Document | This is the most general library schema, and most commonly used for general documentation and information sharing. |
Geospatial Feature | A flexible information storage record with geospatial (map-based) information, which allows storage of data such as affected area extents, location of key facilities, etc. |
Meeting | An agenda and minutes of a meeting, including audio recording and attachments such as photos of whiteboards. |
Note |
---|
Enterprise customers: you you may have additional schemas as part of your custom deployment. Consult your enterprise solution guide for details. |
...
To view documentation in the library, use the datagrid.
The datagrid combines all documentation from the current event with documents from all accessible global events, to give you a single place to view all documentation.
...
- From any screen, click the New Library Document button. If you wish to change the schema from the default Document type, select this now — available alternatives include Geospatial Feature and Meeting
- Enter the Title and Body of the document as needed.
- Upload any Attachments by dragging and dropping files from your computer into the attachment box, or by clicking Add File.
- Optionally add some Tags to identify the document, and set Is Featured to add the document to the Featured counter.
- Select the Event to save the document. By default this will be the currently-selected event at the top right of the screen, however, you may wish to save the document into a global event instead, if the document is to be permanently accessible.
- Click save to save the document.
...
- Browse to Library to view the library Datagrid.
- Use the counters or search system to view the available documents
- Click the link in the datagrid to view the document
- Click Edit (if available based on your security) to edit the record
...
Adding geospatial features
IF If adding a Geospatial Feature, then a map will additionally appear on the edit form. You can add map annotations by following the instructions on the Working with Maps and Assets page.
...
It is not possible to directly delete a document, however you may move the document to an archive event to completely remove it from view.
...
Geospatial Features
By using the Geospatial Feature schema, you can add map-based reference items.
These items will appear on any map within the system, can be searched and linked from the request registers (as well as all other registers that support asset linking), and support a revalidation workflow to ensure the contents remain current.
Geospatial Category
Geospatial categories can be defined by system administrators to support any number of categories. Examples may be "Road Block", "Vulnerable Facility", "Initial Impact Assessment", etc.
To manage the list of geospatial categories, administrators can:
- Navigate to Administration > Settings from the top menu
- Next, navigate to Lookups
- To view the list of geospatial lookups, click the search icon and filter for "Item: Geospatial Category"
- To add a new item, click New Lookup, select the category of "Item: Geospatial Category", then enter the name in the "name" field and a code in the "value" field and press Save.
Note |
---|
When adding or changing categories, your users may need to refresh their form definitions (from the user profile menu within Crisisworks) to see the new settings. |
Adding Geospatial Features
When adding geospatial features into the library:
- First select Geospatial Feature from the Reference Type option
- Enter the title of the feature
- Select the Geospatial Category (this list can be managed via the "lookup" system within Crisisworks)
- Optionally select a Display Icon (tip: search for a keyword within the select box to filter the list).
- Draw the map annotation by using the controls at the top right corner of the map — you can place points, draw a line string or draw a polygon.
- You can also search Related Asset and points of interest, to link the geospatial feature to existing features. This is useful if you are adding a feature that exists at a property address, for example. If the linked asset is also mapped, that map information will be transferred onto this geospatial feature record when it is saved.
- Add information as desired into the Body field, and tag the record as desired using the Tags field
The record can be assigned to a position for ongoing record maintenance, a review date can be set, and the item can be stored in either a current event or a global event.
Geospatial imports
You can now import the geospatial data into a reference item, and this can then be made available as a linked asset (for relating records such as requests or cases to custom areas), a search index (to manage records within or not within the area), and a layer (for overlaying over maps).
For more accurate geospatial data you can import a file or paste the geospatial data into the record choosing one of the two option at the bottom of the form
The system reads many common geospatial format including WKT, GeoJSON, KML, GPX and GeoRSS.
Working Example: how to add a postcode as a geospatial area.
We will step through adding a postcode getting the data from: http://mapit.openlocal.org.au
Once this has been added we will be able to search within this area using the advanced search feature option "within:" and we will also be able to view it on the map as a map layer.
...
- Go to the library
- Set the "Reference Type" to be "Geospatial Feature" (top RHS)
- Set a useful Title such as "Preston area 3072", and maybe add some tags like postcode,
- Choose a Geospatial Category, you can use one of the defaults such as "Area of Interest" or you could define your own via administration → settings → lookups
- Instead of trying to draw the area using the map annotation features, we will get the exact details from http://mapit.openlocal.org.au
- Scroll to the bottom of the form to the "Geospatial Data loaders" section and select "Clipboard Data Loader"
- Find the geospatial data you are after & paste it into this field (see Step 7 example below on how to get some data)
Up till this point if you save the library record you will have created a normal geospatial record which can be shown on the map under the map layer "Library Item: Area of Interest" and you can also link other records to this library record such as requests or information or infrastructure assessments. The next step will allow us to use this as a search area when doing searches in data grids.
8. Under the search section, select "Include in search"
9. Then add a name to use in the "Search Short Reference" area to be used when you do a search such as "3072" or "pc3072" if you don't have spaces in the search name it will make it easier to work with later, but you can use them if you like
10. Save your record
When searching for records within this area add multiple search parameters, as per the documentation for Searching and filtering
for example: priority:[high,urgent] within:pc3072 will find high priority OR ugent records that are only in the 3072 postcode
if there was a space in the search name you would need to add a quote eg: priority:[high,urgent] within:"pc 3072"
Step 7 example:
For each state try the following link
- VIC http://mapit.openlocal.org.au/areas/LVI.html
- QLD http://mapit.openlocal.org.au/areas/LQL.html
- NSW http://mapit.openlocal.org.au/areas/LNS.html
- SA http://mapit.openlocal.org.au/areas/LSA.html
- WA http://mapit.openlocal.org.au/areas/LWA.html
For this example, I will get the pocode data for 3072 by doing the following
- Select the "Darebin" local government from the Victorian area,
- Then select "Overlapping this area" from the "Areas" section on the page
- Then select "pc3072"
- on the next page select "WKT" under the "Geometry" section
Displaying Geospatial Features on maps within Crisisworks
Once a geospatial category has its first feature, a new layer becomes available to all maps to show all the features for that category.
To show a geospatial feature category on a map:
- Click the layer selector icon to the left of any map
- Place a check into the checkbox next to the layer you wish to display
Searching Geospatial Features from other register items
From within requests, information and any other register that supports searching and linking assets, you can search any of the active geospatial reference features in the current event, as well as any global event to which you are authorised.
To find and link a geospatial feature from another item:
- From the asset field, select the Library Item type
- Next, search by name for the item you wish to link, and select it in the result
- The geospatial feature will display on the map
- You can additionally annotate the map with further information for the item being edited.
...
Workflow
The following workflow applies to library document.
...
Status | Usage | ||||||||
---|---|---|---|---|---|---|---|---|---|
| The document contains current information. | ||||||||
| The document has expired and is no longer current. | ||||||||
| The document should be reviewed for currency. This status is transitioned automatically whenever a review date is set and becomes due. | ||||||||
| The library item is marked as deleted and is no longer current. Note there is no way to physically delete items in Crisisworks, however you can move the item to an archive event to remove it completely from view. |
Assignment
Wiki documents can be assigned to positions or users. This assignee is responsible for maintaining accuracy of the information, and will receive notifications whenever items under their control become ready for review.
Review
Users can check the Set a Review Date checkbox, then enter a review date. When that date is reached, the record will automatically be set to the
Status | ||||
---|---|---|---|---|
|
Featured
Users can check the Featured checkbox to include the document in the "Featured" counter.
...
Technical Reference
Document schema
Field ID | Label | Form Type | Data Type | Values | Notes |
---|---|---|---|---|---|
title | Title | text | string(255) | Required | |
body | Body | rte | clob | ||
attachments | Attachments | media | |||
isFeatured | Is Featured | checkbox | boolean | ||
assignee | Position Assigned | assignment | Single assignment to Arrays | ||
setReviewDate | Set a review date | checkbox | boolean | ||
reviewDate | Review at | stateTransitionDatePicker | timestamp | Only available if ‘setReviewDate:true’ | |
activity | auditLog |
...
Geo feature schema
Field ID | Label | Form Type | Data Type | Values | Notes |
---|---|---|---|---|---|
title | Title | text | string(255) | Required | |
geoCategory | Geospatial Category | select | string(255) | Required; the geospatial category of this record | |
icon | Display Icon | select | string(255) | If specified, this will override the default map icon for this record | |
body | Body | rte | clob | ||
attachments | Attachments | media | |||
isFeatured | Is Featured | checkbox | boolean | ||
assignee | Position Assigned | assignment | Single assignment to Arrays | ||
setReviewDate | Set a review date | checkbox | boolean | ||
reviewDate | Review at | stateTransitionDatePicker | timestamp | Only available if ‘setReviewDate:true’; enter a review date | |
syncedAssetItemData | hidden | string(255) | |||
syncedAssetItems | Linked Items | info | Read only | ||
activity | auditLog |
Meeting schema
Field ID | Label | Form Type | Data Type | Values | Notes |
---|---|---|---|---|---|
title | Topic | text | string(255) | Required | |
meetingStartDate | Meeting Start Date and Time | dateTimePicker | timestamp | Required | |
agenda | Agenda | rte | clob | ||
attachments | Business Papers | media | |||
present | Present | textarea | clob | ||
absent | Absent | textarea | clob | ||
previousMinutesReview | Review of Previous Minutes | rte | clob | Review the previous minutes and note down any inaccuracies | |
notes | Meeting Notes | rte | clob | Add discussion topics and notes here | |
resolutions | Resolutions and Action Items | rte | clob | ||
nextMeeting | Date and time of next meeting | dateTimePicker | timestamp | ||
meetingClosedTime | Meeting closed time | dateTimePicker | timestamp | ||
isFeatured | Is Featured | checkbox | boolean | ||
assignee | Position Assigned | assignment | Single assignment to Arrays | ||
setReviewDate | Set a review date | checkbox | boolean | ||
reviewDate | Review at | stateTransitionDatePicker | timestamp | Only available if ‘setReviewDate:true’; enter a review date | |
activity | auditLog |
Non-schema fields
Field ID | Label | Form Type | Data Type | Values | Notes |
---|---|---|---|---|---|
hasAsset | Related Asset | asset | Only available if ‘itemSchemaName:geofeature’; select the location for the feature, and/or click a location on the map | ||
hasEvent |
event | |||||
hasMap | Geospatial Information | geo | Only available if ‘itemSchemaName:geofeature’; uses MDA94 projection | ||
hasSchemaSelection | Reference |
Type | schemaselection | ||||
hasStatus | Status | status | |||
hasTags | tags |
Workflow
Workflow ID | Label | Value | Next States | Initial State |
---|---|---|---|---|
NEW | New | 0 | CURRENT, DRAFT | |
DRAFT | Draft | 1 | DRAFT, CURRENT, EXPIRED, DELETED | |
CURRENT | Current | 2 | CURRENT, REVIEW, EXPIRED, DELETED | ✓ |
REVIEW | Review | 3 | REVIEW, CURRENT, EXPIRED, DELETED | |
EXPIRED | Expired | –2 | EXPIRED, CURRENT, DRAFT, DELETED | |
DELETED | Deleted | –3 | DELETED | |
REOPEN | Reopen | 4 | CURRENT |