4D v14.3

Set group properties

ホーム

 
4D v14.3
Set group properties

Set group properties 


 

Set group properties ( groupID ; name ; owner {; members} ) -> 戻り値 
引数   説明
groupID  倍長整数 in グループのユニークなID番号、または、 -1= 設計者グループの追加 -2= 管理者グループの追加
name  文字 in 新規グループの名前
owner  倍長整数 in 新規グループオーナーのユーザID番号
members  倍長整数配列 in 新規グループのメンバー
戻り値  倍長整数 in 新規グループのユニークなID番号

説明   

Set group properties コマンドを使用すれば、引数 groupID に渡したユニークなグループID番号を持つ既存のグループのプロパティを変更および更新することが可能です。また、設計者あるいは管理者に関連する新規グループを追加することもできます。

既存グループのプロパティを変更している場合は、GET GROUP LIST コマンドによって返された有効なグループID番号を渡さなければなりません。グループID番号は以下の値および範囲を持っています。

グループID番号 グループ説明
15001 to 32767設計者または関連するグループオーナーによって作成されたグルーブ (グループ番号15001は、設計者によって最初に作成されたグループ、グループ番号15002は、2番目に作成されたグループなど)
-15001 to -32768管理者または関連するグループオーナーによって作成されたグループ (グループ番号-15001は、管理者によって最初に作成されたグループ、グループ番号-15002は、2番目に作成されたグループなど)

設計者に関連する新規グループを追加するには、引数 groupID に -1を渡します。管理者に関連する新規グループを追加するには、引数 groupID に -2を渡します。呼び出し後、グループの追加が完了すると、そのユニークなID番号が引数 groupID に返されます。

-1、 -2 または有効なグループID番号が渡されない場合、Set group properties コマンドは何も行いません。

呼び出す前に、引数 nameowner にグループの新しい名前とオーナーを渡します。グループのすべてのプロパティを変更したくない場合 (メンバー以外、以下参照) 、最初にGET GROUP PROPERTIES コマンドを呼び出し、変更したくないプロパティに対して返された値を渡します。

オプション引数 members が渡されないと、現在のグループのメンバーリストは変更されません。
グループを追加している際に、引数 members が渡されないと、そのグループにはメンバーが追加されません。

Note: グループオーナーは自身が所有するグループのメンバーとして自動的に設定されるわけではありません。引数 members を使用して、グループオーナーをそのグループに含めるかどうかはユーザ次第です。

オプション引数 members を渡すと、そのグループのメンバーリスト全体を変更します。呼び出す前に、そのグループがメンバーとして取得するユーザとグループのユニークなID番号を配列 members に割り当てなければなりません。

メンバーID番号 メンバー説明
1設計者ユーザ
2管理者ユーザ
3 to 15000データベースの設計者によって作成されたユーザ (ユーザ番号3は、 設計者によって最初に作成されたユーザ、ユーザ番号4は、2番目に作成されたユーザなど)
-11 to -15000データベースの管理者によって作成されたユーザ (ユーザ番号-11は、管理者によって最初に作成されたユーザ、ユーザ番号-12は、2番目に作成されたユーザなど)
15001 to 32767設計者または関連するグループオーナーによって作成されたグルーブ (グループ番号15001は、設計者によって最初に作成されたグループ、グループ番号15002は、2番目に作成されたグループなど)
-15001 to -32768管理者または関連するグループオーナーによって作成されたグループ (グループ番号-15001は、管理者によって最初に作成されたグループ、グループ番号-15002は、2番目に作成されたグループなど)

グループからすべてのメンバーを削除するには、空の配列 members を渡します。

コマンドを呼び出すための特定のアクセス権を持っていない場合や、パスワードシステムが他のプロセスによって既にアクセスされている場合は、アクセス権エラーが生成されます。ON ERR CALL コマンドを使ってインストールされたエラー処理メソッドでこのエラーを受け取ることができます。

 
プロパティ 

プロダクト: 4D
テーマ: ユーザ&グループ
番号: 614

Errorシステム変数が更新されることがあります。

 
履歴 

初出: 4D v6

 
参照 

GET GROUP LIST
GET GROUP PROPERTIES
GET USER LIST

 
ARTICLE USAGE

ランゲージリファレンス ( 4D v11 SQL Release 6)
ランゲージリファレンス ( 4D v12.4)
ランゲージリファレンス ( 4D v14 R2)
ランゲージリファレンス ( 4D v14 R3)
ランゲージリファレンス ( 4D v13.5)
ランゲージリファレンス ( 4D v14.3)
ランゲージリファレンス ( 4D v14 R4)