DinaSheet 0.3.0 ユーザーマニュアル

DinaSheet for Salesforce ユーザーマニュアル

保存できる Query ファイル、Favorites フォルダー、Salesforce データのグリッド操作、確認付き更新、ロールバック、ダウンロード、ローカルファイル読み込みを説明する実践ガイドです。

6 枚のスクリーンショットは合成デモデータとサンプル ID を使用しています。顧客データや本番組織のデータは含まれていません。起動ポップアップは日本語、ワークスペースは英語で表示しています。

目次

  1. 1. はじめに
  2. 2. 保存 Query と Favorites
  3. 3. レコードの確認と更新
  4. 4. 更新監査とロールバック
  5. 5. CSV・Excel ファイル
  6. 6. Salesforce レポート
  7. 7. ダウンロードと言語
  8. 8. 保存、プライバシー、安全性

1. はじめに

  1. Chrome ウェブストアから DinaSheet for Salesforce をインストールします。すぐに起動できるようにする場合は、Chrome の拡張機能メニューから固定します。
  2. Chrome で Salesforce を開き、通常どおりログインします。DinaSheet はブラウザーのセッションを再利用するため、Salesforce パスワードを別途入力する必要はありません。
  3. DinaSheet のツールバーアイコンをクリックします。現在の Salesforce 組織、または検出された別のログイン済み組織を選び、開くを選択します。
  4. データの読み込みや更新を行う前に、DinaSheet 上部の組織表示を確認します。
現在の Salesforce タブとほかのログイン済み組織を表示する DinaSheet ポップアップ
シートを開く前に、現在のタブと検出済みの別組織セッションを区別して確認できます。

組織が表示されない場合:Salesforce を開くかログインし、ツールバーポップアップに戻って検出済みセッションを更新してください。

2. 保存 Query と Favorites

  1. Salesforce Data サイドバーの Query を展開します。現在の Salesforce 組織に紐づくフォルダーと SOQL ファイルを作成できます。
  2. Query ファイルを開くと SOQL が実行され、Salesforce の最新データが読み込まれます。取得レコードを更新する可能性がある場合は Id を含めます。
  3. File details で SOQL を編集し、解決された Salesforce オブジェクトと更新可否を確認して、Run and update sheet を選びます。
  4. Query ファイル、リストビュー、レポートのメニューから Add to Favorites… を選びます。常設の Default または新しく作成した Favorites フォルダーを指定できます。
  5. Favorites からショートカットを再度開き、別フォルダーへの移動、所属フォルダーの編集、削除を行えます。定義は組織ごとに保存され、結果行は都度読み込まれます。
  6. セル書式やグリッド操作にはスプレッドシートのツールバーを使います。セルを変更しても、Salesforce はすぐには更新されません。
DinaSheet のクエリパネルとスプレッドシートグリッドに表示された Salesforce 取引先データ
SOQL クエリで取引先の項目を編集可能なシートへ読み込みます。接続中の組織はヘッダーで確認できます。

更新可能になる条件:シートに Id 列があり、レコードが 1 種類の Salesforce オブジェクトとして判定できる必要があります。Query 定義と Favorite ショートカットはローカルに保存されますが、Salesforce の結果行は保存されません。

3. レコードの確認と更新

  1. 更新可能な Id 列を持つシートで、対応する項目を 1 つ以上編集します。
  2. 詳細パネルが閉じている場合は開きます。変更項目カードに、各レコードの変更前・変更後の値が正確に表示されます。
  3. 確認カードの更新を選択します。
  4. 確認ダイアログを読みます。さらに編集する場合はキャンセル、表示された値だけを Salesforce に送る場合は更新を選択します。
  5. 更新に成功すると、変更項目を含む上限付きの監査記録がローカルに保存されます。
変更項目の確認カードと Salesforce 更新の最終確認ダイアログ
更新を実行する前に、確認カードとダイアログで同じレコードと項目値を確認できます。

DinaSheet にレコード削除機能はありません。対象となる更新を明示的に確定するまで、グリッドでの編集はローカルのままです。

4. 更新監査とロールバック

  1. レールの LOG アイコンを選択して更新監査ログを開きます。
  2. 対象のオブジェクトと更新日時を探します。監査ログは新しい順に表示されます。
  3. 記録された以前の値へ戻したい各行のロールバックセルを選択します。
  4. 表示された変更項目カードを確認します。ロールバックは通常の Salesforce 更新として準備され、自動では送信されません。
  5. 監査記録の作成後に別の編集が行われた可能性がある場合は、特に現在の Salesforce 値を確認してから、更新を確定またはキャンセルします。
