Loading

Lightning Knowledge 마이그레이션 도구 FAQ

게시 일자: Oct 13, 2022
상세 설명
Lightning Knowledge 마이그레이션 도구 설명서와 아래에서 자주 묻는 질문을 검토하십시오.


Salesforce YouTube 동영상
Lightning Knowledge 마이그레이션 도구
Lightning Knowledge 마이그레이션 도구를 활성화하는 방법
 
솔루션


이 도구를 일반적으로 사용할 수 있지만 Lightning 설정에서 'Lightning Knowledge 마이그레이션 도우미'를 사용할 수 없는 이유는 무엇입니까?


자세한 내용은 Lightning Knowledge 마이그레이션 도구 가용성 문서를 참조하십시오.
 


기능을 활성화하고 테스트를 시작하려면 어떻게 해야 합니까?


모든 고객은 기존 설명서인 Lightning Knowledge 마이그레이션 도구 를 주의 깊게 읽고 사용하여 적격한 후보가 되고 사용하기 전에 도구의 기능을 완전히 이해해야 합니다.

고객이 사용 가능하고 최근 복사된 전체 사본 Sandbox를 보유하고 있으며, 이를 도구 실행에 활용할 수 있는 것이 가장 좋습니다. 현재 사용할 수 없는 경우 계정 팀과 함께 임시 전체 복사본 Sandbox 라이센스를 프로비저닝할 수 있는 가능성에 대해 논의해 보십시오.


프로덕션에서 어떻게 활성화합니까?
 

Sandbox에서 전체 테스트를 마쳤고 프로덕션에서 활성화할 준비가 된 경우 활성화하기 전에 제품 관리를 통한 검토 및 승인 프로세스가 필요합니다. 새 지원 사례를 기록하고 Lightning Knowledge 마이그레이션 도구 가용성의 지침을 참조하여 프로세스를 시작합니다.

참고: 프로덕션에서 기능을 검토, 승인 및 활성화하기 위한 SLA가 없습니다. 프로덕션 검토 프로세스를 완료하는 데 1~2주가 소요될 수 있으므로 프로세스를 시작하고 계획된 날짜보다 미리 잠정적인 일정을 전달합니다. 주말 또는 공휴일에 제출된 새로운 승인 요청은 최소한 다음 영업일까지 검토 또는 처리되지 않습니다. 지원 및 제품 관리는 요청을 수용하기 위해 노력하지만 정해진 일정 내에 활성화할 수 있다는 보장은 없습니다.



‘마이그레이션 확인’ 결과 페이지에서 마이그레이션되지 않은 문서를 찾을 수 있는 방법이 있습니까?


문서에는 "마이그레이션 중에  LightningKnowledgeMigrationResultTimestamp.txt라는 결과 파일이 표준 파일 개체에서 생성됩니다. 마이그레이션을 시작한 관리자가 이 파일을 소유합니다." 참조: 마이그레이션 수행: 여러 문서 유형 조직

마이그레이션에 실패한 문서 및 문서 버전이 포함된 파일은 전역 검색을 통해 파일을 검색하여 찾을 수 있습니다. 파일 이름은 ‘LightningKnowledgeMigrationResult*’ 형식이어야 하며 조직에서 파일을 찾기 위한 검색어로 사용해야 합니다.

참고: 문서 또는 문서 버전이 마이그레이션되지 않은 경우 참조된 파일이 생성되고 검토 및 참조를 위해 처음 1000개의 레코드 ID만 제공합니다. 이 도구는 문서가 마이그레이션에 실패한 이유에 대한 설명을 포함하거나 제공하지 않습니다. 안타깝게도 이러한 세부 사항은 지원 부서에 제공되지 않으며 고객은 잠재적인 불일치 또는 문제에 대해 영향을 받는 문서를 수동으로 검토해야 합니다. 문서 및 문서 버전이 성공적으로 마이그레이션된 것으로 표시되면 다른 추가 데이터가 마이그레이션에 실패했는지 여부에 관계없이 파일에 이를 표시합니다.

도구의 기능을 통해 제공되는 추가 마이그레이션 세부 사항을 보려면 더 큰 Trailblazer Community에서 가시성과 고려 사항을 고려하고 잠재적인 기능 향상을 추적하기 위해 IdeaExchange에서 아이디어를 만들거나 홍보하는 것을 고려하십시오.



