Report Builder 문제 해결 및 우수 사례

IMPORTANT
간소화된 새 Report Builder이 2024년 10월 16일에 릴리스되었습니다. Mac, Windows 및 웹 브라우저에서 지원됩니다.
이 레거시 Report Builder 추가 기능 버전은 여전히 작동합니다. 기존 통합 문서를 새 Report Builder으로 변환할 수 있습니다.

이 문서에서는 Report Builder 최적화에 사용할 수 있는 문제 해결 및 모범 사례에 대해 설명합니다. 또한 표시할 수 있는 오류 메시지 목록도 포함됩니다.

Report Builder 5.0 사용자 및 Opening 5.1 통합 문서 section_C29898775999453FABB5FB0E098415C8

Adobe에서는 차원과 분류 사이의 구분 기호를 밑줄 (_)에서 || 기호로 변경했습니다. 이 변경 사항은 분류 요청으로 Report Builder v5.1 통합 문서를 여는 Report Builder 5.0 사용자에 대한 호환성을 의미합니다. v5.1 이전의 버전에서 작성된 통합 문서를 열 때마다 모든 직렬화된 분류 요청은 이 형식으로 변환됩니다.

이에 따라 상위 호환성 문제가 발생합니다. v5.1로 변환되면, 통합 문서를 Report Builder v5.0을 사용하는 사용자와 공유하는 경우, 해당 사용자는 분류 요청을 인식할 수 없게 됩니다. (v5.0은 "_" 기호를 찾지만 v5.1이 "||" 기호를 직렬화했습니다.)

분류 요청을 포함한 ARB v5.1 통합 문서를 열면 다음의 부작용을 경험하게 됩니다.

  • 통합 문서를 열면 다음 경고가 표시됩니다. "이 통합 문서는 Report Builder v5.1에서 마지막으로 저장되었습니다. 이 버전에서는 이 컴퓨터에 설치된 Report Builder 버전과 호환되지 않는 기능이 몇 가지 도입되었습니다. 이 통합 문서를 업데이트하기 전에 최신 Report Builder 버전으로 업그레이드하는 것이 좋습니다."
  • 분류를 포함한 ARB 요청을 마우스 오른쪽 버튼으로 클릭하면 Report Builder 컨텍스트 메뉴 ([요청 편집], [종속적 요청 추가] 등)가 표시되지 않습니다.
  • 세 번째 버튼을 클릭하거나 요청 관리자 양식에서 요청 세트를 새로 고쳐 모두 새로 고침을 수행하는 경우에는 분류 요청이 오류 없이 실행됩니다. 하지만 분류 값은 작성되지 않습니다.
  • 요청 관리자를 열어서 올바른 요청에 도달할 때까지 행에서 행으로 이동하는 방법으로는 여전히 요청을 편집할 수 있습니다.
  • 요청을 편집하고 모든 매개 변수를 동일하게 둔 다음 [마침]을 클릭하면 응답이 제대로 작성됩니다. 요청을 편집하면 응답 레이아웃 매개 변수가 다시 직렬화됨에 따라 문제가 해결됩니다. 따라서 시간은 걸리지만 해결 방법이 있습니다.

Report Builder에서의 인증 문제 section_FD79104DF1414FE2B36591606C963DE6

Report Builder에서는 보고서 세트에서 데이터 요청을 만들려면 인증이 필요합니다. Analytics 내의 설정 또는 네트워크에 따라 Report Builder에 로그인하는 데 문제가 있는 경우가 있습니다.

  • 잘못된 로그인 회사: 이 오류는 로그인 회사가 잘못 입력되었거나 네트워크 활동 문제가 있는 경우 가장 일반적으로 발생합니다. 다음을 수행합니다.

    • 오타나 잘못된 공백이 없는지 로그인 회사의 철자를 확인합니다.
    • 동일한 로그인 회사로 Analytics에 로그인하여 정확한지 확인합니다. 해당 자격 증명으로 로그인할 수 없는 경우 회사 관리자에게 연락하여 정확한 로그인 회사 정보를 받습니다.
  • 방화벽: Report Builder이 포트 80 및 443을 사용합니다. 이 포트들이 회사 방화벽에서 사용이 허용되는지 확인하십시오. 추가적인 방화벽 제외 사항을 보려면 Adobe의 내부 IP 주소를 참조하십시오.

