メソッドと操作

ガイドツール Salesforce Developer Toolkit メソッドと操作

メソッドと操作

クラス名: box.Toolkit

インスタンスメソッドの呼び出し時に発生した最新のエラーを示す文字列。

この文字列が存在しても、操作が成功しなかったことを意味するわけではありません。そのエラーが回復可能であった可能性もあります。ただし、この文字列に値がない場合は、操作が成功したことを示しています。

コラボレーションのタイプを示す列挙型。

可能性のある値: EDITOR、VIEWER、PREVIEWER、UPLOADER、COOWNER、OWNER、PREVIEWERUPLOADER、VIEWERUPLOADER

サービスアカウントとBox for Salesforce統合の関連付けをクリアするメソッド。間違ったサービスアカウントが使用されている場合、このメソッドを使用してアカウントを変更できます。

パラメータ:

なし

戻り値:

ユーザーのアカウントが存在していたが削除された場合はtrue。
ユーザーのアカウントが何らかの理由 (存在しなかった場合を含む) で削除されなかった場合はfalse。

パラメータ	型	説明
`userId`	id	資格情報がクリアされるユーザーのID。

戻り値:

ユーザーのアカウントが存在していたが削除された場合はtrue。
ユーザーのアカウントが何らかの理由 (存在しなかった場合を含む) で削除されなかった場合はfalse。

パラメータ:

なし

このメソッドはbox.Toolkit()メソッドのデストラクタとして扱います。

このメソッドは重要です。すべてのフォルダ/コラボレーション操作が完了した後、毎回、例外なくこのメソッドを呼び出す必要があります。

Salesforceではデータベースの更新/挿入/削除の後の呼び出しは許可されないため、Toolkitクラスではすべての呼び出し操作が完了した後で挿入するオブジェクトのコレクションが保持されます。このメソッドを呼び出さない場合、このようなオブジェクトがデータベースから消去され、ユーザー/レコード/フォルダの関連付けを追跡するテーブルの同期も失われて、高度なデバッグによる修正が必要になります。

パラメータ:

なし

戻り値:

Void

Box for Salesforce Developer Toolkitは、パラメータとしてHttpRequestオブジェクトを受け取り、HttpResponseオブジェクトを返すグローバルメソッドを提供します。このメソッドではサービスアカウントの認証の詳細情報を利用してBoxのAPIを呼び出すため、開発者は統合のビジネスロジックに集中して取り組むことができます。

パラメータ	型	説明
`request`	HttpRequest	エンドポイントとメソッドが設定されたHttpRequestオブジェクト。

戻り値:

BoxのAPI呼び出しからのレスポンスの詳細情報が含まれたHttpResponseオブジェクト。
HttpRequestのインプットの情報が不足している場合はToolkit.BoxApiException。
サービスアカウントの認証の詳細情報を取得する際に問題が発生した場合はnull。この場合は、mostRecentErrorを確認してください。

バージョン3.46以降で使用可能です。

Salesforceの文字列長の上限は600万文字です。base64エンコード/デコードプロセスでは文字列が膨張するため、有効なファイルサイズの上限は、同期Apexの場合は4.3MB、非同期Apexの場合は8.6MBとなっています。

パラメータ	型	説明
`att`	`Attachment`	Box内のファイルに変換される添付ファイル。
`fileNameOverride`	`string`	省略可 - 新しいファイルの名前。値が渡されなかった場合、添付ファイルの名前が使用されます。
`folderIdOverride`	`string`	省略可 - この添付ファイルの配置先であるBoxフォルダID。値が渡されなかった場合、ファイルは添付ファイルの`parentId`に当たるレコードに関連付けられているフォルダに配置されます。レコード固有のフォルダが存在していない場合は作成されます。
`accessToken`	`string`	省略可 - `accessToken`が送信された場合は、Box API呼び出しにその値が使用されます。そうでない場合は、デフォルトアカウントの資格情報が使用されます。

戻り値:

