:::(Info)To download, visit: Library.
:::
目的
「タイムライン」ウィジェットは、Tulipテーブルから記録されたイベントを表示するインタラクティブなウィジェットです。最新のレコードが最上部に表示されるため、常に最新の状態を把握できます。

設定
必須フィールド:- アグリゲーション ID(Tulip テーブルのアグリゲーション)- API キー(テキスト)- シークレット(テキスト)- アカウント URL(テキスト)
オプションのフィールド:- テキストを白くする(はい/いいえ) - 「はい」に切り替えると、フォント色が白になります。デフォルトは「いいえ」です。
このウィジェットを設定するには、APIキー、シークレット、およびURL(your-account.tulip.coのような形式)を指定する必要があります。 APIキーが何か分からない場合は、次のセクションを参照してください。あるいは、アプリエディタ内で(アプリを実行する前に)、ウィジェットのプロパティに情報を直接入力してウィジェットを設定することもできます。必要な情報を入力したら、ウィジェットを更新してください。 この時点で、テーブルにイベントがあれば、ウィジェットに表示されるはずです。このウィジェットは集計機能を使用しています。集計を通じて、ウィジェットにはイベント情報が表示されます。この集計機能がない場合、ウィジェットを最新の状態に保つためには、テーブルへの挿入のたびにウィジェットを更新する必要があります。
サービスアカウントの作成方法
Prior to r383, Service Accounts were called "API Tokens".
イベントテーブルにアクセスするには、「テーブル:読み取り」権限を持つサービスアカウントが必要です。インスタンスの設定セクションから「Tulip API」に移動し、サービスアカウントがあるかどうかを確認してください。ワークスペースが設定されている場合、これは「ワークスペース設定」の下にある可能性があります。すでにサービスアカウントをお持ちの場合は、その場所に一覧表示されます。「編集」をクリックし、スコープの下で「tables: read」にチェックが入っていることを確認してください。チェックが入っていれば準備は完了です。入っていない場合は、スコープを調整するか、新しいサービスアカウントを作成してください。サービスアカウントが存在しない場合は、「サービスアカウントを作成」ボタンをクリックして作成してください。任意の名前を付け、スコープを選択します。その際、「tables: read」にチェックが入っていることを確認し、必要に応じて他のスコープも選択してください。原則として、必要最小限の権限を割り当てることを推奨しますが、判断に迷う場合はすべてのオプションにチェックを入れても構いません。「作成」をクリックすると、シークレットキーを保存するよう指示するウィンドウが表示されます。この指示に従ってください。シークレットキーを紛失して再生成する必要が生じた場合、以前のシークレットキーが使用されているすべての場所で、新しいシークレットキーに更新する必要があります。
仕組み
テーブルに新しいレコードが追加されると、ウィジェットは自動的に更新されます。最新のイベントが最上部に表示されます。暗い背景でウィジェットを使用する場合は、フォントを変更することができます。
このテーブルは「タイムラインイベント」と呼ばれ、以下の列で構成されています:- ID (テキスト) - イベントの一意のID。自動的に生成されるべきもので、表示されることを意図したものではありませんが、必要です。- タイトル (テキスト) - イベントのタイトル。大きく表示されるため、簡潔にする必要があります。- 説明 (テキスト) - タイトルだけでは内容が十分に伝わらない場合、タイトルの下に表示される詳細情報を追加できます- タイプ (テキスト) - 以下のいずれか、または空欄にできます:success、error、warning、message、andon、pause、start、stop、msteams - タイプが指定されていない場合、または前述のいずれにも該当しない場合は、デフォルトのアイコンが表示されます - ウィジェット内では大文字小文字を区別せずに処理されます- 作成日 (メタデータ、非表示) - 「Tulip table 」内の各レコードには、変更できないがクエリで使用可能なメタデータ(作成日および更新日)が含まれています
