사이트 카탈로그로 마이그레이션 계획 site-catalog-skill

Experience 현대화 에이전트의 사이트 카탈로그에는 마이그레이션할 권한이 있는 사이트의 페이지가 나열되고 가져오기 전에 해당 페이지를 그룹화합니다. 블록의 레이아웃을 공유하는 페이지는 템플릿을 형성합니다. 페이지 간에 유사한 블록은 블록 변형(콘텐츠 구조 또는 모양에서 차이가 있는 블록 버전)을 형성합니다. 가져올 때 필드가 다른 변형은 자체 차단이 됩니다. 이 그룹화를 사용하면 템플릿당 하나의 샘플 페이지를 마이그레이션 및 확인한 다음 나머지 템플릿을 일괄적으로 가져올 수 있습니다. 카탈로그에서 찾은 템플릿, 블록 및 로케일도 예상 프로젝트를 제공하며 해당 보고서를 콘솔을 사용하지 않는 이해 당사자와 공유할 수 있습니다.

카탈로그가 소스 사이트를 읽고 아무것도 가져오지 않습니다. 전체 마이그레이션 워크플로에 대해서는 프로덕션 사이트 마이그레이션을 참조하십시오.

계획 시작 invoking

소스 사이트를 읽을 수 있는 권한이 있고 콘솔이 소스 사이트에 연결할 수 있는지 확인하십시오. 다음 방법 중 하나로 경험 현대화 콘솔에서 계획을 시작하십시오.

Planning이 실행되는 동안 Planning 보기에는 현재 단계, 검색 및 읽은 페이지 수, 경과 시간이 포함된 마이그레이션 계획​이 표시됩니다. 실행이 완료되기 전에 결과를 검토할 수 있습니다.

에이전트는 검색한 모든 페이지를 분석합니다. 이 보고서는 1,000페이지 이상을 발견하면 분석이 소요되는 시간을 대략적으로 알려 주고 계속 진행합니다. 매우 큰 사이트의 경우 에이전트에게 마이그레이션을 분할하는 방법을 제안하도록 요청한 다음 선택한 섹션을 카탈로그화합니다.

실행을 중지하려면 채팅에서 stop 컨트롤을 사용합니다. 계획 보기에는 끝나기 전에 중단된 계획​이 표시되며 중지된 위치를 선택하거나 다시 시작할 수 있습니다. 채팅 스레드는 중단되기 전에 발생한 상황을 보여줍니다.

계획은 다음 네 단계로 실행됩니다.

결과 및 상태 output

실행이 완료되면 에이전트는 페이지, 템플릿 및 블록 변형의 수, 로케일별 분류 및 실행 상태와 같은 요약을 채팅에 게시합니다. 계획 보기에 동일한 상태가 표시됩니다.

complete 실행에는 실패한 페이지가 계속 있을 수 있으므로 실패한 URL을 검토하십시오. 검색된 URL을 합의된 범위와 비교합니다. 아무 링크도 자체 결정이 필요하지 않은 페이지입니다. 검색, 분석, 가져오기 및 사인오프된 페이지의 수를 구분합니다.

계획 보기 planning-ui

작업 영역 패널의 계획 보기에는 마이그레이션하기 전에 수정할 수 있도록 에이전트가 식별한 템플릿, 페이지 및 블록이 스크린샷과 함께 표시됩니다. 모든 이후 단계는 이 그룹화를 기반으로 하므로 페이지를 가져오기 전에 검토하십시오. 이 보기는 에이전트가 파일을 변경하기 전에 한 개의 요청에 대한 접근 방식을 제안하는 채팅의 플랜 모드와 관련이 없습니다.

계획 뷰 열기 accessing-planning-ui

현재 프로젝트에서 사이트를 카탈로그화하지 않은 경우 계획을 시작할 수 있도록 보기에 사이트 주소를 묻습니다.

이 보기는 catalog/ 폴더의 파일에서 콘솔 작업 영역당 하나의 마이그레이션 계획을 표시합니다. 예를 들어 국가 사이트당 하나의 계획과 같이 여러 계획을 나란히 유지할 수 없습니다. 사이트를 차례로 계획 및 마이그레이션하고, 기록을 유지하려면 각 계획의 보고서 번들을 다운로드하십시오.

대시보드 dashboard

대시보드에 카탈로그화된 사이트가 요약됩니다. 머리글에는 사이트 제목, 실행 상태 및 분석 날짜가 표시됩니다. 작업 영역 헤더에서 사이트 열기​를 선택하여 새 탭에서 원본 사이트를 엽니다.

대시보드 카드에는 다음이 표시됩니다.

