SAP Service Cloud インストールベース
SAP Service Cloud インストールベース
SAP Service Cloud におけるインストールベースとは、「顧客の拠点に設置されたアイテムの階層的な配置」です。これは、ワークリストから手動で作成されるコンテナレコードであり、他のオブジェクトが直接、または相互に接続してアタッチされます。インストールベース自体のフィールドテンプレートには、親ポインタフィールドや保証フィールドは一切含まれていません。この特性は、機能場所、製品設置ポイント、および登録製品に存在する確認済みのParent Installed Base UUIDフィールドと組み合わさることで、インストールベースを固定された2分岐モデルの中間点ではなく、柔軟な多階層ツリーのルートにしています。また、保証とは異なり、インストールベースは、専用の「ケースインストールベース」サブエンティティを介して、ケースから直接かつファーストクラスの参照を持つ4つのオブジェクトタイプの1つです。この記事では、その構造を正確にマッピングし、インストールベース作成時に入力される顧客およびパーティロールフィールドをカバーし、命名の衝突やドキュメンテーションのギャップが、インストールベースを使用した構築方法を変更すべき箇所を指摘します。
パート 1: インストールベース — 中核概念(全モジュール共通)
1.1) インストールベースとは

インストールベースは、「この顧客にはどの製品と拠点が属し、それらはどのように階層的に構成されているか」という1つの問いに答えるために存在します。SAP Service Cloudはこれをコンテナレコード(インストールベース)で実現します。このレコードは、他の明細レベルのオブジェクトが直接、または相互に接続されるための基点であり、自身が他の何かに接続しに行くレコードではありません。機能範囲説明書によれば、インストールベースは「顧客別または製品別」のどちらの方向からも表示可能であり、これは特定の顧客の拠点に実際に設置されている製品を保持するあらゆる明細の集約ポイントとして機能することと一致しています。
| 項目 | 詳細 |
|---|---|
| 役割 | 特定顧客における製品とロケーション階層のルート/最上位コンテナ。機能場所、製品設置ポイント、および登録製品の各アイテムが、直接的または相互に接続するためのアンカーとなる。自身のフィールドテンプレートには、親ポインタフィールドと保証フィールドが含まれない。つまり、これらの関係において参照側(子)となることはない。 |
| 使用するモジュール | SAP Service Cloud(インストールベースオブジェクト、そのワークリスト、およびワークセンタタイルの唯一の所有者。技術名は sap.crm.service.installedBaseService)。インストールベース自体について、S/4HANA に対応するものや複製シナリオは確認されていない(S/4HANA 注記を参照)。 |
| トランザクション | インストールベースワークリスト — 作成をクリックし、説明、取引先、コンタクトを入力し、顧客タイプを選択して、保存をクリックする。 |
| 主要テーブル | 従来のABAPテーブルはなし — SAP Service Cloud はマルチテナントSaaSであり、インストールベースのヘッダエンティティとそのパーティロール/アドレスフィールドは、OData / インポート・エクスポートフィールドテンプレートとしてのみ公開される。 |
| S/4HANA 注記 | インストールベース自体に関する公式の複製または統合シナリオは見つからなかった。ソリューションガイドでは、アプリ内での手動によるワークリスト作成手順のみが文書化されている。これは、設置ポイントからの作成パスが「SAP S/4 HANA からの複製をサポートする」と明示されている機能場所とは異なる。インストールベースについては、手動作成を文書化されたデフォルトとして扱い、顧客固有の統合が存在しないことの証明として扱わないこと。 |
名称の衝突 — “インストールベース” は、SAPポートフォリオ内の他の場所で少なくとも2つの無関係なものを意味します。 このオブジェクトは、以下のものと名前以外に共通点はありません。(1) SAP S/4HANA(オンプレミス)および従来のECC「インストールベース管理(CS-IB)」 — これはプラント保全/カスタマーサービスのアプリケーションコンポーネント(テーブル
IBIB)であり、設備、機能場所、シリアル番号付き品目をツリー制御の保守画面で共通のインストールベースにグループ化します。その際、「設備、機能場所、またはシリアル番号付き品目は、同時に1つのインストールベースにのみ存在できる」という厳格な制約があります。このオンプレミスオブジェクトは、従来の SAP CRM サービス(WebClient、IB5x範囲のトランザクション)とも歴史的に共有されています。そして (2) SAP Field Service Management 独自の「アセット/インストールベース」概念。これは、サービスオーダーのスケジューリング/ディスパッチコンテキストのために、独自のクラウドデータモデルとREST APIで管理されています。これらは両方とも、用語は共通ですが、SAP Service Cloud Version 2のインストールベースオブジェクトとはアーキテクチャ的に異なる製品です。衝突ではありません: チケットベースの前身製品である SAP Cloud for Customer (C4C) には、ここで調査されたものと機能的に同じインストールベースの概念があります。これは、SAPのケース/チケットベースのクラウドサービス世代(C4C → SAP Sales and Service Cloud → SAP Service Cloud Version 2)をまたがる直接的な製品系統であり、別の同名の概念ではありません。
1.2) 顧客タイプとパーティロールのバリエーション

