Api.updateData()

Api.updateData()는 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);

Item updateItem = Item.Parse("{\"value\":[100.1]}");
int updateRet = Api.updateData("data://machine/channel/variable/userVariable", "machine=1&channel=1&variable=100", updateItem, out Item _);
Console.WriteLine("updateData Result: " + updateRet);
if (updateRet == 0)
{
Console.WriteLine("updateData was successful");
}

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

수정 값은 예시코드에서 보는 바와 같이 JSON포맷으로 작성합니다. value 필드에 값을 입력합니다.

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

아래는 디버깅 결과입니다. 설비의 상태도 변경이 되었습니다.

Initialize Result: 0
updateData Result: 0
updateData was successful