ワークスペースプロジェクト

Parent page: Altium On-Prem Enterprise Server

Altium Designer は、Enterprise Server Workspace と組み合わせることで、Workspace Projects をサポートします。Workspace プロジェクトは、プロジェクトライフサイクルの開発段階を対象としており、バージョン管理されたプロジェクトの作成と継続的なワークフローを簡素化します。Workspace の管理下にある集中ストレージにより、この機能は他のコラボレーションサービスの基盤にもなります。

Workspace プロジェクトを使用する主な利点は次のとおりです。

• ストレージの簡素化。保存場所を判断する必要はありません。バックアップやその他の基本サービスは用意されています。
• コラボレーション機能の基盤。
• バージョン管理の強制。
• 専用コメントシステムの利点。
• 通知とステータス。ローカルの変更を含むドキュメントのステータスが、設計チーム全体に可視化されます。
• 複雑な設定なしで、同時並行の PCB 設計が可能です。
• Web Viewer を介して、プロジェクトの読み取り専用・ブラウザベースのインタラクティブビューを他のユーザーと共有できます。
• インタラクティブな Project History view など、高度なバージョン管理機能一式。

技術的には、Workspace プロジェクトは、Enterprise Server Workspace に保存されるメタ情報と、Workspace 独自の Version Control service との緊密な統合を組み合わせたものです。一般的なワークフローは次のとおりです。

1. ユーザーは、Altium Designer の Create Project ダイアログから creates a new Workspace project します。あるいは、Make Available On Server dialog を介して converting an existing local project を行うか、Workspace のブラウザインターフェース内（detailed below）から作成します。作成時に、そのユーザーはプロジェクト名、説明、設計リポジトリを定義します。
2. プロジェクトへのアクセスは、Workspace のブラウザベースのインターフェース、または Altium Designer から直接、定義および管理します。
3. 共同作業者は全員、プロジェクトを開くために選択します（Altium Designer 内、または Workspace のブラウザインターフェースから）。その後、設計ファイルとして自動的にチェックアウトされます。

このドキュメントでは、Enterprise Server Workspace のブラウザインターフェースを通じてプロジェクトを扱う方法を説明します。設計ソフトウェアでのプロジェクトの扱いについては、Working with Projects を参照してください。

新しい Workspace プロジェクトの作成

Workspace プロジェクトを作成する主な方法は 3 つあります。

• Workspace のブラウザベースのインターフェース、または from within Altium Designer から新規プロジェクトを作成する。
• 既存のプロジェクト（ローカルプロジェクト、または外部のバージョン管理下にあるローカルプロジェクト）を、Altium Designer 内から Workspace で利用可能にする。つまり、ローカルプロジェクトを Workspace プロジェクトに変換します。詳細は Making an Existing Project Available in the Workspace ページを参照してください。
• Workspace のブラウザベースのインターフェースから、既存の Workspace プロジェクト をクローンする、または Altium Designer の Projects panel から cloning a project を行う。

Workspace のブラウザインターフェースから直接 Workspace プロジェクトを作成するには、次の手順を行います。

1. インターフェースにサインインし、Projects メニューオプションを選択して Designs page にアクセスします。以前に作成したプロジェクトがあれば、ここに一覧表示されます。

2. ページ上部の ボタンをクリックし、続いて Create Project メニューオプションを選択して Create Project  ウィンドウを開きます。

   Project Creations のプロセステーマに対して利用可能なアクティブな process definitions がある場合（Workspace ブラウザインターフェースの Processes page の Project Creations タブで定義）、 ボタンメニューには Create Project オプションの代わりにそれらのプロセスが選択肢として表示されます。必要な項目を選択して、そのプロセスワークフローを起動します。

3. ウィンドウは最初、簡易表示で表示されます。プロジェクト名（任意の名前）、説明（必要に応じて）を入力し、Templates ドロップダウンメニューから適切な Project Template を選択します。

   プロジェクト名は先頭が A-Z、a-z、または 0-9 で始まる必要があり、A-Z、a-z、0-9 を含めることができます。アンダースコア、ダッシュ、スペースも使用できますが、スペースは名前の途中でのみ使用可能です（先頭および末尾のスペースは無視されます）。次の単語は使用できません: AUX, COM1-COM9, LPT1-LPT9, CON, NUL, PRN。さらに、名前には次の文字を含めることはできません: \ . / ? % * : | " < >。