카드 아래에서 토글을 수행하면 각 템플릿의 설명 및 페이지 수가 포함된 템플릿​과 각 블록 및 해당 변형에 포함된 블록 간에 테이블이 전환됩니다. 템플릿 이름을 선택하여 템플릿 세부 정보를 열거나 변형을 선택하여 인스턴스를 확인합니다. 두 테이블 모두 검색 및 정렬할 수 있습니다. 카드를 숨기고 테이블에 더 많은 공간을 제공하려면 테이블 확장​을 선택하세요.

블록 테이블 blocks-table

블록 테이블은 블록당 하나의 확장 가능한 행을 보여 주며 블록의 변형이 그 아래에 중첩됩니다. 각 블록의 경우, 해당 블록에 있는 변형, 페이지 및 템플릿의 수와 코드 상태를 표시합니다.

각 블록은 기반으로 하는 블록 라이브러리의 블록 이름과 유형을 표시합니다(예: cards 유형의 cards-story 블록). 해당 변형은 .with-button과(와) 같은 변형 클래스 아래에 나열됩니다. 클래스가 없는 변형은 블록의 기본값입니다. 페이지 머리글, 바닥글 및 기본 콘텐츠(예: 일반 머리글 및 텍스트)는 블록으로 나열되지 않습니다.

Code 열은 블록에 대한 코드가 생성되었는지 여부를 표시합니다.

준비​는 코드가 있음을 의미합니다. 작성자가 블록을 편집할 수 있는지 여부 및 작동 여부는 릴리스 전 확인의 일부입니다.

신뢰도 열은 에이전트가 블록 변형을 올바로 그룹화하고 분류했는지 확인하는 방법을 보여 줍니다.

샘플 콘텐츠로 코드가 생성되면 블록의 작업 메뉴에서 샘플 보기​를 선택하여 미리 보기에서 블록의 샘플 페이지를 엽니다.

템플릿 및 페이지 세부 사항에 동일한 블록 테이블이 표시되며, 해당 템플릿 또는 페이지로 제한됩니다.

템플릿 세부 정보 template-details

템플릿을 선택하여 페이지 경로, 제목 및 블록 수와 함께 해당 템플릿을 사용하는 모든 페이지를 확인합니다. 페이지 세부 정보를 열 페이지 경로를 선택하십시오. 페이지 / 블록 토글을 사용하여 템플릿에서 사용하는 블록으로 전환합니다.

템플릿의 페이지가 마이그레이션되고 나면 템플릿에는 가져온 페이지 수와 실패한 페이지 수가 표시되며 각 페이지에는 가져오기 상태가 표시됩니다. 가져오기가 실행되는 동안 상태가 업데이트됩니다.

대시는 페이지의 템플릿이 현재 마이그레이션의 일부가 아님을 의미합니다.

페이지 세부 정보 page-details

페이지 세부 사항 에는 페이지에 있는 블록과 섹션 및 블록 수 등의 분석 세부 사항이 나열됩니다. 전체 페이지 스크린샷을 보려면 헤더에서 스크린샷 보기​를 선택하십시오. 해당 블록이 강조 표시된 스크린샷을 보려면 블록 변형에서 페이지에서 찾기​를 선택하십시오.

변형 인스턴스 variant-instances

블록 변형을 선택하여 표시되는 인스턴스, 페이지 및 템플릿의 수와 함께 사이트에서 모든 인스턴스를 나란히 봅니다. 잘못된 그룹의 인스턴스가 눈에 띕니다.

각 인스턴스의 작업 메뉴를 사용하여 해당 스크린샷을 보거나, 페이지에서 해당 스크린샷을 찾거나, 페이지 세부 정보를 열거나, 소스 페이지를 열 수 있습니다.

그룹화를 수정하려면 인스턴스를 하나 이상 선택하고 다음 작업 중 하나를 선택합니다.

적어도 하나의 인스턴스는 원래 변형에 남아 있어야 합니다. 변형의 모든 인스턴스를 이동하려면 대신 이 변형에 고유한 블록을 제공하거나 또는 다른 블록의 변형을 만드세요. 카탈로그가 재생성될 때 분할 및 이동 변경 사항은 유지됩니다.

실패한 URL failed-urls

실패한 URL 목록에는 분석할 수 없었던 각 페이지가 이유 및 시간과 함께 표시됩니다. 이미지 및 문서와 같이 페이지가 아닌 파일은 건너뛰고 별도로 계산되며 나열되지 않습니다.

카탈로그 검토 review-catalog

계획이 완료되면 에이전트는 범위 지정 결과 검토​를 제공합니다. 특히 대형 사이트의 카탈로그를 확인하기 위한 시작점으로 사용하십시오.

