> ## Documentation Index
> Fetch the complete documentation index at: https://domoinc-bradley-turek-pfilter-operators-reference.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Content Governance Hub

## はじめに

この記事では、Content Governance Hubをインストールし、アーカイブの候補となるカードやダッシュボードを特定し、アーカイブおよび復元ワークフローを実行し、アーカイブ条件をカスタマイズする方法について説明します。

***

## アーカイブプロセスについて理解する

Content Governance Hub（CGH）は、使用されていないコンテンツを特定してアーカイブする、パッケージアプリとワークフローのセットです。アプリは、経過時間、使用状況、関連性などの条件に基づいてどのオブジェクトがアーカイブの候補であるかを明らかにし、ワークフローがアーカイブ自体を自動化します。

プロセスは、準備（Preparation）と実行（Execution）の2つのフェーズに分かれています。

<Frame>
  <img src="https://mintcdn.com/domoinc-bradley-turek-pfilter-operators-reference/zjcJUc2WU06RpJ5G/images/kb/content-governance-hub-process-architecture.png?fit=max&auto=format&n=zjcJUc2WU06RpJ5G&q=85&s=3fb1e23a0acfb24ce13d40f74f94d544" alt="準備フェーズが実行フェーズにつながるContent Governance Hubのプロセス" width="1786" height="802" data-path="images/kb/content-governance-hub-process-architecture.png" />
</Frame>

* **準備 —** DomoStats、Domo GovernanceデータセットおよびExceptions（例外）データセットがクリーンアップデータフローに供給され、それがCGHアプリで可視化されます。アプリでは、クリーンアップ作業を開始する前に、どのコンテンツに対応が必要かを特定できます。
* **実行 —** アーカイブワークフローが、クリーンアップデータフローで設定された条件に基づいて、ダッシュボードとカードをアーカイブします。

クリーンアップデータフローは、事前定義された条件を使用してアーカイブするコンテンツを判断します。組織の要件に合わせてカスタマイズできます。

## Content Governance Hubをインストールする

Content Governance Hubをデプロイするには、Domoアカウントチームにお問い合わせください。

## アーカイブするコンテンツを特定する

アーカイブデータフローが初めて実行されると、CGHアプリにデータが取り込まれます。 **［Content Summary］** タブには、「クリーンアップデータフローについて理解する」で説明されている条件に基づいて、アーカイブの対象となるコンテンツが表示されます。

<Frame>
  <img src="https://mintcdn.com/domoinc-bradley-turek-pfilter-operators-reference/zjcJUc2WU06RpJ5G/images/kb/content-governance-hub-content-summary.png?fit=max&auto=format&n=zjcJUc2WU06RpJ5G&q=85&s=0375a11858d6c2e56f053fd4d79435c3" alt="コンテンツタイプ、アーカイブ候補、コンテンツ数を表示するCGHアプリのContent Summaryタブ" width="2340" height="1225" data-path="images/kb/content-governance-hub-content-summary.png" />
</Frame>

<Note>**注記：** アプリはデータセット、データフロー、コネクターデータセットをアーカイブ候補として表示しますが、現在これらのオブジェクトタイプのアーカイブはサポートされていません。ワークフローがアーカイブするのはカードとダッシュボードのみです。</Note>

## ワークフローを起動して操作する

アーカイブおよび復元ワークフローは、 **［Launch Workflows］** タブから起動します。デプロイ後、CGHアプリ内からワークフローを起動する必要があります。

<Frame>
  <img src="https://mintcdn.com/domoinc-bradley-turek-pfilter-operators-reference/zjcJUc2WU06RpJ5G/images/kb/content-governance-hub-workflow-launch.png?fit=max&auto=format&n=zjcJUc2WU06RpJ5G&q=85&s=7eec2796500feed689704566b0e666fb" alt="推定クレジット消費量とアーカイブ対象コンテンツのリストを表示するArchiving Workflow Launch画面" width="2338" height="1350" data-path="images/kb/content-governance-hub-workflow-launch.png" />
</Frame>

この画面には、アーカイブ時に消費されるクレジット数と、アーカイブするオブジェクトが表示されます。

<Tip>**ヒント：** 重要なコンテンツが誤ってアーカイブされないように、ワークフローを実行する前にアーカイブするコンテンツを確認してください。アーカイブ条件を変更した後は、最新のデータが使用されるようにデータフローを再実行してください。</Tip>

