4.2.7　サービスおよび部品の入力プロパティに設定する値の動的な変更について

(a)　タイプに「Javascript」を指定した場合

Javascriptを定義する必要があります。デフォルトでは次の関数が定義されています。

{"data":[
　オブジェクト1,
　オブジェクト2,
　・・・
]}

注※1

次に示す共有プロパティは使用することができません。

com.hitachi.software.dna.sys.cm.cache.interval

注※2

予約プロパティについては，「表3‒13　予約プロパティ一覧」を参照してください。

• Javascriptのライブラリ（auto_utilライブラリ）

  Javascript内ではauto_utilライブラリを使用できます。auto_utilライブラリは主に次の機能を持ちます。

  • 任意の接続先にhttp（s）のリクエストを送る。

  • 接続情報としてWebサービス接続先定義の設定値を参照する。

  auto_utilライブラリのAPIは次の通りです。

  表4‒14　auto_utilライブラリのAPI詳細

  メソッド名	引数		戻り値	説明
  sleep	1	数値型でスリープする時間を指定する（単位：ミリ秒）	なし	指定した時間スリープする。
  parseJson	1	文字列型でJSONの文字列表現を指定する	JSONオブジェクト	文字列をJSONオブジェクトに変換する。
  stringifyJson	1	任意のJSONオブジェクトを指定する	JSONの文字列表現	JSONオブジェクトを文字列に変換する。
  base64.encode	1	BASE64に変換する文字列を指定する	BASE64にエンコードした文字列	BASE64にエンコードする。
  base64.decode	1	BASE64文字列を指定する	BASE64からデコードした文字列	BASE64からデコードする。
  http.call	1	リクエストのJSONオブジェクト	レスポンスのJSONオブジェクト	http（s）のリクエストを行い，レスポンスを返す。
  http.toRawHeader	1	ヘッダのJSONオブジェクト	ヘッダ文字列	ヘッダを文字列の形にして返す。引数にはkeyとそれに対するvalueが設定されたJSONオブジェクトを指定する。
  http.defaultErrorHandler	1	エラー	なし	HttpErrorインスタンスをスローする。
  	2	リクエストのJSONオブジェクト
  	3	レスポンスのJSONオブジェクト
  http.handleCall	1	httpCallメソッド	なし	第一引数のhttpCallメソッドを第二引数のリクエストを指定して呼び出す。 結果のレスポンスがレスポンスコード200以上400未満の場合は，第三引数を呼び出し，それ以外のレスポンスコードの場合は第四引数を呼び出す。
  	2	リクエストのJSONオブジェクト
  	3	http呼び出しが成功した場合に呼び出すメソッド
  	4	http呼び出しの結果ステータスコードが200以上400未満の場合に呼び出すメソッド
  	5	http呼び出しの前にエラーが発生した場合に呼び出すメソッド

  引数，および，戻り値のJSONオブジェクトは次の通りです。

  表4‒15　リクエストのJSONオブジェクト詳細

  メンバ	型	説明
  requestUrl	String	【Webサービス接続先定義を使用しない場合】 http（s）から始まるリクエストURLを指定する。 【Webサービス接続先定義を使用する場合】 リクエストURLのホスト名より後の"/"から最後までの部分を指定する。 例：http://host:port/Folder/ の場合は"/Folder"を指定する。
  requestMethod	String	HTTPリクエストメソッド。文字列で次の値を指定する。 GET POST PUT DELETE
  requestHeaders	String	リクエストヘッダ。 http.toRawHeaderメソッドの戻り値を設定することを想定。 【Webサービス接続先定義を使用する場合】 次の値をユーザーIDとパスワードの埋め文字として使用することができる。 ${connection.username} ${connection.password}
  requestBody	String	リクエストボディ
  authScheme	String	認証が必要な場合，次の値のいずれかを指定する。 basic digest negotiate
  productName	String	Webサービス接続先定義のカテゴリを指定する。 Webサービス接続先定義を使用する場合は必ず指定する。
  connectionName	String	Webサービス接続先定義の名前を指定する。 Webサービス接続先定義を使用する場合は必ず指定する。
  userName	String	接続先に認証する場合のユーザー名を指定する。 Webサービス接続先定義を使用する場合は指定しない。
  password	String	接続先に認証する場合のパスワードを指定する。
  useProxy	boolean	プロキシを使用するかどうかを指定する（true/false）。
  proxyHost	String	プロキシサーバのホスト名またはIPアドレスを指定する。
  proxyPort	int	プロキシサーバのポート番号を指定する。
  proxyAuthScheme	String	プロキシサーバで認証が必要な場合，次の値のいずれかを指定する。 basic digest
  proxyUserName	String	プロキシサーバで認証が必要な場合のユーザー名を指定する。
  proxyPassword	String	プロキシサーバで認証が必要な場合のパスワードを指定する。

  表4‒16　レスポンスのJSONオブジェクト詳細

  メンバ	型	説明
  responseHeaders	String	レスポンスヘッダ
  responseStatusCode	int	レスポンスコード
  responseStatusMessage	String	レスポンスメッセージ
  responseBody	String	レスポンスボディ

• Javascriptのサンプル

  次のサンプルでは，Webサービス接続先定義の接続情報を参照し，JP1/AOからサービステンプレート一覧を取得します。なお，サンプルでは，カテゴリが"Automation"，名前が"view"のWebサービス接続先定義が登録済みである必要があります。

  function fn (requestPath, queryParamMap, properties) {
    return getServiceTemplates('Automation', 'view');
  
    function getServiceTemplates(productname, connectionname) {
      var respBody = null;
      var request = {
        requestMethod: 'GET',
        requestUrl: '/Automation/v1/objects/ServiceTemplates/',
        requestHeaders:auto.util.http.toRawHeader({
          'Accept': 'application/json',
          'Accept-Language': 'en',
          'Content-Type': 'application/json',
        }),
        authScheme: 'basic',
        connectionName: connectionname,
        productName: productname,
      };
  
      auto.util.http.handleCall(auto.util.http.call, request, 
        function(resp, req) {
          respBody = resp.responseBody;
        }, function(resp, req) {
          auto.util.http.defaultErrorHandler(null, req, resp);
        }, function(err, req) {
          auto.util.http.defaultErrorHandler(err, req);
        });
      return respBody;
      }
  }
  

(b)　タイプに「スクリプト」を指定した場合

タイプに「スクリプト」を指定した場合は，次の設定項目を指定してください。

{"data":[
　オブジェクト1,
　オブジェクト2,
　・・・
]}

スクリプトにおいて，「os.environ[“キー名”]」または「os.environ.get(“キー名”)」の形式で，次の環境変数の値を取得できます。

（凡例）

〇：指定あり　－：指定なし

(c)　タイプに「コマンドライン」を指定した場合

次の設定項目を指定してください。

(d)　タイプに「ファイル」を指定した場合

次の設定項目を指定してください。