LoginSignup
7
7
@ksgiksg(おいしみ)

SharePoint リストの選択肢列をPower Automateで操作する

Posted at

はじめに

リストの選択肢を自動的に増やしたり減らしたりしたいときの方法です。
image.png

ここを編集したい、というのが本記事の内容です。
image.png

SharePoint リストはよく、簡易データベースとしてPower Apps のデータソースとして用いられることもありますが、普通、選択式の項目を増減しようと思うと、もう一つ選択肢のためだけのリストを作ってリレーションするのが一般的です。
この方法を使うと、1つのリストだけで完結することができるので、テーブル構造がシンプルになる可能性があります。

SharePoint REST API

方法としては、API を使います。
SharePoint コネクタには、API を使用するためのアクションが標準で用意されておりますので、プレミアムライセンスなしで利用することができます。
image.png

ただ、API を使う分、フローの難易度が高くなりますので、ここでは順を追って説明していきます。

リストを取得する

選択肢を操作するにはまず、選択肢がどのように登録されているかを知る必要があります。
直接選択肢の情報を取得する前に、まずはリスト自体にアクセスしてみましょう。

parameterは以下のように設定します。
image.png

parameter value
サイトのアドレス リストを作成したサイトのホームURL
方法 GET
URI _api/web/lists/getbytitle('{リストの名前}')

実行結果はこのようになります。
この結果のうち、Fieldsが列の定義ですので、次はここにアクセスしていきます。
image.png

列の定義を取得する

リストの情報を取得する方法に加えて、1階層潜ってFields(列)にアクセスします。
先ほどのURIの末尾に、/Fieldsを加えるだけでOKです。
image.png

parameter value
サイトのアドレス リストを作成したサイトのホームURL
方法 GET
URI _api/web/lists/getbytitle('{リストの名前}')/Fields

結果はこのようになります。
結果から、次にアクセスしたい選択肢列を探しておきます。
image.png

特定の列の定義を取得する

先ほど取得したすべての列の定義のうち、アクセスしたい特定の列（選択肢列）の情報にアクセスします。

検索して探した列定義の中には、メタ情報として、その特定の列にアクセスするためのURIが記載されています。
image.png

__metadata/uri
https://v45dm.sharepoint.com/sites/ksgiksg/_api/Web/Lists(guid'afbadf6e-924c-4cd2-ac9d-acb76a5ecc28')/Fields(guid'40b70f91-91ef-4293-8c45-d55ff0960a55')

ここで確認したいのは、Fields(guid'の後ろのIDです。（ここでは40b70f91-91ef-4293-8c45-d55ff0960a55）
IDを直接記載しているプロパティもあるので、どちらからでも確認ができます。
image.png

IDを確認したら、parameterを以下のように設定します。
image.png

parameter value
サイトのアドレス リストを作成したサイトのホームURL
方法 GET
URI _api/web/lists/getbytitle('{リストの名前}')/Fields (guid'{列のID}')

IDの前後に'(シングルクォーテーション)が必要なので注意

結果はこのようになります。
やっと選択肢が取得できましたね！
image.png

選択肢を取得する

選択肢の取得に関しては、前項でもうできてしまったので、ここは必要ないのですが、選択肢のみの情報に絞って取得することもできます。
URI末尾に/Choicesを加えます。
image.png

parameter value
サイトのアドレス リストを作成したサイトのホームURL
方法 GET
URI _api/web/lists/getbytitle('{リストの名前}')/Fields(guid'{列のID}')/Choices

結果は先ほどよりシンプルで、このようになります。
image.png

選択肢を更新する

ようやく本題です。
取得にはGETを使いましたが、更新にはPATCHを使用します。
image.png

また、更新するための情報(ボディ)やヘッダーも必要になります。
※ここでは「バッタ」を選択肢に追加した情報を入力しています。
image.png

ボディとヘッダーを設定するには、アクション下部のすべてを表示をクリックします。
image.png

parameter value
サイトのアドレス リストを作成したサイトのホームURL
方法 PATCH
URI _api/web/lists/getbytitle('{リストの名前}')/Fields(guid'{列のID}')
ヘッダー "accept":"application/json;odata=verbose"
"Content-Type":"application/json;odata=verbose"
ボディ
{
	"__metadata": {
		"type": "SP.FieldChoice"
	},
	"Choices": {
		"__metadata": {
			"type": "Collection(Edm.String)"
		},
		"results": [
			"ライオン",
			"トラ",
			"チーター",
			"バッタ"
		]
	}
}

実行すると、このようにリスト側で選択肢が追加されていることが確認できます。
image.png

おわりに

ちょっと苦手で敬遠していたSharePoint REST API に挑戦してみました。
リストの定義自体を編集できると、いろいろとできることが広がりそうです。
最近できるようになったSharePoint リストから直接フォームを作る機能と組み合わせると、Microsoft Forms ではできなかったことができそうです！

7
7
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
Sign upLogin
7
7