過去に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をどのように使いこなすかが問われる時代になりますね。自分の価値をどこで出すか本気で考えていく必要がありそうです。

サポーターさん

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

にほんブログ村

今回は、TODOを複数ユーザに対して一括で割り当て（レコードを作成）する手順をご説明いたします。

参考

【Tips!】リストビューで選択したレコードを引数にして画面フロー(Flow)を実行する方法

本日のTips!は、リストビューで選択したレコードを引数にしてフローを実行する方…

続きを読む

活動（Event/Task）について

まず初めにわかりにくい部分から説明したいと思います。SalesforceではTodoというオブジェクトは存在しません。

活動登録として利用されるオブジェクトは行動（Event）とTODO（Task）の2つのオブジェクトがあります。

上記の取引先画面の右側にある活動タブには、デフォルトでは新規ToDo、活動の記録、新規行動、メールのタブがあります。

この画面から新規ToDoを登録すると取引先に紐づいた新規のTodo（Taskレコード）が生成されます。

実際に表示されたレコードを見てみましょう。開発コンソールを使って次のクエリを実行します。

</p>
<p>SELECT Id, WhoId, WhatId, Subject, ActivityDate, Status, OwnerId FROM Task</p>
<p>

Taskオブジェクトに新規ToDoのレコードが生成されていることを確認できます。

WhatIdには、001から始まるAccount（取引先）が設定されています。WhoIdには、取引先責任者と紐づく場合に設定されます。

Todoの登録と同様に行動を登録した場合には「Event」オブジェクトにレコードが作成されます。

EventとTaskのオブジェクトの関係性（ER図）については、以下公式サイトで確認することができます。

またArchitect.salesforce.comでも活動関連（Task,Event）のEntityを確認することができます。

画像ダウンロード元：Salesforce Architecsサイト「Tasks ＆Events」（https://architect.salesforce.com/diagrams/template-gallery/platform-task-events-data-model）

※今後はこちらのサイトに集約されていくようです。

（活動履歴に関する補足）

行動に設定されたスケジュールが過ぎて過去の日時になった場合には、自動的に活動履歴のデータとして扱われるようになります。

1.複数のユーザに一括でTodoを割り当てる手順

複数のユーザに一度にTodoを割り当てる手順を説明していきますが、まず注意点があります。

最初に説明した、以下の取引先画面からTodoを作成する場合には、複数ユーザを割り当てることができません。

複数ユーザへの一括割り当て方法は以下の手順で実施します。

手順①Todoのタブから新規ToDoを実行します。

手順②新規ToDoの作成画面を開くと、割り当て先の選択リストから人（ユーザ）、グループ（公開グループ）、キューが選択可能となっています。今回の例では、人（ユーザ）を選択します。

手順③続いて「人を検索」の欄にユーザ名を入力して表示されたユーザを選択します。例では山田太郎を選択

手順④割当先に複数のユーザを指定したら、件名などその他の情報を入力して保存ボタンをクリックします。

手順⑤保存すると指定した人（ユーザ）に対して、それぞれTodo（Taskレコード）が生成されます。

以下、一人名のTodoを表示

以下、同時タイミングでもう1名のTodoも生成されていることが確認できます。（割り当て先が異なる）

ToDoの生成と同時に、ToDoを割り当てられたユーザにはメールが通知されます。

開発者コンソールで再度Taskのレコードを取得するクエリを実行すると同時に複数のTaskレコードが生成されていることが確認できます。割り当て先（OwnerId）が異なっていることがわかります。

以上のように、Todoを複数のユーザに割り当てた場合、1つのTaskレコードに複数のユーザが設定されるわけではなく、あくまで一人のユーザには1つのTaskレコードが作成されることになります。

※1つずつToDoを作成するのと結果は同様になりますが、一括のほうが作業効率は高くなるため業務に合わせて使い分けるとよいでしょう。

（補足：その他注意事項）

Salesforce公式HELPサイト「Assign New Tasks to Multiple People, Public Groups, and Queues in Lightning Experience」

