現在ログインしているユーザーが所属するグループ(ロール)を取得します。
このアクションを実行すると、所属するグループの情報がアクションの結果として保存されます。
この情報を式を使用して $1 などから参照することも可能ですが、「指定のグループ・組織に所属するならば」と組み合わせるのがより典型的な使用方法です。
他のアクションから式を使用して結果を参照する場合、結果データの構造はCybozu のドキュメント から「レスポンス」の項を参照してください。
例えば、1つ目の所属グループのグループ名を取得したい場合は以下のようになります。
= $1.groups[0].name
フィールドマッピングでグループ選択フィールドへセットしたい場合は以下のようにします。
= $1.groups.code
「フィールドに値をセットする」の場合のみは特例で、グループ選択フィールドへ単に「= $1」のみでセットすることが可能です。
「セット先フィールド(省略可)」を指定します。
取得したグループを他のフィールドにセットする場合に指定します。直接フィールドにはセットせず、結果を別のアクションで使用したい場合は、省略できます。
セット先をグループ選択フィールドにした場合、現在選択されている他のグループはクリアされたうえで、ログインユーザーの所属グループが選択された状態になります。複数のグループに所属している場合はすべてセットされます。
セット先を文字列(1行)等にした場合、グループ名がセットされます。複数のグループに所属している場合はグループ名をカンマ区切りで並べたものがセットされます。
ユーザーがゲストユーザーの場合は取得できません。