Power Automate - 사용자 지정 커넥터 만들기

Power Automate - 사용자 지정 커넥터 만들기

Power Automate(클라우드)에서 사용자가 준비한 혹은 공개된 OpenAPI를 가지고 흐름의 단계를 만들 수 있다. 여기서는 Swagger OpenApi 파일을 이용하여 사용자 지정 커넥터를 만들어 본다.

Swagger OpenApi 파일로 사용자 지정 커넥터 만들기

사용자 지정 커넥터는 OpenAPI, GitHub, Postman Collection 등을 이용하여 만들 수 있다. 여기서는 가장 편한 방법인 OpenAPI를 이용해서 만든다.

1. Swagger 페이지에서 OpenAPI JSON파일을 다운로드 한다.
   
   
   
2. Power Automate(클라우드) 페이지에서 데이터 -> 사용자 지정 커넥터 메뉴를 연다. 그후 + 새 사용자 커넥터 -> OpenAPI 파일 가져오기 클릭
   
   
   
3. '커넥터 이름'을 입력하고 가져오기를 클릭해 OpenAPI 파일을 불러온다. 그후 계속을 클릭
   
   
   
4. 사용자 지정 커넥터의 '일반정보' 페이지에서는 커넥터의 아이콘, 배경색, 주소 등을 설정 가능하다.
   
   
   
5. '보안' 페이지에서는 해당 OpenAPI에서 설정한 인증 방식이 입력되어 있을 것이다. 사용자 지정 커넥터를 사용하려면 반드시 보안 인증을 이용해야 한다.
   
   
   
6. '정의' 페이지의 '일반' 항목에서는 각 API의 설명에 대한 정보를 가져온다. 좌측 '동작'에는 각 API Request의 동작을 선택하여 동작(API Request 라면 함수)를 설정을 변경 가능하다. 만약 '표시 여부' 가 none이 되어 있다면 'Important'로 변경하자(해당 부분은 Power Automate나 Logic App에서 사용하는 화면표시에 대한 설정이다.)
   
   
   
7. '정의' 페이지의 '요청' 항목에서는 동작(API Request라면 함수)를 요청시 어떠한 동작, 경로, 파라메터 등을 설정 가능하다. 여기서는 OpenAPI파일을 직접 불러 왔으니 변경할 필요는 없을 것이다.
   
   
   
8. '응답' 항목에서는 응답값의 종류를 확인 가능하다. 모든 설정에 문제가 없다면 유효성 검사는 성공하였다 표시되었을 것이다.
   
   
   
9. '코드' 페이지에서는 해당 커스텀 커넥터의 응답에 대한 코드 수정을 C# 스크립트 형식으로 지정할 수 있다.
   
   
   
10. '테스트' 페이지로 들어갈시 '커넥터를 만들어야 합니다'라는 메시지가 보일 것이다. 우상단의 커넥터 만들기 를 클릭해 커넥터를 생성한다.
11. '테스트 작업' 항목이 처음 만들시 비어있을 것이다. 여기서 새 연결을 클릭하고 새로나온 페이지에 각 인증방식에 맞는 값을 입력한다.(Azure Functions의 경우 default key 값) 입력 후 페이지로 돌아오면 새로고침 아이콘을 클릭하여 새로운 연결이 만들어졌는지 확인하고 각 작업을 테스트해보자. 성공하면 '닫기' 클릭
    
    
    
12. 그후 새로운 사용자 지정 커넥터가 만들어진 것을 확인 가능하다.
    
    
    

흐름 안에서 새로만든 사용자 커넥터의 단계(작업) 사용

1. '흐름'의 편집 페이지로 들어간다.
2. 파일 콘텐츠를 가져오는 작업 이후의 위치에 새 단계(+ 아이콘) -> 작업 추가
   
   
3. '사용자 지정' 탭에서 새로 생성한 사용자 커넥터 선택
   
   
   
4. 그 후 자신이 사용하려는 동작을 선택하면 된다.
   
   
   
5. 이후 다른 동작(단계)와 같이 파라메터를 입력하여 사용하면 된다.