CSV からスレッドをインポートする
CSV インポーターは、スプレッドシートを行ごとに 1 つのスレッドへ変換します。スレッド → スレッドをインポートにあり、テンプレートの選択、列からフィールドへのマッピング、保存先フォルダーの選択、進捗をリアルタイムで確認しながらのインポート実行を案内します。
CSV 形式
Section titled “CSV 形式”ヘッダー行を用意し、1 行につき 1 つのスレッドを記載して、スレッド名用の列を設けます。サイドバーの CSV 形式パネルには、列の例（名前、説明、ステータス、所有者）が表示され、サンプル CSV をダウンロードから開始用ファイルを取得できます。受け付けられるのは .csv ファイルのみ（「CSV ファイルのみ」）で、「このインポーターでは、CSV ファイルの各行が 1 つのスレッドを表すことを前提としています」。
形式に関するヒントがほかに 2 つあります。
- 1 つの列をスレッド名として使用します。インポートするすべての行で、その列に値が必要です。DICE は 名前／タイトル列を検出するとその列を提案し、見つからない場合は最初の列を選択します。
- テンプレートの生成時には、データに基づいて列の型（テキスト、日付、数値）が自動検出されるため、各列の値の形式を統一してください。
インポートモードを選択する
Section titled “インポートモードを選択する”インポートモードセクションには、次の 2 つの方法があります。
- 新しいテンプレートを作成してインポート — 「CSV をアップロードし、テンプレートを自動生成して確認した後、インポートします」。初回のインポートに最適です。DICE が列からテンプレートを推測します。
- 既存のテンプレートにインポート — 「最初にテンプレートを選択し、フィールドをマッピングしてスレッドをインポートします」。テンプレートが 1 つ以上ある場合に利用できます。サンプルをダウンロードを使用すると、選択したテンプレートのフィールドに一致する CSV が生成されます。
新しいテンプレートを使用してインポートする
Section titled “新しいテンプレートを使用してインポートする”- CSV をアップロード — クリックしてアップロードするか、ドラッグ＆ドロップします。ファイルはその場で解析され、行数が表示されます（「N 行をマッピングできます」）。
- テンプレートビルダーを確認 — 推測されたテンプレートが表示されます。テンプレート名とテンプレートの説明にはファイル名に基づく値があらかじめ入力され、検出されたデータフィールドも表示されます。
- スレッド名と説明で、名前列と任意の説明列を確認します。各スレッドにはこれらの値がすでに含まれるため、該当する列はデータフィールドにスレッド名／スレッドの説明として表示され、フィールドとして作成されませんと記載されます。
- テンプレートを作成をクリックします。テンプレートがチームに保存され、保存先とインポートの設定に進みます（「テンプレートが作成されました。保存先とインポートの設定に進んでください」）。
テンプレートは CSV から生成されているため、列のマッピングが自動的に適用されます（「このテンプレートはアップロードされた CSV から生成されたため、フィールドマッピングが自動的に適用されます」）。列の自動マッピングパネルには、名前と説明の参照元が改めて表示されます。変更するには、テンプレートに戻るを使用します。
既存のテンプレートにインポートする
Section titled “既存のテンプレートにインポートする”- テンプレートを選択で、インポートする行の取り込み先となるテンプレートを選択します。
- CSV をアップロード — 「CSV ファイルをアップロードして、マッピングとインポートを開始します」。パネルには、選択したテンプレートのテンプレートフィールドと並んでCSV の行が表示されます。
- フィールドマッピングに進むをクリックします。
保存先とフィールドマッピング
Section titled “保存先とフィールドマッピング”保存先とフィールドマッピングステップでは、作成される内容を制御できます。
- フォルダー — インポートされるすべてのスレッドの保存先フォルダーです。ピッカーには最後に使用したフォルダーがあらかじめ入力されます。インポートする前に、フォルダーを 1 つ選択する必要があります。
- フィールドマッピング — 「各テンプレートフィールドに、その値を設定する CSV 列をマッピングします」。列名の一致に基づいてマッピング候補が適用されます。列なしのままのフィールドには値が設定されません。（テンプレートが CSV から自動生成された場合、この手順は省略されます。）
- スレッド名と説明 — 各スレッドの名前の取得元となる CSV 列（必須）と、任意で説明の取得元となる列です。これらはスレッドのプロパティであるため、該当する列はフィールドデータとして保存されません。
- これらの列もフィールドとして保存 — デフォルトではオフです。オンにすると、名前と説明の値も各スレッドのフィールドデータに保持されます。マッピングされたフィールドが省略される場合は、必須フィールドも含めて、その旨がフィールド名の下に表示されます。代わりに、スレッド自体の名前と説明に値が保持されます。
マッピングの下にあるインポートされるスレッドのプレビューには、インポート後の状態で先頭の数行が表示され、準備完了件数（「N 行をインポートできます」）と、失敗する行（「現在 N 行が失敗します」）が示されます。一般的な原因は、必須値がないことです。必要な行に準備完了と表示されるまで、CSV またはマッピングを修正してください。
各プレビュー行は、作成後のスレッドページと同様に、名前、テンプレート、説明、所属先の組織、チーム、フォルダーの順に表示されます。インポート前に、最後の行を確認することをお勧めします。共有されたフォルダーは別のチームに属している場合があり、その中に作成されたスレッドは自分のチームではなく、そのフォルダーのチームに属します。
インポートを実行する
Section titled “インポートを実行する”N 件のスレッドをインポートをクリックします。インポートは複数のバッチに分けて実行され、インポート状況がリアルタイムで表示されます（「Y 行中 X 行を処理しています。バッチ A / B」）。完了すると、「N 件のスレッドをインポートしました」という概要が表示され、該当する場合は「N 行が失敗しました」と表示されます。
インポートに成功すると、スレッドごとにインポートされたスレッドというアクティビティグループがアクティビティフィードに記録されます。また、作成されたテンプレートは今後のインポートでも利用できます。
アセンブリー・パッケージをインポートする
Section titled “アセンブリー・パッケージをインポートする”CSV インポートとは別に、DICE ではアセンブリー・インポート・パッケージをインポートできます。これは、スレッド、アセンブリー、部品の添付、関係リンクを 1 つの構造で記述した JSON ファイルです。アセンブリー → アセンブリー・パッケージをインポートにあります。
- パッケージの JSON を貼り付けるか、ファイルを読み込むを使用します。
- パッケージを検証をクリックします。パッケージのドライランが実行され、インポート計画が作成されます。作成されるスレッド、アセンブリー、アセンブリーではないスレッド、スレッドの添付、スレッドのリンクの件数に加え、ブロッキング問題と警告が表示されます。参照されているフォルダー、カテゴリー、関係は、既存のものと照合され、既存のものを再利用、新規作成のいずれかとして示されるか、曖昧なものとしてフラグが付きます。
- 計画に「このパッケージはインポート可能です」と表示されたら、インポートを確定をクリックします。
CSV インポートとは異なり、アセンブリー・パッケージのインポートはトランザクションとして処理されます。「確定するまで何も書き込まれず、インポートはすべて成功するか、すべて失敗します」。確定する前に、ブロッキング問題をすべて解決してください。アセンブリーと部品については、アセンブリーを参照してください。