JinJin48
JinJin48
SAP Consultant | BTP · S/4HANA · US Global Rollout
· 19 min read

SAP Service Cloud インストールベース

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


パート 1: インストールベース — 中核概念(全モジュール共通)

1.1) インストールベースとは

ハブアンドスポーク図:中央に設置ベース(Installed Base)が配置され、機能場所(Functional Location)、製品設置ポイント(Product Installation Point)、登録製品(Registered Product)から「親設置ベースUUID(Parent Installed Base UUID)」とラベル付けされた実線の内向き参照矢印、ケース(Case)から「ケース設置ベースサブエンティティ — 設置ベースIDフィールド(Case Installed Bases subentity — Installed Base ID field)」とラベル付けされた実線の内向き参照矢印、そしてアカウント(Account)へ「基本顧客/連絡先(base customer/contact)」とラベル付けされた実線の外向き参照矢印が示されている。

インストールベースは、「この顧客にはどの製品と拠点が属し、それらはどのように階層的に構成されているか」という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つのパーティロールフィールドペア(基本取引先/コンタクト、所有者、支払者、請求先、出荷先)を比較するグリッド。各ペアはアカウントUUIDまたは個人顧客UUIDの参照として表示される

作成時、管理者は「顧客のタイプ」のみを、説明、取引先、連絡先とともに選択します。しかし、完全なフィールドテンプレートでは、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所有権の範囲

インストールベースの6つのデータセクション(コア識別・ステータス、顧客・パーティロール、住所・位置情報、サービス割当、ケース連携、作業区・アクセス制御)におけるSC所有権を示すチェックリスト

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

凡例: ◎ = オーナー / クリティカル、○ = 直接関与


2.1) 基本識別情報 & ステータス

インストールベースのコア識別フィールドのチェックリスト: ID、external_key、ステータス

これらのフィールドは、これがどのインストールベースであるか、および現在アクティブかどうかを確定します。以下のすべてのパーティロール、アドレス、および割当フィールドは、これらが設定されて初めて意味を持ちます。

フィールド説明実務上の使用例
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) ケース連携(ケース稼働ベースサブエンティティ)

ハブアンドスポーク図。CaseノードからInstalled Baseノードへの実線矢印が示されており、結合エンティティのフィールド名parent_external_keyとInstalled Base IDが注釈されています

これらの2つのフィールドは、インストールベース自体ではなく、ケース側のリレーションシップに存在します。しかし、これらはケースにインストールベースへの直接的で第一級の参照を提供する実際のメカニズムであるため、本記事のフィールドレベルの範囲に含まれます。

フィールド説明実務上の使用
parent_external_keyこのケース設置ベース行を、その所有元のケースレコードにリンクしますケースと設置ベースのリンクを一括インポートする場合に必須 — 有効な親キーがない行は読み込みに失敗します。
Installed Base ID参照される設置ベースのID(セクション2.1)このフィールドにより、継承ではなく直接的な関係が確立されます — ケースがサイト全体(その中の個別品目ではなく)に関わる場合は、必ずこのフィールドに入力してください。

前提条件: このサブエンティティは、確定済みの「ケース機能場所」「ケース登録製品」「ケース製品設置ポイント」の各サブエンティティと構造的に同一の形式です。これら4つの品目/コンテナタイプはすべて、それぞれ独自のケース直接結合サブエンティティを持ち、ケースにリンクするために他のオブジェクトを経由する必要はありません。


2.6) 作業区とアクセス制御

インストールベースのアクセス制御フィールドのチェックリスト: 作業区技術名称、UIアプリ名、ビジネスロール割当

このバッチ内の他のマスタデータオブジェクトと同様に、インストールベースのワークリストへのアクセスは、インストールベースレコード自体のフィールドではなく、ビジネスロールの割当によって完全に管理されます。

フィールド説明実務上の使用例
作業区 技術名称sap.crm.service.installedBaseServiceインストールベース作業区の安定した技術識別子 — ビジネスロール割当のスクリプト作成や監査時には、表示ラベルのみに依存せず、こちらを使用します。
UIアプリ名sap.crm.installedbaseservice.uiapp.installedBase作業区タイルに紐づく特定のUIアプリ — インストールベースが他のオブジェクト画面内のタブではなく、専用アプリを持つことを確認します。
ビジネスロール割当システム設定 → ビジネスロール を介して、ビジネスユーザーにインストールベース作業区へのアクセス権を付与します。このバッチで既に確認されている他のサービス・クラウド・マスタデータ・オブジェクトと同一のアクセス制御パターンに従います — 標準のビジネスロールメカニズムを超えた、インストールベース固有の認可オブジェクトは存在しません。

次に読むべきもの

L1) Big Picture

IDCategoryTitle
sc-001OverviewSAP Service Cloudとは何ですか?

L2-A) Master Data

IDCategoryTitle
sc-a01OverviewSAP Service Cloud マスタデータ:概要、階層、および関係性
sc-a02-01Master DataSAP Service Cloud 組織単位
sc-a02-02Master DataSAP Service Cloud 従業員
sc-a02-03Master DataSAP Service Cloud ビジネスロール
sc-a02-04Master DataSAP Service Cloud ビジネスユーザ
sc-a02-05Master DataSAP Service Cloud チーム
sc-a03-01Master DataSAP Service Cloud メールチャネル
sc-a03-02Master DataSAP Service Cloud メールテンプレート
sc-a04-01Master DataSAP Service Cloud ナレッジベースプロバイダ
sc-a05-01Master DataSAP Service Cloud サービスカタログ
sc-a05-02Master DataSAP Service Cloud サービスカテゴリ
sc-a05-03Master DataSAP Service Cloud ケースタイプ
sc-a06-01Master DataSAP Service Cloud サービスレベル
sc-a06-02Master DataSAP Service Cloud サービスレベル決定
sc-a07-01Master DataSAP Service Cloud ケースルーティングルール
sc-a10-04Master DataSAP Service Cloud 保証
sc-a11-01Master DataSAP Service Cloud インストールベース 📍
sc-a11-02Master DataSAP Service Cloud 機能場所

L2-B) Transaction

IDCategoryTitle
sc-b01OverviewSAP Service Cloud トランザクション:プロセスフロー、階層、リレーションシップ