시작하기 전에

이 사용지침서에서는 Oracle Visual Builder Add-in for Excel을 설치하고, REST 서비스에서 데이터를 검색하는 Microsoft Excel 워크북을 생성하고, 비즈니스 사용자가 데이터 입력 태스크를 수행할 수 있도록 워크북을 게시하는 방법에 대해 알아봅니다. 이 사용지침서는 완료하는 데 약 10분이 걸립니다.

배경

Oracle Visual Builder Add-in for Excel을 사용하면 REST 서비스에서 Excel 워크북의 테이블로 데이터를 다운로드할 수 있습니다. 여기서 사용자는 해당 변경사항을 서비스로 다시 전송하기 전에 데이터를 수정, 생성 또는 삭제할 수 있습니다. 추가 기능을 설치하면 서비스의 끝점을 입력하여 서비스에서 Excel 워크북으로 데이터를 다운로드합니다. 다운로드한 데이터를 관리하는 데 도움이 되는 명령이 포함된 새 Oracle Visual Builder 리본 탭도 표시됩니다.

필요 사항

• Microsoft Excel 365 또는 기타 지원 버전이 설치된 Windows 10 또는 11 운영 체제

  (Developing Integrated Spreadsheets Using Oracle Visual Builder Add-in for Excel의 Supported Platforms을 참조하십시오.)

• Oracle Visual Builder 인스턴스에 액세스

  참고: 선택한 REST 서비스를 사용하여 자습서를 완료할 수 있습니다. 대상 서비스에 대한 OpenAPI 서비스 메타데이터가 있는지 확인합니다. 일부 Oracle 서비스는 URL에 /describe를 추가하여 해당 설명을 제공합니다. 이 경로로 이동하면 이 자습서의 일부 단계가 서비스에 대해 다를 수 있습니다.

  예를 들어, 단계 1의 하위 단계 1에서 6까지 건너뛸 수 있지만 하위 단계 7과 8을 완료하여 추가 기능을 설치해야 합니다. 시작하기 전에 다운로드 페이지에서 설치 프로그램을 다운로드합니다.

Oracle Visual Builder Add-in for Excel 설치

1. 이 파일을 마우스 오른쪽 버튼으로 누르고 컴퓨터로 다운로드합니다.

   Personnel_Manager.zip 파일에는 Employees 비즈니스 객체 및 샘플 데이터가 있는 시각적 응용 프로그램이 포함되어 있습니다.

2. 웹 브라우저에서 Oracle Visual Builder에 사인인합니다.
3. [시각적 애플리케이션] 페이지에서 임포트를 누른 다음 파일에서 애플리케이션을 선택하고 Personnel_Manager.zip 파일을 찾아 선택합니다. 임포트를 누릅니다.
4. 시각적 애플리케이션 페이지의 이름 열에서 개인 관리자를 누릅니다.
5. 비즈니스 객체 을 누른 다음 메뉴 을 누르고 데이터 관리자를 선택합니다.

   

6. 데이터 관리자 페이지에서 Excel에서 데이터 편집을 눌러 설치 프로그램을 다운로드합니다.

   참고: 다운로드 페이지에서 최신 버전을 확인하십시오.

7. 설치 프로그램을 실행하기 전에 Excel을 종료합니다.
8. 다운로드한 설치 프로그램 파일을 두 번 눌러 설치를 시작하고 Next를 누른 다음 추가 기능을 설치한 후 Close를 누릅니다. Install Oracle Visual Builder Add-in for Excel in Developing Integrated Spreadsheets Using Oracle Visual Builder Add-in for Excel를 참조하십시오.

   성공적으로 설치하면 Excel에서 추가 기능이 사용으로 설정되고 Excel을 시작할 때 새 Oracle Visual Builder 탭이 나타납니다.

   

REST 서비스에서 데이터를 다운로드하도록 Excel 워크북 구성

이 단계에서는 Excel 워크북에서 방금 임포트한 시각적 애플리케이션과 연계된 REST 서비스에서 직원 데이터를 다운로드하는 테이블을 생성합니다.

