Cognito Forms

Cognito Forms, gönderim verilerini toplamaya ve yönetmeye yönelik çevrimiçi bir form oluşturucudur. Bu bağlayıcı, girdiler oluşturulduğunda, güncelleştirildiğinde veya silindiğinde otomatik akışların tetiklenmesini sağlar ve girdileri oluşturmak, güncelleştirmek ve almak için eylemler sağlar. Verileri yönlendirmek, karşıya yüklenen dosyaları işlemek ve iş iş akışlarını otomatikleştirmek için Cognito Forms'ı diğer hizmetlerle tümleştirin.

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

Hizmet	Class	Bölgeler
Copilot Studio	Standart	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	Standart	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	Standart	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)

İletişim
İsim	Cognito Forms Desteği
URL	https://www.cognitoforms.com/support
E-posta	support@cognitoforms.com

Bağlayıcı Meta Verileri
Publisher	Cognito Forms, LLC
Web sitesi	https://www.cognitoforms.com
Gizlilik İlkesi	https://www.cognitoforms.com/legal/privacy
Kategoriler	Verimli -lik; Işbirliği

Cognito Forms

Cognito Forms anketler, sipariş formları, kayıt formları ve daha fazlası gibi güçlü çevrimiçi formları kolayca oluşturmanıza olanak tanır. Bedavaya. Genel Power Automate bağlayıcımızla ilgili yardım için lütfen support belgelerimize veya bakın.

Publisher: Cognito Forms

Önkoşullar

Ücretli abonelik gereklidir.

Desteklenen İşlemler

Triggers

Tetikleyiciler, abone olunan olay gerçekleştikten kısa bir süre sonra gönderilir.

NewEntry

Bu, belirtilen form için yeni bir giriş oluşturulduğunda tetiklenir. Çıkış, dosya verileri ve dosyalara, imzalara ve giriş belgelerine yönelik geçici bağlantılar da dahil olmak üzere giriş verileri olacaktır.

Parametreler:

• form: Yeni giriş olaylarının abone olacağı formun adı.

UpdateEntry

Belirtilen form için bir girdi güncelleştirildiğinde bu tetiklenir. Çıkış, dosya verileri ve dosyalara, imzalara ve giriş belgelerine yönelik geçici bağlantılar da dahil olmak üzere giriş verileri olacaktır.

Parametreler:

• form: Güncelleştirilmiş giriş olaylarının abone olacağı formun adı.

EntryDeleted

Belirtilen form için bir girdi silindiğinde bu tetiklenir. Çıkış, bağlantılar hariç giriş verileri olacaktır.

Parametreler:

• form: Girdinin silindiği olayların abone olacağı formun adı.

Eylemler

CreateEntry

Bu eylem, belirtilen form için bir girdi oluşturur. Eylem, bazı alan türleri hariç olmak üzere her giriş alanı için ayarlanabilir özellikler içerir. Çıkış, giriş verileri olacaktır.

Parametreler:

• form: İç form adı veya kimliği

EditEntry

Bu eylem, belirtilen form için var olan bir girişi güncelleştirir. Eylem, bazı alan türleri hariç olmak üzere her giriş alanı için ayarlanabilir özellikler içerir. Giriş ücretli bir sipariş içeriyorsa veya entryId yoksa bu eylem başarısız olur. Çıkış, güncelleştirilmiş giriş verileri olacaktır.

Parametreler:

• form: İç form adı veya kimliği
• entryId: Güncelleştirilecek girişin giriş numarası veya giriş kimliği

SetFormAvailability

Bu eylem formun kullanılabilirlik sınırı ayarlarını ayarlar. Formun start her zaman kullanılabilir olması için ve end parametreleri boş olmalıdır. Çıkış, güncelleştirilmiş kullanılabilirlik ayarları olacaktır.

Parametreler:

• form: İç form adı veya kimliği
• start: Formun kullanılabilir olması gereken tarih saat.
• end: Formun artık kullanılamaması gereken tarih saat.
• message: Kullanılabilirlik döneminin dışındayken forma erişmeye çalışan kullanıcılara gösterilmesi gereken ileti.

GetFile

Bu eylem, depolama alanından bir dosya alır. Çıkış, dosya verilerini, meta verileri ve dosyanın geçici bağlantısını içeren bir nesne olacaktır.

Parametreler:

• id: Alınacak dosyanın dosya kimliği.

GetDocument

Bu eylem, belirtilen formu, girişi ve şablonu kullanarak bir giriş belgesi oluşturur ve alır. Çıktı, belgenin dosya verilerini, meta verilerini ve belgenin geçici bağlantısını içeren bir nesne olacaktır.

