コンテンツ構造とアクセスの管理

Workspace のコンテンツ構造とアクセス管理は、Admin – Explorer page（管理者が使用）またはメインの Projects page（十分な権限を持つ Workspace メンバーが使用）のいずれからでも実行できます。これらのページのコマンドと機能により、次のことが可能です。

• Workspace 内のフォルダーとアイテムを参照できます。フォルダーの作成、編集、削除が可能で、Workspace の構造を構築できます。削除されたフォルダーとアイテムは Trash に送られ、完全に削除することも復元することもできます。

• フォルダーレベルおよびアイテムレベルの共有を定義できます。これにより、Workspace 内のどのコンテンツを誰が閲覧できるかを制御できます。またフォルダーレベルでは、他のユーザーがフォルダーとその内容を単に表示できるだけなのか、編集もできるのか（実質的には設計データのリリース／コミット／アップロードが可能か）を制御できます。

• フォルダーまたはアイテム（プロジェクトなど）が、共有権限を親フォルダーから継承するかどうかを指定できます。これは既定の状態です。

コンテンツ構造と管理の観点では、Projects と Explorer のページインターフェースは、機能と利便性の面で異なります。

• Workspace の Projects ページは、フォルダーおよびプロジェクトアイテム管理のためのシンプルなアプローチを提供し、管理者、プロジェクト／アイテム所有者、および十分な編集権限を持つその他のユーザーが利用できます。
  注: このインターフェースでは、最上位の Projects フォルダー（既定）に対する共有権限の編集または設定はできず、別の最上位フォルダーを作成することもできません。

  Workspace の構造および権限管理タスクの大半は、Projects ページのコマンドから実行できます。

• Workspace の Explorer ページは、Altium Designer Explorer panel に似ており、管理者のみが利用可能で、プロジェクトの Release データ、コンポーネント、Managed Content などを含むすべてのフォルダーとアイテムへの管理アクセスを提供します。
  注: このインターフェースでは、設計プロジェクトの共有や、フォルダーおよびアイテムの移動はできません。

  Explorer ページでは、最上位の Projects フォルダーへのアクセスを含め、Workspace 構造と権限設定を詳細に制御できます。

フォルダーとアイテムの共有

Related page: サーバーコンテンツへのアクセス制御（Altium Designer ページ）

Altium 365 Workspace のフォルダー構造は、親オブジェクトから子オブジェクトへの共有権限の伝播に基づく高度な権限継承スキームを備えています。子オブジェクトには、フォルダーや、プロジェクト、コンポーネント、BOM ファイル、テンプレートなどの設計アイテムが含まれます。この仕組みにより、Workspace のフォルダー構造とその共有権限を、社内ユーザーやユーザーグループのアクセス要件に合わせて整理するプロセスが簡素化されます。

Workspace では、次の共有機能が提供されます。

• Folder-level Sharing – フォルダーを共有することで、Workspace 内のどのコンテンツを誰が閲覧できるかを制御する機能を提供します。これにより、他のユーザーがフォルダーとその内容を単に表示できるだけなのか、編集もできるのか（実質的には設計データのリリース／コミット／アップロードが可能か）を制御できます。1 つの Workspace は、制御されたフォルダーレベル権限により、複数の実質的なコンテンツ「ゾーン」に分割できます。これにより、必要に応じてコンテンツを選択的に表示または非表示にし、適切な人に、適切なアクセス権で、適切なデータを提供できます。

• Item-level Sharing – 共有フォルダー内のどのアイテムを誰が閲覧・アクセスできるかを制御する機能を提供します。この、より具体的なレベルの共有により、アイテムが親フォルダーから継承した権限セットを上書き（または追加）できます。ユーザーがフォルダー自体へのアクセス権を持っていれば、そのフォルダー内で自分に共有されたアイテムを、許可に応じて表示／編集できます。

上記の共有機能は、Workspace の権限継承スキームに従います。最も単純には、フォルダーに適用された権限は、親子関係を通じてフォルダー階層を下方向へ、つまりフォルダーからサブフォルダーへと連鎖的に伝播します。

