https://itpfdoc.hitachi.co.jp/manuals/JCS/JCSM71030001/index.html Recent content in 利用ガイド Home on JP1 Cloud Service 運用統合 利用ガイド Hugo -- gohugo.io ja https://itpfdoc.hitachi.co.jp/manuals/JCS/JCSM71030001/introduction/index.html Mon, 01 Jan 0001 00:00:00 +0000 https://itpfdoc.hitachi.co.jp/manuals/JCS/JCSM71030001/introduction/index.html 本書はJP1 Cloud Service/Operations Integrationの概要や利用方法について説明するものです。 ■ 対象製品 JP1 Cloud Service/Operations Integration 03-00 ■ 輸出時の注意 本製品を輸出される場合には、外国為替および外国貿易法の規制ならびに米国の輸出管理規制など外国の輸出関連法規をご確認のうえ、必要な手続きをお取りください。 なお、不明な場合は、弊社担当営業にお問い合わせください。 ■ 商標類 記載の会社名、製品名などは、それぞれの会社の商標または登録商標です。 ■ マニュアルの体系 Ops Iのマニュアルは、本書を含めて3冊のドキュメントから構成されています。 本書では、Ops Iの概要や利用方法について説明しています。 JP1 Cloud Service 運用統合 利用ガイド ＜本書＞ JP1 Cloud Service 運用統合 利用ガイド（ITSM操作編） JP1 Cloud Service 運用統合 APIリファレンス ■ このマニュアルでの表記 このマニュアルでは、名称を省略して表記しています。このマニュアルでの表記を次に示します。 略称 正式名称 .NET Microsoft(R) .NET Excel Microsoft(R) Excel IdP Identity Provider アイデンティティプロバイダー JP1/AJS3 JP1/Automatic Job Management System 3 JP1/IM JP1/Integrated Management 3 JP1/Integrated Management 2 JP1/Integrated Management OIDC OpenID Connect Ops I JP1 Cloud Service/Operations Integration 03-00 RHEL Red Hat(R) Enterprise Linux(R) Windows Server Microsoft(R) Windows Server(R) 2025 Standard https://itpfdoc.hitachi.co.jp/manuals/JCS/JCSM71030001/history/index.html Mon, 01 Jan 0001 00:00:00 +0000 https://itpfdoc.hitachi.co.jp/manuals/JCS/JCSM71030001/history/index.html 変更内容（JCSM71-0300-01） JP1 Cloud Service/Operations Integration 03-00 追加・変更内容 変更箇所 AI拡張機能で、ナレッジ記事の更新をサポートしました。チャットパネルから、チケットに類似した現象のナレッジ記事を選択し、チケットの内容を反映できます。 3.1.2 AI拡張機能で、チケットとナレッジ記事のキーワード検索を行えるようにしました。 3.1.2 チャットパネルでの会話が切断されるケース、および会話履歴が不正になるケースについて注意事項を追記しました。 3.1.2（2） AIクレジットについての説明を追加しました。 2.1.4、3.1.2、4.11、5.1 チケット、ナレッジ記事からOps Iの定義ファイルを更新するケースについて記載を追加しました。 4.11.1 チケットやナレッジ記事などのリソースの変更を起点にユーザーが作成したサーバーサイドスクリプトを実行できる機能（ビジネスロジックトリガー）を追加しました。 スクリプトを実行する契機として、以下のリソースが利用できます。 チケット チケットの作業メモ チケットの関連リンク ナレッジ記事 4.5.6、6.15 ビジネスロジックトリガーの実行条件を設定するマニフェストを登録できるようになりました。 また、これに伴いクライアントサイドスクリプトとサーバーサイドスクリプトについての記載を追加しました。 6.5、6.5.1、6.5.2、6.5.2.1、6.15 以下のサーバーサイドスクリプトの部品を追加しました。 OISystem.properties.get() OISystem.properties.getAll() この部品により、環境のドメインを取得することができます。 6.5.2 以下のサーバーサイドスクリプトの部品を追加しました。 OIVault.kv.v2.get() この部品を利用することで、スクリプト内で自動化アプリケーションに登録しているクレデンシャルを利用できるようになりました。 6.5.2 以下のサーバーサイドスクリプトの部品を追加しました。 OIHttpClient.get() OIHttpClient.post() OIHttpClient.put() OIHttpClient.patch() OIHttpClient.delete() この部品を利用することで、スクリプト内からOps IのAPIやOps I外部と通信できるようになりました。 6.5.2 以下のサーバーサイドスクリプトの部品を追加しました。 OILog.log() OILog.debug() OILog.info() OILog.warn() OILog.error() この部品を利用することで、ログを出力できます。 6.5.2 以下のダッシュボードをダッシュボードアプリケーションに追加しました。 Script このダッシュボードを利用することで、ログを閲覧でき、サーバーサイドスクリプトの挙動を確認できるようになりました。 3.11 アイデンティティプロバイダーのマッピングの種類に、テンプレート文字列で同期する以下の4つの選択肢を追加しました。 ＜OIDC＞ Claimからグループをテンプレート文字列で同期 Claimからロールをテンプレート文字列で同期 ＜SAML＞ 属性からグループをテンプレート文字列で同期 属性からロールをテンプレート文字列で同期 3.6.2（5） グループに親グループを指定することで、グループ階層を定義できるようになりました。グループ階層を定義することで次のことができます。 ユーザーやロールの割り当てをグループ階層上で管理できます。 カスタムテーブルのgroupカラムと組み合わせてグループの階層を用いたアクセス制御ができます。 ワークフローの詳細画面で表示するUIや独自に作成したアプリケーションでグループ階層を表示できます。 グループに割り当てられるロールは、そのグループ階層配下のすべてのグループに引き継がれます。作成済みのグループに親または子グループを作成する場合は、割り当てるロールやロールに割り当てたACLの定義も見直してください。 3. https://itpfdoc.hitachi.co.jp/manuals/JCS/JCSM71030001/table-of-contents/index.html Mon, 01 Jan 0001 00:00:00 +0000 https://itpfdoc.hitachi.co.jp/manuals/JCS/JCSM71030001/table-of-contents/index.html 1. 概要 1.1 Ops Iの概要 1.2 Ops Iの特長 1.3 利用方法の概要 1.4 使用上の注意事項および一時的制限事項 1.4.1 使用上の注意事項 1.4.1（1） Ops Iのログイン、ログアウトに関する注意事項 1.4.1（2） 言語設定に関する注意事項 1.4.1（3） ユーザー管理に関する注意事項 1.4.1（4） アクセス制御に関する注意事項 1.4.1（5） シークレット管理に関する注意事項 1.4.1（6） ドキュメント管理に関する注意事項 1.4.1（7） 入力可能文字に関する注意事項 1.4.1（8） Ops Iからのメール通知に関する注意事項 1.4.1（9） Gitを使用した操作の注意事項 1.4.1（10） タスク管理に関する注意事項 1.4.1（11） ダウンロードファイルのファイル名について 1.4.1（12） 配布ルールに関する注意事項 1.4.1（13） バックアップに関する注意事項 1.4.1（14） 外部システムとの連携に関する注意事項 1.4.2 一時的制限事項 1.4.2（1） 一時的制限事項 2. 導入・設定 2.1 前提知識 2.1.1 導入・設定を実施するユーザー 2.1.2 ユーザーと各機能の関連 2.1.3 ユーザー管理機能 2.1.4 Ops IのAI機能とAIクレジット 2.2 事前準備 2.2.1 Ops Iへの接続およびログイン 2.2.2 ワンタイムコード設定 2.3 ユーザー作成 https://itpfdoc.hitachi.co.jp/manuals/JCS/JCSM71030001/outline/index.html Mon, 01 Jan 0001 00:00:00 +0000 https://itpfdoc.hitachi.co.jp/manuals/JCS/JCSM71030001/outline/index.html 概要について説明します。 章構成 1.1 Ops Iの概要 1.2 Ops Iの特長 1.3 利用方法の概要 1.4 使用上の注意事項および一時的制限事項 https://itpfdoc.hitachi.co.jp/manuals/JCS/JCSM71030001/setting/index.html Mon, 01 Jan 0001 00:00:00 +0000 https://itpfdoc.hitachi.co.jp/manuals/JCS/JCSM71030001/setting/index.html 導入・設定について説明します。 章構成 2.1 前提知識 2.2 事前準備 2.3 ユーザー作成 2.4 組織の設定 2.5 中継サーバーの設定 2.6 リポジトリの設定 2.7 IdP連携の設定 2.8 オンプレミス環境とのプライベートネットワーク接続 https://itpfdoc.hitachi.co.jp/manuals/JCS/JCSM71030001/function/index.html Mon, 01 Jan 0001 00:00:00 +0000 https://itpfdoc.hitachi.co.jp/manuals/JCS/JCSM71030001/function/index.html 機能について説明します。 章構成 3.1 基本的な画面構成 3.2 タスク、リクエスト 3.3 ナレッジ 3.4 ドキュメント 3.5 データモデル 3.6 システム 3.7 Git 3.8 シークレット管理 3.9 ITサービスマネージメント（ITSM） 3.10 自動化 3.11 ダッシュボード https://itpfdoc.hitachi.co.jp/manuals/JCS/JCSM71030001/customer/index.html Mon, 01 Jan 0001 00:00:00 +0000 https://itpfdoc.hitachi.co.jp/manuals/JCS/JCSM71030001/customer/index.html お客様での運用設計・構築について説明します。 章構成 4.1 前提知識 4.2 業務の整理 4.3 業務設計 4.4 UI設計 4.5 その他運用設計Tips 4.6 マニフェストファイルのGitLab登録手順 4.7 ジョブ自動実行の設定手順 4.8 中継サーバー使用手順 4.9 他製品との連携 4.10 自動化実行環境の拡張 4.11 AIエージェントとの連携 https://itpfdoc.hitachi.co.jp/manuals/JCS/JCSM71030001/operation/index.html Mon, 01 Jan 0001 00:00:00 +0000 https://itpfdoc.hitachi.co.jp/manuals/JCS/JCSM71030001/operation/index.html 運用について説明します。 章構成 5.1 ライセンス利用状況の確認 5.2 検証環境から本番環境へのデータ移行 5.3 Ops Iバージョンアップ対応 https://itpfdoc.hitachi.co.jp/manuals/JCS/JCSM71030001/yaml/index.html Mon, 01 Jan 0001 00:00:00 +0000 https://itpfdoc.hitachi.co.jp/manuals/JCS/JCSM71030001/yaml/index.html Ops Iでは、マニフェストファイル（YAML形式）で運用要件を定義します。 これは運用のコード化（Operations as Code）の考え方に基づいており、マニフェストファイルをOps Iに登録することで、自動的に運用機能に変換されます。 マニフェストファイルで記載することができる運用機能の一覧を以下に示します。 （表）マニフェストファイルで記載することができる運用機能 名称 説明 Workflow 運用に必要となるワークフローの定義を行います。 UI 画面に表示するデータ項目やレイアウトなど、UIの定義を行います。 Uipath UIのURLの定義を行います。 Datamodel 各種データを保存するためのデータモデルの定義を行います。 Catalog ユーザーが各種申請を行う際の入り口となるサービスカタログの定義を行います。 Script 画面表示時やボタンをクリックした時など、何かしらのイベントを契機に実行されるアクションの定義を行います。 Library 複数のユーザーから参照できる共有コンテナの定義を行います。 Attachment 運用の中で扱う添付ファイルの命名ルールの定義を行います。 Distribution 運用の中で発生する各種ドキュメントをどのようなルールでどこに保存するか定義を行います。 ACL Statementで定義した認可に対してユーザーやグループなどの適応先を定義します。 Statement URIやテーブルのレコードなどさまざまなリソースに対しての認可設定の定義を行います。 Notification Ops I上でのイベントによる通知、およびワークフローの任意のタイミングで行う通知について、通知の宛先や通知する内容などの定義を行います。 Notifier Notificationで定義された通知内容をどのように通知するか通知手段の定義を行います。 Application Ops Iのアプリケーションの定義を行います。 Skill 各ユーザーが保有する経験値や資格などのスキルを可視化するための定義を行います。 Skillset ワークフローの各ステップを実行するために必要なスキルをセット化して定義します。 Calendar スケジュールの予定表テンプレートを定義します。 Import カスタムテーブルのレコードをインポートする場合の、アップロードするCSVファイルとカスタムテーブルのカラムのマッピングなどを定義します。 BusinessLogicTrigger チケット、ナレッジ、カスタムテーブルの操作をトリガーにスクリプトを実行する機能について、トリガーの条件とスクリプトの動作設定を定義します。 Ops Iで運用機能をコード化する場合、定められた書式に従ってマニフェストファイルを記述する必要があります。各運用機能のマニフェストファイルの詳細な記述内容は「Workflow」～「BusinessLogicTrigger」を参照してください。 例として、サービスカタログからワークフローを実行する場合の運用機能の関係を以下に示します。 （図）マニフェストファイルと運用機能の関係の例 【マニフェストファイル作成時の注意】 マニフェストファイルのファイル名は「manifest.yaml」にする必要があります。 第1階層のnameキーで指定した名称と同じ名称のディレクトリ配下に、マニフェストファイルを保存する必要があります。 kindキーとnameキーの組み合わせはOps Iで一意である必要があります。 マニフェストファイルのnameキーとデータモデルのテーブル名には、システム側が使用する予約語があります。予約語は使用しないでください。 やむを得ず予約語を使用する場合は、プレフィックスを付けるなどの対応を行い、衝突を回避してください。予約語と衝突した場合はエラーが発生する場合があります。予約語の詳細については、「マニフェストファイルのnameキーとデータモデルのテーブル名でエラーが発生しマニフェストファイルが登録できない場合の対処」を参照してください。 Include対象となるマニフェストファイルで、他のnameキーと衝突していると意図しない動作になります。詳細については「エラーメッセージが表示されないが、意図しない動作になる場合の対処」を参照してください。 マニフェストファイルはユーザーが定義したグループ内の任意のリポジトリに登録することで、Ops Iから読み込むことができます。その結果、Ops Iが自動的に対応した運用機能を生成します。マニフェストファイルの登録は「マニフェストファイルのGitLab登録方法（GUI）」と「マニフェストファイルのGitLab登録方法（CUI）」を参照してください。 （図）マニフェストファイルの登録方法 また、マニフェストファイルを定義する際、一部のキーでテンプレート機能を使用することができます。 テンプレート機能はドキュメント機能の1つで、マニフェストファイルに環境パラメータとして定義した用語を、「{{」と「}}」を用いてユーザー定義パラメータやシステム定義パラメータなどに置き換えることができる機能です。多言語に対応させる場合などに有用です。 テンプレート機能を利用できるキーで「{{」や「}}」を文字列として使用する場合は、それぞれ「{{ "{{" }}」や「{{ "}}" }}」のようにエスケープしてください。 https://itpfdoc.hitachi.co.jp/manuals/JCS/JCSM71030001/troubleshoot/index.html Mon, 01 Jan 0001 00:00:00 +0000 https://itpfdoc.hitachi.co.jp/manuals/JCS/JCSM71030001/troubleshoot/index.html Ops Iを使用しているときに発生したトラブルの対処方法を説明します。 章構成 7.1 メッセージ一覧 7.2 エラー時の対処方法 https://itpfdoc.hitachi.co.jp/manuals/JCS/JCSM71030001/role/index.html Mon, 01 Jan 0001 00:00:00 +0000 https://itpfdoc.hitachi.co.jp/manuals/JCS/JCSM71030001/role/index.html Ops Iロールについて説明します。 章構成 8.1 Ops I上のロールとサポート機能の対応関係 8.2 APIとOps I上ロールの対応関係 https://itpfdoc.hitachi.co.jp/manuals/JCS/JCSM71030001/appendix/index.html Mon, 01 Jan 0001 00:00:00 +0000 https://itpfdoc.hitachi.co.jp/manuals/JCS/JCSM71030001/appendix/index.html 以下の項目について説明します。 章構成 9.1 OSSのバージョンおよびエディション、参照先のマニュアル 9.2 各バージョンの変更内容