오류 코드 — Altifigence Documentation

ALcad와 Digital Design Studio가 화면에 보여 주는 공개 오류 코드를 제품별로 모았습니다.

ALcad와 Digital Design Studio는 내보내기나 요청을 거부할 때 공개 오류 코드를 보여 줍니다. 아래 절마다 한 제품의 공개 코드를 모았습니다. 원인과 조치는 그 코드가 나오는 모든 경우에 맞을 때만 적었습니다.

코드·메시지·제품·상황으로 찾으려면 오류 코드 검색을 사용하세요.

ALcad

ALcad는 내보내기를 거부하면 내보내기 거부됨에 이 코드를 보여 줍니다.

`wrong_kind`

원인: 편집이나 설계가 종류가 맞지 않는 항목을 사용합니다. 구리 레이어가 아닌 레이어의 트랙, 바꾸려는 비아·트랙·부품이 아닌 항목을 선택한 편집, 기존 심볼을 다른 부품으로 옮기게 되는 심볼 배치가 여기에 해당합니다.

조치: 내보내기에서 이 코드는 저장된 설계에 구리 레이어가 아닌 레이어의 트랙이 있다는 뜻입니다. 파일 → 작업 공간 → 프로젝트 다시 불러오기로 저장된 프로젝트를 다시 읽으세요. 다른 프로그램이나 파일 동기화가 설계 파일을 바꿨다면 ALcad가 저장한 파일로 되돌리고 다시 불러온 뒤 내보내기를 다시 시작하세요. 다시 불러오기에 실패하면 파일 → 작업 공간 → 설정된 프로젝트 열기… → 프로젝트 폴더 선택…에서 프로젝트 폴더를 다시 여세요. 다시 열 수 없거나 내보내기에 다시 실패하면 화면에 보이는 오류 코드와 메시지를 함께 지원팀에 문의하세요.

`unsupported_schema`

원인: 프로젝트 매니페스트(project.alcad.json)나 설계 파일에 적힌 형식이나 형식 버전을 이 버전의 ALcad가 읽지 않습니다.

조치: 파일 → 작업 공간 → 프로젝트 다시 불러오기로 저장된 프로젝트를 다시 읽으세요. 프로젝트 파일이 다른 버전의 ALcad나 다른 프로그램의 파일로 바뀌었다면 이 버전의 ALcad가 저장한 파일로 되돌리고 다시 불러온 뒤 내보내기를 다시 시작하세요. 다시 불러오기에 실패하면 파일 → 작업 공간 → 설정된 프로젝트 열기… → 프로젝트 폴더 선택…에서 복원한 프로젝트 폴더를 다시 여세요. 다시 열 수 없거나 내보내기에 다시 실패하면 화면에 보이는 오류 코드와 메시지를 함께 지원팀에 문의하세요.

`duplicate_id`

원인: 저장된 프로젝트나 설계가 같은 ID를 둘 이상의 개체나 파일 참조에 쓰거나, 구리 영역의 ID가 너무 길어 ALcad가 그 ID로 영역 채움의 ID를 만들 수 없습니다.

조치: 파일 → 작업 공간 → 프로젝트 다시 불러오기로 저장된 프로젝트를 다시 읽으세요. ALcad가 저장한 뒤 다른 프로그램이나 파일 동기화가 프로젝트 파일을 바꿨다면 ALcad가 저장한 파일로 되돌리고 다시 불러온 뒤 내보내기를 다시 시작하세요. 다시 불러오기에 실패하면 파일 → 작업 공간 → 설정된 프로젝트 열기… → 프로젝트 폴더 선택…에서 복원한 프로젝트 폴더를 다시 여세요. 다시 열 수 없거나 내보내기에 다시 실패하면 화면에 보이는 오류 코드와 메시지를 함께 지원팀에 문의하세요.

`parse_failed`

원인: ALcad가 프로젝트 매니페스트나 설계 파일을 프로젝트 데이터로 읽지 못했습니다. 파일이 정해진 구조의 올바른 JSON이 아니거나, ALcad가 읽는 크기보다 큽니다.

`integrity_mismatch`

원인: 저장된 설계가 그 안에 기록된 내용 지문과 더 이상 맞지 않거나, 프로젝트 매니페스트에 적힌 계약 패킷(contract packet)이 이 버전의 ALcad와 맞지 않습니다. 예를 들어 설계 파일을 ALcad 밖에서 고치면 이렇게 됩니다.