Parametreler:

• form: İç form adı veya kimliği
• entry: Belgenin oluşturulması gereken girişin giriş kimliği veya giriş numarası
• templateNumber: Giriş belgesini oluşturmak için kullanılması gereken şablonun sayısı

GetEntry

Bu eylem, belirtilen form için var olan bir girdi alır. Girdi yoksa bu eylem başarısız olur. Çıkış, giriş verileri olacaktır.

Parametreler:

• form: İç form adı veya kimliği
• entryId: Alınacak girişin giriş numarası veya giriş kimliği

DeleteEntry

Bu eylem, belirtilen form için var olan bir girdiyi siler. Girdi yoksa bu eylem başarısız olur. Çıkış olmayacak.

Parametreler:

• form: İç form adı veya kimliği
• entryId: Silinecek girişin giriş numarası veya giriş kimliği

ImportEntries

Bu eylem, sağlanan dosya içeriğini (.xlsx veya .csv) kullanarak girdiler oluşturur, güncelleştirir veya siler. Çıkış, içeri aktarma kimliğini ve durumunu içeren bir nesne olacaktır.

Parametreler:

• form: İç form adı veya kimliği
• File: İçeri aktaracak girdileri içeren dosya (.xlsx veya .csv)
• ImportMode: İçeri aktarma modu (CreateNew, UpdateExisting veya SyncEntries)
• Email: İçeri aktarma bildirimlerini almak için e-posta adresi (isteğe bağlı)
• MatchEntriesUsing: Giriş kimliği yerine (isteğe bağlı)

GetImportStatus

Bu eylem, bir içeri aktarmanın geçerli durumunu alır ve başarılı ve başarısız girdilerin sayısını döndürür. Çıktı, varsa içeri aktarma durumunu, sayıları ve hata bilgilerini içeren bir nesne olacaktır.

Parametreler:

• form: İç form adı veya kimliği
• importId: Durumunu denetlemek için içeri aktarmanın kimliği

Uploadfile

Bu eylem, Cognito Forms'a bir dosya yükler.

Parametreler:

• fileContent: Dosyanın ikili verileri
• fileName: Dosyanın adı

GetEntryViewEntries

Bu eylem, belirtilen görünüm için tüm girişleri alır. Çıkış, görünüm yapılandırmasını temel alan giriş verileri olacaktır.

Parametreler:

• form: İç form adı veya kimliği
• viewId: Görünümün kimliği
• $count: Toplam girdi sayısını dahil et (isteğe bağlı)
• $select: $select=Kimlik belirtildiğinde Görünümdeki giriş kimliklerinin listesini döndürür (isteğe bağlı)

Özel İşlemler

Bu işlemler genel tetikleyiciler ve eylemler için etkinleştiricilerdir.

GetForms

Bu işlem, form listesini ve Idiçeren Name nesneler olarak döndürür. Eylemler ve tetikleyiciler için parametresi için form kullanıldığında, kullanıcının öğesini görmesi Name, ancak Id API'ye gönderilmesi gerekir. Arşivlenen formlar yanıta dahil değildir.

GetFormSchema

Bu işlem, belirtilen formun şemasını döndürür. Salt input okunur özellikleri dışlayan eylemler için parametresi true, tetikleyicilerin tüm özellikleri içermesi için false olmalıdır. includeLinks parametresi EntryDeleted dışında tüm eylemler ve tetikleyiciler için true olmalıdır.

Parametreler:

• form: İç form adı veya kimliği
• input: Döndürülen şemanın ayarlanamayan özellikleri dışlayıp dışlamaması gerektiğini gösteren boole değeri. Varsayılan olarak False.
• includeLinks: Dosyalar, imzalar ve belgeler için bağlantı özelliklerinin şemaya eklenip eklenmeyeceğini gösteren boole değeri. Varsayılan olarak True.

Abonelikten ÇıkWebhook

Bu işlem belirtilen web kancasının aboneliğini kaldıracak. Şu anda kuyruğa alınan tüm olaylar gönderildikten sonra web kancası artık hiçbir olay almaz.

Parametreler:

• id: Aboneliği kaldırılacak web kancasının kimliği.
• module: Web kancasının modülü. Bu bağlayıcı yalnızca bu modülü desteklediği için bu "formlar" olarak ayarlanmalıdır.

Kimlik Bilgilerini Alma

Kuruluş sahibinin Cognito Forms'da oturum açması ve bağlantıyı yetkilendirmesi gerekir.

Bilinen Sorunlar

Hiç kimse

Dağıtım Yönergeleri

