> ## Documentation Index
> Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# サブスクリプション

> ABBYY Vantage セルフホスト型のサブスクリプションを管理します。ページカウンター、含まれる Skill、複数テナント間での共有、ABBYY Subscription Service へのアクセスを扱います。

テナントで ABBYY Vantage を利用するには、有効なサブスクリプションが必要です。サブスクリプションによって、次の項目が決まります。

* Skill へのアクセス期間
* 処理できるページ数
* 利用可能な Skill

各種 Skill で処理したページ数をカウントするため、サブスクリプションにはカウンターが含まれます。

<Note>
  1 つのサブスクリプションは、テナント内のすべてのユーザーに適用されます。1 つのサブスクリプションが複数のテナントに紐付けられている場合、それらのテナントは各 Skill のカウンターを共有します。
</Note>

<div id="configuring-abbyy-subscription-service-access">
  ## ABBYY Subscription Service へのアクセスの設定
</div>

分離環境では、サブスクリプションの使用状況統計を送信できるように、Vantage から ABBYY Subscription Service へのアクセスを設定します。これらのリクエストの送信頻度は、サブスクリプション設定によって決まります。デフォルトでは、統計は毎日送信されます。

オプション:

1. **直接アクセス**。`https://licensing-us.abbyy.com` への HTTPS リクエストを許可します
2. **プロキシアクセス**。リクエストをプロキシ経由でリダイレクトします。

<div id="using-a-proxy">
  ### プロキシの使用
</div>

<Note>
  開始する前に、お使いのマシンに `kubectl` コマンドラインツールがインストールされ、Kubernetes クラスターへの接続が確立されていることを確認してください。
</Note>

1. Consul の Web インターフェイスにアクセスします。

```bash theme={null}
kubectl port-forward -n abbyy-infrastructure service/consul-ui 8500:80
```

`http://localhost:8500/ui/dc1/kv/secret/` にアクセスします

2. 必要な Vantage 環境を選択します。
3. 次のキーの値を変更します。

| Key                                                       | 説明                                                                                    |
| --------------------------------------------------------- | ------------------------------------------------------------------------------------- |
| `secret/.../subscriptions/licensingHqClientProxyUse`      | プロキシを有効にするには、`True` に設定します。                                                           |
| `secret/.../subscriptions/licensingHqClientProxyUri`      | プロトコルとポートを含むプロキシアドレス (例: `http://<proxyaddress>:3128`)                                |
| `secret/.../subscriptions/licensingHqClientProxyDomain`   | ユーザードメイン。プロキシでドメインアカウント認証を使用している場合は、ドメイン名を指定します。プロキシのログイン名は、このドメイン名とユーザー名の組み合わせになります。 |
| `secret/.../subscriptions/licensingHqClientProxyUserName` | プロキシのログイン名。                                                                           |
| `secret/.../subscriptions/licensingHqClientProxyPassword` | プロキシのパスワード。                                                                           |

4. **Save** をクリックします。
5. `abbyy-vantage-subscriptions` デプロイメントを再起動します。

これで、Vantage は指定したプロキシ経由で ABBYY Subscription Service にアクセスします。

<div id="viewing-subscription-parameters">
  ## サブスクリプション Parametersの確認
</div>

1. **Tenants**タブで、テナント名をクリックします。
2. **サブスクリプション**タブを開きます。

表示される情報:

* サブスクリプションの種類、シリアル番号、有効期限
* **Skill Counters**: Skillごとに利用可能なページ数、次回更新日
* **サブスクリプション Parameters**: 追加オプション (例: Advanced Designerの利用可否)

<div id="how-pages-are-counted">
  ## ページのカウント方法
</div>

ABBYY Vantage では、ユーザーが処理したすべての文書ページが、ライセンスごとのカウンターでカウントされます。処理済みページ数の算出に使用されるカウンターの種類は、使用する Skill と、その Skill がライセンス対象かどうかによって異なります。ライセンス対象の Skill とは、ABBYY またはその Partner が作成し、ABBYY でライセンス手続きを受けた Skill のことです。

カウンターの種類:

| Counter Type              | Description                                                                                            |
| ------------------------- | ------------------------------------------------------------------------------------------------------ |
| **Dedicated counters**    | ライセンス対象の Skill (例: ABBYY Invoice、ABBYY Bill Of Lading) に使用されます。ライセンス対象の各 Skill には、専用のカウンターが割り当てられています。 |
| **Core Cognitive Skills** | ライセンス対象ではないすべての ABBYY Vantage Skill に使用されます。                                                           |
| **OCR Skill**             | OCR Skill を使用して処理されたページに使用されます。                                                                        |
| **Licensed Skills**       | ライセンス対象の Skill の試用版にのみ使用されます。これにより、カウンターがライセンスに含まれていない、またはページ数を使い切ったライセンス対象の Skill を使用して文書を処理できます。     |

<div id="when-pages-are-counted">
  ### ページがカウントされるタイミング
</div>

**設計時** (Document skill および分類スキル) :

* Document skill へのデモ文書のインポート
* 学習用の document set へのファイルのインポート

**実行時** (すべてのスキルタイプ) :

