Api.getData()

Api.getData()는 TORUS 플랫폼으로부터 설비의 데이터를 획득하는 함수입니다. 이 문서에서는 가장 간단한 사용 방법만 소개합니다. 상세한 사용법은 TORUS 매뉴얼을 참조하시기 바랍니다. 아래는 예시 소스 코드입니다.

using IntelligentApiCS;

Guid appGuid = new Guid("68E8D436-0558-40C4-B4BA-AB0F54EFC697");
string appName = "TorusAppTest";

int initRet = Api.Initialize(appGuid, appName);
Console.WriteLine("Initialize Result: " + initRet);

int getRet = Api.getData("data://machine/channel/axis/machinePosition", "machine=1&channel=1&axis=1", out Item item);
Console.WriteLine("getData Result: " + getRet);
if (getRet == 0)
{
    Console.WriteLine(item.ToString());
    double value = item.GetValueDouble("value");
    Console.WriteLine("value: " + value);
}

Api.getData()는 Machine Data Model의 address와 filter를 매개변수로 필요로 합니다. 예시의 Machine Data Model은 Machine Position입니다. filter에 입력된 대로 Machine ID가 1인 CNC의 첫번째 Channel의 첫번째 Axis의 Machine Position 값을 가져옵니다. Machine Data Model 항목은 TORUS 매뉴얼에서 확인할 수 있습니다.

함수 실행 결과가 0이면 정상적으로 데이터를 획득한 것입니다.
0이 아닌 값은 오류코드입니다. TORUS 매뉴얼에서 오류코드 목록을 확인할 수 있습니다.

아래는 디버깅 결과입니다. item 변수가 JSON포맷인 것을 알수 있습니다.

Initialize Result: 0
getData Result: 0
{
"value": [
10
],
"status": 0,
"datatype": "double",
"time": "2024-09-16T00:27:59.649",
"address": "data://machine/channel/axis/machineposition",
"filter": "machine=1&channel=1&axis=1"
}
value: 10