Cognito Forms için geçerli Client id bir ve Client secret bağlayıcı oluşturulması gerekir. Bu özellikler anahtar kasasında bulunabilir ve yalnızca özel bağlayıcının kimlik doğrulama ayarlarında ayarlanmalıdır.

1. Koş!

    paconn create --api-def apiDefinition.swagger.json --api-prop apiProperties.json
   

2. PowerAutomate'ta oturum açın

3. Yeni bağlayıcıya gitme

4. "Güvenlik" Client id altında ve Client secret

5. Bağlayıcıyı güncelleştirme

Azaltma Sınırları

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

Eylemler

Belgeyi Al	Belge alır
Dosya Yükle	Form girdilerinde kullanılacak bir dosyayı karşıya yükler.
Dosyayı Al	Kimliğine göre bir dosya alır.
Form Girdilerini Al	Belirtilen görünüm için tüm girdileri alma
Form kullanılabilirliğini ayarlama	Formun kullanılabilirliğini ayarlar.
Girdi al	Bir girdi alır.
Girdi oluşturma	Yeni bir giriş oluşturur.
Girdileri İçeri Aktar	Sağlanan dosya içeriğini kullanarak girdileri oluşturur, güncelleştirir veya siler.
Girdiyi güncelleştir	Bir girdiyi güncelleştirir.
Girdiyi sil	Bir girdiyi silin.
İçeri Aktarma Durumunu Alma	İçeri aktarmanın geçerli durumunu alır ve başarılı ve başarısız girişlerin sayısını döndürür.

Belgeyi Al

İşlem Kimliği:

GetDocument

Belge alır

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Form	form	True	string	Formun adı
Giriş Kimliği	entry	True	string	Giriş kimliği
Şablon Numarası	templateNumber	True	integer	Şablon numarası

Döndürülenler

Dosya verilerini ve meta verileri içeren bir dosya başvurusu

Body

FileDataRef

Dosya Yükle

İşlem Kimliği:

UploadFile

Form girdilerinde kullanılacak bir dosyayı karşıya yükler.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
File	File	True	file	Karşıya yüklenecek dosya.

Döndürülenler

Name	Yol	Tür	Description
Dosya Kimliği	Id	string	Dosyanın benzersiz kimliği.
Dosya Adı	Name	string	Dosyanın adı
Dosya İçerik Türü	ContentType	string	Dosyanın içerik türü.
Dosya Boyutu	Size	integer	Dosyanın bayt cinsinden boyutu.

Dosyayı Al

İşlem Kimliği:

GetFile

Kimliğine göre bir dosya alır.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Dosya Kimliği	id	True	string	Dosyanın benzersiz tanımlayıcısı

Döndürülenler

Dosya verilerini ve meta verileri içeren bir dosya başvurusu

Body

FileDataRef

Form Girdilerini Al

İşlem Kimliği:

GetEntryViewEntries

Belirtilen görünüm için tüm girdileri alma

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Form	form	True	string	Formun adı
Görünüm Kimliği	viewId	True	string	Görünümün kimliği
Dahil Sayısı	$count		string	Toplam girdi sayısını dahil et
Kimlikleri Seç	$select		string	$select=Kimlik belirtildiğinde Görünümdeki giriş kimliklerinin listesini döndürür

Döndürülenler

response

object

Form kullanılabilirliğini ayarlama

İşlem Kimliği:

SetFormAvailability

Formun kullanılabilirliğini ayarlar.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Form	form	True	string	Formun adı
Kullanılabilirlik Başlangıcı	start		date-time	Kullanılabilirlik başlangıç tarihi
Kullanılabilirlik Sonu	end		date-time	Kullanılabilirlik bitiş tarihi
Kullanılabilir Değil İletisi	message		string	Kullanılabilir Değil İletisi

Döndürülenler

Başlangıç/bitiş kullanılabilirliği ve kullanılamayan ileti gibi form kullanılabilirliği bilgileri.

Body

FormAvailability

Girdi al

İşlem Kimliği:

GetEntry

Bir girdi alır.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Form	form	True	string	Formun adı
Giriş Kimliği	entryId	True	string	Giriş kimliği

Döndürülenler

Bu işlemin çıkışları dinamiktir.

Girdi oluşturma

İşlem Kimliği:

CreateEntry

Yeni bir giriş oluşturur.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Form	form	True	string	Formun adı
Entry	entry	True	dynamic	Form için oluşturulacak giriş

Döndürülenler

Bu işlemin çıkışları dinamiktir.

Girdileri İçeri Aktar

İşlem Kimliği:

ImportEntries

