DevTools – AI開発実践ラボ

要件定義_要件定義書_別紙2「オブジェクト定義書」（Excel版）サンプル

セールスフォース標準化推進ラボ — Sun, 26 Jun 2022 05:25:06 +0000

本記事では、Creative Content Lab Tokyo（クリエイティブコンテンツラボトウキョウ）が作成した要件定義_要件定義書_別紙2「オブジェクト定義書」のテンプレートをご提供しております。

※テンプレートの利用方法に関しては、以下の記事を参照してください。

参考

基本設計-Salesforceデータモデル（オブジェクト設計）

本記事では、Salesforce（セールスフォース）の導入プロジェクトの設計工程…

1.利用方法

１．表紙

画像はクリックすると拡大表示されます。

表紙については、以下の箇所をプロジェクトに合わせて変更してください。

会社名：

情報種別：社外秘など

情報所有者：基本的にはお客様の会社名となります。

タイトル：ドキュメントのタイトルをプロジェクトに合わせて変更

作成日、作成者：※必要に応じて、最終更新日、更新者を入れてください。

２．改訂履歴

改訂履歴は、ドキュメントのメンテナンス上必ず設定するようにしましょう。

またプロジェクトごとに記載の粒度やルールを検討してください。

３．オブジェクト一覧

本書に記載する対象のオブジェクトを一覧化します。

オブジェクト名（表示ラベル名）だけではなく、API参照名（物理名）や区分（標準/カスタム）なども設定するようにしましょう。

また、外部システムとの連携がある場合には、こちらに外部システムの内容を記載することもあります。その場合は、対象システムがわかるように列を追加してください。

４．オブジェクト項目のデータ型に関する説明資料

オブジェクト項目定義書を利用するユーザがSalesforceのデータ型について理解するための補助資料となります。

取り扱うデータ型に対しての説明文を記載しておきましょう。

オブジェクト項目定義書テンプレート

オブジェクトの項目を定義していくためのテンプレートとなります。

一般的にSalesforceの開発はアジャイルに近い形で進められることが多く項目の定義情報（ラベル、データ型、桁数など）は頻繁に更新されます。

そのため、上記エクセルでメンテナンスをするのは非常に作業効率が悪くお勧めしません。

Xgeeksが提供しているDevToolsを使って、ドキュメントは自動生成することをお勧めします。

以下のようにオブジェクト一覧と項目定義書（利用しているプロファイルの情報まで出力可能）を自動生成することができます。

補足）オブジェクト一覧（DevToolsで出力）

参考）オブジェクト項目定義（取引先）

DevToolsの使い方については、以下の記事に纏めていますので、参考にしてください。

参考

Salesforce DevToolsを使ってオブジェクト設計書を自動生成（xgeek.net）

今回は、xgeek.netさんが提供する無料ツールであるSalesforce D…

2.オブジェクト定義書のダウンロード

資料のダウンロードおよびご利用に関しては、本サイトのコンテンツ利用規約に同意される場合のみ利用可能となります。

ダウンロード前に利用規約を必ずお読みください。

一般公開資料

要件定義_要件定義書_別紙2「オブジェクト定義書」（EXCEL版）のダウンロードはこちら

以下は、スプレッドシートでの表示となります。

要件定義_要件定義書_別紙2「オブジェクト定義書」（EXCEL版）のスプレッドシートはこちら

サポーターさん

ブログランキングに参加しましたので、ご支援していただけると幸いです。

にほんブログ村

Salesforce DevToolsを使ってオブジェクト設計書を自動生成（xgeek.net）

セールスフォース標準化推進ラボ — Sat, 27 Nov 2021 16:55:59 +0000

今回は、xgeek.netさんが提供する無料ツールであるSalesforce DevToolsをご紹介していきたいと思います。

xgeek.netでは、今回ご紹介するSalesforce DevTools以外にも、Salesforce導入プロジェクトでは欠かせないツールがいくつか提供されています。

主な製品

Pipeline for salesforce：GitなどからSalesforceのメタデータをSalesforce組織にデプロイすることができる
Salesforce mass editor：リストビューでExcelのように複数データを一括でCopy&Paste（コピー＆ペースト）したり、データ編集が可能

