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

概略

Altium DesignerのProject Releaserで、段階的に進めるオンラインモードのワークフローを使用し、接続先のWorkspaceに設計をリリースする方法を学びます。この記事では、リリースデータの選択、Output Jobの割り当て、Workspaceアイテムの命名とターゲットリビジョンの設定、および検証、データ生成、レビュー、アップロードの各段階を進める方法について説明します。また、対応するリリースプロセスを使用する場合のPLMへのパブリッシュについても解説します。リリースを設定し、各段階で何が行われるかを理解するために、引き続きお読みください。

- ソース、製造、実装、バリアント、カスタムの各データセットのうち、リリースに含めるものを特定し、必要なOutput Jobを割り当てる方法を確認します。
- リリース先のオプション、Workspaceアイテムの命名規則、およびターゲットリビジョンの設定項目を理解します。
- リリースの各段階に沿って進み、自動リリースコマンドがレビュー、レポート作成、PLMへのパブリッシュにどのように影響するかを学びます。
AIでさらに深掘り:

Online ModeのReleaseビューでは、リリースプロセスが段階的なフローで進行します。ビューの左側に表示される項目で、現在のステージを一目で確認できます。

  1. Configure Server Release – リリースプロセスのこのステージでは、生成するデータの種類を指定します。指定できるのは、ソースデータ(常に生成)、基板製造データ、実装データ(ベース設計および検出された各バリアント用)です。

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

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

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

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

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

  6. Execution Report – プロセスの最終ステージで、リリースの概要が表示されます。ナビゲーションリンクを使用して、Explorerパネルで生成されたアイテムリビジョンをすばやく参照できます。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内で部品番号が作成され、プロジェクトに関連付けられます。また、パブリッシュ操作の一環として、PLMインスタンス内にWorkspaceコンポーネントのエントリを定義し、PLM内でコンポーネントのBOMを取得することもできます(省略可能。プロジェクトをPLMインスタンスにパブリッシュする際に定義および使用するパブリッシュテンプレートによって異なります)。

オンラインのステージ1 – サーバーリリースの設定

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

  • Source Data – ソース設計のスナップショット。
  • Fabrication Data – 基板製造業者がベアボードを製造するために必要なデータ。
  • Assembly Data for the Base Design (no variations) – バリアントを適用しないベース設計について、実装業者が部品表に従ってベアボードにすべての部品を実装するために必要なデータ。
  • Assembly Data for Design Variant n – ベース設計のVariant nについて、実装業者が部品表に従ってベアボードに部品を実装するために必要なデータ。

実装データセットの数は、ベース設計(バリアント未適用)と、その設計に定義されている検出済みのすべてのバリアントに対応します。

さらに、Custom Dataセクションを追加して設定することで、カスタマイズしたリリースデータセットを作成できます。これは主に、後方互換性やカスタムデータフローのための機能です。ソースデータを除き、参照は作成されません。リリースの一環として、任意の数のカスタムデータセットを追加して設定できます(現在定義されているデータアイテムの一覧の下にあるAdd Sectionコントロールをクリックします)。

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

Source Dataアイテムは常にリリースに含まれます。その他のデータアイテムを含めるかどうかは任意です。

リリースの一環として作成するデータアイテムを必要に応じて設定したら、ビューの右下にあるボタンをクリックして次に進みます。

ボタンには2つの動作があります。クリックすると、標準のPrepareコマンドが実行されます。これにより、リリースはReview Dataステージまで進み、データのリリースを確定する前に、すべてが正しく設定されているか再確認できます。レビューのために一時停止しない場合は、ボタンに付属するドロップダウンメニューからPrepare & Releaseコマンドを選択します。

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

  • プロジェクトとすべてのファイルが保存されていること。
  • 該当する場合、プロジェクトとすべての関連ファイルがVCSにコミットされていること。
  • 有効になっている各データアイテムに名前が付けられていること。
  • ユーザーにターゲットアイテム(およびリビジョン)を作成する権限があること。
  • 必要なターゲットアイテム(および予定リビジョン)がWorkspaceにまだ存在しない場合は作成し、すでに存在する場合は次のリビジョンが使用されること。

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

リリースするプロジェクトに外部ドキュメント(プロジェクトに関連付けられているものの、プロジェクトフォルダーやそのサブフォルダー以外に保存されているドキュメント)が見つかると、External filesダイアログが開き、外部ドキュメントの一覧()が表示されます。問題を未然に防ぐため、プロジェクトに関連するすべてのドキュメントをプロジェクトフォルダーまたはそのサブフォルダーに保存することをお勧めします。

この時点で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 – データのレビュー

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

(ボタンに付属するメニューから)Prepare & Releaseコマンドを選択した場合、Project ReleaserはReview Dataステージで一時停止しません。

リリースを確定してデータをWorkspaceにアップロードする前に、生成されたデータをレビューし、すべてが意図どおりであることを確認します。
リリースを確定してデータをWorkspaceにアップロードする前に、生成されたデータをレビューし、すべてが意図どおりであることを確認します。

