ワークスペースへのリリース

Online Mode の Release ビューでは、リリースプロセスは段階的なフローになっており、ビュー左側のエントリを見ることで、現在どのステージにいるかをひと目で確認できます。

1. Configure Server Release – リリースプロセスのこのステージでは、生成したいデータの種類を指定します: Source Data（常に生成）、Fabrication Data、Assembly Data（ベースデザインおよび検出された各バリアントごと）。

2. Validate Project – 次のステージは、割り当てられた OutJob ファイル内で 1 つ以上の Validation タイプのレポートが検出された場合に自動実行されます。リリース対象のデータ項目に割り当てられた Output Job ファイルで定義されている、すべての検証出力ジェネレーターが実行されます。

3. Generate Data – この次のステージも自動実行されます。ここでは、含まれている Data Items に割り当てられた OutJob ファイルで定義されたその他すべての出力が実行され、Workspace 内の該当ターゲットアイテムにリリースするデータが生成されます。

4. Review Data – すべての検証チェックに合格し、出力データが生成されると、このステージで生成されたデータを確認できます。

   ボタンに関連付けられたメニューから Prepare & Release または Prepare & Release & Publish to PLM コマンドを使用する場合、Project Releaser は Review Data ステージで一時停止しません。

5. Upload Data – 前のステージでリリースを確定すると、この次のステージに自動的に入ります。ここでは、ターゲット Workspace 内の該当する data Items のリビジョンへデータをアップロードする進行状況のみが表示されます。

6. Execution Report – これはプロセスの最終ステージで、リリースの概要が表示されます。Explorer panel 内で生成された Item Revision をすばやく参照できるよう、ナビゲーションリンクが提供されます。PLM へのリリースおよび公開プロセスの一部として Project Releaser にアクセスした場合は、 ボタンが表示されます。これをクリックすると、そのプロセスの基盤となるワークフローを継続し、PLM へ公開します。

   ボタンに関連付けられたメニューから Prepare & Release & Publish to PLM コマンドを使用する場合、Project Releaser は Execution Report ステージで一時停止せず、 ボタンも表示されません。

7. Publish to PLM – このステージは、関連する有効化済みプロセス（リリース後に PLM へ公開するためのプロセス）でリリースを実行している場合にのみ表示されます。このステージは、前のステージで ボタンをクリックすると自動的に開始されます（または、 ボタンに関連付けられたメニューから Prepare & Release & Publish to PLM コマンドを使用した場合は直接開始されます）。Login Credentials ダイアログが表示されます。PLM インスタンスの Username と Password を入力し、使用する PLM テンプレートを選択します（<PLMInstance>:<PublishingTemplate> の形式で表示されます）。

   PLM インスタンスのログイン資格情報が必要なのは、そのインスタンスへ初めて公開する場合のみです。以後はそれらが Workspace に保存されます。その後、同じプロジェクトを同じ PLM インスタンスへ公開する際は、定義済みワークフローおよび選択した公開テンプレートに従って直接処理されます。
   初回公開時に、部品番号（PLM 側）がまだ Workspace プロジェクトに関連付けられていない場合、それらの部品番号は PLM 内で作成され、その初回公開の一環としてプロジェクトに関連付けられます。また、公開処理の一部として、Workspace コンポーネント用のコンポーネントエントリを PLM インスタンス内に定義することもできます。これにより、PLM 内でコンポーネントの BOM を取得できます（オプション。PLM インスタンスへプロジェクトを公開する際に定義・使用される公開テンプレートに依存します）。

Online Stage 1 – Configure Server Release

リリースプロセスのこのステージでは、生成したいデータの種類を指定します。リリース可能な Data Items は次のとおりです。

• Source Data – ソース設計のスナップショット。
• Fabrication Data – 基板の裸板を作成するために Fabrication House が必要とするデータ。
• Assembly Data for the Base Design (no variations) – 部品表に従って裸板に実装を行うために Assembly House が必要とするデータで、非バリアントのベースデザイン用。
• Assembly Data for Design Variant n – 部品表に従って裸板に実装を行うために Assembly House が必要とするデータで、ベースデザインの Variant n 用。

