πŸ€– Custom Fields API

What is an API?

It's not a beer! API, not IPA! An API is a set of definitions and protocols for building and integrating software. API stands for Application Programming Interface.

APIs let a product or service communicate with other products and services without having to know how they’re implemented.

For example, we use other APIs to pull in weather, send text messages, and similar 3rd party interactions. It allows you to build integrations between products.

What are Custom Fields in D4H?

Our Custom Fields feature allows you to add any data fields you want to a Member, Equipment Item, Incident Report, Incident Weather, Incident Person Involved, Team, Exercise Report, Event Report, Health & Safety Report, or a common field on all Activities. So for example, you might record 'Allergies' against a member, or a 'PO Number' against an item of equipment; you can customize D4H infinitely.

These fields can be different data types; Text (Single-line), Text Area (Multi-line), Date (Calendar), DateTime (Time Entry & Calendar), Single Choice (Dropdown), Multiple Choice (Multi-Select Dropdown), Numeric (Number), Time (Time Entry). For example, you could force a 'Risk Assessment Date' to be a Date & Time on a Training Exercise.

Custom Fields are grouped into headings called Custom Field Bundles. We take care of the creation and deletion of bundles, all you have to do is enter the title of the bundle you wish to use on the create or update of a field.

Ok great! What can I do with the Custom Fields API?

To get this level of customization, custom fields have to be a complex service. We built them before we had an API and we never added them to it afterward. This meant we could never include data from custom fields in our mobile apps, and customers building their own integrations could not get access to this data.

Since October we've been re-building the Custom Fields feature from the ground up, which is a shared-service across our products Personnel & Training, Equipment Management, and Incident Reporting. We're glad to say it's now fully available across our API at both Team and Organization levels.

  1. You can now access your custom fields data from a 3rd party application or script.
  2. You can now create, edit, and delete custom fields from a 3rd party application.
  3. We can now integrate custom field data into our mobile apps.

Release Notes (v9.21.0)

  • UI Improvements to Team > Settings > Custom Fields in the web app.

  • We've added the /v2/team/custom-fields API endpoint to teams.

    • GET /v2/team/custom-fields - List all Custom Fields.
    • POST v2/team/custom-fields - Create a Custom Field.
    • GET /v2/team/custom-fields/{id} - Get a Custom Field.
    • PUT /v2/team/custom-fields/{id} - Update a Custom Field.
    • DELETE /v2/team/custom-fields/{id} - Delete a Custom Field.
  • We've added the /v2/team/custom-fields/bundles endpoint.

    • GET /v2/team/custom-fields/bundles - List all Custom Field Bundles.
    • Custom Field Bundles are created and updated automatically as you create and update your Custom Fields.
  • We've added the /v2/team/custom-fields/{entity_type}/{entity_id} API endpoint to teams.

    • GET /v2/team/custom-fields/{entity_type}/{entity_id} - Get the Custom Fields and Custom Field Values for a specific entity.
    • PUT /v2/team/custom-fields/{entity_type}/{entity_id} - Set the Custom Field Value for a specific entity.

See our API Documentation for complete details.

We're looking forward to seeing what you create.

πŸ“ Equipment On A Map

New in D4H Equipment Management. Read about our new global equipment visualization interface on our blog.

Browse your equipment by map to get a geographical sense of where the nearest asset is located.

Video Overview

Watch video screencast.

Updates

Team Level

  • View Equipment Category
  • View Equipment Kind
  • List All Equipment Locations
  • View Equipment Location
  • Update Equipment Location

Organization Level

Within an organization, all equipment located in a team will inherit the base location of that team unless a specific location has been specified.

  • View Equipment Category
  • View Equipment Kind

For further instructions, see our blog.

πŸ“± Incident Management Mobile App

incident-management-app-launch-compressor.png

We're pleased to announce our new mobile app for the D4H Incident Management product. If you don't have a subscription yet, you can find out more here.

πŸ” View Inspections At Organization Level

It's now possible to view equipment Inspection Results at the parent Organization level. This makes it easy to see that maintenance and checks are staying on schedule, organization-wide.

Note: A parent organization sits on top of multiple teams. Inspections can be created at the parent organization level which applies to all kinds of equipment across the entire organization.

πŸ”‘ Initiate Password Reset For User

As an Admin you can now go to Collections > Personnel > Select Person > Reset Password to initiate a password reset email to a user on their behalf.

2019-11-21 at 11.42.jpg

All they have to do is press [Reset My Password] in the email sent to them.

2019-11-21 at 11.45.jpg

Export Organization Chart As Image

You can now export the Organization Chart of your Roles in D4H Incident Management to an image for inclusion in your ICS207 paperwork.

Also:

  • Be able to print organization charts to a single PDF page in landscape.
  • Be able to turn off team name on the header of PDF exports.
  • Be able to turn off β€˜Exported By’ and 'Date' on PDF exports.
  • Be able to have A) Default D4H Logo, B) Custom Logo, C) No Logo. This should reflect on both navigation bar, PDF Exports, and shared links

Extra Person Details in Attendance

This applies to the Attendance tab within Incidents in D4H Incident Reporting and Exercises & Events in D4H Personnel & Training.

You have always been able to add the number of Extra Persons / Guests to the attendance lists on an activity. Now you can also add their names and details within a text box below it to document the full details of these extra persons.

Checklist Progression Charts

We've added new progression charts to Task Boards within D4H Incident Management. This makes it simple to see how each function within your Incident Management Team is progressing through the incident.

This new user interface also matches our mobile app, double-click into any checklist to update the tasks behind it.

Qualify Attendees Of An Activity

You're now able to take the Attendance list of an activity (Exercise, Event, or Incident) such as a training course and award those members who attended a Qualification. We'll automatically set the date awarded to match the activity that occurred.

2019-11-18 at 16.39.jpg

Here's a short video to show you how it works:

Member Status Lists

Some teams and organizations have a lot of different custom member statuses which causes the Planning > Members listings page to render very slowly on-screen.

For performance reasons, if you have more than 5 statuses under Operational or Non-Operational we'll now show you a list of all your statuses to select from rather than loading them all on-screen.

This should make your access to the information you need faster.

2019-10-19 at 09.12.jpg

Updated 22-Oct-19: Changed from a maximum of 2 to 5 statuses on one page to reduce clicks required if only a few statuses.