https://help.salesforce.com/s/articleView?id=000380133&type=1

関連するTrailheadモジュール

今回ご紹介したTODO（Task）、行動（Event）に関してもう少し詳しく学習した場合は、Trailheadに関連するモジュールがあるので、チャレンジしてみてください。

まとめ

サポーターさん

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

にほんブログ村

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でアクセスする際も同様の設定手順となるため、手順を参考に設定をしてみてください。

サポーターさん

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

にほんブログ村

Winter’23のバージョンアップに伴い、ワークフロールールーの新規作成が廃止予定となっています。（Sandboxプレビューは2022年8月後半から、本番適用は2022年10月予定）※プロセスビルダーはもう少し先のSpring’23予定

サポーターさん

ワークフローの新規作成はできませんが、すでに作成しているものは継続利用可能ですし、変更可能な予定となっています

Salesforceでは、すでに作成済みのワークフローを自動でフローに移行するためのツール（フローに移行：Migrate-to-Flow）が用意されています。

今回は、このツールを使ったワークフローの移行手順や制約などについてご説明したいと思います。

フローに移行ツールについて

Spring’22のバージョンアップの際に、フローに移行（Migration to Flow)機能がリリースされました。

このツールを利用すると、ワークフロールール・プロセスビルダーをフローに自動変換することが可能となります。

下図の通り、設定メニューに「フローに移行」機能が表示されることが確認できます。

基本的には、このフローに移行ツールを利用することで、簡単にフローに移行することができますが、対応できないワークフローや制約事項もあるため、完全に自動で移行ができるというわけではありません。

実際にツールを使いながら変換手順や制約事項について説明していきたいと思います。

制約事項について

まず、制約事項について公式サイトからの内容に基づいて説明します。（以下公式サイトより）

現時点で、「フローに移行ツール」がサポートされるワークフロールールは、以下のようになっています。

上記公式サイトに記載の通り、フローに移行ツールで移行できないものも以外と多いので注意が必要です。

この場合、利用している機能に合わせて、手動での変更が必要となります。簡単なもの（例えば項目自動更新だけの処理）などは、フローで直接作り直しをしたほうが早い場合もあります。

ロジックが複雑なものは一から作成するのも大変なので、移行できない部分だけを許可されている処理やコンポーネント（アクション）に置き換えなどをして移行ツールを利用後に、フローのロジックとして修正するほうがよいでしょう。

ワークフロールールをフローに移行する手順

今回は、新規ワークフロールールを作成後、フローに移行ツールを使って実際に移行作業を実施してみたいと思います。

では、さっそく手順通り進めていきたいと思います。まずは、ワークフローの作成からとなりますが、実際の移行作業では既に組織で作成済みのワークフローを使って作業することになります。

新規ワークフロールールの作成

手順①システム管理者にてSalesforce 組織にログインして、設定->ワークフロールールを実行します。

手順②ワークフロールール画面にて、新規ルールをクリックします。

手順③Flow Builderで試しますか？と確認されますが、ワークフロールールで続行します。

手順④オブジェクトの選択で、取引先責任者を指定して、次へをクリックします。

手順⑤新規ワークフロールールの設定では、以下のように設定して保存＆次へをクリックします。

ルール名：役職未指定時のルール

評価条件：作成されたとき、および編集されるたび

ルール条件：取引先責任者：役職がNULL（ブランク）と一致する場合　※役職が未指定の場合

手順⑥続いて、アクションを追加していきます。まずは、新規Todoをクリックします。

手順⑦新規Todoの画面では、以下の内容を設定し、保存＆新規をクリックします。※設定内容はお好きな内容で構いません。

割り当て先：取引先責任者所有者

件名：役職の更新タスク

期日：ルール適用日

手順⑧続いてはメールアラートを追加します。

設定内容は、適当で構いません。

手順⑨最後に項目自動更新のアクションを以下の内容で追加します。

更新する項目：役職