Assembly データセットの数は、ベース（非バリアント）デザインと、そのデザインに対して定義されているすべての検出済みバリアントに対応します。

プロジェクトのリリースプロセスのステージ 1 – リリースに含める内容（生成するデータ）を設定します。

Source Data 項目は、リリース時に常に含まれます。その他のデータ項目は任意で含めることができます。

Setting Workspace Item Naming Schemes

プロジェクトをターゲット Workspace に初めてリリースする際、その Workspace 内のターゲットデータ項目（そのリビジョンが生成データを受け取る）の命名方法を定義できます。これは Project Release Options ダイアログの Item Naming タブで行います。このダイアログには、ビュー左下の ボタンを押すことでアクセスできます（または、リリース対象データセットの Target Revision リンクをクリックし、コンテキストメニューから Edit を選択します）。このタブでは次のことを行えます。

• プロジェクト名を定義します。デフォルトでは実際のプロジェクト名が入力されます。
• リリースの一部として生成可能な各種データ項目のデフォルト命名スキームを定義します。Item ID 列のフィールド内をクリックし、その右側にある ボタンをクリックして Choose Item ダイアログ（Explorer パネルの一形態）にアクセスすると、現在接続中の Workspace 内の既存 Item を対象にできます。

Project item は、リリースデータを受け取るために作成されるアイテムではなく、リリース済みデータ項目のプロジェクト全体ビュー、および Explorer panel でプロジェクトを表示した際にそれらがどのように接続されているかを提示するためのアンカーポイントとして使われるエンティティです。詳細については、 Viewing the Released Project セクションを参照してください。

命名スキームを変更するには、Settings ボタンをクリックして Naming Template Settings ダイアログを開きます。

プロジェクト名を設定し、ターゲット Workspace 内の生成データ項目の命名を定義します。ここでは、プロジェクトがまだリリースされていないため、フィールドは編集可能です。

命名テンプレートで使用できるマクロ形式は次のとおりです。

• Parameter-based – 角括弧で囲まれたパラメーターの使用をサポートします（例: [ProjectName], [VariantName], [ProjectParameter]）。
• Numeric-based – 波括弧で囲まれた数値修飾子の使用をサポートします（例: {0000}, {9000}）。

Project Release Options ダイアログの Item Naming タブから、命名スキームのエントリを直接クリックして、任意の名前に変更できます。あるいは、フィールド右側のボタンをクリックして Choose Item ダイアログ（Explorer パネルの一形態）にアクセスすると、現在接続中の Workspace 内の既存 Item を対象にできます。

アイテムの命名は、アクティブに接続されている Workspace にリリースするデータを設定する、Release ビューの最初のステージ中であればいつでも変更できます。 をクリックした後は、関連する命名は変更できません。これは、その命名を使用した予定アイテムが、リリースに含まれる有効化された各データセットごとに作成され、それらがプロジェクトにリンクされるためです。したがって、それらのアイテムにデータをリリースするところまで進めなかったとしても、それらは引き続き ready 状態で存在し、対応する命名テンプレートのエントリはグレーアウトされます。これらの予定アイテムを削除するか、Browse コマンド（メニューにアクセスするには Target Revision エントリをクリック）を使用して、必要な命名で新しいターゲット Item をそれぞれ作成できます。

リリースの一部として作成されるデータアイテムの設定が必要どおり完了したら、ビュー右下の ボタンをクリックして先に進みます。

ボタンには 2 つの状態があります。クリックすると標準の Prepare コマンドが起動します。これにより、リリースは Review Data ステージまで進み、データのリリースを確定する前に、すべてが問題ないかを実質的に再確認できます。確認のために一時停止したくない場合は、ボタンに関連付けられたドロップダウンメニューを使用して Prepare & Release コマンドを選択してください。

準備の一環として、リリース前に以下の複数のチェックが実行されます。