4. より多くのコントロールにアクセスするには ボタンをクリックします。次のフィールドが表示されます。
   1. Parent Folder – このフィールドで、Workspace のフォルダ構造内のどこにプロジェクト用フォルダを作成するかを指定します。デフォルトは Projects\<ProjectName> です。新規プロジェクトのデフォルトパスは、Workspace の browser interface の Admin – Settings – Projects page で指定します。

   2. Repository – このフィールドには、Workspace のローカル Version Control service を通じて管理され、かつ使用するために共有されているすべての設計リポジトリが一覧表示されます。新しいプロジェクトとそのファイルを保存するリポジトリを選択します。デフォルトでは、Versioned Storage（Git ベース）リポジトリが選択されます。

      以前のサーバー技術から Enterprise Server にアップグレードしており、内部（SVN）および/または外部（SVN/Git）の設計リポジトリを引き続き使用できる場合は、Repository field が表示されます。ここには、Workspace のローカル Version Control service を通じて管理され、かつ使用するために共有されているすべての設計リポジトリが一覧表示されます。新しいプロジェクトとそのファイルを保存するリポジトリを選択します。SVN ベースのリポジトリを選択した場合は、Repository Folder フィールドが表示されます。このフィールドで、プロジェクトおよび関連ファイルを格納するために、リポジトリ内に作成するフォルダ名を指定します。デフォルトではプロジェクト名が使用されます。

Workspace のブラウザインターフェースから直接、新しい Workspace プロジェクトを定義します。

必要に応じて新しいプロジェクトを定義したら、 をクリックします。新しいプロジェクトが作成されます。概要レベルのプロジェクト一覧に戻り、新しく作成されたプロジェクトのエントリが表示されます。

ブラウザインターフェースから作成された追加の Workspace プロジェクト。

Workspace プロジェクトの参照

Workspace ブラウザインターフェースの Projects page にあるプロジェクト一覧には、あなたに共有されているすべてのプロジェクトが含まれ、プロジェクト管理機能にアクセスするための各種コントロールが用意されています。 ボタンでページをプロジェクトプレビュー（グラフィカルタイル）モードに切り替え、 ボタンで詳細リストモードに切り替えます。

Workspace ブラウザインターフェースの Designs page – Workspace プロジェクトを扱うための司令塔です。ここではページの詳細リストモードを示しています。画像にマウスを重ねると、プロジェクトプレビューモードを確認できます。

ビューのプロジェクトエントリは Last modified 日付で自動的に並べ替えられ、最も最近変更されたプロジェクトが一覧の先頭に表示されます。 ボタンをクリックするとプロジェクト名での並べ替えに変更され、もう一度クリックすると昇順/降順が切り替わります。

リストモードビュー（）は、各列ヘッダーを使用して Name、Author、または Date で並べ替えできます。1 回クリックで昇順、もう 1 回クリックで降順に並べ替えます。列名の右側の矢印は、現在有効な並べ替え方向を示します。

Projects ビューでは、選択したプロジェクトに関連する Properties および Activities データが、ビュー右側のサイドバーペインで利用できます。

サイドバーペインの情報には次が含まれます。 Properties tab: Project – プロジェクトの状態の概要（プロジェクトに PCB がある場合は基板の 3D ビューを含む）。 Shared With – プロジェクトにアクセスできるユーザーおよび/またはロール。エントリにマウスを重ねると、ユーザー/ロールのフルネームが表示されます。 Parameters – プロジェクト設計そのものから抽出または算出された詳細メタデータ。Show More コントロールをクリックすると全リストが展開されます。 Releases – プロジェクトリリースの一覧（時系列順）。エントリをクリックすると、そのリリースが Workspace の Manufacturing Portal で開きます。 Activity tab – Commit、Release、またはプロジェクトに関連付けられた完了済みプロセスワークフローなど、プロジェクトイベントの時系列リスト。

各プロジェクトについて、ビュー上部のボタンから以下の操作も行えます（詳細は後続のリンク先セクションを参照してください）。

