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

手引・操作書

3021-3-087-40

前書き

対象製品

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

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

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

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

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

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

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

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

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

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

輸出時の注意

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

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

商標類

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

Adobe，およびFlashは，Adobe Systems Incorporated（アドビシステムズ社）の米国ならびに他の国における商標または登録商標です。

HP-UXは，Hewlett-Packard Development Company, L.P.のオペレーティングシステムの名称です。

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

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

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

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

Kerberosは，マサチューセッツ工科大学（MIT：Massachusetts Institute of Technology）で開発されたネットワーク認証のプロトコルの名称です。

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

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

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

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

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

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

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

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

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

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

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

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

VMware，vCenter Serverは，米国およびその他の地域における VMware, Inc. の登録商標または商標です。

VMware，VMware vSphere ESXは，米国およびその他の地域における VMware, Inc. の登録商標または商標です。

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

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

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

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

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

This product includes software developed by Andy Clark.

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

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

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

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

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

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

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

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

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

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

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

発行

2015年3月 3021-3-087-40

著作権

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

変更内容

変更内容（3021-3-087-40）JP1/Automatic Operation 10-52，JP1/Automatic Operation コンテンツセット 10-52

追加・変更内容

変更個所

適用OSにLinuxを追加した。

−

部品バージョン管理機能の追加によって，部品バージョンの変更手順を追加した。

1.2.2，1.4，1.4.2，1.6，3.3

操作対象ホストがローカルホストの場合，ローカルホストのプロセスを直接起動してコマンドを実行したり，ファイルをコピーしたりできる，ローカル実行機能の説明を追加した。

4.1.3，4.1.5，4.1.6，4.1.8，4.3.6

操作対象の機器とのSSH接続で使用できる認証方式に，キーボードインタラクティブ認証を追加した。

4.3.4，4.3.6，4.3.11

［コマンドライン］テキストボックスに指定できる文字についての説明を追加した。

4.3.10

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

はじめに

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

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

対象読者

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

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

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

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

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

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

表記

製品名

.NET Framework

.NET Framework 3.5

Microsoft(R) .NET Framework 3.5

Active Directory

Microsoft(R) Active Directory

Hyper-V

Microsoft(R) Hyper-V(R)

Internet Explorer

Microsoft Internet Explorer

Microsoft(R) Internet Explorer(R)

Windows Internet Explorer

Windows(R) Internet Explorer(R)

Windows※1

Windows 7

Microsoft(R) Windows(R) 7 Enterprise

Microsoft(R) Windows(R) 7 Professional

Microsoft(R) Windows(R) 7 Ultimate

Windows Server 2003※2

Windows Server 2003※2

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

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

Windows Server 2003 (x64)

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

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

Windows Server 2003 R2※3

Windows Server 2003 R2※3

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

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

Windows Server 2003 R2 (x64)

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

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

Windows Server 2008

Windows Server 2008 R2

Windows Server 2008 R2 Datacenter

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

Windows Server 2008 R2 Enterprise

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

Windows Server 2008 R2 Standard

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

Windows Server 2008 x64

Windows Server 2008 Datacenter x64

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

Windows Server 2008 Enterprise x64

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

Windows Server 2008 Standard x64

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

Windows Server 2008 x86

Windows Server 2008 Datacenter x86

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

Windows Server 2008 Enterprise x86

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

Windows Server 2008 Standard x86

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

Windows Server 2012

Windows Server 2012 Datacenter

Microsoft(R) Windows Server(R) 2012 Datacenter

Windows Server 2012 Standard

Microsoft(R) Windows Server(R) 2012 Standard

Windows Server 2012 R2

Windows Server 2012 R2 Datacenter

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

Windows Server 2012 R2 Standard

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

Windows Server Failover Cluster

Microsoft(R) Windows Server(R) Failover Cluster

Windows Vista

Microsoft(R) Windows Vista(R) Business

Microsoft(R) Windows Vista(R) Enterprise

Microsoft(R) Windows Vista(R) Ultimate

Windows XP

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

注※1

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

注※2

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

注※3

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

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

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

書式

説明

文字列

可変の値を示します。

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

［　］

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

［　］−［　］

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

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

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

「　」

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

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

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

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

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

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

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

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

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

/opt/jp1ao

/var/opt/jp1ao

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

/opt/HiCommand/Base64

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

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

1.1　概要

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

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

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

注※1

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

注※2

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

ポイント

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

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

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

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

ポイント

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

開発環境

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

本番環境

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

部品

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

サービステンプレート

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

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

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

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

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

フロー

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

ステップ

フローを構成する要素で，1つの部品を実行します。

サービステンプレートおよび部品の要素とプロパティマッピングについて説明します。

プロパティマッピングの例を次の図に示します。

図1‒3　サービステンプレートおよび部品の要素とプロパティマッピング

プロパティマッピング

サービステンプレートには，汎用的な運用手順が定義されています。そのため，サービステンプレートから追加したサービスには，ホスト名やリソースサイズなど，サービスの実行に必要な入力値を格納するためのプロパティが定義されています。これを，サービスの入力プロパティといいます。サービスの実行結果は，サービスの出力プロパティの値として，JP1/AOの操作画面に出力されます。

また，部品には，部品の実行に必要な入力値を格納する入力プロパティと，実行結果を格納する出力プロパティが定義されています。部品の入力プロパティは，直接値を入力する以外に，サービスの入力プロパティや変数と結び付けることで，値を引き継ぐことができます。

サービスの出力プロパティと部品の出力プロパティを結び付けることで，部品の実行結果をJP1/AOの操作画面で確認できます。このように，プロパティを結び付けて値を引き継ぐことを，プロパティマッピングといいます。

サービスの入力プロパティと部品の入力プロパティのマッピング

「図1‒3　サービステンプレートおよび部品の要素とプロパティマッピング」の例では，「サービスの入力プロパティ1」と「部品Aの入力プロパティ1」，「サービスの入力プロパティ2」と「部品Bの入力プロパティ2」をマッピングし，「部品Aの入力プロパティ2」にはマッピングの設定をしていません。

「サービスの入力プロパティ1」に入力した値が，「部品Aの入力プロパティ1」に入力されます。

「サービスの入力プロパティ2」に入力した値が，「部品Bの入力プロパティ2」に入力されます。

マッピングの設定をしていない「部品Aの入力プロパティ2」には，サービステンプレートを作成または編集したときに入力した値が設定されています。

サービスの出力プロパティと部品の出力プロパティのマッピング

「図1‒3　サービステンプレートおよび部品の要素とプロパティマッピング」の例では，「部品Aの出力プロパティ2」と「サービスの出力プロパティ2」，「部品Bの出力プロパティ1」と「サービスの出力プロパティ1」をマッピングしています。

「部品Aの出力プロパティ2」として出力された部品Aの実行結果（コマンドの標準出力，標準エラー出力，または出力プロパティ）が，「サービスの出力プロパティ2」にも出力され，ユーザーはJP1/AOの操作画面から部品Aの実行結果を確認できます。

「部品Bの出力プロパティ1」として出力された部品Bの実行結果（コマンドの標準出力，標準エラー出力，または出力プロパティ）が，「サービスの出力プロパティ1」にも出力され，ユーザーはJP1/AOの操作画面から部品Bの実行結果を確認できます。

変数と部品のプロパティのマッピング

「図1‒3　サービステンプレートおよび部品の要素とプロパティマッピング」では，「部品Aの出力プロパティ1」と「変数1」，「変数1」と「部品Bの入力プロパティ1」をマッピングしています。

「部品Aの出力プロパティ1」として出力された値が，「変数1」に格納されたあと，「部品Bの入力プロパティ1」に入力されます。これによって，部品Aの実行結果を部品Bの入力プロパティの値として引き継いで，処理に反映させることができます。

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

サービステンプレートの開発には，主に次の画面を使用します。

［エディタ］画面は，JP1/AOのメイン画面で［エディタ］タブを選択すると表示されます。

［エディタ］画面でサービステンプレートの作成，編集，または複製を開始します。空のサービステンプレートを作成したあと，または編集や複製をするサービステンプレートを選択したあと，サービステンプレートエディタ編集ビューで編集します。

サービステンプレートの編集が終わったら，サービステンプレートをビルドし，［デバッグ］ビューおよびサービステンプレートデバッグビューで，サービステンプレートをデバッグします。

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

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

画面の項目や入力制限などの詳細は，マニュアル「JP1/AO 画面・コマンド・APIリファレンス」を参照してください。

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

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

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

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

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

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

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

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

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

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

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

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

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

例えばこんなときに

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

作業に必要な知識

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

4.2.2　部品の作成または複製時に設定する項目について

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

2.2.2　サービステンプレートの作成または複製時に設定する項目について

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

6.2.1　リリースの概要

作業の流れ

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

作業

作業の要否

参照先

1

［エディタ］画面を表示する

必須

2.1.1　［エディタ］画面を表示する手順

2

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

必須

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

3

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

任意

4.2.1　部品を作成する手順

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

任意

4.5.1　部品を複製する手順

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

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

任意

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

4

サービスの定義情報を設定する

必須

2.2.3　サービスの定義情報を設定する手順

5

ステップを追加する

必須

3.2　ステップを追加する

6

関連線を接続する

必須

3.4　関連線を接続する

7

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

任意

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

8

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

必須

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

9

開発環境と本番環境が別の場合，サービステンプレートを本番環境にインポートする

任意

6.3.1　サービステンプレートを本番環境にインポートする手順（開発環境と本番環境が別の場合）

10

本番環境でサービスを追加・編集・実行する

必須

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

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

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

「サービスの実行」のトピック

注※

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

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

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

注意事項

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

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

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

作業内容

例えばこんなときに

参照先

検討する

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

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

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

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

サービステンプレートに値を入出力するためのプロパティを追加したいとき。

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

部品の編集

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

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

ステップが使用する部品のバージョンを変更したいとき。

ステップが使用する部品のバージョンを確認したいとき。

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

部品の新規作成

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

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

サービスの説明を表示する画面の内容を変更する流れ

［サービス詳細説明］画面に記載されている，仕様の詳細についての説明を変更したいとき。

［サービス詳細説明］画面に，注意事項を追加したいとき。

1.4.4　サービスの説明を表示する画面の内容を変更する流れ

サービステンプレートへの部品の追加

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

サービステンプレートで自動化している処理の途中に，実行間隔を制御する処理を追加したいとき。

1.4.5　サービステンプレートに処理を追加する流れ

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

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

JP1ユーザーマッピングの処理の流れで，一時ファイルを削除する処理が不要になったとき。

1.4.6　サービステンプレート中の処理を削除する流れ

自動処理する際のパラメータの動的な設定，または静的な設定

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

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

サービスの実行に伴い，コマンドが実行された際に，コマンドの標準出力および標準エラー出力の任意の文字列を抜き出して，［タスク詳細］ダイアログボックスに表示させたいとき。

1.4.7　自動処理する際のパラメータを，動的または静的に設定する場合の流れ

サービスリソースファイルを使用した表示情報の一括変更

サービスリソースファイルを使用して，サービステンプレートに定義されている複数の表示情報をまとめて定義したいとき。

1.4.8　サービスリソースファイルを使用してサービスの表示情報を設定する流れ

部品リソースファイルを使用した表示情報の一括変更

部品リソースファイルを使用して，部品に定義されている複数の表示情報をまとめて定義したいとき。

1.4.9　部品リソースファイルを使用して部品の表示情報を設定する流れ

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

サービステンプレートの定義情報とは，JP1/AOの操作画面に表示されるサービステンプレートの名称や入力プロパティ，出力プロパティなどのことです。

例えばこんなときに

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

サービステンプレートに値を入出力するためのプロパティを追加したいとき。

作業に必要な知識

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

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

6.2.1　リリースの概要

作業の流れ

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

作業

作業の要否

参照先

1

［エディタ］画面を表示する

必須

2.1.1　［エディタ］画面を表示する手順

2

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

任意

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

3

サービステンプレートの定義情報（サービス，プロパティグループ，入力プロパティ，出力プロパティおよび変数に関する設定）を変更する

必須

2.2.3　サービスの定義情報を設定する手順

4

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

任意

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

5

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

必須

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

6

開発環境と本番環境が別の場合，サービステンプレートを本番環境にインポートする

任意

6.3.1　サービステンプレートを本番環境にインポートする手順（開発環境と本番環境が別の場合）

7

本番環境でサービスを追加・編集・実行する

必須

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

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

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

「サービスの実行」のトピック

注※

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

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

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

例えばこんなときに

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

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

ステップが使用する部品のバージョンを変更したいとき。

ステップが使用する部品のバージョンを確認したいとき。

作業に必要な知識

4.1.2　基本部品，リリース部品，開発部品とは

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

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

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

6.2.1　リリースの概要

作業の流れ

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

作業

作業の要否

参照先

1

［エディタ］画面を表示する

必須

2.1.1　［エディタ］画面を表示する手順

2

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

任意

4.5.1　部品を複製する手順

3

部品を一覧表示して，編集する部品を選択する

必須

4.1.1　部品を一覧表示する手順

4

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

必須

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

5

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

任意

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

6

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

任意

3.3　ステップとして使用している部品のバージョンを管理する

7

部品を編集することで，サービスの定義情報に影響がある場合，サービスの定義情報を設定する

任意

2.2.3　サービスの定義情報を設定する手順

8

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

任意

3.2　ステップを追加する

9

部品を編集することで，処理の流れに影響がある場合，関連線を接続・削除する

任意

3.4　関連線を接続する

10

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

任意

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

11

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

必須

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

12

開発環境と本番環境が別の場合，サービステンプレートを本番環境にインポートする

任意

6.3.1　サービステンプレートを本番環境にインポートする手順（開発環境と本番環境が別の場合）

13

本番環境でサービスを追加・編集・実行する

必須

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

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

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

「サービスの実行」のトピック

注※

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

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

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

例えばこんなときに

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

作業に必要な知識

4.1.2　基本部品，リリース部品，開発部品とは

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

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

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

6.2.1　リリースの概要

作業の流れ

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

作業

作業の要否

参照先

1

［エディタ］画面を表示する

必須

2.1.1　［エディタ］画面を表示する手順

2

部品を作成する

必須

4.2.1　部品を作成する手順

3

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

必須

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

4

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

任意

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

5

部品を新規作成することで，サービスの定義情報に影響がある場合，サービスの定義情報を設定する

任意

2.2.3　サービスの定義情報を設定する手順

6

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

必須

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

7

関連線を接続する

必須

3.4.1　関連線を接続する手順

8

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

任意

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

9

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

必須

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

10

開発環境と本番環境が別の場合，サービステンプレートを本番環境にインポートする

任意

6.3.1　サービステンプレートを本番環境にインポートする手順（開発環境と本番環境が別の場合）

11

本番環境でサービスを追加・編集・実行する

必須

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

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

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

「サービスの実行」のトピック

注※

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

1.4.4　サービスの説明を表示する画面の内容を変更する流れ

［サービス一覧］画面，［サービス追加］ダイアログボックス，または［サービス編集］ダイアログボックスでサービスを選択し，［サービス詳細説明表示］ボタンをクリックすると，選択したサービスの説明が別画面で表示されます。サービスの説明を変更するには，画面カスタムファイルを作成・編集し，［サービス詳細説明］画面の表示内容を変更します。

例えばこんなときに

［サービス詳細説明］画面に記載されている，仕様の詳細についての説明を変更したいとき。

［サービス詳細説明］画面に，注意事項を追加したいとき。

作業に必要な知識

2.2.7　画面カスタムファイルとは

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

6.2.1　リリースの概要

作業の流れ

表1‒6　サービスの説明を表示する画面の内容を変更する流れ

作業

作業の要否

参照先

1

［エディタ］画面を表示する

必須

2.1.1　［エディタ］画面を表示する手順

2

サービスの説明を表示する画面内容を定義するため，画面カスタムファイルを設定する

必須

2.2.6　画面カスタムファイルを設定する手順

3

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

任意

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

4

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

必須

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

5

開発環境と本番環境が別の場合，サービステンプレートを本番環境にインポートする

任意

6.3.1　サービステンプレートを本番環境にインポートする手順（開発環境と本番環境が別の場合）

6

本番環境でサービスを追加・編集・実行する

必須

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

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

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

「サービスの実行」のトピック

注※

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

1.4.5　サービステンプレートに処理を追加する流れ

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

例えばこんなときに

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

サービステンプレートで自動化している処理の途中に，実行間隔を制御する処理を追加したいとき。

作業に必要な知識

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

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

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

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

6.2.1　リリースの概要

作業の流れ

表1‒7　サービステンプレートに処理を追加する流れ

作業

作業の要否

参照先

1

［エディタ］画面を表示する

必須

2.1.1　［エディタ］画面を表示する手順

2

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

任意

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

3

処理の流れを定義するため，［フロー］ビューを表示する

必須

3.1.1　［フロー］ビューを表示する手順

4

ステップを追加する

必須

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

5

処理の実行順序に合わせて，関連線を接続する

必須

3.4.1　関連線を接続する手順

6

ステップを追加したことで，サービスプロパティを変更する必要がある場合，サービスの定義情報を修正する

任意

2.2.3　サービスの定義情報を設定する手順

7

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

任意

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

8

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

必須

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

9

開発環境と本番環境が別の場合，サービステンプレートを本番環境にインポートする

任意

6.3.1　サービステンプレートを本番環境にインポートする手順（開発環境と本番環境が別の場合）

10

本番環境でサービスを追加・編集・実行する

必須

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

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

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

「サービスの実行」のトピック

注※

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

1.4.6　サービステンプレート中の処理を削除する流れ

既存のサービステンプレートに含まれるフローから，不要なステップを削除できます。

例えばこんなときに

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

JP1ユーザーマッピングの処理の流れで，一時ファイルを削除する処理が不要になったとき。

作業に必要な知識

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

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

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

6.2.1　リリースの概要

作業の流れ

表1‒8　サービステンプレート中の処理を削除する流れ

作業

作業の要否

参照先

1

［エディタ］画面を表示する

必須

2.1.1　［エディタ］画面を表示する手順

2

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

任意

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

3

処理の流れを定義するため，［フロー］ビューを表示する

必須

3.1.1　［フロー］ビューを表示する手順

4

不要なステップを削除する

必須

3.4.2　ステップまたは関連線を削除する手順

5

ステップを削除したことで，処理の実行順序を変更する必要がある場合，関連線を接続し直す

任意

3.4　関連線を接続する

6

ステップを削除したことで，サービスの定義情報を変更する必要がある場合，サービスの定義情報を変更する

任意

2.2.3　サービスの定義情報を設定する手順

7

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

任意

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

8

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

必須

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

9

開発環境と本番環境が別の場合，サービステンプレートを本番環境にインポートする

任意

6.3.1　サービステンプレートを本番環境にインポートする手順（開発環境と本番環境が別の場合）

10

本番環境でサービスを追加・編集・実行する

必須

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

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

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

「サービスの実行」のトピック

注※

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

1.4.7　自動処理する際のパラメータを，動的または静的に設定する場合の流れ

部品のプロパティにサービスプロパティをマッピングすることで，入力プロパティの値を代入して処理を実行できます。入力プロパティの値は固定することもできます。また，部品の処理終了時に，部品の出力結果を，サービステンプレートの出力プロパティまたは変数に格納するための定義ができます。

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

例えばこんなときに

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

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

サービスの実行に伴い，コマンドが実行された際に，コマンドの標準出力および標準エラー出力の任意の文字列を抜き出して，［タスク詳細］ダイアログボックスに表示させたいとき（出力プロパティの動的な設定）。

作業に必要な知識

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

3.2.3　ステップの定義情報として設定する項目について

2.2.5　マッピングパラメータの定義例とデータの流れについて

3.2.3　ステップの定義情報として設定する項目について

6.2.1　リリースの概要

作業の流れ

表1‒9　自動処理する際のパラメータを，動的または静的に設定する場合の流れ

作業

作業の要否

参照先

1

［エディタ］画面を表示する

必須

2.1.1　［エディタ］画面を表示する手順

2

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

任意

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

3

ステップを選択し，定義情報のうち，プロパティマッピングを変更する

必須

3.2.2　ステップの定義情報を変更する手順

4

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

任意

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

5

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

必須

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

6

開発環境と本番環境が別の場合，サービステンプレートを本番環境にインポートする

任意

6.3.1　サービステンプレートを本番環境にインポートする手順（開発環境と本番環境が別の場合）

7

本番環境でサービスを追加・編集・実行する

必須

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

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

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

「サービスの実行」のトピック

注※

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

1.4.8　サービスリソースファイルを使用してサービスの表示情報を設定する流れ

JP1/AOの操作画面に表示されるサービステンプレートの情報は，サービスリソースファイルで設定できます。

例えばこんなときに

サービスリソースファイルを使用して，サービステンプレートに定義されている複数の表示情報をまとめて定義したいとき。

作業に必要な知識

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

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

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

6.2.1　リリースの概要

作業の流れ

表1‒10　サービスリソースファイルを使用してサービスの表示情報を設定する流れ

作業

作業の要否

参照先

1

［エディタ］画面を表示する

必須

2.1.1　［エディタ］画面を表示する手順

2

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

任意

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

3

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

必須

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

4

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

任意

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

5

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

必須

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

6

開発環境と本番環境が別の場合，サービステンプレートを本番環境にインポートする

任意

6.3.1　サービステンプレートを本番環境にインポートする手順（開発環境と本番環境が別の場合）

7

本番環境でサービスを追加・編集・実行する

必須

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

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

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

「サービスの実行」のトピック

注※

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

1.4.9　部品リソースファイルを使用して部品の表示情報を設定する流れ

JP1/AOの操作画面に表示される部品の情報は，部品リソースファイルで設定できます。

例えばこんなときに

部品リソースファイルを使用して，部品に定義されている複数の表示情報をまとめて定義したいとき。

作業に必要な知識

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

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

4.6.3　部品の表示情報と部品リソースファイルのプロパティとの対応

6.2.1　リリースの概要

作業の流れ

表1‒11　部品リソースファイルを使用して部品の表示情報を設定する流れ

作業

作業の要否

参照先

1

［エディタ］画面を表示する

必須

2.1.1　［エディタ］画面を表示する手順

2

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

任意

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

3

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

必須

4.6.1　部品リソースファイルを設定する手順

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

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

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

例えばこんなときに

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

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

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

作業に必要な知識

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

作業の流れ

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

作業

作業の要否

参照先

1

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

必須

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

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

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

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

2

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

必須

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

3

サービスを追加・編集・実行する

必須

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

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

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

「サービスの実行」のトピック

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

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

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

機能

概要

説明個所

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

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

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

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

2.2　サービステンプレートを作成・編集する

サービステンプレートの一覧表示

サービステンプレートを一覧表示できます。

2.3　サービステンプレートを一覧表示する

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

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

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

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

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

2.5　サービステンプレートを削除する

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

サービステンプレート名や説明など，サービステンプレートの表示情報をサービスリソースファイルで設定できます。

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

フロー管理

ステップの追加

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

3.2　ステップを追加する

関連線の接続

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

3.4　関連線を接続する

ステップに使用している部品のバージョン管理

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

3.3　ステップとして使用している部品のバージョンを管理する

部品管理

部品の一覧表示

部品を一覧表示できます。

4.1　部品を一覧表示する

部品の作成

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

4.2　部品を作成する

部品の編集

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

4.3　部品を編集する

部品の削除

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

4.4　部品を削除する

部品の複製

部品を複製できます。複製した部品を編集して新たに部品を作成できます。

4.5　部品を複製する

部品の表示情報の設定

部品名や説明など，部品の表示情報を部品リソースファイルで設定できます。

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

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

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

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

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

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

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

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

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

ビルドしたサービステンプレートからサービスを追加・実行し，運用上の問題点を摘出できます。運用テストで問題点を発見した場合は，［エディタ］画面から，サービステンプレートまたは部品を編集します。

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

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

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

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

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

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

開発環境と本番環境が別のサーバの場合に，リリースしたサービステンプレートを本番環境にインポートします。

6.3　サービステンプレートを本番環境にインポートする（開発環境と本番環境が別の場合）

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

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

2.1　［エディタ］画面を表示する

2.1.1　［エディタ］画面を表示する手順

サービステンプレートは［エディタ］画面で開発します。［エディタ］画面は［部品］ビューと［サービステンプレートエディタホーム］ビューに分かれています。

図2‒1　［エディタ］画面

操作できる権限およびロール：

AdminロールまたはDevelopロールを持つユーザー

［エディタ］画面を表示するには：

JP1/AOにログインして，メイン画面を表示します。

メイン画面で［エディタ］タブを選択します。

［エディタ］画面が表示されます。

JP1/AOが提供するサービステンプレートの詳細については，マニュアル「JP1/AO サービステンプレートリファレンス」を参照してください。

関連トピック

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

2.1.5　［エディタ］画面で作成したサービステンプレートおよび部品の互換性について

2.1.4　［エディタ］画面で割り込み操作があった場合の動作

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

［エディタ］画面では，サービステンプレートを次の2種類に分けて管理しています。

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

ユーザーが作成中のサービステンプレートです。リリースサービステンプレートを複製して作成したサービステンプレートも，開発サービステンプレートに含まれます。［サービステンプレート一覧］ダイアログボックスの［開発］タブに表示されます。

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

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

開発サービステンプレートをリリースすることで，JP1/AOサーバにインポートされたサービステンプレートです。または，JP1/AOが提供するサービステンプレートです。本番環境で実際に使用します。構成種別には「リリース」が設定されています。［サービステンプレート一覧］ダイアログボックスの［リリース］タブに表示されます。

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

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

注意事項

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

関連トピック

2.1.3　サービステンプレートの構成種別と実行できる操作の差異

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

2.1.3　サービステンプレートの構成種別と実行できる操作の差異

開発サービステンプレートとリリースサービステンプレートでは，構成種別と実行できる操作が異なります。

表2‒1　サービステンプレートの構成種別と実行できる操作の差異

種別

構成種別

サービステンプレートに対する操作

一覧表示

作成

編集

複製

参照

削除

ビルド

リリース

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

デバッグ

○　

○　

○　

○　

○　

○　※

○　

○　

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

リリース

○　

×　

×　

○　

○　

×　

×　

×　

（凡例）

○：操作できます。　×：操作できません。

注※

開発サービステンプレートからサービスを追加し，生成されたタスクが実行中の場合は削除できません。

2.1.4　［エディタ］画面で割り込み操作があった場合の動作

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

2.1.5　［エディタ］画面で作成したサービステンプレートおよび部品の互換性について

［エディタ］画面で作成したサービステンプレートおよび部品の互換性を，次に示します。

上位バージョンとの互換性

サービステンプレートは，上位互換性を保証します。つまり，［エディタ］画面で扱えるのは次のとおりです。ただし，一部の表示や操作がバージョンによって異なる場合があります。

下位バージョンでユーザーが作成したサービステンプレートパッケージ(*.st)

下位バージョンからJP1/AOサーバにインポートされたサービステンプレートおよび部品

下位バージョンとの互換性

サービステンプレートは，下位互換性を保証しません。［エディタ］画面で作成したサービステンプレートを下位バージョンのJP1/AOに適用しようとした場合，インポート時にエラーとなることがあります。

JP1/AOサーバのOSが異なる場合の互換性

ユーザーが作成したサービステンプレートは，OSの異なるJP1/AOサーバにインポートして利用できます。ただし，次の制限があります。

部品の入力プロパティのデフォルト値，およびフロー内の部品（ステップ）の入力プロパティの値に指定できるのは，ASCII文字だけです。

OSがLinuxのJP1/AOサーバにインポートできるのは，10-10以降のJP1/AOで作成されたサービステンプレートだけです。

