---
title: "ギフトカードドメインモデル"
slug: "the-gift-cards-domain-model"
abstract: "ギフトカードオブジェクトを表すドメインモデルの概要。"
---
# ギフトカードドメインモデル

この節では、ギフトカードオブジェクトを表すドメインモデルについて説明します。ここで以下の3つの主張が成り立つ場合です。

-   ドメインモデルは主に外部商取引システムとSitecore間で情報を転送するためのDTOオブジェクトとして機能します。
-   ドメインモデルは最低限必要な情報だけを契約として含み、特定の商取引システムと統合されると通常拡張されます。
-   ドメインモデルは、Sitecore開発者が製品データを外部のコマースシステムと同期させる必要がある場合や、外部コマースシステムからSitecoreに製品データがプッシュされる場合に使用されます。

以下のクラス図はドメインモデルを示しています:

![Class diagram of the gift card domain model](https://doc.sitecore.com/api/markdown-image/xp/ja/developers/100/sitecore-experience-commerce/images/03000017.png)

> !注ドメインモデルは外部システムとの契約を構成する抽象クラスで構成されています。これらの契約はインターフェースではなく抽象クラスとして定義されており、必要に応じて後から簡単に拡張できるようになっています。これはフレームワーク設計ガイドラインで定義されたベストプラクティスガイドラインに従っています。
> 
> 契約のデフォルト実装はConnectの一部として提供されます。外部商取引システムを持つ実際のConnectプロバイダーがデフォルト以上の機能を持っている場合、その実装は置き換え可能です。実際のクラスのインスタンス化はすべて依存性注入によって処理されます。

## クラス:ギフトカード

GiftCardクラスは、外部システム内でギフトカードエンティティを表現する責任を負います。

名称

種類

概要

ExternalId

ストリング

コマースシステム内の製品に対する一意識別子。これはコマースシステムのネイティブAPIを使って商品への参照を得るために使えます。

名称

ストリング

ギフトカードの名前(もしあれば)を教えてください。

カスタマーID

ストリング

カードの所有者の識別子。

ショップネーム

ストリング

カードが関係しているショップがあれば、そのショップがどこかです。

通貨コード

ストリング

カードの価値の通貨です。

バランス

小数点

カードの残りの価値です。

オリジナルマテンション

小数点

カードの初期価値。

概要

ストリング

メーカーに関する言及です。

## クラス:ギフトカードPaymentInfo

GiftCardPaymentInfoクラスは、ギフトカードで支払いを行うことを可能にするPaymentInfoクラスの実装です。

名称

種類

概要

金額

小数点

ギフトカードに対して請求されている金額。

カード番号

ストリング

支払いに使われているギフトカードのID。