Objective Connect (プレビュー)
Objective Connect は、組織が機密文書を外部の関係者と共有できるようにする信頼できるファイル共有プラットフォームです。 ユーザーはクラウドにプライベート ワークスペースを作成し、参加者を数秒で招待できます。 コラボレーション、レポート、セキュリティ、コンプライアンスの機能により、政府機関や規制対象の業界は、安心して外部で作業することができます。
このコネクタは、次の製品および地域で利用可能です。
| Service | クラス | 地域 |
|---|---|---|
| Logic Apps | 標準 | 以下を除くすべての Logic Apps 地域 : - Azure 政府の地域 - Azure 中国の地域 - 国防総省 (DoD) |
| Power Automate | プレミアム | 以下を除くすべての Power Automate 地域 : - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運用する中国のクラウド - 国防総省 (DoD) |
| Power Apps | プレミアム | 以下を除くすべての Power Apps 地域 : - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運用する中国のクラウド - 国防総省 (DoD) |
| コネクタのメタデータ | |
|---|---|
| 公開元 | Objective Corporation |
接続の作成
コネクタは、次の認証タイプをサポートしています:
| 既定 | 接続を作成するためのパラメーター。 | すべての地域 | 共有不可 |
既定
適用できるもの: すべての領域
接続を作成するためのパラメーター。
これは共有可能な接続ではありません。 パワー アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
| 件名 | タイプ | 内容 | 必要 |
|---|---|---|---|
| パスワード | securestring | この API のパスワード | 真 |
| サーバー リージョン。 (英国 - secure.objectiveconnect.co.uk、オーストラリア、ニュージーランド - secure.objectiveconnect.com) | 文字列 | Objective Connect サーバーを指定する。 | 真 |
| ユーザー名 | securestring | この API のユーザー名 | True |
調整制限
| 名前 | 呼び出し | 更新期間 |
|---|---|---|
| 接続ごとの API 呼び出し | 100 | 60 秒 |
アクション
| ドキュメント コンテンツのアップロード |
ドキュメントのコンテンツをアップロードする |
| ドキュメント コンテンツを取得する |
ドキュメントのコンテンツを返す |
| ドキュメント バージョンのコンテンツの取得 |
ドキュメント バージョンのコンテンツを返す |
| ドキュメント バージョンの一覧表示 |
資産バージョンの一覧を取得する |
| ドキュメント バージョンの取得 |
資産バージョンを取得する |
| ドキュメントの作成 |
要求が application:hal+json の場合、メタデータのみが作成されます。 要求が multipart:form-data の場合、1 回の呼び出しでコンテンツを含むドキュメントが作成されます。 |
| ユーザーの取得 |
ユーザーを取得する |
| ワークスペースの作成 |
ワークスペースの作成 |
| ワークスペースを一覧表示 |
要求しているユーザーが表示権限のある共有のリストを取得する |
| ワークスペースを取得 |
ID でワークスペースを取得 |
| 共有ドキュメントの一覧表示 |
ワークスペース UUID で資産のリストを取得する |
| 参加者の削除 |
ワークスペースから参加者を削除する |
| 参加者の取得 |
ワークスペース参加者の取得 |
| 参加者の追加または更新 |
新しい参加者を招待するか、割り当てられた役割を編集する |
ドキュメント コンテンツのアップロード
ドキュメントのコンテンツをアップロードする
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ドキュメント
|
assetUuid | True | string |
ドキュメント UUID |
|
ワークスペース
|
shareUuid | True | string |
ワークスペース UUID |
|
ファイル コンテンツ
|
file | True | file |
アップロードするファイル コンテンツ |
ドキュメント コンテンツを取得する
ドキュメントのコンテンツを返す
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ドキュメント
|
assetUuid | True | string |
UUID |
|
ワークスペース
|
shareUuid | True | string |
UUID |
ドキュメント バージョンのコンテンツの取得
ドキュメント バージョンのコンテンツを返す
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ドキュメント
|
assetUuid | True | string |
UUID |
|
コンテンツ バージョン
|
contentVersion | True | integer |
ドキュメントのバージョン番号 |
|
ワークスペース
|
shareUuid | True | string |
UUID |
ドキュメント バージョンの一覧表示
資産バージョンの一覧を取得する
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ドキュメント
|
assetUuid | True | string |
ドキュメント UUID |
|
ワークスペース
|
shareUuid | True | string |
ワークスペース UUID |
|
長さ
|
length | integer |
取得する結果の最大数 |
|
|
オフセット
|
offset | integer |
開始する結果位置 (デフォルトは0)。 |
戻り値
ドキュメント バージョンの取得
資産バージョンを取得する
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ドキュメント
|
assetUuid | True | string |
UUID |
|
ワークスペース
|
shareUuid | True | string |
UUID |
|
バージョン
|
version | True | integer |
ドキュメントのバージョン番号 |
戻り値
- 本文
- DocumentVersion
ドキュメントの作成
要求が application:hal+json の場合、メタデータのみが作成されます。 要求が multipart:form-data の場合、1 回の呼び出しでコンテンツを含むドキュメントが作成されます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ワークスペース UUID
|
shareUuid | True | string |
パスからの共有 UUID |
|
ファイル コンテンツ
|
file | True | file |
アップロードするファイル コンテンツ |
|
ファイル名
|
name | True | string |
ファイル名 |
|
親 UUID
|
parentUuid | string |
(任意) |
|
|
サマリー
|
summary | string |
(任意) |
戻り値
ユーザーの取得
ユーザーを取得する
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
電子メール
|
emailAddress | string |
検索するメール アドレス |
|
|
長さ
|
length | integer |
返される結果の数。 オフセットが使用されている場合にのみ使用される。 |
|
|
オフセット
|
offset | integer |
この位置の後に結果を返す |
|
|
組織
|
orgUuid | string |
検索する組織の UUID |
|
|
並べ替え
|
sort | string |
並べ替えパラメーターは、並べ替えフィールドを示す単語とオプションの「:desc」タグの形式でなければならず、タグがない場合は、昇順であると見なされる。 不良または空の要求は、デフォルトで名前の昇順になる。 使用可能な並べ替えは、firstName、lastName、email |
|
|
ユーザー UUID
|
uuids | array |
ユーザー UUID のリスト |
戻り値
ワークスペースの作成
ワークスペースの作成
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ユーザー UUID
|
userUuid | True | string |
ユーザー UUID |
|
アクセス
|
access | string | ||
|
エージェント
|
agentShareToken | string |
エージェント トークン |
|
|
件名
|
name | True | string |
件名 |
|
組織全体
|
organisationUuid | string |
組織 UUID |
|
|
担当者
|
ownerUuid | string |
所有者 UUID |
|
|
サマリー
|
summary | string |
サマリー |
|
|
UUID
|
uuid | string |
UUID |
戻り値
- 本文
- ShareResponse
ワークスペースを一覧表示
要求しているユーザーが表示権限のある共有のリストを取得する
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
長さ
|
length | integer |
取得する結果の最大数 |
|
|
オフセット
|
offset | integer |
戻り値が開始する結果位置 (デフォルトは0) |
|
|
担当者
|
ownerUuid | string |
所有者のユーザー UUID。 指定された場合、結果はこのユーザーが所有する共有に制限される |
|
|
関係者
|
participantUuid | string |
参加者のユーザー UUID。 指定された場合、結果はこのユーザーが参加者である共有に制限される |
|
|
Query
|
query | string |
検索クエリ文字列。 指定された場合、結果は指定されたクエリ値を含む名前の共有に制限される |
|
|
並べ替え
|
sort | string |
並べ替え順の条件文字列。 以下は許容される値
|
|
|
Workgroup
|
workgroupUuid | string |
ワークグループ UUID。 指定された場合、結果はワークグループに属する共有に制限される |
戻り値
ワークスペースを取得
ID でワークスペースを取得
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ワークスペース
|
shareUuid | True | string |
取得するワークスペースの UUID |
戻り値
- 本文
- ShareResponse
共有ドキュメントの一覧表示
ワークスペース UUID で資産のリストを取得する
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ワークスペース
|
shareUuid | True | string |
ワークスペース UUID |
|
長さ
|
length | integer |
取得する結果の最大数 |
|
|
オフセット
|
offset | integer |
戻り値が開始する結果位置 (デフォルトは0) |
|
|
親 UUID
|
parentUuid | string |
共有または親資産の UUID。 指定された場合、結果は共有または資産の直接の子に制限される。 無効な場合、応答は 200 になり、リストは空になる。 |
|
|
Query
|
query | string |
検索クエリ文字列。 指定された場合、結果は指定されたクエリ値で始まる名前の資産に制限される。 |
|
|
並べ替え
|
sort | string |
並べ替え順の条件文字列。 以下は許容される値
|
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
|
array of object | ||
|
annotationsCount
|
annotationsCount | integer |
annotationsCount |
|
commentCount
|
commentCount | integer |
commentCount |
|
contentVersion
|
contentVersion | integer |
contentVersion |
|
createdDate
|
createdDate | string |
createdDate |
|
拡張子
|
extension | string |
拡張子 |
|
fileSize
|
fileSize | integer |
fileSize |
|
ロック済み
|
locked | boolean |
ロック済み |
|
モデル
|
model | string |
モデル |
|
modifiedByUuid
|
modifiedByUuid | string |
modifiedByUuid |
|
modifiedDate
|
modifiedDate | string |
modifiedDate |
|
名前
|
name | string |
名前 |
|
pdfPreviewstatus
|
pdfPreviewstatus | string |
pdfPreviewstatus |
|
previewPageCount
|
previewPageCount | integer |
previewPageCount |
|
previewstatus
|
previewstatus | string |
previewstatus |
|
状態
|
status | string |
状態 |
|
種類
|
type | string |
種類 |
|
UUID
|
uuid | string |
UUID |
|
wopiRestricted
|
wopiRestricted | boolean |
wopiRestricted |
参加者の削除
ワークスペースから参加者を削除する
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ユーザー
|
uuid | True | string |
ユーザー UUID |
戻り値
参加者の取得
ワークスペース参加者の取得
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ユーザー
|
userUuid | string |
ユーザー UUID |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
|
array of object | ||
|
承諾済み
|
accepted | boolean |
承諾済み |
|
電子メール
|
string |
電子メール |
|
|
isOwner
|
isOwner | boolean |
isOwner |
|
joinedDate
|
joinedDate | string |
joinedDate |
|
モデル
|
model | string |
モデル |
|
名前
|
name | string |
名前 |
|
ロール
|
roles | array of string |
ロール |
|
shareUuid
|
shareUuid | string |
shareUuid |
|
種類
|
type | string |
種類 |
|
UUID
|
uuid | string |
UUID |
参加者の追加または更新
新しい参加者を招待するか、割り当てられた役割を編集する
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
メール
|
emails | True | array of string |
メール |
|
Message
|
message | string |
招待メッセージ |
|
|
roles
|
roles | array of string |
roles |
|
|
ワークスペース UUID
|
shareUuid | True | string |
UUID |
|
参加者の可視性
|
type | string |
標準 - 他の参加者に表示される。 BCC - 参加者は他の人には非表示となる |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
|
array of object | ||
|
承諾済み
|
accepted | boolean |
承諾済み |
|
電子メール
|
string |
電子メール |
|
|
isOwner
|
isOwner | boolean |
isOwner |
|
モデル
|
model | string |
モデル |
|
ロール
|
roles | array of string |
ロール |
|
shareUuid
|
shareUuid | string |
shareUuid |
|
種類
|
type | string |
種類 |
|
UUID
|
uuid | string |
UUID |
定義
アクセス
- アクセス
- string
AssetReturnDocumentResponse
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
commentCount
|
commentCount | integer | |
|
contentVersion
|
contentVersion | integer | |
|
createdDate
|
createdDate | string | |
|
拡張子
|
extension | string | |
|
fileSize
|
fileSize | integer | |
|
ロック済み
|
locked | boolean | |
|
モデル
|
model | string | |
|
modifiedByUuid
|
modifiedByUuid | string | |
|
modifiedDate
|
modifiedDate | string | |
|
名前
|
name | string | |
|
parentUuid
|
parentUuid | string | |
|
previewPageCount
|
previewPageCount | integer | |
|
previewstatus
|
previewstatus | PreviewStatus | |
|
状態
|
status | AssetStatus | |
|
概要
|
summary | string | |
|
種類
|
type | AssetType | |
|
UUID
|
uuid | string | |
|
wopiRestricted
|
wopiRestricted | boolean |
AssetStatus
AssetType
DocumentVersion
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
createdDate
|
createdDate | string | |
|
拡張子
|
extension | string | |
|
fileSize
|
fileSize | integer | |
|
モデル
|
model | string | |
|
状態
|
status | AssetStatus | |
|
UUID
|
uuid | string | |
|
バージョン
|
version | integer |
EndOnDateOptionalValue
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
存在
|
present | boolean | |
|
値
|
value | string |
NotificationPreference
- NotificationPreference
- string
PreviewStatus
ShareResponse
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
アクセス
|
access | Access | |
|
接続
|
connections | integer | |
|
createdDate
|
createdDate | string | |
|
EndOnDateOptionalValue
|
endOnDateOptionalValue | EndOnDateOptionalValue | |
|
モデル
|
model | string | |
|
modifiedDate
|
modifiedDate | string | |
|
名前
|
name | string | |
|
organisationUuid
|
organisationUuid | string | |
|
ownerUuid
|
ownerUuid | string | |
|
セキュリティで保護
|
secure | boolean | |
|
ShareStatus
|
shareStatus | ShareStatus | |
|
状態
|
status | AssetStatus | |
|
SynchStatus
|
synchStatus | SynchStatus | |
|
UUID
|
uuid | string |
ShareStatus
- ShareStatus
- string
SynchStatus
- SynchStatus
- string
UserResponse
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
無効
|
disabled | boolean | |
|
電子メール
|
string | ||
|
firstName
|
firstName | string | |
|
hideEmailAddress
|
hideEmailAddress | boolean | |
|
lastName
|
lastName | string | |
|
モデル
|
model | string | |
|
notificationPreferences
|
notificationPreferences | array of NotificationPreference | |
|
organisationUuid
|
organisationUuid | string | |
|
ロール
|
roles | array of string | |
|
UserStatus
|
status | UserStatus | |
|
タイムゾーン
|
timezone | string | |
|
UUID
|
uuid | string |
UserStatus
- UserStatus
- string