Tax Reporting에서 OCI Object Storage 설정

Tax Reporting에서 Task ManagerSupplemental Data Manager 첨부파일에 대해 OCI Object Storage를 설정하려면 다음을 수행합니다.

  1. 네비게이터로 이동하고 에서 연결을 누릅니다.

    연결 관리 페이지가 표시됩니다.

  2. 생성을 눌러 연결을 생성합니다.

    연결을 생성할 제공자 선택 대화상자가 표시됩니다.

  3. 기타 웹 서비스 제공자를 누릅니다.

    연결 세부정보 입력 대화상자가 표시됩니다.

  4. 다음 세부정보를 지정합니다.
    • 연결 이름: Object Storage 연결의 이름입니다.
    • 설명: 연결에 관한 간략한 설명입니다.
    • URL: Object Storage 버킷 URL입니다. Oracle Object Storage Cloud 버킷의 URL입니다.
    • 사용자비밀번호: Oracle Cloud Infrastructure에서 Tax Reporting용으로 생성한 사용자 이름과 비밀번호입니다.

      Note:

      통합 ID 제공자에서 사용자가 생성된 경우 사용자 이름에 통합 ID 제공자 이름이 접두어로 지정되어야 합니다. oracleidentitycloudservice/username을 예로 들 수 있습니다. 비밀번호의 경우, 로그인 비밀번호가 아닌 인증 토큰을 비밀번호로 사용해야 합니다.
  5. 저장 및 닫기를 눌러 Object Storage 연결 세부정보를 저장합니다.
  6. > 애플리케이션 > 태스크 관리자로 이동합니다.
  7. 시스템 설정 탭을 누릅니다.

    시스템 설정 관리 페이지가 표시됩니다.

  8. Object Storage를 누르고 연결 드롭다운 목록에서 Object Storage 연결을 선택합니다.

    버킷 URL이 자동으로 채워집니다.

    URL 형식: https://swiftobjectstorage.region_identifier.oraclecloud.com/v1/namespace/bucket_name. 여기서,
    • region_identifier는 호스팅 OCI(Oracle Cloud Infrastructure)입니다.
    • region.namespace는 모든 버킷 및 객체에 대한 최상위 레벨 컨테이너입니다. 각 Oracle Cloud Infrastructure 테넌트는 계정 생성 시에 변경이 불가능하며 고유한 시스템 생성 Object Storage 네임스페이스 이름이 지정됩니다. 테넌시 네임스페이스 이름(예: axaxnpcrorw5)은 모든 영역에서 유효합니다
    • bucket_name은 데이터 및 파일을 저장하는 논리 컨테이너의 이름입니다. 버킷은 구획에서 구성되고 유지관리됩니다.

    예제 URL: https://swiftobjectstorage.us-ashburn-1.oraclecloud.com/v1/epmcloud/fccsAttachments

    버킷 내에 폴더를 생성한 경우 URL 형식: https://swiftobjectstorage.us-ashburn-1.oraclecloud.com/v1/epmcloud/bucket_name/folder_name. 여기서, folder_name은 데이터를 포함하는 폴더의 이름입니다.

  9. 검증 및 저장을 누릅니다. 시스템에서는 연결이 제대로 작동 중인지 확인하기 위해 검증하며 테스트 파일을 생성하고 읽습니다.

    Object Storage 확인 대화상자가 표시됩니다.

  10. 계속을 누릅니다. 뱃치 작업이 즉시 시작되어 현재 데이터베이스에 있는 첨부파일이 지정된 Object Storage 위치로 이동됩니다. 또한 모든 첨부파일은 데이터베이스가 아니라 Object Storage 위치에 저장됩니다. 첨부파일이 Object Storage 위치에 저장된 후에는 데이터베이스로 되돌릴 수 없습니다.
  11. 기존 고객인지, 아니면 OCI Object StorageTax Reporting을 처음 설정하는 새 고객인지 여부에 따라 통계가 표시됩니다.
    • 마이그레이션된 첨부파일 수: 마이그레이션된 첨부파일의 수입니다.

    • 마이그레이션된 첨부파일 크기(MB): 마이그레이션된 첨부파일의 크기입니다.

    • 대기 중인 첨부파일 수: 마이그레이션을 위해 대기 중인 첨부파일의 수입니다.

    • 대기 중인 첨부파일 크기(MB): 마이그레이션을 위해 대기 중인 첨부파일의 크기입니다.

    • 모든 첨부파일 수: 시스템에 있는 총 첨부파일 수입니다(마이그레이션된 첨부파일, 대기 중인 마이그레이션 첨부파일 및 새로 추가된 첨부파일 포함).

    • 모든 첨부파일 크기(MB): 시스템에 있는 모든 첨부파일의 크기입니다.

    Note:

    테스트 환경에서 프로덕션 환경으로 마이그레이션한 후 연결 세부정보의 수동 단계를 업데이트하지 않으면, 애플리케이션 내에서 첨부파일을 업로드 및 다운로드하는 동안 오류가 발생합니다. 다운로드의 경우 0바이트가 다운로드되고 업로드의 경우 검증 오류가 발생합니다.
    • 기존 고객인 경우 Tax Reporting 데이터베이스에서 OCI Object Storage로 첨부파일 마이그레이션에 관련된 통계가 표시됩니다. 첨부파일이 이동됨에 따라 통계 증분이 표시됩니다.

      Tax Reporting은 데이터베이스에서 첨부파일을 가져와 설정한 버킷에 있는 OCI Object Storage로 파일을 이동합니다. 이는 Oracle Cloud Infrastructure에서 Tax Reporting에 대해 생성한 사용자 이름 및 비밀번호와 함께 버킷 URL을 기반으로 수행됩니다. 첨부파일은 데이터베이스에서 OCI Object Storage로 이동된 다음 데이터베이스에서 제거됩니다.

      첫번째 마이그레이션 이후 첨부파일의 업로드 및 다운로드는 OCI Object Storage에서 저장 및 검색됩니다.

    • Tax Reporting의 신규 고객인 경우 기존 첨부파일을 OCI Object Storage로 이동하지 않으므로 표시된 많은 통계가 0으로 표시됩니다.

    다음은 통계의 샘플 스크린샷입니다.

    통계

재설정을 누르면 작동한 마지막 연결로 재설정됩니다.

구성 문제해결

OCI Object Storage를 설정하는 동안 다음 오류가 표시되면 버킷 URL 또는 인증서에 문제가 있을 수 있습니다.

Error: Unable to connect to the Object Storage service using the specified URL and credentials.

cURL 또는 Postman과 같은 REST 클라이언트를 사용하여 버킷 URL 및 인증서를 테스트합니다.

cURL 명령의 형식은 다음과 같습니다. curl <bucket URL> -u "<username>:<password>"

다음은 URL 및 인증서를 테스트하기 위한 cURL 명령 예제입니다.

curl https://swiftobjectstorage.us-ashburn-1.oraclecloud.com/v1/epmcloud/taskAttachments -u "username:password"