Group & Ungroup

The group and ungroup methods, group and ungroup tagged objects in the same way that Illustrator's UI groups and ungroups a selection.

Currently the header's property cells cannot be left blank, so if you have set the tagSearch by using the top row of the spreadsheet's header and have not set other properties, set the property to *, skip or tagSearch. This will prevent an error being flagged on the property cell, you can leave the filler property's values blank.

To prevent the method being applied to a row, inside the method, use either the generic * property and set the cell value to false or the generic skip property and set the cell value to true.

To apply tags to the newly grouped item, use the tags property and provide a list of tags.

Example Spreadsheet

cat | dog | mouse	*
group	ungroup		comment
*	tagSearch: trees	skip	*
	trees		Both group and ungroup will be applied
FALSE	trees		group will be skipped, group's * property is set to false
	trees	TRUE	ungroup will be skipped, ungroup's skip property is set to true
	""		ungroup will be skipped, ungroup's tagSearch property is set to ""
TRUE	trees	FALSE	Both group and ungroup will be applied

Group and Ungroup Properties

Mode	Description
tagSearch	The tag search of the items to group or ungroup Example Values: cat | dog | mouse, trees
*	Set to false if you want the method to be skipped in a particular row. Valid Values: true or false
skip	Set to true is you want the method to be skipped in a particular row. See * and Skip for details. Valid Values: true or false
tags  for group method only	A list of tags to apply to the newly grouped object. Example Values: animals, pets, creatures