이전 문서 번호를 유지할 수 있습니까?


아니요, 여러 문서 유형 마이그레이션을 수행하는 경우 Lightning Knowledge로 마이그레이션할 때 문서 번호 변경을 제어할 수 없습니다. 표준 자동 번호 필드 유형의 하드 코딩된 응용 프로그램 제한으로 인해 이전 문서 번호를 유지할 수 있는 옵션이 없습니다.

참고: 단일 문서 유형 마이그레이션의 경우 문서 번호가 유지되며 변경되지 않습니다. 이는 마이그레이션 프로세스가 단일 문서 유형 마이그레이션에 대한 문서를 다시 생성하지 않기 때문입니다.


단일 문서 유형 마이그레이션을 수행하면 어떻게 됩니까?

단일 문서 유형 마이그레이션은 단일 문서 유형 마이그레이션 문서의 4단계에서 선택한 항목에 따라 다음과 같은 동작을 나타낼 것으로 예상됩니다.
 
  • ‘...라는 새 레코드 유형에 할당’ - 기존 문서 유형의 이름은 개체의 API 이름으로 사용되지만 Knowledge 개체의 레이블은 'Knowledge'로 변경됩니다.
 
  • ‘나중에 새 레코드 유형을 직접 만들기’ - 기존 문서 유형의 이름이 Knowledge 개체의 레이블 및 API 이름에 사용되며 Knowledge(Knowledge__kav)로 변경되지 않습니다.

‘시작’을 클릭하면 도구에 대한 사용자 인터페이스에 제공되는 추가 단계, 확인 페이지 또는 진행률 표시가 없으며 더 이상 설정에 표시되지 않습니다. 마이그레이션은 백그라운드에서 실행되며 관리자는 마이그레이션 프로세스가 완료되면 이메일 알림을 받아야 합니다.
 


마이그레이션되지 않은 다른 데이터를 어떻게 처리합니까?

 
현재로서는 성공적으로 마이그레이션되지 않은 문서 및 버전 ID만 제공합니다. 문서 또는 기타 측면이 마이그레이션되지 않은 이유에 대한 구체적인 세부 사항은 제공되지 않습니다. Salesforce 지원에는 특정 데이터가 마이그레이션되지 않은 내용과 이유에 대한 세부 사항을 고객에게 제공할 수 있는 기능이 없습니다. 이 수준의 세부 사항은 도구가 출력하는 것이 아니며 도구의 현재 기능을 통해 제공되지 않습니다.

마이그레이션 도구는 100% 성공률을 보장하지 않으며 마이그레이션되지 않는 일부 데이터가 조직에 대한 특정 변경이나 도구 자체 수정을 통해 직접 해결할 수 있는 예상치 못한 문제를 반드시 나타내는 것은 아닙니다. 이 도구는 고객이 Lightning Knowledge로 마이그레이션하는 데 도움이 되는 수단을 제공하기 위해 고안되었으며 보장된 엔드 투 엔드 솔루션이 아닙니다. 결과가 만족스럽지 않으면 작업을 취소하여 도구 설명서의 모든 권장 사항을 따르고 최근에 새로 고쳐진 전체 Sandbox를 사용하고 있는지 확인하십시오.

마이그레이션 실패의 가능성이 있는 경우 고객측에서 개입하여 고객의 고유한 요구 사항을 신중하게 검토하고 결과가 만족스러운지 확인하십시오. 마이그레이션 결과를 검토하고 자체 분석을 수행하여 진행 여부를 결정하는 것은 고객의 책임입니다. 이 도구는 있는 그대로 제공되며 정품 솔루션으로 의도되어 고안된 도구가 아닌, Lightning Knowledge로 마이그레이션하는 데 도움이 되는 수단일 뿐입니다.

도구의 사용 가능한 세부 사항 또는 고객사 담당자에 따라 마이그레이션 결과를 승인하거나 취소하기 위한 데이터를 수동으로 검토하고 확인하는 업무는 지원 서비스의 범위에 포함되지 않습니다.



마이그레이션 요약 이메일은 누가 수신하나요?


도구가 실행되는 조직에서 ‘모든 데이터 수정’ 권한이 있는 프로필이 할당된 모든 활성 사용자는 마이그레이션 요약 이메일을 수신합니다. 이 동작을 변경할 수 있는 방법이 없으며 도구의 하드 코딩된 기능입니다.

