VCOF0006

OmniFocus: Schedule Medication

This voice command is useful for tracking the course of doses for a specified medication, by creating a new project whose sequential tasks will execute an individual notification for each of the doses.

(below) OmniFocus project and dosage alert on Apple Watch

Scope and Syntax

Language: English (United States 🇺🇸 · Great Britain 🇬🇧 · Australia 🇦🇺 · Canada 🇨🇦) • Scope: System-Wide

Command phrase variations (words in [brackets] are optional):

• “Schedule Medication”

Requirements

• Application: OmniFocus 4, OmniFocus: 3.13
• System: macOS 12.3, iOS 15, iPadOS 15

Video: Schedule Medication

Presents an Omni Automation that generates a sequential project containing individual notifications for doses.

PLAY PAUSE BACK REWIND

PLAY PAUSE BACK REWIND

Installing voice commands on iOS/iPadOS While Apple’s mobile operating systems currently do not support the Open URL action used in the voice commands files provided on this website, you can still create and use customized Omni Automation voice commands for iPhones and iPads! To create your voice commands, we’ll use specialized Shorcuts workflows that you can “tap-to-install” from the various example pages. Simply follow these steps or view the illustrated instructions here: First, install an Omni Automation shortcut from one of the provided links. (below) Next, in the mobile Settings app, tap Accessibility ▸ Voice Control ▸ Customize Commands ▸ Custom ▸ Create New Command… and in the forthcoming New Command interface select the installed shortcut as the value for the “Action” parameter. Enter one of the command phrases from the example’s documentation page (above) for the value of the “Phrase” property, and… Finally, set the value of the “Application” parameter to either “Any” for global access or choose the Omni app to target from the provided list of installed applications. You can then activate Voice Control and use your voice command to trigger the shortcut to run the Omni Automation script!

Downloads

• ⇩ COMMANDS-FILE OmniFocus 4.0
• ⇩ COMMANDS-FILE OmniFocus 3.13
• ⇩ SHORTCUT-LINK (“Schedule Medication”)

Voice Command Code

One of the best features of Omni Automation is the ability to display forms to the user so they may provide input and selection choices to the script to use in its processing. This command will present a dialog with form elements for setting the parameters of the project.

IMPORTANT: To enable navigation of Omni Automation forms using Voice Control, make sure that the “Use keyboard navigation…” checkbox is selected in the Keyboard > Shortcuts system preference pane.

Here’s the Omni Automation code for the command:

Schedule Medication
Copy

(async () => {

	var projectTitleField = new Form.Field.String(
		"projectTitle",
		"Medication Name",
		null,
		null
	)

	var startDayMenu = new Form.Field.Option(
		"startDay", 
		"Start", 
		["Today", "Tomorrow"], 
		["Today", "Tomorrow"], 
		"Today"
	)

	var times = ["1:00", "2:00", "3:00", "4:00", "5:00", "6:00", "7:00", "8:00", "9:00", "10:00", "11:00", "12:00"]
	var timeIndexes = times.map((item, index) => index)
	var timesMenu = new Form.Field.Option(
		"startTime", 
		"Initial Dose", 
		times, 
		times, 
		"1:00"
	)

	var meridiemMenu = new Form.Field.Option(
		"meridiemOption", 
		"AM/PM", 
		["AM", "PM"], 
		["AM", "PM"], 
		"AM"
	)

	var courseDurationMenu = new Form.Field.Option(
		"courseDuration", 
		"Number of Days", 
		["5", "7", "10", "12", "28", "30"], 
		["5", "7", "10", "12", "28", "30"], 
		"7"
	)

	var timesPerDayMenu = new Form.Field.Option(
		"timesPerDay", 
		"Times per Day", 
		["1", "2", "3", "4"], 
		["1", "2", "3", "4"], 
		"1"
	)

	var inputForm = new Form()
	inputForm.addField(projectTitleField)
	inputForm.addField(startDayMenu)
	inputForm.addField(timesMenu)
	inputForm.addField(meridiemMenu)
	inputForm.addField(courseDurationMenu)
	inputForm.addField(timesPerDayMenu)

	inputForm.validate = function(formObject){
		var projectTitle = formObject.values['projectTitle']
		return (!projectTitle) ? false:true
	}

	var formPrompt = "Select parameters for this medication:"
	var buttonTitle = "Continue"
	var formObject = await inputForm.show(formPrompt, buttonTitle)

	var projectTitle = formObject.values["projectTitle"]
	var startDay = formObject.values["startDay"]
	var startTime = formObject.values["startTime"]
	var meridiemOption = formObject.values["meridiemOption"]

	var targetDate = new Date()
	if (startDay === "Tomorrow"){
		targetDate = new Date(targetDate.setHours(24, 0, 0, 0))
	}
	var dateString = targetDate.toLocaleDateString()
	var startDueDate = new Date(dateString + " " + startTime + " " + meridiemOption)

	var courseDuration = Number(formObject.values["courseDuration"])
	var courseDurationString = String(courseDuration)

	var timesPerDay = Number(formObject.values["timesPerDay"])
	var timeInterval = 24 / timesPerDay
	var timeIntervalString = String(timeInterval)

	var dosageCount = courseDuration * timesPerDay
	var dosageCountString = String(dosageCount)

	var dc = Calendar.current.dateComponentsFromDate(startDueDate)
	dc.day = dc.day + courseDuration
	var completionDate = Calendar.current.dateFromDateComponents(dc)
	var completionDateString = completionDate.toLocaleDateString()

	var project = new Project(`${projectTitle} (${courseDurationString}-day to ${completionDateString})`)
	project.sequential = true
	project.completedByChildren = true

	var taskDueDateTime = startDueDate.getTime()
	var millisecondsToAdd = timeInterval * 3600000

	for (var i = 0; i < dosageCount; i++) {
		var task = new Task(`Dose ${i + 1}`, project)
		if (i !== 0){
			taskDueDateTime = taskDueDateTime + millisecondsToAdd
		}
		var newDueDate = new Date(taskDueDateTime)
		task.dueDate = newDueDate
	}

	document.windows[0].perspective = Perspective.BuiltIn.Projects
	document.windows[0].focus = [project]
})().catch(err => {
	if (!err.message.includes("was cancelled")){
		new Alert(err.name, err.message).show()
	}
});