> ## 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로 한 방향으로만 흐릅니다. 연결하면 두 가지 기능을 사용할 수 있습니다. | 기능 | 동작 | 사용 위치 | | - | - | - | | 자재 명세서 가져오기 | 저장된 버전의 Onshape 조립품 BOM을 읽어 초안 제조형 제조방법에 기록합니다. | 품목의 **자재 명세서**. [자재 명세서 가져오기](#import-a-bill-of-materials)를 참조하십시오. | | 릴리즈된 자산 동기화 | 릴리즈된 Onshape 도면과 CAD 모델을 부품 번호로 일치시켜 이미 존재하는 Alforse 품목에 첨부합니다. 품목을 새로 만들지는 않습니다. | 연동 카드의 **릴리즈된 자산 동기화** 스위치. [릴리즈된 자산 동기화](#sync-released-assets)를 참조하십시오. | ### 연결 유형 선택 Onshape 연동은 두 가지가 있습니다. 동일한 동기화를 실행하며, 접근을 승인하는 OAuth 애플리케이션을 누가 소유하는지만 다릅니다. | 연동 | ID | 인증 | | - | - | - | | **Onshape** | `onshape` | Alforse OAuth 애플리케이션을 사용합니다. **연결**을 선택하고 팝업에서 접근을 승인합니다. | | **Onshape Government** | `onshape-government` | Onshape의 ITAR 및 FedRAMP 에디션을 위해 사용자의 Enterprise가 소유한 비공개 OAuth 앱을 사용합니다. [Onshape Government](#onshape-government)를 참조하십시오. | 한 회사는 한 번에 하나의 Onshape 연결만 보유할 수 있습니다. 첫 번째가 설치된 상태에서 두 번째를 설치하려고 하면 Alforse가 *Onshape is already connected*(Onshape가 이미 연결되어 있습니다) 또는 *Onshape Government is already connected*(Onshape Government가 이미 연결되어 있습니다)로 거부합니다. 현재 연결을 먼저 제거하십시오. ## Onshape 연결 두 Onshape 카드는 **설정 → 연동**의 CAD 범주에 있습니다. ### 연결 인증 **Onshape** 카드에서 **연결**을 선택합니다. Onshape 팝업이 열리면 그곳에서 접근을 승인합니다. 팝업이 저절로 닫히고 연동 페이지가 다시 로드되며 카드가 설치된 것으로 표시됩니다. ### 릴리즈된 자산 동기화 켜기(선택 사항) 카드를 열고 **릴리즈된 자산 동기화**를 켭니다. 스위치를 켜면 **릴리즈된 자산 백필**(Backfill released assets) 작업이 나타납니다. ## 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는 클라이언트 시크릿을 한 번만 표시하므로 즉시 복사하십시오. Enterprise에 Alforse 지원 담당자의 좌석을 부여하면 지원팀이 앱 생성을 도와드릴 수 있습니다. ### 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. **문서**, **버전**, **조립**을 선택합니다. 3. **가져오기**를 선택합니다. Alforse가 Onshape BOM을 읽어 **자재 명세서** 상자에 행을 나열합니다. 부품에 부품 ID가 없는 행에는 *No part ID*(부품 ID 없음) 표시가 붙습니다. 4. **저장**을 선택하여 행을 제조형 제조방법에 기록합니다. 처음 저장한 뒤에는 카드에 *마지막 동기화*가 표시됩니다. **새로고침**을 선택하면 목록을 다시 로드합니다. ### 가져오기 규칙 * **초안만 가능합니다.** 카드는 제조형 제조방법이 **초안**일 때만 작동합니다. 활성 제조방법은 이미 사용 중이므로 비활성화됩니다. * **권한.** 저장하려면 **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가 `invalid_scope`를 반환했습니다. OAuth 애플리케이션에 "Application can write to your documents" 권한이 없습니다. | OAuth 애플리케이션에 해당 권한을 부여한 다음 다시 연결하십시오. | | *Onshape denied the connection*(Onshape가 연결을 거부했습니다) | 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/ko/docs/reference/items.md) **제조방법 및 조달** 부품의 자재 명세서가 구성되는 방식입니다. [Open](https://docs.alforse.com/ko/docs/reference/methods.md) **리비전** 부품의 모든 리비전이 각각 별도의 품목 레코드인 이유입니다. [Open](https://docs.alforse.com/ko/docs/reference/items.md#revisions) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.