• プロジェクトおよびすべてのファイルが保存されていることを確認します。
• 必要に応じて、プロジェクトおよび関連するすべてのファイルが VCS にコミットされていることを確認します。
• 有効化された各データアイテムに名前が付けられていることを確認します。
• ユーザーにターゲットアイテム（およびリビジョン）を作成する権限があることを確認します。
• 必要なターゲット Items（および予定リビジョン）を、存在しない場合は Workspace 内に作成し、既存のアイテムについては次のリビジョンが使用されることを保証します。

問題が見つかった場合は、それらを解決するための対処方法（ローカルで変更されたファイルの保存や VCS へのコミットなど）が提示されます。

Source Data Item はこの時点で生成され、ソース設計プロジェクトファイルのスナップショットがターゲットアイテムのリビジョンにリリースされます。

オンライン ステージ 2 – プロジェクトを検証

ステージ 1 が問題なく完了すると、割り当てられた OutJob ファイル内で 1 つ以上の Validation タイプのレポートが検出された場合に、この次のリリースプロセスのステージが自動的に実行されます。リリース対象のデータアイテムに割り当てられた Output Job ファイルで定義されている、すべての検証用出力ジェネレーターが実行されます。これには、以下のいずれかの実行が含まれます。

• Differences Report – comparator を使用して、ソース設計ドキュメントと PCB 設計ドキュメントが正しく同期しているかを判定します。
• Electrical Rules Check – 取得されたソース設計の電気的/製図上の妥当性をチェックします。
• Design Rules Check – 指定された基板レベルの設計制約に対して PCB ドキュメントの妥当性をチェックします。
• BOM Checks – ソース BOM ドキュメント（*.BomDoc）内の Design Items または Part Choices に関連する違反の可能性をチェックします（利用可能な場合）。
• Footprint Comparison Report – 基板上のフットプリントをソースライブラリと比較し、最新であり一致していることを確認します。
• Component State Checking – 制限状態にあるコンポーネントをチェックします。設定の一環として、ターゲット Workspace 内で現在定義されている各 Lifecycle Definition の各状態に対し、実行するアクションを決定します。アクションなし、警告、またはエラー生成のいずれかです。最後のものは設計のリリースを阻止します。さらに、このチェックを実行すると便利な HTML ベースのレポートも生成され、どの設計コンポーネントが有効な状態ではないかをひと目で確認できます。
• Environment Configuration Compliance Check – 現在割り当てられているロールで使用可能な環境設定を通じて許可されているデータアイテムのみが使用されていることをチェックします（該当する場合）。このチェックにより、すべての設計アイテムが Workspace 由来であることも保証できます。

検証に成功すると、 アイコンとともに Passed というテキストが表示されます。失敗した場合は、 アイコンとともに Failed というテキストが表示されます。

ビュー右下の をクリックすると、リリースプロセスを停止します。

オンライン ステージ 3 – データを生成

ステージ 2 が問題なく完了すると、この次のリリースプロセスのステージが自動的に実行されます。ここでは、含まれる Data Items に割り当てられた OutJob ファイルで定義された、その他すべての出力が実行され、Workspace 内の関連するターゲットアイテムにリリースするデータが生成されます。

他のステージと同様ですが、このステージは実行に時間がかかるため特にわかりやすく、生成の進行状況を示すためにアイコンが使用されます。

– まだ実行/生成されていません。

– 実行/生成中です。

– 正常に生成されました。

– 生成に失敗しました。

ビュー右下の をクリックすると、リリースプロセスを停止します。

オンライン ステージ 4 – データをレビュー

すべての検証チェックが通過し、出力データが生成されると、リリースプロセスのこのステージで生成されたデータをレビューできます。

生成されたデータを確認し、リリースを確定して Workspace にアップロードする前に、すべてが正しい状態であることを確認します。

このページは、生成データのシンプル（コンパクト）表示をデフォルトで表示します。より詳細な表示に切り替えるには、目的のセクションに関連付けられた Details コントロールをクリックします。

関連するセクションの生成データをシンプル表示から詳細表示に切り替えるには、Details コントロールをクリックします。元に戻すには、Hide Details コントロールをクリックします。