このページでは、デフォルトで生成されたデータが簡易(コンパクト)表示されます。対象セクションのDetailsコントロールをクリックすると、詳細表示に切り替わります。

Detailsコントロールをクリックすると、該当セクションの生成データが簡易表示から詳細表示に切り替わります。Hide Detailsコントロールをクリックすると元に戻ります。
Detailsコントロールをクリックすると、該当セクションの生成データが簡易表示から詳細表示に切り替わります。Hide Detailsコントロールをクリックすると元に戻ります。

生成されたデータのコンパクト表示で、Viewリンクをクリックすると、関連するデータファイルまたはファイルセットが、Altium Designer内の対応するエディター(Gerberファイルや圧縮/非圧縮のODB++ファイルの場合はCAMエディターなど)、または対応する外部アプリケーション(部品表の場合はMicrosoft Excelなど)で開きます。詳細表示では、エントリをダブルクリックすると、そのファイルだけを表示できます。

多くの設計者がリリース前の確認として行う一般的なテストに、今回のリリースで生成されたGerberファイルと前回のリリースのGerberファイルの比較があります。Gerber出力の横にあるCompare Gerberリンクをクリックし、ドロップダウンメニューから以前のリリースを選択すると、準備したGerberデータと選択したリリースのデータを比較できます。既定のブラウザーで会社のWorkspaceが開き、結果が表示されます。

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

► Gerber Comparison機能の詳細(Altium 365 Workspace、Enterprise Server Workspace)。

Source Dataセクションのコンパクト表示で、Viewリンクをクリックすると、プロジェクトのソースファイルのスナップショットが保存された一時フォルダーがWindowsエクスプローラーで開きます。この機能は、セクションヘッダーの右側にあるExploreリンクからも利用できます。実際、各セクションには同様のコントロールがあり、一時フォルダー内の該当データのサブフォルダーにすばやく移動できます。

詳細表示では、右クリックのコンテキストメニューのコマンドを使用して、ドキュメントを開いたり、その生成先(一時フォルダー内)をエクスプローラーで開いたりできます。フォルダーの場所や作成日のデータ列を追加することもできます。グリッドの見出し領域を右クリックしてSelect Columnsコマンドを選択すると、表示するデータをカスタマイズするためのダイアログが開きます。

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

リリースの準備からWorkspaceへのデータのリリースまでの間は、設計ファイルを変更できないようになっています。設計ファイルに何らかの変更を加えると、リリースプロセスが終了し、リリース準備前の初期ステージに戻ります。

生成されたデータに問題がなければ、ボタン(こちらもビューの右下にあります)をクリックしてリリースを進めます。Confirm Releaseダイアログが表示され、Workspaceにリリースされるプロジェクトの構成が要約されます。ここでは、Name(既定の入力値は[ProjectName])とDescriptionを追加したり、関連するリリースノートを追加したりすることもできます。

生成されるアイテムリビジョンを確認し、名前/説明の変更やリリースノートの追加を行えます。
生成されるアイテムリビジョンを確認し、名前/説明の変更やリリースノートの追加を行えます。

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

前のステージでリリースを確定すると、自動的にこのステージに進みます。ここでは、Workspace内の該当するデータアイテムのリビジョンへのデータアップロードの進行状況が表示されます。

このステージでは、Workspace内のリンク先アイテムリビジョンへの、生成データのアップロードの進行状況が表示されます。
このステージでは、Workspace内のリンク先アイテムリビジョンへの、生成データのアップロードの進行状況が表示されます。

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

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

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

ナビゲーションリンクを使用すると、Workspaceへの入口となるExplorerパネルで、リリース済みデータ(製造データ、実装データ、およびカスタムデータセット)を含む関連アイテムリビジョンにすばやくアクセスできます。

Explorerパネルを使用して、プロジェクトのリリース済みデータをWorkspace内で直接表示。
Explorerパネルを使用して、プロジェクトのリリース済みデータをWorkspace内で直接表示。

プロジェクトのバリアントに定義されたパラメーターは、対応する実装データセットのリビジョンに含まれます。ExplorerパネルのClassic Viewでプロジェクトを表示しているときに、目的の実装データセットのリビジョンを選択し、Parametersアスペクトビュータブに切り替えると、バリアントのパラメーターを確認できます。

バリアントパラメーターVariantLabel = AがプロジェクトのバリアントDefaultに追加されています。リリース済みの実装データセットにはこのパラメーターが含まれており、ExplorerパネルのParametersアスペクトビュータブで確認できます。
バリアントパラメーターVariantLabel = AがプロジェクトのバリアントDefaultに追加されています。リリース済みの実装データセットにはこのパラメーターが含まれており、ExplorerパネルのParametersアスペクトビュータブで確認できます。

これで完了です。プロジェクトのリリースが完了したら、Releaseビューを閉じるだけです(ビューの右下にあるボタンを使用します)。今後、同じプロジェクトを再リリースする必要が生じた場合も、Project Releaserを使用すればすばやく簡単に実行でき、対象のアイテムリビジョンも自動的に繰り上げられます。