以前の値と選択済みロールバック行を表示する DinaSheet 更新監査ログ
監査ログの行を選ぶと、記録された以前の値が同じ確認付き更新フローに準備されます。

監査記録は過去時点のスナップショットです。レコードが変更されていないことを保証するものではありません。ロールバックを確定する前に現在の値を確認してください。

5. CSV・Excel ファイル

  1. インポートパネルを開き、アップロードを選択します。
  2. ローカルの CSV または Excel ファイルを選び、現在のシートまたは新しいシートを出力先として指定します。
  3. 実行を選択します。DinaSheet はブラウザー内でファイルをローカル解析し、ファイル名、行数、出力先、判定された Salesforce オブジェクトの詳細を表示します。
  4. 読み込んだ表に 1 種類のオブジェクトの有効なレコード ID が含まれる場合は、確認付き更新が利用可能になります。更新前に判定されたオブジェクトを確認してください。
インポート詳細と前回のインポート情報を表示する CSV レコード
詳細パネルで、読み込み元と利用可能な Salesforce Id 列が検出されたかを確認できます。

ファイルを開いても、DinaLab や開発者運営のサーバーへアップロードされることはありません。ワークブックファイルとシートスナップショットは DinaSheet に永続保存されません。

6. Salesforce レポート

  1. レポートインポートモードを開くか、Salesforce データブラウザーからレポートを選びます。
  2. レポート名で検索するかレポート ID を入力し、出力先シートを選んで実行を選択します。
  3. グリッドの横で、レポート名、API 参照名、フォルダー、形式、説明、検索条件、取得元の詳細を確認します。
  4. Salesforce の JSON レポート API が 2,000 行の上限に達した場合、DinaSheet は Salesforce から同じレポートの全件ワークブックエクスポート取得を試みます。
Salesforce レポートの行とレポート・インポート詳細を表示する DinaSheet
レポート結果はデータ行として開き、取得元の詳細と検索条件はサイドパネルで確認できます。

グリッドの編集で Salesforce レポート定義が変更されることはありません。レポート行に 1 種類のオブジェクトの有効なレコード ID がある場合、利用可能な確認付き更新はレポートではなく Salesforce レコードを更新します。

7. ダウンロードと言語

シートと Favorites をダウンロードする

  1. Query ファイルまたは Favorite のメニューから、1 件を CSV または Excel で直接ダウンロードします。
  2. Favorites フォルダーの Download Folder… から、複数 CSV の ZIP または複数シートの Excel ワークブックを作成します。
  3. フォルダーダウンロードでは進捗が表示され、項目の間でキャンセルでき、一部に失敗しても 1 件以上成功すれば処理を続行します。
  4. 現在のグリッドを出力する場合は、対象シートをアクティブにしてスプレッドシートのダウンロード操作を使います。
  5. 別のシステムで使用する前に、ダウンロードしたファイルを確認します。

画面表示の言語を変更する

DinaSheet は、取得できる場合は最初に Salesforce ユーザーの言語に従います。ポップアップまたは DinaSheet ヘッダーの言語セレクターで EN — EnglishJP — 日本語を切り替えられます。言語を変更すると DinaSheet が再読み込みされます。

8. 保存、プライバシー、安全性

  • クエリや更新を実行する前に、接続中の Salesforce 組織を必ず確認してください。
  • レコード更新には、行の選択、項目単位の確認、最終確定が必要です。
  • 監査記録は変更項目だけを保存し、Salesforce 組織ごとに成功した最新 50 件の更新イベント、最大 2 MB に制限されます。
  • 設定、Query フォルダー/ファイル名と SOQL、1 組織あたり最大 30 の Favorites フォルダーと 100 件の Favorite ショートカット、更新記録は端末の Chrome 拡張機能ストレージに保存されます。
  • Salesforce のクエリ/レポート結果行、読み込んだファイル内容、ワークブックのセルスナップショットは拡張機能ストレージに保存されません。
  • Query 定義は DinaSheet 内で削除できます。保存済み定義とショートカットをまとめて削除するには、拡張機能ストレージを消去するか DinaSheet をアンインストールします。
  • Salesforce セッション Cookie と認証ヘッダーは拡張機能内に保持されます。
  • DinaSheet には分析、テレメトリー、広告、外部メッセージング、開発者運営のデータバックエンドはありません。

DinaSheet のプライバシーポリシー全文(英語)を読む