Loading

Data Loader로 Knowledge 자료 기사 업데이트

게시 일자: Jul 29, 2025
상세 설명

지원 제품: Salesforce Classic Knowledge 


Data Loader를 사용하여 Knowledge 문서를 업데이트하기 위한 일반 프로세스 단계:


1. 문서를 내보냅니다.

2. 텍스트 편집기에서 외부적으로 문서의 데이터를 조작합니다.

3. 업데이트 수행
 

다음 제한 사항에 유의하십시오.

 
  • Data Loader를 통해서만 초안 문서를 업데이트할 수 있으며 knowledge 문서를 내보내거나 쿼리하는 방법에 제한이 있습니다.
 
  • Data Loader를 통해 문서의 PublishStatus를 업데이트할 수 없으며 업데이트할 각 문서를 편집하여 초안 버전을 만들어야 합니다.
 
  • 문서를 초안 상태로 대량 업데이트하는 표준 또는 지원되는 방법은 없습니다. 사용자 인터페이스를 통해 한 번에 하나씩 초안 상태로 설정해야 합니다.
 
  • Classic knowledge를 사용하는 경우 한 번에 하나의 문서 유형만 내보내고 업데이트할 수 있습니다. 여러 문서 유형이 있는 경우 각각에 대해 별도의 작업이 필요합니다.


보다 모험적인 유형의 경우 Salesforce Knowledge 개발자 가이드는 Knowledge 문서를 프로그래밍 방식으로 업데이트할 수 있다고 표시하지만 Salesforce는 대량 문서 업데이트를 위한 완벽한 솔루션을 위해 Knowledge API를 활용하는 지원되는 클라이언트 도구를 제공하지 않습니다. 문서를 초안으로 설정하고 업데이트한 다음 다시 게시하기 위해 Apex Knowledge 관리 게시 서비스 클래스를 활용할 수 있지만 이렇게 하려면 지원되지 않는 이 전체 프로세스를 관리하기 위한 클라이언트 도구를 만들어야 합니다. 

개발자가 Knowledge API를 활용할 수 있도록 잠재적으로 도움을 주기 위해 토론 포럼에 프로그래밍 방식으로 게시되는 유익한 업데이트 Knowledge 문서가 있습니다.

문서 업데이트 기능을 포함하는 Knowledge Heroku 도구가 있습니다. 자세한 내용은 Knowledge 가져오기/내보내기 도구 Success 커뮤니티 그룹에서 확인할 수 있지만 이 도구는 Salesforce에서 공식적으로 지원되지 않습니다.

또한 Salesforce Knowledge 글로벌 검색 및 바꾸기(릴리스 2.0) 앱의 잠재적인 사용을 고려할 수 있습니다. 그러나 Classic 또는 Lightning Knowledge 검색 및 앱 바꾸기의 경우에도 이러한 도구는 지원되지 않습니다. 자세한 내용은 타사 앱, 설치된 패키지 또는 프로그램 지원을 참조하십시오.

 
솔루션

1. 내보내기 수행:


a. Data Loader를 열고 내보내기를 클릭한 다음 조직에 로그인합니다.

b. 모든 Salesforce 개체 표시를 선택하고 적절한 ArticleType__kav 개체를 선택합니다. 각 문서 유형에는 선택할 수 있는 고유한 개체가 있습니다. ArticleType을 원하는 문서 유형의 이름으로 대체하여 해당 KnowledgeArticleVersion 개체를 찾습니다.

c. 찾아보기...를 클릭하고 내보내기 결과 .csv 파일의 위치와 파일 이름을 선택합니다. 다음 >을 클릭합니다.

d. 내보낼 필드를 선택합니다. ID 및 업데이트할 원하는 표준 또는 사용자 정의 필드를 포함해야 합니다.

