本記事では帳票DX for Salesforceでのアクションの設定方法をご紹介します。
「出力定義」は、「設定」の中にv1.43.0で追加した「出力定義作成」ボタンを押すと作成することが可能です。
Salesforce連携のOPROARTSアクションの設定方法については、以下をご参照ください。
FAQ「【OPROARTS Connector v2】OPROARTSアクションの設定方法(Salesforce連携)」
◆「権限セット」「各種認証情報」「ページレイアウトの割当て」「アウトバウンドメッセージ」「フロー」の設定
「権限セット」「各種認証情報」「ページレイアウトの割当て」「アウトバウンドメッセージ」と「ワークフロー」の設定
本機能を利用するために、最初に「権限セット」「各種認証情報」「ページレイアウトの割当て」「ワークフロー」と「アウトバウンドメッセージ」を設定する必要があります。
アウトバウンドメッセージを利用する場合、画面上で操作するユーザーと、実際のドキュメント生成やD³Worker連携を行うユーザーは異なります。自動的な処理を行わせるユーザーを準備してください。
【権限セット設定手順】
1.設定を開き、「権限セット」を検索します。
2.「割り当ての管理」>「割り当ての追加」からユーザを追加し、「次へ」をクリックします。
【各種認証情報設定】
1.アプリケーションランチャーにて「OPROARTS(帳票DX)」を開きます。
2.LA, XLA, D3W の配下に、自動的な処理を行わせるユーザーを追加します。
・ALA、AXLA、AD3W は自動処理用のユーザではご利用になれません。
・LA はOffice出力を行う場合に指定します。
・XLA はPDF出力を行う場合に指定します。
・D3W はD³Worker連携を利用する場合に指定します。
認証情報の登録については、以下をご参照ください。
【帳票DX for Salesforce セットアップガイド(2)】認証情報の登録
【ページレイアウトの割当ての設定手順】
「帳票DXアクション」を利用する場合「ページレイアウトの割当て」を設定する必要があります。
以下記事の「◆帳票DXをご利用の場合」をご参照ください。
【アウトバウンドメッセージ設定手順】
1.Salesforceの設定を開き、「ワークフロー」を検索します。
プロセスの自動化>ワークフローアクション>アウトバウンドメッセージ を開きます。
2.「Action Message V3」を開き、「編集」ボタンを押します。
3.「送信ユーザー」の欄に、自動的な処理を実際に行わせるユーザを設定し、保存します。
「アウトバウンドメッセージ」を実行するユーザは、画面上で操作したユーザではなく、この画面で設定したユーザになります。
「出力定義」-「アクション」でのリクエストの場合は、 「ALA」、「AXLA」は利用できません。
アウトバウンドメッセージで利用するユーザの認証情報は「LA」「XLA」「D3W」に登録してください。
必ず、OPROARTS認証情報に、アウトバウンドメッセージに利用するユーザを登録する必要があります。
【フローの設定】
既にワークフロールールの有効化を実施済の場合は、【帳票DX for Salesforce】ワークフロー廃止に伴うフローへの移行 をご参照ください。
ワークフロールールは2025年12 月31日にサポートが終了する見込みです。
ワークフロールールの有効化を未実施の場合は、以下の手順でフローを有効化してください。
1.帳票DX for Salesforceをv1.130.0以降のバージョンにアップグレードします。
2.プロセスの自動化>フローを開き、「UnprocessedActiveAction」の右端の「▼」ボタンをクリックし、「詳細とバージョンを表示」をクリックします。
3.「フローのバージョン」の一覧内の、「バージョン」が最も新しい行の「有効化」をクリックします。
【「帳票DXオブジェクトアップグレード」の実行】
帳票DX for Salesforce v1.89.0以前のバージョンから帳票DX for Salesforce v1.90.0以降にバージョンアップした方は必ず「帳票DXオブジェクトアップグレード」の実行を行ってください。
詳しくは以下記事をご覧ください。
帳票DXアクション実行手順
1.アクションを作成したい設定をクリックします
2.「出力定義作成」をクリックします
既存のレコードを編集する機能は現時点ではございません。作成のみが行えます。
3.「出力方法」「活動履歴作成」を選択します
************************************************************************************************************
Point
※v1.58.0以降の場合、「出力方法」によって、「添付ファイルの参照先 ID」「添付ファイルの所有者 ID」「ZIPファイル名」を設定することが可能です。
・「出力元レコードに添付」を選択した場合、「添付ファイルの所有者 ID」
・「帳票DXアクションか任意レコードに添付(個別に添付)」を選択した場合、「添付ファイルの参照先 ID」「添付ファイルの所有者 ID」
・「帳票DXアクションか任意レコードに添付(複数時zip圧縮)」を選択した場合、「添付ファイルの参照先 ID」「添付ファイルの所有者 ID」「ZIPファイル名」
・v1.146.0以降で「帳票DXアクションか任意レコードに添付(PDF結合)」を選択した場合、「添付ファイルの参照先 ID」「添付ファイルの所有者 ID」「結合PDFファイル名」
************************************************************************************************************
4.選択後、「出力定義作成」をクリックして出力定義を作成します
5.出力定義が保存されます。「出力定義を確認」から出力定義を確認することができます。
6.出力定義のレコードに遷移します
7.「出力定義」のレコードを開き、「関連」タブを開くと、「アクション」の関連リストが表示されます。
「新規」をクリックして、アクションを作成します。
8.レコードタイプを選択し、「次へ」をクリックします。
帳票DXの場合は「Document DX」を選択します。
9.以下の編集を加え、「保存」をクリックします。
・「有効」にチェックを入れる
・「レコード ID」に処理対象のレコード群をカンマ区切りで指定する
10.保存後、ドキュメント生成が作動して、結果が表示されます。
該当のレコードを確認すると、ファイルが添付されています。
Apexによってアウトバウンドメッセージを実行する例
1.Salesforceにて開発者コンソールを開き、Ctrl + E を押して、「Enter Apex Code」(実行匿名ウィンドウ)を開きます。
2.以下のコードを編集した上で貼り付けます。
docutizexa__Action__c action = new docutizexa__Action__c();
action.docutizexa__IsActive__c = true; // 有効化。
action.docutizexa__RecordIds__c = '0060w00000DDGe4AAH,0060w00000DDGe9AAH'; // 処理対象レコードをカンマ区切りで指定。
action.docutizexa__OutputSetting__c = 'a0G0w000004Wc3CEAS'; // 「出力定義」のレコードのオブジェクトIDを指定。
insert action;3.「Execute」をクリックします。
4.「帳票DX」アプリケーションの「出力定義」タブを開き、該当する「出力定義」を開き、出力定義の子として新規の「帳票DXアクション」のレコードが作成されている事を確認します。
「ステータス」が「完了」になる事を確認します。