• Share – プロジェクトのアクセス権限を設定するためのアクセス制御。
• Activities – プロジェクトで利用可能なプロセスアクティビティへのメニューアクセス。
• Functions – プロジェクト機能へのメニューアクセス。Previewモードでは、選択したプロジェクトのボタンからも利用できます。
  • Open – プロジェクトをCAD中心の詳細ビューで開きます。プロジェクト名のエントリをクリック（Previewモード）またはダブルクリック（Listモード）するのと同等です。
  • Move – Workspaceのフォルダ構造内で、プロジェクトを別の親フォルダへ移動します。
  • Edit – プロジェクトのName、Description、およびWorkspace Parametersに関する内容を編集します。
  • Clone – プロジェクトの同一コピーを別名で作成します。
  • Watch/Unwatch – プロジェクトのアクティビティをフォロー／フォロー解除します。関連通知（更新、リリースなど）をプロジェクトのActivitiyタブ、およびEmail Notificationsが有効な場合はメールでも受け取れます。
  • Delete – プロジェクトの構造とデータをWorkspace Trashへ移動してプロジェクトエントリを削除します。そこからWorkspace から完全削除するか、以前の状態に復元できます。

また、プロジェクト一覧を名前、作成者、説明などの各種プロパティで絞り込めるプロジェクトSearch機能も含まれています。ブラウザインターフェース上部のフィールドに検索文字列の一部を入力してください。リストは更新され、属性に検索文字列を含むプロジェクトエントリのみが表示されます。

検索フィルタリングを解除するには、左側ナビゲーションペインのメインProjectsページエントリをクリックするか、検索フィールドをクリアしてEnterを押します。

検索機能の使用例（この例では説明に基づいてプロジェクトを検索）。

Workspaceフォルダの操作

Workspaceでは、Workspace構造内でプロジェクトフォルダを作成・管理することもできます。作成されたフォルダ階層内の任意のフォルダにプロジェクトを作成したり、プロジェクトを移動したりできます。

(デフォルトの)最上位Projectフォルダ配下に新しいフォルダを作成するには、ボタンメニューからCreate Folderオプションを選択します。続くCreate Folderウィンドウで、新しいフォルダ名、親フォルダ、任意の説明を指定します。新しいフォルダは常に現在選択されているフォルダ配下に作成され、そのフォルダが親フォルダになります。

作成したフォルダはタイトルを選択して開き、上部のパンくず（breadcrumbs）で階層を上に戻れます。

メニューオプションを使用して、フォルダの詳細を変更（Edit）、別の親フォルダ配下へ移動（Move）、またはWorkspaceのフォルダ構造から削除（Delete）できます。フォルダを移動する場合は、Move folder <folder> toウィンドウの階層ツリーから新しい親フォルダを選択します。

プロジェクトのアップロード

Altium Designerでは、Make Available on ServerコマンドによりローカルプロジェクトをWorkspaceへアップロードし、Workspace側のバージョン管理下にあるWorkspaceプロジェクトになります。同等の処理は、Workspaceのブラウザインターフェースでも、ボタンメニューから利用できるUpload Projectオプションで実行できます。ローカルプロジェクトのホストフォルダを参照して選択すると、デフォルトでは現在選択中のWorkspaceフォルダへそのプロジェクトがアップロードされます。あるいは、Upload ProjectウィンドウのParent FolderリストにあるChangeオプションを使用して、フォルダ階層内の別の場所を選択できます。

ローカルプロジェクトに既存のバージョン管理リンクがあっても無視され、アップロードされたプロジェクトは完全にバージョン管理された Workspaceプロジェクトになります。 ローカルの元プロジェクトは一切変更されません。

プロジェクトの移動

プロジェクトを別のWorkspaceフォルダへ移動するには、メニューのドロップダウンオプションからMoveを選択し、Move project <project> toウィンドウのフォルダ階層から新しい場所を選びます。ボタンで確定すると、選択したプロジェクトは新しく指定した親フォルダ配下でホストされます。

Workspaceプロジェクトの共有

プロジェクトがWorkspaceに入ったら、実際にそのプロジェクトへアクセスできるユーザーを決める必要があります。これはプロジェクトを共有する、より正確にはアクセス権限を設定することで行います。Workspaceプロジェクトはデフォルトで次の相手に共有されます。

• プロジェクトのOwner（通常は作成者、またはWorkspaceで利用可能にした設計者）：フル（Read/Write）アクセス権限。
• Administratorsロールグループ：フル（Read/Write）アクセス権限。
• Workspaceの全メンバー：閲覧のみのアクセス。

新規プロジェクトのデフォルト権限は、WorkspaceブラウザインターフェースのAdmin – Settings – Projects ページで定義／変更できます。なお、プロジェクトのOwnerには本質的にアクセス権限が割り当てられるため、リストには表示されません。

アクセス権限の設定は、Workspaceのブラウザインターフェースから行えるほか、Altium Designer内から直接行うこともできます。

