Manage Engine Service Desk Plus Plugin for Ticket Orchestrator

このドキュメントでは、Manage Engine Service Desk Plus v1.1.0 の設定方法について説明します。Netskope Cloud Exchangeの Ticket Orchestrator モジュールを備えたプラグイン。このプラグインは、Service Desk Plus プラットフォーム上で選択した Service Desk Plus プロジェクトのタスクを作成するために使用します。また、タスクの更新やステータスの同期もサポートしています。このプラグインは、クラウド環境とオンプレミス環境の両方のデプロイメントタイプをサポートしています。

前提条件

この設定を完了するには、以下が必要です。

Netskopeテナント（または、例えば本番環境と開発／テスト環境など、複数のテナント）。
Netskope Cloud Exchangeテナントには、テナントプラグインとチケットオーケストレータープラグインが既に設定済みです。
Manage Engine Service Desk Plusインスタンス（クラウドまたはオンプレミス）への接続
- オンプレミスインスタンス用の自己署名CA.crtファイル
インスタンスタイプに応じた以下のホストへの接続
- クラウドインスタンスの場合
- For on-premises instance: Example: https://<your-domain>:<port>

Manage Engine Service Desk Plusプラグインのサポート

このプラグインは、Service Desk Plus プラットフォーム上で選択した Service Desk Plus プロジェクトのタスクを作成するために使用します。また、タスクの更新やステータスの同期もサポートしています。このプラグインは、クラウド環境とオンプレミス環境の両方のデプロイメントタイプをサポートしています。

データ型	サポート
インシデントでサポートされているアラートの種類	侵害されたクレデンシャル、ポリシー、マルサイト、マルウェア、DLP、セキュリティ評価、ウォッチリスト、検疫、修復、UBA、CTEP、デバイス、コンテンツ
インシデントでサポートされているイベントタイプ	エンドポイント、インシデント
Cloud Exchangeプラグインでサポートされているアラートの種類	情報、警告、エラー

マッピング

キューマッピング

対象分野	Values
タイトルのカスタムメッセージのデフォルトマッピングフィールド	Netskope $appCategory アラート名: $alertName、イベント名: $alert_name
デスクリプションのカスタムメッセージ用にデフォルトでマップされるフィールド	アラート/イベントID: $idAlert/Event アプリ: $appAlert/Event ユーザー: $user アラート名: $alertNameAlert タイプ: $alertTypeAlert アプリカテゴリ: $appCategory イベント名: $alert_nameEvent タイプ: $eventType

ステータスマッピング

以下は、プラグイン設定に追加されたデフォルトのマッピングです。Cloud Exchange のマッピングは、Service Desk プラットフォームで利用可能なマッピングに基づいて調整できます。

Netskope CE Fields	エンジンサービスデスクプラスのステータスを管理
新しい	新しい
進行中	進行中
保留中	保留中
Closed	Closed
Deleted	（デフォルトは空白になりますユーザーは、マッピングするカスタムステータスをManage Engineプロジェクトで作成できます）
その他	（デフォルトは空白になりますユーザーは、マッピングするカスタムステータスをManage Engineプロジェクトで作成できます）

注記

Manage Engineプラグインのデフォルトステータスは、プラットフォーム内でこれらのフィールドをカスタマイズできるため、異なる場合があります。対応するNetskope CEフィールドにマッピングされていないステータスはすべて「その他」としてマークされます。

権限

クラウドインスタンスの場合：

Module	Permission	範囲
Project	作成、読む、更新	SDPOnDemand.projects.CREATE、SDPOnDemand.projects.参照、SDPOnDemand.projects.UPDATE
Setup	READ	SDPOnDemand.setup.READ
ユーザー	READ	SDPOnDemand.users.READ
一般的な	READ	SDPOnDemand.general.READ

オンプレミスインスタンスの場合：'SDAdmin'ロール（つまり、管理者に割り当てられたロール）を使用して認証トークンを生成します。

APIの詳細

使うAPI一覧

APIエンドポイント	方法	使うケース
{region_url}/oauth/v2/token	役職	アクセストークンを生成および再生成する
/api/v3/portals	得る	Service Desk Plusからすべてのポータルを取得します（検証用）
/api/v3/projects	得る	Service Desk Plusからすべてのプロジェクトを取得します（キュー用）。
/api/v3/projects/ {project_id}/tasks	役職	Service Desk Plusでタスクを作成する
/api/v3/users	得る	Service Desk Plus 上のすべてのユーザーを取得します
/api/v3/tasks	得る	Service Desk Plusで作成されたタスクを取得します。
/api/v3/projects/ {project_id}/tasks/{task_id}/comments	役職	タスクにコメントを追加する（重複排除ワークフロー）
/api/v3/projects/ {project_id}/tasks/{task_id}	PUT	タスクの更新

アクセストークンの生成と再生成

API Endpoint: {region_url}/oauth/v2/token

Method: 役職

Headers:

鍵	Value
Content-Type	application/x-www-form-urlencoded

Body Parameters (For Generating access and refresh token)

鍵	Value
code	<auth_code>
grant_type	authorization_code
client_id	<client_id>
client_secret	<client_secret>

Body Parameters (For Regenerating access token)

鍵	Value
refresh_token	<refresh_token>
grant_type	refresh_token
client_id	<client_id>
client_secret	<client_secret>

Sample Response:

Generating Access Token

{
    "access_token": "1000.XXXX02a3d3152753a9626ef066ddXXXX.XXXX55ff6d4c4d42642342fb77c1XXXX",
    "refresh_token": "1000.XXXX05dafbe43b0c6fcf3cde3a1fXXXX.XXXXeae4f4b8d4f3495bc834f7aeXXXX",
    "scope": "SDPOnDemand.projects.CREATE, SDPOnDemand.projects.READ, SDPOnDemand.projects.UPDATE, SDPOnDemand.setup.READ, SDPOnDemand.users.READ, SDPOnDemand.general.READ",
    "api_domain": "https://www.zohoapis.in",
    "token_type": "Bearer",
    "expires_in": 3600
}

Regenerating Access Token

{
    "access_token": "1000.XXXX93dc236b0867dad58ecb1b51XXXX.XXXX5b790d283c0ce71b6e12811bXXXX",
    "scope": "SDPOnDemand.projects.CREATE, SDPOnDemand.projects.READ, SDPOnDemand.projects.UPDATE, SDPOnDemand.setup.READ, SDPOnDemand.users.READ, SDPOnDemand.general.READ",
    "api_domain": "https://www.zohoapis.in",
    "token_type": "Bearer",
    "expires_in": 3600
}

すべてのポータルを取得

API Endpoint: /api/v3/portals

Method：得る

Headers:

クラウド向け：

鍵	Value
Accept	application/vnd.manageengine.sdp.v3+json
Authorization	Zoho-oauthtoken <access_token>
Content-Type	application/x-www-form-urlencoded

オンプレミスの場合：

鍵	Value
Accept	application/vnd.manageengine.sdp.v3+json
authtoken	<auth_token>
Content-Type	application/x-www-form-urlencoded

Query Parameter

鍵	Value
input_data	{ “list_info”: { “row_count”: “1000”, “start_index”: “1”, “page”: 1, “sort_field”: “created_time”, “sort_order”: “desc” } }

Sample Response:

クラウド向け：

