データ管理

データ保持ルール

データ保持ルールにより、データを保持する期間を制御することができます。デフォルトとして、60日経過した履歴データはすべて削除されます（プラットフォーム管理者がシステム設定で設定可能）。例えば、メジャーメントは90日間保存するが、アラームは10日間で削除するという設定も可能です。

データ保持ルールの表示

管理メニューの データ保持ルール をクリックすると、アカウントに設定されているデータ保持ルールの一覧が表示されます。

ルールごとに、ルール名、削除するデータの詳細（フラグメントタイプ、タイプ、ソースについては、以下を参照）および最大保持期間（日数）が表示されます。

アスタリスク（*）は、どの値のデータもクリーンアップされることを示します。

データタイプ

次のデータタイプが、データ保持ルールの対象となります。

• アラーム
• 監査
• 一括操作
• イベント
• 計測値
• 操作

データ保持ルールの追加

1. トップメニューバーの ルールを追加 をクリックします。
2. 表示されたダイアログボックスより、クリーンアップしたいデータタイプを選択します（アラーム、計測値、イベント、操作、一括操作、監査、またはすべて）。
3. クリーンアップするデータをもっと細かく設定したい場合、フラグメントタイプを入力します。このルールに従ってすべての接続無効アラームをクリーンアップしたい場合、データタイプに「アラーム」を選択し、タイプ 欄に「c8y_UnavailabilityAlarm」と入力します。
4. 特定のデバイスからのデータのみ削除したい場合、デバイスIDを ソース 欄に入力します。
5. 最大保持期間（日） を日数単位で入力します（最大許容値は10年分の日数です）。
6. 保存 ボタンをクリックして設定を保存します。

これで、データ保持ルールは一覧に追加されます。

データ保持ルールの編集

編集したいルールの行をクリックし、表示された「データ保持ルールを編集」画面より編集してください。

それぞれのフィールドの詳細については、データ保持ルールの追加を参照してください。

保持ルールの削除する

削除するルールが含まれる行にマウスを置き、右側に表示される削除アイコン をクリックします。

すべてのデータ保持ルールは、互いに独立して順番に実行されます。したがって、2つのデータ保持ルールがある場合、最大保持期間がより長い具体的なルールと、最大保持期間がより短い一般的なルールで定義されているドキュメントのサブセットを定義します。すると、より一般的な単一のルールがあるかのように効果的に機能します。

例えば、次の 2 つのルールがあるとします。

ソースが 12345 に等しいものを含め、30日以上経過した c8y_Temperature タイプのすべてのメジャーメントが削除されます。

一方、次のデータ保持ルールが定義されている場合:

データ保持プロセスは、30日以上経過したタイプ c8y_Temperature のメジャーメントを削除します。他のすべてのメジャーメントは、60日以上経過すると削除されます。

ファイルリポジトリ

ファイルリポジトリでは、アカウントに保存されているファイルの概要が表示されます。

管理メニューのファイルリポジトリをクリックして、ファイルの一覧を表示します。

ここで表示されるファイルはさまざまなソースから取得されます。これらは、ソフトウェア画像、デバイスから取得した構成スナップショット、デバイスからのログファイル、すべてのアプリケーション画面からアップロードしたWebアプリケーションがあります。

ファイルごとに、ファイル名、所有者、ファイルタイプ（image/bmp、text/csvなど）、サイズ、および最終更新日が表示されます。 ファイルタイプがサポートされている場合は、ファイル名の横にある虫眼鏡アイコンをクリックしてプレビューできます。ファイル行にマウスを移動したときに表示されるアクションボタンをクリックすると、ファイルをダウンロードまたは削除できます。一部のファイル（アプリケーション アーカイブなど）は、このページから削除できないことに注意してください。

フィルターまたは検索入力を使用して、特定のファイルを検索できます。詳細については、検索とフィルター機能を参照してください。デフォルトでは、ファイルはファイル名で並べ替えられます。並べ替えを変更するには、デフォルトのフィルターを削除し、一覧をフィルターするための独自の基準を定義します。

ファイルシステムからファイルをアップロードする

トップメニューバーで ファイルをアップロード をクリックします。表示されるダイアログボックスで、ファイルシステムを参照するか、ファイルをドロップしてアップロードするファイルを選択します。選択したファイルは表示リストに表示されるので、アップロード をクリックしてアップロードを確認します。

アカウントからファイルをダウンロードする

各行の右側にあるダウンロードアイコン をクリックします。

アカウントからファイルを削除する

削除したいファイルを含む行にマウスを移動し、右側にある削除アイコン をクリックします。

複数ファイルの削除

削除したい各ファイルの横にあるチェックボックスを選択するか、表の上部にあるチェックボックスをクリックして表示されているすべてのファイルを選択します。表のヘッダーには、選択したファイル数と利用可能なアクションが表示されます。削除をクリックし、削除を確認します。

最新のメジャーメント値

PUT /tenant/options/measurement.series.latestvalue
{
  "c8y_Humidity.H":"", // 単一シリーズ c8y_Humidity.H を有効にする
  "c8y_Temperature.*":"" // フラグメント c8y_Temperature に基づくシリーズを有効にする
  // または "*":"" ですべてを有効にする
}

POST /measurement/measurements
{
  "source":"5413"
  "time":"2024-02-01T10:00:00Z"
  "c8y_Temperature":{
     "T": {
        "value": 15,
        "unit":"C"
     }
  }
  "c8y_Speed":{
    "S": {
      "value": 15,
      "unit":"m/s"
    }
  }
}

GET /inventory/managedObjects/5413?withLatestValues=true
{
   ...
   "c8y_LatestMeasurements":{
        "c8y_Temperature":{
           "T":{
             "value":15,
             "time":"2024-02-01T10:00:00Z",
             "unit":"C"
           }
        }
   }
}

GET /inventory/managedObjects?withLatestValues=true&query=$filter=c8y_LatestMeasurements.c8y_Temperature.T.value+gt+10
{
  managedObjects: [
    {
        ...
        "c8y_LatestMeasurements":{
            "c8y_Temperature":{
                "T":{
                    "value":15,
                    "time":"2024-02-01T10:00:00Z",
                    "unit":"C"
                }
            }
        }
    }
  ]
}