項目値の指定：”なし”

手順⑩以下の通り、3つのワークフローアクションが追加できたら、ワークフロールールを有効化して完了となります。

有効化されたら動作検証しておきましょう。取引先責任者の作成または更新で、役職を未指定とした場合に、役職に”なし”が設定され、TODOの追加とメール通知がされることが確認できればよいです。

フローに移行ツールを実行

先ほど作成したワークフロールールをフローに移行してみます。

手順①設定->フローに移行を実行します。※先ほど作成したワークフロールールが表示されていると思います。

ここで、ワークフロールール名を指定して、フローに移行ボタンをクリックします。

手順②フローに移行ツールで変換できない機能を利用している場合、以下のようなエラーが表示されます。この場合Taskワークフローアクション（TODOの作成アクション）が制約に該当します。

この場合、手動でワークフローを修正する必要があります。

正常に処理される場合は以下のように処理が進められます。

ワークフロールールの修正

フローに移行ツールでエラーが発生する場合や事前に問題がわかっている場合は、ワークフロールールを修正しましょう。

今回は、TASKのアクションが問題となるため、ワークフロールールからアクション「TODOの作成」を削除します。

手順⑫以下のエラー画面から、ワークフロールールで開くをクリックします。

手順①ワークフロールールの画面で、アクションに表示されているTodoを削除します。

手順②削除されていることが確認できたら、ワークフロールールの画面を閉じて再度、フローに移行画面を表示します。

ワークフロールール修正後に再度フローに移行ツールを実行

手順①フローに移行画面で、修正後のワークフロールールを指定して、フローに移行を実行します。

手順②移行が成功したら以下の画面が表示されます。（まだ無効化されている状態）

このまま有効化を切替ボタンをクリックして有効化することもできますが、変換された処理が正しいかどうかテストすることをお勧めします。

Flow Builderでテストを実行

自動変換されたFlowをテストするための機能があるので、テストを作成して検証してみましょう。

手順①以下の画面で、Flow Builderでテストをクリックします。

手順②テストの作成画面で、作成ボタンをクリックします。

手順③新規テストの画面で、テストの詳細、トリガ、パスを設定から登録していきます。

表示ラベル、API参照名、説明を入力後、レコードが次の場合にテストを実行で作成済を指定します。※更新もテストしたい場合は、更新を指定しても構いません。テストのパスは即時実行

手順④続いて、最初のトリガレコードを設定を実行します。

テストデータとして利用する取引先責任者のレコードを指定します。

手順⑤既存のレコードを使う場合、検索した取引先責任者を選択すると自動的に項目の値がセットされます。

手順⑥既存の取引先責任者は、ワークフロールールを有効化してテストしている場合、役職には”なし”が設定されているため、手動でNULL（ブランク）に変更します。

手順⑦検証レコードが設定できたら、今度は実行結果の検証のためアサーションを指定します。（処理内容が正しいことの検証）

手順⑧フロー実行後の役職が”なし”に変更されていることを検証するため以下のように設定します。

リソース：＄Record＞役職

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

値：なし

テストの実行（ワークフロールールの検証）

テストを作成したら続いてテストを実行していきます。

手順①Flow Builder画面で、テストを表示（ベータ）をクリックします。

手順②テストの画面で、作成したテストのレコードの▼メニューからテストを実行して詳細を表示をクリックします。

手順③テストが実行され正常に処理されると以下のようにアサーションに合格が表示されます。

手順④すべての詳細をクリックすると、実行結果のデバッグログが表示されるため、各プロセスの実行結果が正しいかチェックすることができます。

フローの有効化

変換されたフローの検証が完了したら、フローの有効化を実行します。

手順①以下の画面から有効化を切替をクリックすると、フローが有効化され、変換元のワークフロールールは無効化されます。

以下のメッセージが表示されれば成功

もしくは、手動でフローを有効化して、ワークフロールールを無効化しても同じ結果となります。

最終検証

最後に設定内容の確認とフローの動作検証を実行します。

