はじめに
Inline Editingは、Domoのカードから直接DomoのDataSetを変更できるプレミアムAppです。 このAppはDomo Appstoreにあります。- 必要条件
- 既知の制限事項
- Upsert DataSet
- ページフィルターの設定
- DataSetをAppにマップする
- Appを設定する
- タブの設定
- Appを使用する
- 変更を書き戻す
- 変更ログ
- 新しいバージョンのInline Editingに移行する
必要条件
Appの内部設定は、App管理者のみが行うことができます。管理者を追加するには、Domoグループを作成し、_Inline_Edit_Ownersという名前を付けて、このグループに管理者を追加します。グループが存在しない場合、Appは実行されますが、ユーザーはAppに変更を加えることはできません。 グループの詳細については、「 ユーザーグループを作成および管理する 」を参照してください。既知の制限事項
このAppの現在のバージョンには、以下の既知の制限事項があります。- 標準のDataSetは、100,000行または500列までに制限されています。これより大きなDataSetを使用する必要がある場合は、まずDataSetをUpsert DataSetに変換します。この方法については、「 Inline Editing実装ガイド 」を参照してください。
- インストールされているAppの外部メカニズムによってDataSetのデータが変更されている場合（DataFlowなど）、Appから書き込まれた変更はそのメカニズムによって上書きされます。
- Appは、数秒おきにDataSetの変更をチェックします。複数のユーザーがアクティブにInline Editing Appを使用している状況で、そのうちの誰かが変更を加えた場合、その操作はほかのユーザーに警告されます。Appの使用を続行するには、その変更を取り下げる必要があります。
- Cloud Amplifier経由でDomoに接続されたDataSetはサポートされていません。
Upsert DataSet
Inline Editingは、Domo内の任意のDataSetを使用するように設定できます。ただし、DataSetに変更が書き戻された場合、その変更を送信する方法には以下の2つがあります。- 通常、デフォルトのDataSetでは、Inline Editing AppにDataSet全体を（セクション単位で）ダウンロードし、ターゲット行に変更を適用した後、変更後のDataSetを再アップロードする必要があります。DataSetのサイズによっては、このプロセスに時間がかかる場合があります。
- Upsert DataSetでは、変更、追加、削除されている行に対してのみ変更が送信され、その際、それらのキー列の値が使用されます。Upsert DataSetの方が書き戻し時間が短いため、DataSetをUpsert DataSetに変換することを検討してください。この方法については、「 Inline Editing実装ガイド 」を参照してください。
ページフィルターの設定
Inline Editingには、App内でデータにフィルターをかける方法があります。ただし、Appカードが置かれているDomoのダッシュボードに適用されたフィルターを、Inline Editing Appで読み込んで使用することもできます。 Inline Editing AppのDataSetで使用される列をページフィルターとして使用するためには、これらのDataSetが適切にマップされている必要があります。この方法については、以下の「 DataSetをAppにマップする 」を参照してください。このAppでは、最大30個のDataSet（30個のタブ）を同時に存在させることができます。 タブを追加するたびに、そのタブでDataSetをマップする必要があります。以下の点にご注意ください。
- 各DataSetは1つのタブにしかリンクできません。リンクした後は、同じDataSetを指す2つ目のタブを追加できません。
- タブを削除しても、そのDataSetをマッピングから削除する必要はありません。ただし、削除することでフィルターのリストが整理され、マップされたDataSetのリストがより見やすく保たれます。
DataSetをAppにマップする
DataSetをAppにマップするには、以下のステップに従います。-
Appにマウスポインターを合わせて、右上に
［カードのオプション］ を表示し、選択します。
カードのオプションが表示されます。
-
［カードを編集］ を選択します。
カードエディターが表示されます。
- （オプション）編集中にAppの全ページを表示したい場合は、 ［フルページ］ のボックスにチェックを入れます。
4. カードエディターの下部に、データ マッピング 領域が表示されます。 
［DataSet］ と 
［コレクション］ の2つのセクションがあります。
設定プロセス中に、以下のような赤いインジケーターがいずれかのタブに表示された場合は、そのタブのマッピングに問題があります。
5. 
［DataSet］ セクションに進みます（まだ開いていない場合）。
-
DataSetリストを選択して展開すると、マップされたDataSetのスロットが30個表示されます。プレースホルダーDataSetがあるスロットは、使用されていません。
- 使用されていないスロットを選択します（DataSetをマップする順序は、Appの機能に影響を与えません）。必要に応じて、DataSetを別のDataSetに置き換えることもできます。
-
スロットを選択したら、 ［DATASETを選択］ の下にあるボタンを選択して、 ［DataSetを選択］ モーダルを表示します。
-
モーダルでDataSetを検索して選択し、 ［DATASETを選択］ を選択してカードエディターに戻ります。
［データマッピングをクリア］ を選択すると、DataSetのマッピングをリセットすることができます。
- ステップ6〜8を繰り返して、必要な数のDataSetをマップします。
-
DataSetのAppへのマップが完了したら、カードエディター上部の ［保存して終了］ を選択してカードエディターを閉じ、変更を保持します。
管理者への注記： デフォルトでは、Appはアクティブなタブに適用されるページフィルターを使用して、表に表示されるデータに自動的にフィルターをかけます。ただし、管理者はAppの ［設定］ > ［フィルター］ に移動し、Appでページフィルターを使用するかどうかとその使用方法を設定できます。
Appを設定する
App管理者はAppの設定を行うことができます。App管理者を指定する方法については、上記の「 必要条件 」を参照してください。タブ
タブにはDataSetが含まれており、Appから直接DataSetを編集することができます。これはInline Editingの主な機能です。管理者はタブを追加、削除、設定できます。これらのプロセスについては、以下で説明します。タブを追加する
-
管理者には、デフォルト画面の下部のタブの横に
［新しいタブを追加］ オプションが表示されます。このオプションが表示されない場合、あなたは管理者グループに属していません。
管理者をグループに追加する方法については、上記の「 必要条件 」を参照してください。
- ［+新しいタブを追加］ を選択します。 ［新しいタブを追加］ モーダルが表示されます。
- モーダルの左側で、Appに追加するDataSetを検索して選択します。 モーダルの右側には、DataSetの詳細とDataSetのプレビューが表示されます。
-
［選択］ または ［キャンセル］ を押します。
- ［選択］ を押した場合、 タブ名 の入力を求められ、 ［タブを作成］ を選択できます。
- ［キャンセル］を選択すると、Appに戻ります。新しいタブは作成されません。
— | —
タブを削除する
-
Appの下部で、削除するタブを選択します。
選択したタブが青色に変わり、タブ名の横に
三点メニューが表示されます。
- 三点メニューを選択して、 ［タブを削除］ オプションを表示します。
-
［タブを削除］ を選択します。
タブと関連するすべての設定および保存されている変更が削除され、操作を元に戻せないことを警告するダイアログが表示されます。
- ［確認］ を選択します。
タブの設定
設定は個々のタブ用であるため、変更をタブに適用する必要がある場合、管理者は各タブに変更を加える必要があります。 管理者はAppツールバーで
［タブの設定］ を選択して、アクティブなタブの設定を変更できます。
［DataSetの設定］ モーダルが表示されます。
［DataSetの設定］ には以下の4つのセクションがあります。
ユーザーがアクティブなタブの表に変更を加え、保存してDataSetに書き戻していない場合、設定を変更することはできません。タブの設定を変更する前に、すべての未保存の変更を破棄しておく必要があります。
以下では、設定の各セクションについて説明します。
権限
以下で説明するように、管理者は ［権限］ 設定で、ユーザーがAppで行うことができる変更のタイプを決定できます。有効にするオプションのボックスにチェックマークを入れます。
- ［セルを編集］ — ユーザーは、DataSet内の既存の値に変更を加えることができます。
- ［行を追加］ — ユーザーは新しい行を作成できます。
- ［行を削除］ — ユーザーは、次回DataSetに変更を書き込む際に削除する行にマークを付けておくことができます。
- ［一括編集］ — ［一括編集］ ボタンが表示され、ユーザーは選択した列のすべてのセルの値を変更できます。
列
管理者は ［列］ 設定で、列の設定と、どの列をAppから編集できるようにするかを制御できます。
-
順番 — このハンドルを使用すると、列をドラッグ＆ドロップして順序を並べ替えることができます。
-
非表示/表示 — 列の表示と非表示を切り替えます。列が非表示の場合、アイコンはグレー表示になります。
-
［編集可能］ — このチェックボックスにチェックを入れると、Appユーザーが列を編集できるようになります。
編集 アイコンが、列リストの列名の横に表示されます。
- ［必須］ — 列を必須にするには、このチェックボックスにチェックを入れます。 これは、列が編集可能としてマークされていない場合は、まずその列を編集可能としてマークしてからでないと、必須としてマークできないことを意味します。このオプションを有効にする場合は、列の各セルにコンテンツが含まれている必要があります。必須の列に空のセルがある場合は、以下のエラーが発生します。 ・ユーザーがダッシュボードやDataSetから離れることができない。 ・1ページに表示される行数を変更できない。 ・ユーザーがDataSetに書き込みできない。 ・一時的な変更が自動保存されるときに、必須の空のセル（無効なセル）を含む行がスキップされる。
-
［ピン留め済み］ — このチェックボックスにチェックを入れると、モーダルの列リストの一番上に列がピン留めされ、DataSetでの列の位置が固定されます。
モーダルのピン留めされた列では、
順番 オプションを使用することはできません。
フィルター
管理者は ［フィルター］ 設定で、ページフィルターとApp内フィルターを使用してDataSet/表に表示されるデータにフィルターをかける方法を定義できます。- ［ページフィルターを使う］ — このチェックボックスにチェックを入れると、Appカードが表示されるダッシュボードで定義されているフィルターが、Appに転送され、Appによって使用されます。
- ［App内フィルターを無効にする］ — このチェックボックスにチェックを入れると、App内フィルターが削除され、Appカードが表示されるダッシュボードで定義されているページフィルターのみがAppによって使用されます。また、このチェックボックスにチェックを入れると、Appツールバーから ［フィルター］ オプションも削除されます。
- ［フィルターが 競合しています］ — 列にページフィルターとApp内フィルターの両方がある場合、片方しか使用できなくなります。この設定により、管理者は競合が発生したときに使用するフィルタータイプを制御できます。
日付形式
管理者は ［日付形式］ 設定で、表ビューに日付フィールドを表示する方法を制御できます。 含まれるオプション：- ［デフォルト］ — 日付は「Jan 6, 2023」の形式で表示されます。
- ［省略した日付］ — 日付は「MM/DD/YYYY」と表示されます。
- ［正式な日付］ — 日付は「January 6, 2023」の形式で表示されます。
- ［YYYY-MM-DD］ — 日付は指定された形式で表示されます。
- ［カスタム］ — 管理者は、モーダルで使用可能なオプションからカスタムフォーマットを定義できます。
Appを使用する
このセクションでは、App内のいくつかの一般的なタスクについて説明します。セルを編集する
セルを編集するには、セルを選択します（編集可能なセル内のフォントは青色になっています）。編集モードを終了するには、セルの外側を選択します。 編集可能な列のヘッダーの背景は青色になっています。行を追加する
行を追加するには、
［追加モードに切り替える］ を選択します。追加モードの表が表示されます。
新しい行を追加するには、 
［新しい行を追加］ を選択します。表の下部に新しい行が表示されます。
必須の列とキー列のすべてのフィールドは、新しい行で必要です。一時的な変更は、これらのフィールドのすべてが値を持つか、新しい行がすべて空になるまで、保存されません。
新しい行は、常に表の各ページの表の下部に表示されます。
行を削除する
次回DataSetを書き戻す際に削除する列にマークを付けるには、その行の
三点メニューを選択します。 ［削除のためのマークを付ける］ を選択します。
行をリセットする
行のいずれかのフィールドを変更した場合、その行の
三点メニューを選択した後、 ［行の変更をリセット］ を選択すると、行全体をリセットできます。
ツールバー
以下の表では、Appのデフォルト画面（編集モード）で使用できるツールバーオプションについて説明します。| アイコン | 説明 |
|---|---|
 | ［Appのフィルター］ — このオプションを選択すると、 ［データをフィルター］ モーダルが表示されます。フィルターを適用した後は、表示されている行のみが手動または一括編集の変更の影響を受けます。ただし、データにフィルターをかける前に変更が加えられていた場合には、それらの変更は維持されて、DataSetに書き戻す際に適用されます。 |
 | ［変更を破棄］ — 現在のDataSetのすべてのページの全変更がリセットされます。 |
 | ［追加モードに切り替える］ — 表を追加モードで表示します。 追加モードでは、ツールバーに以下のオプションが表示されます。
