4.11.1 JP1/IM-SSの案件情報更新
機能
この部品は,JP1/IM-SSのjssitemeditコマンドを発行して,JP1/IM-SSのプロセスワークボードに登録されている案件の情報を更新します。
この部品が前提とするサーバを次に示します。
・JP1/IM-SSサーバ
JP1/IM-SSが動作するサーバです。
処理の流れを次に示します。
(1)JP1/IM-SSサーバの指定された案件を指定された値で変更します。指定しなかったプロパティは更新されません。
(2)次のプロパティの指定値は,デフォルトではコードマッピングファイル(jp1imss_itemedit_codemap.conf)に設定されているキーで指定する必要があります。
・ステータス(JP1IMSS.statusTypeCode)
・要因コード(JP1IMSS.causeTypeCode)
・結果コード(JP1IMSS.resultTypeCode)
・回避策種別コード(JP1IMSS.avoidTypeCode)
・解決区分コード(JP1IMSS.solvedTypeCode)
デフォルトでは次のキーを指定できます。
・ステータス(JP1IMSS.statusTypeCode)
[キー]
受付
調査中
計画中
審議中
対応依頼中
レビュー中
承認済み
クローズ
拡張ステータス01〜拡張ステータス40
・要因コード(JP1IMSS.causeTypeCode)
[キー]
空白
新規ソフトウェア不良
既知ソフトウェア不良
新規ハードウェア不良
既知ハードウェア不良
ドキュメント不良
資料不足
ユーザーミス
仕様
他社問題
プロセス不良
顧客要望
機能拡張
業務要件
インシデント・問題修正
プロセス改善
・結果コード(JP1IMSS.resultTypeCode)
[キー]
空白
完了
打ち切り
未確認
変更完了
既知の問題
原因不明
成功
失敗(計画ミス)
失敗(人的ミス)
失敗(その他)
・回避策種別コード(JP1IMSS.avoidTypeCode)
[キー]
空白
なし
運用回避
縮退運転
再起動
ファイル回復
変更の戻し
その他
・解決区分コード(JP1IMSS.solvedTypeCode)
[キー]
空白
ナレッジ
ドキュメント
ユーザー解決
二次サポート
問題管理
他社調査
デフォルト以外のキーを指定する場合は,コードマッピングファイルを作成して,コードマッピングファイルパス(リモート)(jp1imss.codeMappingFile)に,作成したコードマッピングファイル名を指定してください。
コードマッピングファイルについては「JP1/Service Support構築・運用ガイド」を参照してください。
利用場面
問題リカバリー処理の延長でJP1/IM-SSの案件のステータスを更新する。
例えば,JP1/IM-SSオペレータが登録された案件を確認後,JP1/IM-SSの画面からシングルサインオンでJP1/Automatic Operation(以降,JP1/AOと呼びます)のサービス実行画面を開き,問題リカバリー用のサービステンプレートを実行し,サービステンプレートに含まれる部品で障害回復を行ったり,JP1/IM-SSサーバの案件のステータスを更新したりという運用の中で,JP1/IM-SSの案件のステータスを更新する部分に使用できます。
前提条件
【システム内前提製品】/【実行対象サーバ内前提製品】/【実行対象サーバ内前提製品の稼働OS】の最新のサポート状況については,リリースノートを参照してください。
【システム内前提製品】
JP1/Automatic Operation 11-00以降
【実行対象サーバ内前提製品】
(1)JP1/IM-SSサーバに次の製品が稼働していること。
・JP1/Integrated Management - Service Support 10-10以降,または
JP1/Service Support 11-00以降
【実行対象サーバ内前提製品の稼働OS】
(1) Windows Server 2008 R2 Standard/Enterprise/Datacenter
(2) Windows Server 2012 Standard/Datacenter,Windows Server 2012 R2 Standard/Datacenter
(3) Windows Server 2016 Standard/Datacenter
(4) Windows Server 2019 Standard/Datacenter
【実行対象サーバ内前提製品の使用条件】
(1)更新対象の案件がJP1/IM-SSサーバ上に存在していること。
(2)プロパティに指定するユーザーIDがJP1/IM-SSサーバに定義されていること。
(3)プロパティに指定するロールIDがJP1/IM-SSサーバに定義されていること。
注意事項
(1)指定しなかったプロパティは更新されません。指定しなかったプロパティを更新する場合は,JP1/IM-SSのGUIかコマンドを使用して更新してください。
(2)JP1/IM-SSで1024文字以上設定可能なフリー記入欄は,JP1/AOでは1024文字までしか入力できません。
(3)プロパティには「//」で始まる値は指定しないでください。
(4)エージェントレス接続先設定の認証情報に設定したユーザーがビルトインAdministratorではない場合,以下のいずれかの条件を満たす必要があります。
・WindowsのUAC機能が完全に無効化されている。
・エージェントレス接続先の機器にて,エージェントレス接続先設定の認証情報に設定されたユーザーに対するRDPセッションが確立されている。
実行権限
Administrators 権限
バージョン
02.00.00
部品のタグ
Configure JP1,SS,Windows
タスクログに表示される部品の名称
jp1IMSSeditItem
戻り値
戻り値 |
説明 |
---|---|
0 |
正常 |
12 |
異常(ユーザーミス) プロパティ不正 |
21 |
異常(環境不正) コマンドが見つからない(部品スクリプトでエラーを検知) |
25 |
異常(環境不正) 通信エラー |
27 |
異常(エラー内容はタスクログで確認) |
41 |
異常(部品内でエラーを検知) プロパティ未入力(部品スクリプトでエラーを検知) |
42 |
異常(部品内でエラーを検知) 内部エラー(部品スクリプトでエラーを検知) |
プロパティ一覧
プロパティ一覧を次の表に示します。
プロパティキー |
プロパティ名 |
説明 |
デフォルト値 |
入出力種別 |
必須区分 |
---|---|---|---|---|---|
plugin.destinationHost |
実行対象サーバのホスト名 |
案件を編集するJP1/IM-SSサーバのホスト名,またはIPアドレスを指定します。IPv6には対応していません。 |
− |
入力 |
○ |
JP1IMSS.itemID |
案件ID |
更新するJP1/IM-SSの案件IDを指定してください。 |
− |
入力 |
○ |
JP1IMSS.registerID |
登録者ID |
案件の登録者となるユーザーのIDを指定します。 |
− |
入力 |
○ |
JP1IMSS.staffType |
担当者種別 |
担当者種別("USER"または"ROLE")を指定します。 |
− |
入力 |
○ |
JP1IMSS.staffID |
担当者ID |
案件の担当者となるユーザーのIDまたはロールのIDを指定します。 |
− |
入力 |
○ |
JP1IMSS.statusTypeCode |
ステータス |
案件に設定するステータスを指定します。 |
− |
入力 |
○ |
JP1IMSS.closeDateTime |
完了日時(YYYY/MM/DD hh:mm[:ss]) |
案件の完了日時を「YYYY/MM/DD hh:mm:ss」または「YYYY/MM/DD hh:mm」形式で指定します。 |
− |
入力 |
△ |
JP1IMSS.causeTypeCode |
要因コード |
案件に設定する要因コードを指定します。 |
− |
入力 |
△ |
JP1IMSS.resultTypeCode |
結果コード |
案件に設定する結果コードを指定します。 |
− |
入力 |
△ |
JP1IMSS.avoidTypeCode |
回避策種別コード |
案件に設定する回避策種別コードを指定します。 |
− |
入力 |
△ |
JP1IMSS.solvedTypeCode |
解決区分コード |
案件に設定する解決区分コードを指定します。 |
− |
入力 |
△ |
JP1IMSS.freeText |
フリー記入欄 |
案件のフリー記入欄に設定する文字列を指定します。 |
− |
入力 |
△ |
JP1IMSS.codeMappingFile |
コードマッピングファイルパス(リモート) |
ユーザーが定義したコードマッピングファイルを使用する場合,JP1/IM-SSサーバ上のコードマッピングファイル名をフルパスで指定します。 |
− |
入力 |
△ |
JP1IMSS.forceWrite |
編集中の案件の更新 |
案件が編集中の状態でも更新する場合にtrueを指定します。falseを指定すると,案件が編集中のときは更新できません。指定しない場合は,falseとなります。 |
− |
入力 |
△ |
common.returnValue |
部品の戻り値 |
この部品の戻り値が格納されます。 |
− |
出力 |
△ |