この権限継承構造は、階層内のどこかで意図的に無効化しない限り、フォルダーが階層に追加されたとき、および階層内で権限が追加されたときにも維持されます。最上位フォルダーではないフォルダー、つまり階層内にあるフォルダーに追加の権限が適用された場合、その権限はこのレベルから階層の下位へ継承され、既存の権限には影響しません。

Workspace の Projects ページでは、インターフェースの Share オプションからプロジェクトフォルダーの権限にアクセスして変更できます。フォルダーエントリーを選択し、上部の ボタン、またはエントリーの メニューから Share オプションを選択すると、Share Item ウィンドウにアクセスできます。 注意:

• 既定では、Workspace が最初に有効化された時点では、最上位の Projects フォルダーには Projects ページからアクセスできませんが、他の最上位フォルダーが作成されると利用可能になります。Explorer ページインターフェースからは、常に Projects フォルダーにアクセスできます。

• このウィンドウのインターフェースと機能は、プロジェクトを共有する場合も同様に動作します。これには、アイテム（フォルダー）の所有者を変更する 機能も含まれます。

Explorer ページでは、フォルダー（またはアイテム）のナビゲーションツリーエントリーを右クリックし、コンテキストメニューから Share Folder（または Share Item）コマンドを使用することで共有コントロールにアクセスできます。Share ウィンドウが表示され、そこからフォルダー／アイテムのアクセス権限を必要に応じて変更できます。

注意事項:

• 権限の観点では、ユーザー／グループは Can Write（Edit）オプションが有効な場合に Read/Write アクセスを持ちます。このオプションが無効な場合は、Read（View）アクセスのみとなります。

  ユーザー／グループに対してフォルダー／アイテムへの Edit アクセスを有効にすることは、実質的にはその権限セット（ACL）に別の権限を追加することを意味し、そのアクセスを再び View に変更することは、実質的にはそのセットから権限を削除することを意味します。

• ユーザー インターフェースの共有権限の選択について:

  • Can WriteページでExplorerオプション（読み取り/書き込み）がチェックされている場合、それはProjectsページでCan Editが選択されていることと同等です。 

  • ExplorerページでCan Writeオプション（読み取り専用）がオフになっている場合、それはProjectsページでCan Viewが選択されていることと同等です。

• 既存のユーザー/グループのフォルダー/アイテムへの共有アクセスを削除するには:

  • Projectsページで、Share Itemウィンドウ内のユーザー/グループ タイルのRemoveオプションを選択します。

  • Explorerページで、Shareウィンドウ内のユーザー/グループ エントリに関連付けられたRemove コントロール（）をクリックします。

• デフォルトでは、フォルダー/アイテムはその所有者（最初は作成者）と、Administratorsグループのすべてのメンバーのみが利用できます。これらの権限は既定で備わっており、明示的に追加する必要はありません。OwnersおよびAdministratorsには、読み取り/書き込み（表示/編集）権限があります。

• Workspace のすべてのユーザーがフォルダー/アイテムを参照できるようにするには:

  • ProjectsページのShare Itemウィンドウで、Workspace Membersタイルのアクセス オプションをCan Viewに設定します。完全な書き込みアクセスを許可する場合はCan Editに設定します。

  • ExplorerページのShareウィンドウで、Add Workspace Members コントロールを選択し、そのCan Writeオプションのチェックを外します。完全な書き込みアクセスを許可する場合は、チェックを入れたままにします。

    上記を実行すると、Workspace のすべてのメンバーに読み取り/書き込みアクセスが付与される可能性がある点に注意してください。アクセスを特定のユーザーやグループのみに制限したい場合は、No accessに対してWorkspace Membersを設定する（Projectsページ）、またはWorkspace Members entry を削除する（Explorerページ）必要があります。

• 他のアイテムとは異なり、設計プロジェクト アイテムの共有権限はExplorerページでは管理できません。代わりに、ProjectsページからアクセスするShare Itemウィンドウで指定します。詳細はWorkspace Projects pageを参照してください。

