CobbleStone - Sözleşme İçgörüleri (Önizleme)
Sistemler arasında sorunsuz etkileşim için Sözleşme İçgörüleri API'mize bağlanarak sözleşme yönetimi sürecinizi geliştirin. Bağlandıktan sonra işlevsellik şunları içerir: - Yeni kayıtlar oluşturma. - Mevcut kayıtları güncelleştirme. - Belirli bir varlık için kayıtların listesini çekme. - Tüm meta verileri, kısıtlamaları ve bayrakları çekme. - Düzenlenebilir, güncelleştirilebilir veya görüntülenebilir kayıtların listesini çekme.
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) |
| İletişim | |
|---|---|
| İsim | CobbleStone Yazılımı |
| URL | https://www.cobblestonesoftware.com |
| E-posta | AppDev@cobblestonesystems.com |
| Bağlayıcı Meta Verileri | |
|---|---|
| Publisher | Cobblestone Software |
| Web sitesi | https://www.cobblestonesoftware.com |
| Gizlilik İlkesi | https://www.cobblestonesoftware.com/company/privacy-policy |
| Kategoriler | İş Yönetimi; Satış ve CRM |
Cobblestone
Bir varlığın Sözleşme İçgörüleri yazılımımız (Ekle, Ekle, Güncelleştir) ve şema bilgileriyle ilgili temel işlemlere izin verir.
Yayımcı: CobbleStone Software
Önkoşullar
CobbleStone Software (Contact Insight) için mevcut lisansı gerektirir.
Desteklenen İşlemler
Edin
Belirli ölçütlere, etikete göre sıralamaya, etikete göre gruplandırma ve kayıt sayısına sahip belirli bir varlık için kayıtların listesini çekme. Not: Çekilecek kayıt sayısında bir sınır yoktur, ancak kullanıcı daha büyük sonuçların işlenmesinin daha yavaş olacağını göz önünde bulundurmalıdır.
Ekle
Belirtilen varlığa bir kayıt (çağrı başına bir kayıtla sınırlıdır) ekleyin. Yanıt, sistem tarafından oluşturulan kimlik olacaktır.
Update
Belirli ölçütlere ve TriggerWorkflow bayrağına sahip belirtilen bir varlık/alan için kayıtları güncelleştirme isteği başarılı veya başarısız olduktan sonra iş akışını çalıştıracak şekilde güncelleştirin. Güncelleştirilebilecek en fazla kayıt sayısı, çağrı başına 500'dür.
Schema
Tablodaki sütunları, veri türlerini ve tüm kısıtlamaları veya bayrakları (NULL, Uzunluk, Birincil Anahtar vb.) listeler.
Varlık listesi
Bu arabirim aracılığıyla düzenlenip düzenlenemeyeceğini, güncelleştirilebileceğini veya görüntülenip sorgulanamayacağını belirten adların ve üç bayraklı özelliğin listesini döndürür.
Kimlik Bilgilerini Alma
Yetkilendirme (OAUTH 2.0)
- CobbleStone Software, erişim için iki yetkilendirme yöntemi sunar:
- Yetkilendirme Kodu: https://oauth.net/2/grant-types/authorization-code/
- Örtük Verme: https://oauth.net/2/grant-types/implicit/
Kimlik bilgileri CobbleStone Yazılım sisteminiz aracılığıyla ayarlanabilir/oluşturulabilir.
Başlangıç Yapmak
CobbleStone Yazılım sisteminiz aracılığıyla API İstemcisi kimlik bilgilerini oluşturmak için aşağıdaki adımları kullanın:
CobbleStone Software sisteminizde, sistem yöneticisi kimlik bilgilerini ayarlamak/yapılandırmak için aşağıdaki sayfaya gidebilir:
- SaaS İstemcileri için: https://yourCompanyName.cobblestone.software/core/MyAPI.aspx
- Dağıtılan İstemciler için (genellikle): https://yourCompanyName/core/MyAPI.aspx
(NOT: Bu, "My" üst menü öğesinin altındadır ve ardından "API İstemcilerim" öğesini seçin)
Bu, bir sistem yöneticisinin bağlayıcıyla kullanmak üzere OAuth 2.0 kimlik bilgileri (İstemci Kimliği ve İstemci Gizli Anahtarı) oluşturmasına olanak tanır.
CobbleStone Yazılım sisteminizde oturum açmaktan:
Başlamak için CobbleStone Software'i açıp API İstemcilerim > ...
API İstemcisi Ekle'ye tıklayarak yeni bir API İstemcisi girdisi oluşturun ve benzersiz bir ad verin. Ad yalnızca dahilidir ve amacına anlamlı bir şey olabilir. Öğeleri küçük, yönetilebilir ve amaçlı görevler halinde düzenlemek için farklı bir API anahtarı kullanmanızı öneririz.
Bu bir anahtar oluşturur ve yalnızca yönetici personeli sayfaya erişebilir. Anahtarı oluşturan kişiye bağlıdır ve anahtarı yalnızca onlar görebilir. Anahtarı paylaşabilirsiniz, ancak yalnızca oturum açmış olan kullanıcı görebilir.
Bu noktada API İstemcisi girişini ayarlama işlemi tamamlandı. Bu İstemci Kimliği ve Client Securet, bağlayıcının CobbleStone Yazılım sisteminizle iletişim kurması için kullanılır.
Bilinen Sorunlar ve Sınırlamalar
Bağlayıcı şu anda ikili dosyaların gönderilmesini veya alınmasını desteklememektedir.
"Güncelleştir" uç noktası, isabet başına en fazla 500 etkilenen satırla sınırlıdır. Daha sonra 500 kaydın güncelleştirilmiş olması gerekiyorsa, bunların birden çok isabette işlenmesi gerekir.
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 |
|---|---|---|---|
| İstemci Kimliği - CobbleStone ClientId'niz | String | Lütfen istemci kimliğini girin. | Doğru |
| İstemci Gizli Anahtarı - CobbleStone İstemcinizSecret | securestring | Lütfen istemci gizli dizisini girin. | 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
| API'nin çalışmasına izin verilen varlıkların çekme listesi |
Düzenlenip düzenlenemeyeceğini, güncelleştirilebileceğini veya görüntülenebileceğini/sorgulanabileceğini belirten adların ve üç bayraklı özelliğin listesini döndürür. |
| Belirli bir varlık için kayıtların çekme listesi |
Belirli ölçütlere, etikete göre sıralamaya, etikete göre gruplandırma ve kayıt sayısına sahip belirli bir varlık için kayıtların listesini çekme. Not: Çekilecek kayıt sayısında bir sınır yoktur, ancak kullanıcı daha büyük sonuçların işlenmesinin daha yavaş olacağını göz önünde bulundurmalıdır. |
| Belirli bir varlıktaki tüm sütunlar hakkında meta verileri çekme |
Tablodaki sütunları, veri türlerini ve tüm kısıtlamaları veya bayrakları (NULL, Uzunluk, Birincil Anahtar vb.) listeler. |
| Belirli bir veritabanı görünümünü yürütme |
Belirli bir veritabanı görünümünü yürütür (çağrı başına bir kayıtla sınırlıdır). Yanıt, durum olacaktır. |
| Belirli veritabanı görünümündeki tüm sütunlar hakkında meta verileri çekme |
Veritabanı görünümünde sütunları, veri türlerini ve tüm kısıtlamaları veya bayrakları (NULL, Uzunluk, Birincil Anahtar vb.) listeler. |
| Belirtilen varlık için kayıtları güncelleştirme |
Belirli ölçütlere ve TriggerWorkflow bayrağına sahip belirtilen bir varlık/alan için kayıtları güncelleştirme isteği başarılı veya başarısız olduktan sonra iş akışını çalıştıracak şekilde güncelleştirin. Güncelleştirilebilecek en fazla kayıt sayısı, çağrı başına 500'dür. |
| Belirtilen varlık için yeni bir kayıt oluşturma |
Belirtilen varlığa bir kayıt (çağrı başına bir kayıtla sınırlıdır) ekleyin. Yanıt, sistem tarafından oluşturulan kimlik olacaktır. |
| Ekleme Amaçlı Kullanılabilir Varlıkların Listesini Alma |
Bu istemcilerin kullanılabilir Varlık listesini alma, liste kutularını dinamik olarak otomatik olarak doldurmak için iç kullanım olan veri ekleme iznine sahiptir |
| Güncelleştirme Amacıyla Kullanılabilir Varlıkların Listesini Alma |
Bu istemcilerin kullanılabilir Varlık listesini alma, liste kutularını dinamik olarak otomatik olarak doldurmak için iç kullanım olan verileri güncelleştirme iznine sahiptir |
| Kullanılabilir Veritabanı Görünümlerinin Listesini Alma |
Bu istemcilerin kullanılabilir Veritabanı Görünümlerinin Listesini Alma, Veritabanı Görünümü kutularını dinamik olarak otomatik olarak doldurmak için iç kullanım olan verileri sorgulama iznine sahiptir |
| Seçme Amaçlı Kullanılabilir Varlıkların Listesini Alma |
Bu istemcilerin kullanılabilir Varlık listesini alma, liste kutularını dinamik olarak otomatik olarak doldurmak için iç kullanım olan verileri sorgulama iznine sahiptir |
API'nin çalışmasına izin verilen varlıkların çekme listesi
Düzenlenip düzenlenemeyeceğini, güncelleştirilebileceğini veya görüntülenebileceğini/sorgulanabileceğini belirten adların ve üç bayraklı özelliğin listesini döndürür.
Döndürülenler
Varlık Listesi
Belirli bir varlık için kayıtların çekme listesi
Belirli ölçütlere, etikete göre sıralamaya, etikete göre gruplandırma ve kayıt sayısına sahip belirli bir varlık için kayıtların listesini çekme. Not: Çekilecek kayıt sayısında bir sınır yoktur, ancak kullanıcı daha büyük sonuçların işlenmesinin daha yavaş olacağını göz önünde bulundurmalıdır.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Varlık Adı
|
entityName | True | string |
Verileri sorgulamak için tablo adı. |
|
Özellik
|
Attribute | string | ||
|
Diğer ad
|
Alias | string | ||
|
Condition
|
Condition | string | ||
|
Veri Alanı
|
Field | string | ||
|
Kimlik
|
ID | string | ||
|
Veri Girişi
|
Input | string | ||
|
Operator
|
Operator | string | ||
|
Condition
|
Condition | string | ||
|
Veri Alanı
|
Field | string | ||
|
Kimlik
|
ID | string | ||
|
Veri Girişi
|
Input | string | ||
|
Operator
|
Operator | string | ||
|
Türü
|
Type | string | ||
|
Değer
|
Value | string | ||
|
Fields
|
Fields | array of string | ||
|
Yön
|
Direction | string | ||
|
GroupByTag
|
GroupByTag | array of string | ||
|
StartIndex
|
StartIndex | integer |
Hangi dizinden başlayacağız, Varsayılan = 0 |
|
|
Length
|
Length | integer |
StartIndex'ten başlayan satır sayısı, 1000, Varsayılan = 100 çıkarılamaz |
Döndürülenler
- Eşya
- APIQueryResponse
Belirli bir varlıktaki tüm sütunlar hakkında meta verileri çekme
Tablodaki sütunları, veri türlerini ve tüm kısıtlamaları veya bayrakları (NULL, Uzunluk, Birincil Anahtar vb.) listeler.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Varlık Adı
|
entityName | True | string |
Şema alınacak tablonun adı. |
Döndürülenler
Tablodaki sütunların, veri türlerinin ve tüm kısıtlamaların veya bayrakların (NULL, Uzunluk, Birincil Anahtar vb.) listesi
- Eşya
- APISchemaResponse
Belirli bir veritabanı görünümünü yürütme
Belirli bir veritabanı görünümünü yürütür (çağrı başına bir kayıtla sınırlıdır). Yanıt, durum olacaktır.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Veritabanı Görünüm Adı
|
databaseViewName | True | string |
Yürütülecek Veritabanı Görünümünün adı. |
|
Özellik
|
Attribute | string | ||
|
Diğer ad
|
Alias | string | ||
|
Condition
|
Condition | string | ||
|
Veri Alanı
|
Field | string | ||
|
Kimlik
|
ID | string | ||
|
Veri Girişi
|
Input | string | ||
|
Operator
|
Operator | string | ||
|
Condition
|
Condition | string | ||
|
Veri Alanı
|
Field | string | ||
|
Kimlik
|
ID | string | ||
|
Veri Girişi
|
Input | string | ||
|
Operator
|
Operator | string | ||
|
Türü
|
Type | string | ||
|
Değer
|
Value | string | ||
|
Fields
|
Fields | array of string | ||
|
Yön
|
Direction | string | ||
|
GroupByTag
|
GroupByTag | array of string | ||
|
StartIndex
|
StartIndex | integer |
Hangi dizinden başlayacağız, Varsayılan = 0 |
|
|
Length
|
Length | integer |
StartIndex'ten başlayan satır sayısı, 1000, Varsayılan = 100 çıkarılamaz |
Döndürülenler
Tablodaki sütunların, veri türlerinin ve tüm kısıtlamaların veya bayrakların (NULL, Uzunluk, Birincil Anahtar vb.) listesi
- Eşya
- APISchemaResponse
Belirli veritabanı görünümündeki tüm sütunlar hakkında meta verileri çekme
Veritabanı görünümünde sütunları, veri türlerini ve tüm kısıtlamaları veya bayrakları (NULL, Uzunluk, Birincil Anahtar vb.) listeler.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Varlık Adı
|
databaseViewName | True | string |
Şema alınacak Veritabanı Görünümünün adı. |
Döndürülenler
Tablodaki sütunların, veri türlerinin ve tüm kısıtlamaların veya bayrakların (NULL, Uzunluk, Birincil Anahtar vb.) listesi
- Eşya
- APISchemaResponse
Belirtilen varlık için kayıtları güncelleştirme
Belirli ölçütlere ve TriggerWorkflow bayrağına sahip belirtilen bir varlık/alan için kayıtları güncelleştirme isteği başarılı veya başarısız olduktan sonra iş akışını çalıştıracak şekilde güncelleştirin. Güncelleştirilebilecek en fazla kayıt sayısı, çağrı başına 500'dür.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Varlık Adı
|
entityName | True | string |
içindeki kayıtları güncelleştirmek için tablo adı. |
|
Condition
|
Condition | string | ||
|
Veri Alanı
|
Field | string | ||
|
Kimlik
|
Id | string | ||
|
Veri Girişi
|
Input | string | ||
|
Operator
|
Operator | string | ||
|
Condition
|
Condition | string | ||
|
Veri Alanı
|
Field | string | ||
|
Kimlik
|
ID | string | ||
|
Veri Girişi
|
Input | string | ||
|
Operator
|
Operator | string | ||
|
Türü
|
Type | string | ||
|
Değer
|
Value | string | ||
|
Türü
|
Type | string | ||
|
Değer
|
Value | string | ||
|
İsim
|
Name | string | ||
|
Değer
|
Value | string | ||
|
TriggerWorkflow
|
TriggerWorkflow | boolean |
Döndürülenler
- Body
- APIUpdateResponse
Belirtilen varlık için yeni bir kayıt oluşturma
Belirtilen varlığa bir kayıt (çağrı başına bir kayıtla sınırlıdır) ekleyin. Yanıt, sistem tarafından oluşturulan kimlik olacaktır.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Varlık Adı
|
entityName | True | string |
Kaydın ekleneceği tablo adı. |
|
İsim
|
Name | string | ||
|
Değer
|
Value | string |
Döndürülenler
- Body
- APIAddRequest
Ekleme Amaçlı Kullanılabilir Varlıkların Listesini Alma
Bu istemcilerin kullanılabilir Varlık listesini alma, liste kutularını dinamik olarak otomatik olarak doldurmak için iç kullanım olan veri ekleme iznine sahiptir
Döndürülenler
Varlık Listesi
Güncelleştirme Amacıyla Kullanılabilir Varlıkların Listesini Alma
Bu istemcilerin kullanılabilir Varlık listesini alma, liste kutularını dinamik olarak otomatik olarak doldurmak için iç kullanım olan verileri güncelleştirme iznine sahiptir
Döndürülenler
Varlık Listesi
Kullanılabilir Veritabanı Görünümlerinin Listesini Alma
Bu istemcilerin kullanılabilir Veritabanı Görünümlerinin Listesini Alma, Veritabanı Görünümü kutularını dinamik olarak otomatik olarak doldurmak için iç kullanım olan verileri sorgulama iznine sahiptir
Döndürülenler
Veritabanı Görünümleri için sorgu yanıtı
- Eşya
- APIViewListResponse
Seçme Amaçlı Kullanılabilir Varlıkların Listesini Alma
Bu istemcilerin kullanılabilir Varlık listesini alma, liste kutularını dinamik olarak otomatik olarak doldurmak için iç kullanım olan verileri sorgulama iznine sahiptir
Döndürülenler
Varlık Listesi
Tanımlar
APIEntityListResponse
Varlık Listesi
| Name | Yol | Tür | Description |
|---|---|---|---|
|
Eşya
|
APIEntity |
Her varlığı tanımlama |
APIEntity
Her varlığı tanımlama
| Name | Yol | Tür | Description |
|---|---|---|---|
|
VarlıkAdı
|
EntityName | string |
Veritabanında olduğu gibi varlık adı |
|
EntityNameDisplay
|
EntityNameDisplay | string |
Varlık görünen adı |
|
AllowAdd
|
AllowAdd | boolean |
Yeni kayıt eklemeye izin verilip verilmediğini gösterir |
|
AllowEdit
|
AllowEdit | boolean |
Kayıtları düzenlemeye izin verilip verilmediğini gösterir |
|
AllowView
|
AllowView | boolean |
Kayıtları görüntülemeye izin verilip verilmediğini gösterir |
|
EntityNameForAPI
|
EntityNameForAPI | string |
CSS API'sinde kullanılan varlık adı |
APISchemaResponse
Tablodaki sütunların, veri türlerinin ve tüm kısıtlamaların veya bayrakların (NULL, Uzunluk, Birincil Anahtar vb.) listesi
| Name | Yol | Tür | Description |
|---|---|---|---|
|
Eşya
|
APISchema |
APISchema
| Name | Yol | Tür | Description |
|---|---|---|---|
|
İsim
|
Name | string | |
|
IsPrimaryKey
|
IsPrimaryKey | boolean | |
|
IsIdentity
|
IsIdentity | boolean | |
|
IsNullable
|
IsNullable | boolean | |
|
DBType
|
DBType | string | |
|
Maksimum Uzunluk
|
MaxLength | integer | |
|
DataPrecision
|
DataPrecision | integer | |
|
Veri Ölçeği
|
DataScale | integer | |
|
HasDefaultValue
|
HasDefaultValue | boolean | |
|
IsComputedColumn
|
IsComputedColumn | boolean | |
|
IsPassword
|
IsPassword | boolean |
APIAddRequestTuple
| Name | Yol | Tür | Description |
|---|---|---|---|
|
İsim
|
Name | string | |
|
Değer
|
Value | string |
APIUpdateResponse
| Name | Yol | Tür | Description |
|---|---|---|---|
|
Toplam Etkilenen
|
TotalAffected | integer | |
|
TotalFailed
|
TotalFailed | integer | |
|
Message
|
Message | string |
APIAddRequest
| Name | Yol | Tür | Description |
|---|---|---|---|
|
Dizilerini
|
Tuples | array of APIAddRequestTuple |
APIQueryResponse
| Name | Yol | Tür | Description |
|---|---|---|---|
|
Eşya
|
object |
APIViewListResponse
Veritabanı Görünümleri için sorgu yanıtı
| Name | Yol | Tür | Description |
|---|---|---|---|
|
Eşya
|
object |