作成時、管理者は「顧客のタイプ」のみを、説明、取引先、連絡先とともに選択します。しかし、完全なフィールドテンプレートでは、5つの異なるパーティロールスロットが公開されており、各スロットは独立して法人取引先または個人顧客を指すことができます。間違ったロールが設定されたり(ビジネスで実際に必要なロールが未設定のままになったり)すると、請求書が誤ったエンティティにルーティングされたり、フィールドサービスの訪問が誤ったサイト連絡先に対してスケジュールされたりします。
| 取引先役割 | フィールドペア | ユースケース | 主要な動作 |
|---|---|---|---|
| 基本顧客(取引先/担当者) | Account_Account UUID + Account_Contact UUID、または Individual Customer_Individual Customer UUID | 設置基点のプライマリ顧客リンク(作成時に入力) | 唯一必須の取引先役割ペアリング。ワークリストや、設置基点からケースが作成された際に表示されるデフォルトの取引先/担当者コンテキストを決定します。 |
| 所有者 | Owner Account_* / Owner Individual Customer_* | サイトの法的所有者と取引先名義人を区別する | リース、下請け、または第三者サービス対象の機器において、設置品目を法的に所有するエンティティがプライマリ取引先と異なる場合に関連します。 |
| 支払者 | Payer Account_* | プライマリ取引先とは異なる請求責任 | 親会社がプライマリ取引先を保有しているが、子会社や原価センタサイトが実際に請求書を支払う場合に使用します。 |
| 請求先 | Bill-to Account_* / Bill-to Individual Customer_* | プライマリ取引先とは異なる請求先住所/担当者 | 複数拠点を持つ法人顧客で、サイト自体とは別に集中買掛金処理を行う場合によく見られます。 |
| 出荷先 | Ship-to Account_* / Ship-to Individual Customer_* | プライマリ取引先とは異なる物理的な配送場所 | 交換部品やフィールドサービス出荷品を、プライマリ取引先の請求先住所とは異なる住所に配送する必要がある場合に関連します。 |
設計原則: インストールベース作成時に入力されたプライマリ取引先または個人顧客は、自動的に支払元、請求先、出荷先にはなりません。これらの各ロール(所有者を含む)は、同じレコード上で個別に入力されるフィールドペアであり、基本となる取引先/コンタクトのペアのみが必須です。
1.3) 組織レベルとデータ階層