{
    "response_status": [
        {
            "status_code": 2000,
            "status": "success"
        }
    ],
    "portals": [
        {
            "owner": {
                "owner_name": "XYZ",
                "email": "xyz@example.com"
            },
            "is_payload_encryption_enabled": false,
            "start_day_of_week": "SUNDAY",
            "department_type": "ITDESK",
            "logo_url": "https://static.zohocdn.com/sdpondemand/images/it-helpdesk-icon.39a0efae98258a4dea4060897fb71fa6.png",
            "timezone": "Asia/Kolkata",
            "description": "",
            "view_type": "SDP",
            "display_name": "TestPortal",
            "portal_type": "LIVE",
            "is_default": true,
            "is_global_config_mobile": false,
            "app_context": "itdesk",
            "scope": "CLOSED",
            "name": "itdesk",
            "zaid": "60042069058",
            "id": "60042069257",
            "is_msp": false,
            "is_custom_url_default": true,
            "status": "PUBLISHED"
        },
        {
            "owner": {
                "owner_name": "XYZ",
                "email": "xyz@example.com"
            },
            "is_payload_encryption_enabled": false,
            "start_day_of_week": "SUNDAY",
            "department_type": "FACILITY",
            "logo_url": "https://static.zohocdn.com/sdpondemand/images/facilities-desk-icon.2018442fc13879bd1994143dc5a3f6d9.png",
            "timezone": "Asia/Kolkata",
            "description": "",
            "view_type": "SDP",
            "display_name": "NetskopeCloudExchange",
            "portal_type": "LIVE",
            "is_default": false,
            "is_global_config_mobile": false,
            "app_context": "netskopece",
            "scope": "PUBLIC",
            "name": "netskopece",
            "zaid": "60042069058",
            "id": "60042208344",
            "is_msp": false,
            "is_custom_url_default": true,
            "status": "PUBLISHED"
        }
    ],
    "list_info": {
        "has_more_rows": false,
        "row_count": 2
    }
}

オンプレミスの場合：

{
    "response_status": [
        {
            "status_code": 2000,
            "status": "success"
        }
    ],
    "portals": [
        {
            "alias_url": "itdesk",
            "logo_url": {
                "content-url": "/api/v3/portals/1/images/172",
                "id": "172"
            },
            "description": "Helpdesk to manage all IT support",
            "owners": [
                {
                    "name": "administrator",
                    "id": 5
                }
            ],
            "type": {
                "internal_name": "IT",
                "name": "IT",
                "id": "1"
            },
            "is_default": false,
            "internalname": "IT Helpdesk",
            "license_details": {
                "name": "ServiceDesk",
                "edition": "Standard",
                "no_of_techs": "5"
            },
            "image_token": "535088e1e5cf9860e5305ad154949d3ee448e132655cf55ecc1d77bb3dbb7296b14501be7a0f570d654110fcd1efa18cff6ea60a",
            "name": "IT Helpdesk",
            "id": "1",
            "status": {
                "internal_name": "Production",
                "name": "Production",
                "id": "1"
            }
        },
        {
            "alias_url": "netskopece",
            "logo_url": {
                "content-url": "/api/v3/portals/2/images/100000057",
                "id": "100000057"
            },
            "description": "",
            "owners": [
                {
                    "name": "administrator",
                    "id": 5
                }
            ],
            "type": {
                "internal_name": "Blank",
                "name": "Blank",
                "id": "4"
            },
            "is_default": false,
            "internalname": "NetskopeCEPlugins",
            "license_details": {
                "name": "ServiceDesk_2",
                "edition": "Enterprise",
                "no_of_techs": "2"
            },
            "image_token": "d6ece5c0003c55b8d5ea260545a6ab94dd7d5f35014ad05d794fcfd8c98e2d3abe01e37ddbd6c37f0a0fb9fb27e78683b82dbca6",
            "name": "NetskopeCEPlugins",
            "id": "2",
            "status": {
                "internal_name": "Pre-Production",
                "name": "Pre-Production",
                "id": "2"
            }
        },
        {
            "alias_url": "third",
            "logo_url": {
                "content-url": "/api/v3/portals/3/images/200000229",
                "id": "200000229"
            },
            "description": "",
            "owners": [
                {
                    "name": "administrator",
                    "id": 5
                }
            ],
            "type": {
                "internal_name": "Facilities",
                "name": "Facilities",
                "id": "3"
            },
            "is_default": false,
            "internalname": "Thirdinstance",
            "license_details": {
                "name": "ServiceDesk_1",
                "edition": "Enterprise",
                "no_of_techs": "2"
            },
            "image_token": "1367b3fdfcfa53b4834bf13b9a4633c02178185740ecf98a6c38101b24940cdea252e2a43f60de479b9fc9b87c8c78872f775172",
            "name": "Thirdinstance",
            "id": "3",
            "status": {
                "internal_name": "New",
                "name": "New",
                "id": "4"
            }
        }
    ],
    "list_info": {
        "has_more_rows": false,
        "start_index": 1,
        "row_count": 3
    }
}

すべてのプロジェクトを取得

API Endpoints:

Cloud: /app/<portal>/api/v3/projects
On-Premises: /api/v3/projects

Method: 得る

Headers:

クラウド向け：

鍵	Value
Accept	application/vnd.manageengine.sdp.v3+json
Authorization	Zoho-oauthtoken <access_token>
Content-Type	application/x-www-form-urlencoded

オンプレミスの場合：

鍵	Value
Accept	application/vnd.manageengine.sdp.v3+json
authtoken	<auth_token>
Content-Type	application/x-www-form-urlencoded

Path Parameters:

鍵	Value	デプロイメントタイプ	デスクリプション
portal	<portal_url>	雲	クラウド展開タイプの構成パラメータで指定されたポータルのURL名。

Query Parameters:

鍵	Value	デプロイメントタイプ	デスクリプション
input_data	{ “list_info”: { “row_count”: “1000”, “start_index”: “1”, “page”: 1, “sort_field”: “created_time”, “sort_order”: “desc”, } }	クラウドとオンプレミス	–
PORTALID	<portal_id>	On-Premises	設定で指定されたポータルのID

Sample Response

クラウド向け：

{
    "projects": [
        {
            "template": {
                "inactive": false,
                "name": "Default Project Template",
                "id": "20901000000103039"
            },
            "percentage_completion": null,
            "display_id": {
                "display_value": "PJT-6",
                "value": "6"
            },
            "description": "Sample Project",
            "title": "Sample Project",
            "actual_hours": null,
            "actual_end_time": null,
            "id": "20901000000296001",
            "actual_start_time": null,
            "department": null,
            "owner": null,
            "project_type": null,
            "created_time": {
                "display_value": "Jun 10, 2025 04:20 PM",
                "value": "1749552614654"
            },
            "project_code": null,
            "priority": null,
            "created_by": {
                "email_id": "xyz@example.com",
                "is_technician": true,
                "sms_mail": null,
                "mobile": null,
                "last_name": "Xyz",
                "user_scope": "internal_user",
                "sms_mail_id": null,
                "cost_per_hour": "0",
                "site": {
                    "deleted": false,
                    "name": "Base Site",
                    "id": "20901000000153001",
                    "is_default": true
                },
                "phone": "1234567890",
                "employee_id": null,
                "name": "Xyz Xyz",
                "id": "20901000000272327",
                "photo_url": "https://profile.zoho.in/file?exp=10&ID=60042069059&t=user&height=60&width=60",
                "is_vip_user": true,
                "department": null,
                "first_name": "Xyz",
                "job_title": null
            },
            "scheduled_end_time": null,
            "site": {
                "deleted": false,
                "name": "Base Site",
                "id": "20901000000153001",
                "is_default": true
            },
            "actual_cost": null,
            "project_requester": null,
            "estimated_cost": null,
            "estimated_hours": null,
            "projected_end": null,
            "status": {
                "in_progress": true,
                "internal_name": "Open",
                "color": "#0066ff",
                "name": "Open",
                "id": "20901000000005146"
            },
            "scheduled_start_time": null
        }
    ],
    "response_status": [
        {
            "status_code": 2000,
            "status": "success"
        }
    ],
    "list_info": {
        "has_more_rows": true,
        "start_index": 1,
        "sort_field": "created_time",
        "page": 1,
        "sort_order": "desc",
        "row_count": 1
    }
}

