帳票DX for Salesforce(document DX) リリースノート
帳票DX for Salesforce(document DX) リリースノート2024/04/24 パッケージ「v1.75.0」を作成しました。2024/04/23 パッケージ「v1.74.0」を作成しました。2024/04/23 パッケージ「v1.73.0」を作成しました。2024/03/18 パッケージ「v1.68.0」を作成しました。v1.58.0以降へのアップデートの前に以下を確認して下さい。機能追加既存機能の調整2023/11/06 パッケージ「v1.51.0」を作成しました。2023/10/02 パッケージ「v1.43.0」を作成しました。2023/08/31 パッケージ「v1.35.0」を作成しました。2023/08/04 パッケージ「v1.31.0」を作成しました。2023/07/20 パッケージ「v1.28.0」を作成しました。2023/07/14 パッケージ「v1.27.0」を作成しました。2023/05/25 パッケージ「v1.17.0」を作成しました。2023/05/19 パッケージ「v1.16.0」を作成しました。2023/05/10 パッケージ「v1.15.0」を作成しました。2023/04/25 パッケージ「v1.14.0」を作成しました。2023/04/24 パッケージ「v1.13.0」を作成しました。2023/04/19 パッケージ「v1.12.0」を作成しました。2023/04/18 パッケージ「v1.11.0」を作成しました。2023/03/15 パッケージ「v1.6.0」を作成しました。
2024/04/24 パッケージ「v1.75.0」を作成しました。
ドキュメント作成の際に「出力履歴」を作成しますが、その際に「リクエストエンティティ」欄に格納する文字列が許容サイズをオーバーする場合、切り詰めた上で格納するように変更しました。
2024/04/23 パッケージ「v1.74.0」を作成しました。
v1.68.0以降、ALA、XALAでの認証を行えない状態になっていた問題を修正しました。
v1.68.0 にて認証処理の大幅な見直しを行いましたが、その際にALA、XALAでの認証を行えない状態になっておりました。
適切にALA、XALAでも認証できるように修正しました。
2024/04/23 パッケージ「v1.73.0」を作成しました。
親、明細1、明細2にて、同一のオブジェクトを利用できるように変更しました。
項目選択画面で「保存」ボタンを押した際のチェック処理を修正しました。
従来は同一オブジェクトの同一項目を複数箇所で利用している場合にエラーとしていましたが、利用している場所に親、明細1、明細2の違いがある場合はエラーとしないように修正しました。テンプレートに設定を反映する際に、オブジェクト名が重複している場合は、オブジェクト名の末尾に「(連番)」を付加した上で反映するように変更しました。
ボタンや出力定義にてエラー条件を指定する際に、値が空であるかを判定する事を可能にしました。
ボタンや出力定義の作成画面の「エラー条件」タブにて、「比較する値」を空欄にする事ができず、値が空であるかを判定する事が出来ませんでした。「比較」列で「一致しない」か「一致する」を選んでいる場合は、「比較する値」が空欄でもエラーとしないよう修正しました。
エラーメッセージの調整を行いました。
認証失敗時のエラーメッセージを変更しました。
変更前：CID/UID/UPWに誤りがあります。
変更後：認証が失敗しました。(詳細なメッセージ)
OPROARTS認証情報が未登録の状態で、エクスポートやインポートを行った際のエラーメッセージを変更しました。
変更前：... 無効なパラメータです。Salesforce関連のパラメータが不正です。 ...
変更後：OPROARTS認証情報が取得できませんでした。認証情報が登録されているか確認して下さい。: (詳細)
2024/03/18 パッケージ「v1.68.0」を作成しました。
v1.58.0以降へのアップデートの前に以下を確認して下さい。
v1.58.0 にて大幅な変更が加えられています。v1.58.0 よりも過去のバージョンがインストールされている組織にて、v1.58.0以降のバージョンにアップデートする場合は、以下の変更点について問題が無いかご確認頂く必要があります。
「出力確認」画面と、「URL(カスタムリンク)」形式のボタンで、「ダウンロード」や「ワーク実行」を実行した場合の動作が変わります。
従来は画面上にプログレスバーが表示され、ポップアップウィンドウを表示せずに処理していました。
今後は、ポップアップウィンドウが表示され、そこでドキュメントの生成をリクエストする動きに変わります。「Visualforce(Salesforce アクション)」形式のボタンでドキュメントを出力する場合と同様の動作です。
認証の方式を変更した関係で当変更を加えています。
ドキュメントの生成、D³Worker連携、インポート、エクスポートを行う際に、初回のみ、「アクセスを許可しますか？」の確認が表示されます。「許可」をクリックして下さい。
以後のドキュメントの生成、インポート、エクスポートの際には、自動的に許可されます。
ただし、同一の組織に関して、ブラウザ上に複数のログイン情報が記録されている場合、都度ログインを求められます。
それを避けるためには、ログイン画面の上部にある「○件の保存されたユーザ名」部分をクリックし、利用するユーザを1件のみ残して、他は除去して下さい。
以下の条件を満たす場合に、「スケジュール」を指定したD³Worker連携を行う事が出来なくなります。
以下全ての条件を満たす場合、「出力タイミング」欄の「スケジュール」が選択不能になります。認証の方式を変更した関係で当変更を加えています。
D³Worker連携
「出力確認」画面か、「URL(カスタムリンク)」形式のボタンを利用
「項目編集」画面にて「システム」内の「セッションID」を送信する項目として選択している
カスタム設定「D3Worker API URL」の読込み方法を修正しました。
階層カスタム設定によって、ユーザやプロファイル単位でカスタム設定を設けていて、かつ「D3Worker API URL」に組織の設定と異なる設定を行っていた場合の振る舞いが変わります。従来は、組織の設定を優先して適用していました。
今後は、ユーザやプロファイル単位で設定された値を優先して適用します。
カスタム設定「Docutizeb Moderator URL」を追加しました。
インストール直後に自動的に値が設定されます。
v1.58.0 の場合は、
https://docutize.oproarts.com/docutizeb/oauthが設定されます。v1.68.0 の場合は、「OPROARTS Docutizeb URL」の値に沿って、適切な値が自動的に設定されます。
個別ドメインをご利用の場合等、既存の「OPROARTS Docutizeb URL」に標準と異なる値を設定している場合は、値の末尾の「/action」を「/oauth」に書き換えた値を「Docutizeb Moderator URL」に設定して下さい。
例えば、「OPROARTS Docutizeb URL」に
https://[ドメイン名].oproarts.com/docutizeb/actionと設定している場合、「Docutizeb Moderator URL」には
https://[ドメイン名].oproarts.com/docutizeb/oauthを設定してください。
機能追加
ヘッダー明細型のD³Worker連携で、「Visualforce(Salesforce アクション)」形式のボタンを生成する際に、パラメーターとして「multiIdRequest」を含めたコードを生成するように変更しました。
multiIdRequest : false、あるいは無指定の場合、親オブジェクト1レコード毎にD³Workerへ連携します。従来の動作です。
multiIdRequest : true の場合、全レコードをまとめて1度でD³Workerに連携します。ボタンを新規生成する際に、今回のバージョンから当パラメーターに true が指定された形で生成されます。
「Visualforce(Salesforce アクション)」形式のボタンを生成する際に、対応するVisualforcePage内のJavaScriptに対して、パラメーターとして「successUrl」を指定するサンプルコードを含めるように変更しました。
successUrl にはURLを指定します。指定されている場合、ドキュメント生成処理やD³Worker連携が完了した後で、指定されたURLへ自動的に遷移します。
生成直後は該当する行がコメントアウトされています。冒頭の「//」を削除して利用して下さい。
当機能は以下の場合に利用できます。
ドキュメント生成系で、かつ「メモ＆添付ファイル保存」の場合 (ダウンロード系の場合は利用できません)
D³Worker連携の場合
ボタン生成画面と出力定義作成画面に以下の設定項目を追加しました。
文中の「対応するJSパラメーター」は、「Visualforce(Salesforce アクション)」形式のボタンを生成する際に、対応するVisualforcePage内のJavaScriptに適用されるパラメーターを指します。出力定義を生成する際の「追加のパラメーター」にも同名属性で反映されます。
「添付ファイルの参照先 ID」欄
生成するドキュメントを、指定したオブジェクトIDのレコードに紐づけます。
対応するJSパラメーター：attachTo
「出力定義」に関連する「帳票DXアクション」のレコードを作成する際に「添付ファイルの参照先 ID」で指定する事も可能です。
項目の表示条件は以下の通りです。
D³Worker連携系の場合、当設定項目は表示されません。
ドキュメント出力系(PDF等)の場合
ボタン生成画面の場合
「出力方法」として以下のいずれかを指定した場合に指定可能になります。
メモ＆添付ファイル保存
メモ＆添付ファイル保存＋ダウンロード
出力定義作成画面の場合
「出力方法」として以下のいずれかを指定した場合に指定可能になります。
帳票DXアクションか任意レコードに添付(個別に添付)
帳票DXアクションか任意レコードに添付(複数時zip圧縮)
「添付ファイルの所有者 ID」欄
生成するドキュメントに紐づく添付ファイルやSalesforce Filesのレコードの所有者を誰にするかをオブジェクトIDで指定できます。
対応するJSパラメーター：attachOwnerId
「出力定義」に関連する「帳票DXアクション」のレコードを作成する際に「添付ファイルの所有者 ID」で指定する事も可能です。
項目の表示条件は以下の通りです。
D³Worker連携系の場合、当設定項目は表示されません。
ドキュメント出力系(PDF等)の場合
ボタン生成画面の場合
「出力方法」として以下のいずれかを指定した場合に指定可能になります。
メモ＆添付ファイル保存
メモ＆添付ファイル保存＋ダウンロード
出力定義作成画面の場合
常に表示します。
「ZIPファイル名」欄
zipファイルを生成する際のファイル名を指定する事ができます。
対応するJSパラメーター：zipFileName
拡張子は記載不要です。ドキュメント生成の際に、自動的に「.zip」が付加されます。
#\/:*?"<>|,;は、ドキュメント生成時に_に置換されます。
項目の表示条件は以下の通りです。
D³Worker連携系の場合、当設定項目は表示されません。
ドキュメント出力系(PDF等)の場合
ボタン生成画面の場合
「出力方法」として以下のいずれかを指定した場合に指定可能になります。
ダウンロード
メモ＆添付ファイル保存＋ダウンロード
詳細ページボタンか、リストボタンかは問いません。「出力パターン」タブにて複数の「設定」を組み合わせて出力するように指定した場合、詳細ページボタンであっても複数のドキュメントが生成され、zipファイルが作成されるためです。
出力定義作成画面の場合
「出力方法」として以下のいずれかを指定した場合に指定可能になります。
帳票DXアクションか任意レコードに添付(複数時zip圧縮)
Task(活動履歴)を作成する際に、件名と本文を任意に指定できるように変更しました。
画面上には設定項目を設けていません。生成されたJavaScriptを加工するか、帳票DXアクションにて条件を指定して下さい。「Visualforce(Salesforce アクション)」形式のボタンを生成する際に、対応するVisualforcePage内のJavaScriptに対して、パラメーターとして以下を指定するサンプルコードを含めるように変更しました。
taskSubject：生成する活動履歴の件名。
taskComment：生成する活動履歴のコメント。
「出力定義」に関連する「帳票DXアクション」のレコードを作成する際に、以下を指定可能にしました。
活動履歴の件名：生成する活動履歴の件名。
活動履歴のコメント：生成する活動履歴のコメント。
既存機能の調整
ファイル名の字数上限を変更しました。
従来は、拡張子部分を除た最大の字数が、70 でした。
今後は、UTF-8 換算で 250byte以内 になります。
出力確認画面や「URL(カスタムリンク)」形式のボタンから、ヘッダー明細型のD³Worker連携を、複数レコードを選択して実行した場合に、先頭レコードしか処理されない問題を修正しました。全てのレコードを処理します。
「設定」の名前に「/」を含めるのを許容しないように変更しました。
「設定」の新規作成画面と、インポートの際に、名前に「/」が含まれているかをチェックします。
「連携履歴」内の「ログ取得」機能を修正しました。D³Workerの対象ジョブにエンベロープの履歴が1件も含まれない場合の処理を修正しました。
従来は「Attempt to de-reference a null object」のエラーが発生していました。
今後は「D³Workerの該当ジョブにてエンベロープが1件も処理されませんでした。」の内容で「連携履歴.エラーメッセージ」欄を更新します。
「連携履歴.ステータス」を「失敗」に更新するように変更しました。従来は更新していませんでした。
「連携履歴.エンベロープ数」を「0」で更新するよう変更しました。従来は更新していませんでした。
ボタン生成の際に自動生成するVisualforcePage内のJavaScriptについて、window.alert, window.confirm を利用しないように変更しました。
window.alert, window.confirm は、将来的にGoogle Chromeが表示を許容しないように変更される見込みです。
同様の振る舞いをする別の機構を用いるように変更しました。ダイアログの見た目が変化します。
当変更は、当バージョンを適用した後で生成したボタンのみに適用されます。過去のバージョンで生成したボタンの自動的な変更は行いません。過去に作成したボタンのコードについては、手動で変更する必要があります。
ボタン生成の際に、「ボタンを設置する場所」として「リストボタン」を選択して生成した場合、確認ダイアログを表示するコードを生成するよう変更しました。
処理を実行する前に「n件のレコードに対して実行します。」の確認ダイアログを表示します。
このダイアログが不要の場合は、該当するVisualforcePage内の以下の行をコメントアウトして下さい。
1var confirmMessage = needCheck ? '{!JSENCODE($Label.docutizexa__ACTION_BUTTON_VF_RUN_CONFIRM)}' : '{!JSENCODE($Label.docutizexa__ACTION_BUTTON_VF_RUN_CONFIRM_MASTER_LIST)}';2if(!(await OPROARTS.Dialog.confirm(confirmMessage.replace('{0}', ids.length)))){3window.history.back();4return;5}
ボタン生成の際の「出力方法」欄について、一覧型の場合は「メモ＆添付ファイル保存＋ダウンロード」を選択できないように修正しました。
連携履歴画面の「ログ取得」機能を修正しました。
D³Workerの対象ジョブにエンベロープの履歴が1件も含まれない場合、
従来は「Attempt to de-reference a null object」のエラーが発生していました。
今後は「D³Workerの該当ジョブにてエンベロープが1件も処理されませんでした。」の内容で「連携履歴.エラーメッセージ」欄を更新します。例外が発生した場合や、エンベロープの履歴が1件も含まれない場合の、連携履歴の更新処理を以下の通り変更しました
「連携履歴.ステータス」を「失敗」に更新するように変更しました。従来は更新していませんでした。
「連携履歴.エンベロープ数」を「0」で更新するよう変更しました。従来は更新していませんでした。
複数ドキュメントを一括して生成する際に、ファイル名が重複する場合は末尾に連番を自動的に付加する事で、重複を避けるように変更しました。
従来はファイル名の重複が生じた場合はエラーが生じていました。以後は出力可能になります。
ファイル名が重複したファイル群のうち、最初のファイルには連番を付加しません。
重複を判定する際に、ファイル名の大文字・小文字の違いは無視します。
重複を判定する際に、拡張子の違いは無視します。
「OPROARTS(帳票DX)」内の「OPROARTSユーザ（帳票DX）」の一覧画面について、件数が多い場合に表示されるページ遷移ボタンが適切に動作しない問題を修正しました。
2023/11/06 パッケージ「v1.51.0」を作成しました。
「項目編集」画面の「項目一覧」に「システム」「組織」「出力ユーザー」を追加しました。
システム：D³Worker連携の場合にのみ表示します。
D³Worker連携にて、「 - セッション」が付いているSalesforce Filesサービスを利用する場合、Salesforceの「セッションID」「組織ID」「ユーザID」「インスタンスURL」の4つの情報が必要になります。従来はそれらを獲得するためのカスタム数式項目を出力対象オブジェクトに追加する必要がありましたが、今後は追加不要になります。
https://spc.opro.net/hc/ja/articles/900000316463組織：組織に関する情報を獲得できます。
出力ユーザー：ドキュメントを出力するユーザに関する情報を獲得できます。
「帳票DXアクション」を利用してドキュメントを出力する場合、アウトバウンドメッセージの実行者が出力ユーザーとなるためご注意下さい。
OPROARTS Designerの場合は、「ユーザ情報」の配下に「Profile」「ロール」の欄がありましたが、帳票DX for Salesforceでは「出力ユーザー」の配下の「ロールID」「プロファイルID」の参照を辿る事で同等の値を得る事ができます。
「出力パターン」のタブを、「ボタン生成」画面と「出力定義作成」画面に追加しました。
「出力パターン」を指定する事で、特定の条件に該当する場合に、任意の「設定」を組合せてドキュメントを出力する事ができます。
パターンを複数定義する事ができます。「パターン追加」ボタンを押す事で、パターンを先頭に追加する事ができます。
末尾のパターン(パターン1)では条件を指定できません。他のパターンで指定した条件にマッチしない場合に適用されます。
「設定の組み合わせ」または「設定」の欄で、利用する設定を指定する事ができます。
D³Worker連携の場合は、D³Workerの「設定」のみが選択可能です。
D³Worker連携以外の場合は、D³Worker連携以外(PDF, Excel, Word, PowerPoint )の「設定」を任意の組み合わせで指定できます。
PDFの「設定」を連続して指定した場合、1つのPDFファイルとして統合して出力します。
Excel, Word, PowerPointの場合、1つの「設定」につき、1つのファイルを出力します。
「条件」で、パターンを適用する条件を指定する事ができます。
条件を2件以上指定する場合、以下の選択肢が表示されます。
「全ての条件を満たした場合に適用」：既定値。全ての条件を満たす場合にのみパターンに合致すると判断します。(全件AND)
「条件の組合せを式で指定」：式を指定する事で任意の判定を行う事ができます。OR条件を利用したい場合はこちらを選択して下さい。
「エラー条件」タブで指定した条件に該当した場合はエラーになります。「エラー条件」の判定が優先されます。
タブの並びが「エラー条件」「出力パターン」「出力後更新処理」の順になっていますが、この順で出力対象レコードを判断し、処理します。
「条件保存」ボタンを押すと、設定の状態が一時的に記録されます。
エラーがある場合は、エラーメッセージが表示されます。エラーがある場合であっても、設定状態は記憶されます。
設定状態は「設定」内の項目に記録されます。
「ボタン生成」あるいは「出力定義作成」ボタンを押すと、生成が実施されます。
生成されたVisualforceや出力定義レコード内に「pattern」の項目が設けられ、画面上で設定した内容が反映されます。
「メモ&添付ファイル保存＋ダウンロード」を、「ボタン生成」画面の「出力方法」欄に追加しました。
生成したドキュメントをSalesforce上に保存すると同時に、そのファイルがブラウザにてダウンロードされる機能です。
二重にドキュメントを生成する事はありません。ドキュメント生成機能を提供するglobalメソッドを追加しました。
Apex上に以下のようなコードを記述する事でドキュメントを同期的に出力する事ができます。
xxxxxxxxxx11docutizexa.GenerateResult result = new docutizexa.DocumentGenerator().generate('利用する「出力定義」のID', new List<String>{'出力対象とするレコードのID'});
具体的な利用方法は こちら を参照して下さい。
「帳票DXアクション」の処理結果をApex上で解釈するglobalメソッドを追加しました。
Apex上に以下のようなコードを記述する事で、「帳票DXアクション」の「結果」欄に出力されたJSONをインスタンスとして解釈するする事ができます。「帳票DXアクション」が完了した後の処理を実装する際に役立ちます。
x1// ドキュメント生成を行った「帳票DXアクション」の結果を解釈する場合2docutizexa.GenerateResult result = docutizexa.GenerateResult.parseFromAction('結果を調査したい帳票DXアクションのレコードのID');3// D³Worker連携を行った「帳票DXアクション」の結果を解釈する場合5docutizexa.D3WorkerActionResult result = docutizexa.D3WorkerActionResult.parseFromAction('結果を調査したい帳票DXアクションのレコードのID');
具体的な利用方法は こちら を参照して下さい。
D³Worker連携の際に「D3W」以外の認証情報を必要とする問題を修正しました。
画像のIDをURLに変換する処理を実施する際に「LA」の認証情報を要求していました。
「D3W」の認証情報で処理するように修正しました。活動履歴の作成が失敗した場合のエラーメッセージを具体的なものに変更しました。以下のメッセージを表示します。
活動履歴の作成が失敗しました。オブジェクト[(オブジェクト名)]の「活動の追跡」が有効になっているか確認して下さい。あるいはカスタム設定「document DX Static Setting」の「活動登録ON」のチェックを解除して下さい。「レイアウト」が未作成である事が分かりやすくなるようにするため、ボタンの配色を変更しました。 「設定」の詳細画面にて、「レイアウト」ボタンが一度もクリックされていない場合、「出力確認」「ボタン生成」「出力定義作成」のボタンを白色で表示するよう変更しました。
zipに圧縮してダウンロードする際のファイル名の命名方法を変更しました。
従来は、出力元として利用した「設定」の名前 + "_" + 出力日時(yyyyMMddHHmmss) + ".zip" でした。
「出力パターン」機能を追加した事によって、ボタンや出力定義の作成元となった「設定」と、実際に利用される「設定」とがマッチしない場合が生じる場合がある事から、以下のように変更しました。
パラメーター「zipFileName」が指定されている場合は、指定された値 + ".zip" をzipファイルの名前として適用します。
ボタンからの出力の場合は、ボタンに紐づくVisualforcePage内のJavaScript中に指定する事で反映されます。
帳票DXアクションからの出力の場合は、「出力定義」内の「追加のパラメーター」内のJSONに要素を足す事で反映されます。
今後のバージョンにて、画面上でzipファイル名を指定可能にする見込みです。
上記に該当しない場合、zipファイルの内容物のうち、最初に出力されたファイルの名前の拡張子を「zip」に変更したものを、zipファイルの名前として適用します。
添付先として任意のオブジェクトを指定可能にしました。
パラメーター「attachTo」にオブジェクトIDを指定する事で、任意のレコードに対して生成したドキュメントを添付するよう指定する事が可能です。
ボタンからの出力の場合は、ボタンに紐づくVisualforcePage内のJavaScript中に指定する事で反映されます。
帳票DXアクションからの出力の場合は、「出力定義」内の「追加のパラメーター」内のJSONに要素を足す事で反映されます。
今後のバージョンにて、画面上で添付先を指定可能にする見込みです。
「出力履歴」の「メッセージ」に対して、詳細な処理結果を出力するように変更しました。
D³Worker連携かつヘッダー明細型を利用し、完全に同一の式が複数存在する場合に、エラーが生じる問題を修正しました。
2023/10/02 パッケージ「v1.43.0」を作成しました。
「ボタン生成」画面の一部表記を変更しました。
ボタンの種類 → コンテンツリソース(ボタンの種類)
アクション → Visualforce(Salesforce アクション)
リンク → URL(カスタムリンク)
アウトバウンドメッセージを用いて、自動的なドキュメント生成、D³Worker連携が実施可能になりました。
導入方法について
自動的な処理を行わせるユーザーを準備します。
アウトバウンドメッセージを利用する場合、画面上で操作するユーザーと、実際のドキュメント生成やD³Worker連携を行うユーザーは異なります。自動的な処理を行わせるユーザーを準備して下さい。
Salesforceの設定を開き、「権限セット」を検索します。
ユーザー＞権限セット を開きます。
「document DX General User Permission Set」に、自動的な処理を行わせるユーザーを割り当てます。
アプリケーションランチャーにて「OPROARTS（帳票DX）」を開きます。
LA, XLA, D3W の配下に、自動的な処理を行わせるユーザーを追加します。
ALA、AXLA は自動処理用のユーザではご利用になれません。
LA はOffice出力を行う場合に指定します。
XLA はPDF出力を行う場合に指定します。
D3W はD³Worker連携を利用する場合に指定します。
Salesforceの設定を開き、「ワークフロー」を検索します。
プロセスの自動化＞ワークフローアクション＞アウトバウンドメッセージ を開きます。
「Action Message V3」を開き、「編集」ボタンを押します。
「送信ユーザー」の欄に、自動的な処理を実際に行わせるユーザを設定し、保存します。
プロセスの自動化＞ワークフローアクション＞ワークフロールール を開きます。
「UnprocessedActiveAction」を開き、「有効化」ボタンを押します。
アウトバウンドメッセージ送信の流れについて
「帳票DX」のアプリケーションに、「出力定義」のタブを追加しています。
「出力定義」オブジェクトの子オブジェクトとして「帳票DXアクション」オブジェクトを設けています。
処理の条件は「出力定義」に記述し、処理の発動や履歴は「帳票DXアクション」が担います。
「帳票DXアクション」オブジェクトのレコードが、「有効」がチェックされ、かつ「ステータス」が「未完了」の状態になった場合に、ワークフロールールの条件を満たし、アウトバウンドメッセージが送信されます。アウトバウンドメッセージが送信され、各種処理が完了すると、「帳票DXアクション」オブジェクトのレコード内の「結果」フィールドに処理結果がJSON形式で格納されます。
「出力定義」の作成方法について
「出力定義」オブジェクトのレコードは、帳票DXの「設定」の詳細画面に追加した「出力定義作成」ボタンから作成する事ができます。
UIは概ね「ボタン生成」画面と同様ですが、以下の差異があります。アウトバウンドメッセージでの自動実行の場合、ローカルにダウンロードは出来ないため、ドキュメントを生成する場合は何らかのレコードに添付する動作になります。
「コンテンツリソース(ボタンの種類)」欄はありません。
「ボタンを設置する場所」欄はありません。
ドキュメント生成を行う「設定」の場合、「出力方法」の選択肢は以下になります。D³Worker連携の場合は、ボタンの場合と同様に、「出力方法」の欄がありません。
出力元レコードに添付
ドキュメントを出力元レコードに添付します。
ボタンで出力する場合に「メモ&添付ファイル保存」を選択する場合と同等の動作になります。
一覧型の「設定」の場合は選択できません。
帳票DXアクションに添付(個別に添付)
ワークフローの発動元となった「帳票DXアクション」のレコードに対して、生成したドキュメントを添付します。
複数のドキュメントの生成を行った場合、全てのドキュメントをzip圧縮せず個別に添付します。
一覧型の「設定」の場合は、当設定のみが利用可能です。
帳票DXアクションに添付(複数時zip圧縮)
ワークフローの発動元となった「帳票DXアクション」のレコードに対して、生成したドキュメントを添付します。
複数のドキュメントの生成を行った場合、全てのドキュメントをzipファイルに圧縮し、1ファイルで添付します。
生成されたドキュメントが1件のみの場合はzipに圧縮しません。
指定したレコード群の中に、エラー条件に該当する等して処理されなかったものが生じた場合は、zipファイル内に「failed.txt」が追加されます。当ファイル内に処理失敗したレコードの情報が記載されます。ボタンの場合に「処理種別」として「ダウンロード」を指定した場合と同様の動作です。
一覧型の「設定」の場合は選択できません。(一覧型の場合は常に1ファイルのみの生成となるため、zip圧縮が不要)
生成するドキュメントの作成先オブジェクトを「添付ファイル」にするか、あるいはSalesforceFiles(ContentDocument等)にするかは、ボタンで出力する場合と同様に、カスタム設定の「SalesforceFilesに保存」の指定に準じます。
処理の実行方法について
Salesforceの画面上で手動で処理を実行する場合は以下の手順で操作します。Salesforce Lightningを利用している前提で記載します。
「帳票DX」アプリケーションの「出力定義」タブを開きます。
任意のレコードを開きます。
「関連」タブ内の「帳票DXアクション」内の「新規」ボタンをクリックします。
レコードタイプの指定を求められた場合、「Document DX」(帳票DX)を選択します。
「レコードID」欄に、処理対象とするレコード群をカンマ区切りで指定します。
「有効」欄をチェックします。
「保存」を押します。
作成されたレコードをクリックして詳細を表示します。
正常に処理を受け付けた場合、「ステータス」が自動的に「実行中」になります。少し待ってリロードすると、「完了」になります。その際に「結果」欄に具体的な処理結果がJSONで反映されます。
Apexによってアウトバウンドメッセージを実行する例
Salesforceにて開発者コンソールを開き、Ctrl + E を押して、「Enter Apex Code」(実行匿名ウィンドウ)を開きます。
以下のコードを編集した上で貼り付けます。
xxxxxxxxxx51docutizexa__Action__c action = new docutizexa__Action__c();2action.docutizexa__IsActive__c = true; // 有効化。3action.docutizexa__RecordIds__c = '0060w00000DDGe4AAH,0060w00000DDGe9AAH'; // 処理対象レコードをカンマ区切りで指定。4action.docutizexa__OutputSetting__c = 'a0G0w000004Wc3CEAS'; // 「出力定義」のレコードのオブジェクトIDを指定。5insert action;「Execute」をクリックします。
「帳票DX」アプリケーションの「出力定義」タブを開き、該当する「出力定義」を開き、出力定義の子として新規の「帳票DXアクション」のレコードが作成されている事を確認します。「ステータス」が「完了」になる事を確認します。
処理の実行結果について
「設定」の種別や、「出力方法」によって「帳票DXアクション」の「結果」に出力されるJSONの構成が変化します。
以下にサンプルを示しますが、「//」以降は説明であり、実際には出力されません。「設定」がドキュメント出力の場合
出力方法として「出力元レコードに添付」か、「帳票DXアクションに添付(個別に添付)」を指定した場合
xxxxxxxxxx181{2"failed": [ // 失敗した処理群を配列で示す。3{4"message": "Salesforce REST API エラー:\n指定されたエラー条件に該当したため出力をスキップします。\r\n(商談対象外,エラー条件No.1)「商談対象外」はエラー。", // エラーメッセージ5"recordId": "0060w00000DETNnAAP" // 失敗したレコードのID6}7// 複数ある場合はカンマ区切りで列記する。8],9"success": [ // 成功した処理群を配列で示す。10{11"documentId": "0690w000002ABMLAA4", // 生成したドキュメントのID12"outputHistoryId": "a0F0w000003fIhzEAE", // 作成した「出力履歴」のID13"recordId": "0060w00000DDGe4AAH", // データの引用元としたレコードのID14"taskId": "00T0w00000CcnhhEAB" // 作成した活動履歴のID15}16// 複数ある場合はカンマ区切りで列記する。17]18}出力方法として「帳票DXアクションに添付(複数時zip圧縮)」を指定した場合
「出力元レコードに添付」の場合と比較して、「documentId」の出力箇所が違う点に注意が必要です。xxxxxxxxxx181{2"documentId": "0680w000002A4QnAAK", // 生成したドキュメントのID3"failed": [ // 失敗した処理群を配列で示す。4{5"message": "[error.salesforce.rest.fault(指定されたエラー条件に該当したため出力をスキップします。\r\n(商談対象外,エラー条件No.1)「商談対象外」はエラー。)]", // エラーメッセージ6"recordId": "0060w00000DETNnAAP" // 失敗したレコードのID7}8// 複数ある場合はカンマ区切りで列記する。9],10"success": [ // 成功した処理群を配列で示す。11{12"outputHistoryId": "a0F0w000003fIj2EAE", // 作成した「出力履歴」のID13"recordId": "0060w00000DDGe4AAH", // データの引用元としたレコードのID14"taskId": "00T0w00000Ccnj9EAB" // 作成した活動履歴のID15}16// 複数ある場合はカンマ区切りで列記する。17]18}
「設定」がD³Worker連携の場合
出力方法の指定欄は無し。
xxxxxxxxxx211{2"apiUrl": "https://d3w.ap.oproarts.com/d3w/api/_opro_ts/", // リクエスト先のD³WorkerのURL3"failed": [ // 失敗した処理群を配列で示す。4{5"message": "Salesforce REST API エラー:\n指定されたエラー条件に該当したため出力をスキップします。\r\n(商談対象外,エラー条件No.1)「商談対象外」は処理しません。", // エラーメッセージ6"recordId": "0060w00000DETNnAAP" // 失敗したレコードのID7}8// 複数ある場合はカンマ区切りで列記する。9],10"success": [ // 成功した処理群を配列で示す。11{12"historyId": "a050w000004OeZxAAK", // 作成した「連携履歴」のID13"processId": "PGeJhsxZuqC_3ZX", // D³Worker上に発行されたジョブのID14"recordId": "0060w00000DDGe4AAH", // データの引用元としたレコードのID15"status": "OK", // D³Workerが処理受付の際にレスポンスしたステータス16"taskId": "00T0w00000Ccno9EAB" // 作成した活動履歴のID17}18// 複数ある場合はカンマ区切りで列記する。19],20"workName": "テストワーク" // D³Worker上で実行されたワークの名称21}
選択された項目が多い「設定」にてドキュメントを出力する場合に「Apex CPU Time limit exceeded」が生じる場合がある問題について対策しました。
ドキュメント生成の際に「リクエストパラメータの内容に誤りがあります。」のエラーが生じた場合に、より具体的な情報を返却するように変更しました。
単票型のドキュメントを出力する場合に、該当するオブジェクトのレコードが多い場合に「Apex CPU Time limit exceeded」が生じる場合がある問題について対策しました。
2023/08/31 パッケージ「v1.35.0」を作成しました。
「設定」の「ボタン生成」画面に「エラー条件」のタブを追加しました。
当タブにて条件を指定すると、ドキュメント出力やD³Worker連携の前に出力対象レコードの内容を検査し、処理対象から除外する事が可能になります。
当タブは、「ボタンの種類」として「アクション」を指定した場合のみ表示されます。
「単票型」や「ヘッダー明細型」の場合のみ、当機能を利用する事ができます。「一覧型」の場合は利用できません。
「種別」列について
以下の２種が存在します。
単一：1行で完結する条件、あるいは、「複合」条件で利用される条件。
複合：「単一」の条件を組み合わせた条件。「1 or 2」のような条件を指定する事が可能。
式作成画面と同様の演算子や関数を利用する事が可能ですが、基本的には括弧, NOT, OR, AND のみが利用される想定です。
「複合」条件の中で「複合」条件を指定する事はできません。
「エラーメッセージ」欄に文言を記載する事で条件が成立します。
「単一」を1行のみで条件として成立させる場合、「エラーメッセージ」欄に文言を記載して下さい。
「エラーメッセージ」欄を空欄にする場合、「複合」欄で引用して利用して下さい。「複合」欄では必ず「エラーメッセージ」欄に文言を記載して下さい。
「比較」列について
「フィールド」列で指定した項目の型によって選択肢が変化します。
「比較する値」列について
「フィールド」列でDATE型、あるいはDATETIME型を選択した場合、相対日付を選択する事が可能です。
相対日付は、Salesforceの相対日付に準じて実装しています。処理を実行した時点での日時に基づいて、対象の日付が指定した範囲内に含まれるかを判断します。
週や、会計年度に関する相対日付を利用する場合は、SOQLの日付リテラルを活用して範囲に該当するかを判定しています。これを利用する場合、1条件毎にSOQLが実行されるためご注意下さい。
「条件保存」ボタンを追加しました。
このボタンは、「エラー条件」タブか「出力後更新」タブを選択している場合にだけ表示されます。
当ボタンを押すと、設定内容を一時保存する事ができます。
設定内容に問題が検出された場合であっても保存されます。
「ボタン生成」ボタンの変更について
「ボタン生成」ボタンをクリックした際に、「エラー条件」タブの設定内容に問題が無いかを検査します。 検査した結果エラーが検出された場合、ボタン生成は実施されず、ボタン生成画面内に留まります。
2023/08/04 パッケージ「v1.31.0」を作成しました。
ドキュメント生成の際に、引用する画像の拡張子が「jpeg」の場合に処理できない問題を修正しました。
JPEG形式の画像には対応しておりましたが、拡張子が「jpg」の場合しか考慮されていない状態でした。
「設定」のインポートの際に項目数が多い場合にガバナ制限エラーが生じる場合がある問題について修正しました。
2023/07/20 パッケージ「v1.28.0」を作成しました。
「設定」の「ボタン生成」画面の「出力後更新処理」タブにて、「値」の欄内で半角スペースが「+」に変化する問題を修正しました。
2023/07/14 パッケージ「v1.27.0」を作成しました。
「単票」型の「設定」が作成可能になりました。
「単票」とは、1オブジェクトのみ使用し、1レコードにつき1ドキュメントを生成する形式です。
「設定」を新規作成する際に、「基本設定」画面にて「タイプ」として「単票・ヘッダー明細型」を選択し、「オブジェクト選択」画面にて、主オブジェクトのみを選択し、明細オブジェクトを選択しなければ、その「設定」は「単票」の扱いになります。
従来は明細を1件以上指定する必要がありましたが、その制限を廃止しました。基本設定画面の「出力方法」欄について、新規作成時の初期指定欄を「単票・ヘッダー明細型」に変更しました。
ワンクリックでドキュメントを出力できるボタンを生成できる機能を追加しました。
「設定」の「ボタン生成」画面を変更しました。
「ボタンの種類」の表記を「ボタンを設置する場所」に変更しました。
新規の選択項目として「ボタンの種類」を追加しました。以下の選択肢があります。
アクション：ワンクリックでドキュメントを生成できるボタンを生成します。画面の初期表示時点ではこちらが選択されています。
リンク：従来通りのボタンを生成します。ボタンをクリックすると、ドキュメント出力用画面に遷移します。
ボタン生成が完了した後で「ボタン配置設定画面へ移動」のボタンを表示するように変更しました。
当ボタンをクリックすると、オブジェクトマネージャ内の、指定した親オブジェクトの設定画面が表示されます。「詳細ページボタン」を選択した場合、「ページレイアウト」が開きます。レイアウト内にボタンを追加して下さい。
「リストボタン」を選択した場合、「リストビューボタンレイアウト」が開きます。ボタンを表示対象に追加して下さい。
「設定」の「ボタン生成」画面に「出力方法」の欄を追加しました。
当選択欄は、「ボタンの種類」として「アクション」を指定した場合のみ表示されます。
ボタンを押した際に、ダウンロードするか、あるいはファイルとして保存するかを指定します。
保存先を「添付ファイル」とするか、SalesforceFilesとするかは、後述のカスタム設定によって指定します。
「設定」の「ボタン生成」画面に「活動履歴作成」の欄を追加しました。
当選択欄は、「ボタンの種類」として「アクション」を指定した場合のみ表示されます。
「作成する」を選択した場合、ドキュメントを生成した後で、出力元レコードに対して活動履歴を作成します。
「作成しない」を選択した場合は何も行いません。
カスタム設定に「活動登録ON」のチェックボックスが存在しますが、この設定よりも、当画面での設定が優先されます。
「設定」の「ボタン生成」画面に「出力後更新処理」のタブを追加しました。
当タブにて条件を指定すると、ドキュメント出力やD³Worker連携の後で、出力元レコードを指定した条件で更新する事ができます。
当タブは、「ボタンの種類」として「アクション」を指定した場合のみ表示されます。
「単票型」や「ヘッダー明細型」の場合のみ、当機能を利用する事ができます。「一覧型」の場合は利用できません。
更新処理の有無について
ドキュメント生成の場合
ドキュメント生成が成功した場合のみ、出力元レコードを更新します。
D³Worker連携の場合
D³Workerへリクエストする際に「連携履歴」を作成しますが、連携履歴の作成が成功した場合に、出力元レコードを更新します。
D³Worker側での最終的な処理の成否は更新処理の有無に影響しません。最終的に配信が失敗した場合であっても、出力元レコードを指定の条件で更新するためご注意下さい。
更新の種別について
固定値：任意の文字列を指定した項目に反映します。
出力した日：更新処理を実施する時点での日を指定した項目に反映します。時刻情報を持ちません。
出力した日時：更新処理を実施する時点での日時を指定した項目に反映します。時刻情報を持ちます。
出力したユーザのID：ドキュメントの出力を行ったユーザのIDを指定した項目に反映します。
更新対象項目の型が文字列か、ユーザの参照型項目である場合に指定可能です。出力したユーザの名前：ドキュメントの出力を行ったユーザの名前を指定した項目に反映します。
D³Worker連携履歴ID：D³Worker連携の場合だけ選択可能です。D³Worker連携の際に作成される「連携履歴」のIDを指定した項目に反映します。更新対象項目の型が文字列か、「連携履歴」オブジェクトの参照型項目である場合に指定可能です。
以下の項目は更新対象として指定する事ができません。候補にも表示されません。
Id, IsDeleted, LastModifiedDate, LastModifiedById, LastActivityDate, LastViewedDate, LastReferencedDate, SystemModstamp, CreatedDate
諸々の条件は、ボタン生成の際に自動的に生成されるVisualforcePage内に反映されます。
ボタンを生成した後で設定を変更する場合は、直接VisualforcePage内のJavaScriptを編集して下さい。
「ヘッダー明細型」の「設定」の「項目選択」画面にて、明細オブジェクトに対して式を追加する際に、左欄の項目一覧に明細オブジェクトのフィールドが表示されない問題を修正しました。
カスタム設定に「SalesforceFilesに保存」を追加しました。
これをチェックすると、従来の「添付ファイル」(00P系)ではなく、SalesforceFiles(069,068系)にドキュメントを保存します。
「設定」の「ボタン生成」画面にて、「アクション」か「リンク」かを選択可能ですが、どちらを選択した場合であっても当設定が適用されます。「出力確認」を行う場合のドキュメントの生成先も、当設定が適用されます。
項目選択画面で「保存」ボタンを押した際のチェック処理を修正しました。
式ではない項目で、引用元オブジェクトと引用元API参照名が完全に同一の項目が複数存在する場合、 「同一の項目が複数登録されています。(重複項目名)」のエラーメッセージをトーストで表示するように変更しました。
選択されているオブジェクトのうち、項目の選択が行われていないオブジェクトが存在する場合に「項目を選択してください。」のエラーメッセージを表示していましたが、そのチェックを行わないように変更しました。当チェックは式を保存する際にも作動していましたが、その際にもチェックされなくなります。
「保存」ボタンをクリックした際に何らかのエラーが生じた場合、「ファイル名設定」「式追加」ボタンが消えてしまう問題がありました。消えないように修正しました。
「設定」の詳細表示画面と、出力確認画面にて、「ワーク」の設定値を表示する欄を追加しました。
D³Workerのヘッダー明細型の場合に、適切にデータ連携を行う事ができない各種問題を修正しました。
SalesforceFilesや添付ファイルのIDを画像ダウンロードURLに置換する処理が動作するように修正しました。
日付型項目の書式が「yyyy-MM-dd HH:mm:ss」になっていましたが、「yyyy-MM-dd」で出力するように修正しました。
式を利用すると、ワーク実行後に連携履歴にて、式解釈が失敗した旨のエラーが生じる問題を修正しました。
「メモ、添付ファイル、Googleドキュメントおよびファイル」等を明細オブジェクトとして指定すると、ワークを実行した際にエラーになる問題を修正しました。
「設定」がD³Worker連携の場合、項目編集画面にワーク選択欄が表示されまずが、候補を任意の文言でフィルタして探す事が可能になりました。
D³Worker連携の場合にも、連携を実施した際に活動履歴を作成するように変更しました。
従来通り画面から出力する場合は、カスタム設定の「活動履歴ON」の設定状態に基づいて、活動履歴の作成の有無を判断します。
「ボタン生成」画面で「ボタンの種類」として「アクション」を選択してボタンを作成し、そのボタンから実行した場合、「活動履歴作成」の設定欄の指定に基づいて、活動履歴の作成の有無を判断します。
活動履歴は、D³Workerへの連携を実施した時点で作成されます。最終的にD³Worker側での処理が失敗したとしても活動履歴は作成されるためご注意下さい。また、D³Worker側での最終的な処理結果が獲得された後で自動的に活動履歴が更新される事はありませんのでご了承下さい。
ドキュメント出力時の認証用の「OPROARTS キー」として「ALA」と「AXLA」を利用する事が可能になりました。
「ALA」は、Salesforceユーザ全員に、Office形式の帳票の出力権限を付与できます。
カスタム設定の「OPROARTS Connector Type LA」に「LA」を指定している場合のみ、「ALA」が有効になります。
「AXLA」は、Salesforceユーザ全員に、XAデザイナで作成した帳票の出力権限を付与できます。
カスタム設定の「XA Connector Type (Output)」に「XLA」を指定している場合のみ、「AXLA」が有効になります。
具体的な設定方法等はこちらをご確認下さい。
ドキュメント出力をD³Worker連携を行う事ができるApexRESTを追加しました。詳細はこちらを参照して下さい。
2023/05/25 パッケージ「v1.17.0」を作成しました。
D³Worker連携の「設定」を削除する際に「LAD」での認証を行わないように修正しました。
2023/05/19 パッケージ「v1.16.0」を作成しました。
D³Worker連携の「設定」をエクスポートする際には「LAD」での認証を行わないように修正しました。
2023/05/10 パッケージ「v1.15.0」を作成しました。
D³Workerにリクエストする場合に、CSVの列の順序が乱れる場合がある問題を修正しました。
D³Worker連携かつ、ヘッダー明細型を指定している場合に問題が生じる場合がありました。
エクスポートする際に「項目」の並び順が一定になるよう修正しました。
2023/04/25 パッケージ「v1.14.0」を作成しました。
以下の処理にてSalesforceのAPIの「22.0」を利用していました。「55.0」を利用するように変更しました。
OPROARTS認証情報を獲得する処理
D³Workerにワークの実行をリクエストする処理
2023/04/24 パッケージ「v1.13.0」を作成しました。
「項目」の「項目API参照名」のサイズを変更しました。60→255に拡張しました。 項目編集画面にて、参照を辿って深い階層の項目を追加した際に「データ値が大きすぎる」のエラーが生じる問題への対策です。
2023/04/19 パッケージ「v1.12.0」を作成しました。
OPROARTS認証情報入力画面にて、デフォルトでUPWにマスクがかかるよう変更しました。
リストビューからドキュメントを出力する際のレコード件数制限を廃止し、無制限にしました。従来は20件までの制限がありました。
2023/04/18 パッケージ「v1.11.0」を作成しました。
「設定」の一覧画面に、エクスポートボタンと、インポートボタンを追加しました。
インポートする際には、同名の設定を上書きする事が可能です。
ただし、出力形式が異なるファイルで上書きする事は出来ません。出力形式がOfficeのものに限り、
docutize でエクスポートしたものをインポートする事や、
帳票DX でエクスポートしたものを docutize でインポートする事も可能です。インポートの際に、組織内に存在しないオブジェクトを参照するように指定されたファイルを取り込む事はできません。
「設定」が組織別に区別されるよう変更しました。
従来は同一のCIDが登録された組織が複数存在する場合に、各々に同名の設定が存在する場合は、同一のレイアウトを参照するように振る舞っていました。2023/04/17 以降は、組織単位で「設定」が区別されます。
2023/04/17 以降に作成した「設定」のみ区別します。既存の「設定」に関しては従来通りの動作になります。
出力形式がOfficeの場合のレイアウト名の命名が不要になりました。
従来は「設定」を作成した後で「レイアウト」ボタンを押した際に、初回はレイアウトの名称を指定する必要がありましたが、不要になりました。
「設定」の「主オブジェクトAPI参照名」に実在しないAPI参照名が記載されたレコードが存在する場合に「設定」一覧画面を開くことができない問題を修正しました。
D³Workerのリクエスト先が存在しない場合のエラーメッセージを具体的なものに変更しました。
主オブジェクトとして選択可能なオブジェクトとして、WorkOrder(作業指示) を追加しました。
現状、主オブジェクトとして選択可能なオブジェクトは以下になります。
Account(取引先)
Asset(納入商品)
Campaign(キャンペーン)
Case(ケース)
Contact(取引先責任者)
Contract(契約)
Idea(アイデア)
Lead(リード)
Opportunity(商談)
Order(注文)
Product2(商品)
Solution(ソリューション)
User(ユーザ)
WorkOrder (作業指示) v1.11.0 で追加
以下条件を満たすカスタムオブジェクト
カスタム設定ではない
ログインユーザが参照可能
2023/03/15 パッケージ「v1.6.0」を作成しました。
出力形式が「PDF」かつ引用元項目が日付型の場合に、適切に値が出力されない問題を修正しました。
日付型項目を引用してドキュメントを出力する際は、テキストデータを生成する際に、
「yyyy-MM-dd」の書式にする事を想定していましたが、予期せず
「yyyy-MM-dd'T'HH:mm:ssXXX」の書式で生成していました。
「yyyy-MM-dd」を正として修正しました。テンプレートのデザイン画面で「データセット設定」画面を開き、該当する項目の「フィールド型」「入力フォーマット」を、以下の表の「v1.5.0以前で受け付ける形式」のように設定している場合は、「v1.6.0以降で受け付ける形式」の設定に書き換えていただけますようお願い致します。
列名 フィールド型 入力フォーマット v1.5.0以前で受け付ける形式 日付と時刻 yyyy-MM-dd'T'HH:mm:ssXXX v1.6.0以降で受け付ける形式 日付 yyyy-MM-dd