Microsoft OneNote 와 IBM App Connect Enterprise 함께 사용하기

Microsoft OneNote 는 정보를 수집하고 노트를 자유롭게 구성하여 아이디어를 구성하고 실시간으로 사람들과 효과적으로 협업할 수 있는 유용한 도구가 되도록 설계된 디지털 노트북입니다. IBM® App Connect Enterprise Microsoft OneNote 요청 노드를 제공하며, 이를 사용하여 Microsoft OneNote 에 연결하고 페이지, 노트북, 섹션, 섹션 그룹과 같은 개체에 대한 작업을 수행하기 위한 요청을 보낼 수 있습니다.

1. IBM App Connect Enterprise 툴킷에서 Microsoft OneNote Request 노드가 포함된 플로우를 생성합니다.
2. 플로우에서 Microsoft OneNote Request 노드를 선택하여 편집기에서 노드 특성을 표시하십시오.
3. 기본 탭에서 커넥터 감지 실행을 클릭하십시오.
   커넥터 감지 중에 사용할 정책 프로젝트 및 저장소 세부사항의 이름을 지정하는 패널이 표시됩니다.
4. 커넥터 감지 중에 사용할 정책 프로젝트 및 저장소의 세부사항을 지정하십시오.
   1. 정책 프로젝트 필드에서 커넥터 발견 중에 작성된 정책을 저장하는 데 사용되는 정책 프로젝트를 지정하십시오.
      또는 새로 작성을 클릭한 후 새 정책 프로젝트의 이름을 지정하여 새 정책 프로젝트를 작성할 수 있습니다. 그런 다음 완료를 클릭하십시오.
   2. 커넥터 발견 중에 사용할 금고를 지정하십시오. 기본적으로 커넥터 발견 중에 사용되는 신임 정보는 외부 디렉토리 저장소에 저장됩니다. 외부 디렉토리 저장소는 모든 통합 서버에서 사용할 수 있는 App Connect Enterprise 저장소입니다. 또는 통합 서버의 작업 디렉토리에서 작성되고 해당 특정 통합 서버에서만 사용할 수 있는 통합 서버 저장소에 신임 정보를 저장할 수 있습니다.
      신임 정보를 저장하는 데 사용할 저장소를 지정하려면 다음 주제 중 하나의 커넥터 발견 마법사 사용 섹션에 있는 단계를 완료하십시오.

      • 외부 디렉터리 볼트 구성
      • 통합 서버 저장소 구성
   3. 저장소 키 필드에 저장소에 저장된 신임 정보에 액세스하는 데 사용되는 저장소 키를 입력하십시오. 저장소 키의 길이는 8자 이상이어야 합니다.
   4. 선택사항: 기본적으로 지정된 저장소 위치 및 저장소 키는 커넥터 발견을 실행할 때 값이 사전 설정되도록 툴킷에서 환경 설정으로 저장됩니다. 환경 설정을 저장하지 않으려면 저장소 환경 설정에 저장을 선택 취소하십시오.