データ階層の具体例(テナントレベル;SAP Service Cloudには、この上位に会社コード/プラントのスコープ設定はありません)
Client (SAP Service Cloud Tenant)
│
└── Account "ACC-77410 — Acme Manufacturing K.K." (base customer party role)
│
└── Installed Base "IB-40210 — Acme Mfg, Yokohama Plant, Packaging Line 2"
│ (ROOT — its own field template carries no Parent-* field
│ and no Warranty field; it is never the referencing/child
│ side of any relationship)
│
├── Functional Location "FL-8801 — Packaging Robot Cell"
│ (Parent Installed Base UUID = IB-40210)
│ │
│ └── Product Installation Point "PIP-3305 — Motor Drive Unit"
│ (Parent Installation Point UUID = FL-8801 — illustrates
│ that an Installation Point can nest under a Functional
│ Location instead of directly under Installed Base)
│
└── Registered Product "RP-90215 — Serial# CNV-2024-118"
(Parent Installed Base UUID = IB-40210 — attached directly,
the other supported nesting pattern)
Case "CS-500311 — Conveyor motor overheating, packaging line down"
── references ──> Installed Base "IB-40210"
(direct field-level link via the "Case Installed Bases" subentity —
Installed Base ID field)設計原則 — インストールベースは、固定された2階層モデルの1つの枝ではなく、柔軟なツリー構造の唯一のルートである。 機能場所、製品設置ポイント、および登録製品は、それぞれ3つの親ポインタフィールド(
親インストールベースUUID、親登録製品UUID、親設置ポイントUUID)を保持しており、実際にはそのうち1つだけが設定される。つまり、3つのアイテムタイプはいずれも、インストールベースの直下、または別のアイテムの1階層下に直接ネストできる。セットアップガイドの作成手順では、機能場所、登録製品、および製品設置ポイントを、主にレコードが表示されるタブによって区別される、より広範な「設置ポイント」概念のUIレベルの「カテゴリ」として位置付けており、これは十分に裏付けられたニュアンスではあるが、他の場所で単一の統一的な技術的記述によって完全に相互確認されているわけではない。
1.4) 他のマスタデータオブジェクトとの統合

Installed Base(インストールベース)は単独で存在するわけではありません。これは、柔軟な品目ツリーがアタッチされるコンテナであり、パーティロールのアンカーであるAccount(取引先)とその請求先/出荷先バリアントが参照するものであり、Case(ケース)から直接参照される唯一の4つのオブジェクトタイプの1つです。
| オブジェクト | 関係性 | 実務上の注意点 |
|---|---|---|
| 機能場所 (SC-A11-02) | 直接 — 親インストールベースUUID(および親登録製品UUID、親設置ポイントUUID)を保持 | このインストールベースの直下、または別のアイテムの一段階下に直接ネストできる兄弟「アイテム」エンティティタイプ。セットアップガイドの「インストールベースから作成」フローでは、この方法で構築された場合、顧客とインストールベースのコンテキストが事前入力される。 |
| 製品設置ポイント | 直接 — 同一の3フィールド親ポインタパターン | 3つ目の汎用兄弟アイテムタイプ。ソリューションガイドの第29章の定義に従い、インストールベース、機能場所、または登録製品から作成可能。 |
| 登録製品 (SC-A10-03) | 直接 — 同一の3フィールド親ポインタパターン | インストールベースの直下、または別のアイテムの下にもネスト可能。他の2つのアイテムタイプと異なり、製品マスタを追加で参照する。この製品マスタがSAP S/4HANAから実際にレプリケーションされるオブジェクトである。 |
| 取引先 | 直接 — インストールベース自身のフィールドテンプレート上の取引先_取引先UUID / 取引先_連絡先UUID | 作成時に入力される基本顧客リンク。所有者、支払者、請求先、出荷先は、同一の取引先/個人顧客ペアの別個のオプションとなるパーティロールバリアントである(セクション1.2)。 |
| ケース | 直接 — 専用の「ケースインストールベース」結合サブエンティティ(インストールベースIDフィールド) | ソリューションガイドは「インストールベースのケース作成」を第一級の機能として挙げており、ケースが機能場所、製品設置ポイント、登録製品に対して持つ確認済みの直接リンクと構造的に同一である。 |
| 保証 (SC-A10-04) | 間接のみ — インストールベース自身の依存関係テーブルおよび完全なフィールドテンプレートの両方において、保証が存在しないことが確認済み | インストールベースに含まれる機能場所または登録製品のアイテムを介してのみ到達可能。インストールベース自体が独自の保証_*フィールドを持つことはない。 |
真の直接関係であり、否定すべき誤解ではありません。 保証に関する関連記事で判明したように、Case(ケース)には保証への直接的なフィールドレベルのリンクはありません。一方、インストールベースはその逆です。「Case Installed Bases(ケースインストールベース)」サブエンティティは、データモデルレベルにおいて、Caseと機能場所、製品取付ポイント、登録製品との直接リンクと同じ構造ファミリーに属する、実際に確認された第一級のリンクです。インストールベースが、その内包するアイテムを介して間接的にのみCaseに到達すると想定しないでください。インストールベースには独自の直接参照が存在します。
カバレッジギャップ — インストールベース自体に対するS/4HANAレプリケーションの確定シナリオはありません。 インストールベースの作成に関する文書化されたガイダンスはすべて、手動によるアプリ内ワークリストアクションのみを説明しています。特定の実装において、インストールベースが自動化されたS/4HANAレプリケーションによって一般的に作成されると断言しないでください。顧客固有の統合が存在しないという絶対的な主張ではなく、文書化されたデフォルトとして手動作成を扱ってください。
パート 2: SC固有のフィールド詳細
2.0) SC所有権の範囲