手順①ワークフロールールの画面を開いて、無効化されていることを確認

手順②自動変換して作成されたフローの画面を表示して無効化されていることを確認

手順③取引先責任者の編集画面を開いて、役職を”なし”からNULL（ブランク）にして更新します。

手順④役職がFLOWによって再度”なし”に更新されていることを確認します。

手順⑤最後にメールが受信されていることを確認して検証が完了となります。

まとめ

今回は、フローに移行ツールを使ってワークフロールールを自動変換する手順を説明しましたが、フローを使いこなすには、変数を使ったり、処理のアルゴリズムを考えたりする必要がでてくるため、少しプログラミングに近い知識が必要となってきます。

フローの使い方は、TrailheadにTrailがあるため学習したい方はこちらをお試しください。

サポーターさん

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

にほんブログ村

この場合、あとで不要になったレコードタイプを削除するとなったときには、以下のエラーが出てしまい削除できなくなってしまいます。

エラーメッセージ「[プロファイル名]の有効チェックを外すことはできません。デフォルトのレコードタイプとして以下のプロファイルが現在使用中です。」

エラー内容は、メッセージの通りでプロファイルに対して、レコードタイプを有効化しているとレコードタイプを削除できないというシンプルなものです。カスタムプロファイルなどは比較的簡単に修正して対応することができますが、以下のプロファイルなどは簡単には修正することができません。

※（2022年6月17日時点）今後もう少し簡単に削除できる方法が公開されるかもしれませんが…

標準プロファイル

・Chatter Only

・Chatter External User

・Chatter Free User

・Chatter Moderator User

・Customer Community User

・Identity User

今回は、これらのプロファイルの修正方法についてご説明していきます。

レコードタイプの削除方法

【プロファイルの編集画面からレコードタイプ変更が可能なプロファイルの場合】

カスタムプロファイルなどプロファイルの編集画面からレコードタイプの変更が可能な場合は、プロファイルの編集画面で利用しているレコードタイプが表示されているため、そちらから変更することが可能です。手順は以下の通り。

手順①システム管理者にて、設定->プロファイル->対象のプロファイルをクリックしてプロファイルの参照画面を表示します。

例では、[カスタム標準ユーザ]というカスタムプロファイルで説明します。

手順②プロファイルの参照画面からレコードタイプの設定欄を確認して、変更対象のレコードタイプの編集リンクをクリックします。

以下の例では、取引先に設定されたWEB会員（デフォルト）の編集を実行します。

手順③レコードタイプの設定の編集画面が表示されるため、選択済のレコードタイプからWEB会員を未選択とし、代わりにマスタを選択済に設定しいます。※レコードタイプは必須のため、必ず1つは設定する必要があります。

保存すると取引先のWEB会員レコードタイプからカスタム標準ユーザのプロファイルは除外されます。

【プロファイルの編集画面にレコードタイプが表示されない（編集不可）のプロファイルの場合】

ChatterExternal Userなどの特殊な標準プロファイルを利用している場合は、プロファイルの編集を行っても、プロファイルの中にオブジェクトのレコードタイプ設定が表示されません。

そのため、以下の手順に沿って削除を行う必要があります。

手順①まず編集対象のプロファイルのIDを取得します。

システム管理者にて、設定->ユーザ->プロファイルの順に実行し、プロファイルの一覧を表示します。

手順②続いて、編集対象のプロファイル名をクリックします。※以下の例では、[Chatter External User]を使って説明

手順③プロファイルを開いたあとのブラウザのURLからプロフィアるのIDを取得します。※[00e]から始まる15桁のID

上記の例では、最後の00eからの15桁がプロファイルのIDとなります。※2Fは不要なので気を付けてください。

/lightning/setup/Profiles/page?address=%2F00e5h0000032ZSW

※プロファイルIDと合わせてプロファイル名もコピーしてテキストへ保存しておいてください（あとで利用します）

プロファイル名：Chatter External Userなどの名称