継承によって制御される共有制限

フォルダーのShare ItemウィンドウにあるCan ViewやNo accessなど、一部のユーザー アクセス レベルは、その親フォルダーから継承された権限セットと矛盾する（権限を下げる）ため、選択できない場合があります。デフォルトでは、フォルダーの共有権限はすべてのユーザーに対する完全な書き込みアクセスです。これはShare ItemウィンドウではWorkspace Members Can Edit、またはExplorerページのShareウィンドウではWorkspace Members can Writeとして表示されます。

たとえばこのデフォルトのケースでは、フォルダーが継承している権限を（Workspace Members EditからWorkspace Members ViewまたはNo Accessへ）下げるオプションは、権限階層構造が意図せず切り離されるのを防ぐため無効になっています。なお、共有アクセス レベルを上げることは常に可能です。これは、親フォルダーから継承した既存の権限セットに単に「追加」されるためです。

このフォルダーについて、親から子への権限継承を意図的に切断し、異なる（より低い）アクセス レベルを適用できるようにするには、Share ItemウィンドウのAdvanced SettingsにあるInherit parent folder permissionsオプションのチェックを外します。フォルダーが親から権限を継承しなくなると、そのフォルダー自身のアクセス権限は制限なく変更できるようになります。詳細は以下のセクションを参照してください。

同様に、Workspace のExplorer pageでフォルダー共有権限を変更する際も、親フォルダーから継承した権限を下げることはできません。親フォルダー（この場合はProjects）からの権限継承を意図的に切断するには、ShareウィンドウのInherit permissions from parentオプションのチェックを外します。

権限継承の強制

Workspace のProjectsページおよびAdmin – ExplorerページにあるAdvanced Sharingオプションには、追加のEnforce inheritance for all child itemsコマンドが用意されており、現在選択されている（親）フォルダー内のすべてのサブフォルダーおよび Items に対してInherit parent folder permissionsを有効にします。これにより、各フォルダー/Item がそれぞれの親から権限を継承するため、親フォルダーの権限セットが階層全体に伝播します。

通常は必要ありませんが、このコマンドの処理により、サブフォルダーやアイテムが継承階層から切り離されている状況を緩和できます。これは、既存の継承権限を削除（または格下げ）できるようにするために、サブフォルダーまたはアイテムのInherit parent folder permissionsオプションが無効にされていることが原因の場合があります。この状況では、最上位フォルダー レベルで権限セットを変更しても、継承が切断されているフォルダー/アイテムには階層下位へ伝播しません。

たとえば、Adminアクセス専用に設定されたバックアップ フォルダーが複数あり、それらを全体アーカイブ フォルダー内に移動する場合が考えられます。これらの各フォルダーは、アクセス権限をAdminのみに下げられるようにするため、フォルダー階層から切り離されています（Inherit parent folder permissionsオプションがオフ/無効）。これらをアーカイブ フォルダー内に移動しても（そのフォルダー自体もAdminのみに設定されている場合）、切り離された状態は維持されます。Moving Foldersを参照してください。 

ただし、アーカイブ フォルダーの階層全体で権限継承が連続していないため、最上位の権限セットを変更しても、たとえばManagersにViewアクセスを追加しても、その変更はサブフォルダーやその内容には伝播しません。この状況はEnforce inheritance for all child itemsコマンドを適用することで修正できます。これにより、すべてのサブフォルダーおよびその Items に対してInherit parent folder permissions設定が有効になり、権限継承が復元されます。その後、適用されたManagerアクセスはアーカイブ フォルダー階層全体に伝播します。

この例の手順を以下に示します。各種フォルダーには、Components や Projects などの Items が含まれる場合があります。

権限継承の連続性

