ワークスペースへのリリース
概略
- ソース、製造、実装、バリアント、カスタムの各データセットのうち、リリースに含めるものを特定し、必要なOutput Jobを割り当てる方法を確認します。
- リリース先のオプション、Workspaceアイテムの命名規則、およびターゲットリビジョンの設定項目を理解します。
- リリースの各段階に沿って進み、自動リリースコマンドがレビュー、レポート作成、PLMへのパブリッシュにどのように影響するかを学びます。
Online ModeのReleaseビューでは、リリースプロセスが段階的なフローで進行します。ビューの左側に表示される項目で、現在のステージを一目で確認できます。
-
Configure Server Release – リリースプロセスのこのステージでは、生成するデータの種類を指定します。指定できるのは、ソースデータ(常に生成)、基板製造データ、実装データ(ベース設計および検出された各バリアント用)です。
-
Validate Project – リリースプロセスのこのステージは、割り当てられたOutJobファイル内に検証タイプのレポートが1つ以上検出されると、自動的に実行されます。リリース対象のデータアイテムに割り当てられたOutput Jobファイルで定義されている、すべての検証出力ジェネレーターが実行されます。
-
Generate Data – リリースプロセスのこのステージは自動的に実行されます。ここでは、対象のデータアイテムに割り当てられたOutJobファイルで定義されているその他すべての出力が実行され、Workspace内の対応するターゲットアイテムにリリースするデータが生成されます。
-
Review Data – すべての検証チェックに合格し、出力データが生成されると、リリースプロセスのこのステージで生成されたデータを確認できます。
-
Upload Data – 前のステージでリリースを確定すると、自動的にこのステージに進みます。ここでは、ターゲットWorkspace内の対応するデータアイテムのリビジョンへのデータアップロードの進行状況が表示されます。
-
Execution Report – プロセスの最終ステージで、リリースの概要が表示されます。ナビゲーションリンクを使用して、Explorerパネルで生成されたアイテムリビジョンをすばやく参照できます。PLMへのリリースおよびパブリッシュを行うプロセスの一環としてProject Releaserにアクセスした場合は、
ボタンが表示されます。このボタンをクリックすると、プロセスの基盤となるワークフローが続行され、PLMにパブリッシュされます。
-
Publish to PLM – このステージは、該当する有効化済みのプロセス(リリース後にPLMへパブリッシュするプロセス)でリリースを実行している場合にのみ表示されます。前のステージで
ボタンをクリックすると、自動的にこのステージに進みます(
ボタンに関連付けられたメニューからPrepare & Release & Publish to PLMコマンドを使用した場合は、このステージに直接進みます)。Login Credentialsダイアログが表示されます。PLMインスタンスのUsernameとPasswordを入力し、使用するPLMテンプレート(<PLMInstance>:<PublishingTemplate>の形式で表示)を選択します。
オンラインのステージ1 – サーバーリリースの設定
リリースプロセスのこのステージでは、生成するデータの種類を指定します。リリース可能なデータアイテムは次のとおりです。
- Source Data – ソース設計のスナップショット。
- Fabrication Data – 基板製造業者がベアボードを製造するために必要なデータ。
- Assembly Data for the Base Design (no variations) – バリアントを適用しないベース設計について、実装業者が部品表に従ってベアボードにすべての部品を実装するために必要なデータ。
-
Assembly Data for Design
Variant n– ベース設計のVariant nについて、実装業者が部品表に従ってベアボードに部品を実装するために必要なデータ。
実装データセットの数は、ベース設計(バリアント未適用)と、その設計に定義されている検出済みのすべてのバリアントに対応します。

プロジェクトリリースプロセスのステージ1 – リリースに含める内容(生成するデータ)の設定。
Source Dataアイテムは常にリリースに含まれます。その他のデータアイテムを含めるかどうかは任意です。
Output Jobの割り当て
Fabrication DataおよびAssembly Dataアイテムをリリースに含めるには、それぞれに少なくとも1つのOutput Jobファイルを割り当てる必要があります。名前が「fab」および「ass」で始まるOutput Jobファイルがある場合、Releaseビューに初めてアクセスした際に、それらのOutJobがそれぞれFabrication DataおよびAssembly Dataセクションに自動的に割り当てられます。該当するファイルがない場合は、それぞれに適切なOutJobを手動で割り当てる必要があります。この操作は、Project Release OptionsダイアログのRelease Optionsタブから行えます(ビューの左下にある
ボタンをクリックしてアクセスします)。