アーカイブされるコンテンツを変更するには、「アーカイブ条件をカスタマイズする」および「例外を考慮する」を参照してください。

## クリーンアップデータフローについて理解する

クリーンアップデータフローは、ワークフローがDomo内のどのコンテンツをアーカイブするかを特定します。複数のDomoStatsソースを組み合わせて、コンテンツが使用されていないためアーカイブすべきかどうかを判断します。

Content Governance Hubは、アプリとともに4つのデータフローで構成されています。

* **Master | CGH**
* **Customization | CGH**
* **Restoration | CGH**
* **Dataset Tagging | CGH**

<Frame>
  <img src="https://mintcdn.com/domoinc-bradley-turek-pfilter-operators-reference/zjcJUc2WU06RpJ5G/images/kb/content-governance-hub-dataflow-architecture.png?fit=max&auto=format&n=zjcJUc2WU06RpJ5G&q=85&s=f88ba86f344f1fd2f3827f30b4573e6d" alt="CGHアプリに供給される4つのCGHデータフローのリネージ" width="1282" height="733" data-path="images/kb/content-governance-hub-dataflow-architecture.png" />
</Frame>

### アーカイブ条件を確認する

各コンテンツタイプのアーカイブ条件は異なりますが、一般的には最終使用日がコンテンツがアクティブかどうかを判断する主な要素となります。次の表に既定の条件を示します。コンテンツがアーカイブされるには、特に明記されていない限り、すべての条件を満たす必要があります。

| コンテンツ                           | 既定のアーカイブ条件                                                                                                                                                   |
| ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **カード**                         | 最終使用日はアクティビティログから取得されます。過去90日間にカードに対するあらゆるタイプのアクションがなく、過去90日間にカードが存在するダッシュボードに対するあらゆるタイプのアクションがないこと。                                                         |
| **ダッシュボード**                     | 最終使用日はアクティビティログから取得されます。過去90日間にダッシュボードに対するあらゆるタイプのアクションがないこと。                                                                                                |
| **データセット + データフロー / データセットビュー** | 最終使用日はアクティビティログから取得されます。過去90日間にデータセットに対する `UPDATED` 以外のアクションがなく、データセットにアーカイブされていない子カード、データセットビュー、データフローがないこと。入力データフローの場合、同じ条件がそのすべての出力（リンクされた）データセットに適用されます。 |
| **コネクターデータセット**                 | 過去90日間にデータセットに対する `UPDATED` 以外のアクションがなく、データセットに子カード、データセットビュー、データフローがないこと。                                                                                   |

<Note>**注記：** これらは既定の条件ですが、データフローをカスタマイズして条件を変更できます。データフローには、使用可能な追加属性がすでに多数含まれています。「アーカイブ条件をカスタマイズする」を参照してください。</Note>

### 使用可能な追加属性を確認する

データフローは、コンテンツがアーカイブされるべきかどうかの判断には使用しない追加のメタデータを各コンテンツタイプに読み込みます。データフローを変更して、これらの属性をアーカイブ条件に含めることができます。これらの属性には、追加であることを示すために `[E]` というプレフィックスが付いています。

| コンテンツ               | 追加属性                                                                                                     |
| ------------------- | -------------------------------------------------------------------------------------------------------- |
| **カード**             | Page ID、Page Name、Scheduled Report、Sandbox Repository、Certified、Alerts                                   |
| **ダッシュボード**         | Scheduled Report、Sandbox Repository、Publish                                                              |
| **データセット + データフロー** | Sandbox Repository、Certified、Alerts、Import Type、Rows、Archived children、Linked archived children、Children |
| **コネクターデータセット**     | Import Type、Archived children、Linked archived children、Children                                          |

### アーカイブデータセットのディクショナリを確認する

以下のフィールドは、アーカイブデータセットで使用できます。データセットの粒度は重複のないオブジェクトレベルであるため、一部のフィールドは集計されているか、オブジェクトが最後に使用された時刻を参照します。これは、複数のダッシュボードに存在するカードや、複数の子を持つデータセットの場合に特に関連します。