上記のとおり、Workspace のフォルダー階層を通じた共有権限の継承の連続性は、ある時点でフォルダーが親フォルダーから受ける権限継承が明示的に切断（無効化）されない限り維持されます。フォルダー（または project/Item）に対する親から子への権限伝播は、Share Itemダイアログで使用できるInherit permissions from parentオプションのチェックを外すことで無効になります。そのフォルダーは以後、親に対して行われた権限変更を継承しなくなり、この時点で権限階層は事実上切断（無効化）されますが、このレベルより下では継承の連続性は維持されます。

その「切断された」フォルダーのInherit permissions from parentオプションを再び有効にすると、フォルダー権限継承の全深度が復元されます。すると、そのフォルダーは親の権限を再び継承し（まだ存在しない場合）、親子間の権限整合性が回復されます。

有効なアクセス許可継承スキームに従い、フォルダ/アイテムのアクセス許可は親のアクセス許可に対して昇格および追加（実質的には同じ動作）することはできますが、引き下げることはできません。これは、追加されるグループ/ユーザーのアクセス許可が親と子の両方のエンティティで共通になる場合にも当てはまります。

• フォルダにアクセス許可を追加すると、子フォルダ内の同じアクセス許可がより低いアクセスレベルである場合、実質的にそれを上書きします。たとえば、フォルダにLibrarians Read/Writeアクセス許可が追加され、その子フォルダに既存のLibrarians Readエントリがある場合、これはLibrarians Read/Writeエントリに昇格されます。
  要するに、親フォルダにWriteレベルのアクセスが追加され、それが子フォルダに継承されます。 アクセス許可の継承は維持されます。

• 逆に、フォルダにアクセス許可を追加しても、子フォルダ内の同じアクセス許可がより高いアクセスレベルを持っている場合は影響しません。たとえば、フォルダにLibrarians Readアクセス許可が追加され、その子フォルダに既存のLibrarians Read/Writeエントリがある場合、これはReadレベルのエントリに変更（引き下げ）されることはなく、既存のアクセス許可レベルのまま維持されます。
  要するに、親にReadレベルのアクセスが追加され、これは子フォルダにはすでに存在しています。アクセス許可の継承は維持されます。

フォルダの移動

Workspaceフォルダは、Projectsページ（Workspace Projects pageを参照）またはAltium DesignerのExplorerペイン（Organizing Your Workspaceを参照）から、フォルダ構造内の任意の別の場所へ移動できます。

移動されたフォルダの共有アクセス許可がどのように決定されるかは、既存の親フォルダとのinheritance relationshipによって異なります。

• フォルダのInherit parent folder permissionsオプションが有効な場合（既定の状態）、そのフォルダを別のフォルダ内へ移動すると、次のようになります。

  • 新しい親フォルダからアクセス許可セットを継承します（そのフォルダのOwnerを含む）。

  • 元の継承アクセス許可は失われます。

    • * フォルダ/プロジェクトの「継承された」アクセス許可とは、親から取り込まれたアクセス許可のことです。つまり継承されたものです。

  • 以前の拡張アクセス許可は保持されます。

    • * フォルダ/プロジェクトの「拡張された」アクセス許可とは、ユーザーアクセスを拡張するために特別に追加されたものであり、親から継承されたものではありません。

• 要するに、古い親のアクセス許可は新しい親のアクセス許可に置き換えられますが、追加されていたアクセス許可はフォルダとともに移動します。

• フォルダのInherit parent folder permissionsオプションが無効な場合（親のアクセス許可を取り込まない場合）、そのフォルダを別のフォルダ内へ移動すると、次のようになります。

  • 元のアクセス許可を保持します。

  • Inherit parent folder permissions設定の無効状態を保持します。

• 要するに、文字どおり移動イベントであり、それ以外の変更はありません。新しい親フォルダからの継承によって予期しないアクセス許可の変更が発生する可能性を避けられるため、これはフォルダとその内容を移動する最も安全な方法と見なせます。

プロジェクト作成アクセス許可の管理