オンプレミスの場合：

{
    "projects": [
        {
            "requester": null,
            "owner": null,
            "template": null,
            "created_time": {
                "display_value": "Jun 10, 2025 05:33 PM",
                "value": "1749557021886"
            },
            "code": null,
            "has_attachments": false,
            "title": "New project",
            "priority": null,
            "type": null,
            "created_by": {
                "email_id": null,
                "phone": "1234455",
                "name": "administrator",
                "mobile": "1234567890",
                "profile_pic": {
                    "content-url": "/images/default-profile-pic2.svg"
                },
                "is_vipuser": false,
                "id": "5",
                "department": null
            },
            "scheduled_end_time": null,
            "site": null,
            "actual_hours": null,
            "actual_cost": "0.00",
            "estimated_cost": "0.00",
            "actual_end_time": null,
            "estimated_hours": null,
            "id": "1",
            "actual_start_time": null,
            "department": null,
            "projected_end_time": null,
            "status": {
                "color": "#0066ff",
                "name": "Open",
                "id": "1"
            },
            "scheduled_start_time": null
        }
    ],
    "response_status": [
        {
            "status_code": 2000,
            "status": "success"
        }
    ],
    "list_info": {
        "has_more_rows": false,
        "start_index": 1,
        "sort_field": "created_time",
        "page": 1,
        "sort_order": "desc",
        "row_count": 1
    }
}

Create a Task

API Endpoint:

Cloud: /app/<portal>/api/v3/projects/{project_id}/tasks
On-Premises: /api/v3/projects/ {project_id}/tasks

Method: 役職

Headers:

クラウド向け：

鍵	Value
Accept	application/vnd.manageengine.sdp.v3+json
Authorization	Zoho-oauthtoken <access_token>
Content-Type	application/x-www-form-urlencoded

オンプレミス向け

鍵	Value
Accept	application/vnd.manageengine.sdp.v3+json
authtoken	<auth_token>
Content-Type	application/x-www-form-urlencoded

Path Parameters:

鍵	Value	デプロイメントタイプ	デスクリプション
portal	<portal_url>	雲	クラウド展開タイプの構成パラメータで指定されたポータルのURL名。

Query Parameters:

鍵	Value	デプロイメントタイプ	デスクリプション
PORTALID	<portal_id>	On-Premises	設定で指定されたポータルのID。

Request Body:

鍵	デプロイメントタイプ	Value
input_data	雲	{ 「タスク」:{ 「percentage_completion」:「30」「estimated_effort_hours」:「20」、「email_before」:「3600000」「デスクリプション」:「SRSには機能のすべての要件が含まれていなければならない」「タイトル」:「SRSを作成」「additional_cost」:「100」「actual_end_time」:{ 「価値」:「1512974940000」 }, 「actual_start_time」:{ 「価値」:「1421988300000」 }, 「オーナー」:{ 「名前」:「リンカーン」 }, 「優先度」:{ 「名前」:「ハイ」 }, 「scheduled_end_time」:{ 「価値」:「1512974940000」 }, 「estimated_effort_minutes」:「45」「estimated_effort_days」:「15」、「task_type」:{ 「名前」:「実装」 }, 「scheduled_start_time」:{ 「価値」:「1421988300000」 }, 「ステータス」:{ 「名前」:「開いている」 } } }
input_data	On-Premises	{ “task”: { “percentage_completion”: “30”, “email_before”: “3600000”, } “デスクリプション”: “SRSには、機能のすべての要件が含まれている必要があります”, “title”: “SRSの作成”, “additional_cost”: “100”, “actual_end_time”: { “value”: “1512974940000” }, “actual_start_time”: { “value”: “1421988300000” }, “owner”: { “name”: “Lincoln” }, 「優先度」: { 「名前」: 「高」 }, 「予定終了時刻」: { 「値」: 「1512974940000」 }, 「推定労力」: { 「日数」: 「15」, 「時間」: 「16」, 「分」: 「45」 }, 「タスクタイプ」: { 「名前」: 「実装」 }, 「予定開始時刻」: { 「値」: 「1421988300000」 }, 「ステータス」: { 「名前」: 「開く」 } } }

Sample Response:

クラウド向け：

{
    "task": {
        "template": {
            "inactive": false,
            "name": "Default Task",
            "id": "20901000000237005"
        },
        "percentage_completion": null,
        "estimated_effort_hours": null,
        "attachments": [],
        "email_before": "0",
        "description": "Postman 1 PJT 6",
        "project": {
            "template": {
                "inactive": false,
                "name": "Default Project Template",
                "id": "20901000000103039"
            },
            "percentage_completion": null,
            "attachments": [],
            "display_id": {
                "display_value": "PJT-6",
                "value": "6"
            },
            "description": "The SRS must contain all the requirements for the feature",
            "title": "Create SRS",
            "actual_hours": null,
            "actual_end_time": null,
            "id": "20901000000296001",
            "actual_start_time": null,
            "department": null,
            "owner": null,
            "project_type": null,
            "created_time": {
                "display_value": "Jun 10, 2025 04:20 PM",
                "value": "1749552614654"
            },
            "project_code": null,
            "priority": null,
            "created_by": {
                "email_id": "XYZ@example.com",
                "is_technician": true,
                "sms_mail": null,
                "mobile": null,
                "last_name": "XYZ",
                "user_scope": "internal_user",
                "sms_mail_id": null,
                "cost_per_hour": "0",
                "site": {
                    "deleted": false,
                    "name": "Base Site",
                    "id": "20901000000153001",
                    "is_default": true
                },
                "phone": "1234567890",
                "employee_id": null,
                "name": "XYZ XYZ",
                "id": "20901000000272327",
                "photo_url": "https://profile.zoho.in/file?exp=10&ID=60042069059&t=user&height=60&width=60",
                "is_vip_user": true,
                "department": null,
                "first_name": "XYZ",
                "job_title": null
            },
            "scheduled_end_time": null,
            "site": {
                "deleted": false,
                "name": "Base Site",
                "id": "20901000000153001",
                "is_default": true
            },
            "actual_cost": null,
            "project_requester": null,
            "estimated_cost": null,
            "estimated_hours": null,
            "projected_end": null,
            "deleted_time": null,
            "status": {
                "in_progress": true,
                "internal_name": "Open",
                "color": "#0066ff",
                "name": "Open",
                "id": "20901000000005146"
            },
            "scheduled_start_time": null
        },
        "title": "SRS Project",
        "marked_technician": null,
        "overdue": false,
        "additional_cost": null,
        "actual_end_time": null,
        "id": "20901000000301015",
        "actual_start_time": null,
        "owner": null,
        "associated_entity": "project",
        "module": "Project",
        "index": 5,
        "priority": null,
        "created_by": {
            "email_id": "XYZ@example.com",
            "is_technician": true,
            "sms_mail": null,
            "mobile": null,
            "last_name": "XYZ",
            "user_scope": "internal_user",
            "sms_mail_id": null,
            "cost_per_hour": "0",
            "site": {
                "deleted": false,
                "name": "Base Site",
                "id": "20901000000153001",
                "is_default": true
            },
            "phone": "1234567890",
            "employee_id": null,
            "name": "XYZ XYZ",
            "id": "20901000000272327",
            "photo_url": "https://profile.zoho.in/file?exp=10&ID=60042069059&t=user&height=60&width=60",
            "is_vip_user": true,
            "department": null,
            "first_name": "XYZ",
            "job_title": null
        },
        "scheduled_end_time": null,
        "site": {
            "deleted": false,
            "name": "Base Site",
            "id": "20901000000153001",
            "is_default": true
        },
        "estimated_effort_minutes": null,
        "deleted": false,
        "estimated_effort": null,
        "created_date": {
            "display_value": "Jun 11, 2025 05:19 PM",
            "value": "1749642541951"
        },
        "estimated_effort_days": null,
        "task_type": null,
        "scheduled_start_time": null,
        "status": {
            "in_progress": true,
            "internal_name": "Open",
            "stop_timer": false,
            "color": "#0066ff",
            "name": "Open",
            "id": "20901000000004865"
        }
    },
    "response_status": {
        "status_code": 2000,
        "status": "success"
    }
}