요청 최적화를 위한 권장 사항 section_33EF919255BF46CD97105D8ACB43573F

다음 요인으로 인해 요청이 더욱 복잡해지고 처리 속도가 느려질 수 있습니다.

  • 배달 속도를 늦출 수 있는 요인: 몇 시간 내로 너무 많은 북마크, 대시보드 및 Report Builder 통합 문서가 예약되었습니다. 또한 너무 많은 Report Builder 통합 문서가 거의 동시에 예약되었는지도 고려해야 합니다. 이러한 경우 보고서 API 큐가 백로그됩니다.

  • 통합 문서 런타임 속도를 저하할 수 있는 요소: 분류가 크게 증가하거나 시간이 지남에 따라 요청 날짜 범위가 증가합니다.

  • 통합 문서 배달 실패의 원인: 통합 문서의 복잡한 Excel 수식, 특히 날짜와 시간이 포함된 수식.

  • 0(값 없음)을 반환하는 셀: Excel 시트 이름에 아포스트로피 또는 작은 따옴표가 있으면 Report Builder에서 값을 반환하지 않습니다. (Microsoft Excel 제한 사항입니다.)

  • 개별 요청 성능: 처리 속도는 다음 설정의 영향을 받을 수 있습니다.

    table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3
    설정 더 빠른 성능 더 느린 성능
    분류 및 분류 순서 적음 많음
    예: A에서 Z까지 분류하는 경우 A에 대한 항목 수는 Z에 대한 항목 수보다 항상 적어야 합니다. 반대의 경우 요청 시간이 많이 늘어날 수 있습니다.
    날짜 범위 좁은 범위 넓은 범위
    필터링 특정 필터링 가장 자주 사용하는 필터링
    세부 기간 집계됨

    시간별

    • 일별
    • 주별
    • 월별
    • 분기별
    • 연간
    항목 수 작은 데이터 세트 큰 데이터 세트
  • 예약 시간: 24시간 동안 시차를 두고 일정을 예약하십시오 (아래 표 참조). 서로 가깝게 예약된 기존의 책갈피, 대시보드 및 Report Builder 통합 문서는 지연을 발생시킬 수 있습니다. 오전 이른 시간에 더 크고, 더 복잡한 요청을 예약하여 영업일 중 수동 가져오기와 새로 고침을 허용합니다.

    table 0-row-5 1-row-5
    예약 시간 오전 1시 - 오전 2시 오전 2시 - 오전 7시 오전 7시 - 오후 6시 오후 6 - 자정
    Report Builder 사용 거의 사용 안 됨 매우 많이 사용됨 클라이언트 측 사용.
    로컬에서 새로 고치고 "즉시 전송"을 요청하는 사용자 수가 더 많음.
    또한 예약된 통합 문서가 시간 초과하는 경우 API 대기열이 지워졌는지 확인하십시오.
    별로 사용 안 됨
  • 시간 초과: 예약된 모든 보고서는 4시간 후에 시간 초과됩니다. 시스템이 세 번 더 예약을 시도하고 실패할 수 있습니다. (일반적으로 데이터 세트가 클수록 실행하는 데 오래 걸립니다.) 이러한 시간 초과는 Analytics 보고 및 Report Builder에서 볼 수 있습니다.

샘플 오류 메시지 설명 section_3DF3A1EEDAD149CB941BEABEF948A4A5

이 섹션에는 Report Builder 사용 시 발생할 수 있는 오류 메시지의 샘플 목록이 포함되어 있습니다.