5. Microsoft OneNote 커넥터에 대한 커넥터 발견 마법사를 시작하려면 발견 실행 을 클릭하십시오.
   커넥터 감지 창이 표시됩니다. 기존 Microsoft OneNote 연결 (계정) 이 사용 가능한 경우, 해당 연결 목록이 표시됩니다. 기존 연결이 없는 경우 Microsoft OneNote 커넥터의 상태는 Not connected로 표시됩니다.
   • 하나 이상의 Microsoft OneNote 연결 (계정) 이 사용 가능한 경우 다음 단계를 완료하십시오.
     1. 사용할 연결 (계정) 을 클릭하여 선택하십시오.
     2. 필요한 오브젝트 유형을 클릭한 후 오브젝트에 대해 수행할 조치를 선택하십시오. 예를 들어, 다음에서 노트북을 검색하려면 마이크로 소프트 원 노트, 클릭 노트북 그런 다음 노트북 검색.
   • 기존 연결(계정)이 없는 경우 다음 단계를 완료하십시오.
     1. 필요한 오브젝트 유형을 클릭한 후 해당 오브젝트에 대해 수행할 조치를 선택하십시오. 예를 들어, 다음에서 노트북을 검색하려면 마이크로 소프트 원 노트, 클릭 노트북 그런 다음 노트북 검색.
     2. 연결 을 클릭하여 다음 권한 부여 방법 중 하나를 선택해야 하는 메뉴를 표시하십시오.
        • 사용할 App Connect 에 대한 신임 정보 제공 (OAUTH 2.0 PASSWORD)
        • 사용할 App Connect 에 대한 신임 정보 제공 (BASIC OAUTH)
     3. 권한 부여 방법으로 사용할 App Connect 에 대한 신임 정보 제공 (OAUTH 2.0 PASSWORD) 을 선택한 경우 다음 세부사항을 입력하십시오.
        1. 사용자 이름 필드에 Microsoft OneNote API에 액세스할 수 있는 권한이 부여된 사용자 이름을 입력하십시오.
        2. 비밀번호 필드에 지정된 사용자 이름의 비밀번호를 입력하십시오.
        3. 애플리케이션 클라이언트 ID 필드에 Microsoft Azure 앱 등록이 특정 프로젝트 요청에 맵핑된 후 생성되는 고유 ID를 입력하십시오.
        4. 애플리케이션 클라이언트 시크릿 필드에 프로젝트 특정 고유 애플리케이션 클라이언트 ID에 대한 애플리케이션 클라이언트 시크릿을 입력하십시오.
     4. (BASIC OAUTH) 를 사용할 App Connect 에 대한 신임 정보 제공 을 권한 부여 방법으로 선택한 경우 다음 세부사항을 입력하십시오.
        1. 애플리케이션 클라이언트 ID 필드에 Microsoft Azure 앱 등록이 특정 프로젝트 요청에 맵핑된 후 생성되는 고유 ID를 입력하십시오.
        2. 애플리케이션 클라이언트 시크릿 필드에 프로젝트 특정 고유 애플리케이션 클라이언트 ID에 대한 애플리케이션 클라이언트 시크릿을 입력하십시오.
        3. 액세스 토큰 필드에 애플리케이션 클라이언트 ID및 클라이언트 시크릿에서 생성되는 액세스 토큰을 입력하십시오.
        4. 새로 고치기 토큰 필드에 애플리케이션 클라이언트 ID및 클라이언트 시크릿에서 생성되는 새로 고치기 토큰을 입력하십시오.
        5. 프록시 이름 : ` App Connect `가 커넥터 호출을 전달하는 데 사용할 프록시의 이름을 선택하거나 지정합니다. 이 필드는 호출이 프록시를 거쳐야 하는 경우에만 필수입니다. IBM App Connect Enterprise 툴킷을 사용할 때는 프록시 이름을 다음 형식으로 지정해야 합니다: {PolicyProjectName}:HTTPProxyPolicyName

        이러한 연결 정보에 액세스하거나 생성하는 방법에 대한 자세한 내용은 IBM App Connect in containers 의 ‘지속적 배포(CD)’ 문서에 있는 “Microsoft OneNote 에서 IBM App Connect 사용 방법”을 참조하십시오.

     5. 연결을 클릭하십시오.
6. 마법사에서 필수 커넥터 특성을 설정하십시오.
   검색 또는 업데이트 조치의 경우 조건 추가 를 클릭한 후 필터링할 특성을 선택하여 데이터 검색을 위한 조건을 추가할 수 있습니다.

   검색 또는 업데이트 조치에 대한 조건을 추가하는 경우 선택적으로 조건 필터링을 사용하여 적용되는 조건을 세분화할 수 있습니다. 조건 필터링을 사용하려면 ‘닫기’ 버튼(X)을 클릭하여 커넥터 검색 마법사를 종료한 다음, ‘조건 필터링 사용’ 섹션의 지침을 따르십시오.

   작성 조치의 경우 선택적으로 고급 모드를 사용할 수 있습니다. 조치의 기본 편집 보기에서 일부 애플리케이션에는 일반 유스 케이스에 필요하지 않으므로 숨겨진 필드가 있습니다. 고급 유스 케이스의 경우 플로우 편집을 위한 추가 기능을 제공하는 고급 모드 편집으로 전환할 수 있습니다. 고급 모드를 사용하려면 ‘닫기’ 버튼(X)을 클릭하여 커넥터 검색 마법사를 종료한 다음, ‘고급 모드 사용’ 섹션의 지침을 따르십시오.

   검색할 최대 레코드 수와 해당 한계를 초과하는 경우 수행할 조치를 지정하는 특성을 설정할 수도 있습니다.

7. 커넥터 발견 마법사에서 등록 정보 지정을 완료하면 저장을 누르십시오.
   Microsoft OneNote 에 연결하는 데 사용되는 신임 정보는 저장소에 저장되고 기타 연결 세부사항은 Microsoft OneNote 정책에 저장됩니다. 자세한 내용은 Microsoft의 ‘ OneNote ’ 정책을 참조하십시오. 마법사에서 설정한 속성 값은 ‘ IBM App Connect Enterprise Toolkit ’의 ‘Microsoft OneNote Request’ 노드로 반환됩니다.
