For the complete documentation index, see llms.txt. This page is also available as Markdown.

Salesforce 작업 지시 블록

증거 이미지를 첨부해, 어떤 워크플로 탐지에서든 Salesforce 작업 지시를 등록하는 사용자 지정 Python 블록.

탐지는 누군가가 가서 그 문제를 고쳐야만 유용합니다. 이 예시는 완전한 사용자 지정 Python 블록 으로, 워크플로가 방금 본 것인 주석이 달린 프레임, 모델의 예측, 사이트 컨텍스트를 가져와 Files 아래에 프레임이 첨부된 Salesforce 작업 지시서로 등록합니다. 동일한 블록은 대신 Salesforce 사례를 만들 수도 있고, ServiceNow, Jira 또는 자체 미들웨어용 웹훅으로 페이로드를 POST할 수도 있습니다.

Roboflow 모델 출력이라면 무엇이든 사용할 수 있습니다: 객체 탐지, 인스턴스 세분화, 키포인트 및 분류.

구성 도구

대상, Salesforce 조직, 심각도, 사이트, 작업반, 일정, SLA 시간을 입력하세요. 이 페이지는 해당 값이 이미 들어간 블록 코드를 작성하며, 빌더의 각 블록 필드에 대한 정확한 값도 함께 넣습니다. 입력한 내용은 어떤 것도 페이지 밖으로 나가지 않으며, Salesforce 토큰은 출력에 포함되지 않습니다.

작업 지시서 블록 구성 도구

임베드가 로드되지 않으면, 구성 도구를 직접 여세요: https://roboflow.github.io/workflow-examples/.

워크플로에서의 위치

이 블록은 일반적인 탐지 워크플로의 끝에 위치하며, 앞선 블록들이 생성한 결과를 사용합니다.

탐지 모델, 바운딩 박스 및 레이블 시각화 블록, 사용자 지정 블록, Outputs 노드가 있는 워크플로 캔버스
  1. 추가 객체 탐지 모델 블록(또는 다른 모델 블록)과 시각화 항목을 추가하세요.

  2. 추가 사용자 지정 Python 블록을 선택한 다음 코드 편집을 클릭하고 구성 도구의 코드를 붙여넣으세요.

  3. 아래에서 입력과 출력을 선언하세요. 입력 이름은 run.

  4. 을(를) 연결하세요 이미지 를 시각화 출력에, 예측 을 모델에, 그리고 access_token 을(를) 이름이 salesforce_token.

인 워크플로 입력에 연결하세요. 빌더에 구성된 사용자 지정 블록: 이미지와 예측이 칩으로 연결되어 있고, 대상은 salesforce_work_order, 심각도는 Critical

입력

입력
유형
포함하는 내용

이미지

이미지

증거로 첨부할 프레임.

예측

object_detection_prediction, instance_segmentation_prediction, keypoint_detection_prediction, classification_prediction

모든 모델의 예측. 네 가지 유형을 모두 선택하세요.

대상

문자열

salesforce_work_order, salesforce_case, webhook 또는 dry_run.

destination_config

사전

비밀이 아닌 설정: instance_url, api_version, extra_fields, webhook url 및 headers.

access_token

문자열

Salesforce bearer 토큰. 정의에 저장되지 않도록 워크플로 입력에 연결하세요.

심각도

문자열

Critical, High, Medium 또는 Low. 우선순위와 SLA를 결정합니다.

alert_type

문자열

다음과 같은 짧은 기계용 레이블 equipment_fault.

설명

문자열

무엇이 관찰되었는지 설명하는 사람이 읽기 쉬운 문장.

사이트

사전

위치: 이름, 구역, asset_id, camera_id, 주소, lat, lon.

작업반

사전

대상: 기술, 인원 수, 팀.

일정

사전

시기와 내용: requested_start, due_by, duration_hours, parts, access_notes, instructions.

선언된 입력과 해당 유형을 나열한 사용자 지정 블록 편집 패널

출력

출력
유형
포함하는 내용

payload

사전

블록이 생성한 일반 작업 지시서 페이로드.

결과

사전

대상이 응답한 내용: status, record id, url, attachment_id.

error_status

불리언

무엇이든 실패하면 True입니다. 이 블록은 예외를 발생시키지 않으므로 워크플로는 계속 실행됩니다.

메시지

문자열

결과를 한 줄로 요약한 내용.

생성되는 것

작업 지시서는 alert type과 site로 구성된 Subject, severity로부터의 Priority, SLA 표에서 가져온 Start Date와 End Date, 그리고 읽기 쉬운 요약 뒤에 전체 JSON payload가 이어지는 Description으로 만들어집니다. 주석이 달린 프레임은 레코드에 연결된 ContentVersion으로 업로드되므로 Files 아래에 표시됩니다.

우선순위가 Critical이고 설명에 심각도, 관찰 시각, 위치, 탐지 결과, 요청 시작 및 마감 기한이 나열된 Salesforce 작업 지시서 레코드

인증

이 블록은 Authorization 헤더에 bearer 토큰을 보냅니다. 빠른 테스트에는 Salesforce CLI 세션의 토큰을 사용하세요. 운영 환경에서는 client credentials flow를 사용하는 Connected App과, 작업 지시서(또는 사례) 및 ContentVersion 레코드를 생성할 수 있는 실행 사용자(run-as user)를 만드세요.

토큰을 워크플로 정의 밖에 두세요. 이름이 salesforce_token인 워크플로 입력을 추가하고, 블록의 access_token 필드를 거기에 연결한 다음, 빌더의 Run 패널이나 parameters 맵에서 워크플로를 호출할 때 토큰을 전달하세요:

조정하기

팀이 보통 변경하는 모든 것은 코드 상단에 있습니다: 심각도별 SLA 시간, 기본 작업 기간, 그리고 각 레코드에 설정되는 Salesforce 필드입니다. 탐지 자체에서 오는 사용자 지정 필드는 work_order_fields 함수에 한 필드씩 넣습니다. 새 대상은 dispatch 함수에 분기 하나를 더 추가하는 것뿐이며, 비전 쪽은 아무것도 바뀌지 않습니다.

로 실행 대상 을 dry_run 먼저 설정하고 payload 출력을 검사하여 대상이 정확히 무엇을 받는지 확인하세요.

다음 단계

마지막 업데이트

도움이 되었나요?