1. Oracle Visual Builder의 비즈니스 객체 탭에서 직원, 끝점을 차례로 누릅니다.
2. 리소스 API를 확장한 다음 클립보드 아이콘을 눌러 메타데이터 리소스 API에 대한 전체 URL을 복사합니다.

   

3. 컴퓨터의 디렉토리에 employees-source.xlsx라는 Excel 워크북을 생성하고 엽니다.
4. 데이터 테이블을 찾을 셀을 누릅니다.
5. Excel 워크북의 Oracle Visual Builder 탭에서 디자이너를 눌러 새 레이아웃 설정 마법사를 실행합니다.
6. 마법사의 첫번째 화면에서 이전에 [웹 주소] 필드에 복사한 URL을 입력하고 다음을 누릅니다.

   

   인증 설정을 "Default"로 유지합니다.

   주: 다른 REST 서비스를 사용 중인 경우 해당 서비스에 대한 URL을 입력하고 URL에 /describe를 추가하십시오.

7. [사인인] 대화상자에서 Oracle Visual Builder에 액세스하는 데 사용하는 사용자 이름과 비밀번호를 입력하고 사인인을 누릅니다.

   추가 기능이 Oracle Visual Builder 인스턴스에 접속하여 서비스 메타데이터를 검색합니다. 작업 결과가 마법사에 표시됩니다.

8. 계속하려면 다음을 누릅니다.
9. 다음 화면에서 직원을 선택한 후 다음을 누릅니다.

   

   다음 화면에서는 생성할 레이아웃 유형(테이블 또는 Form-over-Table)을 선택하라는 메시지를 표시합니다.

   

10. 테이블 레이아웃을 선택한 후 다음을 누릅니다.

    다음 화면에는 하나 이상의 종속 레이아웃에 대한 추가 비즈니스 객체를 선택하라는 메시지가 표시됩니다.

    

11. 이 화면을 비워 두고 Next를 눌러 계속합니다.
12. 최종 화면에서 새 레이아웃의 세부정보를 확인하고 완료를 누릅니다.

    Excel 워크북에 새 테이블이 나타납니다. 머리글 아래에 자리 표시자 데이터 행이 있는 열 머리글이 표시됩니다. 오른쪽에 레이아웃 디자이너도 표시됩니다.

    

    주: 레이아웃의 원본 셀이 처음 10개 행에 있으면 머리글 행이 고정되어 워크시트에서 위아래로 스크롤할 때 항상 열 머리글이 표시됩니다.

13. 데이터 다운로드를 눌러 직원 비즈니스 객체가 참조하는 데이터를 다운로드합니다.

    

게시하기 전에 Excel 워크북에서 테이블 사용자정의

데이터 입력을 위해 추가 기능이 Excel 통합 문서에서 생성하는 테이블을 게시하고 사용자에게 배포하기 전에 해당 테이블을 사용자정의할 수 있습니다. 예를 들어, [전자메일] 열이 직원의 이름 앞에 나타나도록 열 순서를 변경할 수 있습니다. 검색 질의를 추가하여 서비스에서 다운로드된 데이터를 필터링할 수도 있습니다. 예를 들어, [직원] 비즈니스 오브젝트의 [임금] 필드를 검색 필드로 추가하여 사용자가 해당 기준에 일치하는 직원의 레코드만 다운로드할 수 있는 검색 기준을 입력하도록 할 수 있습니다.

1. 필요한 경우 Oracle Visual Builder 탭에서 디자이너를 누릅니다. 그런 다음 레이아웃 디자이너에서 열 탭을 누릅니다.
2. 다음과 같이 전자메일 항목의 왼쪽에 표시되는 아이콘을 끌어 놓아 열 순서를 재지정합니다.

   참고: 열을 마우스 오른쪽 단추로 누르면 순서 재지정에 대한 추가 옵션이 표시됩니다.

   

   주: 변경, 상태 및 키 열이 자동으로 생성됩니다. 해당 열을 사용자정의하거나 제거할 수 없습니다.

