> ## Documentation Index > Fetch the complete documentation index at: https://docs.alforse.com/llms.txt > Use this file to discover all available pages before exploring further. # CAD > Onshape または Onshape Government を Alforse に接続して、部品表を下書きの製造方法にインポートし、リリース済みの図面と CAD モデルを既存のアイテムに添付します。 CAD 連携は会社を Onshape に接続し、設計データを再入力せずに Alforse へ取り込みます。 エンジニアはアセンブリの部品表を製造方法に取り込むために使い、管理者はリリース済みの図面と 3D モデルを該当するアイテムに添付し続けるために使います。 ## 連携でできること データは Onshape から Alforse への一方向に流れます。接続すると、2 つの機能が使えます。 | 機能 | 内容 | 使う場所 | | - | - | - | | 部品表のインポート | 保存済みバージョンの Onshape アセンブリの BOM を読み取り、下書きの製造方法に書き込みます。 | アイテムの**部品表**。[部品表をインポートする](#import-a-bill-of-materials)を参照。 | | リリース済みアセットの同期 | リリース済みの Onshape の図面と CAD モデルを、品番で照合して既存の Alforse アイテムに添付します。アイテムを新規作成することはありません。 | 連携カードの**リリース済みアセットを同期**スイッチ。[リリース済みアセットを同期する](#sync-released-assets)を参照。 | ### 接続タイプを選ぶ Onshape の連携は 2 種類あります。同期の動作は同じで、アクセスを承認する OAuth アプリケーションの所有者だけが異なります。 | 連携 | ID | 認可 | | - | - | - | | **Onshape** | `onshape` | Alforse の OAuth アプリケーションを使用します。**接続**を選択し、ポップアップでアクセスを承認します。 | | **Onshape Government** | `onshape-government` | Onshape の ITAR・FedRAMP 版向けに、自社の Enterprise が所有するプライベート OAuth アプリを使用します。[Onshape Government](#onshape-government)を参照。 | 1 つの会社が同時に持てる Onshape 接続は 1 つだけです。1 つ目がインストールされている状態で 2 つ目をインストールしようとすると、Alforse は *Onshape is already connected*（または *Onshape Government is already connected*）という理由で拒否します（Onshape がすでに接続されています）。先に現在の接続をアンインストールしてください。 ## Onshape を接続する 2 つの Onshape カードは、**設定 → 連携**の CAD カテゴリにあります。 ### 接続を認可する **Onshape** カードで**接続**を選択します。Onshape のポップアップが開くので、そこでアクセスを承認します。ポップアップは自動的に閉じ、連携ページが再読み込みされて、カードがインストール済みとして表示されます。 ### リリース済みアセットの同期をオンにする（任意） カードを開いて**リリース済みアセットを同期**をオンにします。スイッチをオンにすると、**リリース済みアセットをバックフィル**アクションが表示されます。 ## Onshape Government **Onshape Government** は Onshape の ITAR・FedRAMP 版です。公開の App Store がないため、Enterprise で Alforse 用の**プライベート OAuth アプリ**を作成し、その認証情報を Alforse に入力します。接続後は、**Onshape** と同様に、ドキュメントの参照、部品表のインポート、リリース済みアセットの同期をサポートします。 ### Onshape でプライベートアプリを作成する Enterprise の管理者が **Enterprise settings → Developer → OAuth applications** を開き、新しい OAuth アプリケーションを作成します。 * **Name:** Alforse。一意のプライマリ形式を指定し、タイプを **Connected Cloud App** に設定します。 * **Redirect URL:** `https://app.alforse.com/api/integrations/onshape-government/oauth`。Alforse の Onshape Government ドロワーに、貼り付ける正確なリダイレクト URL と OAuth URL が表示されます。 * **Permissions:** **Application can read your profile information**、**Application can read your documents**、**Application can write to your documents** を許可します。 Onshape はクライアントシークレットを一度しか表示しないため、すぐにコピーしてください。Alforse サポートに Enterprise の席を付与すれば、サポートがアプリの作成を支援できます。 ### Alforse にアプリの詳細を入力する **設定 → 連携**で **Onshape Government** を開きます。Onshape の URL（`https://` のアドレスが必要）、続いてアプリのクライアント ID とクライアントシークレットを入力します。 ### 接続を承認する 設定を保存します。Alforse が Onshape にリダイレクトしてアクセスの承認を求めるので、承認後に Alforse に戻ります。 ### Onshape Government の設定 | 設定 | 効果 | | - | - | | Onshape URL | チームが Onshape Government にサインインするアドレス。Enterprise ごとに固有です。 | | クライアント ID / クライアントシークレット | Enterprise のプライベート OAuth アプリの認証情報。シークレットは暗号化して保存されます。保存済みのシークレットを保持するにはフィールドを空のままにし、再接続するには再入力します。 | | リリース済みアセットを同期 | **Onshape** とまったく同じ動作です。リリース済みの図面とモデルが該当するアイテムに取り込まれます。 | HEADS UP プライベートアプリ経由の呼び出しは、Enterprise の **Onshape API の年間上限**に計上されます。ドキュメントの参照と部品表のインポートは、それぞれ数回の呼び出しで済みますが、リリース済みアセットの同期はリリースされたリビジョンごとに数回の呼び出しが必要です。上限に余裕がない場合は、同期をオフのままにしてください。 ## 部品表をインポートする Onshape 接続をインストールすると、アイテムの**部品表**に Onshape カードが表示されます。BOM は常にドキュメントの保存済みバージョンから取得され、作業中のワークスペースからは取得されません。 1. 矢印で Onshape カードを展開します。 2. **Document**、**Version**、**Assembly** を選択します。 3. **取得**を選択します。Alforse が Onshape の BOM を読み取り、**部品表**ボックスに行を一覧表示します。部品に部品 ID がない行には *No part ID* の印が付きます。 4. **保存**を選択して、行を製造方法に書き込みます。 最初に保存すると、カードに *Last synced*（最終同期）が表示されます。**更新**を選択すると一覧を再読み込みします。 ### インポートのルール * **下書きのみ。** カードが機能するのは、製造方法が**下書き**の間だけです。有効な方法では、すでに使用中であるため無効になります。 * **権限。** 保存には **parts: update** が必要です。 * **完全な置き換え。** 保存すると、サブアセンブリを含め、方法の明細が Onshape の BOM と完全に一致します。 * **リリース済みのサブアセンブリ。** サブアセンブリのリリース済みの方法が Onshape と異なる場合、保存は拒否されます。そのサブアセンブリの新しいバージョン（下書き）を作成して、もう一度保存してください。 ## リリース済みアセットを同期する **リリース済みアセットを同期**は既定でオフです。オンにすると、Onshape がリリースのたびに Alforse に通知し、Alforse は既存のアイテムにリリース済みファイルを添付します。 | Onshape のリリース | アイテムへの添付形式 | | - | - | | リリース済みの部品またはアセンブリの CAD モデル | アイテムの 3D モデル | | リリース済みの図面 | 品番とリビジョンを名前にした PDF | ### アイテムの照合方法 * 品番とリビジョンをアイテム ID と照合します。 * 番号が `DRW-` の図面は、`PRT-` または `ASM-` に添付されます。 * 一致するアイテムがない場合、または複数ある場合は、何も添付されません。同期はファイルを紐づけるだけで、アイテムを作成することはありません。 * 同じリリースを繰り返しても、同じファイルが二重に添付されることはありません。 ### 既存のリリースをバックフィルする 新しいリリースは発生時に同期されます。同期をオンにする前にリリースされたアセットを取り込むには、カードの**リリース済みアセットをバックフィル**を選択します（同期がオンの間だけ表示されます）。すると Alforse は、一致するすべてのアイテムのリリース済みアセットを一括で取得します。バックフィルには **settings: update** 権限が必要です。 アセットの同期には、OAuth アプリケーションの書き込み権限が必要です。この権限がない場合、カードは再接続して書き込みアクセスを許可するよう求めます。 ## トラブルシューティング 接続の試行が失敗すると、Alforse は連携ページにメッセージを表示します。 | メッセージまたは症状 | 原因 | 対処 | | - | - | - | | *Onshape denied the connection*（書き込み権限）（Onshape が接続を拒否しました） | Onshape が `invalid_scope` を返しました。OAuth アプリケーションに "Application can write to your documents" がありません。 | OAuth アプリケーションでその権限を許可してから、もう一度接続します。 | | *Onshape denied the connection* | Onshape で認可が拒否されました。 | もう一度接続します。 | | *The Onshape connection expired*（Onshape の接続の有効期限が切れました） | 承認する前にサインイン状態がタイムアウトしました。 | 連携に戻り、もう一度接続します。 | | *Onshape rejected the authorization*（Onshape が認可を拒否しました） | 認可コードをトークンに交換できませんでした。 | もう一度接続します。Government の場合は、Onshape URL とクライアントシークレットを確認します。 | | *Couldn't save the Onshape connection*（Onshape の接続を保存できませんでした） | Onshape はアクセスを認可しましたが、接続の保存に失敗しました。 | 再試行します。 | | *Onshape is already connected* / *Onshape Government is already connected* | 会社がすでに、もう一方の Onshape 接続を持っています。 | それをアンインストールしてから接続します。 | | **接続**を選択しても何も起きない | ブラウザーがポップアップをブロックしたため、Alforse はページ全体を Onshape に移動させます。 | Alforse のポップアップを許可して再試行します。 | ## 関連 **アイテム** CAD ファイルが添付される部品レコードです。 [Open](https://docs.alforse.com/ja/docs/reference/items.md) **方法と調達** 部品の部品表の構築方法です。 [Open](https://docs.alforse.com/ja/docs/reference/methods.md) **リビジョン** 部品のリビジョンごとに独立したアイテムレコードになる理由です。 [Open](https://docs.alforse.com/ja/docs/reference/items.md#revisions) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.