다음을 통해 공유

Objective Connect(미리 보기)

Objective Connect는 조직에서 중요한 문서를 외부 당사자와 공유할 수 있는 신뢰할 수 있는 파일 공유 플랫폼입니다. 사용자는 몇 초 만에 프라이빗 작업 영역을 만들고 클라우드에서 참가자를 초대할 수 있습니다. 협업, 보고, 보안 및 규정 준수 기능을 통해 정부와 규제 산업이 안심하면서 외부에서 작업할 수 있습니다.

이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.

서비스 클래스 Regions
Copilot Studio Premium 다음을 제외한 모든 Power Automate 지역 :
     - 미국 정부(GCC)
     - 미국 정부(GCC High)
     - 21Vianet에서 운영하는 중국 클라우드
     - 미국 국방부(DoD)
논리 앱 스탠다드 다음을 제외한 모든 Logic Apps 지역 :
     - Azure Government 지역
     - Azure 중국 지역
     - 미국 국방부(DoD)
Power Apps Premium 다음을 제외한 모든 Power Apps 지역 :
     - 미국 정부(GCC)
     - 미국 정부(GCC High)
     - 21Vianet에서 운영하는 중국 클라우드
     - 미국 국방부(DoD)
Power Automate Premium 다음을 제외한 모든 Power Automate 지역 :
     - 미국 정부(GCC)
     - 미국 정부(GCC High)
     - 21Vianet에서 운영하는 중국 클라우드
     - 미국 국방부(DoD)
커넥터 메타데이터
게시자 Objective Corporation

연결을 만드는 중

커넥터는 다음 인증 유형을 지원합니다.
기본값 연결을 만들기 위한 매개 변수입니다. 모든 지역 공유할 수 없음

기본값

적용 가능: 모든 지역

연결을 만들기 위한 매개 변수입니다.

공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.

이름 유형 Description 필수
암호 시큐어스트링 (보안 문자열) 이 API의 암호 진실
서버 지역입니다. (영국 - secure.objectiveconnect.co.uk, ANZ - secure.objectiveconnect.com) 문자열 Objective Connect 서버를 지정합니다. 진실
사용자 이름 시큐어스트링 (보안 문자열) 이 API의 사용자 이름 진실

제한 한도

Name 호출 갱신 기간
연결당 API 호출 100 60초

동작

공유 문서 나열

작업 영역 UUID별 자산 목록 가져오기
문서 만들기

Request가 application:hal+json인 경우 메타데이터만 만듭니다. 요청이 다중 파트:form-data인 경우 단일 호출에서 콘텐츠가 포함된 문서를 만듭니다.
문서 버전 가져오기

자산 버전 가져오기
문서 버전 나열

자산 버전 목록 가져오기
문서 버전 콘텐츠 가져오기

문서 버전의 내용을 반환합니다.
문서 콘텐츠 가져오기

문서의 내용을 반환합니다.
문서 콘텐츠 업로드

문서에 대한 콘텐츠 업로드
사용자 가져오기

사용자 가져오기
작업 영역 가져오기

ID별 작업 영역 가져오기
작업 영역 나열

요청하는 사용자에게 볼 수 있는 권한이 있는 공유 목록을 가져옵니다.
작업 영역 만들기

작업 영역 만들기
참가자 가져오기

작업 영역 참가자 가져오기
참가자 삭제

작업 영역에서 참가자를 제거합니다.
참가자 추가 또는 업데이트

새 참가자 초대 또는 할당된 역할 편집

공유 문서 나열

작업 ID:
ListDocuments

작업 영역 UUID별 자산 목록 가져오기

매개 변수

Name 키 필수 형식 Description
작업 공간
 shareUuid True string

작업 영역 UUID
Length
 length integer

검색할 최대 결과 수
상쇄
 offset integer

반환된 값이 시작되는 결과(기본값: 0)
부모 UUID
 parentUuid string