オンプレミスの場合：

{
    "task": {
        "template": null,
        "percentage_completion": 0,
        "attachments": [],
        "email_before": "0",
        "project": {
            "id": "1",
            "title": "SRS Project"
        },
        "description": "The SRS must contain all the requirements for the feature",
        "title": "Create SRS",
        "type": null,
        "overdue": false,
        "additional_cost": "0.00",
        "actual_end_time": null,
        "id": "5",
        "actual_start_time": null,
        "owner": null,
        "created_time": {
            "display_value": "Jun 11, 2025 04:36 PM",
            "value": "1749639970914"
        },
        "has_attachments": false,
        "associated_entity": "project",
        "index": "-1",
        "priority": null,
        "created_by": {
            "email_id": null,
            "phone": "1234455",
            "name": "administrator",
            "mobile": "1234567890",
            "profile_pic": {
                "content-url": "/images/default-profile-pic2.svg"
            },
            "is_vipuser": false,
            "id": "5",
            "department": null
        },
        "due_by_time": null,
        "scheduled_end_time": null,
        "tags": [],
        "marked_owner": null,
        "site": null,
        "estimated_effort": {
            "display_value": "-",
            "hours": "0",
            "minutes": "0",
            "days": "0"
        },
        "image_token": "3487225cf0ece41728a3cbdd0dd87928df2228254fd920e0aec96205d264afa9ce8155f37358a5b29359d3cc008a0f51223a680c",
        "scheduled_start_time": null,
        "status": {
            "color": "#0066ff",
            "name": "Open",
            "id": "2"
        }
    },
    "response_status": {
        "status_code": 2000,
        "status": "success"
    }
}

すべてのユーザーを取得

API Endpoints:

Cloud: /app/<portal>/api/v3/users
On-Premises: /api/v3/users

Method: 役職

Headers:

クラウド向け：

鍵	Value
Accept	application/vnd.manageengine.sdp.v3+json
Authorization	Zoho-oauthtoken <access_token>
Content-Type	application/x-www-form-urlencoded

オンプレミスの場合：

鍵	Value
Accept	application/vnd.manageengine.sdp.v3+json
authtoken	<auth_token>
Content-Type	application/x-www-form-urlencoded

Path Parameters:

Key	Value	Deployment Type	Description
portal	<portal_url>	雲	クラウド展開タイプの構成パラメータで指定されたポータルのURL名。

Query Parameters:

Key	Value	Deployment Type	Description
input_data	{ “list_info”: { “row_count”: “1000”, “start_index”: “1”, “sort_field”: “created_time”, “sort_order”: “desc” } }	クラウドとオンプレミス	–
PORTALID	<portal_id>	On-Premises	設定で指定されたポータルのID

Sample response

クラウド向け：

{
    "response_status": [
        {
            "status_code": 2000,
            "status": "success"
        }
    ],
    "list_info": {
        "has_more_rows": false,
        "start_index": 1,
        "sort_field": "created_time",
        "page": 1,
        "sort_order": "desc",
        "row_count": 1
    },
    "users": [
        {
            "email_id": "abc.xyz@example.com",
            "sms_mail": null,
            "reporting_to": null,
            "cost_per_hour": "0",
            "id": "20901000000302003",
            "photo_url": "https://profile.zoho.in/file?exp=10&ID=-1&t=user&height=60&width=60",
            "is_vip_user": false,
            "department": null,
            "first_name": "abc",
            "job_title": null,
            "is_technician": true,
            "created_time": {
                "display_value": "Jun 10, 2025 08:24 PM",
                "value": "1749567294459"
            },
            "mobile": null,
            "last_name": null,
            "user_scope": "internal_user",
            "sms_mail_id": null,
            "site": {
                "deleted": false,
                "name": "Base Site",
                "id": "20901000000153001",
                "is_default": true
            },
            "phone": null,
            "employee_id": null,
            "name": "abc"
        }
    ]
}

オンプレミスの場合：

{
    "response_status": [
        {
            "status_code": 2000,
            "status": "success"
        }
    ],
    "list_info": {
        "has_more_rows": true,
        "start_index": 1,
        "sort_field": "created_time",
        "page": 1,
        "sort_order": "desc",
        "row_count": 1
    },
    "users": [
        {
            "email_id": "abc.xyz@example.com",
            "extension": null,
            "description": "-",
            "is_vipuser": true,
            "reporting_to": null,
            "type": "User",
            "citype": {
                "name": "User",
                "id": 3
            },
            "cost_per_hour": "0.00",
            "can_generate_authtoken": true,
            "org_user_status": "ACTIVE",
            "id": "14",
            "department": null,
            "first_name": "ABC",
            "created_time": {
                "display_value": "Jun 11, 2025 10:45 AM",
                "value": "1749618957092"
            },
            "is_technician": false,
            "jobtitle": null,
            "mobile": null,
            "profile_pic": {
                "content-url": "/images/default-profile-pic2.svg"
            },
            "project_roles": null,
            "last_name": "XYZ",
            "sms_mail_id": null,
            "middle_name": null,
            "created_by": {
                "email_id": null,
                "phone": "1234455",
                "name": "administrator",
                "mobile": "1234567890",
                "profile_pic": {
                    "content-url": "/images/default-profile-pic2.svg"
                },
                "is_vipuser": false,
                "id": "5",
                "department": null
            },
            "ciid": "24",
            "login_name": "abcxyz",
            "requester_allowed_to_view": 4,
            "phone": null,
            "sip_user": null,
            "employee_id": null,
            "domain": null,
            "name": "ABC XYZ",
            "enable_telephony": false,
            "status": "ACTIVE"
        }
    ]
}

Fetch Tasks

API Endpoints:

Cloud: /app/<portal>/api/v3/users
On-Premises: /api/v3/users

Method: 役職

Headers:

クラウド向け

鍵	Value
Accept	application/vnd.manageengine.sdp.v3+json
Authorization	Zoho-oauthtoken <access_token>
Content-Type	application/x-www-form-urlencoded

オンプレミス向け

鍵	Value
Accept	application/vnd.manageengine.sdp.v3+json
authtoken	<auth_token>
Content-Type	application/x-www-form-urlencoded

Path Parameters:

鍵	Value	デプロイメントタイプ	デスクリプション
portal	<portal_url>	雲	クラウド展開タイプの構成パラメータで指定されたポータルのURL名。

Query Parameters:

鍵	Value	デプロイメントタイプ	デスクリプション
input_data	{ “list_info”: { “row_count”: “100”, “search_criteria”: [ { “field”: “id”, “values”: [ “3”, “6” ], “condition”: “is” } ], “page”: 1, “start_index”: “1”, “sort_field”: “created_time”, “sort_order”: “desc” } }	クラウドとオンプレミス	–
PORTALID	<portal_id>	On-Premises	設定で指定されたポータルのID

