Objective Connect (Önizleme)

Objective Connect, kuruluşun hassas belgeleri dış taraflarla paylaşmasına olanak tanıyan güvenilir dosya paylaşım platformudur. Kullanıcılar birkaç saniye içinde özel çalışma alanları oluşturabilir ve katılımcıları Bulutta davet edebilir. İşbirliği, raporlama, güvenlik ve uyumluluk özellikleri, devletlerin ve düzenlemeye tabi sektörlerin iç rahatlığıyla dışarıdan çalışabilmesini sağlar.

Bu bağlayıcı aşağıdaki ürün ve bölgelerde kullanılabilir:

Hizmet	Class	Bölgeler
Copilot Studio	Premium	Aşağıdakiler dışında tüm Power Automate bölgeleri :      - ABD Kamu (GCC)      - US Government (GCC High)      - 21Vianet tarafından işletilen Çin Bulutu      - ABD Savunma Bakanlığı (DoD)
Logic Apps	Standart	Aşağıdakiler dışında tüm Logic Apps bölgeleri :      - Azure Kamu bölgeleri      - Azure Çin bölgeleri      - ABD Savunma Bakanlığı (DoD)
Power Apps	Premium	Aşağıdakiler dışında tüm Power Apps bölgeleri :      - ABD Kamu (GCC)      - US Government (GCC High)      - 21Vianet tarafından işletilen Çin Bulutu      - ABD Savunma Bakanlığı (DoD)
Power Automate	Premium	Aşağıdakiler dışında tüm Power Automate bölgeleri :      - ABD Kamu (GCC)      - US Government (GCC High)      - 21Vianet tarafından işletilen Çin Bulutu      - ABD Savunma Bakanlığı (DoD)

Bağlayıcı Meta Verileri
Publisher	Objective Corporation

Bağlantı oluşturma

Bağlayıcı aşağıdaki kimlik doğrulama türlerini destekler:

Varsayılan	Bağlantı oluşturmak için parametreler.	Tüm bölgeler	Paylaşılamaz

Temerrüt

Geçerli: Tüm bölgeler

Bağlantı oluşturmak için parametreler.

Bu, paylaşılabilir bir bağlantı değildir. Power app başka bir kullanıcıyla paylaşılıyorsa, başka bir kullanıcıdan açıkça yeni bağlantı oluşturması istenir.

İsim	Türü	Description	Gerekli
Şifre	securestring	Bu API'nin parolası	Doğru
Sunucu bölgesi. (UK - secure.objectiveconnect.co.uk, ANZ - secure.objectiveconnect.com)	String	Objective Connect sunucusunu belirtin.	Doğru
Kullanıcı adı	securestring	Bu API'nin kullanıcı adı	Doğru

Azaltma Sınırları

Name	Çağrılar	Yenileme Dönemi
Bağlantı başına API çağrıları	100	60 saniye

Eylemler

Belge içeriğini alma	Belgenin içeriğini döndürür
Belge içeriğini karşıya yükleme	Belgenin içeriğini karşıya yükleme
Belge oluşturma	İstek application:hal+json ise, yalnızca meta veriler oluşturur. İstek çok parçalı:form-data ise, tek bir çağrıda içerik içeren belge oluşturur.
Belge sürümlerini listeleme	Varlık sürümlerinin listesini alma
Belge sürümü içeriğini alma	Belge sürümünün içeriğini döndürür
Belge sürümünü alma	Varlık sürümü alma
Katılımcı ekleme veya güncelleştirme	Yeni katılımcı davet etme veya atanan rolleri düzenleme
Katılımcıları alma	Çalışma alanı katılımcılarını alma
Katılımcıyı sil	Katılımcıyı çalışma alanından kaldırır
Kullanıcı alma	Kullanıcıları alma
Paylaşılan belgeleri listeleme	Çalışma Alanı UUID'sine göre Varlıkların listesini alma
Çalışma alanlarını listeleme	İstekte bulunan kullanıcının görme ayrıcalığına sahip olduğu Paylaşımların listesini alma
Çalışma alanı oluşturma	Çalışma alanı oluşturma
Çalışma alanını alma	Kimliğine göre çalışma alanı alma

Belge içeriğini alma

İşlem Kimliği:

GetDocumentContent

