문서의 선택한 두 판 사이의 차이를 보여줍니다.
양쪽 이전 판 이전 판 다음 판 | 이전 판 마지막 판 양쪽 다음 판 | ||
comfilehmi:webapi:index [2023/04/15 06:39] Comfile Technology [3) 커맨드명] |
comfilehmi:webapi:index [2023/07/26 10:15] Comfile Technology |
||
---|---|---|---|
줄 69: | 줄 69: | ||
==== 1) HMI 클라이언트에서 응답 처리하는 방법 ==== | ==== 1) HMI 클라이언트에서 응답 처리하는 방법 ==== | ||
- | HMI 클라이언트는 들어오는 JSON 응답을 자체적으로 해석할 수 있는 능력이 있으므로 별도로 JSON에 관한 처리를 안하더라도 자동으로 처리됩니다. 원격지 HMI 변수값이나 HMI 메모리값이 JSON 형식으로 수신되면 HMI 클라이언트는 그 내용을 그대로 자신에게 복사합니다.(같은 변수명, 같은 메모리 번지로) \\ | + | HMI 클라이언트는 들어오는 JSON 응답을 자체적으로 해석할 수 있는 능력이 있으므로 별도로 JSON에 관한 처리를 안하더라도 자동으로 처리됩니다. 원격지 //내부 변수//값이나 //내부 메모리//값이 JSON 형식으로 수신되면 HMI 클라이언트는 그 내용을 그대로 자신에게 복사합니다.(같은 변수명, 같은 메모리 번지로) \\ |
도착한 JSON 응답이 자동 처리된 후 실행할 사용자 액션을 지정할 수 있습니다. \\ | 도착한 JSON 응답이 자동 처리된 후 실행할 사용자 액션을 지정할 수 있습니다. \\ | ||
JSON 응답에는 변수값이나 메모리값 등의 정보 이외에도 성공했는지 여부, 에러일 경우 에러코드와 에러메시지 정보도 담길 수 있습니다. 가장 최근에 응답 온 JSON 관련해서, 성공여부는 last_json_result() 함수, 에러 코드는 last_json_error_code() 함수, 에러메시지는 last_json_error_message() 함수를 사용하여 알아낼 수 있습니다. 이 함수들에 대한 자세한 설명은 다음 링크를 참고하세요 : [[http://www.comfilewiki.co.kr/ko/doku.php?id=comfilehmi:hmieditor_function:index#web_api_%EA%B4%80%EB%A0%A8_%ED%95%A8%EC%88%98_%EA%B3%A0%EA%B8%89_%EA%B8%B0%EB%8A%A5_chc_hdm-c070rl_%EB%98%90%EB%8A%94_%EA%B7%B8_%EC%83%81%EC%9C%84_%EB%AA%A8%EB%8D%B8%EC%97%90%EC%84%9C%EB%A7%8C_%EC%A7%80%EC%9B%90|WebAPI 관련 함수]] | JSON 응답에는 변수값이나 메모리값 등의 정보 이외에도 성공했는지 여부, 에러일 경우 에러코드와 에러메시지 정보도 담길 수 있습니다. 가장 최근에 응답 온 JSON 관련해서, 성공여부는 last_json_result() 함수, 에러 코드는 last_json_error_code() 함수, 에러메시지는 last_json_error_message() 함수를 사용하여 알아낼 수 있습니다. 이 함수들에 대한 자세한 설명은 다음 링크를 참고하세요 : [[http://www.comfilewiki.co.kr/ko/doku.php?id=comfilehmi:hmieditor_function:index#web_api_%EA%B4%80%EB%A0%A8_%ED%95%A8%EC%88%98_%EA%B3%A0%EA%B8%89_%EA%B8%B0%EB%8A%A5_chc_hdm-c070rl_%EB%98%90%EB%8A%94_%EA%B7%B8_%EC%83%81%EC%9C%84_%EB%AA%A8%EB%8D%B8%EC%97%90%EC%84%9C%EB%A7%8C_%EC%A7%80%EC%9B%90|WebAPI 관련 함수]] | ||
줄 95: | 줄 95: | ||
^ 필드명 ^ 타입 | 내용 | | ^ 필드명 ^ 타입 | 내용 | | ||
| success | boolean | 성공 여부. true이면 성공. false이면 실패 | | | success | boolean | 성공 여부. true이면 성공. false이면 실패 | | ||
- | | vars.{HMI 변수명} | number | vars_to_json() 함수로 요청한 원격지 HMI 숫자 변수의 값. | | + | | vars.{내부 변수명} | number | vars_to_json() 함수로 요청한 원격지 //내부 변수//의 값. | |
- | | vars.{HMI 문자열 변수명} | string | vars_to_json() 함수로 요청한 원격지 HMI 문자열 변수의 값. \\ 문자열 변수명은 '$'로 시작함. | | + | | vars.{내부 문자열 변수명} | string | vars_to_json() 함수로 요청한 원격지 //내부 문자열 변수//의 값. \\ //내부 문자열 변수//명은 '$'로 시작함. | |
- | | mem.{HMI 메모리 시작 번지} | array | mem_to_json() 함수로 요청한 원격지 HMI 메모리의 주소 연속적인 값들 | | + | | mem.{내부 메모리 시작 번지} | array | mem_to_json() 함수로 요청한 원격지 내부 메모리의 주소 연속적인 값들 | |
| error.code | number | 오류 코드 | | | error.code | number | 오류 코드 | | ||
| error.message | string | 오류 메세지. 언어는 프로젝트 기본 언어 설정에 따라 | | | error.message | string | 오류 메세지. 언어는 프로젝트 기본 언어 설정에 따라 | |