過去にAIの機能を使ったことがある人は、「結局AIといっても大したことはできないし、やっぱり人間が必要」というイメージを持っている人も多くいると思いますが、そのイメージは捨てたほうがいいかもしれません。

ChatGPTの登場により、既に特定の分野では完全にAIだけで仕事ができるレベルに到達してきているようです。（人が作業するよりも精度が高く、もちろん作業スピードも高速）

本記事では、ChatGPTの概要や出来ることについて説明するとともに、Salesforceなどシステム開発でどのように利用するかを説明していきたいと思います。

ChatGPTとは

まずは、ChatGPTについて簡単に概要を説明したいと思います。

ChatGPT（チャットジーピーティー）とは、OpenAI社（※工知能の研究開発を行う非営利団体）が開発したGPT-3という大規模言語モデルを使った文章生成AIとなります。

※公式サイトURL：https://openai.com/　（ChatGPTを利用するためには登録が必要です。

ChatGPTは、従来のAI（人工知能）に対するイメージを完全に覆す超ハイレベルなAIとなっています。OpenAI社は、SpaceXやテスラ、そしてTwitter買収で有名なイーロンマスク氏が共同設立した会社です。

現在は、イーロンマスク氏は会社を離れていて、Microsoft社が出資し、MicrosoftのBING（検索エンジン）に組み込んで利用できるようになってきています。※Chromeの拡張機能なども提供され始めています。

最近では、ペンシルベニア大学のMBAの期末試験の解答をChatGPTで行ったところ、B判定（優秀）となり話題になっていました。今後は、Googleの検索が不要になり、調べたいことはなんでもChatGPTに聞けば、全世界の膨大なデータ量から自動で検索して、それを要約して精度の高い回答を得ることができるようになるのではと言われています。

これに対して、GoogleはBardという会話型AIを発表しています。ただし現時点ではChatGPTの方が優れていると評価しているユーザが多いようです。どちらにしても今後近い将来、このAIの分野が目覚ましい進歩をして仕事の中で普通に使われるようになるものと思われます。

特にChatGPTは、文章の生成だけではなく、翻訳、プログラミング（コーディング）までできる優れもののため、今日からすぐに仕事に活かして作業効率を上げることができます。

文章は、英語だけではなく日本語にも対応しており、チャットに対して質問や依頼を入力すると、自然な文章で要約された精度の高い回答を得ることができます。

料金体系については、無料版と有料版を提供されています。まずは無料版で試しに使ってみるとよいと思います。

以上が概要となりますが、詳細な情報について知りたい方は後半でご紹介するYoutubeの動画を見ることをお勧めします。

ChatGPTで実現可能なこと

現時点で、ChatGPTでできることは以下のような内容となります。

1. 検索やQ&A（質問に対して、要約された回答が返ってくる）
2. 精度の高い文章作成（メール本文、感想文、論文など高度なものまで）
3. 翻訳（英語から日本語など幅広い言語に対して精度の高い翻訳を行うことができる）
4. 計算（数学の問題などに対して、答えや計算の過程を説明してくれる）
5. ブログ記事の作成や最適SEOのキーワードの提案など
6. プログラミングのソースコード生成（HTML、Javascript、CSS、PHPなど様々）
7. ソースコードのバグ解析（ソースコードに対してレビューを行い、バグを発見）
8. その他（作詞など）

上記のように様々なことができるようになっています。しかも生成されるのはかなり高度（高品質）なものとなっています。

ちなみにChatGPTに対して、「ChatGPTにはどのような機能がありますか」と質問したところ以下の結果が返ってきました。

以下、実際のChatGPTを利用したイメージ画像

文章（文字列を解析）してのAIとなるため、苦手な分野もありますが、それらの分野でも別のAIのサービスが出てきています。

例えば、画像生成AIであれば、「DreamStudio（https://beta.dreamstudio.ai/home）」や「Mage（https://www.mage.space/）」などがあります。

テキスト入力すると、キーワードから自動で画像を生成してくれます。

以下は、DreamStudioを使って、魅力的なビジュアルストアディスプレイと入力して生成した画像の例

こちらは、キーワード「猫型ロボットのうさぎみみ」などで生成した例

サポーターさん

このように文章作成、翻訳、プログラミング、画像生成、作曲など様々な分野でAIが進んでいることを実感いただけると思います。

ChatGPTを使ったSalesforceのLightning web component開発

では、さっそく本題のChatGPTを使って、Salesforceのプログラミング（ソースコード自動生成）を試してみたいと思います。

ChatGPTには、次の内容を入力しました。

「SalesforceのLightning web componentでお問い合わせフォームを作成する場合のコードを教えて」

すると以下3つ（HTML、Javascript、CSS）のコードが生成されました。

①生成されたHTMLファイル（ContactForm.html）

<template>
<div class="slds-m-around_medium">
<lightning-card title="お問い合わせフォーム">
<div class="slds-m-around_medium">
<lightning-input type="text" label="お名前" required value={name} onchange={handleNameChange}></lightning-input>
<lightning-input type="email" label="メールアドレス" required value={email} onchange={handleEmailChange}></lightning-input>
<lightning-input type="text" label="件名" required value={subject} onchange={handleSubjectChange}></lightning-input>
<lightning-textarea label="メッセージ" required value={message} onchange={handleMessageChange}></lightning-textarea>
</div>
<div class="slds-m-around_medium">
<lightning-button variant="brand" label="送信" onclick={handleSubmit}></lightning-button>
</div>
</lightning-card>
</div>
</template>

実際のChatGPTの画像（ContactForm.html）

②生成されたJavaScriptファイル (contactForm.js)

<template>

import { LightningElement, track } from 'lwc';
import { ShowToastEvent } from 'lightning/platformShowToastEvent';

export default class ContactForm extends LightningElement {
@track name = '';
@track email = '';
@track subject = '';
@track message = '';

handleNameChange(event) {
this.name = event.target.value;
}

handleEmailChange(event) {
this.email = event.target.value;
}

handleSubjectChange(event) {
this.subject = event.target.value;
}

handleMessageChange(event) {
this.message = event.target.value;
}

handleSubmit() {
// フォームの入力内容を検証
if (this.name === '' || this.email === '' || this.subject === '' || this.message === '') {
const event = new ShowToastEvent({
title: '入力エラー',
message: '必須項目を入力してください。',
variant: 'error'
});
this.dispatchEvent(event);
return;
}

// フォームを送信
// TODO: サーバーサイドの処理を実装する
const event = new ShowToastEvent({
title: '送信完了',
message: 'お問い合わせを受け付けました。',
variant: 'success'
});
this.dispatchEvent(event);
}
}

実際のChatGPTの画像（②ContactForm.js）

③生成されたCSSファイル (contactForm.css):

.slds-m-around_medium {
margin: 20px;
}

実際のChatGPTの画像（ContactForm.css）

では、Visual Studio Codeを使って、上記の生成されたコードをコピペして実際にLWCを作成してみます。

VSCを起動して、新規Lightning web componentを作成します。※名前はcontactForm

続いて、VSCで作成されたcontactForm.htmlを開いて、ChatGPTで生成されたソースコードをコピーして貼り付けます。

まずはcontactForm.html

続いて、ContactForm.jsに張り付け

続いてContactForm.cssにソースコードを張り付け　※CSSファイルがない場合、自分で作成しておきます。

最後にXMLファイルを以下のように修正し、ホーム画面などにコンポーネントを配置可能としておきます。

<?xml version="1.0" encoding="UTF-8"?>
<LightningComponentBundle xmlns="http://soap.sforce.com/2006/04/metadata">
<apiVersion>56.0</apiVersion>
<isExposed>true</isExposed>
<targets>
<!-- コンポーネントの配置先を指定 -->
<target>lightning__AppPage</target>
<target>lightning__RecordPage</target>
<target>lightning__HomePage</target>
</targets>
</LightningComponentBundle>

ソースの修正が完了したら最後にコンポーネントをデプロイします。

※図の右下にあるとおり、生成されたコードでデプロイは正常に実行されています。

サポーターさん

デプロイはうまくいったけど、画面はちゃんと表示されるの？と疑ってる方もいると思いますが、実際にSalesforceでコンポーネントを配置して確認してみましょう。

では、ここからはSalesforce組織側の設定となります。

まずは、Salesforceにログインして、ホーム画面のページ編集を行います。ここで、先ほど作成したContactFormのカスタムコンポーネントを好きな場所へ配置します。例では、右上に配置しています。

もしここでコンポーネントが配置されない場合、XMLファイルの指定が間違っている可能性があるので確認してください。

コンポーネントを配置して、保存が終了したら戻ってホーム画面を表示します。

以下のようにお問い合わせフォームが表示されます！！

では動作のほうも確認してみましょう。

以下のようにテキストを入力して実行してみます。

送信ボタンを押すと、JavaScriptで定義した「ShowToastEvent()」が処理され、以下のメッセージが表示されています。

送信完了　お問い合わせを受け付けました。

ChatGPTの最後のメッセージには次のように記載されています。

「このコードでは、フォームが送信される前にJavaScriptでフォームの入力内容を検証しています。また、入力内容が不足している場合はエラーメッセージを表示し、送信が成功した場合は成功メッセージを表示しています。ただし、サーバーサイドのフォーム処理については、実際のシステムに合わせて変更する必要があります。また、CSSでフォームのスタイルを設定する」

この内容の通り、もちろんサーバサイド側の処理（Apexクラス）は別途作成する必要がありますが、プロトタイプで項目や操作イメージをレビューするのには十分な品質ではないでしょうか。（ここまでの作業をすべてやった場合でも、慣れれば5分程度でできます）

要件定義工程でプロトタイプ作成のSEやPGの要員を削減することができる場合も出てくるでしょう。

このスピード間で作業するのは普通にコーディングしていたら無理だと思います。品質についてもバグなしでこの品質をサクッと作れるというのは凄すぎますね。

実際私もやってみるまでは、「たぶんデプロイでエラーが発生して何回か修正しながらやる必要があるかな。。」と思っていましたが、全く不要でした。（感想）

【補足】さらに品質をあげるために

簡単なフォームならChatGPTでもいいかもしれないけど、これじゃ項目も少ないし、デザインもいまいちだし。。。となにかとChatGPTの欠点やあらさがしをしてしまう方もいるでしょう。

そんな方に向けて、ChatGPTの凄さはもちろんこれだけでは終わらないのです。

例えば、フォームに会社名の項目を追加したい場合には、次のように入力してみます。

「SalesforceのLightning web componentでお問い合わせフォームを作成する場合のコードを教えて、会社名の項目も必要です」

すると、、、以下のようにちゃんとテキストで会社名の項目が追加されています。

このように一度作成したものをどんどん改良していくことが簡単にできてしまうのです。

そのほかChatGPTを使ったインプリや開発について

ChatGPTを開発現場でどのように利用していくか、他の用途を考えてみました。

Apexのコーディング

Apexのコーディングはどうなのだろうと思った方も多いはず。試しにやってみました

ChatGPTには、「Salesforceの取引先の取引先名をXXに更新するApexトリガーを作成してください」とお願いしました。

上記の通り、簡単な内容ですが、しっかりとトリガーが作成されました。

しかもソースコードにコメントもちゃんとついてますし、トリガーについての説明も丁寧に記載されています。（素晴らしい）

コードレビュー

ソースコードが出来上がったら、コードとあわせてChatGPTに「コードのバグをチェックしてください」とお願いしてみましょう。

すると以下の結果が返ってきます。例では簡単なApexクラスの処理を読み込ませています。