string。作成されたBoxファイルのIDが返されます。
エラーが発生した場合はnull。この場合には、mostRecentErrorを確認してください。

パラメータ	型	説明
`recordId`	`id`	ルートフォルダIDを取得する必要があるSalesforceレコードのID。

戻り値:

string。レコードIDが渡されたオブジェクトルートフォルダのBoxフォルダIDが返されます。

パラメータ:

なし

戻り値:

string。SalesforceルートフォルダのBoxフォルダIDが返されます。

パラメータ	型	説明
`recordId`	`id`	ルートフォルダIDを取得する必要があるSalesforceレコードのID。

戻り値:

string。レコードIDが渡されたオブジェクトルートフォルダのBoxフォルダIDが返されます。

このメソッドは、特定のレコードの埋め込みウィジェットURLを取得します。このため、必要に応じて独自の埋め込みロジックを使用できます。
このメソッドではシームレスなログインの設定が優先されます。このため、シームレスなログインが有効になっている場合、ユーザーはURLに自動的にログインされます。

パラメータ	型	説明
`recordId`	`id`	ルートフォルダIDを取得する必要があるSalesforceレコードのID。
`isMobileContext`	`boolean`	URLがモバイル (true) か、それ以外 (false) かを示すブール値。

戻り値:

string。渡されたSalesforceレコードIDに関連付けられているフォルダを表すURLが返されます。このURLをBox埋め込みウィジェットで使用して、任意のVisualforceページに埋め込むことができます。

パラメータ	型	説明
`recordId`	`id`	ルートフォルダIDを取得する必要があるSalesforceレコードのID。

戻り値:

string。作成されたルートフォルダのBoxフォルダIDが返されます。
ルートフォルダがすでに存在していた場合、そのルートフォルダのBoxフォルダIDが返されます。

パラメータ	型	説明
`folderName`	`string`	作成するフォルダの名前。フォルダ名には制限があります。詳細はこちらを参照してください。
`parentFolderId`	`string`	このフォルダが作成される親Boxフォルダ。
`accessToken`	`string`	省略可 - `accessToken`が送信された場合は、Box API呼び出しにその値が使用されます。そうでない場合は、デフォルトのサービスアカウントの資格情報が使用されます。

戻り値:

string。作成されたフォルダのBoxフォルダIDが返されます。
フォルダが作成されなかった場合はnullが返されます。この場合、mostRecentErrorで詳細を確認してください。

パラメータ	型	説明
`recordId`	`id`	Boxフォルダの作成に使用されるSalesforceレコードID。
`folderNameOverride`	`string`	デフォルトでは、レコード名がフォルダ名になります。別の名前を付ける場合は、ここでその値を送信します。
`optCreateRootFolder`	`boolean`	オブジェクトのルートフォルダが存在しない場合に、それを作成するかどうかを示すブール値。falseを送信した場合、ルートフォルダが存在しないと呼び出しは失敗します。

戻り値:

string。作成されたフォルダのBoxフォルダIDが返されます。
フォルダが作成されなかった場合はnullが返されます。この場合、mostRecentErrorで詳細を確認してください。
SalesforceレコードがすでにBoxフォルダに関連付けられている場合、既存のBoxフォルダIDが返されます。

パラメータ	型	説明
`folderId`	`string`	移動するフォルダのBoxフォルダID。
`newParentFolderId`	`string`	新しい親フォルダになるフォルダのBoxフォルダID。
`accessToken`	`string`	省略可 - `accessToken`を送信すると、その値がBox API呼び出しに使用されます。そうでない場合、デフォルトのサービスアカウント資格情報が使用されます。

戻り値:

フォルダが正常に移動された場合はtrue。
フォルダが正常に移動されなかった場合はfalse。mostRecentErrorで詳細を確認してください。

パラメータ	型	説明
`recordId`	`id`	返されるフォルダマッピングエントリが関連付けられるSalesforceレコードID。

戻り値:

