ServiceDesk Plus オンプレミス版 ナレッジベース

※本ナレッジは「End-of-Life (EOL) Announcement for Change V1 APIs」をもとに作成しております。 2024年1月31日より、ServiceDesk Plusの変更API V1のサポートが終了（EOL）となります。 これにより、以降のServiceDesk Plusのリリースでは、変更のAPI V1へアクセスできなくなります。 ビルド14503以下のServiceDesk Plusでは、引き続き変更API V1をご利用いただけます。 影響 API V1（特に変更のAPI V1）を利用して、ServiceDesk Plusと連携している 外部の製品/Webクライアント/デスクトップアプリが影響を受けます。 すなわち、API V1で設定しているクライアント連携/カスタムスクリプト/カスタム関数などで該当の機能が動作しなくなります。 推奨事項 API V1を使用して設定されている前述の機能を、API V3に更新することを強く推奨いたします。 なお、以下は廃止される変更のAPI V1および、それに対応するAPI V3の一覧です。 API名 API V1 URL V1オペレーション名 対応するAPI V3 URL V3 HTTPメソッド GET Change （変更の取得） /sdpapi/change/{変更ID} GET /api/v3/changes/{変更ID} GET GET All Changes （すべての変更の取得） /sdpapi/change GET_ALL /api/v3/changes… ［続きを読む］

本ナレッジは、「Upcoming End-of-Life of Request Admin V1 APls」を参考に記載しています。 ServiceDesk Plusビルド13005において、リクエストのAdmin API V1およびWorklog API V1のサポートが終了となります。 API V1からAPI V3に変更しない場合、API V1に基づくすべてのクライアントとの連携は動作しなくなります。 そのため、API V1からAPI V3へ変更することを推奨いたします。 サポート終了となるAPI V1とそれに対応するAPI V3の一覧 レベル 操作 V1 URL 対応するV3 URL GET /sdpapi/admin/level/{level-id} /api/v3/levels/{level_id} GET_ALL /sdpapi/admin/level /api/v3/levels   モード 操作 V1 URL 対応するV3 URL GET /sdpapi/admin/mode/{mode-id} /api/v3/modes/{mode_id} GET_ALL /sdpapi/admin/mode /api/v3/modes   カテゴリー 操作 V1 URL 対応するV3 URL… ［続きを読む］

ビルド11312から13005にアップグレードする際に、以下のような案内が表示される場合があります。 以下を確認後、アップグレードを続行する場合は、「はい」および「OK」をクリックしてください。 最新版へのアップグレード手順の詳細は、「日本語最新ビルドへのアップグレードの流れについて」をご覧ください。 全ビルド間のアップグレードに共通のアラート 強制バックアップに関するアラート   こちらのアラートは、アップグレード時、事前にバックアップを取得することを推奨する旨、およびアップグレード時に、強制バックアップが実行される旨を示しています。詳細は「バックアップ手順」と「リストア手順」ご覧ください。 また、何らかの理由で強制バックアップをスキップすることを検討している場合は、「強制バックアップをスキップする方法」をご覧ください。   アンチウイルススキャンに関するアラート こちらのアラートは、アップグレード前に、ServiceDesk Plusのインストールディレクトリと、postgresql.exeプロセスをアンチウイルススキャンから除外することを推奨する旨を示しています。詳細は、「システム要件」をご覧ください。   ビルド11312 → 12000のアップグレード時に発生するアラート Active Directoryに関するアラート こちらのアラートは、アップグレードに伴い、ユーザーの詳細の差分同期、AD・LDAPの個別のインポートスケジュール、削除されたユーザーの同期などの、ADユーザーのインポートにいくつかの仕様変更が加えられる旨を示しています。詳細は、「Active Directoryの設定」をご覧ください。   ビルド12000 → 13000のアップグレード時に発生するアラート TLSプロトコルに関するアラート こちらのアラートは、TLSプロトコルにてバージョンV1およびV1.1のサポートが終了し、対応する最低のバージョンがV1.2になる旨を示しています。 PPMファイルの整合性および、証明書に関するアラート こちらのアラートは、パッチ検証後に、PPMファイルの整合性チェックのための証明書を適用する必要がある旨を示しています。なお、その証明書は自動的にダウンロード・適用されます。 しかしながら、ファイルの自動ダウンロード・適用に失敗した場合は、UpdateManagerの［Install］をクリックすると、PPMファイルの整合性をチェックするための証明書をインポートするよう求めるポップアップが表示されます。 証明書は、こちらをクリックすることでダウンロードできます。また、詳細は「サービスパックのインストール」をご覧ください。   ビルド13000 → 13005のアップグレード時に発生するアラート サーブレットAPIに関するアラート こちらのアラートは、サーブレットAPI（/servlets/Site Servlet）のサポートが終了し、代わりにAPI V3が利用できること、およびAPI V3のドキュメントがServiceDesk Plus内から参照可能になる旨を示しています。   API V1に関するアラート こちらのアラートは、リクエストのAdmin API V1およびWorklogのAPI V1のサポートが終了すること、また、連携しているすべてのManageEngine製品も適切なバージョンにアップグレードする必要がある旨を示しています。詳細は、「リクエストのAdmin API V3について」をご覧ください。 ［続きを読む］