バグがないというチェックだけではなく、良いプログラミングの実践のためのアドバイスや、補足説明などもしてくれています。

つぎに、バグがある場合にもちゃんとチェックされるのかということで、Insert文で指定する変数を削除して、再度レビュー依頼してみました。以下がChatGPTからの回答です。

ちゃんとバグを見つけてくれました。ちゃんとコメントで修正が必要な内容が書かれています！

さらに以下のように修正されたコードまで提示してくれる神仕様となっております。

いかがでしょうか。。もうコードレビューはChatGPTに頼ればいいですね。。

サポーターさん

コードレビューの工数も削減できますね。どんどん人が不要になる時代。。

Salesforceのインプリ設定の調査

例えばSalesforceのインプリ設定を依頼されたときに使ったことがない機能の場合は、どのような手順で設定するか調べると思いますが、それもChatGPTなら簡単にできてしまいます。

ChatGPTに「Salesforceの承認プロセスはどのように設定しますか」と聞いてみます。すると。。

といった感じです。これをきれいに章立てしてまとめるとマニュアルとして利用することもできますね。

ということで、操作マニュアルの生成もかなりの作業効率化が見込まれます。もちろんスクリーンショットなどは自分で取得しないといけませんが、、、（現時点では）

セールスフォースの用語集作成

例えば、Salesforce関連の用語集など作成したい場合は、以下のようにChatGPTに依頼してみます。

「次のセールスフォース用語について用語集を作成してください。ロール、プロファイル、権限セット」

すると以下のように要約された内容が返ってきました。

サポーターさん

どうですか。この精度の内容をさくっと作ってくれます。もう用語集作成担当は不要ですね（笑）

さらに、以下のように調べた用語について表にまとめるようなことも簡単にやってくれます。

オブジェクト項目のAPI参照名を確認

「Salesforceの取引先の全ての項目のAPI参照名をおしえてください」とChatGPTに依頼してみました結果

あっさりと出てきました。。

そのほかにもオブジェクト項目の翻訳なども一括で行い、結果を表にまとめるような場合にも利用できますね。

まだまだアイデアはたくさんありますが、、、検証ができたら記事にしていきたいと思います。

SalesforceとChatGPTの連携について

これまでの検証はChatGPTのフリーのバージョンを使って行ってきましたが、ChatGPTの有償版ではAPIを利用することができます。

そのためChatGPTのAPIを利用すれば、SalesforceのApexからChatGPTのAPIをコールして、その結果をSalesforceに表示したりナレッジに蓄積したりするようなことができそうです。（未検証ですが）

このあたりは、SalesforceのAI（Einstein）との兼ね合いもあるので、外部システムのAIを利用すべきかどうかは検討が必要だと思います。

ChatGPTについての参考リンク

まずお勧めなのが中田敦彦さんのYoutube。こちらでChatGPTやGoogleのBardなどについての概要が非常にわかりやすく説明されています。

[youtube id=YNEb3EK4rNY]

続いてもYoutubeの動画となりますが、「2030年の未来予測@広島弁フューチャリスト友村普」さんで「ChatGPTの使い方を初心者にもわかりやすく解説。ChatGPTの活用方法は？【openAIのChatGPTとBard】AIが世界を変える？中田敦彦さんもとりあげたチャットGPTとは？」となります。

[youtube id=JtSGYfPAu4Q]

こちらの動画では、どのように文章を生成するのかを実際にChatGPTを使って説明しています。非表示具体的でわかりやすい手順の説明をされています。

まとめ

今回は、ChatGPTを使ったSalesforceの開発について説明しました。

今後ChatGPT以外もAIがさらに進化して、どんどん作業効率化が進んでいくでしょう。

AIをどのように使いこなすかが問われる時代になりますね。自分の価値をどこで出すか本気で考えていく必要がありそうです。

サポーターさん

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

にほんブログ村

サポーターさん

機能の紹介記事は以下を参考にしてください。

参考

Salesforceワークベンチ(workbench)の機能一覧と使い方の説明（SOQL実行・Metadataのバックアップ/デプロイなど）

本記事では、Salesforce workbenchについての概要や機能について…

続きを読む

1.ユーザ説明資料サンプル

１．表紙

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

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

情報種別：社外秘など

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

会社名：自社の会社名（正式名称）を記入してください。

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

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

２．改訂履歴

版数、変更箇所、変更内容、変更理由、作成日、作成者、更新日、更新者などを記述します。

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

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

３．はじめに（本書の目的）

資料の目的を記載します。

４．目次

機能概要説明資料の目次を以下の内容で記載しています。

• Workbench概要
• Workbenchとは
• 機能一覧
• Workbenchの使い方
• Workbenchへの接続方法
• 機能紹介
• メタデータ照会機能
• クエリ実行機能
• データ操作（DML）機能
• マイグレーション機能
• その他ユーティリティ

５．Workbench（ワークベンチ）概要

はじめにWorkbenchについての概要を記載しています。ワークベンチとはどういったものか、できることは何かなど概要レベルで説明します。

続いて、Workbenchの機能一覧を記載（最新の機能一覧は公式サイトからご確認ください）

６．Workbenchの使い方（ワークベンチへのログイン）

ブラウザでWorkbenchへログインして利用するための手順を記載しています。

Workbench接続先サイト（https://workbench.developerforce.com/login.php）

※サイトのURLの最新情報は公式サイトからご確認ください。

Salesforceのユーザアカウントを使ってログインを行います。

ユーザ名とパスワードを設定して、ログイン

Workbenchのトップ画面で、利用する機能を選択するか、もしくはタブに表示されている各種メニューから利用する機能を選択します。

７．メタデータ情報照会（標準/カスタムオブジェクト）

指定したオブジェクトに関するメタデータ情報を参照することができます。

Metadata Types & Components：メタデータタイプの確認やコンポーネントについての詳細情報を確認することができます。

セッション情報（Session Infromation）：

接続しているSalesforceインスタンスのセッション情報（サービスのエンドポイントなど）を確認することができます。

８．クエリ実行機能（SOQLクエリ）

SOQL：SOQLのクエリを直接実行することができます。表示形式やソート順の指定が可能またフィルタ条件や取得レコードの上限の指定も可能です。

そのほか、削除済み、アーカイブレコードを含めるかなどの指定もできます。

Async SOQL Query：非同期のSOQL(Insert/Upsert）の実行ができます。

最初の画面で指定したSOQLで取得したレコードを使って、INSERTまたはUPSERTを実行することができます。

SOSL（Salesforce Object Search Language) の実行が可能です。SOQLは、Salesforceのレコード内のテキスト検索を実行することができます。

Streaming Push Topics：Salesforceのレコードを監視し、本機能で登録したSOQLクエリに該当した場合に、あらかじめ購読（Subscribe登録）されたクライアントに対して、プッシュ通知を実現するものとなります。

9.データ操作（DML）機能

Insert：指定オブジェクトに対して1つまたは複数のレコードを登録することができます。

【説明】INSERTでは、各項目に直接値を設定して、実行します。実行結果では、作成されたレコードIDと処理結果を確認することができます。

Update：指定オブジェクトに対して1つまたは複数のレコードを更新することができます。

【説明】UPDATEでは、各項目に直接値を設定して、実行します。実行結果では、更新されたレコードIDと処理結果を確認することができます。

Upsert：指定オブジェクトに対して1つまたは複数のレコードを更新または新規登録することができます。

外部IDなどのキー項目を比較し、すでにSalesforce上に登録されているキーと一致する場合にはレコードを更新し、一致しない場合は新規レコードとして登録されます。

【説明】UPSERTでは、各項目に直接値を設定して、実行します。

実行結果の確認画面では、処理結果とステータスを確認することができます。INSERT/UPDATEはレコード単位で確認可能

Delete：指定オブジェクトに対して1つまたは複数のレコードを削除することができます。

【説明】DELETEでは、削除対象のIDを指定して削除処理を実行します。実行結果の確認画面では、処理結果とステータスを確認することができます。

Undelete：指定オブジェクトに対して1つまたは複数の削除されたレコードを復元することができます。

【説明】指定オブジェクトに対して1つまたは複数の削除されたレコードを復元することができます。

Purge：指定オブジェクトに対して1つまたは複数の削除されたレコードをゴミ箱から削除することができます。

【説明】実行結果の確認画面では、処理結果とステータスを確認することができます。

10.マイグレーション

Retrieve：マニフェストファイルで指定したメタデータを取得することができます。Package.xmlファイルは事前に作成しておく必用があります。

マニフェストファイル（Package.xml）のサンプル。以下のサイトからフルバージョンをダウンロードすることができます。

全メタデータ取得用のマニフェストファイル（Package.xml）のサンプルダウンロード

https://creativecontentlabtokyo.com/retrieve-salesforce-full-metadata-package-xml-file-download/

説明：Retrieveを実行すると、メタデータAPIを利用してメタデータの取得処理が行われます。

実行結果の画面では、処理結果と合わせて取得したメタデータの圧縮ファイル（Zip）がダウンロード可能となります。※このZipファイルを使って、Deployを行うことができます。

Deploy（デプロイ）：指定したメタデータのZIPファイルを使ってSalesforce組織にメタデータをデプロイします。

【説明】Deployには、以下のように様々なオプションが用意されています。

・チェック（検証）だけを実行

・警告を無視

・エラーの場合にロールバック

・Apexテストの実行、テストレベルの指定など

実行するとメタデータAPIで処理が行われます。処理結果には、処理した件数や結果が表示されます。

【説明】Deploy実施結果では、ZIPファイルに含まれるメタデータごとの処理結果の詳細情報を確認することができます。

11.その他ユーティリティ機能

Rest Explorer：WorkbenchからSalesforce組織に対して直接REST APIを実行することができます。

利用可能なメソッドは、GET、POST、PUT、PATCH、DELETE、HEADとなります。

Apex Execute：WorkbenchからSalesforceに対して直接Apexコードを実行することができます。

例では、Account（取引先）のレコードを3件取得してリストに格納する処理を実行してます。実行結果では、デバッグログを確認することができます。

Password Management：WorkbenchからSalesforceのユーザに対してパスワードの設定やリセットを行うことができます。

Bulk API Job Status：DataloaderやWorkbenchなどから実行されたBulk APIのジョブステータスを確認することができます。

一括データ読み込みジョブのIDを指定して実行します。実行結果の確認画面では、ステータスや処理件数、失敗件数などを確認することができます。

Metadata API Process Status：メタデータAPIの処理プロセスのステータス（実行状況）を確認することができます。確認したいIDを指定して実行します。

2.ユーザ説明資料「機能概要説明書（Salesforce Workbench（ワークベンチ））のダウンロード

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

一般公開資料（PDF版資料）

※クリックして資料のダウンロードが開始されるまで少し時間がかかる場合がありますので、そのままお待ちください。

もしダウンロードが開始されない場合、ブラウザでポップアップブロックされている可能性があるのでご確認ください。

関係者のみ（PPT版資料）

関係者の方は、以下のページからログインして資料をダウンロードしてください

参考

保護中: 【関係者】ダウンロード可能なコンテンツ（サンプル・フォーマット）一覧

  [st-kaiwa2]お問合せ・ご要望いただいているコンテンツも頑…

続きを読む

サポーターさん

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

にほんブログ村

サポーターさん

突然ですが、皆さんはSalesforce workbench（ワークベンチ）を使ったことがありますか？

Salesforceの開発に携わった方は、開発者コンソールを使うことは多いと思いますが、リリースや運用保守でメタデータのバックアップを行うなどの機会がない方は使ったことがないという場合も多いと思います。

