Aggrega へのインポート
インポートが何を読み書きするか、どのフォーマットを読むかは インポート で説明しています。このページでは、エディタからインポートを実行する方法を扱います。
Aggrega: Import into Aggrega — 別のツールが書いたソースから Aggrega のオーサリングファイルをドラフトします。これは Commands パネルの Author グループにある Import ボタンでもあり、エクスプローラーのファイルまたはフォルダの右クリックメニューにある Import into Aggrega でもあります。後者はクリックしたファイルまたはフォルダをインポートします。3 つは 1 つのコマンドなので、同じ質問を同じ順序で、それぞれエディタ自身の入力欄で尋ねます。ただしエクスプローラーの項目はソースを尋ねません。
まずソースです。File… または Folder… を選び、次にその種類に対応するエディタの「開く」ダイアログが表示されます — この選択が先なのは、Windows と Linux では 1 つのダイアログで両方を提供できないためです。次に、ドラフト先となるワークスペース内のフォルダをルートからの相対パスで指定します。空のままにすると、--output-dir なしの aggrega import と同様に、ワークスペースルートの下にドラフトします。次にオプションで、Preview、Sync、その両方にチェックを入れるか、どちらにも入れないかを選べるリストです。Preview は --dry-run です — 何も書き込まれず、インポートが書き込むはずの各ファイルが出力チャネルに表示され、その後に内容が続きます — そして Sync は --sync で、以前のインポートがドラフトした内容をソースに合わせて最新化し、インポートが書いたものだけを変更します。最新化した各部分は、aggrega import --sync がそれに対して出力する言葉でチャネルに一覧表示されます。どちらにもチェックを入れない場合はドラフト全体を書き込みます。最後に、Manifest をドラフトする対象のプロバイダー機能(compose や helm など)で、空のままにすると --target なしの場合と同様に何もドラフトしません。空のままにした回答とチェックしなかったオプションはまったく送信されないため、コンパイラが独自のデフォルトを適用します。質問やダイアログを閉じると、何も送信せずにインポートが終了します。ワークスペースの外に通じるフォルダや、ワークスペースのカタログ内のどの Recipe もバインドしない機能は、何かが書き込まれる前にコンパイラ自身の言葉で拒否されます。

フォーマットは、ターミナルの場合と同様に、ソース自体の形から認識されます。どのフォーマットもソースを認識しない、または複数のフォーマットが認識するためにコンパイラが拒否した場合、エディタはその拒否 — フォーマット名を示すもの — を表示し、ソースをどのフォーマットとして読むかを尋ね、それを付けて同じインポートを再送信します。その質問を空のままにすると、その拒否でインポートが終了します。読み取るのは指定したファイル、または指定したディレクトリ内でインポーターが読み取るファイルだけで、それ以外は読み取りません。ネットワークにはアクセスしません。ただし、インポートの実行に必要で、このマシンがまだ持っていないものを取得する場合は例外です — あるフォーマットが初めて必要とするときのコンパイラのコアインポーターの 1 つと、カタログフォルダを指定していないワークスペースでは、インポートがカタログとして読み取る公開済みのカタログスナップショットです — いずれも aggrega import と同様に、ワークスペースのデフォルトレジストリから取得し、検証してコンテンツキャッシュに保持します。ソースはワークスペースが保持するファイルではなく指定したファイルなので、このマシン上のどこにあっても構いません。ドラフトは常にワークスペースに置かれます。
Cancel ボタン付きで進行状況を表示し、Cancel を押すとエディタの待機を止めるだけでなく変換そのものが停止します。インポーターは、コンパイラが実行途中で巻き戻せるプラグインとして動作するためです。
終了時には、ソースが何として認識されたか、いくつのファイルがドラフトされ、どこに置かれたかが示されます。数えるのはドラフトで、.aggrega-import.json(すべてのインポートがドラフトの隣に書き込む、インポートが書いた内容の記録)は含みません。インポーター自身の検出結果と、ディスクに書き込まれたすべてのファイル(記録を含む)は Aggrega 出力チャネルに送られます。それらが示すのは、作成したドキュメント内ではなくソースファイル内の場所だからです。ドラフトを書き込むインポートが、どのソースも保持できない値をドラフトに必要なまま残した場合、エディタはそれらを尋ねることを提案します。詳しくはインポートがまだ必要とする値への回答を参照してください。
インポートがまだ必要とする値への回答
ドラフトに必要な値の中には、どのソースも保持できないものがあります。たとえば、独自のコードがビルドされるイメージ、オーナーアカウントのメールアドレス、シークレットの取得元などです。ドラフトを書き込むインポートがそのような値を空のまま残した場合、エディタはその数を示す通知で、それらを尋ねることを一度だけ提案します。提案を閉じても何も変わりません。プレビューには何も提案されません。aggrega import --dry-run が何も尋ねないのと同じで、プレビューには回答が適用されないためです。それでも、出力チャネル上のプレビューの検出結果には、まだ空のままの各値が示されます。提案を受け入れると、各値はドラフトが一覧にしている順序で、それぞれ専用の入力ボックスで尋ねられます。ボックスのタイトルにはドラフトされたファイルと値が置かれるキーが示され、質問にはコンパイラ自身による値の説明、つまり aggrega import がターミナルで尋ねる質問が使われます。シークレットのボックスは、コンパイラ自身の言葉でシークレットの取得元を尋ね — シークレットそのものは決して尋ねません — 入力した内容を隠します。空のままにしたボックスの値は未回答のまま残り、後で回答ファイルで回答できます。いずれかのボックスで Escape を押すと質問が終了し、すでに入力した回答も含めて何も送信されません。
その後、エディタは回答を付けてインポートを再送信します。進行状況と Cancel ボタンは同じで、検出結果、ファイル、終了時のメッセージは最初のインポートと同様に出力チャネルに送られます。ドラフトはすでにディスク上にあるため、回答は同期として送られます。コンパイラは各回答をドラフトに書き込み、aggrega import が読み取る回答ファイルに保持するため、そのソースの後のインポートや同期で再び尋ねられることはありません。そのファイルがすでに回答している値はまったく尋ねられません。シークレットに対して取得元の名前以外のもので回答すると、コンパイラ自身の言葉で拒否され、未回答のまま残ります。再送信したインポートの後もドラフトがまだ必要としている値は、同じ方法で提案されます。