| データセクション | SCの関与 | 備考 |
|---|---|---|
| コア識別情報とステータス | ◎ 所有者 | ID、外部キー、ステータス — これがどのインストールベースであるか、現在アイテム添付やケース参照を受け付けるかどうかを確立します。 |
| 顧客と取引先ロール | ◎ 所有者 | 基本となる取引先/コンタクトに加え、セクション1.2で説明する4つのオプションのバリアントロール(所有者、支払者、請求先、出荷先)を含みます。 |
| 住所と地理位置情報 | ◎ 所有者 | 完全な住所ブロックに加え、緯度/経度 — アイテム階層が配置される物理的な場所です。 |
| サービス割当 | ◎ 所有者 | サービステクニシャンチーム、責任計画者、サービステクニシャン、従業員責任者 — このサイトに対して責任を持つ担当者です。 |
| ケースリンケージ(ケースインストールベースサブエンティティ) | ○ 直接関与 | ケース側に存在する結合フィールドですが、このインストールベースを直接参照するために特別に存在します。 |
| 作業区とアクセス制御 | ○ 直接関与 | 専用のインストールベース作業区タイルであり、ビジネスロール割当を介してビジネスユーザーごとに付与されます。 |
凡例: ◎ = オーナー / クリティカル、○ = 直接関与
2.1) 基本識別情報 & ステータス

これらのフィールドは、これがどのインストールベースであるか、および現在アクティブかどうかを確定します。以下のすべてのパーティロール、アドレス、および割当フィールドは、これらが設定されて初めて意味を持ちます。
| フィールド | 説明 | 実務上の使用例 |
|---|---|---|
| ID | インストールベースのシステム識別子。ケースの「インストールベース」サブエンティティの「インストールベースID」フィールドのリンク先として使用される | ケースの直接参照が実際に指す値であるため、ケース側の統合または整合性ロジックをスクリプト化する前に確認すること。 |
| external_key | 一括データ操作用のインポート/エクスポートキー | インストールベースレコードの一括インポートには必須。システムIDとは異なり、移行/統合の整合性確認専用に使用される。 |
| Status | インストールベースが現在、新規品目の添付やケース参照に対してアクティブかどうか | 今回の調査では、このフィールドの公式な列挙値リストは見つからなかった。特定のステータス値セットはあくまで参考値として扱い、実際の使用に際しては現在のテナントで確認すること。 |
2.2) 顧客および取引先ロール