| フィールド名                        | 説明                                                      |
| ----------------------------- | ------------------------------------------------------- |
| Type                          | Card、Dashboard、DataSet + DataFlow、Connectorなどのコンテンツタイプ。 |
| Object ID                     | コンテンツのDomo ID。                                          |
| Object Name                   | コンテンツのDomo名。                                            |
| Action                        | アクティビティログからの最後のアクションタイプ。                                |
| Last used date                | コンテンツが最後に使用された日付。                                       |
| Dataflow ID                   | データセットのソースデータフローのID。                                    |
| Linked Dataset Last used date | リンクされたデータセットの最終使用日。                                     |
| Linked Dataset Count          | リンクされたデータセットの数。                                         |
| Unarchived                    | アーカイブされていない子の数。                                         |
| Linked Unarchived             | リンクされたアーカイブされていない子の数。                                   |
| Archiving period              | コンテンツが未使用と見なされるまでの、ユーザーが定義する期間。                         |

次の追加属性フィールドも使用できます。

| フィールド名             | 説明                                           |
| ------------------ | -------------------------------------------- |
| Page ID            | カードオブジェクトのみ。カードが最後に使用されたときに存在していたダッシュボードのID。 |
| Page Name          | カードオブジェクトのみ。カードが最後に使用されたときに存在していたダッシュボードの名前。 |
| Scheduled Report   | コンテンツがScheduled Reportで使用されているかどうかを示します。     |
| Sandbox Repository | コンテンツがSandboxリポジトリで使用されているかどうかを示します。         |
| Certified          | コンテンツが認定されているかどうかを示します。                      |
| Alerts             | コンテンツに対するアラートの数を示します。                        |
| Publish            | コンテンツがDomo Publishで使用されているかどうかを示します。         |
| Import Type        | データソースのタイプ。                                  |
| Rows               | 行数。                                          |
| Archived           | アーカイブされた子の数。                                 |
| Linked Archived    | リンクされたアーカイブ済みの子の数。                           |
| Children           | データセットの子のカンマ区切りリスト。                          |

### リンクについて理解する

アーカイブデータセットでは、リンクの概念が何度か登場します。次の図は、リンクの意味を示しています。

<Frame>
  <img src="https://mintcdn.com/domoinc-bradley-turek-pfilter-operators-reference/zjcJUc2WU06RpJ5G/images/kb/content-governance-hub-linking-diagram.png?fit=max&auto=format&n=zjcJUc2WU06RpJ5G&q=85&s=a43fd63868aa9d301e6b7e09e01d45c5" alt="入力データフローが3つのデータセットとその子カードおよびデータセットを生成するリンク図" width="759" height="399" data-path="images/kb/content-governance-hub-linking-diagram.png" />
</Frame>

この例では、入力データフローが3つの出力データセットを生成し、すべて現在アーカイブされていません。

* データセット1には2つの子カードがあります。
* データセット2には1つの子カードがあります。
* データセット3には子カードと子データセットがあります。

3つのデータセットはすべて同じ入力データフローを共有しているため、各データセットのリンクされたアーカイブされていない子の数には、そのデータフローによって生成されたすべてのデータセットの子が含まれます。

| データセット  | データフロー   | アーカイブされていない子 | リンクされたアーカイブされていない子 |
| ------- | -------- | ------------ | ------------------ |
| データセット1 | 入力データフロー | 2            | 5                  |
| データセット2 | 入力データフロー | 1            | 5                  |
| データセット3 | 入力データフロー | 2            | 5                  |

## アーカイブ条件をカスタマイズする

アーカイブ条件は **Customization** データフローで設定します。ロジックは各コンテンツタイプの数式タイル内で定義されており、必要に応じて条件を調整できます。

<Frame>
  <img src="https://mintcdn.com/domoinc-bradley-turek-pfilter-operators-reference/zjcJUc2WU06RpJ5G/images/kb/content-governance-hub-archiving-criteria-tiles.png?fit=max&auto=format&n=zjcJUc2WU06RpJ5G&q=85&s=29d006692c1e44e1128fb3b039cc8db1" alt="各コンテンツタイプのアーカイブ条件と例外の数式タイルを示すCustomizationデータフロー" width="562" height="1105" data-path="images/kb/content-governance-hub-archiving-criteria-tiles.png" />
</Frame>

<Warning>**重要：** アーカイブ条件への調整は、対応する例外の数式タイルにもコピーして、コンテンツがアーカイブ候補である理由、またはそうでない理由をユーザーが理解できるようにしてください。</Warning>