手順④レコードタイプを設定しているオブジェクトのID（標準オブジェクトの場合はオブジェクト名でもよい）を取得します。

オブジェクトマネージャを実行してレコードタイプが設定されているオブジェクトを表示しURLからIDを取得します。

以下の例の場合、赤文字のところがオブジェクトのIDとなります。

【カスタムオブジェクトの場合】

/lightning/setup/ObjectManager/01Ip0000000NXGz/Details/view

【標準オブジェクトの場合（以下は取引先）】

/lightning/setup/ObjectManager/Account/Details/view

※オブジェクトIDをコピーしてテキストへ保存しておいてください。※今回の例では取引先となるためAccountをコピー

手順⑤自Salesforce組織のインスタンスURLをコピーしてテキストへ保存

※以下の赤文字URLのように、自のSalesforce組織からhttps://xxx….force.comまでをコピーします。後ろの部分は不要

https://cclt-dev-ed.lightning.force.com/lightning/lightning/xxx

手順⑥レコードタイプの設定画面を表示するためのURLを作成

まずは、手順⑤で取得したインスタンスURLを用意して、その後ろに以下を追加します。※一旦以下の文字列をそのままコピーしてください。

/setup/ui/profilerecordtypeedit.jsp?id=[手順①プロファイルID]&tid=[手順②のオブジェクトID]&pn=[手順①プロファイルID]

作成したURLは以下のようになります。

https://cclt-dev-ed.lightning.force.com/lightning/setup/ui/profilerecordtypeedit.jsp?id=00e5h0000032ZSW&tid=Account&pn=Chatter+External+User

※/setup/の前に/lightning/をつけるとエラーになるので注意！（Classicの機能での編集となるため）

※Chatter Free Userの半角スペース部分は、以下のように+（半角のプラス）でつないでください

・Chatter+Only

・Chatter+External+User

・Chatter+Free+User

・Chatter+Moderator+User

・Customer+Community+User

・Identity+User

手順⑦レコードタイプ設定の編集画面を表示

さきほどの手順⑥で作成したURLをブラウザに張り付けて実行すると、指定されたプロファイルのレコードタイプ設定画面が表示されます。

以下の例では、Chatter External Userのレコードタイプ設定の編集画面となります。

手順⑧レコードタイプの設定変更

削除したいレコードタイプを未選択にして、代わりにのレコードタイプを選択して保存します。

※レコードタイプは必ず1つセットする必要があるためマスタ以外に選択するものがなければ[–マスタ–]を選択してください。

保存してレコードタイプの設定変更を確定します。

手順⑨レコードタイプの無効化

レコードタイプを削除するためには、無効化する必要があります。レコードタイプの編集を行い、有効のチェックを外します。

手順⑩レコードタイプの削除

レコードタイプ一覧から削除対象のレコードタイプの削除を実行します。

削除した場合に、以下のメッセージが表示されることがありますが、ここで削除のリンクを再度クリックしてください。

手順⑫レコードの値の置き換え

最後に、選択リストのレコード値の置き換えを実施します。対象がなければ、[–なし–]を選択して完了をクリックします。

削除が成功するとレコードタイプ一覧から非表示となります。

まとめ

今回は、レコードタイプの削除方法をご説明いたしました。

サポーターさん

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

にほんブログ村

サポーターさん

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

これまでは、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の組み合わせで対応する必要があるかもしれません。

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

サポーターさん

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

にほんブログ村

また、Apexのサンプルコードとして提供している「取引先責任者を使って、カスタマーポータルユーザを作成」を利用して、取引先責任者のカスタマーポータルユーザを作成して、カスタマーポータルサイトにログインするまでの手順を説明してみたいと思います。

※Apexの開発は難しいという方は、標準の機能を使って取引先責任者からポータルユーザを使ってログインしてください。

【必要なライセンス】

カスタマー取引先ポータル（カスタマーポータル）を利用するためには、カスタマーポータルユーザライセンス（※１）が必要となります。

