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

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

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

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

Workspace プロジェクトは、いくつかの方法で作成できます。

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

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

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

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

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

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

   プロジェクト名は 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 ページで指定します。

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

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

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

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

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

Workspace プロジェクトの参照

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

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

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

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

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

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

各プロジェクトについて、ビュー上部のボタン（および後続のリンク先セクションで詳述）から、次の操作も利用できます。

• Share – プロジェクトのアクセス権限を設定するためのアクセス制御。
• Functions – プロジェクト機能にアクセスするためのメニュー。プレビューモード時は、選択したプロジェクトのボタンからも利用できます。
  • Open – プロジェクトをCAD中心の詳細ビューで開きます。プロジェクト名のエントリを（プレビューモードでは）クリック、（リストモードでは）ダブルクリックするのと同等です。
  • 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ウィンドウで、新しいフォルダ名、親フォルダ、任意の説明を指定します。新しいフォルダは常に現在選択中のフォルダ配下に作成され、そのフォルダが親フォルダになります。

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

メニューオプションを使用して、フォルダの詳細を変更（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アクセスのみです。
• Workspaceの全メンバーに対して、Shared With領域のWorkspace Membersエントリのドロップダウンメニューを使用し、読み取り専用（Can View）または読み取り／書き込み（Can Edit）でプロジェクトを共有できます。
• 既存のユーザー／ロールの共有アクセスを削除するには、関連するドロップダウンメニューのRemove オプションをクリックします。

注意点：

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

Workspace プロジェクトアクティビティ

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

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

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

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

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

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

Workspace プロジェクト機能

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

プロジェクトを開く

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

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

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

プロジェクトを編集する

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

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

プロジェクトをクローンする

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

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

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

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

プロジェクトをウォッチする

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

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

Workspace プロジェクトを削除する

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

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