GrouperShell (gsh) Group insert / update / delete (GroupSave)

The GroupSave class is the recommended and support way to insert/update/delete a group. This class was introduced in v1.4+ , some options added later.

Sample call

Group groupAbc = new GroupSave().assignName("a:b:c").assignCreateParentStemsIfNotExist(true).save();

Sample using GroupSave results

GroupSave groupSave = new GroupSave().assignName("a:b:c").assignCreateParentStemsIfNotExist(true); Group groupAbc = groupSave.save(); System.out.println(groupSave.getSaveResultType()); // DELETE, INSERT, NO_CHANGE, or UPDATE

Sample to delete

new GroupSave().assignName("a:b:c").assignSaveMode("DELETE").save();

To edit just one field (the description) for existing group a:b:c

new GroupSave().assignName("a:b:c").assignDescription("new description").assignReplaceAllSettings(false).save();

To edit just one field (the idIndex) for existing group a:b:c

Note, that new idIndex cant be in use by another group (query grouper_groups_v for the id_index col) and should not be above the current pointer (which you can adjust in the table grouper_table_index)

new GroupSave().assignName("a:b:c").assignIdIndex(12345).assignReplaceAllSettings(false).save();

Rename a group to same parent folder

new GroupSave().assignGroupNameToEdit("folder:oldName").assignName("folder:newName").assignReplaceAllSettings(false).save();

Options

Java docs: https://software.internet2.edu/grouper/doc/2.5.x/grouper/apidocs/edu/internet2/middleware/grouper/GroupSave.html

Legacy methods

This methods are not recommended: