一般的なリリースワークフロー

リリースプロセスを開始するには、4 つの方法があります。これは、選択したエンティティの [リリース候補を作成] ダイアログボックスを開くことです。1 つのパーツで説明します。

• Part Studio のパーツリストから: リリースするパーツを右クリックし、[リリース] を選択します。

  

  この方法では、[リリース候補を作成] ダイアログに、選択したパーツがあらかじめ入力されます。

• 任意のタブ (Part Studio、アセンブリ、図面、変数スタジオ、またはインポートされたファイル) の場合: タブを右クリックし、[リリース] を選択します:

  

  このメソッドでは、タブの内容があらかじめ [リリース候補を作成] ダイアログに入力されます。図面の場合は、図面のパーツやアセンブリも含まれます。

• 任意のプロパティダイアログから: パーツ、Part Studio、アセンブリ、図面、変数スタジオ、またはファイルタブを右クリックし、[プロパティ] を選択します。ダイアログの左上隅で、 をクリックします。この方法では、[リリース候補を作成] ダイアログに、選択したパーツまたは選択したタブの内容があらかじめ設定されます。
• 開いているバージョンと履歴フライアウトから をクリックします。このメソッドによって、リリース候補を作成ダイアログに、現在アクティブなタブのオブジェクトがあらかじめ設定されます。

上記の方法でリリースプロセスを開始すると、以下が可能になります。

1. [リリース候補を作成] ダイアログが開きます。

   

You can resize this dialog and its sections by clicking and dragging an edge or corner.

New or modified fields are marked with a yellow triangle in the upper left corner of the field. While in this dialog, you can use the Undo and Redo buttons or your operating system hot keys to undo or redo changes.

2. パーツリストで選択したパーツは、このダイアログに既にリストされています。アセンブリを選択すると、アセンブリ内のすべてのパーツがリストされます。プラス記号を使用してさらにオブジェクトを追加することもできます。以下に示すように、Part Studio、アセンブリ、変数スタジオ、図面、またはファイルからアイテムを選択できます。

   

   

   リストのオブジェクト名をクリックすると、送信前にオブジェクトのデザインを確認できます。適切なタブが別のブラウザタブで開きます。

   オブジェクト名の横にある赤い x をクリックすると、リリースに不要なオブジェクトを削除できます。

3. Optionally, click Include associated drawings  at the top of the dialog. Drawings associated with items in the release are also added to the release.
   • 関連付けられた図面が古くなると警告が表示され、更新したり、古い図面をリリースに含めることができます。
   • リリースが作成されたワークスペースとは異なるワークスペースのバージョンを参照している図面は、関連付けられた図面としては含まれません。これらの図面の 1 つを含めるには、リリースと同じワークスペースで作成するか、図面自体に図面のバージョンを作成してください。
4. リビジョンは、設定時の選択 (アルファベット、数字、カスタム) およびこのオブジェクトの以前のリリースに基づいて、自動的に提供されます。

   新しいリリースでは、リビジョンが自動的に増分されます。リビジョンは、リリースプロセスのオブジェクトにのみ適用され、ワークスペース内のオブジェクトには適用されません。リリース候補が作成されるとすぐに、バージョンがキャプチャされ、リリース候補内のすべてのオブジェクトがそのバージョンのオブジェクトになります。ワークスペースのオブジェクトには、パーツプロパティで手動で割り当てない限り、リビジョンラベルは表示されません。

   リリース管理をオンにした後の最初のリビジョン時に、Onshape はパーツ、アセンブリ、および図面のリビジョン値を維持しようとします。これは、リビジョンが既にオブジェクトに適用されている SOLIDWORKS などの外部ソースからオブジェクトをインポートする場合に便利です。たとえば、リビジョン値 3 でパーツをインポートすると、最初のリリースパッケージはパーツのリビジョンを 3 に維持します。関連するリビジョンがリリース管理スキームと同じでない場合、警告メッセージが生成され、オブジェクトのリビジョン値がリリース管理のリビジョンスキームに一致するように調整されます。たとえば、下の図のパーツ 3 には数値リビジョン値 6 が割り当てられており、リリース管理スキームはアルファベット順に設定されています。最初のリリースでは、パーツ 3 の新しいリビジョン値が A に設定され、警告メッセージが表示されます。

   

   リビジョンの変更はできますが、前に戻ることはできません。たとえば、前のリビジョンが B の場合、Onshape は C を提案します。C の後は任意のアルファベット文字を入力できますが、A に変更することはできません。

5. オブジェクトの現在の [状態] も自動的に提供されます。
   • [進行中] は、初めてリリースされたオブジェクトを反映します。
   • [保留中] は、リリースが承認保留中のオブジェクトを反映しています。
   • [リリース済み] は、以前にリリースされたリンクされたオブジェクトを反映します。
6. パーツに一意のパーツ番号を割り当てます。
   1. Onshape は、複数の [リリース] 間でパーツ番号を追跡し、既存のパーツ番号の下位リビジョンの再リリースを防止します。
   2. リリース管理設定でパーツ番号の順次生成をオンにしている場合は、 アイコンをクリックしてパーツ番号を生成します。ダイアログの上部にある をクリックすると、リリース候補内のすべてのオブジェクトのパーツ番号が生成されます。
   3. リリースのアセンブリまたはパーツのパーツ番号を [リリース管理] の設定で再利用できる図面があり、 をクリックしてリリース候補のすべてのオブジェクトのパーツ番号を生成する場合、Onshape はパーツ番号のないすべての図面に対して新しいパーツ番号を生成し、図面と図面に挿入したオブジェクトの両方に割り当てます。図面または図面に挿入したオブジェクトのどちらかに番号が関連付けられているが、もう一方には関連付けられていない場合は、関連付けられたパーツ番号は両方に割り当てられます。これは、図面にオブジェクトを 1 つだけ挿入した場合にのみ発生します。図面に複数のオブジェクトを挿入すると、新しいパーツ番号が生成されます。パーツリストの各項目の右側にある アイコンをクリックすると、個別のパーツ番号を生成できます。

   Click the Edit properties icon next to each object in the top half of the dialog to open the view displaying the properties in order to enter and record property information for the object. This allows you to begin editing properties of released objects.
   
   
   
   Click the Export icon next to the Properties icon to export that release or entities in that release.
   
   

7. 管理者がルールを設定する方法に基づき、一部のフィールドは必須となり、一部は必須とならない場合があります。次の各フィールドに、必要または目的に応じて情報を提供します。
   1. [リリース名]-Onshape では必須であり、[バージョンと履歴] フライアウトにバージョン名として表示されます (後でリリース情報を表示できます)。
   2. リリースノート - これは Company の管理者によって要求される場合と要求されない場合があります。リリースに関する具体的な情報や指示に適しています。
      1. 承認者 - オブジェクトをリリースする前にこのリリース候補を承認する必要があるユーザーの電子メールアドレスまたはユーザーのチーム名を入力します (これは、Company の管理者によって要求される場合と要求されない場合があります。このフィールドが空のままの場合は、[リリース] をクリックするとオブジェクトがすぐにリリースされます)。電子メールアドレスまたはチームが存在する場合は、リリース候補が作成され、承認者に通知され、承認者が承認するまで、オブジェクトはリリースされません。

         [承認者] フィールドでチームを一覧表示する場合、(リリース管理ワークフローの設定で) [すべての承認者からの承認を要求] が選択されていても、承認にはチームのメンバーが 1 人だけ必要です。

   3. オブザーバー - リリース候補 (またはリリース) に対して、閲覧限定アクセス許可を付与するユーザーのメールアドレスまたはチーム名を入力します。承認を必要としない場合でも、オブザーバーを入力できます。オブザーバーは通知を受信します。
8. Click one of the following based on the desired outcome:
   • Save draft to save the Release candidate you are currently working on as a draft and close the dialog. For more information, see Release drafts.
   • Submit (visible when approvers are listed) to create a version, and set the version icon, Release candidate, and its objects as Pending.

     A notification is sent to each approver and observer listed. A blue message bubble also appears at the top of the graphics area stating the release has been submitted (or other action) and contains a link to the Action items page where you can monitor and act on the release process.

     

     The message stating you can view the status on the Action items page

     

     The Action items page

     To move from Pending to Released and complete the release workflow, the Release candidate must be approved.

   • Close to close the dialog without recording any changes or taking any actions.

• [リリース候補] を作成するユーザーは、承認者のみを要求するのではない筈です。ベストプラクティスは、[承認者] フィールドに追加または別の人を要求することです。
• 適切な設計方法 (特に抑制とロールバックオプションの制限的または一時的な使用) に注意を払い、パーツが不適切に生成されることを防ぎます。
• リリースに含める前に、図面が更新されていることを確認してください。更新された図面がある場合は、リリース候補の作成時に「図面には保留中の更新があります」という通知が表示されます。
• リリース候補に含める前に、アセンブリにエラーがないことを確認するよう注意してください。
• リリース候補の項目に注意が必要な場合は通知され、リリース候補ダイアログで絞り込むことができます。注意が必要な項目の絞り込みを参照してください。

[アセンブリ] をリリースするには。

1. [アセンブリ] タブを右クリックし、[リリース] を選択して、[リリース候補を作成] ダイアログを開きます。

   [リリース候補を作成] ダイアログには、[アセンブリ] が参照するすべてのパーツ、サブアセンブリ、標準コンテンツを含む、[アセンブリ部品表] にリストされるすべてのものが入力されます。

2. [アセンブリ] 内の、他のドキュメントからリンクされているリリース済みパーツは、[リリース候補を作成] ダイアログに反映され、[アセンブリ] がリリースされる際に、パーツの新しいリビジョンは作成されません。

   

   ワークスペースでパーツを参照すると、アセンブリをリリースするときに、そのパーツのリビジョンラベルが引き上げられます。既にリリー済みのパーツを参照する場合、アセンブリをリリースするときにリビジョンは引き上げられません。

   [リビジョン] は、候補が実際にリリース/承認された場合のみ引き上げられることに注意してください。

同じ保留中のリビジョン値を取る同じパーツを含む、2 つの保留中のリリース候補がある場合、最初に承認された方が優先され、新しいリビジョン値を取得します。リリース候補が自動的に破棄されることはありません。また、保留中のリリース候補に対してアクションを実行する必要もありません。保留中のリリースは、パーツの保留中のリビジョンが既に実行されていて、唯一のアクションは破棄または拒否であることを示します。

3. Onshape の連番ジェネレータを使用している場合は、ダイアログの上部にある をクリックして、リリース候補内のすべてのオブジェクトのパーツ番号を生成します。
4. 上記の一般的リリースのワークフローの説明に従って、残りの必要なフィールドに入力し、ワークフロー手順を完了します。

アセンブリ内には標準コンテンツのパーツが含まれていますが、リビジョンは含まれていません。

図面をリリースするには。

1. [図面] タブを右クリックして [リリース] を選択し、[リリース候補を作成] ダイアログを開きます。

   

   [リリース候補を作成] ダイアログは、図面が参照するすべてのパーツまたはアセンブリを自動的に入力します。

   図面内の、他のドキュメントからリンクされているリリース済みパーツは、ダイアログに反映され、図面がリリースされる際に、パーツの新しいリビジョンは作成されません。

2. 上記の一般的なリリースワークフローの説明に従ってダイアログへの入力を続け、ワークフローステップを完了します。

アセンブリの図面とそのパーツの図面をリリースする場合、リリースダイアログには、すべての図面に含まれるすべてのパーツのリストが表示されます。これにより、リリース候補のダイアログにパーツが繰り返し表示されます。これらのパーツは数回リリースされているわけではなく、単に参照用にリストされているものです。たとえば、以下の例のパーツ 1 は、アセンブリの図面と独自の図面の両方にあるため、2 回表示されます。

図面に保留中の更新がある場合は、リリース候補の作成時に通知されます。これは情報提供のみを目的としており、リリース候補を作成する前に図面を更新する必要はありません。

[パーツ番号の一意性] の [リリース管理] 設定が [図面はリリース内のアセンブリまたはパーツからパーツ番号を再利用できます] に設定されている場合、欠落しているパーツ番号を生成すると、図面にはパーツまたはアセンブリと同じパーツ番号が付きます。

[リリース候補を作成] ダイアログでは、オブジェクトリストの検索や絞り込みができます。また、パーツ、アセンブリ、図面、その他のオブジェクトを名前で検索できます。

リストをオブジェクトタイプでリストにより絞り込みます。

1. [フィルター] アイコン をクリックして、フィルターリストを展開します。
2. [タイプ] アイコン () をクリックしてオンに切り替え、そのタイプのオブジェクトのリストを絞り込みます。
3. 複数のアイコンをクリックして、一度に複数のタイプを絞り込みます。
4. フィルターをクリアするには、タイプアイコンをもう一度クリックして選択解除するか、[クリア] ボタンをクリックしてすべてのフィルターを削除します。
5. フィルターアイコン をもう一度クリックして、フィルターリストを折りたたみます。

[リリース候補を作成] ダイアログには、あらゆる指定オブジェクトのプロパティを表示し、修正するメカニズムがあります。

1. [リリース候補を作成] ダイアログで、右側にある [プロパティを編集] アイコン をクリックして、そのオブジェクトの [プロパティ] ビューを開きます。

   

   プロパティビューではリストで他のオブジェクトを選択して、そのプロパティを表示・修正することもできます。

2. [適用] をクリックし、[プロパティ] ビューを離れることなく、すべてのオブジェクトへの変更を保存します。
3. [戻る]、または [戻る矢印] アイコン (パーツ名の下) をクリックして、メインの [リリース候補を作成] ダイアログビューに戻ります。これにより、ダイアログでの作業中にメタデータの変更が保存されます。
4. [適用] または [送信/リリース] をクリックし、[プロパティ] ビューで行った変更を含め、すべての変更を保存します。

既定では、リリースされたオブジェクトの構成済みパーツのプロパティ (メタデータ) は編集できません。つまり、[管理者のみがリリースされたオブジェクトのプロパティを編集できます] チェックボックスがオンになっている場合です。このチェックボックスがオフの場合:

• 管理者はリリースされたオブジェクトのプロパティを編集できます

• リリース管理上重要なプロパティを除き、リリースされたオブジェクトのプロパティは誰でも編集できます (Company の方針によって異なります)

リリース候補に注意が必要な項目が含まれている場合は (たとえば、パーツ番号の欠落や 2 つのパーツに誤って同じパーツ番号が割り当てられているなど)、[リリース候補を作成] ダイアログの右上隅にエラーの数が表示され、ダイアログ内の項目を絞り込んで注意が必要な項目のみを表示できるボタンが表示されます。

このボタンはトグルボタンです。ボタンを 1 回クリックすると、注意が必要なリリース候補項目のみが表示され、もう一度クリックするとすべてのリリース候補アイテムが表示されます。

アイテムが修正されると、数が減ります。すべての項目が修正されると、テキストとボタンが消去されます。

リリース候補を作成するときに、リリース候補内のオブジェクトが最新バージョンであることを確認できます。ダイアログタイトルの左側にある [更新] ボタンを使用します。

リリース候補を作成するときは、候補に含まれるオブジェクトすべてが適切であることを目視で確認できます。最新ではないと思われるオブジェクトがある場合は、オブジェクト名 (オブジェクトのリスト内) にあるリンクをクリックして、適切な Part Studio、アセンブリ、または図面を新しいタブで開きます。必要な変更を加えます。タブ内のオブジェクトに問題がなければ、[リリース候補] ダイアログを開いた状態でタブに戻り、[更新] ボタンをクリックします。

Onshape では [リリース候補] ダイアログのオブジェクトに加えられた変更が適用され、インターフェイスを更新して、それらの変更が反映されます。

例:

オブジェクトのリストでパーツ 1 をクリックすると、そのパーツの Part Studio が開いた状態で新しいタブが開き、オブジェクトを調べることができます。この例では、必要なフィレットフィーチャーが欠落しているため、パーツに追加されます。

フィレットフィーチャーが欠落している [リリース候補を作成] ダイアログのサンプル画像。

[リリース候補] ダイアログを含むタブに戻ります。パーツのサムネイルにはまだフィレットが表示されていないため、[更新] アイコンをクリックしてパーツを更新し、新しい変更内容を反映させます。

パーツが再度読み込まれ、他のタブで作成したフィレットフィーチャーが含められます。適用した変更が [リリース候補] ダイアログに表示されない場合でも、[更新] ボタンをクリックすると、変更内容が反映されます。[適用] または [送信] をクリックすると、バージョンが作成され、現在更新されているすべてのフィーチャーがそのバージョンに含められます。別のユーザーが同時に変更を行っている場合、リリース候補に対して行われた変更が優先され、作成されたバージョンに記録されます。その他の変更は、バージョンと履歴に記録されます。

[更新] ボタンは、リリース候補を作成するとき、および [リリース候補] ダイアログを開いているときに、リリース候補の作成者のみが利用できます。

変更のたびにダイアログを更新する必要はありません。

同様に、エラーを修正した後、[更新] ボタンを使用してリリース候補を更新できます。例:

ロールバック状態のフィーチャーリストがある Part Studio に属するパーツは、リリース候補の作成プロセスを実行できません。

パーツの名前をクリックして、Part Studio を含む新しいタブを開き、ロールバックバーを修正します。[リリース候補] ダイアログボックスが表示されているタブに戻り、[更新] をクリックして候補内のパーツを更新します。

問題は解決され、このリリース候補はレビューと承認のために送信できます

以前にリリースしたアセンブリまたは図面をリリースする場合は、Onshape は、リリース内のアイテムのジオメトリやメタデータが前回のリリース以降に変更されているかどうかについて、各参照をチェックします。次の 3 つのうちいずれか 1 つが発生します。

1. ジオメトリが変更された場合は、一般的なリリース候補プロセスに従います。

2. ジオメトリが変更されていないがメタデータが変更されている場合、Onshape は ([状態] 列の) [状態] の横の [元に戻す] ボタンを表示し、メタデータが変更されたことを示すメッセージが表示されます。

3. ジオメトリもメタデータが最新のリビジョン以降に変更されていない場合は、「アイテムは前回のリビジョンから変更されていません」というメッセージが表示されます。

   

アイテムのボタンをクリックすると、その参照が最後のリビジョンに変更され、それに応じてリリースパッケージが更新されます。これは参照更新であるため、アイテムがリリースパッケージと同じワークスペースから参照されている場合にのみ機能します。[状態] ヘッダーのボタンをクリックすると、変更されていないすべてのアイテムの参照が最後のリビジョンに変更されます。

リリースパッケージが送信されると、変更されていないアイテムが当初はワークスペース参照であった場合は、再びワークスペースに戻されます。当初はバージョン参照だった場合は、リビジョンで保持されます。

If the user does not submit the release and closes it without saving a draft or cancels the Release candidate, the reversion is undone.

このコンテキストでは、アセンブリ内のジオメトリの変更は、追加、除去、または変更されたインスタンス、および部品表の変更として定義されます。アイテムの再配置は、変更されていないジオメトリとして扱われます。

リジッド Part Studios 内のパーツインスタンスを元に戻すことはサポートされていません。

Onshape では、ドキュメント内の [リリース候補を作成] ダイアログで、リリース候補をドラフトとして保存できます。ドキュメント内の [リリースドラフト] パネルで保存したドラフトにアクセスして、編集、送信、または削除できます。