Sample response

クラウド向け：

{
    "response_status": [
        {
            "status_code": 2000,
            "status": "success"
        }
    ],
    "list_info": {
        "has_more_rows": false,
        "start_index": 1,
        "sort_field": "created_time",
        "page": 1,
        "sort_order": "desc",
        "search_criteria": [
            {
                "condition": "is",
                "field": "id",
                "values": [
                    "20901000000301015",
                    "20901000000299001"
                ]
            }
        ],
        "row_count": 1
    },
    "tasks": [
        {
            "template": {
                "inactive": false,
                "name": "Default Task",
                "id": "20901000000237005"
            },
            "percentage_completion": null,
            "estimated_effort_hours": null,
            "email_before": "0",
            "description": "task 1",
            "project": {
                "display_id": {
                    "display_value": "PJT-6",
                    "value": "6"
                },
                "project_code": null,
                "id": "20901000000296001",
                "title": "project created via API"
            },
            "title": "Task 1",
            "marked_technician": null,
            "overdue": false,
            "additional_cost": null,
            "actual_end_time": null,
            "id": "20901000000299001",
            "actual_start_time": null,
            "owner": null,
            "associated_entity": "project",
            "module": "Project",
            "index": 4,
            "priority": null,
            "created_by": {
                "email_id": "XYZ.ABC@crestdata.ai",
                "is_technician": true,
                "sms_mail": null,
                "mobile": null,
                "last_name": "ABC",
                "user_scope": "internal_user",
                "sms_mail_id": null,
                "cost_per_hour": "0",
                "site": {
                    "deleted": false,
                    "name": "Base Site",
                    "id": "20901000000153001",
                    "is_default": true
                },
                "phone": "1234567890",
                "employee_id": null,
                "name": "ABC XYZ",
                "id": "20901000000272327",
                "photo_url": "https://profile.zoho.in/file?exp=10&ID=60042069059&t=user&height=60&width=60",
                "is_vip_user": true,
                "department": null,
                "first_name": "ABC",
                "job_title": null
            },
            "scheduled_end_time": null,
            "site": {
                "deleted": false,
                "name": "Base Site",
                "id": "20901000000153001",
                "is_default": true
            },
            "estimated_effort_minutes": null,
            "deleted": false,
            "estimated_effort": null,
            "created_date": {
                "display_value": "Jun 10, 2025 06:13 PM",
                "value": "1749559419951"
            },
            "estimated_effort_days": null,
            "task_type": null,
            "scheduled_start_time": null,
            "status": {
                "in_progress": true,
                "internal_name": "Open",
                "stop_timer": false,
                "color": "#0066ff",
                "name": "Open",
                "id": "20901000000004865"
            }
        }
    ]
}

オンプレミスの場合：

{
    "response_status": [
        {
            "status_code": 2000,
            "status": "success"
        }
    ],
    "list_info": {
        "has_more_rows": false,
        "start_index": 1,
        "sort_field": "created_time",
        "page": 1,
        "start_count": 1,
        "sort_order": "desc",
        "search_criteria": [
            {
                "condition": "is",
                "field": "id",
                "values": [
                    "3"
                ]
            }
        ],
        "row_count": 1
    },
    "tasks": [
        {
            "template": null,
            "percentage_completion": 0,
            "email_before": "0",
            "project": {
                "id": "1",
                "title": "New project"
            },
            "title": "task 1",
            "type": null,
            "overdue": false,
            "additional_cost": "0.00",
            "actual_end_time": null,
            "id": "6",
            "actual_start_time": null,
            "group": null,
            "owner": null,
            "created_time": {
                "display_value": "Jun 11, 2025 06:13 PM",
                "value": "1749645804615"
            },
            "has_attachments": false,
            "associated_entity": "project",
            "priority": null,
            "created_by": {
                "email_id": null,
                "phone": "1234455",
                "name": "administrator",
                "mobile": "1234567890",
                "profile_pic": {
                    "content-url": "/images/default-profile-pic2.svg"
                },
                "is_vipuser": false,
                "id": "5",
                "department": null
            },
            "due_by_time": null,
            "scheduled_end_time": null,
            "marked_owner": null,
            "marked_group": null,
            "site": null,
            "estimated_effort": {
                "display_value": "-",
                "hours": "0",
                "minutes": "0",
                "days": "0"
            },
            "scheduled_start_time": null,
            "status": {
                "color": "#0066ff",
                "name": "Open",
                "id": "2"
            }
        }
    ]
}

タスクにコメントを追加する

API Endpoints:

Cloud: /app/<portal>/api/v3/projects/{project_id}/tasks/{task_id}/comments
On-Premises: /api/v3/projects/ {project_id}/tasks/{task_id}/comments

Method: 役職

Headers:

クラウド向け：

鍵	Value
Accept	application/vnd.manageengine.sdp.v3+json
Authorization	Zoho-oauthtoken <access_token>
Content-Type	application/x-www-form-urlencoded

オンプレミスの場合：

鍵	Value
Accept	application/vnd.manageengine.sdp.v3+json
authtoken	<auth_token>
Content-Type	application/x-www-form-urlencoded

Path Parameters:

鍵	Value	デプロイメントタイプ	デスクリプション
portal	<portal_url>	雲	クラウド展開タイプの構成パラメータで指定されたポータルのURL名。

Query Parameters:

鍵	Value	デプロイメントタイプ	デスクリプション
PORTALID	<portal_id>	On-Premises	設定で指定されたポータルのID。

Request Body:

鍵	デプロイメントタイプ	Value
input_data	雲	{ “task_comment”: { “comment”: “タスクへのコメント” } }
input_data	On-Premises	{ “コメント”: { “コンテンツ”: “タスク内のコメント” } }

Sample Response

クラウド向け：

{
    "task_comment": {
        "parent_comment": null,
        "created_time": {
            "display_value": "Jun 11, 2025 05:20 PM",
            "value": "1749642604093"
        },
        "task": {
            "id": "20901000000301015",
            "created_date": {
                "display_value": "Jun 11, 2025 05:19 PM",
                "value": "1749642541951"
            },
            "title": "Postman 1 PJT 6"
        },
        "last_updated_time": null,
        "comment": "Comment in task",
        "id": "20901000000301027",
        "created_by": {
            "email_id": "XYZ@example.com",
            "is_technician": true,
            "sms_mail": null,
            "mobile": null,
            "last_name": "XYZ",
            "user_scope": "internal_user",
            "sms_mail_id": null,
            "cost_per_hour": "0",
            "site": {
                "deleted": false,
                "name": "Base Site",
                "id": "20901000000153001",
                "is_default": true
            },
            "phone": "1234567890",
            "employee_id": null,
            "name": "XYZ",
            "id": "20901000000272327",
            "photo_url": "https://profile.zoho.in/file?exp=10&ID=60042069059&t=user&height=60&width=60",
            "is_vip_user": true,
            "department": null,
            "first_name": "XYZ",
            "job_title": null
        }
    },
    "response_status": {
        "status_code": 2000,
        "status": "success"
    }
}

オンプレミスの場合：

{
    "response_status": {
        "status_code": 2000,
        "status": "success"
    },
    "comment": {
        "parent": null,
        "created_time": {
            "display_value": "Jun 11, 2025 04:34 PM",
            "value": "1749639889902"
        },
        "image_token": "e192a23d446d29cbff9a643d59576143b828dc406cc30c6452f9ac3f428b815a08c3ced67c3e27f34d43c79f729dd650238ced46",
        "id": "4",
        "reply_count": 0,
        "created_by": {
            "email_id": null,
            "phone": "1234455",
            "name": "administrator",
            "mobile": "1234567890",
            "profile_pic": {
                "content-url": "/images/default-profile-pic2.svg"
            },
            "is_vipuser": false,
            "id": "5",
            "department": null
        },
        "content": "Comment in task"
    }
}

