Loading
Salesforce から送信されるメールは、承認済ドメインからのみとなります続きを読む

データローダを使用したナレッジベースの記事の更新

公開日: Jul 29, 2025
説明

データローダを使用してナレッジ記事を更新する一般的なプロセスステップ:


1. 記事をエクスポートする

2. 記事のデータを外部のテキストエディタで操作する

3. 更新を実行する
 

次の制限に注意してください。

 
  • データローダを介した更新はドラフト記事に対してのみ可能です。ナレッジ記事のエクスポートまたはクエリには、いくつかの制限があります。
 
  • 記事の PublishStatus はデータローダを介して更新することはできません。更新する記事ごとに編集してドラフトバージョンを作成する必要があります。
 
  • 記事をドラフト状況に一括で更新するための標準の方法またはサポートされる方法はありません。ユーザインターフェースを介して記事を 1 つずつドラフト状況に設定する必要があります。
 
  • Classic ナレッジを使用している場合、記事タイプは一度に 1 つのみエクスポートおよび更新できます。複数の記事タイプがある場合、記事タイプごとに個別の操作を実行する必要があります。


他の方法を試してみたい方は、「Salesforce ナレッジ開発者ガイド」を参照してください。ナレッジ記事をプログラムで更新できることが示されています。ただし、記事を一括更新するためのエンドツーエンドの標準ソリューションを目的とする、ナレッジ API を活用したサポートされるクライアントツールは Salesforce では提供されません。Apex ナレッジ管理の公開サービスクラスを使用して記事をドラフトに設定して更新した後、再公開できる場合がありますが、これを行うと、サポートされないこのプロセス全体を管理するクライアントツールを作成する必要があります。

ディスカッションフォーラムに「Updating Knowledge Articles programmatically (プログラムによるナレッジ記事の更新)」という投稿があります。これは、開発者がナレッジ API の活用を開始する上で役立つ可能性があります。

記事の更新機能を含む、ナレッジの Heroku ツールがあります。詳細は、「Knowledge Import/Export Tools」Trailblazer Community グループを参照してください。ただし、このツールは Salesforce が正式にサポートするものではありません。

また、Salesforce Classic 用の「Salesforce Knowledge Global Search and Replace (Release 2.0) (Salesforce ナレッジのグローバル検索および置き換え (リリース 2.0))」アプリケーションまたは「Lightning Knowledge Search and Replace (Lightning Knowledge の検索および置き換え)」アプリケーションを使用できる場合もありますが、これらのツールは正式にサポートされるものではありません。詳細は、「Support for third party apps, installed packages, or programs (サードパーティアプリケーション、インストール済みパッケージまたはプログラムのサポート)」を参照してください。

 
解決策

1.エクスポートを実行する


a. データローダを開き、[エクスポート] をクリックして組織にログインします。

b.記事タイプごとに独自のオブジェクトを選択できる Classic ナレッジで [Salesforce のすべてのオブジェクトを表示] を選択して、適切な ArticleType__kav オブジェクトを選択します。ArticleType は、対応する KnowledgeArticleVersion オブジェクトを見つけるための記事タイプの名前に置き換えてください。Lightning Knowledge の場合、オブジェクトは Knowledge__kav としてリストされます。

c.[参照...] をクリックし、エクスポートの結果として作成される .csv ファイルの場所とファイル名を選択します。[次へ >] をクリックします。

d. エクスポートの項目を選択します。ID と、更新の対象である標準項目またはカスタム項目をすべて含めたことを確認します。

注意: ArticleType__kav Classic オブジェクトまたは Lightning の Knowledge__kav オブジェクトに対して、データローダを使用してエクスポートを実行する場合、クエリの実装に関するいくつかの制限があります。「Id = [1 つの ID], Id IN [ID のリスト] または PublishStatus = [状況]」の構文を使用して絞り込みを行う必要があります。また、PublishStatus は最上位の AND 条件でのみ許可されます。それ以外の場合、次のエラーが表示されます。
 
'MALFORMED_QUERY: Implementation restriction: When querying or searching the Documentation__kav object, you must filter using the following syntax: Id = [single ID], Id IN [list of ID's] or PublishStatus = [status]. (MALFORMED_QUERY: 実装の制限: Documentation__kav オブジェクトをクエリまたは検索する場合、「Id = [1 つの ID], Id IN [ID のリスト] または PublishStatus = [状況]」の構文を使用して絞り込む必要があります。)In addition PublishStatus is only permitted in a top-level AND condition. (また、PublishStatus は最上位の AND 条件でのみ許可されます。)'
 
制限を満たすには、クエリに次の条件を追加できます。 

PublishStatus = 'Draft' AND Language = 'en_US'
 
知識ベースで複数の言語がサポートされている場合、この Language 条件で使用できる言語コードのリストをドキュメント「サポート言語」で確認できます。

e. 項目の選択に満足し、上記の説明に従って条件を追加したら、[完了] をクリックします。
 

2.任意のアプリケーションを使用して、結果のエクスポートファイルを外部で操作する

 
注意: Salesforce は Microsoft Excel 機能をサポートしていません。また、これはデータ管理または操作タスクの実行に関するポリシーに違反します。次の例は、データを準備するユーザ向けの一般的な例またはガイドであり、サポート部門がこれをユーザの代わりに実行することはできません。

記事にリッチテキストエリア (RTA) 項目が含まれる場合、その項目の列にリッチテキスト項目用の HTML コードが含まれます。互換性のある HTML タグのリストについては、「リッチテキストエディタ」ドキュメントの「サポートされる HTML タグと属性」セクションを参照してください。

たとえば、ナレッジ記事の埋め込み画像 URL へのハードコード化された参照を更新する必要があるとします。結果のエクスポートファイルでは、画像例のカスタム RTA 項目の 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. データローダを開いて、[Update(更新）] をクリックします。

b.[Show all Salesforce objects] にチェックをし、適切な ArticleType__kav オブジェクトを選択します。ArticleType は、Classic ナレッジでは記事の記事タイプ名、Lightning Knowledge では Knowledge__kav になります。

c.[Browse...] をクリックし、ステップ 2 で外部で作成した更新済みファイルを選択します。[開く]、[Next>]、[OK] をクリックします。

d.[Create or Edit a Map] をクリックし、[Auto-Match Fields to Columns] を選択するか、ID 項目と更新する項目を手動で対応付けます。[OK] をクリックします。対応付けが適切であることを確認し、[次へ >] をクリックします

e. [Browse...] をクリックし、成功ファイルとエラーファイルの保存場所を選択します。[Finish] をクリックします。

f.警告を確認し、続行する準備が整ったら [はい] をクリックします。
 

関連情報:

アイデア: Mass edit published articles (公開記事の一括編集)
ナレッジ記事番号

000381649

 
読み込み中
Salesforce Help | Article