Workspaceブラウザインターフェースからプロジェクトのアクセスを設定するには、Designs ページ（メインメニューのProjects）でプロジェクトエントリを選択し、ボタンをクリックしてShare:<project>ウィンドウを開きます。あるいは、プロジェクトエントリに関連付けられたメニューからShareオプションを選択します。これにより、他のユーザーやユーザーグループ（Roles）とプロジェクトを共有するために必要なコントロール一式が提供されます。

Workspaceでプロジェクトを一元管理している場合、他者との共有は各プロジェクトの権限を管理するだけで実現できます。

Share <project>ウィンドウ内：

• Can Editオプションが有効な場合、ユーザー／ロールはRead/Writeアクセスになります。無効の場合はRead（読み取り）アクセスのみです。
• Shared With領域のWorkspace Membersエントリのドロップダウンメニューを使用して、Workspaceの全メンバーに対して読み取り専用（Can View）または読み取り／書き込み（Can Edit）でプロジェクトを共有できます。
• 既存のユーザー／ロールの共有アクセスを解除するには、関連するドロップダウンメニューのRemove オプションをクリックします。

注意点：

• デフォルトでは、Workspaceの全ユーザーがプロジェクトを閲覧できます。特定のユーザーやグループのみにアクセスを制限したい場合は、まずWorkspace MembersエントリのドロップダウンメニューでNo access を選択する必要があります。
• プロジェクトのOwnerは恒久的にRead/Writeアクセスを持ちます。
• プロジェクトへの直接リンクを共有することもできます。リンクはSharingウィンドウ下部のCopy Linkコントロールをクリックして取得します。リンクはクリップボードにコピーされます。使用すると、許可されている場合に限り、対象ユーザーはプロジェクトの詳細管理ページへアクセスできます。その概要は次のセクションで示します。

Workspace Project Activities

Workspace では、構成可能な Process Workflows を Workspace プロジェクトに適用し、設計レビューの実施や新規プロジェクトの作成など、目的に合わせたタスクを実行できる独自の機能を提供します。プロセスおよびその基盤となるワークフローは Workspace 管理者によって作成・設定され、有効化されると Altium Designer と Workspace のブラウザーインターフェースの両方のユーザーが利用できるようになります。

► 詳細は Creating & Managing Processes を参照してください。
► Altium Designer におけるこれらのプロセスについては Performing Design Reviews を参照してください。

ユーザーの観点では、Process Workflows とその内在するステップは Activities として扱われます。利用可能なアクティビティはユーザーが起動でき、割り当てられたユーザーがワークフローステップを一連のタスクとして完了します。これらは Tasks ページから利用できます。

Designs ページ（Projects）で メニューを選択し、利用可能なプロセスから選んで、現在選択されているプロジェクトのアクティビティを開始します。続くプロセスフォームの各ウィンドウで必要なフィールドとオプションを入力し、その後プロセスを開始します（）。起動した Process Workflow によっては、レビュー用データを準備するために次のステップを送信（）する必要があります。

その後、アクティビティに割り当てられたユーザー（複数可）向けに Workflow タスクが作成されます。サインイン中のユーザーに適用されるタスクは、そのユーザーの Tasks ページに表示され、実行することでワークフローを次の段階へ進められます。

なお、アクティビティがロールグループ（例：Engineers）に割り当てられている場合、関連タスクはそのグループの全メンバーに加え、アクティビティに個別割り当てされたユーザー（ここでは Bruce — Engineers ロールのメンバー）にも利用可能になります。このような場合、これらのユーザーのいずれかがレビュー手順を完了し、結果を送信（）できます。

Workspace Project Functions

プロジェクトに関連する機能操作は、Designs ページの メニューから利用でき、Workspace プロジェクトのオープン、移動、編集、クローン、ウォッチ、削除が含まれます。このメニューは、選択したプロジェクトエントリの ボタンからも利用できます。

Open a Project

プロジェクトエントリの メニュー、または上部の メニューから Open オプションを選択すると、製造指向の CAD 中心ビューでプロジェクトを開けます。あるいはプレビューモード（）では、プロジェクト名をクリックします。このビューでは、ナビゲーションペインから利用できる複数のサブビューにアクセスできます。