タスクを更新する

API Endpoints:

Cloud: /app/<portal>/api/v3/projects/{project_id}/tasks/{task_id}
On-Premises: /api/v3/projects/ {project_id}/tasks/{task_id}

Method: PUT

Headers:

クラウド向け：

鍵	Value
Accept	application/vnd.manageengine.sdp.v3+json
Authorization	Zoho-oauthtoken <access_token>
Content-Type	application/x-www-form-urlencoded

オンプレミスの場合：

鍵	Value
Accept	application/vnd.manageengine.sdp.v3+json
authtoken	<auth_token>
Content-Type	application/x-www-form-urlencoded

Path Parameters:

鍵	Value	デプロイメントタイプ	デスクリプション
portal	<portal_url>	雲	クラウド展開タイプの構成パラメータで指定されたポータルのURL名。

Query Parameters:

鍵	Value	デプロイメントタイプ	デスクリプション
PORTALID	<portal_id>	On-Premises	設定で指定されたポータルのID。

Request Body:

鍵	デプロイメントタイプ	Value
input_data	雲	{ 「タスク」:{ 「percentage_completion」:「30」「estimated_effort_hours」:「20」、「email_before」:「3600000」「デスクリプション」:「SRSには機能のすべての要件が含まれていなければならない」「タイトル」:「SRSを作成」「additional_cost」:「100」「actual_end_time」:{ 「価値」:「1512974940000」 }, 「actual_start_time」:{ 「価値」:「1421988300000」 }, 「オーナー」:{ 「名前」:「リンカーン」 }, 「優先度」:{ 「名前」:「ハイ」 }, 「scheduled_end_time」:{ 「価値」:「1512974940000」 }, 「estimated_effort_minutes」:「45」「estimated_effort_days」:「15」、「task_type」:{ 「名前」:「実装」 }, 「scheduled_start_time」:{ 「価値」:「1421988300000」 }, 「ステータス」:{ 「名前」:「開いている」 } } }
input_data	On-Premises	{ “task”: { “percentage_completion”: “30”, “email_before”: “3600000”, } “デスクリプション”: “SRSには、機能のすべての要件が含まれている必要があります”, “title”: “SRSの作成”, “additional_cost”: “100”, “actual_end_time”: { “value”: “1512974940000” }, “actual_start_time”: { “value”: “1421988300000” }, “owner”: { “name”: “Lincoln” }, 「優先度」: { 「名前」: 「高」 }, 「予定終了時刻」: { 「値」: 「1512974940000」 }, 「推定労力」: { 「日数」: 「15」, 「時間」: 「16」, 「分」: 「45」 }, 「タスクタイプ」: { 「名前」: 「実装」 }, 「予定開始時刻」: { 「値」: 「1421988300000」 }, 「ステータス」: { 「名前」: 「開く」 } } }

Sample Response

クラウド向け：

{
    "task": {
        "template": {
            "inactive": false,
            "name": "Default Task",
            "id": "20901000000237005"
        },
        "percentage_completion": null,
        "estimated_effort_hours": null,
        "attachments": [],
        "email_before": "0",
        "description": "",
        "project": {
            "template": {
                "inactive": false,
                "name": "Default Project Template",
                "id": "20901000000103039"
            },
            "percentage_completion": null,
            "attachments": [],
            "display_id": {
                "display_value": "PJT-16",
                "value": "16"
            },
            "description": "This Project is created from the Default Project Template.",
            "title": "Test Rate Limit",
            "actual_hours": null,
            "actual_end_time": null,
            "id": "20901000000371009",
            "actual_start_time": null,
            "department": null,
            "owner": null,
            "project_type": null,
            "created_time": {
                "display_value": "Jun 30, 2025 11:30 AM",
                "value": "1751263215568"
            },
            "project_code": "XYZ",
            "priority": null,
            "created_by": {
                "email_id": "XYZ.ABC@example.com",
                "is_technician": true,
                "sms_mail": null,
                "mobile": null,
                "last_name": "ABC",
                "user_scope": "internal_user",
                "sms_mail_id": null,
                "cost_per_hour": "0",
                "site": {
                    "deleted": false,
                    "name": "Base Site",
                    "id": "20901000000153001",
                    "is_default": true
                },
                "phone": "1234567890",
                "employee_id": null,
                "name": "XYZ ABC",
                "id": "20901000000272327",
                "photo_url": "https://profile.zoho.in/file?exp=10&ID=60042069059&t=user&height=60&width=60",
                "is_vip_user": true,
                "department": null,
                "first_name": "XYZ",
                "job_title": null
            },
            "scheduled_end_time": null,
            "site": {
                "deleted": false,
                "name": "Base Site",
                "id": "20901000000153001",
                "is_default": true
            },
            "actual_cost": null,
            "project_requester": null,
            "estimated_cost": null,
            "estimated_hours": null,
            "projected_end": null,
            "deleted_time": null,
            "status": {
                "in_progress": true,
                "internal_name": "Open",
                "color": "#0066ff",
                "name": "Open",
                "id": "20901000000005146"
            },
            "scheduled_start_time": null
        },
        "title": "Renamed task",
        "marked_technician": null,
        "overdue": false,
        "additional_cost": null,
        "actual_end_time": null,
        "id": "20901000000374053",
        "actual_start_time": null,
        "owner": null,
        "associated_entity": "project",
        "module": "Project",
        "index": 5,
        "priority": null,
        "created_by": {
            "email_id": "XYZ.ABC@example.com",
            "is_technician": true,
            "sms_mail": null,
            "mobile": null,
            "last_name": "ABC",
            "user_scope": "internal_user",
            "sms_mail_id": null,
            "cost_per_hour": "0",
            "site": {
                "deleted": false,
                "name": "Base Site",
                "id": "20901000000153001",
                "is_default": true
            },
            "phone": "1234567890",
            "employee_id": null,
            "name": "XYZ ABC",
            "id": "20901000000272327",
            "photo_url": "https://profile.zoho.in/file?exp=10&ID=60042069059&t=user&height=60&width=60",
            "is_vip_user": true,
            "department": null,
            "first_name": "XYZ",
            "job_title": null
        },
        "scheduled_end_time": null,
        "site": {
            "deleted": false,
            "name": "Base Site",
            "id": "20901000000153001",
            "is_default": true
        },
        "estimated_effort_minutes": null,
        "deleted": false,
        "estimated_effort": null,
        "udf_fields": {
            "udf_double1": null,
            "udf_char2": null
        },
        "created_date": {
            "display_value": "Jun 30, 2025 02:46 PM",
            "value": "1751274978109"
        },
        "estimated_effort_days": null,
        "task_type": null,
        "scheduled_start_time": null,
        "status": {
            "in_progress": true,
            "internal_name": "Open",
            "stop_timer": false,
            "color": "#0066ff",
            "name": "Open",
            "id": "20901000000004865"
        }
    },
    "response_status": {
        "status_code": 2000,
        "status": "success"
    }
}

オンプレミスの場合：

