SPWidgetAccessControl - グローバル

  • リリースバージョン: Yokohama
  • 更新日 2025年01月30日
  • 所要時間:2分
  • SPWidgetAccessControl スクリプトインクルードは、指定されたテーブルがウィジェットへのパブリックアクセスを許可されているかどうか、および対象ユーザーが安全にアクセスしているかどうかをアドミニストレーターが確認できるようにするメソッドを提供します。

    サーバー スクリプトで SPWidgetAccessControl API を使用する方法の詳細と手順については、「 Configure widget security (ゲスト ユーザーがパブリック ウィジェットがアクセスできるテーブルを制限する)」を参照してください。

    SPWidgetAccessControl – SPWidgetAccessControl()

    SPWidgetAccessControl オブジェクトをインスタンス化します。

    表 : 1. パラメーター
    名前 タイプ 説明
    なし

    次の例は、新しい SPWidgetAccessControl オブジェクトを初期化する方法を示しています。

    new global.SPWidgetAccessControl()

    SPWidgetAccessControl – hasPublicAccess(String tableName, Object SPScriptable, String options, Object input)

    指定されたテーブルがウィジェットへのパブリックアクセス権を持っているかどうかに関する情報を返します。

    表 : 2. パラメーター
    名前 タイプ 説明
    tableName 文字列 必須。クエリするテーブルの名前。たとえば、 インシデント [Incident] テーブルをクエリするには「incident」と入力します。
    SPScriptable スクリプト可能オブジェクト 必須。ウィジェットの SP スクリプト可能。要求で $sp としてフォーマットされます。
    SPScriptable:{
    "widgetSysId":widget sys_id,
    "request":request object
    }
    オプション オブジェクト オプション。ウィジェットで渡されるウィジェット/矩形オプション。
    "options":{
    "table":"incident", "maximum_entries": "10"
    }
    
    入力 オブジェクト オプション。実行時に渡されるウィジェット/矩形入力。
    "input":{
    "table":"incident", 
    "display_field":"name"
    }
    表 : 3. 戻り値
    タイプ 説明
    ブール 指定したテーブルのウィジェットアクセスステータスを示すフラグ。可能な値:
    • true:指定されたテーブルには、ウィジェットに対するセキュリティアクセス権が付与されます。
    • false:指定されたテーブルには、ウィジェットに対するセキュリティアクセスが許可されていません。

    デフォルト値:false

    次の例は、構成テーブル m2m_sp_public_widget_allow_table に示されているように、インシデントテーブルが簡易リストウィジェットにアクセスできることを確認したものです。

    options.table = "incident";
    //$sp,options,input - which are available by default in any widget script
    new global.SPWidgetAccessControl().hasPublicAccess(options.table, $sp, options, input);

    出力:

    true