Salesforce Knowledgeは、企業のマーケティング、販売、コマースのニーズを支援するオンラインコンテンツ管理システムです。このコネクタは、Salesforce KnowledgeのClassicバージョンとLightningバージョンの両方に対応しています。
プロジェクトのソース言語は、ナレッジ設定で構成されたSalesforce Knowledgeのデフォルト言語と一致している必要があります。Salesforceの英語は、実際には英語（米国）の完全なロケールです。
このコネクタは、文字列またはテキストエリアのデータ型を持つすべての更新可能なフィールドをインポートします。
このコネクタは、最新のSalesforceセキュリティ要件に準拠しており、PKCE、リフレッシュトークンのローテーション、30日間のアイドル状態のトークン有効期限、およびIP許可リストをサポートしています。
備考
2022年11月1日現在、このコネクタは継続的なローカリゼーションワークフローをサポートしています。これらのワークフローを使用する場合、既存のコネクタを変更しても機能は有効になりません。新しいコネクタを作成する必要があります。
コネクターにはいくつかの使用例があります。
-
プロジェクトマネージャは、ファイルをオンラインリポジトリからプロジェクトに直接追加できます。コネクタのソース言語と一致するドキュメント、または言語が設定されていないドキュメントのみが一覧表示されます。
-
サブミッターポータルをセットアップして、サブミッターがオンラインリポジトリから直接リクエストにファイルを追加できるようにします。コネクタのソース言語と一致するドキュメント、または言語が設定されていないドキュメントのみが一覧表示されます。
-
プロジェクト自動作成（APC）を使用して、監視対象のファイルまたはフォルダの最終更新日の変更が検出されると、新しいプロジェクトが自動的に作成されます。
ソース記事の翻訳
記事の作成者が手動で翻訳をトリガーできるようにするには、Salesforce Knowledgeで特定のフィールドを定義または作成します。これらのフィールドは、Phraseコネクタが翻訳ワークフローをトリガーおよび追跡するために使用されます。既存のフィールドを使用するか、必要に応じてカスタムフィールドを作成します。
必須フィールドマッピング
Salesforce KnowledgeとPhrase TMS間の適切な通信を確保するには、以下のフィールド設定が必要です。
-
翻訳リクエストのトリガー
-
目的
翻訳対象とする記事を定義します。
-
設定
特定の値を保持するフィールド（例：
Workflow_stage__c）を作成または指定します（例：「Translate」）- 推奨タイプ：選択リスト。 -
コネクタのマッピング：
Phrase TMSで、このフィールドをマッピングし、指定された値を持つ記事のみ翻訳がトリガーされるようにします。
-
-
翻訳進捗の追跡
-
目的
翻訳プロセス中に記事のステータスを自動的に更新します。
-
設定
上記と同じフィールドを使用するか、別のフィールドを作成します。
-
コネクタのマッピング：
翻訳が開始されたときに、このフィールドの値をのような値に設定するようにPhrase TMSを構成します。
-
-
翻訳完了の通知
-
目的
翻訳が完了したことをユーザーに通知します。
-
設定
上記と同じフィールドを使用するか、別のフィールドを作成します。
-
コネクタのマッピング：
翻訳がSalesforceにプッシュバックされたら、このフィールドの値をのような値に設定します。
-
-
自動プロジェクト作成（APC）のターゲット言語の定義
-
目的
記事の翻訳先言語を指定します。
-
設定
-
カスタムフィールド（例：
Target_Languages__c）を作成します。 -
フィールドタイプ
複数選択リスト。
-
値
ラベルではなく、言語コード（例：
fr, de, es）をAPI Namesとして使用します。
-
-
コネクタのマッピング：
Phrase TMSはこのフィールドを読み取り、選択された言語に対してのみジョブを作成します。
-
注意
カスタムドメイン（例：mydomain.phrase.jp）からアクセスする場合は、シークレットウィンドウを開き、cloud.memsource.comまたはus.cloud.memsource.comからログインして、コネクタの作成または保存に必要な認証を適用してください。保存後、カスタムドメイン経由でコネクタにアクセスできます。
-
設定
ページから、セクションまでスクロールします。
-
[コネクタ]をクリックします。
ページが開きます。
-
New connectorをクリックします。
ページが開きます。
-
TypeをSalesforce Knowledgeに変更し、コネクタの名前を入力します。
-
ホスト名を入力します。
-
必要に応じて、フィールド値に基づいて記事を翻訳するタイミングを定義します。
-
必要に応じて、最初の翻訳がエクスポートされたときに選択した値（例：translation ready）に変更されるソース記事内のフィールドを定義します。
-
必要に応じて、翻訳後のフィールド値を定義します。
-
翻訳のステータスを選択します。
-
を指定します。
自動プロジェクト作成は、フィールド名（例：
Target_Languages__c）で識別されるカスタムフィールドで指定された言語のジョブのみを作成します。 -
Salesforceの2桁のロケールコードをTMSの4桁のロケールコードにマッピングするようにを設定します。
-
Connect to Salesforceをクリックします。
接続が成功するとチェックマークが表示されます。そうでない場合、赤い感嘆符が表示されます。アイコンにカーソルを合わせると、詳細が表示されます。
-
保存をクリックします。
コネクターがページの一覧に追加されます。
コネクタを削除する
コネクタを削除するには：
-
ページから、削除するコネクタを選択します。
-
Deleteをクリックします。
ウィンドウが開きます。
-
「delete」と入力し、Deleteをクリックします。
コネクタが削除され、コネクタのリストが表示されます。
備考
プロジェクト内の未完了のジョブ（ごみ箱にあるジョブを含む）にまだリンクされているコネクタは削除できません。そのようなコネクタを削除しようとすると、「Failed to delete connector」エラーが返されます。
解決策:コネクタに関連付けられているプロジェクトを開き、残っているジョブを完了または削除してください。に移動し、コネクタにまだリンクされているジョブを削除するために空にします。コネクタの削除を再試行してください。
再認証時の一般的なOAuthエラーの解決
コネクタを再認証するには、PhraseでSalesforce Knowledgeコネクタの設定を開き、と表示されているコネクタを開いて、Salesforceへのアクセスを再承認します。
エラーWe can't authorize you because of an OAuth errorおよびコードOAUTH_APPROVAL_ERROR_GENERICで再認証が失敗した場合は、一時的に発生する可能性があるため、しばらくしてから認証を再試行してください。
invalid_client: app must be installed into orgというエラーで再認証が失敗した場合は、Phrase Salesforce Knowledge Connector接続アプリがSalesforce組織にインストールされていません。これを解決するには、Salesforce管理者が以下の操作を行う必要があります。
-
Salesforceの[設定]で、またはに移動し、Phrase Salesforce Knowledge Connectorがインストール済みとして表示されているかどうかを確認します。
-
表示されない場合は、から、またはアプリのインストールURLからインストールしてください。
-
接続アプリのOAuthポリシーが、関連するユーザーのプロファイルや権限セットを割り当てずに「Admin approved users are pre-authorized（管理者が承認したユーザーは事前承認済み）」に設定されていないことを確認してください。これでも同じエラーが発生するためです。
-
Phraseから再認証を再試行してください。
Salesforce管理者は、接続アプリをインストールするために十分な権限が必要です。インストール中に権限に関する問題が発生した場合、Salesforce組織内でその問題をエスカレーションする必要がある可能性があります。