Workbenchには様々な機能があり、管理者や開発者にとっては開発者コンソール同様、非常に便利なツールとなります。

ワークベンチはWebブラウザから簡単にアクセスすることができ、Salesforce組織ともAPIで簡単に接続できます。さらにブラウザ上から直接クエリを発行したり、メタデータを取得（Retrieve）したり、デプロイ（Deploy）することもできます。

※Bulk、Rest ストリーミング、メタデータなどもサポートしています。

またよく利用されるパターンとして、本番環境で不要となったプログラムを削除するような場合にも利用されています。

1 Workbench概要

1-1. Workbenchとは

Salesforce Workbenchは、Salesforceプラットフォームのメタデータ管理やApexコードの実行、Salesforce APIを使ったデータへのアクセスなどを行う機能が提供されたWebベースのツール（サービス）です。

Workbench（ワークベンチ）を使うことで、システム管理者や開発者はプログラムコードを書くことなく、Webブラウザ上からの操作で簡単にメタデータを取得したり、APIを実行したりすることができます。

公式サイトのURLはこちら「Workbenchサイト（https://workbench.developerforce.com/login.php）」

1-2. 機能一覧

ワークベンチ（workbench）が現時点で提供している機能は以下の通りです。

以上のように、非常に実用性の高い機能が用意されています。

2.Workbenchの使い方

2-１． Workbenchへの接続方法

手順①Workbenchへログインするために以下の公式サイトへブラウザでアクセスします。

Workbenchサイト（https://workbench.developerforce.com/login.php）

• Environment（接続環境）を選択：Production（本番）、またはSandboxを選択します。
• API Version：利用したいAPIのバージョンを指定します。　※バージョンによって利用可能な機能が異なりるため注意

手順②「I agree to terms of service」にチェックを入れて、Login with Salesforceのボタンをクリックします。

手順③Salesforce組織にログインするためのユーザ名とパスワードを入力してログインを行います。

※すでにSalesforce組織にログインしているブラウザでWorkbenchを実行している場合は自動的に接続されます。

手順④Salesforce組織に接続後は、以下ワークベンチのメニューが表示されます。

各機能の利用方法は次の章で紹介します。

3. 機能紹介

3-1. メタデータ照会機能

①Standard ＆Custom Objects（標準＆カスタムオブジェクト）

指定したオブジェクトに関するメタデータ情報を参照することができます。※以下はユーザオブジェクトを照会した例

照会できる情報は以下の通り

• 属性
• 子リレーション
• フィールド（項目）
• レイアウト名

②Metadata Types & Components（メタデータタイプ＆コンポーネント）

メタデータタイプの確認やコンポーネントについての詳細情報（ID、名称、作成者/作成日、最終更新者/最終更新日など）の情報を確認することができます。

上記は、フローのメターデータを照会した例

③Session Information（セッション情報）

接続しているSalesforceインスタンスのセッション情報（サービスのエンドポイントなど）を確認することができます。

取得可能な情報

• APIのバージョン
• クライアントID
• エンドポイント

（ユーザ情報）

• プロファイル
• ロール
• ユーザ名
• ユーザID
• タイムゾーン、ユーザタイプなど

（組織）

• 添付ファイルの上限など

3-2. クエリ実行機能

①SOQL Query（SOQLクエリ実行）

SOQLを直接実行することができます。表示形式やソート順の指定が可能またフィルタ条件や取得レコードの上限の指定も可能です。そのほか、削除済み、アーカイブレコードを含めるかなどの指定もできます。

SOQL実行結果

②Async SOQL Query

非同期のSOQL(Insert/Upsert）の実行ができます。

③SOSL Search

SOSL（Salesforce Object Search Language) の実行が可能です。※Salesforceのレコード内のテキスト検索を実行

SOSLの実行結果（CCLTという文字列での検索を実行）

④Streaming Push Topics

本機能は、Salesforceのレコードを監視し、本機能で登録したSOQLクエリに該当した場合に、あらかじめ購読（Subscribe登録）されたクライアントに対して、プッシュ通知を実現するものとなります。

以下のメッセージが表示される場合は、Salesforce組織のストリーミングAPIの有効化がされていないため、先に設定しておく必要があります。また本機能を使う場合には、事前にSalesforce側でプッシュ通知の各種設定が必要となります。

PushTopicに関しては、少し古いですが、テラスカイさんの以下の記事がわかりやすいかと思います。

3-３. データ操作（DML）機能

①Insert

指定オブジェクトに対して1つまたは複数のレコードを登録することができます。

以下の画面で登録するための項目の値を指定して実行

実行結果を表示（成功すると以下のように表示されます）

②Update

指定オブジェクトに対して1つまたは複数のレコードを更新することができます。

以下の画面で更新レコードのIDを指定して、変更後の値をセットしたら実行

実行結果の画面

③Upsert

指定オブジェクトに対して1つまたは複数のレコードを登録＆更新することができます。

更新の場合はIDを指定して、変更後の値をセットして実行（新規の場合はID指定なし）

実行結果

④Delete

指定オブジェクトに対して1つまたは複数のレコードを（ごみ箱に）削除することができます。

削除対象レコードのIDを指定して実行

実行結果

⑤Undelete

指定オブジェクトに対して1つまたは複数の削除されたレコードを復元することができます。

UndeleteしたいレコードのIDを指定して実行

Undeleteの実行結果

⑥Purge

指定オブジェクトに対して1つまたは複数の削除されたレコードをごみ箱から完全に削除することができます。

Purgeしたいレコードを指定して実行

Purge（パージ）の実行結果

3-４. マイグレーション機能

①Retrieve（取得）

指定されたマニフェストファイル（Package.xml）に定義されたメタデータをdownloadすることができます。

Package.xmlファイルを指定します。

全てのメタデータ取得用のファイルが欲しい方は、以下からダウンロードしてご利用いただけます。

参考

全メタデータ取得用のマニフェストファイル（Package.xml）のサンプルダウンロード

本記事では、Creative Content Lab Tokyo（クリエイティブ…

続きを読む

Retriveを実行した結果

上記のDownload ZIP Fileをクリックするとメタデータのファイルをダウンロードすることができます。

ダウンロードしたメタデータはデプロイして元に戻すことができます。

②Deploy（デプロイ）

指定されたメタデータをSalesforce組織にデプロイすることができます。

オプションで、チェックだけを行う、ワーニングを無視、テストレベルやテストの実行指定などができます。

あらかじめ取得しておいたメタデータファイル（ZIP形式）を指定して実行します。

実行中の画面

実行結果の確認画面

3-５. その他ユーティリティ

①Rest Explorer

WorkbenchからSalesforce組織に対して直接REST APIを実行することができます。

利用可能なメソッドは、GET、POST、PUT、PATCH、DELETE、HEADとなります。

②Apex Execute

Apexコードを直接実行することができます。※開発コンソールと同様

実行すると以下のようなデバッグログが表示されます。

③Password Management（パスワード管理）

ユーザのパスワードを設定したりリセットすることができます。

パスワードを設定/変更したいユーザIDと新しいパスワードを指定してChange Passwordを実行します。

④Bulk API Job Status

DataloaderやWorkbenchなどから実行されたBulk APIのジョブステータスを確認することができます。

一括データ読み込みジョブのIDを指定して実行

ジョブの実行状況（結果）が表示されます。

⑤Metadata API Process Status

メタデータAPIの処理プロセスのステータス（実行状況）を確認することができます。

確認したいIDを指定して実行します。

Salesforce workbenchの概要説明資料のダウンロード

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

一般公開資料

参考

要件定義_ユーザ説明資料_Salesforce Workbench（ワークベンチ）機能概要説明」ダウンロード

本記事では、Creative Content Lab Tokyo（クリエイティブ…

続きを読む

まとめ

サポーターさん

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

にほんブログ村

Event Monitoring Analyticsという機能を利用します。この機能は、イベントモニタリングライセンスを購入されていれば利用可能となっています。

※ライセンスを購入されている場合、イベントモニタリングログの取得と合わせて、CRM Analytics（旧Tableau CRM）の機能が利用可能となりますが、CRM Analyticsの利用については、イベントモニタリングに関する分析だけの用途に限られます。

（補足）Trailheadでは、以下のモジュールで取り上げられています。

設定は以下の手順で実施します。

1.事前準備（前提条件の確認）

Event Monitoring Analytics（CRM Analytics）を利用するためには、ユーザのロール階層を設定していることが前提条件となっています。

要件詳細（以下、Salesforce公式サイトHELPより）

• ロール階層には 2 レベル以上含まれている必要があります。
• ユーザにはロールを割り当てる必要があります。
• 階層の各レベルには、少なくとも 1 人のユーザが割り当てられている必要があります。

上記要件を満たさず、ロールが正しく設定されていない場合、作成したデータフローを実行すると以下のエラーが発生します。

“Something went wrong while executing the FlattenRole node: parent_field does not have any data.”

Event Monitoring Analyticsを利用するSalesforce組織で正しくロールが設定されているか確認しておきましょう。

手順①システム管理者でSalesforceにログインし、設定->ユーザ->ロールを実行して、最上位のデフォルトの組織名の下に2階層以上のロールが設定されていることを確認します。

ロール階層が設定されていない場合は、新規ロールを追加しておきます。

要件3は、各ロールには1ユーザは割り当てている必要があるということで、各ロールの割り当てを確認していきましょう。

選択済みユーザが1名以上選択されていることを確認し、問題がなければ他のロールも確認しておきましょう。

最後に要件2にあるように、ユーザにロールが正しく割り当てられているか確認しておきましょう。

ロールが割り当たっていないユーザがいる場合は、割り当てをしておいてください。

以上で、前提条件の確認が終了となります。

イベントモニタリングを利用可能な組織を持っていない場合

TrailheadでEvent Monitoring Log Analyticsを検証可能な組織を作成することができます。

手順①以下のサイトへ接続します。

手順②LEARN CRM ANALYTICS WITH TRAILHEADサイトを表示したら、右側の欄に必要な情報を入力します。

以下の内容を登録します。

• First Name：名
• Last Name：姓
• Email address：メールアドレス
• Role:役割を選択
• Company：会社名
• Country：Japan（日本）を選択
• Postal Code：郵便番号
• Username：ログインユーザのユーザ名を指定（メールアドレス形式）

手順②登録が完了したら、以下のような画面が表示されますので、しばらくしてメールを確認してみてください。

手順③アクティベーションメールを受信したら、メール本文にある [アカウントを確認] をクリックします。

手順④パスワードの変更画面で新しいパスワードを設定します。

手順⑤Salesforce組織にログインしたら、アプリケーションからAnalytics Studioが利用できることが確認できます。

2.イベントモニタリングの有効化

イベントモニタリング設定の有効化を行います。

手順①設定->セキュリティ->イベントモニタリング->イベントモニタリング設定の順に実行します。

以下の画面で、Analytics アプリケーションでイベントログデータを表示を無効から有効に変更します。

イベントモニタリングデータを削除することが必要な場合は、合わせて有効化しておきます。

イベントマネージャをクリックすると以下の画面に遷移します。

こちらの画面では、「データストリーム」または「データを保存する」設定が可能です。

上記画面に定義されている内容となりますが、取得できるイベントの種類は以下のようなものがあります。

3.利用者の権限設定

続いては、Analytics CRMを利用するための権限セットの設定を行います。

手順①権限セットを実行すると、以下2つの権限セットが用意されているのを確認できます。

・Event Monitoring Analytics ユーザ：Event Monitoring アプリケーションを表示することが可能