これらのフィールドは、セクション1.2で紹介されたように、インストールベースを正しい顧客、およびビジネス上必要な場合は別の所有者、支払者、または出荷先に関連付けます。
| フィールド | 説明 | 実務上の使用例 |
|---|---|---|
| Account_Account UUID / Account_Contact UUID | このインストールベースの主要な法人顧客とその担当者 | 唯一必須のパーティ・ロールの組み合わせ。エージェントがこのインストールベースから直接ケースを作成する際に表示されるデフォルトのアカウント/コンタクトコンテキストを決定します。 |
| Individual Customer_Individual Customer UUID | サイトが企業ではなく個人に属する場合の主要顧客 | Accountペアリングの代わりに設定され、併用はされません。データ入力前に該当する顧客タイプを確認してください。これら2つは相互に排他的な基本顧客パスです。 |
| Owner Account_* / Owner Individual Customer_* | 設置アイテムの法的所有者(主要Accountと異なる場合) | リースまたは外注機器のシナリオで明示的に設定します。空白のままにすると、「所有者=主要Account」と読み手に想定されますが、これは常に正しいとは限りません。 |
| Payer Account_* | このインストールベースに関連する請求書の支払責任者 | 親会社が主要Accountを保持しているが、子会社や原価センタが実際に支払う場合に設定します。設定しないと、請求が誤って主要Accountにデフォルトされる可能性があります。 |
| Bill-to Account_* / Bill-to Individual Customer_* | 主要Accountとは異なる請求先住所/連絡先 | 複数拠点を持つ法人顧客における集中買掛金処理で一般的です。主要Accountの住所が請求先として正しいと想定する前に、顧客の財務部門に確認してください。 |
| Ship-to Account_* / Ship-to Individual Customer_* | 主要Accountとは異なる物理的な配送先住所/連絡先 | 交換部品やフィールドサービスの出荷を、主要Accountの請求先住所とは異なる場所に届ける必要がある場合に関連します。 |
2.3) 住所と位置情報

これらのフィールドは、品目階層が実際に存在する物理的な拠点を記録します。つまり、このインストールベースに対してケースが起票された際に、フィールドテクニシャンが派遣されるロケーションです。
| フィールド | 説明 | 実務上の使用例 |
|---|---|---|
| Address_Postal Address_* | 設置ベースの物理的な拠点の完全な住所ブロック | 取引先自身の住所とは独立して最新の状態に保つこと — 顧客の請求先住所と設置ベースが置かれている物理的な拠点は、特に複数拠点を持つ法人顧客の場合、頻繁に異なります。 |
| Address_Geographical Location_緯度 / 経度 | 拠点の地理座標 | フィールドサービス派遣やマッピング連携に有用。本調査では、これらの座標が手動で入力されるのか、住所から自動的にジオコーディングされるのかを文書化した情報源はありません。いずれかの前提に依存する前に、実際のテナントの動作を確認してください。 |
2.4) サービス割当
![インストールベースのサービス割当フィールドを示す積層図: サービス技術者チーム、担当プランナー、サービス技術者、責任者]
これらのフィールドは、ケースがサイトに対して起票された際に、そのサイトの責任者を決定します。これらを誤って設定すると、ケースルーティングルールの設定が評価される前の段階で、作業が誤ったチームにルーティングされてしまいます。
| フィールド | 説明 | 実務上の使用例 |
|---|---|---|
| サービス技術者チームUUID | この稼働ベースにおけるサービス作業を主に担当するチーム(SC-A02-05) | サイトのデフォルトの割当コンテキストを設定します。チーム構成の変更に応じて最新の状態に保つようにしてください。古い値が残っていると、フィールドサービス計画が気付かれないうちに誤った方向に進む可能性があります。 |
| 担当計画者UUID | この稼働ベースのサービス活動を計画する従業員(SC-A02-02) | 通常は、実際に作業を実行する技術者とは異なる、バックオフィスまたはスケジューリング担当のロールです。 |
| サービス技術者UUID | この稼働ベースでサービス作業を実行する従業員(SC-A02-02) | サイトに対するデフォルト/優先技術者の割当を示します。必ずしも、この稼働ベースに対して起票された個々のケースに割り当てられる技術者であるとは限りません。 |
| 従業員責任者UUID | この稼働ベースに対して全体的な説明責任を持つ従業員(SC-A02-02) | サービス技術者や担当計画者とは異なります。これは、運用上の割当フィールドではなく、所有権/説明責任を示すフィールドです。 |
2.5) ケース連携(ケース稼働ベースサブエンティティ)