2.1.6　下位バージョンのJP1/AOで作成したサービステンプレートに含まれるステップの互換性について

JP1/AO 10-10よりも下位のバージョンで作成したサービステンプレートに含まれるステップの一部は，JP1/AO 10-10と互換性がないため，処理内容の変更ができない場合があります。互換性のないステップは，次のように無彩色のアイコンで表示されます。

図2‒5　互換性のないステップのアイコン

ステップで定義されている処理内容は変更できません。変更できるのは，ステップID，ステップ名，説明だけです。

ステップIDの初期値は「compatible.step」となります。

同一階層内に，互換性のないステップが複数ある場合は，ステップIDの末尾に「_n」（n:2から始まるユニークな整数）」が付き，「ステップID_n」の形式の値となります。ステップIDはシステムによって自動で付与されます。「_n」はフローの順とは関係しません。

ステップの説明の初期値は空文字になります。

2.2　サービステンプレートを作成・編集する

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

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

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

［サービステンプレートエディタホーム］ビューの［作業の開始］で，［作成］をクリックします。

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

なお，［サービステンプレートID］,［サービステンプレートバージョン］，［ベンダーID］は作成後に変更できません。

空のサービステンプレートを作成したあと，引き続き，サービスの定義情報の設定や，フローの作成・編集をします。

関連トピック

2.2.2　サービステンプレートの作成または複製時に設定する項目について

2.2.3　サービスの定義情報を設定する手順

3.　フローを作成・編集する

2.2.2　サービステンプレートの作成または複製時に設定する項目について

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

表2‒2　［サービステンプレート作成］ダイアログボックスおよび［サービステンプレート複製］ダイアログボックスで設定する項目

項目

説明

サービステンプレート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.4.2　サービステンプレートおよび部品の一意性について

2.2.3　サービスの定義情報を設定する手順

［サービス定義編集］ダイアログボックスで，サービステンプレート名やベンダー名などの情報，プロパティグループ，入力プロパティ，出力プロパティおよび変数についての情報を設定します。

サービステンプレートエディタ編集ビューを表示していない場合の手順：

［サービステンプレートエディタホーム］ビューの［作業の開始］で，［編集］をクリックします。

［サービステンプレート一覧］画面でサービステンプレートを選択し，［編集］ボタンをクリックします。

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

サービステンプレートエディタ編集ビューで［サービス定義編集］ボタンをクリックします。

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

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

注意事項

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

関連トピック

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

2.2.5　マッピングパラメータの定義例とデータの流れについて

2.1.4　［エディタ］画面で割り込み操作があった場合の動作

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

［サービス定義編集］ダイアログボックスで，サービス，プロパティグループ，入力プロパティ，出力プロパティおよび変数を設定します。

サービスの実行に必要なパラメータを指定したり，サービスの実行結果を取得したりするために「サービスプロパティ」を使用します。サービスプロパティには「入力プロパティ」や「出力プロパティ」が含まれます。

表2‒3　［サービス定義編集］ダイアログボックスで設定する項目

項目

説明

サービス

サービステンプレート名，ベンダー名，説明，カテゴリ名，および画面カスタムファイルを設定できます。

プロパティグループ

プロパティグループによって，［サービス設定］ダイアログボックスおよび［サービス実行］ダイアログボックスに表示されるプロパティをグループごとに分類できます。

1つのサービステンプレートに対して，プロパティグループは，最大5個まで定義できます。

入力プロパティ※

サービスの実行に必要な入力値を格納するためのプロパティを定義できます。

出力プロパティ※

サービスの実行結果を格納するためのプロパティを定義できます。

変数※

部品間の処理で値を引き継ぐために設定するワーク用の変数です。

注※

1つのサービステンプレートに対して，入力プロパティ，出力プロパティおよび変数は，合計100個まで定義できます。

「サービス」の関連トピック

2.2.2　サービステンプレートの作成または複製時に設定する項目について

2.2.6　画面カスタムファイルを設定する手順

2.2.7　画面カスタムファイルとは

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

「入力プロパティ」・「出力プロパティ」・「変数」の関連トピック

2.2.9　サービスに定義するプロパティ（サービスプロパティ）

「入力プロパティ」の関連トピック

2.2.10　サービス共有プロパティを追加する手順

2.2.11　サービス共有プロパティとは

2.2.12　サービス共有プロパティを定義する場合の注意事項

2.2.13　ビルトインサービス共有プロパティとは

2.2.14　プロパティの可視性とは

2.2.5　マッピングパラメータの定義例とデータの流れについて

マッピングパラメータ定義とは，サービスの入出力プロパティと，部品の入出力プロパティおよび変数を結び付けることです。マッピングパラメータを定義すると，サービスの実行時に指定するプロパティの値を，部品の入力プロパティの値として代入し，処理を実行できます。また，部品の処理終了時に，部品の出力結果をサービステンプレートの出力プロパティまたは変数に格納できます。

マッピングパラメータの定義例と，各プロパティ間でどのようにデータが受け渡しされるかを説明します。

条件

ここでは，次のように，ある部品を実行するサービステンプレートを作成する場合の例を説明します。

部品のプロパティは次のとおり定義されています。

表2‒4　部品Aの定義

プロパティの種別

プロパティ名

入力プロパティ

容量

実行対象サーバ

出力プロパティ

部品の出力結果

表2‒5　部品Bの定義

プロパティの種別

プロパティ名

入力プロパティ

実行対象サーバ

格納先フォルダパス

プロパティ「実行対象サーバ」および「格納先フォルダパス」の値は，サービス実行時に指定します。

プロパティ「容量」の値は「10」で，変更する必要がなく，固定です。

サービスの実行後，部品Aの出力結果を［タスク詳細］ダイアログボックスで確認します。

定義内容

［サービス定義編集］ダイアログボックスで，サービスを次のとおり定義します。

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

プロパティの種別

プロパティ名

入力プロパティ

サーバ名

格納先フォルダパス

出力プロパティ

サービスの実行結果

部品Aおよび部品Bをステップとしてフローに追加します。その後，［ステップ編集］ダイアログボックスで次のとおり設定します。

表2‒7　ステップAの定義

プロパティ名

マッピングパラメータ

容量

10

実行対象サーバ

「サーバ名」のプロパティキー

部品の出力結果

「サービスの実行結果」のプロパティキー

表2‒8　ステップBの定義

プロパティ名

マッピングパラメータ

実行対象サーバ

「サーバ名」のプロパティキー

格納先フォルダパス

「格納先フォルダパス」のプロパティキー

実行対象サーバ，部品の出力結果，および格納先フォルダパスに，［サービス定義編集］ダイアログボックスで定義したプロパティがマッピングされます。

データの流れ

各プロパティのデータの流れを次に示します。

図2‒6　各プロパティのデータの流れ

［サービス実行］ダイアログボックスで指定した「サーバ名」の値が，部品Aおよび部品Bの「実行対象サーバ」の値として格納されます。

［サービス実行］ダイアログボックスで指定した「格納先フォルダパス」の値が，部品Bの「格納先フォルダパス」の値として格納されます。

部品Aの「部品の出力結果」が，［タスク詳細］ダイアログボックスの「サービスの実行結果」に表示されます。

部品Aおよび部品Bの「実行対象サーバ」が，［タスク詳細］ダイアログボックスの「サーバ名」に表示されます。

部品Bの「格納先フォルダパス」が，［タスク詳細］ダイアログボックスの「格納先フォルダパス」に表示されます。

2.2.6　画面カスタムファイルを設定する手順

［サービス定義編集］ダイアログボックスで，画面カスタムファイルを選択することで，［サービス詳細説明］画面に表示される内容を定義できます。画面カスタムファイルには，単一または複数のファイルを設定できます。例えば，図やリンクを設定したい場合は，複数のファイルまたはフォルダをzip形式に圧縮して登録します。単一ファイルを設定する場合と複数ファイルを設定する場合で，設定方法が異なります。

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

画面カスタムファイルとして単一ファイルを設定するには：

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

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

画面カスタムファイルとして複数ファイルを設定するには：

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

「ja」フォルダを.zip形式に圧縮します。

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

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

［サービス詳細説明画面のファイル名（相対パス）］フィールドに，［サービス詳細説明］画面として表示したいファイルのパスを入力します。

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

ポイント

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

関連トピック

2.2.7　画面カスタムファイルとは

2.2.7　画面カスタムファイルとは

画面カスタムファイルとは，［サービス詳細説明］画面に表示される内容を定義するファイルです。［サービス定義編集］ダイアログボックスで画面カスタムファイルを設定すると，［サービス詳細説明］画面に表示される内容を設定できます。次の図に，［サービス詳細説明］画面の表示例を示します。

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

関連トピック

2.2.6　画面カスタムファイルを設定する手順

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

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

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

指定できる拡張子

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

.html

.js

.css

.swf

.jpeg

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

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

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

マルチバイト文字

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

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

2.2.9　サービスに定義するプロパティ（サービスプロパティ）

サービスのプロパティを定義することで，サービスの実行に必要なパラメータを指定したり，サービスの実行結果を取得したりできます。サービスプロパティには次の種類があります。

入力プロパティ

サービスの実行に必要な入力値を格納するためのプロパティを定義できます。独自のプロパティを定義するほか，サービス共有プロパティを利用することもできます。入力プロパティには，プロパティキーやプロパティ名のほか，プロパティの可視性なども指定できます。入力プロパティは次のダイアログボックスで定義します。

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

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

出力プロパティ

サービスの実行結果を格納するためのプロパティを定義できます。出力プロパティは次のダイアログボックスで定義します。

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

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

変数

部品間の処理で値を引き継ぐために設定するワーク用の変数です。変数は次のダイアログボックスで定義します。

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

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

入力プロパティおよび出力プロパティは，次のダイアログボックスでサービスプロパティとして表示されます。

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

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

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

［サービス共有プロパティ］ビュー（サービス共有プロパティの場合）

サービスの入力プロパティおよび出力プロパティに格納できる値の最大値は1,024文字です。

入力プロパティおよび出力プロパティのマッピング

ステップの編集時に，［入力プロパティマッピング］ダイアログボックスまたは［出力プロパティマッピング］ダイアログボックスで，部品プロパティにサービスプロパティをマッピングすることで，JP1/AOの操作画面で入力したサービスプロパティの値を部品プロパティに設定したり，部品プロパティの値を画面に表示したりできます。

変数のマッピング

ステップの編集時に，［出力プロパティマッピング］ダイアログボックスで，値を引き継ぎたい部品の出力プロパティを変数にマッピングします。そして，［入力プロパティマッピング］ダイアログボックスで，あとに実行する部品の入力プロパティに変数をマッピングすることで値を引き継げます。

関連トピック

2.2.11　サービス共有プロパティとは

2.2.13　ビルトインサービス共有プロパティとは

2.2.14　プロパティの可視性とは

2.2.10　サービス共有プロパティを追加する手順

サービステンプレートのプロパティにサービス共有プロパティを追加すると，ほかのサービスとプロパティを共有できます。JP1/AOであらかじめ定義されているサービス共有プロパティ（ビルトインサービス共有プロパティ）や，すでにインポートされているサービステンプレートが持つサービス共有プロパティを追加することもできます。

新規のサービス共有プロパティを追加するには：

［サービス定義編集］ダイアログボックスで［入力プロパティ一覧］の［追加］ボタンをクリックします。

［サービスの入力プロパティ作成］ダイアログボックスの「スコープ」で［サービス共有プロパティ］をチェックします。

定義済みのサービス共有プロパティを追加するには：

［サービス定義編集］ダイアログボックスで［入力プロパティ一覧］の［サービス共有プロパティの選択］ボタンをクリックします。

［サービス共有プロパティ選択］ダイアログボックスで，追加したいサービス共有プロパティを選択し，［OK］ボタンをクリックします。

関連トピック

2.2.11　サービス共有プロパティとは

2.2.12　サービス共有プロパティを定義する場合の注意事項

2.2.13　ビルトインサービス共有プロパティとは

2.2.11　サービス共有プロパティとは

サービス共有プロパティは，ほかのサービスと値を共有して参照したり，更新したりできるサービスプロパティです。

［サービスの入力プロパティ作成］ダイアログボックスまたは［サービスの入力プロパティ編集］ダイアログボックスの「スコープ」で「サービス共有プロパティ」をチェックした場合のサービスプロパティです。同じプロパティキーのサービス共有プロパティであれば，ほかのサービスと共有している値を参照したり，更新したりできます。

サービスおよびタスクが参照するサービス共有プロパティの値は，システムで保持しているプロパティ値です。

サービス共有プロパティの値は，JP1/AOシステム内で1つです。そのため，リソースグループごとに異なる値を設定できません。サービステンプレートから複数のサービスを追加して，別々のリソースグループに割り当てた場合でも，リソースグループ間でサービス共有プロパティの値は共有されます。

プロパティの値は，［サービス設定］ダイアログボックス，［サービス実行］ダイアログボックス，および［サービス共有プロパティ］ビューで設定することもできます。なお，［サービス実行］ダイアログボックスで設定したプロパティの値は，そのサービスから生成されるタスクにだけ有効です。そのため，［サービス実行］ダイアログボックスで設定した内容は，ほかのサービスが参照しているサービス共有プロパティの値に影響しません。またサービスの実行後に，［サービス共有プロパティ］ビューなどで，プロパティ値を変更した場合でも，実行したサービスのプロパティ値には影響しません。

次の図にサービス共有プロパティを設定した場合の有効範囲を示します。

図2‒8　サービス共有プロパティを設定した場合の有効範囲

次の図にサービス共有プロパティを設定しない場合の有効範囲を示します。

図2‒9　サービス共有プロパティを設定しない場合の有効範囲

「スコープ」の［サービス共有プロパティ］をチェックしなかった場合，プロパティに指定した値は，対象のサービス内でだけ有効です。プロパティの値は，［サービス設定］ダイアログボックスおよび［サービス実行］ダイアログボックスで設定できます。

また，サービス共有プロパティのうち，JP1/AOであらかじめ定義されているものをビルトインサービス共有プロパティと呼びます。

関連トピック

2.2.13　ビルトインサービス共有プロパティとは

2.2.12　サービス共有プロパティを定義する場合の注意事項

サービス共有プロパティを定義するときは次の点に注意してください。

サービス共有プロパティの値を設定する場合

プロパティ名および説明は，［サービス定義編集］ダイアログボックスで定義された値が，［サービス設定］ダイアログボックスと［サービス実行］ダイアログボックスにそれぞれ反映されます。

プロパティキーは，システム内でユニークとなるように，ドメイン名をトップレベルドメイン名から逆順で「.」区切りで指定してください。また，プロパティキーにドメイン名を使用しない場合は，値を共有しないほかのプロパティとプロパティキーが重複しないようにしてください。

サービス共有プロパティのプロパティ名および説明以外の値を変更したい場合は，次の手順で変更してください。

1. 変更したいサービス共有プロパティを含むサービステンプレートを，JP1/AOからすべて削除します。

2. サービス共有プロパティの値を変更したサービステンプレートを，JP1/AOに追加します。

サービス共有プロパティの値が変更になります。

すでに登録されているサービス共有プロパティと，同一キーのサービス共有プロパティをサービステンプレートに設定した場合の動作を説明します。

最初にビルド，リリース，またはimportservicetemplateコマンドでインポートしたサービステンプレートに定義されているサービス共有プロパティの［デフォルト値］に設定した値が，サービス共有プロパティに設定されます。その後は，［サービス共有プロパティ］ビュー，［サービス設定］ダイアログボックス，［サービス実行］ダイアログボックスで値を指定できます。

すでに登録されているサービス共有プロパティと，プロパティ名，説明，デフォルト値が異なっても問題ありません。プロパティ名，説明，デフォルト値以外の項目が異なると，ビルド，リリース，またはインポート時にエラーとなります。

すでに登録されているサービス共有プロパティと値が異なる場合，サービステンプレートのプロパティとして，プロパティ名，説明を表示する場合に限り，指定した値が反映されます。

［サービス共有プロパティ選択］ダイアログボックスで選択したサービス共有プロパティは，デフォルト値が空の状態で追加されます。デフォルト値は，［サービスの入力プロパティ編集］ダイアログボックスで設定してください。

サービス共有プロパティにプロパティグループを設定する場合

サービス共有プロパティは，サービステンプレートごとに任意のプロパティグループに分類できます。複数のサービステンプレートで，同じプロパティグループに分類する必要はありません。

2.2.13　ビルトインサービス共有プロパティとは

ビルトインサービス共有プロパティには，JP1/AOシステムで使用する項目があらかじめ定義されています。ビルトインサービス共有プロパティはほかのプロパティと異なり，サービスやタスクとは関係しません。ビルトインサービス共有プロパティを参照するJP1/AOの各機能が動作するときに，設定されている値を使用します。

なお，ビルトインサービス共有プロパティはサービスのサービス共有プロパティとして定義して，タスク内で参照することもできます。その場合は，ほかのサービス共有プロパティと同様に，サービス実行時の値が参照されます。

ビルトインサービス共有プロパティをサービスのサービス共有プロパティとして定義する場合は［サービス定義編集］ダイアログボックスで行います。［サービス定義編集］ダイアログボックスで［サービス共有プロパティの選択］ボタンをクリックすると，ビルトインサービス共有プロパティの一覧が表示されます。

ビルトインサービス共有プロパティには次の種類があります。

表2‒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.jp1.username

JP1ユーザー名

サービスを実行するJP1ユーザー名を設定します。[ビルトインサービス共有プロパテイ]

11

com.hitachi.software.dna.sys.jp1.password

JP1ユーザーのパスワード

サービスを実行するJP1ユーザーのパスワードを設定します。[ビルトインサービス共有プロパテイ]

12

com.hitachi.software.dna.sys.task.log.level

タスクのログ出力レベル

タスクのログ出力レベルを設定します。[ビルトインサービス共有プロパテイ]

13

com.hitachi.software.dna.sys.ssh.privatekey.passphrase

秘密鍵のパスフレーズ（SSH公開鍵認証用）

SSH公開鍵認証で使用する秘密鍵のパスフレーズを指定します。[ビルトインサービス共有プロパテイ]

注※

ビルトインサービス共有プロパティのプロパティ名および説明に任意の値を指定すると，［サービス設定］ダイアログボックスおよび［サービス実行］ダイアログボックスでの表示内容を変更できます。ただし，［サービス共有プロパティ］ビューに表示される内容は，インストール時の内容から変更されません。

各プロパティの詳細な情報を次に示します。

表2‒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

false

−　

−　

−　

−　

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.jp1.username

string

インストール時にユーザーが指定した値

true

1

31