・Event Monitoring Analytics 管理者：Event Monitoring アプリケーションとデータフローを作成およびカスタマイズします。

※Event Monitoring Analytics Appsのライセンスがない場合には表示されません。

手順②まずは「Event Monitoring Analytics 管理者」をクリックして、以下の画面を表示したら、割り当ての管理をクリックします。

手順③割り当ての管理画面で、管理者のユーザを追加します。

手順④手順②、③と同様に「Event Monitoring Analytics ユーザ」についても必要なユーザを割り当てます。

4.CRM Analyticsの設定

ここからは、CRM Analytics側での作業となります。

Event Monitoring Log分析用のテンプレートが用意されているので、これを利用することで、簡単に分析アプリケーションを作成することができます。

手順①アプリケーションからAnalytics Studioを実行します。

手順②Analytics Studio起動後、作成メニューからアプリケーションを実行します。

手順③新規アプリケーションを作成画面では、Event Monitoring Analytics Appのテンプレートを選択します。

手順④ここからはセットアップウィザードに従って設定していきます。次へをクリックします。

手順⑤ステップ１からステップ6までについて、デフォルトではすべてNoとなっているため、分析したいログはすべて「Yes」に変更します。また期間については最長で30日までとなっているため、今回はすべて30で設定します。

ステップ2：同様にすべてYesで期間を30に設定

ステップ3：同様にすべてYesで期間を30に設定

ステップ4：同様にすべてYesで期間を30に設定

ステップ5：同様にすべてYesで期間を30に設定

ステップ6：同様にすべてYesで期間を30に設定

ステップ7では、「既存のデータセットに新規イベントログファイルを追加するか」チェックボックスはONにします。

最後にアプリケーションの名前を設定して作成をクリックします。

手順⑥作成処理が始まると以下の画面が表示されます。通常30分程度で作成が完了します。

手順⑦処理が正常終了した場合は、以下のように処理結果で「0 failed」となっています。

また完了通知のメールも届きます。

メールには、以下のような結果ログが出力されています。

Organization check complete
No application assets marked in-progress.
Completed adding template dependencies
ID [ｘｘｘｘ] のフォルダ [Event Monitoring Log Analytics] が正常に作成されました
データセット [ApexCallout] は正常に作成されました。
データセット [ApexCalloutWithUsers] は正常に作成されました。
データセット [ApexRestApi] は正常に作成されました。
データセット [ApexRestApiWithUsers] は正常に作成されました。
データセット [ApexSoap] は正常に作成されました。
データセット [ApexSoapWithUsers] は正常に作成されました。
データセット [ApexTrigger] は正常に作成されました。
データセット [ApexTriggerWithUsers] は正常に作成されました。
データセット [ApexExecution] は正常に作成されました。
データセット [ApexExecutionWithUsers] は正常に作成されました。
データセット [ApexUnexpectedException] は正常に作成されました。
データセット [ApexUnexpectedExceptionStageCopy] は正常に作成されました。
データセット [API] は正常に作成されました。
データセット [APIWithUsers] は正常に作成されました。
データセット [BulkApi] は正常に作成されました。

….（※一部のみ抜粋）

処理が失敗した場合は、エラー内容に応じて設定の見直しを実施してください。

5.ジョブスケジュールの設定

オブジェクトの情報を定期的に更新するためにジョブのスケジュールを設定します。

手順①Analytics Studioの画面から、データマネージャのメニューをクリックします。

手順②データマネージャ画面は、ジョブ監視画面とデータフロー管理画面の2つがあります。

以下が、ジョブ監視画面です。

データフロー管理画面（ジョブ監視画面でデータフローを管理を実行）

データフローとレシピのメニューをクリックすると、作成したアプリケーションのデータフロー「AppendDataflow」が作成されているので、未スケジュールの隣の▼メニューをクリックします。

手順③スケジュールの設定画面で、データ更新のスケジュールを設定します。

スケジュールモード：「時間ベース」か「イベントベース」

スケジュール基準：分、時間、週、月

開始：時間を選択

スケジュールが設定されると以下のように次の実行日程が表示されます。

6.ダッシュボードの実行

最後にAnalytics Studioの画面から、ダッシュボードを実行してみます。

※デフォルトで用意されているものがいくつかあります。それ以外にも自分でダッシュボードを作成することもできます。

手順①作成したアプリケーション「Event Monitoring Log Analytics」選択し、アプリケーションに含まれているダッシュボードを表示します。

ダッシュボード実行例

注意事項（補足）

イベントモニタリングログは、1カ月間しかサーバ上に保存されないため、過去ログをずっと保管しておく要件がある場合には、別途イベントモニタリングログをCSVでダウンロードしておく必要があります。

Salesforce Event Log File Browserを使った、CSVログファイルのダウンロード手順は以下となります。

手順①Salesforce組織にログインします。

手順②次にブラウザのタブを追加して、以下のURLへ接続します。

https://salesforce-elf.herokuapp.com/

手順③以下画面にて、ログインIDとパスワードを入力します。

手順④elf browserに対して、アクセス許可を実行します。

手順⑤Salesforce Event Log File Browserの画面が表示されたら、接続先を選択します。

本番環境の場合：Productionを選択 ,サンドボックスの場合：Sandboxを選択

手順⑥ログイン後には、以下の画面が表示されます。

・DataRange：ログを検索する範囲を指定

・EventType：検索対象のイベントタイプを指定

・Interval：ログのインターバルを指定

上記の条件を指定後、Applyボタンをクリックすると対象のログが一覧表示されます。

手順⑦上記検索結果の一覧からAction欄から、CSVダウンロードか、cURL Shell Scriptのダウンロードが実行可能です。

cURL Shell Scriptをダウンロードした場合、以下のようなスクリプトが出力されます。

#!/usr/bin/env sh

# A script that downloads an event log file
# Requires cURL http://curl.haxx.se/

# Event Type: Login
# Log Date: 2022-08-30
# File Size (in Bytes): 730.0
curl --compressed "https://{instance_url}/services/data/v32.0/sobjects/EventLogFile/0AT5h00002T6QHAGA3/LogFile" -H "Authorization: Bearer 00D5h000004bsqk!AQwAQKi.Ac5bmBi4LjUIaHZpPse5NF4Z61cA8uTjeDVsP....." -o "2022-08-30_Login.csv"

CSVダウンロードすると以下のようなログが出力可能です。

上記CSVファイルを過去ログとして保存したり、別のシステムへ取り込んで分析して利用することができます。

（補足）参考URL

参考URL

まとめ

今回は、CRM Analyticsを使ったイベントモニタリングログの分析方法を紹介しました。

Event Monitoring Analyticsを利用することで、イベントモニタリングのログファイルをダウンロードして、解析するプログラムを自作する必要もなく、設定だけで簡単に利用できるため、ライセンスがある場合にはぜひ有効活用してみてください。

サポーターさん

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

にほんブログ村

※LINE WOKRSは、現在API2.0のバージョンが最新となっていますので、今回はAPI2.0の前提で説明します。

前回ご説明したTalend API Testerを使ってSalesforceのREST APIを外部システムからコールする手順（以下の記事）と同じような手順で、OAuthを利用してアクセストークンを取得し、トークンを使ってAPIを実行する流れとなります。

参考

Talend API TesterのREST APIを使ってSalesforceにOAuthクライアント認証を行う

外部システムとSalesforceのデータ連携方法のひとつとして、Salesfo…

続きを読む

1.LINE WORKSアカウントのセットアップ

まずは、LINE WORKSのAPIを利用するために、LINE WORKSのアカウントを用意する必要があります。

既にアカウントをお持ちの場合はそちらを利用していただき、まだお持ちでない場合は、以下のサイトからアカウントを作成してください。

今回の検証で利用するAPIについては、フリープラン（無料）で検証可能です。

料金プランには、FREE（フリー）￥0、STANDARD（スタンダード）￥450、ADVANCED（アドバンスト）￥800の3種類があります。（2022年8月22日時点）

プランの違いは、利用料金のページ下部に以下のように詳細が記載されているのでご確認ください。

今回はフリープランで、アカウントのセットアップを行っていきます。

手順①LINE WORKS 公式サイトのトップメニューから「今すぐはじめる」をクリックします。

手順②以下のページで「無料ではじめる」をクリックします。

手順③続いて、ご自身の所属する企業/団体の情報を選択して、次へをクリックします。

手順④サービスを利用する企業/団体名を入力します。※会社名を入力すればOK

手順⑤名前（姓名）を入力して、次へをクリックします。

手順⑥サービスへログインする際に利用する携帯電話番号を入力して次へをクリックします。※携帯電話に認証番号が通知されます。

※携帯電話番号が利用できない場合は、別の方法で新規開設をクリックすると、メールアドレスでのアカウント作成が可能です。

手順⑦登録した携帯電話に4桁の認証番号が届いたら、以下の画面に番号を入力します。

手順⑧認証が完了すると以下の登録完了画面が表示されます。

作成したサービスを他に利用するメンバーがいる場合は、以下の画面に招待メールアドレスを登録して通知することで招待が可能です。

手順⑧サービスをはじめるをクリックすると、LINE WORKS にログインし、プライバシーポリシー確認画面が表示されるので、「規約に同意してサービスを利用する」をクリックして開始します。

2.LINE WORKSの初期設定

アカウントの作成が終わったら、まずはLINE WORKSの初期設定を行います。

手順①以下、LINE WORKSへログイン後の画面で、右上の自分のアイコンをクリックして、メニューを表示し、管理者画面のメニューを実行します。

手順②以下の管理者画面（Admin）に遷移すると、管理者メニューの実行が可能となります。

手順③管理者画面への初回ログイン時には、以下の初期設定のウィザードが表示されるので、今回はこちらを使ってセットアップしていきます。

「はい、設定します」のボタンをクリックして次に進みます。

手順④業種選択画面ではアカウント作成時に指定した業種が指定されているので、変更がなければ次へ進みます。

手順⑤次にチーム/部署の情報を設定します。LINE WORKSからAPIで組織情報を取得する検証を行う場合は、部署の情報を設定しておきましょう。

※ここで指定しなくても、あとから個別のメニューで登録することは可能です。

手順⑥部署を作成したら所属設定をしておきます。

手順⑦今度は、役職/職級を設定します。属性情報としてAPIで取得可能な項目となります。

手順⑧最後は予約管理対象の設備を設定します。（会議室など）

手順⑨設定が完了すると以下の完了画面に遷移します。掲示板は今回は利用しないので、追加しなくても構いません。

掲示板を追加するをクリックした場合は以下の画面へ遷移するため、必用に応じて追加してください。

以上で、管理画面の初期設定は完了となります。

開発メンバーの追加と管理者権限の委任（オプション）

管理者用アカウントを1つ作成していますが、実際の開発では、開発メンバーが他にいて、そのメンバーに開発権限を付与して運用することがあると思います。その場合、まずは管理者画面でメンバーを登録して、メンバーに対して管理者権限の委任をする必要があります。

手順①LINE WOKRS Admin（管理者画面）にログインし、メンバーメニューからメンバーの追加をします。

手順②メンバーのメニューからメンバーを追加を実行します。

手順③メンバーの追加画面で、姓名、ID、所属、パスワードを設定して登録します。

手順④メンバーの登録が完了したら、メンバーの修正からメールアドレスを設定してください。

※管理者権限をメンバーへ委任するためには、メールアドレスが必須となります。

手順⑤続いて、管理者権限のメニューをクリックして、管理者権限画面にて、権限委任をクリックします。

手順⑥権限委任画面にて、委任先のメンバーを指定して次へ進みます。

