About Deploy
Deploy is a built-for-purpose field data manager; it enables the consistent and accurate collection of data from surveys and installation efforts.
How Deploy Works
Deploy takes the ease and convienence of web forms and adds in the missing components to become a fully-featured management tool for field data.
All access to resources within Deploy require a user to login with a personal user account. New users can only create an account using an Enrollment Link.
Projects are the top-level organizational structures in Deploy. They are used to contain all the structures listed below.
Roles are sets of permissions for a Project. A user in Deploy becomes a Team Member in a Project via a Role. The permissions set in a Team Member's Role define what they are allowed to do within a Project.
Sites and Locations are built into the context of Deploy and all collected data about a site or location can be viewed in its page. Each location is parented to a single site.
Deploy uses Location Groups to arrange locations into logical classes like "IDFs" and "Wireless Access Points".
Stages of a project are separated into Tasks, and each Task can be defined to collect a series of fields and/or photos. Task progress can be viewed and summarized for each location in multiple places. Tasks get associated with Location Groups, so each Location within a Location Group will have the same Tasks assigned.
Task Fields are inputs in a form which are used to collect data. A Task can have multiple Task Fields (inputs) defined with different parameters. There are also different Task Field types like Text, Number, Select, etc.
Photo Policies can also be defined for a Task to allow photos to be attached. A Photo Policy can require photos be submitted before or after data is collected or at any time. A Photo Policy can also set a minimum number of photos to be submitted before a task is considered complete.
Events are log entries within a Project. Each time something in a Project is added, modified, or deleted, an Event is generated and is added to the Event Log. A Project's Event Log can be viewed on its Dashboard.
Origin
Collection of installation information can be quite challenging. When installation or survey teams of any size need to collect and combine information collected from installers in the field (ie: IDF name, number of switches, etc), they often start by leveraging familiar tools.
These tools can range from pre-formatted emails, templatized rich-text documents (ie: Microsoft Word), or even structured data formats like spreadsheets, but there are soon discovered problems with these types of data collection:
Spreadsheets can present inputs to fill out information, but they can't properly contain photos. It becomes difficult to update the spreadsheet template and send it out to a large team, and when each team member has their own copy of the spreadsheet, all that data needs to be manually combined.
The next best solution might be web forms like those from Jotform, Smartsheets, or Google Forms. Web forms work well for most of the requirements, they can:
Where web forms fall short is in the last three requirements: End-user visibility, built-in context, and cross-referencing of related information.
End-user visibility
Web form services allow a user to submit all the data requested in the form, but they don't allow that same user to view what has already been submitted. This becomes problematic when trying to keep track of progress, or when a user wants to look back at previously submitted data for reference.
Built-in context
Submission of general web forms will always require repetitive or contextual information to be submitted alongside the truely interesting information. For example, a basic IDF survey form could look like the below:
A surveyor visiting IDFs within a single site would repetitively input the same information for the first three inputs in this form.
Cross-referencing related information
When installers visit the same location multiple times throughout the stages of a project (ie, survey, installation, QA), they submit a new web form during each visit. Information from each stage then has to be manually combined together to form a wholistic view of submitted data for a specific location.
Change Log
Date | Type | Description |
---|---|---|
2025-04-24 | Bug | Export of TaskAnswers with new TaskFields (which have no keys in any answer) were not prepopulating an empty column for the new key. |
2025-04-21 | New Feature | Added descriptions to Task Photos. Description can be set upon upload and can be edited from the Location's page. |
2025-04-16 | Bug | Fixed bug where newly uploaded photos (before page reload) would not have a policy name badge. |
2025-04-15 | New Feature | Import functionality has been added for Sites, Location Groups, Locations, and Task Answers. Import functionality can be used to create, update, and delete entries. Role permissions are required for the different actions and all actions generate events. |
2025-02-27 | New Feature | Added a toggle switch to the account settings page which will prevent photos from loading when viewing locations. This can speed up mobile workflows when internet speeds are limited. |
2025-02-25 | Optimization | Added DB optimizations to the main locations page as well as site and location group views to speed up page load times. |
2025-02-24 | New Feature | Export functionality has been added for Sites, Location Groups, Locations, and Task Answers. To find the export link, click the button in the header on the appropriate pages. |
2025-02-24 | Optimization | Admin site TaskAnswer export functionality has been drastically sped up with database prefetching. |
2025-02-24 | Optimization | A master Locations page has been added to see all locations within a project. Quantities of entries have also been added to the dashboard link buttons. |
2025-02-24 | Optimization | The Tasks page now shows the number of answers for each task as well as the number of locations in each location group. |
2025-01-27 | Optimization | Changed the ui_url field on endpoints to gui_url and renamed url to api_url . Made both fields pseudo-native to the models so they can be filtered and added to serialization of related fields with below feature. |
2025-01-27 | Optimization | Added capability to treat @property methods on models as pseudo-native fields for serialization. Moved some artificial fields to be pseudo-native for filtering capability. |
2024-01-27 | New Feature | Created feature to add and/or filter fields in API queries using the ?fields= and ?add_fields= query parameters. Related fields can be serialized as first-class fields for any forward-lookup relationship. For example: locations with project name included. ?fields= will filter and add fields simultaneously. ?add_fields= will add fields for serialization without filtering. |
2025-01-13 | Optimization | Changed all API endpoints to include all fields. Added the ui_url field to all endpoints where objects have a dedicated GUI detail page (ie: Locations) |
2025-01-10 | Bug | Fix validation of submitted TaskAnswers (GUI or API) when a number field value is not a valid integer (reported by Kyle). |
2025-01-10 | New Feature | Added the ability to view TaskField config information on the /project/tasks/id/ page. |
2024-12-30 | Optimization | Moved the UserAccess API endpoint over to use all current API frameworks. All project-based endpoints now use and are tested against our security (RBAC), event, and filtering frameworks. |
2024-12-27 | New Feature | Added in-depth API filtering capabilities for all framework-current endpoints. All fields and lookup expressions are now supported on endpoints. |
2024-12-27 | Optimization | Moved the Projects and Roles API endpoints over to use all current API frameworks. |
2024-12-20 | New Feature | Added event logging for Site / Location / Location Group / Task Answer / Role / Photo deletion, as well as Photo modification. |
2024-12-20 | Optimization | Built new event handling framework and moved all existing event creation to the new framework. Added functionality to properly render events when references are deleted. |
2024-12-11 | Optimization | Added the TaskFields API endpoint. Added fields to Tasks [detail] view for additional detail. |
2024-12-11 | Optimization | Built field validation into the TaskAnswer API endpoint. Now data submitted to the endpoint will be validated the same way as forms submitted via the GUI. |
2024-11-15 | New Feature | Added the TaskAnswers API endpoint. |
2024-11-15 | Optimization | Built new RBAC system for API endpoints which uses existing roles and permissions. Applied to all endpoints except Projects, Roles, and UserAccess. Most endpoints are now read/write capable. |
2024-11-07 | New Feature | Added bulk creation functionality for new locaitons and sites. |
2024-10-23 | New Feature | Added API token functionality and management in the user account management page. |
2024-10-17 | Bug | Fix next/previous swipe events on off-screen tables (reported by Tyson) |
2024-10-11 | New Feature | Added the multi-choice task field type. Includes the dynamic option and learning mode functionality |
2024-09-30 | New Feature | Extended the dynamic-option and single-use features to the existing Select field type |
2024-09-30 | New Feature | Added a 'single-use choice' feature for selection-type fields. When enabled it only allows each choice in a field to be used one time for one location. Subsequent locations will either disable or hide the choice on in the field. |
2024-09-16 | New Feature | Added the "Single-Choice" task field type. New field type includes a dynamic "Other" option function as well as new option learning mode. Features are fully configurable via the field config. |
2024-09-16 | Optimization | Added this "About Deploy" page |
2024-08-26 | Bug | Hotkey/swipe on a photo in a location was activating Next/Prev on location and not on photo (reported by Tyson) |
2024-08-15 | New Feature | Added hotkey and swipe navigation to all pages with Prev/Next buttons (for Tyson) |
2024-08-15 | Optimization | Auto-focus on the name input in a new location edit page |
2024-08-15 | Bug | Fixed PDF view and navigation in site view pages (reported by Art and Hailee) |
2024-05-23 | Optimization | Added location notes to location tables (for Ed) |
2024-05-21 | New Feature | Front-end control of Roles added |