Belgenin içeriğini döndürür

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Belge	assetUuid	True	string	UUID
Workspace	shareUuid	True	string	UUID

Belge içeriğini karşıya yükleme

İşlem Kimliği:

UploadDocumentContent

Belgenin içeriğini karşıya yükleme

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Belge	assetUuid	True	string	Belge UUID
Workspace	shareUuid	True	string	Çalışma Alanı UUID
Dosya içeriği	file	True	file	Karşıya yüklenecek dosya içeriği

Belge oluşturma

İşlem Kimliği:

CreateDocument

İstek application:hal+json ise, yalnızca meta veriler oluşturur. İstek çok parçalı:form-data ise, tek bir çağrıda içerik içeren belge oluşturur.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Çalışma Alanı UUID	shareUuid	True	string	Yoldaki paylaşım uuid değeri
Dosya içeriği	file	True	file	Karşıya yüklenecek dosya içeriği
Dosya adı	name	True	string	Dosya adı
Üst UUID	parentUuid		string	(İsteğe bağlı)
Özet	summary		string	(İsteğe bağlı)

Döndürülenler

Body

AssetReturnDocumentResponse

Belge sürümlerini listeleme

İşlem Kimliği:

ListDocumentVersions

Varlık sürümlerinin listesini alma

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Belge	assetUuid	True	string	Belge UUID
Workspace	shareUuid	True	string	Çalışma Alanı UUID
Length	length		integer	Alınacak en fazla sonuç sayısı
Ofset baskı	offset		integer	Başlangıç sonucu (varsayılan olarak 0'dır).

Döndürülenler

response

array of DocumentVersion

Belge sürümü içeriğini alma

İşlem Kimliği:

GetDocumentVersionContent

Belge sürümünün içeriğini döndürür

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Belge	assetUuid	True	string	UUID
İçerik sürümü	contentVersion	True	integer	Belgenin sürüm numarası
Workspace	shareUuid	True	string	UUID

Belge sürümünü alma

İşlem Kimliği:

GetDocumentVersion

Varlık sürümü alma

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Belge	assetUuid	True	string	UUID
Workspace	shareUuid	True	string	UUID
Sürüm	version	True	integer	Belgenin sürüm numarası

Döndürülenler

Body

DocumentVersion

Katılımcı ekleme veya güncelleştirme

İşlem Kimliği:

AddParticipant

Yeni katılımcı davet etme veya atanan rolleri düzenleme

Parametreler

Name	Anahtar	Gerekli	Tür	Description
e-postalar	emails	True	array of string	e-postalar
Message	message		string	Davet iletisi
roles	roles		array of string	roles
Çalışma Alanı UUID	shareUuid	True	string	UUID
Katılımcı görünürlüğü	type		string	STANDART - diğer katılımcılara görünür. Gizli - katılımcı diğerlerinden gizlenir

Döndürülenler

Name	Yol	Tür	Description
		array of object
kabul etti	accepted	boolean	kabul etti
e-posta	email	string	e-posta
isOwner	isOwner	boolean	isOwner
model	model	string	model
roles	roles	array of string	roles
shareUuid	shareUuid	string	shareUuid
type	type	string	type
UUID (evrensel benzersiz tanımlayıcı)	uuid	string	UUID (evrensel benzersiz tanımlayıcı)

Katılımcıları alma

İşlem Kimliği:

GetParticipants

Çalışma alanı katılımcılarını alma

Parametreler

Name	Anahtar	Gerekli	Tür	Description
User	userUuid		string	Kullanıcı UUID

Döndürülenler

Name	Yol	Tür	Description
		array of object
kabul etti	accepted	boolean	kabul etti
e-posta	email	string	e-posta
isOwner	isOwner	boolean	isOwner
joinedDate	joinedDate	string	joinedDate
model	model	string	model
name	name	string	name
roles	roles	array of string	roles
shareUuid	shareUuid	string	shareUuid
type	type	string	type
UUID (evrensel benzersiz tanımlayıcı)	uuid	string	UUID (evrensel benzersiz tanımlayıcı)

Katılımcıyı sil

İşlem Kimliği:

DeleteParticipant

Katılımcıyı çalışma alanından kaldırır

Parametreler

Name	Anahtar	Gerekli	Tür	Description
User	uuid	True	string	Kullanıcı UUID

Kullanıcı alma

İşlem Kimliği:

GetUser

Kullanıcıları alma

Parametreler

Name	Anahtar	Gerekli	Tür	Description
E-posta	emailAddress		string	Aranacak e-posta adresi
Length	length		integer	Döndürülecek sonuç sayısı. Yalnızca uzaklık kullanılıyorsa kullanılır.
Ofset baskı	offset		integer	Bu konumdan sonraki sonuçları döndür
Örgüt	orgUuid		string	Aranacak kuruluşun UUID değeri
Sırala	sort		string	param - sort, sıralama alanını isteğe bağlı ":d esc" etiketini gösteren bir sözcük biçiminde olmalıdır; yoksa artan düzen varsayılır. Hatalı veya boş istekler varsayılan olarak artan addır. Kullanılabilir sıralamalar şunlardır: firstName, lastName, email
Kullanıcı UUID'leri	uuids		array	Kullanıcı uuid'lerinin listesi

Döndürülenler

response

array of UserResponse

Paylaşılan belgeleri listeleme

İşlem Kimliği:

ListDocuments

Çalışma Alanı UUID'sine göre Varlıkların listesini alma

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Workspace	shareUuid	True	string	Çalışma Alanı UUID
Length	length		integer	Alınacak en fazla sonuç sayısı
Ofset baskı	offset		integer	Döndürülen değerlerin başlatıldığı sonuç (varsayılan olarak 0'dır)
Üst UUID	parentUuid		string	Paylaşımın veya üst varlığın UUID değeri. Sağlandıysa sonuçlar, hissenin veya varlığın hemen alt öğeleriyle sınırlandırılır. Geçersizse, yanıt boş bir listeyle 200 olur.
Query	query		string	Arama sorgusu dizesi. Sağlandıysa, sonuçlar verilen sorgu değeriyle başlayan adla varlıklarla sınırlandırılır.
Sırala	sort		string	Sıralama düzeni ölçüt dizesi. Kabul edilebilir değerler şunlardır: name oluşturulmaTarihi modifiedDate boyut Sıralama ölçütlerini isteğe bağlı olarak ":d esc" takip ederek sıralamanın azalan düzende olması gerektiğini gösterebilir. SortInfo sağlanmadıysa veya geçersiz değerler içeriyorsa, liste artan Varlık adına göre sıralanır

Döndürülenler

Name	Yol	Tür	Description
		array of object
annotationsCount	annotationsCount	integer	annotationsCount
commentCount	commentCount	integer	commentCount
içerikSürümü	contentVersion	integer	içerikSürümü
oluşturulmaTarihi	createdDate	string	oluşturulmaTarihi
genişletme	extension	string	genişletme
dosya boyutu	fileSize	integer	dosya boyutu
Kilitli	locked	boolean	Kilitli
model	model	string	model
modifiedByUuid	modifiedByUuid	string	modifiedByUuid
modifiedDate	modifiedDate	string	modifiedDate
name	name	string	name
pdfPreviewstatus	pdfPreviewstatus	string	pdfPreviewstatus
previewPageCount	previewPageCount	integer	previewPageCount
previewstatus	previewstatus	string	previewstatus
statü	status	string	statü
type	type	string	type
UUID (evrensel benzersiz tanımlayıcı)	uuid	string	UUID (evrensel benzersiz tanımlayıcı)
wopiRestricted	wopiRestricted	boolean	wopiRestricted

Çalışma alanlarını listeleme

İşlem Kimliği:

ListWorkspaces

İstekte bulunan kullanıcının görme ayrıcalığına sahip olduğu Paylaşımların listesini alma

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Length	length		integer	Alınacak en fazla sonuç sayısı
Ofset baskı	offset		integer	Döndürülen değerlerin başlatıldığı sonuç (varsayılan olarak 0'dır)
Sahibi	ownerUuid		string	Sahibin kullanıcı UUID'si. Sağlanırsa, sonuçlar bu kullanıcıya ait paylaşımlar ile kısıtlanır
Katılımcı	participantUuid		string	Katılımcının kullanıcı UUID'si. Sağlanırsa sonuçlar, bu kullanıcının katılımcı olduğu paylaşımlar ile kısıtlanır
Query	query		string	Arama sorgusu dizesi. Sağlanırsa, sonuçlar belirtilen sorgu değerini içeren ada sahip paylaşımlarla kısıtlanır
Sırala	sort		string	Sıralama düzeni ölçüt dizesi. Kabul edilebilir değerler şunlardır: name oluşturulmaTarihi modifiedDate Katıldı shareOrder kuruluş Sıralama ölçütlerini isteğe bağlı olarak ":d esc" takip ederek sıralamanın azalan düzende olması gerektiğini belirtebilirsiniz. SortInfo sağlanmadıysa veya geçersiz değerler içeriyorsa, liste artan Paylaşım adına göre sıralanır.
Çalışma Grubu	workgroupUuid		string	Çalışma grubu UUID. Sağlanmışsa sonuçlar çalışma grubuna ait paylaşımlar ile kısıtlanır

Döndürülenler

response

array of ShareResponse

Çalışma alanı oluşturma

İşlem Kimliği:

CreateWorkspace

Çalışma alanı oluşturma

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Kullanıcı UUID	userUuid	True	string	Kullanıcı UUID
Access	access		string
Temsilci	agentShareToken		string	Aracı belirteci
İsim	name	True	string	İsim
Organizasyon	organisationUuid		string	Kuruluş UUID
Sahibi	ownerUuid		string	Sahip UUID
Özet	summary		string	Özet
UUID	uuid		string	UUID

Döndürülenler

Body

ShareResponse

Çalışma alanını alma

İşlem Kimliği:

GetWorkspace

Kimliğine göre çalışma alanı alma

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Workspace	shareUuid	True	string	Alınacak Çalışma Alanının uuid değeri

Döndürülenler

Body

ShareResponse

Tanımlar

Access

Access

string

AssetReturnDocumentResponse

Name	Yol	Tür	Description
commentCount	commentCount	integer
içerikSürümü	contentVersion	integer
oluşturulmaTarihi	createdDate	string
genişletme	extension	string
dosya boyutu	fileSize	integer
Kilitli	locked	boolean
model	model	string
modifiedByUuid	modifiedByUuid	string
modifiedDate	modifiedDate	string
name	name	string
parentUuid	parentUuid	string
previewPageCount	previewPageCount	integer
previewstatus	previewstatus	PreviewStatus
statü	status	AssetStatus
summary	summary	string
type	type	AssetType
UUID (evrensel benzersiz tanımlayıcı)	uuid	string
wopiRestricted	wopiRestricted	boolean

AssetStatus

string

AssetType

string

DocumentVersion

Name	Yol	Tür	Description
oluşturulmaTarihi	createdDate	string
genişletme	extension	string
dosya boyutu	fileSize	integer
model	model	string
statü	status	AssetStatus
UUID (evrensel benzersiz tanımlayıcı)	uuid	string
version	version	integer

EndOnDateOptionalValue

Name	Yol	Tür	Description
hediye	present	boolean
value	value	string

NotificationPreference

NotificationPreference

string

PreviewStatus

string

ShareResponse

Name	Yol	Tür	Description
Access	access	Access
connections	connections	integer
oluşturulmaTarihi	createdDate	string
EndOnDateOptionalValue	endOnDateOptionalValue	EndOnDateOptionalValue
model	model	string
modifiedDate	modifiedDate	string
name	name	string
organisationUuid	organisationUuid	string
ownerUuid	ownerUuid	string
güvenli	secure	boolean
ShareStatus	shareStatus	ShareStatus
statü	status	AssetStatus
SynchStatus	synchStatus	SynchStatus
UUID (evrensel benzersiz tanımlayıcı)	uuid	string

ShareStatus

ShareStatus

string

SynchStatus

SynchStatus

string

UserResponse

Name	Yol	Tür	Description
engelli	disabled	boolean
e-posta	email	string
ön ad	firstName	string
hideEmailAddress	hideEmailAddress	boolean
soyadı	lastName	string
model	model	string
notificationPreferences	notificationPreferences	array of NotificationPreference
organisationUuid	organisationUuid	string
roles	roles	array of string
UserStatus	status	UserStatus
timezone	timezone	string
UUID (evrensel benzersiz tanımlayıcı)	uuid	string

UserStatus

UserStatus

string