手順⑦委任を受け入れる画面が表示されます。※委任先のメンバーにメールが通知されます。

手順⑧委任先のメンバーのメールアドレスに以下のメールが届くため、管理者権限を承諾ボタンをクリックします。

3.LINE WORKS Developersで開発に関する設定を行う

LINE WORKSのサービス側の設定が完了したら続いてLINE WOKRS Developersサイトで、開発（API連携）する場合に必要な設定を行っていきます。

手順①ブラウザで、以下「LINE WOKRS Developers」サイトを表示します。

手順②サイトを表示したら、Developer Consoleをクリックします。

手順③API2.0のメニューをクリックして、アプリリストを表示したら、アプリの新規追加＋をクリックします。

手順④アプリの新規追加画面が表示されたら、アプリの名称を指定して、追加ボタンをクリックします。

例では、LINEWORKS_REST_APIと設定しています。

手順⑤アプリ情報の画面で、説明の情報を入力します。

ここに表示されるCliend ID、Cliend Secretの情報は、外部システムからREST APIを利用する際に必要となります。

手順⑥続いて、OAuth Scopeの選択を行います。ここで選択されたAPIは外部からコール可能です。

今回の検証では、Contactだけあれば検証可能ですが、一律すべてチェックしても構いません。

スコープに関する説明は、公式サイトで以下のように説明されています。

※引用元「LINE WORKS Developersドキュメント「OAuth Scopes」より

フリープランの場合、トークログの取得の権限（audit）などは表示されないため、利用できないようです。

手順⑦スコープを設定したら保存してアプリリストの画面へ戻ります。

4.Talend API Testerを使ってLINE WORKSのAPIをコールする

Talend API TesterのREST APIで、LINE WORKSのOAuthのクライアント認証を行う手順を説明します。

サポーターさん

Talend API Testerのインストール手順は以下の記事を参考にしてください。

参考

Talend API TesterのREST APIを使ってSalesforceにOAuthクライアント認証を行う

外部システムとSalesforceのデータ連携方法のひとつとして、Salesfo…

続きを読む

Talend API Testerを使ってLINE WORKSへOAuth認証を行う

ここからは、Talend API Testerを使って、LINE WOKRSにOAuth認証する手順を説明していきます。

手順①新規プロジェクトの作成：Talend API Testerの画面を表示したら、Requestsのタブ->「REPOSITORY」を開いて、MY DRYBEの「：」メニューをクリックして、[Add a project]を実行します。

手順②プロジェクト作成画面で、プロジェクト名を設定して＋Createをクリックします。

プロジェクト名：（例）LINEWORKS_REST_API　※任意の名称

手順③プロジェクトが作成されたら、今度は、プロジェクト名（LINEWORKS_REST_API）の「：」メニューをクリックして、「Add a service」を実行します。

手順④サービスの追加画面が表示されたらデフォルトのサービス名「Service」を修正しておきます。

サービス名：（例）API2.0

手順⑤サービス名を変更したら、＋Add a requestをクリックして、リクエストを作成します。

デフォルトのリクエスト名（Request）を実行するRequestの処理名に変更します。

リクエスト名：1.Authorization Codeの発行

以下の内容を設定します。

METHOD（メソッド）：GET（ゲット）

SCHEMA（スキーマ）：https://auth.worksmobile.com/oauth2/v2.0/authorize?client_id={Client_ID}&redirect_uri={Redirect_URL}&scope={Scope}&response_type=code&state={Free_Text}

クエリパラメータ：

1. client_id={Client_ID}　※LINEWORKS_REST_APIアプリ作成時に生成されたCliend ID
2. redirect_uri={Redirect_URL}　※アプリのRedirect URL（個々の環境に合わせて指定）
3. scope={Scope}　※Scopeで選択したAPIを指定、例では、Contact.readを指定
4. response_type=code（固定値）
5. state={Free_Text}　※任意の文字列
6. domein（任意）※設定する場合は、LINEWORKS管理画面に表示されてるドメインを指定

クエリパラメータの説明

※引用元「LINE WORKS Developersドキュメント「Authorization Codeの発行」より

手順⑥クエリパラメータの設定が完了したらSendをクリックして、GETメソッドを実行してみましょう。

ログイン画面で認証に失敗した場合、エラー画面が表示されます。

ログイン画面で認証に成功した場合、Redirect URL(redirect_uri)にリダイレクトされます。

※RESPONSE=200となっていても、返却された内容を確認すると以下のようにエラーメッセージが表示されている場合があります。

エラー内容：無効なOAuth Scopeです。

※LINEWORKSのアプリ作成時に設定（選択）したScope以外のものが指定されている場合に発生

正常終了の場合は、RESPONSE200が返却され、BODYには、以下の情報が設定されています。

code=発行されたAuthorization Code値、errorCode=00、state=パラメータで指定したStatte値

Authorization Codeを使って、Access Tokenを取得

続いて、正常終了で返却されたAuthorization Codeを使って、Access Token（アクセストークン）を取得するRequest（リクエスト）を作成します。

手順①Authorization Codeのリクエスト作成時と同じように、サービス（API2.0)にリクエストを追加して以下の設定を行います。

以下の内容を設定します。

METHOD（メソッド）：POST（ポスト）

SCHEMA（スキーマ）：https://auth.worksmobile.com/oauth2/v2.0/token

BODY FORMパラメータ：

1. code={Authorization Code}　※Authorization Code取得のAPIを実行して取得したCodeを指定
2. grant_type=authorization_code　※固定文字列
3. client_id={Client_ID}　※LINEWORKS_REST_APIアプリ作成時に生成されたCliend IDを指定
4. client_secret={Client_secret}　※LINEWORKS_REST_APIアプリ作成時に生成されたCliend Secretを指定
5. domain={domein}　※LINEWORKSのサービスのドメイン名を指定（Developer Consoleのメニューバーに表示されている）

※ドメイン名について、スタンダードプランの場合は、グループ名を指定します。また、ＳSO機能を利用する場合は指定が必須となります。

手順②パラメータ設定後、Sendをクリックして、POSTメソッドを実行してみましょう。

正常終了した場合は、以下のようにRESPONSE=200で、BODYに取得したアクセストークンが表示されます。

Access Tokenを使って、LINEWORKSの連絡先取得APIを実行

Access Tokenが取得できたら、このトークンを使って、実際にLINE WORKSのデータを取得するAPIを実行してみましょう。

ＡＰＩ実行前にデータの作成（アドレス帳に新規取引先を登録）しておきます。

手順①LINE WORKSのサービスへログインして、連絡先追加メニューを実行します。

手順②顧客/取引先の連絡先を作成画面で以下の情報を登録します。

取引先名、姓名、ニックネーム、会社、所属、電話番号、メールアドレス、公開範囲、編集許可

※必須項目のみ設定して保存しておきます。、

手順③Talend API Testerの画面に戻って、サービス（API2.0）に対して、もう一つ以下のRequestを追加します。

以下の内容を設定します。

METHOD（メソッド）：GET（ゲット）

SCHEMA（スキーマ）：https://www.worksapis.com/v1.0/contacts

HEADERS：Authorization：Bearer+半角SP+取得したAccess Tokenを指定

クエリパラメータ：

1. count=100　※取得するリストの件数を指定（例では最大100件まで取得するように指定）

クエリパラメータはほかにもたくさんありますが、今回は件数だけを指定して実行します。

※そのほかのクエリパラメータについては、公式ドキュメントを参照してください。

手順④パラメータを指定したらSendをクリックして、連絡先取得のGETメソッドを実行します。

実行した結果、以下のようにRESPONSE=200で、ContactsのJSONに値が返却されていればOKです。

（補足）参考URL

今回利用したAPIは、Contact（アドレス帳）取得のものですが、それ以外のAPIを検証してみたい場合は、公式サイトのAPIの利用ドキュメントが提供されているので、そちらを参考にしてください。

まとめ

今回は、Talend API Testerを使ったLINE WORKS のREST APIの利用方法を説明しました。

LINE WORKSが提供しているAPIはほかにもたくさんあるので、今回ご説明した手順で検証してみてください。

サポーターさん

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

にほんブログ村

本記事では、Gooole Chromeの拡張機能として提供されているTalendのAPI Testerを利用して、SalesforceにOAuthクライアント認証する手順を説明します。

REST APIテストのためのツールは、代表的なものとして、「swagger」や「Postman」などいくつかありますが、「Talend API Test」は、Chromeの拡張で簡単に利用できる以外にも以下のような利点があります。

はじめに

今回は、Salesforceの接続アプリケーションの機能を利用して、外部システムからAPI接続する方法をご紹介します。

接続アプリケーションを使用して、外部システム（アプリケーション）からSalesforce に統合するには、OAuth API（OAuth 2.0） を使用する必要があります。

※OAuth 2.0 は、トークンの交換を通してアプリケーション間の安全なデータ共有を認証するオープンプロトコルです。

以下の流れに沿って作業をしていく必要があります。

1.Salesforce組織で外部接続用のユーザを用意

外部システムからSalesforceにOAuth2.0を使ってクライアント認証をするためのユーザアカウントを用意します。

※既に作成されているユーザがある場合は、そちらを利用することも可能です。

ユーザアカウントを用意したら、ユーザが利用しているプロファイルに対して、「APIの有効化」のシステム管理者権限を付与します。

システム管理者権限：「APIの有効化」をONにして保存

2.接続アプリケーションの設定

Salesforceに外部システムからOAuth認証するには、接続アプリケーションの作成を行う必要があります。

手順①Salesforceにシステム管理者でログインして、設定->アプリケーションマネージャを実行し、新規接続アプリケーションのボタンをクリックします。

手順②新規接続アプリケーションの作成画面で以下、必用な情報を登録していきます。

以下、入力例

接続アプリケーション名：Talend API Tester

API参照名：Talend_API_Tester

取引先責任者メール：cclt@mail.com

手順③上記必須項目を入力後、API（OAuth設定の有効化）のチェックをONにすると以下の入力画面が表示されます。

以下、必須項目の内容を設定します。

コールバックURL：https://login.salesforce.com/services/oauth2/token

※接続先がSandboxの場合は、以下のURLとなります。

「https://test.salesforce.com/services/oauth2/token」

選択したOAuth範囲：以下を選択

・APIを使用してユーザデータを管理（api）： REST API や Bulk API 2.0 などの API を使用して、現在のログインユーザのアカウントへのアクセスを許可します。この範囲には、Connect REST API リソースへのアクセスを許可する chatter_api も含まれます。

・いつでも要求を実行（refresh_token,offline_access）：更新トークンを受け取る資格が要求元クライアントにある場合に、更新トークンを返すことを許可します。更新トークンにより、ユーザがオフラインのときにアプリケーションはユーザのデータを操作できます。このトークンは、offline_access を要求した場合と同じ意味になります。

OAuthの範囲の設定内容については、以下Salesforce公式サイトで確認ができます。

手順④上記設定完了後保存すると以下の確認画面が表示されます。こちらの画面では「次へ」をクリックします。

手順⑤設定後は、以下の画面でAPI（OAuth設定の有効化）のセクションにコンシューマキーと秘密の項目に、「コンシューマの詳細を管理」ボタンが表示されるので、クリックします。

手順⑥「コンシューマの詳細を管理」をクリックすると以下の画面が表示されます。（IDを検証）

手順⑦以下のメールが送信されるため、確認コードをコピーして、先ほどのID検証画面で確認コードをペーストして検証を実行します。

手順⑧以下の画面が表示されたらコンシューマ鍵とコンシューマの秘密の2つをコピーし、テキストエディタなどに保存しておきます。