Sağlanan dosya içeriğini kullanarak girdileri oluşturur, güncelleştirir veya siler.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Form	form	True	string	Formun adı
Dosyayı İçeri Aktar	File	True	file	İçeri aktaracak girişleri içeren dosya (.xlsx veya .csv).
İçe Aktarım Modu	ImportMode	True	string	İçeri aktarma modu
Bildirim E-postası	Email		email	İçeri aktarma bildirimlerini almak için e-posta adresi
Alanı Eşleştir	MatchEntriesUsing		string	Giriş kimliği yerine

Döndürülenler

Name	Yol	Tür	Description
ID	Id	string	İçeri aktarmanın kimliği
Statü	Status	string	İçeri aktarmanın durumu
Hata Mesajı	ErrorMessage	string	İçeri aktarma işleminin neden başarısız olduğunu açıklayan bir ileti

Girdiyi güncelleştir

İşlem Kimliği:

EditEntry

Bir girdiyi güncelleştirir.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Form	form	True	string	Formun adı
Giriş Kimliği	entryId	True	string	Giriş kimliği
Entry	entry	True	dynamic	Güncelleştirilmiş giriş verileri

Döndürülenler

Bu işlemin çıkışları dinamiktir.

Girdiyi sil

İşlem Kimliği:

DeleteEntry

Bir girdiyi silin.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Form	form	True	string	Formun adı
Giriş Kimliği	entryId	True	string	Giriş kimliği

İçeri Aktarma Durumunu Alma

İşlem Kimliği:

GetImportStatus

İçeri aktarmanın geçerli durumunu alır ve başarılı ve başarısız girişlerin sayısını döndürür.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Form	form	True	string	Formun adı
İçeri Aktarma Kimliği	importId	True	string	İçeri Aktarma Kimliği

Döndürülenler

Name	Yol	Tür	Description
ID	Id	string	İçeri aktarmanın kimliği
Statü	Status	string	İçeri aktarmanın durumu
Hata Mesajı	ErrorMessage	string	İçeri aktarma işleminin neden başarısız olduğunu açıklayan bir ileti
SuccessfulEntries	SuccessfulEntries	integer	Başarıyla içeri aktarılan girdi sayısı
UnsuessfulEntries	UnsuccessfulEntries	integer	İçeri aktarılamadı girişlerin sayısı
TotalEntries	TotalEntries	integer	İçeri aktarmadaki toplam girdi sayısı
ImportLink	ImportLink	string	Ek açıklamalı dosyayı indirmek için girişler sayfasının bağlantısı

Tetikleyiciler

Bir girdi silindiğinde	Birisi bir girdiyi sildiğinde tetikler.
Bir giriş güncelleştirildiğinde	Birisi bir girdiyi güncelleştirdiğinde tetikler.
Yeni bir giriş oluşturulduğunda	Birisi yeni bir giriş oluşturduğunda tetikler.

Bir girdi silindiğinde

İşlem Kimliği:

EntryDeleted

Birisi bir girdiyi sildiğinde tetikler.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Form	publisher	True	string	Formun adı

Döndürülenler

Bu işlemin çıkışları dinamiktir.

Bir giriş güncelleştirildiğinde

İşlem Kimliği:

UpdateEntry

Birisi bir girdiyi güncelleştirdiğinde tetikler.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Form	publisher	True	string	Formun adı

Döndürülenler

Bu işlemin çıkışları dinamiktir.

Yeni bir giriş oluşturulduğunda

İşlem Kimliği:

NewEntry

Birisi yeni bir giriş oluşturduğunda tetikler.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
Form	publisher	True	string	Formun adı

Döndürülenler

Bu işlemin çıkışları dinamiktir.

Tanımlar

FileDataRef

Dosya verilerini ve meta verileri içeren bir dosya başvurusu

Name	Yol	Tür	Description
Dosya Kimliği	Id	string	Dosyanın benzersiz kimliği.
Dosya Adı	Name	string	Dosyanın adı
Dosya İçerik Türü	ContentType	string	Dosyanın içerik türü.
Dosya Boyutu	Size	integer	Dosyanın boyutu.
Dosya URL'si	File	string	Dosyanın URL'si.
Dosya İçeriği	Content	byte	Dosya içeriği

FormAvailability

Başlangıç/bitiş kullanılabilirliği ve kullanılamayan ileti gibi form kullanılabilirliği bilgileri.

Name	Yol	Tür	Description
Form kullanılabilirliği başlangıcı	availabilityStart	date-time	Form kullanılabilirliği başlangıcı
Form kullanılabilirliği sonu	availabilityEnd	date-time	Form kullanılabilirliği sonu
Kullanılabilir değil iletisi	notAvailableMessage	string	Kullanılabilir değil iletisi

nesne

Bu , 'object' türüdür.