NOTE
전체 목록이 아닌 오류 메시지 샘플입니다. 오류 해결에 대한 자세한 내용은 관리자에게 문의하십시오.
  • 이 기능은 열린 통합 문서에만 적용할 수 있습니다.: Excel에 열려 있는 통합 문서(스프레드시트 문서)가 없고 Report Builder 도구 모음에서 아이콘 하나를 클릭하면 이 메시지가 표시됩니다. 도구 모음은 스프레드시트를 열기 전까지 비활성화됩니다. 하지만, 이 오류가 표시되지 않고 여전히 도구 모음이 활성화되어 있으면 온라인 도움말을 클릭합니다.

  • 요청 관리자를 활성화하기 전에 먼저 요청 마법사를 종료해야 합니다. ​: 요청 관리자와 요청 마법사가 기능적으로 연결되어 있으면 요청 마법사에서 수행한 작업을 완료하거나 취소하기 전에는 요청 관리자로 작업을 시작할 수 없습니다.

  • 이 범위와 연관된 요청이 없습니다.: 이 오류 메시지는 스프레드시트에 요청이 포함되어 있지 않을 때 요청 관리자에서 시트에서 버튼을 클릭하면 표시됩니다. 스프레드시트에서 요청이 포함된 셀을 식별하려면 요청 관리자에서 테이블에 나열된 개별 요청을 클릭합니다. 요청이 셀과 연결되어 있을 경우 테이블에서 요청을 선택하면 해당 셀이 강조 표시된 채 나타납니다.

  • 선택한 범위가 유효하지 않습니다. 다른 범위를 선택하십시오.: 스프레드시트의 셀을 선택하고 이 셀에 이미 매핑된 요청이 있을 경우 이 오류가 표시됩니다. 셀에 매핑된 요청을 삭제하거나 다른 셀 범위를 매핑하도록 선택하십시오. 셀을 삭제하려면 셀을 삭제 (행 또는 행을 제거)하기 전에 요청이 들어 있는 셀을 찾아, 요청을 삭제해야 합니다.

  • 이 기능을 사용하기 전에 포커스가 있는 Excel 셀을 종료하십시오.: Excel 셀에서 편집 모드 ​이고 Report Builder 아이콘 하나를 클릭하면 이 오류 메시지가 표시됩니다. Excel 셀의 편집 모드는 셀이 선택되어 있고 커서가 셀 내부에 나타남을 의미합니다. Excel의 상단에 있는 공식 입력줄이나 이름 상자에 바로 입력하는 경우에도 Excel 셀에서 편집 모드에 있는 것입니다.

  • 선택한 범위가 다른 요청의 범위와 교차합니다. 선택 내용을 변경하십시오.: 이미 셀들을 스프레드시트에 매핑했다면 이 오류가 표시됩니다.

  • 통합 문서 복구 (제거된 레코드: /xl/calcChain.xml 부분의 수식): 저장 또는 전송할 때 통합 문서의 수식이 손상되는 경우가 있습니다. 파일을 열 때 Excel에서 이러한 수식을 실행하려고 시도하지만 실패합니다. 스프레드시트에서 calcChain.xml을 제거하여 Excel에서 수식 계산을 새로 고침이 문제를 해결할 수 있습니다.

    1. 통합 문서의 파일 확장자 이름을 .xlsx에서 .zip으로 바꿉니다.
    2. 콘텐츠의 압축을 풀고 /xl/ 폴더를 엽니다.
    3. 삭제 calcChain.xml.
    4. 콘텐츠를 다시 압축하고 파일 확장자를 다시 .xlsx로 변경합니다.
    5. Excel에서 통합 문서를 열고 모든 Report Builder 요청을 새로 고칩니다.
  • 입력 필터 또는 출력 범위와 관련된 Excel 셀이 삭제되었을 수 있습니다: Report Builder는 Excel 이름을 사용하여 데이터 요청을 셀에 첨부합니다. 이름 관리자에서 Excel 이름을 삭제하면 이 오류가 표시됩니다. Excel 이름이 삭제되면 요청을 복구할 수 없습니다. 통합 문서가 예약된 경우 일정 관리자에서 복사본을 다운로드하거나 이전에 제공된 통합 문서 복사본을 열 수 있습니다.

recommendation-more-help
a83f8947-1ec6-4156-b2fc-94b5551b3efc