|
 | ［一括編集］ — ユーザーは列の下にあるすべてのセルを同時に編集できます。 一括編集を実行するには、以下のステップに従います。
|
 | ［一括削除］ — ユーザーは列の下のすべてのセルに削除のためのマークを付けることができます。 |
 | ［Adjust font size］ — コントロールを使用してフォントサイズを上げる/下げるか、リストからフォントサイズを選択します。 最後に選択されたフォントサイズは、ローカルに保存されます。 |
 | ［テキストをラップ］ — 表のセルでテキストを折り返す。 |
 | ［レイアウトを保存］ — 現在の表レイアウトを保存し、ユーザーがAppに戻ったときに表示します。 |
 | ［レイアウトをリセット］ — レイアウトをデフォルト設定にリセットします。 |
 | ［フルスクリーンにする］ — Appをフルスクリーンモードで開きます。ボタンを再度選択すると、フルスクリーンが終了します。 |
 | ［タブの設定］ — 管理者は、このオプションを使用して ［DataSetの設定］ にアクセスできます。 |
 | ［ヘルプ］ — ［ヘルプ］ モーダルを開きます。ユーザーは、App内からこのガイドにアクセスできます。 |
［新しい行を追加］ — 表の下部に新しい行を追加します。 
［一括編集］ を選択します。ウィンドウが表示されます。 列をソートする
列をソートするには、その列の
ソート を選択します。
ソート を初めて選択したときは、列が昇順でソートされます。2回目は、列が降順でソートされます。3回目は、列がリセットされます。
複数の列をソートすることができ、以下のようにソートアイコンの横の数字がソートの優先順位を示します。 
このページのトップへ
変更を書き戻す
すべての変更を送信してDataSetに書き戻す準備ができたら、 ［DataSetに書き込む］ を選択します。 このボタンを選択すると、DataSetに書き戻される変更の概要が表示されます。このビューで ［確認］ を選択して処理を開始します。Appが変更を送信して書き戻します。このプロセスには時間がかかる場合があります。ヒント： ［DataSetに書き込む］を選択する前に、そのタブへの変更の概要を表示するには、 
［Tab summary］ を選択して、DataSetの合計行数、変更された行数、追加された行数を表示します。
［Tab summary］ を選択して、DataSetの合計行数、変更された行数、追加された行数を表示します。変更ログ
また、このAppでは、Appを通じて送信されたすべての編集内容、追加された行、削除された行の変更ログとして機能するDomoのDataSetも作成されます。 変更ログにアクセスするには、Domoで<dataset_id>_INLINE_CHANGE_LOGという名前のDataSetを検索します。注記： このDataSet名には、最初にハッシュ（文字と数字の文字列）も付加されています。DataSetにアクセスしたら、名前を変更できます。これは変更ログ機能には影響しません。
新しいバージョンのInline Editingに移行する
以前のバージョンのInline Editingを使用していて、Appを更新する必要がある場合は、以下の手順に従います。-
Appにマウスポインターを合わせて、右上に
［カードのオプション］ を表示し、選択します。
カードのオプションが表示されます。
-
［カードを編集］ を選択してAppエディターを開きます。
-
エディターで ［保存して終了］ を選択して、Appの機能に必要なすべてのコレクションを作成します。