3. 검색 질의를 추가하려면 다운로드 탭을 누릅니다.
4. Search(검색) 옆에 있는 Edit(편집) 아이콘을 누릅니다.

   

5. Available Business Objects Field Editor에서 Salary를 선택하고 OK를 누릅니다.
6. 검색 편집기의 비교 연산자 목록에서 보다 큼을 선택하고 값을 비워 둡니다.
7. 다운로드 시 검색 프롬프트의 검색 편집기 콘트롤이 사용 안함으로 설정되도록 하려면 다운로드 시 편집기가 사용으로 설정됨을 지웁니다.
8. 검색 설정을 저장하고 검색 편집기를 닫으려면 OK를 누릅니다.
9. 데이터 다운로드를 누릅니다.
10. [검색] 대화상자에서 10000을 입력하고 확인을 누릅니다.

    추가 기능은 급여가 10,000 이상인 사원의 레코드만 다운로드합니다.

    

Excel 워크북 게시 및 사용자에게 배포

이제 Excel 워크북을 생성하고 REST 서비스에서 데이터를 다운로드하도록 구성했으므로 게시할 수 있습니다. 이 선택적 단계는 데이터 입력을 위해 다른 사용자에게 배포할 수 있는 워크북의 복사본을 생성하려는 경우에 유용합니다. 또한 설계 도구(디자이너, 레이아웃 삭제 및 게시)를 제거하고 워크시트 보호를 설정할 수 있습니다. 즉, 소스 Excel 워크북을 게시하지 않고 배포할 수 있습니다.

1. Oracle Visual Builder 탭에서 게시를 누릅니다.

   

2. [워크북 게시] 창에서 워크북의 위치 및 파일 이름을 적용합니다. 원래 워크북 이름이 -source(예: employees-source.xlsx)로 끝나는 경우 추가 기능은 -source 없이 동일한 이름을 제공합니다.

   

3. 각 카탈로그에서 서비스 호스트 제거 확인란의 선택을 취소하지만 다른 게시 옵션은 변경되지 않은 상태로 둡니다.
4. 게시를 누릅니다. Oracle Visual Builder Add-in for Excel을 사용하여 통합 스프레드시트 개발의 통합 Excel 워크북 게시를 참조하십시오.

   상태 창에 확인이 표시됩니다.

   

5. Excel 워크북을 게시하는 데 사용한 소스 Excel 워크북을 저장하고 닫습니다.

   이제 데이터 입력을 위해 게시된 워크북을 다른 사용자에게 배포할 수 있습니다. 각 사용자에게는 Excel 워크북을 생성할 때 입력한 REST 서비스에 액세스할 수 있는 사용자 이름과 비밀번호가 있어야 합니다.

   이 자습서의 다음 단계에서는 사용자가 방금 게시한 Excel 워크북을 사용하여 데이터 입력 태스크를 완료하는 방법을 보여줍니다.

게시된 Excel 워크북에서 데이터 생성, 읽기, 업데이트 및 삭제

게시한 Excel 통합 문서의 복사본을 받는 비즈니스 사용자는 추가 기능을 설치하여 REST 서비스에서 데이터를 다운로드해야 합니다. (설치 프로그램은 다운로드 페이지에서 직접 다운로드할 수 있습니다.) 추가 기능이 설치되면 서비스에 변경사항을 업로드하기 전에 워크북에서 다운로드한 데이터를 생성, 읽기, 업데이트 및 삭제할 수 있습니다.

1. 저장한 디렉토리에서 게시된 Excel 워크북을 엽니다.

   

   디자인 툴을 사용 안함으로 설정하여 게시된 워크북의 사용자가 워크북 개발자가 액세스할 수 있는 디자이너, 레이아웃 삭제 및 게시 명령에 액세스하지 못하도록 하므로 [디자인] 섹션은 Oracle Visual Builder 탭에 나타나지 않습니다. Excel 워크북을 게시할 때 모든 레이아웃을 지우도록 선택했으므로 테이블에는 열 머리글이 표시되지만 데이터는 표시되지 않습니다.

