Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Table of Contents
minLevel1
maxLevel7

Prerequisites

MIDAS API 실행의 기본사항은 아래 링크 참조

Civil/Gen의 API 모드 동작 구조

/API 를 주어 실행한 결과에서 함께 실행된 창은 API 서버의 로그 창입니다. API를 사용하기 전에 간단히 연결 방식을 이해하면 도움이 될 것 같습니다.

...

이와 같이 API서버에 미리 정의된 규칙에 따라서 명령어를 주고 받으며 Gen을 제어 하게 됩니다. http 메세지는 Python 을 비롯한 여러 프로그래밍 언어를 이용해 주고 받을 수도 있지만, 먼저 이해를 돕기 위해 Postman 이라는 프로그램을 활용해 간단한 연결을 해보도록 하겠습니다.

Postman 을 활용한 간단한 동작

Postman 설치 및 새 명령어 시작

Postman 은 다음 위치에서 다운로드 받아 설치 하실 수 있습니다. https://www.postman.com/downloads/

모델 파일 열기

모델 파일

View file
nametest.mgb

...

  1. http 메소드 타입 선택 (POST)

  2. api URI 입력 http://localhost:10024/doc/open

  3. Content-type 선택 content-type: application/json

  4. Body JSON 데이터 입력 {"Argument": "C:\\MIDAS\\API\\Model\\test.mgb"}

    1. C:\\MIDAS\\API\\Model\\test.mgb → 내 PC에 있는 모델 파일 경로 입력

    2. 경로에 \\ 사용 주의!

  5. Send 버튼은 누르면 모델파일이 Open되고 postman 에서 응답을 확인 하실 수 있습니다.

Postman 명령을 collection 에 저장하기 및 순서대로 실행하기

우측 상단의 Save 를 누르면 현재 명령어를 collection 으로 구분하여 저장 할 수 있습니다.

...

Postman Reqeust를 collection으로 한번에 실행하기

모델 파일 데이터 가져오기

열린 모델 파일의 데이터는 http GET 메세지를 통해 더 간단하게 가져 올 수 있습니다.

...

  1. http 메소드 타입 선택 (GET)

  2. api URI 입력 http://localhost:10024/db/matl

모델 파일 데이터 추가하기

앞의 Get 명령어를 통해 가져온 MATL(재질) 데이터를 일부 수정해 새로운 MATL 데이터를 추가 해보도록 하겠습니다.

...

  1. http 메소드 타입 선택 (POST)

  2. api URI 입력 http://localhost:10024/db/matl

  3. Content-type 선택 content-type: application/json

  4. Body JSON 데이터 입력

    1. 앞의 모델 파일 데이터 가져오기에서 결과를 복사하고 붙여넣기

    2. 데이터 붙여 넣기 및 수정

      1. 데이터 이름 변경 : MATL → Assign

      2. 데이터 Key 변경 : “1” → “2”

      3. 데이터 이름 변경 : “SS275” → “SS275-ByAPI”

  5. Send 결과 확인

  6. Gen에서 결과 확인

...

모델 파일 데이터 업데이트

앞의 모델 파일 데이터 추가 와 유사한 방법으로 이번에는 MATL(재질) 데이터를 변경 하도록 하겠습니다.
http 메소드 타입이 POST → PUT 으로 바뀐 부분에 유의 하시면 됩니다.

...

  1. http 메소드 타입 선택 (PUT)

  2. api URI 입력 http://localhost:10024/db/matl

  3. Content-type 선택 content-type: application/json

  4. Body JSON 데이터 입력

    1. 앞의 입력에서 사용했던 데이터 그대로 붙여넣기

    2. 변경하고자 하는 데이터만 변경

  5. SEND 결과 확인

  6. Gen에서 결과 확인

필요한 데이터만 입력해 업데이트

모델 파일 업데이트 시에 중요한 데이터는 변경하고자 하는 데이터임을 고려하면, 업데이트 명령은 많이 단순 해 질 수 있습니다. 앞의 예제와 같지만 실제로 변경 하고자 하는 데이터만을 BODY 데이터에 넣어 동작 하는 방법입니다.

...

postman matl update simple result Gen

모델 다른 이름으로 저장하기

시작하면서 API로 mcb 파일을 열었던 방식과 유사하게, 모델 파일을 다른 이름으로도 저장 할 수 있습니다.

...

  1. http 메소드 타입 선택 (POST)

  2. api URI 입력 http://localhost:10024/doc/saveas

  3. Content-type 선택 content-type: application/json

  4. Body JSON 데이터 입력 {"Argument": "C:\\MIDAS\\API\\Model\\test_XXXXXXX.mgb"}

    1. C:\\MIDAS\\API\\Model\\test_XXXXXX.mgb → 내 PC에 있는 경로 입력

    2. 경로에 \\ 사용 주의!

  5. Send 결과 확인

  6. Gen 결과 확인

...

모델 해석 하기

이제 해석 명령어의 형태를 예상할 수 있으실 것 같습니다.

...