Download1682: DataTables プラグイン

Title: DataTables プラグイン

特定の条件で集めた記事（タスク、プロジェクト、予定など）を jQuery DataTables によるテーブル形式（スプレッドシート形式）で表示します。

列として表示する項目のカスタマイズや、行数変更ドロップダウンやフィルターボックスの表示/非表示などを、ウィジェットのオプションで設定できます。

ページ当たりの表示行数変更、並び替え（ソート）、絞り込み（フィルター）、ページ切り替えなどもサポート。

SDL のライブラリとしても使用でき、開発者は、自分のプラグインから当ライブラリを呼び出して利用できます。

関連記事
Forum1404
DocJp1801: セクションテーブルウィジェット 2.0

動作例

当サポートサイトの最新の投稿 30 件

読み込み中...

ダウンロード

下のリンクをクリックしてプラグインの .zip ファイルをダウンロードします。

インストール

TeamPage にサーバー管理者としてログインし、サーバーセットアップ > プラグインページを開き、ページ下部の [新規プラグインのインストール] で .zip ファイルを指定してアップロードします。

アップロードが完了したら、サーバーセットアップ > 一般 > サーバー管理の [TeamPage の再起動] ボタンをクリックして TeamPage を再起動してください。TeamPage クラウド環境では再起動が 2 回必要ですので、1回目の再起動が完了したら再度 [TeamPage の再起動] ボタンをクリックして 2 度目の再起動を行ってください。

サーバーセットアップ > プラグインページを開き、[DataTables] プラグインが表示されていることを確認します。

以上でインストール作業は完了です。

ウィジェットの使い方

ウィジェットの挿入

記事本文のツールバーの [ウィジェットの挿入/編集] アイコンをクリックして表示されるウィジェットの一覧の中から [DataTables] を選択します。

ウィジェットの詳細を選択・記入して [OK] をクリックします。

[ID (DataTable 名)] と [列に表示する項目] は入力必須です。また、[ID (DataTable 名)] に使えるのは半角英数字だけで、スペース（空白文字）や記号などは使えません。

その他、オプションの詳細については後述します。

記事本文にウィジェットが挿入されたことを確認して記事を投稿（送信）します。

投稿された記事の中に DataTable が表示されます。

挿入されたウィジェットの操作

並び替え（ソート）

見出し行（テーブルの最も上の行）をクリックして並び替えができます。

既定のソート順は、最も左の列を基準にした昇順です。ウィジェットの詳細設定で変更できます。

ページあたりの行数の変更

左上に表示されるドロップダウンリストで、ページあたりの行数を変更できます。

なお、ドロップダウンリストを非表示にしたり、ドロップダウンリストの選択肢や初期値を変更したりできます。詳しくは、後述のウィジェットの詳細設定を参照してください。

絞り込み（フィルター）

右上の [フィルター] 欄にテキストを入力して絞り込み表示ができます。下図では「期限超過」を入力して締切を過ぎたタスクだけを表示しています。

優先度や担当者で絞り込んだ一覧へのリンク

優先度や担当者のリンクをクリックすると、クリックした内容の絞り込み（フィルター）が適用された状態の記事一覧画面が表示されます。記事ボリュームを変更して一覧を見やすくしたり、まとめて印刷、エクスポートなどができます。

ウィジェットの詳細オプション

タイトル

テーブルの上に表示されるタイトルを指定します。空欄にするとタイトルは表示されません。

ID (DataTable 名)

DataTable に名前をつけます。ここでは半角英数字のみが使え、空白文字（スペース）や記号は使えませんのでご注意ください。

リクエストするスペース

テーブルに表示される記事は、ここで指定されたスペースに投稿されたものが対象になります。

列に表示する項目

DataTable の列に表示するエントリーフィールド (Entry Field) の名前を記入します。半角カンマ記号で区切ってください。エントリーフィールドとは、簡単に言うと記事の属性（タイトル、投稿日時、投稿者、担当者、優先度など）のことで、標準で次のものが利用できます。

assigned
author_last_update
author_original
color
comment_target
completed
completion_status
count_attachments
count_comments
count_events
count_shares
count_tasks
count_xrefs_all
count_xrefs_incoming
count_xrefs_outgoing
date_created
date_lastmodified
date_sorting
due
duration
estimate
event_allday
event_date
event_duration
event_end
event_start
event_target
goal
invitees
location
members
milestone
moderation_status
owners
priority
project
share_target
start
subscribed
tags
task_start_to_completion
task_start_to_due
task_target
tasks_root
thread_root
title
tododone
tractionid