必要に応じて、該当するデータセットにOutJobを割り当てます。
リリース先の切り替え
Project Release OptionsダイアログのRelease Optionsタブでは、リリース先を変更し、管理対象(Online)と非管理対象(Offline)の動作モードを切り替えることもできます。次の3つのオプションがあります。
-
Unmanaged - Folder(Offline):生成されたデータをローカルフォルダーにリリースするには、このオプションを設定します。ルートフォルダーのパスは、ダイアログのOutput Pathタブで指定します。デフォルトでは、[OutputPath]に設定されています(Project OptionsダイアログのOptionsタブにあるOutput Pathフィールドで定義されたパスを使用します)。 -
Unmanaged - Zip(Offline):生成されたデータをローカルフォルダーにリリースするには、このオプションを設定します。データは1つのZipファイルにまとめられます。Zipファイルのパスと名前は、ダイアログのOutput Pathタブで指定します。デフォルトでは、[OutputPath][ProjectName].zipに設定されています(Project OptionsダイアログのOptionsタブにあるOutput Pathフィールドで定義されたパスを使用します)。 -
Managed - <WorkspaceName>(Online):現在接続しているWorkspaceに(WorkspaceNameを使用して)リリースするには、このオプションを設定します。

プロジェクトのリリースオプションで、リリース先(生成されたデータの送信先)を切り替えます。
Workspaceアイテムの命名規則の設定
プロジェクトを対象のWorkspaceに初めてリリースする際、そのWorkspace内の対象データアイテム(生成されたデータを受け取るリビジョンの親アイテム)の命名方法を定義できます。この設定は、Project Release OptionsダイアログのItem Namingタブで行います。このダイアログには、ビューの左下にある
ボタンを押すか、リリースするデータセットのTarget RevisionリンクをクリックしてコンテキストメニューからEditを選択することでアクセスできます。このタブでは、次の設定を行います。
- プロジェクト名を定義します。デフォルトでは、実際のプロジェクト名が入力されます。
-
リリース時に生成できる各種データアイテムのデフォルトの命名規則を定義します。Item ID列のフィールド内をクリックし、フィールド右側の
ボタンをクリックすると、Choose Itemダイアログ(Explorerパネルと同様の機能を持つダイアログ)が開き、現在接続しているWorkspace内の既存のアイテムを対象として指定できます。
命名規則を変更するには、SettingsボタンをクリックしてNaming Template Settingsダイアログを開きます。

プロジェクト名を設定し、対象のWorkspace内に生成されるデータアイテムの命名規則を定義します。ここでは、プロジェクトがまだリリースされていないため、フィールドを編集できます。
命名テンプレートでは、次のマクロ形式がサポートされています。
-
Parameter-based – 角括弧で囲んだパラメーターを使用できます(例:
[ProjectName]、[VariantName]、[ProjectParameter])。 -
Numeric-based – 波括弧で囲んだ数値の桁数指定を使用できます(例:
{0000}、{9000})。
対象リビジョンの制御
メインビューに戻り、Target Revisionエントリの横にあるリンクをクリックすると、次の画像に示すコマンドメニューが開きます。

リリース時に生成するデータセットの対象リビジョンを指定するためのコントロールにアクセスします。画像にカーソルを合わせると確認できます。
使用できるコマンドは、そのアイテムの初回リリースが完了しているかどうかによって異なります。使用可能なすべてのコマンドを以下に示します。
-
Auto <RevisionID> – このエントリを使用すると、システムがリビジョンを管理するため、計画済みリビジョンが存在しない場合でも、手動で作成する必要がありません。
RevisionIDには、割り当てられたリビジョン命名規則の同じレベルにおける、アイテムの次のリビジョンが表示されます(たとえば、現在のリビジョンがA.1の場合、このコマンドでは対象がA.2と表示されます)。 -
Next <RevisionID> – このエントリは、アイテムの初回リリース後にのみ使用できます。割り当てられたリビジョン命名規則の1つ上のレベルで、対象リビジョンをすばやく繰り上げることができます。
RevisionIDには次のリビジョンが表示されます(たとえば、現在のリビジョンがA.1の場合、このコマンドは対象をB.1に切り替えます)。 -
Custom – このエントリを使用すると、 Custom Revision IDダイアログでカスタムのリビジョンIDを定義し、対象アイテムの特定のリビジョンを指定できます。 使用するリビジョン命名規則によっては、ダイアログに最大3つのレベルIDフィールドが表示されます。アイテムの最初の計画済みリビジョンのIDは、アイテムの作成後、その初期リビジョンにデータがリリースされるまで(つまり、まだ
Planned状態である間)は、いつでも変更できます。 - Browse – このエントリを使用すると、リリース先として既存の対象アイテムのリビジョンを指定できます。そのためのChoose Target Itemダイアログ(Explorerパネルと同様の機能を持つダイアログ)が表示されます。
- Edit – このエントリを使用すると、Project Release OptionsダイアログのItem Namingタブにアクセスし、作成される対象アイテム(および初期リビジョン)の名前を変更できます。
- Navigate – このエントリを使用すると、Explorerパネル内のアイテムにすばやく移動できます(そのアイテムはすでにリリース済みで、次のリビジョンが計画済みの状態で存在しています)。
メニュー最上部のエントリには、現在選択または定義されている対象リビジョンが表示されます。
データ生成の詳細へのアクセス
データセットのヘッダーの右端にあるDetailsコントロールをクリックすると、そのデータセットで具体的に何が生成されるかを確認できます。Hide Detailsコントロールをクリックすると、この詳細表示を折りたたむことができます。Source Dataセットを除き、データは割り当てられた1つ以上のOutput Jobファイルから生成されます。Configureコントロールをクリックすると、元のOutJobにすばやくアクセスできます。

