並べ替え

ガントシートは、プロジェクト全体のタスクを整理するには、並べ替え機能を提供します。GC.Spread.Sheets.GanttSheet.Project クラスのsortメソッドを使用してデータを並べ替えることができます。

SpreadJSはガントシートのデータを様々な方法で並べ替えることができます。並べ替え条件を設定すると、プロジェクトの要件に合わせてタスクの表示を変更できます。

昇順

タスクまたはリソースを最小値から最大値（AからZ、1、2、3…)に並べ替えます。

次のサンプルコードは、taskNumber フィールドを昇順で並べ替える方法を示します。

// taskNumberフィールドを昇順で並べ替えます。
ganttSheet.project.sort(["taskNumber"], [true]);    

降順

タスクまたはリソースを最大値から最小値に（ZからA、3, 2, 1…）並べ替えます。

次のサンプルコードは、taskNumber フィールドを降順で並べ替える方法を示します。

// taskNumberフィールドを降順で並べ替えます。
ganttSheet.project.sort(["taskNumber"], [false]);

アウトライン構造の維持

ガントシートはタスクの元のアウトライン構造を維持しながら並べ替えることができます。この場合は親子タスクの関係が並べ替えによって変更されないため、子タスクは親タスクにリンクされたままになります。また、ガントシートはアウトライン構造を維持せずに並べ替えることもできます。

次のサンプルコードは、アウトライン構造を維持せずに、taskNumber フィールドを降順で並べ替える方法を示します。

// アウトライン構造を維持せずに、taskNumber フィールドを降順で並べ替えます。
ganttSheet.project.sort(["taskNumber"], [false], false);

SpreadJSは、シートレベルの並べ替えも対応しますが、その場合にガントシートの元のアウトライン構造が保持されません。シートレベルで並べ替える場合はガントシート内にグループされたデータを考慮しません。なお、ガントシートをシートレベルで並べ替えると、以下の操作は禁止されます。

• 親ノードが並べ替え対象に含まれません。

• アウトライン構造を維持せずに並べ替えを実行すると、プロジェクトが一時的に次の動作になります。

  • アウトラインの折りたたみ／展開は禁止されます。

  • インデント／インデント削除機能は使用できません。

  • タスク番号の付け直しができません。

タスク番号の永久変更

ガントシートの並べ替えは一時的または永久的に行うことができます。永久的な並べ替えを実行する場合、タスクのID番号が新しい順番に基づいて並べ替えられます。ただし、データベースでも並べ替えの状態を維持するには、すべてのタスクに番号を付け直します。タスクの番号を付け直すには、「アウトラインを維持する」チェックボックスを有効にする必要があります。

次のサンプルコードは、アウトライン構造を維持せずに、taskNumberフィールドを降順で並べ替え、タスクの番号が新しい順番に基づいて付け直す方法を示しています。

// アウトライン構造を維持せずに、taskNumberフィールドを降順で並べ替えます。
ganttSheet.project.sort(["taskNumber"], [false], true, true);

次の図は、さまざまな並べ替え動作を示します。