VCOF0017

OmniFocus: New Tab with Perspective

This voice command will prompt the user to choose the perspective to display in a new window (iOS/iPadOS) or tab (macOS).

Scope and Syntax

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

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

• “Add Perspective View”
• “New Tab with Perspective”

Video: New Tab with Perspective

Open a new tab displaying the chosen perspective

PLAY PAUSE BACK REWIND

Requirements

• Application: OmniFocus 4
• System: macOS 12.3, iPadOS 15, visionOS 1.0

Downloads

• ⇩ COMMANDS-FILE OmniFocus 4.0
• ⇩ SHORTCUT-LINK (“Add Perspective View”) (iOS · iPadOS · visionOS)

Voice Command Code

As a guidance, the dialog prompting the user to select the perspective to display in a new window/tab includes quoted Voice Control commands like: “Move Down” and “Press Return Key”

Here’s the Omni Automation code for the command:

Add Perspective View
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()
	
		bPerspectives = Perspective.BuiltIn.all
		idx = bPerspectives.indexOf(Perspective.BuiltIn.Search)
		if (idx > -1) {
			bPerspectives.splice(idx, 1);
		}
		bPerspectives.sort((a, b) => {
			x = a.name;
			y = b.name;
			if (x < y) {return -1;}
			if (x > y) {return 1;}
			return 0;
		})
		bpNames = bPerspectives.map(p => p.name)
	
		cPerspectives = Perspective.Custom.all
		cPerspectives.sort((a, b) => {
			x = a.name;
			y = b.name;
			if (x < y) {return -1;}
			if (x > y) {return 1;}
			return 0;
		})
		cpNames = cPerspectives.map(p => p.name)
		pNames = bpNames.concat(cpNames)
		itemIndexes = pNames.map((item, index) => index)
		pObjs = bPerspectives.concat(cPerspectives)
	
		perspectivesMenu = new Form.Field.Option(
			"perspective", 
			"Perspective", 
			itemIndexes, 
			pNames, 
			0
		)
	
		inputForm = new Form()
		inputForm.addField(perspectivesMenu)
		formPrompt = "Choose perspective:"
		buttonTitle = "Continue"
		formObject = await inputForm.show(formPrompt,buttonTitle)
		chosenIndex = formObject.values['perspective']
		chosenPerspective = pNames[chosenIndex]
		perspect = pObjs[chosenIndex]
		
		if (Device.current.mac){
			var win = await document.newTabOnWindow(document.windows[0])
		} else {
			var win = await document.newWindow()
		}
		win.perspective = perspect
		
		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()
		}
	}
})();