JP1 Version 10　JP1/Automatic Operation 画面・コマンド・APIリファレンス

文法・操作書

3021-3-088-20

前書き

対象製品

P-242C-E1A4 JP1/Automatic Operation 10-54（適用OS：Windows Server 2008 R2，Windows Server 2012，Windows Server 2012 R2）

製品構成一覧および内訳形名

・P-242C-EAA4 JP1/Automatic Operation - Server 10-52（適用OS：Windows Server 2008 R2，Windows Server 2012，Windows Server 2012 R2）

・P-242C-EBA4 JP1/Automatic Operation - Contents 10-54（適用OS：Windows Server 2008 R2，Windows Server 2012，Windows Server 2012 R2）

P-F242C-E1A41 JP1/Automatic Operation コンテンツセット 10-54（適用OS：Windows Server 2008 R2，Windows Server 2012，Windows Server 2012 R2）

P-822C-E1A1 JP1/Automatic Operation 10-54（適用OS：Linux 5 (AMD/Intel 64)，Linux 5 Advanced Platform (AMD/Intel 64)，Linux 6 (x64)）

製品構成一覧および内訳形名

・P-CC822C-EAA1 JP1/Automatic Operation - Server 10-52（適用OS：Linux 5 (AMD/Intel 64)，Linux 5 Advanced Platform (AMD/Intel 64)，Linux 6 (x64)）

・P-CC822C-EBA1 JP1/Automatic Operation - Contents 10-54（適用OS：Linux 5 (AMD/Intel 64)，Linux 5 Advanced Platform (AMD/Intel 64)，Linux 6 (x64)）

P-F822C-E1A11 JP1/Automatic Operation コンテンツセット 10-54（適用OS：Linux 5 (AMD/Intel 64)，Linux 5 Advanced Platform (AMD/Intel 64)，Linux 6 (x64)）

輸出時の注意

本製品を輸出される場合には、外国為替及び外国貿易法の規制並びに米国輸出管理規則など外国の輸出関連法規をご確認の上、必要な手続きをお取りください。

なお、不明な場合は、弊社担当営業にお問い合わせください。

商標類

HITACHI，HiRDB，JP1は，（株）日立製作所の商標または登録商標です。

Active Directoryは，米国Microsoft Corporationの，米国およびその他の国における登録商標または商標です。

Amazon EC2は，米国その他の諸国における，Amazon.com, Inc.またはその関連会社の商標です。

Amazon Web Servicesは，米国その他の諸国における，Amazon.com, Inc.またはその関連会社の商標です。

IBM，AIXは，世界の多くの国で登録されたInternational Business Machines Corporationの商標です。

Intelは，アメリカ合衆国およびその他の国におけるIntel Corporationの商標です。

Internet Explorerは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。

Itaniumは，アメリカ合衆国およびその他の国におけるIntel Corporationの商標です。

Linuxは，Linus Torvalds氏の日本およびその他の国における登録商標または商標です。

MicrosoftおよびHyper-Vは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。

Microsoft .NET は，お客様，情報，システムおよびデバイスを繋ぐソフトウェアです。

Netscapeは，AOL Inc.の登録商標です。

OpenStack(R)の文字表記とOpenStackのロゴは，米国とその他の国におけるOpenStack Foundationの登録商標/サービスマークまたは商標/サービスマークのいずれかであり，OpenStack Foundationの許諾を得て使用しています。日立製作所は，OpenStack FoundationやOpenStackコミュニティの関連企業ではなく，また支援や出資を受けていません。

OracleとJavaは，Oracle Corporation 及びその子会社，関連会社の米国及びその他の国における登録商標です。

Red Hatは，米国およびその他の国でRed Hat, Inc. の登録商標もしくは商標です。

RSAおよびBSAFEは，米国EMCコーポレーションの米国およびその他の国における商標または登録商標です。

すべてのSPARC商標は，米国SPARC International, Inc. のライセンスを受けて使用している同社の米国およびその他の国における商標または登録商標です。SPARC商標がついた製品は，米国Sun Microsystems, Inc. が開発したアーキテクチャに基づくものです。

SQL Serverは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。

UNIXは，The Open Groupの米国ならびに他の国における登録商標です。

VERITASおよびNetBackupは，Symantec Corporation の米国およびその他の国における商標または登録商標です。

Windowsは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。

Windows PowerShellは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。

Windows Serverは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。

Windows Vistaは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。

その他記載の会社名，製品名は，それぞれの会社の商標もしくは登録商標です。

This product includes software developed by Andy Clark.

This product includes software developed by the Apache Software Foundation (http://www.apache.org/).

This product includes software developed by Ben Laurie for use in the Apache-SSL HTTP server project.

This product includes software developed by Daisuke Okajima and Kohsuke Kawaguchi (http://relaxngcc.sf.net/).

This product includes software developed by IAIK of Graz University of Technology.

This product includes software developed by the Java Apache Project for use in the Apache JServ servlet engine project (http://java.apache.org/).

This product includes software developed by Ralf S. Engelschall <rse@engelschall.com> for use in the mod_ssl project (http://www.modssl.org/).

Portions of this software were developed at the National Center for Supercomputing Applications (NCSA) at the University of Illinois at Urbana-Champaign.

This product includes software developed by the University of California, Berkeley and its contributors.

This software contains code derived from the RSA Data Security Inc. MD5 Message-Digest Algorithm, including various modifications by Spyglass Inc., Carnegie Mellon University, and Bell Communications Research, Inc (Bellcore).

Regular expression support is provided by the PCRE library package, which is open source software, written by Philip Hazel, and copyright by the University of Cambridge, England. The original software is available from ftp://ftp.csx.cam.ac.uk/pub/software/programming/pcre/

本製品は，米国EMC コーポレーションのRSA BSAFE(R)ソフトウェアを搭載しています。

発行

2015年9月 3021-3-088-20

著作権

All Rights Reserved. Copyright (C) 2014, 2015, Hitachi, Ltd.

変更内容

変更内容（3021-3-088-20）JP1/Automatic Operation 10-54，JP1/Automatic Operation コンテンツセット 10-54

追加・変更内容

変更個所

「タスク一覧の取得」および「ステップの一覧取得」で取得できるメンバーを，endTimeからcompletionTimeに変更した。

9.2.14，9.6.1，9.6.2，9.6.12，9.9

単なる誤字・脱字などはお断りなく訂正しました。

はじめに

このマニュアルは，JP1/Automatic Operationの画面，コマンド，およびAPIについて説明したものです。なお，このマニュアルでは，JP1/Automatic OperationをJP1/AOと表記します。

JP1/AOマニュアルの参考情報および用語解説については，マニュアル「JP1/AO 導入・設計ガイド」を参照してください。

対象読者

このマニュアルは，次の方にお読みいただくことを前提に説明しています。

JP1/AOの各画面について知りたい方

JP1/AOの画面を操作する方

JP1/AOのコマンドを利用する方

JP1/AOのAPIを利用する方

マイクロソフト製品の表記について

このマニュアルでは，マイクロソフト製品の名称を次のように表記しています。

表記

製品名

.NET Framework

.NET Framework 3.5

Microsoft(R) .NET Framework 3.5

Active Directory

Microsoft(R) Active Directory

Hyper-V

Microsoft(R) Hyper-V(R)

Internet Explorer

Microsoft Internet Explorer

Microsoft(R) Internet Explorer(R)

Windows Internet Explorer

Windows(R) Internet Explorer(R)

Windows※1

Windows 7

Microsoft(R) Windows(R) 7 Enterprise

Microsoft(R) Windows(R) 7 Professional

Microsoft(R) Windows(R) 7 Ultimate

Windows Server 2003※2

Windows Server 2003※2

Microsoft(R) Windows Server(R) 2003, Enterprise Edition

Microsoft(R) Windows Server(R) 2003, Standard Edition

Windows Server 2003 (x64)

Microsoft(R) Windows Server(R) 2003, Enterprise x64 Edition

Microsoft(R) Windows Server(R) 2003, Standard x64 Edition

Windows Server 2003 R2※3

Windows Server 2003 R2※3

Microsoft(R) Windows Server(R) 2003 R2, Enterprise Edition

Microsoft(R) Windows Server(R) 2003 R2, Standard Edition

Windows Server 2003 R2 (x64)

Microsoft(R) Windows Server(R) 2003 R2, Enterprise x64 Edition

Microsoft(R) Windows Server(R) 2003 R2, Standard x64 Edition

Windows Server 2008

Windows Server 2008 R2

Windows Server 2008 R2 Datacenter

Microsoft(R) Windows Server(R) 2008 R2 Datacenter

Windows Server 2008 R2 Enterprise

Microsoft(R) Windows Server(R) 2008 R2 Enterprise

Windows Server 2008 R2 Standard

Microsoft(R) Windows Server(R) 2008 R2 Standard

Windows Server 2008 x64

Windows Server 2008 Datacenter x64

Microsoft(R) Windows Server(R) 2008 Datacenter x64

Windows Server 2008 Enterprise x64

Microsoft(R) Windows Server(R) 2008 Enterprise x64

Windows Server 2008 Standard x64

Microsoft(R) Windows Server(R) 2008 Standard x64

Windows Server 2008 x86

Windows Server 2008 Datacenter x86

Microsoft(R) Windows Server(R) 2008 Datacenter x86

Windows Server 2008 Enterprise x86

Microsoft(R) Windows Server(R) 2008 Enterprise x86

Windows Server 2008 Standard x86

Microsoft(R) Windows Server(R) 2008 Standard x86

Windows Server 2012

Windows Server 2012 Datacenter

Microsoft(R) Windows Server(R) 2012 Datacenter

Windows Server 2012 Standard

Microsoft(R) Windows Server(R) 2012 Standard

Windows Server 2012 R2

Windows Server 2012 R2 Datacenter

Microsoft(R) Windows Server(R) 2012 R2 Datacenter

Windows Server 2012 R2 Standard

Microsoft(R) Windows Server(R) 2012 R2 Standard

Windows Server Failover Cluster

Microsoft(R) Windows Server(R) Failover Cluster

Windows Vista

Microsoft(R) Windows Vista(R) Business

Microsoft(R) Windows Vista(R) Enterprise

Microsoft(R) Windows Vista(R) Ultimate

Windows XP

Microsoft(R) Windows(R) XP Professional Operating System

注※1

JP1/AOサーバのOSについて説明している場合は，Windows Server 2008 R2，Windows Server 2012およびWindows Server 2012 R2のことを示します。

注※2

Windows Server 2003 (x64)またはWindows Server 2003 R2を併記している場合は，Windows Server 2003 (x64)およびWindows Server 2003 R2は含みません。

注※3

Windows Server 2003 R2 (x64)を併記している場合は，Windows Server 2003 R2 (x64)は含みません。

マニュアルで使用している書式について

このマニュアルで使用する書式について説明します。

説明文で使用する書式

書式

説明

文字列

可変の値を示します。

（例）日付はYYYYMMDDの形式で指定します。

［　］

ウィンドウ，ダイアログボックス，タブ，パネル，メニュー，ボタンなどの画面上の要素名を示します。

［　］−［　］

メニューを連続して選択することを示します。

（例）　［ファイル］−［新規作成］を選択します。

上記の例では，［ファイル］メニュー内の［新規作成］を選択することを示します。

「　」

画面などに入力する文字列を示します。

文法で使用する書式

書式

説明

文字列

可変の値を示します。

（例）日付はYYYYMMDDの形式で指定します。

［　］

この記号で囲まれている項目は任意に指定できます（省略もできます）。

（例）　［A］は「何も指定しない」か「Aを指定する」ことを示します。

｛　｝

この記号で囲まれている複数の項目の中から，必ず1組の項目を選択します。項目の区切りは|で示します。

（例）　｛A|B|C｝は，「A，BまたはCのどれかを指定する」ことを示します。

|

この記号で区切られている項目は，複数項目のうちどれかを指定できます。

（例）　A|B|C は，「A，B，またはC」を示します。

インストール先フォルダの表記

このマニュアルでは，Windows版JP1/AOのデフォルトのインストール先フォルダを次のように表記しています。

JP1/AOのインストール先フォルダ

システムドライブ¥Program Files (x86)¥Hitachi¥JP1AO

共通コンポーネントのインストール先フォルダ

システムドライブ¥Program Files (x86)¥Hitachi¥HiCommand¥Base

なお，Linux版JP1/AOのインストール先フォルダは次のとおりです。

JP1/AO のインストール先フォルダ

/opt/jp1ao/

/var/opt/jp1ao/

共通コンポーネントのインストール先フォルダ

/opt/HiCommand/Base64

1　画面概要

JP1/AOで使用する画面の一覧，画面遷移，および画面操作上の注意事項について説明します。

1.1　画面一覧

JP1/AOには，共通で表示される画面のほか，［サービス］画面，［タスク］画面，［管理］画面，［エディタ］画面の4つの画面があります。それぞれの画面から表示される画面の一覧を次に示します。

表1‒1　JP1/AOの画面一覧（共通）

画面名

説明

参照先

［ログイン］画面

JP1/AOにログインするための画面です。

2.1　［ログイン］画面

メイン画面

サービスを実行したり，タスクの進捗を確認したり，JP1/AOのさまざまな操作をするための画面です。

3.1　メイン画面

［バージョン］ダイアログボックス

JP1/AOのバージョンを確認するための画面です。

3.1.1　［バージョン］ダイアログボックス

［列の表示・非表示設定］ダイアログボックス

一覧で表示する列を選択するための画面です。

3.1.3　［列の表示・非表示設定］ダイアログボックス

［待機中タスク一覧］ダイアログボックス

ユーザーが実行したタスクのうち，待機中タスクの状態を一覧で表示して，確認するための画面です。

3.1.4　［待機中タスク一覧］ダイアログボックス

［応答待ち中タスク一覧］ダイアログボックス

ユーザーが実行したタスクのうち，応答待ち中タスクの状態を一覧で表示して，確認するための画面です。

3.1.5　［応答待ち中タスク一覧］ダイアログボックス

［実行中タスク一覧］ダイアログボックス

ユーザーが実行したタスクのうち，実行中タスクの状態を一覧で表示して，確認するための画面です。

3.1.6　［実行中タスク一覧］ダイアログボックス

［正常終了タスク一覧］ダイアログボックス

ユーザーが実行したタスクのうち，正常終了タスクの状態を一覧で表示して，確認するための画面です。

3.1.7　［正常終了タスク一覧］ダイアログボックス

［失敗タスク一覧］ダイアログボックス

ユーザーが実行したタスクのうち，失敗タスクの状態を一覧で表示して，確認するための画面です。

3.1.8　［失敗タスク一覧］ダイアログボックス

表1‒2　JP1/AOの画面一覧（［サービス］画面）

画面名

説明

参照先

［サービス］画面

JP1/AOに登録されているサービスを確認したり，実行したりするための画面です。

4.1　［サービス］画面

［サービス実行］ダイアログボックス

JP1/AOに登録されているサービスを実行するための画面です。

4.1.1　［サービス実行］ダイアログボックス

［サービス追加］ダイアログボックス

JP1/AOにインポートされているサービステンプレートからサービスを追加し，リソースグループに割り当てるための画面です。

4.1.2　［サービス追加］ダイアログボックス

［サービス設定］ダイアログボックス

サービスのプロパティ情報を設定するための画面です。

4.1.3　［サービス設定］ダイアログボックス

［サービス削除］ダイアログボックス

不要になったサービスを削除するための画面です。

4.1.4　［サービス削除］ダイアログボックス

表1‒3　JP1/AOの画面一覧（［タスク］画面）

画面名

説明

参照先

［タスク］画面

JP1/AOで処理したタスクおよびデバッグタスクの進捗や履歴を確認するための画面です。

5.1　［タスク］画面

［タスク一覧］ビュー

JP1/AOで処理したタスクの情報を確認したり，タスクを停止したりするための画面です。

5.2　［タスク一覧］ビュー

［タスク詳細］ダイアログボックス

入出力プロパティやステップの進捗などを確認するための画面です。

5.2.1　［タスク詳細］ダイアログボックス

［応答入力］ダイアログボックス

実行中のタスクに対して，ユーザー応答を入力する画面です。

5.2.2　［応答入力］ダイアログボックス

［タスクログ］ダイアログボックス

タスクログおよびデバッグタスクのログを参照するための画面です。

5.2.3　［タスクログ］ダイアログボックス

［履歴］ビュー

アーカイブしたタスク（履歴）を確認するための画面です。

5.3　［履歴］ビュー

［履歴削除］ダイアログボックス

不要になった履歴を削除するための画面です。

5.3.1　［履歴削除］ダイアログボックス

［デバッグタスク一覧］ビュー

デバッグタスクの情報を確認したり，デバッグタスクを停止したりするための画面です。

5.4　［デバッグタスク一覧］ビュー

［タスクモニタ］ビュー

タスクおよびデバッグタスクのフローを表示し，フローの進捗やステップの状態などを確認するための画面です。

5.5　［タスクモニタ］ビュー

表1‒4　JP1/AOの画面一覧（［管理］画面）

画面名

説明

参照先

［管理］画面

ユーザー管理やリソースグループ管理などのJP1/AO の設定をするための画面です。

6.1　［管理］画面

［エージェントレス接続先定義］ビュー

エージェントレス接続先に接続する際に使用するエージェントレス接続先定義を確認するための画面です。

6.2　［エージェントレス接続先定義］ビュー

［エージェントレス接続先定義作成］ダイアログボックス

エージェントレス接続先に接続する際に使用するエージェントレス接続先定義を作成するための画面です。

6.2.1　［エージェントレス接続先定義作成］ダイアログボックス

［エージェントレス接続先定義編集］ダイアログボックス

エージェントレス接続先に接続する際に使用するエージェントレス接続先定義を編集するための画面です。

6.2.2　［エージェントレス接続先定義編集］ダイアログボックス

［エージェントレス接続先定義削除］ダイアログボックス

エージェントレス接続先に接続する際に使用するエージェントレス接続先定義を削除するための画面です。

6.2.3　［エージェントレス接続先定義削除］ダイアログボックス

［サービス共有プロパティ］ビュー

JP1/AOに設定されているサービスに共通するプロパティ（サービス共有プロパティ）の設定を確認するための画面です。

6.3　［サービス共有プロパティ］ビュー

［サービス共有プロパティ設定］ダイアログボックス

JP1/AOに設定されているサービス共有プロパティの設定を変更するための画面です。

6.3.1　［サービス共有プロパティ設定］ダイアログボックス

［ユーザー管理］画面

JP1/AOのユーザーのプロファイル，権限，およびJP1/AOと連携するActive Directoryのグループを管理するための画面です。

6.4　［ユーザー管理］画面

［ユーザー一覧］ビュー

ユーザーの一覧を表示し，ユーザーを追加したり，削除したりするための画面です。

6.4.1　［ユーザー一覧］ビュー

［ユーザー追加］ダイアログボックス（ユーザー管理）

JP1/AOにユーザーを追加するための画面です。

6.4.2　［ユーザー追加］ダイアログボックス（ユーザー管理）

［ロック］ダイアログボックス

指定したユーザーをJP1/AO にログインできないようにするための画面です。

6.4.3　［ロック］ダイアログボックス

［ロック解除］ダイアログボックス

指定したユーザーのロックを解除するための画面です。

6.4.4　［ロック解除］ダイアログボックス

［認証方式変更］ダイアログボックス

指定したユーザーの認証方式を変更するための画面です。

6.4.5　［認証方式変更］ダイアログボックス

［ユーザー削除］ダイアログボックス

JP1/AO に追加したユーザーを削除するための画面です。

6.4.6　［ユーザー削除］ダイアログボックス

［プロファイル］ビュー

ユーザーのプロファイルを確認したり，変更したりするための画面です。

6.5　［プロファイル］ビュー

［プロファイル編集］ダイアログボックス

ユーザーのプロファイル情報を変更するための画面です。

6.5.1　［プロファイル編集］ダイアログボックス

［パスワード変更］ダイアログボックス

ユーザーのパスワードを変更するための画面です。

6.5.2　［パスワード変更］ダイアログボックス

［権限変更］ダイアログボックス（［プロファイル］ビューから表示した場合）

ユーザーの権限を変更するための画面です。

6.5.3　［権限変更］ダイアログボックス（［プロファイル］ビューから表示した場合）

［権限］ビュー

権限を管理するための画面です。

6.6　［権限］ビュー

［権限を持つユーザー一覧］ビュー

権限を持つユーザーを確認するための画面です。

6.6.1　［権限を持つユーザー一覧］ビュー

［権限を持つユーザーとグループ一覧］ビュー

権限を持つユーザーとグループを確認するための画面です。

6.6.2　［権限を持つユーザーとグループ一覧］ビュー

［グループ］ビュー

JP1/AOと連携できるActive Directoryのドメインを確認するための画面です。

6.7　［グループ］ビュー

［グループ一覧］ビュー

JP1/AOのユーザーグループとして登録したActive Directoryのグループを管理するための画面です。

6.7.1　［グループ一覧］ビュー

［グループ追加］ダイアログボックス

Active DirectoryのグループをJP1/AOのユーザーグループとして登録するための画面です。

6.7.2　［グループ追加］ダイアログボックス

［グループ削除］ダイアログボックス

JP1/AOのユーザーグループとして登録したActive DirectoryのグループをJP1/AOから削除するための画面です。

6.7.3　［グループ削除］ダイアログボックス

［グループ詳細］ビュー

JP1/AOのユーザーグループとして登録したActive Directoryのグループの詳細を確認するための画面です。

6.7.4　［グループ詳細］ビュー

［権限変更］ダイアログボックス（［グループ詳細］ビューから表示した場合）

JP1/AOのユーザーグループとして登録したActive Directoryのグループの権限を変更するための画面です。

6.7.5　［権限変更］ダイアログボックス（［グループ詳細］ビューから表示した場合）

［ユーザーグループ］ビュー（［ユーザーグループ］タブ）

ユーザーグループを管理するための画面です。

6.8　［ユーザーグループ］ビュー（［ユーザーグループ］タブ）

［ユーザーグループ作成］ダイアログボックス

ユーザーグループを作成して，ユーザーやリソースグループを割り当てるための画面です。

6.8.1　［ユーザーグループ作成］ダイアログボックス

［ユーザー追加］ダイアログボックス （ユーザーグループ）

ユーザーグループにユーザーを追加するための画面です。

6.8.2　［ユーザー追加］ダイアログボックス（ユーザーグループ）

［リソースグループ追加］ダイアログボックス

ユーザーグループにリソースグループを追加するための画面です。

6.8.3　［リソースグループ追加］ダイアログボックス

［ロール編集］ダイアログボックス

リソースグループに割り当てるロールを選択するための画面です。

6.8.4　［ロール編集］ダイアログボックス

［ユーザーグループ編集］ダイアログボックス

選択したユーザーグループを編集して，ユーザーやリソースグループを割り当てるための画面です。

6.8.5　［ユーザーグループ編集］ダイアログボックス

［ユーザーグループ削除］ダイアログボックス

ユーザーグループを削除するための画面です。

6.8.6　［ユーザーグループ削除］ダイアログボックス

［ユーザーグループ］ビュー（［ユーザー］タブ）

ユーザーグループにユーザーを割り当てたり，割り当てたユーザーを確認したりするための画面です。

6.9　［ユーザーグループ］ビュー（［ユーザー］タブ）

［ユーザーグループ割り当て］ダイアログボックス

ユーザーをユーザーグループに割り当てるための画面です。

6.9.1　［ユーザーグループ割り当て］ダイアログボックス

［リソースグループ］ビュー

リソースグループを管理するための画面です。

6.10　［リソースグループ］ビュー

［リソースグループ作成］ダイアログボックス

リソースグループを作成するための画面です。

6.10.1　［リソースグループ作成］ダイアログボックス

［リソースグループ編集］ダイアログボックス

リソースグループの名前や説明を変更するための画面です。

6.10.2　［リソースグループ編集］ダイアログボックス

［リソースグループ削除］ダイアログボックス

リソースグループを削除するための画面です。

6.10.3　［リソースグループ削除］ダイアログボックス

［プロファイル］画面

ユーザーのプロファイル情報を確認するための画面です。

6.11　［プロファイル］画面

表1‒5　JP1/AOの画面一覧（［エディタ］画面）

画面名

説明

参照先

［エディタ］画面

サービステンプレートや部品を開発するための画面です。

7.1　［エディタ］画面

［部品］ビュー

部品を一覧で表示したり，開発したりするための画面です。

7.2　［部品］ビュー

［部品］ビュー（［基本］タブ）

基本部品を使ってサービステンプレートを作成・編集する場合に使用する画面です。

7.2.1　［部品］ビュー（［基本］タブ）

［部品］ビュー（［リリース］タブ）

リリース部品を使ってサービステンプレートを作成・編集する場合に使用する画面です。

7.2.2　［部品］ビュー（［リリース］タブ）

［部品］ビュー（［開発］タブ）

部品を作成したり，作成した部品を使ってサービステンプレートを開発したりする場合に使用する画面です。

7.2.3　［部品］ビュー（［開発］タブ）

［部品複製］ダイアログボックス

部品を複製するための画面です。

7.2.4　［部品複製］ダイアログボックス

［部品作成］ダイアログボックス

部品を新規に作成するための画面です。

7.2.5　［部品作成］ダイアログボックス

［部品編集］ダイアログボックス

部品の定義情報を編集するための画面です。

7.2.6　［部品編集］ダイアログボックス

［部品リソース設定］ダイアログボックス

部品リソースファイルをアップロードしたり，ダウンロードしたりするための画面です。

7.2.7　［部品リソース設定］ダイアログボックス

［部品の入力プロパティ作成］ダイアログボックス

部品に入力プロパティを追加するための画面です。

7.2.8　［部品の入力プロパティ作成］ダイアログボックス

［部品の入力プロパティ編集］ダイアログボックス

部品に定義されている入力プロパティを編集するための画面です。

7.2.9　［部品の入力プロパティ編集］ダイアログボックス

［部品の出力プロパティ作成］ダイアログボックス

部品に出力プロパティを追加するための画面です。

7.2.10　［部品の出力プロパティ作成］ダイアログボックス

［部品の出力プロパティ編集］ダイアログボックス

部品に定義されている出力プロパティを編集するための画面です。

7.2.11　［部品の出力プロパティ編集］ダイアログボックス

［リモートコマンド編集］ダイアログボックス

部品で実行するリモートコマンドを設定するための画面です。

7.2.12　［リモートコマンド編集］ダイアログボックス

［環境変数作成］ダイアログボックス

リモートコマンド実行時に必要な環境変数を作成するための画面です。

7.2.13　［環境変数作成］ダイアログボックス

［環境変数編集］ダイアログボックス

リモートコマンド実行時に必要な環境変数を編集するための画面です。

7.2.14　［環境変数編集］ダイアログボックス

［出力フィルタ編集］ダイアログボックス

出力フィルタを設定するための画面です。

7.2.15　［出力フィルタ編集］ダイアログボックス

［サービステンプレートエディタホーム］ビュー

サービステンプレートを開発するための画面です。

7.3　［サービステンプレートエディタホーム］ビュー

［サービステンプレート作成］ダイアログボックス

サービステンプレートを新規に作成するための画面です。

7.3.1　［サービステンプレート作成］ダイアログボックス

［サービステンプレート一覧］ダイアログボックス

サービステンプレートを一覧で表示し，編集，複製，参照，または削除する対象のサービステンプレートを選択するための画面です。

7.3.2　［サービステンプレート一覧］ダイアログボックス

［サービステンプレート複製］ダイアログボックス

サービステンプレートを複製するための画面です。

7.3.3　［サービステンプレート複製］ダイアログボックス

サービステンプレートエディタ参照ダイアログボックス

サービステンプレートの定義内容を参照するための画面です。

7.3.4　サービステンプレートエディタ参照ダイアログボックス

［サービス定義参照］ダイアログボックス

サービスの定義情報を参照するための画面です。

7.3.5　［サービス定義参照］ダイアログボックス

［サービスの入力プロパティ参照］ダイアログボックス

サービスの入力プロパティを参照するための画面です。

7.3.6　［サービスの入力プロパティ参照］ダイアログボックス

［サービスの出力プロパティ参照］ダイアログボックス

サービスの出力プロパティを参照するための画面です。

7.3.7　［サービスの出力プロパティ参照］ダイアログボックス

［変数参照］ダイアログボックス

サービスの変数を参照するための画面です。

7.3.8　［変数参照］ダイアログボックス

［ステップ参照］ダイアログボックス

サービステンプレートのステップの情報を参照するための画面です。

7.3.9　［ステップ参照］ダイアログボックス

サービステンプレートエディタ編集ビュー

既存のサービステンプレートを編集したり，新規サービステンプレートを作成したりするための画面です。

7.4　サービステンプレートエディタ編集ビュー

［サービスリソース設定］ダイアログボックス

サービスリソースファイルをアップロードしたり，ダウンロードしたりするための画面です。

7.4.1　［サービスリソース設定］ダイアログボックス

［部品バージョン管理］ダイアログボックス（［一括適用］タブ）

ステップとして使用している部品を，最新バージョンのリリース部品に一括で変更するための画面です。

7.4.2　［部品バージョン管理］ダイアログボックス（［一括適用］タブ）

［部品バージョン管理］ダイアログボックス（［個別適用］タブ）

ステップが使用している部品を，個別に任意のバージョンの部品に変更するための画面です。

7.4.3　［部品バージョン管理］ダイアログボックス（［個別適用］タブ）

［ビルド/リリース結果］ダイアログボックス

サービステンプレートのビルドまたはリリースの結果および進捗を確認するための画面です。

7.4.4　［ビルド/リリース結果］ダイアログボックス

［デバッグ実行］ダイアログボックス

サービステンプレートのデバッグを開始するための画面です。

7.4.5　［デバッグ実行］ダイアログボックス

［サービス定義編集］ダイアログボックス

サービスの定義情報を編集するための画面です。

7.4.6　［サービス定義編集］ダイアログボックス

［プロパティグループ作成］ダイアログボックス

プロパティグループを追加するための画面です。

7.4.7　［プロパティグループ作成］ダイアログボックス

［プロパティグループ編集］ダイアログボックス

プロパティグループの定義情報を編集するための画面です。

7.4.8　［プロパティグループ編集］ダイアログボックス

［サービス共有プロパティ選択］ダイアログボックス

サービス共有プロパティをサービスの入力プロパティとして設定するための画面です。

7.4.9　［サービス共有プロパティ選択］ダイアログボックス

［サービスの入力プロパティ作成］ダイアログボックス

サービスの入力プロパティを追加するための画面です。

7.4.10　［サービスの入力プロパティ作成］ダイアログボックス

［サービスの入力プロパティ編集］ダイアログボックス

サービスの入力プロパティを編集するための画面です。

7.4.11　［サービスの入力プロパティ編集］ダイアログボックス

［サービスの出力プロパティ作成］ダイアログボックス

サービスの出力プロパティを追加するための画面です。

7.4.12　［サービスの出力プロパティ作成］ダイアログボックス

［サービスの出力プロパティ編集］ダイアログボックス

サービスの出力プロパティを編集するための画面です。

7.4.13　［サービスの出力プロパティ編集］ダイアログボックス

［変数作成］ダイアログボックス

サービスの変数を作成するための画面です。

7.4.14　［変数作成］ダイアログボックス

［変数編集］ダイアログボックス

サービスの変数を編集するための画面です。

7.4.15　［変数編集］ダイアログボックス

［ステップ作成］ダイアログボックス

サービステンプレートにステップを追加するための画面です。

7.4.16　［ステップ作成］ダイアログボックス

［ステップ編集］ダイアログボックス

サービステンプレートのステップを編集するための画面です。

7.4.17　［ステップ編集］ダイアログボックス

［入力プロパティマッピング］ダイアログボックス

入力プロパティにマッピングパラメータを設定するための画面です。

7.4.18　［入力プロパティマッピング］ダイアログボックス

［出力プロパティマッピング］ダイアログボックス

出力プロパティにマッピングパラメータを設定するための画面です。

7.4.19　［出力プロパティマッピング］ダイアログボックス

［デバッグ］ビュー

デバッグタスクを管理したり，ステップ単位の実行方法を設定するための画面です。

7.5　［デバッグ］ビュー

サービステンプレートデバッグビュー

サービステンプレートをデバッグするための画面です。

7.6　サービステンプレートデバッグビュー

1.2　画面遷移

JP1/AOの画面遷移図を次に示します。

図1‒1　JP1/AOの画面遷移図（メイン画面）

図1‒2　JP1/AOの画面遷移図（管理画面 1/2）

図1‒3　JP1/AOの画面遷移図（管理画面 2/2）

図1‒4　JP1/AOの画面遷移図（エディタ画面　1/3）

図1‒5　JP1/AOの画面遷移図（エディタ画面　2/3）

図1‒6　JP1/AOの画面遷移図（エディタ画面　3/3）

1.3　画面操作上の注意事項

JP1/AOの画面を操作する上での注意事項を次に示します。

Webブラウザーの表示ページをほかのページに切り替えたり，［戻る］ボタン，［進む］ボタン，［更新］ボタンなどを使用したりしないでください。また，JP1/AOの機能以外で表示を拡大または縮小しないでください。これらの操作を行うと動作が不正になる場合があります。問題が発生した場合は，Webブラウザーを再起動してから再度ログインしてください。

JP1/AOの画面で使用する言語は実行するWebブラウザーの言語設定によって決まります。JP1/AOでは，表示言語として日本語だけをサポートしているため，Webブラウザーの表示言語には，日本語（ja）を設定してください。言語の設定をしていない場合，操作画面によっては表示言語が混在するときがあります。

Webブラウザーを終了する場合，ログアウトしてから［閉じる］ボタンで画面を閉じてください。ログイン中に［閉じる］ボタンで画面を閉じると，Webブラウザーが異常終了したり，エラーが発生したりする場合があります。問題が発生した場合は，Webブラウザーを再起動してから再度ログインしてください。

操作画面の表示中にインターネットオプションを操作しないでください。操作した場合は，Webブラウザーを再起動してから再度ログインしてください。

WebブラウザーでAdobe Flash Playerを起動するための設定を有効にしておく必要があります。Adobe Flash Playerを起動するための設定については，Adobe Flash Playerのドキュメントを参照してください。

Webブラウザーのポップアップブロックの設定を有効にしている場合，ポップアップウィンドウを表示する操作をしても画面が表示されないときがあります。このときは，Webブラウザーのポップアップブロックの設定で，許可するサイトにJP1/AOのアドレスを追加することで対処できます。

Internet Explorer 8の場合の操作の例を次に示します。

Internet Explorer 8の［ツール］−［インターネットオプション］メニューを選択します。

［インターネットオプション］画面が表示されます。

［プライバシー］タブを選択し，［設定］ボタンをクリックします。

［ポップアップブロックの設定］画面が表示されます。

［ポップアップブロックの設定］画面の［許可するWebサイトのアドレス］テキストボックスに，JP1/AOサーバのホスト名またはIPアドレスを入力します。

［追加］ボタンをクリックします。

Windows Server 2003およびWindows Server 2008を操作端末として使用する場合，Internet Explorerの「IE ESCの構成（Internet Explorer セキュリティ強化の構成）」が有効となっていると，ローディング中を示すアニメーションが動かないことがあります。

［タスク詳細］ダイアログボックスの［ログダウンロード］ボタンをクリックしてダウンロード先の選択画面を開いたまま，JP1/AOのほかの画面を操作すると，動作が不正になる場合があります。必ずダウンロード先の選択画面を閉じてから，JP1/AOの画面を操作してください。問題が発生した場合は，Webブラウザーを再起動してから再度ログインしてください。

［タスク詳細］ダイアログボックスの［ログダウンロード］ボタンをクリックすると表示されるダイアログボックスのタイトルには，ログイン先のJP1/AOサーバのホスト名またはIPアドレスが表示されます。なお，ダイアログボックスには，操作端末の保存先が表示されます。

Escキーや，Webブラウザーの中止ボタンを押下した場合など，Webブラウザーの動作によっては，動作が不正になる場合があります。問題が発生した場合は，Webブラウザーを再起動してから再度ログインしてください。

環境によっては，JP1/AOの画面の操作中に，Adobe Flash Playerでエラーが発生し，Internet Explorerが異常終了する場合があります。［タスク詳細］ダイアログボックスの［ログダウンロード］ボタンをクリックした場合に発生することがあります。問題が発生した場合は，最新バージョンのAdobe Flash Playerにアップデートし，Internet Explorerを再起動してください。

Webブラウザーの操作画面に入力した文字列はUTF-8に変換されます。

JP1/AOでは外字およびサロゲートペア文字の入力をサポートしていません。これらを使用した場合，操作画面上で文字化けが発生したり，正しい文字として処理されなかったりすることがあります。

Windows Server 2012およびWindows Server 2012 R2を操作端末として使用する場合，Adobe Flash Playerを追加するために，［サーバーマネージャー］−［管理］−［役割と機能の追加］から「デスクトップエクスペリエンス」をインストールしてください。

Internet Explorerで拡張保護モードを設定しているときは，カレントフォルダ以外にタスクログをダウンロードできません。あらかじめ，操作画面を信頼済みのサイトに登録してください。

JP1/AOは，ModernインタフェースのInternet Explorerに対応していません。

JP1/AOにログインした際，「予期しないエラー」のメッセージダイアログが表示されたり，画面が正しく表示されなかったりすることがあります。その場合は，Webブラウザーのインターネット一時ファイルを削除し，Webブラウザーを再起動してから再度ログインしてください。インターネット一時ファイルの削除方法については，使用しているWebブラウザーのドキュメントを参照してください。

ビルトインAdministratorユーザーが，Internet Explorer 11を使用して，新規にダイアログボックスを表示する場合，ダイアログボックスの内容が表示されるウィンドウとは別の空ウィンドウが表示されることがあります。その場合，空ウィンドウは閉じてください。

2　［ログイン］画面

JP1/AOにログインするための画面について説明します。

2.1　［ログイン］画面

［ログイン］画面は，JP1/AOにログインするための画面です。

［ログイン］画面は，次のURLを指定すると表示されます。

JP1/AOサーバとWebブラウザーをhttp接続する場合

http://JP1/AOサーバのホスト名またはIPアドレス:HTTPポート番号/Automation/

JP1/AOサーバとWebブラウザーをhttps接続する場合

https://JP1/AOサーバのホスト名またはIPアドレス:HTTPSポート番号/Automation/

図2‒1　［ログイン］画面

表示項目について説明します。

［ユーザーID］テキストボックス

ログインするユーザーIDを入力します。

［パスワード］テキストボックス

ログインするユーザーのパスワードを入力します。

［OK］ボタン

ユーザーIDとパスワードを入力してクリックすると，JP1/AOにログインして［メイン］画面が表示されます。

［クリア］ボタン

クリックすると，［ユーザーID］テキストボックスと［パスワード］テキストボックスに入力した値が消去されます。

ポイント

JP1/AOサーバとWebブラウザーをhttps接続する場合，SSLサーバ証明書にホスト名を指定しているときはURLにホスト名を，IPアドレスを指定しているときはURLにIPアドレスを指定することをお勧めします。不一致の場合は，警告やエラーが表示されます。

3　メイン画面

JP1/AOを操作するメイン画面について説明します。

3.1　メイン画面

メイン画面を起点として，サービスを実行したり，タスクの進捗を確認したり，JP1/AOのさまざまな操作ができます。

メイン画面は，ログインすると表示されます。

図3‒1　メイン画面

表示項目について説明します。

メニューエリア

メイン画面のメニューやログインユーザーIDが表示されます。

［ファイル］メニュー

クリックすると，次の項目が表示されます。

閉じる

確認ダイアログボックスが表示され，［OK］ボタンをクリックすると，メイン画面が閉じます。

ログアウト

確認ダイアログボックスが表示され，［OK］ボタンをクリックすると，JP1/AOからログアウトされ，［ログイン］画面が表示されます。

［設定］メニュー

クリックすると，次の項目が表示されます。

サービス追加

［サービス追加］ダイアログボックスが表示されます。

［ツール］メニュー

クリックして，［Hitachi Command Suite 製品名］を選択すると，シングルサインオンでHitachi Command Suite 製品を起動できます。このメニューは，Link&Launch機能を有効にしている場合だけ表示されます。

［ヘルプ］メニュー

クリックすると，次の項目が表示されます。

オンラインマニュアル

JP1/AOのマニュアルが表示されます。

バージョン情報

［バージョン］ダイアログボックスが表示されます。

現在のユーザー

ログインユーザーIDが次の場合に応じて表示されます。

JP1ユーザーの場合

JP1ユーザー名がそのまま表示されます。

JP1ユーザー以外の場合

ログインユーザーに設定されているフルネームが表示されます。フルネームが設定されていない場合は，ログイン時に指定したユーザーIDが表示されます。

［ログアウト］ボタン

確認ダイアログボックスが表示され，［OK］ボタンをクリックすると，JP1/AOからログアウトされ，［ログイン］画面が表示されます。

左ペイン

［サービス］画面，［タスク］画面，［管理］画面，［エディタ］画面で，表示される項目が異なります。

［サービス］画面

サービスが登録されているカテゴリがツリー表示されます。

［タスク］画面

タスクが登録されるカテゴリおよび履歴が表示されます。カテゴリには，［サービス］画面と同じカテゴリが表示されます。

［管理］画面

ユーザー管理やエージェントレス接続先定義など，［管理］画面でできるメニューが表示されます。

［エディタ］画面

サービステンプレートの開発に使用する部品の一覧が表示されます。

右ペイン

サービス一覧やユーザー一覧など，左ペインで選択したメニューの一覧が表示されます。一覧の上部にはフィルタエリアが表示され，設定した条件で一覧の絞り込みができます。

タスクサマリー

ログインユーザーが実行したタスクの状態や件数がサマリー表示されます。

待機中

［待機中タスク一覧］ダイアログボックスが表示されます。

応答待ち中

［応答待ち中タスク一覧］ダイアログボックスが表示されます。

実行中

［実行中タスク一覧］ダイアログボックスが表示されます。

正常終了

［正常終了タスク一覧］ダイアログボックスが表示されます。

失敗

［失敗タスク一覧］ダイアログボックスが表示されます。

3.1.1　［バージョン］ダイアログボックス

［バージョン］ダイアログボックスは，JP1/AOのバージョンを確認するための画面です。

［バージョン］ダイアログボックスは，［ヘルプ］メニューから［バージョン情報］を選択すると表示されます。

図3‒2　［バージョン］ダイアログボックス（JP1/AOのバージョンが10-00の場合）

3.1.2　フィルタエリア

フィルタエリアは，一覧の絞り込みをしたり，表示する列を設定したりするためのエリアです。

フィルタエリアは，［サービス］画面，［タスク］画面，［管理］画面，および各画面から表示されるビューならびにダイアログボックスの右ペイン上部に表示されます。なお，フィルタエリアの設定内容は保存され，次回ログイン時にも適用されます。

図3‒3　フィルタエリア

表示項目について説明します。

［フィルタ］

クリックすると，条件設定エリアが表示されます。

条件設定エリア

条件を設定して［適用］ボタンをクリックすると，一覧が条件に従って絞り込み表示されます。

図3‒4　条件設定エリア

［属性］リストボックス

絞り込み条件を設定する列を指定します。

［値］テキストボックス

絞り込み条件の値を指定します。

［−］ボタン

クリックすると，指定した条件設定列が削除されます。

［＋］ボタン

クリックすると，条件設定列が追加され，複数の条件を指定できるようになります。

合致条件リストボックス

複数の条件を設定した場合，すべてに合致するか，どれかに合致するかを選択します。

［適用］ボタン

クリックすると，一覧が条件に従って絞り込み表示されます。

［元に戻す］ボタン

クリックすると，現在の一覧で設定されている絞り込み条件が表示されます。

［消去］ボタン

クリックすると，設定した条件が削除されます。

［オン］ラジオボタン

選択すると，設定した条件が一覧に反映されます。

［オフ］ラジオボタン

選択すると，設定した条件が解除されます。

［すべて選択］ボタン

クリックすると，一覧に表示されている項目がすべて選択されます。

［列の表示・非表示］ボタン

クリックすると，［列の表示・非表示設定］ダイアログボックスが表示されます。

［1ページの行数］リストボックス

一覧で1ページに表示する行数を選択します。行数は「30」「50」「100」「250」または「500」から選択できます。

［ページ］テキストボックス

表示するページ数を指定します。

3.1.3　［列の表示・非表示設定］ダイアログボックス

［列の表示・非表示設定］ダイアログボックスは，一覧で表示する列を選択するための画面です。

［列の表示・非表示設定］ダイアログボックスは，フィルタエリアで［列の表示・非表示］ボタンをクリックすると表示されます。

図3‒5　［列の表示・非表示設定］ダイアログボックス

表示項目について説明します。

［設定の初期化］ボタン

クリックすると，表示・非表示設定がJP1/AOのデフォルトに設定されます。各画面の表示・非表示のデフォルトについては，各画面の初期表示の説明を参照してください。

列の表示・非表示設定

表示・非表示チェックボックスで一覧の表示項目を選択できます。表示項目のタイトルをクリックすると，昇順，または降順でソートできます。カラムをドラッグして表示項目を並び替えることもできます。

表3‒1　列の表示・非表示設定一覧の表示項目（［列の表示・非表示設定］ダイアログボックス）

表示項目

説明

表示・非表示チェックボックス

チェックすると，一覧に選択した列が表示されます。

列名

列の名前が表示されます。

説明

列の説明が表示されます。

［OK］ボタン

クリックすると，列の表示・非表示が設定されます。

［キャンセル］ボタン

クリックすると，［列の表示・非表示設定］ダイアログボックスが閉じます。

3.1.4　［待機中タスク一覧］ダイアログボックス

［待機中タスク一覧］ダイアログボックスは，ユーザーが実行したタスクのうち，待機中タスクを一覧で表示して，確認するための画面です。なお，デバッグタスクはこの画面に表示されません。

［待機中タスク一覧］ダイアログボックスは，タスクサマリーで［待機中］を選択すると表示されます。

図3‒6　［待機中タスク一覧］ダイアログボックス

表示項目について説明します。

待機中タスク一覧

待機中タスクの情報が表示されます。表示項目のタイトルをクリックすると，昇順，または降順でソートできます。表示項目は，［列の表示・非表示設定］ダイアログボックスで選択できます。

表3‒2　待機中タスク一覧の表示項目（［待機中タスク一覧］ダイアログボックス）

表示項目

初期表示

説明

タスク名

○　

タスク名が表示されます。［タスク名］をクリックすると，［タスク詳細］ダイアログボックスが表示されます。

状態

○　

タスクの現在の状態が表示されます。

開始予定日時

×　

タスクの開始予定日時が表示されます。

開始日時

×　

タスクの開始日時が表示されます。

終了日時

×　

タスクの終了日時が表示されます。

タスク種別

○　

タスクの種別が表示されます。即時実行タスク，指定日時実行タスク，または定期実行タスクが表示されます。

タスクID

×　

タスクIDが表示されます。

タスクの説明

○　

タスクの説明が表示されます。

サービス名

×　

タスクを生成したサービス名が表示されます。

リソースグループ

×　

タスクが登録されているリソースグループが表示されます。

サービスカテゴリ

○　

タスクを生成したサービスのカテゴリ名が表示されます。

実行者

○　

タスクを生成したサービスの実行者が表示されます。

実行操作日時

×　

サービスを実行する操作をした日時が表示されます。

定期実行周期

×　

定期実行の周期が表示されます。

定期実行時刻

×　

定期実行の時刻が表示されます。

定期実行適用開始日

×　

定期実行の開始日が表示されます。

構成種別

×　

サービステンプレートの構成種別が表示されます。

（凡例）

○：表示されます。　×：表示されません。

［タスク詳細表示］ボタン

タスクを選択してクリックすると，［タスク詳細］ダイアログボックスが表示されます。

［その他の操作］メニュー

タスクを選択してクリックすると，次の項目が表示されます。タスクは複数選択できます。

スケジュール一時停止

クリックすると，［スケジュール一時停止］ダイアログボックスが表示されます。

スケジュール再開

クリックすると，［スケジュール再開］ダイアログボックスが表示されます。

スケジュールキャンセル

クリックすると，［スケジュールキャンセル］ダイアログボックスが表示されます。

［閉じる］ボタン

クリックすると，［待機中タスク一覧］ダイアログボックスが閉じます。

3.1.5　［応答待ち中タスク一覧］ダイアログボックス

［応答待ち中タスク一覧］ダイアログボックスは，ユーザーが実行したタスクのうち，応答待ち中タスクを一覧で表示して，確認するための画面です。なお，デバッグタスクはこの画面に表示されません。

［応答待ち中タスク一覧］ダイアログボックスは，タスクサマリーで［応答待ち中］を選択すると表示されます。

図3‒7　［応答待ち中タスク一覧］ダイアログボックス

表示項目について説明します。

応答待ち中タスク一覧

応答待ち中タスクの情報が表示されます。表示項目のタイトルをクリックすると，昇順，または降順でソートできます。表示項目は，［列の表示・非表示設定］ダイアログボックスで選択できます。

表3‒3　応答待ち中タスク一覧の表示項目（［応答待ち中タスク一覧］ダイアログボックス）

表示項目

初期表示

説明

タスク名

○　

タスク名が表示されます。［タスク名］をクリックすると，［タスク詳細］ダイアログボックスが表示されます。

状態

○　

タスクの現在の状態が表示されます。

開始予定日時

×　

タスクの開始予定日時が表示されます。

開始日時

○　

タスクの開始日時が表示されます。

終了日時

×　

タスクの終了日時が表示されます。

タスク種別

○　

タスクの種別が表示されます。即時実行タスク，指定日時実行タスク，または定期実行タスクが表示されます。

タスクID

×　

タスクIDが表示されます。

タスクの説明

○　

タスクの説明が表示されます。

サービス名

×　

タスクを生成したサービス名が表示されます。

リソースグループ

×　

タスクが登録されているリソースグループが表示されます。

サービスカテゴリ

○　

タスクを生成したサービスのカテゴリ名が表示されます。

実行者

○　

タスクを生成したサービスの実行者が表示されます。

実行操作日時

×　

サービスを実行する操作をした日時が表示されます。

定期実行周期

×　

定期実行の周期が表示されます。

定期実行時刻

×　

定期実行の時刻が表示されます。

定期実行適用開始日

×　

定期実行の開始日が表示されます。

構成種別

×　

サービステンプレートの構成種別が表示されます。

（凡例）

○：表示されます。　×：表示されません。

［タスクログ参照］ボタン

タスクを選択してクリックすると，［タスクログ］ダイアログボックスが表示されます。

［応答入力］ボタン

クリックすると，［応答入力］ダイアログボックスが表示されます。タスク内で応答待ち中のステップが複数ある場合は，応答待ち中になったステップの順番に従い，［応答入力］ダイアログボックスが表示されます。

［タスク詳細表示］ボタン

タスクを選択してクリックすると，［タスク詳細］ダイアログボックスが表示されます。

［その他の操作］メニュー

タスクを選択してクリックすると，次の項目が表示されます。タスクは複数選択できます。

実行停止

クリックすると，［実行停止］ダイアログボックスが表示されます。

強制停止

クリックすると，［強制停止］ダイアログボックスが表示されます。

［閉じる］ボタン

クリックすると，［応答待ち中タスク一覧］ダイアログボックスが閉じます。

3.1.6　［実行中タスク一覧］ダイアログボックス

［実行中タスク一覧］ダイアログボックスは，ユーザーが実行したタスクのうち，実行中タスクを一覧で表示して，確認するための画面です。なお，デバッグタスクはこの画面に表示されません。

［実行中タスク一覧］ダイアログボックスは，タスクサマリーで［実行中］を選択すると表示されます。

図3‒8　［実行中タスク一覧］ダイアログボックス

表示項目について説明します。

実行中タスク一覧

実行中タスクの情報が表示されます。表示項目のタイトルをクリックすると，昇順，または降順でソートできます。表示項目は，［列の表示・非表示設定］ダイアログボックスで選択できます。

表3‒4　実行中タスク一覧の表示項目（［実行中タスク一覧］ダイアログボックス）

表示項目

初期表示

説明

タスク名

○　

タスク名が表示されます。［タスク名］をクリックすると，［タスク詳細］ダイアログボックスが表示されます。

状態

○　

タスクの現在の状態が表示されます。

開始予定日時

×　

タスクの開始予定日時が表示されます。

開始日時

○　

タスクの開始日時が表示されます。

終了日時

×　

タスクの終了日時が表示されます。

タスク種別

○　

タスクの種別が表示されます。即時実行タスク，指定日時実行タスク，または定期実行タスクが表示されます。

タスクID

×　

タスクIDが表示されます。

タスクの説明

○　

タスクの説明が表示されます。

サービス名

×　

タスクを生成したサービス名が表示されます。

リソースグループ

×　

タスクが登録されているリソースグループが表示されます。

サービスカテゴリ

○　

タスクを生成したサービスのカテゴリ名が表示されます。

実行者

○　

タスクを生成したサービスの実行者が表示されます。

実行操作日時

×　

サービスを実行する操作をした日時が表示されます。

定期実行周期

×　

定期実行の周期が表示されます。

定期実行時刻

×　

定期実行の時刻が表示されます。

定期実行適用開始日

×　

定期実行の開始日が表示されます。

構成種別

×　

サービステンプレートの構成種別が表示されます。

（凡例）

○：表示されます。　×：表示されません。

［タスクログ参照］ボタン

タスクを選択してクリックすると，［タスクログ］ダイアログボックスが表示されます。

［タスク詳細表示］ボタン

タスクを選択してクリックすると，［タスク詳細］ダイアログボックスが表示されます。

［その他の操作］メニュー

タスクを選択してクリックすると，次の項目が表示されます。タスクは複数選択できます。

実行停止

クリックすると，［実行停止］ダイアログボックスが表示されます。

強制停止

クリックすると，［強制停止］ダイアログボックスが表示されます。

［閉じる］ボタン

クリックすると，［実行中タスク一覧］ダイアログボックスが閉じます。

3.1.7　［正常終了タスク一覧］ダイアログボックス

［正常終了タスク一覧］ダイアログボックスは，ユーザーが実行したタスクのうち，正常終了したタスクを一覧で表示して，確認するための画面です。なお，デバッグタスクはこの画面に表示されません。

［正常終了タスク一覧］ダイアログボックスは，タスクサマリーで［正常終了］を選択すると表示されます。

図3‒9　［正常終了タスク一覧］ダイアログボックス

表示項目について説明します。

正常終了したタスク一覧

正常終了したタスクの情報が表示されます。表示項目のタイトルをクリックすると，昇順，または降順でソートできます。表示項目は，［列の表示・非表示設定］ダイアログボックスで選択できます。

表3‒5　正常終了したタスク一覧の表示項目（［正常終了タスク一覧］ダイアログボックス）

表示項目

初期表示

説明

タスク名

○　

タスク名が表示されます。［タスク名］をクリックすると，［タスク詳細］ダイアログボックスが表示されます。

状態

○　

タスクの現在の状態が表示されます。

開始予定日時

×　

タスクの開始予定日時が表示されます。

開始日時

○　

タスクの開始日時が表示されます。

終了日時

○　

タスクの終了日時が表示されます。

タスク種別

○　

タスクの種別が表示されます。即時実行タスク，指定日時実行タスク，または定期実行タスクが表示されます。

タスクID

×　

タスクIDが表示されます。

タスクの説明

○　

タスクの説明が表示されます。

サービス名

×　

タスクを生成したサービス名が表示されます。

リソースグループ

×　

タスクが登録されているリソースグループが表示されます。

サービスカテゴリ

○　

タスクを生成したサービスのカテゴリ名が表示されます。

実行者

○　

タスクを生成したサービスの実行者が表示されます。

実行操作日時

×　

サービスを実行する操作をした日時が表示されます。

定期実行周期

×　

定期実行の周期が表示されます。

定期実行時刻

×　

定期実行の時刻が表示されます。

定期実行適用開始日

×　

定期実行の開始日が表示されます。

構成種別

×　

サービステンプレートの構成種別が表示されます。

（凡例）

○：表示されます。　×：表示されません。

［タスクログ参照］ボタン

タスクを選択してクリックすると，［タスクログ］ダイアログボックスが表示されます。

［タスク詳細表示］ボタン

タスクを選択してクリックすると，［タスク詳細］ダイアログボックスが表示されます。

［その他の操作］メニュー

タスクを選択してクリックすると，次の項目が表示されます。タスクは複数選択できます。

再実行

クリックすると，［サービス実行］ダイアログボックスが表示されます。

タスクアーカイブ

クリックすると，［タスクアーカイブ］ダイアログボックスが表示されます。

［閉じる］ボタン

クリックすると，［正常終了タスク一覧］ダイアログボックスが閉じます。

3.1.8　［失敗タスク一覧］ダイアログボックス

［失敗タスク一覧］ダイアログボックスは，ユーザーが実行したタスクのうち，失敗タスクを一覧で表示して，確認するための画面です。なお，デバッグタスクはこの画面に表示されません。

［失敗タスク一覧］ダイアログボックスは，タスクサマリーで［失敗］を選択すると表示されます。

図3‒10　［失敗タスク一覧］ダイアログボックス

表示項目について説明します。

失敗したタスク一覧

失敗タスクの情報が表示されます。表示項目のタイトルをクリックすると，昇順，または降順でソートできます。表示項目は，［列の表示・非表示設定］ダイアログボックスで選択できます。

表3‒6　失敗したタスク一覧の表示項目（［失敗タスク一覧］ダイアログボックス）

表示項目

初期表示

説明

タスク名

○　

タスク名が表示されます。［タスク名］をクリックすると，［タスク詳細］ダイアログボックスが表示されます。

状態

○　

タスクの現在の状態が表示されます。

開始予定日時

×　

タスクの開始予定日時が表示されます。

開始日時

○　

タスクの開始日時が表示されます。

終了日時

○　

タスクの終了日時が表示されます。

タスク種別

○　

タスクの種別が表示されます。即時実行タスク，指定日時実行タスク，または定期実行タスクが表示されます。

タスクID

×　

タスクIDが表示されます。

タスクの説明

○　

タスクの説明が表示されます。

サービス名

×　

タスクを生成したサービス名が表示されます。

リソースグループ

×　

タスクが登録されているリソースグループが表示されます。

サービスカテゴリ

○　

タスクを生成したサービスのカテゴリ名が表示されます。

実行者

○　

タスクを生成したサービスの実行者が表示されます。

実行操作日時

×　

サービスを実行する操作をした日時が表示されます。

定期実行周期

×　

定期実行の周期が表示されます。

定期実行時刻

×　

定期実行の時刻が表示されます。

定期実行適用開始日

×　

定期実行の開始日が表示されます。

構成種別

×　

サービステンプレートの構成種別が表示されます。

（凡例）

○：表示されます。　×：表示されません。

［タスクログ参照］ボタン

タスクを選択してクリックすると，［タスクログ］ダイアログボックスが表示されます。

［タスク詳細表示］ボタン

タスクを選択してクリックすると，［タスク詳細］ダイアログボックスが表示されます。

［その他の操作］メニュー

タスクを選択してクリックすると，次の項目が表示されます。タスクは複数選択できます。

再実行

クリックすると，［サービス実行］ダイアログボックスが表示されます。

タスクアーカイブ

クリックすると，［タスクアーカイブ］ダイアログボックスが表示されます。

［閉じる］ボタン

クリックすると，［失敗タスク一覧］ダイアログボックスが閉じます。

4　［サービス］画面

JP1/AOの［サービス］画面について説明します。

4.1　［サービス］画面

［サービス］画面は，JP1/AOに登録されているサービスを確認したり，実行したりするための画面です。

［サービス］画面は，メイン画面で［サービス］タブを選択すると表示されます。

図4‒1　［サービス］画面

表示項目について説明します。

左ペイン

［すべてのサービス］メニュー

サービスが登録されているカテゴリがツリー表示されます。

右ペイン

サービス一覧

左ペインで選択したカテゴリのサービスの情報が一覧で表示されます。表示項目のタイトルをクリックすると，昇順，または降順でソートできます。表示項目は，［列の表示・非表示設定］ダイアログボックスで選択できます。

表4‒1　サービス一覧の表示項目（［サービス］画面）

表示項目

初期表示

説明

サービス名

○　

サービス名が表示されます。［サービス名］をクリックすると［サービス実行］ダイアログボックスが表示されます。

説明

○　

サービスの説明が表示されます。

カテゴリ名

○　

サービスに設定されているカテゴリが表示されます。

リソースグループ

×　

サービスが登録されているリソースグループが表示されます。

サービステンプレート名

×　

サービスの基となったサービステンプレート名が表示されます。

ベンダー名

×　

サービステンプレートを作成したベンダー名が表示されます。

サービスバージョン

×　

サービスの基となったサービステンプレートのバージョンが表示されます。

構成種別

×　

サービステンプレートの構成種別が表示されます。

（凡例）

○：表示されます。　×：表示されません。

［サービス追加］ボタン

クリックすると，［サービス追加］ダイアログボックスが表示されます。

［サービス編集］ボタン

サービスを選択してクリックすると，［サービス設定］ダイアログボックスが表示されます。

［サービス削除］ボタン

サービスを選択してクリックすると，［サービス削除］ダイアログボックスが表示されます。

［実行］ボタン

選択したサービスを実行します。このボタンをクリックすると，［サービス実行］ダイアログボックスが表示されます。

［サービス詳細説明表示］ボタン

クリックすると，選択したサービスの説明が表示されます。

4.1.1　［サービス実行］ダイアログボックス

［サービス実行］ダイアログボックスは，JP1/AOに登録されているサービスを実行するための画面です。

［サービス実行］ダイアログボックスは，［サービス］画面でサービスを選択して［実行］ボタンをクリックするか，または［タスク詳細］ダイアログボックスで［再実行］ボタンをクリックすると表示されます。

図4‒2　［サービス実行］ダイアログボックス

表示項目について説明します。

サービス

サービス名

実行するサービス名が表示されます。

説明

サービスの説明が表示されます。

カテゴリ名

実行するサービスが所属するカテゴリが表示されます。

リソースグループ

実行するサービスが登録されているリソースグループが表示されます。

構成種別

サービスの基となるサービステンプレートの構成種別が表示されます。

タスク

［タスク名］テキストボックス

タスク名を入力します。

128文字まで入力できます。デフォルトは，「サービス名_YYYYMMDDhhmmss」（YYYYMMDDhhmmss：サービスを実行した日付および時刻）となります。

［タスクの説明］テキストボックス

タスクの説明を入力します。256文字まで入力できます。

プロパティ

選択したサービスのプロパティ情報が表示されます。表示項目のタイトルをクリックすると，昇順，または降順でソートできます。プロパティは使用するサービステンプレートによって異なります。

［プロパティグループ］

各プロパティがグループごとに表示されます。サービステンプレートにプロパティグループが設定されていない場合は表示されません。

表4‒2　プロパティ一覧の表示項目（［サービス実行］ダイアログボックス）

表示項目

説明

プロパティ名

プロパティ名が表示されます。

プロパティキー

プロパティのキー名が表示されます。

プロパティ値

サービスを実行するのに必要なプロパティ値を入力します。

説明

プロパティの説明が表示されます。

実行契機

サービスの実行契機を選択します。

［実行契機種別］リストボックス

実行契機種別を選択します。

即時実行

サービスを即時実行する場合に選択します。

指定日時実行

指定日時実行を選択すると，［実行開始日］テキストボックスと［実行開始時刻］スピンボックスが表示されます。

指定した日時にサービスを実行する場合に選択します。

図4‒3　［サービス実行］ダイアログボックス（指定日時実行の場合）

［実行開始日］テキストボックス

［カレンダー］ボタンをクリックし，表示されたカレンダーから日付を選択して，サービスの実行開始日を指定します。

［実行開始時刻］スピンボックス

実行開始時刻（時間および分）を24時間方式で指定します。

定期実行

定期実行を選択すると，［実行開始日］テキストボックス，［定期実行周期種別］リストボックス，［定期実行時刻］スピンボックスが表示されます。

指定した日時から定期的にサービスを実行する場合に選択します。

図4‒4　［サービス実行］ダイアログボックス（定期実行の場合）

［実行開始日］テキストボックス

［カレンダー］ボタンをクリックし，表示されたカレンダーから日付を選択して，サービスの実行開始日を指定します。

［定期実行周期種別］リストボックス

サービスを定期実行する周期を指定します。毎日，毎週，毎月のどれかを選択します。

毎日

指定した実行開始日から毎日指定した時刻にサービスが実行されます。

毎週

選択すると，［定期実行曜日］チェックボックスが表示されます。サービスを実行する曜日を選択します。

［定期実行曜日］チェックボックス

サービスを定期実行する曜日を指定します。曜日は複数選択できます。

毎月

選択すると，［定期実行日］テキストボックスと［月末］チェックボックスが表示されます。

［定期実行日］テキストボックス

サービスを定期実行する日付を入力します。1〜31までの整数を入力できます。実行日は複数指定できます。複数指定する場合は，各日付の間を「,」で区切ってください。例えば，1日と15日に実行する場合は，「1,15」と入力します。

31日など，毎月にはない日付を指定した場合，その月はサービスが実行されません。毎月月末に実行したい場合は，［月末］チェックボックスをチェックしてください。

［月末］チェックボックス

チェックすると，毎月月末にサービスが実行されます。

［定期実行時刻］スピンボックス

サービスの定期実行を開始する時刻（時間および分）を指定します。

［内容確認］ボタン

クリックすると，［内容確認］ダイアログボックスが表示されます。サービスの実行内容を確認してください。［内容確認］ダイアログボックスの［実行］ボタンをクリックすると，サービスが実行されます。

［キャンセル］ボタン

クリックすると，［サービス実行］ダイアログボックスが閉じます。

［サービス詳細説明表示］ボタン

クリックすると，サービスの説明が表示されます。

4.1.2　［サービス追加］ダイアログボックス

［サービス追加］ダイアログボックスは，JP1/AOにインポートされているサービステンプレートからサービスを追加し，リソースグループに割り当てるための画面です。

［サービス追加］ダイアログボックスは，［サービス］画面の［サービス追加］ボタンをクリックすると表示されます。

図4‒5　［サービス追加］ダイアログボックス

表示項目について説明します。

サービステンプレート

JP1/AOにインポートされているサービステンプレートの一覧が表示されます。表示項目のタイトルをクリックすると，昇順，または降順でソートできます。追加するサービスを作成するサービステンプレートを選択します。表示項目は，［列の表示・非表示設定］ダイアログボックスで選択できます。

表4‒3　サービステンプレート一覧の表示項目（［サービス追加］ダイアログボックス）

表示項目

初期表示

説明

サービステンプレート名

○　

サービステンプレート名が表示されます。

説明

○　

サービステンプレートの説明が表示されます。

サービステンプレートバージョン

○　

サービステンプレートのバージョンが表示されます。

カテゴリ名

○　

サービステンプレートのカテゴリ名が表示されます。

ベンダー名

○　

サービステンプレートを作成したベンダー名が表示されます。

構成種別

×　

サービステンプレートの構成種別が表示されます。

（凡例）

○：表示されます。　×：表示されません。

［サービス詳細説明表示］ボタン

クリックすると，サービスの詳細説明が表示されます。

［サービス名］テキストボックス

サービステンプレート一覧で選択したサービステンプレートのサービステンプレート名が入力されます。サービス名は64文字以内で変更できます。

［説明］テキストボックス

サービステンプレート一覧で選択したサービステンプレートの説明が入力されます。説明は256文字以内で変更できます。

［カテゴリ名］テキストボックス

サービステンプレート一覧で選択したサービステンプレートのカテゴリ名が入力されます。カテゴリ名は256文字以内で変更できます。カテゴリを階層化する場合は，「/」で区切って入力します。なお，カテゴリの階層数の上限は10 階層です。複数のカテゴリに設定する場合は，カテゴリとカテゴリの間を「,」で区切って入力します。カテゴリの各階層には値を必ず入力してください。

［サービスのリソースグループ］リストボックス

リソースグループを選択します。ログインユーザーに割り当てられているリソースグループの中で，Modifyロール以上の権限が設定されているリソースグループが表示されます。ただし，ログインユーザーにAll Resourcesが割り当てられていて，Modifyロール以上の権限が設定されている場合は，登録されているすべてのリソースグループが表示されます。

［サービス追加］ボタン

クリックすると，サービスが追加され，［サービス設定］ダイアログボックスが表示されます。サービスは1,000個まで追加できます。

［閉じる］ボタン

クリックすると，［サービス追加］ダイアログボックスが閉じます。

4.1.3　［サービス設定］ダイアログボックス

［サービス設定］ダイアログボックスは，サービスのプロパティ情報を設定するための画面です。

［サービス設定］ダイアログボックスは，［サービス追加］ダイアログボックスで［サービス追加］ボタンをクリックするか，または［サービス］画面でサービスを選択し，［サービス編集］ボタンをクリックすると表示されます。

図4‒6　［サービス設定］ダイアログボックス

表示項目について説明します。

サービス

サービスの追加時に指定したサービス名やカテゴリ名を変更できます。

［サービス名］テキストボックス

サービスの追加時に指定したサービス名が表示されます。サービス名は変更できます。64文字まで入力できます。

［説明］テキストボックス

サービス追加時に指定したサービスの説明が表示されます。説明は変更できます。256文字まで入力できます。

［カテゴリ名］テキストボックス

サービスの追加時に指定したカテゴリ名が表示されます。カテゴリ名は256文字以内で変更できます。カテゴリを階層化する場合は，「/」で区切って入力します。なお，カテゴリの階層数の上限は10 階層です。複数のカテゴリに設定する場合は，カテゴリとカテゴリの間を「,」で区切って入力します。カテゴリの各階層には値を必ず入力してください。

リソースグループ

サービス追加時に指定したリソースグループが表示されます。

構成種別

サービスの基となるサービステンプレートの構成種別が表示されます。

プロパティ

サービスのプロパティ情報の一覧が表示されます。表示項目のタイトルをクリックすると，昇順，または降順でソートできます。必要なプロパティ値を設定します。プロパティは使用するサービステンプレートによって異なります。

［プリセットプロパティ］リストボックス

サービステンプレートに設定したいプリセットプロパティを選択できます。サービステンプレートにプリセットプロパティが設定されていない場合は表示されません。

［反映］ボタン

クリックすると，選択したプリセットプロパティがプロパティ一覧に反映されます。サービステンプレートにプリセットプロパティが設定されていない場合は表示されません。

［プロパティグループ］

クリックすると，プロパティグループに含まれるプロパティ一覧が表示されます。サービステンプレートにプロパティグループが設定されていない場合は表示されません。

表4‒4　プロパティ一覧の表示項目（［サービス設定］ダイアログボックス）

表示項目

説明

プロパティ名

プロパティ名が表示されます。

プロパティキー

プロパティのキー名が表示されます。

プロパティ値

プロパティ値を入力します。

説明

プロパティの説明が表示されます。

スコープ

プロパティのスコープが表示されます。

［OK］ボタン

クリックすると，サービスの設定が変更されます。

［キャンセル］ボタン

クリックすると，必須項目がすべて入力されている場合は，［サービス設定］ダイアログボックスが閉じます。必須項目が入力されていない場合は確認ダイアログボックスが表示され，［OK］ボタンをクリックすると［サービス設定］ダイアログボックスが閉じます。

［サービス詳細説明表示］ボタン

クリックすると，サービスの説明が表示されます。

4.1.4　［サービス削除］ダイアログボックス

［サービス削除］ダイアログボックスは，不要になったサービスを削除するための画面です。

［サービス削除］ダイアログボックスは，［サービス］画面でサービスを選択し，［サービス削除］ボタンをクリックすると表示されます。

図4‒7　［サービス削除］ダイアログボックス

表示項目について説明します。

削除サービス一覧

削除候補のサービスの一覧が表示されます。表示項目のタイトルをクリックすると，昇順，または降順でソートできます。

表4‒5　削除サービス一覧の表示項目（［サービス削除］ダイアログボックス）

表示項目

説明

サービス名

サービス名が表示されます。

説明

サービスの説明が表示されます。

カテゴリ名

カテゴリ名が表示されます。

［OK］ボタン

クリックすると，一覧に表示されたサービスが削除されます。

［キャンセル］ボタン

クリックすると，［サービス削除］ダイアログボックスが閉じます。

5　［タスク］画面

JP1/AOの［タスク］画面について説明します。

5.1　［タスク］画面

［タスク］画面は，JP1/AOで処理したタスクおよびデバッグタスクの進捗や履歴を確認するための画面です。

［タスク］画面は，メイン画面で［タスク］タブを選択すると表示されます。

図5‒1　［タスク］画面

表示項目について説明します。

左ペイン

［すべてのタスク］メニュー

選択したカテゴリのタスクの情報が一覧で表示されます。選択すると，右ペインに［タスク一覧］ビューが表示されます。

［履歴］メニュー

選択すると，右ペインに［履歴］ビューが表示されます。

［デバッグ実行したタスク］メニュー

選択すると，右ペインに［デバッグタスク一覧］ビューが表示されます。

右ペイン

左ペインで選択したメニューに応じた画面が表示されます。

5.2　［タスク一覧］ビュー

［タスク一覧］ビューは，JP1/AOで処理したタスクの情報を確認したり，タスクを停止したりするための画面です。

［タスク一覧］ビューは，［タスク］画面の左ペインでタスクのカテゴリを選択すると表示されます。

図5‒2　［タスク一覧］ビュー

表示項目について説明します。

タスク一覧

左ペインで選択したカテゴリのタスクの情報が一覧で表示されます。表示項目のタイトルをクリックすると，昇順，または降順でソートできます。表示項目は，［列の表示・非表示設定］ダイアログボックスで選択できます。デフォルト設定で，タスクとデバッグタスクは合計5,000件まで管理できます。なお，デバッグタスクは［デバッグタスク一覧］ビューに表示されます。

表5‒1　タスク一覧の表示項目（［タスク一覧］ビュー）

表示項目

初期表示

説明

タスク名

○　

タスク名が表示されます。［タスク名］をクリックすると，［タスク詳細］ダイアログボックスが表示されます。

状態

○　

タスクの現在の状態が表示されます。

開始予定日時

×　

タスクの開始予定日時が表示されます。

開始日時

○　

タスクの開始日時が表示されます。タスクをリトライした場合でも，タスクを最初に開始した日時が表示されたままになります。

終了日時

○　

タスクの終了日時が表示されます。スケジュールキャンセルやリストアをしてキャンセル状態となったタスクの場合，この操作をした時刻が表示されます。タスクをリトライした場合は，リトライが終了した日時が表示されます。

タスク種別

○　

タスクの種別が表示されます。即時実行タスク，指定日時実行タスク，または定期実行タスクが表示されます。

タスクID

×　

タスクIDが表示されます。

タスクの説明

○　

タスクの説明が表示されます。

サービス名

×　

タスクを生成したサービス名が表示されます。

リソースグループ

×　

タスクが登録されているリソースグループが表示されます。

サービスカテゴリ

○　

タスクを生成したサービスのカテゴリ名が表示されます。

実行者

○　

タスクを生成したサービスの実行者が表示されます。

実行操作日時

×　

サービスを実行する操作をした日時が表示されます。

定期実行周期

×　

定期実行の周期が表示されます。

定期実行時刻

×　

定期実行の時刻が表示されます。

定期実行適用開始日

×　

定期実行の開始日が表示されます。

構成種別

×　

サービステンプレートの構成種別が表示されます。

（凡例）

○：表示されます。　×：表示されません。

［タスクログ参照］ボタン

タスク一覧でタスクを選択してクリックすると，［タスクログ］ダイアログボックスが表示されます。

［応答入力］ボタン

応答待ち中タスクを選択してクリックすると，［応答入力］ダイアログボックスが表示されます。タスク内で応答待ち中のステップが複数ある場合は，応答待ち中になったステップの順番に従い，［応答入力］ダイアログボックスが表示されます。

［タスク詳細表示］ボタン

タスク一覧でタスクを選択してクリックすると，選択したタスクの［タスク詳細］ダイアログボックスが表示されます。

［その他の操作］メニュー

タスク一覧でタスクを選択してクリックすると，次の項目が表示されます。タスクは複数選択できます。

スケジュール一時停止

待機中の指定日時実行タスクまたは定期実行タスクを選択してクリックすると，［スケジュール一時停止］ダイアログボックスが表示されます。［スケジュール一時停止］ダイアログボックスで［OK］ボタンをクリックすると，選択したタスクが保留中になります。

スケジュール再開

保留中のタスクを選択してクリックすると，［スケジュール再開］ダイアログボックスが表示されます。［スケジュール再開］ダイアログボックスで［OK］ボタンをクリックすると，選択したタスクが開始予定日時以前の場合は待機中，開始予定日時を過ぎている場合はキャンセルになります。

スケジュールキャンセル

待機中の指定日時実行タスクもしくは定期実行タスク，または保留中のタスクを選択してクリックすると，［スケジュールキャンセル］ダイアログボックスが表示されます。［スケジュールキャンセル］ダイアログボックスで［OK］ボタンをクリックすると，選択したタスクがキャンセルになります。

実行停止

実行中，応答待ち中，または異常検出のタスクを選択してクリックすると，［実行停止］ダイアログボックスが表示されます。［実行停止］ダイアログボックスで［OK］ボタンをクリックすると，選択したタスクが停止中になったあと失敗になります。実行中のステップの処理が完了したあと，タスクが停止されます。

強制停止

実行中，応答待ち中，異常検出，または停止中のタスクを選択してクリックすると，［強制停止］ダイアログボックスが表示されます。［強制停止］ダイアログボックスで［OK］ボタンをクリックすると，選択したタスクが停止中になったあと失敗になります。実行中のステップが直ちに停止されたあと，タスクが停止されます。

再実行

正常終了，失敗，またはキャンセルのタスクを選択してクリックすると，［サービス実行］ダイアログボックスが表示されます。タスクは複数選択できません。［サービス実行］ダイアログボックスで設定を確認し，［内容確認］ボタンをクリックすると，［内容確認］ダイアログボックスが表示されます。［内容確認］ダイアログボックスで，［実行］ボタンをクリックすると，設定した内容でタスクが新しく生成されます。

失敗したステップからリトライ

失敗のタスクを選択してクリックすると，［失敗したステップからリトライ］ダイアログボックスが表示されます。タスクは複数選択できません。［失敗したステップからリトライ］ダイアログボックスで［OK］ボタンをクリックすると，選択したタスクと同一のタスクとしてリトライされます。タスクは待機中になったあと，失敗したステップからリトライされます。

失敗した次のステップからリトライ

失敗のタスクを選択してクリックすると，［失敗した次のステップからリトライ］ダイアログボックスが表示されます。タスクは複数選択できません。［失敗した次のステップからリトライ］ダイアログボックスで［OK］ボタンをクリックすると，選択したタスクと同一のタスクとしてリトライされます。タスクは待機中になったあと，失敗したステップの次のステップからリトライされます。

タスクアーカイブ

正常終了，失敗，またはキャンセルのタスクを選択してクリックすると，［タスクアーカイブ］ダイアログボックスが表示されます。［タスクアーカイブ］ダイアログボックスで［OK］ボタンをクリックすると，選択したタスクがタスク一覧から削除され，履歴一覧に履歴として追加されます。

5.2.1　［タスク詳細］ダイアログボックス

［タスク詳細］ダイアログボックスは，タスクの入出力プロパティやステップの進捗などを確認するための画面です。

［タスク詳細］ダイアログボックスは，次の操作によって表示されます。

［待機中タスク一覧］ダイアログボックスでタスクを選択し［タスク詳細表示］ボタンをクリックする

［応答待ち中タスク一覧］ダイアログボックスでタスクを選択し［タスク詳細表示］ボタンをクリックする

［実行中タスク一覧］ダイアログボックスでタスクを選択し［タスク詳細表示］ボタンをクリックする

［正常終了タスク一覧］ダイアログボックスでタスクを選択し［タスク詳細表示］ボタンをクリックする

［失敗タスク一覧］ダイアログボックスでタスクを選択し［タスク詳細表示］ボタンをクリックする

［タスク一覧］ビューでタスク名をクリックする

［タスク一覧］ビューでタスクを選択し［タスク詳細表示］ボタンをクリックする

［デバッグタスク一覧］ビューでタスク名をクリックする

［デバッグタスク一覧］ビューでタスクを選択し［タスク詳細表示］ボタンをクリックする

図5‒3　［タスク詳細］ダイアログボックス

表示項目について説明します。

タスク情報

タスクの情報が表示されます。

タスク名

タスク名が表示されます。

状態

タスクの現在の状態が表示されます。

開始予定日時

タスクの開始予定日時が表示されます。

開始日時

タスクの開始日時が表示されます。タスクをリトライした場合でも，タスクを最初に開始した日時が表示されたままになります。

終了日時

タスクの終了日時が表示されます。スケジュールキャンセルやリストアをしてキャンセル状態となったタスクの場合，この操作をした時刻が表示されます。タスクをリトライした場合は，リトライが終了した日時が表示されます。

タスク種別

タスクの種別が表示されます。即時実行タスク，指定日時実行タスク，または定期実行タスクが表示されます。

タスクID

タスクIDが表示されます。

タスクの説明

タスクの説明が表示されます。

サービス名

タスクを生成したサービス名が表示されます。

リソースグループ

タスクが登録されているリソースグループが表示されます。

サービスカテゴリ

タスクを生成したサービスのカテゴリ名が表示されます。

実行者

タスクを生成したサービスの実行者が表示されます。

実行操作日時

サービスを実行する操作をした日時が表示されます。

定期実行周期

定期実行の周期が表示されます。

定期実行時刻

定期実行の時刻が表示されます。

定期実行適用開始日

定期実行の開始日が表示されます。

構成種別

サービステンプレートの構成種別が表示されます。

［プロパティ］

クリックすると，タスクの入出力プロパティが表示されます。

入力プロパティ一覧

タスクの入力プロパティ一覧が表示されます。表示項目のタイトルをクリックすると，昇順，または降順でソートできます。

表5‒2　入力プロパティ一覧の表示項目（［タスク詳細］ダイアログボックス）

表示項目

説明

プロパティ名

プロパティ名が表示されます。

プロパティキー

プロパティのキー名が表示されます。

プロパティ値

プロパティ値が表示されます。

説明

プロパティの説明が表示されます。

出力プロパティ一覧

タスクの出力プロパティ一覧が表示されます。表示項目のタイトルをクリックすると，昇順，または降順でソートできます。

表5‒3　出力プロパティ一覧の表示項目（［タスク詳細］ダイアログボックス）

表示項目

説明

プロパティ名

プロパティ名が表示されます。

プロパティキー

プロパティのキー名が表示されます。

プロパティ値

プロパティ値が表示されます。

説明

プロパティの説明が表示されます。

［ステップ詳細］

クリックすると，ステップ情報とステップ一覧が表示されます。

ステップ情報

最上位のフローの情報が表示されます。

進捗

最上位のフローの進捗が表示されます。

ステップ一覧

最上位のフローに定義されているステップの一覧が表示されます。表示項目のタイトルをクリックすると，昇順，または降順でソートできます。

表5‒4　ステップ一覧の表示項目（［タスク詳細］ダイアログボックス）

表示項目

説明

ステップ名

最上位のフローに定義されているステップ名が表示されます。

状態

ステップの状態※1が表示されます。この状態から進捗が割り出されます。

戻り値

ステップの戻り値※2が表示されます。

開始日時

ステップの開始日時がYYYY-MM-DD hh:mm:ss形式で表示されます。

終了日時

ステップの終了日時がYYYY-MM-DD hh:mm:ss形式で表示されます。

説明

ステップの説明が表示されます。

注※1

表示内容をステップの状態からタスク処理エンジンでの状態に変更できます。プロパティファイル（config_user.properties）のキー「task.details.jobnet.status.visible」で設定できます。デフォルトでは，ステップの状態が表示されます。

注※2

ステップの戻り値については，使用している部品によって参照するマニュアルが異なります。

基本部品の場合

マニュアル「JP1/AO サービステンプレートリファレンス」の各基本部品のトピックを参照してください。

コンテンツ部品の場合

戻り値が0〜63の場合については，マニュアル「JP1/AO サービステンプレートリファレンス」の各コンテンツ部品のトピックを参照してください。

戻り値が0〜63以外の場合については，マニュアル「JP1/AO サービステンプレート開発ガイド」−「コンテンツ部品の戻り値について」のトピックを参照してください。

［応答入力］ボタン

タスクの状態が応答待ち中の場合だけ表示されます。ただし，デバッグタスクを選択した場合は，表示されません。クリックすると，［応答入力］ダイアログボックスが表示されます。タスク内で応答待ち中のステップが複数ある場合は，応答待ち中になったステップの順番に従い，［応答入力］ダイアログボックスが表示されます。

［再実行］ボタン

タスクの状態が正常終了，失敗，およびキャンセルの場合に表示されます。ただし，デバッグタスクを選択した場合は，表示されません。クリックすると，元のタスクのプロパティが入力された［サービス実行］ダイアログボックスが表示されます。

［タスクログ参照］ボタン

タスクの状態が待機中，保留中，およびキャンセル以外の場合に表示されます。クリックすると，［タスクログ］ダイアログボックスが表示されます。

［ログダウンロード］ボタン

タスクの状態が待機中，保留中，およびキャンセル以外の場合に表示されます。クリックすると，ダウンロードダイアログボックスが表示され，操作端末などの指定した場所にタスクログをダウンロードできます。タスクログのファイル名は，デフォルトで「task_タスクID_1.log」と表示されます。ファイル名は，変更して保存できます。

関連トピック

マニュアル「JP1/AO 構築ガイド」−「プロパティファイル（config_user.properties）」のトピック

5.2.2　［応答入力］ダイアログボックス

［応答入力］ダイアログボックスは，実行中のタスクに対して，ユーザー応答を入力する画面です。

［応答入力］ダイアログボックスは，次の操作によって表示されます。

［応答待ち中タスク一覧］ダイアログボックスでタスクを選択し［応答入力］ボタンをクリックする

［タスク一覧］ビューで応答待ち中のタスクを選択し［応答入力］ボタンをクリックする

［タスク詳細］ダイアログボックスで［応答入力］ボタンをクリックする

［デバッグ］ビューで，[図データ]（［応答入力］ボタン）をクリックする

図5‒4　［応答入力］ダイアログボックス（仮想サーバのシャットダウンの場合）

表示項目について説明します。

メッセージエリア

ユーザーが応答入力をするために必要な情報がメッセージとして表示されます。

応答ボタンエリア

応答内容ごとに応答ボタンが表示されます。応答ボタンをクリックすると確認メッセージが表示され，［OK］ボタンをクリックすると，入力した内容に従って処理が続行，または停止されます。

5.2.3　［タスクログ］ダイアログボックス

［タスクログ］ダイアログボックスは，タスクログおよびデバッグタスクのログを参照するための画面です。

［タスクログ］ダイアログボックスは，次の操作によって表示されます。

［応答待ち中タスク一覧］ダイアログボックスでタスクを選択し［タスクログ参照］ボタンをクリックする

［実行中タスク一覧］ダイアログボックスでタスクを選択し［タスクログ参照］ボタンをクリックする

［正常終了タスク一覧］ダイアログボックスでタスクを選択し［タスクログ参照］ボタンをクリックする

［失敗タスク一覧］ダイアログボックスでタスクを選択し［タスクログ参照］ボタンをクリックする

［タスク一覧］ビューでタスクを選択し［タスクログ参照］ボタンをクリックする

［デバッグタスク一覧］ビューでタスクを選択し［タスクログ参照］ボタンをクリックする

［タスク詳細］ダイアログボックスで［タスクログ参照］ボタンをクリックする

図5‒5　［タスクログ］ダイアログボックス

表示項目について説明します。

タスクログエリア

選択したタスクのタスクログが表示されます。

ログ表示エリア

タスクログの出力内容が表示されます。表示されるログのサイズについては，プロパティファイル（config_user.properties）のキー「client.monitor.tasklog.maxfilesize」で設定できます。

［自動更新する］チェックボックス

チェックすると，タスクの状態に関わらずログ表示エリアが自動更新されて，タスクログの最終行が表示されます。自動更新の間隔はデフォルトで30秒です。チェックを外すと，ログ表示エリアは自動更新されません。ログ表示エリアの自動更新の間隔については，プロパティファイル（config_user.properties）のキー「client.monitor.tasklog.refresh.interval」で設定できます。

［更新］ボタン

クリックすると，ログ表示エリアの表示が更新されて，タスクログの最終行が表示されます。

［ログダウンロード］ボタン

クリックすると，ダウンロードダイアログボックスが表示され，タスクログをダウンロードできます。タスクログのファイル名は，デフォルトで「task_タスクID_1.log」と表示されます。ファイル名は，変更して保存できます。

関連トピック

マニュアル「JP1/AO 構築ガイド」−「プロパティファイル（config_user.properties）」のトピック

5.3　［履歴］ビュー

［履歴］ビューは，アーカイブしたタスク（履歴）を確認するための画面です。

［履歴］ビューは，［タスク］画面の左ペインで［履歴］メニューを選択すると表示されます。

図5‒6　［履歴］ビュー

表示項目について説明します。

履歴

タスクの履歴の一覧が表示されます。表示項目のタイトルをクリックすると，昇順，または降順でソートできます。表示項目は，［列の表示・非表示設定］ダイアログボックスで選択できます。履歴はデフォルト設定で30,000件まで管理できます。

表5‒5　履歴一覧の表示項目（［履歴］ビュー）

表示項目

初期表示

説明

タスク名

○　

タスク名が表示されます。

状態

○　

タスクの現在の状態が表示されます。

開始予定日時

×　

タスクの開始予定日時が表示されます。

開始日時

○　

タスクの開始日時が表示されます。タスクをリトライした場合でも，タスクを最初に開始した日時が表示されたままになります。

終了日時

○　

タスクの終了日時が表示されます。スケジュールキャンセルやリストアをしてキャンセル状態となったタスクの場合，この操作をした時刻が表示されます。タスクをリトライした場合は，リトライが終了した日時が表示されます。

タスク種別

○　

タスクの種別が表示されます。即時実行タスク，指定日時実行タスク，または定期実行タスクが表示されます。

タスクID

×　

タスクIDが表示されます。

タスクの説明

○　

タスクの説明が表示されます。

サービス名

×　

タスクを生成したサービス名が表示されます。

リソースグループ

×　

タスクが登録されているリソースグループが表示されます。

サービスカテゴリ

○　

タスクを生成したサービスのカテゴリ名が表示されます。

実行者

○　

タスクを生成したサービスの実行者が表示されます。

実行操作日時

×　

サービスを実行する操作をした日時が表示されます。

定期実行周期

×　

定期実行の周期が表示されます。

定期実行時刻

×　

定期実行の時刻が表示されます。

定期実行適用開始日

×　

定期実行の開始日が表示されます。

構成種別

×　

サービステンプレートの構成種別が表示されます。

（凡例）

○：表示されます。　×：表示されません。

［履歴削除］ボタン

履歴を選択してクリックすると，［履歴削除］ダイアログボックスが表示されます。履歴は複数選択できます。

［履歴削除］ダイアログボックスで［OK］ボタンをクリックすると，選択した履歴が削除されます。

5.3.1　［履歴削除］ダイアログボックス

［履歴削除］ダイアログボックスは，不要になった履歴を削除するためのダイアログボックスです。

［履歴削除］ダイアログボックスは，［履歴］ビューで履歴を選択して［履歴削除］ボタンをクリックすると表示されます。

図5‒7　［履歴削除］ダイアログボックス

表示項目について説明します。

削除履歴一覧

削除候補の履歴の一覧が表示されます。表示項目のタイトルをクリックすると，昇順，または降順でソートできます。

表5‒6　削除履歴一覧の表示項目（［履歴削除］ダイアログボックス）

表示項目

説明

タスク名

タスク名が表示されます。

タスクID

タスクIDが表示されます。

タスク種別

タスクの種別が表示されます。即時実行タスク，指定日時実行タスク，または定期実行タスクが表示されます。

状態

タスクの状態が表示されます。

実行者

タスクを生成したサービスの実行者が表示されます。

［OK］ボタン

クリックすると，一覧に表示された履歴が削除されます。

［キャンセル］ボタン

クリックすると，［履歴削除］ダイアログボックスが閉じます。

5.4　［デバッグタスク一覧］ビュー

［デバッグタスク一覧］ビューは，デバッグタスクの情報を確認したり，デバッグタスクを停止したりするための画面です。

［デバッグタスク一覧］ビューは，［タスク］画面の左ペインで［デバッグ実行したタスク］メニューを選択すると表示されます。

図5‒8　［デバッグタスク一覧］ビュー

表示項目について説明します。

デバッグタスク一覧

デバッグタスクの情報が一覧で表示されます。表示項目のタイトルをクリックすると，昇順，または降順でソートできます。表示項目は，［列の表示・非表示設定］ダイアログボックスで選択できます。デフォルト設定で，デバッグタスクとタスクは合計5,000件まで管理できます。なお，タスクは［タスク一覧］ビューに表示されます。

表5‒7　デバッグタスク一覧の表示項目（［デバッグタスク一覧］ビュー）

表示項目

初期表示

説明

タスク名

○　

タスク名が表示されます。

状態

○　

タスクの現在の状態が表示されます。

開始日時

○　

タスクの開始日時が表示されます。タスクをリトライした場合でも，タスクを最初に開始した日時が表示されたままになります。

終了日時

○　

タスクの終了日時が表示されます。タスクをリトライした場合は，リトライが終了した日時が表示されます。

タスクID

×　

タスクIDが表示されます。

タスクの説明

○　

タスクの説明が表示されます。

サービス名

×　

タスクを生成したサービス名が表示されます。

リソースグループ

×　

タスクが登録されているリソースグループが表示されます。

サービスカテゴリ

○　

タスクを生成したサービスのカテゴリ名が表示されます。

実行者

○　

タスクを生成したサービスの実行者が表示されます。

サービステンプレート名

○　

サービスの基となったサービステンプレート名が表示されます。

ベンダー名

○　

サービスの基となったサービステンプレートのベンダー名が表示されます。

サービスバージョン

○　

サービスの基となったサービステンプレートのバージョンが表示されます。

（凡例）

○：表示されます。　×：表示されません。

［タスクログ参照］ボタン

デバッグタスク一覧でタスクを選択してクリックすると，［タスクログ］ダイアログボックスが表示されます。

［タスク詳細表示］ボタン

デバッグタスク一覧でタスクを選択してクリックすると，［タスク詳細］ダイアログボックスが表示されます。

［その他の操作］メニュー

デバッグタスク一覧でタスクを選択してクリックすると，次の項目が表示されます。タスクは複数選択できます。

実行停止

実行中，応答待ち中，または異常検出のタスクを選択してクリックすると，［実行停止］ダイアログボックスが表示されます。［実行停止］ダイアログボックスで［OK］ボタンをクリックすると，選択したタスクが停止中になったあと失敗になります。実行中のステップが完了したあと，タスクが停止されます。

強制停止

実行中，応答待ち中，異常検出，または停止中のタスクを選択してクリックすると，［強制停止］ダイアログボックスが表示されます。［強制停止］ダイアログボックスで［OK］ボタンをクリックすると，選択したタスクが停止中になったあと失敗になります。実行中のステップが直ちに停止されたあと，タスクが停止されます。

タスク削除

タスクを選択してクリックすると，［タスク削除］ダイアログボックスが表示されます。タスクは複数選択できます。［タスク削除］ダイアログボックスで［OK］ボタンをクリックすると，選択したタスクが削除されます。

5.5　［タスクモニタ］ビュー

［タスクモニタ］ビューは，タスクおよびデバッグタスクのフローを表示し，フローの進捗やステップの状態などを確認するための画面です。

［タスクモニタ］ビューは，［タスク］画面の左ペインで［すべてのタスク］メニュー，または［デバッグ実行したタスク］メニューを選択すると表示されます。

図5‒9　［タスクモニタ］ビュー

表示項目について説明します。

タスクモニタ

［タスク一覧］ビュー，または［デバッグタスク一覧］ビューでタスクを選択すると，次の項目が表示されます。タスクが未選択の場合，またはタスクを複数選択した場合は表示されません。

フロービュー

ステップの実行順序が表示されます。ステップアイコンにステップの状態を示すアイコンが表示されます。

階層フロー部品を使用するステップをダブルクリックすると，その配下のフローが表示されます。

繰り返し実行部品を使用するステップをダブルクリックすると，繰り返し実行フローが繰り返す回数分表示されます。繰り返し実行フローは，繰り返し実行部品の実行開始以降（実行中および実行後も含む）のタイミングで表示されます。フロー名は「繰り返しの回次番号_繰り返し実行入力値（reserved.loop.input）」の形式で表示されます。

フローツリービュー

サービステンプレートのフロー名が階層表示されます。フロー名をクリックすると，その配下のフローがフロービューに表示されます。

繰り返し実行部品をクリックすると，繰り返し実行フローが繰り返す回数分フロービューに表示されます。繰り返し実行フローは，繰り返し実行部品の実行開始以降（実行中および実行後も含む）のタイミングで，フローツリーに表示されます。フローツリーには「繰り返しの回次番号_繰り返し実行入力値（reserved.loop.input）」の形式で表示されます。

［表示］リストボックス

フロービューの表示倍率を選択します。倍率は「25％」「50％」「75％」または「100％」から選択できます。

関連トピック

付録A.2(2)　ステップの状態を示すアイコン

6　［管理］画面

JP1/AOの［管理］画面について説明します。

6.1　［管理］画面

［管理］画面は，ユーザー管理やリソースグループ管理などのJP1/AOの設定をするための画面です。

［管理］画面は，メイン画面で［管理］タブを選択すると表示されます。

図6‒1　［管理］画面

表示項目について説明します。

左ペイン

［エージェントレス接続先定義］メニュー

選択すると，右ペインに［エージェントレス接続先定義］ビューが表示されます。

［サービス共有プロパティ］メニュー

選択すると，右ペインに［サービス共有プロパティ］ビューが表示されます。

［ユーザー管理］メニュー

選択すると，［ユーザー管理］画面が表示されます。

［ユーザーグループ］メニュー

選択すると，右ペインに［ユーザーグループ］ビューが表示されます。

［リソースグループ］メニュー

選択すると，右ペインに［リソースグループ］ビューが表示されます。

［プロファイル］メニュー

選択すると，［プロファイル］画面が表示されます。

右ペイン

左ペインで選択したメニューに応じた画面が表示されます。

6.2　［エージェントレス接続先定義］ビュー

［エージェントレス接続先定義］ビューは，エージェントレス接続先に接続する際に使用するエージェントレス接続先定義を確認するための画面です。

［エージェントレス接続先定義］ビューは，［管理］画面の左ペインで［エージェントレス接続先定義］メニューを選択すると表示されます。

図6‒2　［エージェントレス接続先定義］ビュー

表示項目について説明します。

エージェントレス接続先定義

エージェントレス接続の接続先一覧が表示されます。表示項目のタイトルをクリックすると，昇順，または降順でソートできます。表示項目は，［列の表示・非表示設定］ダイアログボックスで選択できます。接続先は，10,000件まで登録できます。

表6‒1　エージェントレス接続先定義一覧の表示項目（［エージェントレス接続先定義］ビュー）

表示項目

初期表示

説明

接続先種別

○　

接続先の種別（ホスト名，IPv4，またはIPv6）が表示されます。

接続先

○　

接続先のホスト名またはIPアドレスが表示されます。

リソースグループ

○　

リソースグループ名が表示されます。

プロトコル

○　

エージェントレス接続先に接続するためのプロトコルが表示されます。

ユーザーID

○　

エージェントレス接続先に接続するためのユーザーIDが表示されます。

（凡例）

○：表示されます。

［エージェントレス接続先定義作成］ボタン

クリックすると，［エージェントレス接続先定義作成］ダイアログボックスが表示されます。

［エージェントレス接続先定義編集］ボタン

接続先を選択してクリックすると，［エージェントレス接続先定義編集］ダイアログボックスが表示されます。

［エージェントレス接続先定義削除］ボタン

接続先を選択してクリックすると，［エージェントレス接続先定義削除］ダイアログボックスが表示されます。接続先は，複数選択できます。

6.2.1　［エージェントレス接続先定義作成］ダイアログボックス

［エージェントレス接続先定義作成］ダイアログボックスは，エージェントレス接続先に接続する際に使用するエージェントレス接続先定義を作成するための画面です。

［エージェントレス接続先定義作成］ダイアログボックスは，［エージェントレス接続先定義］ビューの［エージェントレス接続先定義作成］ボタンをクリックすると表示されます。

図6‒3　［エージェントレス接続先定義作成］ダイアログボックス

表示項目について説明します。

［接続先種別］リストボックス

エージェントレス接続先の種別を選択します。

ホスト名

ホスト名を指定する場合に，選択します。

IPv4

IPv4形式のIPアドレスを指定する場合に，選択します。

IPv6

IPv6形式のIPアドレスを指定する場合に，選択します。

［接続先］テキストボックス

接続先ホストのホスト名またはIPアドレスを入力します。1,024文字まで入力できます。

［サービスのリソースグループ］リストボックス

エージェントレス接続先定義に割り当てるリソースグループを選択します。デフォルトの表示は「All Resources」です。

［認証情報］リストボックス

認証情報を設定するかどうかを指定します。

設定する

認証情報を設定する場合に選択します。

設定しない

認証情報を設定しない場合に選択します。

［プロトコル］ラジオボタン

接続先ホストとの通信に使用するプロトコルとして，WMI，SSH，Telnetのどれかを選択します。［プロトコル］ラジオボタンは，［認証情報］リストボックスで［設定する］を選択した場合に，表示されます。

WMI

WMIで接続する場合に選択します。

SSH

SSHで接続する場合に選択します。

Telnet

Telnetで接続する場合に選択します。

［SSH認証方式］ラジオボタン

接続先ホストとの認証方式として，パスワード認証，公開鍵認証またはキーボードインタラクティブ認証を選択します。［SSH認証方式］ラジオボタンは，［プロトコル］ラジオボタンで［SSH］を選択した場合に表示されます。

パスワード認証

パスワード認証方式で接続する場合に，選択します。

公開鍵認証

公開鍵認証方式で接続する場合に，選択します。

キーボードインタラクティブ認証

キーボードインタラクティブ認証方式で接続する場合に，選択します。

［ユーザーID］テキストボックス

接続先にログインするユーザーIDを指定します。ドメインユーザーの場合は「ドメイン名¥ユーザー名」または「ユーザー名@ドメイン名」の形式で指定します。［ユーザーID］テキストボックスは，［認証情報］リストボックスで［設定する］を選択した場合に，表示されます。

［パスワード］テキストボックス

接続先にログインするユーザーのパスワードを指定します。［パスワード］テキストボックスは，［認証情報］リストボックスで［設定する］を選択している場合に表示されます。ただし，［プロトコル］ラジオボタンで［SSH］を選択し，［SSH認証方式］ラジオボタンで［公開鍵認証］を選択している場合は表示されません。

［スーパーユーザーのパスワード］テキストボックス

接続先のスーパーユーザーのパスワードを指定します。次の場合に指定してください。

汎用コマンド実行部品，ファイル転送部品，またはコンテンツ部品を使用したサービスを実行する場合で，部品の実行ユーザーをroot権限に昇格する設定にしているとき

ターミナルコマンド実行部品を使用したサービスを実行する場合で，部品プロパティ「commandLine」のコマンドの値に予約プロパティ「reserved.terminal.suPassword」を指定しているとき

［スーパーユーザーのパスワード］テキストボックスは，［プロトコル］ラジオボタンで［SSH］または［Telnet］を選択した場合に表示されます。

［OK］ボタン

クリックすると，エージェントレス接続先定義が追加されます。

［キャンセル］ボタン

クリックすると，［エージェントレス接続先定義作成］ダイアログボックスが閉じます。

6.2.2　［エージェントレス接続先定義編集］ダイアログボックス

［エージェントレス接続先定義編集］ダイアログボックスは，エージェントレス接続先に接続する際に使用するエージェントレス接続先定義を編集するための画面です。

［エージェントレス接続先定義編集］ダイアログボックスは，［エージェントレス接続先定義］ビューで接続先を選択し，［エージェントレス接続先定義編集］ボタンをクリックすると表示されます。

図6‒4　［エージェントレス接続先定義編集］ダイアログボックス

表示項目について説明します。

［接続先種別］リストボックス

エージェントレス接続先の種別を選択します。

ホスト名

ホスト名を指定する場合に，選択します。

IPv4

IPv4形式のIPアドレスを指定する場合に，選択します。

IPv6

IPv6形式のIPアドレスを指定する場合に，選択します。

［接続先］テキストボックス

接続先ホストのホスト名またはIPアドレスを入力します。1,024文字まで入力できます。

［サービスのリソースグループ］リストボックス

エージェントレス接続先定義に割り当てるリソースグループを選択します。

［認証情報］リストボックス

認証情報を設定するかどうかを指定します。

設定する

認証情報を設定する場合に選択します。

設定しない

認証情報を設定しない場合に選択します。

［プロトコル］ラジオボタン

接続先ホストとの通信に使用するプロトコルとして，WMI，SSH，Telnetのどれかを選択します。［プロトコル］ラジオボタンは，［認証情報］リストボックスで［設定する］を選択した場合に，表示されます。

WMI

WMIで接続する場合に選択します。

SSH

SSHで接続する場合に選択します。

Telnet

Telnetで接続する場合に選択します。

［SSH認証方式］ラジオボタン

接続先ホストとの認証方式として，パスワード認証，公開鍵認証またはキーボードインタラクティブ認証を選択します。［SSH認証方式］ラジオボタンは，［プロトコル］ラジオボタンで［SSH］を選択した場合に表示されます。

パスワード認証

パスワード認証方式で接続する場合に，選択します。

公開鍵認証

公開鍵認証方式で接続する場合に，選択します。

キーボードインタラクティブ認証

キーボードインタラクティブ認証方式で接続する場合に，選択します。

［ユーザーID］テキストボックス

接続先にログインするユーザーIDを指定します。ドメインユーザーの場合は「ドメイン名¥ユーザー名」または「ユーザー名@ドメイン名」の形式で指定します。［ユーザーID］テキストボックスは，［認証情報］リストボックスで［設定する］を選択した場合に，表示されます。

［パスワード］テキストボックス

接続先にログインするユーザーのパスワードを指定します。［パスワード］テキストボックスは，［認証情報］リストボックスで［設定する］を選択している場合に表示されます。ただし，［プロトコル］ラジオボタンで［SSH］を選択し，［SSH認証方式］ラジオボタンで［公開鍵認証］を選択している場合は表示されません。

［スーパーユーザーのパスワード］テキストボックス

接続先のスーパーユーザーのパスワードを指定します。次の場合に指定してください。

汎用コマンド実行部品，ファイル転送部品，またはコンテンツ部品を使用したサービスを実行する場合で，部品の実行ユーザーをroot権限に昇格する設定にしているとき

ターミナルコマンド実行部品を使用したサービスを実行する場合で，部品プロパティ「commandLine」のコマンドの値に予約プロパティ「reserved.terminal.suPassword」を指定しているとき

［スーパーユーザーのパスワード］テキストボックスは，［プロトコル］ラジオボタンで［SSH］または［Telnet］を選択した場合に表示されます。

［OK］ボタン

クリックすると，変更した内容がエージェントレス接続先定義に反映されます。

［キャンセル］ボタン

クリックすると，［エージェントレス接続先定義編集］ダイアログボックスが閉じます。

6.2.3　［エージェントレス接続先定義削除］ダイアログボックス

［エージェントレス接続先定義削除］ダイアログボックスは，エージェントレス接続先に接続する際に使用するエージェントレス接続先定義を削除するための画面です。

［エージェントレス接続先定義削除］ダイアログボックスは，［エージェントレス接続先定義］ビューで接続先を選択し，［エージェントレス接続先定義削除］ボタンをクリックすると表示されます。

図6‒5　［エージェントレス接続先定義削除］ダイアログボックス

表示項目について説明します。

エージェントレス接続先定義

削除するエージェントレス接続の接続先一覧が表示されます。表示項目のタイトルをクリックすると，昇順，または降順でソートできます。

表6‒2　エージェントレス接続先定義一覧の表示項目（［エージェントレス接続先定義削除］ダイアログボックス）

表示項目

説明

接続先種別

接続先の種別（ホスト名，IPv4，またはIPv6）が表示されます。

接続先

接続先のホスト名またはIPアドレスが表示されます。

リソースグループ

リソースグループ名が表示されます。

プロトコル

接続先のプロトコルが表示されます。

ユーザーID

接続先のユーザーIDが表示されます。

［OK］ボタン

クリックすると，一覧に表示された接続先が削除されます。

［キャンセル］ボタン

クリックすると，［エージェントレス接続先定義削除］ダイアログボックスが閉じます。

6.3　［サービス共有プロパティ］ビュー

［サービス共有プロパティ］ビューは，JP1/AOに設定されているサービスに共通するプロパティ（サービス共有プロパティ）の設定を確認するための画面です。

［サービス共有プロパティ］ビューは，［管理］画面で［サービス共有プロパティ］メニューを選択すると表示されます。

図6‒6　［サービス共有プロパティ］ビュー

表示項目について説明します。

サービス共有プロパティ

サービス共有プロパティ情報の一覧が表示されます。表示項目のタイトルをクリックすると，昇順，または降順でソートできます。表示項目は，［列の表示・非表示設定］ダイアログボックスで選択できます。

表6‒3　サービス共有プロパティ一覧の表示項目（［サービス共有プロパティ］ビュー）

表示項目

初期表示

説明

サービス共有プロパティ

○　

サービス共有プロパティ名が表示されます。

説明

○　

サービス共有プロパティの説明が表示されます。

プロパティ値

○　

サービス共有プロパティの値が表示されます。

プロパティキー

×　

サービス共有プロパティのキーが表示されます。

#

×　

［サービス共有プロパティ］ビューでの表示順序が表示されます。

（凡例）

○：表示されます。　×：表示されません。

［サービス共有プロパティ設定］ボタン

サービス共有プロパティを選択してクリックすると，［サービス共有プロパティ設定］ダイアログボックスが表示されます。

6.3.1　［サービス共有プロパティ設定］ダイアログボックス

［サービス共有プロパティ設定］ダイアログボックスは，JP1/AOに設定されているサービス共有プロパティの設定を変更するための画面です。

［サービス共有プロパティ設定］ダイアログボックスは，［サービス共有プロパティ］ビューでサービス共有プロパティを選択し，［サービス共有プロパティ設定］ボタンをクリックすると表示されます。

図6‒7　［サービス共有プロパティ設定］ダイアログボックス（タスクのログ出力レベルの設定の場合）

表示項目について説明します。

サービス共有プロパティ

設定するサービス共有プロパティ名が表示されます。

説明

サービス共有プロパティの説明が表示されます。「ビルトインサービス共有プロパティ」と表示されている場合は，JP1/AOで提供しているプロパティです。

［プロパティ値］

サービス共有プロパティの値を設定します。入力内容は，プロパティの種類によって異なります。

［サービス］

クリックすると，定義しているサービス一覧が表示されます。

定義しているサービス一覧

選択したサービス共有プロパティを定義しているサービスの一覧が表示されます。表示項目のタイトルをクリックすると，昇順，または降順でソートできます。表示項目は，［列の表示・非表示設定］ダイアログボックスで選択できます。

表6‒4　定義しているサービス一覧の表示項目（［サービス共有プロパティ設定］ダイアログボックス）

表示項目

初期表示

説明

サービス名

○　

サービスの名称が表示されます。

説明

○　

サービスの説明が表示されます。

カテゴリ名

○　

サービスのカテゴリ名が表示されます。

リソースグループ

×　

サービスが割り当てられているリソースグループが表示されます。

サービステンプレート名

×　

サービステンプレートの名称が表示されます。

ベンダー名

×　

サービステンプレートのベンダー名が表示されます。

サービスバージョン

×　

サービステンプレートのバージョンが表示されます。

構成種別

×　

サービステンプレートの構成種別が表示されます。

（凡例）

○：表示されます。　×：表示されません。

［OK］ボタン

クリックすると，サービス共有プロパティの値が変更されます。

［キャンセル］ボタン

クリックすると，［サービス共有プロパティ設定］ダイアログボックスが閉じます。

6.4　［ユーザー管理］画面

［ユーザー管理］画面は，JP1/AOのユーザーのプロファイル，権限，およびJP1/AOと連携するActive Directoryのグループを管理するための画面です。

［ユーザー管理］画面は，［管理］画面の左ペインで［ユーザー管理］メニューを選択すると表示されます。

図6‒8　［ユーザー管理］画面

表示項目について説明します。

左ペイン

ユーザーと権限の一覧がツリー表示されます。

［ユーザー管理］メニュー

選択すると，右ペインにユーザー管理項目一覧が表示されます。

［ユーザー］メニュー

選択すると，右ペインに［ユーザー一覧］ビューが表示されます。ツリー下の［ユーザーID］を選択すると，選択したユーザーの［プロファイル］ビューが表示されます。

［権限］メニュー

選択すると，右ペインに［権限］ビューが表示されます。ツリー下の［権限名］を選択すると，選択した権限の［権限を持つユーザー一覧］ビューが表示されます。

［グループ］メニュー

選択すると，右ペインに［グループ］ビューが表示されます。ツリー下の［ドメイン名］を選択すると，選択したドメインの［グループ一覧］ビューが表示されます。

［グループ］メニューは，Active Directoryとのグループ連携を有効にしている場合に表示されます。

［ツリー更新］ボタン

クリックすると，ツリーが現在の状態に更新されます。

右ペイン

左ペインで選択したメニューに応じた画面が表示されます。

6.4.1　［ユーザー一覧］ビュー

［ユーザー一覧］ビューは，ユーザーの一覧を表示し，ユーザーを追加したり，削除したりするための画面です。

［ユーザー一覧］ビューは，［ユーザー管理］画面で［ユーザー］メニューを選択すると表示されます。

図6‒9　［ユーザー一覧］ビュー（Active Directoryとの連携を設定している場合）

表示項目について説明します。

ユーザー一覧

JP1/AOに登録されているユーザーの一覧が表示されます。表示項目のタイトルをクリックすると，昇順，または降順でソートできます。

表6‒5　ユーザー一覧の表示項目（［ユーザー一覧］ビュー）

表示項目

説明

ユーザー選択チェックボックス

チェックすると，削除したり，ロックしたりするユーザーを選択できます。

ユーザーID

ユーザーIDが表示されます。［ユーザーID］をクリックすると，選択したユーザーの［プロファイル］ビューが表示されます。

状態

ユーザーの状態（有効，ロック中）が表示されます。

認証方式

外部認証サーバ連携コンフィグファイル（exauth.properties）でActive Directoryとの連携を設定している場合に，ユーザーの認証方式（内部，LDAP）が表示されます。

フルネーム

ユーザーの名前が表示されます。

説明

ユーザーの説明が表示されます。

［ユーザー追加］ボタン

クリックすると，［ユーザー追加］ダイアログボックス（ユーザー管理）が表示されます。

［ロック］ボタン

ユーザー選択チェックボックスにチェックをしてクリックすると，［ロック］ダイアログボックスが表示されます。ユーザーは複数選択できます。

［ロック解除］ボタン

ユーザー選択チェックボックスにチェックをしてクリックすると，［ロック解除］ダイアログボックスが表示されます。ユーザーは複数選択できます。

［認証方式変更］ボタン

ユーザー選択チェックボックスにチェックをしてクリックすると，［認証方式変更］ダイアログボックスが表示されます。ユーザーは複数選択できます。

［認証方式変更］ボタンは，外部認証サーバ連携コンフィグファイル（exauth.properties）でActive Directoryとの連携を設定している場合に表示されます。

［ユーザー削除］ボタン

ユーザー選択チェックボックスにチェックをしてクリックすると，［ユーザー削除］ダイアログボックスが表示されます。ユーザーは複数選択できます。

6.4.2　［ユーザー追加］ダイアログボックス（ユーザー管理）

［ユーザー追加］ダイアログボックス（ユーザー管理）は，JP1/AOにユーザーを追加するための画面です。

［ユーザー追加］ダイアログボックス（ユーザー管理）は，［ユーザー一覧］ビューで［ユーザー追加］ボタンをクリックすると表示されます。

図6‒10　［ユーザー追加］ダイアログボックス（ユーザー管理）（Active Directoryとの連携を設定している場合）

表示項目について説明します。

プロファイル

ユーザーのプロファイル情報を入力します。

［ユーザーID］テキストボックス

追加するユーザーのIDを入力します。256文字まで入力できます。

［パスワード］テキストボックス

追加するユーザーのパスワードを入力します。256文字まで入力できます。

［パスワードの確認］テキストボックス

［パスワード］で入力した文字列と同じ文字列を入力します。

［フルネーム］テキストボックス

追加するユーザーの名前を入力します。80文字まで入力できます。

［E-mail］テキストボックス

追加するユーザーのメールアドレスを入力します。255バイトまで入力できます。

［説明］テキストボックス

追加するユーザーの説明を入力します。80文字まで入力できます。

［OK］ボタン

クリックすると，ユーザーが追加されます。

［キャンセル］ボタン

クリックすると，［ユーザー追加］ダイアログボックス（ユーザー管理）が閉じます。

6.4.3　［ロック］ダイアログボックス

［ロック］ダイアログボックスは，指定したユーザーをJP1/AOにログインできないようにするための画面です。

［ロック］ダイアログボックスは，［ユーザー一覧］ビューでユーザー選択チェックボックスにチェックをして［ロック］ボタンをクリックすると表示されます。

図6‒11　［ロック］ダイアログボックス

表示項目について説明します。

ユーザー一覧

ロックするユーザーの一覧が表示されます。表示項目のタイトルをクリックすると，昇順，または降順でソートできます。

表6‒6　ユーザー一覧の表示項目（［ロック］ダイアログボックス）

表示項目

説明

ユーザーID

ユーザーIDが表示されます。

フルネーム

ユーザーの名前が表示されます。

説明

ユーザーの説明が表示されます。

［OK］ボタン

クリックすると，選択したユーザーがロックされ，JP1/AOにログインできなくなります。

［キャンセル］ボタン

クリックすると，［ロック］ダイアログボックスが閉じます。

6.4.4　［ロック解除］ダイアログボックス

［ロック解除］ダイアログボックスは，指定したユーザーのロックを解除するための画面です。

［ロック解除］ダイアログボックスは，［ユーザー一覧］ビューでユーザー選択チェックボックスにチェックをして［ロック解除］ボタンをクリックすると表示されます。

図6‒12　［ロック解除］ダイアログボックス

表示項目について説明します。

ユーザー一覧

ロックを解除するユーザーの一覧が表示されます。表示項目のタイトルをクリックすると，昇順，または降順でソートできます。

表6‒7　ユーザー一覧の表示項目（［ロック解除］ダイアログボックス）

表示項目

説明

ユーザーID

ユーザーIDが表示されます。

フルネーム

ユーザーの名前が表示されます。

説明

ユーザーの説明が表示されます。

［OK］ボタン

クリックすると，選択したユーザーのロックが解除され，JP1/AOにログインできるようになります。

［キャンセル］ボタン

クリックすると，［ロック解除］ダイアログボックスが閉じます。

6.4.5　［認証方式変更］ダイアログボックス

［認証方式変更］ダイアログボックスは，指定したユーザーの認証方式を変更するための画面です。

［認証方式変更］ダイアログボックスは，［ユーザー一覧］ビューでユーザー選択チェックボックスにチェックをして［認証方式変更］ボタンをクリックすると表示されます。

図6‒13　［認証方式変更］ダイアログボックス

表示項目について説明します。

認証方式リストボックス

ユーザーの認証方式を選択します。

内部

JP1/AOでユーザーを認証する場合に，選択します。

LDAP

Active Directoryでユーザーを認証する場合に，選択します。

ユーザー一覧

認証方式を変更するユーザーの一覧が表示されます。表示項目のタイトルをクリックすると，昇順，または降順でソートできます。

表6‒8　ユーザー一覧の表示項目（［認証方式変更］ダイアログボックス）

表示項目

説明

ユーザーID

ユーザーIDが表示されます。

状態

ユーザーの状態（有効，ロック中）が表示されます。

認証方式

ユーザーの認証方式（内部，LDAP）が表示されます。

フルネーム

ユーザーの名前が表示されます。

説明

ユーザーの説明が表示されます。

［OK］ボタン

クリックすると，ユーザーの認証方式が変更されます。

［キャンセル］ボタン

クリックすると，［認証方式変更］ダイアログボックスが閉じます。

6.4.6　［ユーザー削除］ダイアログボックス

［ユーザー削除］ダイアログボックスは，JP1/AOに追加したユーザーを削除するための画面です。

［ユーザー削除］ダイアログボックスは，［ユーザー一覧］ビューでユーザー選択チェックボックスにチェックをして［ユーザー削除］ボタンをクリックすると表示されます。

図6‒14　［ユーザー削除］ダイアログボックス

表示項目について説明します。

ユーザー一覧

削除するユーザーの一覧が表示されます。表示項目のタイトルをクリックすると，昇順，または降順でソートできます。

表6‒9　ユーザー一覧の表示項目（［ユーザー削除］ダイアログボックス）

表示項目

説明

ユーザーID

ユーザーIDが表示されます。

フルネーム

ユーザーの名前が表示されます。

説明

ユーザーの説明が表示されます。

［OK］ボタン

クリックすると，選択したユーザーが削除されます。

［キャンセル］ボタン

クリックすると，［ユーザー削除］ダイアログボックスが閉じます。

6.5　［プロファイル］ビュー

［プロファイル］ビューは，ユーザーのプロファイルを確認したり，変更したりするための画面です。

［プロファイル］ビューは，［ユーザー一覧］ビューで［ユーザーID］をクリックすると表示されます。

図6‒15　［プロファイル］ビュー（外部認証連携が有効の場合）

表示項目について説明します。

プロファイル

ユーザーのプロファイル情報が表示されます。

ユーザーID

ユーザーのIDが表示されます。

状態

ユーザーの状態（有効，ロック中）が表示されます。

認証方式

ユーザーの認証方式が表示されます。外部認証連携が有効の場合だけ表示されます。

フルネーム

ユーザーの名前が表示されます。

E-mail

ユーザーのメールアドレスが表示されます。

説明

ユーザーの説明が表示されます。

設定されている権限

ユーザーが持っている権限の一覧が表示されます。表示項目のタイトルをクリックすると，昇順，または降順でソートできます。

表6‒10　設定されている権限の表示項目（［プロファイル］ビュー）

表示項目

説明

アプリケーション

設定されている権限の名称が表示されます。

Admin

ユーザーがUser Management権限を持っているかどうかが表示されます。

［プロファイル編集］ボタン

クリックすると，［プロファイル編集］ダイアログボックスが表示されます。

［パスワード変更］ボタン

クリックすると，［パスワード変更］ダイアログボックスが表示されます。

［権限変更］ボタン

クリックすると，［権限変更］ダイアログボックスが表示されます。このボタンは，ログインユーザーまたはSystemアカウントを選択した場合は表示されません。

［ユーザー削除］ボタン

クリックすると，ユーザーを削除するかどうかを確認するメッセージダイアログボックスが表示され，［OK］ボタンをクリックすると，ユーザーが削除されます。このボタンは，ログインユーザーまたはSystemアカウントを選択した場合は表示されません。

6.5.1　［プロファイル編集］ダイアログボックス

［プロファイル編集］ダイアログボックスは，ユーザーのプロファイル情報を変更するための画面です。

［プロファイル編集］ダイアログボックスは，次のどちらかの操作をすると表示されます。

［プロファイル］ビューで［プロファイル編集］ボタンをクリックする。

［プロファイル］画面で［プロファイル編集］ボタンをクリックする。

図6‒16　［プロファイル編集］ダイアログボックス

表示項目について説明します。

プロファイル

ユーザーのプロファイル情報を変更します。

ユーザーID

ユーザーのIDが表示されます。ユーザーIDは変更できません。

［フルネーム］テキストボックス

ユーザー追加時に入力したフルネームが表示されます。フルネームは80文字以内で変更できます。

［E-mail］テキストボックス

ユーザー追加時に入力したE-mailが表示されます。E-mailは255バイト以内で変更できます。

［説明］テキストボックス

ユーザー追加時に入力した説明が表示されます。説明は80文字以内で変更できます。

［OK］ボタン

クリックすると，プロファイル情報が変更されます。

［キャンセル］ボタン

クリックすると，［プロファイル編集］ダイアログボックスが閉じます。

6.5.2　［パスワード変更］ダイアログボックス

［パスワード変更］ダイアログボックスは，ユーザーのパスワードを変更するための画面です。

［パスワード変更］ダイアログボックスは，次のどちらかの操作をすると表示されます。

［プロファイル］ビューで［パスワード変更］ボタンをクリックする。

［プロファイル］画面で［パスワード変更］ボタンをクリックする。

図6‒17　［パスワード変更］ダイアログボックス（［プロファイル］ビューから表示した場合）

表示項目について説明します。

パスワード入力

ユーザーの新しいパスワードを設定します。

［古いパスワード］テキストボックス

現在のパスワードを入力します。この項目は，［プロファイル］画面から［パスワード変更］ダイアログボックスを表示したときだけ表示されます。

［新しいパスワード］テキストボックス

新しいパスワードを入力します。256文字まで入力できます。

［パスワードの確認］テキストボックス

［新しいパスワード］で入力した文字列と同じ文字列を入力します。

［OK］ボタン

クリックすると，ユーザーのパスワードが変更されます。

［キャンセル］ボタン

クリックすると，［パスワード変更］ダイアログボックスが閉じます。

6.5.3　［権限変更］ダイアログボックス（［プロファイル］ビューから表示した場合）

［権限変更］ダイアログボックスは，ユーザーの権限を変更するための画面です。

［権限変更］ダイアログボックスは，［プロファイル］ビューで［権限変更］ボタンをクリックすると表示されます。

なお，JP1/AOの［権限変更］ダイアログボックスは2種類あります。［グループ詳細］ビューから表示した場合は，「6.7.5　［権限変更］ダイアログボックス（［グループ詳細］ビューから表示した場合）」のトピックを参照してください。

図6‒18　［権限変更］ダイアログボックス（［プロファイル］ビューから表示した場合）

表示項目について説明します。

設定されている権限

ユーザーが持っている権限の一覧が表示されます。

表6‒11　設定されている権限の表示項目（［プロファイル］ビューから表示した場合の［権限変更］ダイアログボックス）

表示項目

説明

アプリケーション

権限の名称が表示されます。

Admin

チェックすると，そのユーザーにUser Management権限が設定されます。

［OK］ボタン

クリックすると，ユーザーの権限が変更されます。

［キャンセル］ボタン

クリックすると，［権限変更］ダイアログボックスが閉じます。

6.6　［権限］ビュー

［権限］ビューは，権限を管理するための画面です。

［権限］ビューは，［ユーザー管理］画面で［権限］メニューを選択すると表示されます。

図6‒19　［権限］ビュー

表示項目について説明します。

登録状況

権限の登録状況が表示されます。

登録されているアプリケーション数

設定されている権限数が表示されます。

登録されているユーザー数

権限に登録されているユーザー数が表示されます。外部認証連携が有効の場合は，登録されているユーザー数とグループ数の合計が表示されます。ただし，JP1/Baseに登録されているJP1ユーザーおよびJP1資源グループは含まれません。

アプリケーション一覧

権限の一覧が表示されます。表示項目のタイトルをクリックすると，昇順，または降順でソートできます。

表6‒12　アプリケーション一覧の表示項目（［権限］ビュー）

表示項目

説明

アプリケーション

権限名が表示されます。［権限名］をクリックすると，外部認証連携が無効の場合は，選択した権限の［権限を持つユーザー一覧］ビューが表示されます。外部認証連携が有効の場合は，選択した権限の［権限を持つユーザーとグループ一覧］ビューが表示されます。

ホスト名/IPアドレス

ホスト名またはIPアドレスが表示されます。

権限を持つユーザー数

権限を持つユーザー数が表示されます。外部認証連携が有効の場合は，権限を持つユーザー数とグループ数の合計が表示されます。ただし，JP1/Baseに登録されているJP1ユーザーおよびJP1資源グループは含まれません。

6.6.1　［権限を持つユーザー一覧］ビュー

［権限を持つユーザー一覧］ビューは，権限を持つユーザーを確認するための画面です。［権限を持つユーザー一覧］ビューは，外部認証連携が無効の場合に表示されます。

［権限を持つユーザー一覧］ビューは，［権限］ビューで［権限名］をクリックすると表示されます。

図6‒20　［権限を持つユーザー一覧］ビュー

表示項目について説明します。

権限を持つユーザー一覧

権限を持つユーザーの一覧が表示されます。表示項目のタイトルをクリックすると，昇順，または降順でソートできます。

表6‒13　権限を持つユーザー一覧の表示項目（［権限を持つユーザー一覧］ビュー）

表示項目

説明

ユーザーID

権限を持つユーザーのユーザーIDが表示されます。［ユーザーID］をクリックすると，選択したユーザーの［プロファイル］ビューが表示されます。

Admin

User Management権限を持っているユーザーはチェックが表示されます。

6.6.2　［権限を持つユーザーとグループ一覧］ビュー

［権限を持つユーザーとグループ一覧］ビューは，権限を持つユーザーとグループを確認するための画面です。［権限を持つユーザーとグループ一覧］ビューは，外部認証連携が有効の場合に表示されます。

［権限を持つユーザーとグループ一覧］ビューは，［権限］ビューで［権限名］をクリックすると表示されます。

図6‒21　［権限を持つユーザーとグループ一覧］ビュー

表示項目について説明します。

権限を持つユーザーとグループ一覧

権限を持つユーザーとグループの一覧が表示されます。表示項目のタイトルをクリックすると，昇順，または降順でソートできます。ただし，JP1/Baseに登録されているJP1ユーザーおよびJP1資源グループは表示されません。

表6‒14　権限を持つユーザーとグループ一覧の表示項目（［権限を持つユーザーとグループ一覧］ビュー）

表示項目

説明

ユーザーIDとグループ名

権限を持つユーザーのユーザーIDとグループ名が表示されます。［ユーザーID］をクリックすると，選択したユーザーの［プロファイル］ビューが表示されます。

Admin

User Management権限を持っているユーザーとグループはチェックが表示されます。

6.7　［グループ］ビュー

［グループ］ビューは，JP1/AOと連携できるActive Directoryのドメインを確認するための画面です。

［グループ］ビューは，Active Directoryとグループ連携している場合に，［ユーザー管理］画面で［グループ］メニューを選択すると表示されます。

図6‒22　［グループ］ビュー

表示項目について説明します。

ドメイン一覧

Active Directoryのドメインの一覧が表示されます。表示項目のタイトルをクリックすると，昇順または降順でソートできます。

表6‒15　ドメイン一覧の表示項目（［グループ］ビュー）

表示項目

説明

ドメイン名

ドメインの名称が表示されます。［ドメイン名］をクリックすると，［グループ一覧］ビューが表示されます。

ドメイン名には，外部認証サーバ連携コンフィグファイル（exauth.properties）の「auth.ldap.サーバ識別名.domain.name」キーに指定した値が表示されます。

ホスト名/IPアドレス

ドメインのホスト名またはIPアドレスが表示されます。

ホスト名/IPアドレスには，外部認証サーバ連携コンフィグファイル（exauth.properties）の「auth.ldap.サーバ識別名.host」キーに指定した値が表示されます。ただし，「auth.ldap.サーバ識別名.dns_lookup」キーにtrueを指定している場合は，DNSサーバから取得した情報が表示されます。情報が取得できなかった場合は，「−」が表示されます。

6.7.1　［グループ一覧］ビュー

［グループ一覧］ビューは，JP1/AOのユーザーグループとして登録したActive Directoryのグループを管理するための画面です。

［グループ一覧］ビューは，［グループ］ビューで［ドメイン名］をクリックすると表示されます。

図6‒23　［グループ一覧］ビュー

表示項目について説明します。

グループ一覧

JP1/AOのユーザーグループとして登録したActive Directoryのグループの一覧が表示されます。表示項目のタイトルをクリックすると，昇順または降順でソートできます。

表6‒16　グループ一覧の表示項目（［グループ一覧］ビュー）

表示項目

説明

グループ選択チェックボックス

チェックすると，削除するグループを選択できます。

グループ名

グループの名称が表示されます。［グループ名］をクリックすると，［グループ詳細］ビューが表示されます。

Distinguished Name

グループの識別名が表示されます。

［グループ追加］ボタン

Active DirectoryのグループをJP1/AOのユーザーグループとして登録します。クリックすると，［グループ追加］ダイアログボックスが表示されます。

［グループ削除］ボタン

JP1/AOのユーザーグループとして登録したActive DirectoryのグループをJP1/AOから削除します。グループ選択チェックボックスにチェックをしてクリックすると，［グループ削除］ダイアログボックスが表示されます。グループは複数選択できます。

6.7.2　［グループ追加］ダイアログボックス

［グループ追加］ダイアログボックスは，Active DirectoryのグループをJP1/AOのユーザーグループとして登録するための画面です。

［グループ追加］ダイアログボックスは，［グループ一覧］ビューで［グループ追加］ボタンをクリックすると表示されます。

図6‒24　［グループ追加］ダイアログボックス

表示項目について説明します。

グループ一覧

JP1/AOのユーザーグループとして登録するActive Directoryのグループの情報を入力します。

［Distinguished Name］テキストボックス

JP1/AOのユーザーグループとして登録するActive Directoryのグループの識別名を入力します。250文字まで入力できます。RFC 4514の規則に従って入力してください。先頭のRelative Distinguished Nameが，グループ名として登録されます。

［−］ボタン

クリックすると，［Distinguished Name］テキストボックスが削除されます。表示されている［Distinguished Name］テキストボックスが1つの場合，クリックできません。

［＋］ボタン

クリックすると，［Distinguished Name］テキストボックスが追加されます。［Distinguished Name］テキストボックスは，20個まで追加できます。

［チェックDN］ボタン

クリックすると，［Distinguished Name］テキストボックスに入力した識別名の指定方法が正しいかどうか，および入力した識別名がActive Directoryに登録されているかどうかを検証します。

［やり直す］ボタン

クリックすると，［Distinguished Name］テキストボックスに入力した内容がすべて削除されます。

［OK］ボタン

クリックすると，入力したグループをJP1/AOのユーザーグループとして登録します。

［キャンセル］ボタン

クリックすると，［グループ追加］ダイアログボックスが閉じます。

6.7.3　［グループ削除］ダイアログボックス

［グループ削除］ダイアログボックスは，JP1/AOのユーザーグループとして登録したActive DirectoryのグループをJP1/AOから削除するための画面です。

［グループ削除］ダイアログボックスは，［グループ一覧］ビューでグループ選択チェックボックスにチェックをして［グループ削除］ボタンをクリックすると表示されます。

図6‒25　［グループ削除］ダイアログボックス

表示項目について説明します。

グループ一覧

JP1/AOから削除するグループの一覧が表示されます。表示項目のタイトルをクリックすると，昇順または降順でソートできます。

表6‒17　グループ一覧の表示項目（［グループ削除］ダイアログボックス）

表示項目

説明

グループ名

JP1/AOから削除するグループの名称が表示されます。

Distinguished Name

JP1/AOから削除するグループの識別名が表示されます。

［OK］ボタン

クリックすると，表示されているグループをJP1/AOから削除します。

［キャンセル］ボタン

クリックすると，［グループ削除］ダイアログボックスが閉じます。

6.7.4　［グループ詳細］ビュー

［グループ詳細］ビューは，JP1/AOのユーザーグループとして登録したActive Directoryのグループの詳細を確認するための画面です。

［グループ詳細］ビューは，［グループ一覧］ビューで［グループ名］をクリックすると表示されます。

図6‒26　［グループ詳細］ビュー

表示項目について説明します。

［権限変更］ボタン

表示されているグループの権限を変更します。クリックすると，［権限変更］ダイアログボックスが表示されます。

［グループ削除］ボタン

JP1/AOのユーザーグループとして登録したActive DirectoryのグループをJP1/AOから削除します。クリックすると，表示されているグループをJP1/AOから削除するかどうかを確認するメッセージダイアログボックスが表示され，［OK］ボタンをクリックすると，グループが削除されます。

グループ詳細

JP1/AOのユーザーグループとして登録したActive Directoryのグループの情報が表示されます。

Distinguished Name

識別名が表示されます。

設定されている権限

グループが持っている権限の一覧が表示されます。表示項目のタイトルをクリックすると，昇順または降順でソートできます。

表6‒18　設定されている権限一覧の表示項目（［グループ詳細］ビュー）

表示項目

説明

アプリケーション

設定されている権限の名称が表示されます。

Admin

グループがUser Management権限を持っている場合，チェックが表示されます。

6.7.5　［権限変更］ダイアログボックス（［グループ詳細］ビューから表示した場合）

［権限変更］ダイアログボックスは，JP1/AOのユーザーグループとして登録したActive Directoryのグループの権限を変更するための画面です。

［権限変更］ダイアログボックスは，［グループ詳細］ビューで［権限変更］ボタンをクリックすると表示されます。

なお，JP1/AOの［権限変更］ダイアログボックスは2種類あります。［プロファイル］ビューから表示した場合は，「6.5.3　［権限変更］ダイアログボックス（［プロファイル］ビューから表示した場合）」のトピックを参照してください。

図6‒27　［権限変更］ダイアログボックス（［グループ詳細］ビューから表示した場合）

表示項目について説明します。

グループ詳細

JP1/AOのユーザーグループとして登録したActive Directoryのグループの情報が表示されます。

Distinguished Name

識別名が表示されます。

設定されている権限

グループが持っている権限の一覧が表示されます。

表6‒19　設定されている権限の表示項目（［グループ詳細］ビューから表示した場合の［権限変更］ダイアログボックス）

表示項目

説明

アプリケーション

権限の名称が表示されます。

Admin

チェックすると，そのグループにUser Management権限が設定されます。

［OK］ボタン

クリックすると，グループの権限が変更されます。

［キャンセル］ボタン

クリックすると，［権限変更］ダイアログボックスが閉じます。

6.8　［ユーザーグループ］ビュー（［ユーザーグループ］タブ）

［ユーザーグループ］ビュー（［ユーザーグループ］タブ）は，ユーザーグループを管理するための画面です。［ユーザーグループ］ビュー（［ユーザーグループ］タブ）は，ログインユーザーがUser Management権限を持つ場合に表示されます。

［ユーザーグループ］ビュー（［ユーザーグループ］タブ）は，［管理］画面で［ユーザーグループ］メニューを選択すると表示されます。

［ユーザーグループ］ビュー（［ユーザーグループ］タブ），およびこの画面から遷移する画面には，Hitachi Command Suite製品と共有しているユーザーグループとユーザーが表示されます。

図6‒28　［ユーザーグループ］ビュー（［ユーザーグループ］タブ）

表示項目について説明します。

ユーザーグループ

ユーザーグループの一覧が表示されます。表示項目のタイトルをクリックすると，昇順，または降順でソートできます。表示項目は，［列の表示・非表示設定］ダイアログボックスで選択できます。

表6‒20　ユーザーグループ一覧の表示項目（［ユーザーグループ］ビュー（［ユーザーグループ］タブ））

表示項目

初期表示

説明

ユーザーグループ

○　

ユーザーグループ名が表示されます。

説明

○　

ユーザーグループの説明が表示されます。ビルトインユーザーグループの場合は「Built-in user group」が表示されます。※1

ユーザー数

○　

ユーザーグループに登録されたユーザー数が表示されます。※1

Distinguished Name

×　

Active Directoryのグループの識別名が表示されます。※2

（凡例）

○：表示されます。　×：表示されません。

注※1

Active Directoryのグループの場合，表示されません。

注※2

ビルトインユーザーグループおよびJP1/AOで作成したユーザーグループの場合，表示されません。

［ユーザーグループ作成］ボタン

クリックすると，［ユーザーグループ作成］ダイアログボックスが表示されます。

［ユーザーグループ編集］ボタン

ユーザーグループを選択してクリックすると，［ユーザーグループ編集］ダイアログボックスが表示されます。

［ユーザーグループ削除］ボタン

ユーザーグループを選択してクリックすると，［ユーザーグループ削除］ダイアログボックスが表示されます。ユーザーグループは複数選択できます。

6.8.1　［ユーザーグループ作成］ダイアログボックス

［ユーザーグループ作成］ダイアログボックスは，ユーザーグループを作成して，ユーザーやリソースグループを割り当てるための画面です。作成したユーザーグループはHitachi Command Suite製品と共有されます。

［ユーザーグループ作成］ダイアログボックスは，［ユーザーグループ］ビュー（［ユーザーグループ］タブ）で［ユーザーグループ作成］ボタンをクリックすると表示されます。

図6‒29　［ユーザーグループ作成］ダイアログボックス

表示項目について説明します。

［名前］テキストボックス

ユーザーグループの名称を入力します。64文字まで入力できます。

［説明］テキストボックス

ユーザーグループの説明を入力します。80文字まで入力できます。

ユーザー

ユーザーグループに追加するユーザーの一覧が表示されます。表示項目のタイトルをクリックすると，昇順，または降順でソートできます。表示項目は，［列の表示・非表示設定］ダイアログボックスで選択できます。

表6‒21　ユーザー一覧の表示項目（［ユーザーグループ作成］ダイアログボックス）

表示項目

初期表示

説明

ユーザーID

○　

ユーザーIDが表示されます。

フルネーム

○　

ユーザーの名前が表示されます。

ユーザーグループ

○　

ユーザーがすでに所属しているユーザーグループが表示されます。

（凡例）

○：表示されます。

［ユーザー追加］ボタン

クリックすると，［ユーザー追加］ダイアログボックス（ユーザーグループ）が表示されます。

［ユーザー削除］ボタン

ユーザーを選択してクリックすると，選択したユーザーが一覧から削除されます。ユーザーは複数選択できます。

リソースグループ

ユーザーグループに割り当てるJP1/AOのリソースグループの一覧が表示されます。表示項目のタイトルをクリックすると，昇順，または降順でソートできます。この項目は，ログインユーザーがUser Management権限とAdminロールの両方を持つ場合に表示されます。

表示項目は，［列の表示・非表示設定］ダイアログボックスで選択できます。

表6‒22　リソースグループ一覧の表示項目（［ユーザーグループ作成］ダイアログボックス）

表示項目

初期表示

説明

リソースグループ

○　

リソースグループ名が表示されます。

説明

○　

リソースグループの説明が表示されます。ビルトインリソースグループの場合は「default resource groups which contains all resources」が表示されます。

ユーザーグループ

○　

リソースグループにすでに割り当てられているユーザーグループが表示されます。

ロール

○　

選択したリソースグループのロールが表示されます。

製品名

○　

リソースグループを管理する製品名が表示されます。JP1/AOのリソースグループの場合，「Automation」が表示されます。

（凡例）

○：表示されます。

［リソースグループ追加］ボタン

クリックすると，［リソースグループ追加］ダイアログボックスが表示されます。

［ロール編集］ボタン

クリックすると，［ロール編集］ダイアログボックスが表示されます。リソースグループは複数選択できます。

［リソースグループ削除］ボタン

リソースグループを選択してクリックすると，選択したリソースグループが一覧から削除されます。リソースグループは複数選択できます。

［OK］ボタン

クリックすると，ユーザーグループが作成されます。

［キャンセル］ボタン

クリックすると，［ユーザーグループ作成］ダイアログボックスが閉じます。

6.8.2　［ユーザー追加］ダイアログボックス（ユーザーグループ）

［ユーザー追加］ダイアログボックス（ユーザーグループ）は，ユーザーグループにユーザーを追加するための画面です。

［ユーザー追加］ダイアログボックス（ユーザーグループ）は，次のどちらかの操作をすると表示されます。

［ユーザーグループ作成］ダイアログボックスで［ユーザー追加］ボタンをクリックする。

［ユーザーグループ編集］ダイアログボックスで［ユーザー追加］ボタンをクリックする。

図6‒30　［ユーザー追加］ダイアログボックス（ユーザーグループ）

表示項目について説明します。

ユーザー

追加できるユーザーの一覧が表示されます。表示項目のタイトルをクリックすると，昇順，または降順でソートできます。表示項目は，［列の表示・非表示設定］ダイアログボックスで選択できます。

表6‒23　ユーザー一覧の表示項目（［ユーザー追加］ダイアログボックス（ユーザーグループ））

表示項目

初期表示

説明

ユーザーID

○　

ユーザーIDが表示されます。

フルネーム

○　

ユーザーの名前が表示されます。

ユーザーグループ

○　

ユーザーがすでに所属しているユーザーグループが表示されます。

（凡例）

○：表示されます。

［OK］ボタン

ユーザーを選択してクリックすると，［ユーザーグループ作成］ダイアログボックスのユーザー一覧に選択したユーザーが表示されます。ユーザーは複数選択できます。

［キャンセル］ボタン

クリックすると，［ユーザー追加］ダイアログボックス（ユーザーグループ）が閉じます。

6.8.3　［リソースグループ追加］ダイアログボックス

［リソースグループ追加］ダイアログボックスは，ユーザーグループにリソースグループを追加するための画面です。

［リソースグループ追加］ダイアログボックスは，次のどちらかの操作をすると表示されます。

［ユーザーグループ作成］ダイアログボックスで［リソースグループ追加］ボタンをクリックする。

［ユーザーグループ編集］ダイアログボックスで［リソースグループ追加］ボタンをクリックする。

図6‒31　［リソースグループ追加］ダイアログボックス

表示項目について説明します。

リソースグループ

ユーザーグループに追加できるリソースグループの一覧が表示されます。表示項目のタイトルをクリックすると，昇順，または降順でソートできます。表示項目は，［列の表示・非表示設定］ダイアログボックスで選択できます。なお，Hitachi Command Suite製品がすでにインストールされている場合でも，Hitachi Command Suite製品で作成したリソースグループは表示されません。

表6‒24　リソースグループ一覧の表示項目（［リソースグループ追加］ダイアログボックス）

表示項目

初期表示

説明

リソースグループ

○　

リソースグループ名が表示されます。

説明

○　

リソースグループの説明が表示されます。ビルトインリソースグループの場合は「default resource groups which contains all resources」が表示されます。

ユーザーグループ

○　

リソースグループにすでに割り当てられているユーザーグループが表示されます。

ロール

○　

選択したリソースグループのロールを選択します。

（凡例）

○：表示されます。

［OK］ボタン

リソースグループを選択してクリックすると，［ユーザーグループ作成］ダイアログボックスのリソースグループ一覧に選択したリソースグループが表示されます。リソースグループは複数選択できます。

［キャンセル］ボタン

クリックすると，［リソースグループ追加］ダイアログボックスが閉じます。

6.8.4　［ロール編集］ダイアログボックス

［ロール編集］ダイアログボックスは，リソースグループに割り当てるロールを選択するための画面です。

［ロール編集］ダイアログボックスは，次のどちらかの操作をすると表示されます。

［ユーザーグループ作成］ダイアログボックスで［ロール編集］ボタンをクリックする。

［ユーザーグループ編集］ダイアログボックスで［ロール編集］ボタンをクリックする。

図6‒32　［ロール編集］ダイアログボックス

表示項目について説明します。

リソースグループ

ロールを選択するリソースグループの一覧が表示されます。表示項目のタイトルをクリックすると，昇順，または降順でソートできます。表示項目は，［列の表示・非表示設定］ダイアログボックスで選択できます。

表6‒25　リソースグループ一覧の表示項目（［ロール編集］ダイアログボックス）

表示項目

初期表示

説明

リソースグループ

○　

リソースグループ名が表示されます。

説明

○　

リソースグループの説明が表示されます。ビルトインリソースグループの場合は「default resource groups which contains all resources」が表示されます。

ユーザーグループ

○　

リソースグループにすでに割り当てられているユーザーグループが表示されます。

ロール

○　

選択したリソースグループのロールを選択します。

（凡例）

○：表示されます。

［OK］ボタン

クリックすると，ロールが変更されます。

［キャンセル］ボタン

クリックすると，［ロール編集］ダイアログボックスが閉じます。

6.8.5　［ユーザーグループ編集］ダイアログボックス

［ユーザーグループ編集］ダイアログボックスは，選択したユーザーグループを編集して，ユーザーやリソースグループを割り当てるための画面です。

［ユーザーグループ編集］ダイアログボックスは，［ユーザーグループ］ビュー（［ユーザーグループ］タブ）でユーザーグループを選択し，［ユーザーグループ編集］ボタンをクリックすると表示されます。

図6‒33　［ユーザーグループ編集］ダイアログボックス

表示項目について説明します。

［名前］テキストボックス

ユーザーグループの名称が表示されます。変更するユーザーグループの名称を入力します。64文字まで入力できます。ビルトインユーザーグループ，およびActive Directoryのグループの名前は変更できません。

［説明］テキストボックス

ユーザーグループの説明が表示されます。変更するユーザーグループの説明を入力します。80文字まで入力できます。ビルトインユーザーグループ，およびActive Directoryのグループの説明は変更できません。

ユーザー

ユーザーグループに追加されているユーザーの一覧が表示されます。表示項目のタイトルをクリックすると，昇順，または降順でソートできます。表示項目は，［列の表示・非表示設定］ダイアログボックスで選択できます。

Active Directoryのグループの場合，表示されません。

表6‒26　ユーザー一覧の表示項目（［ユーザーグループ編集］ダイアログボックス）

表示項目

初期表示

説明

ユーザーID

○　

ユーザーIDが表示されます。

フルネーム

○　

ユーザーの名前が表示されます。

ユーザーグループ

○　

ユーザーがすでに所属しているユーザーグループが表示されます。

（凡例）

○：表示されます。

［ユーザー追加］ボタン

クリックすると，［ユーザー追加］ダイアログボックス（ユーザーグループ）が表示されます。

［ユーザー削除］ボタン

ユーザーを選択してクリックすると，選択したユーザーが一覧から削除されます。ユーザーは複数選択できます。

リソースグループ

ユーザーグループに割り当てるリソースグループの一覧が表示されます。表示項目のタイトルをクリックすると，昇順，または降順でソートできます。

表示項目は，［列の表示・非表示設定］ダイアログボックスで選択できます。Hitachi Command Suite製品がすでにインストールされている場合，Hitachi Command Suite製品で作成したリソースグループも表示されます。ただし，Hitachi Command Suite製品のリソースグループは，ロールの編集，および削除はできません。

表6‒27　リソースグループ一覧の表示項目（［ユーザーグループ編集］ダイアログボックス）

表示項目

初期表示

説明

リソースグループ

○　

リソースグループ名が表示されます。

説明

○　

リソースグループの説明が表示されます。ビルトインリソースグループの場合は「default resource groups which contains all resources」が表示されます。

ユーザーグループ

○　

リソースグループにすでに割り当てられているユーザーグループが表示されます。

ロール

○　

選択したリソースグループのロールが表示されます。

製品名

○　

リソースグループを管理する製品名が表示されます。JP1/AOのリソースグループの場合，「Automation」が表示されます。

（凡例）

○：表示されます。

［リソースグループ追加］ボタン

クリックすると，［リソースグループ追加］ダイアログボックスが表示されます。このボタンは，ログインユーザーがUser Management権限とAdminロールの両方を持つ場合に表示されます。なお，ビルトインユーザーグループを選択した場合は，表示されません。

［ロール編集］ボタン

リソースグループを選択してクリックすると，［ロール編集］ダイアログボックスが表示されます。リソースグループは複数選択できます。このボタンは，ログインユーザーがUser Management権限とAdminロールの両方を持つ場合に表示されます。なお，ビルトインユーザーグループを選択した場合，およびHitachi Command Suite製品で作成したリソースグループを選択した場合は表示されません。

［リソースグループ削除］ボタン

リソースグループを選択してクリックすると，選択したリソースグループが一覧から削除されます。リソースグループは複数選択できます。このボタンは，ログインユーザーがUser Management権限とAdminロールの両方を持つ場合に表示されます。なお，ビルトインユーザーグループを選択した場合，およびHitachi Command Suite製品で作成したリソースグループを選択した場合は，表示されません。

［OK］ボタン

クリックすると，ユーザーグループの内容が変更されます。

［キャンセル］ボタン

クリックすると，［ユーザーグループ編集］ダイアログボックスが閉じます。

6.8.6　［ユーザーグループ削除］ダイアログボックス

［ユーザーグループ削除］ダイアログボックスは，ユーザーグループを削除するための画面です。

［ユーザーグループ削除］ダイアログボックスは，［ユーザーグループ］ビュー（［ユーザーグループ］タブ）でユーザーグループを選択し［ユーザーグループ削除］ボタンをクリックすると表示されます。

図6‒34　［ユーザーグループ削除］ダイアログボックス

表示項目について説明します。

ユーザーグループ

削除するユーザーグループの一覧が表示されます。表示項目のタイトルをクリックすると，昇順，または降順でソートできます。

表6‒28　ユーザーグループ一覧の表示項目（［ユーザーグループ削除］ダイアログボックス）

表示項目

説明

ユーザーグループ

ユーザーグループ名が表示されます。

説明

ユーザーグループの説明が表示されます。

ユーザー数

ユーザーグループに所属しているユーザー数が表示されます。

［OK］ボタン

クリックすると，一覧に表示されたユーザーグループが削除されます。Hitachi Command Suite製品で作成したリソースグループが削除対象のユーザーグループに設定されている場合は，削除時にエラーとなります。

［キャンセル］ボタン

クリックすると，［ユーザーグループ削除］ダイアログボックスが閉じます。

6.9　［ユーザーグループ］ビュー（［ユーザー］タブ）

［ユーザーグループ］ビュー（［ユーザー］タブ）は，ユーザーグループに割り当てたユーザーを確認したり，ユーザーグループにユーザーを割り当てたりするための画面です。［ユーザーグループ］ビュー（［ユーザー］タブ）は，ログインユーザーがUser Management権限を持つ場合に表示されます。

［ユーザーグループ］ビュー（［ユーザー］タブ）は，［管理］画面で［ユーザーグループ］メニューを選択し，［ユーザー］タブを選択すると表示されます。

［ユーザーグループ］ビュー（［ユーザー］タブ），およびこの画面から遷移する画面には，Hitachi Command Suite製品と共有しているユーザーグループとユーザーが表示されます。Hitachi Command Suite製品で作成したユーザーグループにユーザーを割り当てることもできます。

図6‒35　［ユーザーグループ］ビュー（［ユーザー］タブ）

表示項目について説明します。

ユーザー

ユーザーグループに割り当てられるユーザーの一覧が表示されます。表示項目のタイトルをクリックすると，昇順，または降順でソートできます。表示項目は，［列の表示・非表示設定］ダイアログボックスで選択できます。

表6‒29　ユーザー一覧の表示項目（［ユーザーグループ］ビュー（［ユーザー］タブ））

表示項目

初期表示

説明

ユーザーID

○　

ユーザーIDが表示されます。

フルネーム

○　

ユーザーの名前が表示されます。

説明

○　

ユーザーの説明が表示されます。

ユーザーグループ

○　

ユーザーが所属するユーザーグループが表示されます。

（凡例）

○：表示されます。

［ユーザーグループ割り当て］ボタン

ユーザーを選択してクリックすると，［ユーザーグループ割り当て］ダイアログボックスが表示されます。

6.9.1　［ユーザーグループ割り当て］ダイアログボックス

［ユーザーグループ割り当て］ダイアログボックスは，ユーザーをユーザーグループに割り当てるための画面です。

［ユーザーグループ割り当て］ダイアログボックスは，［ユーザーグループ］ビュー（［ユーザー］タブ）でユーザーを選択し，［ユーザーグループ割り当て］ボタンをクリックすると表示されます。

図6‒36　［ユーザーグループ割り当て］ダイアログボックス

表示項目について説明します。

選択可能ユーザーグループ

割り当てられるユーザーグループの一覧が表示されます。表示項目のタイトルをクリックすると，昇順，または降順でソートできます。表示項目は，［列の表示・非表示設定］ダイアログボックスで選択できます。Hitachi Command Suite製品がすでにインストールされている場合，Hitachi Command Suite製品で作成したユーザーグループも選択できます。

表6‒30　選択可能ユーザーグループ一覧の表示項目（［ユーザーグループ割り当て］ダイアログボックス）

表示項目

初期表示

説明

ユーザーグループ

○　

ユーザーグループ名が表示されます。

説明

○　

ユーザーグループの説明が表示されます。ビルトインユーザーグループの場合は「Built-in user group」が表示されます。

ユーザー数

○　

ユーザーグループに所属しているユーザー数が表示されます。

（凡例）

○：表示されます。

［追加］ボタン

選択可能ユーザーグループからユーザーグループを選択してクリックすると，選択済みユーザーグループに選択したユーザーグループが表示されます。ユーザーグループは複数選択できます。

［削除］ボタン

選択済みユーザーグループからユーザーグループを選択してクリックすると，選択したユーザーグループが選択済みユーザーグループから削除されます。ユーザーグループは複数選択できます。

選択済みユーザーグループ

ユーザーに割り当てるユーザーグループの一覧が表示されます。表示項目のタイトルをクリックすると，昇順，または降順でソートできます。表示項目は，［列の表示・非表示設定］ダイアログボックスで選択できます。

表6‒31　選択済みユーザーグループ一覧の表示項目（［ユーザーグループ割り当て］ダイアログボックス）

表示項目

初期表示

説明

ユーザーグループ

○　

ユーザーグループ名が表示されます。

説明

○　

ユーザーグループの説明が表示されます。ビルトインユーザーグループの場合は「Built-in user group」が表示されます。

ユーザー数

○　

ユーザーグループに所属しているユーザー数が表示されます。

（凡例）

○：表示されます。

［OK］ボタン

クリックすると，ユーザーにユーザーグループが割り当てられます。

［キャンセル］ボタン

クリックすると，［ユーザーグループ割り当て］ダイアログボックスが閉じます。

6.10　［リソースグループ］ビュー

［リソースグループ］ビューは，リソースグループを管理するための画面です。

［リソースグループ］ビューは，［管理］画面で［リソースグループ］メニューを選択すると表示されます。

図6‒37　［リソースグループ］ビュー

表示項目について説明します。

リソースグループ

リソースグループの一覧が表示されます。表示項目のタイトルをクリックすると，昇順，または降順でソートできます。表示項目は，［列の表示・非表示設定］ダイアログボックスで選択できます。

表6‒32　リソースグループ一覧の表示項目（［リソースグループ］ビュー）

表示項目

初期表示

説明

リソースグループ

○　

リソースグループ名が表示されます。

説明

○　

リソースグループの説明が表示されます。ビルトインリソースグループの場合は「default resource groups which contains all resources」が表示されます。

ユーザーグループ

○　

リソースグループが割り当てられているユーザーグループが表示されます。

（凡例）

○：表示されます。

［リソースグループ作成］ボタン

クリックすると，［リソースグループ作成］ダイアログボックスが表示されます。

［リソースグループ編集］ボタン

リソースグループを選択してクリックすると，［リソースグループ編集］ダイアログボックスが表示されます。

［リソースグループ削除］ボタン

リソースグループを選択してクリックすると，［リソースグループ削除］ダイアログボックスが表示されます。リソースグループは複数選択できます。

6.10.1　［リソースグループ作成］ダイアログボックス

［リソースグループ作成］ダイアログボックスは，リソースグループを作成するための画面です。

［リソースグループ作成］ダイアログボックスは，［リソースグループ］ビューで［リソースグループ作成］ボタンをクリックすると表示されます。

図6‒38　［リソースグループ作成］ダイアログボックス

表示項目について説明します。

［名前］テキストボックス

リソースグループ名を入力します。63文字まで入力できます。

［説明］テキストボックス

リソースグループの説明を入力します。80文字まで入力できます。

［OK］ボタン

クリックすると，リソースグループが作成されます。

［キャンセル］ボタン

クリックすると，［リソースグループ作成］ダイアログボックスが閉じます。

6.10.2　［リソースグループ編集］ダイアログボックス

［リソースグループ編集］ダイアログボックスは，リソースグループの名前や説明を変更するための画面です。

［リソースグループ編集］ダイアログボックスは，［リソースグループ］ビューでリソースグループを選択し［リソースグループ編集］ボタンをクリックすると表示されます。

図6‒39　［リソースグループ編集］ダイアログボックス

表示項目について説明します。

［名前］テキストボックス

リソースグループ名が表示されます。変更するリソースグループ名を入力します。63文字まで入力できます。

［説明］テキストボックス

リソースグループの説明が表示されます。変更するリソースグループの説明を入力します。80文字まで入力できます。

［OK］ボタン

クリックすると，リソースグループの内容が変更されます。

［キャンセル］ボタン

クリックすると，［リソースグループ編集］ダイアログボックスが閉じます。

6.10.3　［リソースグループ削除］ダイアログボックス

［リソースグループ削除］ダイアログボックスは，リソースグループを削除するための画面です。

［リソースグループ削除］ダイアログボックスは，［リソースグループ］ビューでリソースグループを選択し［リソースグループ削除］ボタンをクリックすると表示されます。

図6‒40　［リソースグループ削除］ダイアログボックス

表示項目について説明します。

リソースグループ

削除するリソースグループの一覧が表示されます。表示項目のタイトルをクリックすると，昇順，または降順でソートできます。

表6‒33　リソースグループ一覧の表示項目（［リソースグループ削除］ダイアログボックス）

表示項目

説明

リソースグループ

リソースグループ名が表示されます。

説明

リソースグループの説明が表示されます。

［OK］ボタン

クリックすると，リソースグループが削除されます。

［キャンセル］ボタン

クリックすると，［リソースグループ削除］ダイアログボックスが閉じます。

6.11　［プロファイル］画面

［プロファイル］画面は，ユーザーのプロファイル情報を確認するための画面です。

［プロファイル］画面は，［管理］画面で［プロファイル］メニューを選択すると表示されます。

図6‒41　［プロファイル］画面

表示項目について説明します。

プロファイル

ユーザーのプロファイル情報が表示されます。

ユーザーID

ユーザーのIDが表示されます。

フルネーム

ユーザーの名前が表示されます。

E-mail

ユーザーのメールアドレスが表示されます。

説明

ユーザーの説明が表示されます。

設定されている権限

ユーザーが持っている権限の一覧が表示されます。表示項目のタイトルをクリックすると，昇順，または降順でソートできます。

表6‒34　設定されている権限の表示項目（［プロファイル］画面）

表示項目

説明

アプリケーション

設定されている権限の名称が表示されます。

Admin

ユーザーがUser Management権限を持っている場合，チェックが表示されます。

［プロファイル編集］ボタン

クリックすると，［プロファイル編集］ダイアログボックスが表示されます。

［パスワード変更］ボタン

クリックすると，［パスワード変更］ダイアログボックスが表示されます。

7　［エディタ］画面

JP1/AO の［エディタ］画面について説明します。

7.1　［エディタ］画面

［エディタ］画面は，サービステンプレートや部品を開発するための画面です。

［エディタ］画面は，メイン画面で［エディタ］タブを選択すると表示されます。

図7‒1　［エディタ］画面（左ペインに［部品］ビュー，右ペインに［サービステンプレートエディタホーム］ビューが表示されている場合）

表示項目について説明します。

左ペイン

次のビューが，操作によって切り替わります。

［部品］ビュー

部品を一覧で表示したり，開発したりするための画面です。部品を作成，編集，複製，または削除できます。

［デバッグ］ビュー

デバッグタスクを管理したり，ステップ単位の実行方法を設定するための画面です。［デバッグ］ビューは，［デバッグ実行］ダイアログボックスで［実行］ボタンをクリックすると表示されます。

右ペイン

次のビューが，操作によって切り替わります。

［サービステンプレートエディタホーム］ビュー

サービステンプレートの開発をするための画面です。サービステンプレートを作成，編集，複製，参照または削除できます。項目をクリックすると，目的に合った画面が表示されます。

サービステンプレートエディタ編集ビュー

サービステンプレートを編集するための画面です。サービステンプレートエディタ編集ビューは，次の操作によって表示されます。

［サービステンプレート一覧］ダイアログボックスで［編集］ボタンをクリックする

［サービステンプレート作成］ダイアログボックスまたは［サービステンプレート複製］ダイアログボックスで［保存］ボタンをクリックする

サービステンプレートデバッグビュー

サービステンプレートをデバッグするための画面です。サービステンプレートデバッグビューは，［デバッグ実行］ダイアログボックスで［実行］ボタンをクリックすると表示されます。

7.2　［部品］ビュー

［部品］ビューは，サービステンプレートを編集する場合に必要な部品を一覧表示したり，部品を開発したりするための画面です。［部品］ビューは，次の操作によって［エディタ］画面の左ペインに表示されます。

メイン画面で［エディタ］タブを選択する

ただし，サービステンプレートのデバッグ時は表示されない

サービステンプレートデバッグビューで［デバッグ終了］ボタンをクリックする

図7‒2　［部品］ビュー

表示項目について説明します。

部品種別選択エリア

部品種別選択エリアは，次のタブで構成されています。

［基本］タブ

基本部品の一覧が表示されるタブです。

［リリース］タブ

リリース部品の一覧が表示されるタブです。

［開発］タブ

開発部品の一覧が表示されるタブです。

部品詳細情報表示エリア

部品詳細情報表示エリアには，部品種別選択エリアで選択した部品の詳細情報が表示されます。表示される項目は次のとおりです。

部品名

部品の名称が表示されます。

部品バージョン

部品のバージョンが表示されます。

ベンダー名

部品のベンダー名が表示されます。

説明

部品の説明が表示されます。

［詳細情報］

クリックすると，次の情報が表示されます。

部品ID

部品IDが表示されます。

ベンダーID

部品のベンダーIDが表示されます。

カテゴリ名

部品のカテゴリ名が表示されます。

認証種別

部品の認証種別が表示されます。認証種別は，［部品］ビュー（［リリース］タブ）または［部品］ビュー（［開発］タブ）の部品を選択した場合に表示されます。

文字セット自動判定(SSH接続用)

部品の文字セット自動判定（SSH接続用）が有効かどうかが表示されます。文字セット自動判定（SSH接続用）は，［部品］ビュー（［リリース］タブ）または［部品］ビュー（［開発］タブ）の部品を選択した場合に表示されます。

root権限で実行(SSH接続用)

接続先ホストで実行するコマンドまたはスクリプトの権限について，SSHで接続する場合にroot権限で実行するかどうかが表示されます。root権限で実行（SSH接続用）は，［部品］ビュー（［リリース］タブ）または［部品］ビュー（［開発］タブ）の部品を選択した場合に表示されます。

入力プロパティ

部品一覧で選択した部品に定義されている入力プロパティの個数が表示されます。

出力プロパティ

部品一覧で選択した部品に定義されている出力プロパティの個数が表示されます。

プラットフォーム

部品に設定したコマンドまたはスクリプトが実行される機器のOSが表示されます。プラットフォームは，［部品］ビュー（［リリース］タブ）または［部品］ビュー（［開発］タブ）の部品を選択した場合に表示されます。

7.2.1　［部品］ビュー（［基本］タブ）

［部品］ビュー（［基本］タブ）は，基本部品を使ってサービステンプレートを作成または編集する場合に使用する画面です。［基本］タブを選択すると，基本部品の一覧が表示されます。

図7‒3　［部品］ビュー（［基本］タブ）

表示項目について説明します。

［表示］リストボックス

部品一覧の表示方法を選択します。

最新バージョンだけを表示

チェックすると，各部品の最新バージョンだけを表示します。チェックを外すと，すべての部品を表示します。

1ページの行数

一覧で1ページに表示する行数を選択します。行数は「30」「50」「100」「250」または「500」から選択できます。

部品一覧

基本部品の一覧が表示されます。表示項目のタイトルをクリックすると，昇順，または降順でソートできます。

表7‒1　部品一覧の表示項目（［部品］ビュー（［基本］タブ））

表示項目

説明

部品名

部品の名称が表示されます。

部品バージョン※

部品のバージョンが表示されます。

説明

部品の説明が表示されます。

注※

［部品バージョン］は，［表示］リストボックスで［最新バージョンだけを表示］をチェックしていない場合にだけ表示されます。

7.2.2　［部品］ビュー（［リリース］タブ）

［部品］ビュー（［リリース］タブ）は，リリース部品を使ってサービステンプレートを作成または編集する場合に使用する画面です。［リリース］タブを選択すると，リリース部品の一覧が表示されます。

図7‒4　［部品］ビュー（［リリース］タブ）

表示項目について説明します。

検索テキストボックス

検索するキーワードを入力します。256文字まで入力できます。

［オン］ラジオボタン

選択すると，検索結果が一覧に反映されます。

［オフ］ラジオボタン

選択すると，検索結果が一覧に反映されないで，すべての部品が表示されます。

［操作］リストボックス

部品に対して実行する操作を指定します。

複製

選択した部品を複製できます。選択すると，［部品複製］ダイアログボックスが表示されます。

削除

選択した部品を削除できます。選択すると，部品を削除するかどうかを確認するメッセージダイアログボックスが表示され，［OK］ボタンをクリックすると，部品が削除されます。

［表示］リストボックス

部品一覧の表示方法を選択します。

最新バージョンだけを表示

チェックすると，各部品の最新バージョンだけを表示します。チェックを外すと，すべての部品を表示します。

1ページの行数

一覧で1ページに表示する行数を選択します。行数は「30」「50」「100」「250」または「500」から選択できます。

部品一覧

リリース部品の一覧が表示されます。表示項目のタイトルをクリックすると，昇順，または降順でソートできます。

表7‒2　部品一覧の表示項目（［部品］ビュー（［リリース］タブ））

表示項目

説明

部品名

部品の名称が表示されます。

部品バージョン※

部品のバージョンが表示されます。

説明

部品の説明が表示されます。

注※

［部品バージョン］は，［表示］リストボックスで［最新バージョンだけを表示］をチェックしていない場合にだけ表示されます。

7.2.3　［部品］ビュー（［開発］タブ）

［部品］ビュー（［開発］タブ）は，部品を作成したり，作成した部品を使ってサービステンプレートを作成または編集したりする場合に使用する画面です。［開発］タブを選択すると，開発部品の一覧が表示されます。

図7‒5　［部品］ビュー（［開発］タブ）

表示項目について説明します。

検索テキストボックス

検索するキーワードを入力します。256文字まで入力できます。

［オン］ラジオボタン

選択すると，検索結果が一覧に反映されます。

［オフ］ラジオボタン

選択すると，検索結果が一覧に反映されないで，すべての部品が表示されます。

［作成］ボタン

部品を作成できます。クリックすると，［部品作成］ダイアログボックスが表示されます。

［編集］ボタン

部品を編集できます。クリックすると，［部品編集］ダイアログボックスが表示されます。

［操作］リストボックス

部品に対して実行する操作を指定します。

リソース設定

部品にリソースファイルを設定できます。選択すると，［部品リソース設定］ダイアログボックスが表示されます。

複製

部品を複製できます。選択すると，［部品複製］ダイアログボックスが表示されます。

削除

部品を削除できます。選択すると，部品を削除するかどうかを確認するメッセージダイアログボックスが表示され，［OK］ボタンをクリックすると，部品が削除されます。

［表示］リストボックス

部品一覧の表示方法を選択します。

最新バージョンだけを表示

チェックすると，各部品の最新バージョンだけを表示します。チェックを外すと，すべての部品を表示します。

1ページの行数

一覧で1ページに表示する行数を選択します。行数は「30」「50」「100」「250」または「500」から選択できます。

部品一覧

開発部品の一覧が表示されます。表示項目のタイトルをクリックすると，昇順，または降順でソートできます。

表7‒3　部品一覧の表示項目（［部品］ビュー（［開発］タブ））

表示項目

説明

部品名

部品の名称が表示されます。

部品バージョン※

部品のバージョンが表示されます。

説明

部品の説明が表示されます。

注※

［部品バージョン］は，［表示］リストボックスで［最新バージョンだけを表示］をチェックしていない場合にだけ表示されます。

7.2.4　［部品複製］ダイアログボックス

［部品複製］ダイアログボックスは，選択した部品を複製するための画面です。［部品複製］ダイアログボックスは，［部品］ビュー（［リリース］タブ）または［部品］ビュー（［開発］タブ）で，［操作］リストボックスから［複製］を選択すると表示されます。

図7‒6　［部品複製］ダイアログボックス

表示項目について説明します。

［部品ID］テキストボックス

部品IDを入力します。64文字まで入力できます。ただし，部品IDおよびベンダーIDの文字数の合計が，115文字以内になるように指定してください。

［部品バージョン］テキストボックス

部品のバージョンを入力します。「メジャーバージョン番号.マイナーバージョン番号.リビジョン番号」の形式で入力します。各番号は，00から99までの2桁の数字で入力します。

［ベンダーID］テキストボックス

部品のベンダーIDを入力します。64文字まで入力できます。ただし，部品IDおよびベンダーIDの文字数の合計が，115文字以内になるように指定してください。

［部品名］テキストボックス

部品の名称を入力します。64文字まで入力できます。

［ベンダー名］テキストボックス

部品のベンダー名を入力します。64文字まで入力できます。

［説明］テキストボックス

部品の説明を入力します。256文字まで入力できます。

［カテゴリ名］テキストボックス

部品のカテゴリ名を入力します。256文字まで入力できます。カテゴリを階層化する場合は，「/」で区切って入力します。なお，カテゴリの階層数の上限は10階層です。複数のカテゴリに設定する場合は，カテゴリとカテゴリの間を「,」で区切って入力します。カテゴリの各階層には値を必ず入力してください。

［保存］ボタン

クリックすると，部品が複製され，［部品編集］ダイアログボックスが表示されます。

［キャンセル］ボタン

クリックすると，［部品複製］ダイアログボックスが閉じます。

注意事項

部品ID，部品バージョンおよびベンダーIDのうち，少なくとも1つは変更しないと，部品を複製できません。

7.2.5　［部品作成］ダイアログボックス

［部品作成］ダイアログボックスは，部品を新規に作成するための画面です。［部品作成］ダイアログボックスは，［部品］ビュー（［開発］タブ）の［作成］ボタンをクリックすると表示されます。

図7‒7　［部品作成］ダイアログボックス

表示項目について説明します。

部品

部品の定義情報を指定します。

［部品ID］テキストボックス

部品IDを入力します。64文字まで入力できます。ただし，部品IDおよびベンダーIDの文字数の合計が，115文字以内になるように指定してください。

［部品バージョン］テキストボックス

部品のバージョンを入力します。「メジャーバージョン番号.マイナーバージョン番号.リビジョン番号」の形式で入力します。各番号は，00から99までの2桁の数字で入力します。

［ベンダーID］テキストボックス

部品のベンダーIDを入力します。64文字まで入力できます。ただし，部品IDおよびベンダーIDの文字数の合計が，115文字以内になるように指定してください。

［部品名］テキストボックス

部品の名称を入力します。64文字まで入力できます。

［ベンダー名］テキストボックス

部品のベンダー名を入力します。64文字まで入力できます。

［説明］テキストボックス

部品の説明を入力します。256文字まで入力できます。

［カテゴリ名］テキストボックス

部品のカテゴリ名を入力します。256文字まで入力できます。カテゴリを階層化する場合は，「/」で区切って入力します。なお，カテゴリの階層数の上限は10階層です。複数のカテゴリに設定する場合は，カテゴリとカテゴリの間を「,」で区切って入力します。カテゴリの各階層には値を必ず入力してください。

アイコン

部品に指定されているアイコンが表示されます。

［標準に戻す］ボタン

クリックすると，部品に設定したアイコンがデフォルトに戻ります。

［変更］ボタン

クリックすると，アップロードする部品アイコンファイルを選択するダイアログボックスが表示され，部品のアイコンが変更できます。pngファイルを部品アイコンとして設定できます。

［認証種別］ラジオボタン

部品の認証種別を次から選択します。

エージェントレス接続先設定を使用

サービス実行時に，［エージェントレス接続先定義］ビューに設定されている認証情報を使用する場合に，選択します。

プロパティで指定

認証情報を入力プロパティで指定する場合に，選択します。

［文字セット自動判定(SSH接続用)］チェックボックス

チェックすると，文字セット自動判定が有効になります。文字セット自動判定の詳細については，マニュアル「JP1/AO サービステンプレート開発ガイド」−「部品実行時に設定される操作対象の機器のロケールについて」のトピックを参照してください。

［root権限で実行(SSH接続用)］チェックボックス

チェックすると，接続先ホストで実行するコマンドまたはスクリプトがroot権限で実行されます。

［入力プロパティ一覧］

クリックすると，入力プロパティ一覧が表示されます。

入力プロパティ一覧

部品の入力プロパティ一覧が表示されます。

表7‒4　入力プロパティ一覧の表示項目（［部品作成］ダイアログボックス）

表示項目

説明

プロパティキー

プロパティキーが表示されます。

プロパティ名

入力プロパティの名称が表示されます。

説明

入力プロパティの説明が表示されます。

［追加］ボタン

入力プロパティを作成できます。クリックすると，［部品の入力プロパティ作成］ダイアログボックスが表示されます。

［編集］ボタン

選択した入力プロパティを編集できます。クリックすると，［部品の入力プロパティ編集］ダイアログボックスが表示されます。

［削除］ボタン

選択した入力プロパティを削除できます。クリックすると，プロパティを削除するかどうかを確認するメッセージダイアログボックスが表示され，［OK］ボタンをクリックすると，プロパティが削除されます。

［出力プロパティ一覧］

クリックすると，出力プロパティ一覧が表示されます。

出力プロパティ一覧

部品の出力プロパティ一覧が表示されます。

表7‒5　出力プロパティ一覧の表示項目（［部品作成］ダイアログボックス）

表示項目

説明

プロパティキー

プロパティキーが表示されます。

プロパティ名

出力プロパティの名称が表示されます。

説明

出力プロパティの説明が表示されます。

［追加］ボタン

出力プロパティを作成できます。クリックすると，［部品の出力プロパティ作成］ダイアログボックスが表示されます。

［編集］ボタン

選択した出力プロパティを編集できます。クリックすると，［部品の出力プロパティ編集］ダイアログボックスが表示されます。

［削除］ボタン

選択した出力プロパティを削除できます。クリックすると，プロパティを削除するかどうかを確認するメッセージダイアログボックスが表示され，［OK］ボタンをクリックすると，プロパティが削除されます。

リモートコマンド

リモートコマンド操作対象の機器のOSに対応したリモートコマンドの実行モードを設定します。

Windows，Linux，AIX，HP-UX，Solaris

それぞれのOSの場合のリモートコマンドの実行モードが表示されます。

［編集］ボタン

それぞれのOS用のリモートコマンドを編集できます。クリックすると，［リモートコマンド編集］ダイアログボックスが表示されます。

［保存］ボタン

クリックすると，部品が作成されます。

［キャンセル］ボタン

クリックすると，［部品作成］ダイアログボックスが閉じます。

7.2.6　［部品編集］ダイアログボックス

［部品編集］ダイアログボックスは，部品の定義情報を編集するための画面です。［部品編集］ダイアログボックスは，［部品］ビュー（［開発］タブ）で［編集］ボタンをクリックするか，［部品複製］ダイアログボックスの［保存］ボタンをクリックすると表示されます。

図7‒8　［部品編集］ダイアログボックス

表示項目について説明します。

部品

編集する部品の定義情報を指定します。

部品ID

部品IDが表示されます。

部品バージョン

部品のバージョンが表示されます。

ベンダーID

部品のベンダーIDが表示されます。

［部品名］テキストボックス

部品の名称を入力します。64文字まで入力できます。

［ベンダー名］テキストボックス

部品のベンダー名を入力します。64文字まで入力できます。

［説明］テキストボックス

部品の説明を入力します。256文字まで入力できます。

［カテゴリ名］テキストボックス

部品のカテゴリ名を入力します。256文字まで入力できます。カテゴリを階層化する場合は，「/」で区切って入力します。なお，カテゴリの階層数の上限は10階層です。複数のカテゴリに設定する場合は，カテゴリとカテゴリの間を「,」で区切って入力します。カテゴリの各階層には値を必ず入力してください。

アイコン

部品に指定されているアイコンが表示されます。

［標準に戻す］ボタン

クリックすると，部品に設定したアイコンがデフォルトに戻ります。

［変更］ボタン

クリックすると，アップロードする部品アイコンファイルを選択するダイアログボックスが表示され，部品のアイコンが変更できます。pngファイルを部品アイコンとして設定できます。

［認証種別］ラジオボタン

部品の認証種別を次から選択します。

エージェントレス接続先設定を使用

サービス実行時に，［エージェントレス接続先定義］ビューに設定されている認証情報を使用する場合に，選択します。

プロパティで指定

認証情報を入力プロパティで指定する場合に，選択します。

［文字セット自動判定(SSH接続用)］チェックボックス

チェックすると，文字セット自動判定が有効になります。文字セット自動判定の詳細については，マニュアル「JP1/AO サービステンプレート開発ガイド」−「部品実行時に設定される操作対象の機器のロケールについて」のトピックを参照してください。

［root権限で実行(SSH接続用)］チェックボックス

チェックすると，接続先ホストで実行するコマンドまたはスクリプトがroot権限で実行されます。

［入力プロパティ一覧］

クリックすると，入力プロパティ一覧が表示されます。

入力プロパティ一覧

部品の入力プロパティ一覧が表示されます。

表7‒6　入力プロパティ一覧の表示項目（［部品編集］ダイアログボックス）

表示項目

説明

プロパティキー

プロパティキーが表示されます。

プロパティ名

入力プロパティの名称が表示されます。

説明

入力プロパティの説明が表示されます。

［追加］ボタン

入力プロパティを作成できます。クリックすると，［部品の入力プロパティ作成］ダイアログボックスが表示されます。

［編集］ボタン

選択した入力プロパティを編集できます。クリックすると，［部品の入力プロパティ編集］ダイアログボックスが表示されます。

［削除］ボタン

選択した入力プロパティを削除できます。クリックすると，プロパティを削除するかどうかを確認するメッセージダイアログボックスが表示され，［OK］ボタンをクリックすると，プロパティが削除されます。

［出力プロパティ一覧］

クリックすると，出力プロパティ一覧が表示されます。

出力プロパティ一覧

部品の出力プロパティ一覧が表示されます。

表7‒7　出力プロパティ一覧の表示項目（［部品編集］ダイアログボックス）

表示項目

説明

プロパティキー

プロパティキーが表示されます。

プロパティ名

出力プロパティの名称が表示されます。

説明

出力プロパティの説明が表示されます。

［追加］ボタン

出力プロパティを作成できます。クリックすると，［部品の出力プロパティ作成］ダイアログボックスが表示されます。

［編集］ボタン

選択した出力プロパティを編集できます。クリックすると，［部品の出力プロパティ編集］ダイアログボックスが表示されます。

［削除］ボタン

選択した出力プロパティを削除できます。クリックすると，プロパティを削除するかどうかを確認するメッセージダイアログボックスが表示され，［OK］ボタンをクリックすると，プロパティが削除されます。

リモートコマンド

リモートコマンド操作対象の機器のOSに対応した実行モードが表示されます。

Windows，Linux，AIX，HP-UX，Solaris

それぞれのOSの場合のリモートコマンドの実行モードが表示されます。

［編集］ボタン

それぞれのOS用のリモートコマンドを編集できます。クリックすると，［リモートコマンド編集］ダイアログボックスが表示されます。

［保存］ボタン

クリックすると，変更した内容が反映されます。

［キャンセル］ボタン

クリックすると，［部品編集］ダイアログボックスが閉じます。

7.2.7　［部品リソース設定］ダイアログボックス

［部品リソース設定］ダイアログボックスは，部品リソースファイルをアップロードしたり，ダウンロードしたりするための画面です。［部品リソース設定］ダイアログボックスは，［部品］ビュー（［開発］タブ）の［操作］リストボックスから，［リソース設定］を選択すると表示されます。

図7‒9　［部品リソース設定］ダイアログボックス

表示項目について説明します。

部品リソースファイル

部品リソースファイルが表示されます。

日本語

部品リソースファイル名が表示されます。ファイル名をクリックすると，ファイルをダウンロードできます。

［更新］ボタン

クリックすると，編集した部品リソースファイルをアップロードするダイアログボックスが表示されます。ファイルを選択し［開く］をクリックすると，ファイルを更新するかどうか確認するメッセージダイアログボックスが表示され，［OK］をクリックするとファイルが更新されます。登録できる部品リソースファイルの名称は，「plugin_ja.properties.txt」だけです。

［閉じる］ボタン

クリックすると，［部品リソース設定］ダイアログボックスが閉じます。

7.2.8　［部品の入力プロパティ作成］ダイアログボックス

［部品の入力プロパティ作成］ダイアログボックスは，部品に入力プロパティを追加するための画面です。［部品の入力プロパティ作成］ダイアログボックスは，［部品作成］ダイアログボックスまたは［部品編集］ダイアログボックスで，［入力プロパティ一覧］の［追加］ボタンをクリックすると表示されます。

図7‒10　［部品の入力プロパティ作成］ダイアログボックス

表示項目について説明します。

［プロパティキー］テキストボックス

プロパティキーを入力します。128文字まで入力できます。

［プロパティ名］テキストボックス

プロパティの名称を入力します。128文字まで入力できます。

［説明］テキストボックス

プロパティの説明を入力します。256文字まで入力できます。

［必須区分］チェックボックス

プロパティの必須区分を設定します。チェックすると，入力が必須のプロパティになります。

［デフォルト値］テキストボックス

プロパティのデフォルト値を入力します。1,024文字まで入力できます。

［OK］ボタン

クリックすると，入力プロパティが追加されます。

［キャンセル］ボタン

クリックすると，［部品の入力プロパティ作成］ダイアログボックスが閉じます。

7.2.9　［部品の入力プロパティ編集］ダイアログボックス

［部品の入力プロパティ編集］ダイアログボックスは，部品に定義されている入力プロパティを編集するための画面です。［部品の入力プロパティ編集］ダイアログボックスは，［部品作成］ダイアログボックスまたは［部品編集］ダイアログボックスで，［入力プロパティ一覧］の［編集］ボタンをクリックすると表示されます。

図7‒11　［部品の入力プロパティ編集］ダイアログボックス

表示項目について説明します。

［プロパティキー］テキストボックス

プロパティキーを入力します。128文字まで入力できます。［プロパティキー］テキストボックスは，予約部品プロパティを選択した場合，編集できません。

［プロパティ名］テキストボックス

プロパティの名称を入力します。128文字まで入力できます。

［説明］テキストボックス

プロパティの説明を入力します。256文字まで入力できます。

［必須区分］チェックボックス

プロパティの必須区分を設定します。チェックすると，入力が必須のプロパティになります。［必須区分］チェックボックスは，予約部品プロパティ「plugin.destinationHost」，「plugin.account」，「plugin.publicKeyAuthentication」または「plugin.keyboardInteractiveAuthentication」を選択した場合，編集できません。

［デフォルト値］テキストボックス

プロパティのデフォルト値を入力します。1,024文字まで入力できます。

［OK］ボタン

クリックすると，変更した内容が反映されます。

［キャンセル］ボタン

クリックすると，［部品の入力プロパティ編集］ダイアログボックスが閉じます。

7.2.10　［部品の出力プロパティ作成］ダイアログボックス

［部品の出力プロパティ作成］ダイアログボックスは，部品に出力プロパティを追加するための画面です。［部品の出力プロパティ作成］ダイアログボックスは，［部品作成］ダイアログボックスまたは［部品編集］ダイアログボックスで，［出力プロパティ一覧］の［追加］ボタンをクリックすると表示されます。

図7‒12　［部品の出力プロパティ作成］ダイアログボックス

表示項目について説明します。

［プロパティキー］テキストボックス

プロパティキーを入力します。128文字まで入力できます。

［プロパティ名］テキストボックス

プロパティの名称を入力します。128文字まで入力できます。

［説明］テキストボックス

プロパティの説明を入力します。256文字まで入力できます。

［OK］ボタン

クリックすると，出力プロパティが追加されます。

［キャンセル］ボタン

クリックすると，［部品の出力プロパティ作成］ダイアログボックスが閉じます。

7.2.11　［部品の出力プロパティ編集］ダイアログボックス

［部品の出力プロパティ編集］ダイアログボックスは，部品に定義されている出力プロパティを編集するための画面です。［部品の出力プロパティ編集］ダイアログボックスは，［部品作成］ダイアログボックスまたは［部品編集］ダイアログボックスで，［出力プロパティ一覧］の［編集］ボタンをクリックすると表示されます。

図7‒13　［部品の出力プロパティ編集］ダイアログボックス

表示項目について説明します。

［プロパティキー］テキストボックス

プロパティキーを入力します。128文字まで入力できます。

［プロパティ名］テキストボックス

プロパティの名称を入力します。128文字まで入力できます。

［説明］テキストボックス

プロパティの説明を入力します。256文字まで入力できます。

［OK］ボタン

クリックすると，変更した内容が反映されます。

［キャンセル］ボタン

クリックすると，［部品の出力プロパティ編集］ダイアログボックスが閉じます。

7.2.12　［リモートコマンド編集］ダイアログボックス

［リモートコマンド編集］ダイアログボックスは，部品で実行するリモートコマンドを設定するための画面です。［リモートコマンド編集］ダイアログボックスは，［部品作成］ダイアログボックスまたは［部品編集］ダイアログボックスで，リモートコマンドの［編集］ボタンをクリックすると表示されます。

図7‒14　［リモートコマンド編集］ダイアログボックス（［実行モード］に［スクリプト］，［スクリプト設定］に［添付］を選択した場合）

表示項目について説明します。

プラットフォーム

リモートコマンド操作対象の機器のOSが表示されます。

［他のプラットフォームの定義情報を取り込む］リストボックス

どのプラットフォームのリモートコマンドの定義情報を取り込むかを選択します。選択できるのはWindows，AIX，HP-UX，Linux，Solarisです。なお，添付ファイルは取り込まれないため，定義情報の取り込み後に，指定したプラットフォームの添付ファイルをアップロードする必要があります。

［実行モード］ラジオボタン

リモートコマンドの実行モードを選択します。

スクリプト

ユーザーが作成したスクリプトを設定したい場合に選択します。

コマンド

操作対象の機器に格納されているコマンドを設定したい場合に選択します。

実行しない

リモートコマンドを実行しない場合に選択します。

［コマンドライン］テキストボックス

コマンドラインを入力します。8,192文字まで入力できます。［コマンドライン］テキストボックスは，［実行モード］ラジオボタンで，［スクリプト］または［コマンド］を選択した場合に表示されます。

［すべての入力プロパティを挿入］ボタン

クリックすると，その部品に定義されているすべての入力プロパティが，「?dna_プロパティキー1? ?dna_プロパティキー2?…」の形式で，［コマンドライン］テキストボックスに入力されます。［すべての入力プロパティを挿入］ボタンは，［実行モード］ラジオボタンで，［スクリプト］または［コマンド］を選択した場合に表示されます。

［スクリプト設定］ラジオボタン

スクリプトの設定方法を選択します。［スクリプト設定］ラジオボタンは，［実行モード］ラジオボタンで，［スクリプト］を選択した場合に表示されます。

添付

スクリプトを添付する場合に設定します。

直接入力

スクリプトを直接入力する場合に選択します。

ファイル

添付するスクリプトのファイル名が表示されます。

アップロード済みの場合は，ファイル名をクリックすると，ファイルをダウンロードできます。［ファイル］は，［スクリプト設定］ラジオボタンで，［添付］を選択した場合に表示されます。

［選択］ボタン

クリックすると，添付するスクリプトファイルを選択するダイアログボックスが表示されます。スクリプトファイル名（zipファイルの場合はzipファイル内の相対パス）が90文字以内かつ，部品ID，ベンダーIDおよびファイル名（zipファイルの場合はzipファイル内の相対パス）の文字数の合計が，123文字以内になるように指定してください。

［選択］ボタンは，［スクリプト設定］ラジオボタンで，［添付］を選択した場合に表示されます。

［ファイル名］テキストボックス

［スクリプト］テキストボックスに入力したスクリプトのファイル名を入力します。ファイル名が90文字以内かつ，部品ID，ベンダーIDおよびファイル名の文字数の合計が，123文字以内になるように指定してください。［スクリプト］テキストボックスに入力したスクリプトは，［ファイル名］テキストボックスで設定したファイル名でアップロードされます。［ファイル名］テキストボックスは，［スクリプト設定］ラジオボタンで，［直接入力］を選択した場合に表示されます。

［スクリプト］テキストボックス

操作対象の機器で実行したいスクリプトを入力します。5,000文字まで入力できます。［スクリプト］テキストボックスに入力したスクリプトは，［ファイル名］テキストボックスで設定したファイル名でアップロードされます。［スクリプト］テキストボックスは，［スクリプト設定］ラジオボタンで，［直接入力］を選択した場合に表示されます。

出力プロパティのマッピング定義一覧

出力プロパティのマッピング定義一覧が表示されます。表示項目のタイトルをクリックすると，昇順，または降順でソートできます。

表7‒8　出力プロパティのマッピング定義一覧の表示項目（［リモートコマンド編集］ダイアログボックス）

表示項目

説明

プロパティキー

プロパティキーが表示されます。

プロパティ名

出力プロパティの名称が表示されます。

説明

出力プロパティの説明が表示されます。

出力フィルタ

出力プロパティの出力フィルタが表示されます。

［編集］ボタン

出力プロパティの出力フィルタを編集できます。クリックすると，［出力フィルタ編集］ダイアログボックスが表示されます。

［詳細設定］

クリックすると，［実行ディレクトリ］テキストボックスおよび環境変数の一覧を表示します。

［実行ディレクトリ］テキストボックス

設定したコマンドやスクリプトを実行する対象の機器のディレクトリを入力します。256文字まで入力できます。

環境変数

コマンドまたはスクリプト実行時に必要な環境変数の一覧が表示されます。表示項目のタイトルをクリックすると，昇順，または降順でソートできます。

表7‒9　環境変数の表示項目（［リモートコマンド編集］ダイアログボックス）

表示項目

説明

変数名

環境変数の名称が表示されます。

値

環境変数に設定した値が表示されます。

［追加］ボタン

環境変数を作成できます。クリックすると，［環境変数作成］ダイアログボックスが表示されます。

［編集］ボタン

選択した環境変数を編集できます。クリックすると，［環境変数編集］ダイアログボックスが表示されます。

［削除］ボタン

選択した環境変数を削除できます。クリックすると，選択した環境変数を削除するかどうかを確認するメッセージダイアログボックスが表示され，［OK］ボタンをクリックすると，環境変数が削除されます。

［OK］ボタン

クリックすると，変更した内容が反映されます。

［キャンセル］ボタン

クリックすると，［リモートコマンド編集］ダイアログボックスが閉じます。

7.2.13　［環境変数作成］ダイアログボックス

［環境変数作成］ダイアログボックスは，リモートコマンド実行時に必要な環境変数を作成するための画面です。［環境変数作成］ダイアログボックスは，［リモートコマンド編集］ダイアログボックスで，環境変数の［追加］ボタンをクリックすると表示されます。

図7‒15　［環境変数作成］ダイアログボックス

表示項目について説明します。

［変数名］テキストボックス

作成する環境変数の名称を入力します。256文字まで入力できます。

［値］テキストボックス

作成する環境変数の値を入力します。2,048文字まで入力できます。

［OK］ボタン

クリックすると，環境変数が追加されます。

［キャンセル］ボタン

クリックすると，［環境変数作成］ダイアログボックスが閉じます。

7.2.14　［環境変数編集］ダイアログボックス

［環境変数編集］ダイアログボックスは，リモートコマンド実行時に必要な環境変数を編集するための画面です。［環境変数編集］ダイアログボックスは，［リモートコマンド編集］ダイアログボックスで，環境変数の［編集］ボタンをクリックすると表示されます。

図7‒16　［環境変数編集］ダイアログボックス

表示項目について説明します。

［変数名］テキストボックス

編集する環境変数の名称を入力します。256文字まで入力できます。

［値］テキストボックス

編集する環境変数の値を入力します。2,048文字まで入力できます。

［OK］ボタン

クリックすると，変更した内容が反映されます。

［キャンセル］ボタン

クリックすると，［環境変数編集］ダイアログボックスが閉じます。

7.2.15　［出力フィルタ編集］ダイアログボックス

［出力フィルタ編集］ダイアログボックスは，出力フィルタを設定するための画面です。出力フィルタとは，標準出力または標準エラー出力の値から，出力プロパティに格納する値を切り出すための正規表現のことです。［出力フィルタ編集］ダイアログボックスは，［リモートコマンド編集］ダイアログボックスで，［出力プロパティのマッピング定義一覧］の［編集］ボタンをクリックすると表示されます。

図7‒17　［出力フィルタ編集］ダイアログボックス

表示項目について説明します。

プロパティキー

出力プロパティのプロパティキーが表示されます。

プロパティ名

出力プロパティの名称が表示されます。

説明

出力プロパティの説明が表示されます。

［出力フィルタ］テキストボックス

出力フィルタを入力します。1,024文字まで入力できます。PCREに従った正規表現を指定します。

［出力フィルタの動作確認］

クリックすると，［標準出力/標準エラー出力］テキストボックス，［出力フィルタの動作確認］ボタンおよび［出力プロパティの値］表示エリアが表示されます。

［標準出力/標準エラー出力］テキストボックス

設定した出力フィルタの動作確認に使うテストデータを入力します。500,000文字まで入力できます。

［出力フィルタの動作確認］ボタン

クリックすると，［標準出力/標準エラー出力］テキストボックスに入力されたデータを使い，出力フィルタの動作を確認します。

［出力プロパティの値］表示エリア

出力フィルタの動作確認の結果が表示されます。

［OK］ボタン

クリックすると，変更した内容が反映されます。

［キャンセル］ボタン

クリックすると，［出力フィルタ編集］ダイアログボックスが閉じます。

7.3　［サービステンプレートエディタホーム］ビュー

［サービステンプレートエディタホーム］ビューは，サービステンプレートを開発するための画面です。［サービステンプレートエディタホーム］ビューは，メイン画面で［エディタ］タブを選択すると［エディタ］画面の右ペインに表示されます。ただし，サービステンプレートのデバッグ時は表示されません。

図7‒18　［サービステンプレートエディタホーム］ビュー

表示項目について説明します。

作成

サービステンプレートを新規に作成できます。クリックすると，［サービステンプレート作成］ダイアログボックスが表示されます。

編集

既存のサービステンプレートを編集できます。クリックすると，［サービステンプレート一覧］ダイアログボックスが表示されます。

複製

既存のサービステンプレートを複製できます。クリックすると，［サービステンプレート一覧］ダイアログボックスが表示されます。

参照

既存のサービステンプレートを参照できます。クリックすると，［サービステンプレート一覧］ダイアログボックスが表示されます。

削除

既存のサービステンプレートを削除できます。クリックすると，［サービステンプレート一覧］ダイアログボックスが表示されます。

7.3.1　［サービステンプレート作成］ダイアログボックス

［サービステンプレート作成］ダイアログボックスは，サービステンプレートを新規に作成するための画面です。［サービステンプレート作成］ダイアログボックスは，［サービステンプレートエディタホーム］ビューで［作成］をクリックすると表示されます。

図7‒19　［サービステンプレート作成］ダイアログボックス

表示項目について説明します。

［サービステンプレートID］テキストボックス

サービステンプレートIDを入力します。64文字まで入力できます。ただし，サービステンプレートIDおよびベンダーIDの文字数の合計が，112文字以内になるように指定してください。

［サービステンプレートバージョン］テキストボックス

サービステンプレートのバージョンを入力します。「メジャーバージョン番号.マイナーバージョン番号.リビジョン番号」の形式で入力します。各番号は，00から99までの2桁の数字で入力します。

［ベンダーID］テキストボックス

サービステンプレートのベンダーIDを入力します。64文字まで入力できます。ただし，サービステンプレートIDおよびベンダーIDの文字数の合計が，112文字以内になるように指定してください。

［サービステンプレート名］テキストボックス

サービステンプレートの名称を入力します。64文字まで入力できます。

［ベンダー名］テキストボックス

サービステンプレートのベンダー名を入力します。64文字まで入力できます。

［説明］テキストボックス

サービステンプレートの説明を入力します。256文字まで入力できます。

［カテゴリ名］テキストボックス

サービステンプレートのカテゴリ名を入力します。256文字まで入力できます。カテゴリを階層化する場合は，「/」で区切って入力します。なお，カテゴリの階層数の上限は10階層です。複数のカテゴリに設定する場合は，カテゴリとカテゴリの間を「,」で区切って入力します。カテゴリの各階層には値を必ず入力してください。

［保存］ボタン

クリックすると，サービステンプレートが作成され，サービステンプレートエディタ編集ビューが［エディタ］画面の右ペインに表示されます。

［キャンセル］ボタン

クリックすると，［サービステンプレート作成］ダイアログボックスが閉じます。

7.3.2　［サービステンプレート一覧］ダイアログボックス

［サービステンプレート一覧］ダイアログボックスは，サービステンプレートを一覧で表示し，編集，複製，参照，または削除する対象のサービステンプレートを選択するための画面です。［サービステンプレート一覧］ダイアログボックスは，［サービステンプレートエディタホーム］ビューで，［編集］，［複製］，［参照］または［削除］をクリックするか，サービステンプレートエディタ編集ビューで，［操作］リストボックスから［参照］を選択すると表示されます。

図7‒20　［サービステンプレート一覧］ダイアログボックス（［サービステンプレートエディタホーム］ビューの［複製］をクリックして表示した場合）

表示項目について説明します。

［リリース］タブ

クリックすると，リリースサービステンプレートの一覧が表示されます。［リリース］タブは，［サービステンプレートエディタホーム］ビューで，［複製］または［参照］をクリックするか，サービステンプレートエディタ編集ビューで，［操作］リストボックスから［参照］を選択すると表示されます。

［開発］タブ

クリックすると，開発サービステンプレートの一覧が表示されます。

検索テキストボックス

検索するキーワードを入力します。256文字まで入力できます。

［オン］ラジオボタン

選択すると，検索結果が一覧に反映されます。

［オフ］ラジオボタン

選択すると，検索結果が一覧に反映されないで，すべてのサービステンプレートが表示されます。

［最新バージョンだけを表示］チェックボックス

チェックすると，各サービステンプレートの最新バージョンだけを表示します。チェックを外すと，すべてのサービステンプレートを表示します。

［列の表示・非表示］ボタン

一覧に表示する項目を選択できます。クリックすると，［列の表示・非表示設定］ダイアログボックスが表示されます。

［1ページの行数］リストボックス

一覧で1ページに表示する行数を選択します。行数は「30」「50」「100」「250」または「500」から選択できます。

サービステンプレート一覧

サービステンプレートの一覧が表示されます。表示項目のタイトルをクリックすると，昇順，または降順でソートできます。表示項目は，［列の表示・非表示設定］ダイアログボックスで選択できます。

表7‒10　サービステンプレート一覧の表示項目（［サービステンプレート一覧］ダイアログボックス）

表示項目

初期表示

説明

サービステンプレート名

○　

サービステンプレートの名称が表示されます。

説明

○　

サービステンプレートの説明が表示されます。

サービステンプレートバージョン

○　

サービステンプレートのバージョンが表示されます。

カテゴリ名

○　

サービステンプレートのカテゴリ名が表示されます。

ベンダー名

○　

サービステンプレートのベンダー名が表示されます。

サービステンプレートID

×　

サービステンプレートIDが表示されます。

ベンダーID

×　

サービステンプレートのベンダーIDが表示されます。

（凡例）

○：表示されます。　×：表示されません。

［編集］ボタン

選択したサービステンプレートを編集できます。クリックすると，［サービステンプレート一覧］ダイアログボックスが閉じ，サービステンプレートエディタ編集ビューが［エディタ］画面の右ペインに表示されます。［編集］ボタンは，［サービステンプレートエディタホーム］ビューで［編集］をクリックして［サービステンプレート一覧］ダイアログボックスを表示した場合に，表示されます。

［複製］ボタン

選択したサービステンプレートを複製できます。クリックすると，［サービステンプレート複製］ダイアログボックスが表示されます。［複製］ボタンは，［サービステンプレートエディタホーム］ビューで［複製］をクリックして［サービステンプレート一覧］ダイアログボックスを表示した場合に，表示されます。

［参照］ボタン

選択したサービステンプレートを参照できます。クリックすると［サービステンプレート一覧］ダイアログボックスが閉じ，サービステンプレートエディタ参照ダイアログボックスが表示されます。［参照］ボタンは，［サービステンプレートエディタホーム］ビューで［参照］をクリックするか，サービステンプレートエディタ編集ビューで，［操作］リストボックスから［参照］を選択すると表示されます。

［削除］ボタン

選択したサービステンプレートを削除できます。クリックすると，サービステンプレートを削除するかどうかを確認するメッセージダイアログボックスが表示され，［OK］ボタンをクリックすると，サービステンプレートが削除されます。［削除］ボタンは，［サービステンプレートエディタホーム］ビューで［削除］をクリックして［サービステンプレート一覧］ダイアログボックスを表示した場合に，表示されます。

［閉じる］ボタン

クリックすると，［サービステンプレート一覧］ダイアログボックスが閉じます。

7.3.3　［サービステンプレート複製］ダイアログボックス

［サービステンプレート複製］ダイアログボックスは，サービステンプレートを複製するための画面です。［サービステンプレート複製］ダイアログボックスは，［サービステンプレート一覧］ダイアログボックスで［複製］ボタンをクリックすると表示されます。

図7‒21　［サービステンプレート複製］ダイアログボックス

表示項目について説明します。

［サービステンプレートID］テキストボックス

サービステンプレートIDを入力します。64文字まで入力できます。ただし，サービステンプレートIDおよびベンダーIDの文字数の合計が，112文字以内になるように指定してください。

［サービステンプレートバージョン］テキストボックス

サービステンプレートのバージョンを入力します。「メジャーバージョン番号.マイナーバージョン番号.リビジョン番号」の形式で入力します。各番号は，00から99までの2桁の数字で入力します。

［ベンダーID］テキストボックス

サービステンプレートのベンダーIDを入力します。64文字まで入力できます。ただし，サービステンプレートIDおよびベンダーIDの文字数の合計が，112文字以内になるように指定してください。

［サービステンプレート名］テキストボックス

サービステンプレートの名称を入力します。64文字まで入力できます。

［ベンダー名］テキストボックス

サービステンプレートのベンダー名を入力します。64文字まで入力できます。

［説明］テキストボックス

サービステンプレートの説明を入力します。256文字まで入力できます。

［カテゴリ名］テキストボックス

サービステンプレートのカテゴリ名を入力します。256文字まで入力できます。カテゴリを階層化する場合は，「/」で区切って入力します。なお，カテゴリの階層数の上限は10階層です。複数のカテゴリに設定する場合は，カテゴリとカテゴリの間を「,」で区切って入力します。カテゴリの各階層には値を必ず入力してください。

［保存］ボタン

クリックすると，サービステンプレートが複製され，サービステンプレートエディタ編集ビューが［エディタ］画面の右ペインに表示されます。

［キャンセル］ボタン

クリックすると，［サービステンプレート複製］ダイアログボックスが閉じます。

注意事項

サービステンプレートID，サービステンプレートバージョンおよびベンダーIDのうち，少なくとも1つは変更しないと，サービステンプレートを複製できません。

7.3.4　サービステンプレートエディタ参照ダイアログボックス

サービステンプレートエディタ参照ダイアログボックスは，サービステンプレートの定義内容を参照するための画面です。サービステンプレートエディタ参照ダイアログボックスは，［サービステンプレート一覧］ダイアログボックスで［参照］ボタンをクリックすると表示されます。

図7‒22　サービステンプレートエディタ参照ダイアログボックス

表示項目について説明します。

ポイント

サービステンプレートエディタ参照ダイアログボックスは読み取り専用画面です。設定内容は変更できません。

［サービス定義参照］ボタン

サービスの定義情報を参照できます。クリックすると，［サービス定義参照］ダイアログボックスが表示されます。

［フロー］ビュー

ステップの実行順序が表示されます。階層フロー部品または繰り返し実行部品を使用するステップをダブルクリックすると，その配下のフローが表示されます。それ以外のステップアイコンをダブルクリックすると，［ステップ参照］ダイアログボックスが表示されます。ステップアイコンは複数選択できます。また，マッピングパラメータの設定が必須の入力プロパティに対して，マッピングパラメータの値が入力されていない場合，ステップアイコンに[図データ]が表示されます。

［表示］リストボックス

［フロー］ビューの表示倍率を選択します。倍率は「25％」「50％」「75％」または「100％」から選択できます。

ステップアイコンを右クリックすると，次の操作を選択できます。

参照

選択すると，［ステップ参照］ダイアログボックスが表示されます。

コピー

選択すると，ステップおよび関連線をコピーできます。コピーしたステップおよび関連線は，サービステンプレートエディタ編集ビューの［フロー］ビューに貼り付けられます。

ステップアイコン以外の場所を右クリックすると，次の操作を選択できます。

すべて選択

選択すると，表示されているステップおよび関連線がすべて選択されます。階層フロー部品または繰り返し実行部品を使用するステップを含む場合，その配下のステップおよび関連線も選択されます。

［フローツリー］ビュー

サービステンプレートのフロー名が階層表示されます。フロー名をクリックすると，その配下のフローが［フロー］ビューに表示されます。また，マッピングパラメータの設定が必須の入力プロパティに対して，マッピングパラメータの値が入力されていないステップをフローに含む場合，[図データ]が表示されます。

［ステップ一覧］ビュー

サービステンプレートのステップ一覧が表示されます。ステップを選択すると，［フロー］ビューのステップアイコンも選択されます。ステップは複数選択できます。表示項目のタイトルをクリックすると，昇順，または降順でソートできます。

［ステップ参照］ボタン

選択したステップを参照できます。クリックすると，［ステップ参照］ダイアログボックスが表示されます。

表7‒11　［ステップ一覧］ビューの表示項目（サービステンプレートエディタ参照ダイアログボックス）

表示項目

説明

入力警告アイコン

マッピングパラメータの設定が必須の入力プロパティに対して，マッピングパラメータの値が入力されていない場合，[図データ]が表示されます。

ステップ名

ステップの名称が表示されます。

7.3.5　［サービス定義参照］ダイアログボックス

［サービス定義参照］ダイアログボックスは，サービスの定義情報を参照するための画面です。［サービス定義参照］ダイアログボックスは，次の操作によって表示されます。

サービステンプレートエディタ参照ダイアログボックスで，［サービス定義参照］ボタンをクリックする

サービステンプレートデバッグビューで，［サービス定義参照］ボタンをクリックする

図7‒23　［サービス定義参照］ダイアログボックス（1/2）

図7‒24　［サービス定義参照］ダイアログボックス（2/2）

表示項目について説明します。

ポイント

［サービス定義参照］ダイアログボックスは読み取り専用画面です。設定内容は変更できません。

サービス

サービスの定義情報が表示されます。

サービステンプレートID

サービステンプレートIDが表示されます。

サービステンプレートバージョン

サービステンプレートのバージョンが表示されます。

ベンダーID

サービステンプレートのベンダーIDが表示されます。

［サービステンプレート名］テキストボックス

サービステンプレートの名称が表示されます。

［ベンダー名］テキストボックス

サービステンプレートのベンダー名が表示されます。

［説明］テキストボックス

サービステンプレートの説明が表示されます。

［カテゴリ名］テキストボックス

サービステンプレートのカテゴリ名が表示されます。

画面カスタムファイル

サービステンプレートに設定されている画面カスタムファイルが表示されます。

［サービス詳細説明画面のファイル名(相対パス)］テキストボックス

サービス詳細説明画面のファイル名が，zipファイル内の相対パスで表示されます。［サービス詳細説明画面のファイル名(相対パス)］テキストボックスは，画面カスタムファイルにzipファイルを指定している場合，表示されます。

［プロパティグループ一覧］

クリックすると，プロパティグループ一覧が表示されます。

プロパティグループ一覧

プロパティグループの一覧が表示されます。

表7‒12　プロパティグループ一覧の表示項目（［サービス定義参照］ダイアログボックス）

表示項目

説明

プロパティグループID

プロパティグループIDが表示されます。

プロパティグループ名

プロパティグループの名称が表示されます。

説明

プロパティグループの説明が表示されます。

初期表示状態

プロパティグループの初期表示状態が表示されます。

［入力プロパティ一覧］

クリックすると，入力プロパティ一覧が表示されます。

入力プロパティ一覧

入力プロパティの一覧が表示されます。

表7‒13　入力プロパティ一覧の表示項目（［サービス定義参照］ダイアログボックス）

表示項目

説明

プロパティキー

プロパティキーが表示されます。

プロパティ名

入力プロパティの名称が表示されます。

説明

入力プロパティの説明が表示されます。

プロパティグループ名

プロパティグループの名称が表示されます。

［参照］ボタン

選択した入力プロパティを参照できます。クリックすると，［サービスの入力プロパティ参照］ダイアログボックスが表示されます。

［出力プロパティ一覧］

クリックすると，出力プロパティ一覧が表示されます。

出力プロパティ一覧

出力プロパティの一覧が表示されます。

表7‒14　出力プロパティ一覧の表示項目（［サービス定義参照］ダイアログボックス）

表示項目

説明

プロパティキー

プロパティキーが表示されます。

プロパティ名

出力プロパティの名称が表示されます。

説明

出力プロパティの説明が表示されます。

［参照］ボタン

選択した出力プロパティを参照できます。クリックすると，［サービスの出力プロパティ参照］ダイアログボックスが表示されます。

［変数一覧］

クリックすると，変数一覧が表示されます。

変数一覧

変数の一覧が表示されます。

表7‒15　変数一覧の表示項目（［サービス定義参照］ダイアログボックス）

表示項目

説明

プロパティキー

プロパティキーが表示されます。

プロパティ名

変数の名称が表示されます。

説明

変数の説明が表示されます。

［参照］ボタン

選択した変数を参照できます。クリックすると，［変数参照］ダイアログボックスが表示されます。

［閉じる］ボタン

クリックすると，［サービス定義参照］ダイアログボックスが閉じます。

7.3.6　［サービスの入力プロパティ参照］ダイアログボックス

［サービスの入力プロパティ参照］ダイアログボックスは，サービスの入力プロパティを参照するための画面です。［サービスの入力プロパティ参照］ダイアログボックスは，［サービス定義参照］ダイアログボックスで，［入力プロパティ一覧］の［参照］ボタンをクリックすると表示されます。

図7‒25　［サービスの入力プロパティ参照］ダイアログボックス

表示項目について説明します。

ポイント

［サービスの入力プロパティ参照］ダイアログボックスは読み取り専用画面です。設定内容は変更できません。

［プロパティキー］テキストボックス

入力プロパティのプロパティキーが表示されます。

［プロパティ名］テキストボックス

入力プロパティの名称が表示されます。

［説明］テキストボックス

入力プロパティの説明が表示されます。

［プロパティグループ］リストボックス

入力プロパティが所属するプロパティグループが表示されます。

［可視性］ラジオボタン

入力プロパティの可視性が表示されます。

exec

選択されている場合，プロパティ値はサービス編集時およびサービス実行時に設定できます。

config

選択されている場合，プロパティ値はサービス編集時に設定できます。

［スコープ］チェックボックス

入力プロパティのスコープが表示されます。チェックされている場合，入力プロパティはサービス共有プロパティです。

［必須区分］チェックボックス

入力プロパティの必須区分が表示されます。チェックされている場合，入力が必須のプロパティです。

［データ型］リストボックス

入力プロパティのデータ型が表示されます。

string

データ型にstring（文字列型）が設定されています。

boolean

データ型にboolean（ブーリアン型）が設定されています。

integer

データ型にinteger（int型）が設定されています。

double

データ型にdouble（ダブル型）が設定されています。

date

データ型にdate（日付型）が設定されています。

password

データ型にpassword（パスワード型）が設定されています。

list

データ型にlist（リスト型）が設定されています。

［デフォルト値］テキストボックス

入力プロパティのデフォルト値が表示されます。

［最小長］テキストボックス

データ型にstringまたはpasswordが設定されている場合に表示されます。入力プロパティに入力できる文字列の最小長が表示されます。

［最大長］テキストボックス

データ型にstringまたはpasswordが設定されている場合に表示されます。入力プロパティに入力できる文字列の最大長が表示されます。

［入力文字制限］テキストボックス

データ型にstringまたはpasswordが設定されている場合に表示されます。入力プロパティの入力文字制限が表示されます。

［最小値］テキストボックス

データ型にinteger，doubleまたはdateが設定されている場合に表示されます。入力プロパティの最小値が表示されます。

［最大値］テキストボックス

データ型にinteger，doubleまたはdateが設定されている場合に表示されます。入力プロパティの最大値が表示されます。

［リスト表示値］テキストボックス

入力プロパティに定義されているリスト表示値が表示されます。［リスト表示値］テキストボックスは，データ型にlistが設定されている場合に表示されます。

［閉じる］ボタン

クリックすると，［サービスの入力プロパティ参照］ダイアログボックスが閉じます。

7.3.7　［サービスの出力プロパティ参照］ダイアログボックス

［サービスの出力プロパティ参照］ダイアログボックスは，サービスの出力プロパティを参照するための画面です。［サービスの出力プロパティ参照］ダイアログボックスは，［サービス定義参照］ダイアログボックスで，［出力プロパティ一覧］の［参照］ボタンをクリックすると表示されます。

図7‒26　［サービスの出力プロパティ参照］ダイアログボックス

表示項目について説明します。

ポイント

［サービスの出力プロパティ参照］ダイアログボックスは読み取り専用画面です。設定内容は変更できません。

［プロパティキー］テキストボックス

プロパティキーが表示されます。

［プロパティ名］テキストボックス

出力プロパティの名称が表示されます。

［説明］テキストボックス

出力プロパティの説明が表示されます。

［データ型］リストボックス

出力プロパティのデータ型が表示されます。

string

データ型にstring（文字列型）が設定されています。

password

データ型にpassword（パスワード型）が設定されています。

［デフォルト値］テキストボックス

出力プロパティのデフォルト値が表示されます。

［閉じる］ボタン

クリックすると，［サービスの出力プロパティ参照］ダイアログボックスが閉じます。

7.3.8　［変数参照］ダイアログボックス

［変数参照］ダイアログボックスは，サービスの変数を参照するための画面です。［変数参照］ダイアログボックスは，［サービス定義参照］ダイアログボックスで，［変数一覧］の［参照］ボタンをクリックすると表示されます。

図7‒27　［変数参照］ダイアログボックス

表示項目について説明します。

ポイント

［変数参照］ダイアログボックスは読み取り専用画面です。設定内容は変更できません。

［プロパティキー］テキストボックス

変数のプロパティキーが表示されます。

［プロパティ名］テキストボックス

変数の名称が表示されます。

［説明］テキストボックス

変数の説明が表示されます。

［データ型］リストボックス

変数のデータ型が表示されます。

string

データ型にstring（文字列型）が設定されています。

password

データ型にpassword（パスワード型）が設定されています。

［デフォルト値］テキストボックス

変数のデフォルト値が表示されます。

［閉じる］ボタン

クリックすると，［変数参照］ダイアログボックスが閉じます。

7.3.9　［ステップ参照］ダイアログボックス

［ステップ参照］ダイアログボックスは，サービステンプレートのステップの情報を参照するための画面です。［ステップ参照］ダイアログボックスは，次の操作によって表示されます。

サービステンプレートエディタ参照ダイアログボックスの［ステップ一覧］ビューで［ステップ参照］ボタンをクリックする

サービステンプレートエディタ参照ダイアログボックスの［フロー］ビューに表示されたステップアイコンを右クリックし，［参照］を選択する

サービステンプレートエディタ参照ダイアログボックスの［フロー］ビューに表示されたステップアイコンをダブルクリックする

サービステンプレートデバッグビューの［フロー］ビューに表示されたステップアイコンを右クリックし，［参照］を選択する

サービステンプレートデバッグビューの［フロー］ビューに表示されたステップアイコンをダブルクリックする

図7‒28　［ステップ参照］ダイアログボックス（1/2）

図7‒29　［ステップ参照］ダイアログボックス（2/2）

表示項目について説明します。

ポイント

［ステップ参照］ダイアログボックスは読み取り専用画面です。設定内容は変更できません。

ステップ

ステップの定義情報が表示されます。

［ステップID］テキストボックス

ステップIDが表示されます。

［ステップ名］テキストボックス

ステップの名称が表示されます。

［説明］テキストボックス

ステップの説明が表示されます。

［部品］

クリックすると，部品の定義情報が表示されます。

部品

部品の定義情報が表示されます。

部品名

部品の名称が表示されます。

部品バージョン

部品のバージョンが表示されます。

ベンダー名

部品のベンダー名が表示されます。

説明

部品の説明が表示されます。

部品ID

部品IDが表示されます。

ベンダーID

部品のベンダーIDが表示されます。

［後続ステップ実行条件］

クリックすると，後続ステップ実行条件が表示されます。

後続ステップ実行条件

後続ステップの実行条件が表示されます。

［条件］リストボックス

後続ステップの実行条件が表示されます。

部品の戻り値が判定値以下の場合に後続のステップを実行する

常に後続のステップを実行する

常に後続のステップを実行しない

［判定値］テキストボックス

後続ステップの実行条件として部品の戻り値判定を使用する場合の，判定値が表示されます。［判定値］テキストボックスは，［条件］リストボックスで［部品の戻り値が判定値以下の場合に後続のステップを実行する］を選択した場合に表示されます。

［警告設定］チェックボックス

チェックされている場合，部品の戻り値が警告値以上かつ判定値以下のときに，ステップが警告状態になります。［警告設定］チェックボックスは，［条件］リストボックスで［部品の戻り値が判定値以下の場合に後続のステップを実行する］を選択した場合に表示されます。

［警告値］テキストボックス

後続ステップの実行条件として，部品の戻り値判定に使用する警告値が表示されます。［警告値］テキストボックスは，［条件］リストボックスで［部品の戻り値が判定値以下の場合に後続のステップを実行する］を選択した場合に表示されます。

［入力プロパティマッピング］

クリックすると，入力プロパティ一覧が表示されます。

入力プロパティ一覧

入力プロパティの一覧が表示されます。表示項目のタイトルをクリックすると，昇順，または降順でソートできます。

表7‒16　入力プロパティ一覧の表示項目（［ステップ参照］ダイアログボックス）

表示項目

説明

入力警告アイコン

マッピングパラメータの設定が必須の入力プロパティに対して，マッピングパラメータの値が入力されていない場合，[図データ]が表示されます。

プロパティキー

プロパティキーが表示されます。

プロパティ名

入力プロパティの名称が表示されます。

説明

入力プロパティの説明が表示されます。

マッピングパラメータ

入力プロパティのマッピングパラメータが表示されます。

［出力プロパティマッピング］

クリックすると，出力プロパティ一覧が表示されます。

出力プロパティ一覧

出力プロパティの一覧が表示されます。表示項目のタイトルをクリックすると，昇順，または降順でソートできます。

表7‒17　出力プロパティ一覧の表示項目（［ステップ参照］ダイアログボックス）

表示項目

説明

プロパティキー

プロパティキーが表示されます。

プロパティ名

出力プロパティの名称が表示されます。

説明

出力プロパティの説明が表示されます。

マッピングパラメータ

出力プロパティのマッピングパラメータが表示されます。

［閉じる］ボタン

クリックすると，［ステップ参照］ダイアログボックスが閉じます。

7.4　サービステンプレートエディタ編集ビュー

サービステンプレートエディタ編集ビューは，既存のサービステンプレートを編集したり，新規サービステンプレートを作成したりするための画面です。

サービステンプレートエディタ編集ビューは，次の操作によって［エディタ］画面の右ペインに表示されます。

［サービステンプレート一覧］ダイアログボックスで［編集］ボタンをクリックする

［サービステンプレート作成］ダイアログボックスまたは［サービステンプレート複製］ダイアログボックスで［保存］ボタンをクリックする

サービステンプレートデバッグビューで［デバッグ終了］ボタンをクリックする

図7‒30　サービステンプレートエディタ編集ビュー

表示項目について説明します。

［サービス定義編集］ボタン

サービスの定義情報を編集できます。クリックすると，［サービス定義編集］ダイアログボックスが表示されます。

［保存］ボタン

クリックすると，変更した内容が反映されます。

［ビルド／デバッグ］ボタン

サービステンプレートのビルド，およびデバッグ実行ができます。クリックすると，サービステンプレートをビルドするかどうか確認するメッセージダイアログボックスが表示され，［OK］ボタンをクリックすると，ビルドが開始されます。ビルドの実行結果は，［ビルド/リリース結果］ダイアログボックスおよび［ビルド/リリース結果詳細］ビューに表示されます。

［リリース］ボタン

サービステンプレートをリリースできます。クリックすると，サービステンプレートをリリースするかどうか確認するメッセージダイアログボックスが表示され，［OK］ボタンをクリックすると，リリースが開始されます。リリースの実行結果は，［ビルド/リリース結果］ダイアログボックスおよび［ビルド/リリース結果詳細］ビューに表示されます。

［操作］リストボックス

サービステンプレートに対して実行する操作を指定します。

参照

ほかのサービステンプレートの定義情報を参照できます。選択すると，［サービステンプレート一覧］ダイアログボックスが表示されます。

リソース設定

サービスリソースファイルを設定できます。選択すると，［サービスリソース設定］ダイアログボックスが表示されます。

部品バージョン管理

ステップとして使用している部品のバージョンの確認および変更ができます。選択すると，［部品バージョン管理］ダイアログボックスが表示されます。

［閉じる］ボタン

クリックすると，［サービステンプレートエディタホーム］ビューが表示されます。

［フロー］ビュー

ステップの実行順序が表示されます。［部品］ビューから部品をドラッグ&ドロップすると，［ステップ作成］ダイアログボックスが表示され，ステップを追加できます。階層フロー部品または繰り返し実行部品を使用するステップをダブルクリックすると，その配下のフローが表示されます。それ以外のステップアイコンをダブルクリックすると，［ステップ編集］ダイアログボックスが表示されます。ステップアイコンは複数選択できます。また，マッピングパラメータの設定が必須の入力プロパティに対して，マッピングパラメータの値が入力されていない場合，ステップアイコンに[図データ]が表示されます。

［表示］リストボックス

［フロー］ビューの表示倍率を選択します。倍率は「25％」「50％」「75％」または「100％」から選択できます。

ステップアイコンを右クリックすると，次の操作を選択できます。

編集

選択すると，［ステップ編集］ダイアログボックスが表示されます。

切り取り

選択すると，ステップおよび関連線を切り取れます。

コピー

選択すると，ステップおよび関連線をコピーできます。

削除

選択すると，ステップおよび関連線を削除できます。

ステップアイコン以外の場所を右クリックすると，次の操作を選択できます。

貼り付け

選択すると，切り取りまたはコピーしたステップおよび関連線を貼り付けられます。

すべて選択

選択すると，表示されているステップおよび関連線がすべて選択されます。階層フロー部品または繰り返し実行部品を使用するステップを含む場合，その配下のステップおよび関連線も選択されます。

［フローツリー］ビュー

サービステンプレートのフロー名が階層表示されます。フロー名をクリックすると，その配下のフローが［フロー］ビューに表示されます。また，マッピングパラメータの設定が必須の入力プロパティに対して，マッピングパラメータの値が入力されていないステップをフローに含む場合，[図データ]が表示されます。

［ビルド/リリース結果詳細］ビュー

ビルドまたはリリース時に出力されたメッセージの一覧が表示されます。

表7‒18　［ビルド/リリース結果詳細］ビューの表示項目（サービステンプレートエディタ編集ビュー）

表示項目

説明

種別

メッセージの種別が表示されます。

エラー

ビルドまたはリリース時に出力されるエラーメッセージです。

警告

ビルドまたはリリース時に出力される警告メッセージです。

情報

ビルドまたはリリース時に出力される情報メッセージです。

メッセージID

メッセージIDが表示されます。

内容

メッセージの内容が表示されます。

［ステップ一覧］ビュー

サービステンプレートのステップ一覧が表示されます。ステップを選択すると，［フロー］ビューのステップアイコンも選択されます。ステップは複数選択できます。表示項目のタイトルをクリックすると，昇順，または降順でソートできます。

［ステップ編集］ボタン

選択したステップを編集できます。クリックすると，［ステップ編集］ダイアログボックスが表示されます。

表7‒19　［ステップ一覧］ビューの表示項目（サービステンプレートエディタ編集ビュー）

表示項目

説明

入力警告アイコン

マッピングパラメータの設定が必須の入力プロパティに対して，マッピングパラメータの値が入力されていない場合，[図データ]が表示されます。

ステップ名

ステップの名称が表示されます。

7.4.1　［サービスリソース設定］ダイアログボックス

［サービスリソース設定］ダイアログボックスは，サービスリソースファイルをアップロードしたり，ダウンロードしたりするための画面です。［サービスリソース設定］ダイアログボックスは，サービステンプレートエディタ編集ビューの［操作］リストボックスから，［リソース設定］を選択すると表示されます。

図7‒31　［サービスリソース設定］ダイアログボックス

表示項目について説明します。

サービスリソースファイル

サービスリソースファイルが表示されます。

日本語

サービスリソースファイル名が表示されます。ファイル名をクリックすると，ファイルをダウンロードできます。

［更新］ボタン

クリックすると，編集したサービスリソースファイルをアップロードするダイアログボックスが表示されます。ファイルを選択し［開く］をクリックすると，ファイルを更新するかどうか確認するメッセージダイアログボックスが表示され，［OK］をクリックするとファイルが更新されます。登録できるサービスリソースファイルの名称は，「service_ja.properties.txt」だけです。

［閉じる］ボタン

クリックすると，［サービスリソース設定］ダイアログボックスが閉じます。

7.4.2　［部品バージョン管理］ダイアログボックス（［一括適用］タブ）

［部品バージョン管理］ダイアログボックス（［一括適用］タブ）は，ステップとして使用している部品を，最新バージョンのリリース部品に一括で変更するための画面です。また，ステップとして使用している部品のバージョンを確認することもできます。

サービステンプレートエディタ編集ビューの［操作］リストボックスから［部品バージョン管理］を選択します。［部品バージョン管理］ダイアログボックスで，［一括適用］タブを選択すると表示されます。

図7‒32　［部品バージョン管理］ダイアログボックス（［一括適用］タブ）

表示項目について説明します。

表7‒20　［ステップ一覧］の表示項目

表示項目

説明

ステップ選択チェックボックス

ステップ選択チェックボックスの表示が活性の場合，チェックボックスをチェックすると，バージョンを変更するステップを選択できます。なお，ステップ選択チェックボックスは，非活性で表示される場合もあります。活性状態，およびチェックの有無による意味を次に示します。

[図データ]（活性でチェックがされている場合）

リリース部品の最新バージョンが未適用で，変更対象です。

[図データ]（活性でチェックがされていない場合）

リリース部品の最新バージョンが未適用ですが，変更対象ではありません。

[図データ]（非活性でチェックがされている場合）

リリース部品の最新バージョンが適用済みです。

[図データ]（非活性でチェックがされていない場合）

リリース部品が存在しないため，適用できません。

ステップ名

ステップの名称が表示されます。

フロー階層

ステップが配置されているフロー階層が表示されます。

適用済み部品名

ステップとして使用している部品名が表示されます。

適用済みバージョン

ステップとして使用している部品のバージョンおよび種別が表示されます。表示される種別を次に示します。

(最新)

対象の部品は，最新バージョンのリリース部品です。

(デバッグ)

対象の部品は，開発部品です。

なお，種別が表示されていない部品は，最新バージョンではないリリース部品です。

適用対象部品名

バージョンの変更先となる部品の名称が表示されます。

適用対象バージョン

変更先となる部品の最新バージョンおよび種別が表示されます。表示される種別を次に示します。

(最新)

対象の部品は，最新バージョンのリリース部品です。

状態

リリース部品の最新バージョンの適用状態が表示されます。表示される状態を次に示します。

未適用

リリース部品の最新バージョンが適用されていません。

適用済み

リリース部品の最新バージョンが適用されています。

適用不可

適用対象のリリース部品がありません。

プロパティ変更通知アイコン

バージョン変更後のプロパティに，変更前のプロパティ値が引き継がれない場合，[図データ]が表示されます。変更前のプロパティ値が引き継がれない場合を次に示します。

プロパティが削除された。

プロパティキーの値が変更された。

プロパティの入出力種別が変更された。

なお，[図データ]が表示された場合は，ステップの定義情報を見直してください。

［適用対象部品］

［ステップ一覧］で選択した部品の，変更先となる最新バージョンのリリース部品の部品名，部品バージョン，ベンダー名，および説明が表示されます。

［詳細情報］

［ステップ一覧］で選択した部品の，変更先となる最新バージョンのリリース部品の詳細情報が表示されます。

［適用］ボタン

［ステップ一覧］で選択されている部品が，最新バージョンのリリース部品に変更されます。

［閉じる］ボタン

クリックすると，［部品バージョン管理］ダイアログボックス（［一括適用］タブ）が閉じます。

関連トピック

マニュアル「JP1/AO サービステンプレート開発ガイド」−「ステップとして使用している部品のバージョンを管理する」のトピック

7.4.3　［部品バージョン管理］ダイアログボックス（［個別適用］タブ）

［部品バージョン管理］ダイアログボックス（［個別適用］タブ）は，ステップとして使用している部品のバージョンを確認して，特定の部品を任意のバージョンのリリース部品または開発部品に，変更するための画面です。

サービステンプレートエディタ編集ビューの［操作］リストボックスから［部品バージョン管理］を選択します。［部品バージョン管理］ダイアログボックスで，［個別適用］タブを選択すると表示されます。

図7‒33　［部品バージョン管理］ダイアログボックス（［個別適用］タブ）

表示項目について説明します。

［部品一覧］

ステップとして使用している部品の種類が表示されます。その部品のバージョンが複数ある場合にだけ表示されます。

なお，ステップとして使用している部品が，次の部品を含む場合，[図データ]が表示されます。

最新ではないリリース部品

開発部品※

注※

リリース部品がない場合は，[図データ]は表示されません。

［部品バージョン］リストボックス

［部品一覧］で選択した部品の持つバージョンおよび種別が表示されます。この中から，変更したい部品のバージョンを選択します。表示される種別を次に示します。

(最新)

対象の部品は，最新バージョンのリリース部品です。

(デバッグ)

対象の部品は，開発部品です。

なお，種別が表示されていない部品は，最新バージョンではないリリース部品です。

［適用対象部品］

［部品バージョン］リストボックスで選択した，変更先となるバージョンの部品の部品名，部品バージョン，ベンダー名，および説明が表示されます。

［詳細情報］

［部品バージョン］リストボックスで選択した，変更先となるバージョンの部品の詳細情報が表示されます。

表7‒21　［ステップ一覧］の表示項目

表示項目

説明

ステップ選択チェックボックス

ステップ選択チェックボックスの表示が活性の場合，チェックボックスをチェックすると，バージョンを変更するステップを選択できます。非活性で表示される場合もあります。活性状態，およびチェックの有無による意味を次に示します。

[図データ]（活性でチェックがされている場合）

［部品バージョン］リストボックスで選択されているバージョンが未適用で，変更対象です。

[図データ]（活性でチェックがされていない場合）

［部品バージョン］リストボックスで選択されているバージョンが未適用ですが，変更対象ではありません。

[図データ]（非活性でチェックがされている場合）

［部品バージョン］リストボックスで選択されているバージョンが適用済みです。

ステップ名

ステップの名称が表示されます。

フロー階層

ステップが配置されているフロー階層が表示されます。

適用済みバージョン

ステップとして使用している部品のバージョンおよび種別が表示されます。表示される種別を次に示します。

(最新)

対象の部品は，最新バージョンのリリース部品です。

(デバッグ)

対象の部品は，開発部品です。

なお，種別が表示されていない部品は，最新バージョンではないリリース部品です。

状態

［部品バージョン］リストボックスで選択されているバージョンの適用状態が表示されます。表示される状態を次に示します。

未適用

［部品バージョン］リストボックスで選択されているバージョンの部品が適用されていません。

適用済み

［部品バージョン］リストボックスで選択されているバージョンの部品が適用されています。

プロパティ変更通知アイコン

バージョン変更後のプロパティに，変更前のプロパティ値が引き継がれない場合，[図データ]が表示されます。変更前のプロパティ値が引き継がれない場合を次に示します。

プロパティが削除された。

プロパティキーの値が変更された。

プロパティの入出力種別が変更された。

なお，[図データ]が表示された場合は，ステップの定義情報を見直してください。

［適用］ボタン

［ステップ一覧］で選択されている部品が，指定したバージョンのリリース部品または開発部品に変更されます。

［閉じる］ボタン

クリックすると，［部品バージョン管理］ダイアログボックス（［個別適用］タブ）が閉じます。

関連トピック

マニュアル「JP1/AO サービステンプレート開発ガイド」−「ステップとして使用している部品のバージョンを管理する」のトピック

7.4.4　［ビルド/リリース結果］ダイアログボックス

［ビルド/リリース結果］ダイアログボックスは，サービステンプレートのビルドまたはリリース結果および進捗を確認するための画面です。

［ビルド/リリース結果］ダイアログボックスは，次の操作によって表示されます。

サービステンプレートエディタ編集ビューで，［ビルド／デバッグ］ボタンまたは［リリース］ボタンをクリックし，表示された確認メッセージダイアログボックスの［OK］ボタンをクリックする

サービステンプレートデバッグビューで，［リリース］ボタンをクリックし，表示された確認メッセージダイアログボックスの［OK］ボタンをクリックする

図7‒34　［ビルド/リリース結果］ダイアログボックス（サービステンプレートエディタ編集ビューの［ビルド／デバッグ］ボタンをクリックして表示した場合）

表示項目について説明します。

概要

ビルドまたはリリースの結果および進捗や，実行時に出力されたメッセージの個数が表示されます。

ビルド/リリース結果

ビルドまたはリリースの結果および進捗が表示されます。

状態

ビルドまたはリリース時に出力されたメッセージの個数が表示されます。

詳細

ビルドまたはリリース時に出力されたメッセージの内容が一覧表示されます。表示項目のタイトルをクリックすると，昇順，または降順でソートできます。

表7‒22　詳細一覧の表示項目（［ビルド/リリース結果］ダイアログボックス）

表示項目

説明

種別

メッセージの種別が表示されます。

エラー

ビルドまたはリリース時に出力されるエラーメッセージです。

警告

ビルドまたはリリース時に出力される警告メッセージです。

情報

ビルドまたはリリース時に出力される情報メッセージです。

メッセージID

メッセージIDが表示されます。

内容

メッセージの内容が表示されます。

［デバッグ実行］ボタン

サービステンプレートのデバッグを開始できます。クリックすると，［デバッグ実行］ダイアログボックスが表示されます。このボタンは，サービステンプレートエディタ編集ビューで［リリース］ボタンをクリックした場合，またはサービステンプレートデバッグビューで［リリース］ボタンをクリックした場合は表示されません。

［閉じる］ボタン

クリックすると，［ビルド/リリース結果］ダイアログボックスが閉じます。

7.4.5　［デバッグ実行］ダイアログボックス

［デバッグ実行］ダイアログボックスは，サービステンプレートのデバッグを開始するための画面です。［デバッグ実行］ダイアログボックスは，次の操作によって表示されます。

［ビルド/リリース結果］ダイアログボックスで［デバッグ実行］ボタンをクリックする

サービステンプレートデバッグビューで［デバッグ実行］ボタンをクリックする

図7‒35　［デバッグ実行］ダイアログボックス（プロパティグループを設定した場合）

表示項目について説明します。

デバッグ設定

開発サービステンプレートのデバッグを開始するために必要な情報を設定します。

［中断設定］リストボックス

デバッグタスクの中断設定を選択します。

1ステップずつ中断する

1ステップごとに中断してデバッグ実行する場合に選択します。

中断しない

ステップを中断しないでデバッグ実行する場合に選択します。

［サービス名］テキストボックス

デバッグサービス名が表示されます。サービス名は変更できます。64文字まで入力できます。デフォルトは，「[DEBUG]サービステンプレート名」となります。

［カテゴリ］テキストボックス

デバッグサービスのカテゴリ名が表示されます。カテゴリ名は変更できます。256文字まで入力できます。カテゴリを階層化する場合は，「/」で区切って入力します。なお，カテゴリの階層数の上限は10階層です。複数のカテゴリに設定する場合は，カテゴリとカテゴリの間を「,」で区切って入力します。カテゴリの各階層には値を必ず入力してください。

［タスク名］テキストボックス

デバッグ実行するタスク名が表示されます。タスク名は変更できます。128文字まで入力できます。デフォルトは，「[DEBUG]サービステンプレート名_YYYYMMDDhhmmss」（YYYYMMDDhhmmss：デバッグ実行した日付および時刻）となります。

［タスクの説明］テキストボックス

デバッグ実行するタスクの説明を入力します。256文字まで入力できます。

［リソースグループ］リストボックス

リソースグループを選択します。デフォルトは，「All Resources」です。

［タスクのログ出力レベル］リストボックス

タスクのログ出力レベルを選択します。ログ出力レベルは「0」「10」「20」「30」または「40」から選択できます。デフォルトは，「40」です。

プロパティ

サービスのプロパティ情報の一覧が表示されます。表示項目のタイトルをクリックすると，昇順，または降順でソートできます。デバッグ実行に必要なプロパティ値を設定します。

［プロパティグループ］

クリックすると，プロパティグループに含まれるプロパティ一覧が表示されます。サービステンプレートにプロパティグループが設定されていない場合は表示されません。

表7‒23　プロパティの表示項目（［デバッグ実行］ダイアログボックス）

表示項目

説明

プロパティ名

プロパティの名称が表示されます。

プロパティキー

プロパティキーが表示されます。

プロパティ値

デバッグ実行するために必要なプロパティ値を入力します。デフォルトでは，サービスプロパティのデフォルト値が表示されます。データ型がpasswordの場合，入力した文字列は「●」で表示されます。

説明

プロパティの説明が表示されます。

スコープ

プロパティのスコープが表示されます。

［実行］ボタン

サービステンプレートのデバッグを開始します。クリックすると，［デバッグ実行］ダイアログボックスが閉じ，［エディタ］画面の左ペインに［デバッグ］ビュー，右ペインにサービステンプレートデバッグビューが表示されます。

［キャンセル］ボタン

クリックすると，［デバッグ実行］ダイアログボックスが閉じます。

7.4.6　［サービス定義編集］ダイアログボックス

［サービス定義編集］ダイアログボックスは，サービスの定義情報を編集するための画面です。［サービス定義編集］ダイアログボックスは，サービステンプレートエディタ編集ビューで，［サービス定義編集］ボタンをクリックすると表示されます。

図7‒36　［サービス定義編集］ダイアログボックス（1/2）

図7‒37　［サービス定義編集］ダイアログボックス（2/2）

表示項目について説明します。

サービス

編集するサービスの定義情報を指定します。

サービステンプレートID

サービステンプレートIDが表示されます。

サービステンプレートバージョン

サービステンプレートのバージョンが表示されます。

ベンダーID

サービステンプレートのベンダーIDが表示されます。

［サービステンプレート名］テキストボックス

サービステンプレートの名称を入力します。64文字まで入力できます。

［ベンダー名］テキストボックス

サービステンプレートのベンダー名を入力します。64文字まで入力できます。

［説明］テキストボックス

サービステンプレートの説明を入力します。256文字まで入力できます。

［カテゴリ名］テキストボックス

サービステンプレートのカテゴリ名を入力します。256文字まで入力できます。カテゴリを階層化する場合は，「/」で区切って入力します。なお，カテゴリの階層数の上限は10階層です。複数のカテゴリに設定する場合は，カテゴリとカテゴリの間を「,」で区切って入力します。カテゴリの各階層には値を必ず入力してください。

画面カスタムファイル

サービステンプレートに設定されている画面カスタムファイルが表示されます。ファイル名をクリックすると，ファイルをダウンロードできます。

［選択］ボタン

画面カスタムファイルを選択できます。クリックすると，フォルダ選択ダイアログボックスが表示されます。画面カスタムファイル名（zipファイルの場合はzipファイル内の相対パス）は64文字以内で指定してください。また，サービステンプレートID，ベンダーIDおよび画面カスタムファイル名（zipファイルの場合はzipファイル内の相対パス）の文字数の合計が，131文字以内になるように指定してください。

［削除］ボタン

クリックすると，画面カスタムファイルの指定が解除されます。

［サービス詳細説明画面のファイル名(相対パス)］テキストボックス

サービス詳細説明画面のファイル名を，zipファイル内の相対パスで指定します。相対パスが64文字以内かつ，サービステンプレートID，ベンダーIDおよび画面カスタムファイル名の文字数の合計が，131文字以内になるように指定してください。［サービス詳細説明画面のファイル名(相対パス)］テキストボックスは，画面カスタムファイルにzipファイルを指定している場合，表示されます。

［プロパティグループ一覧］

クリックすると，プロパティグループ一覧が表示されます。

プロパティグループ一覧

プロパティグループの一覧が表示されます。

表7‒24　プロパティグループ一覧の表示項目（［サービス定義編集］ダイアログボックス）

表示項目

説明

プロパティグループID

プロパティグループIDが表示されます。

プロパティグループ名

プロパティグループの名称が表示されます。

説明

プロパティグループの説明が表示されます。

初期表示状態

プロパティグループの初期表示状態が表示されます。

［追加］ボタン

プロパティグループを作成できます。クリックすると，［プロパティグループ作成］ダイアログボックスが表示されます。

［編集］ボタン

選択したプロパティグループを編集できます。クリックすると，［プロパティグループ編集］ダイアログボックスが表示されます。

［削除］ボタン

選択したプロパティグループを削除できます。クリックすると，プロパティグループを削除するかどうかを確認するメッセージダイアログボックスが表示され，［OK］ボタンをクリックすると，プロパティグループが削除されます。

［入力プロパティ一覧］

クリックすると，入力プロパティ一覧が表示されます。

入力プロパティ一覧

入力プロパティの一覧が表示されます。

表7‒25　入力プロパティ一覧の表示項目（［サービス定義編集］ダイアログボックス）

表示項目

説明

プロパティキー

プロパティキーが表示されます。

プロパティ名

入力プロパティの名称が表示されます。

説明

入力プロパティの説明が表示されます。

プロパティグループ名

プロパティグループの名称が表示されます。

［サービス共有プロパティの選択］ボタン

サービス共有プロパティを入力プロパティとして追加できます。クリックすると，［サービス共有プロパティ選択］ダイアログボックスが表示されます。

［追加］ボタン

入力プロパティを作成できます。クリックすると，［サービスの入力プロパティ作成］ダイアログボックスが表示されます。

［編集］ボタン

選択した入力プロパティを編集できます。クリックすると，［サービスの入力プロパティ編集］ダイアログボックスが表示されます。

［削除］ボタン

選択した入力プロパティを削除できます。クリックすると，入力プロパティを削除するかどうかを確認するメッセージダイアログボックスが表示され，［OK］ボタンをクリックすると，入力プロパティが削除されます。

［出力プロパティ一覧］

クリックすると，出力プロパティ一覧が表示されます。

出力プロパティ一覧

出力プロパティの一覧が表示されます。

表7‒26　出力プロパティ一覧の表示項目（［サービス定義編集］ダイアログボックス）

表示項目

説明

プロパティキー

プロパティキーが表示されます。

プロパティ名

出力プロパティの名称が表示されます。

説明

出力プロパティの説明が表示されます。

［追加］ボタン

出力プロパティを作成できます。クリックすると，［サービスの出力プロパティ作成］ダイアログボックスが表示されます。

［編集］ボタン

選択した出力プロパティを編集できます。クリックすると，［サービスの出力プロパティ編集］ダイアログボックスが表示されます。

［削除］ボタン

選択した出力プロパティを削除できます。クリックすると，出力プロパティを削除するかどうかを確認するメッセージダイアログボックスが表示され，［OK］ボタンをクリックすると，出力プロパティが削除されます。

［変数一覧］

クリックすると，変数一覧が表示されます。

変数一覧

変数の一覧が表示されます。

表7‒27　変数一覧の表示項目（［サービス定義編集］ダイアログボックス）

表示項目

説明

プロパティキー

プロパティキーが表示されます。

プロパティ名

変数の名称が表示されます。

説明

変数の説明が表示されます。

［追加］ボタン

変数を作成できます。クリックすると，［変数作成］ダイアログボックスが表示されます。

［編集］ボタン

選択した変数を編集できます。クリックすると，［変数編集］ダイアログボックスが表示されます。

［削除］ボタン

選択した変数を削除できます。クリックすると，変数を削除するかどうかを確認するメッセージダイアログボックスが表示され，［OK］ボタンをクリックすると，変数が削除されます。

［OK］ボタン

クリックすると，変更した内容が反映されます。

［キャンセル］ボタン

クリックすると，［サービス定義編集］ダイアログボックスが閉じます。

7.4.7　［プロパティグループ作成］ダイアログボックス

［プロパティグループ作成］ダイアログボックスは，プロパティグループを作成するための画面です。［プロパティグループ作成］ダイアログボックスは，［サービス定義編集］ダイアログボックスで，［プロパティグループ一覧］の［追加］ボタンをクリックすると表示されます。

図7‒38　［プロパティグループ作成］ダイアログボックス

表示項目について説明します。

［プロパティグループID］テキストボックス

プロパティグループIDを入力します。32文字まで入力できます。

［プロパティグループ名］テキストボックス

プロパティグループの名称を入力します。64文字まで入力できます。

［説明］テキストボックス

プロパティグループの説明を入力します。256文字まで入力できます。

［初期表示状態］ラジオボタン

［サービス設定］ダイアログボックスおよび［サービス実行］ダイアログボックスでの，プロパティグループの初期表示状態を選択します。

非表示

選択すると，プロパティグループの名称だけが表示され，プロパティグループに所属するプロパティは表示されません。

表示

選択すると，プロパティグループの名称およびプロパティグループに所属するプロパティが表示されます。

［OK］ボタン

クリックすると，プロパティグループが追加されます。

［キャンセル］ボタン

クリックすると，［プロパティグループ作成］ダイアログボックスが閉じます。

7.4.8　［プロパティグループ編集］ダイアログボックス

［プロパティグループ編集］ダイアログボックスは，プロパティグループの定義情報を編集するための画面です。［プロパティグループ編集］ダイアログボックスは，［サービス定義編集］ダイアログボックスで，［プロパティグループ一覧］の［編集］ボタンをクリックすると表示されます。

図7‒39　［プロパティグループ編集］ダイアログボックス

表示項目について説明します。

［プロパティグループID］テキストボックス

プロパティグループIDを入力します。32文字まで入力できます。

［プロパティグループ名］テキストボックス

プロパティグループの名称を入力します。64文字まで入力できます。

［説明］テキストボックス

プロパティグループの説明を入力します。256文字まで入力できます。

［初期表示状態］ラジオボタン

［サービス設定］ダイアログボックスおよび［サービス実行］ダイアログボックスでの，プロパティグループの初期表示状態を選択します。

非表示

選択すると，プロパティグループの名称だけが表示され，プロパティグループに所属するプロパティは表示されません。

表示

選択すると，プロパティグループの名称およびプロパティグループに所属するプロパティが表示されます。

［OK］ボタン

クリックすると，変更した内容が反映されます。

［キャンセル］ボタン

クリックすると，［プロパティグループ編集］ダイアログボックスが閉じます。

7.4.9　［サービス共有プロパティ選択］ダイアログボックス

［サービス共有プロパティ選択］ダイアログボックスは，サービス共有プロパティをサービスの入力プロパティとして設定するための画面です。［サービス共有プロパティ選択］ダイアログボックスは，［サービス定義編集］ダイアログボックスまたは［入力プロパティマッピング］ダイアログボックスの，［サービス共有プロパティの選択］ボタンをクリックした場合に表示されます。

図7‒40　［サービス共有プロパティ選択］ダイアログボックス

表示項目について説明します。

サービス共有プロパティ

サービス共有プロパティの一覧が表示されます。サービスの入力プロパティとして設定するサービス共有プロパティを選択します。表示項目のタイトルをクリックすると，昇順，または降順でソートできます。

表7‒28　サービス共有プロパティ一覧の表示項目（［サービス共有プロパティ選択］ダイアログボックス）

表示項目

初期表示

説明

サービス共有プロパティ

○　

サービス共有プロパティの名称が表示されます。

説明

○　

サービス共有プロパティの説明が表示されます。

プロパティ値

○　

サービス共有プロパティの値が表示されます。

プロパティキー

×　

プロパティキーが表示されます。

#

×　

サービス共有プロパティの通し番号が表示されます。

（凡例）

○：表示されます。　×：表示されません。

プロパティキー

選択したサービス共有プロパティのプロパティキーが表示されます。

［プロパティグループ］リストボックス

選択したサービス共有プロパティを所属させるプロパティグループを選択します。［サービス定義編集］ダイアログボックスに定義されているプロパティグループの名称が表示されます。

［OK］ボタン

クリックすると，選択したサービス共有プロパティがサービスの入力プロパティに追加されます。

［キャンセル］ボタン

クリックすると，［サービス共有プロパティ選択］ダイアログボックスが閉じます。

7.4.10　［サービスの入力プロパティ作成］ダイアログボックス

［サービスの入力プロパティ作成］ダイアログボックスは，サービスの入力プロパティを追加するための画面です。［サービスの入力プロパティ作成］ダイアログボックスは，［サービス定義編集］ダイアログボックスで，［入力プロパティ一覧］の［追加］ボタンをクリックするか，［入力プロパティマッピング］ダイアログボックスで［入力プロパティの追加］ボタンをクリックすると，表示されます。

図7‒41　［サービスの入力プロパティ作成］ダイアログボックス（［データ型］に［string］を選択した場合）

表示項目について説明します。

［プロパティキー］テキストボックス

プロパティキーを入力します。128文字まで入力できます。

［プロパティ名］テキストボックス

プロパティの名称を入力します。128文字まで入力できます。

［説明］テキストボックス

プロパティの説明を入力します。256文字まで入力できます。

［プロパティグループ］リストボックス

プロパティを所属させるプロパティグループを選択します。［サービス定義編集］ダイアログボックスに定義されているプロパティグループの名称が表示されます。

［可視性］ラジオボタン

入力プロパティの可視性を選択します。

exec

選択すると，プロパティ値をサービス編集時およびサービス実行時に設定できます。

config

選択すると，プロパティ値をサービス編集時に設定できます。

［スコープ］チェックボックス

入力プロパティのスコープを設定します。チェックすると，入力プロパティはサービス共有プロパティになります。

［必須区分］チェックボックス

入力プロパティの必須区分を設定します。チェックすると，入力が必須のプロパティになります。

［データ型］リストボックス

入力プロパティのデータ型を選択します。

string

データ型にstring（文字列型）が設定されます。

boolean

データ型にboolean（ブーリアン型）が設定されます。

integer

データ型にinteger（int型）が設定されます。

double

データ型にdouble（ダブル型）が設定されます。

date

データ型にdate（日付型）が設定されます。

password

データ型にpassword（パスワード型）が設定されます。

list

データ型にlist（リスト型）が設定されます。

［デフォルト値］

入力プロパティのデフォルト値を入力します。指定できる値はデータ型によって異なります。

stringの場合

テキストボックスに，文字列を入力します。1,024文字まで入力できます。

booleanの場合

リストボックスから，デフォルト値を選択します。未設定，trueおよびfalseから選択できます。

integerの場合

テキストボックスに，-2147483648から2147483647までの整数を入力します。

doubleの場合

テキストボックスに，-999999999999999から999999999999999までの整数または小数を入力します。17文字まで入力できます。

dateの場合

カレンダーボタンをクリックし，表示されたカレンダーから日付を選択して指定します。1900年1月1日から2100年12月31日までの日付を指定できます。［クリア］ボタンをクリックすると，指定した内容が削除されます。

passwordの場合

テキストボックスに，文字列を入力します。1,024文字まで入力できます。入力した文字列は「●」で表示されます。

listの場合

［リスト表示値］テキストボックスに入力した項目の中から，デフォルト値に指定する項目を選択して入力します。1,024文字まで入力できます。値に「,」または「¥」が含まれる場合，エスケープする必要はありません。

［最小長］テキストボックス

入力文字列の最小長を指定します。0から1024までの整数を入力します。［最小長］テキストボックスは，データ型にstringまたはpasswordを指定した場合に表示されます。

［最大長］テキストボックス

入力文字列の最大長を指定します。1から1024までの整数を入力します。［最大長］テキストボックスは，データ型にstringまたはpasswordを指定した場合に表示されます。

［入力文字制限］テキストボックス

入力文字制限を指定します。PCREに従った正規表現を指定します。1,024文字まで入力できます。［入力文字制限］テキストボックスは，データ型にstringまたはpasswordを指定した場合に表示されます。

［最小値］テキストボックス

入力プロパティの最小値を指定します。［最小値］テキストボックスは，データ型にinteger，doubleまたはdateを指定した場合に表示されます。指定できる値はデータ型によって異なります。

integerの場合

テキストボックスに，-2147483648から2147483647までの整数を入力します。

doubleの場合

テキストボックスに，-999999999999999から999999999999999までの整数または小数を入力します。17文字まで入力できます。

dateの場合

カレンダーボタンをクリックし，表示されたカレンダーから日付を選択して指定します。1900年1月1日から2100年12月31日までの日付を指定できます。［クリア］ボタンをクリックすると，指定した内容が削除されます。

［最大値］テキストボックス

入力プロパティの最大値を指定します。［最大値］テキストボックスは，データ型にinteger，doubleまたはdateを指定した場合に表示されます。指定できる値はデータ型によって異なります。

integerの場合

テキストボックスに，-2147483648から2147483647までの整数を入力します。

doubleの場合

テキストボックスに，-999999999999999から999999999999999までの整数または小数を入力します。17文字まで入力できます。

dateの場合

カレンダーボタンをクリックし，表示されたカレンダーから日付を選択して指定します。1900年1月1日から2100年12月31日までの日付を指定できます。［クリア］ボタンをクリックすると，指定した内容が削除されます。

［リスト表示値］テキストボックス

リストボックスに表示する項目を指定します。表示項目を「,」で区切って入力します。「,」や「¥」を値として指定したい場合は，「¥」でエスケープします。1,024文字まで入力できます。［リスト表示値］テキストボックスは，データ型にlistを指定した場合に表示されます。

［OK］ボタン

クリックすると，入力プロパティが追加されます。

［キャンセル］ボタン

クリックすると，［サービスの入力プロパティ作成］ダイアログボックスが閉じます。

7.4.11　［サービスの入力プロパティ編集］ダイアログボックス

［サービスの入力プロパティ編集］ダイアログボックスは，サービスの入力プロパティを編集するための画面です。［サービスの入力プロパティ編集］ダイアログボックスは，［サービス定義編集］ダイアログボックスで，［入力プロパティ一覧］の［編集］ボタンをクリックすると表示されます。

図7‒42　［サービスの入力プロパティ編集］ダイアログボックス（［データ型］に［string］を選択した場合）

表示項目について説明します。なお，編集対象のプロパティがビルトインサービス共有プロパティの場合は，［プロパティ名］テキストボックス，［説明］テキストボックスおよび［プロパティグループ］リストボックスだけ編集できます。

［プロパティキー］テキストボックス

プロパティキーを入力します。128文字まで入力できます。

［プロパティ名］テキストボックス

プロパティの名称を入力します。128文字まで入力できます。

［説明］テキストボックス

プロパティの説明を入力します。256文字まで入力できます。

［プロパティグループ］リストボックス

プロパティを所属させるプロパティグループを選択します。［サービス定義編集］ダイアログボックスに定義されているプロパティグループの名称が表示されます。

［可視性］ラジオボタン

入力プロパティの可視性を選択します。

exec

選択すると，プロパティ値をサービス編集時およびサービス実行時に設定できます。

config

選択すると，プロパティ値をサービス編集時に設定できます。

［スコープ］チェックボックス

入力プロパティのスコープを設定します。チェックすると，入力プロパティはサービス共有プロパティになります。

［必須区分］チェックボックス

入力プロパティの必須区分を設定します。チェックすると，入力が必須のプロパティになります。

［データ型］リストボックス

入力プロパティのデータ型を選択します。

string

データ型にstring（文字列型）が設定されます。

boolean

データ型にboolean（ブーリアン型）が設定されます。

integer

データ型にinteger（int型）が設定されます。

double

データ型にdouble（ダブル型）が設定されます。

date

データ型にdate（日付型）が設定されます。

password

データ型にpassword（パスワード型）が設定されます。

list

データ型にlist（リスト型）が設定されます。

［デフォルト値］

入力プロパティのデフォルト値を入力します。指定できる値はデータ型によって異なります。

stringの場合

テキストボックスに，文字列を入力します。1,024文字まで入力できます。

booleanの場合

リストボックスから，デフォルト値を選択します。未設定，trueおよびfalseから選択できます。

integerの場合

テキストボックスに，-2147483648から2147483647までの整数を入力します。

doubleの場合

テキストボックスに，-999999999999999から999999999999999までの整数または小数を入力します。17文字まで入力できます。

dateの場合

カレンダーボタンをクリックし，表示されたカレンダーから日付を選択して指定します。1900年1月1日から2100年12月31日までの日付を指定できます。［クリア］ボタンをクリックすると，指定した内容が削除されます。

passwordの場合

テキストボックスに，文字列を入力します。1,024文字まで入力できます。入力した文字列は「●」で表示されます。

listの場合

［リスト表示値］テキストボックスに入力した項目の中から，デフォルト値に指定する項目を選択して入力します。1,024文字まで入力できます。値に「,」または「¥」が含まれる場合，エスケープする必要はありません。

［最小長］テキストボックス

入力文字列の最小長を指定します。0から1024までの整数を入力します。［最小長］テキストボックスは，データ型にstringまたはpasswordを指定した場合に表示されます。

［最大長］テキストボックス

入力文字列の最大長を指定します。1から1024までの整数を入力します。［最大長］テキストボックスは，データ型にstringまたはpasswordを指定した場合に表示されます。

［入力文字制限］テキストボックス

入力文字制限を指定します。PCREに従った正規表現を指定します。1,024文字まで入力できます。［入力文字制限］テキストボックスは，データ型にstringまたはpasswordを指定した場合に表示されます。

［最小値］テキストボックス

入力プロパティの最小値を指定します。［最小値］テキストボックスは，データ型にinteger，doubleまたはdateを指定した場合に表示されます。指定できる値はデータ型によって異なります。

integerの場合

テキストボックスに，-2147483648から2147483647までの整数を入力します。

doubleの場合

テキストボックスに，-999999999999999から999999999999999までの整数または小数を入力します。17文字まで入力できます。

dateの場合

カレンダーボタンをクリックし，表示されたカレンダーから日付を選択して指定します。1900年1月1日から2100年12月31日までの日付を指定できます。［クリア］ボタンをクリックすると，指定した内容が削除されます。

［最大値］テキストボックス

入力プロパティの最大値を指定します。［最大値］テキストボックスは，データ型にinteger，doubleまたはdateを指定した場合に表示されます。指定できる値はデータ型によって異なります。

integerの場合

テキストボックスに，-2147483648から2147483647までの整数を入力します。

doubleの場合

テキストボックスに，-999999999999999から999999999999999までの整数または小数を入力します。17文字まで入力できます。

dateの場合

カレンダーボタンをクリックし，表示されたカレンダーから日付を選択して指定します。1900年1月1日から2100年12月31日までの日付を指定できます。［クリア］ボタンをクリックすると，指定した内容が削除されます。

［リスト表示値］テキストボックス

リストボックスに表示する項目を指定します。表示項目を「,」で区切って入力します。「,」や「¥」を値として指定したい場合は，「¥」でエスケープします。1,024文字まで入力できます。［リスト表示値］テキストボックスは，データ型にlistを指定した場合に表示されます。

［OK］ボタン

クリックすると，変更した内容が反映されます。

［キャンセル］ボタン

クリックすると，［サービスの入力プロパティ編集］ダイアログボックスが閉じます。

7.4.12　［サービスの出力プロパティ作成］ダイアログボックス

［サービスの出力プロパティ作成］ダイアログボックスは，サービスの出力プロパティを追加するための画面です。［サービスの出力プロパティ作成］ダイアログボックスは，［サービス定義編集］ダイアログボックスで，［出力プロパティ一覧］の［追加］ボタンをクリックするか，［出力プロパティマッピング］ダイアログボックスで［出力プロパティの追加］ボタンをクリックすると表示されます。

図7‒43　［サービスの出力プロパティ作成］ダイアログボックス（［データ型］に［string］を選択した場合）

表示項目について説明します。

［プロパティキー］テキストボックス

プロパティキーを入力します。128文字まで入力できます。

［プロパティ名］テキストボックス

プロパティの名称を入力します。128文字まで入力できます。

［説明］テキストボックス

プロパティの説明を入力します。256文字まで入力できます。

［データ型］リストボックス

出力プロパティのデータ型を選択します。

string

データ型にstring（文字列型）が設定されます。

password

データ型にpassword（パスワード型）が設定されます。

［デフォルト値］

出力プロパティのデフォルト値を入力します。1,024文字まで入力できます。データ型にpasswordを指定した場合，入力した文字列は「●」で表示されます。

［OK］ボタン

クリックすると，出力プロパティが追加されます。

［キャンセル］ボタン

クリックすると，［サービスの出力プロパティ作成］ダイアログボックスが閉じます。

7.4.13　［サービスの出力プロパティ編集］ダイアログボックス

［サービスの出力プロパティ編集］ダイアログボックスは，サービスの出力プロパティを編集するための画面です。［サービスの出力プロパティ編集］ダイアログボックスは，［サービス定義編集］ダイアログボックスで，［出力プロパティ一覧］の［編集］ボタンをクリックすると表示されます。

図7‒44　［サービスの出力プロパティ編集］ダイアログボックス（［データ型］に［string］を選択した場合）

表示項目について説明します。

［プロパティキー］テキストボックス

プロパティキーを入力します。128文字まで入力できます。

［プロパティ名］テキストボックス

プロパティの名称を入力します。128文字まで入力できます。

［説明］テキストボックス

プロパティの説明を入力します。256文字まで入力できます。

［データ型］リストボックス

出力プロパティのデータ型を選択します。

string

データ型にstring（文字列型）が設定されます。

password

データ型にpassword（パスワード型）が設定されます。

［デフォルト値］

出力プロパティのデフォルト値を入力します。1,024文字まで入力できます。データ型にpasswordを指定した場合，入力した文字列は「●」で表示されます。

［OK］ボタン

クリックすると，変更した内容が反映されます。

［キャンセル］ボタン

クリックすると，［サービスの出力プロパティ編集］ダイアログボックスが閉じます。

7.4.14　［変数作成］ダイアログボックス

［変数作成］ダイアログボックスは，サービスの変数を追加するための画面です。［変数作成］ダイアログボックスは，［サービス定義編集］ダイアログボックスで，［変数一覧］の［追加］ボタンをクリックするか，［入力プロパティマッピング］ダイアログボックスまたは［出力プロパティマッピング］ダイアログボックスで，［変数の追加］ボタンをクリックすると表示されます。

図7‒45　［変数作成］ダイアログボックス（［データ型］に［string］を選択した場合）

表示項目について説明します。

［プロパティキー］テキストボックス

プロパティキーを入力します。128文字まで入力できます。

［プロパティ名］テキストボックス

プロパティの名称を入力します。128文字まで入力できます。

［説明］テキストボックス

プロパティの説明を入力します。256文字まで入力できます。

［データ型］リストボックス

変数のデータ型を選択します。

string

データ型にstring（文字列型）が設定されます。

password

データ型にpassword（パスワード型）が設定されます。

［デフォルト値］

変数のデフォルト値を入力します。1,024文字まで入力できます。データ型にpasswordを指定した場合，入力した文字列は「●」で表示されます。

［OK］ボタン

クリックすると，変数が追加されます。

［キャンセル］ボタン

クリックすると，［変数作成］ダイアログボックスが閉じます。

7.4.15　［変数編集］ダイアログボックス

［変数編集］ダイアログボックスは，サービスの変数を編集するための画面です。［変数編集］ダイアログボックスは，［サービス定義編集］ダイアログボックスで，［変数一覧］の［編集］ボタンをクリックすると表示されます。

図7‒46　［変数編集］ダイアログボックス（［データ型］に［string］を選択した場合）

表示項目について説明します。

［プロパティキー］テキストボックス

プロパティキーを入力します。128文字まで入力できます。

［プロパティ名］テキストボックス

プロパティの名称を入力します。128文字まで入力できます。

［説明］テキストボックス

変数の説明を入力します。256文字まで入力できます。

［データ型］リストボックス

変数のデータ型を選択します。

string

データ型にstring（文字列型）が設定されます。

password

データ型にpassword（パスワード型）が設定されます。

［デフォルト値］

変数のデフォルト値を入力します。1,024文字まで入力できます。データ型にpasswordを指定した場合，入力した文字列は「●」で表示されます。

［OK］ボタン

クリックすると，変更した内容が反映されます。

［キャンセル］ボタン

クリックすると，［変数編集］ダイアログボックスが閉じます。

7.4.16　［ステップ作成］ダイアログボックス

［ステップ作成］ダイアログボックスは，サービステンプレートにステップを追加するための画面です。［ステップ作成］ダイアログボックスは，［部品］ビューから部品を選択し，サービステンプレートエディタ編集ビューの［フロー］ビューにドラッグ&ドロップした場合に，表示されます。

図7‒47　［ステップ作成］ダイアログボックス（1/2）

図7‒48　［ステップ作成］ダイアログボックス（2/2）

表示項目について説明します。

ステップ

ステップの定義情報を指定します。

［ステップID］テキストボックス

ステップIDを入力します。30文字まで入力できます。

［ステップ名］テキストボックス

ステップの名称を入力します。64文字まで入力できます。

［説明］テキストボックス

ステップの説明を入力します。256文字まで入力できます。

［部品］

クリックすると，部品の定義情報が表示されます。

部品

部品の定義情報が表示されます。

部品名

部品の名称が表示されます。

部品バージョン

部品のバージョンが表示されます。部品にバージョンが複数ある場合はリストボックスが表示され，任意のバージョンを選択できます。

ベンダー名

部品のベンダー名が表示されます。

説明

部品の説明が表示されます。

部品ID

部品IDが表示されます。

ベンダーID

部品のベンダーIDが表示されます。

［後続ステップ実行条件］

クリックすると，後続ステップ実行条件が表示されます。

後続ステップ実行条件

後続ステップの実行条件を指定します。

［条件］リストボックス

後続ステップの実行条件を選択します。

部品の戻り値が判定値以下の場合に後続のステップを実行する

常に後続のステップを実行する

常に後続のステップを実行しない

［判定値］テキストボックス

後続ステップの実行条件として部品の戻り値判定を使用する場合に，判定値を入力します。0から255までの数字を入力できます。［判定値］テキストボックスは，［条件］リストボックスで［部品の戻り値が判定値以下の場合に後続のステップを実行する］を選択した場合に表示されます。

［警告設定］チェックボックス

チェックすると，部品の戻り値が警告値以上かつ判定値以下の場合に，ステップを警告状態にします。［警告設定］チェックボックスは，［条件］リストボックスで［部品の戻り値が判定値以下の場合に後続のステップを実行する］を選択した場合に表示されます。

［警告値］テキストボックス

後続ステップの実行条件として，部品の戻り値判定に使用する警告値を入力します。1から255までの数字を入力できます。［警告値］テキストボックスは，［条件］リストボックスで［部品の戻り値が判定値以下の場合に後続のステップを実行する］を選択した場合に表示されます。

［入力プロパティマッピング］

クリックすると，入力プロパティ一覧が表示されます。

入力プロパティ一覧

入力プロパティの一覧が表示されます。表示項目のタイトルをクリックすると，昇順，または降順でソートできます。

表7‒29　入力プロパティ一覧の表示項目（［ステップ作成］ダイアログボックス）

表示項目

説明

入力警告アイコン

マッピングパラメータの設定が必須の入力プロパティに対して，マッピングパラメータの値が入力されていない場合，[図データ]が表示されます。

プロパティキー

プロパティキーが表示されます。

プロパティ名

入力プロパティの名称が表示されます。

説明

入力プロパティの説明が表示されます。

マッピングパラメータ

マッピングパラメータが表示されます。

［クリア］ボタン

クリックすると，入力プロパティに設定したマッピングパラメータが削除されます。

［編集］ボタン

選択した入力プロパティを編集できます。クリックすると，［入力プロパティマッピング］ダイアログボックスが表示されます。

［出力プロパティマッピング］

クリックすると，出力プロパティ一覧が表示されます。

出力プロパティ一覧

出力プロパティの一覧が表示されます。表示項目のタイトルをクリックすると，昇順，または降順でソートできます。

表7‒30　出力プロパティ一覧の表示項目（［ステップ作成］ダイアログボックス）

表示項目

説明

プロパティキー

プロパティキーが表示されます。

プロパティ名

出力プロパティの名称が表示されます。

説明

出力プロパティの説明が表示されます。

マッピングパラメータ

マッピングパラメータが表示されます。

［クリア］ボタン

クリックすると，出力プロパティに設定したマッピングパラメータが削除されます。

［編集］ボタン

選択した出力プロパティを編集できます。クリックすると，［出力プロパティマッピング］ダイアログボックスが表示されます。

［OK］ボタン

クリックすると，ステップが追加されます。

［キャンセル］ボタン

クリックすると，［ステップ作成］ダイアログボックスが閉じます。

7.4.17　［ステップ編集］ダイアログボックス

［ステップ編集］ダイアログボックスは，サービステンプレートのステップを編集するための画面です。［ステップ編集］ダイアログボックスは，次の操作によって表示されます。

サービステンプレートエディタ編集ビューの［ステップ一覧］ビューで［ステップ編集］ボタンをクリックする

サービステンプレートエディタ編集ビューの［フロー］ビューに表示されたステップアイコンを右クリックし，［編集］を選択する

サービステンプレートエディタ編集ビューの［フロー］ビューに表示されたステップアイコンをダブルクリックする

図7‒49　［ステップ編集］ダイアログボックス（1/2）

図7‒50　［ステップ編集］ダイアログボックス（2/2）

表示項目について説明します。

ステップ

ステップの定義情報を指定します。

［ステップID］テキストボックス

ステップIDを入力します。30文字まで入力できます。

［ステップ名］テキストボックス

ステップの名称を入力します。64文字まで入力できます。

［説明］テキストボックス

ステップの説明を入力します。256文字まで入力できます。

［部品］

クリックすると，部品の定義情報が表示されます。

部品

部品の定義情報が表示されます。

部品名

部品の名称が表示されます。

部品バージョン

部品のバージョンが表示されます。

ベンダー名

部品のベンダー名が表示されます。

説明

部品の説明が表示されます。

部品ID

部品IDが表示されます。

ベンダーID

部品のベンダーIDが表示されます。

［後続ステップ実行条件］

クリックすると，後続ステップ実行条件が表示されます。

後続ステップ実行条件

後続ステップの実行条件を指定します。

［条件］リストボックス

後続ステップの実行条件を選択します。

部品の戻り値が判定値以下の場合に後続のステップを実行する

常に後続のステップを実行する

常に後続のステップを実行しない

［判定値］テキストボックス

後続ステップの実行条件として部品の戻り値判定を使用する場合に，判定値を入力します。0から255までの数字を入力できます。［判定値］テキストボックスは，［条件］リストボックスで［部品の戻り値が判定値以下の場合に後続のステップを実行する］を選択した場合に表示されます。

［警告設定］チェックボックス

チェックすると，部品の戻り値が警告値以上かつ判定値以下の場合に，ステップを警告状態にします。［警告設定］チェックボックスは，［条件］リストボックスで［部品の戻り値が判定値以下の場合に後続のステップを実行する］を選択した場合に表示されます。

［警告値］テキストボックス

後続ステップの実行条件として，部品の戻り値判定に使用する警告値を入力します。1から255までの数字を入力できます。［警告値］テキストボックスは，［条件］リストボックスで［部品の戻り値が判定値以下の場合に後続のステップを実行する］を選択した場合に表示されます。

［入力プロパティマッピング］

クリックすると，入力プロパティ一覧が表示されます。

入力プロパティ一覧

入力プロパティの一覧が表示されます。表示項目のタイトルをクリックすると，昇順，または降順でソートできます。

表7‒31　入力プロパティ一覧の表示項目（［ステップ編集］ダイアログボックス）

表示項目

説明

入力警告アイコン

マッピングパラメータの設定が必須の入力プロパティに対して，マッピングパラメータの値が入力されていない場合，[図データ]が表示されます。

プロパティキー

プロパティキーが表示されます。

プロパティ名

入力プロパティの名称が表示されます。

説明

入力プロパティの説明が表示されます。

マッピングパラメータ

マッピングパラメータが表示されます。

［クリア］ボタン

クリックすると，入力プロパティに設定したマッピングパラメータが削除されます。

［編集］ボタン

選択した入力プロパティを編集できます。クリックすると，［入力プロパティマッピング］ダイアログボックスが表示されます。

［出力プロパティマッピング］

クリックすると，出力プロパティ一覧が表示されます。

出力プロパティ一覧

出力プロパティの一覧が表示されます。表示項目のタイトルをクリックすると，昇順，または降順でソートできます。

表7‒32　出力プロパティ一覧の表示項目（［ステップ編集］ダイアログボックス）

表示項目

説明

プロパティキー

プロパティキーが表示されます。

プロパティ名

出力プロパティの名称が表示されます。

説明

出力プロパティの説明が表示されます。

マッピングパラメータ

マッピングパラメータが表示されます。

［クリア］ボタン

クリックすると，出力プロパティに設定したマッピングパラメータが削除されます。

［編集］ボタン

選択した出力プロパティを編集できます。クリックすると，［出力プロパティマッピング］ダイアログボックスが表示されます。

［OK］ボタン

クリックすると，変更した内容が反映されます。

［キャンセル］ボタン

クリックすると，［ステップ編集］ダイアログボックスが閉じます。

7.4.18　［入力プロパティマッピング］ダイアログボックス

［入力プロパティマッピング］ダイアログボックスは，入力プロパティにマッピングパラメータを設定するための画面です。［入力プロパティマッピング］ダイアログボックスは，［ステップ作成］ダイアログボックスまたは［ステップ編集］ダイアログボックスで，［入力プロパティ一覧］の［編集］ボタンをクリックすると，表示されます。

図7‒51　［入力プロパティマッピング］ダイアログボックス

表示項目について説明します。

プロパティキー

入力プロパティのプロパティキーが表示されます。

プロパティ名

入力プロパティの名称が表示されます。

説明

入力プロパティの説明が表示されます。

［マッピング設定］ラジオボタン

マッピングパラメータの指定方法を選択します。［マッピング設定］ラジオボタンは，編集対象のプロパティによっては表示されない場合があります。

プロパティ一覧から選択

マッピングパラメータとして設定するサービスプロパティを一覧から選択します。このラジオボタンを選択すると，［プロパティ一覧］が表示されます。

直接入力

入力プロパティの値を直接入力して指定します。このラジオボタンを選択すると，［マッピングパラメータ］テキストボックスが表示されます。

マッピングパラメータ

画面の表示状態によって，マッピングパラメータの指定方法が異なります。指定方法は次のとおりです。

［プロパティ一覧］が表示されている場合

マッピングパラメータとして設定するサービスプロパティを［プロパティ一覧］から選択します。選択したサービスプロパティのプロパティキーが表示されます。

［マッピングパラメータ］テキストボックスが表示されている場合（［マッピング設定］ラジオボタンが表示されている場合）

マッピングパラメータを直接入力します。1,024文字まで入力できます。

［マッピングパラメータ］テキストボックスが表示されている場合（［マッピング設定］ラジオボタンが表示されていない場合）

マッピングパラメータを直接入力します。入力プロパティに設定された最小値から最大値までの整数を入力します。

［マッピングパラメータ］リストボックスが表示されている場合

マッピングパラメータをリストボックスから選択します。

プロパティ一覧

入力プロパティにマッピングするためのサービスプロパティ一覧が表示されます。サービスプロパティをクリックすると，マッピングパラメータとして表示されます。［プロパティ一覧］は，［マッピング設定］ラジオボタンで［プロパティ一覧から選択］を選択した場合に表示されます。表示項目のタイトルをクリックすると，昇順，または降順でソートできます。

表7‒33　プロパティ一覧の表示項目（［入力プロパティマッピング］ダイアログボックス）

表示項目

説明

プロパティキー

プロパティキーが表示されます。

プロパティ名

プロパティの名称が表示されます。

説明

プロパティの説明が表示されます。

［サービス共有プロパティの選択］ボタン

サービス共有プロパティを入力プロパティとして追加できます。クリックすると，［サービス共有プロパティ選択］ダイアログボックスが表示されます。

［入力プロパティの追加］ボタン

入力プロパティを追加できます。クリックすると，［サービスの入力プロパティ作成］ダイアログボックスが表示されます。

［変数の追加］ボタン

変数を追加できます。クリックすると，［変数作成］ダイアログボックスが表示されます。

［OK］ボタン

クリックすると，入力プロパティのマッピングパラメータが設定されます。

［キャンセル］ボタン

クリックすると，［入力プロパティマッピング］ダイアログボックスが閉じます。

7.4.19　［出力プロパティマッピング］ダイアログボックス

［出力プロパティマッピング］ダイアログボックスは，出力プロパティにマッピングパラメータを設定するための画面です。［出力プロパティマッピング］ダイアログボックスは，［ステップ作成］ダイアログボックスまたは［ステップ編集］ダイアログボックスで，［出力プロパティ一覧］の［編集］ボタンをクリックすると，表示されます。

図7‒52　［出力プロパティマッピング］ダイアログボックス

表示項目について説明します。

プロパティキー

出力プロパティのプロパティキーが表示されます。

プロパティ名

出力プロパティの名称が表示されます。

説明

出力プロパティの説明が表示されます。

マッピングパラメータ

マッピングされているサービスプロパティキーが表示されます。

プロパティ一覧

出力プロパティにマッピングするためのサービスプロパティ一覧が表示されます。サービスプロパティをクリックすると，マッピングパラメータとして表示されます。表示項目のタイトルをクリックすると，昇順，または降順でソートできます。

表7‒34　プロパティ一覧の表示項目（［出力プロパティマッピング］ダイアログボックス）

表示項目

説明

プロパティキー

プロパティキーが表示されます。

プロパティ名

プロパティの名称が表示されます。

説明

プロパティの説明が表示されます。

［出力プロパティの追加］ボタン

出力プロパティを追加できます。クリックすると，［サービスの出力プロパティ作成］ダイアログボックスが表示されます。

［変数の追加］ボタン

変数を追加できます。クリックすると，［変数作成］ダイアログボックスが表示されます。

［OK］ボタン

クリックすると，出力プロパティのマッピングパラメータが設定されます。

［キャンセル］ボタン

クリックすると，［出力プロパティマッピング］ダイアログボックスが閉じます。

7.5　［デバッグ］ビュー

［デバッグ］ビューは，デバッグタスクを管理したり，ステップ単位の実行方法を設定するための画面です。［デバッグ］ビューは，［デバッグ実行］ダイアログボックスで［実行］ボタンをクリックすると［エディタ］画面の左ペインに表示されます。

図7‒53　［デバッグ］ビュー

表示項目について説明します。

[図データ]（［応答入力］ボタン）

クリックすると，［応答入力］ダイアログボックスが表示されます。タスク内で応答待ち中のステップが複数ある場合は，応答待ち中になったステップの順番に従い，［応答入力］ダイアログボックスが表示されます。

[図データ]（［リトライ］リストボックス）

実行が失敗したタスクに対してリトライする方法を選択します。

失敗したステップからリトライ

失敗したステップからリトライするかどうかを確認するダイアログボックスが表示されます。［OK］ボタンをクリックすると，失敗したステップからリトライされます。

失敗した次のステップからリトライ

失敗した次のステップからリトライするかどうかを確認するダイアログボックスが表示されます。［OK］ボタンをクリックすると，失敗したステップの次のステップからリトライされます。

[図データ]（［強制停止］ボタン）

クリックすると，強制停止するかどうかを確認するダイアログボックスが表示されます。［OK］ボタンをクリックすると，デバッグタスクが停止中になったあと失敗になります。

[図データ]（［再開］ボタン）

中断しているステップの実行が再開されます。サービステンプレートデバッグビューのフロービューで選択したステップの状態が中断中または中断中（実行後）の場合，設定できます。

タスク

タスクの情報が表示されます。

状態

デバッグタスクの状態が表示されます。

ステップ

サービステンプレートデバッグビューの［フロー］ビューで選択したステップの情報が表示されます。

ステップID

ステップIDが表示されます。

ステップ名

ステップの名称が表示されます。

状態

ステップの状態が表示されます。

［実行設定］リストボックス

中断しているステップの部品の処理を実行するかどうかを選択します。ステップの状態が中断中の場合に，設定できます。

部品の処理を実行する

部品の処理を実行する場合に選択します。

部品の処理を実行しない

部品の処理を実行しないで，スキップする場合に選択します。

［部品の処理後に中断する］チェックボックス

チェックすると，部品の処理が完了したあとステップが中断します。チェックを外すと，部品の処理が完了したあとステップは中断しないで，次のステップの開始まで実行します。ステップの状態が中断中の場合で，［実行設定］リストボックスで［部品の処理を実行する］を選択した場合に，設定できます。

［戻り値］テキストボックス

部品またはステップの戻り値が表示されます。部品またはステップの戻り値かどうかは，表示するタイミングによって異なります。

ステップの状態が完了の場合

ステップの戻り値が表示されます。

ステップの状態が中断中の場合

部品の戻り値が表示されます。なお，［実行設定］リストボックスで［部品の処理を実行しない］を選択したときに，またはステップの状態が中断中（実行後）の場合に，戻り値を指定できます。戻り値は，0〜127で指定してください。

［改行コード］ラジオボタン

部品のプロパティ値に使用する改行コードを選択します。ステップの状態が中断中または中断中（実行後）の場合に，設定できます。

CR+LF

改行文字「CRLF(0x0d0a)」を使用する場合に選択します。

CR

改行文字「CR(0x0d)」を使用する場合に選択します。

LF

改行文字「LF(0x0a)」を使用する場合に選択します。

プロパティ一覧

ステップに追加されている部品のプロパティ一覧が表示されます。表示項目のタイトルをクリックすると，昇順，または降順でソートできます。デバッグ実行に必要なプロパティ値を設定できます。

表7‒35　プロパティ一覧の表示項目（［デバッグ］ビュー）

表示項目

説明

プロパティの種別アイコン

プロパティの種別がアイコンで表示されます。

入力プロパティを示すアイコンです。

出力プロパティを示すアイコンです。

プロパティキー

プロパティキーが表示されます。

マッピングパラメータ

マッピングパラメータが表示されます。

プロパティ値

部品に入力するプロパティ値，および出力されたプロパティ値が表示されます。サービスプロパティをマッピングしている場合，ステップの実行を中断した時点のサービスプロパティの値が表示されます。データ型がpasswordの場合，入力した文字列は「●」で表示されます。入力プロパティは，ステップの状態が中断中の場合で，［実行設定］リストボックスで［部品の処理を実行する］を選択した場合，編集できます。出力プロパティは，ステップの状態が中断中の場合で，［実行設定］リストボックスで［部品の処理を実行しない］を選択したときに，またはステップの状態が中断中（実行後）の場合，編集できます。なお，プロパティ値は，1,024文字まで入力できます。

関連トピック

マニュアル「JP1/AO 運用ガイド」−「タスクの状態一覧と状態遷移」のトピック

マニュアル「JP1/AO 運用ガイド」−「ステップの状態一覧」のトピック

マニュアル「JP1/AO サービステンプレート開発ガイド」−「実行したコマンドまたはスクリプトの戻り値，部品の戻り値，ステップの戻り値の関係について」のトピック

マニュアル「JP1/AO サービステンプレート開発ガイド」−「マッピングパラメータの定義例とデータの流れについて」のトピック

7.6　サービステンプレートデバッグビュー

サービステンプレートデバッグビューは，サービステンプレートをデバッグするための画面です。サービステンプレートデバッグビューは，［デバッグ実行］ダイアログボックスで［実行］ボタンをクリックすると［エディタ］画面の右ペインに表示されます。

図7‒54　サービステンプレートデバッグビュー

表示項目について説明します。

［サービス定義参照］ボタン

サービスの定義情報を参照できます。クリックすると，［サービス定義参照］ダイアログボックスが表示されます。

［デバッグ実行］ボタン

サービステンプレートのデバッグ終了後に，再度デバッグを開始できます。クリックすると，［デバッグ実行］ダイアログボックスが表示されます。

［リリース］ボタン

サービステンプレートをリリースできます。クリックすると，サービステンプレートをリリースするかどうか確認するメッセージダイアログボックスが表示され，［OK］ボタンをクリックすると，リリースが開始されます。リリースの実行結果は，［ビルド/リリース結果］ダイアログボックスに表示されます。

［デバッグ終了］ボタン

クリックすると，左ペインに［部品］ビュー，右ペインにサービステンプレートエディタ編集ビューが表示されます。

［フロー］ビュー

ステップの実行順序が表示されます。ステップアイコンにステップの状態を示すアイコンが表示されます。ステップアイコンは複数選択できません。

階層フロー部品を使用するステップをダブルクリックすると，その配下のフローが表示されます。

繰り返し実行部品を使用するステップをダブルクリックすると，繰り返し実行フローが繰り返す回数分表示されます。繰り返し実行フローは，繰り返し実行部品の実行開始以降（実行中および実行後も含む）のタイミングで表示されます。フロー名は「繰り返しの回次番号_繰り返し実行入力値（reserved.loop.input）」の形式で表示されます。

階層フロー部品，繰り返し実行部品，繰り返し実行フロー以外のステップアイコンをダブルクリックすると，［ステップ参照］ダイアログボックスが表示されます。

ステップの状態が中断中または中断中（実行後）の場合，ステップの枠は青色に強調表示されます。ステップ実行を中断できない部品の場合，ステップの背景は暗く強調表示されます。また，繰り返し実行部品の配下のステップの背景も，繰り返し実行部品が実行されるまで，暗く強調表示されます。

［表示］リストボックス

［フロー］ビューの表示倍率を選択します。倍率は「25％」「50％」「75％」または「100％」から選択できます。

ステップアイコンを右クリックすると，次の操作を選択できます。

参照

選択すると，［ステップ参照］ダイアログボックスが表示されます。繰り返し実行フロー以外のステップアイコンの場合に，選択できます。

再開

選択すると，中断しているステップの実行が再開されます。ステップの状態が中断中または中断中（実行後）の場合に，選択できます。

［フローツリー］ビュー

サービステンプレートのフロー名が階層表示されます。中断しているステップがある階層には，中断中を示すアイコンが表示されます。フロー名をクリックすると，その配下のフローが［フロー］ビューに表示されます。

繰り返し実行部品をクリックすると，繰り返し実行フローが繰り返す回数分［フロー］ビューに表示されます。繰り返し実行フローは，繰り返し実行部品の実行開始以降（実行中および実行後も含む）のタイミングで，フローツリーに表示されます。フローツリーには「繰り返しの回次番号_繰り返し実行入力値（reserved.loop.input）」の形式で表示されます。

［タスクログ］タブ

デバッグタスクのタスクログが表示されます。

ログ表示エリア

タスクログの出力内容が表示されます。表示されるログのサイズについては，プロパティファイル（config_user.properties）のキー「client.debugger.tasklog.maxfilesize」で設定できます。

［自動更新する］チェックボックス

チェックすると，タスクの状態に関わらずログ表示エリアが自動更新されて，タスクログの最終行が表示されます。チェックを外すと，ログ表示エリアは自動更新されません。

［更新］ボタン

クリックすると，ログ表示エリアの表示が更新されて，タスクログの最終行が表示されます。

［ログダウンロード］ボタン

クリックすると，ダウンロードダイアログボックスが表示され，タスクログをダウンロードできます。タスクログのファイル名は，デフォルトで「task_タスクID_1.log」と表示されます。ファイル名は，変更して保存できます。

［プロパティ一覧］タブ

デバッグしたサービステンプレートのプロパティ一覧が表示されます。表示項目のタイトルをクリックすると，昇順，または降順でソートできます。

表7‒36　［プロパティ一覧］タブの表示項目（サービステンプレートデバッグビュー）

表示項目

説明

プロパティの種別アイコン

プロパティの種別がアイコンで表示されます。

入力プロパティを示すアイコンです。

出力プロパティを示すアイコンです。

変数を示すアイコンです。

プロパティキー

プロパティキーが表示されます。

プロパティ名

プロパティまたは変数の名称が表示されます。

プロパティ値

プロパティ値または変数の値が表示されます。データ型がpasswordの場合，入力した文字列は「●」で表示されます。

関連トピック

付録A.2(2)　ステップの状態を示すアイコン

マニュアル「JP1/AO 構築ガイド」−「プロパティファイル（config_user.properties）」のトピック

8　コマンド

JP1/AOで使用できるコマンドについて説明します。

8.1　コマンド一覧

JP1/AOで使用できるコマンドの一覧を次に示します。

なお，コマンド名の先頭がhcmdsのものとhcmds64のものが併記されている場合，JP1/AOサーバのOSがWindowsのときはコマンド名の先頭がhcmdsのコマンドを，JP1/AOサーバのOSがLinuxのときはコマンド名の先頭がhcmds64のコマンドを使用してください。

表8‒1　構築関連のコマンド

コマンド名

機能

参照先

encryptpassword（パスワードファイルの作成）

コマンドの引数に指定するパスワードファイルを作成します。

8.5.1　encryptpassword（パスワードファイルの作成）

hcmdscheckauth/hcmds64checkauth（外部認証サーバとの接続確認）

外部認証サーバと連携する場合に，外部認証サーバ連携コンフィグファイルの設定および外部認証サーバとの接続を確認します。

8.5.2　hcmdscheckauth/hcmds64checkauth（外部認証サーバとの接続確認）

hcmdsfwcancel（Windowsファイアウォールの例外登録）

WindowsファイアウォールによってJP1/AOサーバとWebブラウザーの間の通信が遮断されないように例外登録します。JP1/AOとWebブラウザー間のポート番号を変更する場合に使用します。

8.5.3　hcmdsfwcancel（Windowsファイアウォールの例外登録）

hcmdsintg/hcmds64intg（認証データの削除・確認）

ユーザーアカウントを管理しているサーバのリポジトリーに登録されている認証データを削除します。また，認証データが登録されているサーバのアドレスを表示します。

JP1/AOのアンインストール時に認証データを削除できなかった場合に，このコマンドを使用して認証データを削除します。

8.5.4　hcmdsintg/hcmds64intg（認証データの削除・確認）

hcmdsldapuser/hcmds64ldapuser（LDAP検索用ユーザー登録・削除）

Active Directoryと連携する場合，Active Directoryの登録情報検索に必要なユーザー情報を登録します。また，登録したユーザーを削除できます。

8.5.5　hcmdsldapuser/hcmds64ldapuser（LDAP検索用ユーザー登録・削除）

hcmdsssltool/hcmds64ssltool（秘密鍵・自己署名証明書の作成）

SSL接続に必要な秘密鍵，CSR，自己署名証明書，および自己署名証明書の内容ファイルを作成します。

8.5.6　hcmdsssltool/hcmds64ssltool（秘密鍵・自己署名証明書の作成）

setupcluster（クラスタ環境の構築）

JP1/AOをクラスタ環境に構築します。

8.5.7　setupcluster（クラスタ環境の構築）

stopcluster（クラスタ環境でのサービス停止の準備）

クラスタ環境でJP1/AOサービスを停止するための準備をします。クラスタ環境でJP1/AOのサービスを停止する場合には，事前にこのコマンドを実行します。

8.5.8　stopcluster（クラスタ環境でのサービス停止の準備）

表8‒2　運用関連のコマンド

コマンド名

機能

参照先

deleteservicetemplate（サービステンプレートの削除）

JP1/AOに登録されているサービステンプレートを削除します。

8.6.1　deleteservicetemplate（サービステンプレートの削除）

hcmdschgurl/hcmds64chgurl（URL情報の更新）

共通コンポーネントのリポジトリーに格納されている，アプリケーションの起動に使用するアクセス情報（URL情報）を更新します。

JP1/AOの運用を開始したあと，システム構成を変更した場合に使用します。

8.6.2　hcmdschgurl/hcmds64chgurl（URL情報の更新）

hcmdssrv/hcmds64srv（JP1/AOの開始・停止・状態表示）

JP1/AOのサービスとデータベースを開始および停止します。また，JP1/AOのサービスの状態を表示します。

8.6.3　hcmdssrv/hcmds64srv（JP1/AOの開始・停止・状態表示）

hcmdsunlockaccount/hcmds64unlockaccount（ユーザーアカウントのロック解除）

ユーザーアカウントのロックを解除します。すべてのユーザーアカウントがロックされてJP1/AOにログインできない場合に使用します。

8.6.4　hcmdsunlockaccount/hcmds64unlockaccount（ユーザーアカウントのロック解除）

importservicetemplate（サービステンプレートのインポート）

サービステンプレートをJP1/AOに追加します。

8.6.5　importservicetemplate（サービステンプレートのインポート）

listservices（サービス・サービステンプレートの一覧出力）

JP1/AOに登録されているサービスまたはサービステンプレートの一覧をCSV形式で出力します。

8.6.6　listservices（サービス・サービステンプレートの一覧出力）

listtasks（タスクの一覧出力，タスク詳細情報出力）

タスクまたは履歴の一覧をCSV形式で出力します。

タスク詳細情報を，指定したフォルダに出力します。

8.6.7　listtasks（タスクの一覧出力，タスク詳細情報出力）

stoptask（タスクの実行停止）

タスクIDを指定することで，指定したタスクを実行停止します。

8.6.8　stoptask（タスクの実行停止）

submittask（サービスの実行，タスクの一括再登録）

実行するサービス名やプロパティ値を指定して，サービスを実行します。

listtasksコマンドで出力したタスク詳細情報を元に，指定日時実行タスクおよび定期実行タスクを一括で再登録します。

8.6.9　submittask（サービスの実行，タスクの一括再登録）

表8‒3　保守・メンテナンス関連のコマンド

コマンド名

機能

参照先

backupsystem（JP1/AOシステムのバックアップ）

JP1/AOの設定情報やデータベース情報をバックアップして指定したフォルダにデータを格納します。

8.7.1　backupsystem（JP1/AOシステムのバックアップ）

hcmdsdbrepair/hcmds64dbrepair（データベースの再作成）

データベースを強制削除して再作成し，バックアップデータからデータベースを回復します。データベースが破損してrestoresystemコマンド，およびhcmdsdbtransコマンドまたはhcmds64dbtransコマンドのimportオプションを使用しても復旧できない場合に，このコマンドを使用します。

8.7.2　hcmdsdbrepair/hcmds64dbrepair（データベースの再作成）

hcmdsdbsrv/hcmds64dbsrv（データベースの開始・停止）

JP1/AOのデータベースを開始および停止します。データベースのメンテナンスを実施するときに使用します。

8.7.3　hcmdsdbsrv/hcmds64dbsrv（データベースの開始・停止）

hcmdsdbtrans/hcmds64dbtrans（データベースのバックアップ・リストア）

JP1/AOのデータベースをバックアップおよびリストアします。JP1/AOのデータベースを再編成する場合に使用します。

8.7.4　hcmdsdbtrans/hcmds64dbtrans（データベースのバックアップ・リストア）

hcmdsgetlogs/hcmds64getlogs（ログ情報の採取）

JP1/AOの運用中に出力されるログ情報を採取してアーカイブファイルに出力します。

8.7.5　hcmdsgetlogs/hcmds64getlogs（ログ情報の採取）

restoresystem（JP1/AOシステムのリストア）

backupsystemコマンドで取得したJP1/AOの設定情報やデータベース情報のバックアップデータをリストアします。

8.7.6　restoresystem（JP1/AOシステムのリストア）

8.2　コマンド使用時の注意事項

コマンド使用時の注意事項を次に示します。

Windows Server 2008のホストで，Administrators権限が必要なコマンドを実行する場合は，コマンドプロンプトを管理者として起動する必要があります。Windowsの［スタート］メニューの［コマンドプロンプト］を右クリックし，［管理者として実行］を選択すると，管理者として起動できます。なお，UAC機能が無効の場合，コマンドプロンプトを管理者として起動する必要はありません。

JP1/AOサーバのOSがWindowsの場合，コマンドプロンプトで「簡易編集モード」を有効にして画面上でマウスをクリックすると，簡易編集モードを解除するまで画面出力が停止します。このため，「簡易編集モード」を使用しないことを推奨します。

クラスタ環境でコマンドを使用する場合は，実行系のホストで実行してください。ただし，hcmdsgetlogsコマンドまたはhcmds64getlogsコマンドは，待機系のホストでも実行できます。

コマンドの実行を中断したい場合は，［Ctrl］＋［C］キーを押してください。コマンドの実行を中断した場合は，中断時のメッセージを確認して問題が発生していないか確認してください。再実行したい場合は，再度コマンドを実行してください。

コマンドの実行中に［Ctrl］＋［S］キーを押さないでください。［Ctrl］＋［S］キーを押すと，コマンドの出力が停止します。

stoptaskコマンド，submittaskコマンド，およびstopclusterコマンド以外のコマンドは，JP1/AOのほかのコマンドと同時に実行できません。

コマンドの種類によっては，コマンドを実行した直後に割り込み操作をした場合，「2（コマンドの実行を中断しました）」以外の戻り値が返るときがあります。

stoptaskコマンド，submittaskコマンドはそれぞれ同時に10個まで実行できます。それを超えて実行した場合，次のメッセージが表示されタスクは実行されません。

KNAE03236-Eコマンドの同時実行数を超えました。実行中のコマンドの終了を待って，再実行してください。

次のコマンドを実行する場合，プロパティファイルの設定を変更することで，監査ログに出力されるサブジェクト識別情報を変更できます。

deleteservicetemplateコマンド

importservicetemplateコマンド

listservicesコマンド

listtasksコマンド

stoptaskコマンド

submittaskコマンド

JP1/AOサーバのOSがLinuxの場合，標準設定でコアファイル出力時の最大サイズが「0」になっていると，コアダンプは出力されません。障害時にコアダンプを出力するには，ulimitコマンドを実行して，各コマンドを実行する前に最大サイズを無制限(unlimited)に設定してください。

JP1/AOサーバのOSがWindowsの場合，指定したファイルパスの大文字・小文字は区別されません。JP1/AOサーバのOSがLinuxの場合，指定したファイルパスの大文字・小文字は区別されます。

関連トピック

マニュアル「JP1/AO 構築ガイド」−「プロパティファイル（config_user.properties）」のトピック

8.3　コマンドの引数に指定できる文字

コマンドの引数に指定できる文字を次に示します。

コマンドの引数の指定方法は，OSのコマンドプロンプトやシェルの仕様に従います。そのため，引数の値に空白や特殊記号を含む場合，「"」で囲むなどしてエスケープする必要があります。

各コマンドの引数でパスを指定するときに使用できる文字の種類は次のとおりです。

半角英数字，「_」，「.」，「-」，「 」，「(」，「)」，「#」，「@」，「:」，「¥」

なお，JP1/AOサーバのOSがLinuxの場合は，フォルダ区切りとしてだけ「/」も使用できます。

JP1/AOサーバのOSがWindowsの場合，「:」はドライブ区切りとしてだけ使用できます。

JP1/AOサーバのOSがWindowsの場合，「¥」はフォルダ区切りとしてだけ使用できます。

引数でパスを指定する場合，UNC形式のパスは指定できません。

引数でパスを指定する場合，フォルダ名の先頭または末尾が空白のパスは指定できません。空白だけのフォルダ名の場合も同様です。

引数でパスを指定する場合，フォルダ名の先頭または末尾が「.」のパスは指定できません。ピリオドだけのフォルダ名の場合も同様です。

特に断りがない場合，パスの長さは絶対パスで1〜230文字で指定できます。

特に断りがない場合，各コマンドの引数は大文字・小文字が区別されます。

次に示す名称はOSの予約語のため，ファイル名およびフォルダ名に指定しないでください。

CON，PRN，AUX，CLOCK$，NUL，COM0，COM1，COM2，COM3，COM4，COM5，COM6，COM7，COM8，COM9，LPT0，LPT1，LPT2，LPT3，LPT4，LPT5，LPT6，LPT7，LPT8，LPT9

8.4　コマンドの記述形式

コマンドの記述形式について説明します。

各コマンドで説明する項目は次のとおりです。ただし，コマンドによっては説明しない項目もあります。

機能

コマンドの機能について説明しています。

形式

コマンドの指定形式を次の形式で説明しています。

コマンド名［［/オプション［値］］…］

/オプションと値の組み合わせを「オプション」と呼びます。各コマンドのオプションをまとめて「引数」と呼びます。

引数

コマンドの引数について説明しています。

なお，JP1/AOサーバのOSがLinuxの場合，「/」は「-」に読み替えてください。

格納先

コマンドの格納場所について説明しています。

なお，JP1/AOサーバのOSがLinuxの場合，「￥」は「/」に読み替えてください。

実行権限

コマンドの実行に必要なユーザーの権限について説明しています。

注意事項

コマンド使用時の注意事項を説明しています。

戻り値

コマンドの戻り値について説明しています。

なお，コマンド実行時に表示されるメッセージについては，マニュアル「JP1/AO メッセージ」を参照してください。

コマンドによっては監査ログを出力します。監査ログを出力するコマンド，監査の対象となる操作，および出力されるメッセージIDについては，マニュアル「JP1/AO 運用ガイド」の「監査ログに出力される事象の種別」のトピックを参照してください。

使用例

コマンドの使用例について説明しています。

8.5　構築関連のコマンド

8.5.1　encryptpassword（パスワードファイルの作成）

機能

JP1/AOのコマンドの引数に指定するパスワードファイルを作成します。

JP1/AOに登録済みのユーザーのユーザーID，パスワード，および作成するパスワードファイルのパスを引数に指定してコマンドを実行すると，暗号化されたパスワードファイルを作成できます。

各コマンドの実行時に，パスワードを指定する代わりに，作成したパスワードファイルを指定することで，パスワードの指定が不要になります。

形式

encryptpassword
     /user ユーザーID
     /password パスワード
     /passwordfile パスワードファイルパス

引数

/user ユーザーID

パスワードファイルを作成したいJP1/AOのユーザーIDを指定します。

指定できる文字数は，1〜256文字です。

使用できる文字の種類は，半角英数字，「!」，「#」，「$」，「%」，「&」，「'」，「(」，「)」，「*」，「+」，「-」，「.」，「=」，「@」，「¥」，「^」，「_」，「|」です。

大文字と小文字は区別しません。

/password パスワード

userオプションで指定した，ユーザーのパスワードを指定します。

指定できる文字数は，1〜256文字です。

使用できる文字の種類は，userオプションと同じです。

/passwordfile パスワードファイルパス

作成するパスワードファイルのパスを絶対パスまたは相対パスで指定します。指定したパスが存在する場合はエラーとなります。

格納先

Windowsの場合

JP1/AOのインストール先フォルダ¥bin

Linuxの場合

/opt/jp1ao/bin

実行権限

Administrators権限またはroot権限を持つユーザーで実行してください。Administrators権限またはroot権限がない場合は，権限昇格を求めるメッセージが表示されます。

戻り値

コマンドの戻り値を次の表に示します。

戻り値

説明

0

正常に終了しました。

1

引数が不正です。

2

コマンドの実行を中断しました。

3

サービスの状態が不正です。

4

排他エラーが発生しました。

5

通信に失敗しました。

6

認証に失敗しました（指定された値が不正です）。

7

パスの指定が不正です。

8

出力パスが存在しています。

9

指定したパスが存在しません。

10

指定したパスにアクセスできません。

14

コマンドの実行権限がありません。

200

パスワードファイルの作成に失敗しました。

255

そのほかのエラーでコマンドの実行が中断しました。

使用例

Windowsで，指定したユーザーのパスワードファイルを作成する場合のコマンドの使用例を示します。

encryptpassword /user user01 /password pass01 /passwordfile passfile

関連トピック

8.3　コマンドの引数に指定できる文字

8.5.2　hcmdscheckauth/hcmds64checkauth（外部認証サーバとの接続確認）

機能

外部認証サーバと連携する場合に，外部認証サーバ連携コンフィグファイルの設定および外部認証サーバとの接続を確認します。

JP1/AOでは外部認証サーバとしてJP1/BaseまたはActive Directoryと連携できます。

このコマンドを実行すると次の項目がチェックされます。

外部認証サーバ連携コンフィグファイル（exauth.properties）の，外部認証サーバ連携時に共通で使用するキーの値

外部認証サーバ連携コンフィグファイル（exauth.properties）のauth.server.typeキーに値が正しく設定されているかどうか

JP1/Baseの認証機能と連携する場合はauth.server.typeキーに「jp1base」を，Active Directoryと連携する場合は「ldap」を指定してください。大文字と小文字は区別されます。auth.server.typeキーのデフォルトを示す「internal」が指定された場合には，外部認証サーバの設定が有効になっていないことを示すエラーメッセージが表示されます。

JP1/Baseの認証機能と連携する場合，次の項目がチェックされる

JP1/Baseと共通コンポーネントが同一ホストに存在するかどうか

JP1/Baseがサポートしているバージョンかどうか

JP1/Baseのユーザーが正しく認証できるかどうか

Active Directoryと連携する場合，次の項目がチェックされる

外部認証サーバ連携コンフィグファイル（exauth.properties）の，Active Directory連携時に使用するキーの値

Active Directoryと接続できるかどうか

Active Directoryと接続できる場合，グループ検索は可能か

形式

hcmdscheckauth | hcmds64checkauth
     /user ユーザー名
     /pass パスワード
     ［/summary］

引数

/user ユーザー名

外部認証サーバに登録済みのユーザー名を指定します。ただし，JP1/Baseの認証機能と連携する場合には，JP1/AOに登録済みのユーザー名と重複しないユーザー名を指定してください。

/pass パスワード

外部認証サーバに登録済みのユーザー名に対応するパスワードを指定します。

/summary

コマンド実行時に表示される確認メッセージを簡略化します。このオプションを指定した場合，表示されるメッセージは，処理フェーズごとの成否を示すメッセージ，エラーメッセージ，および結果を示すメッセージだけとなります。ただし，結果を示すメッセージと同様のエラーメッセージがある場合，途中のエラーメッセージが省略されて，結果を示すメッセージだけが表示されます。

格納先

Windowsの場合

共通コンポーネントのインストール先フォルダ¥bin

Linuxの場合

/opt/HiCommand/Base64/bin

実行権限

Administrators権限またはroot権限を持つユーザーで実行してください。

戻り値

戻り値

説明

0

正常に終了しました。

1〜99

シンタックスエラーの総数です。

100

シンタックスエラーの行数が100を超えた場合の終了コードです。

101〜199

接続エラーまたは認証エラーが発生しました。

1の位：接続エラーの数

10の位：認証エラーの数

それぞれの位の最大は9です。9以上発生しても9のままとなります。

247

userオプションに指定したユーザーIDが，JP1/AOに登録されているユーザーIDと重複しているため，認証できません。重複していないユーザーIDを指定してください。

248

JP1/Baseが，このコマンドを実行したホストと同一ホスト上にインストールされていません。

249

サポートしていないバージョンのJP1/Baseが使用されています。

250

セカンダリーサーバからコマンドが実行されました。

252

定義ファイルの共通項目の設定が不正です。

253

外部認証連携が設定されていません。

254

引数が不正です。

255

異常終了しました。

使用例

Windowsで，外部認証サーバとの接続を確認する場合のコマンドの使用例を示します。

hcmdscheckauth /user test01 /pass TTdate00 /summary

関連トピック

8.3　コマンドの引数に指定できる文字

8.5.3　hcmdsfwcancel（Windowsファイアウォールの例外登録）

機能

WindowsファイアウォールによってJP1/AOサーバとWebブラウザーの間の通信が遮断されないように例外登録します。JP1/AOとWebブラウザー間のポート番号をデフォルト値から変更する場合に使用します。

形式

hcmdsfwcancel

格納先

共通コンポーネントのインストール先フォルダ¥bin

実行権限

Administrators権限を持つユーザーで実行してください。

戻り値

このコマンドには戻り値がありません。このため，処理が正常に終了したかどうかは，Windows ファイアウォールに正しく例外登録されているかどうかで確認してください。

Windows ファイアウォールは，Windowsの［コントロールパネル］の［Windows ファイアウォール］で確認できます。

8.5.4　hcmdsintg/hcmds64intg（認証データの削除・確認）

機能

ユーザーアカウントを管理しているサーバのリポジトリーに登録されている認証データを削除します。また，認証データが登録されているサーバのアドレスを表示します。

JP1/AOのアンインストール時に認証データを削除できなかった場合に，このコマンドを使用して認証データを削除します。

形式

hcmdsintg | hcmds64intg
     {/delete /type Automation | /print | /primary }
      /user ユーザーID
      /pass パスワード

引数

/delete

認証データを削除します。

/type Automation

認証データが登録されているサーバの製品名として「Automation」を指定します。

/print

認証データが登録されているプログラム名称を表示します。

/primary

認証データが登録されているサーバのホスト名，またはIPアドレスを表示します。

/user ユーザーID

認証データが登録されているサーバに接続するためのユーザーIDを指定します。User Management権限を持つアカウントのユーザーIDを指定します。

/pass パスワード

User Management権限を持つアカウントのパスワードを指定します。

格納先

Windowsの場合

共通コンポーネントのインストール先フォルダ¥bin

Linuxの場合

/opt/HiCommand/Base64/bin

実行権限

Administrators権限またはroot権限を持つユーザーで実行してください。

戻り値

コマンドの戻り値を次の表に示します。

戻り値

説明

0

正常に終了しました。

1

すでに，認証データが削除されています。

2

コマンドを実行したサーバに，認証データが登録されています。

3

コマンドを実行したサーバに，認証データが登録されていません。

4

コマンドを実行したサーバに，認証データが登録されていません。また，認証データが登録されているサーバで認証エラーが発生しました。

253

認証データが登録されているサーバで認証エラーが発生しました。

254

認証データが登録されているサーバとの通信に失敗しました。

255

異常終了しました。

使用例

Windowsで，ユーザーアカウントを管理しているサーバから認証データを削除する場合のコマンドの使用例を示します。

hcmdsintg /delete /type Automation /user user1 /pass pass1

関連トピック

8.3　コマンドの引数に指定できる文字

8.5.5　hcmdsldapuser/hcmds64ldapuser（LDAP検索用ユーザー登録・削除）

機能

Active Directoryと連携する場合，Active Directoryの登録情報検索に必要なユーザー情報を登録します。また，登録したユーザー情報を削除できます。

このコマンドでユーザー情報を登録した場合は，引き続きhcmdscheckauthコマンドまたはhcmds64checkauthコマンドを実行して正しく認証できるかを確認してください。

形式

hcmdsldapuser | hcmds64ldapuser
     {/set /dn ユーザー識別子 /pass パスワード | /delete}
     /name {サーバ識別名 | ドメイン名}
     | /list

引数

/set

ユーザー情報を登録します。

/dn ユーザー識別子

登録するユーザーのユーザー識別子を指定します。使用可能な文字はRFC 4514に従ってください。

「&」「|」「^」「(」「)」「<」「>」は「"」で囲むか，「^」でエスケープしてください。

末尾に「¥」があり，値として指定したい場合は，「¥」でエスケープしてください。

/pass パスワード

dnオプションで指定した，ユーザーのパスワードを指定します。

/delete

登録されているユーザー情報を削除します。nameオプションで指定したサーバ識別名またはドメイン名を含むユーザーの情報を削除します。

/name {サーバ識別名 | ドメイン名}

ユーザー情報の登録をする場合，登録先になるサーバ識別名またはドメイン名を指定します。

ユーザー情報の削除をする場合，削除するユーザーの登録されているサーバ識別名またはドメイン名を指定します。

ただし，Active Directoryとのグループ連携が無効で，LDAP検索用ユーザーが登録されている場合，ドメイン名は指定できません。サーバ識別名を指定してください。

/list

登録したユーザー情報に含まれている，サーバ識別名とドメイン名の一覧を表示します。

格納先

Windowsの場合

共通コンポーネントのインストール先フォルダ¥bin

Linuxの場合

/opt/HiCommand/Base64/bin

実行権限

Administrators権限またはroot権限を持つユーザーで実行してください。Administrators権限またはroot権限がない場合は，権限昇格を求めるメッセージが表示されます。

戻り値

コマンドの戻り値を次の表に示します。

戻り値

説明

0

正常に終了しました。

1

引数が不正です。

2

引数に指定できない文字が含まれています。

3

登録された情報が見つかりません。

255

そのほかのエラーでコマンドの実行が中断しました。

使用例

Windowsで，ユーザー情報を登録する場合

ユーザー名「suzuki」，所属グループ「Users」，サーバドメイン名「example.com」，パスワード「qweasd00」のユーザー情報を登録する。

hcmdsldapuser /set /dn "CN=suzuki,CN=Users,DC=Example,DC=com" /pass qweasd00 /name example.com

Windowsで，ユーザー情報を削除する場合

サーバ名「tokyo」のユーザーの情報を削除する。

hcmdsldapuser /delete /name tokyo

Windowsで，登録されているサーバ識別名とドメイン名の一覧を表示する場合

hcdmsldapuser /list

出力例

登録されているサーバ識別名とドメイン名の一覧を出力した場合の例

[ServerName]
tokyo
osaka
kyoto

関連トピック

8.3　コマンドの引数に指定できる文字

8.5.6　hcmdsssltool/hcmds64ssltool（秘密鍵・自己署名証明書の作成）

機能

SSL接続に必要な秘密鍵，CSR，自己署名証明書および自己署名証明書の内容ファイルを作成します。作成したファイルは，次の用途で使用します。

CSRをCAに提出してSSLサーバ証明書を取得します。取得したSSLサーバ証明書と秘密鍵を組み合わせて，SSL接続環境を構築できます。

自己署名証明書と秘密鍵を組み合わせて，SSL接続環境を構築できます。ただし，セキュリティ強度が低いためテスト目的での利用をお勧めします。

自己署名証明書の内容ファイルで，自己署名証明書の登録内容が確認できます。

形式

hcmdsssltool | hcmds64ssltool
     /key 秘密鍵ファイル名
     /csr CSRファイル名
     /cert 自己署名証明書ファイル名
     /certtext 自己署名証明書の内容ファイル名
     [/validity 自己署名証明書有効期限 /dname 識別名（DN） /sigalg 署名アルゴリズム]

引数

/key 秘密鍵ファイル名

秘密鍵を格納するパスを絶対パスで指定します。絶対パスには，秘密鍵のファイル名を含めてください。

/csr CSRファイル名

CSRを格納するパスを絶対パスで指定します。絶対パスには，CSRのファイル名を含めてください。

/cert 自己署名証明書ファイル名

自己署名証明書を格納するパスを絶対パスで指定します。絶対パスには，自己署名証明書のファイル名を含めてください。

/certtext 自己署名証明書の内容ファイル名

自己署名証明書の内容をテキスト形式で出力します。そのファイルを格納するパスを絶対パスで指定します。絶対パスには，テキストファイル名を含めてください。

/validity 自己署名証明書有効期限

自己署名証明書の有効期限を日数で指定します。このオプションを省略した場合，有効期限は3,650日となります。指定できる値は，9999年12月31日までの日数です。

/dname 識別名（DN）

SSLサーバ証明書に記述する識別名（DN）を「属性型=属性値」の形式で指定します。「,」で区切ることで，複数の属性型の値を指定できます。属性型は，大文字，小文字を区別しません。属性値に「"」「¥」は使用できません。

文字のエスケープはRFC 2253に従ってください。

次の文字は「¥」でエスケープしてください。

「+」「,」「;」「<」「=」「>」

文字列の先頭の空白

文字列の末尾の空白

文字列の先頭の「#」

このオプションを省略した場合，コマンド実行時に画面に従って属性値を応答入力します。

このオプションに指定できる属性型について，次の表に示します。

表8‒4　識別名（DN）に指定できる属性型一覧

属性型

属性型の意味

応答入力時の画面の表記

属性値

CN

Common Name

Server Name

ホスト名，IPアドレス，ドメイン名などJP1/AOサーバの識別名※

OU

Organizational Unit Name

Organizational Unit

部門，部署名など小さな単位の組織名

O

Organization Name

Organization Name

会社，団体の組織名※

L

Locality Name

City or Locality

都市または地域名（日本では市町村名）

ST

State or Province Name

State or Province

州名または地方名（日本では都道府県名）

C

Country Name

two-character country-code

国コード（日本は「JP」）

注※

応答入力では必ず入力してください。

応答入力例を次に示します。

Enter Server Name [default=MyHostname]:example.com
Enter Organizational Unit:Device Manager Administration
Enter Organization Name [default=MyHostname]:HITACHI
Enter your City or Locality:Yokohama
Enter your State or Province:Kanagawa
Enter your two-character country-code:JP
Is CN=example.com,OU=Device Manager Administration,O=HITACHI,L=Yokohama,　ST=Kanagawa,C=JP correct? (y/n) [default=n]:y

入力に誤りがあった場合は，確認で「n」を入力すると再度応答入力が可能です。

/sigalg 署名アルゴリズム

署名アルゴリズムとして，次のどれかを指定してください。このオプションを省略した場合は，「SHA256withRSA」となります。

MD5withRSA

SHA1withRSA

SHA256withRSA

格納先

Windowsの場合

共通コンポーネントのインストール先フォルダ¥bin

Linuxの場合

/opt/HiCommand/Base64/bin

実行権限

Administrators権限またはroot権限を持つユーザーで実行してください。

注意事項

SSLサーバ証明書の属性型「CN」と，WebブラウザーからJP1/AOサーバの接続先として指定したホスト名，IPアドレスまたはドメイン名が一致しない場合，サーバ名の不一致の警告またはエラーが発生します。

戻り値

コマンドの戻り値を次の表に示します。

戻り値

説明

0

正常に終了しました。

1

引数が不正です。

250

キーストアの削除に失敗しました。

251

秘密鍵の作成に失敗しました。

252

自己署名証明書の作成に失敗しました。

253

CSRの作成に失敗しました。

254

自己署名証明書の内容ファイルの作成に失敗しました。

255

異常終了しました。

関連トピック

8.3　コマンドの引数に指定できる文字

8.5.7　setupcluster（クラスタ環境の構築）

機能

JP1/AOをクラスタ環境に構築します。実行系ホストと待機系ホストでそれぞれコマンドを実行する必要があります。

データベースおよびデータの退避先となる共有ディスク上のパスを指定してコマンドを実行すると，クラスタ環境を構築できます。

コマンドの実行後は，途中経過を示すメッセージが表示されます。

形式

setupcluster
     /exportpath データベースおよびデータの退避先パス
     /jp1user JP1ユーザー名

引数

/exportpath データベースおよびデータの退避先パス

このコマンドを実行するホストのデータベースおよびデータを退避させるフォルダを絶対パスまたは相対パスで指定します。十分に空き容量のある，共有ディスク上のフォルダを指定します。指定できるパスの長さは49文字までです。

/jp1user JP1ユーザー名

JP1ユーザー名を指定します。

格納先

Windowsの場合

JP1/AOのインストール先フォルダ¥bin

Linuxの場合

/opt/jp1ao/bin

実行権限

Administrators権限またはroot権限を持つユーザーで実行してください。Administrators権限またはroot権限がない場合は，権限昇格を求めるメッセージが表示されます。

戻り値

コマンドの戻り値を次の表に示します。

戻り値

説明

0

正常に終了しました。

1

引数が不正です。

2

コマンドの実行を中断しました。

3

サービスの状態が不正です。

4

ほかのコマンドを実行中です。

5

通信に失敗しました。

7

パスの指定が不正です。

9

指定したパスが存在しません。

10

指定したパスにアクセスできません。

11

指定したフォルダが空ではありません。

14

コマンドの実行権限がありません。

120

クラスタのセットアップに失敗しました。

121

指定されたJP1ユーザーにタスク処理エンジンをセットアップする権限がありません。

255

そのほかのエラーでコマンドの実行が中断しました。

使用例

Windowsで，実行系ホストで指定した共有フォルダのパスに，データベースの再作成およびデータの退避を行い，クラスタ環境を構築する場合のコマンドの使用例を示します（待機系ホストの場合も同じコマンドを実行します）。

setupcluster /exportpath Z:¥share /jp1user JP1_AO_Admin

関連トピック

8.3　コマンドの引数に指定できる文字

8.5.8　stopcluster（クラスタ環境でのサービス停止の準備）

機能

クラスタ環境でJP1/AOのサービスを停止するための準備をします。クラスタ環境でJP1/AOのサービスを停止する場合には，事前にこのコマンドを実行してください。

形式

stopcluster /prepare

引数

/prepare

クラスタ環境でJP1/AOのサービスを停止する準備を開始します。

格納先

Windowsの場合

JP1/AOのインストール先フォルダ¥bin

Linuxの場合

/opt/jp1ao/bin

実行権限

OSのAdministrators権限またはroot権限を持つユーザーで実行してください。Administrators権限またはroot権限がない場合は，権限昇格を求めるメッセージが表示されます。

注意事項

クラスタ環境で，JP1/AOのサービスを停止するための準備をする以外の用途で使用しないでください。

クラスタ環境構築時に，クラスタソフトで設定する内容はマニュアル「JP1/AO 構築ガイド」−「クラスタシステムの構築」のトピックを参照してください。

戻り値

コマンドの戻り値を次の表に示します。

戻り値

説明

0

正常に終了しました。

1

引数が不正です。

2

コマンドの実行を中断しました。

4

ほかのコマンドを実行中です。

210

クラスタ環境でのサービス停止準備に失敗しました。

255

そのほかのエラーでコマンドの実行が中断しました。

使用例

Windowsで，クラスタ環境でJP1/AOのサービスを停止するための準備をする場合のコマンドの使用例を示します。

stopcluster /prepare

関連トピック

マニュアル「JP1/AO 構築ガイド」−「クラスタシステムの構築」のトピック

8.6　運用関連のコマンド

8.6.1　deleteservicetemplate（サービステンプレートの削除）

機能

JP1/AOに登録されているサービステンプレートを削除します。

削除したいサービステンプレートのサービステンプレートID，ベンダーID，バージョン番号を指定してコマンドを実行すると，指定したサービステンプレートを削除できます。

形式

deleteservicetemplate
     /name サービステンプレートID
     /vendor サービステンプレートのベンダーID
     /version サービステンプレートのバージョン番号
     /user ユーザーID
     {/password パスワード | /passwordfile パスワードファイルパス}

引数

/name サービステンプレートID

削除するサービステンプレートのIDを指定します。

大文字と小文字は区別しません。

指定できる文字数は，1〜64文字です。

使用できる文字の種類は，半角英数字，「-」，「_」，「.」です。

/vendor サービステンプレートのベンダーID

削除するサービステンプレートのベンダーIDを指定します。

大文字と小文字は区別しません。

指定できる文字数は，1〜64文字です。

使用できる文字の種類は，半角英数字，「-」，「_」，「.」です。

/version サービステンプレートのバージョン番号

削除するサービステンプレートのバージョン番号を「XX.YY.ZZ」の形式で指定します。

XX，YY，ZZに指定できる文字は，00から99の2桁の半角数字です。

XX：メジャーバージョン番号

YY：マイナーバージョン番号

ZZ：リビジョン番号

/user ユーザーID

JP1/AOのユーザーIDを指定します。

指定できる文字数は，1〜256文字です。

使用できる文字の種類は，半角英数字，「!」，「#」，「$」，「%」，「&」，「'」，「(」，「)」，「*」，「+」，「-」，「.」，「=」，「@」，「¥」，「^」，「_」，「|」です。

大文字と小文字は区別しません。

/password パスワード

userオプションで指定した，ユーザーのパスワードを指定します。

このオプションまたはpasswordfileオプションのどちらかを指定する必要があります。両方のオプションが指定されている場合，およびどちらのオプションも指定されていない場合はエラーとなります。

指定できる文字数は，1〜256文字です。

使用できる文字の種類は，userオプションと同じです。

/passwordfile パスワードファイルパス

userオプションで指定したユーザーのパスワードファイルのパスを絶対パスまたは相対パスで指定します。パスワードファイルはencryptpasswordコマンドで作成します。

このオプションまたはpasswordオプションのどちらかを指定する必要があります。両方のオプションが指定されている場合，およびどちらのオプションも指定されていない場合はエラーとなります。

格納先

Windowsの場合

JP1/AOのインストール先フォルダ¥bin

Linuxの場合

/opt/jp1ao/bin

実行権限

OSのAdministrators権限またはroot権限と，JP1/AOのAdminロールまたはDevelopロールの両方を持つユーザーで実行してください。Administrators権限またはroot権限がない場合は，権限昇格を求めるメッセージが表示されます。

注意事項

リリースサービステンプレートは，このコマンドを使用して削除してください。なお，開発サービステンプレートは［エディタ］画面から削除してください。

戻り値

コマンドの戻り値を次の表に示します。

戻り値

説明

0

正常に終了しました。

1

引数が不正です。

2

コマンドの実行を中断しました。

3

サービスの状態が不正です。

4

ほかのコマンドを実行中です。

5

通信に失敗しました。

6

認証に失敗しました。

7

パスの指定が不正です。

9

指定したパスが存在しません。

14

コマンドの実行権限がありません。

190

サービステンプレートの削除に失敗しました。

255

そのほかのエラーでコマンドの実行が中断しました。

使用例

Windowsで，指定したサービステンプレートを削除する場合のコマンドの使用例を示します。

deleteservicetemplate /name nameA /vendor vendorB /version 01.00.00 /user user01 /password pass01

関連トピック

8.3　コマンドの引数に指定できる文字

マニュアル「JP1/AO サービステンプレート開発ガイド」−「開発サービステンプレートを削除する手順」のトピック

8.6.2　hcmdschgurl/hcmds64chgurl（URL情報の更新）

機能

共通コンポーネントのリポジトリーに格納されている，アプリケーションの起動に使用するアクセス情報（URL情報）を更新します。

JP1/AOの運用を開始したあと，次のどれかの構成変更を行った場合に使用します。

共通コンポーネントがインストールされているホストが使用するポートを変更した場合

共通コンポーネントがインストールされているホストのホスト名またはIPアドレスを変更した場合

形式

hcmdschgurl | hcmds64chgurl
     {/list |
      /change 変更前のURL 変更後のURL |
      /change 変更後のURL /type Automation}

引数

/list

現在設定されているURLと製品名のリストを表示します。

/change 変更前のURL 変更後のURL

現在登録されているURLに関する情報を，変更後のURLに関する情報で上書きします。

現在登録されているURLと変更後のURLを指定します。typeオプションと組み合わせて使用する場合は，変更後のURLだけを指定します。

IPv6アドレスを含むURLを指定する場合は，IPアドレスを［ ］で囲んでください。

/type Automation

URLを変更する製品名として「Automation」を指定します。

格納先

Windowsの場合

共通コンポーネントのインストール先フォルダ¥bin

Linuxの場合

/opt/HiCommand/Base64/bin

実行権限

Administrators権限またはroot権限を持つユーザーで実行してください。

戻り値

コマンドの戻り値を次の表に示します。

戻り値

説明

0

正常に終了しました。

1

引数が不正です。

2

URLがありません。

253

リポジトリーのリストアに失敗しました。

254

リポジトリーのバックアップに失敗しました。

255

異常終了しました。

使用例

次の場合のコマンドの使用例を示します。

Windowsで，現在設定されているURLと製品名のリストを表示する場合

hcmdschgurl /list

Windowsで，現在登録されているURLに関する情報を，変更後のURLで上書きする場合

hcmdschgurl /change "http://192.168.11.33:23015" "http://192.168.11.55:23015"

関連トピック

8.3　コマンドの引数に指定できる文字

8.6.3　hcmdssrv/hcmds64srv（JP1/AOの開始・停止・状態表示）

機能

JP1/AOのサービスとデータベースを開始または停止します。また，JP1/AOのサービスの状態を表示したり，サービスの開始方法を変更したりできます。

このコマンドのserverオプションに「AutomationWebService」を指定して実行すると，次のサービスを開始・停止・状態表示します。なお，JP1/Baseのサービス「JP1/Base」および「JP1/Base Event」についても開始します。

表8‒5　開始・停止・状態表示の対象サービス一覧

サービス表示名およびプロセス

開始

停止

状態表示

HAutomation Engine Web Service

○　

○　

○　

HBase Storage Mgmt Common Service

○　

○　※1　

○　

HBase Storage Mgmt Web Service

○　

○　※1　

○　

HBase Storage Mgmt Web SSO Service

○　

○　※1　

○　

HAutomation Engine

○　

○　

×　

HAutomation Engine Database _JF0

○　

○　

×　

JP1/Base

○　

×　

×　

JP1/Base Event

○　

×　

×　

データベースのプロセス※2

○　

○　※1　

○　

（凡例）

○：処理されます。　×：処理されません。

注※1

Hitachi Command Suite製品のサービスが開始している場合は停止されません。

注※2

JP1/AOの内部プロセスです。hcmdssrvコマンドまたはhcmds64srvコマンドでは，データベースのサービスを示す「HiRDB/EmbeddedEdition _HD0」は開始および停止しません。

形式

hcmdssrv | hcmds64srv
     {/start | /stop | /check| /status}
     [/server サービス名]

JP1/AOおよび全Hitachi Command Suite製品のサービスの状態を確認する場合：

hcmdssrv | hcmds64srv
     /statusall

サービスの開始方法を変更する場合：

hcmdssrv | hcmds64srv
     /starttype {auto | manual}
     {/server サービス名 | /all}

引数

/start

serverオプションで指定したサービスとデータベースを開始します。

/stop

serverオプションで指定したサービスとデータベースを停止します。

/check

serverオプションで指定したサービスとデータベースの状態を表示します。

/status

serverオプションで指定したサービスとデータベースの状態を表示します。

/server サービス名

JP1/AO製品のサービスだけを開始・停止・状態表示する場合，サービス名には「AutomationWebService」を指定します。このオプションを省略した場合，インストールされているJP1/AOおよびすべてのHitachi Command Suite製品のサービスが対象となります。

/statusall

サービスとデータベースの状態，および共通コンポーネントに登録されたHitachi Command Suite製品のサービスの状態を表示します。

/starttype {auto | manual}

serverオプションで指定したサービスの開始種別を指定します。

自動開始の場合はautoを指定します。手動開始の場合はmanualを指定します。

/all

このオプションを指定した場合は，インストールされているJP1/AOおよびすべてのHitachi Command Suite製品のサービスが対象となります。

格納先

Windowsの場合

共通コンポーネントのインストール先フォルダ¥bin

Linuxの場合

/opt/HiCommand/Base64/bin

実行権限

Administrators権限またはroot権限を持つユーザーで実行してください。

注意事項

日常運用でJP1/AOのサービスを開始・停止する場合は，serverオプションを省略してすべてのサービスを開始・停止してください。serverオプションを指定してJP1/AO製品のサービスだけを開始する場合は，事前に共通コンポーネントのサービスを開始しておく必要があるため，serverオプションに「HBase」を指定して共通コンポーネントのサービスを開始してください。

タスクの処理中にstopオプションを指定した場合，エージェントレス接続先で実行中の処理は強制終了します。そのため，実行状態（実行中，応答待ち中，異常検出，または停止中）のタスクがある場合は，停止状態（正常終了，失敗，またはキャンセル）に遷移するまで待つか，すべてのタスクを実行停止してから使用してください。

stopオプションを指定して実行したあと，3分以内に停止処理が終わらない場合は，タイムアウトを示すメッセージを出力してエラー終了します。この場合は，しばらく待ってから，再度stopオプションを指定して実行してください。

戻り値

startオプション，stopオプション指定時のコマンドの戻り値を次の表に示します。

戻り値

説明

0

正常に終了しました。

1

サービスは開始済みです（startオプション指定時）。

サービスは停止済みです（stopオプション指定時）。

255

失敗しました。

checkオプション，statusオプション，statusallオプション指定時のコマンドの戻り値を次の表に示します。

戻り値

説明

0

開始していません。

1

開始しています。

255

失敗しました。

starttypeオプション指定時のコマンドの戻り値を次の表に示します。

戻り値

説明

0

正常に終了しました。

255

失敗しました。

使用例

次の場合のコマンドの使用例を示します。

Windowsで，JP1/AO製品のサービスを開始する場合

hcmdssrv /start /server AutomationWebService

Windowsで，JP1/AO製品のサービスを停止する場合

hcmdssrv /stop /server AutomationWebService

Windowsで，JP1/AO製品のサービスの状態を確認する場合

hcmdssrv /status /server AutomationWebService

関連トピック

8.3　コマンドの引数に指定できる文字

8.6.4　hcmdsunlockaccount/hcmds64unlockaccount（ユーザーアカウントのロック解除）

機能

ユーザーアカウントのロックを解除します。すべてのユーザーアカウントがロックされてJP1/AOにログインできない場合に使用します。

形式

hcmdsunlockaccount | hcmds64unlockaccount
     /user ユーザーID
     /pass パスワード

引数

/user ユーザーID

ロックを解除するユーザーアカウントのユーザーIDを指定します。User Management権限を持つユーザーIDを指定します。

/pass パスワード

ロックを解除するユーザーアカウントのパスワードを指定します。

格納先

Windowsの場合

共通コンポーネントのインストール先フォルダ¥bin

Linuxの場合

/opt/HiCommand/Base64/bin

実行権限

Administrators権限またはroot権限を持つユーザーで実行してください。

注意事項

hcmdsunlockaccountコマンドまたはhcmds64unlockaccountコマンドでロックを解除できるのは，User Management権限があるユーザーアカウントだけです。

オプションに指定するユーザー名またはパスワードに「&」，「|」，または「^」を含む場合，「"」で囲むか，「^」でエスケープします。例えば，Windowsで，パスワードが「^a^b^c^」の場合，「hcmdsunlockaccount /user system /pass "^"a"^"b"^"c"^"」，または「hcmdsunlockaccount /user system /pass ^^a^^b^^c^^」と記述します。

戻り値

コマンドの戻り値を次の表に示します。

戻り値

説明

0

正常に終了しました。

251

認証エラー（ログインに失敗）です。

252

認証エラー（User Management権限がない）です。

253

認証サーバとの通信に失敗しました。

254

セカンダリーサーバ側で実行されました。

255

異常終了しました。

使用例

Windowsで，ユーザーアカウントのロックを解除する場合のコマンドの使用例を示します。

hcmdsunlockaccount /user test01 /pass TTdate00

関連トピック

8.3　コマンドの引数に指定できる文字

8.6.5　importservicetemplate（サービステンプレートのインポート）

機能

サービステンプレートをJP1/AOに追加します。JP1/AOにサービステンプレートを追加することを，サービステンプレートのインポートといいます。

1つのサービステンプレートパッケージ，または複数のサービステンプレートパッケージをまとめたzipファイルを指定してコマンドを実行すると，指定したサービステンプレートパッケージをJP1/AOにインポートできます。

形式

importservicetemplate
     /file サービステンプレートパッケージまたは複数のサービステンプレートパッケージをまとめたzipファイル
     /user ユーザーID
     {/password パスワード | /passwordfile パスワードファイルパス}

引数

/file サービステンプレートパッケージまたは複数のサービステンプレートパッケージをまとめたzipファイル

インポートするサービステンプレートパッケージまたは複数のサービステンプレートパッケージをまとめたzipファイルを絶対パスまたは相対パスで指定します。

/user ユーザーID

JP1/AOのユーザーIDを指定します。

指定できる文字数は，1〜256文字です。

使用できる文字の種類は，半角英数字および「!」，「#」，「$」，「%」，「&」，「'」，「(」，「)」，「*」，「+」，「-」，「.」，「=」，「@」，「¥」，「^」，「_」，「|」です。

大文字と小文字は区別しません。

/password パスワード

userオプションで指定した，ユーザーのパスワードを指定します。

このオプションまたはpasswordfileオプションのどちらかを指定する必要があります。両オプションが指定されている場合，およびどちらのオプションも指定されていない場合はエラーとなります。

指定できる文字数は，1〜256文字です。

使用できる文字の種類は，userオプションと同じです。

/passwordfile パスワードファイルパス

userオプションで指定した，ユーザーのパスワードが格納されているファイルのパスを絶対パスまたは相対パスで指定します。

このオプションまたはpasswordオプションのどちらかを指定する必要があります。両オプションが指定されている場合，およびどちらのオプションも指定されていない場合はエラーとなります。

格納先

Windowsの場合

JP1/AOのインストール先フォルダ¥bin

Linuxの場合

/opt/jp1ao/bin

実行権限

AdminロールまたはDevelopロールかつOSのAdministrators権限またはroot権限を持つユーザーで実行してください。Administrators権限またはroot権限がない場合は，権限昇格を求めるメッセージが表示されます。

注意事項

複数のサービステンプレートパッケージをまとめたzipファイルをインポートする場合，一部のサービステンプレートパッケージのインポートに失敗してもインポートを続行します。特定のサービステンプレートパッケージのインポートに失敗したことを示すメッセージが表示されたときは，メッセージの内容を確認し，失敗の原因を取り除いた上で，インポートに失敗したサービステンプレートパッケージを再度インポートしてください。

戻り値

コマンドの戻り値を次の表に示します。

戻り値

説明

0

正常に終了しました。

1

引数が不正です。

2

コマンドの実行を中断しました。

3

サービスの状態が不正です。

4

ほかのコマンドを実行中です。

5

通信に失敗しました。

6

認証に失敗しました。

7

パスの指定が不正です。

9

指定したパスが存在しません。

14

コマンドの実行権限がありません。

180

サービステンプレートのインポートに失敗しました。

255

異常終了しました。

使用例

次の場合のコマンドの使用例を示します。

Windowsで，指定したサービステンプレートパッケージをJP1/AOにインポートする場合

importservicetemplate /file C:¥temp¥aaa.st /user user1 /password pass1

Windowsで，指定した複数のサービステンプレートパッケージをまとめたzipファイルをJP1/AOにインポートする場合

importservicetemplate /file C:¥temp¥bbb.zip /user user1 /password pass1

関連トピック

8.3　コマンドの引数に指定できる文字

マニュアル「JP1/AO サービステンプレート開発ガイド」−「サービス共有プロパティを定義する場合の注意事項」のトピック

8.6.6　listservices（サービス・サービステンプレートの一覧出力）

機能

JP1/AOに登録されているサービスまたはサービステンプレートの一覧をCSV形式で出力します。

ベンダー名やバージョン情報を含んだサービスの一覧またはサービステンプレートの一覧を出力できます。なお，デバッグサービスについては出力されません。

形式

listservices
     /output {services | servicetemplates}
     /file 出力ファイルパス
     ［/encoding {UTF-8 | Shift_JIS}］
     /user ユーザーID
     {/password パスワード | /passwordfile パスワードファイルパス}

引数

/output {services | servicetemplates}

出力する一覧情報の種類として，次のどちらかを値に指定します。

services

サービス一覧を出力します。

servicetemplates

サービステンプレート一覧を出力します。

/file 出力ファイルパス

出力ファイルのパスを絶対パスまたは相対パスで指定します。指定したファイルが存在する場合はエラーとなります。

/encoding {UTF-8 | Shift_JIS}

出力ファイルのエンコーディングを指定します。このオプションを省略した場合は，OSのデフォルトエンコーディングとなります。

/user ユーザーID

JP1/AOのユーザーIDを指定します。

指定できる文字数は，1〜256文字です。

使用できる文字の種類は，半角英数字，「!」，「#」，「$」，「%」，「&」，「'」，「(」，「)」，「*」，「+」，「-」，「.」，「=」，「@」，「¥」，「^」，「_」，「|」です。

大文字と小文字は区別しません。

/password パスワード

userオプションで指定した，ユーザーのパスワードを指定します。

このオプションまたはpasswordfileオプションのどちらかを指定する必要があります。両方のオプションが指定されている場合，およびどちらのオプションも指定されていない場合はエラーとなります。

指定できる文字数は，1〜256文字です。

使用できる文字の種類は，userオプションと同じです。

/passwordfile パスワードファイルパス

userオプションで指定したユーザーのパスワードファイルのパスを絶対パスまたは相対パスで指定します。パスワードファイルはencryptpasswordコマンドで作成します。

このオプションまたはpasswordオプションのどちらかを指定する必要があります。両方のオプションが指定されている場合，およびどちらのオプションも指定されていない場合はエラーとなります。

出力形式

サービスまたはサービステンプレートごとに1行ずつ，出力項目がCSV形式で出力されます。

なお，出力項目の値は「"」で囲まれて出力されます。値に「"」が含まれる場合，直前に「"」を付加してエスケープされます。

表8‒6　サービス一覧およびサービステンプレート一覧の出力形式

出力情報の種類

出力項目

意味

サービス一覧

Name

サービス名

Description

説明

Category

カテゴリ名

Resource Group

リソースグループ

Service Template

サービステンプレート名

Vendor

ベンダー名

Version

サービスバージョン

Configuration Type※

構成種別

サービステンプレート一覧

Name

サービステンプレート名

Service ID

サービステンプレートID

Description

説明

Version

サービステンプレートバージョン

Category

カテゴリ名

Vendor

ベンダー名

Vendor ID

ベンダーID

Configuration Type※

構成種別

注※

構成種別は，ユーザーが所属するユーザーグループから操作対象のリソースグループに対してAdminロールまたはDevelopロールが設定されている場合にだけ，出力されます。

ファイルの出力例を次に示します。

サービス一覧の場合

"Name","Description","Category","Resource Group","Service Template","Vendor","Version"
"リモートコマンド実行","リモートの実行対象サーバ上のコマンドを実行します。","OS_Operations/Basic","All Resources","リモートコマンド実行","(株)日立製作所","01.00.00"
"仮想サーバマイグレーション","VMware vSphere環境で，複数の仮想サーバをマイグレーションします。","VM_Operations/Management","All Resources","仮想サーバマイグレーション","(株)日立製作所","01.00.00"

サービステンプレート一覧の場合

"Name","Service ID","Description","Version","Category","Vendor","Vendor ID"
"JP1/AJSジョブネット実行登録","JP1AJSJobnetEntry","JP1/AJSのジョブネットを実行登録します。","01.00.00","JP1_Operations/Management","(株)日立製作所","com.hitachi.software.dna.cts.jp1"
"JP1/AJS・JP1/Baseログ取得","getJP1AJSandJP1BaseLog","JP1/AJSとJP1/Baseのログを取得します。","01.00.00","JP1_Operations/Troubleshoot","(株)日立製作所","com.hitachi.software.dna.cts.jp1"

格納先

Windowsの場合

JP1/AOのインストール先フォルダ¥bin

Linuxの場合

/opt/jp1ao/bin

実行権限

OSのAdministrators権限またはroot権限を持つユーザーで実行してください。

サービス一覧を出力する場合，コマンド実行ユーザーが所属するユーザーグループから，操作対象のリソースグループに対してAdminロール，Developロール，ModifyロールまたはSubmitロールが設定されている必要があります。ロールが設定されていないリソースグループのサービスについては出力されません。

サービステンプレート一覧を出力する場合，コマンド実行ユーザーが所属するユーザーグループから，操作対象のリソースグループに対してAdminロール，DevelopロールまたはModifyロールが設定されている必要があります。

戻り値

コマンドの戻り値を次の表に示します。

戻り値

説明

0

正常に終了しました。

1

引数が不正です。

2

コマンドの実行を中断しました。

3

サービスの状態が不正です。

4

ほかのコマンドを実行中です。

5

通信に失敗しました。

6

認証に失敗しました。

7

パスの指定が不正です。

8

すでに出力先パスに同名のファイルが存在します。

9

指定したパスが存在しません。

10

指定したパスにアクセスできません。

12

エンコーディングの指定が不正です。

13

ファイル出力に失敗しました。

14

コマンドの実行権限がありません。

160

サービス一覧の取得に失敗しました。

161

サービステンプレート一覧の取得に失敗しました。

255

そのほかのエラーでコマンドの実行が中断しました。

使用例

次の場合のコマンドの使用例を示します。

Windowsで，登録されているサービスの一覧をOSのデフォルトエンコーディングでファイルに出力する場合

listservices /output services /file list01 /user user01 /password pass01

Windowsで，登録されているサービステンプレートの一覧をUTF-8エンコーディングでファイルに出力する場合

listservices /output servicetemplates /file list02 /encoding UTF-8 /user user02 /password pass02

関連トピック

8.3　コマンドの引数に指定できる文字

8.6.7　listtasks（タスクの一覧出力，タスク詳細情報出力）

機能

タスクまたは履歴の一覧出力

listtasksコマンドのoutputオプションにtasksを指定して実行すると，［タスク一覧］ビューに表示されるタスク情報をCSV形式で出力できます。またはoutputオプションにhistoriesを指定して実行すると，［履歴］ビューに表示されるタスク情報をCSV形式で出力できます。なお，デバッグタスクについてはどちらのCSVファイルにも出力されません。

期間を指定すると，出力するタスク情報を絞り込むこともできます。

タスク詳細情報の出力

listtasksコマンドのoutputオプションにtaskdetailsを指定して実行すると，タスク詳細情報格納フォルダに，入力プロパティおよび出力プロパティの値を含むタスク詳細情報が出力されます。なお，デバッグタスクの詳細情報については出力されません。

出力されたタスク詳細情報※を元に，submittaskコマンドを実行すると，指定日時実行タスクと定期実行タスクを，同一の設定で一括再登録できます。

注※

このタスク詳細情報には，定義情報（サービス, サービステンプレート, ユーザー，ユーザーグループ，リソースグループ, エージェントレス接続先定義, サービス共有プロパティ）および定義ファイルは含まれません。これらの情報をバックアップしたい場合は，backupsystemコマンドを使用してください。

図8‒1　タスク詳細情報の出力と入力

形式

listtasks
     ［/startrange {yyyy-mm-dd|,yyyy-mm-dd|yyyy-mm-dd,yyyy-mm-dd}］
     /output {tasks | histories | taskdetails}
      {/file出力ファイルパス |/taskdetaildir タスク詳細情報格納フォルダのパス}
     ［/encoding {UTF-8 | Shift_JIS}］
     /user ユーザーID
     {/password パスワード | /passwordfile パスワードファイルパス}

引数

/startrange {yyyy-mm-dd|,yyyy-mm-dd|yyyy-mm-dd,yyyy-mm-dd}

タスクの開始日または開始予定日を指定することで，出力するタスクを絞り込みます。

「yyyy」には西暦を4桁の半角数字で指定します。「mm」には月を1（または01）から12の半角数字で指定します。「dd」には日を1（または01）から31の半角数字で指定します。

yyyy-mm-dd

指定した日付以後に開始したタスクまたは開始予定のタスクを出力します。

,yyyy-mm-dd

指定した日付以前に開始したタスクまたは開始予定のタスクを出力します。

yyyy-mm-dd,yyyy-mm-dd

指定した期間内に開始したタスクまたは開始予定のタスクを出力します。「,」の右側には，左側に指定した日付以降の日付だけを指定できます。

定期実行タスクの場合，次に開始予定のタスクまで出力されます。その次以降に開始予定のタスクは出力されません。

待機中のタスクを出力したい場合，定期実行タスクおよび指定日時実行タスクのときは開始日時ではなく開始予定日時を指定してください。即時実行タスクのときは実行操作日時を指定してください。実行操作日時は［タスク詳細］ダイアログボックスで確認できます。

このオプションを省略した場合は，ユーザーが参照できるすべてのタスクが出力されます。

なお，outputオプションにtaskdetailsを指定した場合に，startrangeオプションを指定するとエラーになります。

/output {tasks | histories | taskdetails}

出力する一覧情報の種類として，次のどれかを値に指定します。

tasks

［タスク一覧］ビューのタスク一覧を出力します。

histories

［履歴］ビューの履歴一覧を出力します。

taskdetails

入力プロパティおよび出力プロパティの値を含むタスク詳細情報を出力します。

{/file 出力ファイルパス |/taskdetaildir タスク詳細情報格納フォルダのパス}

/file 出力ファイルパス

一覧として出力するファイルのパスを絶対パスまたは相対パスで指定します。指定したファイルがすでにある場合はエラーとなります。

outputオプションにtasksまたはhistoriesを指定した場合は，必須で指定します。outputオプションにtaskdetailsを指定した場合に，このオプションを指定するとエラーになります。

/taskdetaildir タスク詳細情報格納フォルダのパス

タスク詳細情報を出力するための，空のフォルダを絶対パスまたは相対パスで指定します。指定できるのはローカルディスクのフォルダだけです。指定できる文字数は，絶対パスの長さで190文字までです。相対パスの場合，絶対パスの長さに換算したときに190文字までとなるように指定します。

指定したフォルダがない場合や，指定したフォルダ内にファイルまたはフォルダがすでにある場合はエラーになります。

outputオプションにtaskdetailsを指定した場合は，必須で指定します。outputオプションにtasksまたはhistoriesを指定した場合に，このオプションを指定するとエラーになります。

/encoding {UTF-8 | Shift_JIS}

出力ファイルのエンコーディングを指定します。このオプションを省略した場合は，OSのデフォルトエンコーディングとなります。

outputオプションにtaskdetailsを指定した場合は，タスク詳細情報格納フォルダの直下にある，タスク一覧ファイル（listtasks.csv）だけに適用されます。タスク詳細情報およびプロパティファイルは，常にUTF-8で出力されます。

/user ユーザーID

JP1/AOのユーザーIDを指定します。

指定できる文字数は，1〜256文字です。

使用できる文字の種類は，半角英数字，「!」，「#」，「$」，「%」，「&」，「'」，「(」，「)」，「*」，「+」，「-」，「.」，「=」，「@」，「¥」，「^」，「_」，「|」です。

大文字と小文字は区別しません。

/password パスワード

userオプションで指定した，ユーザーのパスワードを指定します。

このオプションまたはpasswordfileオプションのどちらかを指定する必要があります。両方のオプションが指定されている場合，およびどちらのオプションも指定されていない場合はエラーとなります。

指定できる文字数は，1〜256文字です。

使用できる文字の種類は，userオプションと同じです。

/passwordfile パスワードファイルパス

userオプションで指定したユーザーのパスワードファイルのパスを絶対パスまたは相対パスで指定します。パスワードファイルはencryptpasswordコマンドで作成します。

このオプションまたはpasswordオプションのどちらかを指定する必要があります。両方のオプションが指定されている場合，およびどちらのオプションも指定されていない場合はエラーとなります。

出力形式

［タスク一覧］ビューおよび［履歴］ビューの一覧を出力する場合（outputオプションにtasksまたはhistoriesを指定した場合）

タスクごとに1行ずつ，出力項目がCSV形式で出力されます。

なお，出力項目の値は「"」で囲まれて出力されます。値に「"」が含まれる場合，直前に「"」を付加してエスケープされます。

表8‒7　タスク一覧の出力項目

出力項目

意味

Task

タスク名

Status

状態

Scheduled Time

開始予定日時

Start Time

開始日時

End Time

終了日時

Type

タスク種別

ID

タスクID

Description

タスクの説明

Service

サービス名

Resource Group

リソースグループ

Category

サービスカテゴリ

Submitted By

実行者

Submitted At

実行操作日時

Recurrence Pattern

定期実行周期

Recurrence Time

定期実行時刻

Recurrence Start

定期実行適用開始日

Configuration Type※

構成種別

注※

構成種別は，ユーザーが所属するユーザーグループから，操作対象のリソースグループに対してAdminロールまたはDevelopロールが設定されている場合にだけ，出力されます。

ファイルの出力例を次に示します。

"Task","Status","Scheduled Time","Start Time","End Time","Type","ID","Description","Service","Resource Group","Category","Submitted By","Submitted At","Recurrence Pattern","Recurrence Time","Recurrence Start","Configuration Type"
"リモートコマンド実行_20131031190605","待機中","2013-11-01 00:00:00","","","定期実行タスク","3327","","リモートコマンド実行","All Resources","OS_Operations/Basic","user","2013-10-31 19:06:37","毎週 月,水,金","00:00:00","2013-10-31","リリース"
"リモートコマンド実行_20131031194429","待機中","2013-11-01 09:00:00","","","指定日時実行タスク","3355","","リモートコマンド実行","All Resources","OS_Operations/Basic","user","2013-10-31 19:44:52","","","","リリース"
"OSユーザーの一覧取得_20131031194524","待機中","2013-11-01 20:00:00","","","定期実行タスク","3385","","OSユーザーの一覧取得","All Resources","OS_Operations/Management","user","2013-10-31 19:45:44","毎日","20:00:00","2013-10-31","リリース"
"リモートコマンド実行_20131031194500","待機中","2013-11-30 00:00:00","","","指定日時実行タスク","3361","","リモートコマンド実行","All Resources","OS_Operations/Basic","user","2013-10-31 19:45:17","","","","リリース"
"OSユーザーの一覧取得_20131031194524","正常終了","2013-10-31 20:00:00","2013-10-31 20:00:00","2013-10-31 20:00:19","定期実行タスク","3375","","OSユーザーの一覧取得","All Resources","OS_Operations/Management","user","2013-10-31 19:45:44","毎日","20:00:00","2013-10-31","リリース"

タスク詳細情報を出力する場合（outputオプションにtaskdetailsを指定した場合）

タスク詳細情報格納フォルダに出力されるデータを次に示します。

図8‒2　タスク詳細情報格納フォルダの構成

タスク詳細情報格納フォルダの内容を次に示します。

タスク詳細情報格納フォルダ

フォルダ名：任意

taskdetaildirオプションに指定するフォルダです。

タスク一覧ファイル

ファイル名：listtasks.csv

タスク詳細情報に含まれるタスクの一覧と，その一覧のうちsubmittaskコマンドで一括再登録する対象となるタスクを確認するためのファイルです。

outputオプションに，tasksを指定して出力されるタスク一覧の各行の末尾に，submittaskコマンドで一括再登録するタスクかどうかのフラグが付加されています。

タスク一覧の出力例を次に示します。

図8‒3　タスク一覧の出力例

ヘッダー部とデータ部の内容は次のとおりです。

ヘッダー部（1行目）

Unexecuted Schedule

データ部（2行目以降）

true:一括再登録されるタスクです。

false:一括再登録されないタスクです。

データ部（2行目以降）のフラグがtrueになるのは，予定されたタスク（指定日時実行タスクまたは定期実行タスク）のうち未実行のタスクです。

listtasksコマンドを実行する時点で，実行が開始されていない指定日時実行タスク

listtasksコマンドを実行する時点で，キャンセルされていない定期実行タスク

listtasksコマンドを実行する時点で，保留中の指定日時実行タスクと定期実行タスク

なお，このファイルは，submittaskコマンドで一括再登録するタスクを確認するためのものです。このファイルは編集しないでください。

個別タスク詳細情報格納フォルダ

フォルダ名：タスクID

個々のタスクの定義情報と，プロパティファイルを格納するフォルダです。タスクIDがフォルダ名となり，出力するタスクの数だけフォルダが生成されます。

タスク定義情報ファイル

ファイル名：taskdef.xml

タスクの定義情報をXMLで出力したファイルです。このファイルは編集しないでください。

入力プロパティファイル

ファイル名：input.properties

タスクに設定された入力プロパティの情報が出力されます。データの形式は，submittaskコマンドのpropertyfileオプションに指定するプロパティファイルと同じです。ファイルの形式については，「8.6.9　submittask（サービスの実行，タスクの一括再登録）」のpropertyfileオプションの説明を参照してください。なお，出力されるのは，可視性が「exec」の入力プロパティだけです。該当する入力プロパティが1つもない場合は，空のファイルが作成されます。

submittaskコマンドでタスクの一括再登録を行う場合，このファイルを編集して実行しないでください。編集した場合のコマンドの実行結果は製品サポートの対象外です。ただし，元の設定と異なる設定で登録する場合は，このファイルをコピーして使用します。ファイルのコピー後に，指定日時やタスク名など，サービスの実行時に指定できる項目を指定してから，個別にサービスを実行してください入力プロパティの値を変更したい場合については，コピーしたファイルを必要に応じて編集し，submittaskコマンドのpropertyfileオプションに指定して実行してください。

なお，例えば，ホスト名，IPアドレス，ユーザー名，パスワードなどの情報が入力プロパティの値に含まれている場合も，そのまま出力されます。

出力プロパティファイル

ファイル名：output.properties

タスクに設定された出力プロパティの内容が出力されます。データの形式は，入力プロパティファイルと同じです。ファイルの形式については，「8.6.9　submittask（サービスの実行，タスクの一括再登録）」のpropertyfileオプションの説明を参照してください。該当する入力プロパティが1つもない場合は，空のファイルが作成されます。

なお，例えば，ホスト名，IPアドレス，ユーザー名，パスワードなどの情報が出力プロパティの値に含まれている場合も，そのまま出力されます。

格納先

Windowsの場合

JP1/AOのインストール先フォルダ¥bin

Linuxの場合

/opt/jp1ao/bin

実行権限

OSのAdministrators権限またはroot権限を持つユーザーで実行してください。Administrators権限またはroot権限がない場合は，権限昇格を求めるメッセージが表示されます。

userオプションに指定するユーザーに必要な権限は，outputオプションに指定する引数によって異なります。

outputオプションにtasksまたはhistoriesを指定する場合（タスクまたは履歴の一覧出力）

/userオプションに指定するユーザーが所属するユーザーグループから，操作対象のリソースグループに対してAdminロール，Developロール，ModifyロールまたはSubmitロールが設定されている必要があります。ロールが設定されていないリソースグループのタスクについては出力されません。

outputオプションにtaskdetailsを指定する場合（タスク詳細情報の出力）

userオプションには，Adminロールを持つユーザーを指定してください。JP1/AOに登録されているすべてのタスクの情報が一括で出力されるほか，入力プロパティや出力プロパティの値に，ホスト名，IPアドレス，ユーザー名，パスワードなどの情報が含まれている場合も，そのまま出力されるため，すべてのリソースにアクセスできるAdminロールを指定する必要があります。出力されたタスク詳細情報は，適切にアクセス制御された場所に保管してください。

戻り値

コマンドの戻り値を次の表に示します。

戻り値

説明

0

正常に終了しました。

1

引数が不正です。

2

コマンドの実行を中断しました。

3

サービスの状態が不正です。

4

ほかのコマンドを実行中です。

5

通信に失敗しました。

6

認証に失敗しました。

7

パスの指定が不正です。

8

すでに出力先パスに同名のファイルが存在します。

9

指定したパスが存在しません。

10

指定したパスにアクセスできません。

11

指定したフォルダが空ではありません。

12

エンコーディングの指定が不正です。

13

ファイル出力に失敗しました。

14

コマンドの実行権限がありません。

150

タスク一覧の取得に失敗しました。

151

履歴一覧の取得に失敗しました。

152

タスク詳細情報の取得に失敗しました。

255

そのほかのエラーでコマンドの実行が中断しました。

使用例

次の場合のコマンドの使用例を示します。

Windowsで，登録されているタスクの一覧をOSのデフォルトエンコーディングでファイルに出力する場合

listtasks /output tasks /file list01.csv /user user01 /password pass01

Windowsで，2012年1月1日から2012年3月31日までの間に開始または開始予定の［履歴］ビューのタスクをUTF-8エンコーディングでファイルに出力する場合

listtasks /startrange 2012-01-01,2012-03-31 /output histories /file list02.csv /encoding UTF-8 /user user02 /password pass02

Windowsで，タスク詳細情報を出力する場合

listtasks /output taskdetails /taskdetaildir "C:¥data¥taskdetail" /user user03 /password pass03

関連トピック

8.3　コマンドの引数に指定できる文字

8.6.9　submittask（サービスの実行，タスクの一括再登録）

8.7.1　backupsystem（JP1/AOシステムのバックアップ）

8.7.6　restoresystem（JP1/AOシステムのリストア）

8.6.8　stoptask（タスクの実行停止）

機能

タスクIDを指定することで，指定したタスクを実行停止します。ただし，デバッグタスクについては実行停止できません。

なお，このコマンドでは，タスクの強制停止はできません。

形式

stoptask
     /taskid タスクID
     /user ユーザーID
     {/password パスワード | /passwordfile パスワードファイルパス}

引数

/taskid タスクID

実行停止するタスクのタスクIDを指定します。

指定できる値は，16桁までの半角数字（10進数）です。

/user ユーザーID

JP1/AOのユーザーIDを指定します。

指定できる文字数は，1〜256文字です。

使用できる文字の種類は，半角英数字，「!」，「#」，「$」，「%」，「&」，「'」，「(」，「)」，「*」，「+」，「-」，「.」，「=」，「@」，「¥」，「^」，「_」，「|」です。

大文字と小文字は区別しません。

/password パスワード

userオプションで指定した，ユーザーのパスワードを指定します。

このオプションまたはpasswordfileオプションのどちらかを指定する必要があります。両方のオプションが指定されている場合，およびどちらのオプションも指定されていない場合はエラーとなります。

指定できる文字数は，1〜256文字です。

使用できる文字の種類は，userオプションと同じです。

/passwordfile パスワードファイルパス

userオプションで指定したユーザーのパスワードファイルのパスを絶対パスまたは相対パスで指定します。パスワードファイルはencryptpasswordコマンドで作成します。

このオプションまたはpasswordオプションのどちらかを指定する必要があります。両方のオプションが指定されている場合，およびどちらのオプションも指定されていない場合はエラーとなります。

格納先

Windowsの場合

JP1/AOのインストール先フォルダ¥bin

Linuxの場合

/opt/jp1ao/bin

実行権限

OSのAdministrators権限またはroot権限を持つユーザーで実行してください。Administrators権限またはroot権限がない場合は，権限昇格を求めるメッセージが表示されます。

コマンド実行ユーザーが所属するユーザーグループから，実行停止したいタスクのリソースグループに対して，Adminロール，Developロール，ModifyロールまたはSubmitロールが設定されている必要があります。ロールが設定されていないリソースグループのタスクについては実行停止できません。

注意事項

実行停止したいタスクの状態が実行中，応答待ち中，または異常検出の場合に，このコマンドを実行してください。これ以外の状態の場合にコマンドを実行すると，コマンドの戻り値が140で失敗します。

戻り値

コマンドの戻り値を次の表に示します。

戻り値

説明

0

正常に終了しました。

1

引数が不正です。

2

コマンドの実行を中断しました。

3

サービスの状態が不正です。

5

通信に失敗しました。

6

認証に失敗しました。

7

パスの指定が不正です。

9

指定したパスが存在しません。

14

コマンドの実行権限がありません。

140

タスクの実行停止に失敗しました。

255

そのほかのエラーでコマンドの実行が中断しました。

使用例

Windowsで，指定したタスクIDのタスクを実行停止する場合のコマンドの使用例を示します。

stoptask /taskid 1 /user user01 /password pass01

関連トピック

8.3　コマンドの引数に指定できる文字

マニュアル「JP1/AO 運用ガイド」−「タスクを停止する手順（実行停止）」のトピック

マニュアル「JP1/AO 運用ガイド」−「タスクを停止する手順（強制停止）」のトピック

8.6.9　submittask（サービスの実行，タスクの一括再登録）

機能

サービスの実行

サービス名，リソースグループ名，およびプロパティ値を指定してコマンドを実行することで，指定したサービスを実行します。タスクが正常に実行された場合，タスクIDがメッセージに出力されます。デバッグサービスについては実行できません。オプションを指定することで，サービスを定期実行したり，実行日時を指定して実行したりできます。何も指定しない場合，サービスは即時実行されます。

タスクの一括再登録

listtasksコマンドで出力したタスク詳細情報の内容を元に，指定日時実行タスクおよび定期実行タスクを一括で再登録します。再登録したタスクには，元のタスクの設定およびタスクの状態が引き継がれます。これは，タスク詳細情報格納フォルダの情報を参照して，同一の設定で指定日時実行または定期実行でサービスを実行する機能であり，同一のタスクを復元する機能ではありません。そのため，再登録されたタスクは，再登録前のタスクとは別のタスクであり，タスクIDも異なります。デバッグタスクについては再登録できません。

タスクを一括再登録する前の作業について

タスクの一括再登録をする前に，次の作業を実施してください。

タスク詳細情報格納フォルダには，タスクの一括再登録を行うJP1/AOと，バージョンおよびリビジョンが同一のJP1/AOで出力したフォルダを指定してください。バージョンまたはリビジョンが異なるJP1/AOで出力したタスク詳細情報格納フォルダを指定した場合，タスクの一括再登録に失敗します。

listtasksコマンドで出力されたタスク詳細情報格納フォルダがあることを確認してください。

定義情報（サービス，サービステンプレート，ユーザー，ユーザーグループ，リソースグループ，エージェントレス接続先定義，サービス共有プロパティ）および定義ファイルを別途設定してください。必要に応じて，backupsystemコマンドおよびrestoresystemコマンドを使用して，これらの設定を復元してください。listtasksコマンドでタスク詳細情報格納フォルダを出力したときから，これらの設定を変更したり，サービスを削除したりしないでください。サービスの設定が変更されていた場合，変更後の設定に従って，一括再登録が実行されます。また，サービス設定が削除されていた場合は，該当のタスクの再登録に失敗します。

指定日時実行タスクの場合，タスク再登録時点で指定日時が過ぎていないことを確認してください。指定日時が過ぎていると，エラーとなるため，そのままでは再登録できません。

一括再登録されるタスクの条件について

一括再登録されるタスクは，タスク詳細情報格納フォルダ内にあるタスク一覧（listtasks.csv）のうち，未実行の指定日時実行タスクおよび定期実行タスクです。未実行の指定日時実行タスクおよび定期実行タスクは，タスク一覧で「Unexecuted Schedule」の列が「true」となっています。

指定日時が過ぎている指定日時実行タスクの再登録について

指定日時が過ぎている指定日時実行タスクはそのままでは再登録できません。一括再登録しても，指定日時が過ぎている旨のメッセージが出力されて，再登録が失敗します。再登録に失敗したタスクの設定内容を確認したい場合は，タスク詳細情報格納フォルダ内のタスク一覧ファイル（listtasks.csv）と，個別タスク詳細情報格納フォルダのプロパティファイルを参照してください。指定日時が過ぎているタスクを登録したい場合は，タスク詳細情報格納フォルダ内にあるタスク一覧（listtasks.csv）の元の指定日時を確認してから，JP1/AOの［サービス］画面またはsubmittaskコマンドで，新しく日時を指定して個別にサービスを実行してください。なお，開始予定日時は現在の日時以降を指定してください。

再登録に失敗したタスクがある場合の対処について

タスクの一括再登録に失敗した場合は，タスク登録が失敗した旨のメッセージと，再登録に失敗したタスクのタスクIDが表示されます。このときのタスクIDとは，listtasksコマンドで出力した時点のタスクIDです。一部，再登録に成功したタスクがある場合，該当するタスクの個別タスク詳細情報格納フォルダをほかの場所に退避させてください。その後，失敗原因を取り除いてからコマンドを再実行してください。フォルダを退避させるのは，再登録に成功したタスクの2重登録を避けるためです。この対処をしたあとも同様のエラーが発生する場合は，システム管理者に連絡してください。

形式

サービスを即時実行する場合

submittask
     /servicename サービス名
     ［/resourcegroup リソースグループ名］
     ［/taskname タスク名］
     ［/taskdescription タスクの説明］
     ［/property プロパティキー プロパティ値 |
      /propertyfile プロパティファイルパス］
      /user ユーザーID
      {/password パスワード | /passwordfile パスワードファイルパス}
     ［/wait］

サービスを指定した日時に実行する場合

submittask
     /servicename サービス名
     ［/resourcegroup リソースグループ名］
     ［/taskname タスク名］
     ［/taskdescription タスクの説明］
     ［/property プロパティキー プロパティ値 |
      /propertyfile プロパティファイルパス］
      /user ユーザーID
      {/password パスワード | /passwordfile パスワードファイルパス}
      /scheduledate yyyy-mm-dd /scheduletime hh:mm

サービスを定期的に実行する場合

submittask
      /servicename サービス名
     ［/resourcegroup リソースグループ名］
     ［/taskname タスク名］
     ［/taskdescription タスクの説明］
     ［/property プロパティキー プロパティ値 |
      /propertyfile プロパティファイルパス］
      /user ユーザーID
      {/password パスワード | /passwordfile パスワードファイルパス}
      /recurrencepattern {daily | weekly:sun,mon,...,sat | monthly:{dd,dd,...,dd | endofmonth}}
      /recurrencetime hh:mm /recurrencestart yyyy-mm-dd

タスクを一括再登録する場合

submittask
     /reregister
     /taskdetaildir タスク詳細情報格納フォルダ
     [/setoriginalsubmitter]
     /user ユーザーID
     {/password パスワード | /passwordfile パスワードファイルパス}

引数

/servicename サービス名

実行するサービスの名称を指定します。

指定できる文字数は，1〜64文字です。

/resourcegroup リソースグループ名

実行するサービスが所属するリソースグループの名称を指定します。

このオプションを省略した場合は，引数に指定したユーザーに関連づいたリソースグループが設定されますが，ユーザーに関連づいたリソースグループが複数存在する場合，エラーとなります。

指定できる文字数は，1〜63文字です。使用できる文字の種類は，半角英数字および「_」です。

ただし，ビルトインリソースグループである"All Resources"を指定する場合だけ空白を指定できます。

/taskname タスク名

タスクの名称を指定します。

このオプションを省略した場合は，デフォルトの名称として「サービス名_YYYYMMDDhhmmss」（YYYYMMDDhhmmss：サービス実行時の時刻）が設定されます。

指定できる文字数は1〜128文字です。使用できる文字の種類は，制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外です。

/taskdescription タスクの説明

タスクの説明を指定します。

このオプションを省略した場合は値が設定されません。

指定できる文字数は，1〜256文字です。使用できる文字の種類は，制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外です。

/property プロパティキープロパティ値

実行するサービスで使用するプロパティキーおよびプロパティ値を指定します。指定したプロパティ値はサービステンプレートの仕様に従って妥当かどうか検証されます。

このオプションで設定しなかったプロパティキーについては，［サービス設定］ダイアログボックスで指定した値が設定されます。指定が必須のプロパティについて，［サービス設定］ダイアログボックスで値を指定していない場合，かつこのオプションでも値を指定しなかった場合，エラーとなります。

このオプションは，「/property プロパティキー1 プロパティ値1 /property プロパティキー2 プロパティ値2」のように複数指定できます。指定できるプロパティキーとプロパティ値の組み合わせは，最大100個です。

プロパティキー

サービスのプロパティキーを指定します。

指定できる文字数は，1〜128文字です。使用できる文字の種類は，半角英数字，「-」，「_」，「.」です。

同一のプロパティキーが指定された場合は，エラーとなります。

プロパティ値

プロパティキーに対応するプロパティ値を指定します。

空白と特殊記号を含む場合，「"」で囲んで指定します。

/propertyfile プロパティファイルパス

実行対象のサービスで使用する入力プロパティの設定を定義したプロパティファイルのパスを，絶対パスまたは相対パスで指定します。

このオプションで設定しなかったプロパティキーおよびプロパティ値については，［サービス設定］ダイアログボックスで指定した値が設定されます。指定が必須のプロパティについて，［サービス設定］ダイアログボックスで値を指定していない場合，かつこのオプションで指定したプロパティファイルでも値が定義されていない場合，エラーとなります。

プロパティファイルの形式を次に示します。

表8‒8　プロパティファイルの形式

項目

形式

格納場所

任意（ただし，コマンド実行ユーザーがアクセスできること）

ファイル名

任意

定義形式

プロパティキー=プロパティ値（改行コード）

プロパティキー=プロパティ値（改行コード）

：

定義例※

common.targetHost=ajsagthost

jp1base.jp1BaseLHostName=lohost

common.foreachIPaddress=192.168.1.xx,192.168.1.yy

注※

プロパティ値の区切り文字は使用するサービステンプレートによって異なります。例では「,」を区切り文字に使用しています。

プロパティごとに1行ずつ定義してください。定義できるプロパティキーとプロパティ値の組み合わせは最大100個です。

最初に「=」が出現するまでの文字列はプロパティキーと見なします。最初に出現する「=」の次の文字から，行末の改行コードまでの文字列はプロパティ値と見なします。ファイル末尾の改行コードの有無は問いません。

/reregister

タスクを一括再登録する場合に指定します。reregisterオプションを指定する場合は，taskdetaildirオプションも必ず指定してください。

/taskdetaildir タスク詳細情報格納フォルダ

reregisterオプションを指定したときに，必ず指定します。再登録したい指定日時実行タスクまたは定期実行タスクの情報が格納された，タスク詳細情報格納フォルダのパスを，絶対パスまたは相対パスで指定します。ただし，指定できるのはローカルディスクのフォルダだけです。指定できる文字数は，絶対パスの長さで190文字までです。

/setoriginalsubmitter

タスクを一括再登録する場合にこのオプションを指定すると，一括再登録をした実行者ではなく，元のタスクの実行者を，再登録後のタスク実行者として表示できます。元のタスクの実行者とは，listtasksコマンドでタスク詳細情報を出力した時点でのタスクの実行者を指します。再登録後のタスクの実行者は，［タスク］画面の［実行者］列に表示されるユーザーIDで確認できます。listtasksコマンドでタスク詳細情報を出力した時点でのタスクの実行者は，タスク詳細情報格納フォルダに出力されたlisttasks.csvファイルのSubmitted Byの列で確認できます。

このオプションを省略した場合は，submittaskコマンドのuserオプションに指定したユーザーIDが，再登録後のタスクの実行者となります。

なお，タスクを再登録する時点で，「listtasksコマンドでタスク詳細情報を出力した時点でのタスクの実行者」が存在しない場合であってもエラーにはなりません。この場合，タスクの実行者は，「listtasksコマンドでタスク詳細情報を出力した時点でのタスクの実行者」になります。

/user ユーザーID

JP1/AOのユーザーIDを指定します。servicenameオプションで指定したサービスが所属するリソースグループに関連づいたユーザーを指定してください。

指定できる文字数は，1〜256文字です。

使用できる文字の種類は，半角英数字，「!」，「#」，「$」，「%」，「&」，「'」，「(」，「)」，「*」，「+」，「-」，「.」，「=」，「@」，「¥」，「^」，「_」，「|」です。

大文字と小文字は区別しません。

/password パスワード

userオプションで指定した，ユーザーのパスワードを指定します。

指定できる文字数は，1〜256文字です。

使用できる文字の種類は，userオプションと同じです。

/passwordfile パスワードファイルパス

userオプションで指定したユーザーのパスワードファイルのパスを絶対パスまたは相対パスで指定します。パスワードファイルはencryptpasswordコマンドで作成します。

/wait

指定した場合，タスクの実行結果（正常終了または失敗）を出力してからコマンドを終了します。waitオプションを指定しない場合，タスク実行の終了を待たないで，コマンドが終了します。このとき，タスクの実行が正常に開始された場合にだけ，タスクIDがメッセージで出力されます。

/scheduledate

サービスを実行する年月日を，「YYYY-MM-DD」の形式で指定します。「YYYY」には西暦を4桁の半角数字で指定します。「MM」には月を1（または01）から12の半角数字で指定します。「DD」には日を1（または01）から31の半角数字で指定します。scheduledateオプションは，scheduletimeオプションとあわせて指定します。なお，次のどれかに該当する場合は，コマンドの実行に失敗します。

引数の組み合わせが不正な場合

引数の組み合わせについては「表8‒9　submittaskコマンドの引数の組み合わせ」を参照してください。

指定した日付の形式が不正な場合

scheduletimeオプションとの組み合わせで決まる日時が過去を指定している場合

指定した日付が1994年1月1日から2036年12月31日の範囲外の場合

/scheduletime

サービスを実行する時分を，「hh:mm」の形式で指定します。「hh」には時を00から23の半角数字で指定します。「mm」には分を00から59の半角数字で指定します。scheduletimeオプションは，scheduledateオプションとあわせて指定します。なお，次のどれかに該当する場合は，コマンドの実行に失敗します。

引数の組み合わせが不正な場合

引数の組み合わせについては「表8‒9　submittaskコマンドの引数の組み合わせ」を参照してください。

指定した時刻の形式が不正な場合

scheduledateオプションとの組み合わせで決まる日時が過去を指定している場合

/recurrencepattern {daily | weekly:sun,mon,...,sat | monthly:{dd,dd,...,dd | endofmonth}}

サービスを定期実行する周期を指定します。recurrencepatternオプションは，recurrencetimeオプションおよびrecurrencestartオプションとあわせて指定します。なお，次のどちらかに該当する場合は，コマンドの実行に失敗します。

引数の組み合わせが不正な場合

引数の組み合わせについては「表8‒9　submittaskコマンドの引数の組み合わせ」を参照してください。

指定した定期実行周期の形式が誤っている場合

定期実行周期の種別は，毎日，毎週，毎月の3つがあります。定期実行周期の書式は，定期実行周期の種別ごとに異なります。

毎日

dailyを指定します。

毎週

weekly:sun,mon,...,satの形式で指定します。

先頭にweekly:を指定し，サービスを実行する曜日を「,」区切りで指定します。曜日の略称には，sun，mon，tue，wed，thu，fri，satを使用します。曜日を指定する際，順序は問いません。同じ曜日が複数回指定されている場合は，引数不正のエラーとなります。

毎月

monthly:{dd,dd,...,dd | endofmonth}を指定します。

先頭にmonthly:を指定し，サービスを実行する日を「,」区切りで指定します。月末にサービスを実行する場合は，日を指定しないで，endofmonthだけを指定します。日を指定する際，順序は問いません。日を指定する場合，1（または01）から31の半角数字で指定します。同じ日が複数回指定されている場合や，0以下や32以上などの存在しない日を指定した場合は，引数不正のエラーとなります。なお，日の指定で存在しない月の定期実行はスキップされます。例えば毎月30や31日を指定したとき，2月の定期実行はスキップされます。

/recurrencetime hh:mm

サービスを定期実行する時分を，「hh:mm」の形式で指定します。「hh」には時を00から23の半角数字で指定します。「mm」には分を00から59の半角数字で指定します。recurrencetimeオプションは，recurrencepatternオプションおよびrecurrencestartオプションとあわせて指定します。なお，次のどちらかに該当する場合は，コマンドの実行に失敗します。

引数の組み合わせが不正な場合

引数の組み合わせについては「表8‒9　submittaskコマンドの引数の組み合わせ」を参照してください。

指定した時刻の形式が不正な場合

/recurrencestart yyyy-mm-dd

サービスを定期実行する際の適用開始日を「yyyy-mm-dd」の形式で指定します。「yyyy」には西暦を4桁の半角数字で指定します。「mm」には月を1（または01）から12の半角数字で指定します。「dd」には日を1（または01）から31の半角数字で指定します。recurrencestartオプションは，recurrencepatternオプションおよびrecurrencetimeオプションとあわせて指定します。なお，次のどれかに該当する場合は，コマンドの実行に失敗します。

引数の組み合わせが不正な場合

引数の組み合わせについては「表8‒9　submittaskコマンドの引数の組み合わせ」を参照してください。

指定した年月日の形式が不正な場合

指定した年月日が1994年1月1日から2036年12月31日の範囲外である場合

submittaskコマンドの引数の組み合わせ

表8‒9　submittaskコマンドの引数の組み合わせ

オプション

サービスの即時実行

サービスの指定日時実行

サービスの定期実行

スケジュールされたタスクの一括再登録

/servicename

◎　

◎　

◎　

×　

/resourcegroup

○　

○　

○　

×　

/taskname

○　

○　

○　

×　

/taskdescription

○　

○　

○　

×　

/property※1

○　

○　

○　

×　

/propertyfile※1

○　

○　

○　

×　

/reregister

×　

×　

×　

◎　

/taskdetaildir

×　

×　

×　

◎　

/setoriginalsubmitter

×　

×　

×　

○　

/user

◎　

◎　

◎　

◎　

/password※2

◎　

◎　

◎　

◎　

/passwordfile※2

◎　

◎　

◎　

◎　

/wait

○　

×　

×　

×　

/scheduledate

×　

◎　

×　

×　

/scheduletime

×　

◎　

×　

×　

/recurrencepattern

×　

×　

◎　

×　

/recurrencetime

×　

×　

◎　

×　

/recurrencestart

×　

×　

◎　

×　

（凡例）

◎：必ず指定します。省略した場合は引数エラーになります。

○：省略できます。

×：指定できません。指定した場合は引数エラーになります。

注※1

propertyオプションまたはpropertyfileオプションのどちらか一方を指定してください。両方を同時に指定するとエラーになります。

注※2

passwordオプションまたはpasswordfileオプションのどちらか一方を指定してください。両方を同時に指定するとエラーになります。

格納先

Windowsの場合

JP1/AOのインストール先フォルダ¥bin

Linuxの場合

/opt/jp1ao/bin

実行権限

OSのAdministrators権限またはroot権限を持つユーザーで実行してください。Administrators権限またはroot権限がない場合は，権限昇格を求めるメッセージが表示されます。

コマンド実行ユーザーが所属するユーザーグループから，実行したいサービスのリソースグループに対してAdminロール，Developロール，ModifyロールまたはSubmitロールが設定されている必要があります。ロールが設定されていないリソースグループのサービスについては実行できません。

userオプションに指定するユーザーに必要な権限を次に示します。

サービスを実行する場合

userオプションに指定するユーザーが所属するユーザーグループから，操作対象のリソースグループに対して，Adminロール，Developロール，ModifyロールまたはSubmitロールが設定されている必要があります。それぞれ，実行権限のあるサービスだけを実行できます。

タスクを一括再登録する場合

userオプションに指定するユーザーには，Adminロールが設定されている必要があります。

戻り値

コマンドの戻り値を次の表に示します。

戻り値

説明

0

正常に終了しました。

1

引数が不正です。

2

コマンドの実行を中断しました。

3

サービスの状態が不正です。

5

通信に失敗しました。

6

認証に失敗しました。

7

パスの指定が不正です。

9

指定したパスが存在しません。

10

指定したパスにアクセスできません。

14

コマンドの実行権限がありません。

130

サービスの開始に失敗しました。

131

プロパティファイルが存在しません。

132

プロパティファイルの形式が不正です。

133

タスクの状態取得に失敗しました。（waitオプション指定時）

134

タスクの実行に失敗しました。（waitオプション指定時）

136

タスク詳細情報格納フォルダのデータ形式が不正です。

137

予定されたタスクの一括再登録が一部失敗しました。

138

予定されたタスクの一括再登録がすべて失敗しました。

139

タスク詳細情報格納フォルダを出力したJP1/AOと，インストールされているJP1/AOのバージョンまたはリビジョンが異なります。

255

そのほかのエラーでコマンドの実行が中断しました。

使用例

次の場合のコマンドの使用例を示します。

Windowsで，サービス名で指定したサービスにプロパティおよびプロパティ値を指定して実行する場合

submittask /servicename service01 /user user01 /password pass01 /property keyA valueA /property keyB "value B" /property keyC valueC,valueD

Windowsで，リソースグループとサービス名で指定したサービスに対して，タスク名，タスクの説明，およびプロパティファイルを指定して実行する場合

submittask /servicename service02 /resourcegroup resourceA /taskname task02 /taskdescription testtask /propertyfile C:¥properties.txt /user user02 /password pass02

Windowsで，タスクの実行結果を出力してからコマンドが終了するようにする場合

submittask /servicename service03 /user user03 /password pass03 /wait

Windowsで，日時を指定してサービスを実行する場合

submittask /servicename service04 /user user04 /password pass04 /scheduledate 2014-01-01 /scheduletime 15:30

Windowsで，定期実行する場合

submittask /servicename service05 /user user05 /password pass05 /recurrencepattern weekly:sun,mon,fri /recurrencetime 15:30 /recurrencestart 2013-06-17

Windowsで，予定されたタスクを一括再登録する場合

submittask /reregister /taskdetaildir "C:¥data¥taskdetail" /user user06 /password pass06

関連トピック

8.6.7　listtasks（タスクの一覧出力，タスク詳細情報出力）

8.3　コマンドの引数に指定できる文字

8.7　保守・メンテナンス関連のコマンド

8.7.1　backupsystem（JP1/AOシステムのバックアップ）

機能

JP1/AOの設定情報やデータベース情報をバックアップして指定したフォルダにデータを格納します。

形式

backupsystem
     /dir バックアップデータのパス
     ［/auto］

引数

/dir バックアップデータのパス

バックアップデータを収集する空のフォルダを絶対パスまたは相対パスで指定します。指定できるのはローカルディスクのフォルダだけです。指定するパスは，50文字以内をお勧めします。

/auto

JP1/AOおよびHitachi Command Suite製品のサービスとデータベースの停止・開始を自動で実行します。このオプションを省略した場合は，JP1/AOおよびHitachi Command Suite製品のサービスとデータベースの停止・開始を自動で実行しません。

なお，クラスタ環境でこのオプションを指定する場合は，クラスタソフトに登録したサービスがオフラインである必要があります。

格納先

Windowsの場合

JP1/AOのインストール先フォルダ¥bin

Linuxの場合

/opt/jp1ao/bin

実行権限

Administrators権限またはroot権限を持つユーザーで実行してください。Administrators権限またはroot権限がない場合は，権限昇格を求めるメッセージが表示されます。

注意事項

バックアップファイルを格納するフォルダに十分な空き容量があることを確認してください。必要な空き容量は次のとおりです。

バックアップ対象ファイルの容量+20MB

このコマンドでバックアップを実施する前に，JP1/Baseのバックアップを実施してください。

このコマンドでは，次のファイルはバックアップされません。必要に応じて手動でバックアップしてください。

https接続用のSSLサーバ証明書ファイル

https接続用の秘密鍵ファイル

公開鍵認証用の秘密鍵ファイル

作成したクラスタサービス制御コマンド（Linuxでクラスタ構成の場合）

autoオプションを指定しない場合，JP1/AOのサービスが停止していることを確認してからこのコマンドを実行してください。

停止していない場合は，hcmdssrvコマンドまたはhcmds64srvコマンドにstopオプションを指定して実行し，サービスを停止してください。

戻り値

コマンドの戻り値を次の表に示します。

戻り値

説明

0

正常に終了しました。

1

引数が不正です。

2

コマンドの実行を中断しました。

3

サービスの状態が不正です。

4

ほかのコマンドを実行中です。

7

パスの指定が不正です。

9

指定したパスが存在しません。

10

指定したパスにアクセスできません。

11

指定したフォルダが空ではありません。

14

コマンドの実行権限がありません。

100

バックアップの実行に失敗しました。

101

サービスの開始/停止に失敗しました。

103

スケジューラーデータベースへのアクセスエラーが発生しました。

255

そのほかのエラーでコマンドの実行が中断しました。

使用例

Windowsで，指定したバックアップフォルダにデータをバックアップする場合のコマンドの使用例を示します。

backupsystem /dir "C:¥Users¥Backup" /auto

関連トピック

マニュアル「JP1/Base 運用ガイド」−「バックアップとリカバリー」のトピック

8.3　コマンドの引数に指定できる文字

マニュアル「JP1/AO 構築ガイド」−「プロパティファイル（config_user.properties）」のトピック

8.7.2　hcmdsdbrepair/hcmds64dbrepair（データベースの再作成）

機能

すべてのデータベースを強制削除して再作成し，hcmdsdbtransコマンドまたはhcmds64dbtransコマンドで取得したバックアップデータからデータベースを回復します。このコマンドは，データベースが破損してrestoresystemコマンド，およびhcmdsdbtransコマンドまたはhcmds64dbtransコマンドのimportオプションを使用しても復旧できない場合に使用します。

形式

hcmdsdbrepair | hcmds64dbrepair
     /trans バックアップデータ

引数

/trans バックアップデータ

hcmdsdbtransコマンドで取得したデータベースのバックアップデータを指定します。バックアップデータには，hcmdsdbtransコマンドまたはhcmds64dbtransコマンドのworkpathオプションまたはfileオプションに指定したパスを指定してください。

格納先

Windowsの場合

共通コンポーネントのインストール先フォルダ¥bin

Linuxの場合

/opt/HiCommand/Base64/bin

実行権限

Administrators権限またはroot権限を持つユーザーで実行してください。

注意事項

hcmdsdbrepairコマンドまたはhcmds64dbrepairコマンドを実行する前に，JP1/AOシステムを停止してください。

hcmdsdbrepairコマンドまたはhcmds64dbrepairコマンドの実行後は，JP1/AOシステムを開始してください。

バックアップデータを展開するために必要な領域として「共通コンポーネントのインストール先フォルダ¥tmp」または「var/opt/HiCommand/Base64/tmp」のフォルダを使用します。バックアップデータの容量に応じて，展開するために必要な領域を確保してください。

コマンドの実行後，ビルトインアカウント（Systemアカウント）のパスワードが初期値に戻ります。必要に応じて，パスワードを変更してください。

クラスタシステムの場合，実行系ホストでコマンドを実行してください。待機系ホストでは実行できません。

戻り値

コマンドの戻り値を次の表に示します。

戻り値

説明

0

正常に終了しました。

1

引数が不正です。

245

データベースのインポートに失敗しました。

246

定義ファイルが不正です。

247

データベースのアンセットアップに失敗しました。

248

サービスまたはデータベースの停止に失敗しました。

249

待機系ノードのため実行できません。

250

バックアップデータが不正（ファイル不足，アーカイブファイルの展開失敗）です。

251

製品不一致，製品バージョン不一致のため中断しました。

252

データベースのセットアップに失敗しました。

253

データベースのサービスの開始に失敗しました。

254

データベースがセットアップされていないためデータベースを再作成できません。

255

異常終了しました。

使用例

Windowsで，すべてのデータベースを強制削除して再作成し，バックアップデータからデータベースを回復する場合のコマンドの使用例を示します。

hcmdsdbrepair /trans C:¥bkfile1

関連トピック

8.3　コマンドの引数に指定できる文字

マニュアル「JP1/AO 運用ガイド」−「JP1/AO システムを開始する手順（非クラスタ構成の場合）」のトピック

マニュアル「JP1/AO 運用ガイド」−「JP1/AO システムを開始する手順（クラスタ構成の場合）」のトピック

マニュアル「JP1/AO 運用ガイド」−「JP1/AO システムを停止する手順（非クラスタ構成の場合）」のトピック

マニュアル「JP1/AO 運用ガイド」−「JP1/AO システムを停止する手順（クラスタ構成の場合）」のトピック

8.6.3　hcmdssrv/hcmds64srv（JP1/AOの開始・停止・状態表示）

8.7.3　hcmdsdbsrv/hcmds64dbsrv（データベースの開始・停止）

機能

JP1/AOのデータベースを開始および停止します。データベースのメンテナンスを実施するときに使用します。

形式

hcmdsdbsrv | hcmds64dbsrv
     {/start | /stop}

引数

/start

データベースを開始します。

/stop

データベースを停止します。

格納先

Windowsの場合

共通コンポーネントのインストール先フォルダ¥bin

Linuxの場合

/opt/HiCommand/Base64/bin

実行権限

Administrators権限またはroot権限を持つユーザーで実行してください。

注意事項

データベースのメンテナンス手順以外では使用しないでください。

戻り値

コマンドの戻り値を次の表に示します。

戻り値

説明

0

開始・停止の要求を受け付けました。

254

データベースが初期化されていません。

255

失敗しました。

使用例

次の場合のコマンドの使用例を示します。

Windowsで，JP1/AOのデータベースを開始する場合

hcmdsdbsrv /start

Windowsで，JP1/AOのデータベースを停止する場合

hcmdsdbsrv /stop

関連トピック

8.3　コマンドの引数に指定できる文字

8.7.4　hcmdsdbtrans/hcmds64dbtrans（データベースのバックアップ・リストア）

機能

JP1/AOのデータベースをバックアップ（エクスポート）またはリストア（インポート）します。JP1/AOのデータベースを再編成する場合に使用します。

形式

JP1/AOのデータベースをバックアップ（エクスポート）する場合：

hcmdsdbtrans | hcmds64dbtrans
     /export
     /workpath 作業用フォルダパス
     /file アーカイブファイルパス
     ［/auto］

JP1/AOのデータベースをリストア（インポート）する場合：

hcmdsdbtrans | hcmds64dbtrans
     /import
     /type Automation
     /workpath 作業用フォルダパス
     ［/file アーカイブファイルパス］
     ［/auto］

引数

/export

データベースをエクスポートします。

/workpath 作業用フォルダパス

エクスポートまたはインポートするときに一時的に使用する作業用フォルダを絶対パスで指定します。指定できるのはローカルディスクのフォルダだけです。

エクスポート時や，インポート時にfileオプションを指定する場合，作業用フォルダには空のフォルダを指定してください。

/file アーカイブファイルパス

エクスポートまたはインポートするアーカイブファイルのパスを絶対パスで指定します。exportオプションを指定する場合は必ず指定します。

出力ファイルサイズが2GBを超える場合や，アーカイブファイルを作成する先のディスク容量が不足している場合，アーカイブファイルは作成されません。

/auto

JP1/AOおよびHitachi Command Suite製品のサービスとデータベースの停止・開始を自動で実行します。このオプションを省略した場合は，JP1/AOおよびHitachi Command Suite製品のサービスとデータベースの停止・開始を自動で実行しません。

/import

データベースをインポートします。インポート時に既存の認証データはすべて削除されてからインポートされます。

/type Automation

データベースをインポートする対象の製品名として「Automation」を指定します。

格納先

Windowsの場合

共通コンポーネントのインストール先フォルダ¥bin

Linuxの場合

/opt/HiCommand/Base64/bin

実行権限

Administrators権限またはroot権限を持つユーザーで実行してください。

注意事項

エクスポート時に，戻り値「3」または「5」が出力された場合，データベースの情報はworkpathオプションに指定したディレクトリに残っています。

これらの情報をインポートしたい場合は，workpathオプションに，エクスポート時にworkpathオプションに指定したディレクトリを指定してください。このとき，エクスポート時にworkpathオプションに指定したディレクトリのフォルダ構成を変更しないでください。また，インポートするとき，fileオプションには何も指定しないでください。

次の場合，workpathオプションに指定したディレクトリは空になり，コマンドが終了します。

エクスポート時に，戻り値「1」，「2」，「233」，「234」，「235」，「237」，「238」，「239」，「240」または「255」が出力された場合

インポート時に，戻り値「3」が出力された場合

戻り値

exportオプション指定時のコマンドの戻り値を次の表に示します。

戻り値

説明

0

正常に終了しました。

1

製品のバージョンの取得に失敗しました。

2

データベースが開始していません。

3

データベースのアーカイブに失敗しました。

4

作業用フォルダが空ではありません。

5

データベースの全体容量が2GBを超えるため，アーカイブできません。

233

データベースの再起動が中断している状態です。

234

データベースのサービスが停止しているか，または存在しません。

235

データベースが初期化されていません。

237

Hitachi Command Suite製品またはデータベースの開始に失敗しました。

238

Hitachi Command Suite製品またはデータベースの停止に失敗しました。

239

データベースの開始に失敗しました。

240

データベースの停止に失敗しました。

255

異常終了しました。

importオプション指定時のコマンドの戻り値を次の表に示します。

戻り値

説明

0

正常に終了しました。

1

製品のバージョンの取得に失敗しました。

2

データベースが開始していません。

3

アーカイブファイルの展開に失敗しました。

4

作業用フォルダが空ではありません。

5

指定された製品がアーカイブファイルに存在しません。

6

指定された製品がインストールされていません。

7

インポートできないバージョンの製品があります。

8

作業用フォルダにインポート用のデータがありません。または，インポート用のデータの形式が不正です。

9

プライマリーサーバに，セカンダリーサーバのデータをインポートしようとしました。

10

セカンダリーサーバに，プライマリーサーバのデータをインポートしようとしました。

11

使用中のデータベースにデータをインポートしようとしました。

233

データベースの再起動が中断している状態です。

234

データベースのサービスが停止しているか，または存在しません。

235

データベースが初期化されていません。

237

Hitachi Command Suite製品またはデータベースの開始に失敗しました。

238

Hitachi Command Suite製品またはデータベースの停止に失敗しました。

239

データベースの開始に失敗しました。

240

データベースの停止に失敗しました。

255

異常終了しました。

使用例

次の場合のコマンドの使用例を示します。

Windowsで，JP1/AOのデータベースをバックアップする場合

hcmdsdbtrans /export /workpath "C:¥Users¥workfolder" /file "C:¥backup¥arcfile01" /auto

Windowsで，JP1/AOのデータベースをリストアする場合

hcmdsdbtrans /import /type Automation /workpath "C:¥Users¥workfolder" /file "C:¥backup¥arcfile01" /auto

関連トピック

8.3　コマンドの引数に指定できる文字

8.7.5　hcmdsgetlogs/hcmds64getlogs（ログ情報の採取）

機能

JP1/AOの運用中に出力されるログ情報を採取してアーカイブファイルに出力します。

形式

hcmdsgetlogs | hcmds64getlogs
     /dir 出力フォルダパス
     ［/types Automation］
     ［/arc アーカイブファイル名］
    ［/logtypes {log | db | csv}］

引数

/dir 出力フォルダパス

アーカイブファイルを出力するフォルダパスを指定します。指定できるのはローカルディスクのフォルダだけです。

出力フォルダパスには空のフォルダを絶対パスまたは相対パスで指定してください。指定したフォルダパスが存在しない場合はフォルダが作成されます。

指定できるパスの最大長は100文字です。なお，このオプションで指定したフォルダには書き込み許可が設定されます。

/types Automation

ログ情報を収集する対象の製品名として「Automation」を指定します。JP1/AOサーバのOSがWindowsの場合，大文字と小文字は区別しません。JP1/AOサーバのOSがLinuxの場合，大文字と小文字を区別します。このオプションを省略した場合，JP1/AOおよびインストールされているすべてのHitachi Command Suite製品が対象となります。なお，この場合，ログの収集に時間がかかることがあります。

/arc アーカイブファイル名

共通コンポーネントの資料採取ツールの実行結果として作成するアーカイブファイルの名称を指定します。このオプションを指定しない場合，アーカイブファイル名は「HiCommand_log」になります。

アーカイブファイルは，dirオプションで指定したフォルダの下に出力されます。

アーカイブファイル名として指定できる文字は，ASCII印字可能文字コード（0x20〜0x7E）の中で，一部の特殊文字（「¥」，「/」，「:」，「,」，「;」，「*」，「?」，「"」，「<」，「>」，「|」，「$」，「%」，「&」，「'」，「`」）を除いたものです。なお，拡張子の指定は不要です。

/logtypes {log | db | csv}

取得したい共通コンポーネントのログファイルの種別を指定します。ログファイル種別と取得できるログファイルの対応を次の表に示します。

表8‒10　ログファイル種別と取得できるログファイル

ログファイル種別

取得できるログファイル（Windowsの場合）

取得できるログファイル（Linuxの場合）

log

arcオプションで指定したアーカイブファイル名.jar

arcオプションで指定したアーカイブファイル名.hdb.jar

/arc オプションで指定したアーカイブファイル名_64.jar

arcオプションで指定したアーカイブファイル名_64.hdb.jar

db

arcオプションで指定したアーカイブファイル名.db.jar

arcオプションで指定したアーカイブファイル名_64.db.jar

csv

arcオプションで指定したアーカイブファイル名.csv.jar

arcオプションで指定したアーカイブファイル名_64.csv.jar

このオプションを省略した場合は，共通コンポーネントのすべてのログファイルが取得されます。そのため，オプションを省略して，実行することをお勧めします。

複数のログファイル種別を指定する場合は，「logtypes log db csv」のように半角空白で区切ってください。なお，typesオプションとlogtypesオプションを同時に使用する場合は，logtypesオプションの値に必ず「log」を指定してください。

出力形式

コマンドを実行した結果，採取する資料の一覧を次に示します。

なお，ファイルの内容および出力形式については公開していません。

表8‒11　採取する資料一覧（JP1/AOサーバのOSがWindowsの場合）

アーカイブファイル

出力結果

/dirオプションで指定した出力先フォルダ¥Automation_1st_log.jar

JP1/AOのインストール先フォルダ¥logs直下のすべてのファイル（サブフォルダは含まれません）

JP1/AOのインストール先フォルダ¥data¥task配下のすべてのファイル

/dirオプションで指定した出力先フォルダ¥Automation_log.jar

FILELIST.txt

JP1/AOのインストール先フォルダ¥conf配下のすべてのファイル

JP1/AOのインストール先フォルダ¥data配下のすべてのファイル

JP1/AOのインストール先フォルダ¥logs配下のすべてのファイル

JP1/AOのインストール先フォルダ¥system¥AJS3CD配下のすべてのファイル

JP1/AOのインストール先フォルダ¥work配下のすべてのファイル

Windowsフォルダ※1¥Temp¥HITACHI_JP1_INST_LOG配下のすべてのファイル

Windowsフォルダ※1¥Temp¥jp1common配下のすべてのファイル

ProgramFiles(x86)フォルダ※2¥InstallShield Installation Information¥{C4F6D00E-A9A2-4E57-A21A-B78B63FF1C54}¥setup.ini

ProgramFiles(x86)フォルダ※2¥InstallShield Installation Information¥{C4F6D00E-A9A2-4E57-A21A-B78B63FF1C54}¥setup.ilg

REGDATA.DAT

/dirオプションで指定した出力先フォルダ¥AJS_log.jar

タスク処理エンジンの資料採取ツールの実行結果

/dirオプションで指定した出力先フォルダ¥/arcオプションで指定したアーカイブファイル名.jar

共通コンポーネントの資料採取ツール（hcmdsgetlogs，hcmdsras）の実行結果

/dirオプションで指定した出力先フォルダ¥/arcオプションで指定したアーカイブファイル名.hdb.jar

共通コンポーネントの資料採取ツール（hcmdsgetlogs）の実行結果

/dirオプションで指定した出力先フォルダ¥/arcオプションで指定したアーカイブファイル名.db.jar

共通コンポーネントの資料採取ツール（hcmdsgetlogs）の実行結果

/dirオプションで指定した出力先フォルダ¥/arcオプションで指定したアーカイブファイル名.csv.jar

共通コンポーネントの資料採取ツール（hcmdsgetlogs）の実行結果

注※1

Windowsフォルダは，デフォルトの場合はC:¥WINDOWSとなります。

注※2

ProgramFiles(x86)フォルダは，デフォルトの場合はC:¥Program Files (x86)となります。

表8‒12　採取する資料一覧（JP1/AOサーバのOSがLinuxの場合）

アーカイブファイル

出力結果

dirオプションで指定した出力先フォルダ/arcオプションで指定したアーカイブファイル名_64.jar

FILELIST.txt

/opt/jp1ao/conf配下のすべてのファイル

/var/opt/jp1ao/data配下のすべてのファイル

/var/opt/jp1ao/logs配下のすべてのファイル

/opt/jp1ao/system/AJS3CD配下のすべてのファイル

/opt/jp1ao/tools配下のすべてのファイル

/var/opt/jp1ao/work配下のすべてのファイル

/tmp/ HITACHI_JP1_INST_LOG配下のすべてのファイル

タスク処理エンジンの資料採取ツールの実行結果

共通コンポーネントの資料採取ツール（hcmds64getlogs，hcmds64ras）の実行結果

dirオプションで指定した出力先フォルダ/arcオプションで指定したアーカイブファイル名_64.hdb.jar

共通コンポーネントの資料採取ツール（hcmds64getlogs）の実行結果

dirオプションで指定した出力先フォルダ/arcオプションで指定したアーカイブファイル名_64.db.jar

共通コンポーネントの資料採取ツール（hcmds64getlogs）の実行結果

dirオプションで指定した出力先フォルダ/arcオプションで指定したアーカイブファイル名_64.csv.jar

共通コンポーネントの資料採取ツール（hcmds64getlogs）の実行結果

格納先

Windowsの場合

共通コンポーネントのインストール先フォルダ¥bin

Linuxの場合

/opt/HiCommand/Base64/bin

実行権限

Administrators権限またはroot権限を持つユーザーで実行してください。

注意事項

このコマンドは実行中に中断しないでください。

このコマンドの実行が中断した場合，dirオプションで指定するフォルダに十分な空き容量がないためhcmdsgetlogsコマンドまたはhcmds64getlogsコマンドが途中で終了しています。dirオプションで指定するフォルダに十分な空き容量を確保したあとで，再度このコマンドを実行してください。

このコマンドは同時に複数実行しないでください。

JP1/AOをクラスタ構成で運用している場合は，実行系ホストと待機系ホストそれぞれでこのコマンドを実行してください。

JP1/AOサーバが停止していてもこのコマンドは実行できます。そのため，クラスタ構成で障害が起きた場合も，系切り替えを行わないでログ情報を採取できます。ただし，データベースが停止している場合，データベースの情報は取得できません。

同じオプションを2回以上指定した場合，最初に指定したオプションが有効となります。

戻り値

コマンドの戻り値を次の表に示します。

戻り値

説明

0

正常に終了しました。

1

引数が不正です。

2

異常終了しました。

使用例

Windowsで，指定したフォルダにログ情報を収集する場合のコマンドの使用例を示します。

hcmdsgetlogs /dir "C:¥Users¥folder01" /types Automation /arc AO_log

関連トピック

8.3　コマンドの引数に指定できる文字

8.7.6　restoresystem（JP1/AOシステムのリストア）

機能

backupsystemコマンドで取得したJP1/AOの設定情報やデータベース情報のバックアップデータをリストアします。

コマンド実行時にリストアするデータを次に示します。

タスク※

デバッグタスク※

タスクの履歴

サービス

デバッグサービス

サービステンプレート

ユーザー

ユーザーグループ

リソースグループ

エージェントレス接続先定義

サービス共有プロパティ

各種定義ファイル

注※

リストアしたタスクおよびデバッグタスクでは，詳細情報の一部（進捗およびステップ一覧）が削除されます。また，リストア後のタスクおよびデバッグタスクの状態は次のように変更されます。

表8‒13　バックアップ時とリストア後のタスクおよびデバッグタスクの状態

バックアップ時のタスクおよびデバッグタスクの状態

リストア後のタスクおよびデバッグタスクの状態

待機中

キャンセル（タスクおよびデバッグタスクの終了日時にはリストアした日時が設定されます）

保留中

実行中

失敗

応答待ち中

異常検出

停止中

正常終了

正常終了

失敗

失敗

キャンセル

キャンセル

形式

restoresystem
     /dir バックアップデータのパス
     /jp1user JP1ユーザー名
     ［/auto］

引数

/dir バックアップデータのパス

backupsystemコマンドで指定したバックアップデータが格納されているバックアップフォルダのパスを絶対パスまたは相対パスで指定します。

/jp1user JP1ユーザー名

バックアップを取得したときに登録されていたJP1ユーザー名を指定します。

/auto

JP1/AOおよびHitachi Command Suite製品のサービスとデータベースの停止・開始を自動で実行します。このオプションを省略した場合は，JP1/AOおよびHitachi Command Suite製品のサービスとデータベースの停止・開始を自動で実行しません。

なお，クラスタ環境でこのオプションを指定する場合は，クラスタソフトに登録したサービスがオフラインである必要があります。

格納先

Windowsの場合

JP1/AOのインストール先フォルダ¥bin

Linuxの場合

/opt/jp1ao/bin

実行権限

Administrators権限またはroot権限を持つユーザーで実行してください。Administrators権限またはroot権限がない場合は，権限昇格を求めるメッセージが表示されます。

注意事項

このコマンドは実行時に一時ファイルが作成されます。このため，バックアップファイルを格納するフォルダに十分な空き容量があることを確認してください。必要な空き容量は次のとおりです。

バックアップ対象ファイルの容量+20MB

このコマンドでリストアを実施する前に，JP1/Baseのリストアを実施してください。

このコマンドでは，次のファイルはリストアされません。必要に応じて手動で再設定してください。

https接続用のSSLサーバ証明書ファイル

https接続用の秘密鍵ファイル

公開鍵認証用の秘密鍵ファイル

作成したクラスタサービス制御コマンド（Linuxでクラスタ構成の場合）

https接続用のファイルはhttpsd.confファイル（Windowsの場合）またはuser_httpsd.confファイル（Linuxの場合），公開鍵認証用のファイルはプロパティファイル（config_user.peroperties）で定義されている，それぞれの格納先に配置してください。

autoオプションを指定しない場合，JP1/AOのサービスが停止していることを確認してからこのコマンドを実行してください。

停止していない場合は，hcmdssrvコマンドまたはhcmds64srvコマンドにstopオプションを指定して実行し，サービスを停止してください。

バックアップを取得したときに登録されていたJP1ユーザー名以外をjp1userオプションに指定した場合は，リストア後，［サービス共有プロパティ］ビューで「JP1ユーザー名」および「JP1ユーザーのパスワード」をコマンドに指定したJP1ユーザーに変更してください。

JP1/AOのインストールパスに半角スペースが含まれる場合，半角の直前までのパスと同名のパスのファイルやフォルダが存在すると，restoresystemコマンドの実行が戻り値114で失敗します。この現象が発生した場合は，該当ファイルまたはフォルダを別のパスに移動してください。その後，JP1/AOを再インストールし，restoresystemコマンドを再度実行してください。

（例）JP1/AOを"C:¥Program Files (x86)¥HITACHI¥JP1AO"にインストールしていて，"C:¥Program"のファイルまたはフォルダが存在した場合restoresystemコマンドの実行に失敗します。

リストアしたタスクおよびデバッグタスクは，次の操作を選択できません。

失敗したステップからリトライ

失敗した次のステップからリトライ

リストアしたタスクおよびデバッグタスクは，ステップの進捗や状態が表示されません。

戻り値

コマンドの戻り値を次の表に示します。

戻り値

説明

0

正常に終了しました。

1

引数が不正です。

2

コマンドの実行を中断しました。

3

サービスの状態が不正です。

4

ほかのコマンドを実行中です。

7

パスの指定が不正です。

9

指定したパスが存在しません。

10

指定したパスにアクセスできません。

14

コマンドの実行権限がありません。

110

リストアの実行に失敗しました。

111

サービスの開始/停止に失敗しました。

113

バックアップファイルが不正です。

114

スケジューラーデータベースへのアクセスエラーが発生しました。

116

指定したJP1ユーザーにタスク処理エンジンをセットアップする権限がありません。

255

そのほかのエラーでコマンドの実行が中断しました。

使用例

Windowsで，指定したバックアップフォルダのデータをリストアする場合のコマンドの使用例を示します。

restoresystem /dir C:¥Users¥Backup /jp1user JP1_AO_Admin /auto

関連トピック

8.7.1　backupsystem（JP1/AOシステムのバックアップ）

マニュアル「JP1/Base 運用ガイド」−「バックアップとリカバリー」のトピック

8.3　コマンドの引数に指定できる文字

マニュアル「JP1/AO 構築ガイド」−「プロパティファイル（config_user.properties）」のトピック

9　API

JP1/AOが提供するAPIについて説明します。APIとの通信には，httpプロトコルまたはhttpsプロトコルを使用できます。

9.1　API一覧

JP1/AOで使用できるAPIの一覧を次の表に示します。

表9‒1　サービス機能のAPI一覧

API名

機能

参照先

サービス一覧の取得

JP1/AOに登録されているサービスの一覧を取得します。

9.4.1　サービス一覧の取得

サービスの情報取得

指定したサービスの情報を取得します。

9.4.2　サービスの情報取得

サービスに対する操作一覧の取得

指定したサービスに対して実行できる操作の一覧を取得します。

9.4.3　サービスに対する操作一覧の取得

サービス実行に必要な情報の取得

指定したサービスの実行操作に必要な情報を取得します。

9.4.4　サービス実行に必要な情報の取得

サービスの実行

指定したサービスを実行します。

9.4.5　サービスの実行

表9‒2　スケジュール機能のAPI一覧

API名

機能

参照先

スケジュール一覧の取得

タスクに設定されているスケジュール一覧を取得します。

9.5.1　スケジュール一覧の取得

スケジュールの情報取得

指定したスケジュールの情報を取得します。

9.5.2　スケジュールの情報取得

スケジュールに対する操作一覧の取得

指定したスケジュールに対して実行できる操作の一覧を取得します。

9.5.3　スケジュールに対する操作一覧の取得

スケジュールのキャンセルに必要な情報の取得

指定したスケジュールをキャンセルするために必要な情報を取得します。

9.5.4　スケジュールのキャンセルに必要な情報の取得

スケジュールのキャンセル

指定したスケジュールをキャンセルします。

9.5.5　スケジュールのキャンセル

スケジュールの一時停止に必要な情報の取得

指定したスケジュールを一時停止するために必要な情報を取得します。

9.5.6　スケジュールの一時停止に必要な情報の取得

スケジュールの一時停止

指定したスケジュールを一時停止します。

9.5.7　スケジュールの一時停止

スケジュールの再開に必要な情報の取得

指定したスケジュールを再開するために必要な情報を取得します。

9.5.8　スケジュールの再開に必要な情報の取得

スケジュールの再開

指定したスケジュールを再開します。

9.5.9　スケジュールの再開

表9‒3　タスク機能のAPI一覧

API名

機能

参照先

タスク一覧の取得

タスクの一覧を取得します。

9.6.1　タスク一覧の取得

タスクの情報取得

指定したタスクの情報を取得します。

9.6.2　タスクの情報取得

タスク操作一覧の取得

指定したタスクに対して実行できる操作の一覧を取得します。

9.6.3　タスク操作一覧の取得

タスク実行停止に必要な情報の取得

指定したタスクを実行停止するために必要な情報を取得します。

9.6.4　タスク実行停止に必要な情報の取得

タスクの実行停止

指定したタスクを実行停止します。

9.6.5　タスクの実行停止

タスクの再実行に必要な情報の取得

指定したタスクを再実行するために必要な情報を取得します。

9.6.6　タスクの再実行に必要な情報の取得

タスクの再実行

指定したタスクを再実行します。

9.6.7　タスクの再実行

タスクのリトライに必要な情報の取得（失敗したステップからリトライ）

タスクを指定し，失敗したステップからリトライするために必要な情報を取得します。

9.6.8　タスクのリトライに必要な情報の取得（失敗したステップからリトライ）

失敗したステップからリトライ

タスクを指定し，失敗したステップからリトライします。

9.6.9　失敗したステップからリトライ

タスクのリトライに必要な情報の取得（失敗した次のステップからリトライ）

タスクを指定し，失敗した次のステップからリトライするために必要な情報を取得します。

9.6.10　タスクのリトライに必要な情報の取得（失敗した次のステップからリトライ）

失敗した次のステップからリトライ

タスクを指定し，失敗した次のステップからリトライします。

9.6.11　失敗した次のステップからリトライ

ステップの一覧取得

指定したタスクに含まれるステップのうち，［タスク詳細］ダイアログボックスに表示されるステップの一覧を取得します。

9.6.12　ステップの一覧取得

タスクログの取得

指定したタスクのタスクログを取得します。

9.6.13　タスクログの取得

表9‒4　プロパティ関連のAPI一覧

API名

機能

参照先

プロパティ定義一覧の取得

プロパティ定義の一覧を取得します。

9.7.1　プロパティ定義一覧の取得

プロパティ定義情報の取得

指定したプロパティ定義の情報を取得します。

9.7.2　プロパティ定義情報の取得

プロパティ定義に対する操作一覧の取得

指定したプロパティ定義に対して実行できる操作の一覧を取得します。

9.7.3　プロパティ定義に対する操作一覧の取得

プロパティ値一覧の取得

次に示す値の一覧を取得します。

サービス共有プロパティ

特定のサービスに関連するプロパティ

特定のスケジュールに関連するプロパティ

特定のタスクに関連するプロパティ

9.7.4　プロパティ値一覧の取得

プロパティ値の取得

指定したプロパティ値の情報を取得します。

9.7.5　プロパティ値の取得

プロパティ値に対する操作一覧の取得

指定したプロパティ値に対する操作の一覧を取得します。

9.7.6　プロパティ値に対する操作一覧の取得

表9‒5　情報管理のAPI一覧

API名

機能

参照先

ユーザー情報の取得

APIを実行したユーザーの情報を取得します。

9.8.1　ユーザー情報の取得

バージョン情報の取得

JP1/AOとAPIのバージョンを取得します。

9.8.2　バージョン情報の取得

9.2　API共通の仕様

各APIに共通する仕様を次に示します。なお，JP1/AOが提供しているAPIは，REST（Representational State Transfer）アーキテクチャスタイルに従います。

ここではJP1/AOに特有の仕様を記載しています。特に断り書きのない場合はHTTP1.1に準拠します。

なお，この節での「API」は，「JP1/AOが提供するAPI」を指します。また，APIを使用するポータルなどのユーザープログラムを総称して「APIクライアント」と表記します。

9.2.1　通信方式

APIが使用する通信プロトコルおよびポート番号について，次に示します。

通信プロトコル

APIでは，httpプロトコルおよびhttpsプロトコルをサポートしています。APIは，JP1/AOがWebブラウザーとの通信で使用するプロトコルを使用します。バージョンは，1.1をサポートしています。通信プロトコルの詳細な仕様については，次の規定を参照してください。

httpプロトコルの場合

RFC2616

httpsプロトコルの場合

RFC2818

ポート番号

ポート番号のデフォルトの設定は，通信プロトコルおよびJP1/AOサーバのOSによって異なります。

通信プロトコルがhttpの場合

Windows：23015

Linux：22015

通信プロトコルがhttpsの場合

Windows：23016

Linux：22016

なお，ポート番号を変更したい場合は，マニュアル「JP1/AO 構築ガイド」−「ポート番号を変更する手順」のトピックを参照してください。

9.2.2　セキュリティと認証

APIのリクエストを発行してレスポンスを取得するには，ユーザー認証を受ける必要があります。JP1/AOのAPIは，Basic認証（Basic Access Authentication）またはHSSOトークンによる認証を利用します。HSSOトークンは，シングルサインオンに必要なトークンです。HSSOトークンは，発行されて1,000秒でタイムアウトします。

ユーザー認証を受けるためには，使用する認証情報をリクエストヘッダーで指定してください。認証情報を指定する場合のリクエストヘッダーの指定例を次に示します。

指定例

Basic認証の場合

Authorization: Basic c3lzdGVtOm1hbmFnZXI=

HSSOトークンによる認証の場合

Authorization:HSSO 32bd25936120d68dceabcb49493079f8ef82a4_V0300

JP1/AOサーバは，権限のないリクエストが発行された場合，レスポンスとして，ステータスコード「401」を返却するとともに，ユーザー認証をリクエストします。

ポイント

Basic認証またはHSSOトークンによる認証でJP1/AOサーバに接続した場合，レスポンスヘッダーとして「WWW-Authenticate: HSSO hsso token」が返却されます。再度，同じセッションでJP1/AOに接続してAPIを発行したい場合は，リクエストヘッダーを次のとおりに指定してください。

Authorization:HSSO hsso token

9.2.3　入出力形式

APIのリクエストおよびレスポンスのデータ形式として，JSON形式またはXML形式を利用できます。データ形式は，リクエストヘッダーで指定してください。指定を省略すると，JSON形式が設定されます。入出力形式の文字コードは，UTF-8を使用します。

入出力形式をXML形式に指定する場合のリクエストヘッダーの指定例を次に示します。

指定例

Accept:application/xml
Content-Type:application/xml

9.2.4　ネームスペース

APIのリクエストおよびレスポンスのデータ形式がXML形式の場合は，次のネームスペースを使用します。

http://www.hitachi.com/products/it/software/xml/restfw/common/APIのバージョン

http://www.hitachi.com/products/it/software/xml/automation/APIのバージョン

9.2.5　リクエスト形式

APIでJP1/AOが提供する機能を利用するためのリクエスト形式を次に示します。

図9‒1　リクエスト形式（ドメインがobjectsの場合の例）

リクエスト形式の構成内容について，次の表で説明します。

表9‒6　リクエスト形式の構成内容

項目

説明

参照先

メソッド

リソースに対する操作を指定します。

9.2.7　サポートするメソッド

URL

APIのコレクション名

APIのコレクション※の名称です。固定値として「Automation」を指定します。

−　

APIのバージョン

使用するAPIのバージョンを指定します。

各APIの「APIのバージョン」を参照してください。

ドメイン名

実行するAPIの操作対象となるリソースのドメイン名を指定します。なお，このリクエスト形式に該当するのは，ドメインが「objects」の場合です。

9.2.8　APIで管理できるドメイン名とリソース

リソース

JP1/AOが提供する機能をAPIのリソースとして提供しています。実行したい処理に応じてリソースを指定します。

クエリパラメータ

リクエストに検索条件を付加することで，レスポンスの出力内容をフィルタリングしたり，ソートしたりすることができます。

9.2.9　クエリパラメータ

プロトコル

APIが使用する通信プロトコルとして「HTTP」を指定します。通信プロトコルにhttpsを使用する場合も，「HTTP」と指定してください。

9.2.1　通信方式

プロトコルのバージョン

APIが使用する通信プロトコルのバージョンとして「1.1」を指定します。

リクエストヘッダー

Host

ホストの情報を指定します。

9.2.10　リクエストヘッダー

Accept

レスポンスのデータ形式を指定します。

Accept-Language

レスポンスの言語コードを指定します。

User-Agent

APIクライアントのソフトウェア情報を指定します。

（凡例）

−：該当しません。

注※

コレクションとは，処理の対象となるデータを指します。

リクエスト形式の構成内容や詳細は，APIごとに異なるため，各APIの「リクエスト形式」を参照してください。

9.2.6　レスポンス形式

レスポンス形式を次に示します。

図9‒2　レスポンス形式

リクエストに対するレスポンス形式の構成内容について，次の表で説明します。

表9‒7　レスポンス形式の構成内容

項目

説明

参照先

ステータスライン

プロトコル

APIが使用する通信プロトコルが表示されます。

−　

プロトコルのバージョン

APIが使用する通信プロトコルのバージョンが表示されます。

−　

ステータスコード

リクエストの実行結果がステータスコードとして返却されます。

各APIの「ステータスコード」を参照してください。

APIを実行する前にエラーになった場合のステータスコードについては，「9.2.17　ステータスコード」のトピックを参照してください。

メッセージ

ステータスコードの内容が表示されます。

レスポンスヘッダー

Content-Type

リクエストヘッダーで指定された，レスポンスのデータ形式が返却されます。

9.2.13　レスポンスヘッダー

レスポンスボディー

リクエストヘッダーで指定されたデータ形式のスキーマが返却されます。

各APIの「レスポンスのスキーマ」を参照してください。

（凡例）

−：該当しません。

9.2.7　サポートするメソッド

APIでは，リソースに対する操作をメソッドとして定義します。

APIの処理に応じて，メソッドを指定してください。指定するメソッドについては，各APIの「リクエスト形式」を参照してください。

APIがサポートするメソッドを次の表に示します。

表9‒8　サポートするメソッド

メソッド

説明

GET

リソースの一覧や情報を取得します。

POST

リソースに応じてJP1/AOの処理を実行します。

9.2.8　APIで管理できるドメイン名とリソース

実行するAPIの操作対象となるリソースのドメイン名，およびJP1/AOがサポートするリソースを指定します。

なお，XML形式のリクエストおよびレスポンスのデータでは，ドメイン名がobjectsのリソースの名称は単数形になります。

APIで管理できるドメイン名とリソースの一覧を次の表に示します。

表9‒9　APIで管理できるドメイン名とリソース

ドメイン名

リソース

リソースの説明

objects

Services

JP1/AOに登録されているサービス

Schedules

タスクに設定されているスケジュール

Tasks

サービスを実行することで生成されたタスク

FlowSteps

タスクに含まれるステップ

TaskLogs

タスクログ

PropertyDefinitions

サービステンプレートのプロパティまたはサービス共有プロパティの定義

PropertyValues

サービス，スケジュール，タスクのプロパティ，サービス共有プロパティの値

user

UserInfo※

JP1/AOが認証したユーザーの情報

configuration

VersionInfo※

JP1/AOおよびAPIのバージョン情報

注※

このリソースは，リクエストには指定しません。レスポンスに含まれるリソースの名称です。リクエストの指定方法は，各APIのリクエスト形式を参照してください。

9.2.9　クエリパラメータ

クエリパラメータでは，リクエストに検索条件を付加することで，レスポンスの出力内容をフィルタリングしたり，ソートしたりすることができます。

JP1/AOがサポートするクエリパラメータを示します。

すべてのAPIで指定できるクエリパラメータ

次の表に示すクエリパラメータは，すべてのAPIに指定できます。

表9‒10　すべてのAPIで指定できるクエリパラメータ

パラメータ

説明

指定できる値

デフォルト値

alt

リクエストのContent-TypeヘッダーやAcceptヘッダーと同様に，入出力のデータ形式を指定できます。

xmlまたはjson

−　

（凡例）

−：該当しません。

一部のAPIで使用できるクエリパラメータ

次の表に示すクエリパラメータは，一部のAPI※で指定できます。

注※

サービス一覧の取得

スケジュール一覧の取得

タスク一覧の取得

ステップの一覧取得

タスクログの取得

プロパティ定義一覧の取得

プロパティ値一覧の取得

表9‒11　一部のAPIで指定できるクエリパラメータ

パラメータ

説明

指定できる値※1

デフォルト値

HQL::filter

指定した条件でフィルタリングします。

「9.2.11　HQL規格の使用」を参照してください。

−　

HQL::fields

レスポンスに含めるメンバーを絞り込むときに指定します。「,」区切りで複数指定できます。

メンバー名

−　

HQL::sortBy

指定されたメンバー名でソートします。

メンバー名 [{ASC| DESC}](, メンバー名 [{ASC| DESC}])

ASC：昇順

DESC：降順

ASC

HQL::offset※2

情報を取得する先頭オブジェクトの位置を指定します。レスポンスに含めるオブジェクトの最大数はHQL::countで指定します。HQL::offsetよりもpageが優先されます。

0〜2147483647

0

HQL::count※2

HQL::offsetに指定した先頭オブジェクトの位置を起点に，レスポンスに含めるオブジェクトの最大数を指定します。HQL::countよりもpageSizeが優先されます。なお，HQL::countとHQL::offsetの合計が2,147,483,647を超える場合，HQL::offsetに指定した値から2,147,483,647番目までのオブジェクトを取得します。

1〜2147483647

100

page※2

リソースを，ページ単位で分割する場合に，指定したページの情報を取得します。pageSizeを同時に指定する必要があります。HQL::offsetよりもpageが優先されます。

1〜2147483647

−　

pageSize※2

1ページに表示するオブジェクトの最大数を指定します。HQL::countよりもpageSizeが優先されます。

1〜2147483647

−　

（凡例）

−：該当しません。

注※1

URLとして表現できない文字列を値に指定したい場合は，UTF-8形式でURLエンコードしてください。

注※2

「タスクログの取得」および「ステップの一覧取得」のAPIでは指定できません。

pageSizeには1ページに表示するオブジェクトの最大数を指定し，pageには分割されたページのうちの何ページ目を表示するかを指定します。これは，例えばJP1/AOの画面にある「サービス一覧」の「ページ」や「1ページの行数」と概念は同じです。 pageおよびpageSizeを指定すると，Paginationオブジェクトに全リソース数とページ数が返却されます。この値によって次のページがあるかどうかを判断できます。

なお，pageおよびpageSizeは次の式のとおり，HQL::offsetの値に変換されて利用されます。

HQL::offset=pageSize*(page−1)

そのため，pageおよびpageSizeがHQL::offsetの範囲を超えた場合，ステータスコードは400のBad Requestが返却されます。

関連トピック

9.2.11　HQL規格の使用

9.2.10　リクエストヘッダー

リクエストヘッダーには，レスポンスのデータ形式およびレスポンスの言語コードなどを指定します。

表9‒12　リクエストヘッダー

ヘッダー

説明

指定できる値

デフォルト値

指定の要否

Host

ホストの情報として次の項目を指定します。

ホスト名またはIPアドレス：JP1/AOサーバのホスト名またはIPアドレスです。

ポート番号：APIがJP1/AOに接続する際に，利用するポート番号です。

ポート番号を指定する際は，「9.2.1　通信方式」を参照してください。

ユーザーの環境を確認して指定します。

−　

必須

Accept

レスポンスデータに指定したいデータ形式を指定します。

application/json：JSON形式

application/xml：XML形式

application/json

必須

Accept-Language

レスポンスデータに指定したい言語の言語コードを指定します。

ja：日本語

−　

必須

Content-Type

リクエストボディーのデータ形式を指定します。

application/json：JSON形式

application/xml：XML形式

application/json

任意

Authorization

認証情報を指定します。

Basic認証の場合

ユーザー情報

HSSOトークンによる認証の場合

hsso token

−　

任意

（凡例）

−：該当しません。

9.2.11　HQL規格の使用

HQL::filterにHQL（Hitachi Query Language）を指定して，対象となるデータをフィルタリングできます。コレクションとは，フィルタリングの対象となるデータを指します。

URLとして表現できない記号や文字は，UTF-8形式でURLエンコードしてください。

形式

リソースリクエストのコレクションを定義するには，次に示す式を使用してください。

expression ::= "(" expression ")" | binary-expression | expression junction expression
junction ::= ( "and" | "or" )

binary-expression ::= (compare-expression | tuple-expression)

compare-expression ::= name-expression compare-operation value-expression

name-expression ::= property-name | "[" property-name "]"
compare-operation ::= ( "eq" | "=" | "ne" | "<>" | "!=" | "gt" | ">" | "lt" | "<" | "ge" |">=" | "le" |"<=" | "starts" | "ends" )
value-expression ::= ( string-expression | number-expression | boolean-expression )

string-expression ::= "'" ([^'] | [']{2})* "'"
number-expression::= ( "0" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9" )+
boolean-expression::= "true" | "false" |"TRUE" | "FALSE"

tuple-expression ::= name-expression tuple-operation tuple-value-expression

tuple-value-expression ::= "[" value-expression ("," value-expression)* "]"

tuple-operation ::= ( "in" | "not in" )

「property-name」は，リソースに定義されているメンバー名です。

「value-expression」は，その式が文字列表現，数値表現，真理値表現のどれであるかを表示します。また，これはリソースに定義されているメンバーの実際のデータ型とは異なります。

データ型と表現形式との関係を次の表に示します。

表9‒13　データ型と表現形式との関係

データ型

表現形式

int/long

number-expression

enum

string-expression

string

string-expression

ISO8601String

string-expression

URLString

string-expression

boolean

boolean-expression

HQLでサポートする演算子を，優先される順に次の表に示します。

表9‒14　HQLでサポートする演算子

演算子

説明

指定できるデータ型

優先順位

eq

等しい。

number-expression，string-expression（string，enum）， boolean-expression

1

ne

等しくない。

number-expression，string-expression（string，enum）， boolean-expression

1

gt

より大きい。

number-expression，string-expression（string，enum）

1

lt

より小さい。

number-expression，string-expression（string，enum）

1

ge

以上。

number-expression，string-expression（string，enum）

1

le

以下。

number-expression，string-expression（string，enum）

1

starts※

開始値。

string-expression（ISO8601Stringを除くstring）

1

ends※

終了値。

string-expression（ISO8601Stringを除くstring）

1

in

含まれる。

number-expression，string-expression（string，enum）， boolean-expression

1

not in

含まれない。

number-expression，string-expression（string，enum）， boolean-expression

1

and

どちらもtrueである。

compare-expression，tuple-expression

2

or

どちらかがtrueである。

compare-expression，tuple-expression

3

注※

大文字と小文字は区別されません。

使用例

指定した列のフィルタリングをする例を次に示します。URLとして表現できない文字列を値に指定したい場合は，UTF-8形式でURLエンコードしてください。

URLエンコード前

...?HQL::filter=instanceID in [1000,1001,1002] and status = 'running'

URLエンコード後

...?HQL::filter=instanceID%20in%20%5b1000%2c1001%2c1002%5d%20and%20status%20%3d%20%27running%27

9.2.12　ドメインオブジェクトの形式

ドメインとは，JP1/AOがサポートするリソースが格納されている場所を指します。ドメインオブジェクトとは，リソースを指します。ここでは，リソースが持つメンバーのデータ形式について説明します。

サポートするデータ型

JSON形式およびXML形式でサポートするデータ型を次の表に示します。

表9‒15　サポートするデータ型

型名

説明

boolean

trueまたはfalse

int

32bit符号付き整数

long

64bit符号付き整数

string※

テキストデータ

注※

ISO8601String，URLStringおよびenumは，string型の拡張表現です。

日付と時間

ドメインオブジェクトでの日付と時間の指定方法を説明します。

日付と時間は，ISO8601フォーマットを使用して指定してください。フォーマットでは，「年（yyyy）」以外のすべての情報を省略できます。日付または時間が省略された場合，指定可能な最小値が自動的に追加されます。タイムゾーンが省略された場合，デフォルトでは，JP1/AOサーバに設定されたタイムゾーンが設定されます。

ただし，HQL::filterを使用して日付と時間を指定する場合，日付と時間は省略できません。また，JSON形式で時間情報を取得する場合，タイムゾーン情報の「:」が表記されていない時間（例：2014-12-09T18:50:30.500+0900）が出力されます。JSON形式で取得した時間情報を，そのままAPIの入力に指定する場合には，タイムゾーンに「:」を追加してください（例：2014-12-09T18:50:30.500+09:00）。「:」を追加しない場合，エラーになります。

なお，リソースのメンバーのデータ型が「ISO8601String」である場合，年月日，時刻，タイムゾーンは，「yyyy-mmddThh:mm:ss.mmmTZD」の形式でレスポンスボディーに表示されます。

表9‒16　年月日，時刻，タイムゾーンの形式

フォーマット

指定例

JP1/AOで処理する時間

yyyy-mm-ddThh:mm:ss.mmmTZD

2014-12-09T18:50:30.500+09:00

指定例と同じ

yyyy-mm-ddThh:mm:ss.mmm

2014-12-09T18:50:30.500.000

2014-12-09T18:50:30.500.000[ホストサーバのタイムゾーン]

yyyy-mm-ddThh:mm:ssTZD

2014-12-09T18:50:30+09:00

2014-12-09T18:50:30.000+09:00

yyyy-mm-ddThh:mmTZD

2014-12-09T18:50+09:00

2014-12-09T18:50:00.000+09:00

yyyy-mm-ddThhTZD

2014-12-09T18+09:00

2014-12-09T18:00:00.000+09:00

yyyy-mm-dd

2014-12-09

2014-12-09T00:00:00.000[ホストサーバのタイムゾーン]

yyyy-mm

2014-12

2014-12-01T00:00:00.000[ホストサーバのタイムゾーン]

yyyy

2014

2014-01-01T00:00:00.000[ホストサーバのタイムゾーン]

9.2.13　レスポンスヘッダー

JP1/AOで制御しているレスポンスヘッダーを次の表に示します。

表9‒17　レスポンスヘッダー

ヘッダー

説明

Cache-Control

GETメソッドを指定したAPIのレスポンス情報をキャッシュ制御します。

Content-Type

レスポンスデータのデータ形式です。

Language

レスポンスデータの言語コードです。

WWW-Authenticate

認証されたHSSOトークンを出力します。

Warning

APIの処理は成功したがサーバの状態に問題がある場合に，情報を表示します。

関連トピック

9.2.10　リクエストヘッダー

9.2.14　リソースのメンバー

JP1/AOが提供する機能をリソースとして分類します。レスポンスボディーで，リソースの情報をメンバーとして取得できます。返却されるリソースのメンバー名，データ型，説明およびHQL::filterとHQL::sortByに適応するかどうかを，機能ごとの表に示します。

なお，JP1/AO 10-50では，サポート対象外のメンバーが返却される場合があります。サポート対象はこの表に記載されているメンバーだけとなります。

年月日の指定方法について特に断り書きがない場合は，「表9‒16　年月日，時刻，タイムゾーンの形式」を参照して指定してください。

表9‒18　「サービス一覧の取得」で取得できるメンバー（リソース（Services））

メンバー名

データ型

説明

HQL::filterまたはHQL::sortByの適応

data

Object

リソースの一覧

×　

instanceID

long

インスタンスID

○　

name

string

サービス名

○　

description

string

サービスの説明

○　

tags

string

カテゴリの情報がカテゴリ単位で「,」区切りで表示される

×　

serviceTemplateName

string

サービスの元になるサービステンプレートの名称

○　

createTime

ISO8601String

サービスの追加年月日，時刻，タイムゾーン

○　

modifyTime

ISO8601String

サービス情報の更新年月日，時刻，タイムゾーン

○　

serviceState

enum

サービスの種類

debug：デバッグ

release：リリース

○　

serviceGroupName

string

サービスが属するリソースグループの名称

○　

pagination

Object

リソースをページ単位で分割する場合の情報

×　

page

integer

リクエストで指定したpage（ページ番号）

×　

pageSize

integer

リクエストで指定したpageSize（ページに含まれるオブジェクトの最大数）

×　

numPages

integer

page（ページ番号）の総数

×　

totalCount

integer

返却されるリソースの総数

×　

count

integer

クエリパラメータの条件に合致したデータの個数（0〜n）

×　

（凡例）

○：適応します。　×：適応しません。

表9‒19　「スケジュール一覧の取得」で取得できるメンバー（リソース（Schedules））

メンバー名

データ型

説明

HQL::filterまたはHQL::sortByの適応

data

Object

リソースの一覧

×　

instanceID

long

インスタンスID

○　

name

string

サービスの実行時に指定したタスク名

○　

submitter

string

実行ユーザー名

○　

status

enum

定期実行のスケジュールの状態

complete：定期実行が完了したスケジュール。実行されない状態である。

running：定期実行中のスケジュール。定期的に実行される状態である。

○　

scheduleType

enum

スケジュールの種別

immediate：即時実行

schedule：指定日時実行

recurrence：定期実行

○　

createTime

ISO8601String

サービスを実行して，スケジュールが作成された年月日，時刻，タイムゾーン

○　

modifyTime

ISO8601String

タスク情報の更新年月日，時刻，タイムゾーン

○　

description

string

タスクの説明

○　

scheduledStartTime

ISO8601String

指定日時実行タスクの開始予定年月日，時刻，タイムゾーン

○　　※

recurrenceInterval

enum

定期実行周期

daily：毎日

weekly：毎週

monthly：毎月

○　

recurrenceDayOfWeek

string

定期実行周期が毎週の場合に，サービスを実行する曜日（1:日曜〜7:土曜）

×　

recurrenceDayOfMonth

string

定期実行周期が毎月の場合に，サービスを実行する日（1〜31日）

×　

recurrenceLastDayOfMonth

boolean

月の最終日に実行するかどうか

true：実行する

false：実行しない

○　

recurrenceStartDate

string

定期実行タスクの実行開始日（yyyy-mm-dd）

○　

recurrenceTime

string

定期実行タスクの実行時刻（hh:mm:ss）

○　

serviceState

enum

サービスの種類

debug：デバッグ

release：リリース

○　

serviceID

long

スケジュールの生成元となるサービスのID

○　

pagination

Object

リソースをページ単位で分割する場合の情報

×　

page

integer

リクエストで指定したpage（ページ番号）

×　

pageSize

integer

リクエストで指定したpageSize（ページに含まれるオブジェクトの最大数）

×　

numPages

integer

page（ページ番号）の総数

×　

totalCount

integer

返却されるリソースの総数

×　

count

integer

クエリパラメータの条件に合致したデータの個数（0〜n）

×　

（凡例）

○：適応します。　×：適応しません。

注※

HQL::sortByは適応しません。

表9‒20　「タスク一覧の取得」で取得できるメンバー（リソース（Tasks））

メンバー名

データ型

説明

HQL::filterまたはHQL::sortByの適応

data

Object

リソースの一覧

×　

instanceID

long

インスタンスID

○　

name

string

タスク名

○　

status

enum

タスクの状態

failed：失敗

completed：正常終了

canceled：キャンセル

inProgressTerminating：停止中

inProgressWithError：異常検出

waitingForInput：応答待ち中

inProgress：実行中

suspended：保留中

waiting：待機中

○　

startTime

ISO8601String

タスクの開始年月日，時刻，タイムゾーン

○　

completionTime

ISO8601String

タスクの終了年月日，時刻，タイムゾーン

○　

scheduledStartTime

ISO8601String

指定日時実行タスクの開始予定年月日，時刻，タイムゾーン

○　

submitter

string

実行ユーザー名

○　

submitTime

ISO8601String

サービス実行によってタスクが生成された年月日，時刻，タイムゾーン

○　

modifyTime

ISO8601String

タスク情報の更新年月日，時刻，タイムゾーン

○　

serviceState

enum

タスクの種類

debug：デバッグ

release：リリース

○　

scheduleID

long

タスクに設定されているスケジュールの定義のID

○　

serviceID

long

タスクの生成元となるサービスのID

○　

pagination

Object

リソースをページ単位で分割する場合の情報

×　

page

integer

リクエストで指定したpage（ページ番号）

×　

pageSize

integer

リクエストで指定したpageSize（ページに含まれるオブジェクトの最大数）

×　

numPages

integer

page（ページ番号）の総数

×　

totalCount

integer

返却されるリソースの総数

×　

count

integer

クエリパラメータの条件に合致したデータの個数（0〜n）

×　

（凡例）

○：適応します。　×：適応しません。

表9‒21　「ステップの一覧取得」で取得できるメンバー（リソース（FlowSteps））

メンバー名

データ型

説明

HQL::filterまたはHQL::sortByの適応

data

Object

リソースの一覧

×　

name

string

ステップ名

×　

startTime

string

ステップの開始年月日と時刻（yyyy-MM-dd hh:mm:ss）

×　

completionTime

string

ステップの終了年月日と時刻（yyyy-MM-dd hh:mm:ss）

×　

jobStatus

enum

ステップの状態（タスク処理エンジン）

noplan：未計画

unexec：未実行終了

bypass：計画未実行

shutdown：閉塞

termwait：先行終了待ち

execwait：実行待ち

queuing：キューイング

holding：保留中

running：実行中

abnormal：異常検出終了

kill：強制終了

fail：起動失敗

job_unknown：終了状態不明（UNKNOWNをJOB_UNKNOWNに変更）

warning：警告検出終了

normal：正常終了

normalfalse：正常終了−偽

monitorintrpt：監視中断

×　

comment

string

ステップのコメント

×　

stepStatus

enum

ステップの状態（JP1/AO）

normal：正常

warning：警告

waiting：待機中

holding：保留中

break：中断中

break_after：中断中（実行後）

running：実行中

waiting_for_response：応答待ち中

abnormal_continue：異常検出

complete：正常終了

error：失敗

abnormal：警告終了

un_exec：未実行終了

bypass：分岐未実行

terminate：停止

waiting_for_foreach：繰り返し実行待ち

×　

pagination

Object

リソースをページ単位で分割する場合の情報

×　

page

integer

リクエストで指定したpage（ページ番号）

×　

pageSize

integer

リクエストで指定したpageSize（ページに含まれるオブジェクトの最大数）

×　

numPages

integer

page（ページ番号）の総数

×　

totalCount

integer

返却されるリソースの総数

×　

count

integer

クエリパラメータの条件に合致したデータの個数（0〜n）

×　

（凡例）

×：適応しません。

表9‒22　「タスクログの取得」で取得できるメンバー（リソース（Tasklogs））

メンバー名

データ型

説明

HQL::filterまたはHQL::sortByの適応

data

Object

リソースの一覧

×　

instanceID

long

インスタンスID

×　

text

string

タスクログの本文

×　

totalSize

long

タスクログの総ファイルサイズ（単位：バイト）

×　

readSize

long

取得したタスクログのサイズ（単位：バイト）

×　

lineCount

long

取得したタスクログの行数

×　

offset

long

取得時に指定したオフセット（単位：バイト）

×　

reverse

boolean

タスクログをオフセットから逆方向に取得したか

true：逆方向に取得した

false：正方向に取得した

×　

pagination

Object

リソースをページ単位で分割する場合の情報

×　

page

integer

リクエストで指定したpage（ページ番号）

×　

pageSize

integer

リクエストで指定したpageSize（（ページに含まれるオブジェクトの最大数））

×　

numPages

integer

page（ページ番号）の総数

×　

totalCount

integer

返却されるリソースの総数

×　

count

integer

クエリパラメータの条件に合致したデータの個数（0〜n）

×　

（凡例）

×：適応しません。

表9‒23　「プロパティ定義一覧の取得」で取得できるメンバー（リソース（PropertyDefinitions））

メンバー名

データ型

説明

HQL::filterまたはHQL::sortByの適応

data

Object

リソースの一覧

×　

instanceID

long

インスタンスID

○　

keyName

string

プロパティキー名

○　

displayName

string

プロパティの表示名

×　

defaultValue

string

プロパティのデフォルト値

○　

type

enum

プロパティのデータ型

boolean

integer

string

double

timestamp(date)

password

list

○　

visibility

enum

プロパティの可視性

config

exec

○　

scope

enum

プロパティの有効範囲

share：サービス共有プロパティ

local：そのサービスだけに有効なプロパティ

○　

description

string

プロパティの説明

×　

mode

enum

プロパティの入出力種別

in：入力プロパティ

out：出力プロパティ

○　

required

boolean

実行時にプロパティが指定必須かどうか

true：指定必須

false：省略できる

○　

maxLength

int

プロパティに入力できる文字列の最大長

○　

minLength

int

プロパティに入力できる文字列の最小長

○　

minValue

string

プロパティに入力できる数値の最小値

○　

maxValue

string

プロパティに入力できる数値の最大値

○　

pattern

string

stringまたはpasswordのプロパティに指定できる文字列の正規表現パターン

○　

valueList

string

プロパティのデータ型がlistの場合に，プロパティ値の候補を「,」区切りで表現したもの

○　

propertyGroupName

string

プロパティグループ名

○　

pagination

Object

リソースをページ単位で分割する場合の情報

×　

page

integer

リクエストで指定したpage（ページ番号）

×　

pageSize

integer

リクエストで指定したpageSize（ページに含まれるオブジェクトの最大数）

×　

numPages

integer

page（ページ番号）の総数

×　

totalCount

integer

返却されるリソースの総数

×　

count

integer

クエリパラメータの条件に合致したデータの個数（0〜n）

×　

（凡例）

○：適応します。　×：適応しません。

表9‒24　「プロパティ値一覧の取得」で取得できるメンバー（リソース（PropertyValues））

メンバー名

データ型

説明

HQL::filterまたはHQL::sortByの適応

data

Object

リソースの一覧

×　

instanceID

long

インスタンスID

○　

type

enum

プロパティのデータ型

boolean

integer

string

double

timestamp(date)

password

list

○　

keyName

string

プロパティキー名

○　

value

string

プロパティの値

○　

serviceID

long

リソースのサービスID

○　

scheduleID

long

リソースのスケジュールID

○　

taskID

long

リソースのタスクID

○　

pagination

Object

リソースをページ単位で分割する場合の情報

×　

page

integer

リクエストで指定したpage（ページ番号）

×　

pageSize

integer

リクエストで指定したpageSize（ページに含まれるオブジェクトの最大数）

×　

numPages

integer

page（ページ番号）の総数

×　

totalCount

integer

返却されるリソースの総数

×　

count

integer

クエリパラメータの条件に合致したデータの個数（0〜n）

×　

（凡例）

○：適応します。　×：適応しません。

表9‒25　情報管理機能のリソース（UserInfo）のメンバー

メンバー名

データ型

説明

HQL::filterまたはHQL::sortByの適応

userName

string

ユーザー名

×　

accessPermission

string

ユーザーに与えられえたアクセス権限

×　

resourceGroup

ResourceGroup

ユーザーに与えられえた，リソースグループ別のアクセス権限

×　

（凡例）

×：適応しません。

表9‒26　情報管理機能のリソース（VersionInfo）のメンバー

メンバー名

データ型

説明

HQL::filterまたはHQL::sortByの適応

productName

string

製品名（JP1/Automatic Operation）

×　

productVersion

string

製品のバージョン

×　

apiVersionl

string

APIのバージョン

×　

（凡例）

×：適応しません。

9.2.15　JP1/AOを操作するAPIで返却されるメンバー

JP1/AOが提供するAPIのうち，JP1/AOの操作を実行するものがあります。該当するAPIと，返却されるメンバーを次に示します。なお，リクエストについては，各APIのリクエスト形式を参照してください。

JP1/AOを操作するAPI

サービスの実行

スケジュールのキャンセル

スケジュールの一時停止

スケジュールの再開

タスクの実行停止

タスクの再実行

失敗したステップからリトライ

失敗した次のステップからリトライ

表9‒27　JP1/AOを操作するAPIで返却されるメンバー

メンバー名

データ型

説明

instanceID

string

インスタンスIDを示します。

created

string

オブジェクトの生成日時を示します。ISO8601形式です。

updated

string

非同期処理の場合に，このオブジェクトが更新された時刻を示します。同期処理の場合は「created」と同時刻を示します。ISO8601形式です。

completed

string

非同期処理の場合に，処理が完了した時刻を示します。同期処理の場合は「created」と同時刻を示します。ISO8601形式です。

state

string

queued：操作が処理を開始していません。この状態では，停止処理だけを受け付けます。

running：操作が実行中です。この状態では，停止処理だけを受け付けます。

failed：操作が失敗しました。

success：操作が正常終了しました。

stopping：操作が停止の処理中です。

stopped：操作が完了する前に停止されました。

affectedResource

string

操作の結果，作成または更新されたAPIのリソースのURLを示します。

9.2.16　実行できる操作を取得するAPIで返却されるメンバー

JP1/AOが提供するAPIのうち，リソースに対して実行できる操作，およびその実行先URLを取得するものがあります。該当するAPIと，返却されるメンバーを次に示します。なお，リクエストについては，各APIのリクエスト形式を参照してください。

実行できる操作を取得するAPI

サービスに対する操作一覧の取得

サービス実行に必要な情報の取得

スケジュールに対する操作一覧の取得

スケジュールのキャンセルに必要な情報の取得

スケジュールの一時停止に必要な情報の取得

スケジュールの再開に必要な情報の取得

タスク操作一覧の取得

タスク実行停止に必要な情報の取得

タスクの再実行に必要な情報の取得

タスクのリトライに必要な情報の取得（失敗したステップからリトライ）

タスクのリトライに必要な情報の取得（失敗した次のステップからリトライ）

表9‒28　実行できる操作を取得するAPIで返却されるメンバー

メンバー名

データ型

説明

name

string

操作名です。

href

string

操作の実行先URLです。

method

string

メソッド名です。

GET

POST

parameters

Object

操作実行時に必要なパラメータです。

9.2.17　ステータスコード

APIの実行時に返却されるステータスコードの一覧を示します。なお，返却されるステータスコードは，APIごとに異なるため，詳細は各APIを参照してください。

表9‒29　ステータスコード

ステータスコード

メッセージ

説明

200

OK

リクエストの処理に成功しました。

201

Created

リソースの作成に成功した場合，ステータス200の代わりにステータス201が返却されます。

400

Bad Request

リクエスト内容が不正です。

401

Unauthorized

認証に失敗しています。認証情報または許可情報が不正です。受理された認証方法は，レスポンスヘッダー「WWW-Authenticate」で通知します。受理された認証方法を，リクエストヘッダー「Authorization」に指定してください。または，リソースグループに対する権限かUser Management権限がありません。

403

Forbidden

リクエストの実行権限がありません。

404

Not found

リクエストされたリソースまたはリソースに対する操作がありません。または，クエリパラメータの指定が不正です。

405

Method not allowed

リクエストされたメソッドは，このリソースにはありません。

406

Not acceptable

指定されたレスポンスのフォーマット形式はサポートされていません。

409

Conflict

サーバ上にすでに存在しているデータと競合しているため，または，リクエストを受理できない状態のため，リクエストを完了できません。

412

Precondition failed

前提条件を満たしていないため，リクエストを受け付けられません。

415

Unsupported media type

指定されたリクエストのフォーマット形式はサポートされていません。

500

Server-side error

サーバ処理エラーが発生しました。

関連トピック

9.2.18　エラー情報

9.2.18　エラー情報

APIのリクエストがエラーになった場合について説明します。APIのリクエストがエラーになった場合，レスポンス情報として，次の表に示すスキーマが返却されます。なお，次の表に示すスキーマ以外のエラー情報については，マニュアル「JP1/AO メッセージ」を参照してください。

エラー情報のスキーマを，次の表に示します。

表9‒30　エラー情報のスキーマ

メンバー名

データ型

説明

errorSource

string

エラーが発生したAPIです。

message

string

エラーのメッセージ内容です。

messageID

string

メッセージIDです。リクエストの際にXMLの記載を誤るなどの理由でエラーが発生した場合は，メッセージIDが"generic error"になります。

application

string

エラーが発生したAPIを保持するアプリケーション情報（Automation）です。

messageData

string

エラーの詳細情報です。

出力例

エラー情報のmessageIDとして，KNAE02102-Eが出力される場合の例を次に示します。

{
  "errorSource" : "http://10.196.184.238:22015/Automation/v1/objects/Tasks/555",
  "message" : "The specified resource does not exist or you do not have access. After reviewing the content of the following, please re-run.¥n- The presence or absence of resources¥n- Access rights to the resource",
  "messageID" : "KNAE02102-E",
  "application" : "Automation"
}

9.3　APIの記述形式

各APIで説明する項目を次に示します。ただし，APIによっては説明のない項目もあります。

機能

APIの機能について説明します。

実行権限

APIを実行できる権限およびロールを示します。

APIのバージョン

APIのバージョンを示します。

リクエスト形式

APIを使用する際のリクエスト形式について説明しています。

ステータスコード

httpプロトコルまたはhttpsプロトコルを使用してAPIを実行したあとのステータスコードについて説明します。APIを実行する前にエラーになった場合のステータスコードについては，「9.2.17　ステータスコード」のトピックを参照してください。

レスポンスのスキーマ

APIが正常終了したときに返却するレスポンスのスキーマ情報について説明します。

使用例

APIを使用するためのリクエスト例およびレスポンス例について説明します。

ただし，ここでは，httpプロトコルを使用している場合の例を記載します。httpsプロトコルを使用する場合は，「HTTP」を「HTTPS」に読み替えてください。

9.4　サービス関連のAPI

サービスリソースを管理するための操作を説明します。

9.4.1　サービス一覧の取得

機能

JP1/AOに登録されているサービスの一覧を取得します。

実行権限

Adminロール，Developロール，Modifyロール，Submitロール

APIのバージョン

v1

リクエスト形式

GET http://host:port/Automation/version/objects/Services

APIの実行ユーザーが権限を持つ，すべてのサービスを対象として一覧を取得します。

ステータスコード

リクエストに対するレスポンスとして返却されるステータスコードを，次の表に示します。

ステータスコード

メッセージ

説明

200

OK

成功しました。

400

Bad Request

クエリパラメータが不正です。

401

Unauthorized

ログイン権限がありません。

412

Precondition failed

サーバが利用できません。

500

Server-side error

サーバ処理エラーが発生しました。

レスポンスのスキーマ

レスポンスボディーには，リクエストで指定したクエリパラメータの条件に合致したデータが返却されます。レスポンスボディーのスキーマを次に示します。

{
  "data" : [ {"サービス機能のリソース（Services）のメンバー" : 値 ... }, ... ],
  "count" : クエリパラメータの条件に合致したデータの個数（0〜n）
}

使用例

すべてのサービスを対象として，サービス一覧を取得する場合の使用例を示します。

リクエストヘッダー:
GET /Automation/v1/objects/Services HTTP/1.1
Host:10.196.184.238:22015
Accept:application/json
Accept-Language: ja
Authorization: Basic c3lzdGVtOm1hbmFnZXI=
User-Agent: useragent1

レスポンスヘッダー:

HTTP/1.1 200 OK
Date: Mon, 14 Jul 2014 11:36:42 GMT
Server: Cosminexus HTTP Server
Access-Control-Expose-Headers: WWW-Authenticate
WWW-Authenticate: HSSO ed355b6e59f72c675dca1498e951439e8aa0d8_V0300
Access-Control-Allow-Origin: *
Access-Control-Allow-Methods: GET, POST, DELETE, PUT, HEAD, OPTIONS
Access-Control-Allow-Credentials: true
Cache-Control: no-cache
Transfer-Encoding: chunked
Content-Type: application/json

レスポンスボディー:
{
  "data" : [ {
    "instanceID" : 2015,
    "name" : "testService1",
    "description" : "description",
    "tags" : "",
    "serviceTemplateName" : "testService",
    "createTime" : "2014-07-14T01:16:11.000-0700",
    "modifyTime" : "2014-07-14T04:36:30.000-0700",
    "serviceState" : "release",
    "serviceGroupName" : "Default Service Group",
    "serviceGroupID" : 3
  }, {
    "instanceID" : 2020,
    "name" : "testService2",
    "description" : "description",
    "tags" : "",
    "serviceTemplateName" : "testService",
    "createTime" : "2014-07-14T01:16:39.000-0700",
    "modifyTime" : "2014-07-14T04:36:33.000-0700",
    "serviceState" : "release",
    "serviceGroupName" : "Default Service Group",
    "serviceTemplateID" : 2008,
    "serviceGroupID" : 3
  } ],
  "count" : 2
}

関連トピック

9.2.14　リソースのメンバー

9.4.2　サービスの情報取得

機能

指定したサービスに関する情報を取得します。

実行権限

Adminロール，Developロール，Modifyロール，Submitロール

APIのバージョン

v1

リクエスト形式

GET http://host:port/Automation/version/objects/Services/id

ステータスコード

リクエストに対するレスポンスとして返却されるステータスコードを，次の表に示します。

ステータスコード

メッセージ

説明

200

OK

成功しました。

401

Unauthorized

ログイン権限がありません。

404

Not found

権限が不正です。または，リソースがありません。

412

Precondition failed

サーバが利用できません。

500

Server-side error

サーバ処理エラーが発生しました。

レスポンスのスキーマ

リクエストに対するレスポンスボディーの構造を次に示します。

{
  "instanceID" : instance-id,
  "name" : "service-display-name",
  "description" : "description-text",
  "tags" : "category-information",
  "serviceTemplateName" : "service-template-name",
  "createTime" : "created-date-and-time",
  "modifyTime" : "updated-date-and-time",
  "serviceState" : "service-state",
  "serviceGroupName" : "resource-group-name",
  "serviceGroupID" : service-group-id
}

使用例

instanceID=2015のサービスに関する情報を取得する場合の使用例を示します。

リクエストヘッダー:

GET /Automation/v1/objects/Services/2015 HTTP/1.1
Host:10.196.184.238:22015
Accept:application/json
Accept-Language: ja
Authorization: Basic c3lzdGVtOm1hbmFnZXI=
User-Agent: useragent1

レスポンスヘッダー:

HTTP/1.1 200 OK
Date: Mon, 14 Jul 2014 11:40:06 GMT
Server: Cosminexus HTTP Server
Access-Control-Expose-Headers: WWW-Authenticate
WWW-Authenticate: HSSO e894c54236919ffb39e71d4b9577345ce8599a_V0300
Access-Control-Allow-Origin: *
Access-Control-Allow-Methods: GET, POST, DELETE, PUT, HEAD, OPTIONS
Access-Control-Allow-Credentials: true
Cache-Control: no-cache
Transfer-Encoding: chunked
Content-Type: application/json

レスポンスボディー:

{
  "instanceID" : 2015,
  "name" : "testService1",
  "description" : "description",
  "tags" : "",
  "serviceTemplateName" : "testService",
  "createTime" : "2014-07-14T01:16:11.000-0700",
  "modifyTime" : "2014-07-14T04:36:30.000-0700",
  "serviceState" : "release",
  "serviceGroupName" : "Default Service Group",
  "serviceGroupID" : 3
}

9.4.3　サービスに対する操作一覧の取得

機能

指定したサービスに対して実行できる操作の一覧を取得します。

実行権限

Adminロール，Developロール，Modifyロール，Submitロール

APIのバージョン

v1

リクエスト形式

GET http://host:port/Automation/version/objects/Services/id/actions

ステータスコード

リクエストに対するレスポンスとして返却されるステータスコードを，次の表に示します。

ステータスコード

メッセージ

説明

200

OK

成功しました。

401

Unauthorized

ログイン権限がありません。

412

Precondition failed

サーバが利用できません。

500

Server-side error

サーバ処理エラーが発生しました。

レスポンスのスキーマ

リクエストに対するレスポンスボディーの構造を次に示します。

{
  "data" : [ {
    "name" : "submit",
    "href" : "http://host:port/Automation/version/objects/Services/id/actions/submit/invoke",
    "method" : "POST",
    "parameters" : null
  } ],
  "count" : count
}

使用例

instanceID=2015のサービスリソースに対して，実行できる操作の一覧を取得する場合の使用例を示します。

リクエストヘッダー:

GET /Automation/v1/objects/Services/2015/actions HTTP/1.1
Host:10.196.184.238:22015
Accept:application/json
Accept-Language: ja
Authorization: Basic c3lzdGVtOm1hbmFnZXI=
User-Agent: useragent1

レスポンスヘッダー:

HTTP/1.1 200 OK
Date: Mon, 14 Jul 2014 11:41:09 GMT
Server: Cosminexus HTTP Server
Access-Control-Expose-Headers: WWW-Authenticate
WWW-Authenticate: HSSO f12ac2d0d54a5ba48563df84b33f49e3181afea4_V0300
Access-Control-Allow-Origin: *
Access-Control-Allow-Methods: GET, POST, DELETE, PUT, HEAD, OPTIONS
Access-Control-Allow-Credentials: true
Cache-Control: no-cache
Transfer-Encoding: chunked
Content-Type: application/json

レスポンスボディー:

{
  "data" : [ {
    "name" : "submit",
    "href" : "http://10.196.184.238:22015/Automation/v1/objects/Services/2015/actions/submit/invoke",
    "method" : "POST",
    "parameters" : [ ]
  }, ],
  "count" : 1
}

関連トピック

9.2.14　リソースのメンバー

9.4.4　サービス実行に必要な情報の取得

機能

指定したサービスの実行操作に必要な情報を取得します。

実行権限

Adminロール，Developロール，Modifyロール，Submitロール

APIのバージョン

v1

リクエスト形式

GET http://host:port/Automation/version/objects/Services/id/actions/submit

ステータスコード

リクエストに対するレスポンスとして返却されるステータスコードを，次の表に示します。

ステータスコード

メッセージ

説明

200

OK

成功しました。

401

Unauthorized

ログイン権限がありません。

404

Not found

サービスを取得する権限がありません。または，サービスがありません。

412

Precondition failed

サーバが利用できません。

500

Server-side error

サーバ処理エラーが発生しました。

レスポンスのスキーマ

リクエストに対するレスポンスボディーの構造を次に示します。

{
  "name" : "submit",
  "href" : "http://host:port/Automation/version/objects/Services/id/actions/submit/invoke",
  "method" : "POST",
  "parameters" : [ {...} ]
}

「parameters」のメンバーとして出力されるオブジェクトを，次の表で説明します。

表9‒31　「parameters」のメンバーとして出力されるオブジェクト（サービス実行に必要な情報の取得）

機能

リソース名称

数

説明

スケジュール

Schedule

1

サービスの実行予定

プロパティ値の一覧

PropertyValue

0〜n

サービスの入力プロパティ

使用例

instanceID=2015のサービスを実行する準備として，必要なテンプレート情報を取得する場合の使用例を示します。

リクエストヘッダー:

GET /Automation/v1/objects/Services/2015/actions/submit HTTP/1.1
Host:10.196.184.238:22015
Accept:application/json
Accept-Language: ja
Authorization: Basic c3lzdGVtOm1hbmFnZXI=
User-Agent: useragent1

レスポンスヘッダー:

HTTP/1.1 200 OK
Date: Mon, 14 Jul 2014 11:44:25 GMT
Server: Cosminexus HTTP Server
Access-Control-Expose-Headers: WWW-Authenticate
WWW-Authenticate: HSSO 717c09f57f33957cd1e6f8d4207e6853b05eac_V0300
Access-Control-Allow-Origin: *
Access-Control-Allow-Methods: GET, POST, DELETE, PUT, HEAD, OPTIONS
Access-Control-Allow-Credentials: true
Cache-Control: no-cache
Transfer-Encoding: chunked
Content-Type: application/json

レスポンスボディー:

{
  "name" : "submit",
  "href" : "http://10.196.184.238:22015/Automation/v1/objects/Services/2015/actions/submit/invoke",
  "method" : "POST",
  "parameters" : [ {
    "name" : "testService1_20140714044426",
    "submitter" : "System",
    "scheduleType" : "immediate",
    "description" : "",
    "scheduledStartTime" : "2014-07-14T04:44:26.004-07:00",
    "recurrenceInterval" : "daily",
    "recurrenceDayOfWeek" : "",
    "recurrenceDayOfMonth" : "",
    "recurrenceLastDayOfMonth" : false,
    "recurrenceStartDate" : "2014-07-14",
    "recurrenceTime" : "00:00:00",
    "serviceID" : 2015
  }, {
    "instanceID" : 2012,
    "type" : "string",
    "keyName" : "testProp",
    "value" : "defaultValue",
    "serviceID" : 2015
  } ]
}

関連トピック

9.2.14　リソースのメンバー

9.4.5　サービスの実行

9.4.5　サービスの実行

機能

指定したサービスを実行します。

実行権限

Adminロール，Developロール，Modifyロール，Submitロール

APIのバージョン

v1

リクエスト形式

POST http://host:port/Automation/version/objects/Services/id/actions/submit/invoke

リクエストボディーの構造は，次のようになっています。

{
  "name" : "submit",
  "href" : "http://host:port/Automation/version/objects/Services/id/actions/submit/invoke",
  "method" : "POST",
  "parameters" : [ {...} ]
}

リクエストのスキーマで「parameters」のメンバーとして指定できるオブジェクトを，次の表で説明します。

表9‒32　「parameters」のメンバーとして指定できるオブジェクト

機能

リソース名称

数

説明

スケジュール

Schedule

1

サービスの実行予定

プロパティ値の一覧

PropertyValue

0〜n

サービスの入力プロパティ

これらのオブジェクトに指定できるプロパティについて，次に説明します。どのタイミング（即時実行，指定日時実行または定期実行）でサービスを実行する場合でも，プロパティに次のメンバーを指定できます。

リソース名称

メンバー名

数

Schedule

name

1

description

1

scheduleType

1

PropertyValue

keyName

0〜n

value

0〜n

指定日時実行または定期実行の場合は，プロパティに次のメンバーを指定できます。

リソース名称

メンバー名

数

プロパティの指定可否

Schedule

scheduledStartTime

1

指定日時実行の場合に指定できます。

recurrenceInterval

1

定期実行の場合に指定できます。

recurrenceDayOfWeek

1

recurrenceDayOfMonth

1

recurrenceLastDayOfMonth

1

recurrenceStartDate

1

recurrenceTime

1

ステータスコード

リクエストに対するレスポンスとして返却されるステータスコードを，次の表に示します。

ステータスコード

メッセージ

説明

201

Created

成功しました。

400

Bad Request

引数が不正です。

401

Unauthorized

ログイン権限がありません。

403

Forbidden

サービス実行権限がありません。

404

Not found

サービス取得権限がありません。または，サービスがありません。

412

Precondition failed

サーバが利用できません。

500

Server-side error

サーバ処理エラーが発生しました。

レスポンスのスキーマ

リクエストに対するレスポンスボディーの構造は，次のようになっています。

{
  "instanceId" : "instance-id",
  "created" : "created-date-and-time",
  "updated" : "updated-date-and-time",
  "completed" : "completed-date-and-time",
  "state" : "state",
  "affectedResources" : [ {...} ]
}

「affectedResources」のメンバーとして出力されるオブジェクトを，次の表で説明します。

表9‒33　「affectedResources」のメンバーとして出力されるオブジェクト（サービスの実行）

出力

リソース名称

数

説明

作成されたスケジュールへのリンク

String

1

作成されたスケジュール機能のリソース（Schedules）へのリンク

作成されたタスクへのリンク

String

1

作成されたタスク機能のリソース（Tasks）へのリンク

使用例

instanceID=2015のサービスを実行する場合の使用例を示します。

リクエストヘッダー:

POST /Automation/v1/objects/Services/2015/actions/submit/invoke HTTP/1.1
Host:10.196.184.238:22015
Accept:application/json
Accept-Language: ja
Content-Type: application/json
Content-Length: 811
Authorization: Basic c3lzdGVtOm1hbmFnZXI=
User-Agent: useragent1

レスポンスヘッダー:

HTTP/1.1 200 OK
Date: Mon, 14 Jul 2014 11:45:34 GMT
Server: Cosminexus HTTP Server
Access-Control-Expose-Headers: WWW-Authenticate
WWW-Authenticate: HSSO 9745c5e76461cc6c3e6946e3f7bfe84c8732ac5_V0300
Access-Control-Allow-Origin: *
Access-Control-Allow-Methods: GET, POST, DELETE, PUT, HEAD, OPTIONS
Access-Control-Allow-Credentials: true
Cache-Control: no-cache
Transfer-Encoding: chunked
Content-Type: application/json

レスポンスボディー:

{
  "instanceID" : "3d9069ca-444f-4757-b0c5-a57ddd7d44cf",
  "created" : "2014-07-14T04:45:35.293-0700",
  "updated" : "2014-07-14T04:45:35.293-0700",
  "completed" : "2014-07-14T04:45:35.293-0700",
  "state" : "success",
  "affectedResource" : [ "http://10.196.184.238:22015/Automation/v1/objects/Schedules/2025", "http://10.196.184.238:22015/Automation/v1/objects/Tasks/2026" ]
}

関連トピック

9.2.14　リソースのメンバー

9.5　スケジュール関連のAPI

タスクに設定されているスケジュール機能を管理するための操作を説明します。

9.5.1　スケジュール一覧の取得

機能

指定したタスクに設定されているスケジュール一覧を取得します。

実行権限

Adminロール，Developロール，Modifyロール，Submitロール

APIのバージョン

v1

リクエスト形式

GET http://host:port/Automation/version/objects/Schedules

APIの実行ユーザーが権限を持つ，すべてのスケジュールを対象として一覧を取得します。クエリパラメータを指定すると，一覧を取得する対象を絞り込めます。クエリパラメータは，次の形式で指定してください。

?クエリパラメータ=値[&クエリパラメータ=値...]

表9‒34　API「スケジュール一覧取得」で指定できるクエリパラメータの一覧

クエリパラメータ

フィルター条件

serviceID

指定した値と等しい

scheduleStatus※

未実行のタスクのスケジュール情報

注※

未実行のタスクのスケジュール情報を取得したい場合は，scheduleStatus に「running」を指定してください。

そのほかに指定できるクエリパラメータについては，「9.2.9　クエリパラメータ」を参照してください。

指定例

クエリパラメータとして，serviceIDに2015を指定する例を次に示します。

?serviceID=2015

ステータスコード

リクエストに対するレスポンスとして返却されるステータスコードを，次の表に示します。

ステータスコード

メッセージ

説明

200

OK

成功しました。

400

Bad Request

クエリパラメータが不正です。

401

Unauthorized

ログイン権限がありません。

412

Precondition failed

サーバが利用できません。

500

Server-side error

サーバ処理エラーが発生しました。

レスポンスのスキーマ

レスポンスボディーには，リクエストで指定したクエリパラメータの条件に合致したデータが返却されます。レスポンスボディーのスキーマを次に示します。

{
  "data" : [ {"スケジュール機能のリソース（Schedules）のメンバー" : 値 ... }, ... ],
  "count" : クエリパラメータの条件に合致したデータの個数（0〜n）
}

使用例

すべてのスケジュールを対象として，スケジュール一覧を取得する場合の使用例を示します。

リクエストヘッダー:

GET /Automation/v1/objects/Schedules HTTP/1.1
Host:10.196.184.238:22015
Accept:application/json
Accept-Language: ja
Authorization: Basic c3lzdGVtOm1hbmFnZXI=
User-Agent: useragent1

レスポンスヘッダー:

HTTP/1.1 200 OK
Date: Mon, 14 Jul 2014 12:25:42 GMT
Server: Cosminexus HTTP Server
Access-Control-Expose-Headers: WWW-Authenticate
WWW-Authenticate: HSSO c181cf3ee24e93ce964562788bccda3381a647f5_V0300
Access-Control-Allow-Origin: *
Access-Control-Allow-Methods: GET, POST, DELETE, PUT, HEAD, OPTIONS
Access-Control-Allow-Credentials: true
Cache-Control: no-cache
Transfer-Encoding: chunked
Content-Type: application/json

レスポンスボディー:

{
  "data" : [ {
    "instanceID" : 2060,
    "name" : "testService1_20140714044426_Resubmit",
    "submitter" : "System",
    "scheduleType" : "immediate",
    "createTime" : "2014-07-14T05:19:39.000-0700",
    "modifyTime" : "2014-07-14T05:19:39.000-0700",
    "description" : "",
    "serviceState" : "release",
    "serviceID" : 2015
  }, {
    "instanceID" : 2029,
    "name" : "testService1_20140714045613",
    "submitter" : "System",
    "scheduleType" : "immediate",
    "createTime" : "2014-07-14T04:56:15.000-0700",
    "modifyTime" : "2014-07-14T04:56:15.000-0700",
    "description" : "",
    "serviceState" : "release",
    "serviceID" : 2015
  }, {
    "instanceID" : 2025,
    "name" : "testService1_20140714044426",
    "submitter" : "System",
    "scheduleType" : "immediate",
    "createTime" : "2014-07-14T04:45:34.000-0700",
    "modifyTime" : "2014-07-14T04:45:34.000-0700",
    "description" : "",
    "serviceState" : "release",
    "serviceID" : 2015
  }, {
    "instanceID" : 2056,
    "name" : "Execute remote command_20140714045708",
    "submitter" : "System",
    "scheduleType" : "immediate",
    "createTime" : "2014-07-14T04:57:09.000-0700",
    "modifyTime" : "2014-07-14T04:57:09.000-0700",
    "description" : "",
    "serviceState" : "test",
    "serviceID" : 2040
  }, {
    "instanceID" : 2134,
    "name" : "stop_20140714052330",
    "submitter" : "System",
    "scheduleType" : "immediate",
    "createTime" : "2014-07-14T05:23:32.000-0700",
    "modifyTime" : "2014-07-14T05:23:32.000-0700",
    "description" : "",
    "serviceState" : "test",
    "serviceID" : 2092
  } ],
  "count" : 5
}

関連トピック

9.2.14　リソースのメンバー

9.5.2　スケジュールの情報取得

機能

指定したスケジュールに関する情報を取得します。

実行権限

Adminロール，Developロール，Modifyロール，Submitロール

APIのバージョン

v1

リクエスト形式

GET http://host:port/Automation/version/objects/Schedules/id

ステータスコード

リクエストに対するレスポンスとして返却されるステータスコードを，次の表に示します。

ステータスコード

メッセージ

説明

200

OK

成功しました。

401

Unauthorized

ログイン権限がありません。

404

Not found

権限が不正です。または，リソースがありません。

412

Precondition failed

サーバが利用できません。

500

Server-side error

サーバ処理エラーが発生しました。

レスポンスのスキーマ

リクエストに対するレスポンスボディーの構造を次に示します。

{
  "instanceID" : instance-id,
  "name" : "registered-service-name",
  "submitter" : "submit-user-name",
  "scheduleType" : "type-of-schedule",
  "createTime" : "created-date-and-time",
  "modifyTime" : "updated-date-and-time",
  "description" : "description-text",
  "serviceState" : "service-state",
  "serviceID" : service-id
}

使用例

instanceID=2060のスケジュールに関する情報を取得する場合の使用例を示します。

リクエストヘッダー:

GET /Automation/v1/objects/Schedules/2060 HTTP/1.1
Host:10.196.184.238:22015
Accept:application/json
Accept-Language: ja
Authorization: Basic c3lzdGVtOm1hbmFnZXI=
User-Agent: useragent1

レスポンスヘッダー:

HTTP/1.1 200 OK
Date: Mon, 14 Jul 2014 12:26:19 GMT
Server: Cosminexus HTTP Server
Access-Control-Expose-Headers: WWW-Authenticate
WWW-Authenticate: HSSO 32bd25936120d68dceabcb49493079f8ef82a4_V0300
Access-Control-Allow-Origin: *
Access-Control-Allow-Methods: GET, POST, DELETE, PUT, HEAD, OPTIONS
Access-Control-Allow-Credentials: true
Cache-Control: no-cache
Transfer-Encoding: chunked
Content-Type: application/json

レスポンスボディー:

{
  "instanceID" : 2060,
  "name" : "testService1_20140714044426_Resubmit",
  "submitter" : "System",
  "scheduleType" : "immediate",
  "createTime" : "2014-07-14T05:19:39.000-0700",
  "modifyTime" : "2014-07-14T05:19:39.000-0700",
  "description" : "",
  "serviceState" : "release",
  "serviceID" : 2015
}

9.5.3　スケジュールに対する操作一覧の取得

機能

指定したスケジュールに対して実行できる操作の一覧を取得します。

実行権限

Adminロール，Developロール，Modifyロール，Submitロール

APIのバージョン

v1

リクエスト形式

GET http://host:port/Automation/version/objects/Schedules/id/actions

ステータスコード

リクエストに対するレスポンスとして返却されるステータスコードを，次の表に示します。

ステータスコード

メッセージ

説明

200

OK

成功しました。

401

Unauthorized

ログイン権限がありません。

412

Precondition failed

サーバが利用できません。

500

Server-side error

サーバ処理エラーが発生しました。

レスポンスのスキーマ

リクエストに対するレスポンスボディーの構造を次に示します。

{
  "data" : [ {
    "name" : "cancel",
    "href" : "http://host:port/Automation/version/objects/Schedules/id",
    "method" : "POST",
    "parameters" : null
  }, {
    "name" : "suspend",
    "href" : "http://host:port/Automation/version/objects/Schedules/id",
    "method" : "POST",
    "parameters" : null
  }, {
    "name" : "resume",
    "href" : "http://host:port/Automation/version/objects/Schedules/id/actions/submit/invoke",
    "method" : "POST",
    "parameters" : null
  } ],
  "count" : count
}

使用例

instanceID=2193のスケジュールに対して実行できる操作の一覧を，取得する場合の使用例を示します。

リクエストヘッダー:

GET /Automation/v1/objects/Schedules/2193/actions HTTP/1.1
Host:10.196.184.238:22015
Accept:application/json
Accept-Language: ja
Authorization: Basic c3lzdGVtOm1hbmFnZXI=
User-Agent: useragent1

レスポンスヘッダー:

HTTP/1.1 200 OK
Date: Mon, 14 Jul 2014 12:29:28 GMT
Server: Cosminexus HTTP Server
Access-Control-Expose-Headers: WWW-Authenticate
WWW-Authenticate: HSSO cc5725658f9964bc6194b6477763ebbe502fcf_V0300
Access-Control-Allow-Origin: *
Access-Control-Allow-Methods: GET, POST, DELETE, PUT, HEAD, OPTIONS
Access-Control-Allow-Credentials: true
Cache-Control: no-cache
Transfer-Encoding: chunked
Content-Type: application/json

レスポンスボディー:

{
  "data" : [ {
    "name" : "cancel",
    "href" : "http://10.196.184.238:22015/Automation/v1/objects/Schedules/2193/actions/cancel/invoke",
    "method" : "POST",
    "parameters" : [ ]
  }, {
    "name" : "suspend",
    "href" : "http://10.196.184.238:22015/Automation/v1/objects/Schedules/2193/actions/suspend/invoke",
    "method" : "POST",
    "parameters" : [ ]
  }, {
    "name" : "resume",
    "href" : "http://10.196.184.238:22015/Automation/v1/objects/Schedules/2193/actions/resume/invoke",
    "method" : "POST",
    "parameters" : [ ]
  } ],
  "count" : 3
}

関連トピック

9.2.14　リソースのメンバー

9.5.4　スケジュールのキャンセルに必要な情報の取得

機能

指定したスケジュールをキャンセルするために必要な情報を取得します。

実行権限

Adminロール，Developロール，Modifyロール，Submitロール

APIのバージョン

v1

リクエスト形式

GET http://host:port/Automation/version/objects/Schedules/id/actions/cancel

ステータスコード

リクエストに対するレスポンスとして返却されるステータスコードを，次の表に示します。

ステータスコード

メッセージ

説明

200

OK

成功しました。

401

Unauthorized

ログイン権限がありません。

404

Not found

権限が不正です。または，リソースがありません。

412

Precondition failed

サーバが利用できません。

500

Server-side error

サーバ処理エラーが発生しました。

レスポンスのスキーマ

リクエストに対するレスポンスボディーの構造を次に示します。

{
  "name" : "cancel",
  "href" : "http://host:port/Automation/version/objects/Schedules/id/actions/cancel/invoke",
  "method" : "POST",
  "parameters" : [ {...} ]
}

使用例

instanceID=2193のスケジュールをキャンセルするために必要になる情報を，取得する場合の使用例を示します。

リクエストヘッダー:

GET /Automation/v1/objects/Schedules/2193/actions/cancel HTTP/1.1
Host:10.196.184.238:22015
Accept:application/json
Accept-Language: ja
Authorization: Basic c3lzdGVtOm1hbmFnZXI=
User-Agent: useragent1

レスポンスヘッダー:

HTTP/1.1 200 OK
Date: Mon, 14 Jul 2014 12:34:39 GMT
Server: Cosminexus HTTP Server
Access-Control-Expose-Headers: WWW-Authenticate
WWW-Authenticate: HSSO d0f2fa4f5046c92521664920b9d84e652bcb6dee_V0300
Access-Control-Allow-Origin: *
Access-Control-Allow-Methods: GET, POST, DELETE, PUT, HEAD, OPTIONS
Access-Control-Allow-Credentials: true
Cache-Control: no-cache
Transfer-Encoding: chunked
Content-Type: application/json

レスポンスボディー:

{
  "name" : "cancel",
  "href" : "http://10.196.184.238:22015/Automation/v1/objects/Schedules/2193/actions/cancel/invoke",
  "method" : "POST",
  "parameters" : [ ]
}

関連トピック

9.5.5　スケジュールのキャンセル

9.5.5　スケジュールのキャンセル

機能

指定したスケジュールをキャンセルします。

実行権限

Adminロール，Developロール，Modifyロール，Submitロール

APIのバージョン

v1

リクエスト形式

POST http://host:port/Automation/version/objects/Schedules/id/actions/cancel/invoke

リクエストボディーの構造は，次のようになっています。

{
  "name" : "cancel",
  "href" : "http://host:port/Automation/version/objects/Schedules/id/actions/cancel/invoke",
  "method" : "POST",
  "parameters" : null
}

ステータスコード

リクエストに対するレスポンスとして返却されるステータスコードを，次の表に示します。

ステータスコード

メッセージ

説明

200

Created

成功しました。

401

Unauthorized

ログイン権限がありません。

404

Not found

権限が不正です。または，リソースがありません。

409

Conflict

タスクの状態が待機中または保留中ではありません。

412

Precondition failed

サーバが利用できません。

500

Server-side error

サーバ処理エラーが発生しました。

レスポンスのスキーマ

リクエストに対するレスポンスボディーの構造は，次のようになっています。

{
  "instanceId" : "instance-id",
  "created" : "created-date-and-time",
  "updated" : "updated-date-and-time",
  "completed" : "completed-date-and-time",
  "state" : "state",
  "affectedResources" : [ {...} ]
}

「affectedResources」のメンバーとして出力されるオブジェクトを，次の表で説明します。

表9‒35　「affectedResources」のメンバーとして出力されるオブジェクト（スケジュールのキャンセル）

出力

リソース名称

数

説明

影響を受けたスケジュールへのリンク

String

1

影響を受けたスケジュール機能のリソース（Schedules）へのリンク

使用例

instanceID=2193のスケジュールをキャンセルする場合の使用例を示します。

リクエストヘッダー:

POST /Automation/v1/objects/Schedules/2193/actions/cancel/invoke HTTP/1.1
Host:10.196.184.238:22015
Accept:application/json
Accept-Language: ja
Content-Type: application/json
Content-Length: 172
Authorization: Basic c3lzdGVtOm1hbmFnZXI=
User-Agent: useragent1

レスポンスヘッダー:

HTTP/1.1 200 OK
Date: Mon, 14 Jul 2014 12:35:22 GMT
Server: Cosminexus HTTP Server
Access-Control-Expose-Headers: WWW-Authenticate
WWW-Authenticate: HSSO 2c90fb9464fb635a106ec87345e839118bc45dba_V0300
Access-Control-Allow-Origin: *
Access-Control-Allow-Methods: GET, POST, DELETE, PUT, HEAD, OPTIONS
Access-Control-Allow-Credentials: true
Cache-Control: no-cache
Transfer-Encoding: chunked
Content-Type: application/json

レスポンスボディー:

{
  "instanceID" : "7a2924f8-1d5b-4f94-aef0-babccb2eb525",
  "created" : "2014-07-14T05:35:23.113-0700",
  "updated" : "2014-07-14T05:35:23.113-0700",
  "completed" : "2014-07-14T05:35:23.113-0700",
  "state" : "success",
  "affectedResource" : [ "http://10.196.184.238:22015/Automation/v1/objects/Schedules/2193" ]
}

9.5.6　スケジュールの一時停止に必要な情報の取得

機能

指定したスケジュールを一時停止するために必要な情報を取得します。

実行権限

Adminロール，Developロール，Modifyロール，Submitロール

APIのバージョン

v1

リクエスト形式

GET http://host:port/Automation/version/objects/Schedules/id/actions/suspend

ステータスコード

リクエストに対するレスポンスとして返却されるステータスコードを，次の表に示します。

ステータスコード

メッセージ

説明

200

OK

成功しました。

401

Unauthorized

ログイン権限がありません。

404

Not found

権限が不正です。または，リソースがありません。

412

Precondition failed

サーバが利用できません。

500

Server-side error

サーバ処理エラーが発生しました。

レスポンスのスキーマ

リクエストに対するレスポンスボディーの構造を次に示します。

{
  "name" : "suspend",
  "href" : "http://host:port/Automation/version/objects/Schedules/id/actions/suspend/invoke",
  "method" : "POST",
  "parameters" : null
}

使用例

instanceID=2193のスケジュールを一時停止するために必要になる情報を取得する場合の使用例を示します。

リクエストヘッダー:

GET /Automation/v1/objects/Schedules/2193/actions/suspend HTTP/1.1
Host:10.196.184.238:22015
Accept:application/json
Accept-Language: ja
Authorization: Basic c3lzdGVtOm1hbmFnZXI=
User-Agent: useragent1

レスポンスヘッダー:

HTTP/1.1 200 OK
Date: Mon, 14 Jul 2014 12:31:38 GMT
Server: Cosminexus HTTP Server
Access-Control-Expose-Headers: WWW-Authenticate
WWW-Authenticate: HSSO 34f06d8c215d7ce2bfa1d4c5e3ec8ab7ecd61f36_V0300
Access-Control-Allow-Origin: *
Access-Control-Allow-Methods: GET, POST, DELETE, PUT, HEAD, OPTIONS
Access-Control-Allow-Credentials: true
Cache-Control: no-cache
Transfer-Encoding: chunked
Content-Type: application/json

レスポンスボディー:

{
  "name" : "suspend",
  "href" : "http://10.196.184.238:22015/Automation/v1/objects/Schedules/2193/actions/suspend/invoke",
  "method" : "POST",
  "parameters" : [ ]
}

関連トピック

9.5.7　スケジュールの一時停止

9.5.7　スケジュールの一時停止

機能

指定したスケジュールを一時停止します。

実行権限

Adminロール，Developロール，Modifyロール，Submitロール

APIのバージョン

v1

リクエスト形式

POST http://host:port/Automation/version/objects/Schedules/id/actions/suspend/invoke

リクエストボディーの構造は，次のようになっています。

{
  "name" : "suspend",
  "href" : "http://host:port/Automation/version/objects/Schedules/id/actions/suspend/invoke",
  "method" : "POST",
  "parameters" : null
}

ステータスコード

リクエストに対するレスポンスとして返却されるステータスコードを，次の表に示します。

ステータスコード

メッセージ

説明

200

Created

成功しました。

401

Unauthorized

ログイン権限がありません。

404

Not found

権限が不正です。または，リソースがありません。

409

Conflict

タスクの状態が保留中ではありません。

412

Precondition failed

サーバが利用できません。

500

Server-side error

サーバ処理エラーが発生しました。

レスポンスのスキーマ

リクエストに対するレスポンスボディーの構造は，次のようになっています。

{
  "instanceId" : "instance-id",
  "created" : "created-date-and-time",
  "updated" : "updated-date-and-time",
  "completed" : "completed-date-and-time",
  "state" : "state",
  "affectedResources" : [ {...} ]
}

「affectedResources」のメンバーとして出力されるオブジェクトを，次の表で説明します。

表9‒36　「affectedResources」のメンバーとして出力されるオブジェクト（スケジュールの一時停止）

出力

リソース名称

数

説明

影響を受けたスケジュールへのリンク

String

1

影響を受けたSchedulesリソースへのリンク

使用例

instanceID=2193のスケジュールを一時停止する場合の使用例を示します。

リクエストヘッダー:

POST /Automation/v1/objects/Schedules/2193/actions/suspend/invoke HTTP/1.1
Host:10.196.184.238:22015
Accept:application/json
Accept-Language: ja
Content-Type: application/json
Content-Length: 174
Authorization: Basic c3lzdGVtOm1hbmFnZXI=
User-Agent: useragent1

レスポンスヘッダー:

HTTP/1.1 200 OK
Date: Mon, 14 Jul 2014 12:32:16 GMT
Server: Cosminexus HTTP Server
Access-Control-Expose-Headers: WWW-Authenticate
WWW-Authenticate: HSSO 35e60f22b689d26c6fa4514f115629d92e4d_V0300
Access-Control-Allow-Origin: *
Access-Control-Allow-Methods: GET, POST, DELETE, PUT, HEAD, OPTIONS
Access-Control-Allow-Credentials: true
Cache-Control: no-cache
Transfer-Encoding: chunked
Content-Type: application/json

レスポンスボディー:

{
  "instanceID" : "3a6ac368-e49c-49ec-ac5b-380370800551",
  "created" : "2014-07-14T05:32:16.519-0700",
  "updated" : "2014-07-14T05:32:16.519-0700",
  "completed" : "2014-07-14T05:32:16.519-0700",
  "state" : "success",
  "affectedResource" : [ "http://10.196.184.238:22015/Automation/v1/objects/Schedules/2193" ]
}

9.5.8　スケジュールの再開に必要な情報の取得

機能

指定したスケジュールを再開するために必要な情報を取得します。

実行権限

Adminロール，Developロール，Modifyロール，Submitロール

APIのバージョン

v1

リクエスト形式

GET http://host:port/Automation/version/objects/Schedules/id/actions/resume

ステータスコード

リクエストに対するレスポンスとして返却されるステータスコードを，次の表に示します。

ステータスコード

メッセージ

説明

200

OK

リソースの検索または削除に成功しました。

401

Unauthorized

ログイン権限がありません。

412

Precondition failed

サーバが利用できません。

500

Server-side error

サーバ処理エラーが発生しました。

レスポンスのスキーマ

リクエストに対するレスポンスボディーの構造を次に示します。

{
  "name" : "resume",
  "href" : "http://host:port/Automation/version/objects/Schedules/id/actions/resume/invoke",
  "method" : "POST",
  "parameters" : null
}

使用例

instanceID=2193のスケジュールを再開するために必要となる情報を取得する場合の使用例を示します。

リクエストヘッダー:

GET /Automation/v1/objects/Schedules/2193/actions/resume HTTP/1.1
Host:10.196.184.238:22015
Accept:application/json
Accept-Language: ja
Authorization: Basic c3lzdGVtOm1hbmFnZXI=
User-Agent: useragent1

レスポンスヘッダー:

HTTP/1.1 200 OK
Date: Mon, 14 Jul 2014 12:33:15 GMT
Server: Cosminexus HTTP Server
Access-Control-Expose-Headers: WWW-Authenticate
WWW-Authenticate: HSSO b6614f2b01ee545d99439e172e745d55ccc6081_V0300
Access-Control-Allow-Origin: *
Access-Control-Allow-Methods: GET, POST, DELETE, PUT, HEAD, OPTIONS
Access-Control-Allow-Credentials: true
Cache-Control: no-cache
Transfer-Encoding: chunked
Content-Type: application/json

レスポンスボディー:

{
  "name" : "resume",
  "href" : "http://10.196.184.238:22015/Automation/v1/objects/Schedules/2193/actions/resume/invoke",
  "method" : "POST",
  "parameters" : [ ]
}

関連トピック

9.5.9　スケジュールの再開

9.5.9　スケジュールの再開

機能

指定したスケジュールを再開します。

実行権限

Adminロール，Developロール，Modifyロール，Submitロール

APIのバージョン

v1

リクエスト形式

GET http://host:port/Automation/version/objects/Schedules/id/actions/resume/
invoke

リクエストボディーの構造は，次のようになっています。

{
  "name" : "resume",
  "href" : "http://host:port/Automation/version/objects/Schedules/id/actions/resume/invoke",
  "method" : "POST",
  "parameters" : null
}

ステータスコード

リクエストに対するレスポンスとして返却されるステータスコードを，次の表に示します。

ステータスコード

メッセージ

説明

200

Created

成功しました。

401

Unauthorized

ログイン権限がありません。

404

Not found

権限が不正です。または，リソースがありません。

409

Conflict

タスクの状態が保留中ではありません。

412

Precondition failed

サーバが利用できません。

500

Server-side error

サーバ処理エラーが発生しました。

レスポンスのスキーマ

リクエストに対するレスポンスボディーの構造は，次のようになっています。

{
  "instanceId" : "instance-id",
  "created" : "created-date-and-time",
  "updated" : "updated-date-and-time",
  "completed" : "completed-date-and-time",
  "state" : "state",
  "affectedResources" : [ {...} ]
}

「affectedResources」のメンバーとして出力されるオブジェクトを，次の表で説明します。

表9‒37　「affectedResources」のメンバーとして出力されるオブジェクト（スケジュールの再開）

出力

リソース名称

数

説明

影響を受けたスケジュールへのリンク

String

1

影響を受けたスケジュール機能のリソース（Schedules）へのリンク

使用例

instanceID=2193のスケジュールを再開する場合の使用例を示します。

リクエストヘッダー:

POST /Automation/v1/objects/Schedules/2193/actions/resume/invoke HTTP/1.1
Host:10.196.184.238:22015
Accept:application/json
Accept-Language: ja
Content-Type: application/json
Content-Length: 172
Authorization: Basic c3lzdGVtOm1hbmFnZXI=
User-Agent: useragent1

レスポンスヘッダー:

HTTP/1.1 200 OK
Date: Mon, 14 Jul 2014 12:33:56 GMT
Server: Cosminexus HTTP Server
Access-Control-Expose-Headers: WWW-Authenticate
WWW-Authenticate: HSSO b2d0839f82cfad2ed8d119a8dc37bbe3b494e73_V0300
Access-Control-Allow-Origin: *
Access-Control-Allow-Methods: GET, POST, DELETE, PUT, HEAD, OPTIONS
Access-Control-Allow-Credentials: true
Cache-Control: no-cache
Transfer-Encoding: chunked
Content-Type: application/json

レスポンスボディー:

{
  "instanceID" : "a109b95d-e7ef-4982-ab24-2d062b38e088",
  "created" : "2014-07-14T05:33:56.925-0700",
  "updated" : "2014-07-14T05:33:56.925-0700",
  "completed" : "2014-07-14T05:33:56.925-0700",
  "state" : "success",
  "affectedResource" : [ "http://10.196.184.238:22015/Automation/v1/objects/Schedules/2193" ]
}

9.6　タスク関連のAPI

タスクリソースを管理するための操作を説明します。

9.6.1　タスク一覧の取得

機能

タスクの一覧を取得します。

実行権限

Adminロール，Developロール，Modifyロール，Submitロール

APIのバージョン

v1

リクエスト形式

GET http://host:port/Automation/version/objects/Tasks

APIの実行ユーザーが権限を持つ，すべてのタスクを対象として一覧を取得します。クエリパラメータを指定すると，一覧を取得する対象を絞り込めます。クエリパラメータは，次の形式で指定してください。

?クエリパラメータ=値[&クエリパラメータ=値...]

表9‒38　API「タスク一覧の取得」で指定できるクエリパラメータの一覧

クエリパラメータ

フィルター条件

serviceID

指定した値と等しい

scheduleID

指定した値と等しい

そのほかに指定できるクエリパラメータについては，「9.2.9　クエリパラメータ」を参照してください。

指定例

クエリパラメータとして，serviceIDに2015を指定する例を次に示します。

?serviceID=2015

ステータスコード

リクエストに対するレスポンスとして返却されるステータスコードを，次の表に示します。

ステータスコード

メッセージ

説明

200

OK

成功しました。

400

Bad Request

クエリパラメータが不正です。

401

Unauthorized

ログイン権限がありません。

412

Precondition failed

サーバが利用できません。

500

Server-side error

サーバ処理エラーが発生しました。

レスポンスのスキーマ

レスポンスボディーには，リクエストで指定したクエリパラメータの条件に合致したデータが返却されます。レスポンスボディーのスキーマを次に示します。

{
  "data" : [ {"タスク機能のリソース（Tasks）のメンバー" : 値 ... }, ... ],
  "count" : クエリパラメータの条件に合致したデータの個数（0〜n）
}

使用例

すべてのタスクを対象として，タスク一覧を取得する場合の使用例を示します。

リクエストヘッダー:

GET /Automation/v1/objects/Tasks HTTP/1.1
Host:10.196.184.238:22015
Accept:application/json
Accept-Language: ja
Authorization: Basic c3lzdGVtOm1hbmFnZXI=
User-Agent: useragent1

レスポンスヘッダー:

HTTP/1.1 200 OK
Date: Mon, 14 Jul 2014 11:47:45 GMT
Server: Cosminexus HTTP Server
Access-Control-Expose-Headers: WWW-Authenticate
WWW-Authenticate: HSSO bd804a4bbfb57c37cad7fe56034d49e428b615_V0300
Access-Control-Allow-Origin: *
Access-Control-Allow-Methods: GET, POST, DELETE, PUT, HEAD, OPTIONS
Access-Control-Allow-Credentials: true
Cache-Control: no-cache
Transfer-Encoding: chunked
Content-Type: application/json

レスポンスボディー:

{
  "data" : [ {
    "instanceID" : 2026,
    "name" : "testService1_20140714044426",
    "status" : "completed",
    "startTime" : "2014-07-14T04:45:35.000-0700",
    "completionTime" : "2014-07-14T04:45:35.000-0700",
    "submitter" : "System",
    "submitTime" : "2014-07-14T04:45:34.000-0700",
    "modifyTime" : "2014-07-14T04:45:57.000-0700",
    "serviceState" : "release",
    "scheduleID" : 2025,
    "serviceGroupID" : 3,
    "serviceID" : 2015
  } ],
  "count" : 1
}

関連トピック

9.2.14　リソースのメンバー

9.6.2　タスクの情報取得

機能

指定したタスクに関する情報を取得します。

実行権限

Adminロール，Developロール，Modifyロール，Submitロール

APIのバージョン

v1

リクエスト形式

GET http://host:port/Automation/version/objects/Tasks/id

ステータスコード

リクエストに対するレスポンスとして返却されるステータスコードを，次の表に示します。

ステータスコード

メッセージ

説明

200

OK

成功しました。

401

Unauthorized

ログイン権限がありません。

404

Not found

権限が不正です。または，リソースがありません。

412

Precondition failed

サーバが利用できません。

500

Server-side error

サーバ処理エラーが発生しました。

レスポンスのスキーマ

リクエストに対するレスポンスボディーの構造を次に示します。

{
  "instanceID" : instance-id,
  "name" : "task-name",
  "status" : "task-status",
  "startTime" : "start-date-and-time",
  "completionTime" : "completion-time",
  "submitter" : "submit-user-name",
  "submitTime" : "created-date-and-time",
  "modifyTime" : "updated-date-and-time",
  "serviceState" : "service-state",
  "scheduleID" : schedule-id,
  "serviceGroupID" : service-group-id
  "serviceID" : service-id
}

使用例

instanceID=2026のタスクに関する情報を取得する場合の使用例を示します。

リクエストヘッダー:

GET /Automation/v1/objects/Tasks/2026 HTTP/1.1
Host:10.196.184.238:22015
Accept:application/json
Accept-Language: ja
Authorization: Basic c3lzdGVtOm1hbmFnZXI=
User-Agent: useragent1

レスポンスヘッダー:

HTTP/1.1 200 OK
Date: Mon, 14 Jul 2014 11:58:17 GMT
Server: Cosminexus HTTP Server
Access-Control-Expose-Headers: WWW-Authenticate
WWW-Authenticate: HSSO 4c41b543aa586cdc7eda448abadac3ff6268be_V0300
Access-Control-Allow-Origin: *
Access-Control-Allow-Methods: GET, POST, DELETE, PUT, HEAD, OPTIONS
Access-Control-Allow-Credentials: true
Cache-Control: no-cache
Transfer-Encoding: chunked
Content-Type: application/json

レスポンスボディー:

{
  "instanceID" : 2026,
  "name" : "testService1_20140714044426",
  "status" : "completed",
  "startTime" : "2014-07-14T04:45:35.000-0700",
  "completionTime" : "2014-07-14T04:45:35.000-0700",
  "submitter" : "System",
  "submitTime" : "2014-07-14T04:45:34.000-0700",
  "modifyTime" : "2014-07-14T04:45:57.000-0700",
  "serviceState" : "release",
  "scheduleID" : 2025,
  "serviceGroupID" : 3,
  "serviceID" : 2015
}

9.6.3　タスク操作一覧の取得

機能

指定したタスクに対して実行できる操作の一覧を取得します。

実行権限

Adminロール，Developロール，Modifyロール，Submitロール

APIのバージョン

v1

リクエスト形式

GET http://host:port/Automation/version/objects/Tasks/id/actions

ステータスコード

リクエストに対するレスポンスとして返却されるステータスコードを，次の表に示します。

ステータスコード

メッセージ

説明

200

OK

成功しました。

401

Unauthorized

ログイン権限がありません。

412

Precondition failed

サーバが利用できません。

500

Server-side error

サーバ処理エラーが発生しました。

レスポンスのスキーマ

リクエストに対するレスポンスボディーの構造を次に示します。

{
  "data" : [ {
    "name" : "stop",
    "href" : "http://host:port/Automation/version/objects/Tasks/id/actions/stop/invoke",
    "method" : "POST",
    "parameters" : null
  }, {
    "name" : "resubmit",
    "href" : "http://host:port/Automation/version/objects/Tasks/id/actions/resubmit/invoke",
    "method" : "POST",
    "parameters" : null
  }, {
    "name" : "rerunStart",
    "href" : "http://host:port/Automation/version/objects/Tasks/id/actions/rerunStart/invoke",
    "method" : "POST",
    "parameters" : null
  }, {
    "name" : "rerunStepStart",
    "href" : "http://host:port/Automation/version/objects/Tasks/id/actions/rerunStepStart/invoke",
    "method" : "POST",
    "parameters" : null
  } ],
  "count" : count
}

使用例

instanceID=2026のタスクに対して実行できる操作の一覧を，取得する場合の使用例を示します。

リクエストヘッダー:

GET /Automation/v1/objects/Tasks/2026/actions HTTP/1.1
Host:10.196.184.238:22015
Accept:application/json
Accept-Language: ja
Authorization: Basic c3lzdGVtOm1hbmFnZXI=
User-Agent: useragent1

レスポンスヘッダー:

HTTP/1.1 200 OK
Date: Mon, 14 Jul 2014 11:50:49 GMT
Server: Cosminexus HTTP Server
Access-Control-Expose-Headers: WWW-Authenticate
WWW-Authenticate: HSSO ef25841e55e5ca35748991fa926afd0852d24f6_V0300
Access-Control-Allow-Origin: *
Access-Control-Allow-Methods: GET, POST, DELETE, PUT, HEAD, OPTIONS
Access-Control-Allow-Credentials: true
Cache-Control: no-cache
Transfer-Encoding: chunked
Content-Type: application/json

レスポンスボディー:

{
  "data" : [ {
    "name" : "stop",
    "href" : "http://10.196.184.238:22015/Automation/v1/objects/Tasks/2026/actions/stop/invoke",
    "method" : "POST",
    "parameters" : [ ]
  }, {
    "name" : "resubmit",
    "href" : "http://10.196.184.238:22015/Automation/v1/objects/Tasks/2026/actions/resubmit/invoke",
    "method" : "POST",
    "parameters" : [ ]
  }, {
    "name" : "rerunStart",
    "href" : "http://10.196.184.238:22015/Automation/v1/objects/Tasks/2026/actions/rerunStart/invoke",
    "method" : "POST",
    "parameters" : [ ]
  }, {
    "name" : "rerunStepStart",
    "href" : "http://10.196.184.238:22015/Automation/v1/objects/Tasks/2026/actions/rerunStepStart/invoke",
    "method" : "POST",
    "parameters" : [ ]
  } ],
  "count" : 4
}

9.6.4　タスク実行停止に必要な情報の取得

機能

指定したタスクを実行停止するために必要な情報を取得します。

実行権限

Adminロール，Developロール，Modifyロール，Submitロール

APIのバージョン

v1

リクエスト形式

GET http://host:port/Automation/version/objects/Tasks/id/actions/stop

ステータスコード

リクエストに対するレスポンスとして返却されるステータスコードを，次の表に示します。

ステータスコード

メッセージ

説明

200

OK

リソースの検索または削除に成功しました。

401

Unauthorized

ログイン権限がありません。

404

Not found

権限が不正です。または，リソースがありません。

412

Precondition failed

サーバが利用できません。

500

Server-side error

サーバ処理エラーが発生しました。

レスポンスのスキーマ

リクエストに対するレスポンスボディーの構造を次に示します。

{
  "name" : "stop",
  "href" : "http://host:port/Automation/version/objects/Tasks/id/actions/stop/invoke",
  "method" : "POST",
  "parameters" : null
}

使用例

instanceID=2026のタスクを実行停止するために必要となる情報を取得する場合の使用例を示します。

リクエストヘッダー:

GET /Automation/v1/objects/Tasks/2026/actions/stop HTTP/1.1
Host:10.196.184.238:22015
Accept:application/json
Accept-Language: ja
Authorization: Basic c3lzdGVtOm1hbmFnZXI=
User-Agent: useragent1

レスポンスヘッダー:

HTTP/1.1 200 OK
Date: Mon, 14 Jul 2014 12:21:37 GMT
Server: Cosminexus HTTP Server
Access-Control-Expose-Headers: WWW-Authenticate
WWW-Authenticate: HSSO a542e79cb51d1228f7359e62edb254aa14b81cc_V0300
Access-Control-Allow-Origin: *
Access-Control-Allow-Methods: GET, POST, DELETE, PUT, HEAD, OPTIONS
Access-Control-Allow-Credentials: true
Cache-Control: no-cache
Transfer-Encoding: chunked
Content-Type: application/json

レスポンスボディー:

{
  "name" : "stop",
  "href" : "http://10.196.184.238:22015/Automation/v1/objects/Tasks/2026/actions/stop/invoke",
  "method" : "POST",
  "parameters" : [ ]
}

関連トピック

9.6.5　タスクの実行停止

9.6.5　タスクの実行停止

機能

指定したタスクを実行停止します。

実行権限

Adminロール，Developロール，Modifyロール，Submitロール

APIのバージョン

v1

リクエスト形式

POST http://host:port/Automation/version/objects/Tasks/id/actions/stop/invoke

リクエストボディーの構造は，次のようになっています。

{
  "name" : "stop",
  "href" : "http://host:port/Automation/version/objects/Tasks/id/actions/stop/invoke",
  "method" : "POST",
  "parameters" : null
}

ステータスコード

リクエストに対するレスポンスとして返却されるステータスコードを，次の表に示します。

ステータスコード

メッセージ

説明

200

Created

成功しました。

401

Unauthorized

ログイン権限がありません。

404

Not found

権限が不正です。または，リソースがありません。

409

Conflict

タスクの状態が実行中，応答待ち中，異常検出のどれでもありません。

412

Precondition failed

サーバが利用できません。

500

Server-side error

サーバ処理エラーが発生しました。

レスポンスのスキーマ

リクエストに対するレスポンスボディーの構造は，次のようになっています。

{
  "instanceId" : "instance-id",
  "created" : "created-date-and-time",
  "updated" : "updated-date-and-time",
  "completed" : "completed-date-and-time",
  "state" : "state",
  "affectedResources" : [ {...} ]
}

「affectedResources」のメンバーとして出力されるオブジェクトを，次の表で説明します。

表9‒39　「affectedResources」のメンバーとして出力されるオブジェクト（タスクの実行停止）

出力

リソース名称

数

説明

影響を受けたタスクへのリンク

String

1

更新されたタスク機能のリソース（Tasks）へのリンク

使用例

instanceID=2026のタスクを実行停止する場合の使用例を示します。

リクエストヘッダー:

POST /Automation/v1/objects/Tasks/2026/actions/stop/invoke HTTP/1.1
Host:10.196.184.238:22015
Accept:application/json
Accept-Language: ja
Content-Type: application/json
Content-Length: 164
Authorization: Basic c3lzdGVtOm1hbmFnZXI=
User-Agent: useragent1

レスポンスヘッダー:

HTTP/1.1 200 OK
Date: Mon, 14 Jul 2014 12:23:58 GMT
Server: Cosminexus HTTP Server
Access-Control-Expose-Headers: WWW-Authenticate
WWW-Authenticate: HSSO d3b775e19041295c9834a332f7936467d94358e_V0300
Access-Control-Allow-Origin: *
Access-Control-Allow-Methods: GET, POST, DELETE, PUT, HEAD, OPTIONS
Access-Control-Allow-Credentials: true
Cache-Control: no-cache
Transfer-Encoding: chunked
Content-Type: application/json

レスポンスボディー:

{
  "instanceID" : "f550ef02-b4f8-4332-95da-3b685f2cedf8",
  "created" : "2014-07-14T05:23:59.222-0700",
  "updated" : "2014-07-14T05:23:59.222-0700",
  "completed" : "2014-07-14T05:23:59.222-0700",
  "state" : "success",
  "affectedResource" : [ "http://10.196.184.238:22015/Automation/v1/objects/Tasks/2026" ]
}

9.6.6　タスクの再実行に必要な情報の取得

機能

指定したタスクを再実行するために必要な情報を取得します。

実行権限

Adminロール，Developロール，Modifyロール，Submitロール

APIのバージョン

v1

リクエスト形式

GET http://host:port/Automation/version/objects/Tasks/id/actions/resubmit

ステータスコード

リクエストに対するレスポンスとして返却されるステータスコードを，次の表に示します。

ステータスコード

メッセージ

説明

200

OK

リソースの検索または削除に成功しました。

401

Unauthorized

ログイン権限がありません。

404

Not found

権限が不正です。または，リソースがありません。

412

Precondition failed

サーバが利用できません。

500

Server-side error

サーバ処理エラーが発生しました。

レスポンスのスキーマ

リクエストに対するレスポンスボディーの構造を次に示します。

{
  "name" : "resubmit",
  "href" : "http://host:port/Automation/version/objects/Tasks/id/actions/resubmit/invoke",
  "method" : "POST",
  "parameters" : [ {...} ]
}

「parameters」のメンバーとして出力されるオブジェクトを，次の表で説明します。

表9‒40　「parameters」のメンバーとして出力されるオブジェクト（タスクの再実行に必要な情報の取得）

機能

リソース名称

数

説明

スケジュール

Schedule

1

サービスの実行予定

プロパティ値の一覧

PropertyValue

0〜n

サービスの入力プロパティ

使用例

instanceID=2026のタスクを再実行するために必要となる情報を取得する場合の使用例を示します。

リクエストヘッダー:

GET /Automation/v1/objects/Tasks/2026/actions/resubmit HTTP/1.1
Host:10.196.184.238:22015
Accept:application/json
Accept-Language: ja
Authorization: Basic c3lzdGVtOm1hbmFnZXI=
User-Agent: useragent1

レスポンスヘッダー:

HTTP/1.1 200 OK
Date: Mon, 14 Jul 2014 12:03:20 GMT
Server: Cosminexus HTTP Server
Access-Control-Expose-Headers: WWW-Authenticate
WWW-Authenticate: HSSO c733364e62b52913e477addabfbf8c55f9de831_V0300
Access-Control-Allow-Origin: *
Access-Control-Allow-Methods: GET, POST, DELETE, PUT, HEAD, OPTIONS
Access-Control-Allow-Credentials: true
Cache-Control: no-cache
Transfer-Encoding: chunked
Content-Type: application/json

レスポンスボディー:

{
  "name" : "resubmit",
  "href" : "http://10.196.184.238:22015/Automation/v1/objects/Tasks/2026/actions/resubmit/invoke",
  "method" : "POST",
  "parameters" : [ {
    "name" : "testService1_20140714044426_Resubmit",
    "submitter" : "System",
    "scheduleType" : "immediate",
    "description" : "",
    "scheduledStartTime" : "2014-07-14T05:03:20.441-07:00",
    "recurrenceInterval" : "daily",
    "recurrenceDayOfWeek" : "",
    "recurrenceDayOfMonth" : "",
    "recurrenceLastDayOfMonth" : false,
    "recurrenceStartDate" : "2014-07-14",
    "recurrenceTime" : "00:00:00",
    "serviceID" : 2015
  }, {
    "instanceID" : 2012,
    "type" : "string",
    "keyName" : "testProp",
    "value" : "defaultValue",
    "serviceID" : 2015
  } ]
}

関連トピック

9.2.14　リソースのメンバー

9.6.7　タスクの再実行

9.6.7　タスクの再実行

機能

指定したタスクを再実行します。

実行権限

Adminロール，Developロール，Modifyロール，Submitロール

APIのバージョン

v1

リクエスト形式

POST http://host:port/Automation/version/objects/Tasks/id/actions/resubmit/
invoke

リクエストボディーの構造は，次のようになっています。

{
  "name" : "resubmit",
  "href" : "http://host:port/Automation/version/objects/Tasks/id/actions/resubmit/invoke",
  "method" : "POST",
  "parameters" : [ {...} ]
}

リクエストのスキーマで「parameters」のメンバーとして指定できるオブジェクトを，次の表で説明します。

表9‒41　「parameters」のメンバーとして指定できるオブジェクト

機能

リソース名称

数

説明

スケジュール

Schedule

1

サービスの実行予定

プロパティ値の一覧

PropertyValue

0〜n

サービスの入力プロパティ

指定できるプロパティについて，次に説明します。

共通の設定の場合

表9‒42　共通の設定の場合

リソース名称

メンバー名

数

Schedule

name

1

Schedule

description

1

Schedule

scheduleType

1

PropertyValue

keyName

0〜n

PropertyValue

value

0〜n

即時実行の場合

プロパティの指定は不要です。

指定日時実行の場合

表9‒43　指定日時実行の場合

リソース名称

メンバー名

数

Schedule

scheduledStartTime

1

定期実行の場合

表9‒44　定期実行の場合

リソース名称

メンバー名

数

Schedule

recurrenceInterval

1

Schedule

recurrenceDayOfWeek

1

Schedule

recurrenceDayOfMonth

1

Schedule

recurrenceLastDayOfMonth

1

Schedule

recurrenceStartDate

1

Schedule

recurrenceTime

1

ステータスコード

リクエストに対するレスポンスとして返却されるステータスコードを，次の表に示します。

ステータスコード

メッセージ

説明

200

Created

成功しました。

400

Bad Request

引数が不正です。

401

Unauthorized

ログイン権限がありません。

404

Not found

権限が不正です。または，リソースがありません。

409

Conflict

タスクの状態が終了またはキャンセルではありません。

412

Precondition failed

サーバが利用できません。

500

Server-side error

サーバ処理エラーが発生しました。

レスポンスのスキーマ

リクエストに対するレスポンスボディーの構造は，次のようになっています。

{
  "instanceId" : "instance-id",
  "created" : "created-date-and-time",
  "updated" : "updated-date-and-time",
  "completed" : "completed-date-and-time",
  "state" : "state",
  "affectedResources" : [ {...} ]
}

「affectedResources」のメンバーとして出力されるオブジェクトを，次の表で説明します。

表9‒45　「affectedResources」のメンバーとして出力されるオブジェクト（タスクの再実行）

出力

リソース名称

数

説明

作成されたスケジュールへのリンク

String

1

作成されたスケジュール機能のリソース（Schedules）へのリンク

作成されたタスクへのリンク

String

1

作成されたタスク機能のリソース（Tasks）へのリンク

使用例

instanceID=2026のタスクを再実行する場合の使用例を示します。

リクエストヘッダー:

POST /Automation/v1/objects/Tasks/2026/actions/resubmit/invoke HTTP/1.1
Host:10.196.184.238:22015
Accept:application/json
Accept-Language: ja
Content-Type: application/json
Content-Length: 821
Authorization: Basic c3lzdGVtOm1hbmFnZXI=
User-Agent: useragent1

レスポンスヘッダー:

HTTP/1.1 200 OK
Date: Mon, 14 Jul 2014 12:19:39 GMT
Server: Cosminexus HTTP Server
Access-Control-Expose-Headers: WWW-Authenticate
WWW-Authenticate: HSSO 5011884058b535482bf6bac7390956be5fc2122_V0300
Access-Control-Allow-Origin: *
Access-Control-Allow-Methods: GET, POST, DELETE, PUT, HEAD, OPTIONS
Access-Control-Allow-Credentials: true
Cache-Control: no-cache
Transfer-Encoding: chunked
Content-Type: application/json

レスポンスボディー:

{
  "instanceID" : "d2a2284f-9a94-4be0-8813-e5f991762740",
  "created" : "2014-07-14T05:19:40.089-0700",
  "updated" : "2014-07-14T05:19:40.089-0700",
  "completed" : "2014-07-14T05:19:40.089-0700",
  "state" : "success",
  "affectedResource" : [ "http://10.196.184.238:22015/Automation/v1/objects/Schedules/2060", "http://10.196.184.238:22015/Automation/v1/objects/Tasks/2063" ]
}

9.6.8　タスクのリトライに必要な情報の取得（失敗したステップからリトライ）

機能

タスクを指定し，失敗したステップからリトライするために必要な情報を取得します。

実行権限

Adminロール，Developロール，Modifyロール，Submitロール

APIのバージョン

v1

リクエスト形式

GET http://host:port/Automation/version/objects/Tasks/id/actions/rerunStart

ステータスコード

リクエストに対するレスポンスとして返却されるステータスコードを，次の表に示します。

ステータスコード

メッセージ

説明

200

OK

成功しました。

401

Unauthorized

ログイン権限がありません。

404

Not found

権限が不正です。または，リソースがありません。

412

Precondition failed

サーバが利用できません。

500

Server-side error

サーバ処理エラーが発生しました。

レスポンスのスキーマ

リクエストに対するレスポンスボディーの構造を次に示します。

{
  "name" : "rerunStart",
  "href" : "http://host:port/Automation/version/objects/Tasks/id/actions/rerunStart/invoke",
  "method" : "POST",
  "parameters" : null
}

使用例

instanceID=2026のタスクを，失敗したステップからリトライするために必要となる情報を，取得する場合の使用例を示します。

リクエストヘッダー:

GET /Automation/v1/objects/Tasks/2026/actions/rerunStart HTTP/1.1
Host:10.196.184.238:22015
Accept:application/json
Accept-Language: ja
Authorization: Basic c3lzdGVtOm1hbmFnZXI=
User-Agent: useragent1

レスポンスヘッダー:

HTTP/1.1 200 OK
Date: Mon, 14 Jul 2014 11:54:52 GMT
Server: Cosminexus HTTP Server
Access-Control-Expose-Headers: WWW-Authenticate
WWW-Authenticate: HSSO aca0707d2fae7c881d4a97f42ab4a5b27824aa_V0300
Access-Control-Allow-Origin: *
Access-Control-Allow-Methods: GET, POST, DELETE, PUT, HEAD, OPTIONS
Access-Control-Allow-Credentials: true
Cache-Control: no-cache
Transfer-Encoding: chunked
Content-Type: application/json

レスポンスボディー:

{
  "name" : "rerunStart",
  "href" : "http://10.196.184.238:22015/Automation/v1/objects/Tasks/2026/actions/rerunStart/invoke",
  "method" : "POST",
  "parameters" : [ ]
}

関連トピック

9.6.9　失敗したステップからリトライ

9.6.9　失敗したステップからリトライ

機能

タスクを指定し，失敗したステップからリトライします。

実行権限

Adminロール，Developロール，Modifyロール，Submitロール

APIのバージョン

v1

リクエスト形式

POST http://host:port/Automation/version/objects/Tasks/id/actions/rerunStart/invoke

リクエストボディーの構造は，次のようになっています。

{
  "name" : "rerunStart",
  "href" : "http://host:port/Automation/version/objects/Tasks/id/actions/rerunStart/invoke",
  "method" : "POST",
  "parameters" : null
}

ステータスコード

リクエストに対するレスポンスとして返却されるステータスコードを，次の表に示します。

ステータスコード

メッセージ

説明

200

Created

成功しました。

400

Bad Request

引数が不正です。

401

Unauthorized

ログイン権限がありません。

404

Not found

権限が不正です。または，リソースがありません。

409

Conflict

タスクの状態が失敗ではありません。

412

Precondition failed

サーバが起動していません。

500

Server-side error

サーバ処理エラーが発生しました。

レスポンスのスキーマ

リクエストに対するレスポンスボディーの構造は，次のようになっています。

{
  "instanceId" : "instance-id",
  "created" : "created-date-and-time",
  "updated" : "updated-date-and-time",
  "completed" : "completed-date-and-time",
  "state" : "state",
  "affectedResources" : [ {...} ]
}

「affectedResources」のメンバーとして出力されるオブジェクトを，次の表で説明します。

表9‒46　「affectedResources」のメンバーとして出力されるオブジェクト（失敗したステップからリトライ）

出力

リソース名称

数

説明

影響を受けたタスクへのリンク

String

1

更新されたタスク機能のリソース（Tasks）へのリンク

使用例

instanceID=2052のタスクを，失敗したステップからリトライする場合の使用例を示します。

リクエストヘッダー:

POST /Automation/v1/objects/Tasks/2052/actions/rerunStart/invoke HTTP/1.1
Host:10.196.184.238:22015
Accept:application/json
Accept-Language: ja
Content-Type: application/json
Content-Length: 184
Authorization: Basic c3lzdGVtOm1hbmFnZXI=
User-Agent: useragent1

レスポンスヘッダー:

HTTP/1.1 200 OK
Date: Mon, 14 Jul 2014 11:58:17 GMT
Server: Cosminexus HTTP Server
Access-Control-Expose-Headers: WWW-Authenticate
WWW-Authenticate: HSSO 4c41b543aa586cdc7eda448abadac3ff6268be_V0300
Access-Control-Allow-Origin: *
Access-Control-Allow-Methods: GET, POST, DELETE, PUT, HEAD, OPTIONS
Access-Control-Allow-Credentials: true
Cache-Control: no-cache
Transfer-Encoding: chunked
Content-Type: application/json

レスポンスボディー:

{
  "instanceID" : "cabe6176-498a-44ed-9691-5d270213f9b7",
  "created" : "2014-07-14T04:58:17.957-0700",
  "updated" : "2014-07-14T04:58:17.957-0700",
  "completed" : "2014-07-14T04:58:17.957-0700",
  "state" : "success",
  "affectedResource" : [ "http://10.196.184.238:22015/Automation/v1/objects/Tasks/2052" ]
}

9.6.10　タスクのリトライに必要な情報の取得（失敗した次のステップからリトライ）

機能

タスクを指定し，失敗した次のステップからリトライするために必要な情報を取得します。

実行権限

Adminロール，Developロール，Modifyロール，Submitロール

APIのバージョン

v1

リクエスト形式

GET http://host:port/Automation/version/objects/Tasks/id/actions/rerunStepStart

ステータスコード

リクエストに対するレスポンスとして返却されるステータスコードを，次の表に示します。

ステータスコード

メッセージ

説明

200

OK

成功しました。

401

Unauthorized

ログイン権限がありません。

404

Not found

権限が不正です。または，リソースがありません。

412

Precondition failed

サーバが利用できません。

500

Server-side error

サーバ処理エラーが発生しました。

レスポンスのスキーマ

リクエストに対するレスポンスボディーの構造を次に示します。

{
  "name" : "rerunStepStart",
  "href" : "http://host:port/Automation/version/objects/Tasks/id/actions/rerunStepStart/invoke",
  "method" : "POST",
  "parameters" : null
}

使用例

instanceID=2026のタスクを，失敗した次のステップからリトライするために，必要な情報を取得する場合の使用例を示します。

リクエストヘッダー:

GET /Automation/v1/objects/Tasks/2026/actions/rerunStepStart HTTP/1.1
Host:10.196.184.238:22015
Accept:application/json
Accept-Language: ja
Authorization: Basic c3lzdGVtOm1hbmFnZXI=
User-Agent: useragent1

レスポンスヘッダー:

HTTP/1.1 200 OK
Date: Mon, 14 Jul 2014 11:54:52 GMT
Server: Cosminexus HTTP Server
Access-Control-Expose-Headers: WWW-Authenticate
WWW-Authenticate: HSSO aca0707d2fae7c881d4a97f42ab4a5b27824aa_V0300
Access-Control-Allow-Origin: *
Access-Control-Allow-Methods: GET, POST, DELETE, PUT, HEAD, OPTIONS
Access-Control-Allow-Credentials: true
Cache-Control: no-cache
Transfer-Encoding: chunked
Content-Type: application/json

レスポンスボディー:

{
  "name" : "rerunStepStart",
  "href" : "http://10.196.184.238:22015/Automation/v1/objects/Tasks/2026/actions/rerunStepStart/invoke",
  "method" : "POST",
  "parameters" : [ ]
}

関連トピック

9.6.11　失敗した次のステップからリトライ

9.6.11　失敗した次のステップからリトライ

機能

タスクを指定し，失敗した次のステップからリトライします。

実行権限

Adminロール，Developロール，Modifyロール，Submitロール

APIのバージョン

v1

リクエスト形式

POST http://host:port/Automation/version/objects/Tasks/id/actions/rerunStepStart/invoke

リクエストボディーの構造は，次のようになっています。

{
  "name" : "rerunStepStart",
  "href" : "http://host:port/Automation/version/objects/Tasks/id/actions/rerunStepStart/invoke",
  "method" : "POST",
  "parameters" : null
}

ステータスコード

リクエストに対するレスポンスとして返却されるステータスコードを，次の表に示します。

ステータスコード

メッセージ

説明

200

Created

成功しました。

400

Bad Request

引数が不正です。

401

Unauthorized

ログイン権限がありません。

404

Not found

権限が不正です。または，リソースがありません。

409

Conflict

タスクの状態が失敗ではありません。

412

Precondition failed

サーバが起動していません。

500

Server-side error

サーバ処理エラーが発生しました。

レスポンスのスキーマ

リクエストに対するレスポンスボディーの構造は，次のようになっています。

{
  "instanceId" : "instance-id",
  "created" : "created-date-and-time",
  "updated" : "updated-date-and-time",
  "completed" : "completed-date-and-time",
  "state" : "state",
  "affectedResources" : [ {...} ]
}

「affectedResources」のメンバーとして出力されるオブジェクトを，次の表で説明します。

表9‒47　「affectedResources」のメンバーとして出力されるオブジェクト（失敗した次のステップからリトライ）

出力

リソース名称

数

説明

影響を受けたタスクへのリンク

String

1

更新されたタスク機能のリソース（Tasks）へのリンク

使用例

instanceID=2052のタスクを失敗した次のステップからリトライする場合の使用例を示します。

リクエストヘッダー:

POST /Automation/v1/objects/Tasks/2052/actions/rerunStepStart/invoke HTTP/1.1
Host:10.196.184.238:22015
Accept:application/json
Accept-Language: ja
Content-Type: application/json
Content-Length: 184
Authorization: Basic c3lzdGVtOm1hbmFnZXI=
User-Agent: useragent1

レスポンスヘッダー:

HTTP/1.1 200 OK
Date: Mon, 14 Jul 2014 11:58:17 GMT
Server: Cosminexus HTTP Server
Access-Control-Expose-Headers: WWW-Authenticate
WWW-Authenticate: HSSO 4c41b543aa586cdc7eda448abadac3ff6268be_V0300
Access-Control-Allow-Origin: *
Access-Control-Allow-Methods: GET, POST, DELETE, PUT, HEAD, OPTIONS
Access-Control-Allow-Credentials: true
Cache-Control: no-cache
Transfer-Encoding: chunked
Content-Type: application/json

レスポンスボディー:

{
  "instanceID" : "cabe6176-498a-44ed-9691-5d270213f9b7",
  "created" : "2014-07-14T04:58:17.957-0700",
  "updated" : "2014-07-14T04:58:17.957-0700",
  "completed" : "2014-07-14T04:58:17.957-0700",
  "state" : "success",
  "affectedResource" : [ "http://10.196.184.238:22015/Automation/v1/objects/Tasks/2052" ]
}

9.6.12　ステップの一覧取得

機能

指定したタスクに含まれるステップのうち，［タスク詳細］ダイアログボックスに表示されるステップの一覧を取得します。

実行権限

Adminロール，Developロール，Modifyロール，Submitロール

APIのバージョン

v1

リクエスト形式

GET http://host:port/Automation/version/objects/FlowSteps

クエリパラメータとしてtaskIDを必ず指定してください。

taskIDを指定することで対象のタスクを絞り込みます。そのタスクに含まれるステップのうち，［タスク詳細］ダイアログボックスに表示されるステップの一覧を取得できます。クエリパラメータの指定がない場合，または複数のクエリパラメータを指定した場合はエラーになります。クエリパラメータは，次の形式で指定してください。

?クエリパラメータ=値[&クエリパラメータ=値...]

表9‒48　API「ステップの一覧取得」に指定できるクエリパラメータの一覧

クエリパラメータ

フィルタ条件

taskID

指定した値と等しい

そのほかに指定できるクエリパラメータについては，「9.2.9　クエリパラメータ」を参照してください。

指定例

クエリパラメータとしてtaskIDに512を指定する例を次に示します。

?taskID=512

ステータスコード

リクエストに対するレスポンスとして返却されるステータスコードを，次の表に示します。

ステータスコード

メッセージ

説明

200

Created

成功しました。

400

Bad Request

引数が不正です。

401

Unauthorized

ログイン権限がありません。

404

Not found

権限が不正です。または，リソースがありません。

412

Precondition failed

サーバが起動していません。

500

Server-side error

サーバ処理エラーが発生しました。

レスポンスのスキーマ

リクエストに対するレスポンスボディーの構造を次に示します。

{
  "data" : [ {"ステップ機能のリソース（FlowSteps）のメンバー" : 値 ... }, ... ],
  "count" : クエリパラメータの条件に合致したデータの個数（0〜n）
}

使用例

タスクID「2052」のタスクが実行するステップの一覧を取得する場合の使用例を示します。

リクエストヘッダー:

GET /Automation/v1/objects/FlowSteps?taskID=2052 HTTP/1.1
Host:10.196.184.238:22015
Accept:application/json
Accept-Language: ja
Authorization: Basic c3lzdGVtOm1hbmFnZXI=
User-Agent: useragent1

レスポンスヘッダー:

HTTP/1.1 200 OK
Date: Mon, 14 Jul 2014 12:51:18 GMT
Server: Cosminexus HTTP Server
Access-Control-Expose-Headers: WWW-Authenticate
WWW-Authenticate: HSSO 91b080f3e0409735fa1583e8e4d6409daa4433f8_V0300
Access-Control-Allow-Origin: *
Access-Control-Allow-Methods: GET, POST, DELETE, PUT, HEAD, OPTIONS
Access-Control-Allow-Credentials: true
Cache-Control: no-cache
Transfer-Encoding: chunked
Content-Type: application/json

レスポンスボディー:
{
  "data" : [ {
    "instanceID" : "remoteHostCommandExe_2052",
    "name" : "remoteHostCommandExe",
    "startTime" : "2014-07-14 04:57:10",
    "completionTime" : "2014-07-14 04:57:34",
    "jobStatus" : "normal",
    "comment" : "Executes a command on the remote execution target server and displays the results.",
    "stepStatus" : "complete"
  } ],
  "count" : 1
}

9.6.13　タスクログの取得

機能

指定したタスクのタスクログを取得します。

実行権限

Adminロール，Developロール，Modifyロール，Submitロール

APIのバージョン

v1

リクエスト形式

GET http://host:port/Automation/version/objects/TaskLogs

APIの実行ユーザーが権限を持つすべてのタスクを対象に，指定したtaskIDのタスクログを取得します。クエリパラメータを指定すると，一覧を取得する対象を絞り込めます。

指定したtaskIDのタスクログを，offsetに指定した値を起点にし，最大でreadSize分取得します。reverseを指定した場合は，offsetから逆方向にreadSize分取得します。クエリパラメータは，次の形式で指定してください。

なお，ログは行単位で取得されます。指定したログサイズに達した場合は，取得中の行は取得されません。

?クエリパラメータ=値[&クエリパラメータ=値...]

表9‒49　API「タスクログの取得」に指定できるクエリパラメータの一覧

クエリパラメータ

フィルタ条件

taskID

指定した値と等しい

readSize

指定した値と等しい（ただし，タスクログの最後まで）

offset

指定した値と等しい

reverse※

offsetからの取得方向を逆にする

注※

reverseには，値を指定しないでください。

そのほかに指定できるクエリパラメータについては，「9.2.9　クエリパラメータ」を参照してください。

指定例

taskID=512のタスクログを，読み出し位置3,000バイトから逆方向に1,000バイト分，取得する場合の指定例を次に示します。

?taskID=512&offset=3000&readSize=1000&reverse

ステータスコード

リクエストに対するレスポンスとして返却されるステータスコードを，次の表に示します。

ステータスコード

メッセージ

説明

200

Created

成功しました。

400

Bad Request

引数が不正です。

401

Unauthorized

ログイン権限がありません。

404

Not found

権限が不正です。または，リソースがありません。

412

Precondition failed

サーバが起動していません。

500

Server-side error

サーバ処理エラーが発生しました。

レスポンスのスキーマ

リクエストに対するレスポンスボディーの構造を次に示します。

{
  "data" : [ {"タスクログ機能のリソース（Tasklogs）のメンバー" : 値 ... }, ... ],
  "count" : クエリパラメータの条件に合致したデータの個数（0〜n）
}

使用例

taskID=2052のタスクログを，最初（読み出し位置0バイト）から5,000,000バイト分，取得する場合の使用例を示します。

リクエストヘッダー:

GET /Automation/v1/objects/TaskLogs?taskID=2052&offset=0&readSize=5000000 HTTP/1.1
Host:10.196.184.238:22015
Accept:application/json
Accept-Language: ja
Authorization: Basic c3lzdGVtOm1hbmFnZXI=
User-Agent: useragent1

レスポンスヘッダー:

HTTP/1.1 200 OK
Date: Mon, 14 Jul 2014 12:42:47 GMT
Server: Cosminexus HTTP Server
Access-Control-Expose-Headers: WWW-Authenticate
WWW-Authenticate: HSSO a6daa83f23a873c39c7a65069728796ce882153_V0300
Access-Control-Allow-Origin: *
Access-Control-Allow-Methods: GET, POST, DELETE, PUT, HEAD, OPTIONS
Access-Control-Allow-Credentials: true
Cache-Control: no-cache
Transfer-Encoding: chunked
Content-Type: application/json

レスポンスボディー

{
  "data" : [ {
    "instanceID" : 2052,
    "text" : "**** Windows Server 2008 R2 6.1
TZ=America/Los_Angeles
2014/07/14 04:57:31.730¥r¥n
yyyy/mm/dd hh:mm:ss.sss                      pid      tid      message-id            message(LANG=ja)¥r¥n
8947 2014/07/14 04:57:31.746     Automation       27A4F43E 12252248 KNAE08001-I           部品実行を開始しました（タスク名：Execute remote command_20140714045708，タスクID：2052，ステップID：/remoteHostCommandExe，実行ID：@A102）。¥r¥n
9101 2014/07/14 04:57:31.824     Automation       27A4F43E 12252248 KNAE08129-I           汎用コマンド実行を開始しました（コマンド：a）。¥r¥n
9103 2014/07/14 04:57:31.824     Automation       27A4F43E 12252248 KNAE08070-I           root権限に昇格する設定（SSH接続用）が有効になっています。¥r¥n
9140 2014/07/14 04:57:34.433     Automation       27A4F43E 12252248 KNAE08131-E      ER   汎用コマンド実行に失敗しました（コマンド：a，部品戻り値：77）。¥r¥n
9148 2014/07/14 04:57:34.449     Automation       27A4F43E 12252248 KNAE08002-I           部品実行を終了しました（タスク名：Execute remote command_20140714045708，タスクID：2052，ステップID：/remoteHostCommandExe，実行ID：@A102，部品戻り値：77）。¥r¥n
9152 2014/07/14 04:57:34.449     Automation       27A4F43E 12252248 KNAE08004-I           schema_version=1.1¥r¥n9154 2014/07/14 04:57:34.449     Automation       27A4F43E 12252248 KNAE08004-I           vendor=com.hitachi.software.dna¥r¥n
9156 2014/07/14 04:57:34.449     Automation       27A4F43E 12252248 KNAE08004-I           name=ExecuteCommandPlugin¥r¥n9158 2014/07/14 04:57:34.449     Automation       27A4F43E 12252248 KNAE08004-I           version=01.10.00¥r¥n
9160 2014/07/14 04:57:34.449     Automation       27A4F43E 12252248 KNAE08004-I           plugin_type=javaClass¥r¥n9162 2014/07/14 04:57:34.449     Automation       27A4F43E 12252248 KNAE08004-I           vendor_display_name=(株)日立製作所¥r¥n
9164 2014/07/14 04:57:34.449     Automation       27A4F43E 12252248 KNAE08004-I           display_name=汎用コマンド実行部品¥r¥n
9166 2014/07/14 04:57:34.449     Automation       27A4F43E 12252248 KNAE08004-I           short_description=コマンドラインを対象ホストで実行する部品です。¥r¥n
9168 2014/07/14 04:57:34.449     Automation       27A4F43E 12252248 KNAE08004-I           tags=Basic,Hitachi¥r¥n9170 2014/07/14 04:57:34.449     Automation       27A4F43E 12252248 KNAE08004-I           enable_SSH_charset_detection=true¥r¥n
9172 2014/07/14 04:57:34.449     Automation       27A4F43E 12252248 KNAE08004-I           property=com.hitachi.software.dna.sys.mail.bcc, value=¥r¥n
9174 2014/07/14 04:57:34.449     Automation       27A4F43E 12252248 KNAE08004-I           property=com.hitachi.software.dna.sys.mail.cc, value=¥r¥n
9177 2014/07/14 04:57:34.449     Automation       27A4F43E 12252248 KNAE08004-I           property=com.hitachi.software.dna.sys.mail.from, value=********¥r¥n
9179 2014/07/14 04:57:34.449     Automation       27A4F43E 12252248 KNAE08004-I           property=com.hitachi.software.dna.sys.mail.notify, value=false¥r¥n
9182 2014/07/14 04:57:34.449     Automation       27A4F43E 12252248 KNAE08004-I           property=com.hitachi.software.dna.sys.mail.smtp.password, value=********¥r¥n
9184 2014/07/14 04:57:34.449     Automation       27A4F43E 12252248 KNAE08004-I           property=com.hitachi.software.dna.sys.mail.smtp.port, value=25¥r¥n
9186 2014/07/14 04:57:34.449     Automation       27A4F43E 12252248 KNAE08004-I           property=com.hitachi.software.dna.sys.mail.smtp.server, value=¥r¥n
9188 2014/07/14 04:57:34.449     Automation       27A4F43E 12252248 KNAE08004-I           property=com.hitachi.software.dna.sys.mail.smtp.userid, value=¥r¥n
9190 2014/07/14 04:57:34.449     Automation       27A4F43E 12252248 KNAE08004-I           property=com.hitachi.software.dna.sys.mail.to, value=¥r¥n
9192 2014/07/14 04:57:34.449     Automation       27A4F43E 12252248 KNAE08004-I           property=com.hitachi.software.dna.sys.task.log.level, value=10¥r¥n
9194 2014/07/14 04:57:34.449     Automation       27A4F43E 12252248 KNAE08004-I           property=common.remoteCommand, value=a¥r¥n
9196 2014/07/14 04:57:34.449     Automation       27A4F43E 12252248 KNAE08004-I           property=common.remoteCommandParameter, value=a¥r¥n
9198 2014/07/14 04:57:34.449     Automation       27A4F43E 12252248 KNAE08004-I           property=common.stdoutProperty, value=¥r¥n
9200 2014/07/14 04:57:34.449     Automation       27A4F43E 12252248 KNAE08004-I           property=common.targetHost, value=a¥r¥n
9202 2014/07/14 04:57:34.449     Automation       27A4F43E 12252248 KNAE08004-I           property=foreach.max_value, value=3¥r¥n
9204 2014/07/14 04:57:34.449     Automation       27A4F43E 12252248 KNAE08004-I           property=mail.plugin.retry.interval, value=10¥r¥n
9206 2014/07/14 04:57:34.449     Automation       27A4F43E 12252248 KNAE08004-I           property=mail.plugin.retry.times, value=3¥r¥n
9208 2014/07/14 04:57:34.449     Automation       27A4F43E 12252248 KNAE08004-I           property=plugin.private.builtin.baseUrl, value=http://WIN-JLTV0PQLK2A:22015/Automation/¥r¥n
9210 2014/07/14 04:57:34.449     Automation       27A4F43E 12252248 KNAE08004-I           property=reserved.service.category, value=OS_Operations/Basic¥r¥n
9212 2014/07/14 04:57:34.449     Automation       27A4F43E 12252248 KNAE08004-I           property=reserved.service.name, value=Execute remote command¥r¥n
9214 2014/07/14 04:57:34.449     Automation       27A4F43E 12252248 KNAE08004-I           property=reserved.service.resourceGroupName, value=Default Service Group¥r¥n
9216 2014/07/14 04:57:34.449     Automation       27A4F43E 12252248 KNAE08004-I           property=reserved.step.path, value=/remoteHostCommandExe¥r¥n
9218 2014/07/14 04:57:34.449     Automation       27A4F43E 12252248 KNAE08004-I           property=reserved.step.prevReturnCode, value=0¥r¥n
9220 2014/07/14 04:57:34.449     Automation       27A4F43E 12252248 KNAE08004-I           property=reserved.task.description, value=¥r¥n
9222 2014/07/14 04:57:34.449     Automation       27A4F43E 12252248 KNAE08004-I           property=reserved.task.dir, value=C:¥¥Program Files¥¥HiCommand¥¥Automation¥¥data¥¥task¥¥2052¥r¥n
9224 2014/07/14 04:57:34.449     Automation       27A4F43E 12252248 KNAE08004-I           property=reserved.task.id, value=2052¥r¥n
9226 2014/07/14 04:57:34.449     Automation       27A4F43E 12252248 KNAE08004-I           property=reserved.task.name, value=Execute remote command_20140714045708¥r¥n
9228 2014/07/14 04:57:34.449     Automation       27A4F43E 12252248 KNAE08004-I           property=reserved.task.submitter, value=System¥r¥n
9230 2014/07/14 04:57:34.449     Automation       27A4F43E 12252248 KNAE08004-I           property=reserved.task.url, value=http://WIN-JLTV0PQLK2A:22015/Automation/launcher/TaskDetails?task_id=2052¥r¥n
9232 2014/07/14 04:57:34.449     Automation       27A4F43E 12252248 KNAE08004-I           property=account, value=¥r¥n
9234 2014/07/14 04:57:34.449     Automation       27A4F43E 12252248 KNAE08004-I           property=commandLine, value=a¥r¥n
9236 2014/07/14 04:57:34.449     Automation       27A4F43E 12252248 KNAE08004-I           property=commandLineParameter, value=a¥r¥n
9238 2014/07/14 04:57:34.449     Automation       27A4F43E 12252248 KNAE08004-I           property=credentialType, value=destination¥r¥n
9240 2014/07/14 04:57:34.449     Automation       27A4F43E 12252248 KNAE08004-I           property=destinationHost, value=a¥r¥n
9243 2014/07/14 04:57:34.457     Automation       27A4F43E 12252248 KNAE08004-I           property=password, value=********¥r¥n
9245 2014/07/14 04:57:34.457     Automation       27A4F43E 12252248 KNAE08004-I           property=stdoutPattern1, value=((?s).*)¥r¥n
9247 2014/07/14 04:57:34.457     Automation       27A4F43E 12252248 KNAE08004-I           property=stdoutPattern2, value=¥r¥n
9249 2014/07/14 04:57:34.457     Automation       27A4F43E 12252248 KNAE08004-I           property=stdoutPattern3, value=¥r¥n
9252 2014/07/14 04:57:34.457     Automation       27A4F43E 12252248 KNAE08004-I           property=suPassword, value=********¥r¥n
9254 2014/07/14 04:57:34.457     Automation       27A4F43E 12252248 KNAE08009-I           部品の標準出力はありません。¥r¥n
9258 2014/07/14 04:57:34.699     Automation       27A4F43E 12252248 KNAE08014-E      ER   指定された接続先ホスト名の名前解決に失敗しました（詳細情報：a  [errno=11004, syscall=getaddrinfo]）。
指定された接続先ホスト名の名前解決ができません。接続先ホスト名の指定値，ネットワークおよびDNSの設定を確認して，再度サービスを実行してください。¥r¥n
9260 2014/07/14 04:57:34.699     Automation       27A4F43E 12252248 KNAE08016-E      ER   部品実行で障害が発生しました（タスク名：Execute remote command_20140714045708，タスクID：2052，ステップID：/remoteHostCommandExe，実行ID：@A102，部品戻り値：77）。¥r¥n
次の要因が考えられます。¥r¥n・部品実行で何らかの障害が発生した。¥r¥n・タスクの強制停止操作が行われた。¥r¥n
・本製品の停止操作が行われた。¥r¥n
タスクログおよび公開ログ(Server[n].log)の発生時刻前後のメッセージを確認して対処してください。タスクの強制停止や本製品の停止操作の形跡がなく，
発生時刻前後にエラーメッセージも出力されていない場合は，資料採取ツールで資料を採取し，システム管理者に連絡してください。¥r¥n
**** Windows Server 2008 R2 6.1                                                    TZ=America/Los_Angeles           2014/07/14 04:58:17.793¥r¥n
yyyy/mm/dd hh:mm:ss.sss                      pid      tid      message-id            message(LANG=ja)¥r¥n
9913 2014/07/14 04:58:17.793     Automation       27A4F43E 1A87FBF6 KNAE08904-I           失敗した次のステップからリトライしました（ユーザーID：System）。¥r¥n",
    "totalSize" : 9477,
    "readSize" : 9477,
    "lineCount" : 66,
    "offset" : 0,
    "reverse" : false
  } ],
  "count" : 1
}

9.7　プロパティ関連のAPI一覧

プロパティ定義またはプロパティ値を管理するための操作を説明します。

9.7.1　プロパティ定義一覧の取得

機能

プロパティ定義の一覧を取得します。取得できるのは，入出力種別が，in，outのサービスプロパティ，またはサービス共有プロパティです。

実行権限

Adminロール，Developロール，Modifyロール，Submitロール

APIのバージョン

v1

リクエスト形式

GET http://host:port/Automation/version/objects/PropertyDefinitions

APIの実行ユーザーが権限を持つ，すべてのサービスおよびタスクを対象として，プロパティ定義の一覧を取得します。クエリパラメータを指定すると，取得する対象を絞り込めます。クエリパラメータは，次の形式で指定してください。

?クエリパラメータ=値[&クエリパラメータ=値...]

表9‒50　API「プロパティ定義一覧の取得」に指定できるクエリパラメータの一覧

クエリパラメータ

フィルタ条件

serviceID

指定した値と等しい

taskID

指定した値と等しい

そのほかに指定できるクエリパラメータについては，「9.2.9　クエリパラメータ」を参照してください。

指定例

クエリパラメータとして，serviceIDに16731を，taskIDに512を指定する例を次に示します。

?serviceID=16731&taskID=512

ステータスコード

リクエストに対するレスポンスとして返却されるステータスコードを，次の表に示します。

ステータスコード

メッセージ

説明

200

OK

成功しました。

401

Unauthorized

ログイン権限がありません。

412

Precondition failed

サーバが利用できません。

500

Server-side error

サーバ処理エラーが発生しました。

レスポンスのスキーマ

レスポンスボディーには，リクエストで指定したクエリパラメータの条件に合致したデータが返却されます。レスポンスボディーのスキーマを次に示します。

{
  "data" : [ {"プロパティ定義機能のリソース（PropertyDefinitions）のメンバー" : 値 ... }, ... ],
  "count" : クエリパラメータの条件に合致したデータの個数（0〜n）
}

使用例

すべてのサービスおよびタスクを対象として，プロパティ定義の一覧を取得する場合の使用例を次に示します。

リクエストヘッダー:

GET /Automation/v1/objects/PropertyDefinitions HTTP/1.1
Host:10.196.184.238:22015
Accept:application/json
Accept-Language: ja
Authorization: Basic c3lzdGVtOm1hbmFnZXI=
User-Agent: useragent1

レスポンスヘッダー:

HTTP/1.1 200 OK
Date: Mon, 14 Jul 2014 12:36:09 GMT
Server: Cosminexus HTTP Server
Access-Control-Expose-Headers: WWW-Authenticate
WWW-Authenticate: HSSO 5f652d484555f1b2f289a33be680d83212cd6e35_V0300
Access-Control-Allow-Origin: *
Access-Control-Allow-Methods: GET, POST, DELETE, PUT, HEAD, OPTIONS
Access-Control-Allow-Credentials: true
Cache-Control: no-cache
Transfer-Encoding: chunked
Content-Type: application/json

レスポンスボディー:

{
  "data" : [ {
    "instanceID" : 44,
    "keyName" : "destinationHost",
    "displayName" : "Destination Host",
    "defaultValue" : "",
    "description" : "Specify the IP address or host name of the destination host. The destination host must be in a network environment that can communicate with the JP1/AO server. You cannot specify more than one destination host.",
    "mode" : "in",
    "required" : true
  }, {
    "instanceID" : 52,
    "keyName" : "destinationHost",
    "displayName" : "Destination Host",
    "defaultValue" : "",
    "description" : "Specify the IP address or host name of the destination host. The destination host must be in a network environment that can communicate with the JP1/AO server. You cannot specify more than one destination host.",
    "mode" : "in",
    "required" : true
  }, {
    "instanceID" : 82,
    "keyName" : "destinationHost",
    "displayName" : "Destination Host",
    "defaultValue" : "",
    "description" : "Specify the IP address or host name of the destination host. The destination host must be in a network environment that can communicate with the JP1/AO server. You cannot specify more than one destination host.",
    "mode" : "in",
    "required" : true
  }, {
    "instanceID" : 101,
    "keyName" : "destinationHost",
    "displayName" : "Destination Host",
    "defaultValue" : "",
    "description" : "Specify the IP address or host name of the destination host. The destination host must be in a network environment that can communicate with the JP1/AO server. You cannot specify more than one destination host.",
    "mode" : "in",
    "required" : true
  }, {
    "instanceID" : 267,
    "keyName" : "destinationHost",
    "displayName" : "Destination Host",
    "defaultValue" : "",
    "description" : "Specify the IPv4 address, IPv6 address or host name of the destination host. The destination host must be in a network environment that can communicate with the JP1/AO server. You cannot specify more than one destination host.",
    "mode" : "in",
    "required" : true
  }, {
    "instanceID" : 173,
    "keyName" : "foreachTask",
    "displayName" : "Repeatedly Executed Task",
    "defaultValue" : "",
    "description" : "Specify the full name of the jobnet to be executed repeatedly. You cannot specify a jobnet to be executed repeatedly if it is in a jobnet that is also executed repeatedly.",
    "mode" : "in",
    "required" : true
  }, {
    "instanceID" : 222,
    "keyName" : "stdoutProperty",
    "displayName" : "Standard Output Value",
    "defaultValue" : "",
    "description" : "Specify what is output to the standard output. Specify one or more keys of service property or reserved property (?dna_<propertyKey>?), literal characters, or any combination of the above.",
    "mode" : "in",
    "required" : true
  }, {
    "instanceID" : 121,
    "keyName" : "remoteHost",
    "displayName" : "Remote Host",
    "defaultValue" : "",
    "description" : "Specify the IP address or host name of the remote host. The remote host must be in a network environment that can communicate with the server. You cannot specify more than one remote host.",
    "mode" : "in",
    "required" : true
  }, {
    "instanceID" : 129,
    "keyName" : "remoteHost",
    "displayName" : "Remote Host",
    "defaultValue" : "",
    "description" : "Specify the IP address or host name of the remote host. The remote host must be in a network environment that can communicate with the server. You cannot specify more than one remote host.",
    "mode" : "in",
    "required" : true
  }, {
    "instanceID" : 144,
    "keyName" : "remoteHost",
    "displayName" : "Remote Host",
    "defaultValue" : "",
    "description" : "Specify the IP address or host name of the remote host. The remote host must be in a network environment that can communicate with the server. You cannot specify more than one remote host.",
    "mode" : "in",
    "required" : true
  }, {
    "instanceID" : 158,
    "keyName" : "remoteHost",
    "displayName" : "Remote Host",
    "defaultValue" : "",
    "description" : "Specify the IP address or host name of the remote host. The remote host must be in a network environment that can communicate with the server. You cannot specify more than one remote host.",
    "mode" : "in",
    "required" : true
  } ],
  "count" : 11
}

関連トピック

9.2.14　リソースのメンバー

9.7.2　プロパティ定義情報の取得

機能

指定したプロパティ定義の情報を取得します。

実行権限

Adminロール，Developロール，Modifyロール，Submitロール

APIのバージョン

v1

リクエスト形式

GET http://host:port/Automation/version/objects/PropertyDefinitions/id

ステータスコード

リクエストに対するレスポンスとして返却されるステータスコードを，次の表に示します。

ステータスコード

メッセージ

説明

200

OK

成功しました。

401

Unauthorized

ログイン権限がありません。

404

Not found

リクエストされたリソースまたは操作がありません。または，ユーザーにリソースの読み取り権限がありません。

412

Precondition failed

サーバが利用できません。

500

Server-side error

サーバ処理エラーが発生しました。

レスポンスのスキーマ

リクエストに対するレスポンスボディーの構造を次に示します。

{
  "instanceID" : instance-id,
  "keyName" : "key-name",
  "displayName" : "display-name",
  "defaultValue" : "default-value",
  "type" : "type",
  "visibility" : "visibility",
  "scope" : "scope",
  "description" : "description",
  "mode" : "mode",
  "required" : {true|false},
  "maxLength" : maxLength,
  "minLength" : minLength,
  "minValue" : "minRange",
  "maxValue" : "maxRange",
  "pattern" : "pattern",
  "valueList" : "valueList",
  "propertyGroupName" : "propertyGroupName"
}

使用例

instanceID=158のプロパティ定義の情報を取得する場合の使用例を示します。

リクエストヘッダー:

GET /Automation/v1/objects/PropertyDefinitions/158 HTTP/1.1
Host:10.196.184.238:22015
Accept:application/json
Accept-Language: ja
Authorization: Basic c3lzdGVtOm1hbmFnZXI=
User-Agent: useragent1

レスポンスヘッダー:

HTTP/1.1 200 OK
Date: Mon, 14 Jul 2014 12:37:24 GMT
Server: Cosminexus HTTP Server
Access-Control-Expose-Headers: WWW-Authenticate
WWW-Authenticate: HSSO 3096d91c11fd92d841b3513ed988ba758237cd1_V0300
Access-Control-Allow-Origin: *
Access-Control-Allow-Methods: GET, POST, DELETE, PUT, HEAD, OPTIONS
Access-Control-Allow-Credentials: true
Cache-Control: no-cache
Transfer-Encoding: chunked
Content-Type: application/json

レスポンスボディー:

{
  "instanceID" : 158,
  "keyName" : "remoteHost",
  "displayName" : "Remote Host",
  "defaultValue" : "",
  "description" : "Specify the IP address or host name of the remote host. The remote host must be in a network environment that can communicate with the server. You cannot specify more than one remote host.",
  "mode" : "in",
  "required" : true
}

9.7.3　プロパティ定義に対する操作一覧の取得

機能

指定したプロパティ定義に対して実行できる操作の一覧を取得します。

実行権限

Adminロール，Developロール，Modifyロール，Submitロール

APIのバージョン

v1

リクエスト形式

GET http://host:port/Automation/version/objects/PropertyDefinitions/id/actions

ステータスコード

リクエストに対するレスポンスとして返却されるステータスコードを，次の表に示します。

ステータスコード

メッセージ

説明

200

OK

成功しました。

401

Unauthorized

ログイン権限がありません。

412

Precondition failed

リクエストがほかのリクエストと競合しています。または，リクエストが現在のオブジェクトの状態と不一致です。

500

Server-side error

サーバ処理エラーが発生しました。

レスポンスのスキーマ

リクエストに対するレスポンスボディーの構造を次に示します。

{
  "data" : [ {"プロパティ定義機能のリソース（PropertyDefinitions）のメンバー" : 値 ... }, ... ],
  "count" : クエリパラメータの条件に合致したデータの個数（0〜n）
}

使用例

instanceID=158のプロパティ定義に対して実行できる操作の一覧を取得する場合の使用例を示します。

リクエストヘッダー:

GET /Automation/v1/objects/PropertyDefinitions/158/actions HTTP/1.1
Host:10.196.184.238:22015
Accept:application/json
Accept-Language: ja
Authorization: Basic c3lzdGVtOm1hbmFnZXI=
User-Agent: useragent1

レスポンスヘッダー:

HTTP/1.1 200 OK
Date: Mon, 14 Jul 2014 12:38:20 GMT
Server: Cosminexus HTTP Server
Access-Control-Expose-Headers: WWW-Authenticate
WWW-Authenticate: HSSO 78d4d9d37740a76bfe7212277228eb2db759bb10_V0300
Access-Control-Allow-Origin: *
Access-Control-Allow-Methods: GET, POST, DELETE, PUT, HEAD, OPTIONS
Access-Control-Allow-Credentials: true
Cache-Control: no-cache
Transfer-Encoding: chunked
Content-Type: application/json

レスポンスボディー:

{
  "data" : [ ],
  "count" : 0
}

9.7.4　プロパティ値一覧の取得

機能

次に示す値の一覧を取得します。

サービス共有プロパティ

特定のサービスに関連するプロパティ

特定のスケジュールに関連するプロパティ

特定のタスクに関連するプロパティ

実行権限

Adminロール，Developロール，Modifyロール，Submitロール

APIのバージョン

v1

リクエスト形式

GET http://host:port/Automation/version/objects/PropertyValues

APIの実行ユーザーが権限を持つ，すべてのサービス，スケジュール，タスクを対象としてプロパティ値の一覧を取得します。クエリパラメータを指定すると，一覧を取得する対象を絞り込めます。クエリパラメータは，次の形式で指定してください。

?クエリパラメータ=値[&クエリパラメータ=値...]

表9‒51　API「プロパティ値一覧の取得」で設定できるクエリパラメータ

クエリパラメータ

フィルター条件

serviceID

指定した値と等しい

scheduleID

指定した値と等しい

taskID

指定した値と等しい

そのほかに指定できるクエリパラメータについては，「9.2.9　クエリパラメータ」を参照してください。

指定例

クエリパラメータとして，serviceIDに16731を，taskIDに512を指定する例を次に示します。

?serviceID=16731&taskID=512

サービス，スケジュールまたはタスク用にプロパティ値を取得したい場合，serviceID，scheduleID，またはtaskIDのそれぞれに対応するクエリパラメータを指定する必要があります。クエリパラメータが指定されていない場合は，サービス共有プロパティだけがレスポンスとして返されます。

ステータスコード

リクエストに対するレスポンスとして返却されるステータスコードを，次の表に示します。

ステータスコード

メッセージ

説明

200

OK

成功しました。

401

Unauthorized

ログイン権限がありません。

412

Precondition failed

サーバが利用できません。

500

Server-side error

サーバ処理エラーが発生しました。

レスポンスのスキーマ

レスポンスボディーには，リクエストで指定したクエリパラメータの条件に合致したデータが返却されます。レスポンスボディーのスキーマを次に示します。

{
  "data" : [ {"プロパティ値管理機能のリソース（PropertyValues）のメンバー" : 値 ... }, ... ],
  "count" : クエリパラメータの条件に合致したデータの個数（0〜n）
}

使用例

すべてのサービス，スケジュール，タスクを対象として，プロパティ値一覧を取得する場合の使用例を示します。

リクエストヘッダー:

GET /Automation/v1/objects/PropertyValues HTTP/1.1
Host:10.196.184.238:22015
Accept:application/json
Accept-Language: ja
Authorization: Basic c3lzdGVtOm1hbmFnZXI=
User-Agent: useragent1

レスポンスヘッダー:

HTTP/1.1 200 OK
Date: Mon, 14 Jul 2014 12:40:06 GMT
Server: Cosminexus HTTP Server
Access-Control-Expose-Headers: WWW-Authenticate
WWW-Authenticate: HSSO 56ca4c95167e4ce4aeb51fa73a85b2923d65e28e_V0300
Access-Control-Allow-Origin: *
Access-Control-Allow-Methods: GET, POST, DELETE, PUT, HEAD, OPTIONS
Access-Control-Allow-Credentials: true
Cache-Control: no-cache
Transfer-Encoding: chunked
Content-Type: application/json

レスポンスボディー:

{
  "data" : [ {
    "instanceID" : 18,
    "type" : "boolean",
    "keyName" : "com.hitachi.software.dna.sys.mail.notify",
    "value" : "false",
  }, {
    "instanceID" : 11,
    "type" : "string",
    "keyName" : "com.hitachi.software.dna.sys.mail.smtp.server",
    "value" : "",
  }, {
    "instanceID" : 20,
    "type" : "integer",
    "keyName" : "com.hitachi.software.dna.sys.mail.smtp.port",
    "value" : "25",
  }, {
    "instanceID" : 5,
    "type" : "string",
    "keyName" : "com.hitachi.software.dna.sys.mail.smtp.userid",
    "value" : "",
  }, {
    "instanceID" : 13,
    "type" : "password",
    "keyName" : "com.hitachi.software.dna.sys.mail.smtp.password",
  }, {
    "instanceID" : 17,
    "type" : "string",
    "keyName" : "com.hitachi.software.dna.sys.mail.from",
    "value" : "",
  }, {
    "instanceID" : 12,
    "type" : "string",
    "keyName" : "com.hitachi.software.dna.sys.mail.to",
    "value" : "",
  }, {
    "instanceID" : 7,
    "type" : "string",
    "keyName" : "com.hitachi.software.dna.sys.mail.cc",
    "value" : "",
  }, {
    "instanceID" : 6,
    "type" : "string",
    "keyName" : "com.hitachi.software.dna.sys.mail.bcc",
    "value" : "",
  } ],
  "count" : 9
}

関連トピック

9.2.14　リソースのメンバー

9.7.5　プロパティ値の取得

機能

指定したプロパティ値の情報を取得します。

実行権限

Adminロール，Developロール，Modifyロール，Submitロール

APIのバージョン

v1

リクエスト形式

GET http://host:port/Automation/version/objects/PropertyValues/id

ステータスコード

リクエストに対するレスポンスとして返却されるステータスコードを，次の表に示します。

ステータスコード

メッセージ

説明

200

OK

成功しました。

401

Unauthorized

ログイン権限がありません。

404

Not found

リクエストされたリソースまたは操作がありません。または，ユーザーにリソースの読み取り権限がありません。

412

Precondition failed

サーバが利用できません。

500

Server-side error

サーバ処理エラーが発生しました。

レスポンスのスキーマ

リクエストに対するレスポンスボディーの構造を次に示します。

{
  "instanceID" : instance-id,
  "type" : "type",
  "keyName" : "key-name",
  "value" : "value"
  "serviceID" : service-id,
  "scheduleID" : schedule-id,
  "taskID" : task-id
}

使用例

instanceID=7のプロパティ値の情報を取得する場合の使用例を示します。

リクエストヘッダー:

GET /Automation/v1/objects/PropertyValues/7 HTTP/1.1
Host:10.196.184.238:22015
Accept:application/json
Accept-Language: ja
Authorization: Basic c3lzdGVtOm1hbmFnZXI=
User-Agent: useragent1

レスポンスヘッダー:

HTTP/1.1 200 OK
Date: Mon, 14 Jul 2014 12:40:54 GMT
Server: Cosminexus HTTP Server
Access-Control-Expose-Headers: WWW-Authenticate
WWW-Authenticate: HSSO 2dafa6e61f242ce903f1797053d0ebfba5566_V0300
Access-Control-Allow-Origin: *
Access-Control-Allow-Methods: GET, POST, DELETE, PUT, HEAD, OPTIONS
Access-Control-Allow-Credentials: true
Cache-Control: no-cache
Transfer-Encoding: chunked
Content-Type: application/json

レスポンスボディー:

{
  "instanceID" : 7,
  "type" : "string",
  "keyName" : "com.hitachi.software.dna.sys.mail.cc",
  "value" : "",
}

9.7.6　プロパティ値に対する操作一覧の取得

機能

指定したプロパティ値に対して実行できる操作の一覧を取得します。

実行権限

Adminロール，Developロール，Modifyロール，Submitロール

APIのバージョン

v1

リクエスト形式

GET http://host:port/Automation/version/objects/PropertyValues/id/actions

ステータスコード

リクエストに対するレスポンスとして返却されるステータスコードを，次の表に示します。

ステータスコード

メッセージ

説明

200

OK

成功しました。

401

Unauthorized

ログイン権限がありません。

412

Precondition failed

サーバが利用できません。

500

Server-side error

サーバ処理エラーが発生しました。

レスポンスのスキーマ

リクエストに対するレスポンスボディーの構造を次に示します。

{
  "data" : [ {"プロパティ値管理機能のリソース（PropertyValues）のメンバー" : 値 ... }, ... ],
  "count" : クエリパラメータの条件に合致したデータの個数（0〜n）
}

使用例

instanceID=7のプロパティ値に対して実行できる操作の一覧を取得する場合の使用例を示します。

リクエストヘッダー:

GET /Automation/v1/objects/PropertyValues/7/actions HTTP/1.1
Host:10.196.184.238:22015
Accept:application/json
Accept-Language: ja
Authorization: Basic c3lzdGVtOm1hbmFnZXI=
User-Agent: useragent1

レスポンスヘッダー:

HTTP/1.1 200 OK
Date: Mon, 14 Jul 2014 12:41:31 GMT
Server: Cosminexus HTTP Server
Access-Control-Expose-Headers: WWW-Authenticate
WWW-Authenticate: HSSO 35ddb1c916ffe060ce74527e258c78eaf78db5a_V0300
Access-Control-Allow-Origin: *
Access-Control-Allow-Methods: GET, POST, DELETE, PUT, HEAD, OPTIONS
Access-Control-Allow-Credentials: true
Cache-Control: no-cache
Transfer-Encoding: chunked
Content-Type: application/json

レスポンスボディー:

{
  "data" : [ ],
  "count" : 0
}

9.8　情報管理のAPI

ユーザー情報を取得したり，JP1/AOおよびAPIのバージョン情報を取得したりするための操作を説明します。

9.8.1　ユーザー情報の取得

機能

APIを実行したユーザーの情報を取得します。

実行権限

Adminロール，Developロール，Modifyロール，Submitロール

APIのバージョン

v1

リクエスト形式

GET http://host:port/Automation/version/user

ステータスコード

リクエストに対するレスポンスとして返却されるステータスコードについては，「9.2.17　ステータスコード」のトピックを参照してください。

レスポンスのスキーマ

リクエストに対するレスポンスボディーの構造を次に示します。

{
  "userName" : "user-name",
  "accessPermission" : [ ... ],
  "resourceGroup" : [ {
    "instanceId" : "instance-id",
    "name" : "resource-group-name",
    "description" : "description",
    "accessPermission" : [ ... ]
  } , ... ]
}

使用例

実行ユーザーの情報を取得する場合の使用例を示します。

リクエストヘッダー:

GET /Automation/v1/user HTTP/1.1
Host:10.196.184.238:22015
Accept:application/json
Accept-Language: ja
Authorization: Basic c3lzdGVtOm1hbmFnZXI=
User-Agent: useragent1

レスポンスヘッダー:

HTTP/1.1 200 OK
Date: Mon, 28 Jul 2014 03:21:30 GMT
Server: Cosminexus HTTP Server
Access-Control-Expose-Headers: WWW-Authenticate
WWW-Authenticate: HSSO ce680e5daa37d9873f31124c64fa8c4a435c21_WIN-JLTV0PQLK2A_V0810
Access-Control-Allow-Origin: *
Access-Control-Allow-Methods: GET, POST, DELETE, PUT, HEAD, OPTIONS
Access-Control-Allow-Credentials: true
Cache-Control: no-store, no-transform
Transfer-Encoding: chunked
Content-Type: application/json

レスポンスボディー:

{
  "userName" : "System",
  "accessPermission" : [ "User Management" ],
  "resourceGroup" : [ {
    "instanceId" : "Automation_RG_ALL",
    "name" : "All Service Groups",
    "description" : "default service groups which contains all services",
    "accessPermission" : [ "View", "Execute", "Develop", "Modify", "Admin" ]
  } ]
}

9.8.2　バージョン情報の取得

機能

JP1/AOとAPIのバージョンを取得します。

実行権限

Adminロール，Developロール，Modifyロール，Submitロール

APIのバージョン

v1

リクエスト形式

GET http://host:port/Automation/version/configuration/version

ステータスコード

リクエストに対するレスポンスとして返却されるステータスコードについては，「9.2.17　ステータスコード」のトピックを参照してください。

レスポンスのスキーマ

リクエストに対するレスポンスボディーの構造を次に示します。

{
  "productName" : "product-name",
  "productVersion" : "product-version",
  "apiVersion" : "api-version"
}

使用例

バージョン情報を取得する場合の使用例を示します。

リクエストヘッダー:

GET /Automation/v1/configuration/version HTTP/1.1
Host:10.196.184.238:22015
Accept:application/json
Accept-Language: ja
Authorization: Basic c3lzdGVtOm1hbmFnZXI=
User-Agent: useragent1

レスポンスヘッダー:

HTTP/1.1 200 OK
Date: Mon, 28 Jul 2014 04:34:59 GMT
Server: Cosminexus HTTP Server
Access-Control-Expose-Headers: WWW-Authenticate
WWW-Authenticate: HSSO 4e671d509ad3cd624d83afd9da20f55c1c261193_WIN-JLTV0PQLK2A_V0810
Access-Control-Allow-Origin: *
Access-Control-Allow-Methods: GET, POST, DELETE, PUT, HEAD, OPTIONS
Access-Control-Allow-Credentials: true
Cache-Control: no-cache
Transfer-Encoding: chunked
Content-Type: application/json

レスポンスボディー:

{
  "productName" : "JP1/Automatic Operation",
  "productVersion" : "10-50-00",
  "apiVersion" : "01.00.00"
}

9.9　APIの使用例

APIでサービスを実行する場合の使用例を示します。まず，実行したいサービスのinstanceIDを特定します。その後，実行契機を「即時実行」に指定して，サービスを実行する手順を説明します。

サービス機能のリソース（Services）の一覧を表示して，実行したいサービスのinstanceIDを確認します。

GET /Automation/v1/objects/Services/ HTTP/1.1
Host:10.197.112.78:23015
User-Agent:sample rest client/1.00.0
Accept:application/json
Accept-Language: ja
Authorization: Basic c3lzdGVtOm1hbmFnZXI=
User-Agent: useragent1

HTTP/1.1 200 OK
Date: Mon, 18 Aug 2014 11:15:01 GMT
Server: Cosminexus HTTP Server
Access-Control-Expose-Headers: WWW-Authenticate
WWW-Authenticate: HSSO b8712c86fcd026562182a358ea43bb23b09c62_V0300
Access-Control-Allow-Origin: *
Access-Control-Allow-Methods: GET, POST, DELETE, PUT, HEAD, OPTIONS
Access-Control-Allow-Credentials: true
Cache-Control: no-cache
Transfer-Encoding: chunked
Content-Type: application/json

{
  "data" : [ {
    "instanceID" : 2269, ←　instanceIDを確認する
    "name" : "リモートコマンド実行",
    "description" : "リモートの実行対象サーバ上のコマンドを実行します。",
    "tags" : "OS_Operations,Basic",
    "serviceTemplateName" : "リモートコマンド実行",
    "createTime" : "2014-08-18T16:53:50.000+0900",
    "modifyTime" : "2014-08-18T16:53:58.000+0900",
    "serviceState" : "release",
    "serviceGroupName" : "All Resources",
    "iconURL" : "http://10.197.112.78:23015/Automation/icon/services/com.hitachi.software.dna.cts.jp1/remoteCommandExe/01.10.00",
    "vendorName" : "Hitachi,Ltd.",
    "version" : "01.10.00",
    "latest" : true,
    "imageURL" : "http://10.197.112.78:23015/Automation/resources/images/overview/overview.png",
    "serviceTemplateID" : 2204,
    "serviceGroupID" : 2
  } ],
  "count" : 1
}

確認したinstanceIDを持つリソースに対して，実行できる操作の一覧を取得します。

GET /Automation/v1/objects/Services/2269/actions HTTP/1.1
Host:10.197.112.78:23015
User-Agent:sample rest client/1.00.0
Accept:application/json
Accept-Language: ja
Authorization: HSSO b8712c86fcd026562182a358ea43bb23b09c62_V0300

HTTP/1.1 200 OK
Date: Mon, 18 Aug 2014 11:24:41 GMT
Server: Cosminexus HTTP Server
Access-Control-Expose-Headers: WWW-Authenticate
WWW-Authenticate: HSSO b365e6a2cda2b4d195d55fee1461a6ed0889927_V0300
Access-Control-Allow-Origin: *
Access-Control-Allow-Methods: GET, POST, DELETE, PUT, HEAD, OPTIONS
Access-Control-Allow-Credentials: true
Cache-Control: no-cache
Transfer-Encoding: chunked
Content-Type: application/json

{
  "data" : [ {
    "name" : "submit",　←　サービスを実行したいため，submitのhref情報を確認する
    "href" : "http://10.197.112.78:23015/Automation/v1/objects/Services/2269/actions/submit/invoke",
    "method" : "POST",
    "parameters" : [ ]
  } ],
  "count" : 1
}

指定したサービスの実行操作に必要なリクエストボディーの情報を取得します。

GET /Automation/v1/objects/Services/2269/actions/submit HTTP/1.1
Host:10.197.112.78:23015
User-Agent:sample rest client/1.00.0
Accept:application/json
Accept-Language: ja
Authorization: HSSO b8712c86fcd026562182a358ea43bb23b09c62_V0300

HTTP/1.1 200 OK
Date: Mon, 18 Aug 2014 11:26:00 GMT
Server: Cosminexus HTTP Server
Access-Control-Expose-Headers: WWW-Authenticate
WWW-Authenticate: HSSO 1b9b5891c58315e26cd0cca9aac6d43e572e3db_V0300
Access-Control-Allow-Origin: *
Access-Control-Allow-Methods: GET, POST, DELETE, PUT, HEAD, OPTIONS
Access-Control-Allow-Credentials: true
Cache-Control: no-cache
Transfer-Encoding: chunked
Content-Type: application/json

レスポンスをファイル(properties.json)に出力

「properties.json」の内容

{
  "name" : "submit",
  "href" : "http://10.197.112.78:23015/Automation/v1/objects/Services/2269/actions/submit/invoke",
  "method" : "POST",
  "parameters" : [ {
    "name" : "リモートコマンド実行_20140818202600",
    "submitter" : "System",
    "scheduleType" : "immediate",
    "description" : "",
    "scheduledStartTime" : "2014-08-18T20:26:00.536+09:00",
    "recurrenceInterval" : "daily",
    "recurrenceDayOfWeek" : "",
    "recurrenceDayOfMonth" : "",
    "recurrenceLastDayOfMonth" : false,
    "recurrenceStartDate" : "2014-08-18",
    "recurrenceTime" : "00:00:00",
    "serviceID" : 2269
  }, {
    "instanceID" : 2275,
    "type" : "string",
    "keyName" : "common.targetHost",
    "value" : "",
    "serviceID" : 2269
  }, {
    "instanceID" : 2271,
    "type" : "string",
    "keyName" : "common.remoteCommand",
    "value" : "",
    "serviceID" : 2269
  }, {
    "instanceID" : 2273,
    "type" : "string",
    "keyName" : "common.remoteCommandParameter",
    "value" : "",
    "serviceID" : 2269
  } ]
}

取得したテンプレートの情報を必要に応じて編集します。実行契機を「即時実行」に指定する場合を示します。

{
  "name" : "submit",
  "href" : "http://10.197.112.78:23015/Automation/v1/objects/Services/2269/actions/submit/invoke",
  "method" : "POST",
  "parameters" : [ {
    "name" : "リモートコマンド実行_20140818202600",
    "submitter" : "System",
    "scheduleType" : "immediate",　←"immediate"を指定する
    "description" : "",
    "scheduledStartTime" : "2014-08-18T20:26:00.536+09:00",
    "recurrenceInterval" : "daily",
    "recurrenceDayOfWeek" : "",
    "recurrenceDayOfMonth" : "",
    "recurrenceLastDayOfMonth" : false,
    "recurrenceStartDate" : "2014-08-18",
    "recurrenceTime" : "00:00:00",
    "serviceID" : 2269
  }, {
    "instanceID" : 2275,
    "type" : "string",
    "keyName" : "common.targetHost",
    "value" : "",　　←　必要に応じてvalueを変更する
    "serviceID" : 2269
  }, {
    "instanceID" : 2271,
    "type" : "string",
    "keyName" : "common.remoteCommand",
    "value" : "hostname",　　←　必要に応じてvalueを変更する
    "serviceID" : 2269
  }, {
    "instanceID" : 2273,
    "type" : "string",
    "keyName" : "common.remoteCommandParameter",
    "value" : "",　　←　必要に応じてvalueを変更する
    "serviceID" : 2269
  } ]
}

編集した情報を使用して，サービスを実行します。

POST /Automation/v1/objects/Services/2269/actions/submit/invoke HTTP/1.1
Host:10.197.112.78:23015
User-Agent:sample rest client/1.00.0
Accept:application/json
Accept-Language: ja
Content-Type: application/json
Content-Length: 1087
Authorization: HSSO b8712c86fcd026562182a358ea43bb23b09c62_V0300

properties.jsonの内容をリクエストする

HTTP/1.1 200 OK
Date: Mon, 18 Aug 2014 11:39:03 GMT
Server: Cosminexus HTTP Server
Access-Control-Expose-Headers: WWW-Authenticate
WWW-Authenticate: HSSO 8ba382c1f2e81a65d7a252391b262624c6fa61_V0300
Access-Control-Allow-Origin: *
Access-Control-Allow-Methods: GET, POST, DELETE, PUT, HEAD, OPTIONS
Access-Control-Allow-Credentials: true
Cache-Control: no-cache
Transfer-Encoding: chunked
Content-Type: application/json

{
  "instanceID" : "4a9141e4-9566-4e42-af08-0f09926f2a5f",
  "created" : "2014-08-18T20:39:04.242+0900",
  "updated" : "2014-08-18T20:39:04.242+0900",
  "completed" : "2014-08-18T20:39:04.242+0900",
  "state" : "success",
  "affectedResource" : [ "http://10.197.112.78:23015/Automation/v1/objects/Schedules/2285" ←作成されたスケジュールリソースのURL,
　"http://10.197.112.78:23015/Automation/v1/objects/Tasks/2280" ←作成されたタスクリソースのURL ],
  "result" : [ ]
}

サービスの実行によって作成されたScheduleリソースを取得し，内容を確認します。

GET /Automation/v1/objects/Schedules/2285 HTTP/1.1
Host:10.197.112.78:23015
User-Agent:sample rest client/1.00.0
Accept:application/json
Accept-Language: ja
Authorization: HSSO b8712c86fcd026562182a358ea43bb23b09c62_V0300

HTTP/1.1 200 OK
Date: Mon, 18 Aug 2014 11:43:00 GMT
Server: Cosminexus HTTP Server
Access-Control-Expose-Headers: WWW-Authenticate
WWW-Authenticate: HSSO cafcefb87199122267f8ad33772555f9357c8a2_V0300
Access-Control-Allow-Origin: *
Access-Control-Allow-Methods: GET, POST, DELETE, PUT, HEAD, OPTIONS
Access-Control-Allow-Credentials: true
Cache-Control: no-cache
Transfer-Encoding: chunked
Content-Type: application/json

{
  "instanceID" : 2285,
  "name" : "リモートコマンド実行_20140818202600",
  "submitter" : "System",
  "scheduleType" : "immediate",
  "createTime" : "2014-08-18T20:39:03.000+0900",
  "modifyTime" : "2014-08-18T20:39:03.000+0900",
  "description" : "",
  "serviceState" : "release",
  "serviceID" : 2269
}

サービスの実行によって作成されたTaskリソースを取得し，内容を確認します。

GET /Automation/v1/objects/Tasks/2280 HTTP/1.1
Host:10.197.112.78:23015
User-Agent:sample rest client/1.00.0
Accept:application/json
Accept-Language: ja
Authorization: HSSO b8712c86fcd026562182a358ea43bb23b09c62_V0300

HTTP/1.1 200 OK
Date: Mon, 18 Aug 2014 11:43:59 GMT
Server: Cosminexus HTTP Server
Access-Control-Expose-Headers: WWW-Authenticate
WWW-Authenticate: HSSO 3713abcd1e99d1481c7b92cc9892a95d1a702d6_V0300
Access-Control-Allow-Origin: *
Access-Control-Allow-Methods: GET, POST, DELETE, PUT, HEAD, OPTIONS
Access-Control-Allow-Credentials: true
Cache-Control: no-cache
Transfer-Encoding: chunked
Content-Type: application/json

{
  "instanceID" : 2280,
  "name" : "リモートコマンド実行_20140818202600",
  "status" : "failed",
  "startTime" : "2014-08-18T20:39:04.000+0900",
  "completionTime" : "2014-08-18T20:39:13.000+0900",
  "submitter" : "System",
  "submitTime" : "2014-08-18T20:39:03.000+0900",
  "modifyTime" : "2014-08-18T20:39:19.000+0900",
  "serviceState" : "release",
  "scheduleType" : "immediate",
  "description" : "",
  "serviceName" : "リモートコマンド実行",
  "tags" : "",
  "serviceGroupName" : "All Resources",
  "serviceTemplateID" : 2204,
  "scheduleID" : 2285,
  "serviceGroupID" : 2,
  "serviceID" : 2269
}

付録

付録A　参考情報

ここでは，JP1/AOを使用する上での参考情報について説明します。

付録A.1　画面の制限値一覧

JP1/AOで使用する画面の制限値について次に示します。

表A‒1　画面の制限値一覧

画面名

項目

制限値

デフォルト

指定できる文字

［ログイン］画面

［ユーザーID］テキストボックスに入力できる文字列

256文字

なし

半角英数字，「!」，「#」，「$」，「%」，「&」，「'」，「(」，「)」，「*」，「+」，「-」，「.」，「=」，「@」，「¥」，「^」，「_」，「|」

［パスワード］テキストボックスに入力できる文字列

256文字

なし

半角英数字，「!」，「#」，「$」，「%」，「&」，「'」，「(」，「)」，「*」，「+」，「-」，「.」，「=」，「@」，「¥」，「^」，「_」，「|」

同一サーバ上のJP1/AOに同時に接続できる端末の数

64台

−

−

メイン画面

フィルタエリアのカレンダーで指定できる年月日

1994-01-01〜2036-12-31

なし

−

同一ホストで同時に起動できるメイン画面数

2個

−

−

フィルタ条件の最大数

20個

−

−

［サービス］画面

フィルタの［属性］項目に次のどれかを指定した場合に，［値］テキストフィールドに指定できる文字列

サービス名

リソースグループ

カテゴリ名

説明

サービステンプレート名

ベンダー名

サービスバージョン

4,096文字

なし

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

［サービス］画面から起動できる［サービス詳細説明］画面数

制限はありません。

−

−

［サービス実行］ダイアログボックス

［タスク名］テキストボックスに入力できる文字列

128文字

サービス名_YYYYMMDDhhmmss（サービスを実行した日付および時刻）

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

［タスクの説明］テキストボックスに入力できる文字列

256文字

なし

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

プロパティ一覧の［プロパティ値］テキストボックスに指定できる文字列（string）

1,024文字

サービステンプレートが保持するサービス定義情報に定義されているデフォルト値

ただし，デフォルト値が定義されていない場合は，空文字が表示される。

サービステンプレートが保持するサービス定義情報の入力文字制限に定義されている文字，かつ制御文字（¥u0000〜¥u001F および¥u007F〜¥u009F）以外の文字

プロパティ一覧の［プロパティ値］テキストボックスに指定できる文字列（integer）

-2147483648〜2147483647

プロパティ一覧の［プロパティ値］テキストボックスに指定できる文字列（double）

約±4.9×10⁻³²⁴〜±1.7×10³⁰⁸の数値

ただし，指数形式では入力できない。

プロパティ一覧の［プロパティ値］テキストボックスに指定できる文字列（password）

1,024文字

プロパティ一覧のカレンダーボタンで表示したカレンダーで指定できる年月日

1900-01-01〜2100-12-31

−

［実行開始日］テキストボックスのカレンダーボタンで表示したカレンダーで指定できる年月日

1994-01-01〜2036-12-31

なし

−

［実行開始時刻］スピンボックス（時）

23時

なし

半角数字

［実行開始時刻］スピンボックス（分）

59分

なし

半角数字

［定期実行時刻］スピンボックス（時）

23時

なし

半角数字

［定期実行時刻］スピンボックス（分）

59分

なし

半角数字

［定期実行日］テキストボックス

92文字

なし

1〜31の半角数字および「,」

1つのメイン画面から起動できる［サービス実行］ダイアログボックスの数

制限はありません。

−

−

［サービス実行］ダイアログボックスから起動できる［サービス詳細説明］画面数

制限はありません。

−

−

ダイレクトアクセスURLのクエリパラメータに指定できる文字数

1,024文字

なし

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

［サービス追加］ダイアログボックス

［サービス名］テキストボックスに入力できる文字列

64文字

なし

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

［説明］テキストボックスに入力できる文字列

256文字

なし

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

［カテゴリ名］テキストボックスに入力できる文字列

256文字

なし

次の文字以外が指定できる。

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）

「¥」

ただし，「/」および「,」は，先頭および末尾に指定できない。

フィルタの［属性］項目に次のどれかを指定した場合に，［値］テキストフィールドに指定できる文字列

カテゴリ名

説明

サービステンプレート名

ベンダー名

サービスバージョン

4,096文字

なし

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

［サービス追加］ダイアログボックスから起動できる［サービス詳細説明］画面数

制限はありません。

−

−

［サービス設定］ダイアログボックス

［サービス名］テキストボックスに入力できる文字列

64文字

設定対象のサービス名

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

［説明］に入力できる文字列

256文字

設定対象のサービスに設定されている説明

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

［カテゴリ名］テキストボックスに入力できる文字列

256文字

設定対象のサービスに設定されているカテゴリ名

次の文字以外が指定できる。

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）

「¥」

ただし，「/」および「,」は，先頭および末尾に指定できない。

プロパティ一覧の［プロパティ値］テキストボックスに指定できる文字列（string）

1,024文字

サービステンプレートが保持するサービス定義情報に定義されているデフォルト値

ただし，デフォルト値が定義されていない場合は，空文字が表示される。

サービステンプレートが保持するサービス定義情報の入力文字制限で定義されている文字，かつ制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

プロパティ一覧の［プロパティ値］テキストボックスに指定できる文字列（integer）

-2147483648〜2147483647

プロパティ一覧の［プロパティ値］テキストボックスに指定できる文字列（double）

約±4.9×10⁻³²⁴〜±1.7×10³⁰⁸の数値

ただし，指数形式では入力できない。

プロパティ一覧の［プロパティ値］テキストボックスに指定できる文字列（password）

1,024文字

プロパティ一覧のカレンダーボタンで表示したカレンダーで指定できる年月日

1900-01-01〜2100-12-31

−

1つのメイン画面から起動できる［サービス設定］ダイアログボックスの数

制限はありません。

−

−

［サービス設定］ダイアログボックスから起動できる［サービス詳細説明］画面数

制限はありません。

−

−

ダイレクトアクセスURLのクエリパラメータに指定できる文字数

1,024文字

なし

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

［タスク一覧］ビュー，［履歴］ビュー，各種タスク一覧ダイアログボックス

フィルタの［属性］項目に次のどれかを指定した場合に，［値］テキストフィールドに指定できる文字列

タスク名

タスクの説明

サービス名

リソースグループ

サービスカテゴリ

実行者

4,096文字

なし

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

フィルタの［属性］項目に「タスクID」を指定した場合に，［値］テキストフィールドに指定できる数値

9999999999999999

なし

半角数字

フィルタの［属性］項目に次のどれかを指定した場合に，時刻入力テキストフィールドで指定できる時刻（時）

開始予定日時

開始日時

終了日時

実行操作日時

定期実行時刻

23時

0

−

フィルタの［属性］項目に次のどれかを指定した場合に，時刻入力テキストフィールドで指定できる時刻（分）

開始予定日時

開始日時

終了日時

実行操作日時

定期実行時刻

59分

0

−

フィルタの［属性］項目に次のどれかを指定した場合に，時刻入力テキストフィールドで指定できる時刻（秒）

開始予定日時

開始日時

終了日時

実行操作日時

定期実行時刻

59秒

0

−

［デバッグタスク一覧］ビュー

フィルタの［属性］項目に次のどれかを指定した場合に，［値］テキストフィールドに指定できる文字列

タスク名

タスクの説明

サービス名

リソースグループ

サービスカテゴリ

実行者

サービステンプレート名

ベンダー名

サービスバージョン

4,096文字

なし

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

フィルタの［属性］項目に「タスクID」を指定した場合に，［値］テキストフィールドに指定できる数値

9999999999999999

なし

半角数字

フィルタの［属性］項目に次のどれかを指定した場合に，時刻入力テキストフィールドで指定できる時刻（時）

開始日時

終了日時

23時

0

−

フィルタの［属性］項目に次のどれかを指定した場合に，時刻入力テキストフィールドで指定できる時刻（分）

開始日時

終了日時

59分

0

−

フィルタの［属性］項目に次のどれかを指定した場合に，時刻入力テキストフィールドで指定できる時刻（秒）

開始日時

終了日時

59秒

0

−

［タスク詳細］ダイアログボックス

1つのメイン画面から起動できる［タスク詳細］ダイアログボックスの数

制限はありません。

−

−

ダイレクトアクセスURLのクエリパラメータに指定できる文字数

1,024文字

なし

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

［応答入力］ダイアログボックス

1つのメイン画面，［タスク詳細］ダイアログボックス，または［タスク一覧］ビューから起動できる［応答入力］ダイアログボックスの数

制限はありません。

−

−

［エージェントレス接続先定義］ビュー

フィルタの［属性］項目に次のどれかを指定した場合に［値］テキストフィールドで指定できる文字列

接続先

リソースグループ

ユーザーID

4,096文字

なし

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

［エージェントレス接続先定義作成］ダイアログボックス

［接続先］テキストボックスに入力できる文字列（［接続先種別］リストボックスでホスト名を選択している場合）

1,024文字

なし

Java SE5でサポートしている正規表現形式で使用できる文字

［接続先］テキストボックスに入力できる文字列（［接続先種別］リストボックスでIPv4を選択している場合）

1,024文字

なし

半角数字，「*」，「-」，「.」

［接続先］テキストボックスに入力できる文字列（［接続先種別］リストボックスでIPv6を選択している場合）

1,024文字

なし

RFC 2373に従ったユニキャストアドレスで使用できる文字

RFC 2373に従ったネットワークプレフィックスで使用できる文字

*（アスタリスク）

［ユーザーID］テキストボックスに入力できる文字列

256文字

なし

半角英数字，「!」，「#」，「$」，「%」，「&」，「'」，「(」，「)」，「*」，「+」，「-」，「.」，「=」，「@」，「¥」，「^」，「_」，「|」

［パスワード］テキストボックスに入力できる文字列

256文字

なし

半角英数字，「!」，「#」，「$」，「%」，「&」，「'」，「(」，「)」，「*」，「+」，「-」，「.」，「=」，「@」，「¥」，「^」，「_」，「|」

［スーパーユーザーのパスワード］テキストボックスに入力できる文字列

256文字

なし

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）を除くASCIIコード文字

［エージェントレス接続先定義編集］ダイアログボックス

［接続先］テキストボックスに入力できる文字列（［接続先種別］リストボックスでホスト名を選択している場合）

1,024文字

選択したエージェントレス接続先定義に設定されている接続先

Java SE5でサポートしている正規表現形式で使用できる文字

［接続先］テキストボックスに入力できる文字列（［接続先種別］リストボックスでIPv4を選択している場合）

1,024文字

選択したエージェントレス接続先定義に設定されている接続先

半角数字，「*」，「-」，「.」

［接続先］テキストボックスに入力できる文字列（［接続先種別］リストボックスでIPv6を選択している場合）

1,024文字

選択したエージェントレス接続先定義に設定されている接続先

RFC 2373に従ったユニキャストアドレスで使用できる文字

RFC 2373に従ったネットワークプレフィックスで使用できる文字

*（アスタリスク）

［ユーザーID］テキストボックスに入力できる文字列

256文字

選択したエージェントレス接続先定義に設定されているユーザーID

半角英数字，「!」，「#」，「$」，「%」，「&」，「'」，「(」，「)」，「*」，「+」，「-」，「.」，「=」，「@」，「¥」，「^」，「_」，「|」

［パスワード］テキストボックスに入力できる文字列

256文字

選択したエージェントレス接続先定義に設定されているパスワード

半角英数字，「!」，「#」，「$」，「%」，「&」，「'」，「(」，「)」，「*」，「+」，「-」，「.」，「=」，「@」，「¥」，「^」，「_」，「|」

［スーパーユーザーのパスワード］テキストボックスに入力できる文字列

256文字

選択したエージェントレス接続先定義に設定されているスーパーユーザーのパスワード

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）を除くASCIIコード文字

［サービス共有プロパティ］ビュー

フィルタの［属性］項目に次のどれかを指定した場合に，［値］テキストフィールドで指定できる文字列

サービス共有プロパティ

説明

プロパティ値

4,096文字

なし

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

フィルタの［属性］項目に「プロパティキー」を指定した場合に，［値］テキストフィールドで指定できる文字列

128文字

なし

半角英数字，「-」，「_」，「.」

フィルタの［属性］項目に「#」を指定した場合に，［値］テキストフィールドで指定できる数値

2147483647

なし

半角数字

［ユーザー管理］画面，［ユーザー追加］ダイアログボックス（ユーザー管理），［プロファイル編集］ダイアログボックス，および［パスワード変更］ダイアログボックス

［ユーザーID］テキストボックスに入力できる文字列

256文字

なし

半角英数字，「!」，「#」，「$」，「%」，「&」，「'」，「(」，「)」，「*」，「+」，「-」，「.」，「=」，「@」，「¥」，「^」，「_」，「|」

［パスワード］テキストボックスに入力できる文字列

256文字

なし

半角英数字，「!」，「#」，「$」，「%」，「&」，「'」，「(」，「)」，「*」，「+」，「-」，「.」，「=」，「@」，「¥」，「^」，「_」，「|」

［フルネーム］テキストボックスに入力できる文字列

80文字

なし

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

なお，$は2個以上連続して入力できません。

［E-mail］テキストボックスに入力できる文字列

255バイト

なし

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

［説明］テキストボックスに入力できる文字列

80文字

なし

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

1つのメイン画面から起動できる［ユーザー管理］画面の数

1個

−

−

［グループ追加］ダイアログボックス

［Distinguished Name］テキストボックスに入力できる文字列

250文字

なし

RFC 4514に従った識別名で使用できる文字

［ユーザーグループ］ビュー

ユーザーグループのフィルタの［属性］項目に次のどれかを指定した場合に，［値］テキストフィールドで指定できる文字列

ユーザーグループ

説明

Distinguished Name

4,096文字

なし

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

ユーザーグループのフィルタの［属性］項目に「ユーザー数」を指定した場合に，［値］テキストフィールドで指定できる文字列

2147483647

なし

半角数字

ユーザーのフィルタの［属性］項目に次のどれかを指定した場合に，［値］テキストフィールドで指定できる文字列

ユーザーID

フルネーム

説明

ユーザーグループ

4,096文字

なし

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

［ユーザーグループ作成］ダイアログボックス

［名前］テキストボックスに入力できる文字列

64文字

なし

次の文字列以外の文字

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）

「"」，「*」，「,」，「/」，「:」，「;」，「<」，「>」，「?」，「|」，「¥」，マルチバイト文字

なお，既存のユーザーグループ名，および半角・全角空白だけのユーザーグループ名は指定できない。

［説明］テキストボックスに入力できる文字列

80文字

なし

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

ユーザー一覧でフィルタの［属性］項目に次のどれかを指定した場合に，［値］テキストフィールドに指定できる文字列

ユーザーID

フルネーム

ユーザーグループ

4,096文字

なし

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

リソースグループ一覧でフィルタの［属性］項目に次のどれかを指定した場合に，［値］テキストフィールドに指定できる文字列

リソースグループ

説明

ユーザーグループ

4,096文字

なし

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

リソースグループ一覧でフィルタの［属性］項目に「製品名」を指定した場合に，［値］テキストフィールドに指定できる文字列

256文字

なし

制御文字以外の文字

［ユーザー追加］ダイアログボックス（ユーザーグループ）

ユーザー一覧のフィルタの［属性］項目に次のどれかを指定した場合に，［値］テキストフィールドで指定できる文字列

ユーザーID

フルネーム

ユーザーグループ

4,096文字

なし

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

［リソースグループ追加］ダイアログボックス，［ロール編集］ダイアログボックス

フィルタの［属性］項目に次のどれかを指定した場合に，［値］テキストフィールドで指定できる文字列

説明

ユーザーグループ

リソースグループ

4,096文字

なし

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

［ユーザーグループ編集］ダイアログボックス

［名前］テキストボックスに入力できる文字列

64文字

選択したユーザーグループ名

次の文字列以外の文字

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）

「"」，「*」，「,」，「/」，「:」，「;」，「<」，「>」，「?」，「|」，「¥」，マルチバイト文字

なお，既存のユーザーグループ名，および半角・全角空白だけのユーザーグループ名は指定できない。

［説明］テキストボックスに入力できる文字列

80文字

選択したユーザーグループの説明

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

ユーザー一覧でフィルタの［属性］項目に次のどれかを指定した場合に，［値］テキストフィールドに指定できる文字列

ユーザーID

フルネーム

ユーザーグループ

4,096文字

なし

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

リソースグループ一覧でフィルタの［属性］項目に次のどれかを指定した場合に，［値］テキストフィールドに指定できる文字列

リソースグループ

説明

ユーザーグループ

4,096文字

なし

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

リソースグループ一覧でフィルタの［属性］項目に「製品名」を指定した場合に，［値］テキストフィールドに指定できる文字列

256文字

なし

制御文字以外の文字

［ユーザーグループ割り当て］ダイアログボックス

選択可能ユーザーグループ，および選択済みユーザーグループのフィルタの［属性］項目に「ユーザーグループ」，「説明」を指定した場合に，［値］テキストフィールドで指定できる文字列

4,096文字

なし

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

選択可能ユーザーグループ，および選択済みユーザーグループのフィルタの［属性］項目に「ユーザー数」を指定した場合に，［値］テキストフィールドで指定できる数値

2147483647

なし

半角数字

［リソースグループ］ビュー

フィルタの［属性］項目に次のどれかを指定した場合に，［値］テキストフィールドに指定できる文字列

リソースグループ

説明

ユーザーグループ

4,096文字

なし

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

［リソースグループ作成］ダイアログボックス

［名前］テキストボックスに入力できる文字列

63文字

なし

半角英数字，「_」

［説明］テキストボックスに入力できる文字列

80文字

なし

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

［リソースグループ編集］ダイアログボックス

［名前］テキストボックスに入力できる文字列

63文字

選択したリソースグループ名

半角英数字，「_」

［説明］テキストボックスに入力できる文字列

80文字

選択したリソースグループの説明

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

［プロファイル］画面

1つのメイン画面から起動できる［プロファイル］画面の数

1個

−

−

［部品］ビュー（［リリース］タブ）

検索テキストボックスに入力できる文字列

256文字

なし

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

［部品］ビュー（［開発］タブ）

検索テキストボックスに入力できる文字列

256文字

なし

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

［部品複製］ダイアログボックス

［部品ID］テキストボックスに入力できる文字列

64文字

複製対象の部品のID

半角英数字，「-」，「_」，「.」

また，次の場合はエラーとなる。

次の文字を含む場合

「CON」, 「PRN」, 「AUX」, 「CLOCK$」, 「NUL」, 「COM0」, 「COM1」, 「COM2」, 「COM3」, 「COM4」, 「COM5」, 「COM6」, 「COM7」, 「COM8」, 「COM9」, 「LPT0」, 「LPT1」, 「LPT2」, 「LPT3」, 「LPT4」, 「LPT5」, 「LPT6」, 「LPT7」, 「LPT8」または 「LPT9」

「.」を，先頭または末尾に指定した場合

［部品バージョン］テキストボックスに入力できる文字列

8文字

複製対象の部品のバージョン

半角数字，「.」

［ベンダーID］ テキストボックスに入力できる文字列

64文字

複製対象の部品のベンダーID

ただし，複製対象の部品のベンダーIDが，「com.hitachi.software.dna」で始まる場合は空文字が表示される。

半角英数字，「-」，「_」，「.」

また，次の場合はエラーとなる。

次の文字を含む場合

「CON」, 「PRN」, 「AUX」, 「CLOCK$」, 「NUL」, 「COM0」, 「COM1」, 「COM2」, 「COM3」, 「COM4」, 「COM5」, 「COM6」, 「COM7」, 「COM8」, 「COM9」, 「LPT0」, 「LPT1」, 「LPT2」, 「LPT3」, 「LPT4」, 「LPT5」, 「LPT6」, 「LPT7」, 「LPT8」または 「LPT9」

「.」を，先頭または末尾に指定した場合

IDが「com.hitachi.software.dna」から始まる場合

［部品名］テキストボックスに入力できる文字列

64文字

複製対象の部品の名称

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

［ベンダー名］テキストボックスに入力できる文字列

64文字

複製対象の部品のベンダー名

ただし，複製対象の部品のベンダーIDが，「com.hitachi.software.dna」で始まる場合は空文字が表示される。

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

［説明］テキストボックスに入力できる文字列

256文字

複製対象の部品の説明

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

［カテゴリ名］テキストボックスに入力できる文字列

256文字

複製対象の部品のカテゴリ名

次の文字以外が指定できる。

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）

「¥」

ただし，「/」および「,」は，先頭および末尾に指定できない。

［部品作成］ダイアログボックス

［部品ID］テキストボックスに入力できる文字列

64文字

なし

半角英数字，「-」，「_」，「.」

また，次の場合はエラーとなる。

次の文字を含む場合

「CON」, 「PRN」, 「AUX」, 「CLOCK$」, 「NUL」, 「COM0」, 「COM1」, 「COM2」, 「COM3」, 「COM4」, 「COM5」, 「COM6」, 「COM7」, 「COM8」, 「COM9」, 「LPT0」, 「LPT1」, 「LPT2」, 「LPT3」, 「LPT4」, 「LPT5」, 「LPT6」, 「LPT7」, 「LPT8」または 「LPT9」

「.」を，先頭または末尾に指定した場合

［部品バージョン］テキストボックスに入力できる文字列

8文字

01.00.00

半角数字，「.」

［ベンダーID］テキストボックスに入力できる文字列

64文字

なし

半角英数字，「-」，「_」，「.」

また，次の場合はエラーとなる。

次の文字を含む場合

「CON」, 「PRN」, 「AUX」, 「CLOCK$」, 「NUL」, 「COM0」, 「COM1」, 「COM2」, 「COM3」, 「COM4」, 「COM5」, 「COM6」, 「COM7」, 「COM8」, 「COM9」, 「LPT0」, 「LPT1」, 「LPT2」, 「LPT3」, 「LPT4」, 「LPT5」, 「LPT6」, 「LPT7」, 「LPT8」または 「LPT9」

「.」を，先頭または末尾に指定した場合

IDが「com.hitachi.software.dna」から始まる場合

［部品名］テキストボックスに入力できる文字列

64文字

なし

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

［ベンダー名］テキストボックスに入力できる文字列

64文字

なし

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

［説明］テキストボックスに入力できる文字列

256文字

なし

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

［カテゴリ名］テキストボックスに入力できる文字列

256文字

なし

次の文字以外が指定できる。

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）

「¥」

ただし，「/」および「,」は，先頭および末尾に指定できない。

［部品編集］ダイアログボックス

［部品名］テキストボックスに入力できる文字列

64文字

編集対象の部品の名称

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

［ベンダー名］テキストボックスに入力できる文字列

64文字

編集対象の部品のベンダー名

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

［説明］テキストボックスに入力できる文字列

256文字

編集対象の部品の説明

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

［カテゴリ名］テキストボックスに入力できる文字列

256文字

編集対象の部品のカテゴリ名

次の文字以外が指定できる。

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）

「¥」

ただし，「/」および「,」は，先頭および末尾に指定できない。

［部品の入力プロパティ作成］ダイアログボックス

［プロパティキー］テキストボックスに入力できる文字列

128文字

なし

半角英数字，「-」，「_」，「.」

ただし，「reserved.」（小文字）または「plugin.」（小文字）から始まるプロパティキーは指定できない。

［プロパティ名］テキストボックスに入力できる文字列

128文字

なし

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

［説明］テキストボックスに入力できる文字列

256文字

なし

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

［デフォルト値］テキストボックスに入力できる文字列

1,024文字

なし

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

［部品の入力プロパティ編集］ダイアログボックス

［プロパティキー］テキストボックスに入力できる文字列

128文字

編集対象のプロパティのプロパティキー

半角英数字，「-」，「_」，「.」

ただし，「reserved.」（小文字）または「plugin.」（小文字）から始まるプロパティキーは指定できない。

［プロパティ名］テキストボックスに入力できる文字列

128文字

編集対象のプロパティの名称

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

［説明］テキストボックスに入力できる文字列

256文字

編集対象のプロパティの説明

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

［デフォルト値］テキストボックスに入力できる文字列

1,024文字

編集対象のプロパティのデフォルト値

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

［部品の出力プロパティ作成］ダイアログボックス

［プロパティキー］テキストボックスに入力できる文字列

128文字

なし

半角英数字，「-」，「_」，「.」

ただし，「reserved.」（小文字）または「plugin.」（小文字）から始まるプロパティキーは指定できない。

［プロパティ名］テキストボックスに入力できる文字列

128文字

なし

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

［説明］テキストボックスに入力できる文字列

256文字

なし

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

［部品の出力プロパティ編集］ダイアログボックス

［プロパティキー］テキストボックスに入力できる文字列

128文字

編集対象のプロパティのプロパティキー

半角英数字，「-」，「_」，「.」

ただし，「reserved.」（小文字）または「plugin.」（小文字）から始まるプロパティキーは指定できない。

［プロパティ名］テキストボックスに入力できる文字列

128文字

編集対象のプロパティの名称

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

［説明］テキストボックスに入力できる文字列

256文字

編集対象のプロパティの説明

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

［リモートコマンド編集］ダイアログボックス

［コマンドライン］テキストボックスに入力できる文字列

8,192文字

すでに設定されているコマンドライン

ただし，コマンドラインが設定されていない場合は，空文字が表示される。

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

［ファイル名］テキストボックスに入力できる文字列

90文字

すでに設定されているファイル名

ただし，ファイル名が設定されていない場合は，空文字が表示される。

ASCII文字

ただし，次の文字は指定できない。

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）

「?」，「*」，「"」，「>」，「<」，「|」，「:」，「/」および「¥」

マルチバイト文字

また，次の文字を含むファイル名も指定できない。

「CON」, 「PRN」, 「AUX」, 「CLOCK$」, 「NUL」, 「COM0」, 「COM1」, 「COM2」, 「COM3」, 「COM4」, 「COM5」, 「COM6」, 「COM7」, 「COM8」, 「COM9」, 「LPT0」, 「LPT1」, 「LPT2」, 「LPT3」, 「LPT4」, 「LPT5」, 「LPT6」, 「LPT7」, 「LPT8」または「LPT9」

添付するスクリプトファイルのファイル名として指定できる文字列

90文字

すでに設定されているスクリプトファイル

ただし，スクリプトファイルが設定されていない場合は，［(ファイルを選択してください。)］が表示される。

［スクリプト］テキストボックスに入力できる文字列

5,000文字

すでに設定されているスクリプト

ただし，スクリプトが設定されていない場合は，空文字が表示される。

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字。

ただし，タブ（¥u0009）および改行（¥u000D，¥u000A）は使用できる。

［実行ディレクトリ］テキストボックスに入力できる文字列

256文字

すでに設定されている実行ディレクトリ

ただし，実行ディレクトリが設定されていない場合は，空文字が表示される。

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

［環境変数作成］ダイアログボックス

［変数名］テキストボックスに入力できる文字列

256文字

なし

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

［値］テキストボックスに入力できる文字列

2,048文字

なし

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

［環境変数編集］ダイアログボックス

［変数名］テキストボックスに入力できる文字列

256文字

編集対象の環境変数の名称

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

［値］テキストボックスに入力できる文字列

2,048文字

編集対象の環境変数の値

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

［出力フィルタ編集］ダイアログボックス

［出力フィルタ］テキストボックスに入力できる文字列

1,024文字

すでに設定されている出力フィルタ

ただし，出力フィルタが設定されていない場合は，空文字が表示される。

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

［標準出力/標準エラー出力］テキストボックスに入力できる文字列

500,000文字

なし

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字。

ただし，タブ（¥u0009）および改行（¥u000D，¥u000A）は使用できる。

［サービステンプレート作成］ダイアログボックス

［サービステンプレートID］テキストボックスに入力できる文字列

64文字

なし

半角英数字，「-」，「_」，「.」

また，次の場合はエラーとなる。

次の文字を含む場合

「CON」, 「PRN」, 「AUX」, 「CLOCK$」, 「NUL」, 「COM0」, 「COM1」, 「COM2」, 「COM3」, 「COM4」, 「COM5」, 「COM6」, 「COM7」, 「COM8」, 「COM9」, 「LPT0」, 「LPT1」, 「LPT2」, 「LPT3」, 「LPT4」, 「LPT5」, 「LPT6」, 「LPT7」, 「LPT8」または 「LPT9」

「.」を，先頭または末尾に指定した場合

［サービステンプレートバージョン］テキストボックスに入力できる文字列

8文字

01.00.00

半角数字，「.」

［ベンダーID］テキストボックスに入力できる文字列

64文字

なし

半角英数字，「-」，「_」，「.」

また，次の場合はエラーとなる。

次の文字を含む場合

「CON」, 「PRN」, 「AUX」, 「CLOCK$」, 「NUL」, 「COM0」, 「COM1」, 「COM2」, 「COM3」, 「COM4」, 「COM5」, 「COM6」, 「COM7」, 「COM8」, 「COM9」, 「LPT0」, 「LPT1」, 「LPT2」, 「LPT3」, 「LPT4」, 「LPT5」, 「LPT6」, 「LPT7」, 「LPT8」または 「LPT9」

「.」を，先頭または末尾に指定した場合

IDが「com.hitachi.software.dna」から始まる場合

［サービステンプレート名］テキストボックスに入力できる文字列

64文字

なし

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

［ベンダー名］テキストボックスに入力できる文字列

64文字

なし

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

［説明］テキストボックスに入力できる文字列

256文字

なし

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

［カテゴリ名］テキストボックスに入力できる文字列

256文字

なし

次の文字以外が指定できる。

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）

「¥」

ただし，「/」および「,」は，先頭および末尾に指定できない。

［サービステンプレート一覧］ダイアログボックス

検索テキストボックスに入力できる文字列

256文字

なし

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

［サービステンプレート複製］ダイアログボックス

［サービステンプレートID］テキストボックス

64文字

複製対象のサービステンプレートのID

半角英数字，「-」，「_」，「.」

また，次の場合はエラーとなる。

次の文字を含む場合

「CON」, 「PRN」, 「AUX」, 「CLOCK$」, 「NUL」, 「COM0」, 「COM1」, 「COM2」, 「COM3」, 「COM4」, 「COM5」, 「COM6」, 「COM7」, 「COM8」, 「COM9」, 「LPT0」, 「LPT1」, 「LPT2」, 「LPT3」, 「LPT4」, 「LPT5」, 「LPT6」, 「LPT7」, 「LPT8」または 「LPT9」

「.」を，先頭または末尾に指定した場合

［サービステンプレートバージョン］テキストボックスに入力できる文字列

8文字

複製対象のサービステンプレートのバージョン

半角数字，「.」

［ベンダーID］テキストボックスに入力できる文字列

64文字

複製対象のサービステンプレートのベンダーID

ただし，複製対象のサービステンプレートのベンダーIDが，「com.hitachi.software.dna」で始まる場合は空文字が表示される。

半角英数字，「-」，「_」，「.」

また，次の場合はエラーとなる。

次の文字を含む場合

「CON」, 「PRN」, 「AUX」, 「CLOCK$」, 「NUL」, 「COM0」, 「COM1」, 「COM2」, 「COM3」, 「COM4」, 「COM5」, 「COM6」, 「COM7」, 「COM8」, 「COM9」, 「LPT0」, 「LPT1」, 「LPT2」, 「LPT3」, 「LPT4」, 「LPT5」, 「LPT6」, 「LPT7」, 「LPT8」または 「LPT9」

「.」を，先頭または末尾に指定した場合

IDが「com.hitachi.software.dna」から始まる場合

［サービステンプレート名］テキストボックスに入力できる文字列

64文字

複製対象のサービステンプレートの名称

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

［ベンダー名］テキストボックスに入力できる文字列

64文字

複製対象のサービステンプレートのベンダー名

ただし，複製対象のサービステンプレートのベンダーIDが，「com.hitachi.software.dna」で始まる場合は空文字が表示される。

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

［説明］テキストボックスに入力できる文字列

256文字

複製対象のサービステンプレートの説明

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

［カテゴリ名］テキストボックスに入力できる文字列

256文字

複製対象のサービステンプレートのカテゴリ名

次の文字以外が指定できる。

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）

「¥」

ただし，「/」および「,」は，先頭および末尾に指定できない。

［デバッグ実行］ダイアログボックス

［サービス名］テキストボックスに入力できる文字列

64文字

[DEBUG]サービステンプレート名

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

［カテゴリ］テキストボックスに入力できる文字列

256文字

デバッグ実行対象のサービステンプレートのカテゴリ名

次の文字以外が指定できる。

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）

「¥」

ただし，「/」および「,」は，先頭および末尾に指定できない。

［タスク名］テキストボックスに入力できる文字列

128文字

[DEBUG]サービステンプレート名_YYYYMMDDhhmmss（デバッグ実行した日付および時刻）

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

［タスクの説明］テキストボックスに入力できる文字列

256文字

なし

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

プロパティ一覧の［プロパティ値］テキストボックスに指定できる文字列（string）

1,024文字

サービステンプレートが保持するサービス定義情報に定義されているデフォルト値

ただし，デフォルト値が定義されていない場合は，空文字が表示される。

サービステンプレートが保持するサービス定義情報の入力文字制限に定義されている文字，かつ制御文字（¥u0000〜¥u001F および¥u007F〜¥u009F）以外の文字

プロパティ一覧の［プロパティ値］テキストボックスに指定できる文字列（integer）

-2147483648〜2147483647

プロパティ一覧の［プロパティ値］テキストボックスに指定できる文字列（double）

約±4.9×10⁻³²⁴〜±1.7×10³⁰⁸の数値

ただし，指数形式では入力できない。

プロパティ一覧の［プロパティ値］テキストボックスに指定できる文字列（password）

1,024文字

プロパティ一覧のカレンダーボタンで表示したカレンダーで指定できる年月日

1900-01-01〜2100-12-31

−

［サービス定義編集］ダイアログボックス

［サービステンプレート名］テキストボックスに入力できる文字列

64文字

編集対象のサービステンプレートの名称

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

［ベンダー名］テキストボックスに入力できる文字列

64文字

編集対象のサービステンプレートのベンダー名

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

［説明］テキストボックスに入力できる文字列

256文字

編集対象のサービステンプレートの説明

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

［カテゴリ名］テキストボックスに入力できる文字列

256文字

編集対象のサービステンプレートのカテゴリ名

次の文字以外が指定できる。

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）

「¥」

ただし，「/」および「,」は，先頭および末尾に指定できない。

［画面カスタムファイル］のファイル名として指定できる文字列

64文字

編集対象のサービステンプレートに指定した画面カスタムファイル

次の文字以外が指定できる。

サロゲートペア文字

マルチバイト文字

［サービス詳細説明画面のファイル名(相対パス)］テキストボックスに入力できる文字列

64文字

編集対象のサービステンプレートに設定されているサービス詳細説明画面のファイル名

ASCII文字

ただし，次の文字は指定できない。

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）

「?」，「*」，「"」，「>」，「<」，「|」，「:」,「¥」

マルチバイト文字

また，次の場合はエラーとなる。

フォルダ名またはファイル名に次の文字を含む場合

「CON」, 「PRN」, 「AUX」, 「CLOCK$」, 「NUL」, 「COM0」, 「COM1」, 「COM2」, 「COM3」, 「COM4」, 「COM5」, 「COM6」, 「COM7」, 「COM8」, 「COM9」, 「LPT0」, 「LPT1」, 「LPT2」, 「LPT3」, 「LPT4」, 「LPT5」, 「LPT6」, 「LPT7」, 「LPT8」または 「LPT9」

「/」および「.」を，先頭または末尾に指定した場合

「/」を2つ以上続けて入力した場合

［プロパティグループ作成］ダイアログボックス

［プロパティグループID］テキストボックスに入力できる文字列

32文字

なし

半角英数字，「-」，「_」，「.」

［プロパティグループ名］テキストボックスに入力できる文字列

64文字

なし

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

［説明］テキストボックスに入力できる文字列

256文字

なし

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

［プロパティグループ編集］ダイアログボックス

［プロパティグループID］テキストボックスに入力できる文字列

32文字

編集対象のプロパティグループのID

半角英数字，「-」，「_」，「.」

［プロパティグループ名］テキストボックスに入力できる文字列

64文字

編集対象のプロパティグループの名称

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

［説明］テキストボックスに入力できる文字列

256文字

編集対象のプロパティグループの説明

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

［サービスの入力プロパティ作成］ダイアログボックス

［プロパティキー］テキストボックスに入力できる文字列

128文字

なし

半角英数字，「-」，「_」，「.」

ただし，「reserved.」（小文字）から始まるプロパティキーは指定できない。

［プロパティ名］テキストボックス

128文字

なし

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

［説明］テキストボックスに入力できる文字列

256文字

なし

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

データ型にstringを指定した場合に，［デフォルト値］テキストボックスに入力できる文字列

1,024文字

なし

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

データ型にintegerを指定した場合に，［デフォルト値］テキストボックスに入力できる文字列

-2147483648〜2147483647

なし

半角数字，「-」

データ型にdoubleを指定した場合に，［デフォルト値］テキストボックスに入力できる文字列

17文字（-999999999999999〜999999999999999）

なし

半角数字，「-」，「.」

データ型にdateを指定した場合に，［デフォルト値］テキストボックスに入力できる文字列

1900-01-01〜2100-12-31

なし

−

データ型にpasswordを指定した場合に，［デフォルト値］テキストボックスに入力できる文字列

1,024文字

なし

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

データ型にlistを指定した場合に，［デフォルト値］テキストボックスに入力できる文字列

1,024文字

なし

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

データ型にstringを指定した場合に，［最小長］テキストボックスに入力できる文字列

0〜1024

なし

半角数字

データ型にpasswordを指定した場合に，［最小長］テキストボックスに入力できる文字列

0〜1024

なし

半角数字

データ型にstringを指定した場合に，［最大長］テキストボックスに入力できる文字列

1〜1024

なし

半角数字

データ型にpasswordを指定した場合に，［最大長］テキストボックスに入力できる文字列

1〜1024

なし

半角数字

データ型にstringを指定した場合に，［入力文字制限］テキストボックスに入力できる文字列

1,024文字

なし

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

データ型にpasswordを指定した場合に，［入力文字制限］テキストボックスに入力できる文字列

1,024文字

なし

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

データ型にintegerを指定した場合に，［最小値］テキストボックスに入力できる文字列

-2147483648〜2147483647

なし

半角数字，「-」

データ型にdoubleを指定した場合に，［最小値］テキストボックスに入力できる文字列

17文字（-999999999999999〜999999999999999）

なし

半角数字，「-」，「.」

データ型にdateを指定した場合に，［最小値］テキストボックスに入力できる文字列

1900-01-01〜2100-12-31

なし

−

データ型にintegerを指定した場合に，［最大値］テキストボックスに入力できる文字列

-2147483648〜2147483647

なし

半角数字，「-」

データ型にdoubleを指定した場合に，［最大値］テキストボックスに入力できる文字列

17文字（-999999999999999〜999999999999999）

なし

半角数字，「-」，「.」

データ型にdateを指定した場合に，［最大値］テキストボックスに入力できる文字列

1900-01-01〜2100-12-31

なし

−

［リスト表示値］テキストボックスに入力できる文字列

1,024文字

なし

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

［サービスの入力プロパティ編集］ダイアログボックス

［プロパティキー］テキストボックスに入力できる文字列

128文字

編集対象のプロパティのプロパティキー

半角英数字，「-」，「_」，「.」

ただし，「reserved.」（小文字）から始まるプロパティキーは指定できない。

［プロパティ名］テキストボックスに入力できる文字列

128文字

編集対象のプロパティの名称

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

［説明］テキストボックスに入力できる文字列

256文字

編集対象のプロパティの説明

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

データ型にstringを指定した場合に，［デフォルト値］テキストボックスに入力できる文字列

1,024文字

編集対象のプロパティのデフォルト値

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

データ型にintegerを指定した場合に，［デフォルト値］テキストボックスに入力できる文字列

-2147483648〜2147483647

編集対象のプロパティのデフォルト値

半角数字，「-」

データ型にdoubleを指定した場合に，［デフォルト値］テキストボックスに入力できる文字列

17文字（-999999999999999〜999999999999999）

編集対象のプロパティのデフォルト値

半角数字，「-」，「.」

データ型にdateを指定した場合に，［デフォルト値］テキストボックスに入力できる文字列

1900-01-01〜2100-12-31

編集対象のプロパティのデフォルト値

−

データ型にpasswordを指定した場合に，［デフォルト値］テキストボックスに入力できる文字列

1,024文字

編集対象のプロパティのデフォルト値

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

データ型にlistを指定した場合に，［デフォルト値］テキストボックスに入力できる文字列

1,024文字

編集対象のプロパティのデフォルト値

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

データ型にstringを指定した場合に，［最小長］テキストボックスに入力できる文字列

0〜1024

編集対象のプロパティの最小長

半角数字

データ型にpasswordを指定した場合に，［最小長］テキストボックスに入力できる文字列

0〜1024

編集対象のプロパティの最小長

半角数字

データ型にstringを指定した場合に，［最大長］テキストボックスに入力できる文字列

1〜1024

編集対象のプロパティの最大長

半角数字

データ型にpasswordを指定した場合に，［最大長］テキストボックスに入力できる文字列

1〜1024

編集対象のプロパティの最大長

半角数字

データ型にstringを指定した場合に，［入力文字制限］テキストボックスに入力できる文字列

1,024文字

編集対象のプロパティの入力文字制限

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

データ型にpasswordを指定した場合に，［入力文字制限］テキストボックスに入力できる文字列

1,024文字

編集対象のプロパティの入力文字制限

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

データ型にintegerを指定した場合に，［最小値］テキストボックスに入力できる文字列

-2147483648〜2147483647

編集対象のプロパティの最小値

半角数字，「-」

データ型にdoubleを指定した場合に，［最小値］テキストボックスに入力できる文字列

17文字（-999999999999999〜999999999999999）

編集対象のプロパティの最小値

半角数字，「-」，「.」

データ型にdateを指定した場合に，［最小値］テキストボックスに入力できる文字列

1900-01-01〜2100-12-31

編集対象のプロパティの最小値

−

データ型にintegerを指定した場合に，［最大値］テキストボックスに入力できる文字列

-2147483648〜2147483647

編集対象のプロパティの最大値

半角数字，「-」

データ型にdoubleを指定した場合に，［最大値］テキストボックスに入力できる文字列

17文字（-999999999999999〜999999999999999）

編集対象のプロパティの最大値

半角数字，「-」，「.」

データ型にdateを指定した場合に，［最大値］テキストボックスに入力できる文字列

1900-01-01〜2100-12-31

編集対象のプロパティの最大値

−

［リスト表示値］テキストボックスに入力できる文字列

1,024文字

編集対象のプロパティのリスト表示値

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

［サービスの出力プロパティ作成］ダイアログボックス

［プロパティキー］テキストボックスに入力できる文字列

128文字

なし

半角英数字，「-」，「_」，「.」

ただし，「reserved.」（小文字）から始まるプロパティキーは指定できない。

［プロパティ名］テキストボックスに入力できる文字列

128文字

なし

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

［説明］テキストボックスに入力できる文字列

256文字

なし

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

データ型にstringを指定した場合に，［デフォルト値］テキストボックスに入力できる文字列

1,024文字

なし

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

データ型にpasswordを指定した場合に，［デフォルト値］テキストボックスに入力できる文字列

1,024文字

なし

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

［サービスの出力プロパティ編集］ダイアログボックス

［プロパティキー］テキストボックスに入力できる文字列

128文字

編集対象のプロパティのプロパティキー

半角英数字，「-」，「_」，「.」

ただし，「reserved.」（小文字）から始まるプロパティキーは指定できない。

［プロパティ名］テキストボックスに入力できる文字列

128文字

編集対象のプロパティの名称

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

［説明］テキストボックスに入力できる文字列

256文字

編集対象のプロパティの説明

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

データ型にstringを指定した場合に，［デフォルト値］テキストボックスに入力できる文字列

1,024文字

編集対象のプロパティのデフォルト値

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

データ型にpasswordを指定した場合に，［デフォルト値］テキストボックスに入力できる文字列

1,024文字

編集対象のプロパティのデフォルト値

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

［変数作成］ダイアログボックス

［プロパティキー］テキストボックスに入力できる文字列

128文字

なし

半角英数字，「-」，「_」，「.」

ただし，「reserved.」（小文字）から始まるプロパティキーは指定できない。

［プロパティ名］テキストボックスに入力できる文字列

128文字

なし

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

［説明］テキストボックスに入力できる文字列

256文字

なし

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

データ型にstringを指定した場合に，［デフォルト値］テキストボックスに入力できる文字列

1,024文字

なし

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

データ型にpasswordを指定した場合に，［デフォルト値］テキストボックスに入力できる文字列

1,024文字

なし

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

［変数編集］ダイアログボックス

［プロパティキー］テキストボックスに入力できる文字列

128文字

編集対象の変数のプロパティキー

半角英数字，「-」，「_」，「.」

ただし，「reserved.」（小文字）から始まるプロパティキーは指定できない。

［プロパティ名］テキストボックスに入力できる文字列

128文字

編集対象の変数の名称

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

［説明］テキストボックスに入力できる文字列

256文字

編集対象の変数の説明

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

データ型にstringを指定した場合に，［デフォルト値］テキストボックスに入力できる文字列

1,024文字

編集対象の変数のデフォルト値

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

データ型にpasswordを指定した場合に，［デフォルト値］テキストボックスに入力できる文字列

1,024文字

編集対象の変数のデフォルト値

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

［ステップ作成］ダイアログボックス

［ステップID］テキストボックスに入力できる文字列

30文字

ステップとして追加した部品のID

ステップとして追加した部品のIDが30文字を超える場合は，31文字以降は切り捨てられる。

また，部品IDと同名のステップIDがフロー内に存在する場合，部品IDの末尾に「_n 」（連番）が付与された文字列が表示される。

「_n」を付与することで，ステップIDが30文字を超える場合は，「_n」分の文字数が，ステップIDの末尾から削除される。

半角英数字，「-」，「_」，「.」

ただし，「.」から始まるステップIDは指定できない。

［ステップ名］テキストボックスに入力できる文字列

64文字

ステップとして追加した部品の名称

ステップとして追加した部品の名称が64文字を超える場合は，65文字以降は切り捨てられる。

また，部品名と同名のステップ名がフロー内に存在する場合，部品名の末尾に「_n 」（連番）が付与された文字列が表示される。

「_n」を付与することで，ステップ名が64文字を超える場合は，「_n」分の文字数が，ステップ名の末尾から削除される。

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

［説明］テキストボックスに入力できる文字列

256文字

なし

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

［判定値］テキストボックスに入力できる文字列

0〜255

なし

半角数字

［警告値］テキストボックスに入力できる文字列

1〜255

なし

半角数字

［ステップ編集］ダイアログボックス

［ステップID］テキストボックスに入力できる文字列

30文字

編集対象のステップのID

半角英数字，「-」，「_」，「.」

ただし，「.」から始まるステップIDは指定できない。

［ステップ名］テキストボックスに入力できる文字列

64文字

編集対象のステップの名称

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

［説明］テキストボックスに入力できる文字列

256文字

編集対象のステップの説明

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

［判定値］テキストボックスに入力できる文字列

0〜255

編集対象のステップの判定値

半角数字

［警告値］テキストボックスに入力できる文字列

1〜255

編集対象のステップの警告値

半角数字

［入力プロパティマッピング］ダイアログボックス

［マッピング設定］ラジオボタンが表示されている場合に，［マッピングパラメータ］テキストボックスに入力できる文字列

1,024文字

マッピングパラメータに設定されている値

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

ただし，改行（¥u000D，¥u000A）およびタブ（¥u0009）は使用できる。

［マッピング設定］ラジオボタンが表示されていない場合に，［マッピングパラメータ］テキストボックスに入力できる文字列

入力プロパティに設定された最小値から最大値まで

半角英数字，「-」

［デバッグ］ビュー

［戻り値］テキストボックスに入力できる文字列

0〜127

デバッグ実行中に中断した部品の戻り値

半角数字

プロパティ一覧の［プロパティ値］テキストボックスに入力できる文字列

1,024文字

デバッグ実行中に中断した部品のプロパティ値

制御文字（¥u0000〜¥u001Fおよび¥u007F〜¥u009F）以外の文字

ただし，改行（¥u000D，¥u000A），タブ（¥u0009）およびスペース（¥u0020）は使用できる。

（凡例）

−：該当する項目はありません。

付録A.2　画面に表示される状態を示すアイコン

(1)　タスクの状態を示すアイコン

タスクの状態を示すアイコンを次に示します。

表A‒2　タスクの状態を示すアイコン

アイコン

タスクの状態

待機中

保留中

実行中

応答待ち中

異常検出

停止中

正常終了

失敗

キャンセル

関連トピック

マニュアル「JP1/AO 運用ガイド」−「タスクの状態一覧と状態遷移」のトピック

(2)　ステップの状態を示すアイコン

ステップの状態を示すアイコンを次に示します。

表A‒3　ステップの状態を示すアイコン

アイコン

ステップの状態

待機中，または繰り返し実行待ち

中断中

実行中

応答待ち中

異常検出

正常終了

失敗

警告終了

未実行，または計画未実行

関連トピック

マニュアル「JP1/AO 運用ガイド」−「ステップの状態一覧」のトピック

付録A.3　各バージョンの変更内容

(1)　10-54の変更内容

「タスク一覧の取得」および「ステップの一覧取得」で取得できるメンバーを，endTimeからcompletionTimeに変更した。

(2)　10-52の変更内容

適用OSにLinuxを追加した。

部品バージョン管理機能の追加によって次の画面を追加した。

［部品バージョン管理］ダイアログボックス（［一括適用］タブ）

［部品バージョン管理］ダイアログボックス（［個別適用］タブ）

JP1/AOにログインした際，「予期しないエラー」のメッセージダイアログが表示されたり，画面が正しく表示されなかったりした場合の対処方法についての説明を追加した。

操作対象の機器とのSSH接続で使用できる認証方式に，キーボードインタラクティブ認証を追加した。

予約部品プロパティ「plugin.publicKeyAuthentication」または「plugin.keyboardInteractiveAuthentication」を選択した場合は，［必須区分］チェックボックスが編集できないことの説明を追加した。

クラスタ環境の待機系のサーバでもhcmdsgetlogsコマンドまたはhcmds64getlogsコマンドは実行できることの説明を追加した。

JP1/AOサーバが停止していてもhcmdsgetlogsコマンドまたはhcmds64getlogsコマンドは実行できることの説明を追加した。

(3)　10-50の変更内容

2014年9月以降，マニュアル名称および資料番号を次のとおり変更した。

変更前

JP1/AO 画面・コマンドリファレンス（3021-3-084）

変更後

JP1/AO 画面・コマンド・APIリファレンス（3021-3-088）

Active Directoryと連携してユーザーを管理する機能を追加した。

https接続に対応した。

操作対象の機器との認証方式に公開鍵認証を追加した。

stopclusterコマンドを追加した。

クラスタ環境のJP1/AOのサービスを停止するための準備を実行できるようにした。

hcmdsldapuserコマンドを追加した。

Active Directoryと連携する場合に，Active Directoryの登録情報検索に必要なユーザー情報を編集できるようにした。

hcmdsssltoolコマンドを追加した。

SSL接続に必要な秘密鍵，CSR，自己署名証明書，および自己署名証明書の内容ファイルを作成できるようにした。

backupsystemコマンドおよびrestoresystemコマンドについて，次のファイルは対象外となる説明を追加した。

https接続用のSSLサーバ証明書ファイル

https接続用の秘密鍵ファイル

公開鍵認証用の秘密鍵ファイル

APIをサポートした。

(4)　10-12の変更内容

適用OSにWindows Server 2012 R2を追加した。

タスクモニタ機能およびサービステンプレートのデバッガ機能追加によって，次の画面を追加した。

［タスクログ］ダイアログボックス

［デバッグタスク一覧］ビュー

［タスクモニタ］ビュー

［デバッグ実行］ダイアログボックス

［デバッグ］ビュー

サービステンプレートデバッグビュー

スライドバー変更によって，次の画面図を変更した。

メイン画面

［サービス］画面

［タスク］画面

［タスク一覧］ビュー

［履歴］ビュー

［管理］画面

［エージェントレス接続先定義］ビュー

［サービス共有プロパティ］ビュー

［ユーザーグループ］ビュー（［ユーザーグループ］タブ）

［ユーザーグループ］ビュー（［ユーザー］タブ）

［リソースグループ］ビュー

［エディタ］画面

サービステンプレートエディタ参照ダイアログボックス

サービステンプレートエディタ編集ビュー

次の画面にタスクログ参照機能を追加した。

［応答待ちタスク一覧］ダイアログボックス

［実行中タスク一覧］ダイアログボックス

［正常終了タスク一覧］ダイアログボックス

［失敗タスク一覧］ダイアログボックス

［タスク一覧］ビュー

［タスク詳細］ダイアログボックス

次の画面に，タスクのリトライ機能およびタスクの強制停止機能を追加した。

［応答待ちタスク一覧］ダイアログボックス

［実行中タスク一覧］ダイアログボックス

［タスク一覧］ビュー

タスクモニタ機能およびサービステンプレートのデバッガ機能追加によって，次の画面の表示される条件を変更した。

［サービス実行］ダイアログボックス

［タスク詳細］ダイアログボックス

［応答入力］ダイアログボックス

［部品］ビュー

［サービス定義参照］ダイアログボックス

［ステップ参照］ダイアログボックス

サービステンプレートエディタ編集ビュー

［ビルド/リリース結果］ダイアログボックス

また，次の画面の表示項目の説明を変更した。

［タスク］画面

［タスク詳細］ダイアログボックス

［エディタ］画面

サービステンプレートエディタ編集ビュー

［ビルド/リリース結果］ダイアログボックス

［タスク詳細］ダイアログボックスに，ステップ一覧の表示項目に戻り値を追加した。また，ステップ一覧の状態の表示内容が変更できることを追加した。

次の画面に，root権限のユーザーで実行するか指定できる機能を追加した。

［部品］ビュー

［部品作成］ダイアログボックス

［部品編集］ダイアログボックス

次のコマンドに，デバッグサービスおよびデバッグタスクは対象外となることを追加した。

listservicesコマンド

listtasksコマンド

stoptaskコマンド

submittaskコマンド

restoresystemコマンドに，デバッグサービスおよびデバッグタスクについての説明を追加した。また，リストアしたタスクおよびデバッグタスクについてリトライ操作が選択できないことを追加した。

画面に表示される状態を示すアイコンについて，説明を追加した。

(5)　10-11の変更内容

リリース部品を削除できるようにした。

WindowsおよびLinuxに加えて，AIX，HP-UXおよびSolarisで，コマンドまたはスクリプトを実行するコンテンツ部品に対応した。

hcmdscheckauthコマンドの/userオプションの説明を追加した。また，戻り値247を追加した。

オプションに指定するユーザー名またはパスワードついての注意事項を追加した。

listtasksコマンドでタスク詳細情報の一括出力ができるようにした。また，submittaskコマンドで，指定日時実行タスクおよび定期実行タスクの一括再登録ができるようにした。

submittaskコマンドで定期実行タスクの登録ができるようにした。

JP1/AOのサービスを開始するとJP1/Baseのサービスも開始されるため，JP1/Baseのサービスについての記述を削除した。

クラスタシステムの場合の注意事項を追加した。

/workpathオプションおよび/fileオプションの説明を変更した。また，hcmdsdbtransコマンドの注意事項を追加した。

(6)　10-10の変更内容

［エディタ］画面を使用して，サービステンプレートや部品を開発できる機能を追加した。

次の画面の表示項目に，［構成種別］を追加した。

［待機中タスク一覧］ダイアログボックス

［応答待ちタスク一覧］ダイアログボックス

［実行中タスク一覧］ダイアログボックス

［正常終了タスク一覧］ダイアログボックス

［失敗タスク一覧］ダイアログボックス

［サービス］画面

［サービス実行］ダイアログボックス

［サービス追加］ダイアログボックス

［サービス設定］ダイアログボックス

［タスク一覧］ビュー

［タスク詳細］ダイアログボックス

［履歴］ビュー

submittaskコマンド，stoptaskコマンドの同時実行数を2個から10個に変更した。

次のコマンドを実行できるユーザー権限に，Developロールを追加した。

deleteservicetemplateコマンド

importservicetemplateコマンド

listservicesコマンド

listtasksコマンド

stoptaskコマンド

submittaskコマンド

listservicesコマンドおよびlisttasksコマンドの出力項目に，構成種別を追加した。

submittaskコマンドの/propertyオプションについて，指定を省略した場合，［サービス設定］ダイアログボックスで入力した値が設定されることを明記した。

submittaskコマンドに，タスクの実行結果を出力してからコマンドを終了する,/waitオプションを追加した。

submittaskコマンドに，サービスの実行契機を指定する，/scheduledateオプションおよび/scheduletimeオプションを追加した。

画面の制限値一覧に，［エディタ］画面の制限値を追加した。

(7)　10-02の変更内容

Windows Server 2012の場合の画面操作上の注意事項を追加した。

［タスク詳細］ダイアログボックスの次の項目を変更した。

「ジョブネット情報」を「ステップ情報」に変更した。

「ジョブネット詳細」を「ステップ詳細」に変更した。

ルートジョブネット名を削除した。

「ユニット一覧」を「ステップ一覧」に変更した。

「ユニット名」を「ステップ名」に変更した。

「コメント」を「説明」に変更した。

使用できるプロトコルにTelnet を追加した。

監査ログに出力されるサブジェクト識別情報を変更できる機能を追加した。

setupclusterコマンドは，Windows Server 2012では使用できないことを追加した。

画面の制限値一覧を修正した。

(8)　10-01の変更内容

制限値一覧のうち，機能に関する項目を「機能の制限値一覧」として「JP1/AO 導入・設計ガイド」に移動した。

索引

A

API[1]

API一覧[1]

API共通の仕様[1]

APIで管理できるドメイン名とリソース[1]

APIの記述形式[1]

APIの使用例[1]

B

backupsystem（JP1/AOシステムのバックアップ）[1]

D

deleteservicetemplate（サービステンプレートの削除）[1]

E

encryptpassword（パスワードファイルの作成）[1]

H

hcmdscheckauth/hcmds64checkauth（外部認証サーバとの接続確認）[1]

hcmdschgurl/hcmds64chgurl（URL情報の更新）[1]

hcmdsdbrepair/hcmds64dbrepair（データベースの再作成）[1]

hcmdsdbsrv/hcmds64dbsrv（データベースの開始・停止）[1]

hcmdsdbtrans/hcmds64dbtrans（データベースのバックアップ・リストア）[1]

hcmdsfwcancel（Windowsファイアウォールの例外登録）[1]

hcmdsgetlogs/hcmds64getlogs（ログ情報の採取）[1]

hcmdsintg/hcmds64intg（認証データの削除・確認）[1]

hcmdsldapuser/hcmds64ldapuser（LDAP検索用ユーザー登録・削除）[1]

hcmdssrv/hcmds64srv（JP1/AOの開始・停止・状態表示）[1]

hcmdsssltool/hcmds64ssltool（秘密鍵・自己署名証明書の作成）[1]

hcmdsunlockaccount/hcmds64unlockaccount（ユーザーアカウントのロック解除）[1]

HQL規格の使用[1]

I

importservicetemplate（サービステンプレートのインポート）[1]

J

JP1/AOを操作するAPIで返却されるメンバー[1]

L

listservices（サービス・サービステンプレートの一覧出力）[1]

listtasks（タスクの一覧出力，タスク詳細情報出力）[1]

R

restoresystem（JP1/AOシステムのリストア）[1]

S

setupcluster（クラスタ環境の構築）[1]

stopcluster（クラスタ環境でのサービス停止の準備）[1]

stoptask（タスクの実行停止）[1]

submittask（サービスの実行，タスクの一括再登録）[1]

う

運用関連のコマンド[1]

え

［エージェントレス接続先定義削除］ダイアログボックス[1]

［エージェントレス接続先定義作成］ダイアログボックス[1]

［エージェントレス接続先定義］ビュー[1]

［エージェントレス接続先定義編集］ダイアログボックス[1]

［エディタ］画面[1]

エラー情報[1]

お

［応答入力］ダイアログボックス[1]

［応答待ち中タスク一覧］ダイアログボックス[1]

か

画面一覧[1]

画面概要[1]

画面遷移[1]

画面操作上の注意事項[1]

画面に表示される状態を示すアイコン[1]

画面の制限値一覧[1]

［環境変数作成］ダイアログボックス[1]

［環境変数編集］ダイアログボックス[1]

［管理］画面[1]、[2]

く

クエリパラメータ[1]

［グループ一覧］ビュー[1]

［グループ削除］ダイアログボックス[1]

［グループ詳細］ビュー[1]

［グループ追加］ダイアログボックス[1]

［グループ］ビュー[1]

け

［権限］ビュー[1]

［権限変更］ダイアログボックス（［グループ詳細］ビューから表示した場合）[1]

［権限変更］ダイアログボックス（［プロファイル］ビューから表示した場合）[1]

［権限を持つユーザー一覧］ビュー[1]

［権限を持つユーザーとグループ一覧］ビュー[1]

こ

構築関連のコマンド[1]

コマンド[1]

コマンド一覧[1]

コマンド使用時の注意事項[1]

コマンドの記述形式[1]

コマンドの引数に指定できる文字[1]

さ

サービス一覧の取得[1]

［サービス］画面[1]、[2]

サービス関連のAPI[1]

［サービス共有プロパティ設定］ダイアログボックス[1]

［サービス共有プロパティ選択］ダイアログボックス[1]

［サービス共有プロパティ］ビュー[1]

［サービス削除］ダイアログボックス[1]

［サービス実行］ダイアログボックス[1]

サービス実行に必要な情報の取得[1]

［サービス設定］ダイアログボックス[1]

［サービス追加］ダイアログボックス[1]

［サービス定義参照］ダイアログボックス[1]

［サービス定義編集］ダイアログボックス[1]

［サービステンプレート一覧］ダイアログボックス[1]

サービステンプレートエディタ参照ダイアログボックス[1]

サービステンプレートエディタ編集ビュー[1]

［サービステンプレートエディタホーム］ビュー[1]

［サービステンプレート作成］ダイアログボックス[1]

サービステンプレートデバッグビュー[1]

［サービステンプレート複製］ダイアログボックス[1]

サービスに対する操作一覧の取得[1]

サービスの実行[1]

［サービスの出力プロパティ作成］ダイアログボックス[1]

［サービスの出力プロパティ参照］ダイアログボックス[1]

［サービスの出力プロパティ編集］ダイアログボックス[1]

サービスの情報取得[1]

［サービスの入力プロパティ作成］ダイアログボックス[1]

［サービスの入力プロパティ参照］ダイアログボックス[1]

［サービスの入力プロパティ編集］ダイアログボックス[1]

［サービスリソース設定］ダイアログボックス[1]

サポートするメソッド[1]

参考情報[1]

し

［実行中タスク一覧］ダイアログボックス[1]

実行できる操作を取得するAPIで返却されるメンバー[1]

失敗したステップからリトライ[1]

失敗した次のステップからリトライ[1]

［失敗タスク一覧］ダイアログボックス[1]

［出力フィルタ編集］ダイアログボックス[1]

［出力プロパティマッピング］ダイアログボックス[1]

情報管理のAPI[1]

す

スケジュール一時停止[1]

スケジュール一覧の取得[1]

スケジュール関連のAPI[1]

スケジュールキャンセル[1]

スケジュールに対する操作一覧の取得[1]

スケジュールの一時停止[1]

スケジュールの一時停止に必要な情報の取得[1]

スケジュールのキャンセル[1]

スケジュールのキャンセルに必要な情報の取得[1]

スケジュールの再開[1]

スケジュールの再開に必要な情報の取得[1]

スケジュールの情報取得[1]

ステータスコード[1]

［ステップ作成］ダイアログボックス[1]

［ステップ参照］ダイアログボックス[1]

ステップの一覧取得[1]

ステップの状態を示すアイコン[1]

［ステップ編集］ダイアログボックス[1]

せ

［正常終了タスク一覧］ダイアログボックス[1]

セキュリティと認証[1]

た

［待機中タスク一覧］ダイアログボックス[1]

タスク一覧の取得[1]

［タスク一覧］ビュー[1]

［タスク］画面[1]、[2]

タスク関連のAPI[1]

タスク実行停止に必要な情報の取得[1]

［タスク詳細］ダイアログボックス[1]

タスク操作一覧の取得[1]

タスクの再実行[1]

タスクの再実行に必要な情報の取得[1]

タスクの実行停止[1]

タスクの状態を示すアイコン[1]

タスクのリトライに必要な情報の取得（失敗したステップからリトライ）[1]

タスクのリトライに必要な情報の取得（失敗した次のステップからリトライ）[1]

［タスクモニタ］ビュー[1]

［タスクログ］ダイアログボックス[1]

タスクログの取得[1]

つ

通信方式[1]

て

［デバッグ実行］ダイアログボックス[1]

［デバッグタスク一覧］ビュー[1]

［デバッグ］ビュー[1]

と

ドメインオブジェクトの形式[1]

に

入出力形式[1]

［入力プロパティマッピング］ダイアログボックス[1]

［認証方式変更］ダイアログボックス[1]

ね

ネームスペース[1]

は

バージョン情報の取得[1]

［バージョン］ダイアログボックス[1]

［パスワード変更］ダイアログボックス[1]

ひ

［ビルド/リリース結果］ダイアログボックス[1]

ふ

フィルタエリア[1]

［部品作成］ダイアログボックス[1]

［部品の出力プロパティ作成］ダイアログボックス[1]

［部品の出力プロパティ編集］ダイアログボックス[1]

［部品の入力プロパティ作成］ダイアログボックス[1]

［部品の入力プロパティ編集］ダイアログボックス[1]

［部品バージョン管理］ダイアログボックス（［一括適用］タブ）[1]

［部品バージョン管理］ダイアログボックス（［個別適用］タブ）[1]

［部品］ビュー[1]

［部品］ビュー（［開発］タブ）[1]

［部品］ビュー（［基本］タブ）[1]

［部品］ビュー（［リリース］タブ）[1]

［部品複製］ダイアログボックス[1]

［部品編集］ダイアログボックス[1]

［部品リソース設定］ダイアログボックス[1]

プロパティ関連のAPI一覧[1]

［プロパティグループ作成］ダイアログボックス[1]

［プロパティグループ編集］ダイアログボックス[1]

プロパティ値一覧の取得[1]

プロパティ値に対する操作一覧の取得[1]

プロパティ値の取得[1]

プロパティ定義一覧の取得[1]

プロパティ定義情報の取得[1]

プロパティ定義に対する操作一覧の取得[1]

［プロファイル］画面[1]

［プロファイル］ビュー[1]

［プロファイル編集］ダイアログボックス[1]

へ

［変数作成］ダイアログボックス[1]

［変数参照］ダイアログボックス[1]

［変数編集］ダイアログボックス[1]

ほ

保守・メンテナンス関連のコマンド[1]

め

メイン画面[1]、[2]

ゆ

［ユーザー一覧］ビュー[1]

［ユーザー管理］画面[1]

［ユーザーグループ削除］ダイアログボックス[1]

［ユーザーグループ作成］ダイアログボックス[1]

［ユーザーグループ］ビュー（［ユーザー］タブ）[1]

［ユーザーグループ］ビュー（［ユーザーグループ］タブ）[1]

［ユーザーグループ編集］ダイアログボックス[1]

［ユーザーグループ割り当て］ダイアログボックス[1]

［ユーザー削除］ダイアログボックス[1]

ユーザー情報の取得[1]

［ユーザー追加］ダイアログボックス（ユーザー管理）[1]

［ユーザー追加］ダイアログボックス（ユーザーグループ）[1]

り

リクエスト形式[1]

リクエストヘッダー[1]

［リソースグループ削除］ダイアログボックス[1]

［リソースグループ作成］ダイアログボックス[1]

［リソースグループ追加］ダイアログボックス[1]

［リソースグループ］ビュー[1]

［リソースグループ編集］ダイアログボックス[1]

リソースのメンバー[1]

［リモートコマンド編集］ダイアログボックス[1]

［履歴削除］ダイアログボックス[1]

［履歴］ビュー[1]

れ

レスポンス形式[1]

レスポンスヘッダー[1]

［列の表示・非表示設定］ダイアログボックス[1]

ろ

［ロール編集］ダイアログボックス[1]

［ログイン］画面[1]

［ロック解除］ダイアログボックス[1]

［ロック］ダイアログボックス[1]