default Workspace settingsでは、Workspaceメンバーによって作成またはアップロードされたプロジェクトはProjectsフォルダに保存され、親のProjectsフォルダから継承された全ユーザーへの書き込みアクセス付きで利用可能になり、Projects pageから直接アクセスされます。 このシンプルな構成はユーザーにとって便利ですが、Workspaceの任意のメンバーがこの主要な（最上位）場所にアクセス可能なプロジェクトを作成できてしまいます。Projectsフォルダ、または追加のサブフォルダ内で、誰がプロジェクトを作成（およびアクセス）できるかをより高度に制御するには、Workspace管理者はExplorer page、またはAltium DesignerのExplorer panelで、プロジェクトフォルダの共有アクセス許可を定義できます。

前述のとおり、フォルダのアクセス許可は、WorkspaceのExplorerページで、フォルダエントリの右クリックコンテキストメニューにあるShare Folderオプションからアクセスします。たとえば、Projectsフォルダへのアクセスは、既定のアクセス許可（Workspace Members）を読み取り専用に変更する（Can Writeをオフにする）か、完全に削除したうえで、必要に応じて特定のユーザー（Add User）またはユーザーグループ（Add Role）向けのアクセス許可を追加することで変更できます。

更新された書き込みアクセス許可により、どのWorkspaceメンバーがProjectsフォルダにプロジェクトを作成（またはアップロード）できるかが決まります。上記の例では、Managersグループのメンバーのみが可能です。このアクセス許可の制約は、Altium Designerでcreating a new projectを行うユーザーにも適用されます。

structured folder hierarchyのように、アクセス許可とユーザー/グループアクセスがそれに応じて構成されている場合、たとえばフォルダツリーを下るにつれて段階的に開放されるような構成では、このアプローチにより、移動先フォルダに応じてユーザーおよびグループに適切なレベルのアクセス許可を提供できます。

既定のプロジェクト作成アクセス許可

新しく追加されたプロジェクトが親フォルダーの権限セットを継承する既定の構成に代わる方法として、Default Permissions for new projects ページの Projects view で Admin – Settings オプションを有効にすることで、すべての新規プロジェクトに対して固定の権限セットを指定できます。 この構成は、すべてのユーザープロジェクトが Projects フォルダーのような特定の場所に作成される、あまり厳密でないフォルダー権限階層に適している場合があります。

有効にすると、新しく作成されたプロジェクトは親フォルダーの権限を継承するのではなく、このオプションで指定された権限を採用します。このオプションの初期設定は Workplace の既定設定と同じで、すべてのユーザーに書き込みアクセスが許可されていますが、必要に応じて変更できます。たとえば、Engineers には Write（編集）アクセス、Librarians には View（読み取り専用）アクセスを設定できます。

Points of note:

• Administrators は常にすべてのプロジェクト（およびフォルダー）に対する書き込みアクセス権を持つため、この設定は変更できません（読み取り専用です）。

• Project Owner（プロジェクトを作成したユーザー）は、そのプロジェクトに対する完全なアクセス権を持ちます。また、新規プロジェクトを作成するにはフォルダーへの書き込み権限が必要であるため、結果としてその親フォルダーに対してもアクセス権を持つことになります。

• 固定のプロジェクト権限セット（前述のとおり）を適用する場合、親フォルダーの権限は通常含まれないため、プロジェクトの親子（フォルダー-プロジェクト）権限継承は自動的に無効になります（上記スライド #4）。 これを手動でプロジェクトに再適用すると、親フォルダーの権限セットがプロジェクトに追加されます。詳細は上記の Permission Inheritance Continuity を参照してください。

• 新規プロジェクトに対するこの権限適用動作は、cloning a project の場合にも適用されます。

フォルダー書き込みアクセスなしでのプロジェクト作成

Projects フォルダー（または default storage location として指定されている別のフォルダー）への書き込みアクセス権を持たないユーザーが、プロジェクトの Create または Upload を実行すると、システムは新規プロジェクトを保存するためのユーザー専用 Personal Folder 構造を自動的に作成します。これはメンバーのメールアドレスに基づく最上位フォルダーとして表示され、その配下にそのユーザーのプロジェクトを保存する My Projects サブフォルダーが作成されます。このフォルダー構造/階層は、そのサインイン中のユーザー本人のみ（および administrators）に所有・公開され、他のユーザーには表示されません。