リリース候補をドラフトとして保存するには、リリース候補ダイアログで、左下の [ドラフトを保存] ボタンを選択します (下図では赤で囲まれています)。

これにより、リリース候補が自動的にドラフトとして保存され、ダイアログが閉じて、新しいドラフトが [リリースドラフト] パネルに追加されます。

[リリースドラフト] パネルにアクセスするには、グラフィック領域の左側にあるリリースドラフトアイコン をクリックします。

ここから、ドラフトをダブルクリックして [リリースをレビュー] ダイアログを開き、リリース候補の編集を続けます。

リリースをドラフトとして再度保存したり、ドラフトを削除したりするには、左下の [ドラフトを保存] オプションの横にある矢印をクリックして、希望するオプションを選択します。

または、[送信] ボタンをクリックしてリリースを送信し、ダイアログを閉じます。

変更を保存または送信せずにダイアログを閉じるには、[閉じる] ボタンをクリックします。

1 つのドキュメント内の [Part Studio]、[アセンブリ]、および [図面] はすべて、他のドキュメントのバージョンのオブジェクトを参照できるため、リンクされたオブジェクトを作成できます。リンクされたオブジェクトは自動的に [リリース候補] に含まれますが、リリースプロセスの間にすべてのオブジェクトがどのように処理されるかは、リンクされているかどうかにより影響を受けます。

• オブジェクトが現在のワークスペース (リンクされていないオブジェクト) にある場合、[リリース候補] が作成されると、[リリース状態] は初期的に [進行中] になります。それは ワークスペースが定義によって常に編集可能であるからです。現在のワークスペースからオブジェクトをリリースすると、現在のドキュメントにバージョンが作成され、オブジェクトおよびバージョンは [リリース済み] (または 承認が必要な場合は承認 [保留]) としてマークされます。
• オブジェクトが別のドキュメント内の未リリースバージョンからリンクされている場合、[リリース候補] が作成されると、[リリース状態] は初期的に [進行中] になります。非リリースバージョンからリンクオブジェクトをリリースしても、操作は現在のワークスペース内のオブジェクトのリリースと変わることはありません。ただし、リンクされたドキュメント内のバージョンも [リリース済み] としてマークされ、バージョンに添付される [リリース] は現在のドキュメントのものになります。
• リンクオブジェクトが [承認保留中] のリリースにリンクされている場合、[保留] 状態になります。リンクオブジェクトは [リリース済み] ではなく [保留] であるため、メタデータと [リビジョン] は変更できます。リンクオブジェクトをリリースすると、その状態が [リリース] に変更され、リンクバージョンに追加の [リリース] が添付され、以前の [保留] [リリース候補] は上書きされます。
• リンクオブジェクトが [リリース済み] バージョンにリンクされている場合、そのオブジェクトの状態は [リリース済み] になります。[リリース済み] オブジェクトを新しい [リリース] に含めても、オブジェクトの [状態] や [リビジョン] は変更されません。[状態] および [リビジョン] はユーザーの参照に含まれます。

オブジェクト (またはドキュメント全体) をリビジョンでマークしないようにしたい場合があります。これらのオブジェクトは、参照目的でリリースに含めることが必要となる場合がありますが、リビジョンを追跡する必要はありません。Onshape では、オブジェクトをリビジョン未管理 (リリースプロセス中にリビジョンを受信しない) としてマークすることができます。

1. Access the Properties dialog for the object (Assembly, Document, Drawing, Variable Studio, or File) through any of:
   1. The Workspace menu > Properties command
   2. The Versions and history panel context menu > Properties command
2. [プロパティを編集] アイコン をクリックします。オブジェクトをリビジョン未管理としてマークするには、[プロパティ] ダイアログの下部にある [リビジョンが管理されていません] チェックボックスをクリックします。

リビジョン未管理としてマークできるオブジェクトには、Part Studio (Part Studio 内のすべてのパーツを含む)、アセンブリ、図面、変数スタジオ、ファイル、および個々のパーツが含まれます。