※Experience Cloudユーザライセンス（外部ユーザラインセンスとして、Customer Community、Customer Community Plusのいずれか）

代理店などの自社パートナーに対しては、別のパートナーコミュニティラインセンス（Partner Community）が用意されているので注意

サポーターさん

Developer Edition環境を使えば動作検証は可能です

Developer Edition（無料の開発環境）を持っていない方は、以下の記事を参考にSalesforce組織を取得してください。

参考

セールスフォースの基礎Ⅰ（３）Developer組織の作成～ログインまで

【第三回】セールスフォースの基礎講義 前回の記事では、インスタンスとリージョンの…

続きを読む

デジタルエクスペリエンス（Experience Cloud サイト）について

デジタルエクスペリエンス（Experience Cloud サイト ※旧Community Cloudサイト ）：Salesforce CMS、Mobile Publisher、Web アプリケーションスイートが結合されてた堅牢なカスタマイズされたサイト

簡単に言うと、Salesforce CRMと連携して、従業員/顧客/パートナー（代理店など）向けの公開ポータルサイトを非常に簡単に作成することができる機能（サービス）となります。

Salesforce内の各種データを共有（公開）したり、Salesforceの標準機能を外部向けに利用可能とすることができます。

サポーターさん

顧客向けにナレッジ（よくある質問やお問い合わせ）などの情報を公開することで、サポートコストを低減するなども目的で利用したり、だ代理店などのパートナー向けに商談などの情報を公開するような利用方法もあります。

サイトの構築は非常に簡単で、ノンコーディングで作成することもできますし、開発したコンポーネントなどを配置して利用することもできます。

さらに、各種CMSのテンプレートが提供されていて、テンプレートを適用するとおしゃれなページが簡単に構築できます。

※以下、選択可能なテンプレート（一部）

Experience Cloudユーザライセンスの種類

Experience Cloudユーザライセンス（旧Community Cloud）は、以下の種類があります。（2022/06/11時点）

以下、【引用元】：Salesforce公式HELPサイト「Experience Cloud ユーザライセンス」

上記の通り、ポータル系のライセンス体系は用途によって、細分化されているのでお客様の要件によって適切なものを選択する必要があります。

今回の記事で利用するのは、「Customer Community（カスタマーコミュニティ）」ライセンスとなります。

取引先責任者をカスタマーポータルユーザとして、新規ユーザを作成するため、Customer Communityが必要となります。

代理店などのパートナー向けにユーザを作成する場合には、Partner Communityのライセンスが必要となります。

ライセンス毎の課金体系について

デジタルエクスペリエンスのポータルサイトでは、大きく2種類のライセンス課金体系があります。

１．メンバーベースライセンス

ユーザに紐づくライセンス体系で先ほどご紹介したライセンス体系（Customer Community、Customer Community Plus、Partner Community、外部アプリケーション、Channel Account）がそれに該当します。

メンバーベースライセンスの場合、ユーザが月に何度ログインしても料金体系は変わらず固定となります。（ひと月当たりいくら）

２．ログインベースライセンス

ログインベースライセンスのライセンス体系は（Customer Community Login、CustomerCommunity Plus ログイン、Partner Community ログイン、External Apps Login、Channel Account Login）となっており、各種メンバーライセンスにログインが付いたライセンス名となっています。

ログインベースのライセンスの場合、毎月利用する特定数のログイン(※1)を購入することになります。

※1.ライセンスに関連付けられている外部ユーザは、サイトにログインする度に1 ログインを消費します。

ただし、同一ユーザが同じ日に複数回ログインしても、消費するのは 1ログインというカウントとなります。（日次ユニークログインと呼ばれる）

ポータルサイトの目的やユーザの利用状況によって、最適なライセンスを選択する必要があります。

デジタルエクスペリエンスでカスタマー取引先ポータルを作成

ここからは実際にSalesforceの組織にログインして、カスタマポータルのサイトを作成していきたいと思います。

