SHACL 필수 값과 허용 값 검수, 목록에 있어도 출고검수가 빠지는 이유
SHACL에서 sh:hasValue는 지정 값의 존재를, sh:in은 각 값의 목록 포함 여부를 검사합니다. 빈 속성, 미등록 코드, 같은 이름의 다른 IRI를 가상 표본 7건으로 검수합니다.
이 글을 쓴 알파카랩스카카오·네이버·쿠팡 출신, 재하청 0%, 대기업·공공기관 등 18개사+ 레퍼런스
sh:hasValue는 지정 값이 있는지 확인하고, sh:in은 있는 값이 모두 목록에 드는지 확인합니다. 값이 비어 있으면 sh:in만으로는 누락을 잡을 수 없습니다.
2026년 11월 15일 기준입니다. 주문 데이터에 포장확인만 있고 출고검수가 빠졌다고 가정합니다. 포장확인은 허용 목록에 있으므로 목록 검사에는 통과합니다. 출고검수 값이 꼭 있어야 하는 주문이라면, 같은 속성에 그 값의 존재 조건도 넣어야 합니다.
두 검사는 같은 속성에서 무엇을 확인할까?#
SHACL의 속성 셰이프에서 sh:hasValue는 지정한 RDF 항이 값 노드에 포함됐는지 확인합니다. sh:in은 속성에 연결된 모든 값이 목록에 들어 있는지 확인합니다. 아래 가상 주문에서는 출고검수와 포장확인을 허용하고, 출고검수를 필수로 정했습니다. W3C SHACL 권고의 필수 값과 허용 목록
@prefix ex: <https://example.org/> .
@prefix sh: <http://www.w3.org/ns/shacl#> .
ex:OrderShape a sh:NodeShape ;
sh:targetNode ex:OrderA ;
sh:property [
sh:path ex:step ;
sh:hasValue ex:DispatchCheck ;
sh:in ( ex:DispatchCheck ex:PackagingCheck )
] .검수 표본은 모두 OrderA를 검사 대상으로 지정합니다. ex:step으로 연결된 값이 하나도 없으면 검사할 목록 외 값이 없으므로 sh:in은 결과를 추가하지 않습니다. 이 경우 sh:hasValue는 출고검수 값이 없다는 결과를 냅니다. 검사 대상을 놓치는 경우까지 살펴보려면 SHACL 검증 대상 누락 검수를 참고할 수 있습니다.
보고서에서 누락과 미등록을 어떻게 읽을까?#
검증 결과의 sh:sourceConstraintComponent를 확인합니다. HasValue는 지정 값이 없을 때, In은 발견한 값이 허용 목록을 벗어날 때 나옵니다. 두 조건에 모두 어긋나는 입력에는 두 성분이 나타납니다.
| 가상 입력 | 값의 구성 | 결과 성분 |
|---|---|---|
| 값 없음 | ex:step 연결 없음 | HasValue |
| 포장확인만 있음 | 허용된 선택 값만 있음 | HasValue |
| 출고검수만 있음 | 지정 값이 허용 목록에도 있음 | 적합 |
| 출고검수와 포장확인 | 지정 값과 허용된 선택 값 | 적합 |
| 출고검수와 미등록 값 | 지정 값과 목록 밖 값 | In |
| 미등록 값만 있음 | 지정 값이 빠지고 목록 밖 값만 있음 | HasValue와 In |
| 같은 이름의 다른 IRI | 출고검수와 끝 이름은 같고 주소가 다름 | HasValue와 In |
In 성분에서는 보고서의 sh:value로 어느 값이 목록을 벗어났는지 확인합니다. HasValue 성분을 처리할 때는 위반 값이 항상 제공된다고 가정하지 말고, 소스 셰이프의 필수 값 설정을 확인합니다. 운영 화면에는 누락한 값과 미등록 값을 각각 표시하면 담당자가 원천 매핑을 고치기 쉽습니다. W3C 허용 목록 제약
적합 판정 뒤에 무엇이 남을까?#
같은 이름을 표시해도 주소가 다른 IRI는 별개 RDF 항입니다. 원천별 출고검수 코드가 의미상 같다고 합의했다면, 승인한 매핑으로 같은 IRI에 연결한 뒤 다시 검수합니다. 두 그래프에서 숫자의 값과 원천 표현을 구분하는 경우는 RDF 리터럴 비교 검수에서 다룹니다.
값 종류를 확인하는 두 제약은 출고검수가 언제 기록됐는지, 사람이 실제로 검수했는지 판단하기 위한 증거를 읽지 않습니다. 작업 순서나 승인 시각이 인수 조건이면 작업 이벤트와 시각을 확인합니다. 값의 개수에도 업무 조건이 있다면 개수 조건을 따로 정의합니다. SHACL 조건부 개수 검수
출처와 적용 범위#
W3C의 2017년 7월 20일 SHACL 권고와 2026년 11월 10일 SHACL 1.2 Core 작업 초안을 2026년 11월 15일 확인했습니다. 이번 표본에는 두 문서에서 확인한 Core 제약을 사용했습니다. 사용 중인 그래프 저장소와 엔진에서도 같은 대상이 선택되고 같은 결과가 나오는지 확인합니다. SHACL 1.2 Core 작업 초안
알파카랩스는 공개 온톨로지 서비스에서 원천별 변환 규칙, 공통 식별자와 누락·충돌 표본 검수를 협의한다고 안내합니다. 표의 출고검수는 구성 예시입니다. 온톨로지 구축 서비스
자주 묻는 질문#
sh:in에 출고검수를 넣으면 필수가 되나요?
목록에 넣는 것은 해당 값을 허용한다는 뜻입니다. 출고검수 값이 반드시 있어야 하면 sh:hasValue를 함께 설정합니다.
sh:hasValue로 다른 값도 막을 수 있나요?
sh:hasValue는 지정 값의 존재만 확인합니다. 추가 값을 제한하려면 같은 경로에서 sh:in으로 허용 목록을 정의합니다.
값이 하나도 없어도 sh:in을 통과할 수 있나요?
목록을 벗어난 값이 없으므로 sh:in만으로는 위반을 보고하지 않습니다. 값이 비어 있으면 실패해야 하는 규칙을 따로 지정합니다.
두 검사에 어긋나면 무엇을 확인하나요?
보고서에서 HasValue와 In을 확인합니다. 어떤 지정 값이 빠졌는지는 소스 셰이프를 보고, 어떤 값이 허용 목록 밖인지는 In 결과의 sh:value로 확인합니다.
주소가 다르고 표시 이름이 같으면 같은 값인가요?
이 표본의 검증은 실제 RDF 항을 대조합니다. 다른 IRI를 같은 업무 코드로 쓰려면 원천 매핑 규칙에 합의한 뒤 변환 결과를 검수합니다.
필수·허용 값 검수표 준비#
비식별 원천 코드, 필수 값, 허용 목록을 준비합니다. 속성이 비어 있는 표본과 허용 값에 미등록 값이 섞인 표본을 각각 가져오십시오.
필수·허용 값의 인수 기준을 정리합니다
첫 범위 협의에서 원천 코드와 기대 결과로 제약 검수표 초안을 정리합니다. 소요 시간은 값 매핑과 대상 범위를 확인한 뒤 협의합니다.
필수·허용 값 검수표 초안 협의