セールスフォース・ドットコム社の営業担当の方や、開発ベンダーの方も当たり前のように利用されているほど利用者が広がっています。

サポーターさん

この記事を書いている時点でDevToolsについては3万人の利用者を超えて、日本だけでも1万人以上利用しているようです。

どれも無料で提供されているので、まだ利用したことがないという方はこれを機にご利用ください。

Salesforce DevTools

https://www.xgeek.net/ja/salesforce/tesforce-for-google-chrome/

1.機能概要

xgeek.netの公式ホームページで紹介されている主要な機能は以下となります。

GUIベースのQuery Editor機能、SOQLの自動生成、クエリ実行結果をExcelファイルにエクスポートが可能
Excel形式のオブジェクト定義書を自動生成
画面レイアウトやリストビュー設計書の自動生成
svg形式のSalesforceデータモデル(ERDs)の自動生成
プロファイル編集、項目セキュリティ編集ページで一括チェックが可能 (Classicのみ)
カスタム項目の一括編集、一括削除、一括コピー及び他のオブジェクトへのコピー作成機能 (Classicのみ)

2.利用方法

Salesforce DevToolsはChromeの拡張機能となるため、Chromeブラウザを利用する必要があります。

手順①Xgeekのサイトへアクセスして、Salesforce DevToolsのメニューをクリックします。

https://www.xgeek.net/ja/tag/salesforce/

②Install From Chrome Web Storeのボタンをクリックして、Chrome ウェブストアを開きます。

以下のボタンから直接Chromeウェブストアへ遷移できます。

Chrome ウェブストア（Salesforce DevTools）

③Chrome ウェブストアの画面で、Chromeに追加のボタンをクリックします。

④以下のメッセージが表示されるので、拡張機能を追加ボタンをクリックします。

⑤Chromeの拡張機能として、以下の赤枠のアイコンが表示されていればOK（※アイコンは今後変更になる可能性がありますので注意）

⑥オブジェクト定義を作成したいSaleforceの組織へログインしておきます。

※DevToolsは、Salesfore関連のドメインにアクセスしたときしか動作しないように初期設定されているので、それ以外のサイトでは利用できないので注意してください

⑦続いて、⑤のアイコンをクリックすると以下の画面が表示されるため、Activeのボタンをクリックします。

⑧今度は、Salesfore側からツールのアクセス許可を確認するメッセージが表示されるため、許可をして先に進んでください。

⑨Salesforeにログインした状態で、もう一度アイコンをクリックすると以下の画面が表示されます。（メニュー画面）

実はオブジェクト定義書作成以外にも便利な機能がたくさんありますが、詳細はまた別途ご紹介いたします。

3.オブジェクト定義書の自動生成手順

①オブジェクト定義書を作成したいSalesforceのタブを表示します。【重要】

例では、取引先画面を表示しています。

②取引先を表示した状態で、DevToolsのメニューを表示すると以下のように取引先（Account）と表示されているのが確認できます。

この状態で、Exportボタンをクリックして、Object Definition（FULL）を選択します。

※FULLの場合は、プロファイル毎の項目レベルセキュリティの設定情報も取得できます。

③項目レベルセキュリティの設定情報を取得したいプロファイルを選択したらExportボタンをクリックします。

④以下のExcelファイルがダウンロードされます。

1シート目は、オブジェクト定義の内容で、2シート目がオブジェクトの項目定義となります。

オブジェクト項目定義　※Fullでは、右側のプロファイル毎の項目レベルセキュリティの設定内容も出力されます。

まとめ

いかがでしたでしょうか。

DevToolsは、日々進化しており、今回ご紹介した機能以外にも便利な機能がたくさんありますので、別の機会にご紹介したいと思います。

サポーターさん

ブログランキングに参加しましたので、ご支援していただけると幸いです。

にほんブログ村

基本設計-Salesforceデータモデル（オブジェクト設計）

セールスフォース標準化推進ラボ — Sun, 07 Nov 2021 06:13:48 +0000

本記事では、Salesforce（セールスフォース）の導入プロジェクトの設計工程で実施するデータモデル（オブジェクト設計）について説明します。