※外部システムからREST APIでアクセスする際に利用します。

コンシューマ鍵を新規で作成する場合は、生成ボタンをクリックすると新規のコンシューマキーが生成されます。

ステージングされたコンシューマキーを適用すると以下のメッセージが表示されます。

新規コンシューマキーを生成して、適用した直後に外部システムからAPIでアクセスすると以下のようなエラーとなります。

error code : 400 Bad Request

error : “invalid_client_id”

上記エラーの場合は、数分程度待ってから実行して正常に接続できるか確認してください。

3.セキュリティトークンの発行

続いては、セキュリティトークンの発行手順となります。

外部システムからREST APIでOAuth接続する場合、利用するユーザに対してセキュリティトークンを発行して、ログインパスワード＋セキュリティトークンの組み合わせでパスワードのパラメータを指定する必要があります。

セキュリティトークンを発行せずOAuth認証した場合、以下のエラーが発生します。

error code : 400 Bad Request

error :  “invalid_grant”

error_description : “authentication failure”

手順①外部システムからOAuth認証で利用するユーザアカウントを使ってSalesforceにログインします。

手順②ログイン後、私の設定：個人設定画面で、「私のセキュリティトークンのリセット」メニューから「セキュリティトークンのリセット」を実行します。

手順③以下、リセットメール送信後、リセットされたセキュリティトークンの情報をメールで受信します。

メール本文のセキュリティトークン（大文字と小文字を区別）の値は、外部システムからREST APIを使ってアクセスする際に利用します。

4.外部システム側でのREST API接続設定

最後に、Talend API TesterのREST APIで、Salesforceに対してOAuthのクライアント認証を行う手順を説明します。

Talend API Tester インストール

まずは、Chromeの拡張機能「Talend API Tester」インストールしていきます。

手順①ブラウザChromeを起動して、以下のURLを入力するか、Chromeウェブストアを表示して、「Talend API Test」で検索します。

Talend API Testerが表示されたらクリックして詳細画面を表示します。

https://chrome.google.com/webstore/detail/talend-api-tester-free-ed/aejoelaoggembcahagimdiliamlcdmfm

手順②詳細画面で、Chormeに追加ボタンをクリックしてインストールします。

手順③Chromeにインストールが完了したら、アイコンをクリックしてTalend API Testerを起動します。

すると以下の画面が表示されるため、Use Talend API Tester – Free Editionをクリックして開始します。

以上で、インストールは完了となります。

Talend API TesterでSalesforceへOAuth認証

ここからは、Talend API Testerを使って、Salesforceにログイン認証する手順を説明していきます。

手順①新規プロジェクトの作成：Talend API Testerの画面を表示したら、Requestsのタブ->「REPOSITORY」を開いて、MY DRYBEの「：」メニューをクリックして、[Add a project]を実行します。

手順②プロジェクト作成画面で、プロジェクト名を設定して＋Createをクリックします。

プロジェクト名：（例）Salesforce REST API　※任意の名称

Also create a scenario：シナリオは今回は利用しないため、チェックはOFFにしてもよいです。

手順③プロジェクトが作成されます。※Scenarioにチェックを入れている場合は、Scnarioも作成されています。

今度は、プロジェクト名（Salesforce REST API）の「：」メニューをクリックして、「Add a service」を実行します。

手順④サービスの追加画面が表示されたらデフォルトのサービス名「Service」を修正しておきます。

サービス名：（例）Salesforce

手順⑤サービス名を変更したら、＋Add a requestをクリックして、リクエストを作成します。

デフォルトのリクエスト名（Request）を実行するRequestの処理名に変更します。

リクエスト名：ログイン認証リクエスト

手順⑥続いて、Open requestのボタンをクリックします。

手順⑦Request画面を表示するとデフォルトでは以下のような画面となっています。

手順⑧今回はSalesforceのOAuth認証をしてトークンを取得するリクエストを作成します。

以下の内容で設定を行います。

METHOD（メソッド）：POST

SCHEME：https://login.salesforce.com/services/oauth2/token

※SalesforceのOAuthトークンエンドポイントを指定します。接続先がSandboxの場合は、以下のURLとなります。

「https://test.salesforce.com/services/oauth2/token」

【HEADERS】

Content-Type：application/x-www-form-urlencoded

【BODY】

パラメータの設定方法は、今回はFORM形式で以下をそれぞれ指定します。

• grant_type：TEXT＝：password
• client_id：TEXT＝：接続アプリケーションで発行したコンシューマ鍵（例）3MVG95mg0lk4batiP7Q5f8gZVREE.2FpJFS…
• client_secret：TEXT＝：接続アプリケーションで発行したコンシューマ秘密鍵（例）E92AA80B028EC9D0A49AE2BEB296…
• username：TEXT＝：Salesforceユーザアカウント（例）cclt-integration-user@mail.com
• password：TEXT＝：ユーザのパスワード＋セキュリティトークン（例）userPasswordwMlVs4R6nsv9L9drIIuR

手順⑨上記Requestを設定したら、Sendボタンをクリックしてリクエストを実行してみましょう。

実行結果として、以下のようにResponseで200OKが表示されれば成功となります。

上記レスポンスBODYの「access_token」と「instance_url」を利用して、Salesforceのデータへアクセスすることができるようになります。

アクセストークンを利用してSOQLクエリを実行

今度は、OAuth認証を実行して取得したアクセストークンとインスタンスURLを使って、SOQLクエリを実行してみましょう。

手順①プロジェクト「Salesforce REST API 」のサービス「Salefsorce」以下の新規REQUESTを追加します。

Request名：（例）取引先責任者の名前を取得するクエリを実行

METHOD：GET

SCHEMA：取得したinstance_url//services/data/v50.0/query/?q=クエリ文

（例）https://cclt-dev-ed.my.salesforce.com/services/data/v50.0/query/?q=SELECT+FirstName+FROM+Contact

※取引先責任者（Contact）に対して、Firstname（名）を取得するSELECT文（SPの部分は+に置き換えが必要です）

HEADERS

Authorization：Bearer 00D5h000004bsqk!AQwAQB_PXWbdAQCP_SlAXxFdfhWwEOW….

※Bearer+半角SP+access_token

手順②上記を設定後、クエリのパラメータの横にある「：」をクリックしてEncodeにチェックがされていないことを確認して[Send]を実行します。

以下のようにResponse200OKが返却され、BODYに取得した取引先責任者の名前の情報が表示されます。

クエリパラメータがEncodeされている場合には、MALFOMED_QUERYのエラーが発生するので注意してください。

（補足）Salesforce組織でIPアドレス制限を実施している場合

IPアドレス制限を実施している場合、外部システム側が固定のグローバルIPアドレスがある場合は、IPアドレスをホワイトリストへ登録します。

固定のグローバルIPがない場合は、接続アプリケーションの設定で、IPアドレス制限の緩和をすることで接続が可能となります。

IPアドレス制限の緩和をすると、セキュリティが低下するため、更新トークンのポリシーを厳格化するなどの考慮が必要です。

まとめ

今回は、Talend API Testerを使ったOAuthクライアント認証の手順を説明しましたが、他のツールやシステムからSalesforceにREST APIでアクセスする際も同様の設定手順となるため、手順を参考に設定をしてみてください。

サポーターさん

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

にほんブログ村

前回の記事で、Summer 22で動的関連リストが利用できるようになりましたが、さっそくプロジェクトで利用してみたところ、まだ機能制限があったり今まで関連リストで実現できていたことができないなど、まだ現時点では不便だと感じる部分があります。

以下、前回の記事「動的関連リスト」

参考

Salesforce 動的関連リストの使い方（Summer22新機能）

今回の記事では、Summer’22で公開された新機能（動的関連リスト）の利用方法…

続きを読む

特に、モバイルを利用するプロジェクトの場合、現時点（2022/07/09)では、利用できずタブ毎表示されなくなるため、注意が必要です。

また、動的関連リストでは、通常の関連リストと同様デフォルトで最大30レコードまで表示可能ですが、通常の関連リストと異なり、すべて表示する機能がありません。

そのため絞り込みをして30件までで業務上問題なければ動的関連リストを使えますが、すべて表示することが必須という場合には、レポートを作成して動的関連リストにアクションを追加してレポートへ遷移させるなどの工夫が必要となります。

サポーターさん

これらの問題を解決することができる製品が今回ご紹介する（List Editor）となります。

List Editorでは以下のような機能が用意されています。

では、さっそく製品のインストールから設定までの手順をご紹介していきたいと思います。

List Editorのインストール

まずは、List Editorのインストール手順となります。現時点では、英語版しかないため、日本語のAppExchangeで検索しても出てきません。

手順①以下のURL（App Exchange） をブラウザで指定して開きます。

https://appexchange.salesforce.com/appxListingDetail?listingId=a0N3u00000PFXi6EAH

手順②以下のページが表示されたらGet It Nowボタンをクリックします。

手順③ログインするアカウントを選択します。Salesforceでログインをクリックします。

手順④ログイン後、インストール組織を選択します。インストール権限のあるユーザアカウントを選択して、本番組織にインストールする場合には、[Install in Production]を、サンドボックスにインストールする場合には、[Install in Sandbox]をクリックします。

手順⑤続いて、インストール先組織の確認を実施します。正しければ[Confirm and Install]をクリックします。

手順⑥インストール先組織のユーザに対するアクセス権限を指定します。（今回はすべてのユーザを選択）

手順⑦インストールおよびアクセス権の付与処理が実行されます。

手順⑧インストールが完了すると以下の画面が表示されるので、完了ボタンをクリックします。

※メールアドレスにも完了の通知が届きます。

以上で、製品のインストールは完了となります。

List Editorの利用方法（設定手順）

続いては、インストールしたList Editorの使い方（設定方法）を説明していきます。

※今回は取引先画面に対して、取引先責任者をList Editorで設定してみます。

手順①取引先の参照画面から編集ページを実行します。

手順②編集ページでは、コンポーネントのカスタムにList Editorが表示されているため、これをドラッグ＆ドロップでお好きな場所へ配置します。

手順③以下の例では、関連リストタブのトップにList Editorのコンポーネントを配置しました。

手順④続いて、コンポーネントを選択して、パラメータを指定していきます。

・Object Api Name：に取引先責任者（API参照名：Contact）を指定します。

するとコンポーネントがリフレッシュ取引先責任者の情報が表示されます。名称の指定を間違えると正しく表示されません。

・Display Fields：こちらには項目のAPI参照名を指定します。（カンマ区切りで複数設定可能）

・Default order field：並べ替えをする項目のAPI参照名を指定します。（複数指定可能）

・Descending order：チェックすると降順での表示となります。

・Number of lines to display：デフォルトの表示行数（最大30まで指定可能）

・Parent reference field name（オプション）：親レコードの参照項目を指定、複数の親オブジェクトの参照がある場合には切替が可能

・List filter：デフォルトの絞り込み条件を指定：SOQLでのWhere句の表現で絞り込み条件の指定が可能です。（例：name like ‘%2’）

・List Label Name：ラベルのタイトルを指定することができます。

・Do not allow editing：チェックするとレコードの編集ボタンが非表示になります。

・Do not allow new creation：チェックすると新規子レコードの作成ボタンが非表示になります。

・Do not allow reloard：チェックするとレコードの更新（リフレッシュ）ボタンが非常時になります。

・Do not allow text search：チェックするとテキストの検索ボックスが非表示になります。

・Do not allow record action：チェックするとレコードの行に編集や削除のアクション▽が表示されなくなります。

