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
• System: macOS 12.3, iOS 15, iPadOS 15, visionOS 1.0

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 Control commands on iOS · iPadOS · visionOS 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! Installing Siri commands on iOS · iPadOS · visionOS To use this voice command with Siri, simply install the provided Shortcuts workflow. To trigger the command, summon Siri and say: “Hey Siri, [Name of installed Shortcuts workflow]” NOTE: After installation of the shortcut, you can rename it to whatever phrase fits your needs.

Downloads

• ⇩ COMMANDS-FILE OmniFocus 4.0
• ⇩ SHORTCUT-LINK (“Schedule Medication”)(iOS · iPadOS · visionOS)

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 () => {
	try {
		function createUtterance(textToSpeak){
			langCode = Speech.Voice.currentLanguageCode
			voiceObj = Speech.Voice.withLanguage(langCode)
			utterance = new Speech.Utterance(textToSpeak)
			utterance.voice = voiceObj
			utterance.rate = Speech.Utterance.defaultSpeechRate
			return utterance
		}
		synthesizer = new Speech.Synthesizer()
		
		projectTitleField = new Form.Field.String(
			"projectTitle",
			"Medication Name",
			null,
			null
		)

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

		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"]
		timeIndexes = times.map((item, index) => index)
		timesMenu = new Form.Field.Option(
			"startTime", 
			"Initial Dose", 
			times, 
			times, 
			"1:00"
		)

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

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

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

		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){
			projectTitle = formObject.values['projectTitle']
			return (!projectTitle) ? false:true
		}

		formPrompt = "Drug name and parameters:"
		buttonTitle = "Continue"
		spokenPrompt = "Enter the drug name, and select the scheduling parameters."
		utterance = createUtterance(spokenPrompt)
		synthesizer.speakUtterance(utterance)

		formObject = await inputForm.show(formPrompt, buttonTitle)

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

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

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

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

		dosageCount = courseDuration * timesPerDay
		dosageCountString = String(dosageCount)

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

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

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

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

		document.windows[0].perspective = Perspective.BuiltIn.Projects
		document.windows[0].focus = [project]
		
		utterance = createUtterance('Done!')
		synthesizer.speakUtterance(utterance)
	}
	catch(err){
		if (!err.causedByUserCancelling){
			utterance = createUtterance(err.message)
			synthesizer.speakUtterance(utterance)
			new Alert(err.name, err.message).show()
		}
	}
})();