Workspace administrator の視点では、メンバーの個人用フォルダーはトップレベルの Home フォルダー配下にまとめられます。これは Projects ページや Explorer ページのフォルダー階層、さらに Altium Designer の Explorer pane folder tree でも確認できます。

アイテムリビジョンのダウンロード

Workspace メンバーは、プロジェクトの Design および Releases ビューから、プロジェクト内容（ソースファイル、生成ファイル、リリース済みデータなど）をダウンロードできます。Explorer ページでは、Item Revision のエントリ右側にある Download コントロール（）をクリックすることで、インターフェースから直接データをダウンロードできます。

Workspace 構造のナビゲーション

Workspace コンテンツのプロジェクト指向ナビゲーションは、すべての Workspace メンバーが Projects および Components ページから利用できますが、Workspace administrators は以下のように Explorer ページのインターフェースを通じてすべてのコンテンツを参照およびアクセスできます。

Administrators は、次の方法で Workspace コンテンツに移動できます。

1. 内容を確認したいフォルダー名をクリックする。

2. 検索機能を使用する。Item の ID、Comment、または Description に基づくキーワードを入力し、Enter を押すか、虫眼鏡アイコン（）をクリックします。Workspace 全体がスキャンされ、一致する Items として検索結果が一覧表示されます。

   検索後、通常の Workspace コンテンツ表示に戻るには、ブラウザーインターフェースの左端にあるナビゲーションツリーで Admin – Explorer ページのエントリを再度クリックします。あるいは、検索フィールドをクリアして Enter を押します。

追加機能

Workspace のブラウザーインターフェースでコンテンツを閲覧する際には、以下の追加機能も利用できます。

• Navigate – このコマンドは Item の右クリックコンテキストメニューにあり、その Item を Altium Designer の Explorer panel ですばやく開くために使用します。これを行うには Altium Designer が起動されます（X2.exe を開くかどうかの確認が表示されます。これは Altium Designer のソース実行ファイルです）。

  Altium Designer がすでに実行中の場合は、そのインスタンスが使用されます。

• Full item info – このコマンドは Item Revision の右クリックコンテキストメニューにあり、その Revision のすべての詳細を一覧表示するビューを表示するために使用します。実質的には、その Item Revision で利用可能な各種アスペクトビューをすべて含むビューです（Summary を除く）。

  親 Item レベルでこのコマンドを使用すると、その Item の最新リビジョンの詳細が表示されます。

• Follow/UnFollow – Type が Components のフォルダーの右クリックコンテキストメニューにある Follow command を使用して、そのフォルダーをフォローします。フォロー中のフォルダー内で発生したあらゆるアクティビティ（コンポーネント作成、リリース、リビジョン状態変更、削除）は、Workspace から送信されるメール通知で通知されます（Workspace のメール通知が Administrator によって有効化されている場合）。そのフォルダー内のコンポーネントアクティビティのフォローを停止するには、UnFollow コマンドを使用します。

• Remove Folder – このコマンドはフォルダーの右クリックメニューにあり、そのフォルダーとそのすべての内容（サブフォルダーおよびその中の Items）を、Workspace の隔離された Trash 領域へ移動するために使用します。Trash 内のエンティティは、必要に応じて完全削除または復元できます。プロジェクトフォルダーを削除する場合、関連するリリースおよび製造パッケージも Trash に移動されます。

• Remove Item – このコマンドは Item の右クリックメニューにあり、その Item を Workspace の隔離された Trash 領域へ移動するために使用します。Trash 内のエンティティは、必要に応じて完全削除または復元できます。Component Item を削除する場合は、関連するモデルも同時に Trash へ移動することができます。これらは他の場所で使用されていない場合にのみ削除できる点に注意してください（1 つ以上の他のコンポーネントで使用されていないことが条件です）。