生成データのコンパクト表示では、View リンクをクリックすると、関連するデータファイルまたはファイルセットを、Altium Designer 内の該当エディター（例: Gerber ファイルまたは圧縮/非圧縮 ODB++ ファイル用の CAM エディター）または該当する外部アプリケーション（例: 部品表用の Microsoft Excel）で開くことができます。詳細表示では、エントリをダブルクリックするとそのファイルのみを表示できます。

多くの設計者がリリース準備完了の確認テストとしてよく行うのは、現在のリリースから生成された Gerber ファイルと前回のリリースの Gerber ファイルを比較することです。Gerber 出力の横にある Compare Gerber リンクをクリックし、ドロップダウンメニューから以前のリリースを選択すると、準備済みの Gerber データを選択した リリースのものと比較できます。デフォルトブラウザーが Company Workspace を開き、結果を表示します。

データを Workspace にリリースする前に、Project Releaser から Gerber 比較機能にアクセスする。

►Gerber Comparison 機能の詳細はこちら（Altium 365 Workspace、Enterprise Server Workspace）。

データ確認後に修正が必要とわかった場合は、ビュー右下の ボタンをクリックします。確認ダイアログが表示され、生成済みデータがすべて失われることが通知されます。OK をクリックするとリリースがキャンセルされ、プロセスのステージ 1 に戻ります。

生成データに問題がなければ、 ボタン（これもビュー右下）をクリックしてリリースを続行します。Confirm Release ダイアログが表示され、Workspace にリリースされるプロジェクトの構成が要約されます。ここでは、Name を追加したり（デフォルトでは [ProjectName] が入力されています）、Description を追加したり、関連するリリースノートを追加したりすることもできます。

生成された Item-Revisions の観点から、何がリリースされるかの確認、および Name/Description の変更とリリースノート追加の機能。

オンライン ステージ 5 – データのアップロード

前のステージでリリースを確認すると、この次のステージに自動的に入ります。このステージでは、Workspace 内の関連データ Item のリビジョンへのデータアップロードの進行状況のみが表示されます。

このステージでは、生成データが Workspace 内のリンクされた Item-Revisions にアップロードされる進行状況のみが反映されます。

オンライン ステージ 6 – 実行レポート

これはプロセスの最終ステージであり、リリースの概要が表示されます。

リリースの最終レポート。

Navigation Links を使用すると、リリース済みデータ（Fabrication Data、Assembly Data、および任意の Custom Data セット）を含む関連 Item Revision に、Explorer panel（Workspace へのポータル）からすばやくアクセスできます。

Explorer パネルにより、Workspace 内でプロジェクトのリリース済みデータを直接表示しているところ。

Viewing the Released Project

Workspace プロジェクトでは、リリース完了後に利用できる追加機能が 1 つあります。Execution Report ページ上部の Navigation Links の最後にある Project Page リンクをクリックすると、Explorer パネルが開き、Project View 内でプロジェクトが表示されます。これは Workspace Projects でのみ利用可能です。

以前に Classic View でプロジェクトを表示していた場合は、手動で Project View に切り替える必要があることがあります。コマンドは、Explorer パネル右上の ボタンに関連付けられたメニューから利用できます。

Project View により、Explorer パネルで Workspace プロジェクトをより詳細に確認できます。

Releases 領域（ビュー左下）には、プロジェクトに関連付けられたプロジェクトリリースの一覧が表示され、各リリースの概要とその構成パッケージが含まれます。この領域の ボタンをクリックすると、Batch state change dialog が開き、同じリリースに関連する複数のアイテムのライフサイクル状態を、単一のバッチ処理でまとめて変更できます。