• Design – プロジェクトの設計ドキュメントをナビゲートして操作し、オブジェクトプロパティを確認し、レビューコメントを配置します。このビューは現在（最新）のプロジェクトリビジョンに適用され、Web Viewer インターフェースを使用します。
• Supply – 設計ドキュメントから抽出された作業中（WIP）の BOM データを対話的に確認します。これには、プロジェクトに投入された ActiveBOM ドキュメントから導出されたメーカー部品およびサプライヤー部品データのエントリが含まれます。
• Releases – 現在のプロジェクトに対するすべてのリリースの概要情報を表示します。各リリースは Manufacturing Portal view で開くことができます。さらにその中で、選択したリリースに含まれるリリースパッケージファイル、設計ドキュメント、サプライデータのサブビューを利用できます。
• Activities – 現在のプロジェクトに適用される、アクティブまたはクローズ済みの Process workflow Activities を表示します。
• History – プロジェクトに関連する主要イベント（作成、コミット、リリース、クローンなど）の進行タイムラインを参照します。プロジェクトに関連してサポート対象のイベントが発生するたびに、そのイベントは専用タイルとしてタイムラインに追加され、該当する場合は各種アクションが利用できます。

► 詳細は Management of a Specific Project を参照してください。

Edit a Project

Workspace 内の既存プロジェクトのプロパティを編集するには、Designs ページ（Projects）でそのエントリを選択し、 メニューまたは上部の メニューから Edit オプションを選択します。続く Project Editing ウィンドウで、プロジェクトの Name、Description を変更し、Workspace Parameters エントリを管理できます。

Project Editing ウィンドウで ボタンをクリックすると、プロジェクトから派生し、プロジェクトとともに保存される追加のプロパティデータが表示されます。Parameters コントロールを選択して、パラメータの Name/Value ペアを追加（）、編集、または削除（）できます。これらはプロジェクトとともに Workspace に保存され、Altium Designer では Special Strings として使用できます。設計空間で配置済みのテキストオブジェクトを選択した状態で Properties パネルからアクセスします。対照的に、プロジェクトタイプのパラメータはプロジェクトファイル（*.PrjPcb）に保存され、Altium Designer で編集できます。

Clone a Project

既存の Workspace プロジェクトをクローン（複製）するには、Designs ページ（Projects）でそのエントリを選択し、 メニューまたは上部の メニューから Clone オプションを選択します。Clone Project ウィンドウで、クローンされたプロジェクトの名前と説明を設定します。デフォルトでは、元のプロジェクト名に - Copy サフィックスが付いた名前が使用されます。

ボタンをクリックすると、ターゲットの親フォルダやリポジトリ情報などを含む追加のプロパティフィールドが表示されます。ターゲットフォルダ設定は、手動で指定しない限り自動的にプロジェクト名と一致します。または Change オプションにより、別の既存の親フォルダに割り当てることもできます。

プロジェクトは Altium Designer でも、Explorer panel の メニューにある Clone オプション、または Projects panel でプロジェクト名を右クリックしてコンテキストメニューから Clone オプションを選択することでクローンできます。

必要に応じてフィールドを設定したら、 ボタンをクリックして確定します。元のプロジェクトは、その構成ファイルおよびデータとともにクローン（複製）され、Projects ページの一覧に新しいプロジェクトエントリとして追加されます。

Watch a Project

Workspace でプロジェクトを「ウォッチ」（通知を受け取る）するには、Designs ページ（Projects）でそのエントリを選択し、 メニューまたは上部の メニューから Watch オプションを選択します。

プロジェクトをフォロー（ウォッチ）すると、プロジェクトに関連する通知（コミット、リリース、プロパティ変更メッセージなど）を、インターフェース右側ペインの Activities タブで受け取れます。プロジェクト作成者は自動的にそのプロジェクトをウォッチする設定になります。有効化されると、コマンドは Unwatch に変わります。これを選択するとプロジェクトのフォローを停止し、そのプロジェクトに関連するイベント通知の受信も停止します。

Delete a Workspace Project

既存の Workspace プロジェクトを削除（除去）するには、Designs ページ（Projects）でそのエントリを選択し、 メニューまたは上部の メニューから Delete オプションを選択します。この操作は実質的に「ソフト削除」であり、プロジェクトリポジトリは Workspace の Trash area に移動されます。プロジェクトは Altium Designer でも、Explorer panel の メニューにある Delete オプションを使用して削除できます。

そのビュー内（メインメニューから Trash を選択）では、プロジェクトのエントリを完全に削除（Permanently Delete）することも、操作を取り消す（Restore）こともできます。なお、 ボタンは、Workspace のゴミ箱に保存されているすべてのエントリ（可能な場合）を削除します。