공유 또는 부모 자산의 UUID입니다. 제공된 경우 결과는 공유 또는 자산의 직위 자식으로 제한됩니다. 잘못된 경우 응답은 빈 목록이 있는 200이 됩니다.
Query
 query string

검색 쿼리 문자열입니다. 제공된 경우 결과는 지정된 쿼리 값으로 시작하는 이름의 자산으로 제한됩니다.
Sort
 sort string

정렬 순서 조건 문자열입니다. 허용되는 값은 다음과 같습니다.

  • 이름
  • 생성일
  • modifiedDate
  • size 정렬 조건에는 선택적으로 ":d esc"가 뒤에 오면 정렬 순서가 내림차순이어야 함을 나타낼 수 있습니다. sortInfo가 제공되지 않거나 잘못된 값이 포함된 경우 목록은 오름차순 자산 이름으로 정렬됩니다.

반환

Name 경로 형식 Description
array of object
annotationsCount
 annotationsCount integer

annotationsCount
commentCount
 commentCount integer

commentCount
콘텐츠 버전
 contentVersion integer

콘텐츠 버전
생성일
 createdDate string

생성일
확장
 extension string

확장
파일 크기
 fileSize integer

파일 크기
잠김
 locked boolean

잠김
model
 model string

model
modifiedByUuid
 modifiedByUuid string

modifiedByUuid
modifiedDate
 modifiedDate string

modifiedDate
이름
 name string

이름
pdfPreviewstatus
 pdfPreviewstatus string

pdfPreviewstatus
previewPageCount
 previewPageCount integer

previewPageCount
previewstatus
 previewstatus string

previewstatus
status
 status string

status
type
 type string

type
UUID (범용 고유 식별자)
 uuid string

UUID (범용 고유 식별자)
wopiRestricted
 wopiRestricted boolean

wopiRestricted

문서 만들기

작업 ID:
CreateDocument

Request가 application:hal+json인 경우 메타데이터만 만듭니다. 요청이 다중 파트:form-data인 경우 단일 호출에서 콘텐츠가 포함된 문서를 만듭니다.

매개 변수

Name 키 필수 형식 Description
작업 영역 UUID
 shareUuid True string

경로의 공유 uuid
파일 콘텐츠
 file True file

업로드할 파일 콘텐츠
파일 이름
 name True string

파일 이름
부모 UUID
 parentUuid string

(선택 사항)
요약
 summary string

(선택 사항)

반환

몸
AssetReturnDocumentResponse

문서 버전 가져오기

작업 ID:
GetDocumentVersion

자산 버전 가져오기

매개 변수

Name 키 필수 형식 Description
문서
 assetUuid True string

UUID(범용 고유 식별자)
작업 공간
 shareUuid True string

UUID(범용 고유 식별자)
버전
 version True integer

문서의 버전 번호

반환

몸
DocumentVersion

문서 버전 나열

작업 ID:
ListDocumentVersions

자산 버전 목록 가져오기

매개 변수

Name 키 필수 형식 Description
문서
 assetUuid True string

문서 UUID
작업 공간
 shareUuid True string

작업 영역 UUID
Length
 length integer

검색할 최대 결과 수
상쇄
 offset integer

시작할 결과입니다(기본값: 0).

반환

response
array of DocumentVersion

문서 버전 콘텐츠 가져오기

작업 ID:
GetDocumentVersionContent

문서 버전의 내용을 반환합니다.

매개 변수

Name 키 필수 형식 Description
문서
 assetUuid True string

UUID(범용 고유 식별자)
콘텐츠 버전
 contentVersion True integer

문서의 버전 번호
작업 공간
 shareUuid True string

UUID(범용 고유 식별자)

문서 콘텐츠 가져오기

작업 ID:
GetDocumentContent

문서의 내용을 반환합니다.

매개 변수

Name 키 필수 형식 Description
문서
 assetUuid True string

UUID(범용 고유 식별자)
작업 공간
 shareUuid True string