・Do not allow delete on edit：チェックするとレコードの削除ボタンが非表示になります。

手順⑤上記内容を設定後、保存して取引先画面を表示してみましょう。

以下のようの取引先に紐づく担当者の一覧が表示されます。

List Editorの利用方法

基本的な設定が終わったら実際に利用してみましょう。

【新規作成】

List Editor上の（New）ボタンをクリックすると新規取引先責任者の登録画面（標準）が表示されます。

手順②必要な情報を入力して保存します。

手順③保存するとレコードが追加されたことが確認できます。

【レコードの編集（個別）】

手順①個別に1レコードだけ編集した場合は、レコードのアクションメニューからEditを実行します。

手順②編集画面は標準と同じです。レコードを編集して保存をクリックします。

【レコードの一括編集】

手順①以下のように複数レコードが存在して一括編集したい場合には、鉛筆マークのボタンをクリックします。

手順②以下のように一括編集画面が表示されます。値の変更やレコードの削除などが可能です。

List Editorのコンポーネントのカスタマイズ（その他）

List Editorのコンポーネントは、以下のようなカスタマイズが可能です。

（ヘッダ背景色、テキスト色、レコードの偶数行の背景色の変更）

例：背景色をピンク、テキストを白、行をスカイブルーに変更しています。※英単語や16進数（#ffffffなど）での指定が可能です。

16進数で指定した場合

（アイコンの色、アイコンの背景色）

アイコンの色や背景色の変更も可能です。※アイコン自体の指定はできないようです。

最後にイメージの高さと幅の指定が可能となっています。

まとめ

以上で、List Editorのコンポーネントのインストールからカスタマイズまでの説明が完了となります。

ご紹介した通り、かなり便利で実用的なコンポーネントとなっていて、開発なしでこれらの機能が利用できるのであれば、動的関連リストの代わりにとしては十分な気がします。

注意点としては、自由入力での検索は、リストビューと同じようにテキスト項目や選択リスト値に対してしか検索できないため、ロングテキスト型を利用している場合には注意が必要です。

また、ロングテキスト型を配置した場合には、その項目での並べ替えはできません。（現状ではソートしようとするとExceptionが発生します）

※標準のリストビューでは、ソートできないように制御されていますが、そこの制御がまだ実装されていない気がするので、ご利用の際は注意が必要です。

サポーターさん

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

にほんブログ村

サポーターさん

関連リストのオブジェクト内の項目を使ってのフィルタリングができるようになりました

これまでは、Lightning Recordページ内に関連リストを追加しても、関連リストに対しては親オブジェクトの条件での絞り込みしかできませんでしたが、Summer’22（2022年6月12日リリース）の動的関連リスト（Dynamic Related List）を利用することで、関連リストのオブジェクト項目を使っての絞り込みができるようになりました。

ただし、この機能を使うことで制約事項もあるため、合わせてご説明していきたいと思います。

動的関連リストの概要

動的関連リストは、以下、Lightning アプリケーションビルダーから利用することができます。

動的関連リストの設定手順

続いては、動的関連リストの設定手順を説明していきます。

今回は、取引先のLightning レコードページに商談の動的関連リストを設定する例でご説明します。

手順①システム管理者でログイン後、取引先のタブをクリックして、取引先一覧を表示します。

手順②取引先レコードを選択して、詳細画面を表示します。

手順③設定メニューから「編集ページ」を実行します。

※もしくは手順①～③の手順かわりに以下、オブジェクトマネージャで取引先オブジェクトを選択後、Lightning レコードページを編集する流れでも構いません。

手順④Lightning アプリケーションビルダーの画面にて、[関連リスト – 1つ]のコンポーネントをお好きな場所へ配置します。

※注意事項として以下の記載がありますが、動的関連リストは、複数関連リストでは有効化できません。

動的関連リストは、既存の [関連リスト – 1 つ] コンポーネントでのみ使用できます。リストの表示ラベル、その項目、そのページアクション、およびその検索条件を設定するには、[動的関連リスト – 1 つ] コンポーネントを使用してください。

必ず「関連リスト – 1つ]のコンポーネントを利用するようにしてください。

手順⑤追加した関連リストを選択いて、以下の内容を設定します。

親レコード：この取引先を使用

関連リスト：商談

関連リスト種別：デフォルト（お好きなものを選択して構いません）

手順⑥続いて、動的関連リストにアップグレードの内容を確認して、「アップグレードに関するお問い合わせ」のリンクをクリックして、動的関連リストを有効化します。※実際にお問い合わせするわけではないです。

手順⑦動的関連リストを有効化すると以下の図のように設定可能な項目が変更されます。

手順⑧動的関連リストの設定は、関連リストのオブジェクトの項目を使って検索条件を設定することができます。

検索条件を追加ボタンをクリックしてください。

手順⑨検索条件の設定画面が表示されます。（例では商談のフェーズがClosed Wonのレコードを抽出としました）

項目：フェーズ

演算子：次の文字列と一致する

値：Closed Won

保存すると以下のように表示されます。

変更が確認できたら、保存、有効化を実施してアプリケーションビルダーを閉じます。

手順⑩取引先に関連する全ての商談を確認します。

以下の例では、Prospecting,Closed Lost,Closed Wonの3種類のステータスを用意しています。

手順⑪設定した動的関連リストの画面を確認します。

動的関連リストには、1件（フェーズ：Closed Won）が表示されています。一方標準の関連リストでは、3件すべて表示されています。

最後に制約事項をお伝えしておきます。

動的関連リストと標準の関連リストを見比べていただくとわかりますが、動的関連リストには、すべて表示というメニューが表示されていません。

（≒動的関連リストでは、全ての検索した結果を表示することができず、最大で30件までのレコードの表示制限となります）

※2022年6月15日の調査時点

設定手順は以上となります。

制約事項への対応方針

・動的関連リストで全てのレコードを表示できない問題

対応方針：同じ条件のレポートを作成しておき、動的関連リストのアクションを追加する。（レポートURLを実行するボタンを作成しておき、パラメータのIDには表示しているレコードのIDを渡す）

・モバイル対応

対応方針：Salesforce LabsがApp Exchangeで無償提供している製品「List Editor」を利用する。

このList Editorは、かなり汎用性が高い製品となっています。Record Hunterと使い勝手（設定）は似ていますね。

以下の画面のように、取引先に紐づく取引先責任者（担当者一覧と名前を変更しています）表示可能です。

機能も豊富で、以下のようなことができます。

• 親レコードに関連する子レコードを表示可能（30件以上も表示できます）
• 表示する子レコードの条件指定が可能（例えば、名前にAAAが含まれるなどSOQLのWHERE句と同じ条件が指定可能）
• 一括編集機能（複数のレコード項目を一括編集することができます）
• 項目の並び替えやリフレッシュ
• テキスト項目の検索（絞り込み）※自由入力で部分一致検索が可能（ただしロングテキストエリアは検索不可のため注意）
• 新規子レコードの登録ボタン表示
• 背景色、テキストの色、アイコンの色、レコードの背景色の変更などが可能

一括編集画面（サンプル）

App Exchangeのリストエディタ「List Editor」に関するインストールから設定手順の詳細に関しては、こちらの記事を参照ください。

参考

リストエディタList Editor (Salesforce Labs公式)を使ってみよう

今回の記事では、Salesforce Labsが提供しているList Edito…

続きを読む

まとめ

今回は、Summer’22で公開された新機能（動的関連リスト）の使い方や制約事項についてご説明しました。

お客様から関連リストの絞り込みについては以前から要望が多かったため、実現されて非常に喜ばれています。

表示件数については、もしかすると何かの設定で可能かもしれませんし、将来的には実現されるかもしれません。

どうしても要件として必要な場合には、これまで通り、リストビューとLWCの組み合わせで対応する必要があるかもしれません。

※リストビューを使っての実現方法は別途ご紹介いたします。

サポーターさん

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

にほんブログ村

前回の記事では、Tableau Viz Lightning Web Component for Salesforceを使ってTableau Onlineのコンポーネントを表示する方法を説明しましたが、実際にプロジェクトで利用する場合には、セキュリティ上Tableau側への連携は認証が必要になると思います。

参考

Tableau Viz Lightning Web Component for Salesforceを使ってみよう

SalesforceのデータをTableauを使って分析するといえば、Table…

続きを読む

※Tableau Onlineのトライアル環境を利用したい場合は、上記記事を参考にセットアップしておいてください。

SalesforceからTableauのコンポーネントを利用する場合に、都度IDとパスワードを入力して認証してから利用することも可能ですが、毎回ログインするのは面倒です。

今回ご紹介する手順でSSO設定することで、Salesforceへログイン後は自動的にTableauも認証されるようになります。

Tableau OnlineのSAML認証設定

Tableau Onlineにシステム管理者としてログインしておきます。

手順①左サイドバーのメニューから設定を実行して、設定画面を表示します。

手順②以下の警告メッセージが表示されます。問題なければ続行します。

手順③認証タブをクリックして、認証タイプで追加の認証方法を有効にするを選択後、SAMLをクリックします。

手順④SAMLの中に表示されている、「＞接続の編集…」をクリックします。

上記の中からTableau OnlineエンティティIDとアサーションコンシューマーサービスURLをそれぞれコピーして、テキストに保存しておきます。

※あとでSalesforce側の設定時にペーストして利用します。

SAML ID プロバイダとしての Salesforce の有効化

まず、Salesforce側の設定を実施します。

Tableau Viz Lightning Web Component for Salesforceを利用するSalesforce 組織を外部サービスプロバイダに対するシングルサインオン (SSO) SAML ID プロバイダとすることができます。

手順①Salesforceへシステム管理者としてログイン後、設定->IDプロバイダを実行し、以下の画面からIDプロバイダを有効化するを実行します。

手順②IDプロバイダの設定画面で、証明書を選択します。※自動的に作成されるものがデフォルトで選択されるのでそのまま保存します。

手順③以下の警告メッセージが表示される場合があります。問題なければＯＫをクリックします。※すでに別のサービスのSSOを使っている場合は注意してください。

警告メッセージ「IdP証明書を変更しようとしています。証明書を変更すると、既存のサービスプロバイダが機能しなくなる可能性があります。継続してよろしいですか？

手順④ＩＤプロバイダの情報が表示されます。ここでは、「証明書のダウンロード」、「メタデータのダウンロード」をそれぞれ実行してファイルをダウンロードしてください。

手順⑤以下ダウンロードしたファイルはあとで利用するため、保管用のフォルダへ配置しておいてください。

手順⑥設定->アプリケーションマネージャを実行します。

手順⑦新規接続アプリケーションを実行します。

接続アプリケーション名は、サービスの内容がわかるような名前を指定してください。

手順⑧続いてWebアプリケーションの設定項目で以下の内容を指定します。

開始URL：Tableau Onlineのログイン後のホーム画面のURLを指定します。

SAMLの有効化にチェックを入れます。

手順⑨SAML有効化すると以下の項目が表示されるため、最初にTableau Onlineの認証画面で取得した以下のエンティティIDとアサーションコンシューマーサービスURL（ACS）を使って、値を設定します。

※Tableau Onlineで取得した情報

エンティティIDとACS URLをコピー＆ペーストで間違いないように入力します。

手順⑩件名種別では、今回は統合IDを指定します。

※Salesforceのユーザ名は全世界で一意の値にする必要があり、Sandboxなどで検証したり、本番移行の際にユーザ名をTableau Online側と一致させるのが難しい場合が多いため、ユーザオブジェクトの統合ID項目を利用してSAML認証を行います。

