▤ Drawing Vault for AutoCAD – BC Connector
ヘルプ / ドキュメントHelp / Documentation


ヘルプHelp

概要Overview

本コネクタは、当社図面管理システム「Drawing Vault」で管理する設計図面のメタデータ（版・状態・設変(ECN)・検図状況）を Dynamics 365 Business Central の品目(Item)へ一方向連携します。品目カードの FactBox に最新状態が表示され、「図面を開く／検図する」から認証付き deep-link で閉域ビューアへ遷移します。図面ファイル本体は閉域から出ません（メタデータのみ）。

This connector performs a one-way push of drawing metadata (version, status, ECN, review) from our Drawing Vault system onto items in Dynamics 365 Business Central. The Item Card FactBox shows the latest state, and "Open Drawing / Review Drawing" deep-link to the closed-network viewer. Drawing files never leave your closed network (metadata only).

前提条件Prerequisites

  • Dynamics 365 Business Central（Online・Essentials または Premium）。
  • 当社「図面管理システム（Drawing Vault）」の有効なバックエンド契約（CSP 直販または Microsoft Marketplace）。本コネクタ単体は入口＋状態表示のみです。
  • BC 管理者権限、および Microsoft Entra のアプリ登録権限（サービス間連携の設定用）。
  • Dynamics 365 Business Central (Online, Essentials or Premium).
  • An active backend contract for our Drawing Vault system (CSP direct or Microsoft Marketplace). The connector alone provides entry point and status display only.
  • BC administrator rights and Microsoft Entra app-registration rights (to configure service-to-service integration).

セットアップSetup

  1. AppSource から本拡張をインストール（または管理者が .app をアップロード）。
  2. 連携用アプリの登録：BC の「Microsoft Entra アプリケーション」でコネクタのクライアント ID を追加し、状態＝有効、権限セット D365 BASIC ＋ FMDV Drawing Vault を付与、同意を付与（Grant Consent）。
  3. Entra 側：アプリにアプリケーション権限 API.ReadWrite.All（Dynamics 365 Business Central）を付与し管理者の同意。リダイレクト URI に https://businesscentral.dynamics.com/OAuthLanding.htm を登録。
  4. 当社が図番⇔品目の対応を設定し、メタデータの push を有効化します（下記「図番⇔品目の対応」）。
  5. 対応済みの品目カードを開くと FactBox「Drawings (Drawing Vault)」に図面が表示されます。
  1. Install the extension from AppSource (or an admin uploads the .app).
  2. Register the connector app: in BC "Microsoft Entra Applications" add the connector's client ID, set State = Enabled, grant permission sets D365 BASIC + FMDV Drawing Vault, and Grant Consent.
  3. In Entra: grant the app the application permission API.ReadWrite.All (Dynamics 365 Business Central) with admin consent. Add redirect URI https://businesscentral.dynamics.com/OAuthLanding.htm.
  4. We configure the drawing↔item mapping and enable metadata push (see below).
  5. Open a mapped Item Card — the "Drawings (Drawing Vault)" FactBox lists its drawings.
ヒント：委任権限（Automation.ReadWrite.All 等）だけでは業務/カスタム API に不足します。必ずアプリケーション種別の API.ReadWrite.All と管理者同意を設定してください。
Tip: Delegated permissions (e.g. Automation.ReadWrite.All) are not enough for business/custom APIs. Use the application permission API.ReadWrite.All with admin consent.

図番⇔品目の対応Drawing ↔ Item mapping

方式Source 内容Description
A 図枠属性から自動対応（例：表題欄の品目番号）。Automatic from a title-block attribute (e.g. item no. in the title block).
B 図番規約から自動対応（図番＝品目番号）。Automatic from a drawing-number rule (drawing no. = item no.).
C 手動 / CSV 一括登録。A/B より優先（人手の指定を尊重）。Manual / CSV bulk import. Overrides A/B (manual intent wins).