UUID(범용 고유 식별자)

문서 콘텐츠 업로드

작업 ID:
UploadDocumentContent

문서에 대한 콘텐츠 업로드

매개 변수

Name 키 필수 형식 Description
문서
 assetUuid True string

문서 UUID
작업 공간
 shareUuid True string

작업 영역 UUID
파일 콘텐츠
 file True file

업로드할 파일 콘텐츠

사용자 가져오기

작업 ID:
GetUser

사용자 가져오기

매개 변수

Name 키 필수 형식 Description
전자 메일
 emailAddress string

검색할 전자 메일 주소
Length
 length integer

반환할 결과 수입니다. 오프셋을 사용하는 경우에만 사용됩니다.
상쇄
 offset integer

이 위치 뒤의 결과 반환
조직
 orgUuid string

검색할 조직의 UUID
Sort
 sort string

매개 변수 - 정렬은 오름차순이 없는 경우 정렬 필드에 선택적 ":d esc" 태그를 나타내는 단어 형식이어야 합니다. 잘못된 요청 또는 빈 요청은 기본적으로 오름차순 이름으로 설정됩니다. 사용 가능한 정렬은 firstName, lastName, email입니다.
사용자 UUID
 uuids array

사용자 uuids 목록

반환

response
array of UserResponse

작업 영역 가져오기

작업 ID:
GetWorkspace

ID별 작업 영역 가져오기

매개 변수

Name 키 필수 형식 Description
작업 공간
 shareUuid True string

검색할 작업 영역의 uuid

반환

몸
ShareResponse

작업 영역 나열

작업 ID:
ListWorkspaces

요청하는 사용자에게 볼 수 있는 권한이 있는 공유 목록을 가져옵니다.

매개 변수

Name 키 필수 형식 Description
Length
 length integer

검색할 최대 결과 수
상쇄
 offset integer

반환된 값이 시작되는 결과(기본값: 0)
소유자
 ownerUuid string

소유자의 사용자 UUID입니다. 제공된 경우 결과는 이 사용자가 소유한 공유로 제한됩니다.
참가자
 participantUuid string

참가자의 사용자 UUID입니다. 제공된 경우 결과가 이 사용자가 참가자인 공유로 제한됩니다.
Query
 query string

쿼리 문자열을 검색합니다. 제공된 경우 결과는 지정된 쿼리 값을 포함하는 이름의 공유로 제한됩니다.
Sort
 sort string

정렬 순서 조건 문자열입니다. 허용되는 값은 다음과 같습니다.

  • 이름
  • 생성일
  • modifiedDate
  • 합류
  • shareOrder
  • 조직 정렬 기준 다음에 ":d esc"를 추가하여 정렬이 내림차순이어야 함을 나타낼 수 있습니다. sortInfo가 제공되지 않거나 잘못된 값이 포함된 경우 목록은 오름차순 공유 이름으로 정렬됩니다.
작업 그룹
 workgroupUuid string

작업 그룹 UUID. 제공된 경우 결과는 작업 그룹에 속한 공유로 제한됩니다.

반환

response
array of ShareResponse

작업 영역 만들기

작업 ID:
CreateWorkspace

작업 영역 만들기

매개 변수

Name 키 필수 형식 Description
사용자 UUID
 userUuid True string

사용자 UUID
Access
 access string
에이전트
 agentShareToken string

에이전트 토큰
이름
 name True string

이름
조직
 organisationUuid string

조직 UUID
소유자
 ownerUuid string

소유자 UUID
요약
 summary string

요약
UUID(범용 고유 식별자)
 uuid string

UUID(범용 고유 식별자)

반환

몸
ShareResponse

참가자 가져오기

작업 ID:
GetParticipants

작업 영역 참가자 가져오기

매개 변수

Name 키 필수 형식 Description
사용자
 userUuid string

사용자 UUID

반환

Name 경로 형식 Description
array of object
accepted
 accepted boolean