2. 데이터 다운로드를 눌러 워크북이 검색하도록 구성된 데이터를 다운로드합니다.
3. [사인인] 대화상자에 사용자 이름 및 비밀번호를 입력하고 확인을 누릅니다.
4. 사원 급여를 기준으로 데이터 다운로드를 제한하도록 검색 질의를 설정했기 때문에 질의 값을 입력하라는 메시지가 표시됩니다. 값을 비워 두고 확인을 누릅니다.

   추가 기능은 모든 직원 데이터를 다운로드합니다.

   

5. 다음 사항을 변경합니다.
   • 행 1에서 Sophia를 Sophie로 변경합니다.
   • G2 셀을 누르고 값 목록에서 관리자를 선택하여 Dave Brown의 직책을 변경합니다.
   • 예를 들어, 전자 메일 주소를 눌러 John Sieve(행 4) 행을 선택합니다. Oracle Visual Builder 탭에서 테이블 행 변경사항을 누른 다음 삭제 표시를 누릅니다.
   • 전체 행 5를 선택하고 마우스 오른쪽 버튼을 누른 다음 컨텍스트 메뉴에서 삽입을 선택합니다. 새로 삽입된 행에 대해 전자메일 = jmcgahern@example.com, 이름 = John, 성 = McGahern, 고용 일자 = 2018-01-30, 직책 = Accountant, 임금 = 19,000 및 부서 = Accounting 데이터를 입력합니다.

     주: 테이블에 새 행을 추가하는 또 다른 방법은 테이블에서 마지막으로 다운로드한 행 바로 아래의 행을 선택하고 테이블 행 변경 사항 및 행 삽입을 누르는 것입니다. 추가 기능이 테이블 내에 새 행을 생성한 다음 편집할 수 있습니다.

   • 예를 들어, 전자 메일 주소를 선택하여 테이블 맨 끝에 있는 Ken Ster의 행(행 102)을 선택합니다. Oracle Visual Builder 탭에서 테이블 행 변경사항을 누른 다음 삭제 표시를 누릅니다.

     이러한 변경 작업을 수행한 후에는 테이블이 다음 이미지에 표시된 것과 유사합니다. 즉, 변경한 각 행에 대한 변경됨 열에 Update, Delete 또는 Create 메시지가 나타납니다.

     

6. Oracle Visual Builder 탭에서 변경 사항 업로드를 누릅니다.

   테이블에 보류 중인 삭제가 있다는 메시지가 표시되면 Yes를 눌러 확인합니다. 업로드가 완료되면 테이블은 상태 열을 새로 고쳐 업로드된 각 수정된 행에 대한 변경 사항을 설명합니다.

   생성한 새 행으로 John McGahern에 대한 새 레코드가 컬렉션에 생성됩니다.

   삭제하도록 표시한 행, John Sieve 및 Ken Ster의 레코드는 REST 서비스가 컬렉션에서 해당 레코드를 삭제했으므로 더 이상 나타나지 않습니다.

   

   주: 모든 데이터는 REST 서비스에 업로드되기 전에 검증됩니다. 오류가 발생하면 항상 오류를 수정하고 변경사항을 다시 업로드할 수 있습니다. 부분 오류가 있는 경우(예: 행 업데이트 및 삭제에 성공했지만 행 생성을 실패한 경우) 실패한 생성 행에 대한 데이터만 수정하면 됩니다.

   Excel 워크북에 대한 변경사항이 성공적으로 업로드되었는지 확인하려면 시각적 애플리케이션에서 비즈니스 객체 페이지의 데이터 탭으로 이동합니다.

   

자세히 알아보겠습니까?

• Developing Integrated Spreadsheets Using Oracle Visual Builder Add-in for Excel의 Oracle Visual Builder Add-in for Excel 소개
• 다운로드에 대한 검색 옵션 구성 - Oracle Visual Builder Add-in for Excel을 사용하여 통합 스프레드시트 개발
• Oracle Visual Builder Add-in for Excel을 사용하여 데이터 관리. 이 가이드는 비즈니스 사용자가 통합 워크북을 사용하여 성공할 수 있도록 도와줍니다.