手順⑪nameidのフォーマはメールアドレスを選択します。

手順⑫IdP証明書を選択します。※手順②で作成した証明書を選択します。

手順⑬SAMLメッセージの署名アルゴリズムでSHA256を選択します。

手順⑭これまで設定した内容を保存します。

②接続アプリケーションの権限セット作成

Tableau Onlineへの接続アプリケーションをユーザが利用できるように権限セットを作成して、ユーザへ付与します。

手順①設定->権限セットの画面を表示します。「新規」のボタンをクリックします。

手順②権限セット作成画面にて、ラベル名とAPI参照名を指定して保存します。

※ライセンスを指定する場合は、ライセンスの選択リストで適切なライセンスを選択してください。

手順③権限セット概要から、割り当てられた接続アプリケーションをクリックします。

手順④割り当てられた接続アプリケーションの「編集」ボタンをクリックします。

手順⑤接続アプリケーションインストール済から作成したTableau Onlineの接続アプリケーションを有効化の方へ追加して保存する。

手順⑥保存後の画面で、「割り当ての管理」ボタンをクリックします。

手順⑦「割り当てを追加」ボタンをクリックします。

手順⑧権限セットを追加したいユーザ（Tableau OnlineのSSO接続対象のユーザ）を選択して「割り当て」ボタンをクリックします。

※Salesforceの設定->IDプロバイダイベントログにて、SSOの状況が確認できますが、権限セットを付与していない場合、以下のエラーが表示されます。

「エラー: ユーザにこのサービスプロバイダへのアクセス権がありません 」

※ ユーザは SAML 対応接続アプリケーションの使用を許可されていません。たとえば、適切な権限セットまたはプロファイルがありません。

Salesforceユーザの統合IDを指定する

手順①設定->ユーザからTableau OnlineとSSO接続するユーザを選択し、統合IDを編集する

今回はテスト用ユーザ1名について、統合IDにメールアドレスを設定する。※Tableau Onlineのユーザ名と一致させること。

つづいて、Tableau Online側の作業を行います。

Tableau OnlineのSAML認証設定

Tableau Onlineにシステム管理者としてログインしておきます。

手順①左サイドバーのメニューから設定を実行して、設定画面を表示します。

手順②SAMLの中に表示されている、「＞接続の編集…」をクリックします。

手順⑤Tableau Onlinにメタデータファイルをインポートで、IdPメタデータファイルにSalesforceからダウンロードしておいたメタデータファイルをインポートします。

手順⑥ダウンロードしておいたメタデータファイルを指定します。

手順⑦ファイルがインポートされたら適用を実行します。

手順⑧埋め込みオプションをONに設定します。

インラインフレームを使用する認証（低いセキュリティ、すべてのIdPでサポートされていない）

手順⑨ユーザの管理から、ユーザの追加を実行する。

※Salesforceのユーザ項目の統合IDに指定したメールアドレスと一致するユーザを作成する。

例：sfdc.tableau.sso@email.com

手順⑩上記手順で追加したメールアドレスに以下のメールが届いていることを確認する。

メール内リンクから「Start Exploring」を実行する。

手順⑪Salesforceにリダイレクトされるため、統合IDを設定したユーザでログインする。

手順⑫Salesforceへログイン後、SSO認証後Tabelauのホーム画面へ遷移する。

※ログインできずにエラーになっている場合は、ここまでの設定がうまくいっていない可能性があるため、本記の「SSO接続エラーの対処方法」を参照して、原因の特定をしてください。

最後に、Salesforceへログインして、Tableau viz componentの画面がSSOで認証され正常に表示されることを確認します。

設定->IDプロバイダイベントログで、状況が成功になっている確認します。

Tableau viz componentが表示されることを確認する。

※ワークブックが正しく表示されない場合は、Tableau OnlineでSSOユーザにアクセス権限が付与されている確認してください。

SSO接続エラーの対処方法

Salesforce側で調査

・設定->IDプロバイダイベントログを確認する。

※SSO対象ユーザのイベントログが確認できる。エラー内容を確認して対処する。

エラーメッセージの詳細な内容は、Salesforce公式のHelpページにて確認することができます。

補足

Tableau の公式HPより参考になる手順が書かれているページがあるのでこちらも参考にしてください。

まとめ

Tableau viz componentをSSOで接続する手順について説明しました。

サポーターさん

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

にほんブログ村

しかし既にTableauをお使いの場合には、蓄積したデータや作成したコンポーネントをSalesforceに連携してSalesforce上で利用（表示）するという方法もあります。

「 Tableau Viz Lightning Web コンポーネント」を使用すると、SalesforceのLightning ページでTableau ビューを 簡単に表示することができます。

今回の記事では、SalesforceのAppExchangeで公開されている「Tableau Viz Lightning Web Component for Salesforce」を使って、Tableauで作成したコンポーネントをSalesforce Lightningページ表示する方法をご紹介いたします。

この方法を使うと、Salesforceの標準機能で実現が難しいレポートやダッシュボードをSalesforce側の開発をせず、Tableauの標準機能で作成して、それをSalesforce上で参照するという使い方ができるため、作業工数の削減や品質向上につなげることができます。

では、さっそくセットアップ手順を説明していきたいと思います。

Tableau Viz Lightning Web Component for Salesforceのセットアップ手順

前提：Tableau製品には大きくクラウド型（Tableau Online）とオンプレミス型（Tableau Server）の2種類が存在します。

今回は、クラウド型サービスのTableau Onlineを使って、Salesforceとの連携を実現します。

※Tableau Onlineについては、現在14日間のトライアルが無料で利用可能となっています。

セットアップの手順（概略）は以下となります。

セットアップ（実践）

では手順に従ってさっそくセットアップを進めていきましょう。

１．Tableau Online のサインアップ

まずは、Tableau Onlineのトライアルの申し込みを行います。すでに自社でTableau Onlineをご利用の場合は、本ステップはスキップしてください。

①以下、Tableau の公式HPへアクセスします。

以下の申し込み画面で、必要事項を入力して無料トライアル版をリクエストのボタンをクリックします。

②申し込み後、以下の画面が表示されます。

③申込時に指定したメールアドレスに以下のメールが届きますので、「Activate My Site」のボタンをクリックします。

④ブラウザで以下の画面が表示されます。必要事項を入力して、もう一度「Activate My Site」を実行します。

・姓名、パスワード、サイト名（Tableau Online上に表示されます）を入力

・ロケーション：日本を指定

・利用規約に同意のチェックをします。

⑤次に進むと、以下のようなWelcome to Tableau！画面が表示されて、Tableau Onlineが利用できるようになります。「Next」ボタンをクリック。

⑥Salesforce Customerの確認メッセージが表示されますが、ここでは接続せずスキップしておきます。

⑦Tableau Onlineのホームが面が表示されます。ログインユーザはシステム管理者権限を持っています。

２．Tableau Online側からSalesforceに接続して商談ダッシュボードを作成

つづいて、Salesforce組織に接続して、商談データを使ったダッシュボードをTableau Onlineに作成していきます。

①ホーム画面のダッシュボードスターターからSalesforceを選択します。

②ダッシュボードの選択画面で、商談の概要というものがあるためこちらを選択して「Salesforceにサインイン」をクリックします。

※その他のお気に入りのダッシュボードがあればそちらを利用していただいても構いません。

③Tableau OnlineからSalesforceに対するアクセスを認証するため、接続先組織のユーザ名とパスワードを入力してログイン認証します。

④以下のようにアクセス許可を求める画面が表示されるため、許可のボタンをクリックします。

⑤アクセスを許可すると、Tableau Online側で自動的にSalesforceに接続し必要なデータを収集してダッシュボードを自動生成します。

⑥ダッシュボードの生成が終わると、以下のような画面が表示されます。

※以下はスマートフォン用のVIEWで表示した場合のレイアウトとなります。

⑦続いて、作成したTableau VIEWを公開します。画面左上の「パブリッシュ」のボタンをクリックします。

⑧ワークブックのパブリッシュ画面が表示されます。

⑨ワークブックの名前を指定して、保存先のプロジェクトを選択します。

データソースのパスワードの埋め込みは今回はSalesforce側はサンプルデータを利用しているため指定しませんが、必要な方は設定してください。

登録・設定が終わったら、「パブリッシュ」ボタンをクリックします。

⑩パブリッシュ後にブラウザのURLをコピーしておきます。

３．AppExchange「Tableau Viz Lightning Web Component for Salesforce」をインストール

今度は、Salesforce側の作業となります。AppExchangeの「Tableau Viz Lightning Web Component for Salesforce」をSalesforce組織にインストールします。

①以下、Tableau公式HPのリンクからAPPExchangeのサイトへ行き、「Get It Now」をクリックします。

※直接のAppExchangeのリンクは以下となります。

②次にTrailblazer.meのほうでログインします。

③アプリケーションをインストールする対象の組織へログインするためのユーザ名、パスワードを指定します。

※Sandboxの場合、URLが異なるので注意してください。

④ID検証の画面にて、メールアドレスに通知された確認コードを入力して検証を行います。

⑤続いて、左側のInstall in a Salesforce Orgのメニューで、インストール先の組織を選択して、Install in Production（本番環境へのインストール）または、Install in Sandbox(サンドボックスへのインストール)をクリックします。

※今回の説明ではDeveloper環境へのインストールのため「Install in Production」にて実行します。

⑥インストール情報を確認して問題なければ、「Confirm and Install」を実行します。

⑦インストール先のユーザを指定します。※必要なオプションを選択してインストールを実行してください。

⑧インストールが完了すると以下の画面が表示されます。

４．Tableau viz ComponentにTableau Onlineで作成したビューを表示

最後に、SalesforceのLightningページにTableau Onlineで作成したビューを表示します。

①Salesforceにシステム管理者でログイン後、お好きなLightningページに遷移して、ページの編集を行います。

※以下の例では、ホーム画面のページを編集しています。

②アプリケーションビルダーのページ編集画面にて、コンポーネント一覧に表示されているTableau Visualizationをドラッグアンドドロップで、画面に配置します。

③Tableau Visualizationのコンポーネントをクリックしてプロパティを表示します。（右ウィンドウ）

Tableau viewのURLを指定するところに、Tableau OnlineでパブリッシュしたあとにコピーしておいたURLを貼り付けます。

④画面を有効化して保存しておきます。

ホーム画面を表示すると以下のようにSalesforceからTableau Onlineにアクセスして、商談ダッシュボードを表示することができました。

もちろんこのままTableau Onlineの機能を使って、ダッシュボードを作成したりすることもできます。

※Salesforce上からTableau Onlineを使って、Salesforce上にあるデータを使ってダッシュボードを作成するということができるため、Salesforce標準ダッシュボードやレポートの代わりに利用するといった使い方もできるということです。

ただし、以下のようにデータの送受信が発生するためデータ量によっては、ある程度待ち時間が発生するので注意してください。

（補足）Tableau Onlineでパブリッシュする際にパスワードを設定している場合は、以下のようにTableau Onlineにサインインのメニューが表示されます。毎回サインインするのが面倒な場合には、SAML認証を使ったシングルサインオンの対応も可能です。

まとめ

いかがでしたでしょうか。今回はTableau Onlineを使って作成したビューをSalesforceに表示しましたが、もちろんTableau Serverでも同様のことが実現可能です。

※Tableau Serverもトライアルが用意されているので、興味がある方はお試しください。

SAML認証を使ったSSOの設定については、少し複雑な設定が必要となるため、別の機会に記事にしてご説明したいと思います。

サポーターさん

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

にほんブログ村