{
    "task": {
        "template": null,
        "percentage_completion": 0,
        "attachments": [],
        "email_before": "0",
        "project": {
            "id": "12",
            "title": "Edit Task project"
        },
        "description": "not using query params",
        "title": "Editing task12323",
        "type": null,
        "overdue": false,
        "additional_cost": "0.00",
        "actual_end_time": null,
        "id": "1571",
        "actual_start_time": null,
        "owner": null,
        "created_time": {
            "display_value": "Jun 30, 2025 09:35 PM",
            "value": "1751299555035"
        },
        "has_attachments": false,
        "associated_entity": "project",
        "index": "-1",
        "priority": null,
        "created_by": {
            "email_id": null,
            "phone": "1234455",
            "name": "administrator",
            "mobile": "1234567890",
            "profile_pic": {
                "content-url": "/images/default-profile-pic2.svg"
            },
            "is_vipuser": false,
            "id": "5",
            "department": null
        },
        "due_by_time": null,
        "scheduled_end_time": null,
        "tags": [],
        "marked_owner": null,
        "site": null,
        "estimated_effort": {
            "display_value": "-",
            "hours": "0",
            "minutes": "0",
            "days": "0"
        },
        "image_token": "4264c7d64a47e4cc4c69f206df85f04f14114ca78e65b6319115b70c449744dea69b0d6716c93556820995ae4961d7167945298cc7a42f36e818654df294df9525b1b598",
        "scheduled_start_time": null,
        "status": {
            "color": "#0066ff",
            "name": "Open",
            "id": "2"
        }
    },
    "response_status": {
        "status_code": 2000,
        "status": "success"
    }
}

パフォーマンスマトリックス

以下は、これらの仕様を持つ大型CEスタックで収集された測定値です。

デスクリプション	仕様
スタックの詳細	サイズ：大 RAM：32 GB CPU：16コア
クラウドインスタンスで作成されたタスク	約68枚のチケット/分
オンプレミスインスタンスで作成されたタスク	約60枚のチケット/分

ユーザーエージェント

netskope-ce-5.1.2-cto-manage-engine-service-desk-plus-v1.0.0

ワークフロー

クレデンシャルの認証を取得します。
Manage Engine Service Desk Plusプラグインを設定します。
ビジネスルールを追加します。
キュー設定を追加します。
Manage Engine Service Desk Plusプラグインを検証する

動画を見る

再生ボタンをクリックして動画をご覧ください。

Manage Engine Service Desk Plus から認証クレデンシャルを取得します

クラウドインスタンスの場合

注記

認証クレデンシャルを生成するには、ZOHO開発者コンソールのアクセスが必要です。開発者コンソールについてはこのドキュメントを参照し、地域(データセンター)に基づいて開発者コンソールへのアクセスを得てください。

クライアントID、クライアントシークレット、認証コードを取得してください。

開発者コンソールにログインしてください。

「セルフクライアント」の場合はCreate Nowをクリックし、次にCreateをクリックしてください。

クライアントIDとクライアントシークレットをコピーしてください。

Self Clientの下にある「コード生成」セクションに移動してください。

範囲、持続時間、範囲をデスクリプション指定し、 Createをクリックします。

最低限の範囲:

SDPOnDemand.projects.CREATE、SDPOnDemand.projects.読む、SDPOnDemand.projects.UPDATE、SDPOnDemand.setup.読む、SDPOnDemand.users.読む、SDPOnDemand.general.読む
また、「権限」セクションもご参照ください。

生成されたコードをコピーしてください。それはCloud Exchangeでプラグインを設定する際の認証パラメータの認証コードとして使用されます。

注記

認証コードを生成する際に、選択した期間内にCloud Exchangeでプラグインを設定する必要があります。そうしないと、以下に示すエラーが発生し、その場合は、ウィンドウから認証コードを再生成する必要があります。

URL名を取得する

Manage Engine Service Desk Plusインスタンスにログインし、 ESM Directoryに移動します。

Service Instancesをクリックし、必要なインスタンスの URL 名をコピーしてください。

オンプレミスインスタンスの場合

認証トークンを取得する

オンプレミスインスタンスにログインし、右上隅からユーザープロファイルに移動してください。

Generate Authtokenをクリックしてください。

必要に応じて有効期限を入力し、 Generateをクリックしてください。

生成された認証トークンをコピーしてください。

エイリアスURLを取得する

Manage Engine Service Desk Plusインスタンスにログインし、 ESM Directoryに移動します。

Service Instancesをクリックし、必要なインスタンスのエイリアス URL 名をコピーしてください。

注記

実際のURLをコピーしないでください。例えば、サービスデスクインスタンスが「IT Helpdesk」の場合、エイリアスURLは「itdesk」になります。

Manage Engine Service Desk Plusプラグインの設定

Cloud Exchange で、 Settings > Pluginsに移動します。Manage Engine Service Desk Plus v1.0.0 (CTO)プラグインボックスを検索して選択します。

要件に応じて、構成名と同期間隔を指定してください。

Nextをクリックして、ManageEngine Service Desk Plusインスタンスのデプロイメントタイプを選択してください。

注記

オンプレミスインスタンスの場合は、展開タイプとして「オンプレミス」を選択する必要があります。

Nextをクリックして、インスタンスの認証パラメータを入力してください。クレデンシャルを取得するには、「Manage Engine Service Desk Plus から認証クレデンシャルを取得する」セクションを参照してください。
- クラウドインスタンスの場合：
  - API Domain URL: Manage Engine Service Desk Plus CloudインスタンスのURL。
  - Client ID: Service Desk Plus CloudアカウントのクライアントID。
  - Client Secret: Service Desk Plus Cloudアカウントのクライアントシークレット。
  - Auth Code: Service Desk Plus Cloudアカウントの認証コード。
  - URL Name: サービスデスクプラスポータルのURL名。

オンプレミス環境の場合：
- Service Desk Plus On-Premises Instance URL: Manage Engine Service Desk PlusオンプレミスインスタンスのURL。
- Auth Token: ManageEngine Service Desk Plusオンプレミスアカウントの認証トークン。
- Alias URL: サービスデスクプラスポータルのエイリアスURL。エイリアスURL名のみを指定し、実際のURLは指定しないでください。
- SSL Certificate: Service Desk Plusオンプレミスインスタンス用の自己署名証明書の内容を入力してください。

ご要望に応じて、以下のフィールドのマッピング設定を提供してください。
ステータスマッピングのデフォルトマッピングは以下のとおりです。
Saveをクリックしてください。

Manage Engine Service Desk Plus 用の Ticket Orchestrator ビジネスルールを追加する

Manage Engine Service Desk Plus プラットフォームでタスクを作成するために必要なフィルターに基づいてビジネスルールを作成します。

Ticket OrchestratorでBusiness Rulesに移動します。
Create new ruleをクリックしてください。
テキストボックスに適切なルール名を入力し、ビジネスルールのフィールドに対して適切なフィルタクエリ条件を作成します。Filter Queryを押してクエリを手動で入力することもできます。
Saveをクリックしてください。

Manage Engine Service Desk Plus 用の Ticket Orchestrator キューを追加する

Ticket OrchestratorでQueuesに移動します。
Add Queue Configurationをクリックし、ドロップダウンメニューから「ビジネスルール」、「プラグイン設定」、「キュー」を選択します。
マップフィールドセクションで、アラートとインシデントの間で適切な値を追加/マッピングします。アラートの属性には、カスタムメッセージフィールド内の「$」記号を介してアクセスできます。Add をクリックして、フィールドマッピングを追加してください。

既にアラート/イベントを取得済みの場合、 Saveをクリックしてキューを同期してください。

注記

該当するスキーマ内のフィールドの値を指定する必要があります。
ステータスフィールドのマッピングには、Manage Engine Service Desk Plusのステータス形式で値を指定してください。
Netskopeでインシデントステータスを更新するには、CTO向けのNetskopeプラグインガイドを参照してください。

