JP1 Version 11 JP1/Automatic Operation サービステンプレート開発ガイド

3021-3-A90-41

前書き

対象製品

P-2A2C-E1BL JP1/Automatic Operation 11-51（適用OS：Windows Server 2008 R2，Windows Server 2012，Windows Server 2012 R2，Windows Server 2016）

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

・P-CC2A2C-EABL JP1/Automatic Operation - Server 11-51（適用OS：Windows Server 2008 R2，Windows Server 2012，Windows Server 2012 R2，Windows Server 2016）

・P-CC2A2C-EBBL JP1/Automatic Operation - Contents 11-51（適用OS：Windows Server 2008 R2，Windows Server 2012，Windows Server 2012 R2，Windows Server 2016）

P-2A2C-E3BL JP1/Automatic Operation Content Pack 11-51（適用OS：Windows Server 2008 R2，Windows Server 2012，Windows Server 2012 R2，Windows Server 2016）

P-822C-E1BL JP1/Automatic Operation 11-51（適用OS：Linux 6 (x64)，Linux 7，Oracle Linux 6 (x64)，Oracle Linux 7，CentOS 6 (x64)，CentOS 7，SUSE Linux 12）

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

・P-CC822C-EABL JP1/Automatic Operation - Server 11-51（適用OS：Linux 6 (x64)，Linux 7，Oracle Linux 6 (x64)，Oracle Linux 7，CentOS 6 (x64)，CentOS 7，SUSE Linux 12）

・P-CC822C-EBBL JP1/Automatic Operation - Contents 11-51（適用OS：Linux 6 (x64)，Linux 7，Oracle Linux 6 (x64)，Oracle Linux 7，CentOS 6 (x64)，CentOS 7，SUSE Linux 12）

P-822C-E3BL JP1/Automatic Operation Content Pack 11-51（適用OS：Linux 6 (x64)，Linux 7，Oracle Linux 6 (x64)，Oracle Linux 7，CentOS 6 (x64)，CentOS 7，SUSE Linux 12）

輸出時の注意

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

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

商標類

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

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

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

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

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

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

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

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

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

UNIXは，The Open Groupの商標です。

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

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

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

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

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

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

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

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/

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

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

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 Andy Clark.

Java is a registered trademark of Oracle and/or its affiliates.

発行

2020年4月 3021-3-A90-41

著作権

All Rights Reserved. Copyright (C) 2016, 2020, Hitachi, Ltd.

変更内容

変更内容（3021-3-A90-41）JP1/Automatic Operation 11-51

追加・変更内容

変更個所

プロパティのマッピングの予約プロパティの説明を変更した。

3.6.4

可視性またはデータ型によるマッピングの可否を変更した。

3.6.5

サービスの入力プロパティに設定する項目の説明を変更した。

4.2.4

ビルトインサービス共有プロパティの説明を変更した。

4.3.4

プロパティグループに設定する項目を変更した。

4.4.1

サービステンプレートを複製する場合のヒントを変更した。

5.2.1

部品の作成または編集時にコマンドラインに入力プロパティを挿入する際の説明を変更した。

6.4.2

スクリプトファイル作成時の注意を変更した。

6.4.4

ビルドをデバッグに変更した。

A.1(1)，A.1(2)，A.1(3)

11-10の変更内容の階層フロー部品に関する説明を削除した。

A.3(3)

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

はじめに

このマニュアルは，JP1/Automatic Operationで使用するサービステンプレートおよび部品の開発手順について説明したものです。なお，このマニュアルでは，JP1/Automatic OperationをJP1/AOと表記します。

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

対象読者

このマニュアルは，次の方を対象に説明しています。

サービステンプレートを新規作成する方

サービステンプレートを編集する方

なお，対象読者には，JP1/AOに関する基本的な知識があることを前提としています。

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

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

表記

製品名

Internet Explorer

Windows(R) Internet Explorer(R)

Windows Server 2008 R2

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

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

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

Windows Server 2012

Microsoft(R) Windows Server(R) 2012 Datacenter

Microsoft(R) Windows Server(R) 2012 Standard

Windows Server 2012 R2

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

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

Windows Server 2016

Microsoft(R) Windows Server(R) 2016 Datacenter

Microsoft(R) Windows Server(R) 2016 Standard

Windows Server 2016，Windows Server 2012 R2，Windows Server 2012，およびWindows Server 2008 R2を総称してWindowsと表記することがあります。

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

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

書式

説明

文字列

可変の値を示します。

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

［ ］

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

［ ］－［ ］

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

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

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

「 」

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

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

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

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

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

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

システムドライブ¥Program Files¥Hitachi¥HiCommand¥Base64

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

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

/opt/jp1ao

/var/opt/jp1ao

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

/opt/HiCommand/Base64

マニュアルで掲載している画面図について

製品の改良などによって，このマニュアルに掲載されている画面はご使用の製品画面と一部異なることがあります。あらかじめご了承ください。

1　サービステンプレート開発の流れ

サービステンプレートの開発の流れを説明します。ITシステムの運用手順を自動化するための処理をサービステンプレートとして定義します。

1.1　概要

サービステンプレート開発の流れおよび開発に使用する要素について説明します。

1.1.1　サービステンプレート開発の流れ

JP1/AOでは，「サービステンプレート」を使用して運用手順を自動化できます。煩雑な運用手順や，不定期でありながらも実行頻度の多い運用手順などの自動化で特に効果を発揮します。

サービステンプレートは新規作成するほか，JP1/AOが提供するサービステンプレート※1を複製したあと，ユーザーの運用に応じて作業手順を追加・削除するなど，編集して使用する※2こともできます。また，JP1/AOが提供するサービステンプレートをそのまま使用することもできます。

注※1

JP1/AOが提供しているサービステンプレートには，JP1/AOに同梱されるJP1運用コンテンツのほかに，JP1/AO Content Pack（別製品）として販売しているコンテンツセットがあります。

注※2

JP1/AOが提供するサービステンプレートを編集したい場合は，該当するサービステンプレートをインポートしてください。

ヒント

サービステンプレートの開発に，JP1/AOが提供するコンテンツ部品を使用したい場合は，そのコンテンツ部品を含むサービステンプレートをインポートしてください。また，部品提供用のサービステンプレートとして「種別 Components」を提供しています。例えば，「HCS Components」や「Oracle Componentes」などがあります。

これらのサービステンプレートに含まれる部品については，マニュアルJP1/AO サービステンプレートリファレンス－「部品提供用のサービステンプレートに含まれる部品一覧」のトピックを参照してください。

サービステンプレートの開発の流れを次に示します。

図1‒1　サービステンプレート開発の流れ

ヒント

JP1/AOが提供する部品は，汎用性を考慮しているため，部品のプロパティに詳細な入力制限を設定していません。これらの部品を使用してサービステンプレートを作成する場合，必要に応じて，サービスプロパティ（サービスの定義情報）の入力制限を検討してください。

サービステンプレートを新規作成する場合の関連トピック

1.1.2　サービステンプレートの開発に使用する要素

1.2　サービステンプレートの開発に使用する主な画面

1.3.1　サービステンプレートを新規作成する場合の作業内容と構成

1.4　サービステンプレートを新規作成する流れ

サービステンプレートを編集して使用する場合の関連トピック

1.1.2　サービステンプレートの開発に使用する要素

1.2　サービステンプレートの開発に使用する主な画面

1.3.2　サービステンプレートを編集して使用する場合の作業内容と構成

1.5　サービステンプレートを編集して使用する流れ

サービステンプレートをそのまま使用する場合の関連トピック

1.1.2　サービステンプレートの開発に使用する要素

1.3.3　サービステンプレートをそのまま使用する場合の作業内容と構成

1.6　JP1/AOが提供するサービステンプレートをそのまま使用する流れ

1.1.2　サービステンプレートの開発に使用する要素

サービステンプレートには，運用手順を自動化するために必要な情報が定義されています。サービステンプレートの開発に使用する要素を次に示します。

図1‒2　サービステンプレートの開発に使用する要素

開発環境

サービステンプレートを開発するための環境です。開発したサービステンプレートの動作を検証するため，デバッグや運用テストも実行します。サービステンプレートは本番環境で開発することもできますが，開発環境と本番環境は別にすることを推奨します。

本番環境

開発が完了したサービステンプレートからサービスを作成し，実行するための環境です。実際に自動化の運用を行います。

サービステンプレート

ITシステムの運用手順を自動化するための処理が定義されています。サービステンプレートにはフローおよびステップが含まれています。

開発サービステンプレート

ユーザーが作成中のサービステンプレートです。リリースサービステンプレートを複製して作成したサービステンプレートも，開発サービステンプレートに含まれます。開発環境で使用します。

リリースサービステンプレート

開発サービステンプレートをリリースすると，リリースサービステンプレートになります。リリースサービステンプレートは，編集できません。JP1/AOが提供するサービステンプレートもリリースサービステンプレートに含まれます。本番環境で実際に使用します。

フロー

自動化する運用手順の流れが定義されています。

コンポーネント

ステップとして配置できる部品およびリリースサービステンプレートのことです。

部品

IT運用を自動化するための処理の最小単位です。

ステップ

フローを構成する要素で，1つのコンポーネントを実行します。

1.2　サービステンプレートの開発に使用する主な画面

サービステンプレートの開発には，主に［Service Builder］画面を使用します。一部の操作は，［サービステンプレート］画面からも実施できます。

1.2.1　サービステンプレートを開発するときの画面の遷移

［Service Builder］画面は，［Service Builder Home］画面および［Service Builder Edit］画面の2つの画面を切り替えて操作します。

［Service Builder Home］画面は，サービステンプレート開発に関する操作の起点となる画面です。サービステンプレートを開発するときは，まずこの画面から実施したい操作を選択してください。

［Service Builder Edit］画面の［フロー］タブで編集をしたあと，［Service Builder Edit］画面の［プロパティ］タブでサービスプロパティの設定をすると，スムーズにサービステンプレートを編集できます。なお，［Service Builder Edit］画面の［フロー］タブと［Service Builder Edit］画面の［プロパティ］タブは，サービステンプレートの編集中，何度でも画面を切り替えられます。

図1‒3　サービステンプレートの開発に使用する主な画面（サービステンプレートを作成・編集・複製するとき）

サービステンプレートの編集が終わったら，［Service Builder Debug］画面でサービステンプレートをデバッグします。

図1‒4　サービステンプレートの開発に使用する主な画面（サービステンプレートをデバッグするとき）

関連項目

1.2.2　［Service Builder］画面

8.3.1　［Service Builder Debug］画面

1.2.2　［Service Builder］画面

［Service Builder］画面は，サービステンプレートや部品を開発するための画面です。［Service Builder］画面は，メイン画面で［ツール］－［サービスビルダー］を選択すると表示されます。

［Service Builder Home］画面

［Service Builder Home］画面は，サービステンプレートや部品の開発の起点となる画面です。

図1‒5　［Service Builder Home］画面

［Service Builder Home］画面には，すでに作成されているサービステンプレート（［リリース］タブ），または現在開発中のサービステンプレート（［開発］タブ）が表示されます。選択したサービステンプレートに関連する詳細にアクセスしたり，管理機能（編集，参照，複製，エクスポート，削除）を実行したりできます。必要な場合はサービステンプレートをインポートまたは新しいテンプレートを作成したりできます。

画面左上のテキスト検索ボックスを使用して，サービステンプレートを検索できます。また，サービステンプレートが関連付けられているタググループに基づいて検索を実行できます。［カードビュー］タブ，または［テーブルビュー］タブを使用して，サービステンプレートの表示を切り替えられます。

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

［部品の操作］プルダウンメニュー

部品に対して実行する操作を指定できます。

［作成］：開発部品を新規に作成できます。

［編集］：開発部品を編集できます。

［リソース設定］：開発部品にリソースファイルを設定できます。

［複製］：開発部品またはリリース部品を複製できます。

［削除］：開発部品またはリリース部品を削除できます。

［ツール］プルダウンメニュー

［画面設定の初期化］を選択すると，設定した画面を初期化（工場出荷時の状態）します。

［ヘルプ］プルダウンメニュー

［オンラインマニュアル］を選択すると，JP1/AOのマニュアルが表示されます。

［×］ボタン

アプリケーションを終了するかどうかを確認するダイアログボックス（確認画面）で［OK］ボタンをクリックすると，［Service Builder Home］画面が閉じメイン画面に戻ります。

［開発］タブ

［インポート］ボタン

開発サービステンプレートまたはリリースサービステンプレートをJP1/AOサーバにインポートできます。

［サービステンプレート作成］ボタン

開発サービステンプレートを新規に作成できます。

［編集］ボタン

選択した開発サービステンプレートを編集できます。

［参照］ボタン

選択した開発サービステンプレートを参照できます。

［複製］ボタン

選択した開発サービステンプレートを複製できます。

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

選択したサービステンプレートに関連する詳細を表示します。

［その他の操作］プルダウンメニュー

［エクスポート］：選択したサービステンプレートの内容を指定したファイルにエクスポートします。

［削除］：選択したサービステンプレートを削除します。

［リリース］タブ

［参照］ボタン

選択したリリースサービステンプレートを参照できます。

［複製］ボタン

選択したリリースサービステンプレートを複製できます。

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

選択したサービステンプレートに関連する詳細を表示します。

［Service Builder Edit］画面

［Service Builder Edit］画面は，サービステンプレートのフローやプロパティを編集するための画面です。

図1‒6　［Service Builder Edit］画面

サービステンプレートの編集は，［Service Builder Edit］画面で行います。タブを切り替えることによって，サービステンプレートの詳細，定義情報の設定やプロパティの設定を参照および編集できます。

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

［フロー］タブ

サービステンプレートのフローを作成したり，編集したりします。詳細については「3.1　［Service Builder Edit］画面の［フロー］タブ」のトピックを参照してください。

［定義情報］タブ

サービステンプレートに関連する詳細を表示します。［編集］ボタンをクリックすると，サービステンプレートを編集およびカスタマイズできます。詳細については「2.2.1　［Service Builder Edit］画面の［定義情報］タブ」のトピックを参照してください。

［プロパティ］ タブ

サービステンプレートに関連付けられた入力プロパティと出力プロパティを表示します。詳細については「4.1　［Service Builder Edit］画面の［プロパティ］タブ」のトピックを参照してください。

［閉じる］ボタン

［Service Builder Home］画面に戻ります。

［保存］ボタン

サービステンプレートを保存できます。

［デバッグ］ボタン

サービステンプレートをビルドできます。ビルドに成功すると，サービステンプレートをデバッグできるようになります。

［リリース］ボタン

サービステンプレートをリリースできます。

［操作］プルダウンメニュー

［リソース設定］を選択すると，サービステンプレートにリソースファイルを設定できます。

［コンポーネントバージョン管理］を選択すると，サービステンプレートのステップとして使用しているコンポーネントのバージョンを管理できます。

関連項目

1.2.1　サービステンプレートを開発するときの画面の遷移

1.2.3　サービステンプレートの編集を開始する手順

サービステンプレートは，［Service Builder Edit］画面で編集します。なお，リリースサービステンプレートは編集できないため，一度開発テンプレートとして複製してから編集する必要があります。

サービステンプレートの編集を開始するには：

メイン画面で，［ツール］メニューから［サービスビルダー］を選択します。

図1‒7　［サービスビルダー］選択

編集したい開発サービステンプレートを選択し，［編集］ボタンをクリックします。

操作結果

［Service Builder Edit］画面の［フロー］タブが表示されます。引き続き，フローの作成・編集や，サービスプロパティの設定をしてください。

ヒント

リリースサービステンプレートを編集したい場合，［Service Builder Home］－［リリース］タブの［複製］ボタンから操作すると，定義情報（［サービステンプレート複製］ダイアログボックス）を設定したあと，［Service Builder Edit］画面の［フロー］タブが自動的に表示されます。

関連項目

2.1　開発サービステンプレートおよびリリースサービステンプレートとは

5.2.1　サービステンプレートを複製する手順

3.4　ステップを追加・編集する

4.2　サービスプロパティを編集・追加する

1.2.4　［Service Builder］画面で割り込み操作があった場合の注意事項

サービステンプレートまたは部品の編集中に，別のユーザーが同じサービステンプレートまたは部品に対して割り込み操作を行った場合の動作について示します。ここではサービステンプレートを例に説明していますが，部品の場合も同じ動作です。

［Service Builder］画面でサービステンプレートを編集しているユーザーを「操作ユーザー」とします。また，操作ユーザーが作業中のサービステンプレートに別の操作をするユーザーを「割り込みユーザー」とします。

サービステンプレートの編集中に対象が複製される場合

操作ユーザーがサービステンプレートの編集中でも，割り込みユーザーは同一対象を複製できます。複製されるサービステンプレートは，操作ユーザーが編集結果を保存する前の内容となります。

図1‒8　サービステンプレートの編集中に対象が複製される場合

サービステンプレートまたは部品の編集中に，ファイルが削除またはファイル名が変更される場合

操作ユーザーがサービステンプレートまたは部品の編集中に，割り込みユーザーが同一の対象に次の操作をした場合，操作ユーザーがサービステンプレートまたは部品を保存する時点，サービステンプレートをビルドまたはリリースする時点で，エラーメッセージが表示されます。

部品に設定されている部品アイコン（標準の部品アイコンは除く）を削除した

部品に設定されているスクリプトファイルを削除，またはファイル名を変更した

サービステンプレートに設定されている画面カスタムファイルを削除，またはファイル名を変更した

図1‒9　サービステンプレートの編集中に，ファイルが削除またはファイル名が変更される場合

サービステンプレートの編集中に対象がリリースされる場合

操作ユーザーがサービステンプレートを編集中に，割り込みユーザーが同一の対象をリリースした場合，リリースは正常に実行されます。しかし，操作ユーザーが編集中の画面にはリリースされたことが反映されません。操作ユーザーがサービステンプレートの編集内容を保存する時点で，保存に失敗し，エラーメッセージが表示されます。

リリースする場合は，ほかのユーザーが対象のサービステンプレートを編集中でないか確認してください。

図1‒10　サービステンプレートの編集中に対象がリリースされる場合

1.3　作業内容とサービステンプレートの構成

サービステンプレートを開発したり，JP1/AOが提供しているサービステンプレートをそのまま使用したりする場合の作業内容と構成について説明します。

1.3.1　サービステンプレートを新規作成する場合の作業内容と構成

サービステンプレートを新規作成する場合の作業内容と構成について次に示します。作業は図中の数字の順に進めます。

図1‒11　サービステンプレートを新規作成する場合の作業内容と構成

1.3.2　サービステンプレートを編集して使用する場合の作業内容と構成

サービステンプレートを編集して使用する場合の作業内容と構成について次に示します。作業は図中の数字の順に進めます。ただし，図中の破線の内側にある作業は，ニーズに応じて実施するかどうかを選択できます。

図1‒12　サービステンプレートを編集して使用する場合の作業内容と構成

1.3.3　サービステンプレートをそのまま使用する場合の作業内容と構成

サービステンプレートをそのまま使用する場合の作業内容と構成について次に示します。作業は図中の数字の順に進めます。

図1‒13　サービステンプレートをそのまま使用する場合の作業内容と構成

1.4　サービステンプレートを新規作成する流れ

サービステンプレートを新規作成する場合の作業の流れとマニュアルの参照先を示します。

1.4.1　サービステンプレートを新規作成する流れ

JP1/AOが提供するサービステンプレートを利用するだけでなく，ユーザー独自のサービステンプレートを新規作成することもできます。

例えばこんなときに

すでにあるサービステンプレートではなく，独自のサービステンプレートを作成したいとき。

作業に必要な知識

2.1　開発サービステンプレートおよびリリースサービステンプレートとは

2.2.4　サービステンプレートの定義情報として設定する項目について

6.2.3　部品の定義情報として設定する項目について

5.4.1　リリースとは

作業の流れ

表1‒1　サービステンプレートを新規作成する流れ

作業

作業の要否

参照先

1

空のサービステンプレートを作成する

必須

2.2.2　空のサービステンプレートを作成する手順

2

すでにある部品を使用しない場合は，部品を新規作成する

任意

6.2.1　部品を作成する手順

リリース部品を編集して使用したい場合は，部品を複製してから編集する

任意

7.1.1　部品を複製する手順

6.2.2　部品の定義情報を編集する手順

開発部品を編集して使用したい場合は，部品を編集する

任意

6.2.2　部品の定義情報を編集する手順

3

フローを作成する

必須

3.　サービステンプレートのフローを作成・編集する

4

サービスプロパティを設定する

必須

4.　サービスプロパティを設定する

5

作成したサービステンプレートを検証する※

任意

8.　サービステンプレートを検証する

6

完成したサービステンプレートをリリースして，サービスを作成できる状態にする

必須

5.4.2　サービステンプレートをリリースする手順

7

サービステンプレートを開発環境からほかの環境に移動したい場合，サービステンプレートをエクスポートしたあと，移動先の環境にインポートする

任意

5.5.1　サービステンプレートをエクスポートする手順，5.6.1　サービステンプレートをインポートする手順

8

サービスを作成・編集・実行する

必須

マニュアルJP1/AO 運用ガイド

「サービスを作成する手順」のトピック

「サービスを編集する手順」のトピック

「サービスを実行する手順」のトピック

注※

サービステンプレートを検証して問題点を摘出した場合は，必要に応じて2～5の作業を実施してください。

1.5　サービステンプレートを編集して使用する流れ

JP1/AOが提供しているサービステンプレート（JP1/AO同梱およびJP1/AO Content Pack）を複製および編集することで，ユーザー独自のサービステンプレートを作成できます。リリースサービステンプレートを編集したい場合は，複製後，新たなサービステンプレートとして編集します。

重要

JP1/AOが提供するサービステンプレート（JP1/AO同梱およびJP1/AO Content Pack）および部品は，編集すると製品サポート対象外となります。ただし，製品サポート対象外のサービステンプレートであっても，そこから呼び出されるJP1/AOが提供する部品（JP1/AO同梱およびJP1/AO Content Pack）は製品サポートの対象となります。

サービステンプレートを編集して使用するケースの一覧を次に示します。

表1‒2　開発内容に応じたマニュアルの参照先

作業内容

例えばこんなときに

参照先

検討する

すでにあるサービステンプレートや部品をそのまま使用できるか検討するとき。

マニュアルJP1/AO サービステンプレートリファレンス

サービステンプレートの定義情報の編集

サービステンプレート名を「仮想サーバの停止」から「仮想サーバの停止とメール送信」に変更したいとき。

1.5.1　サービステンプレートの定義情報を編集する流れ

部品の編集

部品に定義されているスクリプトやコマンドの内容を変更したいとき。

［フロー］エリアに表示される部品のアイコンを変更したいとき。

1.5.2　部品を編集してサービステンプレートに適用する流れ

部品の新規作成

部品を新規作成し，任意のコマンドを実行する処理を定義したいとき。

1.5.3　部品を新規作成してサービステンプレートに適用する流れ

ステップとして使用しているコンポーネントのバージョンの変更

ステップとして使用している部品を最新バージョンの部品に置き換えたいとき。

1.5.4　ステップとして使用しているコンポーネントのバージョンを変更する流れ

サービステンプレートへのステップの追加または削除

サービステンプレートで自動化している処理の最後に，メールを送る処理を追加したいとき。

JP1/IMおよびJP1/Baseのログを取得する処理の流れで，ファイル転送の処理が不要になったとき。

1.5.5　サービステンプレートの処理を追加または削除する流れ

サービスを実行する際のプロパティ値の動的な設定，または静的な設定

メモリ容量を増やす処理で，メモリ容量を5GBで毎回固定したいとき。

あるコマンドの実行結果に対して，次のコマンドを実行したいとき。

1.5.6　サービスを実行する際のプロパティ値を，動的または静的に設定する場合の流れ

サービスの実行者がサービスの実行に必要な値を指定したり， サービスの実行結果を取得したりするためのプロパティの設定

メモリ容量を増やす処理で，メモリ容量を固定ではなくサービスの実行時に指定できるようにしたいとき。

部品の処理の結果を［タスク詳細］画面で確認したいとき。

1.5.7　サービスのプロパティを設定する流れ

1.5.1　サービステンプレートの定義情報を編集する流れ

サービステンプレートの定義情報とは，JP1/AOの操作画面に表示されるサービステンプレートの名称や説明のことです。

例えばこんなときに

サービステンプレート名を「仮想サーバの停止」から「仮想サーバの停止とメール送信」に変更したいとき。

作業に必要な知識

2.1　開発サービステンプレートおよびリリースサービステンプレートとは

2.2.4　サービステンプレートの定義情報として設定する項目について

5.4.1　リリースとは

作業の流れ

表1‒3　サービステンプレートの定義情報を編集する流れ

作業

作業の要否

参照先

1

リリースサービステンプレートを編集する場合，サービステンプレートを複製する

任意

5.2.1　サービステンプレートを複製する手順

2

サービステンプレートの定義情報を変更する

必須

2.2.3　サービステンプレートの定義情報を変更する手順

3

完成したサービステンプレートをリリースして，サービスを作成できる状態にする

必須

5.4.2　サービステンプレートをリリースする手順

4

サービステンプレートを開発環境からほかの環境に移動したい場合，サービステンプレートをエクスポートしたあと，移動先の環境にインポートする

任意

5.5.1　サービステンプレートをエクスポートする手順，5.6.1　サービステンプレートをインポートする手順

5

サービスを作成・編集・実行する

必須

マニュアルJP1/AO 運用ガイド

「サービスを作成する手順」のトピック

「サービスを編集する手順」のトピック

「サービスを実行する手順」のトピック

1.5.2　部品を編集してサービステンプレートに適用する流れ

基本部品以外の部品は編集できます。部品を編集したあと，サービステンプレートに適用します。なお，すでにリリースされている部品の場合は，複製したあとに編集します。

例えばこんなときに

部品に定義されているスクリプトやコマンドの内容を変更したいとき。

［フロー］エリアに表示される部品のアイコンを変更したいとき。

作業に必要な知識

6.1　部品とは

2.1　開発サービステンプレートおよびリリースサービステンプレートとは

5.4.1　リリースとは

作業の流れ

表1‒4　部品を編集してサービステンプレートに適用する流れ

作業

作業の要否

参照先

1

リリース部品を編集したい場合，部品を複製する

任意

7.1.1　部品を複製する手順

2

部品の定義情報を編集する

必須

6.2.2　部品の定義情報を編集する手順

3

リリースサービステンプレートに部品を適用する場合，サービステンプレートを複製する

任意

5.2.1　サービステンプレートを複製する手順

4

編集した部品をステップとしてフローに追加するか，すでにステップとして使用されている部品の場合，新しいバージョンに変更する

必須

3.4.1　ステップを追加する手順，3.7.4　ステップとして使用しているコンポーネントのバージョンを任意に変更する手順

5

部品を編集したことで処理の流れに影響がある場合，ステップを追加・削除する

任意

3.4　ステップを追加・編集する，3.5.3　ステップおよび関連線に実行できる操作

6

部品を編集したことでステッププロパティに影響がある場合，ステッププロパティを設定する

任意

3.6　ステッププロパティを設定する

7

部品を編集したことでサービスプロパティに影響がある場合，サービスプロパティを設定する

任意

4.2　サービスプロパティを編集・追加する

8

編集したサービステンプレートを検証する※

任意

8.　サービステンプレートを検証する

9

完成したサービステンプレートをリリースして，サービスを作成できる状態にする

必須

5.4.2　サービステンプレートをリリースする手順

10

サービステンプレートを開発環境からほかの環境に移動したい場合，サービステンプレートをエクスポートしたあと，移動先の環境にインポートする

任意

5.5.1　サービステンプレートをエクスポートする手順，5.6.1　サービステンプレートをインポートする手順

11

サービスを作成・編集・実行する

必須

マニュアルJP1/AO 運用ガイド

「サービスを作成する手順」のトピック

「サービスを編集する手順」のトピック

「サービスを実行する手順」のトピック

注※

サービステンプレートを検証して問題点を摘出した場合は，必要に応じて2～8の作業を実施してください。

1.5.3　部品を新規作成してサービステンプレートに適用する流れ

ユーザー独自の部品を新規作成できます。新規作成した部品を，サービステンプレートにステップとして追加します。

例えばこんなときに

部品を新規作成し，任意のコマンドを実行する処理を定義したいとき。

作業に必要な知識

6.1　部品とは

2.1　開発サービステンプレートおよびリリースサービステンプレートとは

5.4.1　リリースとは

作業の流れ

表1‒5　部品を新規作成してサービステンプレートに適用する流れ

作業

作業の要否

参照先

1

部品を作成する

必須

6.2.1　部品を作成する手順

2

リリースサービステンプレートを編集したい場合，サービステンプレートを複製する

任意

5.2.1　サービステンプレートを複製する手順

3

作成した部品をステップとしてフローに追加する

必須

3.4.1　ステップを追加する手順

4

ステップを追加したことで処理の流れに影響がある場合，ステップを追加・削除する

任意

3.4　ステップを追加・編集する，3.5.3　ステップおよび関連線に実行できる操作

5

部品を編集したことでステッププロパティに影響がある場合，ステッププロパティを設定する

任意

3.6　ステッププロパティを設定する

6

部品を編集したことでサービスプロパティに影響がある場合，サービスプロパティを設定する

任意

4.2　サービスプロパティを編集・追加する

7

編集したサービステンプレートを検証する※

任意

8.　サービステンプレートを検証する

8

完成したサービステンプレートをリリースして，サービスを作成できる状態にする

必須

5.4.2　サービステンプレートをリリースする手順

9

サービステンプレートを開発環境からほかの環境に移動したい場合，サービステンプレートをエクスポートしたあと，移動先の環境にインポートする

任意

5.5.1　サービステンプレートをエクスポートする手順，5.6.1　サービステンプレートをインポートする手順

10

サービスを作成・編集・実行する

必須

マニュアルJP1/AO 運用ガイド

「サービスを作成する手順」のトピック

「サービスを編集する手順」のトピック

「サービスを実行する手順」のトピック

注※

サービステンプレートを検証して問題点を摘出した場合は，必要に応じて1～7の作業を実施してください。

1.5.4　ステップとして使用しているコンポーネントのバージョンを変更する流れ

サービステンプレートでステップとして使用しているコンポーネントを，別のバージョンに置き換えられます。

例えばこんなときに

ステップとして使用している部品を最新バージョンの部品に置き換えたいとき。

作業に必要な知識

6.1　部品とは

2.1　開発サービステンプレートおよびリリースサービステンプレートとは

3.7.1　ステップとして使用しているコンポーネントのバージョンの管理について

5.4.1　リリースとは

作業の流れ

表1‒6　ステップとして使用しているコンポーネントのバージョンを変更する流れ

作業

作業の要否

参照先

1

リリースサービステンプレートに部品を適用する場合，サービステンプレートを複製する

任意

5.2.1　サービステンプレートを複製する手順

2

ステップが使用するコンポーネントのバージョンを確認し，必要に応じて，バージョンを変更する

必須

3.7　ステップとして使用しているコンポーネントのバージョンを管理する

3

コンポーネントのバージョンを変更したことでステッププロパティに影響がある場合，ステッププロパティを設定する

任意

3.6　ステッププロパティを設定する

4

コンポーネントのバージョンを変更したことでサービスプロパティに影響がある場合，サービスプロパティを設定する

任意

4.2　サービスプロパティを編集・追加する

5

編集したサービステンプレートを検証する※

任意

8.　サービステンプレートを検証する

6

完成したサービステンプレートをリリースして，サービスを作成できる状態にする

必須

5.4.2　サービステンプレートをリリースする手順

7

サービステンプレートを開発環境からほかの環境に移動したい場合，サービステンプレートをエクスポートしたあと，移動先の環境にインポートする

任意

5.5.1　サービステンプレートをエクスポートする手順，5.6.1　サービステンプレートをインポートする手順

8

サービスを作成・編集・実行する

必須

マニュアルJP1/AO 運用ガイド

「サービスを作成する手順」のトピック

「サービスを編集する手順」のトピック

「サービスを実行する手順」のトピック

注※

サービステンプレートを検証して問題点を摘出した場合は，必要に応じて2～5の作業を実施してください。

1.5.5　サービステンプレートの処理を追加または削除する流れ

既存のサービステンプレートに含まれるフローに対し，ユーザーがステップを追加することで処理を追加できます。ステップを削除すると，処理を削除できます。

例えばこんなときに

サービステンプレートで自動化している処理の最後に，メールを送る処理を追加したいとき。

JP1/IMおよびJP1/Baseのログを取得する処理の流れで，ファイル転送の処理が不要になったとき。

作業に必要な知識

2.1　開発サービステンプレートおよびリリースサービステンプレートとは

3.2　フローとステップの関係

3.3　フローの階層化について

5.4.1　リリースとは

作業の流れ

表1‒7　サービステンプレートの処理を追加または削除する流れ

作業

作業の要否

参照先

1

リリースサービステンプレートを編集したい場合，サービステンプレートを複製する

任意

5.2.1　サービステンプレートを複製する手順

2

ステップを追加または削除する

必須

3.4.1　ステップを追加する手順，3.5.3　ステップおよび関連線に実行できる操作

3

ステップを追加または削除したことで処理の流れに影響がある場合，ステップの実行順序を見直す

任意

3.5.1　ステップの実行順序を定義する手順

4

ステップを追加または削除したことで，ステッププロパティまたはサービスプロパティに影響がある場合，ステッププロパティまたはサービスプロパティを設定する

任意

3.6　ステッププロパティを設定する，4.2　サービスプロパティを編集・追加する

5

編集したサービステンプレートを検証する※

任意

8.　サービステンプレートを検証する

6

完成したサービステンプレートをリリースして，サービスを作成できる状態にする

必須

5.4.2　サービステンプレートをリリースする手順

7

サービステンプレートを開発環境からほかの環境に移動したい場合，サービステンプレートをエクスポートしたあと，移動先の環境にインポートする

任意

5.5.1　サービステンプレートをエクスポートする手順，5.6.1　サービステンプレートをインポートする手順

8

サービスを作成・編集・実行する

必須

マニュアルJP1/AO 運用ガイド

「サービスを作成する手順」のトピック

「サービスを編集する手順」のトピック

「サービスを実行する手順」のトピック

注※

サービステンプレートを検証して問題点を摘出した場合は，必要に応じて2～5の作業を実施してください。

1.5.6　サービスを実行する際のプロパティ値を，動的または静的に設定する場合の流れ

ステッププロパティをほかのステッププロパティまたはサービスプロパティとマッピングすることで，プロパティ値を代入して処理を実行できます。入力プロパティの値は固定することもできます。

すでにある入力プロパティや出力プロパティにマッピングするだけでなく，プロパティを新規に追加してマッピングすることもできます。

例えばこんなときに

メモリ容量を増やす処理で，メモリ容量を固定ではなくサービスの実行時に指定できるようにしたいとき（入力プロパティの動的な設定）。

メモリ容量を増やす処理で，メモリ容量を毎回5GBで固定したいとき（入力プロパティの静的な設定）。

作業に必要な知識

2.1　開発サービステンプレートおよびリリースサービステンプレートとは

3.6.1　ステッププロパティとは

3.6.7　ステッププロパティの定義例について

5.4.1　リリースとは

作業の流れ

表1‒8　サービスを実行する際のプロパティ値を，動的または静的に設定する場合の流れ

作業

作業の要否

参照先

1

リリースサービステンプレートを編集する場合，サービステンプレートを複製する

任意

5.2.1　サービステンプレートを複製する手順

2

ステッププロパティを設定する

必須

3.6　ステッププロパティを設定する

3

ステッププロパティを設定したことでサービスプロパティに影響がある場合，サービスプロパティを設定する

任意

4.2　サービスプロパティを編集・追加する

4

編集したサービステンプレートを検証する※

任意

8.　サービステンプレートを検証する

5

完成したサービステンプレートをリリースして，サービスを作成できる状態にする

必須

5.4.2　サービステンプレートをリリースする手順

6

サービステンプレートを開発環境からほかの環境に移動したい場合，サービステンプレートをエクスポートしたあと，移動先の環境にインポートする

任意

5.5.1　サービステンプレートをエクスポートする手順，5.6.1　サービステンプレートをインポートする手順

7

サービスを作成・編集・実行する

必須

マニュアルJP1/AO 運用ガイド

「サービスを作成する手順」のトピック

「サービスを編集する手順」のトピック

「サービスを実行する手順」のトピック

注※

サービステンプレートを検証して問題点を摘出した場合は，必要に応じて2～4の作業を実施してください。

1.5.7　サービスのプロパティを設定する流れ

サービスの実行者がサービスの実行に必要なパラメータを指定したり， サービスの実行結果を取得したりするためのプロパティを設定できます。

例えばこんなときに

メモリ容量を増やす処理で，メモリ容量を固定ではなくサービスの実行時に指定できるようにしたいとき。

部品の処理の結果を［タスク詳細］画面で確認したいとき。

作業に必要な知識

2.1　開発サービステンプレートおよびリリースサービステンプレートとは

3.6.1　ステッププロパティとは

3.6.7　ステッププロパティの定義例について

4.2.1　サービスプロパティとは

5.4.1　リリースとは

作業の流れ

表1‒9　サービスのプロパティを設定する流れ

作業

作業の要否

参照先

1

リリースサービステンプレートを編集する場合，サービステンプレートを複製する

任意

5.2.1　サービステンプレートを複製する手順

2

ステッププロパティをサービスプロパティに昇格したい場合，ステッププロパティを設定する

任意

3.6　ステッププロパティを設定する

3

サービスプロパティを設定する

必須

4.2　サービスプロパティを編集・追加する

4

編集したサービステンプレートを検証する※

任意

8.　サービステンプレートを検証する

5

完成したサービステンプレートをリリースして，サービスを作成できる状態にする

必須

5.4.2　サービステンプレートをリリースする手順

6

サービステンプレートを開発環境からほかの環境に移動したい場合，サービステンプレートをエクスポートしたあと，移動先の環境にインポートする

任意

5.5.1　サービステンプレートをエクスポートする手順，5.6.1　サービステンプレートをインポートする手順

7

サービスを作成・編集・実行する

必須

マニュアルJP1/AO 運用ガイド

「サービスを作成する手順」のトピック

「サービスを編集する手順」のトピック

「サービスを実行する手順」のトピック

注※

サービステンプレートを検証して問題点を摘出した場合は，必要に応じて2～4の作業を実施してください。

1.6　JP1/AOが提供するサービステンプレートをそのまま使用する流れ

JP1/AOが提供しているサービステンプレートをそのまま使用する場合の作業の流れとマニュアルの参照先を示します。

1.6.1　JP1/AOが提供するサービステンプレートをそのまま使用する流れ

JP1/AOが提供するサービステンプレート（JP1/AO同梱およびJP1/AO Content Pack）をそのまま使用することもできます。

例えばこんなときに

次のように，すでにあるサービステンプレートの中に，自動化したい業務にぴったり合ったテンプレートがあったとき。

「監視設定追加」のサービステンプレートを使用して，JP1/NNMiおよびJP1/PFMに複数の監視対象サーバを追加したいとき。

「運用ユーザー追加」のサービステンプレートを使用して，OSユーザーおよびJP1ユーザーをそれぞれ追加し，マッピング情報を追加したいとき。

作業に必要な知識

2.1　開発サービステンプレートおよびリリースサービステンプレートとは

作業の流れ

表1‒10　JP1/AOが提供するサービステンプレートをそのまま使用する流れ

作業

作業の要否

参照先

1

使用するサービステンプレートを検討する

必須

マニュアルJP1/AO 導入・設計ガイド－「自動化する運用手順と使用するサービステンプレートの検討」のトピック

マニュアルJP1/AO サービステンプレートリファレンス

「JP1/AO 同梱版サービステンプレート一覧」のトピック

「JP1/AO Content Pack版サービステンプレート一覧」のトピック

2

サービステンプレートをJP1/AOに追加する

必須

マニュアルJP1/AO 運用ガイド－「サービステンプレートをインポートする手順」のトピック

3

サービスを作成・編集・実行する

必須

マニュアルJP1/AO 運用ガイド

「サービスを作成する手順」のトピック

「サービスを編集する手順」のトピック

「サービスを実行する手順」のトピック

1.7　サービステンプレート開発に関する機能一覧

サービステンプレート開発に関する機能一覧を次の表に示します。

表1‒11　サービステンプレート開発に関する機能一覧

機能

概要

参照先

サービステンプレートの作成・編集

定義情報の作成・編集

ユーザー独自のサービステンプレートを新規作成できます。

また，サービステンプレートを編集し，サービステンプレート名，説明，サービスプロパティ，画面カスタムファイルなどを任意の内容に書き換えられます。

2.2　サービステンプレートの定義情報を作成・変更する

ステップの追加

業務に必要な処理を配置するために，フローにステップを追加します。ステップの定義情報を編集することもできます。

3.4　ステップを追加・編集する

ステップの実行順序の定義

ステップを追加し，関連線で接続することで処理の実行順序を定義できます。

3.5　ステップの実行順序を定義する

ステッププロパティの設定

サービスを実行する際のプロパティ値を動的または静的に設定できます。

3.6　ステッププロパティを設定する

サービスプロパティの設定

サービスの設定時・実行時に入力する項目や，実行結果の確認 時に表示される項目を定義できます。

4.2　サービスプロパティを編集・追加する

ステップとして使用しているコンポーネントのバージョン管理

ステップに使用しているコンポーネントのバージョンの確認および変更ができます。

3.7　ステップとして使用しているコンポーネントのバージョンを管理する

サービステンプレートの表示情報の設定

サービステンプレート名や説明などのサービステンプレートの表示情報を，リソースファイルで設定できます。なお，リソースファイルはWebブラウザーのロケールごとに設定できます。

2.3　サービステンプレートの表示情報をリソースファイルで設定する

サービステンプレートの管理

サービステンプレートの参照

サービステンプレートの定義情報や処理内容を参照できます。

5.1　サービステンプレートを参照する

サービステンプレートの複製

サービステンプレートを複製できます。複製したサービステンプレートを編集して新たにサービステンプレートを作成できます。

5.2　サービステンプレートを複製する

サービステンプレートの削除

サービステンプレートを削除できます。

5.3　開発サービステンプレートを削除する

サービステンプレートのリリース

検証の済んだサービステンプレートをリリースすることで，サービステンプレートのパッケージが作成され，JP1/AOサーバにインポートされます。1度リリースしたサービステンプレートは編集できません。開発環境からほかの環境に移動したい場合は，サービステンプレートを手動でインポートする必要があります。

5.4　サービステンプレートをリリースする

サービステンプレートのエクスポート

サービステンプレートファイルを任意のフォルダに格納できます。

5.5　サービステンプレートをエクスポートする

サービステンプレートのインポート

リリースしたサービステンプレートを開発環境からほかの環境に移動したい場合に，サービステンプレートを移動先の環境にインポートします。

5.6　サービステンプレートをインポートする

部品の作成・編集

部品の作成

ユーザー独自の部品を新規作成できます。

6.2　部品の定義情報を作成・編集する，6.3　部品プロパティを設定する，6.4　プラットフォームを編集する

部品の編集

部品を編集できます。部品の名称や，入力プロパティ，出力プロパティ，リモートコマンドなどを設定します。なお，JP1/AOが提供する部品は編集できません。

部品の表示情報の設定

部品名や説明などの部品の表示情報を，リソースファイルで設定できます。なお，リソースファイルはWebブラウザーのロケールごとに設定できます。

6.5　部品の表示情報をリソースファイルで設定する

部品の管理

部品の複製

開発部品およびリリース部品を複製できます。複製した部品を編集して新たに部品を作成できます。

7.1　部品を複製する

部品の削除

開発部品およびリリース部品を削除できます。

7.2　部品を削除する

サービステンプレートの検証

サービステンプレートのビルド

ビルドすると，開発中のサービステンプレートのパッケージが作成され，JP1/AOサーバにインポートされます。サービステンプレートを検証するために行います。

8.2　サービステンプレートをビルドする

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

ビルドしたサービステンプレートの動作を確認し，問題点を摘出できます。デバッグでフローや部品の問題点を発見した場合は，サービステンプレートまたは部品を編集します。

8.3　サービステンプレートをデバッグする

サービステンプレートの運用テスト

ビルドしたサービステンプレートからサービスを作成・実行し，運用上の問題点を摘出できます。運用テストで問題点を発見した場合は，サービステンプレートまたは部品を編集します。

8.5　サービステンプレートの運用をテストする

2　サービステンプレートの定義情報を設定する

サービステンプレートの作成・編集時に必要な定義情報の設定について説明します。

2.1　開発サービステンプレートおよびリリースサービステンプレートとは

サービステンプレートには，開発サービステンプレートとリリースサービステンプレートがあります。

開発サービステンプレート

ユーザーが作成中のサービステンプレートです。リリースサービステンプレートを複製して作成しているサービステンプレートも，開発サービステンプレートに含まれます。

開発サービステンプレートをビルドすると，構成種別に「デバッグ」が設定され，サービス実行をテストできる状態になります。開発サービステンプレートから作成したサービスは，開発環境で使用します。ビルド前のサービステンプレートも開発サービステンプレートに含まれます。

開発サービステンプレートは次の画面に表示されます。

［Service Builder Home］画面の［開発］タブ

Developロール以上のユーザーが［サービス］画面の［作成］ボタンから表示する［サービステンプレート選択］ダイアログボックス

リリースサービステンプレート

開発サービステンプレートをリリースすることで，JP1/AOサーバにインポートされたサービステンプレートです。または，JP1/AOが提供するサービステンプレートです。本番環境で実際に使用します。構成種別には「リリース」が設定されています。

JP1/AOサーバにインポートしたサービステンプレートのうち，構成種別が「リリース」のものもリリースサービステンプレートとして扱われます。

リリースサービステンプレートは次の画面に表示されます。

［サービステンプレート］画面

［Service Builder Home］画面の［リリース］タブ

［サービス］画面の［作成］ボタンから表示する［サービステンプレート選択］ダイアログボックス

なお，一度リリースしたサービステンプレートは編集できません。編集したい場合は，リリーステンプレートを複製し，開発サービステンプレートとして編集してください。

重要

JP1/AOが提供するサービステンプレートおよび部品は，編集すると製品サポートの対象外となります。製品サポート対象外のサービステンプレートであっても，そこから呼び出されるJP1/AOが提供する部品（JP1/AO同梱およびJP1/AO Content Pack）は製品サポートの対象となります。

関連項目

5.4.2　サービステンプレートをリリースする手順

2.2　サービステンプレートの定義情報を作成・変更する

空のサービステンプレートを作成した場合や，すでにあるリリースサービステンプレートを複製した場合，サービステンプレートの定義情報を設定します。

2.2.1　［Service Builder Edit］画面の［定義情報］タブ

［Service Builder Edit］画面の［定義情報］タブは，サービステンプレートの作成または複製後，サービステンプレートの定義情報を編集するための画面です。

図2‒1　［Service Builder Edit］画面の［定義情報］タブ

サービステンプレートの定義情報が表示されます。［編集］ボタンをクリックすると，定義情報を編集できます。

2.2.2　空のサービステンプレートを作成する手順

サービステンプレートを新規作成する際は，まずサービステンプレートID，サービステンプレートバージョン，ベンダーIDなどの定義情報を設定します。

空のサービステンプレートを作成するには：

［Service Builder Home］画面の［開発］タブで，［サービステンプレート作成］ボタンをクリックします。

［サービステンプレート作成］ダイアログボックスでサービステンプレートの定義情報を設定し，［OK］ボタンをクリックします。

なお，［サービステンプレートID］,［サービステンプレートバージョン］，［ベンダーID］は作成後に変更できません。定義情報を保存する前によく確認してください。

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

ヒント

空のサービステンプレートは，［サービステンプレート］画面で［サービステンプレート作成］ボタンをクリックしても作成できます。

操作結果

空のサービステンプレートが作成され，［Service Builder Edit］画面の［フロー］タブが表示されます。

関連項目

2.2.4　サービステンプレートの定義情報として設定する項目について

1.2.3　サービステンプレートの編集を開始する手順

2.2.3　サービステンプレートの定義情報を変更する手順

3.　サービステンプレートのフローを作成・編集する

2.2.3　サービステンプレートの定義情報を変更する手順

サービステンプレートの作成または複製後，［Service Builder Edit］画面の［定義情報］タブで，一度設定したサービステンプレートの定義情報を変更できます。

サービステンプレートの定義情報を編集するには：

［Service Builder Home］画面の［開発］タブで，編集したい開発サービステンプレートを選択し，［編集］ボタンをクリックします。

［Service Builder Edit］画面の［定義情報］タブで，［編集］ボタンをクリックします。

［サービス定義編集］ダイアログボックスでサービステンプレートの定義情報を設定します。

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

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

操作結果

サービステンプレートの定義情報が設定されます。

重要

サービステンプレートの編集中に，別のユーザーによって割り込み操作が行われた場合，保存に失敗するおそれがあります。

関連項目

2.2.4　サービステンプレートの定義情報として設定する項目について

1.2.3　サービステンプレートの編集を開始する手順

1.2.4　［Service Builder］画面で割り込み操作があった場合の注意事項

2.2.4　サービステンプレートの定義情報として設定する項目について

［サービステンプレート作成］ダイアログボックス，［サービステンプレート複製］ダイアログボックス，および［サービス定義編集］ダイアログボックスでは次に示す項目を設定できます。

表2‒1　サービステンプレートの定義情報として設定する項目

項目

説明

［サービステンプレートID］※1

サービステンプレートを識別するIDを指定します。

［サービステンプレートバージョン］※1

サービステンプレートのバージョン番号を指定します。

「aa.bb.cc」の形式で指定します。

［ベンダーID］※1

サービステンプレートを作成したベンダーを識別するIDを指定します。

ベンダーIDは，ユニークとなるようにドメイン名をトップレベルドメイン名から逆順で「.」（ピリオド）区切りで指定してください。例えば「com.xxxx」や「jp.co.yyyy」のように指定してください。また，ベンダーIDにドメイン名を使用しない場合は，ほかのベンダーのベンダーIDと値が重複しないようにしてください。

なお，「com.hitachi.software.dna」で始まるベンダーIDは指定できません。

［サービステンプレート名］

サービステンプレートの名称を指定します。

［ベンダー名］※2

サービステンプレートを作成したベンダーの名称を指定します。

［説明］

サービステンプレートの説明を指定します。

［タグ］

サービステンプレートに定義するタグを指定します。タグは複数指定できます。

注※1

［サービステンプレートID］,［サービステンプレートバージョン］，［ベンダーID］はサービステンプレートの作成または複製後に変更できません。サービステンプレートは，これら3つの項目の組み合わせによって一意性が保証されています。

注※2

指定を省略した場合，［ベンダーID］に指定した値が［ベンダー名］に設定されます。

また，［サービス定義編集］ダイアログボックスでは，詳細設定として次の項目も設定できます。

表2‒2　詳細設定として設定できる項目

項目

説明

アイコン

サービステンプレートに設定されているアイコンが表示されます。［デフォルトアイコンを指定］ボタンをクリックすると，サービステンプレートに設定したアイコンがデフォルトに戻ります。［変更］ボタンをクリックすると，アップロードするアイコンファイルを選択するダイアログボックスが表示され，アイコンを変更できます。アイコンにはpng形式で，サイズが縦48ピクセル，横48ピクセルのファイルを設定してください。

画面カスタムファイル

サービステンプレートに設定されている画面カスタムファイルが表示されます。ファイル名をクリックすると，ファイルをダウンロードできます。［選択］ボタンをクリックすると，フォルダ選択ダイアログボックスが表示され，画面カスタムファイルが設定できます。［削除］ボタンをクリックすると，画面カスタムファイルの指定が解除されます。

サービス詳細説明画面のファイル名(相対パス)

画面カスタムファイルにzip形式のファイルを指定している場合，［サービス詳細説明］画面の設定ファイルの相対パスを指定します。

サービス概要のファイル名(相対パス)

画面カスタムファイルにzip形式のファイルを指定している場合，サービス概要の画像ファイルの相対パスを指定します。

スケジュール種別

サービスの実行時に指定できるスケジュール種別の選択肢を指定します。スケジュール種別には，「即時実行」，「指定日時実行」，および「定期実行」があります。なお，スケジュール種別の選択肢は，サービスの作成・編集時に，さらに絞り込むことができます。

有効なアクション

タスクに対して「強制停止」および「リトライ」を許可するかどうかを指定できます。なお，有効なアクションの選択肢は，サービス作成・編集時に，さらに絞り込むことができます。

関連項目

5.2.2　サービステンプレートおよび部品の一意性について

6.2.4　コンポーネントのアイコンとして設定できる画像ファイルについて

2.2.5　サービステンプレートに設定する画面カスタムファイルとは

2.2.5　サービステンプレートに設定する画面カスタムファイルとは

画面カスタムファイルとは，画面上のサービスの表示内容や表示形式を定義するためのファイルです。［サービス定義編集］画面で画面カスタムファイルを設定すると，［サービス詳細説明］画面の表示内容およびサービス概要の画像ファイルを定義できます。画面カスタムファイルをWebブラウザーのロケールごとに設定すると，Webブラウザーのロケールに対応した言語でサービスの詳細説明を参照できます。

サービス概要の画像ファイルは，次の画面に表示されます。

［サービス設定］画面

［サービス実行］画面

次の図に，画面の表示例を示します。

図2‒4　［サービス詳細説明］画面の表示例

図2‒5　サービス概要の画像ファイルの表示例

関連項目

2.2.6　サービステンプレートに画面カスタムファイルを設定する手順

2.2.7　画面カスタムファイルをWebブラウザーのロケールごとに切り替えるには

2.2.8　画面カスタムファイルの形式

2.2.6　サービステンプレートに画面カスタムファイルを設定する手順

サービステンプレートの画面カスタムファイルとして，単一または複数のファイルを設定できます。例えば，図やリンクを設定したい場合は，複数のファイルまたはフォルダをzip形式に圧縮して登録します。

なお，画面カスタムファイルは，設定したあとでも変更できます。

画面カスタムファイルを設定するには：

作成した複数のファイルを次のフォルダの配下に格納します。「任意のフォルダ¥webroot」配下に格納します。※

webrootフォルダの配下のファイルを.zip形式に圧縮します。このとき，webrootフォルダ自体は含めないでください。※

［サービス定義編集］ダイアログボックスで，［画面カスタムファイル］の［選択］ボタンをクリックします。

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

画面カスタムファイルに指定したいファイルを選択します。

［サービス詳細説明画面のファイル名(相対パス)］テキストボックスまたは［サービス概要のファイル名(相対パス)］テキストボックスに，対応するファイルの相対パスを入力します。※

設定したファイル（.zip）を展開したパスをカレントパスとして，相対パスで指定します。パスの区切り文字には「/」（スラッシュ）を使用してください。

注※ 画面カスタムファイルとして複数のファイルを設定する場合に必要な手順です。

ヒント

拡張子がzipのファイルの場合は，保存，ビルドまたはリリースすると，ファイル名が「webroot.zip」に自動で変更されます。

操作結果

サービステンプレートに画面カスタムファイルが設定されます。

関連項目

2.2.5　サービステンプレートに設定する画面カスタムファイルとは

2.2.7　画面カスタムファイルをWebブラウザーのロケールごとに切り替えるには

2.2.7　画面カスタムファイルをWebブラウザーのロケールごとに切り替えるには

画面カスタムファイルの.zip形式のファイルを作成するとき，各ロケールに対応したファイルを「webroot¥言語コード」の配下に格納しておけば，Webブラウザーのロケールに対応した画面カスタムファイルが読み込まれるため，表示が切り替わります。

このとき，webrootフォルダの配下のファイルを.zip形式に圧縮します。ただし，［サービス詳細説明画面のファイル名(相対パス)］テキストボックスまたは［サービス概要のファイル名(相対パス)］テキストボックスでは，「webroot¥言語コード」をカレントパスとした相対パスを指定してください。

言語コードとして指定できるのは，ISO-639で定義されている2桁の英小文字（ja，en，zh）です。

なお，webrootフォルダの直下にも画面カスタムファイルを格納しておくと，次の場合に，webrootフォルダ直下の画面カスタムファイルが読み込まれます。このため，例えば，Webブラウザーのロケールに対応した言語の画面カスタムファイルがない場合は，英語の画面カスタムファイルが読み込まれるようにできます。

Webブラウザーのロケールに対応した言語コードフォルダがない場合

Webブラウザーのロケールに対応した言語コードフォルダ内にファイルがない場合

重要

webrootフォルダ直下のファイル名と，言語コードフォルダ内のファイル名は，同じにしてください。

webrootフォルダ直下にファイルを格納しない場合も，各言語コードフォルダ内のファイル名は，同じにしてください。

関連項目

2.2.6　サービステンプレートに画面カスタムファイルを設定する手順

2.2.8　画面カスタムファイルの形式

2.2.8　画面カスタムファイルの形式

画面カスタムファイルは，Webブラウザー上で実行される静的なコンテンツとして作成してください。

指定できる拡張子

画面カスタムファイルに指定できる拡張子の例を次に示します。

［サービス詳細説明］画面の表示内容を定義する画面カスタムファイル

.html

.js

.css

.swf

.jpeg

サービス概要の画像を定義する画面カスタムファイル

.png

また，画像ファイルのサイズは縦150ピクセル，横420ピクセルを推奨します。

なお，アプリケーションサーバ上で稼働する.jspや.warなどの動的なコンテンツは製品サポートの対象外です。

ファイル名・ファイルパスに使用できる文字

画面カスタムファイルのファイル名およびファイルパスはASCII文字を使用してください。次の文字は使用できません。

マルチバイト文字

制御文字（'¥u0000'～'¥u001F' または'¥u007F'～'¥u009F'）

「?」「*」「"」「>」「<」「|」「:」

2.3　サービステンプレートの表示情報をリソースファイルで設定する

サービステンプレートにリソースファイルを設定して，画面で表示する情報をWebブラウザーのロケールごとに定義します。例えば，表示されるサービステンプレート名をWebブラウザーのロケールにあった言語に切り替えられます。

2.3.1　サービスリソースファイルを設定する手順

サービスリソースファイルを設定すると，サービステンプレートに表示する情報を設定できます。表示情報を設定できるのはサービステンプレート，ステップ，およびサービスプロパティです。サービスリソースファイルを直接編集したい場合は，サービスリソースファイルをダウンロードし，リソースファイルを書き換えます。

ただし，リリースサービステンプレートの表示情報は変更できません。変更したい場合は，リリースサービステンプレートを複製し，開発サービステンプレートとして編集してください。

［Service Builder Home］画面の［開発］タブで，編集したいサービステンプレートを選択し，［編集］ボタンをクリックします。

［Service Builder Edit］画面の［操作］プルダウンメニューから［リソース設定］を選択します。

［サービスリソース設定］ダイアログボックスでサービスリソースファイルのリンクをクリックし，ダウンロードします。

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

ダウンロードしたサービスリソースファイルの定義を編集します。

ファイル名は「service_言語コード.properties.txt」のままにしてください。ファイル名を変更するとアップロード時にエラーになります。

言語コードには，ISO-639で定義されている2桁の英小文字（ja，en，zh）が指定できます。

［更新］ボタンをクリックして，編集したサービスリソースファイルを選択し，アップロードします。

確認のダイアログボックスで［OK］ボタンをクリックします。

重要

サービスリソースファイルをアップロードすると，それまで保存していたリソースファイルの内容が上書きされます。このため，誤ったファイルで不正に上書きしないように注意してください。

操作結果

リソースファイルの内容に従って，サービステンプレートの表示情報が設定されます。

関連項目

5.2.1　サービステンプレートを複製する手順

2.3.2　サービスリソースファイルの形式

2.3.3　サービスリソースファイルの定義内容

2.3.2　サービスリソースファイルの形式

サービスリソースファイルは，JP1/AOの操作画面で表示する項目を定義したファイルです。サービスリソースファイルの形式を次に示します。なお，サービスリソースファイルの定義内容は，設定する表示項目の種類によって異なります。それぞれの定義内容については，「2.3.3　サービスリソースファイルの定義内容」を参照してください。

サービスリソースファイルのファイル名は「service_言語コード.properties.txt」です。

言語コードには，ISO-639で定義されている2桁の英小文字（ja，en，zh）が指定できます。

「プロパティキー区切り文字設定値」の形式で記述してください。区切り文字には「=」，「:」，「¥t」，または半角スペースを使用できます。

プロパティキーと設定値は1行に1つ記述してください。

プロパティキーに記述できる文字を次に示します。

半角英数字

半角ハイフン「-」

半角アンダーライン「_」

半角ピリオド「.」

使用できる文字セットはUTF-8です。

同じプロパティキーに対する定義を複数記述した場合は，あとに記述した内容が有効になります。

先頭に「#」を付けた行はコメントになります。

大文字と小文字は区別します。

指定する文字列に「¥」が含まれる場合は，「¥¥」と記述してください。

半角スペースだけの行は無視されます。

サービスリソースファイルのそれぞれの行で，最初の半角スペース以外の文字から最初の区切り文字の直前までがプロパティキーとして扱われます。

サービスリソースファイルのそれぞれの行で，プロパティキーの後ろの区切り文字の直後にある，区切り文字以外の文字から行末までが設定値として扱われます。

例えば，次のように指定した場合，「abc」がプロパティキー，「c」が設定値として扱われます。

abc¥t¥tc

ただし，最初の区切り文字の直後に「=」または「:」が含まれる場合，その直後にある半角スペースまたは「¥t」以外の文字から行末までが設定値として扱われます。

例えば，次のように指定した場合，「abc」がプロパティキー，「=¥tc」が設定値として扱われます。

abc¥t=¥t=¥tc

サロゲートペア文字は使用できません。

2.3.3　サービスリソースファイルの定義内容

サービスリソースファイルの定義内容は，設定する表示項目の種類によって異なります。それぞれの定義内容を次に示します。

［サービス定義編集］ダイアログボックスの項目を設定する場合

［サービス定義編集］ダイアログボックスのサービステンプレート名や説明などを設定したい場合に定義します。次の形式で記述してください。

プロパティキー区切り文字設定値

例えば，「service.displayName=テスト用サービス」のように記述してください。

ステップの表示項目を設定する場合

ステップ名および説明を設定したい場合に定義します。ステップ名および説明は，サービスを実行したとき，［タスク］画面の［フロー］エリアに表示されます。

ステップ名を設定する場合

サービステンプレート内のステップ名を設定する場合の形式を次に示します。

dnajob.ステップID.displayName 区切り文字設定値

例えば，「dnajob.teststep.displayName=テスト用ステップ」のように記述してください。

ステップの説明を設定する場合

ステップの説明を設定する場合の形式を次に示します。

dnajob.ステップID.comment 区切り文字設定値

例えば，「dnajob.teststep.comment=テスト用のステップです」のように記述してください。

フロー内の最上位の階層にないステップの表示項目を設定する場合

フロー内の最上位の階層のステップIDから，設定したいステップのステップIDまでを「/」（スラッシュ）で連結して指定します。

例えば，次の図のStepFのリソースを設定したい場合は，最上位の階層にあるStepBと，StepFのステップIDを連結します。StepIのリソースを設定したい場合は，StepB，StepG，およびStepIのステップIDを連結します。

図2‒8　StepFとStepIのリソースを設定する例

StepFとStepIのリソースを設定する場合の記述例を次に示します。

dnajob.StepB/StepF.displayName=ステップF
dnajob.StepB/StepF.comment=ステップFの説明
dnajob.StepB/StepG/StepI.displayName=ステップI
dnajob.StepB/StepG/StepI.comment=ステップIの説明

関連項目

2.3.4　サービステンプレートの表示情報とサービスリソースファイルのプロパティとの対応

2.3.4　サービステンプレートの表示情報とサービスリソースファイルのプロパティとの対応

サービステンプレートの表示情報は，画面上で設定できます。画面上で設定した表示情報は，サービスのリソースファイルにも定義されています。サービステンプレートの表示情報と，サービスリソースファイルのプロパティの対応を次に示します。

表2‒3　サービステンプレートの表示情報とサービスリソースファイルのプロパティとの対応

サービステンプレートの表示情報

サービスリソースファイルのプロパティ

ベンダー名

service.vendorDisplayName

サービステンプレート名

service.displayName

サービステンプレートの説明

service.shortDescription

プロパティグループ名

プロパティグループに関連ステップがない場合

propertyGroup.プロパティグループID.displayName

プロパティグループに関連ステップがある場合

propertyGroup.ステップID/プロパティグループID.displayName※

プロパティグループの説明

プロパティグループに関連ステップがない場合

propertyGroup.プロパティグループID.description

プロパティグループに関連ステップがある場合

propertyGroup.ステップID/プロパティグループID.description※

サービスプロパティの名称

プロパティに関連ステップがない場合

property.プロパティキー.displayName

プロパティに関連ステップがある場合

property.ステップID/プロパティキー.displayName※

サービスプロパティの説明

プロパティに関連ステップがない場合

property.プロパティキー.description

プロパティに関連ステップがある場合

property.ステップID/プロパティキー.description※

ステッププロパティの名称

property.ステップID/プロパティキー.displayName※

ステッププロパティの説明

property.ステップID/プロパティキー.description※

ステップ名

dnajob.ステップID.displayName※

ステップの説明

dnajob.ステップID.comment※

注※

フロー内の最上位の階層にないステップのリソースを設定する場合は，フロー内の最上位の階層にあるステップのステップIDから，設定したいステップのステップIDまでを「/」（スラッシュ）で連結して指定します。

なお，ステッププロパティの情報は，サービスリソースファイルの点線の下に表示されています。サービスリソースファイルをアップロードしたあと，［Service Builder Edit］画面の［フロー］タブでステッププロパティをサービスプロパティに昇格すると，このとき設定していたステッププロパティの情報が，サービスプロパティの情報として適用されます。

2.3.5　サービステンプレートの作成時に自動で生成されるサービスリソースファイルについて

サービステンプレートを作成すると，サービスリソースファイルが自動で生成されます。生成されるサービスリソースファイルは，Webブラウザーのロケールと同じ言語のサービスリソースファイルと，英語用のサービスリソースファイルの2種類です。ただし，Webブラウザーのロケールが英語の場合は，英語用のサービスリソースファイルだけが生成されます。

生成されるサービスリソースファイルには，次の値が設定されます。

表2‒4　サービスリソースファイルに設定される表示情報のデフォルト値（サービステンプレートの作成時）

定義する表示情報

デフォルトで設定される値

Webブラウザーのロケールと同じ言語

自動で生成される英語用のリソースファイル※

ベンダー名

［Service Builder］画面で指定した値

ベンダーID

サービステンプレート名

サービステンプレートID

サービステンプレートの説明

空白

注※

Webブラウザーのロケールが英語の場合，生成されるサービスリソースファイルの内容は「Webブラウザーのロケールと同じ言語」の列を参照してください。

サービステンプレートを作成するときに自動で生成されるサービスリソースファイルの例を次に示します。

サービステンプレート作成時に画面上で設定する値

ベンダーID：test.vendor
サービステンプレートID：test.service
サービステンプレートバージョン：10.00.00
サービステンプレート名：テストサービステンプレート
ベンダー名：テスト用
説明：テスト用サービステンプレートです

生成されるサービスリソースファイル（日本語）

service.vendorDisplayName=テスト用
service.displayName=テストサービステンプレート
service.shortDescription=テスト用サービステンプレートです

生成されるサービスリソースファイル（英語）

service.vendorDisplayName=test.vendor
service.displayName=test.service
service.shortDescription=

2.3.6　サービステンプレートの編集時に更新されるサービスリソースファイルについて

サービステンプレートを編集し，保存すると，Webブラウザーのロケールと同じ言語のサービスリソースファイルが更新されます。

ただし，次のような場合は，サービスリソースファイル同士の整合性を確保するため，Webブラウザーのロケール以外の言語のサービスリソースファイルにも更新が反映されます。

表示情報の定義を追加または削除した場合

プロパティグループID，ステップID，またはプロパティキーを更新した場合

表示情報の定義を追加した場合，Webブラウザーのロケール以外の言語のサービスリソースファイルには，次の表に示す値で定義が追加されます。表示情報の定義を更新した場合，プロパティグループID，プロパティキー，またはステップIDを更新したときだけ，Webブラウザーのロケール以外の言語のサービスリソースファイルの値は，次の表に示す値で自動的に上書きして設定されます。そのため，上書きされる前の値を参照したい場合は，Webブラウザーのロケール以外の言語のサービスリソースファイルをバックアップしておいてください。

重要

階層化ステップおよび繰り返しステップのステップIDを更新した場合，下位のフローに含まれるステップのステップ名およびステップの説明の値が，次の表に示す値で自動的に上書きされます。なお，上書きされるのは，Webブラウザーのロケール以外の言語のサービスリソースファイルに定義された値です。

表2‒5　サービスリソースファイルに設定される表示情報の値

定義する表示情報

設定される値

プロパティグループ名※1

プロパティグループID

プロパティグループの説明※1

空白

サービスプロパティの名称※2

プロパティキー

サービスプロパティの説明※2

空白

ステップ名※3

ステップID

ステップの説明※3

空白

注※1

プロパティグループIDを更新した場合に，値が上書きされる表示情報です。

注※2

プロパティキーを更新した場合に，値が上書きされる表示情報です。

注※3

ステップIDを更新した場合に，値が上書きされる表示情報です。

表示情報の定義を削除した場合は，Webブラウザーのロケール以外の言語のサービスリソースファイルからも定義が削除されます。

Webブラウザーのロケール以外の言語の表示情報を設定する場合は，手動でサービスリソースファイルを作成または編集し，アップロードする必要があります。手動でサービスリソースファイルを作成する場合は，表示情報が設定されているロケールのサービスリソースファイルをダウンロードして利用することをお勧めします。

2.3.7　サービスリソースファイルが作成されていないロケールのWebブラウザーでサービステンプレートを表示した場合について

サービスリソースファイルが作成されていないロケールのWebブラウザーで，サービステンプレートを表示した場合は，英語用のサービスリソースファイルを読み込んで，画面が表示されます。

3　サービステンプレートのフローを作成・編集する

サービステンプレートのフローの作成・編集について説明します。フローを作成・編集することで，運用手順を並べ替えたり，手順を追加したりできます。

3.1　［Service Builder Edit］画面の［フロー］タブ

［Service Builder Edit］画面の［フロー］タブは，サービステンプレートのフローを作成したり，編集したりするための画面です。［Service Builder Edit］画面の［フロー］タブは，［Service Builder Home］画面で，作成または編集の操作をすると表示されます。

図3‒1　［Service Builder Edit］画面の［フロー］タブ

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

［コンポーネント］エリア

フローにステップとして配置できるコンポーネントが表示されます。［リリース］タブ，［開発］タブおよび［サービス］タブをクリックすると，表示するコンポーネントの種別を切り替えられます。コンポーネントを選択すると，詳細情報が表示されて，そのコンポーネントに対して操作できるボタンが表示されます。上部の検索窓およびタグ選択を使って，コンポーネントを検索できます。

［リリース］タブ

クリックすると，リリース部品が表示されます。

［開発］タブ

クリックすると，開発部品が表示されます。

［サービス］タブ

クリックすると，サービス部品が表示されます。サービス部品を選択し，［サービス詳細説明表示］ボタンをクリックすると，サービス部品の基となるリリースサービステンプレートの詳細説明を参照できます。

［フロー］エリア

ステップの実行順序を定義するエリアです。

［フローツリー］エリア

［フロー］エリアに表示するフローの階層を選択するエリアです。サービステンプレートに定義されているフローの名称が階層表示されます。フロー名をクリックすると，その配下のフローが［フロー］エリアに表示されます。

［ステッププロパティ］エリア

ステッププロパティの値や可視性を設定するエリアです。選択したステップの定義情報，プロパティ一覧，および後続ステップの一覧が表示されます。

［定義情報］タブ

ステップの定義情報を編集します。

［編集］ボタンをクリックすると表示される［ステップ編集］ダイアログボックスで編集できます。詳細については，「2.2.1　［Service Builder Edit］画面の［定義情報］タブ」のトピックを参照してください。

［プロパティ］タブ

ステップとして使用されている部品のプロパティ一覧が表示されます。詳細については，「4.1　［Service Builder Edit］画面の［プロパティ］タブ」のトピックを参照してください。

［次ステップ］タブ

選択したステップの後続ステップの一覧および選択したステップと後続ステップを結びつけるアローの条件式が表示されます。詳細については，「3.4.5　後続ステップのアロー条件式について」のトピックを参照してください。

3.2　フローとステップの関係

フローに配置できる部品およびサービステンプレートをコンポーネントと呼びます。コンポーネントは，［Service Builder Edit］画面の［フロー］タブの［コンポーネント］エリアに表示されます。これを［フロー］エリアにドラッグ&ドロップして，フローの1つ1つの処理を追加します。［フロー］エリアにドロップされたコンポーネントのことを「ステップ」と呼びます。業務に必要なステップを［フロー］エリアに配置し，関連線で繋いでフローを作成します。フローとステップの関係を次に示します。

図3‒2　フローとステップの関係

なお，「階層フロー部品」や「繰り返し実行部品」を使用すると，フローの中に別のフローを定義できます。

関連項目

3.3　フローの階層化について

3.3　フローの階層化について

フローの階層化とは，フローの中に別のフローを定義することです。最上位のフローを第1階層として最大25階層まで定義できます。サービス部品をステップとして配置する場合，サービス部品に含まれる階層も合わせて25階層以内になるよう定義します。サービス部品の内部に含まれる階層数は，サービス部品の基になっているリリースサービステンプレートを参照して確認してください。

フローを階層化したい場合は，階層フロー部品を配置します。複数のステップをまとめたものを繰り返し実行したい場合は，繰り返し実行部品を配置します。

図3‒3　フローの階層化

表3‒1　コンポーネントとステップの関係とその役割

ドラッグ&ドロップするコンポーネント

ステップの種別

役割

階層フロー部品

階層化ステップ

フローを階層化する。

繰り返し実行部品

繰り返しステップ

指定したフローを繰り返し実行する。

繰り返しステップの配下のフローをさらに階層化したい場合は，階層フロー部品または繰り返しステップを置くこと。ただし，繰り返しステップの入れ子は最大3階層までとする。

サービス部品

サービスステップ

リリースサービステンプレートを1つのコンポーネントとしてフローに配置し，処理を実行する。

その他のコンポーネント

通常ステップ

コンポーネントを実行する。

ヒント

［Service Builder Edit］画面の［フロー］タブ右側の［フローツリー］エリアでは，定義したフローの一覧をツリー形式で確認できます。［フローツリー］エリアには，最上位のフローがサービステンプレート名で表示されます。その配下の階層は，階層フロー部品，繰り返し実行部品を実行するステップの「ステップ名」が表示されます。

関連項目

マニュアル『JP1/AO 運用ガイド』－「タスクログの詳細」のトピック

5.1　サービステンプレートを参照する

3.4　ステップを追加・編集する

フローにステップを追加したり，すでにあるステップを編集したりできます。

ツアーアイコン（[図データ]）をクリックすると，ステップを追加する流れを確認できます。はじめて［Service Builder Edit］画面の［フロー］タブを起動した場合は必ず表示されます。

3.4.1　ステップを追加する手順

ステップを追加することで，フローに処理を追加できます。ステップとは，フローに配置されたコンポーネントのことです。

なお，追加できるステップ数の上限は次のとおりです。サービス部品の内部に含まれるステップ数も合わせて，上限を超えないようにしてください。サービス部品の内部に含まれるステップ数は，サービス部品の基になっているリリースサービステンプレートを参照して確認してください。

1サービステンプレートに追加できるステップ数：320個

1階層に追加できるステップ数：80個

ヒント

追加したステップ数が多い，または1階層に追加したステップ数が多いなど，画面上にすべてのステップを表示できない場合は，ミニマップが表示されます。フロー全体のどの部分が表示されているのかを確認できます。

ステップを追加するには：

［Service Builder Edit］画面の［フロー］タブの［コンポーネント］エリアで，ステップとして追加したいコンポーネントを選択します。

選択したコンポーネントを［フロー］エリアにドラッグ&ドロップします。

［ステップ作成］ダイアログボックスでステップの定義情報を入力し，［OK］ボタンをクリックします。

図3‒4　［ステップ作成］ダイアログボックス

操作結果

ステップが［フロー］エリアに追加されます。

ヒント

次の部品は，［フロー］エリア上で右クリックして［ステップを追加］から選択すると，［フロー］エリアに追加できます。

値判定分岐部品

戻り値判定分岐部品

異常終了部品

繰り返し実行部品

階層フロー部品

関連項目

1.2.3　サービステンプレートの編集を開始する手順

3.4.3　ステップの定義情報として設定する項目について

5.1　サービステンプレートを参照する

3.4.2　ステップを編集する手順

ステップの編集とは，ステップ作成時に［ステップ作成］ダイアログボックスで設定した定義情報を変更する操作です。ステップの定義情報は，［ステップ編集］ダイアログボックスで変更できます。

ステップを編集するには：

［Service Builder Edit］画面の［フロー］タブの［フロー］エリアで，定義情報を変更したいステップを右クリックして，［編集］を選択するか，［ステッププロパティ］エリアの［定義情報］タブから［編集］ボタンをクリックします。

［ステップ編集］ダイアログボックスでステップの定義情報を変更し，［OK］ボタンをクリックします。

図3‒5　［ステップ編集］ダイアログボックス

操作結果

ステップの編集内容が設定されます。

ヒント

［フロー］エリアで，定義情報を変更したいステップをクリックして，ステップ上部のスパナアイコンをクリックすることでも，ステップの定義情報を変更できます。

関連項目

3.4.3　ステップの定義情報として設定する項目について

3.4.3　ステップの定義情報として設定する項目について

ステップの定義情報のうち，ユーザーが設定できるのはステップID，ステップ名，説明，および後続ステップ実行条件です。これらの項目は，［ステップ作成］ダイアログボックスまたは［ステップ編集］ダイアログボックスで設定します。

表3‒2　［ステップ作成］ダイアログボックスまたは［ステップ編集］ダイアログボックスの表示項目

項目

説明

ステップ

ステップID

ステップを一意に識別するための値です。ステップIDには，フロー内（配下の階層フローは含まない）で一意となる値を指定します。デフォルトではコンポーネントのIDが表示されています。

フロー内に同一ステップIDのステップがある場合は，ステップIDの末尾に「_n」（n: 2から始まるユニークな整数）が付き，「ステップID_n」の形式で表示されます。ただし，「ステップID_n」が30文字を超えていた場合，超えた文字数分がステップIDの末尾から削除され，「_n」の付いた形式に変更されます。

ステップ名

ここで指定した値が［フロー］エリアにあるステップのアイコンステップ名として表示されます。ステップ名は，同一フロー内で重複して指定できます。

フロー内に同一ステップ名のステップがある場合は，ステップ名の末尾に「_n」（n: 2から始まるユニークな整数）が付き，「ステップ名_n」の形式で表示されます。ただし，「ステップ名_n」が64文字を超えていた場合，超えた文字数分がステップ名の末尾から削除され，「_n」の付いた形式に変更されます。

説明

ここで指定した説明が［フロー］エリアに表示されます。デフォルトでは空白です。

コンポーネント

コンポーネントの情報が表示されます。

後続ステップ実行条件

ステップで実行する部品の戻り値によって，後続のステップを実行するかどうかを設定します。

関連項目

3.4.4　後続ステップ実行条件について

3.4.4　後続ステップ実行条件について

前のステップの戻り値によって，後続のステップを実行するかどうかを設定します。

ステップの戻り値は，基本的には部品の戻り値と同じです。ステップの戻り値と部品の戻り値の関係については，「6.4.10　実行したコマンドまたはスクリプトの戻り値，部品の戻り値，ステップの戻り値の関係について」を参照してください。

なお，サービス部品を使用したステップの場合，ステップの戻り値は常に「0」です。

後続ステップ実行条件の種類

［戻り値をしきい値により判定する］

判定値と警告値の設定例を次に示します。

図3‒6　判定値が「0」，警告値が未設定の場合（デフォルト）

戻り値が判定値以下の場合は，後続のステップを実行します（正常終了）。

戻り値が判定値より大きい場合は，後続のステップは実行されません（異常終了）。

図3‒7　判定値が「6」，警告値が「2」の場合

戻り値が判定値以下の場合，後続のステップを実行します（正常終了）。ただし，戻り値が警告値以上，判定値以下の場合は，後続するステップを実行し，警告終了となります。この場合，警告値を超えて終了したことを示すため，タスクの状態は［失敗］（タスク終了時），または［異常検出］（タスク実行中）になります。［フロー］エリアには，警告終了したことがステップの状態として表示されます。警告値を指定する場合は，判定値以下の値を指定してください。なお，警告値の指定は省略できます。

戻り値が判定値より大きい場合は，後続のステップは実行されません（異常終了）。

［戻り値によらず常に正常終了］

部品の戻り値に関係なく，常に後続のステップを実行します。

［戻り値によらず常に異常終了］

部品の戻り値に関係なく，常にステップを異常終了します。後続のステップは実行されません。

後続ステップ実行条件を設定できない部品

サービス部品，階層フロー部品, および次のフローを制御する部品には，後続ステップ実行条件を設定できません。

戻り値判定分岐部品

値判定部品

実行間隔制御部品

異常終了部品

値判定分岐部品

3.4.5　後続ステップのアロー条件式について

［Service Builder Edit］画面の［フロー］タブの［フロー］エリアで選択したステップと，後続ステップを結びつけるアローの条件式を，［次ステップ］タブから設定します。

表3‒3　［次ステップ］タブの表示項目

項目

説明

ステップ名

後続ステップの名前が表示されます。

条件名

ここで指定した値が［フロー］エリアにあるステップのアイコンや，後続ステップの一覧にアロー条件式の名前として表示されます。デフォルトでは，後続ステップの名前が表示されています。

条件

アロー条件式の種類をドロップダウンリストから選択します。

ALWAYS

IF

OTHER

デフォルトではALWAYSが表示されています。OTHERを選択する場合，［次ステップ］タブ内に，［条件］（アロー条件式の種類）にIFを指定したステップを設定する必要があります。

条件式

ここで指定した値がフローエリアにあるステップのアイコンや，後続ステップの一覧にアロー条件式として表示されます。この項目は，［条件］（アロー条件式の種類）にIFを指定した場合だけ指定できます。

説明

ここで指定した値が後続ステップの一覧にアロー条件式の説明として表示されます。この項目は，［条件］（アロー条件式の種類）にIFを指定した場合だけ指定できます。

3.5　ステップの実行順序を定義する

［Service Builder Edit］画面の［フロー］タブの［フロー］エリアでステップ同士を関連線で接続して，実行順序を定義できます。

3.5.1　ステップの実行順序を定義する手順

ステップを追加したあと，業務として実行する順序に合わせて，ステップを関連線で接続します。関連線で接続することで，ステップの実行順序が定義できます。

ステップの実行順序を定義するには：

プロパティ値の自動補完機能を有効にしたい場合は，［Service Builder Edit］画面の［フロー］タブの［フロー］エリアでキャンバスを右クリックし，［プロパティ値の自動補完］を選択します。右クリックしたときに［プロパティ値の自動補完］がチェックされている場合，すでにプロパティ値の自動補完機能が有効になっています。

［フロー］エリアで，先に実行するステップのアイコンの○を，あとに実行するステップのアイコンまでドラッグし，アイコンの色が変わったらドロップします。

図3‒8　［Service Builder Edit］画面の［フロー］タブ

操作結果

ステップ同士が関連線で接続されます。

関連項目

3.5.2　プロパティ値の自動補完機能について

3.5.3　ステップおよび関連線に実行できる操作

3.5.5　複数のステップに関連線を接続する場合の動作

3.5.6　関連線が接続できない例

3.5.7　処理が分岐する部品を使用する場合の関連線接続

3.5.2　プロパティ値の自動補完機能について

プロパティ値の自動補完機能とは，［フロー］エリアでステップの実行順序を定義するときに，自動でプロパティのマッピングを設定する機能です。プロパティ値の自動補完機能を有効にすると，ステップとステップを関連線で接続したとき，接続元ステップと接続先ステップのプロパティマッピングが自動で設定されます。自動補完の前にプロパティマッピングが設定されていた場合，上書きされます。

自動補完されたプロパティには，［ステッププロパティ］エリアで[図データ]が表示されます。[図データ]はほかのステップを選択するまで表示されます。プロパティに[図データ]が表示されたら，ほかのステップを選択する前に，自動補完されたプロパティ値が意図した設定になっているかどうかを確認してください。意図しない設定になっていた場合，マッピングを設定し直してください。

マッピングが設定される条件と動作について説明します。

ステップの出力プロパティとステップの入力プロパティとのマッピング設定

関連線の接続元ステップの出力プロパティと接続先ステップの入力プロパティのプロパティキーが同じ場合，入力プロパティに出力プロパティへの参照が設定されます。

ステップの入力プロパティ同士のマッピング設定

関連線の接続元と接続先で，ステップの入力プロパティのプロパティキーおよびデータ型が同じ場合，接続元ステップの入力プロパティの値が接続先ステップの入力プロパティの値として設定されます。

なお，自動補完されたあとに接続元ステップの入力プロパティの値を変更しても，接続先ステップの入力プロパティの値は変更されません。

ヒント

次の場合は自動補完されません。

関連線の接続元または接続先のステップがサービス部品を使用していて，すでに内部のステッププロパティ同士でマッピング設定されている場合

これら以外で，プロパティ値が自動補完されない場合，接続元または接続先のステップがJP1/AO 10-02以前のバージョンで配置されている可能性があります。同じコンポーネントをステップとして配置し直すと，自動補完機能の対象になります。

関連項目

3.6.1　ステッププロパティとは

3.6.3　ステッププロパティの値をマッピングする手順

3.6.4　プロパティのマッピングとは

3.6.5　可視性またはデータ型によるマッピングの可否について

4.2.1　サービスプロパティとは

3.5.3　ステップおよび関連線に実行できる操作

ステップおよび関連線は，右クリックで削除，コピー，切り取りまたは貼り付けができます。

ステップおよび関連線は複数選択できます。［フロー］エリアでマウスをドラッグして選択したいステップの範囲を指定するか，［Ctrl］キーを押しながら，選択したいステップをクリックします。

切り取り対象は，選択範囲に含まれているステップまたは関連線です。階層化されたフローが含まれている場合は，その配下のフローもすべて切り取られます。切り取られるデータは，直前に行った切り取り操作の1回分だけです。

選択範囲外のステップと接続されていた関連線は，切り取った時点で［フロー］エリアから削除されます。

関連項目

3.5.4　ステップまたは関連線の貼り付け時に引き継がれる情報

3.5.4　ステップまたは関連線の貼り付け時に引き継がれる情報

コピーまたは切り取ったステップや関連線を貼り付ける場合，コピー元または切り取り元から引き継がれる情報があります。そのため，貼り付け先の開発サービステンプレートの定義情報は，貼り付けたあと必要に応じて見直してください。

貼り付け時に引き継がれるステップまたは関連線の情報を次の表に示します。

表3‒4　ステップまたは関連線の貼り付け時に引き継がれる情報

コピー・切り取り対象

コピー・切り取り対象の情報

貼り付け先の情報

ステップ

ステップID

ステップIDはフロー内（配下の階層フローは含まない）でユニークである必要がある。

貼り付け先に同じステップIDのステップがない場合，コピー元または切り取り元の情報がそのまま引き継がれる。

同じステップIDのステップがある場合，「ステップID_n」に変更される。なお，nは，2以上のユニークな整数が設定される。また，変更した「ステップID_n」が30文字を超えた場合，超えた文字数分がステップIDの末尾から削除される。

ステップ名

貼り付け先に同じステップ名のステップがない場合，コピー元または切り取り元の情報がそのまま引き継がれる。

同じステップ名のステップがある場合，「ステップ名_n」に変更される。なお，nは，2以上のユニークな整数が設定される。また，変更した「ステップ名_n」が64文字を超えた場合，超えた文字数分がステップ名の末尾から削除される。

説明

コピー元または切り取り元の情報がそのまま貼り付けられる。

部品情報への参照

後続ステップ実行条件

入力プロパティの設定

出力プロパティの設定

関連するサービスプロパティ

開発部品またはリリース部品を使用したステップの場合，デフォルトプロパティのプロパティグループに追加される。サービス部品を使用したステップの場合，プロパティグループの情報も引き継がれる。

関連線

方向

関連線の方向の情報もコピーされる。ただし，選択範囲外のステップと接続されている接続線はコピーされない。

3.5.5　複数のステップに関連線を接続する場合の動作

関連線は1つのステップから複数のステップに接続することも，複数のステップから1つのステップに接続することもできます。このように接続した場合，接続されたすべてのステップの実行完了を待ってから，次のステップが実行されます。

図3‒9　複数ステップの接続例

3.5.6　関連線が接続できない例

フローの中で循環するような関連線や，接続元と接続先が同じ関連線などは，接続できません。

表3‒5　関連線の接続制限

接続できない関連線

詳細

例

循環参照となる関連線

フローの中で，ループするような関連線は接続できない。

接続元ステップ自身への関連線

関連線の接続先と接続元のステップが同一の場合，関連線は接続できない。

同一の関連線

同じ接続先と接続元を持つ関連線は複数作成できない。

戻り値判定分岐部品への複数接続

戻り値判定分岐部品は，直前のステップの戻り値を判定する部品のため，複数ステップからの接続はできない。直前のステップとして接続できるステップは最大1つである。

戻り値判定分岐部品または値判定分岐部品から戻り値判定分岐部品または値判定分岐部品への接続

戻り値判定分岐部品または値判定分岐部品の分岐先として，戻り値判定分岐部品および値判定分岐部品を接続することはできない。後続するステップとして連続して接続することはできる。

戻り値判定分岐部品または値判定分岐部品の分岐先ステップからの関連線

戻り値判定分岐部品または値判定分岐部品の分岐先のステップは最大1個であり，関連線は接続できない。複数のステップの処理が必要となる場合は，階層フロー部品を分岐先として接続する。

戻り値判定分岐部品または値判定分岐部品の分岐先ステップへの関連線

戻り値判定分岐部品または値判定分岐部品の分岐先のステップに，関連線を接続することはできない。

（凡例）[図データ]：戻り値判定分岐部品または値判定分岐部品[図データ]：その他の部品

関連項目

3.5.7　処理が分岐する部品を使用する場合の関連線接続

マニュアル『JP1/AO サービステンプレートリファレンス』－「戻り値判定分岐部品」のトピック

3.5.7　処理が分岐する部品を使用する場合の関連線接続

後続するステップとは別に，判定条件にマッチしたときにだけ実行したいステップがある場合，戻り値判定分岐部品や値判定分岐部品を使用します。使用する際は，部品の下部の点線部分に分岐先のコンポーネントをドラッグ&ドロップして接続します。

なお，条件にマッチした場合は，分岐先ステップを実行したあとに，後続するステップを実行します。条件にマッチしない場合は，分岐先ステップを実行しないで，後続するステップを実行します。

図3‒10　 戻り値判定分岐部品を使用した場合の関連線接続の例

後続するステップとの接続は，通常の矢印で描画されます。

判定条件にマッチした場合だけ実行するステップとの関連線は，両矢印で描画されます。判定条件にマッチした場合だけ実行するステップは必ず1つです。

判定条件にマッチした場合，「sample1」，「戻り値判定分岐部品」，「sample2」，「sample3」の順番でステップが実行されます。

判定条件にマッチしなかった場合，「sample1」，「戻り値判定分岐部品」，「sample3」の順番でステップが実行されます。

3.6　ステッププロパティを設定する

ステッププロパティを設定します。ステッププロパティの値は，直接指定したり，ほかのプロパティの値とマッピングしたりできます。

3.6.1　ステッププロパティとは

ステッププロパティとは，ステップに定義されたプロパティのことです。ステップとして使用するコンポーネントに含まれる部品プロパティが，ステッププロパティとして［Service Builder Edit］画面の［フロー］タブの［ステッププロパティ］エリアに表示されます。

ステッププロパティに対しては，次の設定ができます。

入力プロパティの値を直接指定する

前後のステップのプロパティとマッピングして値を引き継ぐ

サービスプロパティに昇格し，入力プロパティの値をサービスの設定・実行時に指定できるようにする

サービスプロパティに昇格し，出力プロパティの値を［タスク詳細］画面で確認できるようにする

関連項目

3.6.2　ステップの入力プロパティの値を直接指定する手順

3.6.3　ステッププロパティの値をマッピングする手順

3.6.6　ステッププロパティをサービスプロパティに昇格する手順

3.6.7　ステッププロパティの定義例について

3.6.2　ステップの入力プロパティの値を直接指定する手順

ステップの入力プロパティに，サービステンプレートで固定の値を直接指定できます。

ステップの入力プロパティの値を直接指定するには：

［Service Builder Edit］画面の［フロー］タブの［フロー］エリアで，ステップを選択します。

［ステッププロパティ］エリアの［プロパティ］タブから，入力プロパティのアイコンをクリックします。

値を直接指定したいプロパティの行を選択し，鉛筆アイコンをクリックします。

［入力プロパティマッピング］ダイアログボックスで，設定方法の［直接入力］を選択します。

図3‒11　［入力プロパティマッピング］ダイアログボックス（設定方法で［直接入力］を選択した場合）

［値］テキストボックスにステッププロパティの値を入力します。

ヒント

ほかのプロパティの値と任意の文字列をあわせて指定したい場合，［プロパティ挿入］ボタンをクリックします。［参照プロパティ選択］ダイアログボックスでプロパティを選択して，［OK］ボタンをクリックすると，選択したプロパティのプロパティキーが［値］テキストボックスに挿入されます。

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

操作結果

ステッププロパティの値が設定されます。

ヒント

ステッププロパティの値は，［ステッププロパティ］エリアの［値］列のテキストボックスでも指定できます。このとき，ステッププロパティのデータ型がlistの場合はプルダウンメニューから，dateの場合はカレンダーから値を選択できます。

関連項目

3.6.7　ステッププロパティの定義例について

3.6.3　ステッププロパティの値をマッピングする手順

プロパティ同士をマッピングすると，プロパティ間で値を引き継げます。例えば，ステップAの出力プロパティとステップBの入力プロパティをマッピングすると，ステップAの出力プロパティの値をステップBの入力プロパティとして引き継げます。

ステッププロパティのマッピングを設定するには：

［Service Builder Edit］画面の［フロー］タブの［フロー］エリアで，ステップを選択します。

［ステッププロパティ］エリアの［プロパティ］タブをクリックし，入力プロパティまたは出力プロパティのアイコンをクリックします。

マッピングしたいプロパティの行を選択し，鉛筆アイコンをクリックします。

図3‒12　［ステッププロパティ］エリア

［入力プロパティマッピング］ダイアログボックスまたは［出力プロパティマッピング］ダイアログボックスで，［プロパティ参照］ラジオボタンを選択します。

マッピングできるプロパティだけが［プロパティ］エリアに表示されます。

図3‒13　［入力プロパティマッピング］ダイアログボックス（設定方法で［プロパティ参照］を選択した場合）

ヒント

マッピング可能アイコン（[図データ]）をクリックすると，フィルタリングがOFFに切り替わり，マッピングできないプロパティも表示されます。エラーアイコンにマウスカーソルを重ねると，マッピングできない理由が表示されます。

［入力プロパティマッピング］ダイアログでの入力について

サービスプロパティまたは変数を表示したい場合

［ステップツリー］エリアでサービステンプレート名を選択してください。プロパティグループ名の左にある開閉ボタンをクリックすることで，所属するサービスプロパティが表示されます。変数はデフォルトプロパティグループに表示されます。

予約プロパティを表示したい場合

［ステップツリー］エリアで予約プロパティを選択してください。

ステッププロパティを表示したい場合

［ステップツリー］エリアでステップ名を選択してください。そのステップのプロパティが［プロパティ］エリアに表示されます。デフォルトでは，選択したステップより前のステップが［ステップツリー］エリアに表示されています。［すべてのステップを表示］をチェックすると，フロー上のすべてのステップが［ステップツリー］エリアに表示されます。

［プロパティ］エリアでマッピングしたいプロパティを選択します。

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

操作結果

プロパティ同士がマッピングされます。

ヒント

サービスプロパティを新規に作成して，ステッププロパティとマッピングすることもできます。作成したサービスプロパティは，［入力プロパティマッピング］ダイアログボックスまたは［出力プロパティマッピング］ダイアログボックスに表示され，ステッププロパティと同じようにマッピングできます。

マッピング元とマッピング先のプロパティの可視性またはデータ型が一致しない場合，ビルド時にエラーになることがあります。可視性またはデータ型によるマッピング可否については，「3.6.5　可視性またはデータ型によるマッピングの可否について」を参照してください。

出力プロパティの場合，サービスプロパティ「エラーメッセージ」がデフォルトで用意されています。「エラーメッセージ」は，［タスク詳細］画面のメッセージエリアにエラーメッセージを出力するためのサービスプロパティです。「エラーメッセージ」とステップの出力プロパティをマッピングすれば，出力プロパティの値を［タスク詳細］画面のメッセージエリアにエラーメッセージとして出力できます。

なお，「エラーメッセージ」は編集および削除できます。削除したあとに同じプロパティキーのサービスプロパティを追加した場合，出力プロパティの値は［タスク詳細］画面に表示されます。

関連項目

3.6.4　プロパティのマッピングとは

3.6.7　ステッププロパティの定義例について

3.6.4　プロパティのマッピングとは

プロパティのマッピングとは，片方のステッププロパティまたはサービスプロパティから，もう片方のステッププロパティまたはサービスプロパティに値を引き継ぐ設定のことです。これにより，プロパティの値を動的に設定できます。

入力プロパティのマッピング設定

入力プロパティを編集してマッピングを設定する場合，編集対象の入力プロパティが値の引き継ぎ先となり，マッピングするプロパティが値の引き継ぎ元となります。

入力プロパティにマッピングできるのは，次のプロパティです。

ステッププロパティ

サービスの入力プロパティ

「reserved.loop.output」「reserved.terminal.account」「reserved.terminal.password」「reserved.terminal.suPassword」以外の予約プロパティ

変数

入力プロパティにマッピングを設定した場合のデータの流れの例を次の図に示します。

図3‒14　入力プロパティにマッピングを設定した場合のデータの流れ

図では，入力プロパティにプロパティAをマッピングしています。そのため，プロパティAに指定または出力された値は，入力プロパティの値として引き継がれます。

出力プロパティのマッピング設定

出力プロパティを編集してマッピングを設定する場合，編集対象の出力プロパティが値の引き継ぎ元となり，マッピングするプロパティが値の引き継ぎ先となります。

出力プロパティにマッピングできるのは，次のプロパティです。

サービスの出力プロパティ

予約プロパティ「reserved.loop.output」

変数

出力プロパティにマッピングを設定した場合のデータの流れの例を次の図に示します。

図3‒15　出力プロパティにマッピングを設定した場合のデータの流れ

図では，出力プロパティにプロパティAをマッピングしています。そのため，出力プロパティに出力された値は，プロパティAの値として引き継がれます。

重要

マッピングを設定している出力プロパティを，入力プロパティにマッピングすると，ビルド時にエラーになります。例えば，サービスの出力プロパティに値を引き継ぐよう設定したステップの出力プロパティの値を，次のステップの入力プロパティに引き継ぐことはできません。

関連項目

3.6.3　ステッププロパティの値をマッピングする手順

3.6.5　可視性またはデータ型によるマッピングの可否について

3.6.5　可視性またはデータ型によるマッピングの可否について

プロパティをマッピングするとき，値を引き継ぐ元となるプロパティと引き継ぐ先のプロパティでは，可視性およびデータ型を一致させることをお勧めします。プロパティの可視性またはデータ型が異なる場合，可視性またはデータ型の組み合わせによっては，ビルド時にエラーになります。エラーになった場合は，［Service Builder Edit］画面の［プロパティ］タブでサービスプロパティの可視性またはデータ型を見直してください。

可視性によるマッピング可否

プロパティの値を引き継ぐ先のプロパティには，引き継ぐ元となるプロパティと同じか，下位の可視性を設定してください。可視性が下位であるとは，公開範囲（プロパティが表示される画面）が限定されているという意味です。値を引き継ぐ元となるプロパティより，引き継ぐ先のプロパティのほうが公開範囲が広い場合，ビルド時にエラーになります。

可視性の組み合わせによるマッピング可否を次の表に示します。

表3‒6　入力プロパティを編集する場合の，可視性の組み合わせによるマッピング可否

値を引き継ぐ元のプロパティの可視性

値を引き継ぐ先のプロパティ（入力プロパティ）の可視性

サービスの入力プロパティ（関連ステップあり）

ステップの入力プロパティ※

［設定画面と実行画面］

［設定画面のみ］

サービスの入力プロパティ（関連ステップなし）

［設定画面と実行画面］

○

○

○

［設定画面のみ］

×

○

○

サービスの入力プロパティ（関連ステップあり）

［設定画面と実行画面］

○

○

○

［設定画面のみ］

×

○

○

変数※

×

×

○

ステップの入力プロパティ※

×

×

○

ステップの出力プロパティ※

×

×

○

（凡例）

○：正常にマッピングできます。 ×：マッピングはできますが，ビルド時にエラーになります。

注※

ステッププロパティおよび変数は，Developロール以上のユーザーがサービステンプレートの開発時に参照・設定できる内部プロパティです。そのため，可視性はサービスプロパティよりも下位になります。

表3‒7　出力プロパティを編集する場合の，可視性の組み合わせによるマッピング可否

値を引き継ぐ元のプロパティ（出力プロパティ）の可視性

値を引き継ぐ先のプロパティの可視性

サービスの出力プロパティ（関連ステップなし）

サービスの出力プロパティ（関連ステップあり）

変数※

サービスの出力プロパティ（関連ステップあり）

○

×

×

ステップの出力プロパティ※

○

×

○

（凡例）

○：正常にマッピングできます。 ×：マッピングはできますが，ビルド時にエラーになります。

注※

ステッププロパティおよび変数は，Developロール以上のユーザーがサービステンプレートの開発時に参照・設定できる内部プロパティです。そのため，可視性はサービスプロパティよりも下位になります。

データ型によるマッピング可否

プロパティの値を引き継ぐ先のプロパティは，引き継ぐ元となるプロパティのデータ型を扱えるデータ型を設定してください。なお，ステッププロパティおよび予約プロパティ「reserved.loop.output」にはデータ型がありません。ただし，ステップの基となるコンポーネントが基本部品の場合，一部のステッププロパティには，データ型が設定されています。このようなステッププロパティは，サービスプロパティに昇格すると，［サービスの入力プロパティ編集］ダイアログボックスでデータ型を確認できます。

データ型の組み合わせによるマッピング可否を次の表に示します。

表3‒8　入力プロパティを編集する場合の，データ型の組み合わせによるマッピング可否

値を引き継ぐ元のプロパティ

値を引き継ぐ先のプロパティ（入力プロパティ）のデータ型

プロパティの種別

データ型

boolean

integer

string

double

date

password

list

composite

データ型なし

入力プロパティ

boolean

○

×

○

×

×

×

×

○

○

integer

×

○

○

×

×

×

×

○

○

string

×

×

○

×

×

×

×

○

○

double

×

×

○

○

×

×

×

○

○

date

×

×

○

×

○

×

×

○

○

password

×

×

×

×

×

○

×

×

○

list

×

×

○

×

×

×

○

○

○

composite

×

×

×

×

×

×

×

○

○

データ型なし

×

×

○

×

×

×

×

○

○

出力プロパティ

string

○

○

○

〇

○

×

○

○

○

password

×

×

×

×

×

○

×

×

○

composite

×

×

×

×

×

×

×

○

○

（凡例）

○：正常にマッピングできます。 ×：マッピングはできますが，ビルド時にエラーになります。

表3‒9　出力プロパティを編集する場合の，データ型の組み合わせによるマッピング可否

値を引き継ぐ元のプロパティ（出力プロパティ）のデータ型

値を引き継ぐ先のプロパティのデータ型

string

password

composite

データ型なし

string

○

×

○

○

password

×

○

×

×

composite

×

×

○

○

データ型なし

○

○

○

○

（凡例）

○：正常にマッピングできます。 ×：マッピングはできますが，ビルド時にエラーになります。

ヒント

プロパティをマッピングするとき，値を引き継ぐ元となるプロパティに設定されていた入力文字制限や最大長などの制限は無視され，引き継ぐ先の制限が適用されます。そのため，引き継ぐ先のプロパティには，引き継ぐ元となるプロパティの値も考慮した制限を設定してください。

関連項目

3.6.4　プロパティのマッピングとは

3.6.3　ステッププロパティの値をマッピングする手順

3.6.6　ステッププロパティをサービスプロパティに昇格する手順

4.2.1　サービスプロパティとは

4.2.4　サービスの入力プロパティに設定する項目について

4.2.5　サービスの出力プロパティに設定する項目について

3.6.6　ステッププロパティをサービスプロパティに昇格する手順

ステッププロパティをサービスプロパティに昇格すると，［Service Builder Edit］画面の［プロパティ］タブに表示され，サービスプロパティとして編集できるようになります。サービスプロパティの詳細については，「4.2.1　サービスプロパティとは」を参照してください。

ステップの入力プロパティをサービスプロパティに昇格すると，［サービス設定］画面および［サービス実行］画面に表示され，サービスの作成時や実行時に値を入力できるようになります。

ステップの出力プロパティをサービスプロパティに昇格すると，サービスの実行後に［タスク詳細］画面の［出力］エリアから出力プロパティの値を確認できるようになります。

ステッププロパティをサービスプロパティに昇格するには：

［Service Builder Edit］画面の［フロー］タブの［フロー］エリアで，ステップを選択します。

［ステッププロパティ］エリアの入力プロパティまたは出力プロパティのアイコンをクリックし，サービスプロパティに昇格したいステッププロパティ列の［サービスプロパティ］のチェックボックスをオンにします。

図3‒16　［ステッププロパティ］エリア

ヒント

サービス部品を使用したステップを選択している場合，［サービスプロパティ］のチェックボックスは変更できません。

また，次の部品を使用したステップのプロパティはサービスプロパティに昇格できないため，［サービスプロパティ］のチェックボックスは表示されません。

階層フロー部品

実行間隔制御部品

戻り値判定分岐部品

異常終了部品

操作結果

ステッププロパティがサービスプロパティに昇格し，［Service Builder Edit］画面の［プロパティ］タブに表示されます。

関連項目

3.6.7　ステッププロパティの定義例について

3.6.7　ステッププロパティの定義例について

サービステンプレートの作成時に，ステッププロパティを定義する例を説明します。

ステップAとステップBを順に実行するサービステンプレートがあります。ステップAの出力結果が格納されたフォルダに対して，ステップBを実行します。また，一部のプロパティの値はサービステンプレートで固定ではなく，サービスの実行時に毎回指定します。

定義内容

ステップのプロパティは次のとおり定義されています。

表3‒10　ステップAの定義

プロパティの種別

プロパティ名

定義内容

入力プロパティ

容量

値は「10」で固定です。変更する必要はありません。

実行対象サーバ

サービス実行時に値を指定します。

出力プロパティ

出力結果の格納フォルダパス

出力結果を［タスク詳細］画面で確認する必要はありません。

表3‒11　ステップBの定義

プロパティの種別

プロパティ名

定義内容

入力プロパティ

実行フォルダパス

ステップAの出力結果の格納フォルダを指定します。

出力プロパティ

ステップBの出力結果

出力結果を［タスク詳細］画面で確認します。

設定内容

プロパティ「容量」の値は10で固定のため，［Service Builder Edit］画面の［フロー］タブの［ステッププロパティ］エリアで，［値］列のテキストボックスに「10」を直接指定します。

プロパティ「実行対象サーバ」の値をサービス実行時に指定するため，［Service Builder Edit］画面の［フロー］タブの［ステッププロパティ］エリアで，［サービスプロパティ］のチェックボックスをオンにして，サービスプロパティに昇格します。その後，昇格させたプロパティの可視性を［サービス作成とサービス実行］に設定します。

ステップBをステップAの出力結果の格納フォルダに実行するため，ステップBのプロパティ「実行フォルダパス」を選択し，［入力プロパティマッピング］ダイアログボックスでステップAのプロパティ「出力結果の格納フォルダパス」を指定します。

サービスの実行後，プロパティ「ステップBの出力結果」を［タスク詳細］画面で確認するため，［Service Builder Edit］画面の［フロー］タブの［ステッププロパティ］エリアで，［サービスプロパティ］のチェックボックスをオンにして，サービスプロパティに昇格します。

データの流れ

各プロパティのデータの流れを次に示します。

図3‒17　データの流れ

サービスの実行者が［サービス実行］画面で指定した値が，ステップAの「実行対象サーバ」の値として格納されます。

ステップAのプロパティ「出力結果の格納フォルダパス」に出力された値が，ステップBのプロパティ「実行フォルダパス」の値として格納されます。

ステップBのプロパティ「ステップBの出力結果」が，［タスク詳細］画面に表示されます。

関連項目

3.6.2　ステップの入力プロパティの値を直接指定する手順

3.6.3　ステッププロパティの値をマッピングする手順

3.6.6　ステッププロパティをサービスプロパティに昇格する手順

3.6.8　予約プロパティ一覧

予約プロパティとは，JP1/AOがプロパティキーの定義や用途を規定している特殊なサービスプロパティです。プロパティキーは「reserved.」で始まります。このプロパティは，［入力プロパティマッピング］ダイアログボックスまたは［出力プロパティマッピング］ダイアログボックスで，ステッププロパティにマッピングして使用します。ユーザーが，プロパティの定義や値を設定する必要はありません。

入力プロパティとして予約プロパティをマッピングすると，部品実行時に予約プロパティの値が部品プロパティの値に反映されます。

予約プロパティを使用するには，［入力プロパティマッピング］ダイアログボックスで［プロパティ参照］ラジオボタンを選択します。

または，［直接入力］を選択し，［プロパティ挿入］ボタンをクリックします。［参照プロパティ選択］ダイアログボックス※で予約プロパティを選択すると，［値］テキストボックスに「?dna_予約プロパティキー?」の形式で，予約プロパティを指定できます。この場合，部品実行時に部品プロパティの一部として値が反映されます。

注※

［ステップツリー］エリアで繰り返し実行部品のステップを選択した場合だけ，［予約プロパティ］ダイアログが表示され，繰り返し実行部品に関連する予約プロパティが表示されます。

出力プロパティとして予約プロパティを使用すると，任意の部品プロパティの値が予約プロパティに格納されます。［出力プロパティマッピング］ダイアログボックスで，［プロパティ参照］ラジオボタンを選択すると，出力プロパティに対して，値を反映する先のサービスプロパティとして指定できます。

表3‒12　予約プロパティ一覧

予約プロパティキー

説明

reserved.loop.index※1

選択している部品から見て，1個上位の繰り返し実行部品の繰り返し実行の回次を表す1～99の数値を参照するためのプロパティです。

繰り返し実行の回次とは，繰り返し実行部品のプロパティ「inputProperties」に指定された「,」区切りのデータのうち，何番目のパラメータに対応する実行かを表しています。繰り返し実行方式が「parallel」の場合でも回次を参照できます。この予約プロパティを参照指定で使う場合は?dna_reserved.loop.index?と記述します。このプロパティは，reserved.loop.inputと同じように，繰り返し実行部品の配下のフロー内で，かつ，サービスプロパティをマッピングできる部品であればどの部品でも使用できます。

reserved.loop.indexN※1

選択している部品から見て，N個上位の繰り返し実行部品の繰り返し実行の回次を表す1～99の数値を参照するためのプロパティです。

繰り返し実行の回次とは，繰り返し実行部品のプロパティ「inputProperties」に指定された「,」区切りのデータのうち，何番目のパラメータに対応する実行かを表しています。繰り返し実行方式が「parallel」の場合でも回次を参照できます。この予約プロパティを参照指定で使う場合は?dna_reserved.loop.indexN?と記述します。このプロパティは，reserved.loop.inputと同じように，繰り返し実行部品の配下のフロー内で，かつ，サービスプロパティをマッピングできる部品であればどの部品でも使用できます。

N：2または3の整数値

reserved.loop.input※1

選択している部品から見て，1個上位の繰り返し実行部品の入力プロパティ「inputProperties」の値を参照するための予約プロパティです。

繰り返し実行部品の入力プロパティで指定したコンマ区切りの値のうち，フローの繰り返し回数に対応した項目の値が入力されます。例えば，入力プロパティが「A，B，C」だった場合，繰り返しの回次に応じて「A」，「B」，「C」が順に入力されます。繰り返しは99回まで実行できます。この予約プロパティを参照指定で使う場合は?dna_reserved.loop.input?と記述します。

reserved.loop.inputN※1

選択している部品から見て，N個上位の繰り返し実行部品の入力プロパティ「inputProperties」の値を参照するための予約プロパティです。

繰り返し実行部品の入力プロパティで指定したコンマ区切りの値のうち，フローの繰り返し回数に対応した項目の値が入力されます。例えば，入力プロパティが「A，B，C」だった場合，繰り返しの回次に応じて「A」，「B」，「C」が順に入力されます。繰り返しは99回まで実行できます。この予約プロパティを参照指定で使う場合は?dna_reserved.loop.inputN?と記述します。

N：2または3の整数値

reserved.loop.output

繰り返し実行部品の出力プロパティ「outputProperties」に値を代入するための予約プロパティです。

このプロパティに出力された値が，コンマ区切りで出力プロパティに反映されます。例えば，部品の出力プロパティの値がフローの繰り返し回数に対応して「X」，「Y」，「Z」となった場合，出力プロパティには「X，Y，Z」という結果が反映されます。

reserved.service.name

タスクの生成元となったサービスの名称を参照するためのプロパティです。

この予約プロパティを参照指定で使う場合は?dna_reserved.service.name?と記述します。サービスプロパティをマッピングできる部品であればどの部品でも使用できます。

reserved.step.path

実行中のステップのIDを参照するためのプロパティです。

この予約プロパティを参照指定で使う場合は?dna_reserved.step.path?と記述します。タスクログに出力される部品実行開始および終了時のメッセージの埋め字と同じ値です。サービスプロパティをマッピングできる部品であればどの部品でも使用できます。

reserved.service.serviceGroupName

タスクの生成元となったサービスが登録されているサービスグループを参照するためのプロパティです。

この予約プロパティを参照指定で使う場合は?dna_reserved.service.serviceGroupName?と記述します。サービスプロパティをマッピングできる部品であればどの部品でも使用できます。

reserved.step.prevReturnCode

先行のステップ（接続された関連線の接続元となるステップ）の戻り値を参照するためのプロパティです。

この予約プロパティを参照指定で使う場合は?dna_reserved.step.prevReturnCode?と記述します。先行のステップが複数ある場合は，すべての戻り値の論理和が設定されます。先行のステップがない場合は0が設定されます。サービスプロパティをマッピングできる部品であればどの部品でも使用できます。

タスクをリトライする場合に，先行のステップを実行しないで，この予約プロパティを参照するステップから実行するときは，先行ステップの戻り値として前回ステップを実行したときの戻り値が設定されます。※

reserved.task.description

タスクの説明を参照するためのプロパティです。

この予約プロパティを参照指定で使う場合は?dna_reserved.task.description?と記述します。サービスプロパティをマッピングできる部品であればどの部品でも使用できます。

reserved.task.dir

タスク実行時に一時的に作成される，データフォルダのパスを参照するための予約プロパティです。

このプロパティは，タスク実行時にタスクごとの一意のフォルダパスに展開されます。

このフォルダは，タスクを実行するときJP1/AOサーバ上に作成され，タスクのアーカイブ時に削除されます。

なお，名称が「task」で始まるファイルやフォルダは，JP1/AOで予約されているため，ユーザーは作成しないでください。

reserved.task.id

タスクIDを参照するためのプロパティです。

この予約プロパティを参照指定で使う場合は?dna_reserved.task.id?と記述します。サービスプロパティをマッピングできる部品であればどの部品でも使用できます。

reserved.task.name

タスク名を参照するためのプロパティです。

この予約プロパティを参照指定で使う場合は?dna_reserved.task.name?と記述します。サービスプロパティをマッピングできる部品であればどの部品でも使用できます。

reserved.task.submitter

タスクの実行者のユーザーIDを参照するためのプロパティです。

タスクをリトライした場合でも，リトライしたときのユーザーではなく，タスクを実行したときのユーザーのユーザーIDを参照します。

この予約プロパティを参照指定で使う場合は?dna_reserved.task.submitter?と記述します。サービスプロパティをマッピングできる部品であればどの部品でも使用できます。

reserved.task.tags

タスクに設定されているタグを参照するためのプロパティです。

この予約プロパティを参照指定で使う場合は?dna_reserved.task.tags?と記述します。サービスプロパティをマッピングできる部品であればどの部品でも使用できます。

reserved.task.url

［タスク詳細］画面へのURLを参照するためのプロパティです。

この予約プロパティを参照指定で使う場合は?dna_reserved.task.url?と記述します。サービスプロパティをマッピングできる部品であればどの部品でも使用できます。

reserved.terminal.account

ターミナル接続部品で使用されたユーザーIDを参照するための予約プロパティです。

ターミナルコマンド実行部品の入力プロパティ「commandLine」で使用します。

接続に使用するユーザーアカウントが入力されます。

reserved.terminal.password

ターミナル接続部品で使用されたパスワードを参照するための予約プロパティです。

ターミナルコマンド実行部品の入力プロパティ「commandLine」で使用します。

接続に使用するユーザーアカウントのパスワードが入力されます。

reserved.terminal.suPassword

ターミナル接続部品で使用された管理者のパスワードを参照するための予約プロパティです。

ターミナルコマンド実行部品の入力プロパティ「commandLine」で使用します。

接続で使用するスーパーユーザーのパスワードが入力されます。

注※1

繰り返し実行部品を入れ子で定義している場合，繰り返し実行入力値（reserved.loop.input，reserved.loop.inputN），および繰り返し実行回次（reserved.loop.index，reserved.loop.indexN）は，プルダウンメニューにまとめて表示されます。その場合，対応する繰り返し実行部品のステップ名が括弧内に表示されます。詳細を次の図に示します。

注※2

タスクをリトライした場合，予約プロパティに設定される値の例を次に示します。

フローにstep1，step2，step3というステップがあり，step2とstep3にはそれぞれ「reserved.step.prevReturnCode」が定義されています。step1の戻り値は0，step2の戻り値は63で失敗，step3は未実行という状態でタスクが失敗したとします。

この状態で［失敗したステップからリトライ］を実行する場合，step2から見た「reserved.step.prevReturnCode（step1の戻り値）」は0になります。また，［失敗した次のステップからリトライ］を実行する場合，step3から見た「reserved.step.prevReturnCode（step2の戻り値）」は63になります。

3.6.9　ステップに表示される警告アイコンについて

指定が必須のステッププロパティの値が空である場合，ステップに警告を表すアイコンが表示されます。

図3‒18　警告アイコンが表示されているステップの例

警告アイコンの表示は，ステッププロパティの値を編集したタイミングで更新されます。

警告アイコンが表示されたステップをコピーして貼り付けた場合，警告アイコンもコピーされます。

なお，警告アイコンは［ステッププロパティ］エリアにも表示されます。

3.7　ステップとして使用しているコンポーネントのバージョンを管理する

サービステンプレートのステップとして使用しているコンポーネントのバージョンを最新にしたり，任意のバージョンに変更したりできます。

3.7.1　ステップとして使用しているコンポーネントのバージョンの管理について

JP1/AOでは，開発サービステンプレートのステップとして使用しているコンポーネントのバージョンを一括または個別に変更できます。なお，コンポーネントのバージョンを変更した場合，プロパティ値などのユーザーが設定した情報を引き継ぐことができます。また，ステップとして使用しているコンポーネントのバージョンを確認することもできます。これらの機能は，複数のバージョンを持つコンポーネントが対象です。

なお，サービス部品を使用したコンポーネントのバージョンを変更する場合で，サービス部品の内部にさらにサービス部品を含むとき，内部のサービス部品のバージョンは変更されません。

ステップとして使用しているコンポーネントのバージョン管理機能

ステップとして使用しているコンポーネントのバージョンを確認および変更する方法は，［一括適用］と［個別適用］から選べます。それぞれの機能を次に説明します。

［一括適用］

ステップとして使用しているすべてのコンポーネントを，最新バージョンのリリース部品またはサービス部品に一括で変更する機能です。ただし，すでに最新バージョンのコンポーネントを使用しているステップは変更されません。また，ステップとして使用しているすべてのコンポーネントのバージョンを確認することもできます。

［個別適用］

ステップとして使用しているコンポーネントの中から，特定のコンポーネントを任意のバージョンに変更する機能です。また，特定のコンポーネントのバージョンを確認することもできます。

［一括適用］と［個別適用］の機能の違いを，次の表に示します。

表3‒13　［一括適用］と［個別適用］の機能の違い

比較する内容

［一括適用］

［個別適用］

変更対象となるコンポーネント

最新バージョンよりも古いバージョンのコンポーネント。

指定したコンポーネント。バージョンは問いません。

変更後のコンポーネント

最新バージョンのリリース部品およびサービス部品。

指定したバージョンのコンポーネント。

ヒント

この機能の対象は，開発サービステンプレートです。リリースサービステンプレートのステップが使用しているコンポーネントのバージョンを変更したい場合は，事前にサービステンプレートを複製して，開発サービステンプレートとしてください。

関連項目

3.7.2　ステップとして使用しているコンポーネントのバージョンを確認する手順

3.7.3　ステップとして使用しているコンポーネントのバージョンを一括で最新にする手順

3.7.4　ステップとして使用しているコンポーネントのバージョンを任意に変更する手順

3.7.5　コンポーネントのバージョンを変更したときに引き継がれる情報について

3.7.2　ステップとして使用しているコンポーネントのバージョンを確認する手順

ステップとして使用しているコンポーネントのバージョンを確認します。

ステップとして使用しているコンポーネントのすべてを，一度に確認する場合は，［一括適用］タブを選択します。指定したコンポーネントのバージョンを確認する場合は，［個別適用］タブを選択します。

［一括適用］タブから確認する場合

［Service Builder Home］画面で，［開発］タブをクリックし，確認するサービステンプレートを選択して，［編集］ボタンをクリックします。

［操作］プルダウンメニューの［コンポーネントバージョン管理］を選択します。

［コンポーネントバージョン管理］ダイアログボックスで，［一括適用］タブを選択します。

［ステップ一覧］の［適用済みバージョン］で，サービステンプレート内のステップが使用するすべてのコンポーネントのバージョンが確認できます。

［状態］で，［未適用］と表示されているステップは，コンポーネントのバージョンを最新バージョンのリリース部品またはサービス部品に変更できます。［適用済み］と表示されているステップは，最新バージョンのリリース部品またはサービス部品を使用しています。［適用不可］と表示されているステップは，変更先に指定するリリース部品またはサービス部品がありません。

［個別適用］タブから確認する場合

［Service Builder Home］画面で，［開発］タブをクリックし，確認するサービステンプレートを選択して，［編集］ボタンをクリックします。

［操作］プルダウンメニューの［コンポーネントバージョン管理］を選択します。

［コンポーネントバージョン管理］ダイアログボックスで，［個別適用］タブを選択します。

［コンポーネント一覧］から，バージョンを確認したいコンポーネントを選択します。

［ステップ一覧］の［適用済みバージョン］で，選択したステップが使用するコンポーネントのバージョンが確認できます。

［状態］で，［未適用］と表示されているステップは，コンポーネントのバージョンを変更できます。［適用済み］と表示されているステップは，任意に指定したコンポーネントのバージョンを使用しています。

関連項目

3.7.1　ステップとして使用しているコンポーネントのバージョンの管理について

3.7.3　ステップとして使用しているコンポーネントのバージョンを一括で最新にする手順

ステップとして使用しているコンポーネントを，一括で最新バージョンのリリース部品またはサービス部品に変更します。

［Service Builder Home］画面で，［開発］タブをクリックし，確認するサービステンプレートを選択して，［編集］ボタンをクリックします。

［操作］プルダウンメニューの［コンポーネントバージョン管理］を選択します。

図3‒19　［コンポーネントバージョン管理］選択

［コンポーネントバージョン管理］ダイアログボックスで，［一括適用］タブを選択します。

図3‒20　［コンポーネントバージョン管理］ダイアログボックス（［一括適用］タブ）

ヒント

最新バージョンにしたくないステップがあれば，ステップ選択チェックボックスからチェックを外します。

最新バージョンのリリース部品よりも，新しいバージョンの開発部品を使用しているステップは，変更対象として，ステップ選択チェックボックスがチェックされています。そのため，この部品を変更対象にしない場合は，ステップ選択チェックボックスのチェックを外してください。

［適用］ボタンをクリックします。

［ステップ一覧］で選択されているステップが使用するすべてのコンポーネントが，一括で最新バージョンのリリース部品またはサービス部品に変更されます。

変更後のプロパティに，変更前のプロパティ値が引き継がれない場合，[図データ]が表示されます。表示された場合は，ステップの定義情報を見直してください。変更前のプロパティ値が引き継がれない場合を次に示します。

プロパティが削除された場合

プロパティキーの値が変更された場合

プロパティの入出力種別が変更された場合

操作結果

選択したステップが使用するコンポーネントが，最新バージョンのリリース部品またはサービス部品に変更されます。

関連項目

3.7.1　ステップとして使用しているコンポーネントのバージョンの管理について

3.7.5　コンポーネントのバージョンを変更したときに引き継がれる情報について

3.7.4　ステップとして使用しているコンポーネントのバージョンを任意に変更する手順

ステップとして使用しているコンポーネントを，コンポーネントごとに任意のバージョンに変更します。

［Service Builder Home］画面で，［開発］タブをクリックし，確認するサービステンプレートを選択して，［編集］ボタンをクリックします。

［操作］プルダウンメニューの［コンポーネントバージョン管理］を選択します。

図3‒21　［コンポーネントバージョン管理］選択

［コンポーネントバージョン管理］ダイアログボックスで，［個別適用］タブを選択します。

図3‒22　［コンポーネントバージョン管理］ダイアログボックス（［個別適用］タブ）

［コンポーネント一覧］からバージョンを変更したいコンポーネントを選択します。

［コンポーネント一覧］には，ステップとして使用しているコンポーネントの種類が表示されます。そのコンポーネントのバージョンが複数ある場合にだけ表示されます。そのうち，最新ではないコンポーネントを含む場合，[図データ]が表示されます。

変更先となるバージョンの詳細情報を確認するため，［バージョン］プルダウンメニューからバージョンを選択し，表示された部品の情報を確認します。［参照］ボタンが表示されている部品については，［参照］ボタンをクリックして表示された［部品参照］ダイアログボックスで部品の詳細情報を確認できます。

指定したバージョンごとに［ステップ一覧］の［状態］を確認してください。［状態］が［未適用］と表示されているステップは，バージョンを変更できます。［適用済み］と表示されているステップは，変更先に指定したバージョンと同じバージョンであるため，変更できません。

［バージョン］プルダウンメニューから，変更先に指定したいバージョンを選択します。

［状態］が［未適用］のステップの中から，バージョンを変更したいステップを選択します。

［適用］ボタンをクリックします。

［ステップ一覧］で選択されているステップが，指定したバージョンのコンポーネントに変更されます。

変更後のプロパティに，変更前のプロパティ値が引き継がれない場合，[図データ]が表示されます。表示された場合は，ステップの定義情報を見直してください。変更前のプロパティ値が引き継がれない場合を次に示します。

プロパティが削除された場合

プロパティキーの値が変更された場合

プロパティの入出力種別が変更された場合

操作結果

選択したステップが使用するコンポーネントが，指定したバージョンのコンポーネントに変更されます。

関連項目

3.7.1　ステップとして使用しているコンポーネントのバージョンの管理について

3.7.5　コンポーネントのバージョンを変更したときに引き継がれる情報について

3.7.5　コンポーネントのバージョンを変更したときに引き継がれる情報について

コンポーネントのバージョンを変更した場合に，変更前と変更後で同一のプロパティまたはプロパティグループについては，一部の情報が引き継がれます。

コンポーネントのバージョンを変更したときに引き継がれるプロパティの情報について

一括適用または個別適用の前後で，あるプロパティのプロパティキーおよび入出力種別が一致する場合，そのプロパティは変更前と変更後で同一のものとして処理されます。適用後にプロパティが追加された場合，プロパティ値には追加されたプロパティのデフォルト値が指定されます。適用後にプロパティが削除された場合，該当するプロパティ自体が削除されます。

一括適用または個別適用の前後で同一のプロパティとして処理される場合に，引き継がれる情報を次に示します。

プロパティ値（プロパティのマッピング設定を含む）

プロパティ名

説明

表示設定

デフォルト値※

注※ サービス部品を使用したステップで，次の条件のどれかに当てはまる場合だけ，デフォルト値は変更後の情報で更新されます。

変更前または変更後のプロパティが，サービス部品の内部のプロパティを参照している場合

プロパティのデータ型が，composite型からcomposite型以外に変更された場合

プロパティのデータ型が，composite型以外からcomposite型に変更された場合

なお，この場合デフォルト値は空になります。

コンポーネントのバージョンを変更したときに引き継がれるプロパティグループの情報について

一括適用または個別適用の前後で，あるプロパティグループのプロパティグループキーが一致する場合，そのプロパティグループは変更前と変更後で同一のものとして処理されます。適用後のコンポーネントにだけ存在するプロパティグループは新規に追加し，適用前のコンポーネントにだけ存在するプロパティグループは削除します。

一括適用または個別適用の前後で同一のプロパティグループとして処理される場合に，引き継がれる情報を次に示します。

プロパティグループ名

説明

表示設定

注※ サービス部品を使用したコンポーネントのバージョンを変更する場合，変更後の情報で更新されます。

4　サービスプロパティを設定する

フローを編集したら，［Service Builder Edit］画面の［プロパティ］タブで，サービスプロパティを設定します。

サービスプロパティを設定すると，サービスの設定時・実行時に入力する項目や，実行結果の確認時に表示される項目を定義できます。

4.1　［Service Builder Edit］画面の［プロパティ］タブ

［Service Builder Edit］画面の［プロパティ］タブは，サービスプロパティの設定をするための画面です。［Service Builder Home］画面で，作成または編集の操作をして［Service Builder Edit］画面を表示し，［プロパティ］タブをクリックすると表示されます。

図4‒1　［Service Builder Edit］画面の［プロパティ］タブ

［プロパティ］タブには，プロパティグループと各グループに所属するサービスプロパティの一覧が表示されます。［プロパティ］タブは次の項目で構成されます。

フィルタリング機能エリア

プロパティ一覧エリアに多数のプロパティがある場合に，表示するプロパティを絞り込むためのフィルタリング機能があります。

テキスト検索ボックス

任意の文字列を入力して，表示するサービスプロパティをフィルタリングします。

フィルタリングボタン

プロパティの属性に応じて表示するサービスプロパティをフィルタリングします。ボタンをクリックすることでフィルタリングのON/OFFを切り替えます。フィルタリングできる属性を次に示します。

・プロパティの種別（入力プロパティ，出力プロパティ，または変数）

・プロパティの可視性（サービス作成とサービス実行，サービス実行，または［タスク詳細］画面）

・プロパティの表示設定（変更可能，変更不可，表示，または非表示）

操作機能エリア

プロパティグループまたはサービスプロパティに対する操作を実行するためのボタンです。

［全グループを開く］ボタン

クリックすると，すべてのプロパティグループを開いて，サービスプロパティを表示します。

［全グループを閉じる］ボタン

クリックすると，すべてのプロパティグループを閉じます。

［追加］ボタン

プロパティグループまたはサービスプロパティを作成できます。

［編集］ボタン

一覧で選択したサービスプロパティを編集します。

［削除］ボタン

一覧で選択したサービスプロパティを削除します。

［プレビュー］ボタン

［サービス作成］画面，［サービス実行］画面，または［タスク詳細］画面をプレビューします。

［その他の操作］ボタン

一覧で選択したサービスプロパティの可視性，表示設定を変更します。

プロパティ一覧エリア

プロパティ一覧エリアでは，プロパティグループおよびサービスプロパティの一覧が表示されます。プロパティグループおよびサービスプロパティの各行に表示される項目について説明します。

プロパティグループの行には次の項目が表示されます。

表示/非表示プルダウンメニュー

プロパティグループの表示/非表示を切り替えられます。

［編集］ボタン

クリックすると，プロパティグループを編集できます。

［削除］ボタン

クリックすると，プロパティグループを削除できます。

［追加］ボタン

クリックすると，プロパティを作成してプロパティグループに追加できます。

［上に移動］ボタンおよび［下に移動］ボタン

クリックすると，プロパティグループの並び順を変更できます。

サービスプロパティの各行には次の項目が表示されます。

チェックボックス

サービスプロパティの行を選択するときにクリックします。複数の行を選択できます。

［編集］ボタン

クリックすると，サービスプロパティを編集できます。

［削除］ボタン

クリックすると，サービスプロパティを削除できます。

サービスプロパティの種別

サービスプロパティの種別（入力プロパティ，出力プロパティ，または変数）が表示されます。

［プロパティキー］

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

［プロパティ名］

クリックすると，プロパティ名を編集できます。

［説明］

クリックすると，説明を編集できます。

［可視性］プルダウンメニュー

クリックすると，サービスプロパティを［サービス作成］画面と［サービス実行］画面に表示するか，［サービス作成］画面だけに表示するかを切り替えられます。

［表示設定］プルダウンメニュー

クリックすると，プロパティの表示設定を切り替えられます。

［デフォルト値］

クリックすると，デフォルト値を編集できます。

4.2　サービスプロパティを編集・追加する

サービスに定義するプロパティをサービスプロパティと呼びます。サービスプロパティには表示情報やデータ型，デフォルト値などを設定します。

4.2.1　サービスプロパティとは

サービスプロパティとは，サービスの実行者がサービスの実行に必要なパラメータを指定したり，サービスの実行結果を取得したりするためのプロパティです。サービスプロパティには次の種類があります。

入力プロパティ

サービスの実行に必要な入力値を格納するためのプロパティを定義できます。独自のプロパティを定義するほか，サービス共有プロパティを利用することもできます。

出力プロパティ

サービスの実行結果を格納するためのプロパティを定義できます。

変数

部品間の処理で値を引き継ぐために設定するワーク用の変数です。

入力プロパティおよび出力プロパティは，次の画面でサービスプロパティとして表示されます。

［サービス作成］画面

［サービス実行］画面

［タスク詳細］画面

［サービス共有プロパティ］エリア（サービス共有プロパティの場合）

ヒント

［Service Builder Edit］画面の［フロー］タブでサービスプロパティに昇格する設定をしたステッププロパティが，サービスプロパティとして［プロパティ］タブに表示されます。サービスプロパティは，新規に作成することもできます。

関連項目

4.2.2　サービスプロパティを編集する手順

4.2.3　サービスプロパティを追加する手順

3.6.6　ステッププロパティをサービスプロパティに昇格する手順

4.3.1　サービス共有プロパティとは

4.3.4　ビルトインサービス共有プロパティとは

4.2.7　プロパティの可視性および表示設定について

4.2.2　サービスプロパティを編集する手順

サービスプロパティの編集とは，サービスプロパティの定義情報を変更する操作です。サービスプロパティの定義情報は，［サービスの入力プロパティ編集］ダイアログボックス，［サービスの出力プロパティ編集］ダイアログボックス，または［変数編集］ダイアログボックスで変更できます。

サービスプロパティを編集するには：

［Service Builder Edit］画面の［プロパティ］タブで，編集したいサービスプロパティを選択して［編集］ボタンをクリックします。

表示されたダイアログボックスで，定義情報を編集します。

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

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

操作結果

サービスプロパティの編集内容が設定されます。

関連項目

1.2.3　サービステンプレートの編集を開始する手順

4.2.4　サービスの入力プロパティに設定する項目について

4.2.5　サービスの出力プロパティに設定する項目について

4.2.6　変数に設定する項目について

4.2.3　サービスプロパティを追加する手順

サービスの入力プロパティ，出力プロパティ，および変数を追加できます。追加したサービスプロパティは，ステッププロパティとマッピングできます。

サービスプロパティを追加するには：

［Service Builder Edit］画面の［プロパティ］タブで，［追加］ボタンのメニューから［入力プロパティ］，［出力プロパティ］または［変数］をクリックします。

表示されたダイアログボックスで，定義情報を入力します。

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

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

操作結果

サービスプロパティが作成され，［Service Builder Edit］画面の［プロパティ］タブに追加されます。

ヒント

サービスの入力プロパティ，出力プロパティおよび変数は，［入力プロパティマッピング］ダイアログボックスまたは［出力プロパティマッピング］ダイアログボックスからも追加できます。

関連項目

4.2.4　サービスの入力プロパティに設定する項目について

4.2.5　サービスの出力プロパティに設定する項目について

4.2.6　変数に設定する項目について

4.2.4　サービスの入力プロパティに設定する項目について

［サービスの入力プロパティ作成］ダイアログボックスまたは［サービスの入力プロパティ編集］ダイアログボックスで設定できる項目は次のとおりです。

表4‒1　サービスの入力プロパティに設定する項目

項目

説明

関連ステップ

プロパティの関連ステップが表示されます。

［Service Builder Edit］画面の［フロー］タブの［ステッププロパティ］エリアで［サービスプロパティ］がチェックされているプロパティを編集する場合に表示されます。

プロパティキー

プロパティキーを入力します。

この項目は，プロパティに関連ステップがある場合，プロパティの関連ステップがサービス部品を使用している場合，またはビルトインサービス共有プロパティの場合，変更できません。

プロパティ名※1

プロパティの名称を入力します。

説明※1

プロパティの説明を入力します。

プロパティグループ

プロパティを所属させるプロパティグループを選択します。

この項目は，プロパティの関連ステップがサービス部品を使用している場合，変更できません。

なお，プロパティグループは，［Service Builder Edit］画面の［プロパティ］タブでサービスプロパティをプロパティグループの上にドラッグ&ドロップしても設定できます。

可視性※1

［サービス作成］画面および［サービス実行］画面での可視性を設定します。可視性は，入力プロパティを公開するユーザーのロールを制限したいときに設定します。入力プロパティが各画面で表示されるかどうかは，［表示設定］との組み合わせで決まります。可視性と表示設定の組み合わせについては，「4.2.7　プロパティの可視性および表示設定について」を参照してください。

この項目は，プロパティの関連ステップがサービス部品を使用している場合，またはビルトインサービス共有プロパティの場合，変更できません。

表示設定※1

［サービス作成］画面および［サービス実行］画面での表示設定を選択します。表示設定は，ユーザーが入力プロパティに対してできる操作を制限したいときに設定します。入力プロパティが各画面で表示されるかどうか，および値を変更できるかどうかは，［可視性］との組み合わせで決まります。可視性と表示設定の組み合わせについては，「4.2.7　プロパティの可視性および表示設定について」を参照してください。

スコープ

チェックすると，入力プロパティはサービス共有プロパティになります。

この項目は，プロパティに関連ステップがある場合，プロパティの関連ステップがサービス部品を使用している場合，またはビルトインサービス共有プロパティの場合，変更できません。また，データ型に［composite］を選択した場合，チェックできません。

必須区分

チェックすると，入力が必須のプロパティになります。

この項目は，プロパティに関連ステップがある場合，プロパティの関連ステップがサービス部品を使用している場合，またはビルトインサービス共有プロパティの場合，変更できません。

データ型

入力プロパティのデータ型を選択します。

この項目は，プロパティの関連ステップがサービス部品を使用している場合，またはビルトインサービス共有プロパティの場合，変更できません。また，基本部品の場合，一部のプロパティはデータ型が変更できません。

設定方法

入力プロパティの設定方法を選択します。

この項目は，次の条件をすべて満たす場合に表示されます。

プロパティに関連ステップがある

サービス共有プロパティではない

サービス部品の内部で，ほかのプロパティとマッピングされていない

なお，設定方法で［プロパティを参照］を選択した場合，［サービス作成］画面または［サービス実行］画面でデフォルト値を変更できなくなります。

デフォルト値※1※2

プロパティのデフォルト値を指定します。

この項目は，ビルトインサービス共有プロパティの場合，表示されません。

編集中のプロパティの関連ステップがサービス部品を使用していて，かつプロパティがサービス部品の内部でほかのプロパティとマッピングされている場合，デフォルト値には，［（内部プロパティ）］が表示され，変更できません。

バリデーションスクリプト

プロパティのバリデーションスクリプトを指定します。

［新規作成］ボタンをクリックするとバリデーションスクリプトを入力するためのエディタが表示されます。

この項目は，サービス共有プロパティの場合，表示されません。

注※1

［Service Builder Edit］画面の［プロパティ］タブのプロパティ一覧エリアでも編集できます。

注※2

データ型に［composite］を選択している場合，デフォルト値を入力するためのエディタが表示されます。このとき，デフォルト値にプロパティキーが参照指定されていても，文字列として扱われ，プロパティ値は取得できません。

ヒント

string型とcomposite型の違いは，指定できる文字数です。string型の場合は1,024文字までしか指定できませんが，composite型は30MBまで指定できます。例えば，1,024文字を超える出力プロパティをほかのステップの入力プロパティにマッピングしたい場合は，入力プロパティのデータ型としてcomposite型を指定してください。

選択したデータ型に応じて表示される項目を次に示します。

表4‒2　サービスの入力プロパティに設定する項目（データ型によって表示/非表示が異なるもの）

項目

データ型

string

boolean

integer

double

date

password

list

composite

最小長

○

×

×

×

×

○

×

×

最大長

○

×

×

×

×

○

×

×

最小値

×

×

○

○

○

×

×

×

最大値

×

×

○

○

○

×

×

×

リスト表示値

×

×

×

×

×

×

○

×

入力文字制限※

○

×

×

×

×

○

×

×

注※

入力文字制限を指定します。PCREに従った正規表現を指定します。

（凡例）

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

関連項目

4.2.7　プロパティの可視性および表示設定について

4.2.5　サービスの出力プロパティに設定する項目について

［サービスの出力プロパティ作成］ダイアログボックスまたは［サービスの出力プロパティ編集］ダイアログボックスで設定できる項目は次のとおりです。

表4‒3　サービスの出力プロパティに設定する項目

項目

説明

関連ステップ

プロパティの関連ステップが表示されます。

［Service Builder Edit］画面の［プロパティ］タブの［ステッププロパティ］エリアで［サービスプロパティ］がチェックされているプロパティを編集する場合に表示されます。

プロパティキー

プロパティキーを入力します。

この項目は，プロパティの関連ステップがサービス部品を使用している場合，変更できません。

プロパティ名※

プロパティの名称を入力します。

説明※

プロパティの説明を入力します。

プロパティグループ

プロパティを所属させるプロパティグループを選択します。

この項目は，プロパティの関連ステップがサービス部品を使用している場合，変更できません。

なお，プロパティグループは，［Service Builder Edit］画面の［プロパティ］タブでサービスプロパティをプロパティグループの上にドラッグ&ドロップしても設定できます。

表示/非表示※

出力プロパティを［タスク詳細］画面に表示するかどうかを選択します。

データ型

出力プロパティのデータ型を選択します。string，passwordまたはcompositeが選択できます。

この項目は，プロパティの関連ステップがサービス部品を使用している場合，変更できません。

デフォルト値※

出力プロパティのデフォルト値を入力します。指定できる値はデータ型によって異なります。

なお，プロパティに関連ステップがある場合，デフォルト値には，プロパティのマッピングだけ設定できます。

関連ステップがサービス部品を使用していて，かつプロパティがサービス部品の内部でほかのプロパティとマッピングされている場合，デフォルト値には「（内部プロパティ）」が表示され，変更できません。

注※

［Service Builder Edit］画面の［プロパティ］タブのプロパティ一覧エリアでも編集できます。

4.2.6　変数に設定する項目について

［変数作成］ダイアログボックスまたは［変数編集］ダイアログボックスで設定できる項目は次のとおりです。

表4‒4　変数に設定する項目

項目

説明

プロパティキー

プロパティキーを入力します。

プロパティ名※

プロパティの名称を入力します。

説明※

プロパティの説明を入力します。

プロパティグループ

「デフォルトプロパティ」が設定されています。変数の場合，この項目は変更できません。

データ型

変数のデータ型を選択します。string，password，またはcompositeが選択できます。

デフォルト値※

変数のデフォルト値を入力します。指定できる値はデータ型によって異なります。

注※

［Service Builder Edit］画面の［プロパティ］タブのプロパティ一覧エリアでも編集できます。

4.2.7　プロパティの可視性および表示設定について

サービスプロパティの可視性と表示設定の組み合わせによって，JP1/AOの各画面にプロパティを表示するかどうかや，値および表示設定を変更可能にするかどうかが設定できます。ただし，変数には設定できません。

プロパティの可視性

サービスプロパティには，可視性を指定できます。プロパティの可視性を指定すると，JP1/AOの操作画面でプロパティを表示したり，非表示にしたりできます。

プロパティを表示できるJP1/AOの操作画面を次に示します。

［サービス作成］画面

［サービス実行］画面

［タスク詳細］画面

［サービス共有プロパティ］エリア

例えば，サービスを実行するユーザーが意識する必要のないプロパティを，［サービス実行］画面に表示しないようにできます。

なお，サービスの出力プロパティは，［タスク詳細］画面にだけ表示されます。

サービスの入力プロパティの可視性は，［Service Builder Edit］画面の［プロパティ］タブで設定できます。プロパティの可視性として，［サービス作成とサービス実行］または［サービス作成］を指定できます。出力プロパティの場合，可視性は固定されています。表示設定によって，［タスク詳細］画面に表示するかどうかを定義できます。

サービス作成とサービス実行

［サービス作成］画面および［サービス実行］画面の入力項目として表示したいプロパティに指定してください。指定すると，プロパティがSubmitロール以上のユーザーに公開されます。

サービス作成

［サービス作成］画面の入力項目として表示したいプロパティに指定してください。指定すると，プロパティがModifyロール以上のユーザーに公開されます。

プロパティの表示設定

サービスプロパティの表示設定を指定すると，［サービス作成］画面や［サービス実行］画面で，サービスプロパティを表示するかどうか，値を変更できるようにするかどうかを定義できます。

変更可能

サービスの入力プロパティの場合に，表示された画面上で，サービスプロパティの値を変更できる状態です。

変更不可

サービスの入力プロパティの場合に，表示された画面上で，サービスプロパティの値は変更できません。

表示

サービスの出力プロパティの場合に，表示された画面上で，サービスプロパティの値を参照できる状態です。

非表示

サービスプロパティは画面上に表示されない状態です。

可視性と表示設定の組み合わせによる，各画面上の表示/非表示および操作可否を次の表に示します。

表4‒5　［サービス作成］画面での表示可否

可視性

表示設定

画面上の表示/非表示および操作可否

作成画面と実行画面

変更可能

プロパティ値および表示設定の変更可

変更不可

プロパティ値および表示設定の変更可

非表示

プロパティ値および表示設定の変更可

作成画面のみ

変更可能

プロパティ値の変更可

変更不可

表示されるが変更不可

非表示

非表示

表4‒6　［サービス実行］画面での表示可否

可視性

表示設定

画面上の表示/非表示および操作可否

作成画面と実行画面

変更可能

プロパティ値の変更可

変更不可

表示されるが変更不可

非表示

非表示

作成画面のみ

変更可能

非表示

変更不可

非表示

非表示

非表示

表4‒7　［タスク詳細］画面での表示可否

可視性

サービスプロパティの入出力種別

表示設定

画面上の表示/非表示および操作可否

作成画面と実行画面※

入力プロパティ

変更可能

表示

変更不可

表示

非表示

非表示

出力プロパティ

表示

表示

非表示

非表示

作成画面のみ

入力プロパティ

変更可能

非表示

変更不可

非表示

非表示

非表示

注※

出力プロパティの場合，［Service Builder Edit］画面の［プロパティ］タブでの可視性は［タスク詳細］画面と表示されます。

表4‒8　［サービス共有プロパティ］エリアでのサービス共有プロパティの表示可否

可視性

表示設定

画面上の表示/非表示および操作可否

作成画面と実行画面

変更可能

プロパティ値の変更可

変更不可

プロパティ値の変更可

非表示

プロパティ値の変更可

作成画面のみ

変更可能

プロパティ値の変更可

変更不可

プロパティ値の変更可

非表示

プロパティ値の変更可

関連項目

4.3　サービス共有プロパティ

4.2.8　サービスプロパティを削除する手順

サービスの入力プロパティ，出力プロパティ，および変数を削除できます。ただし，この手順で削除できるのは関連ステップがないサービスプロパティだけです。

ステッププロパティから昇格したサービスプロパティを削除したい場合は，［Service Builder Edit］画面の［フロー］タブの［ステッププロパティ］エリアで，［サービスプロパティ］チェックボックスをオフにしてください。また，サービス部品に含まれるサービスプロパティは，削除できません。

サービスプロパティを削除するには：

［Service Builder Edit］画面の［プロパティ］タブのプロパティ一覧エリアで，削除したいサービスプロパティを選択して［削除］ボタンをクリックします。

操作結果

サービスプロパティが削除されます。

4.3　サービス共有プロパティ

サービスプロパティの種別であるサービス共有プロパティについて説明します。

4.3.1　サービス共有プロパティとは

サービス共有プロパティは，ほかのサービスと値を共有して参照したり，更新したりできるサービスプロパティです。サービスおよびタスクが参照するサービス共有プロパティの値は，システムで保持しているプロパティ値です。

また，サービス共有プロパティのうち，JP1/AOであらかじめ定義されているものをビルトインサービス共有プロパティと呼びます。

サービス共有プロパティに設定される値

サービス共有プロパティの値は，JP1/AOシステム内で1つです。そのため，サービスグループごとに異なる値は設定できません。サービステンプレートから複数のサービスを作成して，別々のサービスグループに割り当てた場合でも，サービスグループ間でサービス共有プロパティの値は共有されます。

サービステンプレート内で同じサービス共有プロパティが定義されたサービス部品を複数使用している場合でも，［サービス作成］画面または［サービス実行］画面上では1つのサービス共有プロパティとして表示されます。なお，このときのプロパティ名，説明，および表示設定には，［Service Builder Edit］画面の［プロパティ］タブの［プロパティ一覧］エリアで最上位に表示されているサービス共有プロパティの設定が適用されます。

サービス共有プロパティの値の有効範囲

プロパティの値は，［サービス作成］画面，［サービス実行］画面，および［管理］画面の［サービス共有プロパティ］エリアで設定することもできます。ただし，［サービス実行］画面で設定したプロパティの値は，そのサービスから生成されるタスクにだけ有効です。そのため，［サービス実行］画面で設定した内容は，ほかのサービスが参照しているサービス共有プロパティの値に影響しません。またサービスの実行後に，［サービス共有プロパティ］エリアなどで，プロパティ値を変更した場合でも，実行したサービスのプロパティ値には影響しません。

次の図にサービス共有プロパティを設定した場合の有効範囲を示します。

図4‒4　サービス共有プロパティを設定した場合の有効範囲

次の図にサービス共有プロパティを設定しない場合の有効範囲を示します。

図4‒5　サービス共有プロパティを設定しない場合の有効範囲

［スコープ］の［サービス共有プロパティ］をチェックしなかった場合，プロパティに指定した値は，対象のサービス内でだけ有効です。プロパティの値は，［サービス作成］画面および［サービス実行］画面で設定できます。

関連項目

4.3.4　ビルトインサービス共有プロパティとは

マニュアル『JP1/AO 運用ガイド』－「サービス共有プロパティの設定」のトピック

4.3.2　サービス共有プロパティを追加する手順

サービステンプレートのプロパティにサービス共有プロパティを追加すると，ほかのサービスとプロパティを共有できます。JP1/AOであらかじめ定義されているサービス共有プロパティ（ビルトインサービス共有プロパティ）や，すでにインポートされているサービステンプレートが持つサービス共有プロパティを追加することもできます。

新規のサービス共有プロパティを追加するには：

［Service Builder Edit］画面の［プロパティ］タブで，［入力プロパティの追加］ボタンをクリックします。

［サービスの入力プロパティ作成］ダイアログボックスの［スコープ］で［サービス共有プロパティ］をチェックします。

定義済みのサービスプロパティをサービス共有プロパティにするには：

［Service Builder Edit］画面の［プロパティ］タブで，サービスの入力プロパティの［編集］ボタンをクリックします。

［サービスの入力プロパティ編集］ダイアログボックスの［スコープ］で［サービス共有プロパティ］をチェックします。

ただし，次の場合，［サービス共有プロパティ］チェックボックスの指定は変更できません。

関連ステップがある場合

ビルトインサービス共有プロパティの場合

データ型に［composite］が選択されている場合

定義済みのサービス共有プロパティを追加するには：

［Service Builder Edit］画面の［プロパティ］タブで，［追加］－［サービス共有プロパティ］を選択します。

［サービス共有プロパティ選択］ダイアログボックスで，追加したいサービス共有プロパティと追加先のプロパティグループを選択し，［OK］ボタンをクリックします。

関連項目

4.3.1　サービス共有プロパティとは

4.3.3　サービス共有プロパティを定義する場合の注意事項

4.3.4　ビルトインサービス共有プロパティとは

4.3.3　サービス共有プロパティを定義する場合の注意事項

サービス共有プロパティを定義するときは次の点に注意してください。

サービス共有プロパティの値を設定する場合

プロパティ名および説明は，［Service Builder Edit］画面の［プロパティ］タブで定義された値が，［サービス作成］画面と［サービス実行］画面にそれぞれ反映されます。

プロパティキーは，システム内でユニークとなるように，ドメイン名をトップレベルドメイン名から逆順で「.」区切りで指定してください。また，プロパティキーにドメイン名を使用しない場合は，値を共有しないほかのプロパティとプロパティキーが重複しないようにしてください。

サービス共有プロパティのプロパティ名および説明以外の値を変更したい場合は，次の手順で変更してください。

1. 変更したいサービス共有プロパティを含むサービステンプレートを，JP1/AOからすべて削除します。

2. サービス共有プロパティの値を変更したサービステンプレートを，JP1/AOに追加します。

サービス共有プロパティの値が変更されます。

すでに登録されているサービス共有プロパティと，プロパティ名，説明，デフォルト値，表示設定が異なっても問題ありません。プロパティ名，説明，デフォルト値，表示設定以外の項目が異なると，ビルド，リリース，またはインポート時にエラーとなります。

最初にビルド，リリース，またはインポートしたサービステンプレートに定義されているサービス共有プロパティの［デフォルト値］に設定した値が，サービス共有プロパティに設定されます。その後は，［サービス共有プロパティ］エリア，［サービス作成］画面，［サービス実行］画面で値を指定できます。

すでに登録されているサービス共有プロパティと，プロパティ名，説明，デフォルト値が異なっても問題ありません。プロパティ名，説明，デフォルト値以外の項目が異なると，ビルド，リリース，またはインポート時にエラーとなります。

すでに登録されているサービス共有プロパティと値が異なる場合，サービステンプレートのプロパティとして，プロパティ名，説明を表示する場合に限り，指定した値が反映されます。

［サービス共有プロパティ選択］ダイアログボックスで選択したサービス共有プロパティは，デフォルト値が空の状態で追加されます。デフォルト値は，［サービスの入力プロパティ編集］ダイアログボックスで設定してください。

サービス共有プロパティにプロパティグループを設定する場合

サービス共有プロパティは，サービステンプレートごとに任意のプロパティグループに分類できます。複数のサービステンプレートで，同じプロパティグループに分類する必要はありません。

4.3.4　ビルトインサービス共有プロパティとは

ビルトインサービス共有プロパティには，JP1/AOシステムで使用する項目があらかじめ定義されています。ビルトインサービス共有プロパティはほかのプロパティと異なり，サービスやタスクとは関係しません。ビルトインサービス共有プロパティを参照するJP1/AOの各機能が動作するときに，設定されている値を使用します。

なお，ビルトインサービス共有プロパティはサービスのサービス共有プロパティとして定義して，タスク内で参照することもできます。その場合は，ほかのサービス共有プロパティと同様に，サービス実行時の値が参照されます。

ビルトインサービス共有プロパティをサービスのサービス共有プロパティとして定義する場合は［Service Builder Edit］画面の［プロパティ］タブで行います。［Service Builder Edit］画面の［プロパティ］タブで［追加］－［サービス共有プロパティ］を選択すると，ビルトインサービス共有プロパティの一覧が表示されます。

ビルトインサービス共有プロパティには次の種類があります。

表4‒9　ビルトインサービス共有プロパティ一覧

項番

プロパティキー

プロパティ名※

プロパティの説明※

1

com.hitachi.software.dna.sys.mail.notify

メール通知

メール通知機能のオン/オフの設定をします。［ビルトインサービス共有プロパテイ］

2

com.hitachi.software.dna.sys.mail.smtp.server

SMTPサーバのアドレス

SMTPサーバのアドレスを設定します。IPv4,IPv6,ホスト名で指定可能です。一つのみ指定可能です。「,」(カンマ)区切りで複数のアドレスを指定することは出来ません。［ビルトインサービス共有プロパテイ］

3

com.hitachi.software.dna.sys.mail.smtp.port

SMTPサーバのポート番号

SMTPサーバのポート番号を設定します。［ビルトインサービス共有プロパテイ］

4

com.hitachi.software.dna.sys.mail.smtp.userid

SMTPサーバのユーザーID

SMTPサーバにログインするユーザーのユーザーIDを設定します。［ビルトインサービス共有プロパテイ］

5

com.hitachi.software.dna.sys.mail.smtp.password

SMTPサーバのパスワード

SMTPサーバにログインするユーザーのパスワードを設定します。［ビルトインサービス共有プロパテイ］

6

com.hitachi.software.dna.sys.mail.from

通知メールの送信元

通知メールの送信元を設定します。［ビルトインサービス共有プロパテイ］

7

com.hitachi.software.dna.sys.mail.to

通知メールの送信先(TO)

通知メールの送信先(TO)を設定します。「,」(カンマ)で区切ることにより複数のメールアドレスを指定できます。［ビルトインサービス共有プロパテイ］

8

com.hitachi.software.dna.sys.mail.cc

通知メールの送信先(CC)

通知メールの送信先(CC)を設定します。「,」(カンマ)で区切ることにより複数のメールアドレスを指定できます。［ビルトインサービス共有プロパテイ］

9

com.hitachi.software.dna.sys.mail.bcc

通知メールの送信先(BCC)

通知メールの送信先(BCC)を設定します。「,」(カンマ)で区切ることにより複数のメールアドレスを指定できます。［ビルトインサービス共有プロパテイ］

10

com.hitachi.software.dna.sys.task.log.level

タスクのログ出力レベル

タスクのログ出力レベルを設定します。［ビルトインサービス共有プロパテイ］

11

com.hitachi.software.dna.sys.ssh.privatekey.passphrase

秘密鍵のパスフレーズ（SSH公開鍵認証用）

SSH公開鍵認証で使用する秘密鍵のパスフレーズを指定します。［ビルトインサービス共有プロパテイ］

注※

ビルトインサービス共有プロパティのプロパティ名および説明に任意の値を指定すると，［サービス作成］画面での表示内容を変更できます。ただし，［サービス共有プロパティ］エリアに表示される内容は，インストール時の内容から変更されません。

各プロパティの詳細な情報を次に示します。

表4‒10　ビルトインサービス共有プロパティの詳細情報

項番

プロパティキー

データ型

デフォルト値

必須区分

文字列長

指定できる文字

リスト選択値

最小

最大

1

com.hitachi.software.dna.sys.mail.notify

boolean

false

true

－

－

－

－

2

com.hitachi.software.dna.sys.mail.smtp.server

string

－

false

0

255

制限なし

－

3

com.hitachi.software.dna.sys.mail.smtp.port

integer

25

true

0

65535

－

－

4

com.hitachi.software.dna.sys.mail.smtp.userid

string

－

false

0

255

制限なし

－

5

com.hitachi.software.dna.sys.mail.smtp.password

password

－

false

0

1,024

制限なし

－

6

com.hitachi.software.dna.sys.mail.from

string

－

false

0

255

制限なし

－

7

com.hitachi.software.dna.sys.mail.to

string

－

false

0

255

制限なし

－

8

com.hitachi.software.dna.sys.mail.cc

string

－

false

0

255

制限なし

－

9

com.hitachi.software.dna.sys.mail.bcc

string

－

false

0

255

制限なし

－

10

com.hitachi.software.dna.sys.task.log.level

list

10

true

－

－

－

0,10,20,30,40

11

com.hitachi.software.dna.sys.ssh.privatekey.passphrase

password

－

false

0

1,024

制限なし

－

（凡例）

－：該当しません。

4.4　プロパティグループを設定する

サービスプロパティが所属するプロパティグループを，追加および編集できます。

4.4.1　プロパティグループを設定する手順

［Service Builder Edit］画面の［プロパティ］タブで，プロパティグループを追加および編集します。

［Service Builder Edit］画面の［プロパティ］タブで，プロパティグループを追加したい場合は［追加］－［プロパティグループ］を，編集したい場合はプロパティグループの行にある［編集］ボタンをクリックします。

表示されたダイアログボックスで，プロパティグループの定義情報を設定します。

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

設定できる項目は次のとおりです。

表4‒11　プロパティグループに設定する項目

項目

説明

関連ステップ

プロパティグループの関連ステップが表示されます。

プロパティグループID

プロパティグループのIDを入力します。

この項目は，プロパティグループの関連ステップがサービス部品を使用している場合，変更できません。

プロパティグループ名

プロパティグループの名称を入力します。

説明

プロパティグループの説明を入力します。

表示/非表示

次の画面で，プロパティグループを表示するかどうかを選択します。

［サービス作成］画面

［サービス実行］画面

［タスク詳細］画面

バリデーションスクリプト

プロパティのバリデーションスクリプトを指定します。

［新規作成］ボタンをクリックするとバリデーションスクリプトを入力するためのエディタが表示されます。

プロパティグループを編集する場合に，関連ステップがあるときはこの項目は変更できません。

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

操作結果

プロパティグループが設定されます。

4.4.2　プロパティグループを削除する手順

サービスプロパティが所属するプロパティグループを削除できます。削除されたプロパティグループに属していたサービスプロパティは，「デフォルトプロパティ」に所属が変更されます。

ヒント

「デフォルトプロパティ」のプロパティグループ，および関連ステップを持つプロパティグループは削除できません。

プロパティグループを削除するには：

［Service Builder Edit］画面の［プロパティ］タブで，削除したいプロパティグループの行にある［削除］ボタンをクリックします。

操作結果

プロパティグループが削除されます。

5　サービステンプレートを管理する

サービステンプレートに対して，編集のほかにできる操作を説明します。例えば，サービステンプレートを複製したり，サービステンプレートをリリースしたりできます。

5.1　サービステンプレートを参照する

開発サービステンプレートやリリースサービステンプレートの設定内容を参照します。

5.1.1　サービステンプレートを参照する手順

開発サービステンプレートまたはリリースサービステンプレートの設定内容を別の画面で参照しながら，サービステンプレートのフローを編集できます。参照用の画面は読み取り専用で開くため，既存のサービステンプレートを誤って編集しないようにできます。

なお，サービステンプレートは［Service Builder Home］画面，および［サービステンプレート］画面からも参照できます。［サービステンプレート］画面から参照できるのは，リリースサービステンプレートだけです。

サービステンプレートの参照画面を開くには：

［Service Builder Home］画面の［開発］タブまたは［リリース］タブで，参照したいサービステンプレートを選択し，［参照］ボタンをクリックします。

操作結果

［Service Builder View］画面が表示されます。

5.2　サービステンプレートを複製する

開発サービステンプレートまたはリリースサービステンプレートを複製します。

5.2.1　サービステンプレートを複製する手順

開発サービステンプレートまたはリリースサービステンプレートの設定内容はそのまま保ち，別の開発サービステンプレートとして複製します。既存のサービステンプレートを基に新たなサービステンプレートを開発する場合や，サービステンプレートのバージョンアップ版を作成する場合に利用できます。

重要

サービス部品を使用したステップを含むサービステンプレートを複製する場合，サービス部品の基となるリリースサービステンプレートがJP1/AOサーバにインポートされていることを確認してください。サービス部品の基となるリリースサービステンプレートがJP1/AOサーバに存在しない場合，複製しても，サービス部品に関する情報が取得できません。

サービステンプレートを複製するには：

［Service Builder Home］画面の［開発］タブまたは［リリース］タブで，複製したいサービステンプレートを選択し，［複製］ボタンをクリックします。

［サービステンプレート複製］ダイアログボックスで，サービステンプレートの定義情報を設定し，［OK］ボタンをクリックします。

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

操作結果

サービステンプレートが複製され，［Service Builder Edit］画面の［フロー］タブが表示されます。引き続き，フローの作成・編集や，サービスプロパティの設定をします。

ベンダーID，サービステンプレートID，サービステンプレートバージョンのうち，少なくとも1つは変更しないと，サービステンプレートを複製できません。サービステンプレートは，これら3つの項目の組み合わせによって一意性が保証されています。また，「com.hitachi.software.dna」で始まるベンダーIDはJP1/AOによって予約されているため指定できません。複製元のサービステンプレートのベンダーIDが「com.hitachi.software.dna」で始まる場合は，複製時に「ベンダーID」および「ベンダー名」が削除されます。

ヒント

リリースサービステンプレートは，［サービステンプレート］画面の［複製］ボタンからも複製できます。

サービステンプレート複製ダイアログボックスへの入力結果は，ブラウザロケールと同一のサービスリソースファイルに設定され，他ロケールのサービスリソースファイルは複製元の値がコピーされます。

関連項目

2.2.4　サービステンプレートの定義情報として設定する項目について

5.2.2　サービステンプレートおよび部品の一意性について

5.2.2　サービステンプレートおよび部品の一意性について

サービステンプレートおよび部品は，次の3つの項目の組み合わせによって一意性が保証されています。

ベンダーID

サービステンプレートID（部品ID）

サービステンプレートのバージョン（部品のバージョン）

この3つの項目は，開発サービステンプレート（開発部品）と，リリースサービステンプレート（リリース部品）を区別しないで，一元的に管理されています。このため，すでにあるリリースサービステンプレート（リリース部品）のベンダーID，サービステンプレートID（部品ID），およびサービステンプレートバージョン（部品バージョン）がすべて一致しているサービステンプレートおよび部品は，作成したり複製したりできません。

図5‒2　サービステンプレートのバージョン管理

5.3　開発サービステンプレートを削除する

開発サービステンプレートを削除します。

5.3.1　開発サービステンプレートを削除する手順

開発サービステンプレートを削除すると，サービステンプレートの定義がJP1/AOサーバから削除されて［開発サービステンプレート］の一覧からも削除されます。

重要

削除対象の開発サービステンプレートがほかのユーザーによって編集中でも，削除できます。対象のサービステンプレートがほかのユーザーによって編集中でないか確認してから削除してください。

サービステンプレートを削除するには：

［Service Builder Home］画面の［開発］タブで，削除したいサービステンプレートを選択します。

［その他の操作］プルダウンメニューで，［削除］ボタンをクリックします。

操作結果

開発サービステンプレートが削除されます。

ヒント

削除対象の開発サービステンプレートが使用している開発部品およびリリース部品については，ほかのサービステンプレートで使用されていても使用されていなくても，削除されません。不要になった開発部品およびリリース部品は，部品単位で削除してください。

削除対象の開発サービステンプレートをビルドして作成されたサービスや，そのサービスのタスクがある場合，サービスはすべて削除され，タスクはアーカイブされます。タスクが実行中である場合は削除に失敗します。また，削除対象の開発サービステンプレートをデバッグする際に作成されたデバッグサービスおよびデバッグタスクがある場合，すべて削除されます。デバッグタスクが実行中である場合は削除に失敗します。

削除対象の開発サービステンプレートがほかのユーザーによってすでにリリースされていた場合，削除に失敗します。

リリースサービステンプレートを削除したい場合，［サービステンプレート］画面から操作します。手順の詳細については，マニュアルJP1/AO 運用ガイド－「サービステンプレートを削除する手順」のトピックを参照してください。

関連項目

7.2.1　部品を削除する手順

1.2.4　［Service Builder］画面で割り込み操作があった場合の注意事項

マニュアル『JP1/AO 運用ガイド』－「サービステンプレートを削除する手順」のトピック

5.4　サービステンプレートをリリースする

サービステンプレートを開発し，検証が完了したら，サービステンプレートをリリースします。

5.4.1　リリースとは

リリースとは，検証が完了したサービステンプレートをほかのユーザーに公開する場合の操作です。リリースに成功すると，サービステンプレートがパッケージングされ，サービスとして作成できる状態になります。

なお，一度リリースしたサービステンプレートおよびサービステンプレートに含まれる部品は，編集できなくなります。リリース後に編集したい場合は，サービステンプレートまたは部品を複製してください。

目的

サービステンプレートを本番環境に適用する場合にリリースを行います。リリースしたサービステンプレートは，リリース構成のサービステンプレートとしてパッケージングされたあと，JP1/AOサーバにインポートされます。

実行できる回数

リリースは1回だけ実行できます。リリースすると，リリース前の開発サービステンプレートは削除されます。リリース前に開発サービステンプレートから作成したサービスは削除され，タスクはアーカイブされます。また，デバッグサービスおよびデバッグタスクは削除されます。

リリース時のサービステンプレート，サービス，タスク，デバッグサービス，デバッグタスクの削除およびアーカイブ範囲の詳細は，「付録A.1(5)　ビルドまたはリリースする場合のサービステンプレート，サービス，タスクの削除・アーカイブ範囲」を参照してください。

設定される構成種別

リリース後のサービステンプレートには「リリース構成」が設定されます。リリース構成のサービステンプレートおよび作成されたサービスやタスクは，AdminまたはDevelopロールだけでなく，ModifyまたはSubmitロールが設定されているユーザーでも，設定および実行ができます。また，サービステンプレートをリリースすると，サービステンプレートおよびサービステンプレートに含まれる部品は編集できなくなります。編集したい場合は，別のサービステンプレートまたは部品として複製する必要があります。リリースで設定されるサービステンプレートおよび部品の構成種別については，「付録A.1(2)　デバッグおよびリリースによって設定されるサービステンプレートおよび部品の構成種別」を参照してください。

サービステンプレートの出力先

リリースによって作成されたサービステンプレートパッケージは，「ベンダーID_名称_バージョン.st」のファイル名で，次のフォルダに作成されます。

リリース後のサービステンプレートをエクスポートすることで，任意のフォルダに保存することもできます。

Windowsの非クラスタシステムの場合

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

Linuxの非クラスタシステムの場合

/var/opt/jp1ao/develop/output

Windowsのクラスタシステムの場合

共有フォルダ名¥develop¥output

Linuxのクラスタシステムの場合

共有フォルダ名/develop/output

関連項目

5.4.2　サービステンプレートをリリースする手順

2.1　開発サービステンプレートおよびリリースサービステンプレートとは

5.2.1　サービステンプレートを複製する手順

(1)　デバッグおよびリリースの仕組みと違い

(2)　デバッグおよびリリースによって設定されるサービステンプレートおよび部品の構成種別

(5)　ビルドまたはリリースする場合のサービステンプレート，サービス，タスクの削除・アーカイブ範囲

5.4.2　サービステンプレートをリリースする手順

サービステンプレートを選択し，リリースすることで，サービステンプレートのパッケージが作成され，JP1/AOサーバにインポートされます。サービステンプレートの開発環境と本番環境が同じ場合は，サービスを作成できる状態になります。

重要

サービステンプレートを一度リリースすると，再編集できなくなります。リリースしたサービステンプレートは，複製することで編集できるようになります。

サービステンプレートにサービス部品を使用したステップを配置している場合，サービス部品の基となるリリースサービステンプレートがJP1/AOサーバにインポートされていることを確認してください。リリースサービステンプレートが削除されているか，インポートされていないと，リリースに失敗します。

サービステンプレートをリリースするには：

［Service Builder Home］画面の［開発］タブで，リリースしたいサービステンプレートを選択し，［編集］ボタンをクリックします。

［Service Builder Edit］画面で，［リリース］ボタンをクリックします。

図5‒3　［Service Builder Edit］画面

確認画面で［OK］ボタンをクリックします。

［ビルド/リリース結果］ダイアログボックスで結果を確認し，［閉じる］ボタンをクリックします。

操作結果

サービステンプレートがリリースされます。リリースサービステンプレートは，［サービステンプレート］画面に表示されます。

対象のサービステンプレートがほかのユーザーによって，すでにリリースされていた場合や削除されていた場合はエラーとなり，リリースに失敗します。

リリース時にエラーが発生した場合は，エラー原因とフローの修正を促すメッセージが通知され，［Service Builder Edit］画面右上に［エラー］ボタンが表示されます。メッセージを閉じたあとも，［エラー］ボタンをクリックすればメッセージを参照できます。このボタンは，［Service Builder Edit］画面を閉じるまで表示されます。

関連項目

5.4.1　リリースとは

(5)　ビルドまたはリリースする場合のサービステンプレート，サービス，タスクの削除・アーカイブ範囲

5.5　サービステンプレートをエクスポートする

開発環境で作成したサービステンプレートを本番環境にインポートしたい場合，まずサービステンプレートパッケージを任意のフォルダにエクスポートします。

5.5.1　サービステンプレートをエクスポートする手順

ビルドまたはリリースしたサービステンプレートをエクスポートすると，任意のフォルダにサービステンプレートパッケージを保存できます。ここでは，開発サービステンプレートをエクスポートする手順を説明します。

開発サービステンプレートをエクスポートするには：

［Service Builder Home］画面の［開発］タブで，エクスポートしたいサービステンプレートを選択します。

［その他の操作］プルダウンメニューで，［エクスポート］をクリックします。

任意のフォルダを指定し，［保存］ボタンをクリックします。

操作結果

任意のフォルダにサービステンプレートパッケージが保存されます。

ヒント

リリースサービステンプレートの場合，［サービステンプレート］画面の［その他の操作］プルダウンメニューで［エクスポート］を選択します。サービステンプレートパッケージは，Webブラウザーで設定されているフォルダに保存されます。

関連項目

5.6　サービステンプレートをインポートする

5.6　サービステンプレートをインポートする

開発したサービステンプレートをほかの環境に移動したい場合，移動先の環境にサービステンプレートファイルをインポートします。

5.6.1　サービステンプレートをインポートする手順

開発したサービステンプレートをほかの環境に移動したい場合，エクスポートしたサービステンプレートファイルを移動先の環境にインポートする必要があります。

重要

［Service Builder Home］画面または［サービステンプレート］画面からインポートする場合，ファイルサイズは100MB以内にしてください。

ヒント

サービステンプレートの開発環境と本番環境は別にすることを推奨します。開発環境と本番環境が別の場合，開発環境で作成したサービステンプレートを本番環境にインポートして使用します。

開発環境と本番環境が別である場合は，事前に開発環境でサービステンプレートの動作を確認することをお勧めします。開発環境での動作確認が完了したら，本番環境にサービステンプレートパッケージをコピーして，サービステンプレートをインポートします。

サービステンプレートをインポートするには：

［Service Builder Home］画面の［開発］タブで，［インポート］ボタンをクリックします。

［サービステンプレートインポート］ダイアログボックスで，［選択］ボタンをクリックします。

任意のサービステンプレートファイルを選択し，［インポート］ボタンをクリックします。

操作結果

任意のサービステンプレートがJP1/AOにインポートされます。

関連項目

5.6.2　サービス部品を使用したステップを含むサービステンプレートのインポートについて

5.5　サービステンプレートをエクスポートする

5.6.3　サービステンプレートの開発環境と本番環境を別にすることを推奨する理由

5.6.2　サービス部品を使用したステップを含むサービステンプレートのインポートについて

インポートするサービステンプレートにサービス部品を使用したステップが含まれている場合，そのサービス部品の基となるリリースサービステンプレートもインポートされます。

サービステンプレートは，階層の深い順にインポートされます。このとき，どれかのサービステンプレートのインポートに失敗すると，インポートエラーとなり，処理は中断されます。ただし，中断した時点ですでにインポートされていたサービステンプレートは，インポート済みの状態になります。

サービステンプレートのインポートの途中で，サービス部品の基となるリリースサービステンプレートのインポートに失敗したときの動作について，次の図に示します。

図5‒4　サービス部品の基となるリリースサービステンプレートのインポートに失敗したときの動作

図では，サービス部品Bの基となるサービステンプレートBのインポートに失敗しています。このとき，サービステンプレートBより先にインポートされていたサービステンプレートCはインポート済みの状態になります。インポートに失敗したサービステンプレートB，およびそのあとにインポートされるはずだったサービステンプレートAは，インポートされません。

5.6.3　サービステンプレートの開発環境と本番環境を別にすることを推奨する理由

本番環境とは別に，サービステンプレートを開発する環境を構築すると，本番用と開発用で，サービス共有プロパティを使い分けられます。

サービステンプレートの開発環境と本番環境が同じである場合

サービス共有プロパティの値は，JP1/AOシステム内で1つです。サービス共有プロパティを変更した場合，開発サービステンプレートだけでなく，リリースサービステンプレートにも影響します。

サービステンプレートの開発環境と本番環境が別の場合

サービス共有プロパティの値は，本番用と開発用で別々に管理されます。サービス共有プロパティを変更した場合，開発サービステンプレートのサービス共有プロパティだけが変更されます。リリースサービステンプレートのサービス共有プロパティには影響しません。

このように，リリースサービステンプレートのサービス共有プロパティに変更が影響しないようにするため，サービステンプレートの開発環境と本番環境を別にすることを推奨しています。

6　部品を作成・編集する

部品の作成・編集について説明します。JP1/AOが提供する部品をそのまま使用するほか，部品を作成・編集することで，ユーザー独自の処理を定義できます。

6.1　部品とは

部品とは，実行する処理を定義したものです。

JP1/AOで扱う部品は基本部品，リリース部品，開発部品の3つに分類できます。［Service Builder Edit］画面の［フロー］タブの［コンポーネント］エリアでは，基本部品とリリース部品が［リリース］タブに，開発部品が［開発］タブに表示されます。

また，便宜的に，これらの部品は提供元によって「基本部品」と「コンテンツ部品」に分類されています。詳細はマニュアルJP1/AO サービステンプレートリファレンスの「サービステンプレートと部品の種類」のトピックを参照してください。

ヒント

［Service Builder Edit］画面の［フロー］タブの［コンポーネント］エリアには［サービス］タブもあり，サービス部品が表示されます。サービス部品とは，［フロー］エリアにステップとして配置できるリリースサービステンプレートのことです。そのため，サービス部品は，マニュアルで説明する「部品」には含まれません。

表6‒1　部品の種類

種別

説明

基本部品

［リリース］タブに表示されます。

JP1/AOが提供する部品です。メールの通知やフローの繰り返し処理など，汎用的な処理が定義されています。

コンテンツ部品

リリース部品

［リリース］タブに表示されます。

ユーザーが作成したサービステンプレートをリリースすることで，JP1/AOにインポートされた部品です。

JP1/AOが提供するサービステンプレートに含まれている部品です。

JP1/AOサーバにインポートされた部品のうち，構成種別が「リリース」の部品もリリース部品として扱われます。

開発部品

［開発］タブに表示されます。

ユーザーが新規作成し，リリースする前の部品です。または，既存の部品を複製し，作成している途中の部品です。

開発部品は，開発部品を含む開発サービステンプレートをビルドすることでJP1/AOサーバにインポートされ，テスト用として実行できる状態になります。

JP1/AOサーバにインポートされた部品のうち，構成種別が「デバッグ」の部品も開発部品として扱われます。

部品では，例えば次のことができます。

メールの通知やフローの繰り返し処理をする

JP1/AOサーバと任意のリモートホストとの間でファイルやフォルダを転送する

任意のリモートホストに接続してコマンドやスクリプトを実行する

また，JP1/AOでは，コンテンツ部品として，ユーザー独自の部品を作成できます。任意のリモートホストに接続してコマンドやスクリプトを実行する部品を作成して，サービステンプレートに組み込むことができます。

コンテンツ部品を実行する場合，操作対象の機器のOSがWindowsの場合はWMIを，UNIXの場合はSSHを使用して操作対象の機器に接続します。なお，基本部品については，マニュアルJP1/AO サービステンプレートリファレンスの基本部品についてのトピックを参照してください。

関連項目

6.1.1　部品の種別と実施できる操作

6.1.2　部品の実行ユーザー

6.1.3　操作対象の機器に転送されるファイル（Windowsの場合）

6.1.4　操作対象の機器に転送されるファイル（UNIXの場合）

6.1.5　部品実行時に必要なOSのコマンドについて

6.1.6　部品実行時に設定される操作対象の機器のロケールについて

6.1.7　部品実行時にJP1/AOが通信で使用する文字セットについて

6.1.8　部品実行時に特定の文字セットを設定したい場合

(2)　デバッグおよびリリースによって設定されるサービステンプレートおよび部品の構成種別

6.1.1　部品の種別と実施できる操作

部品の種別によって，実施できる操作が異なります。

表6‒2　部品の種別と実施できる操作一覧

種別

部品の操作可否

一覧表示

作成

編集

削除

複製

基本部品

○

×

×

×

×

開発部品

○

○

○

○ ※1

○

リリース部品

○

× ※2

×

○ ※1※3

○

（凡例）

○：操作できます。 ×：操作できません。

注※1

開発サービステンプレートに使用されている場合は削除できません。

削除対象の部品をステップで使用している開発サービステンプレートがビルド済みの場合は，削除できません。この場合，開発サービステンプレートから，削除対象の部品を使用しているステップを削除したあとで，ビルドを再実行してください。ビルドしたあとに，部品を削除できるようになります。

注※2

開発部品を含む開発サービステンプレートをリリースすると，その開発部品はリリース部品になります。

注※3

リリースサービステンプレートに使用されている場合は削除できません。

6.1.2　部品の実行ユーザー

部品の実行ユーザーは，ローカル実行機能の設定と，操作対象の機器の組み合わせによって決まります。

ローカル実行機能が無効の場合

ローカル実行機能が無効の場合，部品の実行ユーザーは次のようになります。

操作対象の機器のOSがWindowsの場合

基本的には，操作対象の機器に接続したユーザーが，コマンドまたはスクリプトの実行ユーザーになります。ただし，操作対象の機器に接続したあと，コマンドまたはスクリプトをSystemアカウントの権限で実行することもできます。

操作対象の機器のOSがWindowsの場合，ユーザーのプロファイルは引き継がれません。そのため，部品の実行結果と，デスクトップ上で実行したコマンドまたはスクリプトの実行結果は異なることがあります。

よって，部品を実行する際に，ユーザーのプロファイルは参照させないでください。ユーザーのプロファイルとは，ユーザー環境変数，レジストリ，Internet Explorerの設定などです。これらを参照させた場合，コマンドまたはスクリプトが期待する動作をしないことがあります。例えば，Internet Explorerのプロキシの設定を参照するコマンドまたはスクリプトを実行すると，通信エラーで失敗することがあります。これには，Windows Updateをスクリプトで実行する場合などが該当します。

操作対象の機器のOSがUNIXの場合

基本的には，操作対象の機器に接続したユーザーが，コマンドまたはスクリプトの実行ユーザーになります。ただし，操作対象の機器に接続したあと，コマンドまたはスクリプトの実行ユーザーをroot権限に昇格することもできます。

なお，root権限のユーザーで操作対象の機器に接続する場合は，操作対象の機器側でroot権限のユーザーによる接続を許可しておく必要があります。

部品の実行ユーザーの一覧を次に示します。

表6‒3　部品の実行ユーザー一覧

部品

root権限のユーザーへの昇格※1

操作対象の機器に接続したユーザー

コマンドまたはスクリプトの実行ユーザー※2

基本部品（汎用コマンド実行部品，ファイル転送部品およびターミナル接続部品）

コンテンツ部品

設定している

root権限のユーザー

root権限のユーザー

root権限ではないユーザー

root権限のユーザー

設定していない

root権限のユーザー

root権限のユーザー

root権限ではないユーザー

root権限ではないユーザー

注※1　root権限のユーザーに昇格するための方法は，部品ごとに異なります。

汎用コマンド実行部品およびファイル転送部品の場合

部品プロパティで，root権限のユーザーに昇格するかどうかを指定します。root権限のユーザーに昇格する方法の詳細については，マニュアルJP1/AO サービステンプレートリファレンスの基本部品についてのトピックを参照してください。

ターミナル接続部品の場合

ターミナル接続部品では，root権限のユーザーに昇格するかどうかは設定できません。ターミナルコマンド実行部品で，ユーザーの権限をroot権限に昇格するコマンドを実行してください。root権限のユーザーに昇格する方法の詳細については，マニュアルJP1/AO サービステンプレートリファレンスの基本部品についてのトピックを参照してください。

コンテンツ部品の場合

［部品作成］ダイアログボックスまたは［部品編集］ダイアログボックスの［リモートコマンド］タブから［root権限で実行］チェックボックスで実行するユーザーの権限を指定できます。［root権限で実行］チェックボックスをチェックした場合，root権限のユーザーでコマンドまたはスクリプトが実行されます。［root権限で実行］チェックボックスをチェックしなかった場合，操作対象の機器に接続したユーザーの権限でコマンドまたはスクリプトが実行されます。

ヒント

［root権限で実行］チェックボックスをチェックした場合，［部品作成］ダイアログボックスまたは［部品編集］ダイアログボックスの［リモートコマンド］タブから指定した認証種別によって，スーパーユーザーのパスワードを指定する方法が異なります。

部品の認証種別に［エージェントレス接続先設定を使用］を指定した場合

エージェントレス接続先定義で指定したスーパーユーザーのパスワードが使用されます。

部品の認証種別に［プロパティで指定］を指定した場合

部品のプロパティ「plugin.suPassword」でスーパーユーザーのパスワードを指定します。

注※2　ファイル転送部品の場合，ファイルを転送するユーザーです。また，ターミナル接続部品の場合，実際にコマンドを実行するのはターミナルコマンド実行部品です。

ローカル実行機能が有効の場合

ローカル実行機能が有効の場合，操作対象の機器がローカルホストのときの部品の実行ユーザーは次のようになります。

ローカルホストのOSがWindowsの場合

Systemアカウントの権限でコマンドまたはスクリプトが実行されます。

ローカルホストのOSがUNIXの場合

rootユーザーの権限でコマンドまたはスクリプトが実行されます。

なお，操作対象の機器がローカルホスト以外の場合の実行ユーザーは，ローカル実行機能が無効の場合と同様です。

6.1.3　操作対象の機器に転送されるファイル（Windowsの場合）

操作対象の機器のOSがWindowsの場合に，汎用コマンド実行部品，ファイル転送部品，またはコンテンツ部品を使用するときは，次のファイルが操作対象の機器に転送されます。なお，次のファイルは部品の実行が終了する際に削除されます。

図6‒1　操作対象の機器に転送されるファイル（Windowsの場合）

転送対象ファイルは，次の条件のどちらかの場合に転送されます。

ファイル転送部品を使用した場合

コンテンツ部品で，スクリプトを設定して実行した場合

ただし，ローカル実行機能が有効な場合で，操作対象がローカルホストのときは，ファイルは転送されないで，ローカルホストにコピーされます。

6.1.4　操作対象の機器に転送されるファイル（UNIXの場合）

操作対象の機器のOSがUNIXの場合に，ファイル転送部品，またはコンテンツ部品を使用するときは，次のファイルが操作対象の機器に転送されます。なお，次のファイルは部品の実行が終了する際に削除されます。

図6‒2　操作対象の機器に転送されるファイル（UNIXの場合）

転送対象ファイルは，次のどちらかの場合に転送されます。

ファイル転送部品を使用した場合

コンテンツ部品で，スクリプトを設定して実行した場合

ただし，ローカル実行機能が有効な場合で，操作対象がローカルホストのときは，ファイルは転送されないで，ローカルホストにコピーされます。

なお，作業用フォルダは，ユーザー設定プロパティファイル（config_user.properties）のキー「plugin.remoteCommand.workDirectory.ssh」で設定できます。デフォルトは「/tmp/Hitachi_AO」です。

関連項目

マニュアル『JP1/AO 構築ガイド』－「ユーザー設定プロパティファイル（config_user.properties）」のトピック

6.1.5　部品実行時に必要なOSのコマンドについて

部品を実行する際に，操作対象機器のOSに，あらかじめインストールされている必要のあるコマンドがあります。詳細はリリースノートを参照してください。

6.1.6　部品実行時に設定される操作対象の機器のロケールについて

部品実行時に適用される操作対象の機器のロケールは，OSによって異なります。部品実行時に適用されるロケールを，操作対象の機器のOSごとに示します。

Windowsの場合

操作対象の機器でスクリプトやコマンドを実行する際は，JP1/AOサーバと操作対象の機器のロケールと文字セットを統一してください。ロケールと文字セットには，Windowsの［コントロールパネル］で設定されている日時の形式，ユーザー単位の表示言語，システム全体の表示言語，およびシステムのロケールの設定が適用されます。

JP1/AOが通信で使用する文字セットについては「6.1.7　部品実行時にJP1/AOが通信で使用する文字セットについて」を参照してください。

UNIXの場合

［部品作成］ダイアログボックスまたは［部品編集］ダイアログボックスの［リモートコマンド］タブから，［文字セット自動判定］の設定によって，部品実行時に適用されるロケールが異なります。

［文字セット自動判定］で［有効］のチェックを外している場合

「LC_ALL=C」のロケールでスクリプトが実行されます。また，コマンドおよびコマンドのパラメータの内容はすべてASCII文字で指定してください。コマンドのパラメータ，標準出力，および標準エラー出力の内容にASCII文字以外が含まれると文字化けしたり，正しくコマンド実行されないおそれがあります。

［文字セット自動判定］で［有効］にチェックをしている場合

接続ユーザーのデフォルトのロケールを参照して，それを基にスクリプトが実行されます。

スクリプトやコマンドの実行時，操作対象の機器の環境変数「LC_ALL」および「LANG」は，共に接続ユーザーのデフォルトのロケールに設定が変更されます。ただし，「LC_ALL」以外の環境変数「LC_XXXXX」の設定は変更されません。

スクリプトやコマンドの実行時のロケールは，次の優先順位に従って参照されます。

表6‒4　部品実行時に参照されるロケールの優先順位

優先順位

環境変数

1

LC_ALLの設定値

2

LC_CTYPEの設定値

3

LANGの設定値

部品実行時のスクリプトやコマンドの文字セットがこのように設定された文字セットと異なる場合は，文字化けするおそれがあります。なお，コマンドやコマンドのパラメータで使用できる文字セットは，OSによって異なります。使用できる文字セットについては「6.1.7　部品実行時にJP1/AOが通信で使用する文字セットについて」を参照してください。

6.1.7　部品実行時にJP1/AOが通信で使用する文字セットについて

部品実行時に設定されるJP1/AOが通信で使用する文字セットは，操作対象の機器のOS によって異なります。

JP1/AOサーバが出力するタスクログや公開ログは，UTF-8で出力されます。そのため，操作対象の機器と互換性のない文字セットから取得した文字や機種依存文字，およびUnicode依存文字は，ログ出力の際に文字化けするおそれがあります。

部品実行時に設定される文字セットを，操作対象の機器のOSごとに示します。

Windowsの場合

操作対象の機器でスクリプトやコマンドを実行する際は，JP1/AOサーバと操作対象の機器のロケールと文字セットを統一してください。ロケールと文字セットは，Windowsの［コントロールパネル］で設定できます。

UNIXの場合

操作対象の機器でスクリプトやコマンドを実行する際，JP1/AOサーバが通信で使用できる文字セットは，locale charmapコマンドを実行して取得した次の文字セットだけです。なお，locale charmapコマンドで取得した文字について，大文字と小文字は区別されません。

EUC-JP

eucjp

ibm-943C

ISO-8859-1

MS932

PCK

Shift_JIS

UTF-8

windows-31j

なお，これらを除く文字セットを取得した場合は，「UTF-8」に設定されます。ただし，locale charmapコマンドの実行結果が「IBM-943」の場合，部品実行時にJP1/AOが通信で使用する文字セットは「ibm-943C」になります。

JP1/AOが使用する文字セットを確認する場合は，SSHクライアントまたはsshコマンドを使用して接続ユーザーでログインしてから，locale charmapコマンドを実行してください。接続ユーザーのログイン時の文字セットを変更する場合は，ログインスクリプトなどで環境変数が設定されるようにしてください。環境変数「LC_ALL」または「LANG」を設定することで，ログイン時の文字セットを変更できます。

また，特定の文字セットを設定したい場合は「6.1.8　部品実行時に特定の文字セットを設定したい場合」を参照してください。

なお，ローカル実行機能が有効の場合，文字セットはSystemアカウントまたはrootユーザーのデフォルト設定に従います。ただし，次の処理は行われません。

locale charmapコマンドによる文字セットの自動判定

文字セットマッピングファイルによる文字セットの設定

接続先プロパティファイルによる文字セットの設定

6.1.8　部品実行時に特定の文字セットを設定したい場合

操作対象の機器のOSがUNIXの場合に，JP1/AOサーバが通信で使用する文字セットを設定したいときは，文字セットマッピングファイル，または接続先プロパティファイルのterminal.charsetキーで設定してください。

文字セットマッピングファイル，および接続先プロパティファイルのterminal.charsetキーで文字セットを指定した場合，次の優先順位に従って設定されます。

表6‒5　部品実行時に設定される文字セットの優先順位

優先順位

設定値

1

接続先プロパティファイルのterminal.charsetキーで指定された文字セット

2

文字セットマッピングファイルで指定された文字セット

3

操作対象の機器でlocale charmapコマンドを実行して取得した文字セット

4

UTF-8

関連項目

マニュアル『JP1/AO 構築ガイド』－「接続先プロパティファイル（接続先名.properties）」，「文字セットマッピングファイル（charsetMapping_user.properties）」のトピック

6.2　部品の定義情報を作成・編集する

部品を作成，編集，または複製した場合，定義情報を設定します。

6.2.1　部品を作成する手順

ユーザー独自の部品を新規作成できます。

部品を作成するには：

［Service Builder Home］画面で［部品の操作］プルダウンメニューから［作成］をクリックします。

［部品作成］ダイアログボックスで部品の定義情報を設定し，［保存］ボタンをクリックします。

図6‒3　［部品作成］ダイアログボックス

ヒント

サービステンプレートの編集中に部品を作成したい場合，［Service Builder Edit］画面の［フロー］タブの［開発］タブから［作成］ボタンをクリックすることでも，部品を作成できます。

操作結果

部品が作成されます。

関連項目

6.2.3　部品の定義情報として設定する項目について

6.2.2　部品の定義情報を編集する手順

開発部品の定義を編集できます。リリース部品を編集したい場合，一度開発部品として複製してください。

部品の定義情報を編集するには：

［Service Builder Home］画面で［部品の操作］プルダウンメニューから［編集］をクリックします。

［部品一覧］から，編集したい部品を選択し，［編集］ボタンをクリックします。

［部品編集］ダイアログボックスで部品の定義情報を設定し，［保存］ボタンをクリックします。

図6‒4　［部品編集］ダイアログボックス

操作結果

部品の定義情報が設定されます。

重要

フロー内にステップとして配置したあとに部品のプロパティを編集した場合は，ステッププロパティの設定が適切かどうか確認してください。部品のプロパティと，ステッププロパティの設定に不整合が生じている場合は，ビルドまたはリリース時にエラーとなります。

ヒント

サービステンプレートの編集中に部品を編集したい場合，［Service Builder Edit］画面の［フロー］タブの［開発］タブから［編集］ボタンをクリックすることでも，部品を編集できます。

関連項目

6.2.3　部品の定義情報として設定する項目について

6.2.3　部品の定義情報として設定する項目について

部品の作成・編集・複製時に設定できる項目を，各タブごとに次に示します。

表6‒6　部品の定義情報として設定する項目（［定義情報］タブ）

項目

説明

［部品ID］※1

部品を識別するIDを指定します。

［部品バージョン］※1

部品のバージョン番号を指定します。

「aa.bb.cc」の形式で指定します。

［ベンダーID］※1

部品を作成したベンダーを識別するIDを指定します。

ベンダーIDは，ユニークとなるようにドメイン名をトップレベルドメイン名から逆順で「.」（ピリオド）区切りで指定してください。例えば「com.xxxx」や「jp.co.yyyy」のように指定してください。また，ベンダーIDにドメイン名を使用しない場合は，ほかのベンダーIDと値が重複しないようにしてください。

ただし，「com.hitachi.software.dna」で始まるベンダーIDは指定できません。

［部品名］

部品の名称を指定します。

［ベンダー名］※2

部品を作成したベンダーの名称を指定します。

［説明］

部品の説明を指定します。

［タグ］

部品に定義するタグを指定します。タグは複数指定できます。タグは，その部品に設定するすべてのタグ名の文字と，タグとタグとの間に挿入されるコンマの数の合計が256文字以内で指定できます。

［アイコン］

部品に設定されているアイコンが表示されます。［標準に戻す］ボタンをクリックすると，部品に設定したアイコンがデフォルトに戻ります。［変更］ボタンをクリックすると，アップロードするアイコンファイルを選択するダイアログボックスが表示され，アイコンを変更できます。アイコンにはpng形式で，サイズが縦48ピクセル，横48ピクセルのファイルを設定してください。

注※1

［部品ID］，［部品バージョン］，［ベンダーID］は部品の作成または複製後に変更できません。

注※2

指定を省略した場合，［ベンダーID］に指定した値が［ベンダー名］に設定されます。なお，［Service Builder Edit］画面の［フロー］タブ上に表示される開発部品の［ベンダー名］については，空白のままです。

表6‒7　部品の定義情報として設定する項目（［プロパティ］タブ）

項目

説明

参照先

入力プロパティ※

部品の実行に必要な入力値を格納するためのプロパティを定義できます。

6.3　部品プロパティを設定する

出力プロパティ※

部品の実行結果を格納するためのプロパティを定義できます。

注※

1つの部品に対して，入力プロパティおよび出力プロパティは，合計100個まで定義できます。

ヒント

入力プロパティまたは出力プロパティのアイコンをクリックすると，表示されるプロパティをフィルタすることができます。

表6‒8　部品の定義情報として設定する項目（［リモートコマンド］タブ）

項目

説明

［認証種別］

部品の認証種別を次から選択します。

［エージェントレス接続先設定を使用］

サービス実行時に，［エージェントレス接続先定義］エリアに設定されている認証情報を使用する場合に選択してください。

［プロパティで指定］

認証情報を入力プロパティで指定する場合に選択してください。

［Windows接続用設定］

［システムアカウントで実行］をチェックすると，接続先ホストで実行するコマンドまたはスクリプトがSystemアカウントの権限で実行されます。

［Linux/UNIX接続用設定］

［root権限で実行］

接続先ホストで実行するコマンドまたはスクリプトの実行ユーザーを，root権限で実行する場合にチェックボックスをオンにします。

［文字セット自動判定］

文字セット自動判定を有効にする場合にチェックボックスをオンにします。

［プラットフォーム］

操作対象ホストで実行するコマンドまたはスクリプトを設定します。プラットフォームはOSごとに設定します。

設定する項目の詳細については，「6.4　プラットフォームを編集する」のトピックを参照してください。

関連項目

6.2.4　コンポーネントのアイコンとして設定できる画像ファイルについて

6.2.5　部品の認証種別とは

6.2.4　コンポーネントのアイコンとして設定できる画像ファイルについて

［Service Builder］画面の［フロー］タブに表示されるアイコンは，コンポーネントごとに任意の画像を設定できます。

部品アイコンは部品の作成時または編集時に設定します。サービス部品の場合は，サービステンプレートの定義情報として設定したサービステンプレートアイコンがコンポーネントのアイコンとして使用されます。なお，アイコンを設定しなかった場合は，標準の部品アイコンまたはサービステンプレートアイコンが設定されます。

図6‒5　標準の部品アイコン

図6‒6　標準のサービステンプレートアイコン

アイコンとして設定できる画像ファイルの条件を次に示します。条件と一致しないファイルが指定されるとファイル登録時にエラーとなります。

ファイル形式

PNG形式

画像サイズ

縦48ピクセル，横48ピクセル

アイコンとして登録した画像のファイル名は，「icon.png」に変更されます。

なお，任意の画像ファイルを登録したあとでも，ファイルを選択することで再登録できます。この場合，既存の登録ファイルは削除され，再登録したファイルで置き換えられます。

6.2.5　部品の認証種別とは

［部品作成］ダイアログボックスまたは［部品編集］ダイアログボックスの［認証種別］で選択した内容に従って，次のプロパティが自動的に設定されます。

［認証種別］で［エージェントレス接続先設定を使用］を選択

plugin.destinationHost

［認証種別］で［プロパティで指定］を選択

plugin.destinationHost

plugin.account

plugin.password

plugin.suPassword

plugin.publicKeyAuthentication

plugin.keyboardInteractiveAuthentication

関連項目

6.3.6　実行ホストまたは認証情報を指定するための予約部品プロパティ

6.3　部品プロパティを設定する

部品の定義情報を作成したら，部品の入力プロパティおよび出力プロパティを設定します。

6.3.1　部品プロパティとは

部品のプロパティを定義することで，部品の実行に必要なパラメータを指定したり，部品の実行結果を取得したりできます。部品プロパティには次の種類があります。

入力プロパティ

リモートコマンドを実行する際のコマンドの引数や，操作対象ホストなど，部品の実行に必要な入力値を格納するためのプロパティを定義できます。

出力プロパティ

リモートコマンドの実行結果（標準出力や標準エラー出力）など，部品の実行結果を格納するためのプロパティを定義できます。

部品のプロパティは，定義した部品内でだけ有効です。

部品の入力プロパティに格納できる値の最大値は，composite型のサービスプロパティがマッピングされていない場合は1,024文字，composite型のサービスプロパティがマッピングされている場合は30MBです。最大値を超える値を指定した場合，最大値を超える部分の値が切り捨てられます。

また，部品のプロパティのうち，プロパティキーと用途があらかじめ決まっているプロパティを「予約部品プロパティ」と呼びます。予約部品プロパティは，リモートコマンドの実行ホストまたは認証情報を指定するために，部品プロパティとして定義する必要があります。

関連項目

6.3.2　部品プロパティを追加する手順

6.3.3　部品プロパティを編集する手順

6.3.6　実行ホストまたは認証情報を指定するための予約部品プロパティ

6.3.2　部品プロパティを追加する手順

部品の作成または編集時に，部品プロパティを追加できます。

部品プロパティを追加するには：

［Service Builder Home］画面で，部品の作成または編集の操作をします。

表示されたダイアログボックスで，［プロパティ］タブを選択し，［追加］プルダウンメニューから［入力プロパティ］または［出力プロパティ］ボタンをクリックします。

表示されたダイアログボックスで，部品プロパティの定義情報を入力します。

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

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

操作結果

部品プロパティが追加されます。

関連項目

6.3.4　部品の入力プロパティに設定する項目について

6.3.5　部品の出力プロパティに設定する項目について

6.3.1　部品プロパティとは

6.2.1　部品を作成する手順

6.2.2　部品の定義情報を編集する手順

6.3.3　部品プロパティを編集する手順

部品の編集時に，部品プロパティを編集できます。

部品プロパティを編集するには：

［Service Builder Home］画面で，部品の編集の操作をします。

表示されたダイアログボックスで，［プロパティ］タブから，編集したいプロパティの行を選択して，［編集］ボタンをクリックします。

表示されたダイアログボックスで，部品プロパティの定義情報を編集します。

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

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

操作結果

部品プロパティの定義情報が設定されます。

関連項目

6.3.4　部品の入力プロパティに設定する項目について

6.3.5　部品の出力プロパティに設定する項目について

6.3.1　部品プロパティとは

6.2.2　部品の定義情報を編集する手順

6.3.4　部品の入力プロパティに設定する項目について

［部品の入力プロパティ作成］ダイアログボックスまたは［部品の入力プロパティ編集］ダイアログボックスでは，次に示す項目を設定できます。

表6‒9　部品の入力プロパティの定義情報として設定する項目

項目

説明

［プロパティキー］

プロパティキーを指定します。この項目は，予約部品プロパティを選択した場合，変更できません。

［プロパティ名］

プロパティ名を指定します。

［説明］

プロパティの説明を指定します。

［必須区分］

［必須］をチェックすると，入力が必須のプロパティになります。この項目は，予約部品プロパティ「plugin.destinationHost」，「plugin.publicKeyAuthentication」，または「plugin.keyboardInteractiveAuthentication」を選択した場合，変更できません。

［デフォルト値］

プロパティのデフォルト値を指定します。

6.3.5　部品の出力プロパティに設定する項目について

［部品の出力プロパティ作成］ダイアログボックスまたは［部品の出力プロパティ編集］ダイアログボックスでは，次に示す項目を設定できます。

表6‒10　部品の出力プロパティの定義情報として設定する項目

項目

説明

［プロパティキー］

プロパティキーを指定します。

［プロパティ名］

プロパティ名を指定します。

［説明］

プロパティの説明を指定します。

6.3.6　実行ホストまたは認証情報を指定するための予約部品プロパティ

予約部品プロパティとは，プロパティキーと用途があらかじめ決まっている部品プロパティのことです。

予約部品プロパティの名称は「plugin.」で始まります。予約部品プロパティは，次のダイアログボックスの［入力プロパティ一覧］に自動作成されます。

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

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

予約部品プロパティは，定義した部品内でだけ有効です。

予約部品プロパティは編集できますが，プロパティキー，必須区分など，一部の項目は変更できません。また，予約部品プロパティは削除できません。

実行ホストを指定するための予約部品プロパティ

部品の実行ホストを指定するために，次の予約部品プロパティが自動作成されます。

表6‒11　実行ホストを指定する予約部品プロパティ

プロパティキー

説明

plugin.destinationHost

操作対象ホストを，IPv4アドレス，IPv6アドレス，またはホスト名で指定します。サーバおよびコマンド実行環境が相互に直接参照できるネットワーク構成にある，対象ホストを指定する必要があります。ただし，JP1/AOサーバのOSがLinuxで，かつ操作対象の機器のOSがWindowsの場合は，接続先にIPv6アドレスを指定できません。

1～256文字で指定します。

認証情報を指定するための予約部品プロパティ

部品の認証種別として［部品作成］または［部品編集］ダイアログボックスの［リモートコマンド］タブで，［認証種別］から［エージェントレス接続先設定を使用］または［プロパティで指定］を選択します。

［エージェントレス接続先設定を使用］

［エージェントレス接続先定義］エリアに設定されている認証情報を使用する場合に選択します。選択すると，操作対象ホストに応じて，Windows，SSHまたはTelnetのエージェントレス接続先定義に設定済みの認証情報が適用されます。

［プロパティで指定］

プロパティに指定した認証情報を使用する場合に選択します。

［プロパティで指定］を指定した場合，［部品作成］ダイアログボックスまたは［部品編集］ダイアログボックスの入力プロパティ一覧に，次の表に示す予約部品プロパティが自動作成されます。なお，ローカル実行機能が有効の場合で，実行ホストがローカルホストのときは，これらの設定内容は無視されます。

表6‒12　認証情報を指定する予約部品プロパティ

プロパティキー

説明

plugin.account

対象ホストにログインする際に使用するユーザーIDを1～256文字で指定します。

plugin.password

対象ホストにログインする際に使用するパスワードを1～256文字で指定します。

予約部品プロパティ「plugin.publicKeyAuthentication」に「true」を指定した場合，「plugin.password」に入力した値は無視されます。

plugin.suPassword

UNIX環境の対象ホストにログインする際に使用するrootのパスワードを1～256文字で指定します。

次の場合，rootのパスワードを指定しても無視されます。

対象ホストがWindows環境の場合

［部品作成］ダイアログボックスまたは［部品編集］ダイアログボックスの［root権限で実行］をチェックしていない場合

plugin.publicKeyAuthentication

UNIX環境の対象ホストとのSSH接続に公開鍵認証を使用するかどうかを指定します。このプロパティに値を指定しない場合は，「false」として扱われます。

true

公開鍵認証を使用する場合に指定してください。

false

公開鍵認証を使用しない場合に指定してください。※

plugin.keyboardInteractiveAuthentication

UNIX環境の対象ホストとのSSH接続にキーボードインタラクティブ認証を使用するかどうかを指定します。このプロパティに値を指定しない場合は，「false」として扱われます。

ただし，「plugin.keyboardInteractiveAuthentication」の値が有効になるのは，「plugin.publicKeyAuthentication」に「false」を指定した場合です。「plugin.publicKeyAuthentication」に「true」を指定した場合は，「plugin.keyboardInteractiveAuthentication」に「true」を指定しても，公開鍵認証が設定されます。

true

キーボードインタラクティブ認証を使用する場合に指定してください。

false

キーボードインタラクティブ認証を使用しない場合に指定してください。※

注※

プロパティ「plugin.publicKeyAuthentication」および「plugin.keyboardInteractiveAuthentication」の両方に「false」を指定した場合，パスワード認証が設定されます。

6.3.7　部品プロパティを削除する手順

部品の編集時に，部品プロパティを削除できます。

ヒント

予約部品プロパティは削除できません。

部品プロパティを削除するには：

［Service Builder Home］画面で，部品の編集の操作をします。

表示されたダイアログボックスで，［プロパティ］タブから，削除したいプロパティの行を選択して，削除（ごみ箱）アイコンをクリックします。

操作結果

部品プロパティが削除されます。

関連項目

6.2.2　部品の定義情報を編集する手順

6.3.6　実行ホストまたは認証情報を指定するための予約部品プロパティ

6.4　プラットフォームを編集する

部品が操作対象ホストで実行するコマンドまたはスクリプトを設定します。

6.4.1　プラットフォームを編集する手順

部品にプラットフォームを設定します。プラットフォームはOSごとに設定できます。

プラットフォームを編集するには：

［Service Builder Home］画面で，部品の作成または編集の操作をします。

表示されたダイアログボックスで，［リモートコマンド］タブをクリックし，［プラットフォーム］内の項目を編集します。

図6‒9　［プラットフォーム］（実行モードで［スクリプト］を選択した場合）

［保存］ボタンをクリックします。

操作結果

操作対象ホストのOSで実行するプラットフォームが設定されます。

関連項目

6.4.2　プラットフォームに設定する項目について

6.2.1　部品を作成する手順

6.2.2　部品の定義情報を編集する手順

6.4.2　プラットフォームに設定する項目について

［プラットフォーム］では，リモートコマンドが実行されるOS を［プラットフォームを追加］プルダウンメニューから選択します。

［定義情報の取り込み］プルダウンメニューでほかのOSを選択すると，選択したOSを対象としたリモートコマンドの定義情報が取り込まれます。選択できるOSは次のとおりです。

Windows

AIX

HP-UX

Linux

Solaris

なお，添付ファイルは取り込まれないため，定義情報の取り込み後に，指定したOSの添付ファイルをアップロードする必要があります。

選択したOSのタブで設定できる項目を次の表に示します。

表6‒13　選択したOSのタブでの設定項目

項目

説明

［実行モード］

リモートコマンドの実行モードを選択します。

［スクリプト］

ユーザーが作成したスクリプトを設定したい場合に選択してください。

［コマンド］

操作対象の機器に格納されているコマンドを設定したい場合に選択してください。

［コマンドライン］

実行するコマンドラインを入力します。［入力プロパティ挿入］ボタンをクリックすると，その部品に定義されているすべての入力プロパティが表示されます。コマンドラインに挿入するプロパティを選択して［OK］ボタンをクリックすると「△"?dna_プロパティキー?" 」（△は半角スペース）の形式で入力されます。プロパティキー横のチェックボックスで複数のプロパティを選択できます。

［スクリプト設定］

［実行モード］ラジオボタンで［スクリプト］を選択した場合に，スクリプトの設定方法を選択します。

［添付］

スクリプトを添付する場合に設定します。

［直接入力］

スクリプトを直接入力する場合に選択します。

［ファイル］

［スクリプト設定］ラジオボタンで［添付］を選択した場合に，添付されたファイルの名称が表示されます。［選択］ボタンをクリックすると，添付するスクリプトファイルを選択するダイアログボックスが表示されます。

［ファイル名］

［スクリプト設定］ラジオボタンで［直接入力］を選択した場合に，［スクリプト］テキストボックスに入力したスクリプトのファイル名を入力します。［スクリプト］テキストボックスに入力したスクリプトは，この項目で設定したファイル名でアップロードされます。

［スクリプト］

［スクリプト設定］ラジオボタンで［直接入力］を選択した場合に，操作対象の機器で実行したいスクリプトを入力します。

［出力プロパティのマッピング定義一覧］

出力プロパティのマッピング定義一覧が表示されます。コマンドまたはスクリプトの標準出力および標準エラー出力の一部を出力プロパティに格納したい場合，格納したいプロパティの行の鉛筆アイコンをクリックすると，出力フィルタを編集できます。

［詳細設定］

［実行ディレクトリ］

設定したコマンドやスクリプトを実行する対象の機器のディレクトリを入力します。

［環境変数］

コマンドまたはスクリプト実行時に必要な環境変数の一覧が表示されます。環境変数は，追加，編集または削除できます。

関連項目

6.4.3　コマンドを設定する手順

6.4.4　スクリプトの設定方法について

6.4.12　標準出力および標準エラー出力を出力プロパティにマッピングする手順

6.4.14　［実行ディレクトリ］の指定方法について

6.4.15　環境変数を追加・編集する手順

6.4.3　コマンドを設定する手順

操作対象ホストのOS（Windows，AIX，HP-UX，LinuxまたはSolaris）に応じて，実行するコマンドを設定します。複数のOSに対応した部品を作成する場合は，OSごとに設定します。

コマンドに設定できるのは，操作対象の機器にあり，その機器で実行できるスクリプトまたはコマンドです。

なお，部品として実行するコマンドの戻り値に使用できる値は，0～63の範囲です。

部品の標準出力および標準エラー出力が，100KB未満となるように部品およびサービステンプレートを設計する必要があります。部品の標準出力および標準エラー出力が100KBを超えると，その時点でコマンドが強制終了され，部品はエラーで終了します。このときのコマンドの実行結果は保証されません。

重要

ユーザーに入力を求める対話式コマンドおよびスクリプト，GUI表示などにより自動的に終了しないコマンドは実行できません。

コマンドを設定するには：

［部品作成］ダイアログボックスまたは［部品編集］ダイアログボックスの［リモートコマンド］タブをクリックします。

［プラットフォーム］の［実行モード］で［コマンド］を選択します。

［コマンドライン］を指定し，［保存］ボタンをクリックします。

図6‒10　［プラットフォーム］（実行モードで［コマンド］を選択した場合）

関連項目

6.4.7　［コマンドライン］テキストボックスの指定方法について

6.4.8　コマンドまたはスクリプトの戻り値をフローの分岐条件に使用する手順（戻り値が0～63の範囲外の場合）

6.4.4　スクリプトの設定方法について

操作対象の機器のOSに対応した部品を作成するために，スクリプトはOSごとに設定します。スクリプトに定義できるのは，操作対象の機器にあり，その機器で実行できるスクリプトまたはコマンドです。

スクリプトのファイルは，いったん登録したあとでも登録し直すことができます。ファイルを登録し直すと，既存のファイルは上書きされます。

スクリプトの設定方法による差異

スクリプトの設定方法には，作成済みのスクリプトを添付する方法と，スクリプトを直接入力する方法の2種類があります。それぞれの差異を次に示します。

［添付］を選択

zip形式にすることで，複数ファイルや複数フォルダで構成されるスクリプトファイルを登録できます。

ただし，拡張子がzipの圧縮ファイルは，部品をJP1/AOサーバに保存するときにファイル名が変更されます。ファイル名は，OSごとに「windows.zip」，「aix.zip」，「hpux.zip」，「linux.zip」または「solaris.zip」に変更されます。［添付］を選択して登録したファイルは，JP1/AOをWebブラウザーで操作する端末にダウンロードできます。スクリプトを直接入力した場合は，定義したスクリプトファイルをダウンロードできません。

［直接入力］を選択

操作対象の機器で実行するスクリプトの内容を［リモートコマンド編集］ダイアログボックスで直接入力します。スクリプトに定義できるのは，操作対象の機器にあり，その機器で実行できるスクリプトまたはコマンドです。この場合，定義できるスクリプトファイルは1ファイルだけです。保存されるスクリプトの文字セットや改行コードは，操作対象の機器のOSに従って固定となります。

そのため，複数ファイルで構成されるスクリプトファイルを登録したい場合や，任意の文字セットや改行コードを設定したい場合は，［添付］を選択してください。

［スクリプト設定］での設定内容による，ファイルの登録方法，設定される文字セットおよび改行コードの差異を次の表に示します。

表6‒14　スクリプトの設定方法による差異

項目

［添付］を選択

［直接入力］を選択

Windows

AIX，HP-UX，Linux，Solaris

Windows

AIX，HP-UX，Linux，Solaris

単一ファイルの登録

登録できる

登録できる

複数ファイルの登録

登録できる

登録できない

保存されるスクリプトの文字セット

登録ファイルの文字セットが設定される

JP1/AOサーバのOSのデフォルトの文字セット

UTF-8

保存されるスクリプトの改行コード

登録ファイルの改行コードが設定される

CR+LF

LF

スクリプトファイル作成時の注意

スクリプトファイルを作成するときは，次の点に注意してください。

スクリプトファイルにはASCII文字を使用してください。次の文字は使用できません。

制御文字（'¥u0000'～'¥u001F' または'¥u007F'～'¥u009F'）

「?」「*」「"」「>」「<」「|」「:」

ファイルパスおよびファイル名にマルチバイト文字を使用できません。

部品として実行するスクリプトの戻り値に使用できる値は，0～63の範囲です。

部品の標準出力および標準エラー出力が，100KB未満となるように部品およびサービステンプレートを設計する必要があります。部品の標準出力および標準エラー出力が100KBを超えると，その時点でスクリプトが強制終了され，部品はエラーで終了します。このときのスクリプトの実行結果は保証されません。

スクリプト実行時のロケールは，操作対象の機器のOSごとに異なります。操作対象の機器に設定されるロケールについては，「6.1.6　部品実行時に設定される操作対象の機器のロケールについて」を参照してください。

ユーザーに入力を求める対話式コマンドおよびスクリプト，GUI表示などにより自動的に終了しないコマンドは実行できません。

ヒント

コマンドおよびスクリプトを実行する際の戻り値の設定については，「6.4.9　コンテンツ部品の戻り値について」を参照してください。

関連項目

6.4.5　スクリプトを設定する手順（作成済みのスクリプトを添付する場合）

6.4.6　スクリプトを設定する手順（スクリプトを直接入力する場合）

6.4.8　コマンドまたはスクリプトの戻り値をフローの分岐条件に使用する手順（戻り値が0～63の範囲外の場合）

6.4.10　実行したコマンドまたはスクリプトの戻り値，部品の戻り値，ステップの戻り値の関係について

6.4.5　スクリプトを設定する手順（作成済みのスクリプトを添付する場合）

操作対象ホストで実行するスクリプトを添付ファイルで設定します。

作成済みのスクリプトを添付するには：

［部品作成］ダイアログボックスまたは［部品編集］ダイアログボックスの［リモートコマンド］タブをクリックします。

［プラットフォーム］の［実行モード］で［スクリプト］を選択します。

［コマンドライン］テキストボックスに，スクリプトを実行するためのコマンドを入力します。

登録できるスクリプトファイルは1つですが，zip形式のファイルに圧縮することで複数のファイルやフォルダ階層で構成されるスクリプトも登録できます。［コマンドライン］テキストボックスに入力するスクリプトのパスは，単一ファイルの場合，ファイル名を指定します。複数ファイルをzip形式にしたファイルの場合，ファイルを展開したパスをカレントとして，そこからの相対パスとなるように指定します。

図6‒11　［プラットフォーム］（スクリプト設定で［添付］を選択した場合）

［スクリプト設定］で［添付］を選択します。

［ファイル］で［選択］をクリックし，スクリプトを登録します。

操作結果

スクリプトファイルが設定されます。

関連項目

6.4.4　スクリプトの設定方法について

6.4.7　［コマンドライン］テキストボックスの指定方法について

6.4.6　スクリプトを設定する手順（スクリプトを直接入力する場合）

操作対象ホストで実行するスクリプトを直接入力して設定します。

スクリプトを直接入力する方法

［部品作成］ダイアログボックスまたは［部品編集］ダイアログボックスの［リモートコマンド］タブをクリックします。

［プラットフォーム］の［実行モード］で［スクリプト］を選択します。

［コマンドライン］テキストボックスに，スクリプトを実行するためのコマンドを入力します。

［スクリプト設定］で［直接入力］を選択します。

［ファイル名］および［スクリプト］を設定します。

［ファイル名］には，［スクリプト］に記入するコードのファイル名を記入します。［スクリプト］には，スクリプトのコードを記入します。

図6‒12　［プラットフォーム］（スクリプト設定で［直接入力］を選択した場合）

操作結果

スクリプトファイルが設定されます。

関連項目

6.4.4　スクリプトの設定方法について

6.4.7　［コマンドライン］テキストボックスの指定方法について

6.4.7　［コマンドライン］テキストボックスの指定方法について

［実行モード］の指定によって，［コマンドライン］テキストボックスの指定方法が異なります。また，入力プロパティの値を，実行するコマンドの引数として指定することもできます。

［コマンドライン］テキストボックスには，制御文字（¥u0000～¥u001Fおよび¥u007F～¥u009F）以外の文字が指定できます。ただし，JP1/AOでは［コマンドライン］テキストボックスに入力されたコマンドの妥当性をチェックしません。動作確認が完了したコマンドを入力してください。

また，［コマンドライン］テキストボックスに環境変数を表す特殊文字などが含まれる場合でも，エスケープされません。ただし，部品の入力プロパティの値がコマンドラインに渡される場合，［プラットフォーム］の選択によって，マッピングされた部品の入力プロパティの値に含まれる次の文字は自動的にエスケープされます。

Windowsの場合：「%」

UNIXの場合：「$」，「`」，「¥」，「"」

入力プロパティをコマンドラインの引数としてマッピングする場合は，コマンドの引数の値を「"?dna_部品プロパティのプロパティキー?"」のように，「"」で囲んでください。ただし，PowerShellスクリプトを実行する場合に限り，「"」または「'」で囲むことができます。

なお，［プラットフォーム］がWindowsの場合，部品の入力プロパティの値に「"」が含まれる場合は，部品実行時にエラーになります。

［実行モード］に［スクリプト］を指定した場合

操作対象の機器で実行するスクリプトを作成し，［コマンドライン］テキストボックスには，実行したいスクリプトを呼び出すコマンドを記述してください。スクリプトのファイルパスには，単一ファイルの場合，ファイル名を指定します。複数ファイルをzip形式にしたファイルの場合，ファイルを展開したパスをカレントとして，そこからの相対パスとなるように指定します。

スクリプトは，［実行ディレクトリ］で指定したフォルダ配下の一時フォルダにコピーされて実行されます。

なお，［プラットフォーム］がAIX，HP-UX，Linux，またはSolarisの場合，実行時にコマンドラインの前に「./」が指定されて実行されます。そのため，コマンドラインに「./」を指定する必要はありません。コマンドラインに「./」が指定されている場合は，「././」のあとにスクリプトファイルが指定されますが，問題ありません。コマンドラインに環境変数を表す特殊文字などが含まれる場合でも，エスケープされません。

次に，［実行モード］で［スクリプト］を指定している場合の［コマンドライン］テキストボックスの指定方法を示します。

［コマンドライン］テキストボックスの指定例

cmd.exe /q /c "AAA.bat bbb ccc"

スクリプトのファイル（AAA.bat）の内容の例

［プラットフォーム］がWindowsの場合，コマンドはバッチファイル化され操作対象の機器で実行されます。そのため，対象のコマンドをコマンドプロンプトで実行した結果と異なることがあります。

［実行モード］に［コマンド］を指定した場合

［コマンドライン］テキストボックスには，操作対象の機器で実行するコマンドを直接記述してください。なお，スクリプトの作成は不要です。

次に，［実行モード］で［コマンド］を指定している場合の［コマンドライン］テキストボックスの指定方法を示します。

［コマンドライン］テキストボックスの指定例

zzz.exe aaa bbb

入力プロパティの値を，実行するコマンドの引数として指定したい場合

入力プロパティの値を，実行するコマンドの引数として指定したい場合は，［コマンドライン］テキストボックスに「?dna_部品プロパティのプロパティキー?」を指定します。

［コマンドライン］テキストボックスの指定例

scriptA.sh -xx ?dna_input01? -yy ?dna_input02?

この指定例の場合，「?dna_input01?」の部分に部品プロパティ「input01」の値が代入され，「?dna_input02?」の部分に部品プロパティ「input02」の値が代入されます。

OS標準のスクリプト以外を実行する場合

操作対象機器のOSがWindowsの場合はcmd.exe経由で，UNIXの場合はユーザーのログインシェル経由で，スクリプトが実行されます。OS標準のスクリプト以外を起動したい場合は，対象となる実行ファイルの起動に必要な命令を定義します。

次に，PowerShellスクリプトをコマンドプロンプトで起動し，vCenterへの接続を試行する場合の例を示します。

［コマンドライン］テキストボックスの指定例

powershell -executionPolicy RemoteSigned -command ".¥vsphereConnectChallenge.ps1 '?dna_vCenterServerName?' '?dna_userName?' '?dna_password?' '?dna_portNumber?' '?dna_protocol?'; exit $LASTEXITCODE" 2>&1

PowerShellでは，デフォルトの状態でスクリプトを実行できません。「powershell -executionPolicy RemoteSigned」と指定することで，JP1/AOの操作対象機器に対して，ローカルのPowerShellスクリプトを実行できるようになります。

「?dna_プロパティキー?」はプロパティ値を代入するための変数です。「?dna_プロパティキー?」は「"」または「'」で囲んでください。※

これによって，代入されるプロパティ値に空の値がある場合でも，［コマンドライン］テキストボックスに指定したプロパティが引き渡されます。

注※　PowerShellでは，「"」でプロパティを囲むと，後続のプロパティ値が繰り上がって入力されます。「'」で囲むと，プロパティ値が空でも，後続のプロパティ値が繰り上がらないで，空のプロパティとして認識されます。繰り上がりを避けることで，定義したとおりの引数の内容や順番でスクリプトを実行できます。

関連項目

6.4.9　コンテンツ部品の戻り値について

6.4.10　実行したコマンドまたはスクリプトの戻り値，部品の戻り値，ステップの戻り値の関係について

6.4.11　部品の標準出力について

6.4.14　［実行ディレクトリ］の指定方法について

6.4.8　コマンドまたはスクリプトの戻り値をフローの分岐条件に使用する手順（戻り値が0～63の範囲外の場合）

部品として実行するコマンドまたはスクリプトが，0～63の範囲外の戻り値を返す場合に，その戻り値をフローの分岐条件に使用したいときは，次の手順を実施してください。

コマンドまたはスクリプトの戻り値をフローの分岐条件に使用するには：

部品の作成または編集時に，［プラットフォーム］の［実行モード］で［スクリプト］を指定します。

実行するコマンドの戻り値を標準出力として出力するように，スクリプトを作成します。

［出力フィルタ編集］ダイアログボックスで，標準出力から，コマンドまたはスクリプトの戻り値を部品の出力プロパティに設定するように指定します。

出力プロパティマッピングで，手順3の部品の出力プロパティの値をサービスプロパティ（変数）に代入するように設定します。

基本部品の値判定分岐部品を使用して，手順4のサービスプロパティ（変数）を判定するように設定します。

操作結果

戻り値がフローの分岐条件として設定されます。

関連項目

6.4.10　実行したコマンドまたはスクリプトの戻り値，部品の戻り値，ステップの戻り値の関係について

マニュアル『JP1/AO サービステンプレートリファレンス』－「値判定分岐部品」のトピッ ク

6.4.9　コンテンツ部品の戻り値について

コンテンツ部品の戻り値を次に示します。

表6‒15　コンテンツ部品の戻り値

部品の戻り値

説明

0～63※

戻り値の意味は，コンテンツ部品ごとに異なる。

64

コンテンツ部品で実行したコマンドが，戻り値0～63以外で終了した。

65

JP1/AOサーバとの接続に失敗した。例えば，部品実行中にJP1/AOサーバが停止された場合が該当する。

66

次のユーザーがJP1ユーザーにマッピングされている。

Administratorsグループに所属しないユーザー

Administratorsグループに所属するビルトインAdministrator以外で，UACが有効であるユーザー

68

対象のジョブ実行IDに関する情報がない。

70

リモートホストへの接続に失敗した。

71

次のどれかの理由に該当した。

コマンド実行の呼び出しに失敗した。

実行ディレクトリへの移動に失敗した。

環境変数の設定に失敗した。

72

次のどれかの理由に該当した。

コマンド実行の状態取得に失敗した。

標準出力および標準エラー出力の合計が100KBを超えた。

73

転送に失敗した。

74

ファイル削除に失敗した。

76

接続がタイムアウトした。

77

リモートホストのホスト名の名前解決に失敗した。

78

次のどれかの理由で，リモートホストとの認証に失敗した。

パスワード認証に失敗した。

操作対象の機器に公開鍵認証機能が設定されていない。

公開鍵認証で，秘密鍵とパスフレーズが一致していない。

公開鍵認証で，秘密鍵と操作対象の機器に登録されている公開鍵が対になっていない。

公開鍵認証で，不正な秘密鍵が使用されている。

キーボードインタラクティブ認証に失敗した。

80

タスクの実行を停止した。

81

部品が不正な状態で呼び出された。

83

JP1/AOサーバの環境が壊れている。

84

指定された部品の情報が取得できない。

86

指定したプロパティ値に誤りがある。

127

そのほかのエラーが発生した。

注※

［Service Builder Home］画面で作成した部品の場合，実行するコマンドまたはスクリプトの戻り値と同じです。JP1/AOが提供しているコンテンツ部品の場合，戻り値の意味はマニュアルJP1/AO サービステンプレートリファレンスの各コンテンツ部品のトピックを参照してください。

関連項目

6.4.10　実行したコマンドまたはスクリプトの戻り値，部品の戻り値，ステップの戻り値の関係について

6.4.10　実行したコマンドまたはスクリプトの戻り値，部品の戻り値，ステップの戻り値の関係について

コマンドまたはスクリプトの戻り値は，基本的にはそのまま部品の戻り値として使用されます。例えば，エージェントレス接続を行って接続先ホスト上でコマンドを実行する部品（コンテンツ部品および汎用コマンド実行部品）が接続先ホストでコマンドまたはスクリプトを実行した場合，コマンドまたはスクリプトの戻り値が，そのまま部品の戻り値になります。ただし，ターミナルコマンド実行部品は，コマンドまたはスクリプトの戻り値を部品の戻り値として設定しないため対象外となります。

コマンドまたはスクリプトの戻り値として使用できる値は，0～63の範囲です。戻り値が0～63の範囲外である場合は，範囲外の値である旨を示す「64」が部品の戻り値になります。また，コマンドまたはスクリプトが実行できなかった場合，その要因に応じて，65以上の値が戻り値になります。

部品の戻り値は，基本的にはそのままステップの戻り値として使用されます。ただし，部品の実行時に障害が発生した場合などは，部品の戻り値とステップの戻り値が異なることがあります。この場合は，ステップの戻り値の情報を基に，必要な対処を実施してください。

関連項目

6.4.8　コマンドまたはスクリプトの戻り値をフローの分岐条件に使用する手順（戻り値が0～63の範囲外の場合）

6.4.11　部品の標準出力について

［コマンドライン］テキストボックスに指定したコマンドまたはスクリプトの，標準出力および標準エラー出力がそのまま部品の標準出力となります。

ただし，部品の標準出力は100KB未満になるように，部品およびサービステンプレートを設計する必要があります。部品の標準出力が100KBを超えると，その時点でコマンドが強制終了され，部品はエラー終了となります。このときのコマンドの実行結果は保証されません。

なお，指定したサイズにはJP1/AOが使用する容量も含まれます。そのため，実際の標準出力および標準エラー出力より余裕を持たせて，部品の標準出力の量を見積もっておく必要があります。

部品の標準出力のサイズ（操作対象機器のOSがUNIXの場合）

改行コード(LF)の数×バイト

操作対象機器のOSがUNIXの場合，標準出力および標準エラー出力の中の改行文字「CR(0x0d)」が「LF(0x0a)」に変わります。また，標準出力および標準エラー出力の最後の文字が改行文字(CR/LF/CR+LF)以外のときに，標準出力および標準エラー出力の末尾に「LF(0x0a)」が付加されます。

「LF(0x0a)」→「LF(0x0a)」

「CR(0x0d)」→「LF(0x0a)」

「CR+LF(0x0d0a)」→「LF+LF(0x0a0a)」

関連項目

6.4.12　標準出力および標準エラー出力を出力プロパティにマッピングする手順

6.4.12　標準出力および標準エラー出力を出力プロパティにマッピングする手順

コマンドまたはスクリプトの標準出力および標準エラー出力を出力プロパティにマッピングします。

デフォルトでは，出力プロパティのマッピング定義一覧に表示されるプロパティの出力フィルタは空欄です。そのため，コマンドまたはスクリプトの標準出力および標準エラー出力が，すべて出力プロパティに格納される設定になっています。標準出力および標準エラー出力の値を切り出して出力プロパティにマッピングしたい場合は，［出力フィルタ編集］ダイアログボックスで正規表現を設定します。

標準出力および標準エラー出力を出力プロパティにマッピングするには：

［部品作成］ダイアログボックスまたは［部品編集］ダイアログボックスの［リモートコマンド］タブをクリックします。

出力プロパティのマッピング定義一覧でプロパティを選択し，鉛筆アイコンをクリックします。

出力プロパティのマッピング定義一覧に表示される出力プロパティは，部品プロパティの設定時に登録した出力プロパティだけです。

［出力フィルタ編集］ダイアログボックスの出力フィルタを，PCREに従った正規表現で入力し，［OK］ボタンをクリックします。

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

ヒント

出力フィルタのテキストボックスに直接入力して編集することもできます。

設定した出力フィルタを検証したい場合は，［出力フィルタのテスト］－［テストデータ］のテキストボックスにテスト用の標準出力および標準エラー出力を入力すると，［出力フィルタの実行結果］に実行結果が表示されます。

操作結果

出力フィルタで切り出された値が［出力プロパティの値］に表示されます。

関連項目

6.4.13　［出力フィルタ］の指定方法について

6.4.13　［出力フィルタ］の指定方法について

コマンドまたはスクリプトの標準出力を出力プロパティに格納できます。

［出力フィルタ］にPCREに従った正規表現を定義することで，コマンドまたはスクリプトの標準出力および標準エラー出力から任意の文字列を切り出して，部品の出力プロパティに格納できます。

重要

正規表現に複数のグループを指定した場合，最初のグループに該当する範囲だけが部品の出力プロパティに格納されます。

正規表現に複数の範囲が該当する場合，最初に該当する範囲だけが部品の出力プロパティに格納されます。複数の範囲を格納することはできません。

次に，コマンドまたはスクリプトの標準出力を出力プロパティに格納する場合の指定例を示します。

［プロパティキー］：output01

［出力フィルタ］：DATE=(.*)

この指定例の場合，出力プロパティ「output01」に，標準出力の「DATE=」以降の値が格納されます。

また，出力プロパティに戻り値を格納したい場合は，次のとおり部品を定義しスクリプトを作成してください。

［プラットフォーム］の［実行モード］に［スクリプト］を指定してください。

スクリプトは，実行したコマンドまたはスクリプトの戻り値を，出力フィルタに指定した正規表現で切り出せる形式で標準出力に表示するように作成してください。

6.4.14　［実行ディレクトリ］の指定方法について

スクリプトまたはコマンドを実行するフォルダの絶対パスを指定します。実行ディレクトリには，JP1/AOサーバのOSと操作対象の機器のOSの両方のコマンドに入力できる文字を指定してください。

実行ディレクトリのパスに空白が含まれる場合でも「"」や「'」で囲まないでください。囲んだ場合，部品の実行が失敗します。また，実行ディレクトリは，事前に操作対象のホスト上に作成して，必要に応じてパーミッションを変更してください。少なくとも，部品を実行するユーザーのパーミッションを付与する必要があります。

また，操作対象のホストのOSがWindowsの場合，実行ディレクトリは作業用フォルダと同じドライブ配下に作成してください。事前に正しく実行ディレクトリを作成していない場合は，部品の実行に失敗することがあります。

実行ディレクトリの指定方法は［実行ディレクトリ］に指定する方法と，ユーザー設定プロパティファイル（config_user.properties）または接続先プロパティファイル（接続先名.properties）に指定する方法があります。実行ディレクトリは，次の優先順位に従って設定されます。

「実行ディレクトリ」に指定した値

接続先プロパティファイル（接続先名.properties）のキー「common.executionDirectory」に指定した値

ユーザー設定プロパティファイル（config_user.properties）のキー「plugin.remoteCommand.executionDirectory.wmi（操作対象のホストがWindowsの場合）」，または「plugin.remoteCommand.executionDirectory.ssh（操作対象のホストがUNIXの場合）」に指定した値

操作対象のホストの次の環境変数「%TEMP%」の値（操作対象のホストがWindowsの場合），または/tmp（操作対象のホストがUNIXの場合）

なお，［実行モード］の指定によって，次のとおり動作が異なります。

［実行モード］に［スクリプト］を指定した場合

［実行ディレクトリ］に指定したフォルダ配下のユニークな名称の一時フォルダに，スクリプトをコピーします。スクリプトは，一時フォルダ配下で実行されます。なお，スクリプトの実行完了後に，コピーしたスクリプトおよび一時フォルダは削除されます。

［実行モード］に［コマンド］を指定した場合

［実行ディレクトリ］に指定したディレクトリでコマンドラインが実行されます。

6.4.15　環境変数を追加・編集する手順

リモートコマンドに環境変数を追加したり，すでにある環境変数を編集したりできます。

環境変数を追加・編集するには：

［部品作成］ダイアログボックスまたは［部品編集］ダイアログボックスの［リモートコマンド］タブをクリックします。

［プラットフォーム］で，［詳細設定］－［環境変数］の［追加］ボタンをクリックします。すでにある環境変数を編集する場合は，その環境変数を選択して［編集］アイコンをクリックします。

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

表示されたダイアログボックスで環境変数の名称および値を設定し，［OK］ボタンをクリックします。

操作結果

環境変数が設定されます。

関連項目

6.4.1　プラットフォームを編集する手順

6.4.16　環境変数を削除する手順

6.4.16　環境変数を削除する手順

リモートコマンドに定義した環境変数を削除できます。

環境変数を削除するには：

［部品作成］ダイアログボックスまたは［部品編集］ダイアログボックスの［リモートコマンド］タブをクリックします。

［プラットフォーム］ダイアログボックスで，［詳細設定］－［環境変数］から，削除したい環境変数を選択し，［削除］アイコンをクリックします。

削除するかどうかを確認するダイアログボックス（確認画面）で［OK］ボタンをクリックします。

操作結果

環境変数が削除されます。

6.5　部品の表示情報をリソースファイルで設定する

部品にリソースファイルを設定して，画面で表示する情報をWebブラウザーのロケールごとに定義します。例えば，表示される部品名をWebブラウザーのロケールにあった言語に切り替えられます。

6.5.1　部品リソースファイルを設定する手順

部品リソースファイルを設定すると，部品に表示する情報を設定できます。部品リソースファイルを直接編集したい場合は，部品リソースファイルをダウンロードしてファイルを書き換えます。

ただし，リリース済みのサービステンプレートに含まれる部品の表示情報は設定できません。

部品リソースファイルを設定するには：

［Service Builder Home］画面で［部品の操作］プルダウンメニューから［リソース設定］をクリックします。

［部品一覧］ダイアログボックスで部品を選択し，［リソース設定］ボタンをクリックします。

［部品リソース設定］ダイアログボックスで，部品リソースファイルのリンクをクリックし，ダウンロードします。

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

ダウンロードした部品リソースファイルの定義を編集します。

［更新］ボタンをクリックして，編集した部品リソースファイルを選択し，アップロードします。

アップロードした部品リソースファイルの名称が「plugin_言語コード.properties.txt」以外の場合はエラーになります。

確認のダイアログボックスで［OK］ボタンをクリックします。

重要

部品リソースファイルをアップロードすると，それまで保存していた部品リソースファイルの内容が上書きされます。このため，誤ったファイルで不正に上書きしないように注意してください。

言語コードには，ISO-639で定義されている2桁の英小文字（ja，en，zh）が指定できます。

操作結果

リソースファイルの内容に従って，部品の表示情報が設定されます。

関連項目

6.5.2　部品リソースファイルの形式

6.5.3　部品の表示情報と部品リソースファイルのプロパティとの対応

6.5.2　部品リソースファイルの形式

部品リソースファイルは，JP1/AOの操作画面で表示する部品の項目を定義したファイルです。部品リソースファイルの形式を次に示します。

部品リソースファイルのファイル名は「plugin_言語コード.properties.txt」です。

言語コードには，ISO-639で定義されている2桁の英小文字（ja，en，zh）が指定できます。

「プロパティキー区切り文字設定値」の形式で記述してください。区切り文字には「=」，「:」，「¥t」，または半角スペースを使用できます。

例えば，「plugin.displayName=テスト用部品」のように記述してください。

プロパティキーと設定値は1行に1つ記述してください。

プロパティキーは1～128文字以内で記述してください。プロパティキーに記述できる文字を次に示します。

半角英数字

半角ハイフン「-」

半角アンダーライン「_」

半角ピリオド「.」

使用できる文字セットはUTF-8です。

同じプロパティに対する定義を複数記述した場合は，あとに記述した内容が有効になります。

先頭に「#」を付けた行はコメントになります。

大文字と小文字は区別されます。

指定する文字列に「¥」が含まれる場合は，「¥¥」と記述してください。

半角スペースだけの行は無視されます。

それぞれの行で，最初の半角スペース以外の文字から最初の区切り文字の直前までがプロパティキーとして扱われます。

それぞれの行で，プロパティキーの後ろの区切り文字の直後にある，区切り文字以外の文字から行末までが設定値として扱われます。

例えば，次のように指定した場合，「abc」がプロパティキー，「=¥tc」がプロパティ値として扱われます。

abc¥t=¥tc

ただし，最初の区切り文字の直後に「=」または「:」が含まれる場合，その直後にある半角スペースまたは「¥t」以外の文字から行末までが設定値として扱われます。

例えば，次のように指定した場合，「abc」がプロパティキー，「=¥tc」がプロパティ値として扱われます。

abc¥t=¥t=¥tc

サロゲートペア文字は無視されます。

6.5.3　部品の表示情報と部品リソースファイルのプロパティとの対応

部品の表示情報は，画面上で設定できます。画面上で設定した表示情報は，部品リソースファイルにも定義されています。部品の表示情報と，部品リソースファイルのプロパティの対応を次に示します。

表6‒16　画面の表示情報と部品リソースファイルの対応

部品の表示情報

部品リソースファイルのプロパティ

部品名

plugin.displayName

ベンダー名

plugin.vendorDisplayName

説明

plugin.shortDescription

入力プロパティ名・出力プロパティ名

property.プロパティキー.displayName

入力プロパティの説明・出力プロパティの説明

property.プロパティキー.description

6.5.4　部品の作成時に自動で生成される部品リソースファイルについて

部品を作成すると，部品リソースファイルが自動で生成されます。生成される部品リソースファイルは，Webブラウザーのロケールと同じ言語の部品リソースファイルと，英語用の部品リソースファイルの2種類です。ただし，Webブラウザーのロケールが英語の場合は，英語用の部品リソースファイルだけが生成されます。

生成される部品リソースファイルには，次の値が設定されます。

表6‒17　部品リソースファイルに設定される表示情報のデフォルト値（部品の作成時）

定義する表示情報

デフォルトで設定される値

Webブラウザーのロケールと同じ言語

自動で生成される英語用のリソースファイル※

ベンダー名

部品の作成，複製，または編集時に指定した値

ベンダーID

部品名

部品ID

部品の説明

空白

部品の入力プロパティ名，出力プロパティ名

プロパティキー

部品の入力プロパティの説明，出力プロパティの説明

空白

注※

Webブラウザーのロケールが英語の場合，生成される部品リソースファイルの内容は「Webブラウザーのロケールと同じ言語」の列を参照してください。

部品を作成するときに自動で生成される部品リソースファイルの例を次に示します。

画面上で設定する値

ベンダーID：test.vendor
部品ID：test.plugin
部品バージョン：10.00.00
部品名：テスト部品
ベンダー名：テスト用
説明：テスト用部品です

生成される部品リソースファイル（日本語）

plugin.vendorDisplayName=テスト用
plugin.displayName=テスト部品
plugin.shortDescription=テスト用部品です

生成される部品リソースファイル（英語）

plugin.vendorDisplayName=test.vendor
plugin.displayName=test.plugin
plugin.shortDescription=

6.5.5　部品の編集時に更新される部品リソースファイルについて

部品を編集し，保存すると，Webブラウザーのロケールと同じ言語の部品リソースファイルが更新されます。

ただし，表示情報の定義を追加，削除した場合，またはプロパティキーを更新した場合は，整合性を確保するため，Webブラウザーのロケール以外の言語の部品リソースファイルにも反映されます。

表示情報の定義を追加した場合，Webブラウザーのロケール以外の言語の部品リソースファイルには，次の表に示す値で定義が追加されます。表示情報の定義を更新した場合，プロパティキーを更新したときだけ，Webブラウザーのロケール以外の言語の部品リソースファイルの値は，次の表に示す値で自動的に上書きして設定されます。そのため，上書きされる前の情報を参照したい場合は，Webブラウザーのロケール以外の言語の部品リソースファイルをバックアップしておいてください。

表6‒18　部品リソースファイルに設定する表示情報の値

定義する表示情報

設定される値

部品の入力プロパティ名，出力プロパティ名

プロパティキー

部品の入力プロパティの説明，出力プロパティの説明

空白

表示情報の定義を削除した場合は，Webブラウザーのロケール以外の言語の部品リソースファイルからも定義が削除されます。

Webブラウザーのロケール以外の言語の表示情報を設定する場合は，手動で部品リソースファイルを作成または編集し，アップロードする必要があります。手動で部品リソースファイルを作成する場合は，表示情報が設定されているロケールの部品リソースファイルをダウンロードして利用することをお勧めします。

6.5.6　部品リソースファイルが作成されていないロケールのWebブラウザーで部品を表示した場合について

部品リソースファイルが作成されていないロケールのWebブラウザーで，部品を表示した場合は，英語用の部品リソースファイルを読み込んで画面が表示されます。

7　部品を管理する

部品に対しては，作成や編集のほかに，複製，および削除ができます。

7.1　部品を複製する

開発部品またはリリース部品を複製します。

7.1.1　部品を複製する手順

開発部品またはリリース部品の設定内容はそのまま保ち，別名の開発部品として複製します。既存の部品を基に新たな部品を開発する場合や，部品の修正版を作成する場合に利用できます。

部品を複製するには：

［Service Builder Home］画面で［部品の操作］プルダウンメニューから［複製］をクリックします。

［部品一覧］ダイアログボックスで，［リリース］タブまたは［開発］タブから複製したい部品を選択し，［複製］ボタンをクリックします。

［部品複製］ダイアログボックスで，部品ID，部品バージョン，ベンダーIDのうち，少なくとも1つを変更し，［保存］ボタンをクリックします。

「com.hitachi.software.dna」で始まるベンダーIDはJP1/AOで予約しているため指定できません。複製元の部品のベンダーIDが「com.hitachi.software.dna」で始まる場合は，複製時に「ベンダーID」および「ベンダー名」が削除されます。

図7‒1　［部品複製］ダイアログボックス

ヒント

サービステンプレートの編集中に部品を複製したい場合，［Service Builder Edit］画面の［フロー］タブの［開発］または［リリース］タブから，複製したい部品を選択し，［複製］ボタンをクリックすることでも，部品を複製できます。

操作結果

部品が複製されます。続けて，部品の定義情報を設定します。

関連項目

6.2.3　部品の定義情報として設定する項目について

6.2.2　部品の定義情報を編集する手順

7.2　部品を削除する

開発部品またはリリース部品を削除します。

7.2.1　部品を削除する手順

［部品一覧］ダイアログボックスの［開発］タブおよび［リリース］タブに表示されている部品を削除できます。部品を削除すると，部品の定義がJP1/AOサーバから削除されて，［Service Builder Edit］画面の［フロー］タブの［コンポーネント］エリアからも削除されます。

ただし，削除対象の部品を使用している開発サービステンプレートまたはリリースサービステンプレートが1つでもある場合は，その部品を削除できません。また，削除対象の部品をステップで使用している開発サービステンプレートがビルド済みの場合も，削除できません。この場合，開発サービステンプレートから，削除対象の部品を使用しているステップを削除したあとで，ビルドを再実行してください。ビルドしたあとに，部品を削除できるようになります。

部品を削除するには：

［Service Builder Home］画面で［部品の操作］プルダウンメニューから［削除］をクリックします。

［部品一覧］ダイアログボックスで，［リリース］タブまたは［開発］タブから削除したい部品を選択し，［削除］ボタンをクリックします。

図7‒2　［部品一覧］ダイアログボックス（削除）

ヒント

サービステンプレートの編集中に部品を削除したい場合，［Service Builder Edit］画面の［フロー］タブの［開発］または［リリース］タブから，削除したい部品を選択し，［削除］ボタンをクリックすることでも，部品を削除できます。

操作結果

部品が削除されます。

8　サービステンプレートを検証する

サービステンプレートを作成または編集したら，本番環境で実行しても問題ないかどうか，検証します。

8.1　サービステンプレートを検証する概要

サービステンプレートを検証する流れや，ビルド，デバッグ，および運用テストの概念について説明します。

8.1.1　サービステンプレートを検証する流れ

サービステンプレートを作成または編集したら，サービステンプレートをビルドおよびデバッグして，フローの遷移や部品の処理の問題点を摘出します。問題点が摘出された場合，サービステンプレートまたは部品を編集し，再度ビルドおよびデバッグします。すべての問題点が解消されたら，開発環境でサービスを実行して，運用テストをします。

サービステンプレートを検証する流れを次の図に示します。

図8‒1　サービステンプレートを検証する流れ

ビルド

サービステンプレートを作成または編集したら，サービステンプレートをビルドして，動作を確認できる状態にします。

デバッグ

ビルドに成功したら，サービステンプレートをデバッグして，フローや部品の問題点を摘出します。デバッグ実行すると，デバッグサービスおよびデバッグタスクが生成されます。

デバッグタスクの実行結果を確認して，問題点が摘出されたら，サービステンプレートを修正し，再度ビルドおよびデバッグします。

すべての問題点が解消されるまで，サービステンプレートの修正，ビルド，およびデバッグを繰り返します。

運用テスト

すべての問題点が解消されたら，開発環境でサービスを作成・実行して，運用テストを行います。

タスクの実行結果を確認して，問題点が摘出されたら，サービステンプレートまたは部品の修正からやり直します。

問題がなければサービステンプレートをリリースします。

なお，デバッグおよび運用テストは必要に応じて実施してください。

サービステンプレートをビルドする場合の関連トピック

8.1.2　ビルドとは

8.2　サービステンプレートをビルドする

サービステンプレートをデバッグする場合の関連トピック

8.1.3　デバッグとは

8.3　サービステンプレートをデバッグする

8.4　デバッグタスクを管理する

サービステンプレートの運用をテストする場合の関連トピック

8.1.4　運用テストとは

8.5　サービステンプレートの運用をテストする

8.1.2　ビルドとは

ビルドとは，［Service Builder］画面で作成または編集したサービステンプレートを検証するための操作です。ビルドに成功すると，サービステンプレートがパッケージングされ，デバッグしたり，サービスを作成したりできる状態になります。

目的

開発サービステンプレートを検証する場合にビルドを行います。ビルドしたサービステンプレートは，デバッグ状態のサービステンプレートとしてパッケージングされたあと，JP1/AOサーバにインポートされます。

実行できる回数

1つのサービステンプレートに対して，ビルドは何回でも実行できます。デバッグや運用テストでサービステンプレートの問題点が摘出された場合は，開発サービステンプレートまたは開発部品の修正から，ビルド，デバッグおよび運用テストまでの一連の作業を，すべての問題点が解消されるまで繰り返し実施します。

一度デバッグしたサービステンプレートを編集し，再度ビルドした場合，前回生成されたデバッグサービスおよびデバッグタスクは削除されます。一度運用テストをしたサービステンプレートを再度ビルドした場合，前回作成したサービスは削除され，タスクはアーカイブされます。サービスおよびタスクの削除・アーカイブ範囲についての詳細は，「付録A.1(5)　ビルドまたはリリースする場合のサービステンプレート，サービス，タスクの削除・アーカイブ範囲」を参照してください。

設定される状態

ビルド後のサービステンプレートは状態に「デバッグ」が設定されます。デバッグ状態のサービステンプレートおよび作成されたサービスやタスクは，AdminまたはDevelopロールが設定されているユーザーだけが参照および操作できます。

サービステンプレートの出力先

ビルドによって作成されたサービステンプレートパッケージは，「ベンダーID_名称_バージョン_d.st」のファイル名で，次のフォルダに作成されます。

Windowsの非クラスタシステムの場合

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

Linuxの非クラスタシステムの場合

/var/opt/jp1ao/develop/output

Windowsのクラスタシステムの場合

共有フォルダ名¥develop¥output

Linuxのクラスタシステムの場合

共有フォルダ名/develop/output

関連項目

2.1　開発サービステンプレートおよびリリースサービステンプレートとは

8.1.1　サービステンプレートを検証する流れ

8.2.1　サービステンプレートをビルドする手順

付録A.1　デバッグおよびリリースの参考情報

8.1.3　デバッグとは

デバッグとは，［Service Builder Debug］画面を使用して，ビルドしたサービステンプレートの動作を確認し，フローや部品の問題点を摘出するための操作です。サービステンプレートをデバッグすると，デバッグサービスおよびデバッグタスクが生成されます。デバッグは，デバッグタスクを実行しながら行います。

デバッグで問題点が摘出された場合は，デバッグを停止し，サービステンプレートまたは部品を編集します。

目的

サービステンプレートのフローや部品が，設計したとおりに動作するかを確認するためにデバッグを行います。例えば，プロパティのマッピング設定や，後続ステップ実行条件によるフローの分岐が設計どおりかを確認できます。［Service Builder Debug］画面を使用すると，次のことができます。

階層フローや繰り返し実行フローを含む，すべての階層におけるフローの遷移や，部品の処理の結果を確認しながらデバッグタスクを実行できます。

プロパティのマッピング設定に従って，プロパティの値が正しく設定されているか，確認しながらデバッグタスクを実行できます。

部品の問題点が摘出された場合，ステッププロパティの値や戻り値を変更して実行できます。そのため，ステッププロパティの値や戻り値に任意の値を指定したときの，部品の処理やフローの遷移を確認できます。

実行できる回数

1つのサービステンプレートに対して，デバッグは何回でも実行できます。また，デバッグ中にサービステンプレートの問題点が摘出された場合は，開発サービステンプレートまたは開発部品の修正から，ビルド，デバッグまでの一連の作業を，すべての問題点が解消されるまで繰り返し実施してください。

デバッグサービスとは

サービステンプレートのデバッグ時に生成・実行されるサービスのことです。生成されるデバッグサービスは，1つのサービステンプレートにつき1つです。一度デバッグしたサービステンプレートを再度デバッグした場合，前回生成されたデバッグサービスは削除され，新しいデバッグサービスが生成されます。

なお，デバッグサービスは，［タスク］画面（［デバッグ］タブ）のサービス名の列に表示され，［サービス］画面には表示されません。

デバッグタスクとは

サービステンプレートのデバッグ時に，デバッグサービスの生成に伴って生成されるタスクのことです。一度デバッグしたサービステンプレートを再度デバッグした場合，前回生成されたデバッグタスクは削除され，新しいデバッグタスクが生成されます。

デバッグタスクは，［Service Builder Debug］画面および［タスク］画面（［デバッグ］タブ）に表示され，AdminまたはDevelopロールが設定されているユーザーだけが参照および操作できます。

なお，デバッグタスクの状態はタスクサマリーに表示されません。

関連項目

2.1　開発サービステンプレートおよびリリースサービステンプレートとは

8.1.1　サービステンプレートを検証する流れ

8.3.2　サービステンプレートをデバッグする流れ

8.3.3　デバッグ時に組み合わせて使用する機能一覧

8.3.4　サービステンプレートのデバッグ例

8.1.4　運用テストとは

運用テストは，ビルドしたサービステンプレートからサービスを作成し，開発環境で実行して，運用しても問題がないかを確認するための操作です。

運用テストで問題点が摘出された場合は，［Service Builder］画面から，サービステンプレートまたは部品を編集します。

目的

サービステンプレートから生成したサービスを実行し，本番環境で実行しても問題がないかを確認するために運用テストを行います。運用テストでは，実運用と同じように，［サービス］画面からサービスを作成・実行して，サービステンプレートのユーザビリティについても確認できます。例えば，サービスのスケジュール種別を指定して，用途に合った運用ができるかを確認したり，プロパティの可視性や値の編集可否を確認したりできます。

実行できる回数

1つのサービステンプレートに対して，運用テストは何回でも実行できます。また，運用テストでサービステンプレートの問題点が摘出された場合は，開発サービステンプレートまたは開発部品の修正から，ビルド，デバッグ，運用テストまでの一連の作業を，すべての問題点が解消されるまで繰り返し実施してください。

関連項目

2.1　開発サービステンプレートおよびリリースサービステンプレートとは

8.1.1　サービステンプレートを検証する流れ

8.5.1　サービステンプレートの運用をテストする手順

マニュアル『JP1/AO 運用ガイド』－「サービスの管理」のトピック

マニュアル『JP1/AO 運用ガイド』－「サービスの実行」のトピック

マニュアル『JP1/AO 運用ガイド』－「タスクの管理」のトピック

8.2　サービステンプレートをビルドする

サービステンプレートをビルドする手順について説明します。

8.2.1　サービステンプレートをビルドする手順

サービステンプレートを選択してビルドすると，サービステンプレートパッケージが作成され，JP1/AOサーバにインポートされます。ビルドしたサービステンプレートは，デバッグしたり，運用テストしたりできる状態になります。

重要

フロー内にステップとして配置されている状態で，部品の定義を編集すると，ステップに定義したマッピング設定とステッププロパティに不整合が生じるおそれがあります。不整合が生じると，ビルド時にエラーとなります。その場合は，プロパティの設定や部品の配置をやり直して，不整合を解消してください。

サービステンプレートをビルドするには：

［Service Builder Edit］画面で，［デバッグ］ボタンをクリックします。

確認画面で［OK］ボタンをクリックします。

ビルドの結果が，［ビルド/リリース結果］ダイアログボックスに表示されます。ビルドに成功すると，［デバッグ実行］ダイアログボックスが表示されます。

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

引き続き，デバッグをする場合は，［デバッグ実行］ダイアログボックスで［OK］ボタンをクリックします。デバッグを開始する手順については，「8.3.5　デバッグを開始する手順」を参照してください。

デバッグをしない場合は，［キャンセル］ボタンをクリックします。

なお，ビルド時にエラーが発生した場合は，エラー原因とフローの修正を促すメッセージが通知され，［Service Builder Edit］画面右上に［エラー］ボタンが表示されます。メッセージを閉じたあとも，［エラー］ボタンをクリックすればメッセージを参照できます。このボタンは，［Service Builder Edit］画面を閉じるまで表示されます。

対象のサービステンプレートがほかのユーザーによって，すでにリリースされていた場合や削除されていた場合はエラーとなり，ビルドに失敗します。

関連項目

1.2.4　［Service Builder］画面で割り込み操作があった場合の注意事項

8.1.1　サービステンプレートを検証する流れ

8.1.2　ビルドとは

付録A.1　デバッグおよびリリースの参考情報

8.3　サービステンプレートをデバッグする

［Service Builder Debug］画面を使用して，サービステンプレートをデバッグします。

8.3.1　［Service Builder Debug］画面

［Service Builder Debug］画面は，サービステンプレートをデバッグするための画面です。［Service Builder Debug］画面は，［デバッグ実行］ダイアログボックスで［OK］ボタンをクリックすると表示されます。

図8‒3　［Service Builder Debug］画面

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

［エディタへ戻る］ボタン

クリックすると，［Service Builder Debug］画面を閉じ，［Service Builder Edit］画面が表示されます。このとき，実行中のデバッグタスクは強制停止されます。

重要

［Service Builder Debug］画面を閉じるときは，必ず［エディタへ戻る］ボタンから閉じてください。Webブラウザーのボタンから閉じた場合，デバッグタスクが実行中のままになります。デバッグタスクが実行中のままだと，デバッグタスクの基となるサービステンプレートを編集できません。Webブラウザーのボタンから［Service Builder Debug］画面を閉じた場合は，［タスク］画面からデバッグタスクを停止してください。

［デバッグ］エリア

デバッグタスクを実行する際の設定をしたり，実行中のデバッグタスクへの操作をしたりするエリアです。

［応答入力］ボタン

応答待ち中のデバッグタスクに応答を入力できます。

［再実行］プルダウンメニュー

デバッグタスクの状態が「正常終了」または「失敗」の場合に，再度デバッグタスクを実行できます。再実行の方法は，［最初からリトライ］，［失敗したステップからリトライ］，または［失敗した次のステップからリトライ］から選択できます。

［再開］ボタン

中断中のデバッグタスクの実行を再開できます。

［一時停止］ボタン

デバッグタスクの実行を中断できます。

［強制停止］ボタン

デバッグタスクの実行を強制停止できます。

［ステップイン］ボタン

中断中のステップで，次に中断できるポイントまでステップを実行したあと，ステップを中断できます。

［ステップオーバー］ボタン

中断中の次のステップで，最初に中断できるポイントまでステップを実行したあと，ステップを中断できます。

［ステップリターン］ボタン

2階層目以下のフローを実行中に，1つ上の階層のフローで最初に中断できるポイントまでステップを実行したあと，ステップを中断できます。

［ブレークポイント切り替え］ボタン

選択したステップに，ブレークポイントを設定できます。すでにブレークポイントが設定されたステップを選択した場合，ブレークポイントの設定を解除できます。

［実行設定］プルダウンメニュー

ステップを実行するときに，部品の処理を実行するかどうかを設定できます。

［ステップ情報］エリア

選択しているステップのステップID，ステップ名，および状態が表示されます。

［ステッププロパティ］エリア

選択しているステップのプロパティ値が表示されます。[図データ]をクリックすると，プロパティ値を編集できます。サービス部品を使用したステップの入力プロパティの場合，［編集］プルダウンメニューをクリックすると，［サービス作成］画面または［サービス実行］画面で値を設定できます。［インポート］ボタンまたは［エクスポート］ボタンをクリックすると，プロパティファイルを使用したステッププロパティのインポートまたはエクスポートができます。

フローエリア

ステップの実行順序がフロー形式で表示されます。ステップの状態，ブレイクポイントの有無，ステップの中断可否が確認できます。

［フローツリー］エリア

フローエリアに表示するフローの階層を選択するエリアです。サービステンプレートに定義されているフローの名称が階層表示されます。フロー名をクリックすると，その配下のフローがフローエリアに表示されます。

［タスクログ］タブ

実行中のデバッグタスクのタスクログが表示されます。タスクログはダウンロードできます。

［サービスプロパティ］タブ

サービステンプレートに設定されているサービスプロパティが，プロパティグループごとに一覧表示されます。ただし，変数は表示されません。

［ブレークポイント］タブ

ブレークポイントを設定したステップの名称と，そのステップが配置されたフローの階層が一覧表示されます。［全ての設定を解除］ボタンをクリックすると，すべてのブレークポイントの設定が解除されます。表示されているステップを右クリックすると，ブレークポイントを解除したり，該当するステップをフローエリアで選択したりできます。

8.3.2　サービステンプレートをデバッグする流れ

ビルドに成功したら，サービステンプレートをデバッグして，フローや部品の問題点を摘出します。

サービステンプレートをデバッグする流れを次に示します。

サービステンプレートに含まれるコンポーネントをすべて実行しても問題ない場合，まずは，ステップごとに中断しないで，デバッグタスクを実行します。

フローの遷移や部品の処理に問題点がないかを確認します。

サービステンプレートに実行したくないコンポーネントが含まれている場合は，手順1を実行しないで，手順2から実行してください。

フローの遷移や部品の処理に問題点が摘出されたら，次は，ステップごとに中断しながらデバッグを実行して，問題点の個所や内容を特定します。任意のステップにブレークポイントを設定することもできます。必要に応じて，入力プロパティや出力プロパティの値を変更して，動作を確認します。［Service Builder Debug］画面の［再実行］プルダウンメニュー[図データ]で，デバッグを何度でも実行できます。

［Service Builder Edit］画面で，サービステンプレートを修正します。

再度サービステンプレートをビルドし，デバッグします。1～4の流れを，すべての問題点が解消されるまで繰り返します。

すべての問題点が解消されたことを確認し，デバッグを終了します。

ヒント

一度デバッグタスクを実行したあと，サービステンプレートを修正しないで再度デバッグする場合，ビルドは必要ありません。

関連項目

8.1.1　サービステンプレートを検証する流れ

8.1.2　ビルドとは

8.1.3　デバッグとは

8.3.3　デバッグ時に組み合わせて使用する機能一覧

8.3.4　サービステンプレートのデバッグ例

8.3.3　デバッグ時に組み合わせて使用する機能一覧

サービステンプレートのデバッグに関する機能一覧を次の表に示します。サービステンプレートをデバッグする場合は，これらの機能を目的に合わせて使用してください。

表8‒1　デバッグ時に組み合わせて使用する機能一覧

機能

概要

説明個所

デバッグタスクの設定

デバッグサービス・デバッグタスクの定義情報，タスクログの出力レベル，およびデバッグサービスのプロパティの情報を設定できます。

8.3.5　デバッグを開始する手順

ステップの実行設定

デバッグタスクの実行には，通常のタスクのようにステップを中断しないで実行する方法と，部品の処理の前後でステップを中断しながら実行する方法があります。これらの方法は組み合わせて使用できます。

ステップごとに中断しないで実行する

通常のタスクの実行と同様に，デバッグタスクの処理を中断しないで実行します。デバッグタスクの実行結果を確認して，フローの中で問題のあるステップを特定できます。

ステップごとに中断しながら実行する

任意のステップについて，部品の処理の前後で実行を中断しながらデバッグタスクを実行します。そのため，プロパティの値や戻り値などを確認しながら，デバッグタスクの処理を進められます。

8.3.9　ステップの実行を中断しながらデバッグするときの操作

部品の処理のスキップ

部品の処理を実行しないで，ステップの実行が終了したものとして処理できます。

8.3.11　デバッグ時に部品の処理をスキップする手順

プロパティマッピングの設定の確認

ステッププロパティの値を［デバッグ］エリアに表示できます。［サービスプロパティ］タブに表示されるサービスプロパティの値とあわせて参照して，プロパティマッピングが正しく設定されているかを確認できます。

8.3.13　デバッグ時にプロパティマッピングの設定を確認する手順

ステップの情報変更

ステッププロパティや戻り値を，任意の値に変更できます。

部品の処理を実行する前にステップを中断して，入力プロパティの値を変更できます。

部品の処理をスキップしたあと，および処理を実行したあとでステップを中断しているときに，出力プロパティの値や戻り値を変更できます。

8.3.14　デバッグ時にステッププロパティの値または戻り値を変更する手順

タスクのリトライ

デバッグタスクが失敗した場合に，次の方法でリトライできます。

再実行

ビルドしないで，新しいデバッグタスクとして実行できます。

失敗したステップからリトライ

失敗したステップからもう一度実行できます。

失敗した次のステップからリトライ

失敗したステップを正常終了したものとして処理し，次のステップから実行できます。

8.3.19　サービステンプレートをビルドしないで再度デバッグする手順，8.3.20　デバッグ時に失敗したステップからリトライする手順，8.3.21　デバッグ時に失敗した次のステップからリトライする手順

フローの情報表示

デバッグタスクのフローを次の方法で表示できます。

フロー表示

［Service Builder Debug］画面および［タスク］画面で，すべての階層におけるフローの遷移やステップの状態を確認できます。

フローツリー表示

［Service Builder Debug］画面で，フローの階層をツリー形式で確認できます。また，各フローの階層に中断中のステップがあるかどうかを確認できます。

8.3.22　デバッグタスクのフロー表示について，8.3.23　デバッグタスクのフローツリー表示について，8.4　デバッグタスクを管理する

タスクログの表示

［Service Builder Debug］画面の［タスクログ］タブに，タスクログを常に表示できます。タスクログは自動更新およびダウンロードできます。

8.4.3　デバッグタスクのタスクログを確認する手順

デバッグタスクの管理

デバッグタスクに対して，次のことができます。

進捗状況の確認

詳細情報の確認

実行停止

強制停止

削除

8.4　デバッグタスクを管理する

関連項目

8.3.2　サービステンプレートをデバッグする流れ

8.3.4　サービステンプレートのデバッグ例

8.3.4　サービステンプレートのデバッグ例

デバッグでは，ユーザーが確認したい項目に応じて，さまざまな設定を組み合わせる必要があります。

サービステンプレートをデバッグする操作の例を次に示します。

この例では，次のような場合に，サービステンプレートをデバッグする手順について説明します。

デバッグするサービステンプレートの問題点

問題1：

ステップAの入力プロパティと，サービスプロパティのマッピングの設定に問題がある。

ユーザーの意志

意志1：

サービステンプレートを修正する前に，ほかのステップの実行結果を確認したい。

意志2：

プロパティのマッピングに問題がある場合，そのステップの部品の処理は実行したくない。

意志3：

ステップBのステッププロパティを変更して，部品Bの処理の結果を確認したい。

意志4：

部品Cの処理の結果を確認したい。

図8‒4　サービステンプレートのデバッグ例

デバッグタスクの実行が開始され，部品Aの処理を実行する前にステップAが自動で中断されます。ステップAが中断されたら，［デバッグ］エリアでステッププロパティ「入力A」の値を確認します。［サービスプロパティ］タブに表示されている，サービスプロパティ「入力1」の値が正しくマッピングされているかを確認します。

こうすることで，ステッププロパティ「入力A」のマッピング設定に，問題を発見できます（問題1）。

プロパティのマッピングに問題があったため，意志1および意志2に従い，部品Aの処理はスキップしてデバッグタスクを進めます。［デバッグ］エリアで，［実行設定］プルダウンメニューから［部品の処理を実行しない］を選択します。

意志3のとおり，ステッププロパティの値を変更して部品Bの処理を実行するため，［ステップオーバー］ボタン[図データ]をクリックし，部品Bの処理を実行する前までデバッグタスクの処理を進めます。

部品Aの処理がスキップされ，ステップAの実行が終了します。部品Bの処理の実行前に，ステップBが中断されます。

［デバッグ］エリアで，［実行設定］プルダウンメニューから［部品の処理を実行する］を選択します。

ステップBの入力プロパティの値を変更します。

［デバッグ］エリアで［再開］ボタン[図データ]をクリックします。

部品Bの処理が実行されたあと，後続ステップ実行条件に従ってステップCが実行され，デバッグタスクが終了します。

意志3および意志4のとおり，［デバッグ］エリア，フローエリア，および［タスクログ］タブで，ステップBおよびステップCの実行結果を確認します。

［Service Builder Debug］画面の［エディタへ戻る］ボタンをクリックします。

［Service Builder Debug］画面が閉じます。

［Service Builder Edit］画面の［フロー］タブで，ステップAのプロパティマッピングの設定を修正します。

サービステンプレートを保存したあと，サービステンプレートを再度デバッグします。

関連項目

8.1.1　サービステンプレートを検証する流れ

8.1.2　ビルドとは

8.1.3　デバッグとは

8.3.2　サービステンプレートをデバッグする流れ

8.3.3　デバッグ時に組み合わせて使用する機能一覧

8.3.9　ステップの実行を中断しながらデバッグするときの操作

8.3.5　デバッグを開始する手順

サービステンプレートのビルドに成功したら，デバッグを開始します。デバッグを開始するには，デバッグサービス・デバッグタスクの定義情報，タスクログの出力レベル，およびデバッグサービスのプロパティの情報を設定します。

なお，デバッグ実行時のスケジュール種別は即時実行となります。

デバッグを開始するには：

［デバッグ実行］ダイアログボックスで，デバッグサービス・デバッグタスクの定義情報，タスクログの出力レベル，およびデバッグサービスのプロパティの情報を設定します。

プロパティは，［編集］プルダウンメニューから［[サービス作成]画面］または［[サービス実行]画面］を選択し，それぞれの画面から設定します。プロパティファイルから読み込むこともできます。

図8‒5　［デバッグ実行］ダイアログボックス

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

操作結果

［Service Builder Debug］画面が表示され，デバッグタスクが実行されます。

デバッグタスクの実行が開始されたあと，1つめのステップが部品の処理を実行する前に中断されます。ステップの実行を再開する場合は，［デバッグ］エリアの［再開］ボタンをクリックします。

重要

［デバッグ実行］ダイアログボックスには，デバッグ実行するユーザーが最後にビルドしたときのサービステンプレートの状態が反映されます。デバッグ実行するユーザーがビルドしたあとで，ほかのユーザーが同一のサービステンプレートを編集し，ビルドしていた場合，その編集内容は反映されません。

次の場合，デバッグタスクは強制停止されます。

・JP1/AOサーバが停止された場合

・クラスタのフェールオーバーが発生した場合

デバッグ実行中にWebブラウザーを閉じた場合，デバッグタスクはその時点で処理が中断され，後続の処理を実行できなくなります。この場合，ユーザーは再度ログインして，［タスク］画面の［デバッグ］エリアでデバッグタスクを停止させる必要があります。なお，一度閉じた［Service Builder Debug］画面は表示できません。デバッグタスクを実行したい場合は，再度サービステンプレートをビルドし，デバッグの実行をやり直してください。

サービステンプレートをビルドしてからデバッグを開始するまでの間に，ほかのユーザーが同じサービステンプレートをビルドした場合，［デバッグ実行］ダイアログボックスの［OK］ボタンをクリックしたあと，エラーになります。

デバッグタスクに含まれる部品について，1つのJP1/AOシステム内で同時実行できる部品の数は10までです。同時実行できる部品の数の上限や，上限を超えた場合の処理については，マニュアルJP1/AO 運用ガイド－「タスクに含まれる部品の同時実行数の上限について」のトピックを参照してください。

デバッグタスクの状態は，JP1イベント通知およびメール通知の対象となります。

関連項目

8.3.6　デバッグを開始するときの設定項目について

8.3.3　デバッグ時に組み合わせて使用する機能一覧

8.3.7　ステップごとに中断しないでデバッグする手順

8.3.9　ステップの実行を中断しながらデバッグするときの操作

8.3.6　デバッグを開始するときの設定項目について

［デバッグ実行］ダイアログボックスでは，デバッグサービス・デバッグタスクの定義情報，タスクログの出力レベル，およびデバッグサービスのプロパティの情報を設定します。

表8‒2　［デバッグ実行］ダイアログボックスで表示される項目

項目

説明

サービス名

デバッグサービス名を設定します。デフォルトでは「[DEBUG]実行対象のサービステンプレート名」が設定されます。

タグ

デバッグサービスのタグを設定します。デフォルトでは「実行対象のサービステンプレートのタグ」が設定されます。

タスク名

デバッグタスクのタスク名を設定します。デフォルトでは「[DEBUG]実行対象のサービステンプレート名_現在時刻(YYYYMMDDhhmmss)」が設定されます。

タスクの説明

デバッグタスクの説明を設定します。デフォルトは空白です。

サービスグループ

デバッグサービスを登録するサービスグループを選択します。デフォルトでは「DefaultServiceGroup」が設定されます。

ログ出力レベル

タスクログのログ出力レベルを選択します。デフォルトでは40が設定されます。

ここで設定したログ出力レベルは，デバッグタスクだけに適用されます。既存のビルトインサービス共有プロパティ「com.hitachi.software.dna.sys.task.log.level」には影響しません。

プロパティ一覧

サービスの入力プロパティの値が表示されます。デフォルトでは，サービステンプレートの作成時に設定されたサービスプロパティの定義に従って設定されています。

プロパティの値を変更するときは，［編集］プルダウンメニューから，［[サービス作成]画面］または［[サービス実行]画面］を選択し，各画面から操作します。［インポート］ボタンでプロパティファイルから値を設定したり，［エクスポート］ボタンで設定した値を出力したりすることもできます。

なお，ここで設定したプロパティの値は，デバッグタスク固有の値として使用され，システムのサービス共有プロパティには反映されません。そのため，サービス共有プロパティを参照しているほかのサービスには影響しません。

サービスプロパティの値をサービステンプレートで設定したデフォルト値に戻す場合は，［デフォルトに戻す］ボタンをクリックしてください。

関連項目

マニュアル『JP1/AO 運用ガイド』－「プロパティファイルについて」のトピック

8.3.7　ステップごとに中断しないでデバッグする手順

デバッグタスクの実行を開始すると，最初のステップに含まれる部品を実行する前に，ステップが中断されます。そのあと，通常のタスクの実行と同様に，ステップごとに中断しないでデバッグタスクを実行できます。このとき，ステッププロパティの値や戻り値を変更することはできません。

ステップごとに中断しないでデバッグする流れ：

ステップにブレークポイントが設定されている場合，［ブレークポイント］タブで［全ての設定を解除］ボタンをクリックします。

［デバッグ］エリアの［実行設定］プルダウンメニューで部品の処理の実行設定をします。

例えば，タスクが正常終了するかどうかを確認したい場合や，フローの遷移に問題点がないかを確認したい場合は，［部品の処理を実行する］を選択します。ブレークポイントを設定したステップまで，部品の処理をすべてスキップしたい場合は，［部品の処理を実行しない］を選択します。

［デバッグ］エリアの［再開］ボタン[図データ]をクリックします。

操作結果

ブレークポイントを設定した場所まで，ステップごとに中断しないで，デバッグタスクが実行されます。［Service Builder Debug］画面で実行結果を確認し，必要に応じてサービステンプレートまたは部品を編集します。

関連項目

8.3.5　デバッグを開始する手順

8.3.6　デバッグを開始するときの設定項目について

8.3.22　デバッグタスクのフロー表示について

8.4.3　デバッグタスクのタスクログを確認する手順

8.3.8　ステップ実行を中断できるタイミング

ステップは，ステップに含まれる部品の処理を実行する前後で中断できます。

部品の処理を実行する前とは，ステップの実行が開始され，ステップの入力プロパティが生成された直後のことです。このとき，ステップの状態は「中断中」になります。

部品の処理を実行した後とは，出力プロパティおよび戻り値が出力された直後のことです。このとき，ステップの状態は「中断中（実行後）」になります。

ステップを中断していると，ステッププロパティの値や戻り値を変更できます。そのため，ステッププロパティの値や戻り値に任意の値を指定したときの，部品の処理やフローの遷移を確認できます。これによって，部品の処理やフローの問題点を検証できます。また，部品の処理を実行する前に中断すると，そのあと，部品の処理を実行するかどうかを選択できます。

ただし，ステップの実行を中断できない部品もあります。

ヒント

デバッグの開始直後は，最初のステップの部品の処理を実行する前に，ステップが自動で中断されます。

部品の処理を実行する際に，部品の戻り値が65以上となった場合（ステップの入力プロパティの値に誤りがあったときや，操作対象の機器のOSに接続できなかったときなど）は，部品の処理の実行後に中断する操作をしても，中断されないで，デバッグタスクの処理が進みます。

関連項目

8.3.9　ステップの実行を中断しながらデバッグするときの操作

8.3.10　ステップ実行の中断時に変更できるステップの情報

8.3.9　ステップの実行を中断しながらデバッグするときの操作

デバッグタスクの実行時，次にどの場所まで実行するか（どの場所で中断するか）は，［デバッグ］エリアで操作できます。デバッグ中，ステップを実行するときの操作を次に示します。これらの操作を組み合わせて実施して，デバッグを進めてください。

表8‒3　ステップの実行を中断しながらデバッグするときの操作

操作

操作方法

操作するタイミング

説明

例えばこんなときに

再開※

［再開］ボタン[図データ]をクリックする

ステップの中断中

中断中のステップの実行を再開します。直近でブレークポイントが設定されているステップの部品の処理の実行前，またはデバッグタスクの最後まで処理が進みます。

ブレークポイントを設定したステップまで，デバッグタスクを実行したいとき

ステップごとに中断しないで，デバッグタスクを最後まで実行したいとき

一時停止

［一時停止］ボタン[図データ]をクリックする

ステップの実行中

直近で中断できるところまでステップを実行したあと，ステップを中断します。

誤ってステップの中断を設定しないでデバッグタスクを実行したとき

ステップイン※

［ステップイン］ボタン[図データ]をクリックする

ステップの中断中

次に中断できるところまでステップを実行し，中断します。階層ステップ，繰り返しステップ，またはサービスステップの場合，配下のフロー内でもステップを中断します。

部品の処理の実行前・実行後のステップ情報を1つずつ確認しながらデバッグを進めたいとき

ステップの出力プロパティまたは戻り値を変更しながらデバッグを進めたいとき

ステップオーバー※

［ステップオーバー］ボタン[図データ]をクリックする

ステップの中断中

次のステップで最初に中断できる場所までステップを実行し，中断します。階層ステップ，繰り返しステップ，またはサービスステップの場合，配下のフロー内では中断しないで，ステップを実行します。

ステップごとに部品の処理の結果を確認しながらデバッグを進めたいとき

ステップの入力プロパティを変更して，部品の処理を確認しながらデバッグを進めたいとき

ステップリターン※

［ステップリターン］ボタン[図データ]をクリックする

ステップの中断中

主に階層ステップ，繰り返しステップ，またはサービスステップの配下のフローで操作します。操作すると，1つ上の階層で最初に中断できる場所までステップを実行し，中断します。

最上位の階層で操作した場合，デバッグタスクの最後までステップを実行します。

繰り返し実行の処理は，1つ目のステップだけ確認して，あとはスキップしたいとき

ブレークポイント※

ブレークポイントを設定したい場合

ブレークポイントを設定したいステップを選択して［ブレークポイント切り替え］ボタン[図データ]をクリックする

ブレークポイントの設定を解除したい場合

ブレークポイントの設定を解除したいステップを選択して［ブレークポイント切り替え］ボタン[図データ]をクリックする

すべてのブレークポイントの設定を解除したい場合

［ブレークポイント］タブの［全ての設定を解除］ボタンをクリックする

［Service Builder Debug］画面の表示中

選択したステップについて，部品の処理の実行前後に中断するポイントを設定します。再開の操作をした場合，ブレークポイントを設定した個所までステップを実行します。

任意のステップについて，部品の処理の実行前・実行後のステップ情報を確認したいとき

任意のステップについて，部品の処理をスキップしたいとき

注※

フローエリアのステップアイコンを右クリックしても操作できます。

ステップイン，ステップオーバー，およびステップリターンの操作について，操作を行った場合にステップ実行が中断される場所を次に示します。

なお，フローエリア上では，ステップイン，ステップオーバー，またはステップリターンの操作時，次に中断されるステップのアイコンに[図データ]が表示されます。

デバッグタスクの開始後，ステップインの操作を繰り返した場合

図8‒6　ステップインの操作で中断される場所

階層フロー部品の配下のフローも含め，すべての部品の処理の前後でステップ実行が中断されます。ただし，階層フロー部品の実行後は中断できないため，ステップBの部品の処理の後では中断されないで，ステップEの部品の処理の前で中断されます。

デバッグタスクの開始後，ステップオーバーの操作を繰り返した場合

図8‒7　ステップオーバーの操作で中断される場所

各ステップの部品の処理の実行前に中断されます。ただし，階層フロー部品の配下のフローでは，ステップの実行が中断されません。

階層フロー部品の配下のフローでステップリターンの操作をした場合

図8‒8　ステップリターンの操作で中断される場所

階層フロー部品の配下のフローに含まれるすべてのステップを実行したあと，上位のフローに戻り，ステップEの部品の処理の実行前に中断されます。

関連項目

8.3.8　ステップ実行を中断できるタイミング

8.3.10　ステップ実行の中断時に変更できるステップの情報

8.3.11　デバッグ時に部品の処理をスキップする手順

8.3.12　デバッグ時にステップ実行を中断またはスキップできない部品

8.3.14　デバッグ時にステッププロパティの値または戻り値を変更する手順

8.3.10　ステップ実行の中断時に変更できるステップの情報

デバッグでステップの実行を中断しているときに，デバッグタスクのステップの情報を変更できます。デバッグの際，部品の問題点が摘出された場合に，ステッププロパティの値および戻り値を変更して，動作を確認できます。

変更できるステップの情報は，中断するタイミングで異なります。

表8‒4　中断時に変更できるステップの情報

項目

部品の処理の実行前に中断しているとき

部品の処理の実行後に中断しているとき

部品の処理を実行する（スキップしない）場合

部品の処理を実行しない（スキップする）場合

ステップの入力プロパティの値※

○

○

×

ステップの出力プロパティの値※

×

×

○

ステップの戻り値

×

×

○

（凡例）

○：変更できます。 ×：変更できません。

注※

次の場合，変更できません。

プロパティにマッピングを設定している場合

サービス部品に含まれるステップのプロパティで，［サービス作成］画面や［サービス実行］画面で非表示または編集不可に設定されている場合

関連項目

8.3.8　ステップ実行を中断できるタイミング

8.3.12　デバッグ時にステップ実行を中断またはスキップできない部品

8.3.14　デバッグ時にステッププロパティの値または戻り値を変更する手順

8.3.11　デバッグ時に部品の処理をスキップする手順

デバッグ時に，処理を実行したくない部品がある場合，その部品の処理をスキップします。スキップする場合は，その部品の処理を実行したと仮定したときの，ステップの出力プロパティの値や戻り値を指定します。これによって，後続ステップ実行条件による，ステップおよびタスクの状態遷移，フローの遷移，および後続ステップの処理を確認できます。

部品の処理をスキップするには：

実行したくない部品を含むステップで，部品の処理を実行する前に中断します。

［デバッグ］エリアの［実行設定］プルダウンメニューから［部品の処理を実行しない］を選択します。

部品の処理の実行後までステップを実行し，中断します。部品の処理をスキップするステップにブレークポイントを設定している場合は［再開］ボタン[図データ]，設定していない場合は［ステップイン］ボタン[図データ]をクリックします。

［ステッププロパティ］エリアで，戻り値の[図データ]をクリックし，任意の値を指定します。

ここで指定した戻り値によって，後続ステップ実行条件による，ステップおよびタスクの状態遷移やフローの遷移が決まります。

必要に応じて，出力プロパティの[図データ]をクリックし，任意の値を指定します。

ヒント

出力プロパティにマッピングを設定している場合は，指定したステップの出力プロパティの値が，マッピングを設定しているサービスプロパティ（出力プロパティまたは変数）に反映されます。値を指定しない場合は，マッピングを設定しているサービスプロパティ（出力プロパティまたは変数）の値が空になります。

操作結果

ステップを実行する操作をすると，指定した戻り値および出力プロパティに従って，デバッグタスクの処理が進みます。

関連項目

8.3.5　デバッグを開始する手順

8.3.9　ステップの実行を中断しながらデバッグするときの操作

8.3.12　デバッグ時にステップ実行を中断またはスキップできない部品

8.3.14　デバッグ時にステッププロパティの値または戻り値を変更する手順

3.4.4　後続ステップ実行条件について

8.3.12　デバッグ時にステップ実行を中断またはスキップできない部品

デバッグ実行時に，ステップ実行を中断する操作をしても，ステップ実行を中断できない部品があります。中断できない部品の場合，該当ステップの後続ステップまで自動的にフローの処理が進みます。

表8‒5　部品ごとの中断可否

項番

部品名

中断可否

スキップ可否

1

基本部品

汎用コマンド実行部品

○

○

2

ファイル転送部品

○

○

3

繰り返し実行部品

○

○

4

メール通知部品

○

○

5

ユーザー応答待ち部品

○

○

6

標準出力部品

○

○

7

ターミナル接続部品

○

○

8

ターミナルコマンド実行部品

○

○

9

ターミナル切断部品

○

○

10

階層フロー部品

△

×

11

実行間隔制御部品

○

○

12

戻り値判定分岐部品

△

×

13

値判定部品

○

○

14

異常終了部品

○

○

15

値判定分岐部品

△

×

16

JavaScript実行部品

○

○

17

ファイルエクスポート部品

○

○

18

Webクライアント部品

○

○

19

コンテンツ部品

○

○

20

サービス部品

△

×※

21

JP1/AO 10-10よりも下位のバージョンで作成したサービステンプレートに含まれる，互換性のないステップ

×

×

（凡例）

○：中断またはスキップできます。 ×：中断またはスキップできません。 △：部品の実行前には中断できますが，実行後は中断できません。

注※

サービス部品を含むステップはスキップできませんが，配下のフローのステップをスキップできるかどうかは，各ステップに含まれる部品で決まります。

8.3.13　デバッグ時にプロパティマッピングの設定を確認する手順

デバッグ時に，サービスプロパティの値とステッププロパティの値が設計したとおりにマッピングされているかを確認します。

［デバッグ］エリアおよび［サービスプロパティ］タブを参照して，マッピング設定しているステッププロパティとサービスプロパティに，同じ値が指定されているかを確認できます。

デバッグ実行中に，マッピングの設定を確認する場合は，次のタイミングでプロパティの値を確認してください。

ステップの入力プロパティと，サービスの入力プロパティまたは変数のマッピング設定を確認する場合

ステップの処理を実行する前に，ステップが中断しているとき

ステップの出力プロパティと，サービスの出力プロパティまたは変数のマッピング設定を確認する場合

ステップの処理をスキップする場合に，ステップの出力プロパティおよび戻り値を指定したあと，ステップを再開したとき

ステップの処理の実行後に中断していたステップを再開したとき

図8‒9　プロパティマッピングの設定を確認する画面

プロパティマッピングの設定を確認するには：

フローエリアで，ステッププロパティの値を確認したいステップを選択します。

［デバッグ］エリアに，選択したステップの入力プロパティおよび出力プロパティが表示されます。

［Service Builder Debug］画面下部の，［サービスプロパティ］タブをクリックします。

サービスプロパティの値が表示されます。

［デバッグ］エリアおよび［サービスプロパティ］タブを相互に参照します。ステッププロパティのプロパティ値列と，マッピングされているサービスプロパティのプロパティ値列に，同じ値が表示されているかを確認します。

操作結果

プロパティの値がマッピングしたとおりに引き継がれているか，確認できます。設計とは異なるサービスプロパティがマッピングされている場合や，表示されている値に問題がある場合，［Service Builder Edit］画面で修正します。

重要

繰り返し実行部品のプロパティ「foreachMode」で「parallel」を指定している場合，並行して実行されている繰り返し実行フローの中で更新されたサービスプロパティの値は，［サービスプロパティ］タブに反映されません。

関連項目

8.3.9　ステップの実行を中断しながらデバッグするときの操作

8.3.16　デバッグ時のステッププロパティおよび戻り値の表示について

8.3.14　デバッグ時にステッププロパティの値または戻り値を変更する手順

ステップ実行の中断時に，ステッププロパティの値または戻り値を任意の値に変更します。部品を実行する前に入力プロパティを変更すると，異なるプロパティの値が入力されたときの，部品の処理を確認できます。部品を実行またはスキップしたあとに出力プロパティまたは戻り値を変更すると，異なるプロパティの値や戻り値が出力されたときの，後続ステップの処理やフローの遷移を確認できます。

ステッププロパティおよび戻り値を変更するための条件については，「8.3.10　ステップ実行の中断時に変更できるステップの情報」を参照してください。

デバッグ時にステッププロパティの値または戻り値を変更するには：

フローエリアで，状態が中断中になっているステップを選択します。

［デバッグ］エリアの［ステッププロパティ］エリアで，値を変更したいプロパティまたは戻り値の[図データ]をクリックします。

［ステッププロパティ編集］ダイアログボックスで，任意の値を指定します。ステッププロパティの値を変更する場合，［複数行］ラジオボタンで［はい］を選択すると，改行を含むプロパティ値を設定できます。

図8‒10　［ステッププロパティ編集］ダイアログボックス

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

操作結果

ステップを実行する操作をすると，指定したステッププロパティまたは戻り値に従ってデバッグタスクの処理が進みます。

ヒント

ステッププロパティの値は，プロパティファイルからインポートして設定することもできます。また，［Service Builder Debug］画面で設定した値をプロパティファイルにエクスポートできます。

ステッププロパティの値にサロゲートペア文字または制御文字（改行およびタブを除く）を指定することはできません。ただし，サービステンプレートの開発時にサロゲートペア文字または制御文字（改行およびタブを除く）を含むプロパティ値を指定していた場合，ステッププロパティの値として維持され，［デバッグ］エリアにも表示されます。

関連項目

8.3.15　［Service Builder Debug］画面でのステッププロパティのインポートおよびエクスポートについて

8.3.9　ステップの実行を中断しながらデバッグするときの操作

8.3.17　デバッグ時にステッププロパティの値を変更した場合の影響

8.3.15　［Service Builder Debug］画面でのステッププロパティのインポートおよびエクスポートについて

［Service Builder Debug］画面では，ステップの入力プロパティの値をプロパティファイルで設定したり，設定したステッププロパティおよび戻り値をプロパティファイルに出力したりできます。

ステッププロパティのインポート

［Service Builder Debug］画面の［インポート］ボタンをクリックすると，あらかじめ用意したプロパティファイルの設定値を［ステッププロパティ］エリアに反映できます。プロパティ値を反映できるのは，［ステッププロパティ］エリアで[図データ]が表示されているプロパティです。

［Service Builder Debug］画面でインポートする場合，プロパティに妥当でない値（データ型や制約条件を満たしていないプロパティ値）が1つでも定義されていると，インポート時にエラーになります。

次の場合，値の反映はスキップし，インポート完了後に「値の反映をスキップしたプロパティ」としてその件数が表示されます。

値を変更できないプロパティ（［ステッププロパティ］エリアで[図データ]が表示されていないプロパティ）

json形式のプロパティファイルで，「value」フィールドが定義されていないプロパティ

json形式のプロパティファイルで，「value」フィールドに「null」が定義されているプロパティ

また，選択したステップに存在しないプロパティが定義されている場合，インポート完了後に「ステップに存在しないプロパティ」としてその件数が表示されます。

ステッププロパティのエクスポート

［Service Builder Debug］画面の［エクスポート］ボタンをクリックすると，［ステッププロパティ］エリアに表示されているプロパティの値をプロパティファイルに出力できます。

このとき，出力されるプロパティファイルの名称は「step_properties.json」です。また，戻り値はプロパティキー「reserved.debugger.exitCode」として出力されます。

なお，ステッププロパティをエクスポートする場合，「type」フィールドは出力されません（サービス部品のステッププロパティを除く）。

関連項目

マニュアル『JP1/AO 運用ガイド』－「プロパティファイルについて」のトピック

8.3.16　デバッグ時のステッププロパティおよび戻り値の表示について

デバッグ時に，ステップの入力プロパティおよび出力プロパティの値が，［ステッププロパティ］エリアに表示される条件について説明します。

表8‒6　ステッププロパティの値が表示される条件

種別

表示されるステップ

表示されるタイミング

ステップの入力プロパティ

中断できる部品および値判定分岐部品を含むステップ

部品の実行が開始されたタイミング

ステップの出力プロパティ

中断できる部品を含むステップ

部品の処理が終了したタイミング

戻り値

すべてのステップ

部品の処理が終了したタイミング

関連項目

8.3.12　デバッグ時にステップ実行を中断またはスキップできない部品

8.3.17　デバッグ時にステッププロパティの値を変更した場合の影響

デバッグでステップの情報を変更する場合，変更できるのはステッププロパティの値および戻り値です。ステッププロパティの値を変更した場合でも，プロパティマッピングされているサービスプロパティの値が連動して変更されることはありません。ただし，ステップの出力プロパティを変更することで，出力プロパティのマッピングに従い，間接的にサービスプロパティ（出力プロパティまたは変数）の値が変更されることがあります。

例として，次のとおりサービステンプレートが定義されている場合に，ステップ実行でステップの入力プロパティおよび出力プロパティの値を変更したときの動作を示します。

図8‒11　サービステンプレートの構成例

プロパティマッピング定義

ステップA

サービスの入力プロパティ「入力1」とステップAの入力プロパティ「入力A1」をマッピング

ステップAの出力プロパティ「出力A1」とサービスの変数「変数1」をマッピング

ステップB

サービスの変数「変数1」とステップBの入力プロパティ「入力B1」をマッピング

サービスの入力プロパティ「入力1」とステップBの入力プロパティ「入力B2」をマッピング

ステップBの出力プロパティ「出力B1」とサービスの出力プロパティ「出力1」をマッピング

プロパティの値を変更したときの動作

ステップの入力プロパティを変更したときの動作

部品Aを実行する前に，ステップの入力プロパティ「入力A1」の値を変更した場合，部品Aは変更後の値で動作します。このとき，ステップの入力プロパティ「入力A1」にマッピングしているサービスの入力プロパティ「入力1」の値は変更されません。よって，ステップの入力プロパティ「入力B2」には変更前のサービスの入力プロパティに指定した値が入ります。

ステップの出力プロパティを変更したときの動作

部品Aを実行したあと，ステップの出力プロパティ「出力A1」の値を変更した場合，「出力A1」とマッピングしている変数「変数1」には，変更後の値が設定されます。また，ステップの入力プロパティ「入力B1」にも変更後の値が入ります。

8.3.18　応答待ち中のデバッグタスクの対処を入力する手順（応答入力）

デバッグタスクの実行中に応答入力が必要な場合，［デバッグ］エリアから応答を入力します。

応答待ち中のデバッグタスクの対処を入力するには：

デバッグタスクの状態が「応答待ち中」のときに，［デバッグ］エリアの［応答入力］ボタン[図データ]をクリックします。

［応答入力］ダイアログボックスでメッセージを確認し，実施したい操作のボタンをクリックします。

［情報］ダイアログボックスで，［OK］ボタンをクリックします。

操作結果

入力した応答内容に従って，応答待ち中のステップの部品処理が続行，または停止されます。

8.3.19　サービステンプレートをビルドしないで再度デバッグする手順

デバッグタスクを実行したあと，サービステンプレートを修正しないで再度デバッグ実行したい場合，［Service Builder Debug］画面を表示したまま，新しいデバッグタスクを実行できます。このとき，再度ビルドする必要はありません。

デバッグを再実行できるのは，デバッグタスクの状態が「正常終了」または「失敗」の場合です。デバッグタスクの実行中に新しいデバッグタスクを実行したい場合は，実行中のデバッグタスクを強制停止してください。

なお，デバッグを再実行すると，前に生成されたデバッグサービスおよびデバッグタスクは削除され，新しいデバッグサービスおよびデバッグタスクが生成されます。

ビルドしないで新しいデバッグタスクを実行するには：

［デバッグ］エリアの［再実行］プルダウンメニュー[図データ]で［最初からリトライ］を選択します。

［デバッグ実行］ダイアログボックスで，デバッグサービス・デバッグタスクの定義情報，タスクログの出力レベル，およびデバッグサービスのプロパティの情報を設定します。

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

操作結果

デバッグタスクが実行されます。

重要

［デバッグ実行］ダイアログボックスには，デバッグ実行するユーザーが最後にビルドしたときのサービステンプレートの状態が反映されます。デバッグ実行するユーザーがビルドしたあとで，ほかのユーザーが同一のサービステンプレートを編集し，ビルドしていた場合，その編集内容は反映されません。

サービステンプレートをビルドしないで再度デバッグ実行できるのは，［Service Builder Debug］画面を表示している場合だけです。 ［エディタへ戻る］ボタンをクリックしたり，JP1/AOからログアウトしたりして，［Service Builder Debug］画面を閉じた場合は，サービステンプレートを再度ビルドしてからデバッグ実行してください。

関連項目

8.3.2　サービステンプレートをデバッグする流れ

8.3.6　デバッグを開始するときの設定項目について

8.4.5　デバッグタスクを強制停止する手順

8.3.20　デバッグ時に失敗したステップからリトライする手順

デバッグタスクが途中で失敗した場合，失敗したステップからリトライします。

失敗したステップからリトライした場合，プロパティの値を引き継いだ状態で，同一のタスクIDでデバッグタスクを再開できます。例えば，一時的にネットワーク接続が切断されてステップの実行に失敗したあと，接続が復旧した場合など，失敗した原因が解決できたときに使用します。

プロパティ値を引き継ぐ際の例外や，デバッグタスクの状態によるリトライの可否など，リトライの詳細については，マニュアルJP1/AO 運用ガイド－「タスクのリトライについて」のトピックを参照してください。

デバッグ時に失敗したステップからリトライするには：

デバッグタスクの状態が「失敗」のときに，［デバッグ］エリアの［再実行］プルダウンメニュー[図データ]で［失敗したステップからリトライ］を選択します。

失敗したステップからリトライするかどうかを確認するダイアログボックスが表示されます。

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

関連トピック

失敗したステップからデバッグタスクが再実行されます。

関連項目

8.3.21　デバッグ時に失敗した次のステップからリトライする手順

マニュアル『JP1/AO 運用ガイド』－「タスクのリトライについて」のトピック

8.3.21　デバッグ時に失敗した次のステップからリトライする手順

デバッグタスクが途中で失敗した場合，失敗した次のステップからリトライします。

失敗した次のステップからリトライした場合，プロパティの値を引き継いだ状態で，同一のタスクIDでデバッグタスクを再開できます。失敗したステップを実行する必要がないときに使用します。失敗した次のステップからリトライすると，失敗したステップは正常終了したものとして処理されます。例えば，前のステップで摘出された問題点をいったん保留にして，デバッグタスクの実行を継続したい場合に使用します。

プロパティ値を引き継ぐ際の例外や，デバッグタスクの状態によるリトライの可否など，リトライの詳細については，マニュアルJP1/AO 運用ガイド－「タスクのリトライについて」のトピックを参照してください。

デバッグ時に失敗した次のステップからリトライするには：

デバッグタスクの状態が「失敗」のときに，［デバッグ］エリアの［再実行］プルダウンメニュー[図データ]で［失敗した次のステップからリトライ］を選択します。

失敗したステップからリトライするかどうかを確認するダイアログボックスが表示されます。

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

関連トピック

失敗した次のステップからデバッグタスクが再実行されます。

関連項目

8.3.20　デバッグ時に失敗したステップからリトライする手順

マニュアル『JP1/AO 運用ガイド』－「タスクのリトライについて」のトピック

8.3.22　デバッグタスクのフロー表示について

実行中のデバッグタスクを，フロー形式で表示できます。

［Service Builder Debug］画面のフローエリアに，ステップの実行順序が表示されます。

ステップアイコンには，ステップの状態アイコン，およびブレークポイントアイコン[図データ]が表示されます。階層フロー部品，繰り返し実行部品，またはサービス部品を含むステップの場合，ステップアイコンの右下に矢印アイコン[図データ]が表示され，クリックすると，配下のフローが表示されます。

また，ステップアイコンにマウスカーソルを重ねると，ステップ名およびステップの状態が表示されます。実行後のステップの場合，ステップの開始時刻，終了時刻，および戻り値も表示されます。

ヒント

ステップの状態については，マニュアルJP1/AO 運用ガイド－「ステップの状態一覧」のトピックを参照してください。

図8‒12　デバッグタスクのフロー表示

フローエリアでは，中断中のステップアイコンの枠が，次のように強調表示されます。

図8‒13　中断中のステップのアイコン（表示例）

フローエリアでは，中断できない部品のステップアイコンの背景が，次のように暗く表示されます。

図8‒14　中断できない部品のステップおよび繰り返し実行部品（実行前）の配下のフローにあるステップのアイコン（表示例）

サービステンプレートに階層構造がある場合，配下のフローのキャンバス上で右クリックをすると次のメニューが表示され，1つ上の階層またはルート階層に移動できます。

図8‒15　配下のフローのキャンバス上で右クリックしたときに表示されるメニュー

ステップアイコン上で右クリックをすると，次のメニューが表示され，ステップ実行の操作や，タスクログの表示のほか，［参照］から［ステップ参照］ダイアログボックスを表示できます。階層フロー部品，繰り返し実行部品，またはサービス部品の場合，［開く］を選択すると，配下のフローが表示されます。

図8‒16　ステップアイコン上で右クリックしたときに表示されるメニュー

図8‒17　［ステップ参照］ダイアログボックス

関連項目

8.3.24　デバッグ時の繰り返し実行フローの表示について

8.3.25　デバッグ時の繰り返し実行部品および繰り返し実行フローの表示情報について

8.3.23　デバッグタスクのフローツリー表示について

フローツリーの最上位には，サービステンプレート名が表示されます。その配下の階層は，階層フロー部品，繰り返し実行部品，またはサービス部品を使用したステップの名称で表示されます。

デバッグ実行中に，中断しているステップ（ユーザーの操作が必要な状態のステップ）がある階層には，中断アイコンが表示されます。

図8‒18　中断アイコンの表示例（階層フロー部品2に含まれるステップが中断している場合）

デバッグ実行中に，中断しているステップを探す場合は，フローツリーから中断アイコンが付いている階層を探してください。中断アイコンが付いている階層を選択し，表示されたフローの中から，中断しているステップを特定します。

なお，中断しているステップを含む階層よりも上位の階層のアイコンには，中断アイコンが表示されません。また，階層フロー部品や繰り返し実行部品自身を示すステップの状態および繰り返し実行フローの状態については，フローツリーに表示されません。

関連項目

8.3.24　デバッグ時の繰り返し実行フローの表示について

8.3.25　デバッグ時の繰り返し実行部品および繰り返し実行フローの表示情報について

8.3.24　デバッグ時の繰り返し実行フローの表示について

デバッグ実行時，繰り返し実行部品を実行するステップでは，繰り返し実行部品の配下の階層に，繰り返し回次ごとのフローが表示されます。これを「繰り返し実行フロー」と呼びます。繰り返し実行フローは，繰り返し実行部品の実行開始以降（実行中および実行後も含む）のタイミングでフローエリアおよび［フローツリー］エリアに表示されます。

繰り返し実行フローのフロー名は，「Step[繰り返しの回次番号]:繰り返し実行入力値（reserved.loop.input）」の形式で表示されます。ただし，繰り返し実行フローの表示名が64文字を超える場合，65文字目以降が切り捨てられます。繰り返し実行入力値に制御文字が含まれる場合は，制御文字が削除されたあと，65文字目以降が切り捨てられます。なお，繰り返しの回次番号は2桁で表示されます。

繰り返し実行部品の実行時に，繰り返し実行部品の繰り返し入力プロパティ（inputProperties）の値が「hostA,hostB,hostC」である場合の表示例を次に示します。この図の例では，フロー名が「Step[01]:hostA」，「Step[02]:hostB」，および「Step[03]:hostC」として表示されます。

図8‒19　繰り返し実行フローのフロー表示

図8‒20　繰り返し実行フローのフローツリー表示

なお，繰り返し実行方式の「parallel」または「serial」に関係なく，すべての回次分の繰り返し実行フローが一度に表示されます。

ただし，デバッグ中にログアウトした場合などは，それ以降，「繰り返し実行待ち」の状態である繰り返し実行フローについて，回次についての情報が表示されなくなることがあります。

繰り返し実行部品の実行前に，配下のフローに含まれるステップにブレークポイントを設定していた場合，実行後に展開された繰り返し実行フローの同じステップにもブレークポイントの設定が反映されます。繰り返し実行フローが展開されたあとで，繰り返し実行フロー内のステップに設定されたブレークポイントを設定または解除した場合，ほかの繰り返し実行フロー内の同じステップにも反映されます。

関連項目

8.3.24　デバッグ時の繰り返し実行フローの表示について

8.3.23　デバッグタスクのフローツリー表示について

8.3.25　デバッグ時の繰り返し実行部品および繰り返し実行フローの表示情報について

8.3.25　デバッグ時の繰り返し実行部品および繰り返し実行フローの表示情報について

デバッグ時に，繰り返し実行部品を含むステップの実行が開始されると，繰り返し実行部品および繰り返し実行フローの，次の情報が表示されます。なお，該当するステップの実行が開始されるまでは表示されません。

表8‒7　繰り返し実行フローの表示情報

項目

説明

繰り返し実行方式（parallel/serial）

繰り返し実行部品を含むステップのプロパティ「foreachMode」の値として表示されます。

繰り返し実行の回次（reserved.loop.index，reserved.loop.indexN）

繰り返し実行フローの名称として，繰り返し実行入力値とともに表示されます。

繰り返し実行部品を含むステップのプロパティ「inputProperties」で指定されたコンマ区切りのデータのうち，何番目のパラメータに対応する実行かを示します。予約プロパティreserved.loop.indexおよびreserved.loop.indexNの詳細については「3.6.8　予約プロパティ一覧」のトピックを参照してください。

繰り返し実行入力値（reserved.loop.input，reserved.loop.inputN）

繰り返し実行フローの名称として，繰り返し実行の回次とともに表示されます。※

繰り返し実行部品を含むステップのプロパティ「inputProperties」で指定された値が，コンマで区切られて，繰り返し実行フローの回次別に展開された値を示します。予約プロパティreserved.loop.inputおよびreserved.loop.inputNの詳細については「3.6.8　予約プロパティ一覧」のトピックを参照してください。

繰り返し実行結果（成功/失敗）

繰り返し実行部品を含むステップのプロパティ「outputResult」の値として表示されます。

繰り返し実行出力値（reserved.loop.output）

繰り返し実行部品を含むステップの出力プロパティ「outputProperties」として表示されます。

値は繰り返し実行フローの中の出力プロパティマッピングによって「reserved.loop.output」に指定されたものです。

注※

繰り返し実行フローの表示名が64文字を超える場合，65文字目以降が切り捨てられます。繰り返し実行入力値に制御文字が含まれる場合は，制御文字が削除されたあと，65文字目以降が切り捨てられます。

8.4　デバッグタスクを管理する

デバッグタスクに対しては，実行のほかに，次の操作ができます。

進捗状況の確認

詳細情報の確認

タスクログの確認およびダウンロード

実行停止

強制停止

削除

8.4.1　［タスク］画面からデバッグタスクの進捗状況を確認する手順

［タスク］画面から，デバッグタスクの進捗をフロー形式で確認します。例えば，［Service Builder Debug］画面を閉じたあとでデバッグタスクのステップの状態を確認する場合や，ほかのユーザーが実行したデバッグタスクのステップの状態を確認する場合などに，［タスク］画面から確認します。

［タスク］画面からデバッグタスクの進捗状況を確認するには：

［タスク］画面の［デバッグ］タブをクリックします。

［タスク］画面からデバッグタスクの進捗状況を確認する手順の詳細については，マニュアルJP1/AO 運用ガイド－「［タスク］画面からタスクの状態を確認する手順」のトピックを参照してください。

重要

デバッグタスクの最大保持期間が経過するか，通常のタスクとの合計数が最大保持数を超えた場合，1日1回，タスクの自動アーカイブと同じタイミングで，終了日時の古いデバッグタスクまたはタスクから順に自動削除（タスクの場合は自動アーカイブ）されます。デバッグタスクの保持期間，タスクとの合計の最大保持数，および自動削除のタイミングは，ユーザー設定プロパティファイル（config_user.properties）で変更できます。タスクの自動アーカイブについては，マニュアルJP1/AO 運用ガイド－「タスクの自動アーカイブ，履歴の自動削除について」のトピックを参照してください。

操作結果

デバッグタスクの進捗状況が確認できます。

関連項目

8.3.23　デバッグタスクのフローツリー表示について

8.3.24　デバッグ時の繰り返し実行フローの表示について

マニュアル『JP1/AO 構築ガイド』－「ユーザー設定プロパティファイル（config_user.properties）」のトピック

マニュアル『JP1/AO 運用ガイド』－「ステップの状態一覧」のトピック

8.4.2　［タスク詳細］画面からデバッグタスクの詳細を確認する手順

［タスク詳細］画面で，デバッグ時にサービスに設定されたプロパティの値や，タスクログなどを確認できます。例えば，［Service Builder Debug］画面を閉じたあとでこれらの情報を確認する場合や，ほかのユーザーが実行したデバッグタスクの詳細を確認する場合などに，［タスク詳細］画面から確認します。

［タスク詳細］画面からデバッグタスクの詳細を確認するには：

［タスク］画面の［デバッグ］タブをクリックします。

［タスク］画面からデバッグタスクの詳細を確認する手順の詳細については，マニュアルJP1/AO 運用ガイド－「タスクの詳細を確認する手順」のトピックを参照してください。

操作結果

デバッグタスクの詳細が確認できます。

8.4.3　デバッグタスクのタスクログを確認する手順

デバッグタスクのタスクログを確認します。デバッグタスクの状態が待機中の場合，タスクログは表示されません。なお，タスクログは任意のフォルダに，任意のファイル名でダウンロードできます。

実行中のデバッグタスクのタスクログを確認する場合は，［Service Builder Debug］画面から確認します。

終了したデバッグタスクのタスクログを確認する場合や，デバッグタスクを実行したユーザー以外のユーザーが確認する場合は，［タスク］画面から確認します。

タスクログの出力内容については，マニュアルJP1/AO 運用ガイド－「タスクログの詳細」のトピックを参照してください。

［Service Builder Debug］画面からデバッグタスクのタスクログを確認するには：

［Service Builder Debug］画面で，［タスクログ］タブをクリックします。

［タスクログ］タブに，デバッグ中のデバッグタスクのタスクログが表示されます。

図8‒21　［タスクログ］タブ

［タスクログ］タブでは，タスクログの表示内容を更新するタイミングを設定したり，タスクログをダウンロードしたりできます。操作方法を次に説明します。

タスクログをダウンロードする

［ダウンロード］ボタンをクリックします。

タスクログを手動で更新する

［更新］ボタンをクリックします。

タスクログを定期的に自動更新する

［自動更新する］をチェックします。

チェックすると，デバッグタスクの実行中に，ステップの状態，またはタスクの状態が変更されたタイミングで，タスクログが自動更新されます。

ヒント

フローエリアのステップアイコンを右クリックし，［ステップログ表示］を選択すると，ステップの結果が出力されている個所までタスクログがスクロールされます。

デバッグタスクを再度デバッグ実行した場合，またはリトライした場合は，［自動更新する］が自動的にチェックされ，タスクログが更新されます。

［自動更新する］をチェックしている場合，タスクの状態に関わらず，タスクログは再取得され，［タスクログ］タブのスクロールバーは最下部へ移動します。

［タスク］画面からデバッグタスクのタスクログを確認するには：

［タスク］画面の［デバッグ］タブをクリックします。

［タスク］画面からタスクログを確認する手順の詳細については，マニュアルJP1/AO 運用ガイド－「タスクの詳細を確認する手順」のトピックを参照してください。

重要

［タスク詳細］画面，および［Service Builder Debug］画面の［タスクログ］タブには，ユーザー設定プロパティファイル（config_user.properties）で指定したタスクログのサイズ（単位：KB）が，タスクログの末尾から算出して表示されます。タスクログのすべての内容は表示されません。

タスクログのサイズは，ユーザー設定プロパティファイル（config_user.properties）のデバッグタスク用ログファイルサイズの最大値（単位：KB）で設定できます。デバッグタスク用ログファイルサイズの最大値を超えた場合，タスクログの古い情報から上書きされます。

関連項目

マニュアル『JP1/AO 構築ガイド』－「ユーザー設定プロパティファイル（config_user.properties）」のトピック

8.4.4　デバッグタスクを実行停止する手順

実行中のデバッグタスクを実行停止します。タスクの状態が，実行中，応答待ち中，または異常検出の場合にデバッグタスクを実行停止できます。実行停止すると，デバッグタスクの状態が失敗となります。ただし，デバッグタスクの最後のステップを実行中にユーザーが実行停止をした場合，最後のステップが正常終了すると，デバッグタスクの状態も正常終了となります。

中断中のステップがある場合，自動的に再開され，ステップの実行が終了したあと，デバッグタスクが停止します。

ヒント

実行停止と強制停止の違いについては，マニュアルJP1/AO 運用ガイド－「タスクの管理」のトピックを参照してください。

デバッグタスクを実行停止するには：

［タスク］画面の［デバッグ］タブをクリックします。

タスク一覧から実行を停止したいデバッグタスクを選択します。

ヒント

タスク名横のチェックボックスで複数のデバッグタスクを選択できます。

［その他の操作］プルダウンメニューで，［実行停止］をクリックします。

［実行停止］ダイアログボックスで実行停止するデバッグタスクを確認し，［OK］ボタンをクリックします。

［情報］ダイアログボックスで，［OK］ボタンをクリックします。

操作結果

選択したデバッグタスクの状態が失敗となります。

8.4.5　デバッグタスクを強制停止する手順

実行中のデバッグタスクを強制停止します。デバッグタスクの状態が，実行中，応答待ち中，異常検出，または停止中の場合にデバッグタスクを強制停止できます。

実行中のデバッグタスクを停止して，デバッグを再度実行したい場合は，［Service Builder Debug］画面から強制停止します。

デバッグタスクの実行中にJP1/AOのWebブラウザーを閉じてしまった場合や，ほかのユーザーが実行したデバッグタスクを強制停止したい場合は［タスク］画面から強制停止します。

実行を強制停止すると，デバッグタスクの状態が失敗となります。

中断中のステップがある場合，自動的に再開されたあと，部品の処理は実行しないで，デバッグタスクが停止します。

ヒント

実行停止と強制停止の違いについては，マニュアルJP1/AO 運用ガイド－「タスクの管理」のトピックを参照してください。

［Service Builder Debug］画面からデバッグタスクを強制停止するには：

［Service Builder Debug］画面の［デバッグ］エリアで，［強制停止］ボタン[図データ]をクリックします。

［情報］ダイアログボックスで，［OK］ボタンをクリックします。

操作結果

デバッグタスクの状態が失敗となります。

［タスク］画面からデバッグタスクを強制停止するには：

［タスク］画面の［デバッグ］タブをクリックします。

タスク一覧から実行を強制停止したいデバッグタスクを選択します。

ヒント

タスク名横のチェックボックスで複数のデバッグタスクを選択できます。

［その他の操作］プルダウンメニューで，［強制停止］をクリックします。

［強制停止］ダイアログボックスで強制停止するデバッグタスクを確認し，［OK］ボタンをクリックします。

［情報］ダイアログボックスで，［OK］ボタンをクリックします。

操作結果

選択したデバッグタスクの状態が失敗となります。

8.4.6　デバッグタスクを削除する手順

必要がなくなったデバッグタスクを手動で削除します。タスクの状態が，正常終了，または失敗の場合にデバッグタスクを削除できます。

なお，デバッグタスクを自動で削除したい場合は，ユーザー設定プロパティファイル（config_user.properties）で，実行が終了したデバッグタスクを保持する期間を設定してください。

デバッグタスクを手動で削除するには：

［タスク］画面の［デバッグ］タブをクリックします。

タスク一覧から削除したいデバッグタスクを選択します。

ヒント

タスク名横のチェックボックスで複数のデバッグタスクを選択できます。

［その他の操作］プルダウンメニューで，［タスク削除］をクリックします。

［タスク削除］ダイアログボックスで削除するデバッグタスクを確認し，［OK］ボタンをクリックします。

操作結果

［デバッグ］タブから，デバッグタスクが削除されます。

関連項目

マニュアル『JP1/AO 構築ガイド』－「ユーザー設定プロパティファイル（config_user.properties）」のトピック

8.5　サービステンプレートの運用をテストする

サービステンプレートのデバッグが完了したら，サービステンプレートをリリースする前に，運用テストをします。

8.5.1　サービステンプレートの運用をテストする手順

サービステンプレートをデバッグし，問題がないことを確認したら，開発環境で運用テストをします。

サービステンプレートの運用をテストするには：

サービステンプレートをビルドしたあと，［サービス］画面で，サービスを作成します。

ヒント

［サービステンプレート選択］ダイアログボックスの［すべてのバージョンを表示］ボタンをクリックすると，ビルド済みの開発サービステンプレートが表示されるようになります。［最新バージョンのみ表示］ボタンをクリックしていると，リリースサービステンプレートしか表示されません。

サービスを実行します。

［タスク］画面から，実行結果を確認します。

運用テストの結果，サービステンプレートに問題点を発見した場合は，サービステンプレートまたは部品を編集します。

関連項目

マニュアル『JP1/AO 運用ガイド』－「サービスを作成する手順」のトピック

マニュアル『JP1/AO 運用ガイド』－「サービスの実行」のトピック

マニュアル『JP1/AO 運用ガイド』－「タスクの管理」のトピック

8.1.1　サービステンプレートを検証する流れ

8.1.2　ビルドとは

8.1.4　運用テストとは

8.2.1　サービステンプレートをビルドする手順

付録

付録A　参考情報

ここでは，JP1/AOを使用する上での参考となる情報について説明します。

付録A.1　デバッグおよびリリースの参考情報

(1)　デバッグおよびリリースの仕組みと違い

開発サービステンプレートをデバッグおよびリリースすると，サービステンプレートのパッケージが作成されます。サービステンプレートを検証したい場合にデバッグし，本番環境で実行できる状態にしたい場合にリリースします。

デバッグおよびリリースの仕組みを次の図に示します。

図A‒1　デバッグおよびリリースの仕組み

デバッグとリリースの違いを次の表に示します。

表A‒1　デバッグおよびリリースの違い

操作

目的

実行できる回数

サービステンプレートパッケージに設定される構成種別

サービステンプレートパッケージのファイル名

操作後の開発サービステンプレート編集可否

デバッグ

サービステンプレートを検証する

何回でも実行できる

デバッグ構成

ベンダーID_名称_バージョン_d.st

○

リリース

サービステンプレートを本番環境に適用する

1回

リリース構成

ベンダーID_名称_バージョン.st

×

（凡例）

○：編集できます。 × ：編集できません。

関連項目

(2)　デバッグおよびリリースによって設定されるサービステンプレートおよび部品の構成種別

(4)　サービステンプレートの構成種別とユーザーのロールによる画面表示可否の関係

(5)　ビルドまたはリリースする場合のサービステンプレート，サービス，タスクの削除・アーカイブ範囲

(2)　デバッグおよびリリースによって設定されるサービステンプレートおよび部品の構成種別

サービステンプレートパッケージ（*.st）内のサービステンプレートおよび部品には，デバッグまたはリリースに対応した構成種別が設定されています。サービステンプレートおよび部品に設定される構成種別を次の表に示します。

表A‒2　デバッグおよびリリースによって設定される構成種別

サービステンプレートおよび部品

設定される構成種別

デバッグした場合

リリースした場合

開発サービステンプレート

デバッグ構成

リリース構成

部品※

基本部品，リリース部品（リリース構成）

リリース構成

リリース構成

開発部品（デバッグ構成）

デバッグ構成

リリース構成

注※

部品は，単体ではデバッグおよびリリースできません。開発部品は，その部品を含むサービステンプレートがリリースされるとリリース部品になります。また，開発部品は，その部品を含むサービステンプレートがデバッグされた場合，開発部品のままです。

関連項目

(4)　サービステンプレートの構成種別とユーザーのロールによる画面表示可否の関係

(3)　同一のサービステンプレートまたは部品が複数あった場合のデバッグ・リリース時の動作

サービステンプレートの開発中にデバッグを繰り返す場合や，デバッグ後にリリースする場合など，同一のサービステンプレートまたは部品がすでにインポートされている場合があります。この場合，サービステンプレートまたは部品の構成種別によって，デバッグおよびリリース時の動作が異なります。

なお，「同一のサービステンプレート（同一の部品）」とは，ベンダーID，サービステンプレートID（部品ID），サービステンプレートのバージョン（部品のバージョン）が同一のものを指します。なお，部品は，サービステンプレートが使用している部品を指します。

サービステンプレートをデバッグした場合

サービステンプレートは，上書きされます。

デバッグするサービステンプレートに含まれる開発部品は，上書きされます。

デバッグするサービステンプレートに含まれるリリース部品は，上書きされません。

サービステンプレートをリリースした場合

サービステンプレートは，上書きされ，リリースサービステンプレートになります。

リリースするサービステンプレートに含まれる開発部品は，リリース部品になります。

リリースするサービステンプレートに含まれるリリース部品は，上書きされません。

(4)　サービステンプレートの構成種別とユーザーのロールによる画面表示可否の関係

サービステンプレートの構成種別とユーザーのロールによって，サービステンプレートおよびサービステンプレートから作成された管理対象（サービス，タスク，履歴）の［サービス］画面，［タスク］画面での表示可否が異なります。サービステンプレートの構成種別とユーザーのロールによる，画面の表示可否の関係を次の表に示します。

表A‒3　サービステンプレートの構成種別とユーザーのロールによる画面表示可否の関係

サービステンプレートの構成種別

管理対象

［サービス］画面および［タスク］画面での表示可否

Admin

Develop

Modify

Submit

デバッグ構成

サービステンプレート

○

×

×

サービス

○

×

×

タスク

○

×

×

履歴

○

×

×

リリース構成

サービステンプレート

○

○

×

サービス

○

○

○

タスク

○

○

○

履歴

○

○

△

（凡例）

○：操作・表示ともにできます。 △：表示だけはできます。 × ：操作・表示できません。

(5)　ビルドまたはリリースする場合のサービステンプレート，サービス，タスクの削除・アーカイブ範囲

開発サービステンプレートをビルドまたはリリースする場合，サービステンプレートおよびサービスは自動で削除され，タスクは自動でアーカイブされます。デバッグサービスおよびデバッグタスクは自動で削除されます。

なお，ビルドまたはリリースに失敗した場合でも，サービステンプレートおよびサービスは削除され，タスクはアーカイブされます。デバッグサービスおよびデバッグタスクは削除されます。

図A‒2　開発サービステンプレートをビルドまたはリリースする場合の削除・アーカイブ範囲

付録A.2　サービステンプレートの互換性について

上位または下位のJP1/AOとの互換性について説明します。

(1)　［Service Builder］画面で作成したサービステンプレートおよび部品の互換性について

［Service Builder］画面で作成したサービステンプレートおよび部品の互換性を，次に示します。

上位バージョンとの互換性

サービステンプレートは，上位互換性を保証します。つまり，［Service Builder］画面で扱えるのは次のとおりです。ただし，一部の表示や操作がバージョンによって異なる場合があります。

下位バージョンでユーザーが作成したサービステンプレートパッケージ(*.st)

下位バージョンからJP1/AOサーバにインポートされたサービステンプレートおよび部品

下位バージョンとの互換性

サービステンプレートは，下位互換性を保証しません。［Service Builder］画面で作成したサービステンプレートを下位バージョンのJP1/AOに適用しようとした場合，インポート時にエラーとなることがあります。

JP1/AOサーバのOSが異なる場合の互換性

ユーザーが作成したサービステンプレートは，OSの異なるJP1/AOサーバにインポートして利用できます。ただし，次の制限があります。

部品の入力プロパティのデフォルト値，およびフロー内の部品（ステップ）の入力プロパティの値に指定できるのは，ASCII文字だけです。

OSがLinuxのJP1/AOサーバにインポートできるのは，10-10以降のJP1/AOで作成されたサービステンプレートだけです。

(2)　下位バージョンのJP1/AOで作成したサービステンプレートに含まれるステップの互換性について

JP1/AO 10-10よりも下位のバージョンで作成したサービステンプレートに含まれるステップの一部は，JP1/AO 10-10と互換性がないため，処理内容の変更ができない場合があります。互換性のないステップは，次のように無彩色のアイコンで表示されます。

図A‒3　互換性のないステップのアイコン

ステップで定義されている処理内容は変更できません。変更できるのは，ステップID，ステップ名，説明だけです。

ステップIDの初期値は「compatible.step」です。

同一階層内に，互換性のないステップが複数ある場合は，ステップIDの末尾に「_n」（n:2から始まるユニークな整数）」が付き，「ステップID_n」の形式の値となります。ステップIDはシステムによって自動で付与されます。「_n」はフローの順とは関係しません。

ステップの説明の初期値は空文字です。

付録A.3　各バージョンの変更内容

(1)　11-51の変更内容

(a)　資料番号（3021-3-A90-41）の変更内容

プロパティのマッピングの予約プロパティの説明を変更した。

可視性またはデータ型によるマッピングの可否を変更した。

サービスの入力プロパティに設定する項目の説明を変更した。

ビルトインサービス共有プロパティの説明を変更した。

プロパティグループに設定する項目を変更した。

サービステンプレートを複製する場合のヒントを変更した。

部品の作成または編集時にコマンドラインに入力プロパティを挿入する際の説明を変更した。

スクリプトファイル作成時の注意を変更した。

ビルドをデバッグに変更した。

11-10の変更内容の階層フロー部品に関する説明を削除した。

(b)　資料番号（3021-3-A90-40）の変更内容

［入力プロパティマッピング］ダイアログボックスまたは［出力プロパティマッピング］ダイアログボックスで，［プロパティ参照］を選択した場合，マッピングできるプロパティだけが表示されるようになったため，説明を変更した。

(2)　11-50の変更内容

ステップに関する表示や手順の説明を変更した。

次のビルトインサービス共有プロパティの説明を削除した。

com.hitachi.software.dna.sys.jp1.username

com.hitachi.software.dna.sys.jp1.password

サービステンプレートをインポートする手順の補足説明を削除した。

コマンド実行時の注意事項を追加した。

(3)　11-10の変更内容

［Service Builder］画面を刷新した。

［サービス定義編集］ダイアログボックスで設定できる項目に「有効なアクション」を追加した。

［ステッププロパティ］エリアに表示される［次ステップ］タブの記載を追加した。

繰り返しステップの配下に，最大3 階層までの繰り返しステップの入れ子ができるように説明を変更した。

「ステップ作成」および「ステップ編集」画面内の［後続ステップ実行条件］－［条件］選択プルダウンメニューのラベルが変更になったため，説明を変更した。

階層フロー部品について後続ステップ実行条件を設定できるようになったため，説明を削除した。

後続ステップのアロー条件式についての記載を追加した。

階層フロー部品，実行間隔制御部品，戻り値判定分岐部品，異常終了部品についてプロパティ値が自動補完できるようになったため，説明を削除した。

繰り返し実行部品に関連する予約プロパティが表示される［予約プロパティ］ダイアログの記載を追加した。

予約プロパティ「reserved.loop.indexN」および「reserved.loop.inputN」を追加した。

繰り返し実行部品を入れ子で定義している場合の［参照プロパティ選択］画面の記載を追加した。

JP1/AOはJP1/AJS3を同梱しなくなったため，関連する戻り値についての説明を削除した。

実行間隔制御部品，戻り値判定分岐部品，異常終了部品，値判定分岐部品についてデバッグ時の中断またはスキップの可否の仕様が変更されたため，該当する記載を修正した。

繰り返し実行フローの表示情報に，予約プロパティ「reserved.loop.indexN」および「reserved.loop.inputN」の記載を追加した。

(4)　11-01の変更内容

インポートするサービステンプレートのファイルサイズについて説明を追加した。

部品作成および編集の際に，［システムアカウントで実行(Windows接続用)］を有効にすると，接続先ホストで実行するコマンドまたはスクリプトがSystemアカウントの権限で実行されることを追加した。

フローの情報表示の説明を変更した。

デバッグを開始する手順の注意事項を変更した。

ステップ実行の中断時の変更可否を変更した。

(5)　11-00の変更内容

(a)　資料番号（3021-3-087-40）からの変更内容

適用OSに次のOSを追加した。

Linux 7

Oracle Linux 6 (x64)

Oracle Linux 7

CentOS 6 (x64)

CentOS 7

SUSE Linux 12

適用OSから次のOSを削除した。

Linux 5 (AMD/Intel 64)

Linux 5 Advanced Platform (AMD/Intel 64)

32ビット版から64ビット版のWindowsに移行した。

Windows版JP1/AOおよび共通コンポーネントのインストール先フォルダを変更した。

英語環境または中国語環境でJP1/AOを運用する場合についての説明を追加した。

JP1/AOの操作画面の刷新に伴い，操作画面に合わせてマニュアルの構成や記載内容を変更した。

サービステンプレートをエクスポートする機能を追加した。

リリースサービステンプレートをサービス部品としてサービステンプレートのフローに配置できる機能を追加した。これに伴い，従来の部品とサービス部品を合わせてコンポーネントとした。

サービスプロパティの可視性および表示設定についての説明を追加した。

サービスプロパティの可視性および表示設定や，所属するプロパティグループを設定する機能を追加した。

ステッププロパティ同士をマッピングする機能を追加した。

プロパティマッピングの自動補完機能を追加した。

画面カスタムファイルとして，サービス概要の画像ファイルを設定する機能を追加した。

サービスリソースファイルで，次の項目を設定する機能を追加した。

サービスプロパティの名称

サービスプロパティの説明

ステッププロパティの名称

ステッププロパティの説明

プロパティマッピングについての説明を追加した。

プロパティの可視性またはデータ型によるマッピングの可否についての説明を追加した。

ステッププロパティをサービスプロパティに昇格する機能を追加した。

サービステンプレートおよびサービスの分類方法として「タグの管理」を追加した。これに伴い，「カテゴリの管理」を削除した。

リソースの管理として「サービスグループ」を追加した。これに伴い，「リソースグループ」を削除した。

サービスプロパティをインポート/エクスポートする機能を追加した。

デバッグ時，デバッグタスクを実行する機能としてステップイン，ステップオーバー，ステップリターン，およびブレークポイントの設定を追加した。

コンテンツ部品の戻り値71の説明に，次の原因を追加した。

実行ディレクトリへの移動に失敗した。

環境変数の設定に失敗した。

コンテンツ部品の戻り値72の説明に，「標準出力および標準エラー出力の合計が100KB を超えた。」を追加した。

(b)　資料番号（3021-3-363-10）からの変更内容

適用OSにLinuxを追加した。

Windows版JP1/AOおよび共通コンポーネントのインストール先フォルダを変更した。

32ビット版から64ビット版のWindowsに移行した。

JP1/AOの操作画面の刷新に伴い，操作画面に合わせてマニュアルの構成や記載内容を変更した。

部品バージョン管理機能の追加によって，部品バージョンの変更手順を追加した。

操作対象ホストがローカルホストの場合，ローカルホストのプロセスを直接起動してコマンドを実行したり，ファイルをコピーしたりできる，ローカル実行機能の説明を追加した。

操作対象の機器とのSSH接続で使用できる認証方式に，キーボードインタラクティブ認証を追加した。

リソースの管理として「サービスグループ」を追加した。これに伴い，「リソースグループ」を削除した。

サービステンプレートをエクスポートする機能を追加した。

リリースサービステンプレートをサービス部品としてサービステンプレートのフローに配置できる機能を追加した。これに伴い，従来の部品とサービス部品を合わせてコンポーネントとした。

サービスプロパティの可視性および表示設定についての説明を追加した。

サービスプロパティの可視性および表示設定や，所属するプロパティグループを設定する機能を追加した。

ステッププロパティ同士をマッピングする機能を追加した。

プロパティマッピングの自動補完機能を追加した。

画面カスタムファイルとして，サービス概要の画像ファイルを設定する機能を追加した。

サービスリソースファイルで，次の項目を設定する機能を追加した。

サービスプロパティの名称

サービスプロパティの説明

ステッププロパティの名称

ステッププロパティの説明

プロパティマッピングについての説明を追加した。

プロパティの可視性またはデータ型によるマッピングの可否についての説明を追加した。

ステッププロパティをサービスプロパティに昇格する機能を追加した。

サービステンプレートおよびサービスの分類方法として「タグの管理」を追加した。これに伴い，「カテゴリの管理」を削除した。

サービスプロパティをインポート/エクスポートする機能を追加した。

デバッグ時，デバッグタスクを実行する機能としてステップイン，ステップオーバー，ステップリターン，およびブレークポイントの設定を追加した。

コンテンツ部品の戻り値71の説明に，次の原因を追加した。

実行ディレクトリへの移動に失敗した。

環境変数の設定に失敗した。

コンテンツ部品の戻り値72の説明に，「標準出力および標準エラー出力の合計が100KB を超えた。」を追加した。

(6)　10-52の変更内容

(a)　資料番号（3021-3-087-40）の変更内容

適用OSにLinuxを追加した。

部品バージョン管理機能の追加によって，部品バージョンの変更手順を追加した。

操作対象ホストがローカルホストの場合，ローカルホストのプロセスを直接起動してコマンドを実行したり，ファイルをコピーしたりできる，ローカル実行機能の説明を追加した。

操作対象の機器とのSSH接続で使用できる認証方式に，キーボードインタラクティブ認証を追加した。

［コマンドライン］テキストボックスに指定できる文字についての説明を追加した。

(7)　10-50の変更内容

(a)　資料番号（3021-3-087-30）の変更内容

サービステンプレートの開発に，JP1/AOが提供するコンテンツ部品を使用したい場合の説明を追加した。

操作対象の機器との認証方式に公開鍵認証を追加した。

操作対象の機器のOSがWindowsの場合に，ユーザーのプロファイルが引き継がれないことの説明を追加した。

［コマンドライン］テキストボックスに，OS標準のスクリプト以外を実行する場合の説明を追加した。

(b)　資料番号（3021-3-363-10）の変更内容

2014年12月以降，マニュアル名称および資料番号を次のとおり変更した。

変更前

Job Management Partner 1/Automatic Operation 画面・コマンドリファレンス（3021-3-315）

変更後

Job Management Partner 1/Automatic Operation 画面・コマンド・APIリファレンス（3021-3-366）

適用OSにWindows Server 2012 R2を追加した。

サービステンプレートのデバッグを支援する機能を追加した。それに伴い，マニュアルの構成を変更した。

サービステンプレートの開発に，JP1/AO が提供するコンテンツ部品を使用したい場合の説明を追加した。

操作対象の機器との認証方式に公開鍵認証を追加した。

リリース部品を削除できるようにした。

予約プロパティの説明を追加した。また，次の予約プロパティを追加した。

reserved.loop.index

reserved.service.category

reserved.service.name

reserved.service.resourceGroupName

reserved.step.path

reserved.step.prevReturnCode

reserved.task.description

reserved.task.id

reserved.task.name

reserved.task.submitter

reserved.task.url

予約プロパティ「reserved.step.prevReturnCode」について，タスクをリトライする場合に，先行のステップを実行しないときの説明を追加した。

ステップまたは関連線の貼り付け時に引き継がれる情報として，後続ステップ実行条件を追加した。

WindowsおよびLinuxに加えて，AIX，HP-UXおよびSolarisで，コマンドまたはスクリプトを実行するコンテンツ部品に対応した。

コマンドまたはスクリプトを実行するユーザーについて，コンテンツ部品を使用する場合であることを明記した。

操作対象の機器のOSがWindowsの場合に，ユーザーのプロファイルが引き継がれないことの説明を追加した。

操作対象の機器のOSがUNIXの場合，コンテンツ部品を実行する際にrootユーザーに昇格するかどうかを選択する機能を追加した。

転送対象ファイルが転送される条件について説明を追加した。

転送対象ファイルを格納するフォルダをプロパティファイル（config_user.properties）で設定できるように変更した。

コンテンツ部品を実行する際に，操作対象機器のOSに，あらかじめインストールされている必要のあるコマンドについて追記した。

部品実行時にJP1/AOが通信で使用する文字セットのうち「ibm-943」を「ibm-943C」に変更した。

部品を実行する際に，操作対象の機器のOSに，あらかじめインストールされている必要のあるコマンドについて追記した。

予約部品プロパティ「plugin.suPassword」について，root権限で実行しない設定の場合の説明を追加した。

［コマンドライン］テキストボックスに，OS標準のスクリプト以外を実行する場合の説明を追加した。

コンテンツ部品のコマンドラインの指定方法について注意事項を追記した。

コンテンツ部品の戻り値についての説明を追加した。

実行したコマンドまたはスクリプトの戻り値，部品の戻り値，ステップの戻り値の関係についての説明を追加した。

部品として実行するコマンドまたはスクリプトが，0～63の範囲外の戻り値を返す場合に，その戻り値をフローの分岐条件に使用したいときの手順を追加した。

部品の標準出力についてのトピックを追加した。

実行ディレクトリのパスに空白が含まれる場合でも「"」や「'」で囲まないことを明記した。

(8)　10-12の変更内容

(a)　資料番号（3021-3-087-20）の変更内容

適用OSにWindows Server 2012 R2を追加した。

サービステンプレートのデバッグを支援する機能を追加した。それに伴い，マニュアルの構成を変更した。

予約プロパティ「reserved.step.prevReturnCode」について，タスクをリトライする場合に，先行のステップを実行しないときの説明を追加した。

ステップまたは関連線の貼り付け時に引き継がれる情報として，後続ステップ実行条件を追加した。

操作対象の機器のOSがUNIXの場合，コンテンツ部品を実行する際にrootユーザーに昇格するかどうかを選択する機能を追加した。

転送対象ファイルが転送される条件について説明を追加した。

転送対象ファイルを格納するフォルダをプロパティファイル（config_user.properties）で設定できるように変更した。

予約部品プロパティ「plugin.suPassword」について，root権限で実行しない設定の場合の説明を追加した。

コンテンツ部品の戻り値についての説明を追加した。

実行したコマンドまたはスクリプトの戻り値，部品の戻り値，ステップの戻り値の関係についての説明を追加した。

部品として実行するコマンドまたはスクリプトが，0～63の範囲外の戻り値を返す場合に，その戻り値をフローの分岐条件に使用したいときの手順を追加した。

(9)　10-11の変更内容

(a)　資料番号（3021-3-087-10）の変更内容

リリース部品を削除できるようにした。

予約プロパティの説明を追加した。また，次の予約プロパティを追加した。

reserved.loop.index

reserved.service.category

reserved.service.name

reserved.service.resourceGroupName

reserved.step.path

reserved.step.prevReturnCode

reserved.task.description

reserved.task.id

reserved.task.name

reserved.task.submitter

reserved.task.url

WindowsおよびLinuxに加えて，AIX，HP-UXおよびSolarisで，コマンドまたはスクリプトを実行するコンテンツ部品に対応した。

コマンドまたはスクリプトを実行するユーザーについて，コンテンツ部品を使用する場合であることを明記した。

コンテンツ部品を実行する際に，操作対象機器のOSに，あらかじめインストールされている必要のあるコマンドについて追記した。

部品実行時にJP1/AOが通信で使用する文字セットのうち「ibm-943」を「ibm-943C」に変更した。

部品を実行する際に，操作対象の機器のOSに，あらかじめインストールされている必要のあるコマンドについて追記した。

コンテンツ部品のコマンドラインの指定方法について注意事項を追記した。

部品の標準出力についてのトピックを追加した。

実行ディレクトリのパスに空白が含まれる場合でも「"」や「'」で囲まないことを明記した。

索引

J

JP1/AOが提供するサービステンプレートをそのまま使用する流れ[1], [2]

S

［Service Builder］画面[1]

［Service Builder］画面で作成したサービステンプレートおよび部品の互換性について[1]

［Service Builder］画面で割り込み操作があった場合の注意事項[1]

う

運用テストとは[1]

お

応答待ち中のデバッグタスクの対処を入力する手順（応答入力）[1]

か

下位バージョンのJP1/AOで作成したサービステンプレートに含まれるステップの互換性について[1]

開発環境[1]

開発サービステンプレート[1], [2]

開発サービステンプレートおよびリリースサービステンプレートとは[1]

開発サービステンプレートを削除する[1]

開発サービステンプレートを削除する手順[1]

開発部品[1]

概要[1]

可視性またはデータ型によるマッピングの可否について[1]

画面カスタムファイルの形式[1]

画面カスタムファイルをWebブラウザーのロケールごとに切り替えるには[1]

空のサービステンプレートを作成する手順[1]

環境変数を削除する手順[1]

環境変数を追加・編集する手順[1]

関連線が接続できない例[1]

き

基本部品[1]

こ

後続ステップ実行条件について[1]

後続ステップのアロー条件式について[1]

コマンドまたはスクリプトの戻り値をフローの分岐条件に使用する手順（戻り値が0～63の範囲外の場合）[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]

サービステンプレートを検証する流れ[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]

サービスリソースファイルが作成されていないロケールのWebブラウザーでサービステンプレートを表示した場合について[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]

そ

操作対象の機器に転送されるファイル（UNIXの場合）[1]

操作対象の機器に転送されるファイル（Windowsの場合）[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]

部品実行時にJP1/AOが通信で使用する文字セットについて[1]

部品実行時に設定される操作対象の機器のロケールについて[1]

部品実行時に特定の文字セットを設定したい場合[1]

部品実行時に必要なOSのコマンドについて[1]

部品とは[1]

部品の作成時に自動で生成される部品リソースファイルについて[1]

部品の実行ユーザー[1]

部品の出力プロパティに設定する項目について[1]

部品の種別と実施できる操作[1]

部品の定義情報として設定する項目について[1]

部品の定義情報を作成・編集する[1]

部品の定義情報を編集する手順[1]

部品の入力プロパティに設定する項目について[1]

部品の認証種別とは[1]

部品の表示情報と部品リソースファイルのプロパティとの対応[1]

部品の表示情報を設定する[1]

部品の標準出力について[1]

部品の編集時に更新される部品リソースファイルについて[1]

部品プロパティとは[1]

部品プロパティを削除する手順[1]

部品プロパティを設定する[1]

部品プロパティを追加する手順[1]

部品プロパティを編集する手順[1]

部品リソースファイルが作成されていないロケールのWebブラウザーで部品を表示した場合について[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], [2]

リリースとは[1]

リリース部品[1]

マニュアル発行元

株式会社 日立製作所

〒100-8280　東京都千代田区丸の内一丁目6番6号