データセットの詳細表示にアクセスして、生成されるデータを確認します。画像にカーソルを合わせると確認できます。
追加設定
PreferencesダイアログのData Management – Serversページでは、プロジェクトのリリースに関する追加設定を行えます。
-
現在接続しているWorkspaceにアップロードする前に、生成されたファイルを一時保存するフォルダーは、自動設定の場所(デフォルトのインストールでは
\Users\<ProfileName>\AppData\Local\Temp\Releases)にすることも、任意のフォルダーを手動で指定することもできます。 - Delete contents after exiting release modeオプションを有効にすると、リリース処理の完了後に一時保存フォルダーが空になります。
- 生成される各出力の名前には、必要に応じてアイテムIDとリビジョンIDを接頭辞として付けることができます(例:
[FAB-Kame_FMU-A.1] Validation.PDF)。これを行うには、Prepend revision HRID to file namesオプションを有効にします。
リリースの一環として作成するデータアイテムを必要に応じて設定したら、ビューの右下にある
ボタンをクリックして次に進みます。
準備の一環として、以下を含むリリース前チェックが実行されます。
- プロジェクトとすべてのファイルが保存されていること。
- 該当する場合、プロジェクトとすべての関連ファイルがVCSにコミットされていること。
- 有効になっている各データアイテムに名前が付けられていること。
- ユーザーにターゲットアイテム(およびリビジョン)を作成する権限があること。
- 必要なターゲットアイテム(および予定リビジョン)がWorkspaceにまだ存在しない場合は作成し、すでに存在する場合は次のリビジョンが使用されること。
問題が見つかった場合は、その解決方法が提示されます(ローカルで変更されたファイルの保存やVCSへのコミットなど)。
この時点でSource Dataアイテムが生成され、ソース設計プロジェクトファイルのスナップショットがターゲットアイテムのリビジョンにリリースされます。
オンライン ステージ2 – プロジェクトの検証
ステージ1が問題なく完了すると、割り当てられたOutJobファイルで検証タイプのレポートが1つ以上検出された場合に、リリースプロセスの次のステージが自動的に実行されます。リリース対象のデータアイテムに割り当てられたOutput Jobファイルで定義されている、すべての検証出力ジェネレーターが実行されます。これには、以下の実行が含まれます。
- Differences Report – コンパレーターを使用して、ソースドキュメントとPCB設計ドキュメントが正しく同期しているかを確認します。
- Electrical Rules Check – 入力されたソース設計の電気的および作図上の妥当性を確認します。
- Design Rules Check – 指定された基板レベルの設計制約に照らして、PCBドキュメントの妥当性を確認します。
-
BOM Checks – ソースBOMドキュメント(
*.BomDoc)がある場合、その中の設計アイテム または部品選択に関連する違反の可能性を確認します。 - Footprint Comparison Report – 基板上のフットプリントをソースライブラリと比較して、最新の状態であり、一致していることを確認します。
- Component State Checking – 使用が制限された状態にあるコンポーネントを確認します。設定時に、ターゲットWorkspaceで現在定義されている各ライフサイクル定義の各状態について、何もしない、警告を出す、エラーを生成する、のいずれかのアクションを指定します。エラーを生成する場合、設計はリリースできません。また、このチェックを実行すると便利なHTML形式のレポートが生成され、有効な状態にない設計コンポーネントを一目で確認できます。
- Environment Configuration Compliance Check – 割り当てられたロールで使用可能な環境設定によって許可されているデータアイテムのみが使用されていることを確認します(該当する場合)。このチェックでは、すべての設計アイテムがWorkspaceから取得されていることも確認できます。
検証が成功すると、
アイコンとPassedというテキストが表示されます。成功しなかった場合は、
アイコンとFailedというテキストが表示されます。
オンライン ステージ3 – データの生成
ステージ2が問題なく完了すると、リリースプロセスの次のステージが自動的に実行されます。このステージでは、対象のデータアイテムに割り当てられたOutJobファイルで定義されているその他すべての出力処理を実行し、Workspace内の対応するターゲットアイテムにリリースするデータを生成します。
他のステージと同様に、生成の進行状況はアイコンで表示されます。このステージは実行に時間がかかるため、特にこれらのアイコンが役立ちます。
– 未実行/未生成。
– 実行中/生成中。
– 生成成功。
– 生成失敗。
オンライン ステージ4 – データのレビュー
すべての検証チェックに合格し、出力データが生成されると、リリースプロセスのこのステージで生成されたデータをレビューできます。