本ナレッジは「End-of-Life of Request V1 APIs - Impact on Upgrade, Scripts and Integrations」を参考に記載しています。   ServiceDesk Plusバージョン11.3より、一部のリクエストAPI V1のサポートが終了となります。 これらのAPIに基づくすべてのクライアントと連携は、新しいAPIに更新されない限り、動作しなくなります。 そのため、新しいバージョンのAPIを使用および更新することを推奨いたします。 本変更に伴い、カスタムトリガーとカスタムメニューコマンドのカスタムスクリプトの入力フォーマットを変更しました。サポートが終了となった場合、カスタムトリガーとカスタムメニューコマンドでは、引数「$COMPLETE_JSON_FILE」は機能しなくなります。その代わり、API V3フォーマットで入力する引数「$COMPLETE_V3_JSON_FILE」を使用してください。カスタムトリガーとカスタムメニューでサポートされていない「$COMPLETE_JSON_FILE」が使用されている場合、バージョン11.3へアップグレードできません。 影響を受ける機能 ［管理］→［カスタムトリガー］→［スクリプトを実行する］ ［管理］→［インシデント/サービスカタログの業務ルール］→［スクリプトを実行する］ ［管理］→［リクエストライフサイクル］→［スクリプトを実行する］ ［管理］→［カスタムメニュー］→［スクリプトを実行する］ ［管理］→［インシデントテンプレート/サービスカタログ］→［フィールド＆フォームルールのスクリプトを実行する］ ［管理］→［カスタムスケジュール］→［実行対象］ ［ホームページ＆ダッシュボード］→［ウィジェットのカスタマイズ］ ［管理］→［ページスクリプト］ サポートが終了となった場合、カスタムトリガーとカスタムメニューコマンドでは引数「$ COMPLETE_JSON_FILE」は機能しません。引数「$COMPLETE_V3_JSON_FILE」を使用してください。 サポート終了となるリクエストAPI V1およびAPI V3の一覧 API V3をサポートしていないリクエストAPI V1に関しては、バージョン11.3以降も当面は引き続き利用可能です。 例：GET_REQUEST_FILTERS、ADD_CONVERSATION、REPLY_REQUEST、GET_CONVERSATION、GET_NOTIFICATION、MENU_ACTION 注意点 ServiceDesk Plusのモバイルアプリを使用している場合は、モバイルアプリを最新バージョンへアップグレードをお願いします。 IOS：バージョン5.2.2011以降 Android：バージョン5.5以降   ServiceDesk Plusインスタンスが連携している他のManageEngine製品のバージョンにも影響します。すべての連携が機能するように他の製品についても確認するようお願いします。 リクエストAPI V3がサポートされているManageEngine製品のビルドは以下の通りです。 Desktop Central：ビルド100574以降 OpManager：ビルド12.5.0232以降 Application Manager：ビルド14780以降 Password Manager… ［続きを読む］