1.デジタルエクスペリエンスの有効化

まず最初にデジタルエクスペリエンスの機能を有効化します。

手順①システム管理者でログイン後、[設定]->[デジタルエクスペリエンス]->[設定]の順に実行します。

以下の画面が表示されたら、デジタルエクスペリエンスを有効化にチェックします。

手順②デジタルエクスペリエンスを有効化にチェックすると、ドメイン名の選択項目が表示されます。

ドメイン名に作成したいドメイン名を入力して、[参加可能か調べる]をクリックして、ドメインが利用可能かチェックします。

手順③ドメイン名のチェックが終わったら、保存ボタンをクリックします。

すると以下の警告メッセージが表示されるので、問題なければOKをクリックして有効化を完了します。

「デジタルエクスペリエンスを有効化すると、レコードアクセス権が「ロール＆下位ロール」から「ロール、内部＆ポータル下位ロール」に自動的に変更されます。ポータル下位ロールにアクセス権を開放すると、組織のデータが外部ユーザに公開される可能性があります。デジタルエクスペリエンスを有効化したら、[デジタルエクスペリエンス] > [サイトメンバーアクセス権の変換] ツールを実行してデータアクセス権を保護してください。

デジタルエクスペリエンスを有効化したら、ドメイン名の変更やデジタルエクスペリエンスの無効化ができなくなります。

手順④有効化を実施後、以下の通り、成功しましたのメッセージが表示されれば有効化作業が完了となります。

2.カスタマーコミュニティユーザ用プロファイルの作成

カスタマーコミュニティ用のプロファイルを作成します。

※サイト公開前にはプロファイルを含め、必要なセキュリティ設定は必ず済ませておいてください

手順①システム管理者で、[設定]->[ユーザ]->[プロファイル]の順に実行します。

プロファイル一覧から、[Customer Community User]プロファイルの横にあるコピーリンクをクリックします。

手順②プロファイルのコピー画面で、カスタムプロファイルの名前を指定して保存ボタンをクリックします。

例では、「Custom Customer Community User」という名前にしています。

※Apexのコードサンプルではこの名称を利用してプロファイルを取得しています。名前を変更する場合、Apexコードで指定しているプロファイル名も変更してください

プロファイル作成後は、必ずプロファイルに設定されている権限の確認をしてください。（必要ない権限は削除）

3.新規カスタマー取引先ポータル（サイト）の作成

手順①デジタルエクスペリエンスを有効化すると、デジタルエクスペリエンスメニューに、すべてのサイトが表示されるので、クリックして実行します。

すべてのサイトページで、[新規]ボタンをクリックして、新規サイトの作成を行います。

手順②新規ボタンをクリックすると、お気に入りのエクスペリエンスの選択画面が表示されます。

ポータルの利用用途に沿った各種テンプレートが用意されています。

手順③今回は、カスタマー取引先ポータルを選択します。

手順④カスタマー取引先ポータルの画面で内容を確認したら、「使用を開始する」ボタンをクリックします。

手順⑤続いて、ポータルの名前を設定後、作成ボタンをクリックします。　※サイトのページのURLは省略可能。

手順⑥サイトの作成処理が開始されます。

手順⑦サイトの作成が終わると以下のワークスペースの画面が表示されます。

手順⑧ワークスペースからビルダーのメニューを実行します。

すると以下のようなホーム画面が表示されます。

4.カスタマー取引先ポータルサイトのカスタマイズ

まずは、サイトへアクセス可能なプロファイルを設定します。

手順①サイト作成後、ビルダーの左上のメニューから「管理」メニューを実行します。

手順②管理メニューの中から、メンバーメニューをクリックします。

選択可能なプロファイルで、作成したプロファイル「Custom Customer Community User」を選択して選択済みへ追加します

続いては、新規作成したカスタマー取引先ポータルサイトのレイアウトなどのカスタマイズを行います。（ここは省略してもよいです）

ポータル画面の設定やカスタマイズに関しては、別の記事で詳細をご説明したいと思います。