リリースを確定してデータをWorkspaceにアップロードする前に、生成されたデータをレビューし、すべてが意図どおりであることを確認します。
このページでは、デフォルトで生成されたデータが簡易(コンパクト)表示されます。対象セクションのDetailsコントロールをクリックすると、詳細表示に切り替わります。

Detailsコントロールをクリックすると、該当セクションの生成データが簡易表示から詳細表示に切り替わります。Hide Detailsコントロールをクリックすると元に戻ります。
詳細表示での出力生成状態
次の表は、データの生成中に詳細表示で確認できる出力状態の一覧です。
状態 |
説明 |
|---|---|
|
出力はまだ生成されていないか、存在しません。 |
|
出力は生成されていますが、その後に設計が変更されたため、このデータの有効性は現時点では保証されません。 |
|
出力を現在生成中です。 |
|
この出力は検証ベースの出力であり、エラーのないレポートが生成されています。ERCレポートの場合は、エラーがないか、エラーのレベルがそのレポートに指定された最大許容エラーレベル以内に収まっています。 |
|
出力(検証ベースの出力を除く)が正常に生成されました。 |
|
出力は正常に生成されませんでした。検証ベースの出力の場合、ソース設計ドキュメントにエラーがあり、一部のチェックに合格していないことを意味します。通常の出力の場合、出力を正常に生成できなかったことを意味します。生成前の検証で致命的なエラーが発生しているか、Output Jobファイル内の対応する出力ジェネレーターの設定に問題がある可能性があります。 |
生成されたデータのコンパクト表示で、Viewリンクをクリックすると、関連するデータファイルまたはファイルセットが、Altium Designer内の対応するエディター(Gerberファイルや圧縮/非圧縮のODB++ファイルの場合はCAMエディターなど)、または対応する外部アプリケーション(部品表の場合はMicrosoft Excelなど)で開きます。詳細表示では、エントリをダブルクリックすると、そのファイルだけを表示できます。
多くの設計者がリリース前の確認として行う一般的なテストに、今回のリリースで生成されたGerberファイルと前回のリリースのGerberファイルの比較があります。Gerber出力の横にあるCompare Gerberリンクをクリックし、ドロップダウンメニューから以前のリリースを選択すると、準備したGerberデータと選択したリリースのデータを比較できます。既定のブラウザーで会社のWorkspaceが開き、結果が表示されます。

Workspaceにデータをリリースする前に、Project ReleaserからGerber比較機能にアクセス。
► Gerber Comparison機能の詳細(Altium 365 Workspace、Enterprise Server Workspace)。
データを確認した結果、修正が必要な場合は、ビューの右下にある
ボタンをクリックします。生成されたデータがすべて失われることを通知する確認ダイアログが表示されます。OKをクリックすると、リリースがキャンセルされ、プロセスのステージ1に戻ります。
生成されたデータに問題がなければ、
ボタン(こちらもビューの右下にあります)をクリックしてリリースを進めます。Confirm Releaseダイアログが表示され、Workspaceにリリースされるプロジェクトの構成が要約されます。ここでは、Name(既定の入力値は[ProjectName])とDescriptionを追加したり、関連するリリースノートを追加したりすることもできます。

生成されるアイテムリビジョンを確認し、名前/説明の変更やリリースノートの追加を行えます。
オンライン ステージ5 – データのアップロード
前のステージでリリースを確定すると、自動的にこのステージに進みます。ここでは、Workspace内の該当するデータアイテムのリビジョンへのデータアップロードの進行状況が表示されます。