`invalid_path`

원인: 프로젝트 파일이나 폴더의 위치나 종류가 ALcad가 요구하는 것과 다릅니다. 예를 들어 프로젝트 매니페스트의 경로가 프로젝트 폴더 안의 일반 상대 경로가 아니거나 두 번 적혀 있거나, 부품의 3D 모델이 매니페스트에 없거나, 프로젝트 파일이나 폴더가 링크이거나, 소유자나 권한이 ALcad의 요구와 다릅니다.

조치: 프로젝트 파일을 프로젝트 매니페스트에 적힌 이름 그대로 프로젝트 폴더 안에 링크가 아닌 일반 파일로 두세요. Linux에서는 프로젝트 폴더를 내 사용자 계정이 소유하고 그 폴더에 읽기·쓰기·실행 권한이 있어야 하며, 다른 사용자에게 쓰기 권한이 없어야 하고, 프로젝트 매니페스트와 설계 파일의 권한은 0600이어야 합니다. 프로젝트 매니페스트에 경로가 두 번 적혀 있거나 부품의 3D 모델이 빠져 있다면 ALcad가 저장한 프로젝트 사본으로 되돌리세요. 그런 다음 파일 → 작업 공간 → 프로젝트 다시 불러오기를 선택하고 내보내기를 다시 시작하세요. 다시 불러오기에 실패하면 파일 → 작업 공간 → 설정된 프로젝트 열기… → 프로젝트 폴더 선택…에서 프로젝트 폴더를 다시 여세요. 다시 열 수 없거나 내보내기에 다시 실패하면 화면에 보이는 오류 코드와 메시지를 함께 지원팀에 문의하세요.

`invariant_violation`

원인: 저장된 설계가 모든 ALcad 설계가 지키는 규칙을 어깁니다. 예를 들어 두 부품의 참조명이 같거나, 한 부품에 번호가 같은 핀이 둘 있거나, 부품의 심볼이 정확히 하나가 아니거나 풋프린트가 둘 이상입니다.

`invalid_reference`

원인: 저장된 프로젝트나 설계에 ALcad가 받지 않는 참조·목록·텍스트 값이 있습니다. 예를 들어 트랙·비아·구리 영역이 없는 넷이나 레이어를 쓰거나, 심볼·핀·풋프린트가 없는 부품을 가리키거나, 프로젝트 매니페스트와 설계가 서로 다른 프로젝트의 것이거나, 목록이나 텍스트가 ALcad가 허용하는 길이보다 길거나, 프로젝트 이름이 비어 있습니다.

`not_found`

원인: 프로젝트에 필요한 파일이나 폴더가 없습니다. 예를 들어 ALcad가 프로젝트를 연 뒤 프로젝트 폴더나 프로젝트 매니페스트에 적힌 설계 파일이 옮겨졌거나 이름이 바뀌었거나 삭제되었습니다.

조치: 프로젝트 폴더와 파일을 ALcad가 연 위치에 프로젝트 매니페스트에 적힌 이름 그대로 되돌려 두세요. 그런 다음 파일 → 작업 공간 → 프로젝트 다시 불러오기를 선택하고 내보내기를 다시 시작하세요. 다시 불러오기에 실패하면 파일 → 작업 공간 → 설정된 프로젝트 열기… → 프로젝트 폴더 선택…에서 복원한 프로젝트 폴더를 다시 여세요. 다시 열 수 없거나 내보내기에 다시 실패하면 화면에 보이는 오류 코드와 메시지를 함께 지원팀에 문의하세요.

`io_failed`

원인: ALcad가 저장된 프로젝트 파일을 열거나 읽는 중에 운영체제가 오류를 알렸습니다. 예를 들어 파일을 읽을 수 없거나 프로젝트가 있는 저장 장치에 접근할 수 없었습니다.

조치: 프로젝트가 있는 저장 장치가 연결되어 있는지, 내 사용자 계정이 프로젝트 파일을 읽을 수 있는지 확인하세요. 그런 다음 파일 → 작업 공간 → 프로젝트 다시 불러오기를 선택하고 내보내기를 다시 시작하세요. 코드가 다시 나오면 화면에 보이는 오류 코드와 메시지를 함께 지원팀에 문의하세요.