タスクを作成する際、ステータス、優先度、タスクタイプなどのフィールドは、大文字と小文字を区別します。
時間関連のフィールドでは、タスク作成時にエポックタイム形式（ミリ秒）を指定する必要があります。
所有者などのユーザー関連フィールドは、ユーザーを想定しており、プロジェクトに関連付けられている必要があります。プロジェクトに関連付けられているユーザーを確認するには、[プロジェクト] > [メンバー] に移動してください。こちらに、そのプロジェクトに関連付けられているユーザーのリストが表示されます。
見積もりに関連する項目では、小数点以下の値を含まない整数値の入力が求められます。
コメントには、プラグイン設定の作成中にクレデンシャルを使うユーザーのユーザー名が追加されます。

Manage Engine Service Desk Plusプラグインを検証する

Cloud Exchangeで検証する

ワークフローを検証するには、Netskope Alerts/Eventsが必要です。

Manage Engine Service Desk Plus で作成されたチケットの一覧を表示するには、 Ticket OrchestratorのTickets に移動してください。

プラグイン名でフィルターを適用して、 Loggingからのチケット作成を検証します。

ManageEngine Service Desk Plusでの検証

クラウドインスタンスの場合：

インシデント作成を検証するには：

ManageEngineインスタンスにログインし、サービスデスクを選択して、「プロジェクト」ページに移動します。

Netskope Cloud Exchangeでキューを設定する際に選択したプロジェクトをクリックし、タスクページに移動します。ここでは、特定のプロジェクトに対して作成されたすべてのタスクを確認できます。

オンプレミス環境の場合：

インシデント作成を検証するには：

ManageEngineインスタンスにログインし、サービスデスクページに移動してください。

プロジェクトページに移動してください。

Netskope Cloud Exchange でキューを設定する際に選択したプロジェクトをクリックし、 Tasksに移動します。ここでは、特定のプロジェクトに対して作成されたすべてのタスクを確認できます。

Manage Engine Service Desk Plusプラグインのトラブルシューティング

CTO Manage Engine Service Desk Plus プラグインを構成できません

ユーザーがCTO Manage Engine Service Desk Plusプラグインを設定できない場合、以下のいずれかの理由が考えられます。

間違ったクレデンシャルが提供されました。
ユーザーに必要な権限がありません。
インスタンスURLが正しくありません。
オンプレミス版ManageEngine Service Desk PlusインスタンスのSSL証明書が正しくありません。

What to do: これらの問題を解決するには、以下の手順に従ってください。

必ず正しいクレデンシャルを入力してください。クレデンシャルを取得するには、「Manage Engine Service Desk Plus から認証クレデンシャルを取得する」セクションを参照してください。
ユーザーが必要な権限を持っていることを確認してください。「権限」セクションを参照してください。
正しいインスタンスURLが指定されていることを確認してください。
オンプレミスの Manage Engine Service Desk Plus インスタンスを使用している場合は、プラグインの設定時に、Service Desk Plus オンプレミスインスタンス用の自己署名証明書を提供する必要があります。 .crtファイルの内容を提供してください。

タスクを使うプラグインを作成できません

タスクを作成できない場合プラグインの場合、以下のいずれかの理由が考えられます。

Cloud Exchangeにアラートやイベントが存在しない、または新しいアラートやイベントが取得されていない。
ビジネスルールにはフィルタリングされたアラート/イベントがありません
ユーザーにはインシデントを作成するために必要な権限がありません。
タイトルフィールドはキュー構成にマッピングされていません。
キュー構成でマッピングされている所有者（担当者）は、タスクを作成しているプロジェクトのメンバーではありません。
レート制限を超過しました

What to do: 上記から根本原因を特定し、最適な解決策を選択してください。

アラート/イベントページでアラート/イベントが利用可能かどうかを確認してください。アラート/イベントが利用できない場合、タスクは作成されません。Netskopeテナント、またはCTOでアラート/イベントを作成するために必要なその他の設定を構成します。
ビジネスルールを確認し、アラートがフィルタリングされているかどうかをテストして確認します。フィルタリングでアラートが利用できない場合は、ビジネスルールを更新します。
ユーザーが必要な権限を持っていることを確認してください。「権限」セクションを参照してください。
チケットを作成するには、タイトルと値を必ずマッピングしてください。タスクを作成する際には、タイトルの入力が必須です。
タスクを作成するプロジェクトのメンバーが、そのタスクの所有者（担当者）であることを確認してください。
インスタンスのデフォルトのレート制限を確認するには、Manage Engine Service Desk Plus のサポート担当者にお問い合わせください。

名前解決エラーの一時的な失敗

オンプレミスインスタンスでプラグインを設定する際に、以下に示すような名前解決エラーが一時的に発生する場合は、以下の手順に従ってください。

requests.exceptions.ConnectionError: HTTPSConnectionPool(host='win11-50-10-99', port=443): Max retries exceeded with url: /api/v3/portals?input_data=%7B%22list_info%22%3A+%7B%22row_count%22%3A+1000%2C+%22start_index%22%3A+1%2C+%22page%22%3A+1%2C+%22sort_field%22%3A+%22created_time%22%2C+%22sort_order%22%3A+%22desc%22%7D%7D (Caused by NewConnectionError('<urllib3.connection.HTTPSConnection object at 0x7fd5685bfb50>: Failed to establish a new connection: [Errno -3] Temporary failure in name resolution'))

What to do:

Cloud ExchangeがインストールされているVMにSSH接続し、すべてのコンテナを停止します。 sudo ./stopスクリプト。
docker-composeファイルを使うコマンドを編集してください vi docker-compose.yml。
コアセクションにホストを追加してください。
- 形式:
  extra_hosts:
  – “<your domain>:<your ip>”
注記：

オンプレミス版ManageEngine Service Desk Plusインスタンスがホストされているサーバーのドメイン名とIPアドレス。

ファイルを保存します。
Netskope Cloud Exchange使うコマンドsudo ./startを開始します。
オンプレミス設定用に有効なクレデンシャルを使用してプラグインを構成します。

プロキシを使用したオンプレミスインスタンスのプラグイン設定中にエラーが発生しました

プロキシを使用してオンプレミスインスタンスのプラグインを設定できず、次のエラーが発生した場合：

CTO Manage Engine Service Desk Plus [CTO Manageengine onprem]: Proxy error occurred. Verify the proxy configuration provided. Error: HTTPSConnectionPool(host='win11-50-10-99', port=10026): Max retries exceeded with url: /api/v3/portals?input_data=%7B%22list_info%22%3A+%7B%22row_count%22%3A+1000%2C+%22start_index%22%3A+1%2C+%22page%22%3A+1%2C+%22sort_field%22%3A+%22created_time%22%2C+%22sort_order%22%3A+%22desc%22%7D%7D (Caused by ProxyError('Cannot connect to proxy.', OSError('Tunnel connection failed: 503 Service Unavailable')))

What to do: 以下の手順をプロキシVM（Cloud ExchangeがインストールされているVMではなく、プロキシが設定されているVM）で実行してください。

証明書を信頼済みディレクトリにコピーしてください。
Ubuntu OS の場合: sudo cp your-cert.crt /usr/local/share/ca-certificates/
CentOS の場合: sudo cp your-cert.crt /etc/pki/ca-trust/source/anchors/
信頼ストアを更新します。
Ubuntu OS の場合: sudo update-ca-certificates
CentOS の場合: sudo update-ca-trust extract
プロキシを再起動してください。
オンプレミス環境向けにプラグインを設定します。

制限

クラウドインスタンスの無料版ではプロジェクトあたりのタスク数が300に制限されており、オンプレミス版では1分あたりの呼び出し回数が60回に制限されていることが確認されました。