一般的なシステム開発では、業務プロセスをベースに概念データモデルを設計し、そこからハイレベルのエンティティ抽出を行う流れとなります。

概念データモデル

業務プロセスをモデルとして、まずは、以下のような概念データモデルを作成し、ハイレベルのエンティティを抽出していきます。

最初から細かくなりすぎないように注意してください。全体像が俯瞰できるようなものを作成することを目指します。

定義するべき情報は以下となります。

エンティティ（Salesforceでは最終的にオブジェクトとして定義される）
識別子：エンティティのキーとなる項目を定義（上記では、顧客名や顧客コード）
リレーション：エンティティ間の関係性を定義
オプショナリティは、リレーションの元と先の関係性を示し、（ | ）は必須で（〇）は任意となります。上記の例では、顧客は必ず必要（必須）で、担当者は任意の関係となるため、担当者のいない顧客データが存在することになります。
カーディナリティは、エンティティ間の多重度（「1:1」、「1:N」、「N:N」）を示す。上記の例では、1顧客に対して、複数の担当者紐づく（ 1:N ）関係となります。

今回の趣旨はオブジェクト設計のため、概念データモデルの詳細な説明は別の記事で説明します。

まずは、オブジェクト設計までの大まかな流れを理解していただければ構いません。

オブジェクト設計

では、オブジェクト設計について説明していきます。

まず、Salesforceでは、データベースのテーブルのことをオブジェクトといいます。オブジェクトというと、別のものを思い浮かべるかたもいると思いますので、お客様にもプロジェクト開始時にSalesforceの用語について説明しておくとよいでしょう。

そのほかにも、Salesforceやクラウドの基本的なアーキテクチャなども含めて説明しておくとよいでしょう。

以下の記事では、説明用にそのまま利用できる資料を提供しているので、よろしければご利用ください。

参考

ユーザ説明資料

ユーザ説明用資料に関する記事一覧 Salesforce導入プロジェクトで必要とな…

オブジェクト設計書の作成

では、概念データモデルやER図が出来上がったら、続いてはオブジェクト（テーブル）の基本項目について検討していきます。

最初に以下のようなオブジェクト一覧を作成しましょう。

全体のオブジェクト数の把握や、標準オブジェクト、カスタムオブジェクトなどの識別や用途を整理します。

標準オブジェクトは、Salesforceの標準機能（例えば取引先の管理や商談の管理機能）で利用するあらかじめ用意されたオブジェクトを意味します。

カスタムオブジェクトは、新しく自由に定義できるオブジェクトとなります。

オブジェクト定義書

続いて、オブジェクト定義書を作成します。オブジェクト定義書では以下の事項を記述します。

オブジェクト名、API参照名（オブジェクト一覧より転記）
項目の表示ラベル（項目名）
API参照名（項目のAPI参照名）
データ型（テキスト、数値、選択リストなど）
桁数
項目タイプ（標準項目、カスタム項目）
必須（〇/×）
選択リスト値（項目定義が選択リストの場合の、選択リスト値を定義）
数式（数式項目の場合に、数式の内容を定義）
外部ID（外部データ連携を行う場合に、キーとなる項目の場合は外部IDとして定義しておく）
履歴管理：項目の値が変更された場合に項目変更履歴として残したい項目の場合は管理対象とする必要があります。
ヘルプ内容：Salesforceでは、項目の入力補助としてヘルプメッセージの表示が可能で、表示する内容を定義できます。

設計担当者は、これらの項目を検討して、オブジェクト定義書を作成していきます。

データ型（補足）

データ型に関する補足事項はいくつかありますが、重要なものだけ紹介しておきます。

選択リスト

選択リストの値については、オブジェクト毎に個別で定義するものと、グローバル選択リスト値を利用する場合と2種類あります。

例えば、お客様の業種の選択リストを顧客管理オブジェクトとアンケート管理オブジェクトで利用するような場合には、それぞれのオブジェクトで「業種」という選択リストを作成するとメンテナンスが大変になるため、グローバル選択リストを使って、共通の選択リスト値を定義しておき、それぞれのオブジェクトで利用するというやり方が一般的です。