* Documents セクションへのページのアップロード
* トランザクション内での文書の処理
* Try Skill 機能の使用

<Note>
  文書のインポート後にトランザクションが失敗した場合でも、ページはカウントされます。
</Note>

すべてのサブスクリプションカウンターは、「更新期間」と呼ばれる一定期間ごとに更新されます。この期間の終了時に、すべてのカウンター値がリセットされ、ユーザーは再び最大ページ数まで利用できるようになります。更新期間の長さと開始日は、いずれかのスキルが初めて使用された時期に関係なく、1つのサブスクリプション内のすべてのカウンターで共通です。

どの形式でも、1ページの単一画像は、その画像に複数の異なる文書が含まれている場合でも、1ページとしてカウントされます。

特定のスキルで処理に使用できるページ数を使い切った場合、または現在有効なサブスクリプションで必要な処理スキルへのアクセスが提供されていない場合、ユーザーはそのスキルを使用して新しいトランザクションを作成できません。

<div id="process-skill-page-counting">
  ### Process Skill のページカウント
</div>

| Skill の構成                       | カウンターの動作                                  |
| ------------------------------- | ----------------------------------------- |
| ライセンス対象外の Skill のみ              | Core Cognitive Skills カウンター がページごとに 1 回増加 |
| ライセンス対象の Skill が 1 つ            | ライセンス対象の Skill のカウンターがページごとに 1 回増加        |
| ライセンス対象外 + ライセンス対象の Skill が 1 つ | どの Skill が文書を処理するかによってカウンターが決まる           |
| ライセンス対象の Skill が複数              | 各ライセンス対象の Skill のカウンターがページごとに増加           |

<Note>
  Process Skill に含まれるいずれかの Skill で、関連するすべてのカウンターがそれぞれの上限に達している場合、トランザクションは開始されません。
</Note>

<div id="managing-subscriptions">
  ## サブスクリプションの管理
</div>

システム管理者は、テナントのサブスクリプションを管理できます。具体的には、システム管理者はサブスクリプションの関連付け、変更、削除を行えます。

<div id="linking-a-subscription">
  ### サブスクリプションの関連付け
</div>

新しいテナントの作成時にサブスクリプションファイルをアップロードするか、テナント設定から既存のテナントに追加します。

<img src="https://mintlify.s3.us-west-1.amazonaws.com/abbyy/images/vantage/self-hosted/misc-p01-004.png" alt="「Upload Subscription File」ボタンが表示された「New Tenant」ダイアログ" style={{ width:"50%" }} />

<div id="modifying-a-subscription">
  ### サブスクリプションの変更
</div>

1. **Tenants** タブを開き、テナント名をクリックします。
2. **サブスクリプション** タブを開きます。
3. サブスクリプションの種類の横にあるメニューアイコンをクリックします。
4. **Change サブスクリプション File** を選択し、新しいファイルをアップロードします。

<div id="deleting-a-subscription">
  ### サブスクリプションの削除
</div>

1. **Tenants** タブを開き、テナント名をクリックします。
2. **サブスクリプション** タブに移動します。
3. メニュー icon をクリックし、**Delete サブスクリプション** を選択します。

<Warning>
  サブスクリプションを削除すると、テナントのユーザーはどの Skill を使用してもトランザクションを作成できなくなります。
</Warning>

<div id="licensed-skills-reference">
  ## ライセンス対象の Skill リファレンス
</div>

| Skill名                                                                                                                | ライセンス名                          |
| --------------------------------------------------------------------------------------------------------------------- | ------------------------------- |
| Invoice US, EU, CA, ES, UA, AU-NZ, CN, Invoice Classifier                                                             | ABBYY.Invoice                   |
| Purchase Order US, EU, Purchase Order Classifier                                                                      | ABBYY.PurchaseOrder             |
| Receipt, Receipt CJK, Hotel Invoice, Taxi Receipt, Expense Management Classifier                                      | ABBYY.Receipt                   |
| Commercial Invoice                                                                                                    | ABBYY.CommercialInvoice         |
| Bill Of Lading                                                                                                        | ABBYY.BillOfLading              |
| Air Waybill                                                                                                           | ABBYY.AirWaybill                |
| 送金通知                                                                                                                  | ABBYY.RemittanceAdvice          |
| Utility Bill                                                                                                          | ABBYY.UtilityBills              |
| Bank Statement                                                                                                        | ABBYY.BankStatements            |
| Personal Earning Statement                                                                                            | ABBYY.PersonalEarningStatements |
| 到着通知                                                                                                                  | ABBYY.ArrivalNotice             |
| Form W-2, Wage and Tax Statement                                                                                      | ABBYY.IrsTaxFormW-2             |
| Form 1040, U.S. Individual Income Tax Return, Form 1040, U.S. Individual Income Tax Return 2022, Form 1040 Classifier | ABBYY.IrsTaxForm1040            |
| 原産地証明書                                                                                                                | ABBYY.CertificateOfOrigin       |
| Form 990, Return of Organization Exempt From Income Tax                                                               | ABBYY.Form990                   |
| Form 1098, Mortgage Interest Statement                                                                                | ABBYY.TaxForm1098               |
| 身分證件                                                                                                                  | ABBYY.IdReading                 |