^[a-zA-Z0-9!#¥$%&¥-¥.@_`~]+$

−　

11

com.hitachi.software.dna.sys.jp1.password

password

インストール時にユーザーが指定した値

true

6

32

^[a-zA-Z0-9!#¥$%&'¥(¥)¥*¥+,¥-¥.¥/;<=>¥?@¥[¥]¥^_`¥{¥|¥}~]+$

−　

12

com.hitachi.software.dna.sys.task.log.level

list

10

true

−　

−　

−　

0,10,20,30,40

13

com.hitachi.software.dna.sys.ssh.privatekey.passphrase

password

−　

false

0

1,024

制限なし

−　

（凡例）

−：該当しません。

2.2.14　プロパティの可視性とは

サービスプロパティでは，プロパティの可視性を指定できます。また，可視性は入力プロパティに指定できます。

サービスプロパティにプロパティの可視性を指定すると，JP1/AOの操作画面でプロパティを表示したり，非表示にしたりできます。プロパティを表示できるJP1/AOの操作画面を次に示します。

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

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

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

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

例えば，サービスを実行するユーザーが意識する必要のないプロパティを，［サービス実行］ダイアログボックスに表示しないようにできます。

プロパティの可視性は，［サービスの入力プロパティ編集］ダイアログボックスおよび［サービスの入力プロパティ作成］ダイアログボックスで設定できます。プロパティの可視性として，configまたはexecを指定できます。

config

［サービス設定］ダイアログボックスの入力項目として表示したいプロパティに指定してください。

exec

［サービス設定］ダイアログボックスおよび［サービス実行］ダイアログボックスの入力項目として表示したいプロパティに指定してください。

［タスク詳細］ダイアログボックスでサービス実行時に指定したプロパティ値を確認したり，サービス共有プロパティとして定義していると［サービス共有プロパティ］ビューでプロパティ値を設定したりできます。

プロパティの可視性とログインユーザーの権限によって，JP1/AOの各画面にプロパティが表示されます。

表2‒11　［サービス設定］ダイアログボックスでの表示可否

サービスプロパティの種類

可視性

ログインユーザーのロールごとの表示可否

Adminロール，Developロール

Modifyロール

Submitロール

サービス共有プロパティでない場合

config

○　

○　

×　

exec

○　

○　

×　

サービス共有プロパティの場合

config

○　

○　

×　

exec

○　

○　

×　

（凡例）

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

表2‒12　［サービス実行］ダイアログボックスでの表示可否

サービスプロパティの種類

可視性

ログインユーザーのロールごとの表示可否

Adminロール，Developロール

Modifyロール

Submitロール

サービス共有プロパティでない場合

config

×　

×　

×　

exec

○　

○　

○　

サービス共有プロパティの場合

config

×　

×　

×　

exec

○　

○　

○　

（凡例）

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

表2‒13　［タスク詳細］ダイアログボックスでの表示可否

サービスプロパティの種類

可視性

ログインユーザーのロールごとの表示可否

Adminロール，Developロール

Modifyロール

Submitロール

サービス共有プロパティでない場合

config

○　

○　

×　

exec

○　

○　

○　

サービス共有プロパティの場合

config

○　

○　

×　

exec

○　

○　

○　

（凡例）

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

表2‒14　［サービス共有プロパティ］ビューでのプロパティの表示可否

サービスプロパティの種類

可視性

ログインユーザーのロールごとの表示可否

Adminロール，Developロール

Modifyロール

Submitロール

サービス共有プロパティでない場合

config

×　

×　

×　

exec

×　

×　

×　

サービス共有プロパティの場合

config

○　

×　

×　

exec

○　

×　

×　

（凡例）

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

2.2.15　編集中に別のサービステンプレートを参照する手順

開発サービステンプレートやリリースサービステンプレートの設定内容を別の画面で参照しながら，サービステンプレートを編集できます。参照用の画面は読み取り専用で開くため，既存のサービステンプレートを誤って編集しないようにできます。

［エディタ］画面からサービステンプレートの参照画面を開くには：

［サービステンプレートエディタホーム］ビューの［作業の開始］で，［参照］をクリックします。

［サービステンプレート一覧］ダイアログボックスで参照したいサービステンプレートを選択し，［参照］ボタンをクリックします。

別の画面でサービステンプレートの参照画面が表示されます。

サービステンプレートの編集中に別のサービステンプレートの参照画面を開くには：

［サービステンプレートエディタホーム］ビューの［作業の開始］で，［編集］をクリックします。

［サービステンプレート一覧］ダイアログボックスで編集したいサービステンプレートを選択し，［編集］ボタンをクリックします。

［操作］プルダウンメニューで［参照］を選択します。

［サービステンプレート一覧］ダイアログボックスで参照したいサービステンプレートを選択し，［参照］ボタンをクリックします。

別の画面でサービステンプレートの参照画面が表示されます。

2.3　サービステンプレートを一覧表示する

2.3.1　サービステンプレートを一覧表示する手順

サービステンプレートを編集，複製，参照，または削除するときに，サービステンプレートの一覧が表示されます。

サービステンプレートを一覧表示するには：

［サービステンプレートエディタホーム］ビューの［作業の開始］で，［編集］，［複製］，［参照］，または［削除］をクリックします。

［サービステンプレート一覧］ダイアログボックスが表示されます。

開発サービステンプレートとリリースサービステンプレートが，別のタブで一覧表示されます。なお，［編集］または［削除］をクリックして表示される画面には開発サービステンプレートだけが表示されます。

［サービステンプレート一覧］ダイアログボックスでは，表示列や件数を指定したり，最新バージョンのサービステンプレートだけを表示したりできます。

関連トピック

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

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

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

開発サービステンプレートまたはリリースサービステンプレートの設定内容はそのまま保ち，別の開発サービステンプレートとして複製します。既存のサービステンプレートを基に新たなサービステンプレートを開発する場合や，サービステンプレートのバージョンアップ版を作成する場合に利用できます。

サービステンプレートを複製するには：

［サービステンプレートエディタホーム］ビューの［作業の開始］で，［複製］をクリックします。

［サービステンプレート一覧］ダイアログボックスで複製したいサービステンプレートを選択し，［複製］ボタンをクリックします。

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

［情報］ダイアログボックスで，［OK］ボタンをクリックします。

サービステンプレートが複製され，サービステンプレートエディタ編集ビューが表示されます。

ベンダーID，サービステンプレートID，サービステンプレートバージョンのうち，少なくとも1つは変更しないと，サービステンプレートを複製できません。サービステンプレートは，これら3つの項目の組み合わせによって一意性が保証されています。また，「com.hitachi.software.dna」で始まるベンダーIDはJP1/AOによって予約されているため指定できません。複製元のサービステンプレートのベンダーIDが「com.hitachi.software.dna」で始まる場合は，複製時に「ベンダーID」および「ベンダー名」が削除されます。

関連トピック

2.2.2　サービステンプレートの作成または複製時に設定する項目について

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

マニュアル「JP1/AO 運用ガイド」の「サービステンプレートにプリセットプロパティを追加する手順」のトピック

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

サービステンプレートおよび部品は，次の3つの項目の組み合わせによって一意性が保証されています。

ベンダーID

サービステンプレートID（部品ID）

サービステンプレートのバージョン（部品のバージョン）

この3つの項目は，開発サービステンプレート（開発部品）と，リリースサービステンプレート（リリース部品）を区別しないで，一元的に管理されています。このため，すでにあるリリースサービステンプレート（リリース部品）のベンダーID，サービステンプレートID（部品ID），およびサービステンプレートバージョン（部品バージョン）がすべて一致しているサービステンプレートおよび部品は，作成したり複製したりできません。

図2‒10　サービステンプレートのバージョン管理

2.5　サービステンプレートを削除する

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

開発サービステンプレートを削除すると，サービステンプレートの定義がJP1/AOサーバから削除されて［開発サービステンプレート］の一覧からも削除されます。

注意事項

サービステンプレートがほかのユーザーによって編集中の場合でも，サービステンプレートを削除できます。対象のサービステンプレートがほかのユーザーによって編集中でないか確認してから削除してください。

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

［サービステンプレートエディタホーム］ビューの［作業の開始］で，［削除］をクリックします。

［サービステンプレート一覧］ダイアログボックスで削除したいサービステンプレートを選択し，［削除］ボタンをクリックします。

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

削除対象の開発サービステンプレートが使用している開発部品およびリリース部品については，ほかのサービステンプレートで使用されていても使用されていなくても，削除されません。不要になった開発部品およびリリース部品は，部品単位で削除してください。

削除対象の開発サービステンプレートをビルドして作成されたサービスや，そのサービスのタスクがある場合，サービスはすべて削除され，タスクはアーカイブされます。タスクが実行中である場合はエラーとなり，削除に失敗します。また，削除対象の開発サービステンプレートをデバッグする際に作成されたデバッグサービスおよびデバッグタスクがある場合，すべて削除されます。デバッグタスクが実行中である場合はエラーとなり，削除に失敗します。

対象の開発サービステンプレートがほかのユーザーによって，すでにリリースされていた場合はエラーとなり，削除に失敗します。

関連トピック

2.5.2　リリースサービステンプレートを削除する手順

4.4.1　部品を削除する手順

2.1.4　［エディタ］画面で割り込み操作があった場合の動作

2.5.2　リリースサービステンプレートを削除する手順

リリースサービステンプレートを削除したい場合はdeleteservicetemplateコマンドを実行します。

関連トピック

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

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

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

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

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

［サービステンプレートエディタホーム］ビューの［作業の開始］で，［編集］をクリックします。

［サービステンプレート一覧］ダイアログボックスでサービステンプレートを選択し，［編集］ボタンをクリックします。

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

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

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

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

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

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

注意事項

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

関連トピック

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

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

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

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

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

サービスリソースファイルのファイル名は「service_ja.properties.txt」です。

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

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

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

半角英数字

半角ハイフン「-」

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

半角ピリオド「.」

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

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

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

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

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

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

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

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

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

abc¥t=¥tc

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

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

abc¥t=¥t=¥tc

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

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

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

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

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

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

プロパティキーは1〜128文字以内で記述してください。

例えば，「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‒11　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.6.4　サービステンプレートの表示情報とサービスリソースファイルのプロパティとの対応

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

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

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

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

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

ベンダー名

service.vendorDisplayName

サービステンプレート名

service.displayName

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

service.shortDescription

プロパティグループ名

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

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

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

入力プロパティ・出力プロパティ・変数のプロパティ名

property.プロパティキー.displayName

入力プロパティ・出力プロパティ・変数の説明

property.プロパティキー.description

ステップ名

dnajob.ステップID.displayName※

ステップの説明

dnajob.ステップID.comment※

注※

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

ステップ名およびステップの説明は，［タスク詳細］ダイアログボックスの［ステップ詳細］エリアにも表示される情報です。ただし，この情報が表示されるのは，最上位のフローに含まれるステップだけです。最上位のフローにないステップおよび，最上位の階層にないステップについて定義しても，［タスク詳細］ダイアログボックスの［ステップ詳細］エリアには表示されません。

3　フローを作成・編集する

フローの作成・編集について説明します。フローを作成・編集することで，運用手順を並べ替えたり，手順を追加したりできます。

3.1　［フロー］ビューを表示する

3.1.1　［フロー］ビューを表示する手順

フローの作成・編集は［フロー］ビューで行います。

サービステンプレートを新規作成してフローを作成する場合

［サービステンプレートエディタホーム］ビューの［作業の開始］で，［作成］をクリックします。

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

［情報］ダイアログボックスで［OK］ボタンをクリックすると，［フロー］ビューが表示されます。

すでにあるサービステンプレートのフローを編集する場合

［サービステンプレートエディタホーム］ビューの［作業の開始］で，［編集］をクリックします。

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

［フロー］ビューが表示されます。

関連トピック

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

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

フローの1つ1つの処理は，［部品］ビューから部品をドラッグし，［フロー］ビューにドロップして作成します。［フロー］ビューにドロップされた部品のことを「ステップ」と呼びます。業務に必要なステップを配置し，関連線で繋いでフローを作成します。フローとステップの関係を次に示します。

図3‒1　フローとステップの関係

なお，「階層フロー部品」や「繰り返し実行部品」を使用すると，フローの中に別のフローを定義できます。

関連トピック

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

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

フローの階層化とは，フローの中に別のフローを定義することです。最上位のフローを第1階層として最大25階層まで定義できます。

フローを階層化したい場合は，階層フロー部品を配置します。複数のステップをまとめたものを繰り返し実行したい場合は，繰り返し実行部品を配置します。

図3‒2　フローの階層化

表3‒1　部品とステップの関係とその役割

ドラッグ&ドロップする部品

ステップの種別

役割

階層フロー部品

階層化ステップ

フローを階層化する。

繰り返し実行部品

繰り返しステップ

指定したフローを繰り返し実行する。

ただし，繰り返しステップの配下のフローをさらに階層化したい場合は，階層フロー部品を置くこと。繰り返しステップの配下のフローに繰り返し実行部品を置くことはできない。また，繰り返しステップを含むフローをコピー&ペーストして，階層化した場合もエラーとなる。

その他の部品

通常ステップ

部品を実行する。

階層化したフローを含むサービステンプレートを実行した場合，最上位のフロー内のステップだけが［タスク詳細］ダイアログボックスに表示されます。最上位のフローにないステップや，階層フロー部品および繰り返し実行部品内のステップは表示されません。

ポイント

［エディタ］画面の右側の［フローツリー］では，定義したフローの一覧をツリー形式で確認できます。［フローツリー］には，最上位のフローがサービステンプレート名で表示されます。その配下の階層は，階層フロー部品または繰り返し実行部品を実行するステップの「ステップ名」が表示されます。

関連トピック

マニュアル「JP1/AO 運用ガイド」−「タスクログの詳細」のトピック

3.2　ステップを追加する

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

ステップを追加することで，フローに処理を追加できます。ステップとは，フローにドロップされた部品のことです。

なお，追加できるステップ数の上限は次のとおりです。

1サービステンプレートに追加できるステップ数：320個

1階層に追加できるステップ数：80個

サービステンプレートエディタ編集ビューを表示していない場合の手順：

［サービステンプレートエディタホーム］ビューの［作業の開始］で，［編集］をクリックします。

［サービステンプレート一覧］画面でサービステンプレートを選択し，［編集］ボタンをクリックします。

ステップを追加するには：

サービステンプレートエディタ編集ビューの左側にある［部品］ビューで，ステップとして追加したい部品を選択します。

どの部品種別（基本部品，開発部品，リリース部品）でもステップとして使用できます。

選択した部品を［フロー］ビューにドラッグ&ドロップします。

［ステップ作成］ダイアログボックスが表示されます。

［ステップ作成］ダイアログボックスでステップの定義情報を入力し，［OK］ボタンをクリックします。

ここでは［ステップID］および［ステップ名］を指定するだけでステップを追加できます。なお，ステップの情報やプロパティマッピングはあとから設定することもできます。

ステップが［フロー］ビューに追加されます。

関連トピック

3.2.3　ステップの定義情報として設定する項目について

4.1.2　基本部品，リリース部品，開発部品とは

3.2.2　ステップの定義情報を変更する手順

ステップ作成時に［ステップ作成］ダイアログボックスで設定した定義情報は，［ステップ編集］ダイアログボックスで変更できます。

サービステンプレートエディタ編集ビューを表示していない場合の手順：

［サービステンプレートエディタホーム］ビューの［作業の開始］で，［編集］をクリックします。

［サービステンプレート一覧］画面でサービステンプレートを選択し，［編集］ボタンをクリックします。

ステップの定義情報を変更するには：

サービステンプレートエディタ編集ビューの［ステップ一覧］ビューで，定義情報を変更したいステップをクリックして［ステップ編集］ボタンをクリックします。

［ステップ編集］ダイアログボックスでステップの定義情報を変更し，［OK］ボタンをクリックします。

ポイント

［フロー］ビューで，定義情報を変更したいステップを右クリックして［編集］を選択することでも，ステップの定義情報を変更できます。

関連トピック

3.2.3　ステップの定義情報として設定する項目について

3.2.3　ステップの定義情報として設定する項目について

［ステップ編集］ダイアログボックスで，ステップのIDやステップ名，部品，入力プロパティ，出力プロパティの情報などを設定します。

表3‒2　［ステップ編集］ダイアログボックスで設定する項目

項目

説明

ステップ

ステップID

ステップを一意に識別するための値です。ステップIDは，フロー内（配下の階層フローは含まない）で一意となる値を指定します。デフォルトでは部品IDが表示されています。

フロー内に同一ステップIDのステップがある場合は，ステップIDの末尾に「_n」（n: 2から始まるユニークな整数）が付き，「ステップID_n」の形式で表示されます。ただし，「ステップID_n」が30文字を超えていた場合，超えた文字数分がステップIDの末尾から削除され，「_n」の付いた形式に変更されます。

ステップ名

ここで指定した値が［フロー］ビューにあるステップのアイコンや，［ステップ一覧］にステップ名として表示されます。また，第1階層のフローの場合，［タスク詳細］ダイアログボックスにも表示されます。デフォルトでは部品名が表示されています。ステップ名は，同一フロー内で重複して指定できます。

フロー内に同一ステップ名のステップがある場合は，ステップ名の末尾に「_n」（n: 2から始まるユニークな整数）が付き，「ステップ名_n」の形式で表示されます。ただし，「ステップ名_n」が64文字を超えていた場合，超えた文字数分がステップ名の末尾から削除され，「_n」の付いた形式に変更されます。

説明

第1階層のフローの場合，ここで指定した説明が［タスク詳細］ダイアログボックスに説明として表示されます。デフォルトでは空白です。

部品

部品の情報が表示されます。

部品バージョンには，［部品］ビューからドラッグ&ドロップした部品のバージョンが表示されます。ステップを編集するときは変更できません。

後続ステップ実行条件

ステップで実行する部品の戻り値によって，後続のステップを実行するかどうかを設定します。

入力プロパティ

サービスプロパティを設定すると，その値が部品の入力プロパティとして設定されます。また，値を直接入力することもできます。

出力プロパティ

サービスプロパティを設定すると，そのプロパティの値を更新できます。

関連トピック

3.2.4　後続ステップ実行条件について

3.2.5　入力プロパティマッピングの設定手順

3.2.6　出力プロパティマッピングの設定手順

マニュアル「JP1/AO 画面・コマンド・APIリファレンス」−「画面の制限値一覧」のトピック

3.2.4　後続ステップ実行条件について

前のステップの戻り値によって，後続のステップを実行するかどうかを設定します。

なお，ステップの戻り値は，基本的には部品の戻り値と同じです。ステップの戻り値と部品の戻り値の関係については，「4.3.12　実行したコマンドまたはスクリプトの戻り値，部品の戻り値，ステップの戻り値の関係について」を参照してください。

後続ステップ実行条件の種類

［部品の戻り値が判定値以下の場合に後続のステップを実行する］

判定値と警告値の設定例を次に示します。

図3‒3　判定値が「0」，警告値が未設定の場合（デフォルト）

戻り値が判定値以下の場合は，後続のステップを実行します（正常終了）。

戻り値が判定値より大きい場合は，後続のステップは実行されません（異常終了）。

図3‒4　判定値が「6」，警告値が「2」の場合

戻り値が判定値以下の場合，後続のステップを実行します（正常終了）。ただし，戻り値が警告値以上，判定値以下の場合は，後続するステップを実行し，警告終了となります。この場合，警告値を超えて終了したことを示すため，タスクの状態は「失敗」（タスク終了時），または「異常検出」（タスク実行中）になります。［タスク詳細］ダイアログボックスには，警告終了したことがステップの状態として表示されます。警告値を指定する場合は，判定値以下の値を指定してください。なお，警告値の指定は省略できます。

戻り値が判定値より大きい場合は，後続のステップは実行されません（異常終了）。

［常に後続のステップを実行する］

部品の戻り値に関係なく，常に後続のステップを実行します。

［常に後続のステップを実行しない］

部品の戻り値に関係なく，常にステップを異常終了します。後続のステップは実行されません。

後続ステップ実行条件を設定できない部品

階層フロー部品や値判定部品など，フローを制御する部品には，後続ステップ実行条件を設定できません。

階層フロー部品

戻り値判定分岐部品

値判定部品

実行間隔制御部品

異常終了部品

値判定分岐部品

3.2.5　入力プロパティマッピングの設定手順

サービスプロパティを設定すると，その値が部品の入力プロパティとして設定されます。例えば，部品の入力プロパティにサービスプロパティ1をマッピングすると，部品の入力プロパティにはサービスプロパティ1の値が格納されます。

また，値を直接入力して部品プロパティに反映することもできます。

サービステンプレートエディタ編集ビューを表示していない場合の手順：

［サービステンプレートエディタホーム］ビューの［作業の開始］で，［編集］をクリックします。

［サービステンプレート一覧］画面でサービステンプレートを選択し，［編集］ボタンをクリックします。

サービスプロパティの値を入力プロパティに設定する場合：

サービステンプレートエディタ編集ビューの［ステップ一覧］ビューで，定義情報を変更したいステップをクリックします。

［ステップ編集］ボタンをクリックします。

［ステップ編集］ダイアログボックスの「入力プロパティ一覧」で部品プロパティを選択し，［編集］を選択します。

［入力プロパティマッピング］画面の「マッピング設定」で「プロパティ一覧から選択」を選択します。

［プロパティ一覧］から，サービスプロパティを選択し，［OK］ボタンをクリックします。

選択したサービスプロパティの値を，部品プロパティに反映できます。

プロパティの値を直接入力する場合：

サービステンプレートエディタ編集ビューの［ステップ一覧］ビューで，定義情報を変更したいステップをクリックします。

［ステップ編集］ボタンをクリックします。

［ステップ編集］ダイアログボックスの「入力プロパティ一覧」で部品プロパティを選択し，［編集］を選択します。

［入力プロパティマッピング］画面の「マッピング設定」で「直接入力」を選択します。

［マッピングパラメータ］に値を入力して，［OK］ボタンをクリックします。

直接入力の場合，改行を含めたマッピングパラメータを指定できます。

また，複数の予約プロパティやサービスプロパティと，リテラル文字を組み合わせて指定できます。プロパティの値を参照させたい場合は，「?dna_プロパティキー?」の形式で記述してください。

関連トピック

3.2.7　予約プロパティ一覧

3.2.6　出力プロパティマッピングの設定手順

出力プロパティを設定すると，部品プロパティの値をサービスプロパティに反映できます。例えば，部品の出力プロパティにサービスプロパティ1をマッピングすると，サービスプロパティ1には部品の出力プロパティの値が格納されます。

サービステンプレートエディタ編集ビューを表示していない場合の手順：

［サービステンプレートエディタホーム］ビューの［作業の開始］で，［編集］をクリックします。

［サービステンプレート一覧］画面でサービステンプレートを選択し，［編集］ボタンをクリックします。

部品プロパティの値をサービスプロパティに反映するには：

サービステンプレートエディタ編集ビューの［ステップ一覧］ビューで，定義情報を変更したいステップをクリックします。

［ステップ編集］ボタンをクリックします。

［ステップ編集］ダイアログボックスの「出力プロパティ一覧」で部品プロパティを選択し，［編集］ボタンをクリックします。

［出力プロパティマッピング］画面の「プロパティ一覧」からプロパティを選択します。

［出力プロパティの追加］ボタンまたは［変数の追加］をクリックし，プロパティを追加することもできます。

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

部品プロパティの値を，サービスプロパティに反映できます。

3.2.7　予約プロパティ一覧

予約プロパティとは，JP1/AOがプロパティキーの定義や用途を規定している特殊なサービスプロパティです。プロパティキーは「reserved.」で始まります。このプロパティは，［入力プロパティマッピング］ダイアログボックスまたは［出力プロパティマッピング］ダイアログボックスで，部品プロパティにマッピングして使用します。ユーザーが，プロパティの定義や値を設定する必要はありません。

入力プロパティとして予約プロパティをマッピングすると，部品実行時に予約プロパティの値が部品プロパティの値に反映されます。

予約プロパティを使用するには，［入力プロパティマッピング］ダイアログボックスの[プロパティ一覧から選択]を選択します。

または，[直接入力]を選択し，「マッピングパラメータ」に「?dna_予約プロパティキー?」の形式で，予約プロパティを指定できます。この場合，部品実行時に部品プロパティの一部として値が反映されます。

出力プロパティとして予約プロパティを使用すると，任意の部品プロパティの値が予約プロパティに格納されます。［出力プロパティマッピング］ダイアログボックスで，[プロパティ一覧から選択]を選択すると，出力プロパティに対して，値を反映する先のサービスプロパティとして指定できます。

表3‒3　予約プロパティ一覧

予約プロパティキー

説明

reserved.loop.index

繰り返し実行部品の繰り返し実行の回次を表す1〜99の数値を参照するためのプロパティです。

繰り返し実行の回次とは，繰り返し実行部品のプロパティ「inputProperties」に指定された「,」区切りのデータのうち，何番目のパラメータに対応する実行かを表しています。繰り返し実行方式が「parallel」の場合でも回次を参照できます。この予約プロパティを参照指定で使う場合は?dna_reserved.loop.index?と記述します。このプロパティは，reserved.loop.inputと同じように，繰り返し実行部品の配下のフロー内で，かつ，サービスプロパティをマッピングできる部品であればどの部品でも使用できます。

reserved.loop.input

繰り返し実行部品の入力プロパティ「inputProperties」の値を参照するための予約プロパティです。

繰り返し実行部品の入力プロパティで指定したコンマ区切りの値のうち，フローの繰り返し回数に対応した項目の値が入力されます。例えば，入力プロパティが「A，B，C」だった場合，繰り返しの回次に応じて「A」，「B」，「C」が順に入力されます。繰り返しは99回まで実行できます。

reserved.loop.output

繰り返し実行部品の出力プロパティ「outputProperties」に値を代入するための予約プロパティです。

このプロパティに出力された値が，コンマ区切りで出力プロパティに反映されます。例えば，部品の出力プロパティの値がフローの繰り返し回数に対応して「X」，「Y」，「Z」となった場合，出力プロパティには「X，Y，Z」という結果が反映されます。

reserved.service.category

タスクの生成元となったサービスに設定されているカテゴリを参照するためのプロパティです。

この予約プロパティを参照指定で使う場合は?dna_reserved.service.category?と記述します。サービスプロパティをマッピングできる部品であればどの部品でも使用できます。

reserved.service.name

タスクの生成元となったサービスの名称を参照するためのプロパティです。

この予約プロパティを参照指定で使う場合は?dna_reserved.service.name?と記述します。サービスプロパティをマッピングできる部品であればどの部品でも使用できます。

reserved.service.resourceGroupName

タスクの生成元となったサービスが登録されているリソースグループを参照するためのプロパティです。

この予約プロパティを参照指定で使う場合は?dna_reserved.service.resourceGroupName?と記述します。サービスプロパティをマッピングできる部品であればどの部品でも使用できます。

reserved.step.path

実行中のステップのIDを参照するためのプロパティです。

この予約プロパティを参照指定で使う場合は?dna_reserved.step.path?と記述します。タスクログに出力される部品実行開始および終了時のメッセージの埋め字と同じ値になります。サービスプロパティをマッピングできる部品であればどの部品でも使用できます。

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.url

［タスク詳細］ダイアログボックスへのURLを参照するためのプロパティです。

この予約プロパティを参照指定で使う場合は?dna_reserved.task.url?と記述します。サービスプロパティをマッピングできる部品であればどの部品でも使用できます。

reserved.terminal.account

ターミナル接続部品で使用されたユーザーIDを参照するための予約プロパティです。

ターミナルコマンド実行部品の入力プロパティ「commandLine」で使用します。

接続に使用するユーザーアカウントが入力されます。

reserved.terminal.password

ターミナル接続部品で使用されたパスワードを参照するための予約プロパティです。

ターミナルコマンド実行部品の入力プロパティ「commandLine」で使用します。

接続に使用するユーザーアカウントのパスワードが入力されます。

reserved.terminal.suPassword

ターミナル接続部品で使用された管理者のパスワードを参照するための予約プロパティです。

ターミナルコマンド実行部品の入力プロパティ「commandLine」で使用します。

接続で使用するスーパーユーザーのパスワードが入力されます。

注※

タスクをリトライした場合，予約プロパティに設定される値の例を次に示します。

フローに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.2.8　ステップに表示される警告アイコンについて

必須のマッピングパラメータが空である場合，ステップに警告を表すアイコンが表示されます。

図3‒5　警告アイコンが表示されているステップの例

警告アイコンは，［ステップ作成］ダイアログボックスおよび［ステップ編集］ダイアログボックスを閉じるか，マッピングパラメータを編集したタイミングで表示が更新されます。

警告アイコンが表示されたステップをコピーして貼り付けた場合，警告アイコンもコピーされます。

3.3　ステップとして使用している部品のバージョンを管理する

3.3.1　ステップとして使用している部品のバージョンの管理について

JP1/AOでは，開発サービステンプレートのステップとして使用している部品のバージョンを一括または個別に変更できます。なお，部品のバージョンを変更した場合，プロパティ値などのユーザーが設定した情報を引き継ぐことができます。また，ステップとして使用している部品のバージョンを確認することもできます。これらの機能は，複数のバージョンを持つ部品が対象です。

ステップとして使用している部品のバージョン管理機能

ステップとして使用している部品のバージョンを確認および変更する方法は，一括適用と個別適用から選べます。それぞれの機能を次に説明します。

一括適用

ステップとして使用しているすべての部品を，最新バージョンのリリース部品に一括で変更する機能です。ただし，すでに最新バージョンの部品を使用しているステップは変更されません。また，ステップとして使用しているすべての部品のバージョンを，確認することもできます。

個別適用

ステップとして使用している部品の中から，特定の部品を，任意のバージョンのリリース部品または開発部品に変更する機能です。また，特定の部品のバージョンを確認することもできます。

一括適用と個別適用の機能の違いを，次の表に示します。

表3‒4　一括適用と個別適用の機能の違い

比較する内容

一括適用

個別適用

変更対象となる部品

最新バージョンのリリース部品よりも古いバージョンのリリース部品，および開発部品。

指定したリリース部品および開発部品。バージョンは問いません。

変更後の部品

最新バージョンのリリース部品。

指定したバージョンのリリース部品または開発部品。

ポイント

この機能の対象は，サービステンプレートエディタ編集ビューで編集している開発サービステンプレートです。リリースサービステンプレートのステップが使用している部品のバージョンを変更したい場合は，事前にサービステンプレートを複製して，開発サービステンプレートとしてください。

適用後のプロパティの増減について

一括適用または個別適用した場合，変更前のプロパティ値を引き継ぐことができます。ただし，変更前後でプロパティが追加または削除されると，プロパティの処理の内容が異なります。

プロパティが追加された場合

追加されるプロパティに設定されている，プロパティのデフォルト値が設定されます。

プロパティが削除された場合

変更後の部品から，該当するプロパティ自体が削除されます。

適用後のプロパティ値の処理について

一括適用または個別適用した場合のプロパティ値の処理は，場合によって異なります。場合に応じたプロパティ値の処理を次に示します。

適用前後で「プロパティキー」および「入出力種別」が一致する場合

プロパティ値には，適用前の値がそのまま引き継がれます。

適用前後で「プロパティキー」または「入出力種別」が一致しない場合※

プロパティ値には，適用前の値が引き継がれません。

注※

適用前後でプロパティが増減した場合も含みます。

3.3.2　ステップとして使用している部品のバージョンを確認する手順

ステップとして使用している部品のバージョンを確認します。

ステップとして使用している部品のすべてを，一度に確認する場合は，［一括適用］タブを選択します。指定した部品のバージョンを確認する場合は，［個別適用］タブを選択します。

［一括適用］タブから確認する場合

［サービステンプレートエディタホーム］ビューの［作業の開始］で，［編集］をクリックします。

［サービステンプレート一覧］ダイアログボックスでサービステンプレートを選択し，［編集］ボタンをクリックします。

［操作］リストボックスから［部品バージョン管理］を選択します。

［部品バージョン管理］ダイアログボックスで，［一括適用］タブを選択します。

［ステップ一覧］の［適用済みバージョン］で，すべての部品のバージョンが確認できます。

［状態］で，［未適用］と表示されている部品は，部品のバージョンを最新バージョンのリリース部品に変更できます。［適用済み］と表示されている部品は，最新バージョンのリリース部品を使用しています。［適用不可］と表示されている部品は，変更先に指定するリリース部品がありません。

［個別適用］タブから確認する場合

［サービステンプレートエディタホーム］ビューの［作業の開始］で，［編集］をクリックします。

［サービステンプレート一覧］ダイアログボックスでサービステンプレートを選択し，［編集］ボタンをクリックします。

［操作］リストボックスから［部品バージョン管理］を選択します。

［部品バージョン管理］ダイアログボックスで，［個別適用］タブを選択します。

［部品一覧］から，バージョンを確認したい部品を選択します。

［ステップ一覧］の［適用済みバージョン］で，選択した部品のバージョンが確認できます。

［状態］で，［未適用］と表示されている部品は，部品のバージョンを変更できます。［適用済み］と表示されている部品は，任意に指定した部品のバージョンを使用しています。

3.3.3　ステップとして使用している部品のバージョンを一括で最新にする手順

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

［サービステンプレートエディタホーム］ビューの［作業の開始］で，［編集］をクリックします。

［サービステンプレート一覧］ダイアログボックスでサービステンプレートを選択し，［編集］ボタンをクリックします。

［操作］リストボックスから［部品バージョン管理］を選択します。

［部品バージョン管理］ダイアログボックスで，［一括適用］タブを選択します。

ポイント

最新バージョンにする対象にしたくない部品があれば，ステップ選択チェックボックスからチェックを外します。

最新バージョンのリリース部品よりも，新しいバージョンの開発部品を使用しているステップは，変更対象として，ステップ選択チェックボックスはチェックされていません。そのため，この部品を変更対象にする場合は，ステップ選択チェックボックスをチェックしてください。

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

［ステップ一覧］で選択されている部品のすべてが，一括で最新バージョンのリリース部品に変更されます。

変更後のプロパティに，変更前のプロパティ値が引き継がれない場合，[図データ]が表示されます。表示された場合は，ステップの定義情報を見直してください。変更前のプロパティ値が引き継がれない場合を次に示します。

プロパティが削除された場合

プロパティキーの値が変更された場合

プロパティの入出力種別が変更された場合

3.3.4　ステップとして使用している部品のバージョンを任意に変更する手順

ステップとして使用している部品を，部品ごとに任意のバージョンに変更します。

［サービステンプレートエディタホーム］ビューの［作業の開始］で，［編集］をクリックします。

［サービステンプレート一覧］ダイアログボックスでサービステンプレートを選択し，［編集］ボタンをクリックします。

［操作］リストボックスから［部品バージョン管理］を選択します。

［部品バージョン管理］ダイアログボックスで，［個別適用］タブを選択します。

［部品一覧］からバージョンを変更したい部品を選択します。

［部品一覧］には，ステップとして使用している部品の種類が表示されます。その部品のバージョンが複数ある場合にだけ表示されます。そのうち，最新ではないリリース部品，または開発部品を含む場合，[図データ]が表示されます。

変更先となるバージョンの詳細情報を確認するため，［部品バージョン］リストボックスからバージョンを選択し，［詳細情報］を確認します。

指定したバージョンごとに［ステップ一覧］の［状態］を確認してください。［状態］が［未適用］と表示されている部品は，バージョンを変更できます。［適用済み］と表示されている部品は，変更先に指定したバージョンと同じバージョンであるため，変更できません。

［部品バージョン］リストボックスから，変更先に指定したいバージョンを選択します。

［状態］が［未適用］の部品の中から，バージョンを変更したい部品を選択します。

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

［ステップ一覧］で選択されている部品が，指定したバージョンの部品に変更されます。

変更後のプロパティに，変更前のプロパティ値が引き継がれない場合，[図データ]が表示されます。表示された場合は，ステップの定義情報を見直してください。変更前のプロパティ値が引き継がれない場合を次に示します。

プロパティが削除された場合

プロパティキーの値が変更された場合

プロパティの入出力種別が変更された場合

3.4　関連線を接続する

3.4.1　関連線を接続する手順

ステップを追加したあと，業務として実行する順序に合わせて，ステップを関連線で接続します。

サービステンプレートエディタ編集ビューを表示していない場合の手順：

［サービステンプレートエディタホーム］ビューの［作業の開始］で，［編集］をクリックします。

［サービステンプレート一覧］画面でサービステンプレートを選択し，［編集］ボタンをクリックします。

関連線を接続するには：

サービステンプレートエディタ編集ビューの［フロー］ビューで，先に実行するステップのアイコンの○を，あとに実行するステップのアイコンまでドラッグし，アイコンの色が変わったらドロップします。

ステップが関連線で接続されます。

関連トピック

3.4.8　複数のステップに関連線を接続する場合の動作

3.4.9　関連線が接続できない例

3.4.10　処理が分岐する部品を使用する場合の関連線接続

3.4.2　ステップまたは関連線を削除する手順

ステップまたは関連線を削除できます。ステップを削除すると，対象のステップに接続されていた関連線も同時に削除されます。また，関連線を削除すると，ステップ間の関連が解除されます。

サービステンプレートエディタ編集ビューを表示していない場合の手順：

［サービステンプレートエディタホーム］ビューの［作業の開始］で，［編集］をクリックします。

［サービステンプレート一覧］画面でサービステンプレートを選択し，［編集］ボタンをクリックします。

ステップまたは関連線を削除するには：

サービステンプレートエディタ編集ビューの［フロー］ビューで，削除したいステップまたは関連線を右クリックし，［削除］を選択します。

［Delete］キーを押してもステップまたは関連線を削除できます。

関連トピック

3.4.5　ステップを複数選択する手順

3.4.3　ステップまたは関連線をコピーする手順

ステップまたは関連線をコピーして，同一または別のサービステンプレートの［フロー］ビューに貼り付けることができます。

コピー対象は，選択範囲に含まれているステップまたは関連線です。階層化されたフローが含まれている場合は，その配下のフローもすべてコピーされます。コピーできるデータは，直前に行ったコピー操作の1回分だけです。

サービステンプレートエディタ編集ビューを表示していない場合の手順：

［サービステンプレートエディタホーム］ビューの［作業の開始］で，［編集］をクリックします。

［サービステンプレート一覧］画面でサービステンプレートを選択し，［編集］ボタンをクリックします。

ステップまたは関連線をコピーするには：

サービステンプレートエディタ編集ビューの［フロー］ビューからコピーしたいステップまたは関連線を右クリックし，［コピー］を選択します。

関連トピック

3.4.5　ステップを複数選択する手順

3.4.7　ステップまたは関連線の貼り付け時に引き継がれる情報

3.4.4　ステップまたは関連線を切り取る手順

ステップまたは関連線を切り取って，同一または別のサービステンプレートの［フロー］ビューに貼り付けることができます。

切り取り対象は，選択範囲に含まれているステップまたは関連線です。階層化されたフローが含まれている場合は，その配下のフローもすべて切り取られます。切り取られるデータは，直前に行った切り取り操作の1回分だけです。

選択範囲外のステップと接続されていた関連線は，切り取った時点で［フロー］ビューから削除されます。

サービステンプレートエディタ編集ビューを表示していない場合の手順：

［サービステンプレートエディタホーム］ビューの［作業の開始］で，［編集］をクリックします。

［サービステンプレート一覧］画面でサービステンプレートを選択し，［編集］ボタンをクリックします。

ステップまたは関連線を切り取るには：

サービステンプレートエディタ編集ビューの［フロー］ビューから切り取りたいステップまたは関連線を右クリックし，［切り取り］を選択します。

関連トピック

3.4.5　ステップを複数選択する手順

3.4.7　ステップまたは関連線の貼り付け時に引き継がれる情報

3.4.5　ステップを複数選択する手順

ステップは複数選択できます。

サービステンプレートエディタ編集ビューを表示していない場合の手順：

［サービステンプレートエディタホーム］ビューの［作業の開始］で，［編集］をクリックします。

［サービステンプレート一覧］画面でサービステンプレートを選択し，［編集］ボタンをクリックします。

ステップを複数選択するには：

サービステンプレートエディタ編集ビューの［フロー］ビューでマウスをドラッグして，選択したいステップの範囲を指定します。

［Ctrl］キーを押しながら，選択したいステップをクリックすることでも複数選択できます。

ポイント

［フロー］ビュー内のステップまたは関連線がない個所で，右クリックして［すべて選択］を選択すると，すべてのステップまたは関連線を選択できます。

3.4.6　ステップまたは関連線を貼り付ける手順

ステップや関連線のコピーまたは切り取りによってクリップボードに記録されたデータを，開発サービステンプレートの［フロー］ビューに任意に配置できます。

なお，貼り付け先に引き継ぐ情報は，貼り付け先に同一のステップIDやステップ名のステップがあるかどうかによって異なります。

サービステンプレートエディタ編集ビューを表示していない場合の手順：

［サービステンプレートエディタホーム］ビューの［作業の開始］で，［編集］をクリックします。

［サービステンプレート一覧］画面でサービステンプレートを選択し，［編集］ボタンをクリックします。

ステップまたは関連線を貼り付けるには：

サービステンプレートエディタ編集ビューの［フロー］ビューの何もない個所で右クリックし，［貼り付け］を選択します。

関連トピック

3.4.7　ステップまたは関連線の貼り付け時に引き継がれる情報

3.4.7　ステップまたは関連線の貼り付け時に引き継がれる情報

コピーまたは切り取ったステップや関連線を貼り付ける場合，コピー元または切り取り元から引き継がれる情報があります。そのため，貼り付け先の開発サービステンプレートの定義情報は，貼り付けたあと必要に応じて見直してください。

貼り付け時に引き継がれるステップまたは関連線の情報を次の表に示します。

表3‒5　ステップまたは関連線の貼り付け時に引き継がれる情報

コピー・切り取り対象

コピー・切り取り対象の情報

貼り付け先の情報

ステップ

ステップID

ステップIDはフロー内（配下の階層フローは含まない）でユニークである必要がある。

貼り付け先に同じステップIDのステップがない場合，コピー元または切り取り元の情報がそのまま引き継がれる。

同じステップIDのステップがある場合，「ステップID_n」に変更される。なお，nは，2以上のユニークな整数が設定される。また，変更した「ステップID_n」が30文字を超えた場合，超えた文字数分がステップIDの末尾から削除される。

ステップ名

貼り付け先に同じステップ名のステップがない場合，コピー元または切り取り元の情報がそのまま引き継がれる。

同じステップ名のステップがある場合，「ステップ名_n」に変更される。なお，nは，2以上のユニークな整数が設定される。また，変更した「ステップ名_n」が64文字を超えた場合，超えた文字数分がステップ名の末尾から削除される。

説明

コピー元または切り取り元の情報がそのまま貼り付けられる。

部品情報への参照

後続ステップ実行条件

入力プロパティのマッピングパラメータ

出力プロパティのマッピングパラメータ

関連線

方向

関連線の方向の情報もコピーされる。ただし，選択範囲外のステップと接続されている接続線はコピーされない。

3.4.8　複数のステップに関連線を接続する場合の動作

関連線は1つのステップから複数のステップに接続することも，複数のステップから1つのステップに接続することもできます。このように接続した場合，接続されたすべてのステップの実行完了を待ってから，次のステップが実行されます。

図3‒6　複数ステップの接続例

3.4.9　関連線が接続できない例

フローの中で循環するような関連線や，接続元と接続先が同じ関連線などは，接続できません。

表3‒6　関連線の接続制限

接続できない関連線

詳細

例

循環参照となる関連線

フローの中で，ループするような関連線は接続できない。

接続元ステップ自身への関連線

関連線の接続先と接続元のステップが同一の場合，関連線は接続できない。

同一の関連線

同じ接続先と接続元を持つ関連線は複数作成できない。

戻り値判定分岐部品への複数接続

戻り値判定分岐部品は，直前のステップの戻り値を判定する部品のため，複数ステップからの接続はできない。直前のステップとして接続できるステップは最大1つである。

戻り値判定分岐部品または値判定分岐部品から戻り値判定分岐部品または値判定分岐部品への接続

戻り値判定分岐部品または値判定分岐部品の分岐先として，戻り値判定分岐部品および値判定分岐部品を接続することはできない。後続するステップとして連続して接続することはできる。

戻り値判定分岐部品または値判定分岐部品の分岐先ステップからの関連線

戻り値判定分岐部品または値判定分岐部品の分岐先のステップは最大1個であり，関連線は接続できない。複数のステップの処理が必要となる場合は，階層フロー部品を分岐先として接続する。

戻り値判定分岐部品または値判定分岐部品の分岐先ステップへの関連線

戻り値判定分岐部品または値判定分岐部品の分岐先のステップに，関連線を接続することはできない。

（凡例）[図データ]：戻り値判定分岐部品または値判定分岐部品[図データ]：その他の部品

関連トピック

3.4.10　処理が分岐する部品を使用する場合の関連線接続

マニュアル「JP1/AO サービステンプレートリファレンス」−「戻り値判定分岐部品」のトピック

3.4.10　処理が分岐する部品を使用する場合の関連線接続

後続するステップとは別に，判定条件にマッチしたときにだけ実行したいステップがある場合，戻り値判定分岐部品や値判定分岐部品を使用します。使用する際は，部品のアイコンの下側にある○を起点にして関連線を接続します。

なお，条件にマッチした場合は，分岐先ステップを実行したあとに，後続するステップを実行します。条件にマッチしない場合は，分岐先ステップを実行しないで，後続するステップを実行します。

図3‒7　 戻り値判定分岐部品を使用した場合の関連線接続の例

後続するステップとの接続は，通常の矢印で描画されます。

判定条件にマッチした場合だけ実行するステップとの関連線は，両矢印で描画されます。判定条件にマッチした場合だけ実行するステップは必ず1つです。

判定条件にマッチした場合，「sample1」，「戻り値判定分岐部品」，「sample2」，「sample3」の順番でステップが実行されます。

判定条件にマッチしなかった場合，「sample1」，「戻り値判定分岐部品」，「sample3」の順番でステップが実行されます。

4　部品を作成・編集する

部品の作成・編集について説明します。JP1/AOが提供する部品をそのまま使用するほか，部品を作成・編集することで，ユーザー独自の処理を定義できます。

4.1　部品を一覧表示する

4.1.1　部品を一覧表示する手順

JP1/AOにインポートされている部品を一覧で確認できます。

部品の一覧は，［エディタ］画面の左側に［部品］ビューとして表示されます。

ポイント

部品名，部品バージョン，詳細情報などを表示したい場合は，部品の一覧で部品をクリックします。

関連トピック

4.1.2　基本部品，リリース部品，開発部品とは

4.1.2　基本部品，リリース部品，開発部品とは

部品とは，実行する処理を定義したものです。

JP1/AOで扱う部品は基本部品，リリース部品，開発部品の3つに分類でき，［部品］ビューでそれぞれ別のタブに表示されます。

また，便宜的に，これらの部品は提供元によって「基本部品」と「コンテンツ部品」に分類されています。詳細はマニュアル「JP1/AO サービステンプレートリファレンス」の「サービステンプレートと部品の種類」のトピックを参照してください。

表4‒1　部品の種類

種別

説明

基本部品

［基本］タブに表示されます。

JP1/AOが提供する部品です。メールの通知やフローの繰り返し処理など，汎用的な処理が定義されています。

コンテンツ部品

リリース部品

［リリース］タブに表示されます。

ユーザーが［エディタ］画面で作成したサービステンプレートをリリースすることで，JP1/AOにインポートされた部品です。

JP1/AOが提供するサービステンプレートに含まれている部品です。

importservicetemplateコマンドで，JP1/AOサーバにインポートされた部品のうち，構成種別が「リリース」の部品もリリース部品として扱われます。

開発部品

［開発］タブに表示されます。

ユーザーが新規作成し，リリースする前の部品です。または，既存の部品を複製し，作成している途中の部品です。

開発部品は，開発部品を含む開発サービステンプレートをビルドすることでJP1/AOサーバにインポートされ，テスト用として実行できる状態になります。

importservicetemplateコマンドを実行してJP1/AOサーバにインポートされた部品のうち，構成種別が「デバッグ」の部品も開発部品として扱われます。

部品では，例えば次のことができます。

メールの通知やフローの繰り返し処理をする

JP1/AOサーバと任意のリモートホストとの間でファイルやフォルダを転送する

任意のリモートホストに接続してコマンドやスクリプトを実行する

また，JP1/AOでは，コンテンツ部品として，ユーザー独自の部品を作成できます。任意のリモートホストに接続してコマンドやスクリプトを実行する部品を作成して，サービステンプレートに組み込むことができます。

コンテンツ部品を実行する場合，操作対象の機器のOSがWindowsの場合はWMIを，UNIXの場合はSSHを使用して操作対象の機器に接続します。なお，基本部品については，マニュアル「JP1/AO サービステンプレートリファレンス」の基本部品についてのトピックを参照してください。

関連トピック

4.1.3　部品の実行ユーザー

4.1.4　部品の種別と実施できる操作

4.1.5　操作対象の機器に転送されるファイル（Windowsの場合）

4.1.6　操作対象の機器に転送されるファイル（UNIXの場合）

4.1.7　部品実行時に設定される操作対象の機器のロケールについて

4.1.8　部品実行時にJP1/AOが通信で使用する文字セットについて

4.1.9　部品実行時に特定の文字セットを設定したい場合

付録A.1(2)　ビルドおよびリリースによって設定されるサービステンプレートおよび部品の構成種別

4.1.3　部品の実行ユーザー

部品の実行ユーザーは，ローカル実行機能の設定と，操作対象の機器の組み合わせによって決まります。

ローカル実行機能が無効の場合

ローカル実行機能が無効の場合，部品の実行ユーザーは次のようになります。

操作対象の機器のOSがWindowsの場合

操作対象の機器に接続したユーザーで，コマンドまたはスクリプトが実行されます。

操作対象の機器のOSがWindowsの場合，ユーザーのプロファイルは引き継がれません。そのため，部品の実行結果と，デスクトップ上で実行したコマンドまたはスクリプトの実行結果は異なることがあります。

よって，部品を実行する際に，ユーザーのプロファイルは参照させないでください。ユーザーのプロファイルとは，ユーザー環境変数，レジストリ，Internet Explorerの設定などです。これらを参照させた場合，コマンドまたはスクリプトが期待する動作をしないことがあります。例えば，Internet Explorerのプロキシの設定を参照するコマンドまたはスクリプトを実行すると，通信エラーで失敗することがあります。これには，Windows Updateをスクリプトで実行する場合などが該当します。

操作対象の機器のOSがUNIXの場合

基本的には，操作対象の機器に接続したユーザーが，コマンドまたはスクリプトの実行ユーザーになります。ただし，操作対象の機器に接続したあと，コマンドまたはスクリプトの実行ユーザーをroot権限に昇格することもできます。

なお，root権限のユーザーで操作対象の機器に接続する場合は，操作対象の機器側でroot権限のユーザーによる接続を許可しておく必要があります。

部品の実行ユーザーの一覧を次に示します。

表4‒2　部品の実行ユーザー一覧

部品

root権限のユーザーへの昇格※1

操作対象の機器に接続したユーザー

コマンドまたはスクリプトの実行ユーザー※2

基本部品（汎用コマンド実行部品，ファイル転送部品およびターミナル接続部品）

コンテンツ部品

設定している

root権限のユーザー

root権限のユーザー

root権限ではないユーザー

root権限のユーザー

設定していない

root権限のユーザー

root権限のユーザー

root権限ではないユーザー

root権限ではないユーザー

注※1

root権限のユーザーに昇格するための方法は，部品ごとに異なります。

基本部品の場合

汎用コマンド実行部品およびファイル転送部品

部品プロパティで，root権限のユーザーに昇格するかどうかを指定します。

ターミナル接続部品

ターミナル接続部品では，root権限のユーザーに昇格するかどうかは設定できません。ターミナルコマンド実行部品で，ユーザーの権限をroot権限に昇格するコマンドを実行してください。

なお，root権限のユーザーに昇格する方法の詳細については，マニュアル「JP1/AO サービステンプレートリファレンス」の基本部品についてのトピックを参照してください。

コンテンツ部品の場合

［部品作成］ダイアログボックスまたは［部品編集］ダイアログボックスの［root権限で実行(SSH接続用)］チェックボックスで実行するユーザーの権限を指定できます。［root権限で実行(SSH接続用)］チェックボックスにチェックした場合，root権限のユーザーでコマンドまたはスクリプトが実行されます。［root権限で実行(SSH接続用)］チェックボックスにチェックしなかった場合，操作対象の機器に接続したユーザーの権限でコマンドまたはスクリプトが実行されます。

ポイント

［root権限で実行(SSH接続用)］チェックボックスをチェックした場合，［部品作成］ダイアログボックスまたは［部品編集］ダイアログボックスで指定した認証種別によって，スーパーユーザーのパスワードを指定する方法が異なります。

部品の認証種別に［エージェントレス接続先設定を使用］を指定した場合

エージェントレス接続先定義で指定したスーパーユーザーのパスワードが使用されます。

部品の認証種別に［プロパティで指定］を指定した場合

部品のプロパティ「plugin.suPassword」でスーパーユーザーのパスワードを指定します。

注※2

ファイル転送部品の場合，ファイルを転送するユーザーです。

ターミナル接続部品の場合，実際にコマンドを実行するのはターミナルコマンド実行部品です。

ローカル実行機能が有効の場合

ローカル実行機能が有効の場合，操作対象の機器がローカルホストのときの部品の実行ユーザーは次のようになります。

ローカルホストのOSがWindowsの場合

Systemアカウントの権限でコマンドまたはスクリプトが実行されます。

ローカルホストのOSがUNIXの場合

rootユーザーの権限でコマンドまたはスクリプトが実行されます。

なお，操作対象の機器がローカルホスト以外の場合の実行ユーザーは，ローカル実行機能が無効の場合と同様です。

4.1.4　部品の種別と実施できる操作

部品の種別によって，［エディタ］画面で実施できる操作が異なります。

表4‒3　部品の種別と実施できる操作一覧

種別

部品の操作可否

一覧表示

作成

編集

削除

複製

基本部品

○　

×　

×　

×　

×　

開発部品

○　

○　

○　

○　 ※1

○　

リリース部品

○　

×　

×　

○　※1※2

○　

（凡例）

○：操作できます。　×：操作できません。

注※1

開発サービステンプレートに使用されている場合は削除できません。

削除対象の部品をステップで使用している開発サービステンプレートがビルド済みの場合は，削除できません。この場合，開発サービステンプレートから，削除対象の部品を使用しているステップを削除したあとで，ビルドを再実行してください。ビルドしたあとに，部品を削除できるようになります。

注※2

リリースサービステンプレートに使用されている場合は削除できません。

4.1.5　操作対象の機器に転送されるファイル（Windowsの場合）

操作対象の機器のOSがWindowsの場合に，汎用コマンド実行部品，ファイル転送部品，またはコンテンツ部品を使用するときは，次のファイルが操作対象の機器に転送されます。なお，次のファイルは部品の実行が終了する際に削除されます。

図4‒1　操作対象の機器に転送されるファイル（Windowsの場合）

転送対象ファイルは，次の条件のどちらかの場合に転送されます。

ファイル転送部品を使用した場合

コンテンツ部品で，スクリプトを設定して実行した場合

ただし，ローカル実行機能が有効な場合で，操作対象がローカルホストのときは，ファイルは転送されないで，ローカルホストにコピーされます。

関連トピック

4.3.9　スクリプトを設定する手順

4.1.6　操作対象の機器に転送されるファイル（UNIXの場合）

操作対象の機器のOSがUNIXの場合に，ファイル転送部品，またはコンテンツ部品を使用するときは，次のファイルが操作対象の機器に転送されます。なお，次のファイルは部品の実行が終了する際に削除されます。

図4‒2　操作対象の機器に転送されるファイル（UNIXの場合）

転送対象ファイルは，次のどちらかの場合に転送されます。

ファイル転送部品を使用した場合

コンテンツ部品で，スクリプトを設定して実行した場合

ただし，ローカル実行機能が有効な場合で，操作対象がローカルホストのときは，ファイルは転送されないで，ローカルホストにコピーされます。

なお，作業用フォルダは，プロパティファイル（config_user.properties）のキー「plugin.remoteCommand.workDirectory.ssh」で設定できます。デフォルトは「/tmp/Hitachi_AO」です。

関連トピック

4.3.9　スクリプトを設定する手順

マニュアル「JP1/AO 構築ガイド」−「プロパティファイル（config_user.properties）」のトピッ ク

4.1.7　部品実行時に設定される操作対象の機器のロケールについて

部品実行時に適用される操作対象の機器のロケールは，OSによって異なります。部品実行時に適用されるロケールを，操作対象の機器のOSごとに示します。

Windowsの場合

操作対象の機器でスクリプトやコマンドを実行する際は，JP1/AOサーバと操作対象の機器のロケールと文字セットを統一してください。ロケールと文字セットには，Windowsの［コントロールパネル］の［地域と言語のオプション］で設定されている日時の形式，ユーザー単位の表示言語，システム全体の表示言語，およびシステムのロケールの設定が適用されます。

JP1/AOが通信で使用する文字セットについては「4.1.8　部品実行時にJP1/AOが通信で使用する文字セットについて」を参照してください。

UNIXの場合

［部品作成］ダイアログボックスまたは［部品編集］ダイアログボックスの「文字セット自動判定(SSH接続用)」の設定によって，部品実行時に適用されるロケールが異なります。

「文字セット自動判定(SSH接続用)」で「有効」のチェックを外している場合

「LC_ALL=C」のロケールでスクリプトが実行されます。また，コマンドおよびコマンドのパラメータの内容はすべてASCII文字で指定してください。コマンドのパラメータ，標準出力，および標準エラー出力の内容にASCII文字以外が含まれると文字化けしたり，正しくコマンド実行されないおそれがあります。

「文字セット自動判定(SSH接続用)」で「有効」にチェックしている場合

接続ユーザーのデフォルトのロケールを参照して，それを基にスクリプトが実行されます。

スクリプトやコマンドの実行時，操作対象の機器の環境変数「LC_ALL」および「LANG」は，共に接続ユーザーのデフォルトのロケールに設定が変更されます。ただし，「LC_ALL」以外の環境変数「LC_XXXXX」の設定は変更されません。

スクリプトやコマンドの実行時のロケールは，次の優先順位に従って参照されます。

表4‒4　部品実行時に参照されるロケールの優先順位

優先順位

環境変数

1

LC_ALLの設定値

2

LC_CTYPEの設定値

3

LANGの設定値

部品実行時のスクリプトやコマンドの文字セットがこのように設定された文字セットと異なる場合は，文字化けするおそれがあります。なお，コマンドやコマンドのパラメータで使用できる文字セットは，OSによって異なります。使用できる文字セットについては「4.1.8　部品実行時にJP1/AOが通信で使用する文字セットについて」を参照してください。

4.1.8　部品実行時にJP1/AOが通信で使用する文字セットについて

部品実行時に設定されるJP1/AOが通信で使用する文字セットは，操作対象の機器のOS によって異なります。

JP1/AOサーバが出力するタスクログや公開ログは，JP1/AOサーバのOSのデフォルトの文字セットで出力されます。そのため，操作対象の機器と互換性のない文字セットから取得した文字や機種依存文字，および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」を設定することで，ログイン時の文字セットを変更できます。

また，特定の文字セットを設定したい場合は「4.1.9　部品実行時に特定の文字セットを設定したい場合」を参照してください。

なお，ローカル実行機能が有効の場合，文字セットはSystemアカウントまたはrootユーザーのデフォルト設定に従います。ただし，次の処理は行われません。

locale charmapコマンドによる文字セットの自動判定

文字セットマッピングファイルによる文字セットの設定

接続先プロパティファイルによる文字セットの設定

4.1.9　部品実行時に特定の文字セットを設定したい場合

操作対象の機器のOSがUNIXの場合に，JP1/AOサーバが通信で使用する文字セットを設定したいときは，文字セットマッピングファイル，または接続先プロパティファイルのterminal.charsetキーで設定してください。

文字セットマッピングファイル，および接続先プロパティファイルのterminal.charsetキーで文字セットを指定した場合，次の優先順位に従って設定されます。

表4‒5　部品実行時に設定される文字セットの優先順位

優先順位

設定値

1

接続先プロパティファイルのterminal.charsetキーで指定された文字セット

2

文字セットマッピングファイルで指定された文字セット

3

操作対象の機器でlocale charmapコマンドを実行して取得した文字セット

4

UTF-8

関連トピック

マニュアル「JP1/AO 構築ガイド」−「接続先プロパティファイル（接続先名.properties）」，「文字セットマッピングファイル（charsetMapping_user.properties）」のトピック

4.1.10　部品実行時に必要なOSのコマンドについて

部品を実行する際に，操作対象機器のOSに，あらかじめインストールされている必要のあるコマンドがあります。詳細はリリースノートを参照してください。

4.2　部品を作成する

4.2.1　部品を作成する手順

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

部品を作成するには：

［エディタ］画面の［部品］ビューで［開発］タブを選択します。

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

［部品作成］ダイアログボックスで部品の定義情報を設定し，［保存］ボタンをクリックします。

関連トピック

4.2.2　部品の作成または複製時に設定する項目について

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

4.2.2　部品の作成または複製時に設定する項目について

［部品作成］ダイアログボックスおよび［部品複製］ダイアログボックスでは次に示す項目を設定できます。

表4‒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

部品を作成したベンダーの名称を指定します。

説明

部品の説明を指定します。

カテゴリ名

部品のカテゴリ名を指定します。

注※1

［部品ID］,［部品バージョン］，［ベンダーID］は部品の作成または複製後に変更できません。

注※2

指定を省略した場合，［ベンダーID］に指定した値が［ベンダー名］に設定されます。なお，［エディタ］画面上に表示される開発部品の［ベンダー名］については，空白のままです。

［部品作成］ダイアログボックスでは入力プロパティ，出力プロパティ，リモートコマンドも設定できます。入力プロパティ，出力プロパティ，リモートコマンドについては，「4.3.2　部品の定義情報として設定する項目について」のトピックを参照してください。

4.3　部品を編集する

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

［開発］タブに表示されている部品の定義を編集できます。

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

［エディタ］画面の［部品］ビューで［開発］タブを選択します。

編集する部品を選択して［編集］ボタンをクリックします。

［部品編集］ダイアログボックスで部品の定義情報を設定し，［保存］ボタンをクリックします。

注意事項

フロー内にステップとして配置したあとに部品のプロパティを編集した場合は，ステップに定義したマッピングパラメータが適切かどうか確認してください。部品のプロパティと，ステップに定義したマッピングパラメータに不整合が生じている場合は，ビルドまたはリリース時にエラーとなります。

関連トピック

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

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

［部品作成］ダイアログボックスまたは［部品編集］ダイアログボックスで，部品，入力プロパティ，出力プロパティ，リモートコマンドを設定します。

表4‒7　［部品作成］ダイアログボックスまたは［部品編集］ダイアログボックスで設定する項目

項目

説明

部品

部品名，ベンダー名，説明，カテゴリ名，アイコン，認証種別，文字セット自動判定(SSH接続用)の要否，およびroot権限で実行するかどうかを設定できます。

入力プロパティ※

部品の実行に必要な入力値を格納するためのプロパティを定義できます。

出力プロパティ※

部品の実行結果を格納するためのプロパティを定義できます。

リモートコマンド

操作対象ホストで実行するコマンドまたはスクリプトを設定します。リモートコマンドはOSごとに設定します。

注※

1つの部品に対して，入力プロパティおよび出力プロパティは，合計100個まで定義できます。

「部品」の関連トピック

4.2.2　部品の作成または複製時に設定する項目について

4.3.3　部品のアイコンとして設定できる画像ファイルについて

4.3.4　部品の認証種別とは

「入力プロパティ」および「出力プロパティ」の関連トピック

4.3.5　部品に定義するプロパティ（部品プロパティ）

「入力プロパティ」の関連トピック

4.3.6　実行ホストまたは認証情報を指定するための予約部品プロパティ

「リモートコマンド」の関連トピック

4.3.9　スクリプトを設定する手順

4.3.15　スクリプトの設定方法による差異

4.3.17　コマンドを設定する手順

4.3.7　標準出力および標準エラー出力を出力プロパティにマッピングする手順

4.3.3　部品のアイコンとして設定できる画像ファイルについて

部品一覧や［フロー］ビューに表示されるアイコンは，部品ごとに任意の画像を設定できます。なお，アイコンを設定しなかった場合は，標準の部品アイコンが設定されます。

図4‒3　標準の部品アイコン

部品のアイコンとして設定できる画像ファイルの条件を次に示します。条件と一致しないファイルが指定されるとファイル登録時にエラーとなります。

ファイル形式

PNG形式

画像サイズ

縦48ピクセル，横48ピクセル

アイコンとして登録した画像のファイル名は，「icon.png」に変更されます。

なお，任意の画像ファイルを登録したあとでも，ファイルを選択することで再登録できます。この場合，既存の登録ファイルは削除され，再登録したファイルで置き換えられます。

4.3.4　部品の認証種別とは

［部品作成］ダイアログボックスまたは［部品編集］ダイアログボックスの「認証種別」で選択した内容に従って，次のプロパティが自動的に設定されます。

「認証種別」で［エージェントレス接続先設定を使用］を選択

plugin.destinationHost

「認証種別」で［プロパティで指定］を選択

plugin.destinationHost

plugin.account

plugin.password

plugin.suPassword

plugin.publicKeyAuthentication

plugin.keyboardInteractiveAuthentication

関連トピック

4.3.6　実行ホストまたは認証情報を指定するための予約部品プロパティ

4.3.5　部品に定義するプロパティ（部品プロパティ）

部品のプロパティを定義することで，部品の実行に必要なパラメータを指定したり，部品の実行結果を取得したりできます。部品プロパティには次の種類があります。

入力プロパティ

リモートコマンドを実行する際のコマンドの引数や，操作対象ホストなど，部品の実行に必要な入力値を格納するためのプロパティを定義できます。入力プロパティは次のダイアログボックスで定義できます。

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

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

出力プロパティ

リモートコマンドの実行結果（標準出力や標準エラー出力）など，部品の実行結果を格納するためのプロパティを定義できます。出力プロパティは次のダイアログボックスで定義できます。

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

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

部品のプロパティは，定義した部品内でだけ有効です。

部品の入力プロパティおよび出力プロパティに格納できる値の最大値は1,024文字です。1,024文字以上の値が指定された場合，1,024文字までがプロパティ値として格納され，それより先の値は切り捨てられます。また，「?dna_プロパティキー?」の形式でプロパティの値を参照指定した場合，参照先の値が1,024文字以上になったときは，サービスの実行時に切り捨てられます。

また，部品のプロパティのうち，プロパティキーと用途があらかじめ決まっているプロパティを「予約部品プロパティ」と呼びます。予約部品プロパティは，リモートコマンドの実行ホストまたは認証情報を指定するために，部品プロパティとして定義する必要があります。

関連トピック

4.3.6　実行ホストまたは認証情報を指定するための予約部品プロパティ

4.3.6　実行ホストまたは認証情報を指定するための予約部品プロパティ

予約部品プロパティとは，プロパティキーと用途があらかじめ決まっている部品プロパティのことです。

予約部品プロパティの名称は「plugin.」で始まります。予約部品プロパティは，次のダイアログボックスの［入力プロパティ一覧］に自動作成されます。

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

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

予約部品プロパティは，定義した部品内でだけ有効です。

予約部品プロパティは編集できますが，プロパティキー，必須区分など，一部の項目は編集できません。また，予約部品プロパティは削除できません。

実行ホストを指定するための予約部品プロパティ

部品の実行ホストは，次の予約部品プロパティが自動作成されます。

表4‒8　実行ホストを指定する予約部品プロパティ

プロパティキー

説明

plugin.destinationHost

操作対象ホストを，IPv4アドレス，IPv6アドレス，またはホスト名で指定します。サーバおよびコマンド実行環境が相互に直接参照できるネットワーク構成にある，対象ホストを指定する必要があります。ただし，JP1/AOサーバのOSがLinuxで，かつ操作対象の機器のOSがWindowsの場合は，接続先にIPv6アドレスを指定できません。

1〜256文字で指定します。

認証情報を指定するための予約部品プロパティ

部品の認証種別として［部品作成］または［部品編集］ダイアログボックスの「認証種別」で［エージェントレス接続先設定を使用］または［プロパティを指定］を選択します。

［エージェントレス接続先設定を使用］

［エージェントレス接続先定義］ビューに設定されている認証情報を使用する場合に選択します。選択すると，JP1/AOのログインユーザーのIPアドレスに応じて，WMI，SSHまたはTelnetのエージェントレス接続先定義に設定済みの認証情報が適用されます。

［プロパティを指定］

プロパティに指定した認証情報を使用する場合に選択します。

［プロパティを指定］を指定した場合，［部品の入力プロパティ編集］ダイアログボックスのプロパティに，次の予約部品プロパティが自動作成されます。なお，ローカル実行機能が有効の場合で，実行ホストがローカルホストのときは，これらの設定内容は無視されます。

表4‒9　認証情報を指定する予約部品プロパティ

プロパティキー

説明

plugin.account

部品の［認証種別］として［プロパティで指定］を選択した場合に，対象ホストにログインする際に使用するユーザーIDを1〜256文字で指定します。

plugin.password

部品の［認証種別］として［プロパティで指定］を選択した場合に，対象ホストにログインする際に使用するパスワードを1〜256文字で指定します。

予約部品プロパティ「plugin.publicKeyAuthentication」に「true」を指定した場合，「plugin.password」に入力した値は無視されます。

plugin.suPassword

部品の［認証種別］として［プロパティで指定］を選択した場合に，UNIX環境の対象ホストにログインする際に使用するrootのパスワードを1〜256文字で指定します。

次の場合，rootのパスワードを指定しても無視されます。

対象ホストがWindows環境の場合

［部品作成］ダイアログボックスまたは［部品編集］ダイアログボックスの［root権限で実行(SSH接続用)］をチェックしていない場合

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」を指定した場合，パスワード認証が設定されます。

4.3.7　標準出力および標準エラー出力を出力プロパティにマッピングする手順

コマンドまたはスクリプトの標準出力および標準エラー出力を出力プロパティにマッピングします。

デフォルトでは，「出力プロパティのマッピング定義一覧」に表示されるプロパティの出力フィルタは空欄です。そのため，コマンドまたはスクリプトの標準出力および標準エラー出力が，すべて出力プロパティに格納される設定になっています。標準出力および標準エラー出力の値を切り出して出力プロパティにマッピングしたい場合は，［出力フィルタ編集］ダイアログボックスで正規表現を設定します。

［部品作成］ダイアログボックスまたは［部品編集］ダイアログボックスを表示していない場合の手順：

［エディタ］画面の［部品］ビューで［開発］タブを選択します。

部品を新規作成する場合，［作成］ボタンをクリックします。

または，部品を編集する場合，部品を選択して［編集］ボタンをクリックします。

標準出力および標準エラー出力を出力プロパティにマッピングするには：

［部品作成］ダイアログボックスまたは［部品編集］ダイアログボックスの「リモートコマンド」で［編集］ボタンをクリックします。

「出力プロパティのマッピング定義一覧」でプロパティを選択し，［編集］ボタンをクリックします。

「出力プロパティのマッピング定義一覧」に表示される出力プロパティは，部品プロパティの設定時に登録した出力プロパティだけです。

［出力フィルタ編集］ダイアログボックスの「出力フィルタ」を，PCREに従った正規表現で入力し，［OK］ボタンをクリックします。

設定した出力フィルタを検証したい場合は，［標準出力/標準エラー出力］テキストボックスにテスト用の標準出力および標準エラー出力を入力し，［出力フィルタの動作確認］ボタンをクリックします。

出力フィルタで切り出された値が「出力プロパティの値」に表示されます。

関連トピック

4.3.8　「出力フィルタ」の指定方法について

4.3.8　「出力フィルタ」の指定方法について

コマンドまたはスクリプトの標準出力を出力プロパティに格納できます。

「出力フィルタ」にPCREに従った正規表現を定義することで，コマンドまたはスクリプトの標準出力および標準エラー出力から任意の文字列を切り出して，部品の出力プロパティに格納できます。

注意事項

正規表現に複数のグループを指定した場合，最初のグループに該当する範囲だけが部品の出力プロパティに格納されます。

正規表現に複数の範囲が該当する場合，最初に該当する範囲だけが部品の出力プロパティに格納されます。複数の範囲を格納することはできません。

次に，コマンドまたはスクリプトの標準出力を出力プロパティに格納する場合の指定例を示します。

プロパティキー：output01

出力フィルタ：DATE=(.*)

この指定例の場合，出力プロパティ「output01」に，標準出力の「DATE=」以降の値が格納されます。

また，出力プロパティに戻り値を格納したい場合は，次のとおり部品を定義しスクリプトを作成してください。

「リモートコマンド編集」ダイアログボックスの「実行モード」に「スクリプト」を指定してください。

スクリプトは，実行したコマンドまたはスクリプトの戻り値を，出力フィルタに指定した正規表現で切り出せる形式で標準出力に表示するように作成してください。

4.3.9　スクリプトを設定する手順

操作対象ホストで実行するスクリプトを設定します。OS（WindowsまたはUNIX）に対応した部品を作成するために，スクリプトはOSごとに設定します。スクリプトに定義できるのは，操作対象の機器にあり，その機器で実行できるスクリプトまたはコマンドです。

スクリプトの設定方法には，作成済みのスクリプトを添付する方法と，スクリプトを直接入力する方法の2種類があります。

複数ファイルで構成されるスクリプトを定義する場合や，任意の文字セットや改行コードを使用してスクリプトを定義する場合は，「作成済みのスクリプトを添付する方法」を実施してください。「スクリプトを直接入力する方法」の場合，定義できるスクリプトファイルが1ファイルに限られ，保存されるスクリプトの文字セットや改行コードはOSごとに固定となります。

スクリプトファイルにはASCII文字を使用してください。次の文字は使用できません。

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

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

また，ファイル名にマルチバイト文字は使用できません。

部品として実行するスクリプトの戻り値に使用できる値は，0〜63の範囲です。

部品の標準出力および標準エラー出力が，100KB未満となるように部品およびサービステンプレートを設計する必要があります。部品の標準出力および標準エラー出力が100KBを超えると，その時点でコマンドが強制終了され，部品はエラーで終了します。このときのコマンドの実行結果は保証されません。

スクリプト実行時のロケールは，操作対象の機器のOSごとに異なります。操作対象の機器に設定されるロケールについては，「4.1.7　部品実行時に設定される操作対象の機器のロケールについて」を参照してください。

［部品作成］ダイアログボックスまたは［部品編集］ダイアログボックスを表示していない場合の手順：

［エディタ］画面の［部品］ビューで［開発］タブを選択します。

部品を新規作成する場合，［作成］ボタンをクリックします。

または，部品を編集する場合，部品を選択して［編集］ボタンをクリックします。

作成済みのスクリプトを添付する方法

［部品作成］ダイアログボックスまたは［部品編集］ダイアログボックスの「リモートコマンド」で［編集］ボタンをクリックします。

［リモートコマンド編集］ダイアログボックスの「実行モード」で［スクリプト］を選択します。

［コマンドライン］テキストボックスに，スクリプトを実行するためのコマンドを入力します。

登録できるスクリプトファイルは1つですが，zip形式のファイルに圧縮することで複数のファイルやフォルダ階層で構成されるスクリプトも登録できます。［コマンドライン］テキストボックスに入力するスクリプトのパスは，単一ファイルの場合，ファイル名を指定します。複数ファイルをzip形式にしたファイルの場合，ファイルを展開したパスをカレントとして，そこからの相対パスとなるように指定します。

「スクリプト設定」で［添付］を選択します。

「ファイル」で［選択］をクリックし，スクリプトを登録します。

スクリプトを直接入力する方法

［部品作成］ダイアログボックスまたは［部品編集］ダイアログボックスの「リモートコマンド」で［編集］ボタンをクリックします。

［リモートコマンド編集］ダイアログボックスの「実行モード」で［スクリプト］を選択します。

［コマンドライン］テキストボックスに，スクリプトを実行するためのコマンドを入力します。

「スクリプト設定」で［直接入力］を選択します。

「ファイル名」および「スクリプト」を設定します。

［ファイル名］には，［スクリプト］に記入するコードのファイル名を記入します。［スクリプト］には，スクリプトのコードを記入します。

ファイルを登録したあとでも，再度ファイルを登録し直すことができます。この場合，既存のファイルは選択し直したファイルで置き換えられます。

ポイント

コマンドおよびスクリプトを実行する際の戻り値の設定については，「4.3.11　コンテンツ部品の戻り値について」を参照してください。

関連トピック

4.3.10　［コマンドライン］テキストボックスの指定方法について

4.3.12　実行したコマンドまたはスクリプトの戻り値，部品の戻り値，ステップの戻り値の関係について

4.3.15　スクリプトの設定方法による差異

4.3.10　［コマンドライン］テキストボックスの指定方法について

「実行モード」の指定によって，［コマンドライン］テキストボックスの指定方法が異なります。また，入力プロパティの値を，実行するコマンドの引数として指定することもできます。

［コマンドライン］テキストボックスには，制御文字（¥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では，「"」でプロパティを囲むと，後続のプロパティ値が繰り上がって入力されます。「'」で囲むと，プロパティ値が空でも，後続のプロパティ値が繰り上がらないで，空のプロパティとして認識されます。繰り上がりを避けることで，定義したとおりの引数の内容や順番でスクリプトを実行できます。

関連トピック

4.3.11　コンテンツ部品の戻り値について

4.3.12　実行したコマンドまたはスクリプトの戻り値，部品の戻り値，ステップの戻り値の関係について

4.3.16　「実行ディレクトリ」の指定方法について

4.3.11　コンテンツ部品の戻り値について

コンテンツ部品の戻り値を次に示します。

表4‒10　コンテンツ部品の戻り値

部品の戻り値

説明

-1

部品実行中に「強制停止」の操作で中断された。

0〜63※

戻り値の意味は，コンテンツ部品ごとに異なる。

64

コンテンツ部品で実行したコマンドが，戻り値0〜63以外で終了した。

65

JP1/AOサーバとの接続に失敗した。例えば，部品実行中にJP1/AOサーバが停止された場合が該当する。

66

次のユーザーがJP1ユーザーにマッピングされている。

Administratorsグループに所属しないユーザー

Administratorsグループに所属するビルトインAdministrator以外で，UACが有効であるユーザー

68

対象のジョブ実行IDに関する情報がない。

69

タスク処理エンジンの環境変数の取得に失敗した。

70

リモートホストへの接続に失敗した。

71

コマンド実行の呼び出しに失敗した。

72

コマンド実行の状態取得に失敗した。

73

転送に失敗した。

74

ファイル削除に失敗した。

76

接続がタイムアウトした。

77

リモートホストのホスト名の名前解決に失敗した。

78

次のどれかの理由で，リモートホストとの認証に失敗した。

パスワード認証に失敗した。

操作対象の機器に公開鍵認証機能が設定されていない。

公開鍵認証で，秘密鍵とパスフレーズが一致していない。

公開鍵認証で，秘密鍵と操作対象の機器に登録されている公開鍵が対になっていない。

公開鍵認証で，不正な秘密鍵が使用されている。

キーボードインタラクティブ認証に失敗した。

80

タスクの実行を停止した。

81

部品が不正な状態で呼び出された。

82

タスク処理エンジンからの要求メッセージを正しくパースできない。

83

JP1/AOサーバの環境が壊れている。

84

指定された部品の情報が取得できない。

86

指定したプロパティ値に誤りがある。

127

そのほかのエラーが発生した。

注※

［エディタ］画面で作成した部品の場合，実行するコマンドまたはスクリプトの戻り値と同じです。JP1/AOが提供しているコンテンツ部品の場合，戻り値の意味はマニュアル「JP1/AO サービステンプレートリファレンス」の各コンテンツ部品のトピックを参照してください。

関連トピック

4.3.12　実行したコマンドまたはスクリプトの戻り値，部品の戻り値，ステップの戻り値の関係について

4.3.12　実行したコマンドまたはスクリプトの戻り値，部品の戻り値，ステップの戻り値の関係について

コマンドまたはスクリプトの戻り値は，基本的にはそのまま部品の戻り値として使用されます。例えば，エージェントレス接続を行って接続先ホスト上でコマンドを実行する部品（コンテンツ部品および汎用コマンド実行部品）が接続先ホストでコマンドまたはスクリプトを実行した場合，コマンドまたはスクリプトの戻り値が，そのまま部品の戻り値になります。ただし，ターミナルコマンド実行部品は，コマンドまたはスクリプトの戻り値を部品の戻り値として設定しないため対象外となります。

コマンドまたはスクリプトの戻り値として使用できる値は，0〜63の範囲です。戻り値が0〜63の範囲外である場合は，範囲外の値である旨を示す「64」が部品の戻り値になります。また，コマンドまたはスクリプトが実行できなかった場合，その要因に応じて，65以上の値が戻り値になります。

部品の戻り値は，基本的にはそのままステップの戻り値として使用されます。ただし，部品の実行時に障害が発生した場合や，タスクを強制停止した場合などは，部品の戻り値とステップの戻り値が異なることがあります。この場合は，ステップの戻り値の情報を基に，必要な対処を実施してください。

関連トピック

4.3.13　コマンドまたはスクリプトの戻り値をフローの分岐条件に使用する手順（戻り値が0〜63の範囲外の場合）

4.3.13　コマンドまたはスクリプトの戻り値をフローの分岐条件に使用する手順（戻り値が0〜63の範囲外の場合）

部品として実行するコマンドまたはスクリプトが，0〜63の範囲外の戻り値を返す場合に，その戻り値をフローの分岐条件に使用したいときは，次の手順を実施してください。

コマンドまたはスクリプトの戻り値をフローの分岐条件に使用するには：

部品の作成または編集時に，［リモートコマンド編集］ダイアログボックスの「実行モード」で「スクリプト」を指定します。

実行するコマンドの戻り値を標準出力として出力するように，スクリプトを作成します。

［出力フィルタ編集］ダイアログボックスで，標準出力から，コマンドまたはスクリプトの戻り値を部品の出力プロパティに設定するように指定します。

出力プロパティマッピングで，手順3の部品の出力プロパティの値をサービスプロパティ（変数）に代入するように設定します。

基本部品の値判定分岐部品を使用して，手順4のサービスプロパティ（変数）を判定するように設定します。

関連トピック

マニュアル「JP1/AO サービステンプレートリファレンス」−「値判定分岐部品」のトピッ ク

4.3.14　部品の標準出力について

［コマンドライン］テキストボックスに指定したコマンドまたはスクリプトの，標準出力および標準エラー出力がそのまま部品の標準出力となります。

ただし，部品の標準出力は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)」

4.3.15　スクリプトの設定方法による差異

スクリプトの設定方法には，作成済みのスクリプトを添付する方法と，スクリプトを直接入力する方法の2種類があります。それぞれの差異を次に示します。

「添付」を選択

zip形式にすることで，複数ファイルや複数フォルダで構成されるスクリプトファイルを登録できます。

ただし，拡張子がzipの圧縮ファイルは，部品をJP1/AOサーバに保存するときにファイル名が変更されます。ファイル名は，OSごとに「windows.zip」，「aix.zip」，「hpux.zip」，「linux.zip」または「solaris.zip」に変更されます。「添付」を選択して登録したファイルは，JP1/AOをWebブラウザーで操作する端末にダウンロードできます。スクリプトを直接入力した場合は，定義したスクリプトファイルをダウンロードできません。

「直接入力」を選択

操作対象の機器で実行するスクリプトの内容を［リモートコマンド編集］ダイアログボックスで直接入力します。スクリプトに定義できるのは，操作対象の機器にあり，その機器で実行できるスクリプトまたはコマンドです。この場合，定義できるスクリプトファイルは1ファイルだけです。保存されるスクリプトの文字セットや改行コードは，操作対象の機器のOSに従って固定となります。

そのため，複数ファイルで構成されるスクリプトファイルを登録したい場合や，任意の文字セットや改行コードを設定したい場合は，「添付」を選択してください。

［スクリプト設定］での設定内容による，ファイルの登録方法，設定される文字セットおよび改行コードの差異を次の表に示します。

表4‒11　スクリプトの設定方法による差異

項目

「添付」を選択

「直接入力」を選択

Windows

AIX，HP-UX，Linux，Solaris

Windows

AIX，HP-UX，Linux，Solaris

単一ファイルの登録

登録できる

登録できる

複数ファイルの登録

登録できる

登録できない

保存されるスクリプトの文字セット

登録ファイルの文字セットが設定される

JP1/AOサーバのOSのデフォルトの文字セット

UTF-8

保存されるスクリプトの改行コード

登録ファイルの改行コードが設定される

CR+LF

LF

関連トピック

4.3.9　スクリプトを設定する手順

4.3.12　実行したコマンドまたはスクリプトの戻り値，部品の戻り値，ステップの戻り値の関係について

4.3.16　「実行ディレクトリ」の指定方法について

スクリプトまたはコマンドを実行するフォルダの絶対パスを指定します。実行ディレクトリには，JP1/AOサーバのOSと操作対象の機器のOSの両方のコマンドに入力できる文字を指定してください。

実行ディレクトリのパスに空白が含まれる場合でも「"」や「'」で囲まないでください。囲んだ場合，部品の実行が失敗します。また，実行ディレクトリは，事前に操作対象のホスト上に作成してください。事前に実行ディレクトリを作成していない場合は，部品の実行に失敗することがあります。

実行ディレクトリの指定方法は「実行ディレクトリ」に指定する方法と，プロパティファイル（config_user.properties）に指定する方法があります。実行ディレクトリは，次の優先順位に従って設定されます。

操作対象のホストがWindowsの場合

「実行ディレクトリ」に指定した値

プロパティファイル（config_user.properties）のキー「plugin.remoteCommand.executionDirectory.wmi」に指定した値

操作対象のホストの環境変数「%TEMP%」の値

操作対象のホストがUNIXの場合

「実行ディレクトリ」に指定した値

プロパティファイル（config_user.properties）のキー「plugin.remoteCommand.executionDirectory.ssh」に指定した値

/tmp

なお，「実行モード」の指定によって，次のとおり動作が異なります。

「実行モード」に「スクリプト」を指定した場合

「実行ディレクトリ」に指定したフォルダ配下のユニークな名称の一時フォルダに，スクリプトをコピーします。スクリプトは，一時フォルダ配下で実行されます。なお，スクリプトの実行完了後に，コピーしたスクリプトおよび一時フォルダは削除されます。

「実行モード」に「コマンド」を指定した場合

［実行ディレクトリ］に指定したディレクトリでコマンドラインが実行されます。

4.3.17　コマンドを設定する手順

操作対象ホストのOS（Windows，AIX，HP-UX，LinuxまたはSolaris）に応じて，実行するコマンドを設定します。複数のOSに対応した部品を作成する場合は，OSごとに設定します。

コマンドに設定できるのは，操作対象の機器にあり，その機器で実行できるスクリプトまたはコマンドです。

なお，部品として実行するコマンドの戻り値に使用できる値は，0〜63の範囲です。

部品の標準出力および標準エラー出力が，100KB未満となるように部品およびサービステンプレートを設計する必要があります。部品の標準出力および標準エラー出力が100KBを超えると，その時点でコマンドが強制終了され，部品はエラーで終了します。このときのコマンドの実行結果は保証されません。

［部品作成］ダイアログボックスまたは［部品編集］ダイアログボックスを表示していない場合の手順：

［エディタ］画面の［部品］ビューで［開発］タブを選択します。

部品を新規作成する場合，［作成］ボタンをクリックします。

または，部品を編集する場合，部品を選択して［編集］ボタンをクリックします。

コマンドを設定するには：

［部品作成］ダイアログボックスまたは［部品編集］ダイアログボックスの「リモートコマンド」で，操作対象ホストのOSに応じて［編集］ボタンをクリックします。

［リモートコマンド編集］ダイアログボックスの「実行モード」で［コマンド］を選択します。

「コマンドライン」を指定し，［OK］ボタンをクリックします。

関連トピック

4.3.10　［コマンドライン］テキストボックスの指定方法について

4.4　部品を削除する

4.4.1　部品を削除する手順

［開発］タブおよび［リリース］タブに表示されている部品を削除できます。部品を削除すると，部品の定義がJP1/AO サーバから削除されて，［開発］タブおよび［リリース］タブの部品一覧からも削除されます。

ただし，削除対象の部品を使用している開発サービステンプレートまたはリリースサービステンプレートが1つでもある場合は，その部品を削除できません。また，削除対象の部品をステップで使用している開発サービステンプレートがビルド済みの場合も，削除できません。この場合，開発サービステンプレートから，削除対象の部品を使用しているステップを削除したあとで，ビルドを再実行してください。ビルドしたあとに，部品を削除できるようになります。

部品を削除するには：

［エディタ］画面の［部品］ビューで［リリース］タブまたは［開発］タブを選択します。

削除する部品を選択して［操作］プルダウンメニューから［削除］を選択します。

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

部品が削除されます。

4.5　部品を複製する

4.5.1　部品を複製する手順

開発部品またはリリース部品の設定内容はそのまま保ち，別名の開発部品として複製します。既存の部品を基に新たな部品を開発する場合や，部品の修正版を作成する場合に利用できます。

部品を複製するには：

［エディタ］画面の［部品］ビューで［リリース］タブまたは［開発］タブを選択します。

複製する部品を選択して［操作］プルダウンメニューから［複製］を選択します。

［部品複製］ダイアログボックスで，部品ID，部品バージョン，ベンダーIDのうち，少なくとも1つを変更し，［保存］ボタンをクリックします。

「com.hitachi.software.dna」で始まるベンダーIDはJP1/AOで予約しているため指定できません。複製元の部品のベンダーIDが「com.hitachi.software.dna」で始まる場合は，複製時に「ベンダーID」および「ベンダー名」が削除されます。

部品が複製されたら，続けて部品の定義情報を設定します。

関連トピック

4.2.2　部品の作成または複製時に設定する項目について

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

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

4.6.1　部品リソースファイルを設定する手順

部品リソースファイルを設定すると，部品に表示する情報を設定できます。部品リソースファイルを直接編集したい場合は，部品リソースファイルをダウンロードしてファイルを書き換えます。

ただし，リリース済みのサービステンプレートに含まれる部品の表示情報は設定できません。

部品リソースファイルを設定するには：

［エディタ］画面の［部品］ビューで部品を選択します。

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

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

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

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

アップロードした部品リソースファイルの名称が「plugin_ja.properties.txt」以外の場合はエラーになります。

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

注意事項

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

関連トピック

4.6.2　部品リソースファイルの形式

4.6.3　部品の表示情報と部品リソースファイルのプロパティとの対応

4.6.2　部品リソースファイルの形式

部品リソースファイルは，JP1/AOの操作画面で表示する部品の項目を定義したファイルです。部品ファイルの形式を次に示します。

部品リソースファイルのファイル名は「plugin_ja.properties.txt」です。

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

例えば，「plugin.displayName=テスト用部品」のように記述してください。

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

プロパティキーは1〜128文字以内で記述してください。プロパティキーに記述できる文字を次に示します。

半角英数字

半角ハイフン「-」

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

半角ピリオド「.」

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

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

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

大文字と小文字は区別されます。

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

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

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

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

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

abc¥t=¥tc

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

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

abc¥t=¥t=¥tc

サロゲートペア文字は無視されます。

4.6.3　部品の表示情報と部品リソースファイルのプロパティとの対応

［エディタ］画面で管理する部品の表示情報は，画面上で設定できます。画面上で設定した表示情報は，部品リソースファイルにも定義されています。部品の表示情報と，部品リソースファイルのプロパティの対応を次に示します。

表4‒12　画面の表示情報と部品リソースファイルの対応

部品の表示情報

部品リソースファイルのプロパティ

部品名

plugin.displayName

ベンダー名

plugin.vendorDisplayName

説明

plugin.shortDescription

入力プロパティ名・出力プロパティ名

property.プロパティキー.displayName

入力プロパティの説明・出力プロパティの説明

property.プロパティキー.description

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

サービステンプレートを作成したら，本番環境で実行しても問題ないかどうか，検証します。

5.1　サービステンプレートを検証する概要

5.1.1　サービステンプレートを検証する流れ

フローを作成または編集したあと，開発サービステンプレートをビルドおよびデバッグして，フローの遷移や部品の処理の問題点を摘出します。問題点が摘出された場合，サービステンプレートまたは部品を編集し，再度ビルドおよびデバッグします。すべての問題点が解消されたら，開発環境でサービスを実行して，運用テストをします。

サービステンプレートを検証する流れを次の図に示します。

図5‒1　サービステンプレートを検証する流れ

ビルド

フローを作成または編集したら，サービステンプレートをビルドして，動作を確認できる状態にします。

デバッグ

ビルドに成功したら，サービステンプレートをデバッグして，フローや部品の問題点を摘出します。デバッグ実行すると，デバッグサービスおよびデバッグタスクが生成されます。

デバッグタスクの実行結果を確認して，問題点が摘出されたら，サービステンプレートを修正し，再度ビルドおよびデバッグします。

すべての問題点が解消されるまで，サービステンプレートの修正，ビルド，およびデバッグを繰り返します。

運用テスト

すべての問題点が解消されたら，開発環境でサービスを追加・実行して，運用テストを行います。

タスクの実行結果を確認して，問題点が摘出されたら，サービステンプレートまたは部品の修正からやり直します。

問題がなければサービステンプレートをリリースします。

なお，デバッグおよび運用テストは必要に応じて実施してください。

サービステンプレートをビルドする場合の関連トピック

5.1.2　ビルドとは

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

サービステンプレートをデバッグする場合の関連トピック

5.1.3　デバッグとは

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

5.4　デバッグタスクを管理する

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

5.1.4　運用テストとは

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

5.1.2　ビルドとは

ビルドとは，［エディタ］画面で作成または編集したサービステンプレートを検証するための操作です。ビルドに成功すると，サービステンプレートがパッケージングされ，デバッグしたり，サービスとして追加したりできる状態になります。

目的

開発サービステンプレートを検証する場合にビルドを行います。ビルドしたサービステンプレートは，デバッグ構成のサービステンプレートとしてパッケージングされたあと，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.2　開発サービステンプレートおよびリリースサービステンプレートとは

5.1.1　サービステンプレートを検証する流れ

5.2.1　サービステンプレートをビルドする手順

付録A.1　ビルドおよびリリースの参考情報

5.1.3　デバッグとは

デバッグとは，［デバッグ］ビューおよびサービステンプレートデバッグビューを使用して，ビルドしたサービステンプレートの動作を確認し，フローや部品の問題点を摘出するための操作です。サービステンプレートをデバッグすると，デバッグサービスおよびデバッグタスクが生成されます。デバッグは，デバッグタスクを実行しながら行います。

デバッグで問題点が摘出された場合は，デバッグを停止し，サービステンプレートまたは部品を編集します。

目的

サービステンプレートのフローや部品が，設計したとおりに動作するかを確認するためにデバッグを行います。例えば，プロパティマッピングの設定や，後続ステップ実行条件によるフローの分岐が設計どおりかを確認できます。［デバッグ］ビューおよびサービステンプレートデバッグビューを使用すると，次のことができます。

階層フローや繰り返し実行フローを含む，すべての階層におけるフローの遷移や，部品の処理の結果を確認しながらデバッグタスクを実行できます。

プロパティマッピングの設定に従って，プロパティの値が正しく設定されているか，確認しながらデバッグタスクを実行できます。

部品の問題点が摘出された場合，部品のプロパティの値や戻り値を変更して実行できます。そのため，部品のプロパティの値や戻り値に任意の値を指定したときの，部品の処理やフローの遷移を確認できます。

実行できる回数

1つのサービステンプレートに対して，デバッグは何回でも実行できます。また，デバッグ中にサービステンプレートの問題点が摘出された場合は，開発サービステンプレートまたは開発部品の修正から，ビルド，デバッグまでの一連の作業を，すべての問題点が解消されるまで繰り返し実施してください。

デバッグサービスとは

サービステンプレートのデバッグ時に生成・実行されるサービスのことです。生成されるデバッグサービスは，1つのサービステンプレートにつき1つです。一度デバッグしたサービステンプレートを再度デバッグした場合，前回生成されたデバッグサービスは削除され，新しいデバッグサービスが生成されます。

なお，デバッグサービスは，［デバッグタスク一覧］ビューのサービス名の列に表示され，［サービス］画面には表示されません。

デバッグタスクとは

サービステンプレートのデバッグ時に，デバッグサービスの生成に伴って生成されるタスクのことです。一度デバッグしたサービステンプレートを再度デバッグした場合，前回生成されたデバッグタスクは削除され，新しいデバッグタスクが生成されます。

デバッグタスクは，サービステンプレートデバッグビューおよび［デバッグタスク一覧］ビューに表示され，AdminまたはDevelopロールが設定されているユーザーだけが参照および操作できます。

なお，デバッグタスクの状態はタスクサマリーに表示されません。

関連トピック

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

5.1.1　サービステンプレートを検証する流れ

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

5.3.2　デバッグ時に組み合わせて使用する機能一覧

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

5.1.4　運用テストとは

運用テストは，ビルドしたサービステンプレートからサービスを追加し，開発環境で実行して，運用しても問題がないかを最終確認するための操作です。

運用テストで問題点が摘出された場合は，［エディタ］画面から，サービステンプレートまたは部品を編集します。

目的

サービステンプレートから生成したサービスを実行し，本番環境で実行しても問題がないかを確認するために運用テストを行います。運用テストでは，実運用と同じように，［サービス］画面からサービスを追加・実行して，サービステンプレートのユーザビリティについても確認できます。例えば，サービスの実行契機を指定して，用途に合った運用ができるかを確認したり，プロパティの可視性を確認したりできます。

実行できる回数

1つのサービステンプレートに対して，運用テストは何回でも実行できます。また，運用テストでサービステンプレートの問題点が摘出された場合は，開発サービステンプレートまたは開発部品の修正から，ビルド，デバッグ，運用テストまでの一連の作業を，すべての問題点が解消されるまで繰り返し実施してください。

関連トピック

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

5.1.1　サービステンプレートを検証する流れ

5.5.1　サービステンプレートの運用をテストする手順

マニュアル「JP1/AO 運用ガイド」−「サービスの管理」のトピック

マニュアル「JP1/AO 運用ガイド」−「サービスの実行」のトピック

マニュアル「JP1/AO 運用ガイド」−「タスクの管理」のトピック

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

5.2.1　サービステンプレートをビルドする手順

サービステンプレートを選択してビルドすると，サービステンプレートパッケージが作成され，JP1/AOサーバにインポートされます。ビルドしたサービステンプレートは，デバッグしたり，運用テストしたりできる状態になります。

注意事項

フロー内にステップとして配置されている状態で，部品の定義を編集すると，ステップに定義したマッピングパラメータと部品プロパティに不整合が生じるおそれがあります。不整合が生じると，ビルド時にエラーとなります。その場合は，プロパティの設定や部品の配置をやり直して，不整合を解消してください。

サービステンプレートエディタ編集ビューを表示していない場合の手順：

［サービステンプレートエディタホーム］ビューの［作業の開始］で，［編集］をクリックします。

［サービステンプレート一覧］画面でサービステンプレートを選択し，［編集］ボタンをクリックします。

サービステンプレートをビルドするには：

サービステンプレートエディタ編集ビューで，［ビルド/デバッグ］ボタンをクリックします。

確認画面で［OK］ボタンをクリックします。

ビルドの結果が，［ビルド/リリース結果］ダイアログボックスに表示されます。

引き続き，デバッグをする場合は，［デバッグ実行］ボタンをクリックします。デバッグを開始する手順については，「5.3.4　デバッグを開始する手順」を参照してください。

デバッグをしない場合は，［デバッグ終了］ボタンをクリックします。

なお，ビルド時にエラーが発生した場合は，エラー原因とフローの修正を促すメッセージが通知されます。このとき発生したエラーはサービステンプレートエディタ編集ビューを閉じるまで表示されます。

対象のサービステンプレートがほかのユーザーによって，すでにリリースされていた場合や削除されていた場合はエラーとなり，ビルドに失敗します。

関連トピック

2.1.4　［エディタ］画面で割り込み操作があった場合の動作

5.1.1　サービステンプレートを検証する流れ

5.1.2　ビルドとは

付録A.1　ビルドおよびリリースの参考情報

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

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

ビルドに成功したら，サービステンプレートをデバッグして，フローや部品の問題点を摘出します。

サービステンプレートをデバッグする流れを次に示します。

サービステンプレートに含まれる部品をすべて実行しても問題ない場合，まずは，ステップごとに中断しないで，デバッグタスクを実行します。

［デバッグ］ビューやサービステンプレートデバッグビューで，フローの遷移や部品の処理に問題点がないかを確認します。

サービステンプレートに実行したくない部品が含まれている場合は，手順1を実行しないで，手順2から実行してください。

フローの遷移や部品の処理に問題点が摘出されたら，次は，ステップごとに中断しながらデバッグを実行して，問題点の個所や内容を特定します。必要に応じて，設計とは異なる入力プロパティや出力プロパティの値を指定し，動作を確認します。サービステンプレートデバッグビューの［デバッグ実行］ボタンをクリックして，デバッグを何度でも実行できます。

サービステンプレート編集ビューで，サービステンプレートを修正します。

再度サービステンプレートをビルドし，デバッグします。1〜4の流れを，すべての問題点が解消されるまで繰り返します。

すべての問題点が解消されたことを確認し，デバッグを終了します。

ポイント

一度デバッグタスクを実行したあと，サービステンプレートを修正しないで再度デバッグする場合，ビルドは必要ありません。

関連トピック

5.1.1　サービステンプレートを検証する流れ

5.1.2　ビルドとは

5.1.3　デバッグとは

5.3.2　デバッグ時に組み合わせて使用する機能一覧

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

5.3.2　デバッグ時に組み合わせて使用する機能一覧

サービステンプレートのデバッグに関する機能一覧を次の表に示します。サービステンプレートをデバッグする場合は，これらの機能を目的に合わせて使用してください。

表5‒1　デバッグ時に組み合わせて使用する機能一覧

機能

概要

説明個所

デバッグ実行時の中断設定

デバッグタスクの実行方法を，次の2つから選択できます。

1ステップずつ中断しないで実行する

通常のタスクの実行と同様に，デバッグタスクの処理を中断することなく実行します。デバッグタスクの実行結果を確認して，フローの中で問題のあるステップを特定できます。

1ステップずつ中断して実行する

デバッグタスクを，1ステップずつ中断しながら実行します。そのため，プロパティの値や部品の戻り値などを1ステップずつ確認しながら，デバッグタスクの処理を進められます。

5.3.4　デバッグを開始する手順，5.3.7　ステップごとに中断しないでデバッグする流れ，5.3.8　ステップごとに中断してデバッグする流れ

フローの情報表示

デバッグタスクのフローを次の2通りの方法で表示できます。

フロー表示

サービステンプレートデバッグビューおよび［タスク］画面で，すべての階層におけるフローの遷移やステップの状態を確認できます。

フローツリー表示

サービステンプレートデバッグビューで，フローの階層をツリー形式で確認できます。また，各フローの階層に中断中のステップがあるかどうかを確認できます。

［タスク］画面からも，フローの階層をツリー形式で確認できます。

5.3.24　デバッグタスクのフロー表示について，5.3.25　デバッグタスクのフローツリー表示について，5.4　デバッグタスクを管理する

タスクログの表示

サービステンプレートデバッグビューの［タスクログ］タブに，タスクログを常に表示できます。タスクログは自動更新できます。

5.4.4　デバッグタスクのタスクログを確認する手順

プロパティマッピングの設定の確認

部品のプロパティの値およびプロパティマッピングの設定を，［デバッグ］ビューに表示できます。サービステンプレートデバッグビューの［プロパティ一覧］タブに表示されるサービスプロパティの値と併せて参照して，プロパティマッピングが正しく設定されているかを確認できます。

5.3.16　デバッグ時にプロパティマッピングの設定を確認する手順

ステップの情報変更※

部品のプロパティや戻り値を，任意の値に変更できます。

部品の処理を実行する前にステップを中断して，入力プロパティの値を変更できます。

部品の処理を実行したあとにステップを中断して，出力プロパティの値や戻り値を変更できます。

5.3.17　デバッグ時に部品の入力プロパティの値を変更する手順，5.3.18　デバッグ時に部品の出力プロパティの値を変更する手順，5.3.19　デバッグ時に部品の戻り値を変更する手順

部品の処理のスキップ※

部品の処理を実行しないで，ステップの実行が終了したものとして処理できます。

5.3.12　デバッグ時に部品の処理をスキップする手順

タスクのリトライ

デバッグタスクが失敗した場合に，次の2つの方法でリトライできます。

失敗したステップからリトライ

失敗したステップからもう一度実行できます。

失敗した次のステップからリトライ

失敗したステップを正常終了したものとして処理し，次のステップから実行できます。

5.3.13　デバッグ時に失敗したステップからリトライする手順，5.3.14　デバッグ時に失敗した次のステップからリトライする手順

デバッグタスクの管理

デバッグタスクに対して，次のことができます。

すべてのデバッグタスクの一覧表示

デバッグタスクの実行停止

デバッグタスクの強制停止

デバッグタスクの削除

5.4　デバッグタスクを管理する

注※

デバッグ実行時の中断設定に，「1ステップずつ中断して実行する」を選択している場合に，使用できる機能です。

関連トピック

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

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

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

デバッグでは，ユーザーが確認したい項目に応じて，さまざまな設定を組み合わせる必要があります。

サービステンプレートをデバッグする操作の例を次に示します。

この例では，次のような場合に，サービステンプレートをデバッグする手順について説明します。

デバッグするサービステンプレートの問題点

問題1：

ステップAの入力プロパティと，サービスプロパティのマッピングの設定に問題がある。

ユーザーの意志

意志1：

サービステンプレートを修正する前に，ほかのステップの実行結果を確認したい。

意志2：

部品Aの処理を確認したい。

意志3：

部品Bの処理は実行したくない。

意志4：

部品Cの処理の結果を確認したい。

図5‒2　サービステンプレートのデバッグ例

意志3のとおり，フローの中に実行したくない部品があるため，1ステップずつ中断しながらデバッグタスクを実行します。デバッグ開始時，［デバッグ実行］ダイアログボックスで，［中断設定］リストボックスから［1ステップずつ中断する］を選択します。

サービスの定義情報を指定し，［実行］ボタンをクリックします。

［デバッグ］ビューおよびサービステンプレートデバッグビューが表示されます。

［デバッグ］ビューで，ステップAの入力プロパティAの値を確認します。［プロパティ一覧］タブに表示されている，サービスプロパティ入力1の値が正しくマッピングされているかを確認します。

こうすることで，ステップAの入力プロパティのマッピングに，問題を発見できます（問題1）。

意志2のとおり，入力プロパティの値が正しく設定された場合の，部品Aの処理を確認するため，［デバッグ］ビューで，入力プロパティAの値を変更します。

［デバッグ］ビューの［再開］ボタンをクリックして，部品Aの処理を実行します。

［デバッグ］ビュー，［フロー］ビュー，および［タスクログ］タブで，ステップAの実行結果を確認します。

意志1のとおり，ほかのステップの実行結果を確認するため，デバッグタスクの処理を進めます。［フロー］ビューで，ステップBを選択します。

意志3のとおり，部品Bの処理をスキップするため，［デバッグ］ビューで，［実行設定］リストボックスから［部品の処理を実行しない］を選択します。

［デバッグ］ビューの［再開］ボタンをクリックして，ステップBを実行します。

部品Bの処理がスキップされ，ステップBの実行が終了します。

［フロー］ビューで，ステップBの後続ステップ実行条件に従って，ステップCの実行が開始されたことを確認します。

［デバッグ］ビューの［再開］ボタンをクリックして，部品Cの処理を実行します。

デバッグタスクが正常終了します。

意志4のとおり，［デバッグ］ビュー，［フロー］ビュー，および［タスクログ］タブで，ステップCの実行結果を確認します。

サービステンプレートデバッグビューの［デバッグ終了］ボタンをクリックします。

サービステンプレートエディタ編集ビューが表示されます。

ステップAのプロパティマッピングの設定を修正します。

サービステンプレートを保存したあと，サービステンプレートを再度ビルドおよびデバッグします。

関連トピック

5.1.1　サービステンプレートを検証する流れ

5.1.2　ビルドとは

5.1.3　デバッグとは

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

5.3.2　デバッグ時に組み合わせて使用する機能一覧

5.3.4　デバッグを開始する手順

サービステンプレートのビルドに成功したら，デバッグを開始します。デバッグを開始するには，デバッグサービス実行時の中断設定，およびデバッグサービス・デバッグタスクの定義情報を設定します。

なお，デバッグ実行時の実行契機は即時実行となります。

デバッグを開始するには：

［デバッグ実行］ダイアログボックスの［中断設定］リストボックスから，デバッグタスクの実行方法を選択します。

1ステップごとに中断しながら実行する場合は［1ステップずつ中断する］を，1ステップごとに中断しないで実行する場合は［中断しない］を選択します。

デバッグサービスの定義情報を設定します。

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

［エディタ］画面に，［デバッグ］ビューおよびサービステンプレートデバッグビューが表示され，デバッグタスクが実行されます。

中断設定で［1ステップずつ中断する］を選択している場合，1ステップずつ実行が中断されます。実行を再開する場合は，［デバッグ］ビューの［再開］ボタンをクリックします。

注意事項

中断設定では，デバッグタスクの実行を1ステップごとに中断するかどうか選択します。実行結果を確認しながらデバッグしたい場合や，実行したくない部品がある場合は，中断設定を［1ステップずつ中断する］にしてください。

［デバッグ実行］ダイアログボックスには，デバッグ実行するユーザーが最後にビルドしたときのサービステンプレートの状態が反映されます。デバッグ実行するユーザーがビルドしたあとで，ほかのユーザーが同一のサービステンプレートを編集し，ビルドしていた場合，その編集内容は反映されません。

次の場合，デバッグタスクは強制停止されます。

JP1/AOサーバが停止された場合

クラスタのフェールオーバーが発生した場合

JP1/AOからログアウトした場合

デバッグ実行中にWebブラウザーを閉じた場合，デバッグタスクは停止されないで，処理が自動的に完了するまで実行されたままになります。このとき，デバッグタスクの実行を1ステップずつ中断する設定にしている場合，実行中のステップまたは後続のステップで，デバッグタスクの処理が中断されたままになります。この場合，ユーザーは再度ログインして，［タスク］画面の［デバッグタスク一覧］ビューでデバッグタスクを停止させる必要があります。なお，一度閉じた［デバッグ］ビューおよびサービステンプレートデバッグビューは表示できません。デバッグタスクを実行したい場合は，再度サービステンプレートをビルドし，デバッグの実行をやり直してください。

サービステンプレートをビルドしてからデバッグを開始するまでの間に，ほかのユーザーが同じサービステンプレートをビルドした場合，［デバッグ実行］ダイアログボックスの［実行］ボタンをクリックしたあと，エラーになります。

デバッグタスクに含まれる部品について，1つのJP1/AOシステム内で同時実行できる部品の数は10までです。同時実行できる部品の数の上限や，上限を超えた場合の処理については，マニュアル「JP1/AO 運用ガイド」−「タスクに含まれる部品の同時実行数の上限について」のトピックを参照してください。

デバッグタスクの状態は，JP1イベント通知およびメール通知の対象となります。

関連トピック

5.3.2　デバッグ時に組み合わせて使用する機能一覧

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

5.3.5　デバッグを開始するときの設定項目について

5.3.7　ステップごとに中断しないでデバッグする流れ

5.3.8　ステップごとに中断してデバッグする流れ

5.3.5　デバッグを開始するときの設定項目について

［デバッグ実行］ダイアログボックスでは，中断設定，サービス名，カテゴリ，タスク名，タスクの説明，リソースグループ，タスクログのログ出力レベル，およびプロパティ値を設定できます。

表5‒2　［デバッグ実行］ダイアログボックスで設定する項目

項目

説明

中断設定

デバッグタスクの中断設定について，次のどちらかを選択します。

中断しない

デバッグタスク実行の過程でステップを中断しません。

1ステップずつ中断する

デバッグタスクを，1ステップずつ中断します。

サービス名

デバッグサービス名を設定します。デフォルトでは「[DEBUG]実行対象のサービステンプレート名」が設定されます。

カテゴリ

デバッグサービスのカテゴリを設定します。デフォルトでは「実行対象のサービステンプレートのカテゴリ」が設定されます。

タスク名

デバッグタスクのタスク名を設定します。デフォルトでは「[DEBUG]実行対象のサービステンプレート名_現在時刻(YYYYMMDDhhmmss)」が設定されます。

タスクの説明

デバッグタスクの説明を設定します。デフォルトは空白です。

リソースグループ

デバッグサービスを登録するリソースグループを選択します。デフォルトでは「All Resources」が設定されます。

タスクログのログ出力レベル

タスクログのログ出力レベルを選択します。デフォルトでは40が設定されます。

ここで設定したログ出力レベルは，デバッグタスクだけに適用されます。既存のビルトインサービス共有プロパティ「com.hitachi.software.dna.sys.task.log.level」には影響しません。

プロパティ値

サービスの入力プロパティの値を設定します。デフォルトでは，サービステンプレートの作成時に設定されたサービスプロパティの定義に従って設定されます。

ここで設定したプロパティの値は，デバッグタスク固有の値として使用され，システムのサービス共有プロパティには反映されません。そのため，サービス共有プロパティを参照しているほかのサービスには影響しません。

5.3.6　サービステンプレートをビルドしないで再度デバッグする手順

デバッグタスクを実行したあと，サービステンプレートを修正しないで再度デバッグ実行したい場合，サービステンプレートデバッグビューを表示したまま，新しいデバッグタスクを実行できます。このとき，再度ビルドする必要はありません。

なお，再度デバッグ実行すると，前に生成されたデバッグサービスおよびデバッグタスクは削除され，新しいデバッグサービスおよびデバッグタスクが生成されます。

ビルドしないで新しいデバッグタスクを実行するには：

デバッグタスクの状態が「正常終了」または「失敗」のときに，サービステンプレートデバッグビューで［デバッグ実行］ボタンをクリックします。

デバッグタスクの実行中に新しいデバッグタスクを実行したい場合は，実行中のデバッグタスクを強制停止してください。

［デバッグ実行］ダイアログボックスで，デバッグサービス実行時の中断設定，およびデバッグサービスの定義情報を設定します。

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

デバッグタスクが実行されます。

注意事項

［デバッグ実行］ダイアログボックスには，デバッグ実行するユーザーが最後にビルドしたときのサービステンプレートの状態が反映されます。デバッグ実行するユーザーがビルドしたあとで，ほかのユーザーが同一のサービステンプレートを編集し，ビルドしていた場合，その編集内容は反映されません。

サービステンプレートをビルドしないで再度デバッグ実行できるのは，サービステンプレートデバッグビューを表示している場合だけです。［デバッグ終了］ボタンをクリックしたり，JP1/AOからログアウトしたりして，サービステンプレートデバッグビューを閉じた場合は，サービステンプレートを再度ビルドしてからデバッグ実行してください。

関連トピック

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

5.3.5　デバッグを開始するときの設定項目について

5.4.6　デバッグタスクを強制停止する手順

5.3.7　ステップごとに中断しないでデバッグする流れ

通常のタスクの実行と同様に，ステップごとに中断しないでデバッグタスクを実行します。このとき，部品のプロパティの値や戻り値の変更はできません。

例えば，サービステンプレートまたは部品を編集したあと，タスクが正常終了するかどうかを確認したい場合や，フローの遷移に問題点がないかを確認したい場合などに使用します。

ステップごとに中断しないでデバッグする流れ：

［デバッグ実行］ダイアログボックスで，［中断設定］リストボックスから［中断しない］を選択します。

デバッグサービスの定義情報を指定します。

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

［デバッグ］ビューおよびサービステンプレートデバッグビューが表示され，デバッグタスクが実行されます。

［デバッグ］ビューおよびサービステンプレートデバッグビューで，実行結果を確認します。

デバッグタスクが終了したら，必要に応じてサービステンプレートまたは部品を編集します。

関連トピック

5.3.4　デバッグを開始する手順

5.3.5　デバッグを開始するときの設定項目について

5.3.16　デバッグ時にプロパティマッピングの設定を確認する手順

5.3.24　デバッグタスクのフロー表示について

5.4.4　デバッグタスクのタスクログを確認する手順

5.3.8　ステップごとに中断してデバッグする流れ

ステップごとに処理を中断しながら，デバッグタスクを実行します。ステップごとに中断してデバッグすると，次のことができます。複数のステップが並列で同時に動作するフローの場合も，すべてのステップでこれらを設定できます。

フローの遷移や部品の処理を1つずつ確認しながらデバッグタスクを実行できます。

部品の処理を実行するかを選択できます。

部品のプロパティの値や戻り値を変更できます。

例えば，フローで問題のある個所の見当がつき，内容を確認しながらタスク実行したい場合や，設計とは異なるプロパティの値を指定して，動作を確認したい場合などに使用します。

注意事項

部品の処理を実行する際に，部品の戻り値が65以上となった場合（部品の入力プロパティの値に誤りがあったときや，操作対象の機器のOSに接続できなかったときなど）は，部品の処理の実行後に中断する設定をしていても，中断されないで，デバッグタスクの処理が進みます。

ステップごとに中断してデバッグする流れ：

［デバッグ実行］ダイアログボックスで，［中断設定］リストボックスから［1ステップずつ中断する］を選択します。

デバッグサービスの定義情報を指定します。

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

［デバッグ］ビューおよびサービステンプレートデバッグビューが表示され，デバッグタスクが実行されます。

フローの最初のステップが実行され，部品の処理を実行する前に中断されます。フローの処理の流れについては，「5.3.9　ステップごとに中断してデバッグする場合の処理の流れ」を参照してください。

必要に応じて，［デバッグ］ビューおよび［プロパティ一覧］タブで入力プロパティのマッピングを確認したり，入力プロパティを任意の値に変更したりします。

部品の処理を実行するかどうかを選択します。部品の処理を実行しない場合，部品の出力プロパティおよび戻り値を指定します。部品の処理の実行後に部品の出力プロパティおよび戻り値を変更したい場合は，部品の処理後に中断する設定を行います。

［再開］ボタンをクリックし，ステップの実行を再開します。応答入力が必要な場合は，応答を入力します。

部品の処理が実行され，ステップの実行が終了します。

作業5で，部品の処理の実行後に中断する設定にした場合は，必要に応じて部品の出力プロパティおよび戻り値を変更し，［再開］ボタンをクリックします。

後続ステップ実行条件に従い，次のステップが実行され，部品の処理を実行する前に中断されます。

後続のステップを実行する場合は，4〜7の作業を繰り返します。

デバッグタスクが終了したら，必要に応じてサービステンプレートまたは部品を編集します。

関連トピック

5.3.4　デバッグを開始する手順

5.3.10　デバッグ時にステップ実行を中断できない部品

5.3.11　ステップ実行の中断時に変更できるステップの情報

5.3.15　応答待ち中のデバッグタスクの対処を入力する手順（応答入力）

5.3.16　デバッグ時にプロパティマッピングの設定を確認する手順

5.3.17　デバッグ時に部品の入力プロパティの値を変更する手順

5.3.18　デバッグ時に部品の出力プロパティの値を変更する手順

5.3.19　デバッグ時に部品の戻り値を変更する手順

5.3.9　ステップごとに中断してデバッグする場合の処理の流れ

デバッグ実行時の中断設定に［1ステップずつ中断する］を指定して，ステップの実行を開始すると，部品の処理が実行される前にステップが中断されます。ステップを再開したあとは，部品の実行設定によって処理の流れと中断されるタイミングが異なります。ここでは，次の場合について説明します。

ステップの実行開始時

部品の処理をスキップする場合

部品の出力プロパティおよび戻り値を変更する場合

ステップの実行開始時の処理の流れ

デバッグ実行時の中断設定に［1ステップずつ中断する］を指定して，ステップを実行した場合のデバッグタスクの処理について説明します。

図5‒3　ステップの実行開始時の処理の流れ

デバッグタスクを実行すると，ステップAの実行が開始されます。

部品Aの入力プロパティ「入力A」の値が生成されます。部品Aの処理が実行される前に，ステップAが中断されます。

ステップAの実行を再開すると，部品Aの処理が実行されます。

後続ステップ実行条件に従って，ステップBの実行が開始されます。

ステップBの入力プロパティ「入力B」の値が生成され，部品Bの処理が実行される前に，ステップBが中断されます。

部品の処理をスキップする場合の処理の流れ

デバッグ実行時の中断設定に［1ステップずつ中断する］を指定して，部品の実行設定に［実行しない］を指定した場合のデバッグタスクの処理について説明します。

図5‒4　部品の処理をスキップする場合の処理の流れ

ステップAが部品Aの処理前に中断されている状態で，部品Aの実行設定に「実行しない」を選択すると，出力プロパティの値および戻り値が指定できるようになります。

ステップAを再開すると，部品Aの実行がスキップされます。

指定した出力プロパティの値および戻り値に従って，ステップBの実行が開始されます。

ステップBの入力プロパティ「入力B」の値が生成されます。部品Bの処理が実行される前に，ステップBが中断されます。

部品の出力プロパティおよび戻り値を変更する場合の処理の流れ

デバッグ実行時の中断設定に［1ステップずつ中断する］を指定して，部品の実行設定に［部品の処理後に中断する］を指定した場合のデバッグタスクの処理について説明します。

図5‒5　部品の出力プロパティおよび戻り値を変更する場合の処理の流れ

ステップAが部品Aの処理前に中断されている状態で，部品Aの実行設定に「部品の処理後に中断する」を選択し，ステップAを再開すると，部品Aの処理が実行されます。

部品Aの処理後，ステップAの実行が終了する前に中断され，出力プロパティおよび戻り値が変更できるようになります。

ステップAを再開すると，指定した出力プロパティの値および戻り値に従って，ステップBの実行が開始されます。

ステップBの入力プロパティ「入力B」の値が生成されます。部品Bの処理が実行される前に，ステップBが中断されます。

関連トピック

5.3.8　ステップごとに中断してデバッグする流れ

5.3.11　ステップ実行の中断時に変更できるステップの情報

5.3.12　デバッグ時に部品の処理をスキップする手順

5.3.17　デバッグ時に部品の入力プロパティの値を変更する手順

5.3.18　デバッグ時に部品の出力プロパティの値を変更する手順

5.3.19　デバッグ時に部品の戻り値を変更する手順

5.3.10　デバッグ時にステップ実行を中断できない部品

デバッグ実行時の中断設定に［1ステップずつ中断する］を選択しても，ステップ実行を中断できない部品があります。中断できない部品の場合，該当ステップの後続ステップまで自動的にフローの処理が進みます。

表5‒3　部品ごとの中断可否

項番

部品名

中断可否

1

基本部品

汎用コマンド実行部品

○　

2

ファイル転送部品

○　

3

繰り返し実行部品

○　

4

メール通知部品

○　

5

ユーザー応答待ち部品

○　

6

標準出力部品

○　

7

ターミナル接続部品

○　

8

ターミナルコマンド実行部品

○　

9

ターミナル切断部品

○　

10

階層フロー部品

×　

11

実行間隔制御部品

×　

12

戻り値判定分岐部品

×　

13

値判定部品

○　

14

異常終了部品

×　

15

値判定分岐部品

×　

16

コンテンツ部品

○　

17

JP1/AO 10-10よりも下位のバージョンで作成したサービステンプレートに含まれる，互換性のないステップ

×　

（凡例）

○：中断できます。　×：中断できません。

5.3.11　ステップ実行の中断時に変更できるステップの情報

デバッグでステップの実行を中断しているときに，デバッグタスクのステップの情報を変更できます。デバッグの際，部品の問題点が摘出された場合に，入力プロパティや出力プロパティの値を変更して，動作を確認できます。

変更できるステップの情報は，中断するタイミングで異なります。

表5‒4　中断時に変更できるステップの情報

項目

部品の処理の実行前に中断しているとき

部品の処理の実行後に中断しているとき

部品の処理を実行する（スキップしない）場合

部品の処理を実行しない（スキップする）場合

部品の入力プロパティの値

○　

×　

×　

部品の出力プロパティの値

×　

○　

○　

部品の戻り値

×　

○　

○　

（凡例）

○：変更できます。　×：変更できません。

5.3.12　デバッグ時に部品の処理をスキップする手順

デバッグ時に，処理を実行したくない部品がある場合，その部品の処理をスキップします。スキップする場合は，その部品の処理を実行したと仮定したときの，出力プロパティの値や部品の戻り値を指定します。これによって，後続ステップ実行条件による，ステップおよびタスクの状態遷移，フローの遷移，および後続ステップの処理を確認できます。

処理をスキップできない部品については，「5.3.10　デバッグ時にステップ実行を中断できない部品」を参照してください。

なお，部品の処理をスキップできるのは，デバッグ実行時の中断設定で［1ステップずつ中断する］を選択している場合だけです。

部品の処理をスキップするには：

実行したくない部品を含むステップの中断中に，［デバッグ］ビューの［実行設定］リストボックスから［部品の処理を実行しない］を選択します。

［戻り値］テキストボックスに任意の値を指定します。

ここで指定した戻り値によって，後続ステップ実行条件による，ステップおよびタスクの状態遷移やフローの遷移が決まります。

必要に応じて，出力プロパティに任意の値を指定します。

ポイント

出力プロパティマッピングを設定している場合は，指定した部品の出力プロパティの値が，マッピングを設定しているサービスプロパティ（出力プロパティまたは変数）に反映されます。値を指定しない場合は，マッピングを設定しているサービスプロパティ（出力プロパティまたは変数）の値が空になります。

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

関連トピック

5.3.4　デバッグを開始する手順

5.3.9　ステップごとに中断してデバッグする場合の処理の流れ

5.3.18　デバッグ時に部品の出力プロパティの値を変更する手順

5.3.19　デバッグ時に部品の戻り値を変更する手順

3.2.4　後続ステップ実行条件について

5.3.13　デバッグ時に失敗したステップからリトライする手順

デバッグタスクが途中で失敗した場合，失敗したステップからリトライします。

失敗したステップからリトライした場合，プロパティの値を引き継いだ状態で，同一のタスクIDでデバッグタスクを再開できます。例えば，一時的にネットワーク接続が切断されてステップの実行に失敗したあと，接続が復旧した場合など，失敗した原因が解決できたときに使用します。

プロパティ値を引き継ぐ際の例外や，デバッグタスクの状態によるリトライの可否など，リトライの詳細については，マニュアル「JP1/AO 運用ガイド」−「タスクのリトライについて」のトピックを参照してください。

デバッグ時に失敗したステップからリトライするには：

デバッグタスクの状態が「失敗」のときに，［デバッグ］ビューの［リトライ］リストボックスから［失敗したステップからリトライ］を選択します。

失敗したステップからリトライするかどうかを確認するダイアログボックスが表示されます。

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

関連トピック

5.3.14　デバッグ時に失敗した次のステップからリトライする手順

マニュアル「JP1/AO 運用ガイド」−「タスクのリトライについて」のトピック

5.3.14　デバッグ時に失敗した次のステップからリトライする手順

デバッグタスクが途中で失敗した場合，失敗した次のステップからリトライします。

失敗した次のステップからリトライした場合，プロパティの値を引き継いだ状態で，同一のタスクIDでデバッグタスクを再開できます。失敗したステップを実行する必要がないときに使用します。失敗した次のステップからリトライすると，失敗したステップは正常終了したものとして処理されます。例えば，前のステップで摘出された問題点をいったん保留にして，デバッグタスクの実行を継続したい場合に使用します。

プロパティ値を引き継ぐ際の例外や，デバッグタスクの状態によるリトライの可否など，リトライの詳細については，マニュアル「JP1/AO 運用ガイド」−「タスクのリトライについて」のトピックを参照してください。

デバッグ時に失敗した次のステップからリトライするには：

デバッグタスクの状態が「失敗」のときに，［デバッグ］ビューの［リトライ］リストボックスから［失敗した次のステップからリトライ］を選択します。

失敗した次のステップからリトライするかどうかを確認するダイアログボックスが表示されます。

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

関連トピック

5.3.13　デバッグ時に失敗したステップからリトライする手順

マニュアル「JP1/AO 運用ガイド」−「タスクのリトライについて」のトピック

5.3.15　応答待ち中のデバッグタスクの対処を入力する手順（応答入力）

デバッグタスクの実行中に応答入力が必要な場合，［デバッグ］ビューから応答を入力します。

応答待ち中のデバッグタスクの対処を入力するには：

デバッグタスクの状態が「応答待ち中」のときに，［デバッグ］ビューの［応答入力］ボタンをクリックします。

［応答入力］ダイアログボックスでメッセージを確認し，実施したい操作のボタンをクリックします。

［情報］ダイアログボックスで，［OK］ボタンをクリックします。

入力した応答内容に従って，応答待ち中のステップの部品処理が続行，または停止されます。

5.3.16　デバッグ時にプロパティマッピングの設定を確認する手順

デバッグ時に，サービスプロパティの値と部品プロパティの値が設計したとおりにマッピングされているかを確認します。

［デバッグ］ビューおよびサービステンプレートデバッグビューの［プロパティ一覧］タブを参照して，マッピング設定している部品プロパティとサービスプロパティに，同じ値が指定されているかを確認できます。

デバッグ実行中に，マッピングの設定を確認する場合は，次のタイミングでプロパティの値を確認してください。

部品の入力プロパティと，サービスの入力プロパティまたは変数のマッピング設定を確認する場合

部品の処理を実行する前に，ステップが中断しているとき

部品の出力プロパティと，サービスの出力プロパティまたは変数のマッピング設定を確認する場合

部品の処理をスキップする場合に，部品の出力プロパティおよび戻り値を指定したあと，ステップを再開したとき

部品の処理の実行後に中断していたステップを再開したとき

図5‒6　プロパティマッピングの設定を確認する画面

部品のプロパティマッピングの設定を確認するには：

［フロー］ビューで，部品プロパティの値を確認したいステップを選択します。

［デバッグ］ビューに，選択したステップの入力プロパティおよび出力プロパティが表示されます。

サービステンプレートデバッグビュー下部の，［プロパティ一覧］タブをクリックします。

サービスプロパティの値が表示されます。

［デバッグ］ビューで，マッピング設定を確認したい部品プロパティのマッピングパラメータ列を参照し，マッピングされているサービスプロパティを確認します。

手順3で確認したサービスプロパティを，［プロパティ一覧］タブのプロパティキー列から探します。

［デバッグ］ビューおよび［プロパティ一覧］ビューを相互に参照します。部品プロパティのプロパティ値列と，マッピングされているサービスプロパティのプロパティ値列に，同じ値が表示されているかを確認します。

設計とは異なるサービスプロパティがマッピングされている場合や，表示されている値に問題がある場合，サービステンプレート編集ビューで修正します。

プロパティマッピングが正しく設定された場合の部品の処理や，設計とは異なる値を指定したときの後続ステップの処理やフローの遷移を確認したい場合は，部品プロパティの値を変更します。

ポイント

［デバッグ］ビューおよび［プロパティ一覧］タブでは，プロパティの種類が，次のようなアイコンで表示されます。

[図データ]アイコン

入力プロパティを示します。

[図データ]アイコン

出力プロパティを示します。

[図データ]アイコン

変数を示します。

注意事項

繰り返し実行部品のプロパティ「foreachMode」で「parallel」を指定している場合，並行して実行されている繰り返し実行フローの中で更新されたサービスプロパティの値は，［プロパティ一覧］タブに反映されません。

関連トピック

5.3.9　ステップごとに中断してデバッグする場合の処理の流れ

5.3.17　デバッグ時に部品の入力プロパティの値を変更する手順

5.3.18　デバッグ時に部品の出力プロパティの値を変更する手順

5.3.17　デバッグ時に部品の入力プロパティの値を変更する手順

デバッグ時に，部品の入力プロパティの値を変更します。部品の実行前に入力プロパティを任意の値に変更して，異なるプロパティの値が入力されたときの，部品の処理を確認できます。

なお，入力プロパティの値を変更できるのは，デバッグの設定で［1ステップずつ中断する］を選択している場合だけです。

デバッグ時に入力プロパティの値を変更するには：

［フロー］ビューで，状態が中断中になっているステップを選択します。

［デバッグ］ビューの［実行設定］リストボックスで，［部品の処理を実行する］を選択します。

［デバッグ］ビューで，入力プロパティに任意の値を指定します。

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

関連トピック

5.3.4　デバッグを開始する手順

5.3.8　ステップごとに中断してデバッグする流れ

5.3.9　ステップごとに中断してデバッグする場合の処理の流れ

5.3.16　デバッグ時にプロパティマッピングの設定を確認する手順

5.3.21　デバッグ時に部品プロパティの値を変更した場合の影響

5.3.22　部品プロパティの値にサロゲートペア文字および制御文字が含まれていた場合について

5.3.23　部品プロパティの値の改行コードについて（ステップ実行の中断時）

5.3.18　デバッグ時に部品の出力プロパティの値を変更する手順

デバッグ時に，部品の出力プロパティの値を変更します。部品の処理を実行またはスキップしたあと，出力プロパティを任意の値に変更して，異なるプロパティの値が出力されたときの，後続ステップの処理やフローの遷移を確認できます。

なお，出力プロパティの値を変更できるのは，デバッグの設定で［1ステップずつ中断する］を選択している場合だけです。

出力プロパティの値を変更する方法は，部品の処理を実行する場合とスキップする場合で異なります。

デバッグ時に出力プロパティの値を変更するには（部品の処理を実行する場合）：

［フロー］ビューで，状態が中断中になっているステップを選択します。

［デバッグ］ビューの［実行設定］リストボックスで，［部品の処理を実行する］を選択します。

［部品の処理後に中断する］チェックボックスをチェックします。

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

部品の処理が実行されたあと，ステップが中断されます。

［デバッグ］ビューで，出力プロパティに任意の値を指定します。

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

デバッグ時に出力プロパティの値を変更するには（部品の処理をスキップする場合）：

［フロー］ビューで，状態が中断中になっているステップを選択します。

［デバッグ］ビューの［実行設定］リストボックスで，［部品の処理を実行しない］を選択します。

［デバッグ］ビューで，出力プロパティに任意の値を指定します。

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

関連トピック

5.3.4　デバッグを開始する手順

5.3.8　ステップごとに中断してデバッグする流れ

5.3.9　ステップごとに中断してデバッグする場合の処理の流れ

5.3.12　デバッグ時に部品の処理をスキップする手順

5.3.16　デバッグ時にプロパティマッピングの設定を確認する手順

5.3.21　デバッグ時に部品プロパティの値を変更した場合の影響

5.3.22　部品プロパティの値にサロゲートペア文字および制御文字が含まれていた場合について

5.3.23　部品プロパティの値の改行コードについて（ステップ実行の中断時）

5.3.19　デバッグ時に部品の戻り値を変更する手順

デバッグ時に，部品の戻り値を変更します。部品の処理を実行またはスキップしたあと，戻り値を任意の値に変更して，異なる戻り値が出力されたときの，後続ステップ実行条件による，ステップおよびタスクの状態遷移，フローの遷移，および後続ステップの処理を確認できます。

なお，戻り値を変更できるのは，デバッグの設定で［1ステップずつ中断する］を選択している場合だけです。

戻り値を変更する方法は，部品の処理を実行する場合とスキップする場合で異なります。

デバッグ時に部品の戻り値を変更するには（部品の処理を実行する場合）：

［フロー］ビューで，状態が中断中になっているステップを選択します。

［デバッグ］ビューの［実行設定］リストボックスで，［部品の処理を実行する］を選択します。

［部品の処理後に中断する］チェックボックスをチェックします。

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

部品の処理が実行されたあと，ステップが中断されます。

［デバッグ］ビューの［戻り値］テキストボックスで，任意の戻り値を指定します。

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

デバッグ時に部品の戻り値を変更するには（部品の処理をスキップする場合）：

［フロー］ビューで，状態が中断中になっているステップを選択します。

［デバッグ］ビューの［実行設定］リストボックスで，［部品の処理を実行しない］を選択します。

［デバッグ］ビューの［戻り値］テキストボックスで，任意の戻り値を指定します。

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

関連トピック

5.3.4　デバッグを開始する手順

5.3.8　ステップごとに中断してデバッグする流れ

5.3.9　ステップごとに中断してデバッグする場合の処理の流れ

5.3.12　デバッグ時に部品の処理をスキップする手順

3.2.4　後続ステップ実行条件について

5.3.20　デバッグ時の部品プロパティの値の表示について

デバッグ時に，部品の入力プロパティおよび出力プロパティの値が表示される条件と表示される個所について説明します。

表5‒5　部品プロパティの値が表示される条件と表示される個所

部品プロパティの種別

表示される部品

表示されるタイミング

表示される個所

入力プロパティ

中断できる部品および値判定分岐部品

部品の実行が開始されたタイミング

［デバッグ］ビューのプロパティ値の列

出力プロパティ

中断できる部品※

部品の処理が終了したタイミング

［デバッグ］ビューのプロパティ値の列

注※

部品の処理を実行する際に，部品の戻り値が65以上となった場合（部品の入力プロパティの値に誤りがあったときや，操作対象の機器のOSに接続できなかったときなど）は，部品の処理の実行後に中断する設定をしていても，中断されないで，デバッグタスクの処理が進みます。

ポイント

中断できない部品（値判定分岐部品を除く）の場合，入力プロパティの値は，ステップの編集時，入力プロパティマッピングに直接指定した値です。そのため，部品の入力プロパティの値は，［デバッグ］ビューで，入力プロパティのマッピングパラメータの列に表示されます。

関連トピック

5.3.10　デバッグ時にステップ実行を中断できない部品

5.3.21　デバッグ時に部品プロパティの値を変更した場合の影響

デバッグでステップの情報を変更する場合，変更できるのは部品のプロパティの値および戻り値です。部品プロパティの値を変更した場合でも，プロパティマッピングされているサービスプロパティの値が連動して変更されることはありません。ただし，部品の出力プロパティを変更することで，出力プロパティマッピングに従い，間接的にサービスプロパティ（出力プロパティまたは変数）の値が変更されることがあります。

例として，次のとおりサービステンプレートが定義されている場合に，ステップ実行で部品の入力プロパティおよび出力プロパティの値を変更したときの動作を示します。

図5‒7　サービステンプレートの構成例

プロパティマッピング定義

ステップ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」にも変更後の値が入ります。

5.3.22　部品プロパティの値にサロゲートペア文字および制御文字が含まれていた場合について

デバッグ時にステップが中断したタイミングで，部品プロパティの値に，サロゲートペア文字，および制御文字（改行およびタブを除く）が含まれていた場合，これらの文字は表示されません。また，ステップの再開時には，サロゲートペア文字，および制御文字（改行およびタブを除く）が削除された値が，部品プロパティの値として反映されます。

なお，デバッグタスクの中断設定が「中断しない」の場合も，プロパティの値のサロゲートペア文字，および制御文字（改行およびタブを除く）は表示されません。ただし，部品プロパティの値としては維持されます。

5.3.23　部品プロパティの値の改行コードについて（ステップ実行の中断時）

デバッグ実行時に，ステップが中断したタイミングで，部品プロパティの値に使用する改行コードを，ステップ単位に指定できます。部品の接続先の機器のOSに合わせて，運用時と同じ改行コードを指定できます。

サービス，部品のプロパティは，CR+LFを2文字として扱います。そのため，改行コードによって部品の出力結果の文字数が変化し，制限値（1,024文字）を超えた場合，プロパティの値として反映される値が変化することがあります。このとき，運用時と同じ改行コードを指定すると，プロパティの値が変化することを防げます。

改行コードは，［デバッグ］ビューで，「CR」，「LF」，および「CRLF」から選択できます。ステップ実行を再開すると，ステップ内のすべての部品プロパティの改行コードが，選択した改行コードに変更されます。デフォルトでは，現在のプロパティの値に含まれている改行コードが指定されます。複数の改行コードが混在する場合は，部品のプロパティの定義順で，最初の改行コードが指定されます。部品プロパティの値に改行コードが含まれない場合は，「CRLF」が指定されます。

なお，部品プロパティの値に改行コードが含まれない場合は，改行コードの指定は不要です。

5.3.24　デバッグタスクのフロー表示について

実行中のデバッグタスクを，フロー形式で表示できます。

サービステンプレートデバッグビューの［フロー］ビューに，ステップの実行順序が表示されます。ステップアイコンには，ステップの状態アイコンが表示されます。

また，ステップアイコンにマウスカーソルを重ねると，ステップ名，状態アイコン，およびステップの状態が表示されます。

ポイント

ステップの状態については，マニュアル「JP1/AO 運用ガイド」−「ステップの状態一覧」のトピックを参照してください。

図5‒8　デバッグタスクのフロー表示

［フロー］ビューでは，中断中のステップアイコンの枠が，次のように強調表示されます。

図5‒9　中断中のステップのアイコン（表示例）

［フロー］ビューでは，中断できない部品のステップアイコンの背景が，次のように暗く表示されます。また，繰り返し実行部品の配下のフローにあるステップアイコンも，繰り返し実行部品が実行されるまで，背景が暗く表示されます。

図5‒10　中断できない部品のステップおよび繰り返し実行部品（実行前）の配下のフローにあるステップのアイコン（表示例）

関連トピック

5.3.26　デバッグ時の繰り返し実行フローのフロー表示について

5.3.28　デバッグ時の繰り返し実行部品および繰り返し実行フローの表示情報について

マニュアル「JP1/AO 画面・コマンド・APIリファレンス」−「ステップの状態を示すアイコン」のトピック

5.3.25　デバッグタスクのフローツリー表示について

フローツリーの最上位には，サービステンプレート名が表示されます。その配下の階層は，階層フロー部品または繰り返し実行部品を使用したステップの名称で表示されます。

デバッグ実行中に，中断しているステップ（ユーザーの操作が必要な状態のステップ）がある階層には，中断アイコンが表示されます。

図5‒11　中断アイコンの表示例（階層フロー部品2に含まれるステップが中断している場合）

デバッグ実行中に，中断しているステップを探す場合は，フローツリーから中断アイコンが付いている階層を探してください。中断アイコンが付いている階層を選択し，表示されたフローの中から，中断しているステップを特定します。

なお，中断しているステップを含む階層よりも上位の階層のアイコンには，中断アイコンが表示されません。また，階層フロー部品や繰り返し実行部品自身を示すステップの状態および繰り返し実行フローの状態については，フローツリーに表示されません。

関連トピック

5.3.27　デバッグ時の繰り返し実行フローのフローツリー表示について

5.3.28　デバッグ時の繰り返し実行部品および繰り返し実行フローの表示情報について

5.3.26　デバッグ時の繰り返し実行フローのフロー表示について

デバッグ実行時，繰り返し実行部品を実行するステップでは，繰り返し実行部品の配下の階層に，繰り返し回次ごとのフローが表示されます。これを「繰り返し実行フロー」と呼びます。繰り返し実行フローは，繰り返し実行部品の実行開始以降（実行中および実行後も含む）のタイミングで表示されます。

繰り返し実行部品の実行時に，繰り返し実行部品の繰り返し入力プロパティ（inputProperties）の値が「hostA,hostB,hostC」である場合の例を次に示します。

図5‒12　繰り返し実行フローのフロー表示

繰り返し実行フローを示す名称が，「繰り返しの回次番号_繰り返し実行入力値（reserved.loop.input）」の形式でアイコンに表示されます。ただし，繰り返し実行フローを示す名称が64文字を超える場合，65文字目以降が切り捨てられます。繰り返し実行入力値に制御文字が含まれる場合は，制御文字が削除されたあと，65文字目以降が切り捨てられます。なお，繰り返しの回次番号は2桁で表示されます。この図の例では，「01_hostA」，「02_hostB」，および「03_hostC」として表示されます。

関連トピック

5.3.26　デバッグ時の繰り返し実行フローのフロー表示について

5.3.28　デバッグ時の繰り返し実行部品および繰り返し実行フローの表示情報について

5.3.27　デバッグ時の繰り返し実行フローのフローツリー表示について

実行しているデバッグタスクのフローツリーは，サービステンプレートデバッグビューの［フローツリー］ビューに表示されます。繰り返し実行フローは，繰り返し実行部品の実行開始以降（実行中および実行後も含む）のタイミングで，フローツリーに表示されます。繰り返し実行フローは，「繰り返しの回次番号_繰り返し実行入力値（reserved.loop.input）」の形式で表示されます。ただし，繰り返し実行フローの表示名が64文字を超える場合，65文字目以降が切り捨てられます。繰り返し実行入力値に制御文字が含まれる場合は，制御文字が削除されたあと，65文字目以降が切り捨てられます。なお，繰り返しの回次番号は2桁で表示されます。

繰り返し実行部品の実行時に，繰り返し実行部品の繰り返し入力プロパティ（inputProperties）の値が「hostA,hostB,hostC」である場合の表示例を次に示します。

図5‒13　繰り返し実行フローのフローツリー表示

なお，繰り返し実行方式の「parallel」または「serial」に関係なく，すべての回次分の繰り返し実行フローが一度に表示されます。

ただし，デバッグ中にログアウトした場合などは，それ以降，「繰り返し実行待ち」の状態である繰り返し実行フローについて，回次についての情報が表示されなくなることがあります。

関連トピック

5.3.25　デバッグタスクのフローツリー表示について

5.3.28　デバッグ時の繰り返し実行部品および繰り返し実行フローの表示情報について

5.3.28　デバッグ時の繰り返し実行部品および繰り返し実行フローの表示情報について

デバッグ時に，繰り返し実行部品を含むステップの実行が開始されると，繰り返し実行部品および繰り返し実行フローの，次の情報が表示されます。なお，該当するステップの実行が開始されるまでは表示されません。

表5‒6　繰り返し実行フローの表示情報

項目

説明

繰り返し実行方式（parallel/serial）

繰り返し実行部品のプロパティ「foreachMode」の値として表示されます。

繰り返し実行の回次（reserved.loop.index）

繰り返し実行フローの名称として，繰り返し実行入力値とともに表示されます。

繰り返し実行部品のプロパティ「inputProperties」で指定されたコンマ区切りのデータのうち，何番目のパラメータに対応する実行かを示します。

繰り返し実行入力値（reserved.loop.input）

繰り返し実行フローの名称として，繰り返し実行の回次とともに表示されます。※

繰り返し実行部品のプロパティ「inputProperties」で指定された値が，コンマで区切られて，繰り返し実行フローの回次別に展開された値を示します。

繰り返し実行結果（成功/失敗）

繰り返し実行部品のプロパティ「outputResult」の値として表示されます。

繰り返し実行出力値（reserved.loop.output）

繰り返し実行部品の出力プロパティ「outputProperties」として表示されます。

値は繰り返し実行フローの中の出力プロパティマッピングによって「reserved.loop.output」に指定されたものです。

注※

繰り返し実行フローの表示名が64文字を超える場合，65文字目以降が切り捨てられます。繰り返し実行入力値に制御文字が含まれる場合は，制御文字が削除されたあと，65文字目以降が切り捨てられます。

関連トピック

5.3.22　部品プロパティの値にサロゲートペア文字および制御文字が含まれていた場合について

5.4　デバッグタスクを管理する

5.4.1　すべてのデバッグタスクの状態を確認する手順

［タスク］画面から，すべてのデバッグタスクの状態を一覧で確認します。例えば，複数のデバッグタスクの状態を確認する場合や，ほかのユーザーが実行したデバッグタスクの状態を確認する場合などに使用します。

すべてのデバッグタスクの状態を確認するには：

［タスク］画面の左ペインで，［デバッグ実行したタスク］メニューを選択します。

［タスク］画面の右ペイン（［デバッグタスク一覧］ビュー）で，デバッグタスクの状態を確認します。

ポイント

［デバッグタスク一覧］ビューに表示されている［タスク名］をクリックすることで，デバッグタスクの詳細が確認できます。

注意事項

デバッグタスクの最大保持期間が経過するか，通常のタスクとの合計数が最大保持数を超えた場合，1日1回，タスクの自動アーカイブと同じタイミングで，終了日時の古いデバッグタスクまたはタスクから順に自動削除（タスクの場合は自動アーカイブ）されます。デバッグタスクの保持期間，タスクとの合計の最大保持数，および自動削除のタイミングは，プロパティファイル（config_user.properties）で変更できます。タスクの自動アーカイブについては，マニュアル「JP1/AO 運用ガイド」−「タスクの自動アーカイブ，履歴の自動削除について」のトピックを参照してください。

関連トピック

マニュアル「JP1/AO 構築ガイド」−「プロパティファイル（config_user.properties）」のトピック

5.4.2　［タスク］画面からデバッグタスクの進捗状況を確認する手順

［タスク］画面から，デバッグタスクの進捗をフロー形式で確認します。例えば，［デバッグ］ビューおよびサービステンプレートデバッグビューを閉じたあとでデバッグタスクのステップの状態を確認する場合や，ほかのユーザーが実行したデバッグタスクのステップの状態を確認する場合などに，［タスク］画面から確認します。

［タスク］画面からデバッグタスクのステップの状態を確認するには：

［タスク］画面の左ペインで，［デバッグ実行したタスク］メニューを選択します。

［タスク］画面の右ペイン（［デバッグタスク一覧］ビュー）で，状態を確認するタスクを選択します。

［タスクモニタ］ビューで，タスクの進捗状況を確認します。進捗状況はステップアイコンの上に状態を示すアイコンで表示されます。

関連トピック

5.3.25　デバッグタスクのフローツリー表示について

5.3.26　デバッグ時の繰り返し実行フローのフロー表示について

マニュアル「JP1/AO 運用ガイド」−「タスクの進捗状況をフロー形式で確認する手順」のトピック

マニュアル「JP1/AO 運用ガイド」−「ステップの状態一覧」のトピック

マニュアル「JP1/AO 画面・コマンド・APIリファレンス 」−「ステップの状態を示すアイコン」のトピック

5.4.3　デバッグタスクの進捗状況の詳細を一覧形式で確認する手順

デバッグタスクの進捗状況の詳細を確認します。デバッグタスクについて，全体の進捗状況と，ステップごとの処理状況を確認できます。なお，表示できるのは，最上位のフローに定義されているステップの一覧です。最上位のフローにないステップおよび，階層フロー部品および繰り返し実行部品内のステップは表示されません。

デバッグタスクの進捗状況の詳細を一覧形式で確認するには：

［タスク］画面の左ペインで，［デバッグ実行したタスク］メニューを選択します。

［タスク］画面の右ペイン（［タスク一覧］ビュー）で，進捗状況の詳細を確認したいデバッグタスクの［タスク名］をクリックします。

ポイント

進捗状況を確認したいデバッグタスクの行を選択し，［タスク詳細表示］ボタンをクリックしても同じ操作ができます。

［タスク詳細］ダイアログボックスの下部にある［ステップ詳細］をクリックします。

［ステップ情報］で，デバッグタスクの全体の進捗状況を確認します。

［ステップ一覧］で，ステップごとの進捗状況を確認します。

5.4.4　デバッグタスクのタスクログを確認する手順

デバッグタスクのタスクログを確認します。デバッグタスクの状態が待機中の場合，タスクログは表示されません。なお，タスクログは任意のフォルダに，任意のファイル名でダウンロードできます。

実行中のデバッグタスクのタスクログを確認する場合は，［エディタ］画面から確認します。

終了したデバッグタスクのタスクログを確認する場合や，デバッグタスクを実行したユーザー以外のユーザーが確認する場合は，［タスク］画面から確認します。

タスクログの出力内容については，マニュアル「JP1/AO 運用ガイド」−「タスクログの詳細」のトピックを参照してください。

［エディタ］画面からデバッグタスクのタスクログを確認するには：

サービステンプレートデバッグビューで，［タスクログ］タブをクリックします。

［タスクログ］タブに，デバッグ中のデバッグタスクのタスクログが表示されます。

［タスクログ］タブでは，タスクログの表示内容を更新するタイミングを設定したり，タスクログをダウンロードしたりできます。操作方法を次に説明します。

タスクログを定期的に自動更新する

［自動更新する］チェックボックスにチェックします。

チェックすると，デバッグタスクの実行中に，ステップの状態，またはタスクの状態が変更されたタイミングで，タスクログが自動更新されます。

タスクログを手動で更新する

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

タスクログをダウンロードする

［ダウンロード］ボタンをクリックします。

ポイント

デバッグタスクを再度デバッグ実行した場合，またはリトライした場合は，［自動更新する］チェックボックスが自動的にチェックされ，タスクログが更新されます。

［自動更新する］チェックボックスをチェックしている場合，タスクの状態に関わらず，タスクログは再取得され，［タスクログ］タブのスクロールバーは最下部へ移動します。

［タスク］画面からデバッグタスクのタスクログを確認するには：

［タスク］画面の左ペインで，［デバッグ実行したタスク］メニューを選択します。

［タスク］画面の右ペイン（［デバッグタスク一覧］ビュー）から，タスクログを確認します。

［タスク］画面からタスクログを確認する手順の詳細については，マニュアル「JP1/AO 運用ガイド」−「タスクログを表示する手順」のトピックを参照してください。

注意事項

［タスクログ］ダイアログボックス，およびサービステンプレートデバッグビューの［タスクログ］タブには，プロパティファイル（config_user.properties）で指定したタスクログのサイズ（単位：KB）が，タスクログの末尾から算出して表示されます。タスクログのすべての内容は表示されません。

タスクログのサイズは，プロパティファイル（config_user.properties）のデバッグタスク用ログファイルサイズの最大値（単位：KB）で設定できます。デバッグタスク用ログファイルサイズの最大値を超えた場合，タスクログの古い情報から上書きされます。

関連トピック

マニュアル「JP1/AO 構築ガイド」−「プロパティファイル（config_user.properties）」のトピック

5.4.5　デバッグタスクを実行停止する手順

実行中のデバッグタスクを実行停止します。タスクの状態が，実行中，応答待ち中，または異常検出の場合にデバッグタスクを実行停止できます。実行停止すると，デバッグタスクの状態が失敗となります。ただし，デバッグタスクの最後のステップを実行中にユーザーが実行停止をした場合，最後のステップが正常終了すると，デバッグタスクの状態も正常終了となります。

中断中のステップがある場合，自動的に再開され，ステップの実行が終了したあと，デバッグタスクが停止します。

ポイント

実行停止と強制停止の違いについては，マニュアル「JP1/AO 運用ガイド」−「タスクの管理」のトピックを参照してください。

デバッグタスクを実行停止するには：

［タスク］画面の左ペインで，［デバッグ実行したタスク］メニューを選択します。

［タスク］画面の右ペイン（［デバッグタスク一覧］ビュー）で，実行を停止したいデバッグタスクを選択します。

［Ctrl］キーを押しながら選択すると，複数のデバッグタスクを選択できます。［すべて選択］ボタンをクリックすると，すべてのデバッグタスクを選択できます。

注意事項

［タスク名］をクリックすると［タスク詳細］ダイアログボックスが開くため，［タスク名］以外の余白部分を選択してください。

［その他の操作］メニューで，［実行停止］をクリックします。

［実行停止］ダイアログボックスで実行停止するデバッグタスクを確認し，［OK］ボタンをクリックします。

［情報］ダイアログボックスで，［OK］ボタンをクリックします。

選択したデバッグタスクの状態が失敗となります。

5.4.6　デバッグタスクを強制停止する手順

実行中のデバッグタスクを強制停止します。デバッグタスクの状態が，実行中，応答待ち中，異常検出，または停止中の場合にデバッグタスクを強制停止できます。

実行中のデバッグタスクを停止して，デバッグを再度実行したい場合は，［エディタ］画面から強制停止します。

デバッグタスクの実行中にJP1/AOのWebブラウザーを閉じてしまった場合や，ほかのユーザーが実行したデバッグタスクを強制停止したい場合は［タスク］画面から強制停止します。

実行を強制停止すると，デバッグタスクの状態が失敗となります。

中断中のステップがある場合，自動的に再開されたあと，部品の処理は実行しないで，デバッグタスクが停止します。

ポイント

実行停止と強制停止の違いについては，マニュアル「JP1/AO 運用ガイド」−「タスクの管理」のトピックを参照してください。

［エディタ］画面からデバッグタスクを強制停止するには：

［エディタ］画面の［デバッグ］ビューで，［強制停止］ボタンをクリックします。

［強制停止］ダイアログボックスで強制停止するデバッグタスクを確認し，［OK］ボタンをクリックします。

［情報］ダイアログボックスで，［OK］ボタンをクリックします。

デバッグタスクの状態が失敗となります。

［タスク］画面からデバッグタスクを強制停止するには：

［タスク］画面の左ペインで，［デバッグ実行したタスク］メニューを選択します。

［タスク］画面の右ペイン（［デバッグタスク一覧］ビュー）で，実行を強制停止したいデバッグタスクを選択します。

［Ctrl］キーを押しながら選択すると，複数のデバッグタスクを選択できます。［すべて選択］ボタンをクリックすると，すべてのデバッグタスクを選択できます。

注意事項

［タスク名］をクリックすると［タスク詳細］ダイアログボックスが開くため，［タスク名］以外の余白部分を選択してください。

［その他の操作］メニューで，［強制停止］をクリックします。

［強制停止］ダイアログボックスで強制停止するデバッグタスクを確認し，［OK］ボタンをクリックします。

［情報］ダイアログボックスで，［OK］ボタンをクリックします。

選択したデバッグタスクの状態が失敗となります。

5.4.7　デバッグタスクを削除する手順

必要がなくなったデバッグタスクを手動で削除します。タスクの状態が，正常終了，または失敗の場合にデバッグタスクを削除できます。

なお，デバッグタスクを自動で削除したい場合は，プロパティファイル（config_user.properties）で，実行が終了したデバッグタスクを保持する期間を設定してください。

デバッグタスクを手動で削除するには：

［タスク］画面の左ペインで，［デバッグ実行したタスク］メニューを選択します。

［タスク］画面の右ペイン（［デバッグタスク一覧］ビュー）で，削除したいデバッグタスクを選択します。

［Ctrl］キーを押しながら選択すると，複数のデバッグタスクを選択できます。［すべて選択］ボタンをクリックすると，すべてのデバッグタスクを選択できます。

注意事項

［タスク名］をクリックすると［タスク詳細］ダイアログボックスが開くため，［タスク名］以外の余白部分を選択してください。

［その他の操作］メニューで，［タスク削除］をクリックします。

［タスク削除］ダイアログボックスで削除するデバッグタスクを確認し，［OK］ボタンをクリックします。

［情報］ダイアログボックスで，［OK］ボタンをクリックします。

［デバッグタスク一覧］ビューから，デバッグタスクが削除されます。

関連トピック

マニュアル「JP1/AO 構築ガイド」−「プロパティファイル（config_user.properties）」のトピック

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

5.5.1　サービステンプレートの運用をテストする手順

サービステンプレートをデバッグし，問題がないことを確認したら，開発環境で運用テストをします。

サービステンプレートの運用をテストするには：

サービステンプレートをビルドしたあと，サービスとして追加します。

サービスを実行します。

［タスク］画面から，実行結果を確認します。

運用テストの結果，サービステンプレートに問題点を発見した場合は，サービステンプレートまたは部品を編集します。

関連トピック

マニュアル「JP1/AO 運用ガイド」−「サービスを追加する手順」のトピック

マニュアル「JP1/AO 運用ガイド」−「サービスの実行」のトピック

マニュアル「JP1/AO 運用ガイド」−「タスクの管理」のトピック

5.1.1　サービステンプレートを検証する流れ

5.1.2　ビルドとは

5.1.4　運用テストとは

5.2.1　サービステンプレートをビルドする手順

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

サービステンプレートのリリースについて説明します。編集が完了したサービステンプレートをリリースすることで，サービステンプレートのパッケージが作成され，JP1/AOサーバにインポートされます。

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

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

サービステンプレートを選択し，リリースすることで，サービステンプレートのパッケージが作成され，JP1/AOサーバにインポートされます。サービステンプレートの開発環境と本番環境が同じ場合は，サービスを追加できる状態になります。

注意事項

サービステンプレートを一度リリースすると，再編集できなくなります。リリースしたサービステンプレートは，複製することで編集できるようになります。

サービステンプレートエディタ編集ビューを表示していない場合の手順：

［サービステンプレートエディタホーム］ビューの［作業の開始］で，［編集］をクリックします。

［サービステンプレート一覧］画面でサービステンプレートを選択し，［編集］ボタンをクリックします。

サービステンプレートをリリースするには：

サービステンプレートエディタ編集ビューで，［リリース］ボタンをクリックします。

サービステンプレートデバッグビューの［リリース］ボタンでも同様にリリースできます。

確認画面で［OK］ボタンをクリックします。

［ビルド/リリース結果］ダイアログボックスで結果を確認し，［閉じる］ボタンをクリックします。

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

対象のサービステンプレートがほかのユーザーによって，すでにリリースされていた場合や削除されていた場合はエラーとなり，リリースに失敗します。

リリース時にエラーが発生した場合は，エラー原因とフローの修正を促すメッセージが通知されます。このとき発生したエラーはサービステンプレートエディタ編集ビューを閉じるまで表示されます。

注意事項

サービステンプレートデバッグビューからリリースする場合，サービステンプレートは，デバッグを実行したユーザーが最後にビルドしたときの内容でリリースされます。そのため，デバッグを実行したユーザーが最後にビルドしたあとで，ほかのユーザーが同一のサービステンプレートを編集し，ビルドしていても，その編集内容は反映されません。

関連トピック

6.2.1　リリースの概要

付録A.1(5)　ビルドまたはリリースする場合のサービステンプレート，サービス，タスクの削除・アーカイブ範囲

6.2　リリースの概要

6.2.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

関連トピック

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

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

付録A.1(1)　ビルドおよびリリースの仕組みと違い

付録A.1(2)　ビルドおよびリリースによって設定されるサービステンプレートおよび部品の構成種別

付録A.1(5)　ビルドまたはリリースする場合のサービステンプレート，サービス，タスクの削除・アーカイブ範囲

6.3　サービステンプレートを本番環境にインポートする（開発環境と本番環境が別の場合）

6.3.1　サービステンプレートを本番環境にインポートする手順（開発環境と本番環境が別の場合）

サービステンプレートの開発環境と本番環境が別である場合は，開発環境で作成したサービステンプレートを本番環境にインポートする必要があります。

開発環境と本番環境が別である場合は，事前に開発環境でサービステンプレートの動作を確認することをお勧めします。開発環境での動作確認が完了したら，本番環境にサービステンプレートをインポートします。サービステンプレートを開発環境から本番環境へインポートする手順を次に示します。

サービステンプレートを開発環境から本番環境へインポートするには：

開発環境のJP1/AOサーバから，本番環境のJP1/AOサーバのローカルディスク上にサービステンプレートをコピーします。

本番環境のJP1/AOサーバで，importservicetemplateコマンドを実行して，サービステンプレートパッケージをインポートします。

本番環境のJP1/AOサーバで，サービスを作成します。

ポイント

複数のサービステンプレートパッケージをzipファイルに圧縮し，importservicetemplateコマンドでインポートすることで，一度に複数のサービステンプレートパッケージをインポートできます。

関連トピック

6.3.2　サービステンプレートの開発環境と本番環境を別にすることを推奨する理由

6.3.2　サービステンプレートの開発環境と本番環境を別にすることを推奨する理由

本番環境とは別に，サービステンプレートを開発する環境を構築すると，本番用と開発用で，サービス共有プロパティを使い分けられます。

サービステンプレートの開発環境と本番環境が同じである場合

サービス共有プロパティの値は，JP1/AOシステム内で1つです。サービステンプレートエディタでサービス共有プロパティを変更した場合，開発サービステンプレートだけでなく，リリースサービステンプレートにも影響します。

サービステンプレートの開発環境と本番環境が別の場合

サービス共有プロパティの値は，本番用と開発用で別々に管理されます。サービステンプレートエディタでサービス共有プロパティを変更した場合，開発サービステンプレートのサービス共有プロパティだけが変更されます。リリースサービステンプレートのサービス共有プロパティには影響しません。

このように，リリースサービステンプレートのサービス共有プロパティに変更が影響しないようにするため，サービステンプレートの開発環境と本番環境を別にすることを推奨しています。

付録

付録A　参考情報

ここでは，JP1/AOを使用する上での参考となる情報について説明します。

付録A.1　ビルドおよびリリースの参考情報

(1)　ビルドおよびリリースの仕組みと違い

開発サービステンプレートをビルドおよびリリースすると，サービステンプレートのパッケージが作成されます。サービステンプレートを検証したい場合にビルドし，本番環境で実行できる状態にしたい場合にリリースします。

ビルドおよびリリースの仕組みを次の図に示します。

図A‒1　ビルドおよびリリースの仕組み

ビルドとリリースの違いを次の表に示します。

表A‒1　ビルドおよびリリースの違い

操作

目的

実行できる回数

サービステンプレートパッケージに設定される構成種別

サービステンプレートパッケージのファイル名

操作後の開発サービステンプレート編集可否

ビルド

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

何回でも実行できる

デバッグ構成

ベンダーID_名称_バージョン_d.st

○　

リリース

サービステンプレートを本番環境に適用する

1回

リリース構成

ベンダーID_名称_バージョン.st

×　

（凡例）

○：編集できます。　× ：編集できません。

関連トピック

付録A.1(2)　ビルドおよびリリースによって設定されるサービステンプレートおよび部品の構成種別

付録A.1(4)　サービステンプレートの構成種別とユーザーのロールによる画面表示可否の関係

付録A.1(5)　ビルドまたはリリースする場合のサービステンプレート，サービス，タスクの削除・アーカイブ範囲

(2)　ビルドおよびリリースによって設定されるサービステンプレートおよび部品の構成種別

サービステンプレートパッケージ（*.st）内のサービステンプレートおよび部品には，ビルドまたはリリースに対応した構成種別が設定されています。サービステンプレートおよび部品に設定される構成種別を次の表に示します。

表A‒2　ビルドおよびリリースによって設定される構成種別

サービステンプレートおよび部品

設定される構成種別

ビルドした場合

リリースした場合

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

デバッグ構成

リリース構成

部品※

基本部品，リリース部品（リリース構成）

リリース構成

リリース構成

開発部品（デバッグ構成）

デバッグ構成

リリース構成

注※

部品は，単体ではビルドおよびリリースできません。開発部品は，その部品を含むサービステンプレートがリリースされるとリリース部品になります。また，開発部品は，その部品を含むサービステンプレートがビルドされた場合，開発部品のままです。

関連トピック

付録A.1(4)　サービステンプレートの構成種別とユーザーのロールによる画面表示可否の関係

(3)　同一のサービステンプレートまたは部品が複数あった場合のビルド・リリース時の動作

サービステンプレートの開発中にビルドを繰り返す場合や，ビルド後にリリースする場合など，同一のサービステンプレートまたは部品がすでにインポートされている場合があります。この場合，サービステンプレートまたは部品の構成種別によって，ビルドおよびリリース時の動作が異なります。

なお，「同一のサービステンプレート（同一の部品）」とは，ベンダーID，サービステンプレートID（部品ID），サービステンプレートのバージョン（部品のバージョン）が同一のものを指します。なお，部品は，サービステンプレートが使用している部品を指します。

サービステンプレートをビルドした場合

サービステンプレートは，上書きされます。

ビルドするサービステンプレートに含まれる開発部品は，上書きされます。

ビルドするサービステンプレートに含まれるリリース部品は，上書きされません。

サービステンプレートをリリースした場合

サービステンプレートは，上書きされ，リリースサービステンプレートになります。

リリースするサービステンプレートに含まれる開発部品は，リリース部品になります。

リリースするサービステンプレートに含まれるリリース部品は，上書きされません。

(4)　サービステンプレートの構成種別とユーザーのロールによる画面表示可否の関係

サービステンプレートの構成種別とユーザーのロールによって，サービステンプレートおよびサービステンプレートから作成された管理対象（サービス，タスク，履歴）の［サービス］画面，［タスク］画面での表示可否が異なります。サービステンプレートの構成種別とユーザーのロールによる，画面の表示可否の関係を次の表に示します。

表A‒3　サービステンプレートの構成種別とユーザーのロールによる画面表示可否の関係

サービステンプレートの構成種別

管理対象

［サービス］画面および［タスク］画面での表示可否

Admin

Develop

Modify

Submit

デバッグ構成

サービステンプレート

○　

×　

×　

サービス

○　

×　

×　

タスク

○　

×　

×　

履歴

○　

×　

×　

リリース構成

サービステンプレート

○　

○　

×　

サービス

○　

○　

○　

タスク

○　

○　

○　

履歴

○　

○　

△　

（凡例）

○：操作・表示ともにできます。　△：表示だけはできます。　× ：操作・表示できません。

(5)　ビルドまたはリリースする場合のサービステンプレート，サービス，タスクの削除・アーカイブ範囲

開発サービステンプレートをビルドまたはリリースする場合，サービステンプレートおよびサービスは自動で削除され，タスクは自動でアーカイブされます。デバッグサービスおよびデバッグタスクは自動で削除されます。

なお，ビルドまたはリリースに失敗した場合でも，サービステンプレートおよびサービスは削除され，タスクはアーカイブされます。デバッグサービスおよびデバッグタスクは削除されます。

図A‒2　開発サービステンプレートをビルドまたはリリースする場合の削除・アーカイブ範囲

付録A.2　各バージョンの変更内容

(1)　10-52の変更内容

適用OSにLinuxを追加した。

部品バージョン管理機能の追加によって，部品バージョンの変更手順を追加した。

操作対象ホストがローカルホストの場合，ローカルホストのプロセスを直接起動してコマンドを実行したり，ファイルをコピーしたりできる，ローカル実行機能の説明を追加した。

操作対象の機器とのSSH接続で使用できる認証方式に，キーボードインタラクティブ認証を追加した。

［コマンドライン］テキストボックスに指定できる文字についての説明を追加した。

(2)　10-50の変更内容

2014年9月以降，マニュアル名称および資料番号を次のとおり変更した。

変更前

JP1/AO 画面・コマンドリファレンス（3021-3-084）

変更後

JP1/AO 画面・コマンド・APIリファレンス（3021-3-088）

サービステンプレートの開発に，JP1/AOが提供するコンテンツ部品を使用したい場合の説明を追加した。

操作対象の機器との認証方式に公開鍵認証を追加した。

操作対象の機器のOSがWindowsの場合に，ユーザーのプロファイルが引き継がれないことの説明を追加した。

［コマンドライン］テキストボックスに，OS標準のスクリプト以外を実行する場合の説明を追加した。

(3)　10-12の変更内容

適用OSにWindows Server 2012 R2を追加した。

サービステンプレートのデバッグを支援する機能を追加した。それに伴い，マニュアルの構成を変更した。

予約プロパティ「reserved.step.prevReturnCode」について，タスクをリトライする場合に，先行のステップを実行しないときの説明を追加した。

ステップまたは関連線の貼り付け時に引き継がれる情報として，後続ステップ実行条件を追加した。

操作対象の機器のOSがUNIXの場合，コンテンツ部品を実行する際にrootユーザーに昇格するかどうかを選択する機能を追加した。

転送対象ファイルが転送される条件について説明を追加した。

転送対象ファイルを格納するフォルダをプロパティファイル（config_user.properties）で設定できるように変更した。

予約部品プロパティ「plugin.suPassword」について，root権限で実行しない設定の場合の説明を追加した。

コンテンツ部品の戻り値についての説明を追加した。

実行したコマンドまたはスクリプトの戻り値，部品の戻り値，ステップの戻り値の関係についての説明を追加した。

部品として実行するコマンドまたはスクリプトが，0〜63の範囲外の戻り値を返す場合に，その戻り値をフローの分岐条件に使用したいときの手順を追加した。

(4)　10-11の変更内容

リリース部品を削除できるようにした。

予約プロパティの説明を追加した。また，次の予約プロパティを追加した。

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]

う

運用テストとは[1]

え

［エディタ］画面で作成したサービステンプレートおよび部品の互換性について[1]

［エディタ］画面で割り込み操作があった場合の動作[1]

［エディタ］画面を表示する[1]

［エディタ］画面を表示する手順[1]

お

応答待ち中のデバッグタスクの対処を入力する手順（応答入力）[1]

か

下位バージョンのJP1/AOで作成したサービステンプレートに含まれるステップの互換性について[1]

開発環境[1]

開発サービステンプレート[1]、[2]

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

開発サービステンプレートを削除する手順[1]

開発部品[1]

概要[1]

画面カスタムファイルとは[1]

画面カスタムファイルの形式[1]

画面カスタムファイルを設定する手順[1]

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

関連線が接続できない例[1]

関連線を接続する[1]

関連線を接続する手順[1]

き

基本部品[1]

基本部品，リリース部品，開発部品とは[1]

こ

後続ステップ実行条件について[1]

コマンドまたはスクリプトの戻り値をフローの分岐条件に使用する手順（戻り値が0〜63の範囲外の場合）[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]、[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]

ステップごとに中断してデバッグする流れ[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]

ビルドとは[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]

部品を削除する手順[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]