70세 코딩

BPMN에서는 게이트웨이 없이 직접 시퀀스 플로우와 엑티비티를 연결할 수 있다.

1. 조건부 시퀀스 플로우

시퀀스 플로우 시작점에 다이아몬드 표시를 붙혀서 표기한다.
포괄적, 배타적 게이트웨이 모두 대응 가능 하다.

2. 기본 시퀀스 플로우

시퀀스 플로우 시작점에 사선을 그어서 표기한다.
다른 어떤 조건에도 해당되지 않을 때 선택 된다(else 개념).

3. 병렬 게이트 대체 플로우

조건 다이아몬드 없는 일반 시퀀스 플로우가 2개 이상인 경우 병렬 게이트웨이와 동일 하다.
즉 다음 모델링과 동일하다.

4. 배타적 시퀀스 플로우 병합

게이트웨이 거치지 않고 곧바로 시퀀스 플로우가 엑티비티에 연결(도착)되는 경우 해당 토큰은 기다림 없이
즉시 엑티비티를 실행하게 된다. 따라서 배타적 시퀀스 플로우를 병합하기에 적합 하다.
일반적으로 배타적이지 않은 경로를 게이트웨이 없이 병합하는 모델링은 오류이다.
(단 경우에 따라 실제 이렇게 되어야 하는 경우에는 가능하다)
이 경우 다음의 모델링과 동일한 표현이다.

5. 무조건 시퀀스 플로우

기본 시퀀스 플로우가 어떤 조건에도 해당되지 않을 때 선택되는 것과 달리
조건에 관계없이 무조건(항상) 처리되어야 하는 플로우인 경우에 사용 한다. 
이때 각 조건은 포괄적이든 배타적이든 관계 없다.

지난 글에 이어서 실제 C# 으로 SOAP API를 호출 해 보는 소스를 작성 해 보겠습니다.

일반적으로 웹 서비스 제공업체에서 제공해 주는 기술문서를 참고로 해서 사용되는 함수 및 자료형을 확인해야 합니다.
여기서는 용마라는 택배업체에서 제공되는 문서를 바탕으로 작성 되었습니다.

[참고] 용마 반품 연동가이드 문서 일부

또한 처리방법만을 남길 목적인 테스트용 코드 이므로, 예외 처리등은 하지 않았습니다.
실제 환경에서는 반드시 리턴값 확인 및 예외 처리를 해야 합니다.

(1) define

1. 해당하는 클래스가 정의된 Reference.cs의 namespace 및 Linq를 using에 추가 합니다.

using WindowsFormsApplication1.kr.co.yongmalogis.www;
using System.Xml.Linq;

2. 호출될 메소드를 가지고 있는 객체를 전역변수로 선언 합니다.

TestBPService testBPService;

3. 나중에 사용할 List를 전역변수로 생성 합니다.

List<Dictionary<string, string>> array = new List<Dictionary<string, string>>();

(2) 등록번호 추출

간단히 getEDINum() 메소드를 호출하면 string 으로 리턴 됩니다.

private void btngetEDINum_Click(object sender, EventArgs e)
{
    txtgetEDINum.Text = testBPService.getEDINum();
}

(3) 반품정보 등록

주어진 기술문서를 참조하여 Key, Value 쌍을 Dictonary에 추가하고, 이를 다시 List에 추가 합니다.

Dictionary<string, string> dic = new Dictionary<string, string>();

dic.Add("regno", txtgetEDINum.Text);
dic.Add("ymd", "20190624");
dic.Add("Cons", "XXXXXX");
dic.Add("Seq", "1");
dic.Add("Ordno", "");
dic.Add("Vencode", "");
dic.Add("Venname", "왕내과");
dic.Add("Zip1", "123");
dic.Add("Zip2", "45");
dic.Add("Addr1", "울릉도 동남쪽 뱃길따라 2백리");
dic.Add("Addr2", "");
dic.Add("Contact", "이사부");
dic.Add("Phone1", "011-123-4567");
dic.Add("Phone2", "");
dic.Add("Descry", "");
dic.Add("Itemcode", "");
dic.Add("Itemname", "");
dic.Add("Qty", "1");
dic.Add("Memo1", "");
dic.Add("Sname", "");
dic.Add("sphone", "");

array.Add(dic);

기술문서에 파라미터 데이터 타입이 XML 문자열로 되어 있어서, List 데이터 전체를 ediInsert() 메소드의 인자로 넘길 XML 문자열로 변환 합니다.

XElement xmlElements = new XElement("TEBLE", array.Select(i => new XElement("item",
                    i.Select(j => new XElement(j.Key, j.Value))
                    )));

실제 SOAP API를 호출 합니다. 

string result = testBPService.ediInsert(xmlElements.ToString());
MessageBox.Show(result);

나머지 반품 확정 및 삭제는 등록번호 추출과 유사한 형태라 생략 합니다.

이 글이 도움이 되셨으면 좋아요 눌러 주시거나 댓글을 남겨 주세요.

최근 사내 ERP에서 택배사로 반품정보를 SOAP API로 전송을 해야할 일이 생겨서
C#에서 웹서비스 호출처리를 했는데, 유사한 경우에 도움이 될까해서 이를 정리 합니다.

우선 Visual Studio 에서 새로운 프로젝트를 시작하고, 솔루션 탐색기에서 서비스참조 추가를 합니다.

하단의 『고급』 버튼을 눌러서 서비스 참조 설정 창이 뜨면 다시 『웹 참조 추가』 버튼을 누릅니다.

웹 참조 추가 창이 나타나면, 업체에서 (매뉴얼상에) 알려준 asmx URL을 입력하고 우측의 작은 화살표를 클릭 하면
자동으로 제공되는 메소드 목록들이 나타 납니다.
확인 후 『참조추가』 버튼을 누르면 해당 메소드를 호출 할 수 있는 프록시 클래스가 생성 됩니다.

위의 웹 참조 이름을 더블클릭 하면 개체 브라우저를 통해 제공되는 메소드와 데이터타입 등을 확인 할 수 있습니다.

실제 소스는 '웹 참조 이름'과 동일 폴더 안에 Reference.cs 라는 파일로 생성 됩니다.

다음 글에서는 실제 API 호출을 하는 소스를 c# 으로 작성 하도록 하겠습니다.