CSV 取込は、図番（またはDocGroupId）・品目番号・メモの列を割り当てて一括登録します。取込結果は ok / 未検出 / 曖昧 / エラーで表示され、部分成功を許容します。

CSV import maps the columns for drawing no. (or DocGroupId), item no. and note, then bulk-creates links. Results are shown as ok / not found / ambiguous / error (partial success is allowed).

品目カードでの利用Using the FactBox

  • 品目カードの FactBox「Drawings (Drawing Vault)」に、最新版・状態・設変(ECN)・検図状況（検図者/承認者/期限）が表示されます。
  • 「図面を開く」：認証付き deep-link で閉域ビューアを開きます（図面本体は閉域のまま）。
  • 「検図する」：閉域の検図画面へ遷移します。赤入れ・承認は Drawing Vault 側で役割強制のもと行います（BC 内では赤入れしません）。
  • FactBox は閲覧専用です（BC から図面リンクを書き戻しません＝一方向連携）。
  • The "Drawings (Drawing Vault)" FactBox shows the latest version, status, ECN and review state (checker / approver / due).
  • Open Drawing: opens the closed-network viewer via an authenticated deep-link (files stay in the closed network).
  • Review Drawing: opens the closed-network review screen. Redlining and approval are performed on the Drawing Vault side with role enforcement (no redlining inside BC).
  • The FactBox is read-only (BC never writes drawing links back — one-way integration).

セキュリティ・データSecurity & data

  • 図面データ・業務データはお客様専用・閉域のバックエンド（お客様の Azure テナント内）に保管され、マーケットプレイスや外部 SaaS へ送信されません。
  • BC へ渡るのはメタデータのみ。サインインとサービス間認証は Microsoft Entra ID を使用します。
  • プレビューは AutoCAD クライアント生成（サーバ側 CAD レンダラ非搭載）。任意機能（AI 検索・OCR）もテナント内処理です。
  • Drawing and business data is stored in a dedicated, closed-network backend within your own Azure tenant and is never sent to the marketplace or any external SaaS.
  • Only metadata is pushed to BC. Sign-in and service-to-service access use Microsoft Entra ID.
  • Previews are generated on the AutoCAD client (no server-side CAD renderer). Optional features (AI search, OCR) are processed in-tenant.

トラブルシューティングTroubleshooting

症状Symptom 対処Resolution
FactBox に何も出ないFactBox is empty その品目が未対応。図番⇔品目の対応（A/B/C）と品目番号の一致を確認。The item is not mapped. Check the drawing↔item mapping (A/B/C) and that the item no. matches.
API が 403 / 「AAD scope must be changed」API returns 403 / "AAD scope must be changed" S2S アプリに権限セット（D365 BASIC＋FMDV Drawing Vault）が未付与、または Entra の API.ReadWrite.All（アプリケーション）＋管理者同意が未設定。委任権限では不可。The S2S app is missing the permission sets (D365 BASIC + FMDV Drawing Vault), or the Entra API.ReadWrite.All (application) + admin consent is not set. Delegated permissions do not work.
同意時に AADSTS500113（No reply address）AADSTS500113 (No reply address) on consent Entra アプリに Reply URL https://businesscentral.dynamics.com/OAuthLanding.htm を登録。Add the reply URL https://businesscentral.dynamics.com/OAuthLanding.htm to the Entra app.
図面が開けないDrawing won't open 閉域ビューアはバックエンド契約と認証が前提。ネットワーク許可（固定IP 等）とサインインを確認。The closed-network viewer requires a backend contract and authentication. Check network allow-listing (fixed IP, etc.) and sign-in.

サポートSupport

お問い合わせ：support@insight.ne.jp（日本語・当社営業時間）／製品情報：https://www.insight.jp/drawing_vault_bc

Contact: support@insight.ne.jp (Japanese, business hours) / Product: https://www.insight.jp/drawing_vault_bc

プライバシーポリシー：/privacy ・ 使用許諾（EULA）：/eula

Privacy: /privacy · EULA: /eula

© Insight System — Drawing Vault for AutoCAD – BC Connector