accepted
메일 주소
 email string

메일 주소
isOwner
 isOwner boolean

isOwner
joinedDate
 joinedDate string

joinedDate
model
 model string

model
이름
 name string

이름
roles
 roles array of string

roles
shareUuid
 shareUuid string

shareUuid
type
 type string

type
UUID (범용 고유 식별자)
 uuid string

UUID (범용 고유 식별자)

참가자 삭제

작업 ID:
DeleteParticipant

작업 영역에서 참가자를 제거합니다.

매개 변수

Name 키 필수 형식 Description
사용자
 uuid True string

사용자 UUID

참가자 추가 또는 업데이트

작업 ID:
AddParticipant

새 참가자 초대 또는 할당된 역할 편집

매개 변수

Name 키 필수 형식 Description
전자 메일
 emails True array of string

전자 메일
Message
 message string

초대 메시지
roles
 roles array of string

roles
작업 영역 UUID
 shareUuid True string

UUID(범용 고유 식별자)
참가자 가시성
 type string

STANDARD - 다른 참가자에게 표시됩니다. BCC - 참가자가 다른 사용자에게 숨겨집니다.

반환

Name 경로 형식 Description
array of object
accepted
 accepted boolean

accepted
메일 주소
 email string

메일 주소
isOwner
 isOwner boolean

isOwner
model
 model string

model
roles
 roles array of string

roles
shareUuid
 shareUuid string

shareUuid
type
 type string

type
UUID (범용 고유 식별자)
 uuid string

UUID (범용 고유 식별자)

정의

Access

Access
string

AssetReturnDocumentResponse

Name 경로 형식 Description
commentCount
 commentCount integer
콘텐츠 버전
 contentVersion integer
생성일
 createdDate string
확장
 extension string
파일 크기
 fileSize integer
잠김
 locked boolean
model
 model string
modifiedByUuid
 modifiedByUuid string
modifiedDate
 modifiedDate string
이름
 name string
parentUuid
 parentUuid string
previewPageCount
 previewPageCount integer
previewstatus
 previewstatus PreviewStatus
status
 status AssetStatus
summary
 summary string
type
 type AssetType
UUID (범용 고유 식별자)
 uuid string
wopiRestricted
 wopiRestricted boolean

AssetStatus

string

AssetType

string

DocumentVersion

Name 경로 형식 Description
생성일
 createdDate string
확장
 extension string
파일 크기
 fileSize integer
model
 model string
status
 status AssetStatus
UUID (범용 고유 식별자)
 uuid string
version
 version integer

EndOnDateOptionalValue

Name 경로 형식 Description
선물
 present boolean
value
 value string

NotificationPreference

NotificationPreference
string

PreviewStatus

string

ShareResponse

Name 경로 형식 Description
Access
 access Access
connections
 connections integer
생성일
 createdDate string
EndOnDateOptionalValue
 endOnDateOptionalValue EndOnDateOptionalValue
model
 model string
modifiedDate
 modifiedDate string
이름
 name string
organisationUuid
 organisationUuid string
ownerUuid
 ownerUuid string
확실한
 secure boolean
ShareStatus
 shareStatus ShareStatus
status
 status AssetStatus
SynchStatus
 synchStatus SynchStatus
UUID (범용 고유 식별자)
 uuid string

ShareStatus

ShareStatus
string

SynchStatus

SynchStatus
string

UserResponse

Name 경로 형식 Description
사용 안 함
 disabled boolean
메일 주소
 email string
이름 (첫 번째 이름)
 firstName string
hideEmailAddress
 hideEmailAddress boolean
lastName
 lastName string
model
 model string
notificationPreferences
 notificationPreferences array of NotificationPreference
organisationUuid
 organisationUuid string
roles
 roles array of string
UserStatus
 status UserStatus
시간대
 timezone string
UUID (범용 고유 식별자)
 uuid string

UserStatus

UserStatus
string