> For the complete documentation index, see [llms.txt](https://docs.roboflow.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roboflow.com/workflows/ko/tutorials/integrate-with-ignition/live-data/trigger-an-inspection-from-ignition.md).

# Ignition에서 검사 트리거

Ignition에서 HTTP를 통해 Roboflow 엣지 디바이스에 필요할 때 부품 검사를 요청하고, Workflow 결과를 Ignition 태그에 기록하도록 설정합니다.

Ignition이 검사 시점을 결정하는 경우(예: 부품 감지 센서 또는 HMI 버튼) 이 경로를 사용하세요. Ignition은 HTTP를 통해 장치를 호출하고, 장치는 최신 카메라 프레임에서 Workflow를 실행한 다음 결과를 담은 응답을 Ignition으로 돌려보냅니다.

{% hint style="info" %}
OPC UA Writer Sink, OPC UA Reader, OPC UA Server는 Enterprise 고객만 사용할 수 있습니다. [자세히 알아보려면 Roboflow 영업팀에](https://roboflow.com/sales) 문의하세요.
{% endhint %}

{% hint style="info" %}
이 단계와 스크린샷은 Ignition 8.1(Designer 8.1.55)을 기준으로 합니다. 8.3을 포함한 다른 버전에서는 메뉴 이름, 대화상자, 속성 이름이 다를 수 있습니다.
{% endhint %}

## 예시 태그

이 페이지에서는 패턴을 보여 주기 위해 태그 5개를 사용합니다. 설명을 위한 예시이므로 생산 라인에 맞게 이름, 폴더, 데이터 유형을 직접 정의하고 스크립트에도 동일하게 반영하세요.

<table data-search="false"><thead><tr><th>태그</th><th>데이터 유형</th><th>의미</th></tr></thead><tbody><tr><td><code>Roboflow/Inspect</code></td><td>부울</td><td>검사를 요청하려면 <code>true</code> 로 설정합니다(예: 부품 감지 센서 또는 HMI 버튼에서 요청). 결과가 도착하면 스크립트가 다시 <code>false</code> 로 설정합니다.</td></tr><tr><td><code>Roboflow/DeviceTriggerUrl</code></td><td>문자열</td><td>장치에서 스트림을 트리거하는 주소</td></tr><tr><td><code>Roboflow/LastDetections</code></td><td>정수(Int4)</td><td>마지막 검사에서 탐지한 객체 수. 검사에 실패하면 <code>-1</code> 실패 여부</td></tr><tr><td><code>Roboflow/LastResult</code></td><td>문자열</td><td>마지막 검사에서 클래스별로 집계한 개수(JSON 형식, 예: <code>{"bottle":12}</code>)</td></tr><tr><td><code>Roboflow/LastError</code></td><td>문자열</td><td>마지막 검사에 실패한 이유. 성공한 경우에는 비어 있습니다.</td></tr></tbody></table>

## 트리거된 스트림 추가

Deployment Manager에서 장치를 열고 "Add Stream"을 클릭합니다. "Workflow ID"에서 Workflow를 선택하고, "Mode"를 "Triggered"로 설정한 다음, 카메라의 "RTSP URL"을 입력하고 "Create Stream"을 클릭합니다. 트리거된 스트림은 카메라 연결과 모델 로드를 유지하지만, 트리거될 때만 Workflow를 실행합니다. Workflow가 내보내는 결과를 Ignition이 그대로 가져오므로 어떤 Workflow든 사용할 수 있습니다. 따라서 OPC UA Writer Sink는 제외하세요.

<figure><img src="https://3843302164-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoO0Ceoy9R0lHDZATcPyh%2Fuploads%2Fgit-blob-c659a1d5fbbdc157a8c0df330b310925ac344ab3%2Fignition-dm-add-stream-triggered.png?alt=media" alt="The Deployment Manager Add New Video Stream dialog with Name line-1-camera, the Workflow selected, Mode Triggered, Stream Type RTSP Stream, and an RTSP URL" width="400"><figcaption><p>트리거된 스트림은 Ignition의 요청을 기다립니다.</p></figcaption></figure>

스트림의 트리거 주소는 `http://<device-ip>:8000/inference_pipelines/<pipeline-id>/trigger`입니다. 파이프라인 ID는 Deployment Manager의 스트림 세부정보에서 확인하세요.

## Ignition에서 태그 만들기

Designer의 Tag Browser에서 `default` 공급자를 선택합니다. 이름이 `Roboflow`인 폴더를 만든 다음, 위의 데이터 유형을 사용해 예시 태그를 메모리 태그로 추가합니다. 폴더를 마우스 오른쪽 버튼으로 클릭하고 "New Tag" > "Memory Tag"를 선택한 다음, Tag Editor에서 "Name"과 "Data Type"을 설정합니다. 값을 `DeviceTriggerUrl` 에 스트림의 트리거 주소로 설정합니다.

<figure><img src="https://3843302164-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoO0Ceoy9R0lHDZATcPyh%2Fuploads%2Fgit-blob-2dd6de0e5a8eedacbea39630449ba110c2074c15%2Fignition-designer-inspect-tags.png?alt=media" alt="The Ignition Designer Tag Browser with the Roboflow folder expanded, showing DeviceTriggerUrl set to the device trigger address, Inspect false, LastDetections 12, an empty LastError, and LastResult {&#x22;bottle&#x22;:12}"><figcaption><p>검사 후의 예시 태그입니다. 이 폴더에는 다른 태그도 포함되어 있습니다.</p></figcaption></figure>

## 검사 스크립트 추가

두 번 클릭하여 `Inspect` Tag Editor를 엽니다. "Scripting" > "Value Changed"로 이동한 다음, 스크립트 본문에 다음 코드를 붙여 넣습니다. Workflow에 `predictions`:

```python
라는 객체 탐지 출력이 있다고 가정합니다.
if initialChange or not currentValue.value:
    return
import java.lang
def run():
    log = system.util.getLogger("Roboflow")
    base = "[default]Roboflow/"
    try:
        url = system.tag.readBlocking([base + "DeviceTriggerUrl"])[0].value
        # HTTP/1.1: the device rejects the HTTP/2 upgrade Ignition sends by default.
        resp = system.net.httpClient(timeout=300000, version="HTTP_1_1").post(url, data="{}", headers={"Content-Type": "application/json"})
        body = resp.json if resp.good else None
        if not body or not body.get("success"):
            raise ValueError("HTTP %s: %s" % (resp.statusCode, resp.text[:300]))
        preds = body["data"]["workflow_output"][0]["predictions"]["predictions"]
        counts = {}
        for p in preds:
            counts[p["class"]] = counts.get(p["class"], 0) + 1
        system.tag.writeBlocking([base + "LastDetections", base + "LastResult", base + "LastError"], [len(preds), system.util.jsonEncode(counts), ""])
    except (Exception, java.lang.Exception) as e:
        system.tag.writeBlocking([base + "LastDetections", base + "LastResult", base + "LastError"], [-1, "", str(e)[:500]])
        log.warn("Roboflow inspect failed: %s" % e)
    finally:
        system.tag.writeBlocking([base + "Inspect"], [False])
# The HTTP call blocks until the Workflow finishes, so run it off the tag event thread.
system.util.invokeAsynchronous(run)
```

<figure><img src="https://3843302164-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoO0Ceoy9R0lHDZATcPyh%2Fuploads%2Fgit-blob-7cf6d0e9f1d15a439f53f4f81440406cbacef11a%2Fignition-designer-inspect-script.png?alt=media" alt="The Ignition Tag Editor for the Inspect tag, on Scripting > Value Changed, with the script that posts to the device trigger URL and writes LastDetections, LastResult, and LastError"><figcaption><p>의 값 변경 스크립트는 <code>Inspect</code>.</p></figcaption></figure>

설정 `Inspect` 을 `true` 로 설정합니다. HMI 버튼, PLC 태그 변경 스크립트 또는 OPC UA 클라이언트에서 설정할 수 있습니다. 값이 다시 `false`가 되면 결과 태그를 확인합니다(예: `LastDetections` 는 `12` 이고 `LastResult` 는 `{"bottle":12}` 로, 병 12개를 나타냅니다). 실행별 입력값(예: 제품 코드)을 전달하려면 요청 본문에 다음과 같이 포함합니다: `{"workflows_parameters": {...}}`. 자세히 알아보기: [에지 트리거](https://docs.roboflow.com/deployment/self-hosted/enterprise/deployment-manager/making-changes/trigger-a-stream#edge-trigger).

## 실행 중인 워크플로에 값 전달

이미 실행 중인 워크플로에 Ignition의 값을 전달하려면 대신 OPC UA Reader 블록을 사용합니다. 이 블록을 사용하려면 장치의 추론 이미지에 `roboflow-workflows` 0.2.13 이상이 필요합니다. 블록이 없으면 장치를 업데이트하세요. 이 블록은 하나의 태그를 구독하고 실행할 때마다 최신 `value` 와 `is_new` 를 반환합니다. `error_status`입니다. 플래그가 꺼져 있을 때 추론을 건너뛰려면 Continue If 블록과 함께 사용하세요(예:  `LineRunning`  태그). 해당 서버의 Writer Sink와 동일하게 "Url", "Namespace", "Object Name", "Variable Name", "Node Lookup Mode"를 설정하세요. Ignition 태그에는 "direct"를, Roboflow OPC UA Server의 태그에는 "hierarchical"을 사용합니다.

## 문제 해결

<table data-search="false"><thead><tr><th>증상</th><th>원인</th><th>해결 방법</th></tr></thead><tbody><tr><td><code>LastError</code> 에 다음이 표시됨 <code>HTTP 400: Invalid HTTP request received.</code></td><td>Ignition의 HTTP 클라이언트가 HTTP/2를 사용하고 있음</td><td>스크립트에서 <code>version="HTTP_1_1"</code> 을 유지하세요</td></tr><tr><td>Deployment Manager에서 첫 번째 트리거가 시간 초과됨</td><td>모델을 처음 실행하면 TensorRT 엔진을 빌드하며, 이 작업에는 몇 분이 걸릴 수 있음</td><td>기다리세요. 실행은 계속 진행되어 완료되며, 엔진은 이후 실행을 위해 캐시됩니다.</td></tr></tbody></table>

## 보안

포트 8000의 장치 트리거 엔드포인트에는 인증이 없으므로, 여기에 접근할 수 있는 사람은 누구나 스트림을 트리거할 수 있습니다. 또한 요청 본문은 해당 실행에 사용할 스트림의 Workflow 입력을 대체합니다. 포트 8000에 접근할 수 있는 대상을 제한하세요.
