기본적인 사용법을 익히는 차원에서 Guide의 내용은 모두 따라하기 해 보시길 권장합니다.
|
|---|
Prerequisites
MIDAS API 실행의 기본사항은 아래 링크 참조
...
기본사항
API 모드 실행은 실행파일 MidasGen.exe 에 /API 실행 파라미터를 넘기면 됩니다. command 라인에서 실행 하거나 바로가기를 수정해 만들 수 있습니다.
Command 라인에서 실행
바로가기 만들기
바로가기 생성 (우클릭 후 바로가기 만들기)
바로가기 대상에 /API 추가
API 모드로 실행되면 Civil 실행시 다음과 같은 대화상자가 함께 실행 되고 Connected to client … 메세지가 나타나면 정상적으로 실행 된 것입니다.
...
Gen의 API 모드 동작 구조
/API 를 주어 실행한 결과에서 함께 실행된 창은 API 서버의 로그 창입니다. API를 사용하기 전에 간단히 연결 방식을 이해하면 도움이 될 것 같습니다.
...
이와 같이 API서버에 미리 정의된 규칙에 따라서 명령어를 주고 받으며 Gen을 제어 하게 됩니다. http 메세지는 Python 을 비롯한 여러 프로그래밍 언어를 이용해 주고 받을 수도 있지만, 먼저 이해를 돕기 위해 Postman 이라는 프로그램을 활용해 간단한 연결을 해보도록 하겠습니다.
Postman 을 활용한 간단한 동작
Postman 설치 및 새 명령어 시작
Postman 은 다음 위치에서 다운로드 받아 설치 하실 수 있습니다. https://www.postman.com/downloads/
모델 파일 열기
모델 파일
| View file | ||
|---|---|---|
|
...
http 메소드 타입 선택 (POST)
api URI 입력
http://localhost:10024/doc/openContent-type 선택
content-type: application/jsonBody JSON 데이터 입력
{"Argument": "C:\\MIDAS\\API\\Model\\test.mgb"}C:\\MIDAS\\API\\Model\\test.mgb → 내 PC에 있는 모델 파일 경로 입력
경로에 \\ 사용 주의!
Send 버튼은 누르면 모델파일이 Open되고 postman 에서 응답을 확인 하실 수 있습니다.
Postman 명령을 collection 에 저장하기 및 순서대로 실행하기
우측 상단의 Save 를 누르면 현재 명령어를 collection 으로 구분하여 저장 할 수 있습니다.
...
Postman Reqeust를 collection으로 한번에 실행하기
모델 파일 데이터 가져오기
열린 모델 파일의 데이터는 http GET 메세지를 통해 더 간단하게 가져 올 수 있습니다.
...
http 메소드 타입 선택 (GET)
api URI 입력
http://localhost:10024/db/matl
모델 파일 데이터 추가하기
앞의 Get 명령어를 통해 가져온 MATL(재질) 데이터를 일부 수정해 새로운 MATL 데이터를 추가 해보도록 하겠습니다.
...
http 메소드 타입 선택 (POST)
api URI 입력
http://localhost:10024/db/matlContent-type 선택
content-type: application/jsonBody JSON 데이터 입력
앞의 모델 파일 데이터 가져오기에서 결과를 복사하고 붙여넣기
데이터 붙여 넣기 및 수정
데이터 이름 변경 : MATL → Assign
데이터 Key 변경 : “1” → “2”
데이터 이름 변경 : “SS275” → “SS275-ByAPI”
Send 결과 확인
Gen에서 결과 확인
...
모델 파일 데이터 업데이트
앞의 모델 파일 데이터 추가 와 유사한 방법으로 이번에는 MATL(재질) 데이터를 변경 하도록 하겠습니다.
http 메소드 타입이 POST → PUT 으로 바뀐 부분에 유의 하시면 됩니다.
...
http 메소드 타입 선택 (PUT)
api URI 입력
http://localhost:10024/db/matlContent-type 선택
content-type: application/jsonBody JSON 데이터 입력
앞의 입력에서 사용했던 데이터 그대로 붙여넣기
변경하고자 하는 데이터만 변경
SEND 결과 확인
Gen에서 결과 확인
필요한 데이터만 입력해 업데이트
모델 파일 업데이트 시에 중요한 데이터는 변경하고자 하는 데이터임을 고려하면, 업데이트 명령은 많이 단순 해 질 수 있습니다. 앞의 예제와 같지만 실제로 변경 하고자 하는 데이터만을 BODY 데이터에 넣어 동작 하는 방법입니다.
...
postman matl update simple result Gen
모델 다른 이름으로 저장하기
시작하면서 API로 mcb 파일을 열었던 방식과 유사하게, 모델 파일을 다른 이름으로도 저장 할 수 있습니다.
...
http 메소드 타입 선택 (POST)
api URI 입력
http://localhost:10024/doc/saveasContent-type 선택
content-type: application/jsonBody JSON 데이터 입력
{"Argument": "C:\\MIDAS\\API\\Model\\test_XXXXXXX.mgb"}C:\\MIDAS\\API\\Model\\test_XXXXXX.mgb → 내 PC에 있는 경로 입력
경로에 \\ 사용 주의!
Send 결과 확인
Gen 결과 확인
...
모델 해석 하기
이제 해석 명령어의 형태를 예상할 수 있으실 것 같습니다.
...