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

概略

Altium Designerで、Project Releaserの段階的なオンラインモードのワークフローを使用して、接続されたWorkspaceに設計をリリースする方法を学びます。この記事では、リリースデータの選択、出力ジョブの割り当て、Workspaceのアイテム命名規則とターゲットリビジョンの設定、および検証、データ生成、レビュー、アップロードの各段階の進め方を説明します。また、対応するリリースプロセスを使用する場合のPLMへの公開についても取り上げます。リリースの設定方法と、各段階で行われる処理を確認しましょう。

- ソース、製造、実装、バリアント、カスタムの各データセットのうち、リリースに含めるものを選択し、必要な出力ジョブを割り当てる方法を確認します。
- リリース先のオプション、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内に作成され、プロジェクトに関連付けられます。また、パブリッシュ処理の一環として、Workspaceコンポーネントに対応するコンポーネントエントリをPLMインスタンス内に定義し、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つ以上検出された場合、リリースプロセスの次のステージが自動的に実行されます。リリース対象のデータアイテムに割り当てられた出力ジョブファイルで定義されている、すべての検証出力ジェネレーターが実行されます。これには、次の処理が含まれます。

  • 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にリリースする際に、 Confirm Releaseダイアログ でリリースノートを追加した場合は、その内容もタイル内に表示されます。リリースに含まれる各データセットも一覧表示されます。

最新のプロジェクトコミットにまだタグがない場合、その最新コミットにタグが自動的に割り当てられます。このタグの形式は 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インスタンスのUsernameとPasswordを入力し、使用するPLMテンプレート(<PLMInstance>:<PublishingTemplate>の形式で表示されます)を選択します。

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