設定

コンポーネント設定

Object Team MemberコンポーネントはLightning App Builderで直接設定できます。以下のプロパティを使用できます：

プロパティ	タイプ	デフォルト	説明
Card Title	String	Team Members	コンポーネントカードに表示されるタイトル
Max Displayed Members	Integer	5	折りたたむ前に表示されるチームメンバーの最大数。すべて表示するには0に設定

チームメンバーの数が設定された制限を超えると、リストが折りたたまれ、**「Show all (X more)」ボタンが表示されます。これをクリックすると完全なリストが展開され、「Show less」**ボタンで再び折りたたむことができます。レコードオーナーは、表示制限に関係なく常にリストの最初に表示されます。

表示制限の動作

設定	動作
Max Displayed Members = 5（デフォルト）	最初の5人のメンバーを表示し、残りは「Show X more」で表示
Max Displayed Members = 0	すべてのチームメンバーが表示され、折りたたみ/展開なし
Max Displayed Members = 3（カスタム）	最初の3人のメンバーを表示し、残りは「Show X more」で表示

チームメンバーのロール

ユーザーをチームに追加する際、以下のいずれかのロールを割り当てます：

ロール	説明	機能
Owner	レコードオーナー	レコード作成時に自動的に割り当てられます。手動で割り当てたり削除したりすることはできません。チームメンバーを管理する完全なアクセス権を持ちます。チーム内に他のユーザーがいない場合は自動的に削除されます。
Manager	チーム管理者	チームメンバーの追加、編集、削除が可能です。チーム構成を管理する必要があるユーザーにこのロールを使用します。
User	標準チームメンバー	チームメンバーのリストを表示できますが、変更はできません。レコードへのアクセスのみが必要なユーザーにこのロールを使用します。

オーナー変更の同期

レコードオーナーが変更されたとき（例：アカウントが別の営業担当者に再割り当てされた場合）、Ownerチームメンバーは自動的に更新されません。システムは最初のチームメンバーが追加されたときにOwnerレコードを作成しますが、親レコードの後続のオーナー変更は追跡しません。

チームOwnerをレコードオーナーと同期するには、Record-Triggered Flowを作成する必要があります。

Flowによるセットアップ（推奨）

Apexトリガーによるセットアップ

trigger AccountOwnerSync on Account(after update) {
  List<tucariofts.SyncOwnerInvocable.SyncOwnerRequest> requests =
    new List<tucariofts.SyncOwnerInvocable.SyncOwnerRequest>();

  for (Account acc : Trigger.new) {
    Account oldAcc = Trigger.oldMap.get(acc.Id);
    if (acc.OwnerId != oldAcc.OwnerId) {
      tucariofts.SyncOwnerInvocable.SyncOwnerRequest req =
        new tucariofts.SyncOwnerInvocable.SyncOwnerRequest();
      req.recordId = acc.Id;
      requests.add(req);
    }
  }

  if (!requests.isEmpty()) {
    tucariofts.SyncOwnerInvocable.syncOwners(requests);
  }
}

Apexコードから呼び出す（単一レコード）

tucariofts.SyncOwnerInvocable.SyncOwnerRequest request =
    new tucariofts.SyncOwnerInvocable.SyncOwnerRequest();
request.recordId = accountId;

List<tucariofts.SyncOwnerInvocable.SyncOwnerResult> results =
    tucariofts.SyncOwnerInvocable.syncOwners(
        new List<tucariofts.SyncOwnerInvocable.SyncOwnerRequest>{ request }
    );

if (results[0].success) {
    System.debug('Owner synced: ' + results[0].oldOwnerId +
                 ' → ' + results[0].newOwnerId);
} else {
    System.debug('Sync failed: ' + results[0].message);
}

結果オブジェクト

フィールド	タイプ	説明
success	Boolean	同期が成功したかどうか
message	String	結果メッセージまたはエラーの詳細
oldOwnerId	Id	以前のオーナーのUser ID
newOwnerId	Id	新しいオーナーのUser ID

エラーシナリオ

