Releasing to a Workspace

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

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

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 – これはプロセスの最終ステージで、リリースのサマリを提供します。生成された Item Revisions を Explorer panel で素早く参照できるよう、ナビゲーションリンクが用意されています。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）が BOM に従って裸基板へ部品を実装するために必要なデータ（バリアントなしのベース設計用）。
• Assembly Data for Design Variant n – 実装業者（Assembly House）が BOM に従って裸基板へ部品を実装するために必要なデータ（ベース設計の Variant n 用）。

実装データセットの数は、ベース（バリアントなし）設計と、その設計に対して定義され検出されたすべてのバリアントに対応します。

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

Source Data アイテムはリリース時に常に含まれます。その他のデータアイテムは任意で含められます。

Setting Workspace Item Naming Schemes

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

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

Project アイテムは、リリースデータを受け取るために作成されるアイテムではなく、リリースされたデータアイテム全体のプロジェクトビューを提示し、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 をターゲットにすることもできます。

Releaseビューの第1ステージでは、アクティブに接続されているWorkspaceへリリースするデータを設定している間、アイテムの命名はいつでも変更できます。をクリックした後は、関連する命名を変更できません。これは、その命名で計画済みアイテムが、リリースに含まれる有効化された各データセットごとに作成され、プロジェクトにリンクされるためです。したがって、それらのアイテムへデータをリリースするところまで進めなかった場合でも、アイテムは準備完了の状態で存在し続け、対応する命名テンプレートのエントリはグレーアウトされます。これらの計画済みアイテムを削除するか、Browseコマンド（Target Revisionエントリをクリックしてメニューにアクセス）を使用して、各ケースで目的の命名を持つ新しいターゲットアイテムを作成できます。

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

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

準備の一環として、次のような複数の事前チェックが実行されます。

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

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

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

Online Stage 2 – Validate Project

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

• Differences Report – コンパレーターを使用して、ソースと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 – （該当する場合）割り当てられたロールで使用可能な環境設定により許可されているデータアイテムのみが使用されていることをチェックします。このチェックでは、すべてのDesign ItemsがWorkspaceから供給されていることも保証できます。

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

ビュー右下のをクリックすると、リリース処理は停止します。

Online Stage 3 – Generate Data

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

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

– まだ実行／生成されていない。

– 実行／生成中。

– 正常に生成された。

– 生成に失敗した。

ビュー右下のをクリックすると、リリース処理は停止します。

Online Stage 4 – Review Data

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

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

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

関連セクションで生成されたデータを、簡易表示から詳細表示へ切り替えるには Details コントロールをクリックします。Hide Details コントロールをクリックすると、再び元に戻せます。

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

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

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

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

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

生成データに問題がなければ、（同じく画面右下の） ボタンをクリックしてリリースを続行します。Confirm Release ダイアログが表示され、Workspace にリリースされるプロジェクト構成の要約が示されます。ここで Name（既定では [ProjectName]）、Description を追加でき、さらに必要に応じてリリースノートも追加できます。

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

Online Stage 5 – Upload Data

前ステージでリリースを確定すると、この次のステージに自動的に移行します。Workspace 内の関連データ Item のリビジョンへデータをアップロードする進捗が表示されるだけです。

このステージは、Workspace 内のリンクされた Item-Revisions へ生成データをアップロードする進捗を反映するだけです。

Online Stage 6 – Execution Report

これはプロセスの最終ステージで、リリースの要約を提供します。

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

ナビゲーションリンクを使用すると、リリース済みデータ（製造データ、実装データ、および任意のカスタムデータセット）を含む関連 Item Revision に素早くアクセスできます。場所は Explorer panel（Workspace へのポータル）です。

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

Viewing the Released Project

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

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

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

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

プロジェクトのリリース情報には、Explorer panel の ボタンから開く、対象 Workspace の Web Viewer でもアクセスできます。Workspace の Web Viewer では、プロジェクトに関連するすべてのリリースを Releases ビュー（オンサイトサーバー提供の Workspace の場合は Manufacture ビュー）で参照できます。このページにはすべてのプロジェクトリリースが一覧表示され、最新のエントリが最上部に表示されます。個々のリリースは、開くボタン（）から Workspace の Manufacturing Portal で開けます。Manufacturing Portal ビューでは、選択したリリースのより詳細な情報（構成するリリースパッケージファイル、設計ドキュメント一式、コンポーネントのメーカー／サプライヤー情報など）が表示されます。なお、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 への公開

Altium Designer で Project Releaser を実行する際、その一環として設計を PLM インスタンスへ公開（Publish）できます。公開処理では、公開テンプレート（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

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 インスタンス内の品番など、作成された内容を常に正確に確認できます。