今回は、以下のようにダッシュボードのコンポーネント追加と、ケースの一覧表示だけ追加しています。

手順①カスタマイズが終わったら、画面右上の公開ボタンをクリックしてページを公開します。

5.取引先、取引先責任者レコードの作成

続いては、取引先と取引先責任者のレコードを作成していきます。

※ここはSalesforceの基本的な操作となるため、詳細な手順は省略します。

【例】以下の取引先と取引先責任者を作成

取引先責任者については、取引先は上記で作成した取引先に紐づけて作成

姓名とメールアドレスは必ず設定するようにしてください。　※メールアドレスは新規ポータルユーザを作成するときに利用します。

6.取引先責任者のカスタマーコミュニティユーザを作成

続いては、作成した取引先責任者をカスタマーポータルユーザとして有効化します。

その１（標準機能を使ったやり方）

手順①取引先責任者のページレイアウトを編集して、モバイルおよびLightning アクションから、「カスタマーユーザを有効化」「カスタマーユーザを無効化」「カスタマーユーザを表示」のボタンをレイアウトに配置して保存します。

手順②取引先責任者の詳細画面で「カスタマーユーザを有効化」ボタンをクリックします。

手順③ユーザの新規作成画面に遷移するので、この画面でライセンスとプロファイルを以下に変更して保存します。

・ユーザライセンス：Customer Community

・プロファイル：Custom Customer Community User

そのほか、ユーザ名など変更したい箇所があれば編集してから保存します。

手順④作成時に以下の警告メッセージが表示されます。問題なければOKをクリックします。

任意のコミュニティで [お知らせメールを送信] オプションを選択している場合、そのコミュニティの新規メンバーはお知らせメールメッセージを受信します。このコミュニティメンバーにお知らせメールメッセージを送信しない場合は、[お知らせメールを送信] オプションを選択解除します。

手順⑤ユーザ作成後に以下のメールが届きます。メール内のリンクをクリックします。

手順⑥パスワードの設定画面にて新規パスワードを設定します。設定後パスワードの変更を実行

7.カスタマーコミュニティユーザでカスタマー取引先ポータルサイトへログイン

パスワードの変更を行うと自動的にログインされます。作成したサイトのログイン画面が表示されれば成功となります。

カスタマーポータルユーザの作成（ApexTriggerサンプルコード）

今回は、取引先責任者の標準機能「カスタマーユーザを有効化」機能を使ってユーザを作成しましたが、フローアクションやApexなどで自動的にユーザを作成したい場合もあると思います。

取引先責任者IDを使って、Apexで自動的にカスタマーユーザを作成する方法については、以下にサンプルコードを用意しています。

ユーザ作成後は、ユーザ宛にメールが届きます。※メール内リンクからユーザを有効化＆パスワードの変更を実施してログイン可能となります。

参考

カスタマーポータルユーザの作成（Apex Class サンプルコード）

今回のサンプルは、取引先責任者IDを使ってカスタマー取引先ポータルのユーザを作成…

続きを読む

まとめ

今回は、カスタマーポータルを作成してポータルユーザでログインする手順についてご説明しました。

デジタルエクスペリエンスの構築方法では、開発機能を使ったサイト作成なども実際のプロジェクトでは多いと思いますので、別の機会に開発機能を使ってのサイト作成方法をご紹介したいと思います。

サポーターさん

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

にほんブログ村

サポーターさん

Salesforceのインプリで発見したエラーなどは、ググって検索すると思いますが、解決方法を具体的な手順で残していく習慣をつけるとよいですよ

エラーメッセージ一覧（カテゴリ別）

オブジェクト関連

ダッシュボード関連

モバイル（Mobile）アプリケーション

レコードタイプ関連

フロー（Flow/Process Builder）

Apex

Apex Batch

Lightning Recordページレイアウト関連

リリース（変更セット）関連

データインポート（インポートウィザード）関連

データ削除（共通）

その他（共通）