返されるリストは、このレコードに関連付けられているすべてのフォルダマッピングエントリのコレクションです。
一般に、フォルダマッピングエントリが存在しない場合は空のリストになりますが、状況によってnullになる場合があります。

パラメータ	型	説明
`recordId`	`id`	フォルダIDを取得するSalesforceレコードID。

戻り値:

string。渡されたSalesforceレコードIDに関連付けられたBoxフォルダIDが返されます。

パラメータ	型	説明
`folderId`	`string`	BoxフォルダID。

戻り値:

id。渡されたBoxフォルダIDに関連付けられたSalesforceレコードIDが返されます。

パラメータ	型	説明
`recordId`	`id`	Boxフォルダに関連付けるSalesforceレコードID。
`folderId`	`string`	Salesforceレコードに関連付けるBoxフォルダID。

戻り値:

box__FRUP__cオブジェクト - エラーが発生した場合 (mostRecentErrorを確認)、返されるFRUPオブジェクトはnullになります。このFRUPエントリは、commitChangesメソッドの呼び出し時にデータベースに挿入されます。このメソッドでは、同じフォルダの複数レコードへの関連付けやその逆の関連付けが許可されないため、他のフォルダの関連付けとの一貫性が保証されます。

Box for Salesforce Developer Toolkitによって作成されたコラボレーションは、コラボレータにコラボレーションメールを送信しません。Box for Salesforce統合に使用されるサービスアカウントのみがコラボレーションメールを受け取ります。

パラメータ	型	説明
`folderId`	`string`	コラボレーションを作成するBoxフォルダのID。
`boxUserId`	`string`	コラボレーションするBoxユーザーのID (`boxUserId`または`emailAddress`のどちらか一方のみ必要)。
`emailAddress`	`box.Toolkit.CollaborationType`	Boxユーザーのメールアドレス。
`collabType`	`string`	コラボレーションのタイプ (`CollaborationType`列挙型の定義を参照)。
`accessToken`	`string`	省略可 - 送信した場合、この値はBox API呼び出しの認証に使用されます。`null`の場合、サービスアカウントの資格情報が使用されます。

戻り値:

string。作成されたBoxコラボレーションのIDが返されます。
エラーが発生した場合はnullが返されます。その場合、mostRecentErrorを確認してください。

パラメータ	型	説明
`userId`	`id`	コラボレーションするSalesforceユーザーID。
`recordId`	`id`	コラボレーションするレコードフォルダのSalesforceレコードID。
`collabType`	`box.Toolkit.CollaborationType`	コラボレーションのタイプ (`CollaborationType`列挙型の定義を参照)。
`optCreateFolder`	`boolean`	SalesforceレコードIDに関連付けられたBoxフォルダがまだ存在しない場合に、それを作成するかどうかを示すブール値。ルートフォルダが存在しない場合は、ルートフォルダも作成されます。`false`に設定した場合、フォルダがまだ存在しないと呼び出しが失敗します。

戻り値:

string。作成されたBoxコラボレーションのIDが返されます。
エラーが発生した場合はnullが返されます。その場合、mostRecentErrorを確認してください。

メソッドと操作

メソッドと操作

ツールキットの詳細

インスタンス変数

`mostRecentError`

`Enum CollaborationType`

静的メソッド

`deleteServiceUserAssociation`

`deleteUserAssociation`

インスタンスメソッド (コンストラクタ/デストラクタ)

`box.Toolkit()`

`commitChanges`

ジェネリックメソッド

`sendRequest`

ファイル操作

`createFileFromAttachment`

`getObjectFolderByRecordId`

フォルダ操作

`getRootFolderId`

`getObjectFolderByRecordId`

`getFolderUrl`

`createObjectFolderForRecordId`

`createFolder`

`createFolderForRecordId`

`moveFolder`

フォルダ関連付けメソッド

`getFolderAssociationsByRecordId`

`getFolderIdByRecordId`

`getRecordIdByFolderId`

`createFolderAssociation`

コラボレーションメソッド

`createCollaboration`

`createCollaborationOnRecord`

関連するガイド