すべてのコンテンツに適用されるカスタム条件を指定するには、最後の数式タイル（アーカイブの事前ステップ）を使用します。

<Frame>
  <img src="https://mintcdn.com/domoinc-bradley-turek-pfilter-operators-reference/zjcJUc2WU06RpJ5G/images/kb/content-governance-hub-archiving-prestep-tiles.png?fit=max&auto=format&n=zjcJUc2WU06RpJ5G&q=85&s=2cfcd07d95d59096c0a9f7dfc10ef773" alt="「Change Null Owners to No Owner」、「Rank and Window」、「Add Formula」などのアーカイブ事前ステップの数式タイル" width="640" height="331" data-path="images/kb/content-governance-hub-archiving-prestep-tiles.png" />
</Frame>

### 入力Webフォームにパラメータを入力する

アーカイブプロセスにパラメータを入力するために、4つのWebフォームを使用できます。

* **Archiving Parameters | Archiving —** コンテンツが未使用と見なされるまでの期間を調整します。既定は90日です。
* **Override | Archiving —** データフローの条件を満たしていなくてもアーカイブしたいコンテンツを指定します。
* **Exclusions | Archiving —** 決してアーカイブしないオブジェクトを指定します。
* **Restoration Input | Archiving —** 復元ワークフローが復元するオブジェクトを指定します。

<Note>**注記：** データフローのスキルに自信がある場合は、アーカイブのニーズに合わせて任意のCGHデータフローを調整できます。CGHに今後拡張が加えられると、それらはSandboxを使用してプッシュされるため、加えた変更が上書きされる可能性があります。事前にDomoから通知され、拒否することもできます。</Note>

## 例外を考慮する

データフローはオブジェクトが使用されているほとんどのケースを判断できますが、注意すべき例外がいくつかあります。

| コンテンツ                                  | 推奨される代替策                                               |
| -------------------------------------- | ------------------------------------------------------ |
| APIによって直接アクセスされるデータセット（常に検出されるとは限りません） | Exclusionsリストに含めます。                                    |
| 定期的なコンテンツ（年に1回だけ使用される財務レポートなど）         | Exclusionsリストに含めます。                                    |
| 公開されたコンテンツ                             | 公開コンテンツのDomoStatsデータは信頼性が低い場合があります。Exclusionsリストに含めます。 |
| DataFusion                             | メタデータのデータソースが現在ないため、含まれません。                            |
| Domoパッケージアプリ                           | Domoパッケージアプリで使用されるデータセットやカードを認定します。                    |
| 増分ロード（アップサートおよびパーティションなど）              | ソースデータが他に存在しない場合は、Exclusionsリストに含めます。                  |

## コンテンツがアーカイブされる仕組みを理解する

データフローとは異なり、ワークフローはシンプルで直接的です。サポートされている各コンテンツタイプに1つずつ、2つのアーカイブワークフローがあります。

### カードをアーカイブする

カードのアーカイブは次のプロセスに従います。

1. アーカイブグループがカードにオーナーとして追加されます。このグループはプロセスの事前設定済みパラメータです。
2. カードがすべてのダッシュボードから削除されます。
3. カードがアーカイブダッシュボードに追加されます。このダッシュボードは事前設定済みパラメータです。
4. アーカイブグループ以外のすべてのオーナーが削除されます。
5. カードのタイトルが変更され、 `[Archiving]` が含まれます。
6. その他のすべてのユーザーが削除されます。

### ダッシュボードをアーカイブする

ダッシュボードのアーカイブは次のプロセスに従います。

1. アーカイブグループがダッシュボードにオーナーとして追加されます。このグループは事前設定済みパラメータです。
2. ダッシュボードがアーカイブダッシュボードのサブダッシュボードに移動されます。このダッシュボードは事前設定済みパラメータです。
3. ダッシュボードのタイトルが変更され、 `[Archiving]` が含まれます。
4. アーカイブグループ以外のすべてのオーナーが削除されます。
5. その他のすべてのユーザーが削除されます。

## アーカイブされたコンテンツを復元する

復元ワークフローを使用して、アーカイブされたコンテンツを復元できます。

### カードを復元する

カードの復元では、カードの名前、オーナー、グループが復元されます。

### ダッシュボードを復元する

ダッシュボードの復元では、ダッシュボードが元の親ダッシュボードに戻され、その名前、オーナー、グループが復元されます。
