【SharePoint Online】JavaScript で権限変更。

Question

前提・実現したい事

JavaScriptを使用し、SharePoint Online上でユーザーの
「アクセス権限」を変更したいです。

本来の希望動作は「観覧・編集・登録・・・」等、様々に変更可能にしたいです。
現段階では、テスト作成なので「観覧のみ」に設定したいです。

// リストを固有の権限に設定し既存権限をすべてクリア
oListItem.breakRoleInheritance(false, false);

の部分で、権限をリセットされているはずが、リセット(初期化)されていないという事でしょうか？

発生している問題・Error Message

自分の権限は元々「フルコントロール」が付いております。
下記プログラムを実行し、
"自分の予想では"「フルコントロール → 観覧」に権限が変更されると思っていました。

しかし実際は、「フルコントロール → フルコントロール,観覧」のように
自分の権限に『追加』されてしまいます。

どなたか分かる方いれば、よろしくお願い致します。

実際のソースコード

function breakSecurityInheritanceChangeUser() {
	// リスト名
	var listName 		= "test";

	// コンテキストの取得
	var clientContext 	= new SP.ClientContext;

	// 現在のログインユーザーの取得
	var oUser 			= clientContext.get_web().get_currentUser();

	// 対象リストの取得
	var oList 			= clientContext.get_web().get_lists().getByTitle(listName);

	// 対象アイテム選択
	var itemId 			= 1;

	/*---------------------------------------------------------------------------*/
	// 処理
	/*---------------------------------------------------------------------------*/

	// アイテム情報取得
	var oListItem = oList.getItemById(itemId);

	// リストを固有の権限に設定し既存権限をすべてクリア
	oListItem.breakRoleInheritance(false, false);

	// ロールバインディング
	var collRoleDefinitionBinding = SP.RoleDefinitionBindingCollection.newObject(clientContext);

	// 閲覧アクセス許可レベルの追加
	collRoleDefinitionBinding.add(clientContext.get_web().get_roleDefinitions().getByType(SP.RoleType.reader));

	// ユーザーをバインド
	oListItem.get_roleAssignments().add(oUser, collRoleDefinitionBinding);

	// ユーザー情報読込
	clientContext.load(oUser);

	// アイテム情報読込
	clientContext.load(oListItem, "Title");

	// 実行 -- アラートにて表示 --
	clientContext.executeQueryAsync(function(){
		alert("次のアイテムに固有の権限を設定しました :\n" + oListItem.get_item("Title") + "\n\n" + "新たに次のユーザーに権限を付与しました :\n" + _spPageContextInfo.userLoginName);
	}, onQueryFailed);
}

/*---------------------------------------------------------------------------*/
// 失敗時のメッセージ
/*---------------------------------------------------------------------------*/
function onQueryFailed(sender, args) {
	alert("Request failed. " + args.get_message() + "\n" + args.get_stackTrace());
}

試した事

補足情報(言語/FW/ツール等のVersion)

・Window 7
・SharePoint Online(Office365)
・IE、Google Chrome

Answer 1

SharePointグループ（ユーザー）のアクスル許可レベルを変更するにはimportRoleDefinitionBindings()を使用します。

具体的な手順としては下記の通りです。

1.アクセス権限の継承を切断する
2.アクセス許可レベルを変更したいSharePoint グループ（ユーザー）を取得します
3.付与したいアクセス許可レベルを作成して、対象のSharePoint グループ（ユーザー）に付与して更新します。

サンプルコードは下記の通りです。

//(1)アクセス権限の継承を切断する
var siteUrl 	= '/sites/SiteUrl';
var ctx 	= new SP.ClientContext(siteUrl);
var web 	= ctx.get_web();
var list 	= web.get_lists().getByTitle('ListName');

list.breakRoleInheritance(true, false);

//(2)アクセス許可レベルを変更したいSharePoint グループ（ユーザー）を取得します
var group = list.get_roleAssignments().getByPrincipalId(XX) //XXにはSharePointグループ（ユーザー）の割り振られているID（番号）が入ります。

//(3)付与したいアクセス許可レベルを作成して、対象のSharePoint グループ（ユーザー）に付与して更新します。
var collRoleDefinitionBinding = SP.RoleDefinitionBindingCollection.newObject(ctx);
this.oRoleDefinition = web.get_roleDefinitions().getByType(SP.RoleType.reader);
collRoleDefinitionBinding.add(oRoleDefinition);

group.importRoleDefinitionBindings(collRoleDefinitionBinding);
group.update();

ctx.load(list);

ctx.executeQueryAsync(
	Function.createDelegate(this, this.onQuerySucceeded), 
	Function.createDelegate(this, this.onQueryFailed)
);

function onQuerySucceeded(sender, args) {
	alert('成功！');
}

function onQueryFailed(sender, args) {
	alert('失敗...');
}

• 補足

breakRoleInheritance()の解釈が少し誤っています。
正しくは下記の通りです。

× リストを固有の権限に設定し既存権限をすべてクリア
〇 リスト（サイト、アイテム...etc）のアクセス権限の継承を切断して、固有のアクセス権限が付与可能な状態にする

そのため、既存権限が消される訳ではないのでご注意下さい。

・breakRoleInheritance()のリファレンス
https://docs.microsoft.com/en-us/previous-versions/office/developer/sharepoint-2010/ee659518%28v%3doffice.14%29