シナリオ	結果
レコードにチームメンバーがいない	success = false、「No Owner team member found」
オーナーが変更されていない	success = true、「Owner unchanged, no update needed」
Record IDがnull	success = false、「Record ID is required」
無効なレコードID	success = false、エラーメッセージ

重要な制限事項

キューオーナーはサポートされていません — Flexible Team Shareはキューをチームオーナーとしてサポートしていません。レコードがキューに所有されている場合：

• システムは現在のユーザー（最初にチームメンバーを追加した人）をチームのOwnerとして使用します
• 後でレコードオーナーをキューからユーザーに変更した場合は、Sync Ownerアクションを実行してチームを更新してください
• オーナーをユーザーからキューに変更した場合、チームOwnerは以前のユーザーのままになります

Flowはオブジェクトごとに作成する必要があります — オーナー同期が必要な各オブジェクトタイプに対して、個別のFlowを作成する必要があります。Invocable Actionはどのオブジェクトでも機能しますが、SalesforceではオブジェクトごとにRecord-Triggered Flowを個別に作成する必要があります。

終了日による一時的なアクセス

チームメンバーを追加する際、オプションで終了日を設定して、レコードへの一時的なアクセスを付与できます。これは以下の場合に便利です：

• 期限が定められたプロジェクトベースのコラボレーション
• 一時的なコンサルタントまたは請負業者
• 休暇カバーまたは委任された責任
• 監査またはレビュー期間

動作の仕組み

自動クリーンアッププロセス

• スケジュールされたバッチジョブが毎日実行され（デフォルトでは午前2:00）、期限切れのチームメンバーを削除します
• チームメンバーが削除されると、共有レコードも削除され、レコードへのアクセス権が取り消されます
• クリーンアップジョブはConfiguration Wizardから管理できます

Scheduled Job

Flexible Team Shareには、期限切れのチームメンバーを削除する自動クリーンアップジョブが含まれています。このジョブはパッケージのインストール時に自動的にスケジュールされます。

ジョブの確認

手動ジョブ管理

管理者はConfiguration Wizardからクリーンアップジョブを管理できます：

• Schedule Job — 実行されていない場合に手動でスケジュール
• Unschedule Job — 自動クリーンアップを停止
• Run Now — 即座にクリーンアップを実行

トラブルシューティング

「設定が見つかりません」警告

症状： このオブジェクトの設定が存在しないという警告モーダルが表示されます。

原因： Configuration Wizardでオブジェクトを設定する前に、チームメンバーコンポーネントがレコードページに追加されました。

解決策：

「アクセスなし」エラー

症状： コンポーネントにチームメンバーの代わりに「アクセスなし」メッセージとロックアイコンが表示されます。

原因： 現在のユーザーに必要なPermission Set Groupが割り当てられていません。

解決策：

「This operation requires the FTS Admin permission set」エラーが解消されない

症状： Configuration Wizardで設定をデプロイする際（オブジェクトを選択し、Deploy Settingsをクリックする際）に、Flexible Team Share - Admin権限セットがすでにユーザーに割り当てられているにもかかわらず、**「This operation requires the FTS Admin permission set」**というエラーが表示されます。

原因： これはSalesforceの権限キャッシュに起因する現象です。権限セットが割り当てられた後も、Salesforceがアクティブなセッションに対して以前の権限状態に基づいて評価を続けることがあり、新たに付与されたアクセス権がすぐには認識されません。

解決策：

「制限に到達しました」警告

症状： 「Add Team Member」ボタンが無効になり、制限に到達したことを示すメッセージが表示されます。

原因： 許可されているチームメンバーの最大数に到達しました。

解決策： 非アクティブまたは不要なチームメンバーを削除してスロットを空けます。

制限内のチームメンバー	制限を超えたチームメンバー

共有が機能しない

症状： チームメンバーが正常に追加されたが、レコードにアクセスできません。

原因： オブジェクトの組織の共有設定（OWD）がPublic Read/Writeに設定されています。

解決策：

サポート

質問や問題については、[email protected]までお問い合わせください。