詳細情報:
データ調整の制限事項
テンプレートを設定する前に、データ True-Up トークンの命名、テンプレート形式、サポートされる機能、編集機能に関する制限事項を確認してください。これらの制限は、トークンの動作、レコードの更新、テンプレートの互換性に影響します。
DT トークンの一般的なルールと制限事項
- データの調整では、次の項目はサポートされません。
- DT トークン名の特殊文字。
- DT トークンのデータ変換。
- RTB、HYP、IMG DT トークン。
- Marked 句を含む句内の DT トークン。セクション内に DT トークンを作成できます。
- ヘッダーまたはフッター内に配置される DT トークン。
- セクションまたは条項のヘッダーとタイトル内に配置される DT トークン。
- データの調整では、次の機能がサポートされます。
- セクションとその項目トークンで DT_ プレフィックスが使用されている場合の品目トークンの繰り返し。
- DT_ プレフィックスを使用する場合、1 レベルの深さまでの関連オブジェクト項目のネストされた DT トークン。
- 文書内の最大 1,000 DT トークンと最大 2,000 DT 品目トークン。
- DT トークンの動作とドキュメントへの影響:
- tokenMap の最上位で DT トークンを定義する必要があります。
- DT_ プレフィックスを含む DT トークンのみを認識します。
- ダウンロードしたドキュメントで DT トークン値を含む行を削除すると、関連付けられたコンテンツ境界が削除される場合があります。
- 変数 DT トークンと品目 DT トークンには一意のトークン名を使用します。これにより、データ調整で各トークン種別が正しく区別され、調整されます。
- Microsoft 365 アドインからドキュメントをチェックインすると、[データ調整] パネルが無効になります。
品目トークンの要件
- データ調整で品目を処理するには、品目セクションのメインノードと項目トークンの両方で DT_ プレフィックスを使用します。
- 品目はセクション内に配置しないでください。テンプレートでは専用の繰り返し品目領域を使用します。
- 文書内の複数のテーブルに対応付けられている品目の DT_ プレフィックストークン名の一貫性を維持します。
- 関連するすべての品目で品目の同期状況を集計します。
ネストされた関連オブジェクトトークン
- DT ネストされたトークンでは、関連オブジェクトの 1 レベルのみがサポートされます。より深いネストされた参照はサポートされていません。
- データ調整では、ネストされたオブジェクト項目は 1 対 1 の対応付けでのみ調整されます。1 対多のリレーションでは品目を使用します。
テンプレートの互換性
- ドキュメントテンプレートはドキュメント生成 2.0 でのみ機能し、高度なドキュメント生成 API バージョン種別が必要です。
- ドキュメント生成時のデータ True-Up トークン データのマージは、Salesforce Contracts でのみ機能します。
- DOCX テンプレートのみがサポートされます。PPTX ファイルと PDF ファイルには互換性がありません。
- ドキュメントテンプレートの目次では DT トークンはサポートされません。
- DT 項目を含むドキュメントを別の組織または別の契約オブジェクトからインポートしないでください。DT トークンは、その生成元の契約オブジェクト、または OmniStudio データマッパーまたはコンテキストサービスの ObjectId 項目で指定されたオブジェクトを参照します。
データソースの互換性
- データのソースがデータマッパーであり、形式を使用して変換されている場合、カスタム日付形式はサポートされません。デフォルトの日付形式のみがサポートされます。
- データ調整では、中間書式を使用せずにデータベース値を使用して値を取得します。ドキュメントの書式設定は調整値に影響しません。
- 数値、パーセント、通貨などの数値項目の場合、項目で定義された桁数よりも小数点以下の桁数が多いと、入力規則の警告が表示されますが、丸めることなく文書に保存できます。
編集と書式設定
- 生成されたドキュメントの DT トークン値はロックされ、Microsoft 365 Word アドインの [値を編集] オプションを介してのみ編集できます。
- 日付型の DT トークンでは、表示形式の変更 (YYYY/MM/DD や MM/DD/YYYY など) がサポートされます。デフォルトの形式は YYYY-MM-DD です。
- レビュー担当者は、[値を編集] オプションを使用して DT トークン値を更新する前に、既存のドキュメントの変更を受け入れるか却下する必要があります。
アクセス要件
- 自動採番項目では、レコードの更新機能はサポートされていません。
- 調整とレコード更新のために DT トークンで参照される項目には、項目レベルセキュリティの「参照」および「編集」アクセス権が必要です。
- Partner Community ユーザーは、[プライバシーとセキュリティ] でブラウザーのプライバシー設定の [ブラウザーのプライバシー] がカスタムに設定されている場合、Firefox と Safari でのみ Microsoft 365 アドインで文書を開くことができます。この設定がないと、アドインアクセスはサポートされません。また、Microsoft 365 のデータ調整を使用するには、項目レベルセキュリティ (FLS) アクセス権も必要です。 必要なアクセス権がない場合、チェックインおよび更新アクションはサポートされません。
ガイドライン (制限なし)
- [値を編集] ウィンドウからロックされた項目を編集することはできません。ウィンドウのコピーオプションを使用して、レコード値をドキュメント値に同期します。
- [項目の更新] を開始する前に [値を取得] を実行し、すべてのトークンの状況に最新の Salesforce データが反映されることを確認します。
- DT トークンが編集できない項目を参照している場合、レコードの更新を開始する前にその項目の値を再取得します。
- 調整の前に [データの積み上げ集計] パネルから個々の DT トークンを削除できます。
- レコード ID の項目で [値を取得] または [項目を更新] で入力規則エラーが発生した場合、データ調整ではそのレコード ID の項目は更新されません。
- DT トークンの書式設定は、次の条件を満たした場合、生成されたドキュメントで保持されます。
- 書式設定は、{{ から } までのトークン全体に適用する必要があります。
- 書式はトークン全体で統一する必要があります。トークンの一部を異なる方法で書式設定することはできません (例: 半分太字、半分斜体)。
- 太字、斜体、下線、フォント (書体)、フォントサイズの書式設定オプションのみがサポートされます。必要に応じて、その他の書式設定オプションを追加できます。
- トークンに書式設定が適用されていても、Microsoft 365 Word アドインの [値を編集] オプションを使用して DT トークン値を編集できます。