참고: KnowledgeArticleVersion (ArticleType__kav) 개체에 대해 Data Loader를 통해 내보내기를 수행할 때 쿼리 구현 제한이 있습니다. Id = [single ID], Id IN [list of ID's] 또는 PublishStatus = [status] 구문을 사용하여 필터링해야 합니다. 또한 PublishStatus는 최상위 AND 조건에서만 허용됩니다. 그렇지 않으면 다음 오류가 발생합니다.
 
‘MALFORMED_QUERY: 구현 제한: Documentation__kav 개체를 쿼리하거나 검색할 때 Id = [single ID], Id IN [list of ID's] 또는 PublishStatus = [status] 구문을 사용하여 필터링해야 합니다. 또한 PublishStatus는 최상위 AND 조건에서만 허용됩니다.’
 
제한 사항을 충족하기 위해 쿼리에 다음 조건을 추가할 수 있습니다. 

PublishStatus = 'Draft' AND Language = 'en_US'
 
Knowledge 자료가 여러 언어를 지원하는 경우 지원되는 언어 문서에서 언어 조건에 대해 사용 가능한 언어 코드 목록을 찾을 수 있습니다.

e. 필드 선택에 만족하고 위에 설명된 대로 조건을 추가했으면 완료를 클릭합니다.
 

2. 선택한 응용 프로그램을 사용하여 결과 내보내기 파일을 외부에서 조작합니다.

 
참고: Salesforce는 Microsoft Excel 기능에 대한 지원을 제공하지 않으며 데이터 관리 또는 조작 작업을 수행하는 것은 정책에 위배됩니다. 다음은 고객이 데이터를 준비할 수 있는 일반적인 예 또는 가이드로 제공되며 고객을 대신하여 지원부에서 수행할 수 없습니다.

문서에 서식 있는 텍스트 영역(RTA) 필드가 포함된 경우 해당 필드의 열에는 서식 있는 텍스트 필드에 대한 HTML 코드가 포함됩니다. 호환되는 HTML 태그 목록은 서식 있는 텍스트 편집기 문서의 지원되는 HTML 태그 및 속성 섹션을 참조하십시오.

예를 들어 Knowledge 문서 및 결과 내보내기 파일의 사용자 정의 RTA 필드에서 임베디드 이미지 URL에 대한 하드 참조를 업데이트해야 한다고 가정합니다. 예제 이미지의 HTML은 다음과 같습니다.

<img alt="Launch" src="https://c.<YourOldInstanceHere>.content.force.com/servlet/servlet.ImageServer?id=015a0000003AlU7&amp;oid=00Da0000001aQGp"></img>

이렇게 하려면 Excel의 찾기 및 바꾸기 기능을 사용하여 "https://c.<YourOldInstanceHere>.content.force.com"을 입력하고 새 인스턴스로 교체하여 문서 필드 내의 모든 URL 발생에서 이전 인스턴스에 대한 참조를 업데이트합니다.

<img alt="Launch" src="https://c.<YourNewInstanceHere>.content.force.com/servlet/servlet.ImageServer?id=015a0000003AlU7&amp;oid=00Da0000001aQGp"></img>

이 예제는 조직이 인스턴스 분할 또는 마이그레이션에 포함되어 지식 문서 이미지가 계속 표시되도록 하는 경우 특히 유용합니다.
 

3. 업데이트 수행:

 
경고: 데이터 작업을 수행하기 전에 항상 데이터를 백업하십시오. 자세한 내용은 Salesforce에서 백업 데이터 내보내기 또는 데이터 내보내기 를 참조하십시오. Salesforce에서 수동으로 열고 해당 레코드가 올바른지 확인하여 작업의 성공 여부를 확인하려면 레코드의 작은 하위 집합으로 테스트를 실행하는 것이 좋습니다.

a. Data Loader를 열고 업데이트를 클릭합니다.

b. 모든 Salesforce 개체 표시를 선택하고 ArticleType이 문서의 문서 유형 이름인 적절한 ArticleType__kav 개체를 선택합니다.
c. 찾아보기...를 클릭하고 2단계에서 외부에서 준비한 업데이트된 파일을 선택합니다. 열기를 클릭하고 다음 >확인을 클릭합니다.

d. 맵 만들기 또는 편집을 클릭하고 필드를 열에 자동 일치를 선택하거나 업데이트할 Id 필드와 필드를 수동으로 매핑합니다. 확인을 클릭합니다. 매핑이 올바른지 확인하고 다음 >을 클릭합니다.

e. 찾아보기...를 클릭하고 성공 및 오류 파일을 저장할 위치를 선택합니다. 완료를 클릭합니다.

f. 경고를 검토하고 계속할 준비가 되었으면 를 클릭합니다.
 

참고 항목:

아이디어 게시된 문서 대량 편집
Knowledge 기사 번호

000381649

 
로드 중
Salesforce Help | Article