검토는 카탈로그만 변경합니다. 페이지를 가져오거나 코드를 생성하지 않습니다.

사이트 마이그레이션 시작​한 번에 하나의 템플릿을 마이그레이션합니다. 에이전트는 시작할 템플릿을 물은 다음 카탈로그의 페이지 및 블록을 사용합니다. 다음 페이지를 계속 진행하기 전에 해당 템플릿의 페이지를 확인하고 일부 페이지를 수정할 수 있습니다.

카탈로그 구체화 planning-actions

작업 메뉴(…)를 엽니다. 템플릿, 페이지, 블록 또는 변형 중 하나를 선택하고 AI 작업​을 선택하여 사용 가능한 작업을 확인합니다. 최대 20개의 항목을 선택하여 함께 작업할 수도 있습니다.

작업을 선택하면 콘솔이 선택한 항목을 요청이 있는 채팅에 추가합니다. 확인하기 전에 범위 및 제안된 변경 사항을 검토하십시오. 채팅에 추가​를 선택하고 변경해서는 안 되는 사항 및 에이전트가 콘텐츠를 업로드할 수 있는지 여부 등 자신의 메시지를 작성할 수도 있습니다.

일부 작업은 적용되는 위치만 표시합니다. 예를 들어, 유형이 분류된 블록에 대해서만 블록 코드 생성 및 블록 이름 바꾸기​를 사용할 수 있으며, 변형 클래스가 있는 변형에 대해서만 이 변형에 고유한 블록을 제공​할 수 있습니다.

AEM으로 페이지 마이그레이션 및 AEM으로 템플릿 마이그레이션​에서 AEM​은(는) 콘솔에 연결된 프로젝트를 참조합니다. 가져온 콘텐츠는 문서 기반 프로젝트를 위한 Experience Workspace 또는 Experience Manager 작성을 위한 작성자 인스턴스에 업로드할 때까지 콘솔 작업 영역에 유지됩니다.

그룹화 및 이름 지정 수정 사항은 이미 가져온 페이지가 아니라 카탈로그를 변경합니다. 블록 코드 생성​은(는) 코드를 변경하고 마이그레이션 작업은 콘텐츠를 가져오므로 해당 출력을 별도로 검토하십시오. 카탈로그의 구조적 리팩터는 블록 코드의 리팩터가 아닙니다. 자세한 내용은 결과를 변경하지 않고 리팩터링을 참조하십시오.

단계 다시 실행 additional-prompts

예를 들어 소스 사이트가 변경된 후 단계를 다시 실행하려면 에이전트에게 이름별로 반복하도록 요청합니다.

repeat block cataloging

또한 에이전트는 이후 단계마다 다시 실행되며 이전 단계를 유지합니다. 블록 인스턴스 분할 또는 이동과 같이 계획 보기에서 변경한 내용은 그대로 유지됩니다.

계획 보기에 블록 카탈로그가 최신 상태가 아님​이 표시되면 현재 버전을 읽을 수 없는 이전 형식으로 카탈로그가 만들어졌습니다. scope site 및 사이트 주소와의 채팅에서 계획을 다시 실행하십시오. 계획이 끝나기 전에 중지되면 계획 보기의 다시 시작​에서도 동일한 사이트에 대한 새 실행을 시작합니다.

일괄 가져오기 워크플로우 bulk-import

템플릿으로 전체 사이트 템플릿을 마이그레이션하려면 다음을 수행하십시오.

템플릿의 출력이 잘못된 경우 더 많은 페이지를 가져오기 전에 샘플 페이지에서 수정하십시오. 분석이 실패하면 실패한 URL을 확인하고 소스 액세스를 수정한 후 해당 페이지를 다시 시도하십시오. 페이지를 다시 가져오면 작성자가 이후에 편집한 내용을 덮어씁니다. 일괄로 가져오기를 참조하십시오.

카탈로그 파일 catalog-files

대부분의 사용자는 계획 보기만 필요합니다. 오프라인 보고서를 공유하거나 다른 도구의 데이터를 사용하려면 프로젝트의 catalog/ 폴더에서 원시 출력을 찾으십시오.

폴더에는 .pages/의 페이지 단위 분석 및 스크린샷과 .blocks/의 변형 단위 메타데이터를 포함하는 중간 파일도 포함되어 있습니다.

제한 사항 limitations

분석을 제출하려면 프로젝트 인계에서 확인한 날짜, 소스 범위, 보고서, 수정 사항, 확인되지 않은 URL 및 샘플 페이지를 기록하십시오.