これらの2つのフィールドは、インストールベース自体ではなく、ケース側のリレーションシップに存在します。しかし、これらはケースにインストールベースへの直接的で第一級の参照を提供する実際のメカニズムであるため、本記事のフィールドレベルの範囲に含まれます。
| フィールド | 説明 | 実務上の使用 |
|---|---|---|
| parent_external_key | このケース設置ベース行を、その所有元のケースレコードにリンクします | ケースと設置ベースのリンクを一括インポートする場合に必須 — 有効な親キーがない行は読み込みに失敗します。 |
| Installed Base ID | 参照される設置ベースのID(セクション2.1) | このフィールドにより、継承ではなく直接的な関係が確立されます — ケースがサイト全体(その中の個別品目ではなく)に関わる場合は、必ずこのフィールドに入力してください。 |
前提条件: このサブエンティティは、確定済みの「ケース機能場所」「ケース登録製品」「ケース製品設置ポイント」の各サブエンティティと構造的に同一の形式です。これら4つの品目/コンテナタイプはすべて、それぞれ独自のケース直接結合サブエンティティを持ち、ケースにリンクするために他のオブジェクトを経由する必要はありません。
2.6) 作業区とアクセス制御

このバッチ内の他のマスタデータオブジェクトと同様に、インストールベースのワークリストへのアクセスは、インストールベースレコード自体のフィールドではなく、ビジネスロールの割当によって完全に管理されます。
| フィールド | 説明 | 実務上の使用例 |
|---|---|---|
| 作業区 技術名称 | sap.crm.service.installedBaseService | インストールベース作業区の安定した技術識別子 — ビジネスロール割当のスクリプト作成や監査時には、表示ラベルのみに依存せず、こちらを使用します。 |
| UIアプリ名 | sap.crm.installedbaseservice.uiapp.installedBase | 作業区タイルに紐づく特定のUIアプリ — インストールベースが他のオブジェクト画面内のタブではなく、専用アプリを持つことを確認します。 |
| ビジネスロール割当 | システム設定 → ビジネスロール を介して、ビジネスユーザーにインストールベース作業区へのアクセス権を付与します。 | このバッチで既に確認されている他のサービス・クラウド・マスタデータ・オブジェクトと同一のアクセス制御パターンに従います — 標準のビジネスロールメカニズムを超えた、インストールベース固有の認可オブジェクトは存在しません。 |
次に読むべきもの
L1) Big Picture
| ID | Category | Title |
|---|---|---|
| sc-001 | Overview | SAP Service Cloudとは何ですか? |
L2-A) Master Data
| ID | Category | Title |
|---|---|---|
| sc-a01 | Overview | SAP Service Cloud マスタデータ:概要、階層、および関係性 |
| sc-a02-01 | Master Data | SAP Service Cloud 組織単位 |
| sc-a02-02 | Master Data | SAP Service Cloud 従業員 |
| sc-a02-03 | Master Data | SAP Service Cloud ビジネスロール |
| sc-a02-04 | Master Data | SAP Service Cloud ビジネスユーザ |
| sc-a02-05 | Master Data | SAP Service Cloud チーム |
| sc-a03-01 | Master Data | SAP Service Cloud メールチャネル |
| sc-a03-02 | Master Data | SAP Service Cloud メールテンプレート |
| sc-a04-01 | Master Data | SAP Service Cloud ナレッジベースプロバイダ |
| sc-a05-01 | Master Data | SAP Service Cloud サービスカタログ |
| sc-a05-02 | Master Data | SAP Service Cloud サービスカテゴリ |
| sc-a05-03 | Master Data | SAP Service Cloud ケースタイプ |
| sc-a06-01 | Master Data | SAP Service Cloud サービスレベル |
| sc-a06-02 | Master Data | SAP Service Cloud サービスレベル決定 |
| sc-a07-01 | Master Data | SAP Service Cloud ケースルーティングルール |
| sc-a10-04 | Master Data | SAP Service Cloud 保証 |
| sc-a11-01 | Master Data | SAP Service Cloud インストールベース 📍 |
| sc-a11-02 | Master Data | SAP Service Cloud 機能場所 |
L2-B) Transaction
| ID | Category | Title |
|---|---|---|
| sc-b01 | Overview | SAP Service Cloud トランザクション:プロセスフロー、階層、リレーションシップ |