また、プラグインを導入している場合は、プラグインによって追加されたエントリーフィールドを利用できます。

リクエストの種類

テーブルに表示される記事の集め方を選択します。テーブル表示用の記事を検索する内部処理のリクエスト時に、<entries> SDL タグの type= パラメーターの値として使用されます。

リクエストのタグ

上記 [リクエストの種類] でタグによる方法を選択した場合に使用されるタグ名をここに記入します。

リクエストの記事タイプのフィルター

ここに記入する内容は、テーブル表示用の記事を検索する内部処理のリクエスト時に、<entries> SDL タグの entrytypesfilter= パラメーターの値として使用されます。

リクエストの検索書式

ここに記入する内容は、テーブル表示用の記事を検索する内部処理のリクエスト時に、<entries> SDL タグの search= パラメーターの値として使用されます。

リクエストのインデックスタイプ

ここに記入する内容は、テーブル表示用の記事を検索する内部処理のリクエスト時に、<entries> SDL タグの indextype= パラメーターの値として使用されます。

リクエストの期間範囲

テーブルに表示される記事の期間範囲（投稿日時の期間）を指定します。既定の [all] は「すべての期間」を表します。

リクエストの最大件数

ここに記入する内容は、テーブル表示用の記事を検索する内部処理のリクエスト時に、<entries> SDL タグの max= パラメーターの値として使用されます。

例えば、ここで「15」を指定すると、ヒット件数が「15」に達した時点で記事の取り出しを終了します。仮に、記事が100件あるとすると、初めの15件で終了するので、テーブルに表示されるのは15件（15行）だけになり、残りの85件はテーブルに表示されません。

ソートを有効にする

ここで [いいえ] を選択すると、テーブルのタイトル行をクリックしたときの並び替え（ソート）ができなくなります。

ソートの既定値

ソート（並び替え）順の既定値（デフォルト設定）を選択します。

ソートの既定の基準列番号

ソート（並び替え）の基準となる列の番号を指定します。最も左の列が「0」になります。

フィルターボックスを表示

テーブルの右上の [フィルター] ボックスを表示するかどうかを選択します。

詳細情報を表示

テーブルの左下の、表示中の件数などの詳細情報を表示するかどうかを選択します。

ページ切り替えを有効にする

テーブルの右下の、ページ切り替えボタンを表示するかどうかを選択します。ここで [いいえ] を選択すると、ページ切り替えは無効になり、該当する記事すべてが 1 ページに表示されます。

表示件数変更ドロップダウンを表示

テーブルの左上の、1 ページあたりの件数を切り替えるドロップダウンを表示するかどうかを選択します。

表示件数変更ドロップダウンの項目

表示件数変更ドロップダウンに表示される選択肢を指定します。既定は「10,25,50,100」です。半角コンマ記号で区切ってください。

ページ毎に表示する行数の初期値

テーブルの左上の、表示件数変更ドロップダウンの初期値を指定します。

開発者向けの使い方

テスト表示ビュー

検索ボックスに /type datatables_example を入力して Enter キーを押すと、下図の動作テスト画面が表示され、パラメーターの変更がどのように動作に反映されるのかをこの画面で確認できます。

SDL ライブラリとして使用する

セクションタイトル付き

プラグイン中の com/traction/sdl/datatables/parent.sdl の「datatable-section」関数を次の書式で呼び出します。

<com.traction.sdl.datatables.parent#datatable-section id="foo" proj="*" ... >

セクションタイトルを省略

プラグイン中の com/traction/sdl/datatables/parent.sdl の「datatable-iframe-div」関数を次の書式で呼び出します。

<com.traction.sdl.datatables.parent#datatable-iframe-div id="foo" proj="*" ... >

Attachments:

plugin_installed.png
widget1.png
widget2.png
widget3.png
widget4.png
widget5.png
widget6.png
widget7.png
DataTables_Example.png
entry_fields.png
datatables_image.png
datatables_logo.png

参照されている (3)

Download2241: TeamPage 6.2.31 リリースノート Download2004: 機材レンタル管理プラグイン DocDailyReports2: 必要なプラグインのインストール

参照している (1)

DocJp1801: セクションテーブルウィジェット 2.0

Article: Download1682 (permalink)
Categories: :DocJp:プラグイン
Date: 2016/06/08; 14時47分23秒 JST

Author Name: TeamPage サポート
Author ID: jpbo

動作例