관리자가 이메일을 수신하지 못한 경우 사용자 레코드에 지정된 이메일 주소가 유효한지 확인하고 이메일 전달성을 최소 "시스템 전용"으로 설정합니다. 자세한 내용은 Salesforce에서 보낸 이메일에 대한 전달성 설정 구성 지침 을 참조하십시오. 



마이그레이션에 오랜 시간이 소요되는 이유는 무엇일까요?


완료 시간은 마이그레이션할 Knowledge 자료의 크기와 동시에 실행 중인 다른 프로세스의 수에 따라 달라집니다.

마이그레이션 완료에 필요한 예상 시간이나 SLA는 없으며, Knowledge 자료의 사용자 정의 규모와 정도에 따라 며칠에서 일주일 이상 소요될 수 있습니다.

마이그레이션 프로세스는 폐쇄된 시스템이며 지원팀이나 제품팀이 처리 시간을 단축할 수 없습니다. 그러나 예상치 못한 문제가 발생할 수 있다고 생각될 경우 Salesforce 지원에 사례를 기록하여 마이그레이션의 현재 상태를 확인합니다.



마이그레이션을 취소할 경우 ‘문서 유형이 취소에 대한 올바른 상태가 아닙니다’ 또는 '문서 유형 Knowledge가 올바른 상태가 아닙니다'라는 메시지가 표시되는 이유는 무엇입니까?


이러한 오류는 이전 문서 유형 또는 새 문서 유형이 마이그레이션 과정에서 수동으로 변경된 경우 발생하는 것으로 알려져 있습니다. 예를 들어 문서 유형이 삭제되었거나 마이그레이션 중 설정에서 배포 상태가 수동으로 변경된 경우

Knowledge 설정 관련 변경 사항을 수동으로 취소하려면 조직의 설정 감사 추적을 검토하여 취소를 다시 시도합니다. 자세한 내용은 모니터 설정 변경 사항을 참조하십시오.

마이그레이션 과정에서 문서 유형이 삭제된 경우 해결 방법을 사용할 수 없으며 Sandbox를 새로 고치고 정리된 슬레이트로 다시 시작해야 합니다. 새로 고칠 수 없는 경우 지원 부서에 문의하여 마이그레이션을 수동으로 재설정할 수 있는지 확인합니다.



마이그레이션을 취소하는 데 시간이 오래 걸리는 이유는 무엇입니까?


Knowledge 사용자 정의 및 기본 프로세스의 정도가 가변적이므로 실행 취소 프로세스에 걸리는 시간에 대한 근사치, 추정 또는 SLA는 없습니다. 실행 취소를 완료하는 데 며칠에서 일주일 이상 소요되는 일이 종종 발생합니다.

오랜 시간 동안 실행 취소가 완료될 때까지 대기하는 경우:

1) Knowledge에 변경 사항이 없는지 확인하려면 설정 감사 내역을 확인합니다. 문서에 "경고 마이그레이션을 수락하거나 취소하기 전에 개체 관리자에서 Knowledge 개체를 업데이트하지 마십시오. 업데이트할 경우 취소 작업이 중단됩니다."라고 기술되어 있습니다. 참조: 여러 문서 유형 마이그레이션.

설정 감사 내역에 변경 사항이 있는 경우 실행 취소를 성공적으로 완료하려면 변경 사항을 되돌려야 할 수 있습니다.

2) “Knowledge 마이그레이션 실행 취소 작업 실패”라는 제목의 이메일 알림을 받았는지 확인합니다.

조직이 새 Knowledge__kav 개체에 대한 종속성을 생성한 경우 실행 취소 프로세스가 완료되지 않습니다. 취소를 방지하는 종속성에 대한 세부 사항을 제공해야 하는 이메일을 검토합니다.

이러한 종속성이 제거되면 실행 취소를 진행하기 전에 마이그레이션 프로세스 중에 생성된 Knowledge__kav 문서 유형을 수동으로 영구 삭제해야 할 수 있습니다.

