Datalynxのタグ
Datalynxタグは、ビュー設定でプレースホルダーとして使用される特別なパターンです。設定に挿入されたこれらのタグは、ビュー内で動的に作成されたデータに置き換えられます。
例1:タグ## author:firstname ##がビュー設定 "entry template"に配置されています。ユーザ "Micheal Mulley"が新しいエントリを作成します。このエントリの所有者はMicheal Mulleyです。エントリを表示すると、「ビュー設定」でタグ## author:firstname ##が設定された場所に「Micheal」が表示されます。著者の名はユーザーのプロフィールフィールドから取得されます。
例2:タグ[[私のお気に入りの映画]]はビューの "entry template"設定に置かれています。 「管理 - >フィールド」で「私のお気に入りの映画」というフィールドが作成される前(タイプ:テキスト)。ユーザは、デフォルトビューで「新しいエントリを追加する」ボタンをクリックします。ユーザーが自分のお気に入りのフィルムをフォームに入力できるフォームが、[[私のお気に入りのフィルム]]がビュー設定の "entry template"に配置された正確な場所に表示されます。
Datalynxタグタイプ
datalynxタグにはさまざまな種類があります。それらは「配置できる場所」と「操作できるデータ」に分けられます。
- Datalynxフィールドタグ:これらのタグは、エントリ内のフィールドの値を表示します。編集モードでは、データ入力に使用されるフォーム要素が表示されます。 Datalynxフィールドタグは、ビューの設定の「エントリテンプレート」セクションでのみ使用できます。
- datalynxフィールドタグのパターン:これは、ビュー設定でプレースホルダーとして使用されるパターンです。
- [[fieldname]]これはentrの中のフィールドの値を表示します。
- [[fieldname @]]これは「フィールドラベル」の内容を表示します。それ自体に条件付きテキストが含まれます(つまり、フィールドの説明とフィールド値自体を意味します。フィールド値が空の場合はフィールドラベルまったく表示されません)。フィールドラベルの詳細な説明は[[Datalynx Fields | Fields]]をご覧ください。
- [[fieldname:restricted]]機能mod / datalynx:editrestrictedfieldsを持つユーザーのみがこのフィールドを編集または表示できます。デフォルトでは、ロールマネージャだけが機能を持ちます。
- datalynxフィールドタグのパターン:これは、ビュー設定でプレースホルダーとして使用されるパターンです。
- Datalynx一般タグ:これらのタグは、さまざまな種類の情報のプレースホルダーとして機能します。たとえば、作者に関する情報、エントリID、別のビューへのリンクなどです。
Datalynxタグの場所
タグを置く場所には2つの主な場所があり、その他のまれなユースケースもあります。主な場所は、ビュー "ビューテンプレート"と "エントリテンプレート"の設定にあります。
- テンプレートの表示:これらのタグには、以下のプロパティがあります。
- 単一エントリのデータを処理しません
- 彼らは単一のユーザーのデータを扱いません
- 一般的なビュープロパティのデータを処理します。 例: ## quicksearch ##は、すべてのエントリを検索するためのキーワードを入力するための検索フィールドを提供します。
- 入力テンプレート
- 単一のエントリに関連するユーザーデータ。 例: ## author:lastname ##は、エントリ自体の中にあるエントリの著者の姓を表示します。
- 単一のエントリに関連するエントリプロパティ。 例:エントリのID ## entryid ###
- フィールドタグこれらのタグは、1つのエントリでさまざまな種類のデータを表示および編集するために使用されます。 例: [[duration]]はデュレーションを表示します。フィールドはビューで使用される前に "Manage - > Fields"で定義されなければなりません。この場合、フィールドはタイプ "期間"です。
- その他のタグ:これらには、エントリを承認するためのアクションタグ、コメントまたは評価タグのためのコメントタグが含まれます。
- その他の場所
- タグ内例: PDFをダウンロードするためのダウンロードリンクを作成するためのタグには、PDFとしてエクスポートする必要があるエントリのエントリIDを含めることができます。
タグ一覧
タグ | 説明 | 例/結果 | 場所 |
## viewurl ## | 現在のビューのURL | https://www.example.com/mod/datalynx/view.php?d=3&view=4 | ビューテンプレート、エントリテンプレート |
## viewurl:ビュー名## | 現在のdatalynx.view-name内の名前view-nameを持つビューのURL:リンクされているビューの名前。link-text:リンクのテキスト。 HTMLでも構いませんが ';'または、「;」を含むHTML特殊文字エディタモードで入力した場合は使用できません。特別なリンクテキストパターンは表示テーマアイコンを可能にします、例えば_pixicon:f / pdf:ダウンロード、_pixicon:i / edit:編集等。url-query:リンクのビューURLに追加されるURLクエリパラメータ。これらは|で区切られたarg = valのペアです。引数はターゲットビューによって有効になることが期待されます。 valは入力パターンにすることができます。 | #{{viewlink:Certificate; _pixicon:f / pdf:ダウンロード; pdfexportentry = ## entryid ## | dest = D | docname = [[CertID]] - [[CertYear]] [[CertMonth]];}}# | 入力テンプレート |
#{{viewlink:ビュー名;リンクテキスト; URLクエリ;}}# | 各datalynxビューの表示リンク。 | #{{viewlink:写真のリスト;写真のリストを開くにはここをクリック;;}}#
| 入力テンプレート |
#{{viewsesslink:ビュー名;リンクテキスト; URLクエリ;}}# | 上記と同じですが、セッションキーがURLに追加されています。 | #{{viewsesslink:Single; _pixicon:i / edit:Edit; editentries = ## entryid ##;}}#このテンプレートをエントリテンプレートに追加すると、Singleというビューにリンクされた編集アイコンが表示され、エントリが開きます。そのビューの編集モード。 | 入力テンプレート |
##承認## | エントリを承認/未承認にします。 「承認」が活動設定に設定されていることが必要 | エントリを承認するためのボタン。ボタンは現在のステータスを表示し、ステータスはAJAXを介して更新されます(ページ全体をリロードすることなく) | 入力テンプレート |
## edit ## | この特定のエントリを編集するためのリンク付きのアイコンを表示します。ユーザーがエントリを編集する権限を持っている場合にのみ表示されます。 | 入力テンプレート | |
##削除## | この特定のエントリを削除するためのリンク付きのアイコンを表示します。ユーザーがエントリを削除する権限を持っている場合にのみ表示されます。 | 入力テンプレート | |
## ##を選択 | マルチ編集目的のためのチェックボックス。表形式で自動的に追加 | 入力テンプレート | |
##輸出する## | この特定のエントリをエクスポートするためのリンクを生成します。 | 入力テンプレート | |
##重複## | エントリを複製する | 入力テンプレート | |
##状態## | 編集モードの場合のみ:エントリのステータス(下書きまたは最終提出)を選択するためのドロップダウンを表示します。最終提出が選択された場合、エントリはもう編集できません。 | 入力テンプレート | |
##コメント## | エントリに追加されたコメントを表示 | 入力テンプレート | |
##コメント:##を数える | このエントリに追加されたコメントの数を表示 | 入力テンプレート | |
##コメント:インライン## | コメントをインラインで表示 | 入力テンプレート | |
##アンカー## | TBC | 入力テンプレート | |
##もっと## | 「管理」→「ビュー」で定義されているビューへのリンクを「M」として作成します。 | 入力テンプレート | |
## moreurl ## | https://www.example.com/somelinkの形式でURLのみを作成します。このリンクをカスタムHTMLタグに入れることができます。 | 入力テンプレート | |
## entryid ## | エントリのIDを表示します | 入力テンプレート | |
## group:id ## | グループIDを表示します | 入力テンプレート | |
##グループ名## | グループ名を表示 | 入力テンプレート | |
## group:picture ## | グループ写真を表示 | 入力テンプレート | |
## group:##を編集 | 編集モードの場合:グループを変更/選択できます | 入力テンプレート | |
## rating:rate ## | 評点を選択するためのドロップダウンメニューを表示する | 入力テンプレート | |
## rating:ビュー## | コメントの評価を表示 | 入力テンプレート | |
## rating:viewinline ## | 評価をインラインで表示する | 入力テンプレート | |
## rating:avg ## | 平均評価を計算して表示します | 入力テンプレート | |
## rating:count ## | 評価数を表示します | 入力テンプレート | |
##評価:最大## | 最大を表示します。評価 | 入力テンプレート | |
## rating:min ## | 最低評価を表示 | 入力テンプレート | |
## rating:sum ## | すべての評価の合計を表示します | 入力テンプレート | |
## author:id ## | エントリの作成者/所有者のIDを表示します | 入力テンプレート | |
##作者:名前## | Moodleサイトの設定に応じて、著者の完全ローカライズ名を表示します。 | 入力テンプレート | |
##作者:編集## | 編集モードの場合:エントリの作成者を選択するためのドロップダウンを表示します。デフォルト:現在のユーザ | 入力テンプレート | |
##著者:ファーストネーム## | 著者の名前を表示します | 入力テンプレート | |
##作者:姓## | 著者の姓を表示します | 入力テンプレート | |
##作者:ユーザー名## | 著者のユーザー名を表示します | 入力テンプレート | |
##作者:idnumber ## | 著者のIDを表示します | 入力テンプレート | |
##作者:絵## | 作者のユーザープロフィール写真を表示します | 入力テンプレート | |
##著者:picturelarge ## | 作者のユーザープロフィール写真を表示します | 入力テンプレート | |
##作者:メールアドレス## | 作者のEメールを表示します | 入力テンプレート | |
## numentriestotal ## | 全エントリ数を表示 | テンプレートを表示 | |
##表示された## | 現在のページの全エントリ数を表示します | テンプレートを表示 | |
## viewurl ## | 現在のビューのURLを表示します | テンプレートを表示 | |
## viewsmenu ## | ビューを選択するためのドロップダウンメニューを表示します。 | テンプレートを表示 | |
##フィルタメニュー## | フィルタを選択するためのドロップダウンメニューを表示します。 | テンプレートを表示 | |
##クイックサーチ## | すべてのエントリを検索するために検索キーワードを入力するための入力フィールドを表示します。 | テンプレートを表示 | |
## quickperpage ## | 1ページに表示するエントリ数を選択するためのドロップダウンメニューを表示します。 | テンプレートを表示 | |
## advancedfilter ## | ユーザーに多くの基準に従って正確な検索を実行する可能性を与えるために、高度なフィルターを表示します | テンプレートを表示 | |
## addnewentry ## | 新しいエントリを追加するためのリンクを表示する | テンプレートを表示 | |
## addnewentries ## | 新しいエントリを追加するためのリンクを表示する | テンプレートを表示 | |
## selectallnone ## | [すべてを選択する]チェックボックスを表示する | 入力テンプレート | |
## multiduplicate ## | 複数のエントリを複製するには、「複製」というテキストラベルのボタンを表示します | 入力テンプレート | |
## multiduplicate:icon ## | 複数のエントリを複製するために、複製記号付きのボタンを表示します。 | 入力テンプレート | |
##マルチエディット## | 複数のエントリを編集するためのテキストラベル「edit」の付いたボタンを表示します | 入力テンプレート | |
## multiedit:icon ## | 複数のエントリを編集するための編集記号付きのボタンを表示します。 | 入力テンプレート | |
## multidelete ## | 複数のエントリを削除するには、テキストラベル「削除」のボタンを表示します。 | 入力テンプレート | |
## multidelete:icon ## | 複数のエントリを削除するための削除記号付きのボタンを表示します。 | 入力テンプレート | |
##マルチ承認## | テキストラベル「承認」のボタンを表示して複数のエントリを承認します | 入力テンプレート | |
## multiapprove:icon ## | 複数のエントリを承認するための承認記号付きのボタンを表示します。 | 入力テンプレート | |
## multiexport ## | 複数のエントリをエクスポートするためのテキストラベル「エクスポート」のボタンを表示します | 入力テンプレート | |
## multiexport:icon ## | 複数のエントリをエクスポートするためのエクスポート記号付きのボタンを表示します。 | 入力テンプレート | |
##マルチインポート## | 現在サポートされていません | 入力テンプレート | |
## multiimporty:icon ## | 現在サポートされていません | 入力テンプレート | |
## pagingbar ## | ページング情報と前/次のボタンを含むナビゲーションバーを表示する | テンプレートを表示 | |
##改ページ## | 書き出されたPDFのエントリの後に改ページを挿入する | ||
フィールドタグ
フィールドタグは単純なパターンを持ちます。フィールド名は二重角括弧で囲まれます。
[[フィールド名]]。すべてのフィールド名は、ビュー設定の「入力テンプレート」のテキスト領域のすぐ下にあるドロップダウンメニューにあります。
タグのバリエーション:
- [[fieldname]]:ビューモードでフィールドの値を表示し、編集モードでデータを入力するためのフォーム要素を表示します。
- [[* fieldname]]:フィールド名の前にアスタリスクが付いている場合、エントリの作成/編集時にそのフィールドは必須になります。フィールドに入力しないと、エントリは保存されず、フィールドに入力するようにエラーメッセージが表示されます。
- [[fieldname @]]:フィールドの「フィールドラベル」の設定で定義されているように、追加のテキスト/ HTMLでフィールドの値を表示します。これは、フィールドに値が設定されている場合にのみフィールドの説明を表示するためによく使用されます。編集モードでは、フォームは常にフィールドの「フィールドラベル」の設定で定義されたとおりにレンダリングされます。
- [[fieldname:restricted]]:このフィールドを編集または表示できるのは、mod / datalynx:editrestrictedfields権限を持つユーザーだけです。デフォルトでは、ロールマネージャだけが機能を持ちます。
一括編集タグ
これらのタグは、一括編集用に最適化された「表形式」でのみ使用してください。タグはテーブルヘッダに配置されます。
%% fieldname:bulkedit %%
表形式ビューのテーブルヘッダーに配置すると、その列のチェックボックスが表示され、列の一括編集が有効になります(1列はフィールド、エントリは行で表示されます)。編集モードでは、最初の行(表形式ビューに表示される最初のエントリ)を変更すると、編集のためにマークされた他のすべての行は、最初の行に選択された値と同じ値になります。
計算タグ
入力値に基づいて計算を表示できます。計算は、型「number」のフィールドと、## numentriestotal ##のような他のタグを使って行うことができます。次の例は、計算に使用する構文を示しています。これはビューの“ entry template”設定で行われます。
単一エントリの計算
ポイント | 計算(変換例) |
[[mypoints_in_test01]] | %% F01:= ROUND(0.03 * [[!mypoints_in_test01]]、2)%% |
[[mypoints_in_test02]] | %% F02:= ROUND(0.03 * [[!mypoints_in_test01]]、2)%% |
和 | %% F03:= SUM(_F01 _、_ F02 _)%% |
複数エントリの計算
エントリ## entryid ## | ##作者:名前## |
[[score01]] | %% F ## entryid ## 01:= ROUND(0.03 * [[!score01]]、2)%% |
[[score02]] | %% F ## entryid ## 02:= ROUND(0.03 * [[!score02]]、2)%% |
高得点 | %% FF ## entryid ## 03:= MAX(_F ## entryid ## 01 _、_ F ## entryid ## 02 _)%% |