プロジェクトをリリースするたびに、Project Released イベントタイルが、プロジェクトのHistoryビューのタイムラインに追加されます。リリースを実行したユーザーの名前(および写真)が、日時とともに表示されます。生成したデータをWorkspaceにリリースする際に、 リリースの確認ダイアログ でリリースノートを追加した場合は、その内容もタイル内に表示されます。リリースに含まれる各データセットも一覧表示されます。

プロジェクトの最新のコミットにまだタグがない場合は、そのコミットにタグが自動的に割り当てられます。このタグの形式は RELEASE_<RevisionID>です。ここで、 <RevisionID> は、リリースされたプロジェクトソースのリビジョン番号(A.1、 A.2など)です。たとえば、 RELEASE_A.3となります。

プロジェクトのHistoryビューに表示されるProject Releasedイベントタイルの例。プロジェクトの最新のコミットにはタグがなかったため、リリース後にタグが付けられています。
プロジェクトのHistoryビューに表示されるProject Releasedイベントタイルの例。プロジェクトの最新のコミットにはタグがなかったため、リリース後にタグが付けられています。

► 詳細については、プロジェクト履歴を参照してください。

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インスタンスへのパブリッシュが可能になります。ワークフロー図を以下に示します。

このプロセス定義をそのまま有効にして使用することはできません。テンプレートとして、自社の要件に合わせて編集し、名前を付けて新しいプロセス定義として保存してから、can有効にして使用してください。

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

有効にすると、Project Releaserの一環としてPLMインスタンスにパブリッシュするプロセスに、Altium Designer内からアクセスできるようになります。アクティブなプロジェクトのProject » Project Releaserサブメニュー、またはProjectsパネルで設計プロジェクトのエントリを右クリックして表示される Project Releaserコンテキストサブメニューからアクセスできます。

Project Releaser
Project Releaser

の一環としてPLMインスタンスにパブリッシュするプロセスへのアクセスProject Releaserが表示され、追加のステージ(7. Publish to PLM)が含まれます。また、生成されたデータと実行レポートの確認のために停止することなくProject Releaserを実行したい場合は、ボタンに関連付けられたメニューからPrepare & Release & Publish to PLMコマンドを使用できます。

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

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

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

PLMインスタンスのログイン認証情報が必要になるのは、そのインスタンスに初めてパブリッシュするときだけです。認証情報はWorkspaceに保存されます。それ以降、そのプロジェクトを同じPLMインスタンスにパブリッシュするときは、定義されたワークフローと選択されたパブリッシュテンプレートに従って、そのまま処理が進みます。

PLMインスタンスへの初回パブリッシュ時に表示されるLogin Credentialsダイアログ。
PLMインスタンスへの初回パブリッシュ時に表示されるLogin Credentialsダイアログ。

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

Login CredentialsダイアログのDiagramタブ
Login CredentialsダイアログのDiagramタブ

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

初めてパブリッシュする場合で、PLM側の部品番号がまだWorkspaceプロジェクトに関連付けられていない場合は、初回のパブリッシュ処理でPLMに部品番号が作成され、プロジェクトに関連付けられます。また、パブリッシュ操作の一環として、Workspaceコンポーネントに対応するコンポーネントエントリをPLMインスタンスに定義し、PLM内でコンポーネントのBOMを取得することもできます。これはオプションであり、プロジェクトをPLMインスタンスにパブリッシュする際に定義および使用するパブリッシュテンプレートによって決まります。

PLMへのパブリッシュプロセスのステータスは、Workspaceのブラウザーインターフェースで、プロジェクトの詳細管理ページにあるActivitiesビューから確認できます。 プロジェクトの詳細管理ページを開くには、WorkspaceのブラウザーインターフェースのProjectsページで目的のプロジェクトを選択し、プロジェクト一覧の上にあるコントロールをクリックして、表示されるメニューからOpenを選択します。または、一覧で目的のプロジェクトのエントリを直接ダブルクリックします。ページが新しいブラウザータブで開きます。 プロセスのワークフロー履歴(Historyタブ)では、PLMインスタンス内の部品番号など、作成された内容をいつでも正確に確認できます。

AI-LocalizedAI で翻訳
問題が見つかった場合、文字/画像を選択し、Ctrl + Enter キーを押してフィードバックをお送りください。
Contents
機能の提供状況

ご利用可能な機能は、お使いのAltiumソリューション(Altium Develop、Altium Agile Teams、Altium Agile Enterprise、または有効な契約期間中のAltium Designer)によって異なります。

実際にお使いのソフトウェアに文書化されている機能が表示されない場合は、詳細についてAltium Sales までお問い合わせください。

従来のドキュメント

Altium Designer のドキュメントは、バージョンごとに掲載されなくなりました。Altium Designer の旧バージョンのドキュメントは、Other Installers ページの Legacy Documentation の項目をご覧ください。

Contents