8. 감지를 완료하고 특성 값을 저장했으면 창의 오른쪽 상단에 있는 X를 클릭하거나 Alt+F4를 눌러 커넥터 감지 마법사를 종료하십시오.
9. IBM App Connect Enterprise Toolkit 에서 Microsoft OneNote Request 노드 편집 화면으로 돌아갑니다.
   커넥터 발견 마법사 ( 6단계) 에서 설정된 커넥터 특성이 이제 특성 편집기의 Microsoft OneNote Request 노드에 표시됩니다. 기본 탭에는 마법사에서 설정한 조치 및 오브젝트 특성의 값이 표시됩니다. 예를 들어, 마법사에서 [노트북 ] > [노트북 가져오기] 를 선택한 경우, 해당 노드의 [ 기본 ] 탭에 다음과 같은 속성이 표시됩니다:

   • 조치 - RETRIEVEALL
   • 오브젝트 - getUsersByIdOnenoteNotebooks_model

   조치 및 오브젝트 특성의 값은 읽기 전용 형식으로 표시됩니다. 이러한 값을 변경하려면 커넥터 감지 실행을 다시 클릭하고 커넥터 감지 마법사에서 새 값을 설정하여 이를 수행할 수 있습니다.

   스키마 기본 이름 특성은 Microsoft OneNote 커넥터와 주고 받는 요청 및 응답 메시지의 형식을 설명하는 스키마 파일의 기본 이름을 지정합니다. 스키마 기본 이름은 노드에 대한 발견을 처음 실행할 때 자동으로 설정되며 현재 플로우 이름 및 노드 이름을 기반으로 합니다. 처음 감지를 실행하기 전에 이 특성을 수동으로 설정하면 설정한 값이 사용됩니다. 발견 후 스키마의 이름을 바꾸는 경우 프로젝트에서 이름을 바꾼 스키마에서 사용하는 스키마 기본 이름과 일치하도록 이 특성을 편집해야 합니다. 감지 후에 이 특성을 변경하는 경우 일치하도록 스키마 이름을 바꾸거나 감지를 다시 실행해야 합니다.

   감지 중에 선택된 조치에 따라 커넥터 감지 마법사는 요청 스키마 및 응답 스키마 또는 응답 스키마만 생성합니다. 요청 스키마는 선택한 조치 및 오브젝트에 요청 메시지가 필요한 경우에만 생성됩니다. 생성된 요청 스키마는 요청 메시지의 유효성 검증에 사용됩니다. 조치가 RETRIEVE 또는 DELETE인 경우 커넥터가 응답 스키마만 리턴합니다.

   생성된 스키마 파일이 프로젝트에 추가되고 입력 또는 출력 데이터를 변환하기 위해 맵핑 노드에서 사용할 수 있습니다. 스키마의 전체 파일 이름은 스키마 기본 이름 (예: gen/MyMessageFlow.Microsoft_OneNote_Request) 에서 파생되며 접미부는 response.schema.json 또는 request.schema.json입니다. 요청 스키마 열기 또는 응답 스키마 열기를 클릭하여 스키마를 열 수 있습니다.

10. Microsoft OneNote Request 노드의 특성 설정이 올바른지 확인한 후 메시지 플로우를 저장하십시오.
11. Microsoft OneNote Request 노드의 연결 탭에서 정책 특성은 연결에 사용할 보안 ID의 세부사항을 포함하는 정책의 이름을 표시합니다. 정책의 유형은 Microsoft OneNote입니다.
    자세한 내용은 Microsoft의 ‘ OneNote ’ 정책을 참조하십시오.
12. 선택사항: 연결 탭에서 제한시간 특성을 설정하여 노드가 Microsoft OneNote 가 조작을 처리할 때까지 대기하는 시간 (초) 을 지정하십시오.
13. Microsoft OneNote Request 노드의 필터 탭에는 메시지 플로우가 데이터를 선택하는 방법을 제어하는 특성이 포함되어 있습니다. 이러한 특성의 초기값은 커넥터 발견 마법사의 Microsoft OneNote 커넥터에 대해 설정된 특성 값에서 가져옵니다. 여기에는 필터 옵션 특성 및 지정된 조건 ( 6단계에 설명된 대로) 이 포함됩니다. 나중에 커넥터 발견 마법사로 돌아가서 등록 정보의 값을 변경하면 (예를 들어, 새 조건을 추가하여) 해당 갱신사항이 노드의 등록 정보 세트에 반영됩니다.

    필터 옵션 특성은 Microsoft OneNote Request 노드가 실행될 때 작동할 오브젝트를 제어합니다. 필터 한계 특성은 검색할 최대 항목 수 및 한계를 초과하는 경우 수행할 조치를 제어합니다.

    필터 옵션 섹션에서 수정할 값 옆에 있는 편집 을 클릭하고 필터 한계 섹션에서 설정된 특성 값을 변경하여 값을 수정할 수 있습니다.

    특성 값은 실행 시 Microsoft OneNote Request 노드에 전달되는 메시지의 컨텐츠에서 해석되는 텍스트 값 또는 ESQL 또는 XPATH 표현식일 수 있습니다.

14. 요청 탭에서 데이터 위치 특성을 설정하여 Microsoft OneNote에서 작성될 오브젝트 데이터를 포함하는 수신 메시지 트리의 위치를 지정하십시오. 이 데이터는 Microsoft OneNote Request 노드에서 Microsoft OneNote로 전송되는 요청을 형성합니다.
15. 결과 탭에서 출력 데이터 위치 특성을 설정하여 Microsoft OneNote에서 작성된 레코드의 데이터를 포함할 출력 메시지 트리의 위치를 지정하십시오.
16. 기본적으로 요청 메시지는 커넥터 발견 중에 생성된 요청 스키마에 대해 유효성 검증됩니다. Microsoft OneNote Request 노드의 유효성 검증 특성을 사용하여 요청 유효성 검증을 끄거나 유효성 검증 설정을 변경할 수 있습니다.
17. 메시지 플로우를저장 하십시오.