Lightning Experience의 개체 관리 설정으로 이동 또는 Classic에서 ‘설정’을 열고 빠른 찾기 상자에 'Knowledge 문서 유형'을 입력한 다음 ‘Knowledge 문서 유형’ 설정 섹션을 선택합니다.
 
  • 두 위치 중 하나에 배포되지 않은 상태의 ‘Knowledge__kav’ 개체가 포함된 경우 수동으로 삭제한 다음 영구 삭제하여 실행 취소 프로세스를 완료할 수 있습니다. ‘Knowledge__kav’ 개체 삭제에 대한 지침은 문서 유형 삭제를 참조한 다음 문서 유형 설정에서 '삭제된 개체’ 목록을 찾고 '지우기'를 클릭하여 개체를 영구적으로 제거하거나 영구 삭제합니다.
 
  • 백그라운드 작업 모니터링을 통해 영구 삭제 작업의 상태를 모니터링할 수 있습니다. 해당 항목 '작업 유형'은 다음과 같아야 합니다. ‘사용자 정의 엔티티 정의가 영구 삭제될 경우 사용자 정의 엔티티 데이터를 정리합니다.’ 작업 상태가 완료로 표시되면 실행 취소가 완료됩니다. 작업 상태가 완료로 표시되는 예기치 않은 상황이 있을 수 있지만 영구 삭제된 Knowledge 개체는 계속 유지됩니다. 이 상황이 시나리오일 수 있다고 예상되는 경우 추가 조사를 위해 사례를 기록하고 지원팀에 이 문서의 내부 정보 섹션을 참조하도록 요청하고 지원팀에 남아있는 Knowledge 개체를 제거하기 위해 프로세스를 수동으로 실행할 수 있는 권한을 제공합니다.
 
3) 마이그레이션에 파일이 포함된 경우 취소 프로세스는 마이그레이션 프로세스의 일부로 생성된 파일을 효과적으로 제거하기 위해 예약된 실제 삭제 작업이 조직에 대해 실행될 때까지 대기해야 할수 있습니다.
 
  • 물리적 삭제가 자연스럽게 처리될 때까지 기다릴 수 없거나 취소를 진행할 수 없는 경우 추가 조사를 위해 지원팀에 사례를 기록합니다. 지원팀에서 예기치 않은 문제가 발생했는지 또는 프로세스가 물리적 삭제를 기다리고 있는지 확인할 수 있습니다. 조직에 대한 명시적 권한을 제공하고 문서화할 경우 지원팀에서 수동으로 삭제할 수 있습니다.

오류를 해결하기 전에는 마이그레이션을 시작할 수 없습니다: You can’t migrate an article type called “Knowledge” when starting the migration assistant. (마이그레이션 도우미를 시작할 때 'Knowledge'라는 문서 유형의 문서는 마이그레이션할 수 없습니다.)

이 오류는 'Knowledge'라는 이름과 개체명을 가진 Classic 문서 유형이 이미 존재하는 경우에 발생합니다. 

 

마이그레이션을 수락할 경우 ‘이 사용자 정의 개체는 다른 기능에서 사용됩니다.’라는 메시지가 표시되는 이유는 무엇입니까?


다음과 같은 이유로 마이그레이션을 완료할 수 없습니다.

이 작업을 완료할 수 없습니다. 이 사용자 정의 개체는 다른 기능에서 사용됩니다. 사용을 제거하고 다시 시도합니다. <ReferenceHere>

마이그레이션 프로세스에서 기존 참조로 인해 이전 문서 유형을 삭제할 수 없는 경우 오류가 수신됩니다. 고객은 Developer Console을 사용하여 ‘*__ka’ 및 '*__kav'를 검색하여 이전 문서 유형을 참조하는 잠재적 Apex 코드를 찾을 수 있습니다. 자세한 내용은 여러 문서 유형 마이그레이션 문서의 13단계에 있는 글 머리 기호에 설명되어 있습니다.

참고: 모든 참조를 나열하는 메타 데이터 분석은 지원 서비스의 범위에 포함되지 않습니다. 이 프로세스는 고객이 완료해야 합니다.

개발자가 관련 참조가 모두 삭제되었지만 종속성 메시지가 계속 표시되고 이전 문서 유형을 삭제할 수 없는 경우 Salesforce 지원에 사례를 기록하여 백그라운드에서 예기치 않게 지속될 수 있는 지연 Apex 종속성을 수동으로 제거하기 위해 스크립트를 사용해야 하는지 여부를 조사해야 합니다.
Knowledge 기사 번호

000385080

 
로드 중
Salesforce Help | Article