JS7 クイックスタート

JS7® JobSchedulerは、独SOS社(Software- und Organisations-Service GmbH)が開発したジョブ管理システムです。従来のJobSchedulerをリニューアルし、耐障害性や大規模環境対応を強化しています。本記事では、JS7® JobSchedulerで初めてジョブを実行する方法について説明します。

参考：
- [JS7 Getting Started](https://kb.sos-berlin.com/display/PKB/JS7+-+Getting+Started)

詳細な情報は以下を参照ください：
- [ナレッジベース（英語）](https://kb.sos-berlin.com/display/PKB/JS7)
- [日本語紹介資料](https://www.ossl.co.jp/)
- [フォーラム](https://groups.google.com/forum/?hl=ja#!forum/jobscheduler-ja)
- [Facebook](https://www.facebook.com/Jobscheduler-Japan-%E3%83%A6%E3%83%BC%E3%82%B6%E3%83%BC%E3%82%B0%E3%83%AB%E3%83%BC%E3%83%97-594469610565511/timeline/)
- [日本JobSchedulerユーザーグループ](https://sites.google.com/site/jobschedulerja/)
- [JIRA（英語）](https://change.sos-berlin.com/secure/Dashboard.jspa)
- [User Forum（英語）](http://sourceforge.net/projects/jobscheduler/forums/forum/486122)
- [SOS社ホームページ](http://www.sos-berlin.com)

# 1. 前提条件

JS7® JobScheduler V.2.1以上がインストール済みであること。インストール方法については以下を参照ください：
- [Dockerでのインストール手順](https://qiita.com/satoruf/items/360fee5293611433ed33)
- [Windowsでのインストール手順](https://qiita.com/Yoshitami/items/6804584592956a483364)
- [Linux/CLIでのインストール手順](https://qiita.com/satoruf/items/fa9846f4376d1a50a67e)

# 2. はじめに

## (1) デフォルトジョブリソースのインストール

デフォルトジョブリソースとは、定義済み共通ジョブリソース（JS7®インスタンス内でのグローバル変数）です。ホスト名やエージェント名、ワークフロー名などをジョブ内から呼び出すことができます。

[ジョブリソース](https://kb.sos-berlin.com/display/PKB/JS7+-+Job+Resources)

1. 画面右上のヘルプメニュー（？マーク）をクリックし、サンプル＞デフォルトジョブリソースを選択します。
2. サンプルダウンロードをクリックします。
3. ジョブ定義メニューをクリックし、画面右上のインポートボタンをクリックします。
4. ジョブ定義画面のインベントリーを選択し、左側のコントローラーを展開、ジョブリソースからDefaultをクリックします。
5. 配置ボタンをクリックし、登録をクリックして配置済みになることを確認します。

![スクリーンショット](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/52445/02e83fc8-0675-46c0-f82c-110b8d3fd40e.png)

ジョブのメール送受信設定を行う場合、`eMailDefault`をクリックし、アカウント情報を入力して配置をクリックします。

![スクリーンショット](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/52445/a594de9e-c324-dfe4-b25b-4c2f2cd627c7.png)

## (2) ワークフローサンプルのインストール

オンラインデモで提供されているワークフローサンプルをインストールします。サンプルの説明は[こちら](https://kb.sos-berlin.com/display/PKB/JS7+-+Online+Demo)を参照ください。

1. 画面右上のヘルプメニュー（？マーク）をクリックし、サンプルからジョブ実行環境に応じたワークフローサンプルを選択してダウンロードします。
2. ジョブ定義メニューをクリックし、インポートボタンをクリックして、ダウンロードしたファイルを選択します。
3. ジョブ定義画面のインベントリーを選択し、左側のコントローラーから展開、ワークフローをクリックします。

![スクリーンショット](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/52445/19fc617f-be24-dd76-1f12-11b7dda56aed.png)

# 3. サンプルワークフローの実行

## (1) エージェント名の変更

サンプルワークフロージョブのエージェント名を変更します。詳細は以下のスクリーンショットを参照してください。

![スクリーンショット](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/52445/16df0a79-6fe5-d9a1-b467-fbc2d599419d.png)

## (2) ワークフローの実行

1. ワークフローを有効にし、配置ボタンをクリックします。
2. ワークフロー画面で配置済みワークフローが表示されます。
3. ワークフローを実行するには、アクションメニューからオーダー追加を選択します。

![スクリーンショット](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/52445/33258c54-0a4a-0337-035a-05d1fd8194ea.png)

## (3) ワークフローの定期実行

[デイリープランサービス](https://kb.sos-berlin.com/display/PKB/JS7+-+Daily+Plan+Service)を使用して、定期的にワークフローを実行します。カレンダーとスケジュールを設定します。

![スクリーンショット](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/52445/f01abacb-9780-7c28-e30c-6efb833a3acb.png)

## (4) ワークフローのイベント実行

ファイル監視やAPIを使用して、イベントをトリガーにワークフローを実行します。

### ファイル監視によるワークフロー実行

指定ディレクトリやファイルを監視し、書き込みを検知してワークフローを実行します。

![スクリーンショット](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/52445/9092b5e0-7b04-e435-5b95-482533b13f8a.png)

### APIによるワークフロー実行

JS7® JobSchedulerは、REST APIやPowerShell CLIを使用して外部から操作可能です。

- [REST API](https://kb.sos-berlin.com/display/PKB/JS7+-+REST+Web+Service+API)
- [PowerShell Module](https://kb.sos-berlin.com/display/PKB/JS7+-+PowerShell+Module)

# 4. オブジェクト命名規則

JS7®JobSchedulerでは、オブジェクト名はJavaの識別子の命名規則に準じます。詳細は以下を参照ください。

- [オブジェクト命名規則](https://kb.sos-berlin.com/display/PKB/JS7+-+Object+Naming+Rules)

# 5. その他ナレッジベースリンク

- [JS7® JobSchedulerワークフロー間連携](https://qiita.com/satoruf/items/64b185880f4ac0e05c5d)
- [JS7® How To](https://kb.sos-berlin.com/display/PKB/JS7+-+How+To)
- [JS7® FAQ](https://kb.sos-berlin.com/display/PKB/JS7+-+FAQ)
- [JS7® Troubleshooting](https://kb.sos-berlin.com/display/PKB/JS7+-+Troubleshooting)