プロジェクトの Release 情報には、Explorer panel の ボタンから開く対象 Workspace の Web Viewer でもさらにアクセスできます。Workspace の Web Viewer では、プロジェクトに関連付けられたすべてのリリースに Releases ビューからアクセスできます。オンサイトサーバーで提供される Workspace の場合は Manufacture ビューからアクセスします。このページにはすべてのプロジェクトリリースが新しいものから上に一覧表示され、個々のリリースは開くボタン（）から Workspace の Manufacturing Portal で開くことができます。Manufacturing Portal ビューでは、選択した Release のより詳細な情報が表示され、そこにはその構成 release package ファイル、設計ドキュメント一式、およびコンポーネントの Manufacturer / Supplier 詳細が含まれます。Send to Manufacturer 機能は Altium 365 Workspace でのみ利用可能である点に注意してください。► 詳細については Altium 365 Workspace Releases View ページを参照してください。

以上で完了です。プロジェクトがリリースされたら、Release ビューを閉じるだけです（ビュー右下の ボタンを使用）。今後同じプロジェクトを再リリースする必要がある場合も、Project Releaser により迅速かつ簡単に実行でき、対象の Item-Revisions は自動的にインクリメントされます。

PLMインスタンスへの公開

Related pages: PLM Integration（Altium 365 Workspace、Enterprise Server Workspace）では、PLMへの公開

Project Releaser を Altium Designer で実行する処理の一環として、設計をPLMインスタンスに公開できます。公開処理では、そのPLMインスタンスの統合設定の一部として定義された公開テンプレートを使用し、データをPLMへどのように反映させるかを制御します。この機能は、適切に設定されたプロセスを通じて利用できます。インストール時にはサンプルのプロセス定義（Project Releaser with Publish）が用意されており、その基盤となるワークフローにより、Project Releaser の追加ステージとして統合PLMインスタンスへの公開が可能になります。ワークフロー図を以下に示します。

デフォルトの Project Releaser with Publish サンプルプロセス定義のワークフロー図

有効化されると、Project Releaser の一部としてPLMインスタンスへ公開するためのプロセスは、Altium Designer 内でアクティブなプロジェクトのProject » Project Releaserサブメニュー、または Projectsパネル内の設計プロジェクト項目を右クリックして開く Project Releaserコンテキストサブメニューからアクセスできます。

Project Releaser

の一部としてPLMインスタンスへ公開するための プロセスへのアクセスProject Releaser が表示され、追加ステージとして 7. Publish to PLM が加わります。さらに、 ボタンに関連付けられたメニューから Prepare & Release & Publish to PLM コマンドも利用でき、生成されたデータや実行レポートの確認で停止せずに Project Releaser を実行したい場合に使用できます。

生成されたデータおよび実行レポートの確認で停止せずに Project Releaser を実行するための追加コマンド

標準の Prepare コマンドで Project Releaser を実行した場合、データの確認とリリース後、Execution Report ステージで ボタンが表示されます。これをクリックすると、プロセスの基盤となるワークフローが継続し、PLM へ公開されます。すると Login Credentials ダイアログが表示されます。PLMインスタンスの Username と Password を入力し、使用するPLMテンプレート（<PLMInstance>:<PublishingTemplate> の形式で表示されます）を選択してください。

Prepare & Release & Publish to PLM コマンドを使用した場合は、最終的に直接 Login Credentials ダイアログが表示されます。Project Releaser は Execution Report ステージで一時停止せず、 ボタンも表示されません。

PLMインスタンスへの初回公開時に表示される Login Credentials ダイアログ。

Diagram タブをクリックすると、このプロセスの基盤となるワークフローを確認できます。

Login Credentials ダイアログの Diagram タブ

ボタンをクリックすると、そのワークフローに従って公開プロセスが進行します。

PLMへの公開プロセスの状態は、Workspace のブラウザーインターフェースから、プロジェクトの詳細管理ページにある Activities ビューで確認できます。 プロジェクトの詳細管理ページを開くには、Workspace のブラウザーインターフェースの Projects ページで対象プロジェクトを選択し、プロジェクト一覧の上にある コントロールをクリックして、関連メニューから Open 項目を選択します。あるいは、一覧内の対象プロジェクト項目を直接ダブルクリックすることもできます。ページは新しいブラウザータブで開きます。 プロセスワークフローの履歴（History タブ）の一部として、PLMインスタンス内で作成された部品番号など、何が正確に作成されたかを常に確認できます。