このステージでは、Workspace内のリンク先アイテムリビジョンへの、生成データのアップロードの進行状況が表示されます。
オンライン ステージ6 – 実行レポート
これはプロセスの最終ステージで、リリースの概要が表示されます。
ナビゲーションリンクを使用すると、Workspaceへの入口となるExplorerパネルで、リリース済みデータ(製造データ、実装データ、およびカスタムデータセット)を含む関連アイテムリビジョンにすばやくアクセスできます。

Explorerパネルを使用して、プロジェクトのリリース済みデータをWorkspace内で直接表示。
リリース済みプロジェクトの表示
Workspaceプロジェクトでは、リリース完了後に利用できる追加機能があります。Execution Reportページ上部のナビゲーションリンクの最後にあるProject Pageリンクをクリックすると、Explorerパネルが開き、プロジェクトがProject Viewに表示されます。この機能はWorkspaceプロジェクトでのみ利用できます。

Project Viewを使用すると、ExplorerパネルでWorkspaceプロジェクトをより詳しく確認できます。
Releases領域(ビューの左下)には、プロジェクトに関連付けられたリリースの一覧が表示され、各リリースとその構成パッケージの概要が含まれます。この領域の
ボタンをクリックすると、一括状態変更ダイアログが開きます。このダイアログでは、同じリリースに関連する複数のアイテムのライフサイクル状態を、1回のバッチ処理でまとめて変更できます。
プロジェクトのリリース情報は、Explorerパネルの
ボタンから開く、対象WorkspaceのWeb Viewerでも確認できます。WorkspaceのWeb Viewerでは、プロジェクトに関連するすべてのリリースに、Releasesビュー(オンサイトサーバーが提供するWorkspaceの場合はManufactureビュー)からアクセスできます。このページには、すべてのプロジェクトリリースが新しい順に一覧表示されます。各リリースの「開く」ボタン(
)をクリックすると、Workspaceの Manufacturing Portalでそのリリースを開くことができます。Manufacturing Portalビューには、選択したリリースの詳細情報が表示されます。これには、リリースを構成するパッケージファイル、設計ドキュメント一式、および部品のメーカーとサプライヤーの詳細が含まれます。なお、Send to Manufacturer機能はAltium 365 Workspaceでのみ利用できます。► 詳細については、Altium 365 WorkspaceのReleasesビューページを参照してください。
これで完了です。プロジェクトのリリースが完了したら、Releaseビューを閉じるだけです(ビューの右下にある
ボタンを使用します)。今後、同じプロジェクトを再リリースする必要が生じた場合も、Project Releaserを使用すればすばやく簡単に実行でき、対象のアイテムリビジョンも自動的に繰り上げられます。
PLMインスタンスへのパブリッシュ
Related pages: PLM連携(Altium 365 Workspace、Enterprise Server Workspace)、PLMへのパブリッシュ
Altium DesignerでProject Releaserを実行する際に、その一環として設計を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コンテキストサブメニューからアクセスできます。
の一環としてPLMインスタンスにパブリッシュするプロセスへのアクセスProject Releaserが表示され、追加のステージ(7. Publish to PLM)が含まれます。また、生成されたデータと実行レポートの確認のために停止することなくProject Releaserを実行したい場合は、
ボタンに関連付けられたメニューからPrepare & Release & Publish to PLMコマンドを使用できます。

生成されたデータと実行レポートの確認のために停止せずにProject Releaserを実行するための追加コマンド
標準のPrepareコマンドでProject Releaserを実行した場合、データを確認してリリースすると、Execution Reportステージに
ボタンが表示されます。このボタンをクリックすると、プロセスのワークフローが続行され、PLMへのパブリッシュが行われます。Login Credentialsダイアログが表示されます。使用するPLMテンプレート(<PLMInstance>:<PublishingTemplate>の形式で表示)を選択し、PLMインスタンスのUsernameとPasswordを入力するか、SSOを使用してログインします。

PLMインスタンスへの初回パブリッシュ時に表示されるLogin Credentialsダイアログ。
Diagramタブをクリックすると、プロセスのワークフローを確認できます。

Login CredentialsダイアログのDiagramタブ
ボタンをクリックすると、そのワークフローに従ってパブリッシュ処理が進みます。

)が表示されます。問題を未然に防ぐため、プロジェクトに関連するすべてのドキュメントをプロジェクトフォルダーまたはそのサブフォルダーに保存することをお勧めします。



