[toc]
概要
本記事では、らくらくExcelを使用して、Salesforceの帳票出力元データ(参照先レコード)の項目を編集する手順を説明します。
見積レコードと見積明細レコードから生成したExcel見積書を例に、D3Worker側の設定からExcelアドインでの操作までを手順に沿って解説します。
前提条件
- ViewFramerを用いてSalesforceから出力したExcel帳票(見積書)が必要です。
- Excelファイルに以下の項目が含まれていることを確認してください。
- 見積レコードID
- 取引先責任者の氏名(姓・名を別々のセルに配置)
- 「ダミー文書」サービスと「Salesforce一括登録」サービスの基本設定が完了していることを前提とします。
-
Salesforce標準の見積オブジェクトには取引先責任者の参照項目が存在しないため、 本ページの設定では以下のカスタム参照項目を見積オブジェクトに作成していることを前提とします。
項目名 API参照名 データ型 取引先責任者 Contact__c 参照関係(取引先責任者)
事前準備
Excel見積書の用意
ViewFramerを用いると、Salesforceの見積レコードからExcel見積書を出力できます。
ViewFramer を使用した Excel帳票の出力方法の詳細は、下記記事をご参照ください。
アドインのインストール
らくらくExcelを利用するためには、Excel用Officeアドイン「OPROARTS-D3Worker Bridge」のインストールが必要です。 以下の手順を行うことでアドインが使用可能になります。
- 見積書のExcelファイルを開きます。
- 「挿入」タブの「アドインを入手」をクリックします。
- 検索ボックスに「OPROARTS-D」と入力してEnterキーを押します。
- 候補から「OPROARTS-D3Worker Bridge」を選択し、「追加」をクリックしてインストールします。
D3Workerの設定
サービス設定
出力したExcel見積書から、見積レコードに紐づく取引先責任者の氏名を変更するため、以下のサービスを使用します。
| サービス | 説明 |
|---|---|
| 「ダミー文書」サービス | 文書を生成しないサービスとして機能します。 |
| 「Salesforce一括登録」サービス | 取引先責任者レコードの項目を編集・更新します。 |
各サービスの詳細な設定方法については、以下記事をご参照ください。
D3Workerのサービス「ダミー文書」(文書化を伴わない処理) らくらくExcelを用いてSalesforceのレコードを更新する (「D3Workerの設定」の「サービス設定」部分)
エンベロープ設定
文書化サービスに「ダミー文書」を基にしたサービスを、配送サービスに「Salesforce一括登録」を基にしたサービスを指定します。
文書化サービス
配送サービス
| 操作内容 | 説明 |
|---|---|
| 関連オブジェクトの確認 | 「関連オブジェクト」の「レコードのID」の「SOQL」にチェックを入れます。 |
| 編集をクリック | 「編集」をクリックします。 |
| SOQLを入力 | 見積レコードに紐づく取引先責任者レコードのIDを取得するSOQLを入力し、「OK」をクリックします。 |
エンベロープの設定が完了したら、「保存」ボタンをクリックします。
ワーク設定
| 設定項目 | 内容 |
|---|---|
| ワーク名称 | わかりやすいワーク名を入力します。 |
| エンベロープ | 作成したエンベロープを選択します。 |
| データソース | 「エンベロープパラメータを基にデータソースを構築」をクリックして自動生成します。 |
| 文字コード | 「UTF-8」に設定します。 |
| 先頭行の処理 | 「データとして使用しない」をオフにします。 |
| エンベロープフィールド | 「P.見積.Id」を選択します。 |
| アクティブ化するパラメータ | 「エンベロープフィールド」を選択し、「ELSEとして使用」にチェックを入れます。 |
「エンベロープフィールド」で「P.見積.Id」を選択可能にするため、一度「データソース」タブに移動してから「エンベロープ」タブに戻ります。
Excelでの設定
アドインの起動
- 見積書のExcelファイルを開きます。
-
「データ」タブで「D3Worker連携」をクリックしてアドインを表示させます。
-
「Get Started」をクリックします。
-
D3Workerの接続情報を入力し、「ログイン」をクリックします。
💡補足「UID/UPWをローカルに保存する」にチェックを入れると、次回のログイン時にUID入力が省略できます。
ワークの選択と割り当て
| 操作内容 | 説明 |
|---|---|
| ワーク選択 | 作成したワークを選択します。ワーク名の一部を入力することで、該当するワークに絞り込めます。 |
| セルの割り当て | Excelのセルをワークのデータソース・パラメータに対応付けます。 |
| フィールドマッピング | 各フィールド名をクリックし、対応させたいセルを選択します。 この手順をデータソースフィールド数分繰り返します。 |
データ設定項目
以下の項目は、ワーク実行時の各種設定を指定します。
| 項目名 | 内容 | 説明 |
|---|---|---|
| 引用元シート制限 | 対象シート名を入力 | この項目に入力した文字列に当てはまるシート名のシートのみから、D3Workerへのリクエストが可能になります。正規表現( * と ? のみ)も使用できます。 |
| データ検索基準セル | 参照セルを選択 | 下隣のセルが空であり、かつ自身は空でない任意のセルを選択してください。 このセルから下方に向けて、明細行をカウントします。 |
| 1レコード毎に繰り返す行数 | 数値を入力 | 1つの明細行として扱う行数を指定します(例:取引先責任者を1件のみ更新する場合は1を入力)。 |
| 明細検索方法 | 検索方法を選択 | 「列内で最後の入力がある箇所まで」または「列内で次の空白値に到達するまで」から選択します。 |
| マッピング位置確認用式出力先セル | セルを指定 | このセル上でF2を押すと、マッピング対象のセルが色付きで表示されます。 |
「明細行」とは、見積明細を単純に表すものではなく、「明細行として扱われた行数と同じ数だけ関連レコード(ここでは取引先責任者)を更新する」ための行を指します。
データソースの各フィールド名とパラメータ名が並んでいるので、対応させたいセルを選択した状態でフィールド名をクリックします。 データソースフィールドの数だけこの手順を繰り返し行います。
全てのフィールドとパラメータについてセルもしくは固定値を割り当てたら、「送信」ボタンをクリックします。 このとき、「実行後、シート上にIDのリンクを貼る」を選択していることを確認してください。
ヘッダー部分の見積IDに書き込まれたリンクをクリックすると、更新された見積レコードを開きます。 事前にSalesforce 組織にログインしておくと、スムーズにレコード画面を開けます。
取引先責任者の名前が変更されています。
ワーク実行時のオプション
| オプション名 | 挙動 |
|---|---|
| シートを更新しない | 「送信」押下後にシート内容が変更されません。 |
| 実行後、シート上にIDをテキストで出力 | 「送信」押下後にID項目参照元のセルが更新したレコードのID(テキスト)で書き換えられます。 |
| 実行後、シート上にIDのリンクを貼る | 「送信」押下後にID項目参照元のセルが更新したレコードのID(リンク)で書き換えられます。 リンククリックでデフォルトブラウザが開き、レコード詳細画面に遷移します。 |