`invalid_geometry`

원인: ALcad가 제조 파일을 준비하는 중에 형상 검사나 관련 검사에 실패했습니다. 예를 들어 보드나 구리 영역의 외곽선 점이 너무 적거나 많거나, 비아가 적층 순서대로 서로 다른 두 구리 레이어 사이를 잇지 않거나, 구리 영역 채움이 크기 한도를 넘습니다.

조치: 코드 옆에 보이는 메시지를 확인하세요. 그런 다음 파일 → 작업 공간 → 프로젝트 다시 불러오기를 선택하고 내보내기를 다시 시작하세요. 다시 불러오기에 실패하거나 코드가 다시 나오면 invalid_geometry 코드와 화면에 보이는 메시지를 함께 지원팀에 문의하세요.

services

Digital Design Studio는 Cloud 워크스페이스 요청이 거부되면 IDE에 이 코드를 오류 문구로 보여 줍니다.

`PRECONDITION_REQUIRED`

원인: 따옴표로 묶어야 하는 필수 버전 값이 없거나 올바르지 않습니다. 파일이나 워크스페이스 버전이 필요한 요청에서는 64자 소문자 16진수 값을 큰따옴표로 묶어야 합니다.

조치: 프로젝트를 다시 열고(브라우저에서는 페이지를 새로 고쳐도 됩니다) 같은 작업을 다시 하세요. 코드가 다시 나오면 화면에 보이는 오류 코드를 함께 지원팀에 문의하세요.

`INVALID_IDEMPOTENCY_KEY`

원인: 멱등성 키(idempotency key)가 없거나 필요한 형식에 맞지 않습니다. 작업(job) 제출이나 워크스페이스 시작·중지처럼 한 번만 반영되어야 하는 요청은 이 키를 담아야 합니다.

`INVALID_REQUEST`

원인: 요청 본문·항목·헤더나 그 밖의 요청 정보가 이 작업의 요구 사항에 맞지 않습니다.

조치: 이 작업에 입력한 이름·경로·옵션을 확인한 뒤 다시 하세요. 코드가 다시 나오면 프로젝트를 다시 열고(브라우저에서는 페이지를 새로 고쳐도 됩니다) 같은 작업을 다시 하세요. 그래도 나오면 화면에 보이는 오류 코드를 함께 지원팀에 문의하세요.

`UNSUPPORTED_MEDIA_TYPE`

원인: 요청의 Content-Type 헤더가 없거나 정확히 application/json이 아닙니다.

`INVALID_PATH`

원인: 요청의 파일이나 폴더 경로를 Cloud 워크스페이스에서 쓸 수 없거나, 이름 바꾸기 뒤의 경로가 원래 경로와 같습니다.

조치: 다른 이름이나 경로를 고른 뒤 다시 하세요. 경로는 /로 시작하거나 끝나면 안 되고, 256바이트·32단계 이하여야 하며, \나 제어 문자를 담으면 안 됩니다. 경로의 각 부분은 비어 있거나 .·..이면 안 되고, 점이나 공백으로 끝나면 안 되며, 첫 점 앞의 이름이 CON·NUL·COM1·LPT1 같은 예약된 장치 이름이면 안 됩니다. 첫 부분은 .git 같은 예약된 폴더면 안 됩니다. RTL 회로도의 소스 경로에는 영문자 A–Z·a–z, 숫자, /, _, ., -만 쓸 수 있습니다.

`BODY_TOO_LARGE`

원인: 요청 본문이 이 작업에 허용되는 크기를 넘거나, 선언된 본문 길이가 올바르지 않습니다.

조치: 파일을 저장하다가 이 코드가 나왔다면 파일을 여러 파일로 나누는 등으로 크기를 줄인 뒤 다시 저장하세요. 그래도 나오거나 다른 작업에서 나오면 화면에 보이는 오류 코드를 함께 지원팀에 문의하세요.

`INVALID_IDENTITY`

원인: 요청의 식별자(프로젝트·조직·사용자·작업·요청 ID 등)가 필요한 UUID 형식이 아니거나, 요청이 대상 Cloud 워크스페이스를 올바르게 밝히지 않았습니다.