Bir Postman koleksiyonundan özel bağlayıcı oluşturma

Not

Bu konu Azure Logic Apps, Power Automate ve Power Apps’te özel bağlayıcı oluşturma ve kullanmayla ilgili öğretici serisinin bir parçasıdır. İşlemi anlamak için özel bağlayıcıya genel bakışı okuduğunuzdan emin olun.

Özel Bağlayıcı oluşturmak için, bağlanmak istediğiniz API’yi açıklayarak bağlayıcının bu API’nin işlemlerini ve veri yapılarını anlamasını sağlamalısınız. Bu konu, Bilişsel hizmetler metin analizleri duyarlılık API'sını tanımlayan postman koleksiyonunu kullanarak özel bir bağlayıcı oluşturursunuz (bu dizi için örneğimiz).

API'yi tanımlamanın diğer yolları için aşağıdaki konulara gidin:

• Bir OpenAPI tanımından özel bağlayıcı oluşturma

• Sıfırdan özel bağlayıcı oluşturma

Önkoşullar

• Örnek API'yi tanımlayan Postacı koleksiyonu:

  • Oluşturduğumuz Postman koleksiyonunu indirin
    veya
  • Özel bağlayıcı için Postman koleksiyonu oluşturma konusunu tamamlayın Özel bağlayıcı oluşturulurken Postman koleksiyonunun 1 MB'tan büyük olmaması gerektiğine dikkat edin.

• Bilişsel Hizmetler Metin Analizleri API’si için bir API anahtarı

• Aşağıdaki aboneliklerden birini:

  • Bumantık uygulamalarını kullanıyorsanız Azure
  • Power Automate
  • Power Apps

• Logic Apps kullanıyorsanız önce bir Azure Logic Apps özel bağlayıcısı oluşturun

Postman koleksiyonunu içeri aktarma

Artık oluşturduğunuz veya indirdiğiniz Postman koleksiyonu ile çalışmaya hazırsınız. Gerekli bilgilerin çoğu koleksiyonda yer alır. Özel bağlayıcı sihirbazında ilerlerken de bu bilgileri gözden geçirebilir ve güncelleştirebilirsiniz. İlk olarak Logic Apps’e ya da Power Automate ve Power Apps’e yönelik Postman koleksiyonunu içeri aktarın.

Mantık uygulamaları için Postman koleksiyonunu alın

1. Azure portalına gidin ve daha önce Azure Logic Apps özel bağlayıcısı oluşturma bölümünde oluşturduğunuz Logic Apps bağlayıcısını açın.

2. Connector menüsünde, Logic Apps Bağlayıcısıöğesini seçin ve sonra Düzenle'yi seçin.

   

3. Genel altında, Postman koleksiyonu v1 yükleme seçeneğini belirleyin ve ardından oluşturduğunuz Postman koleksiyonuna gidin.

   

   Sihirbaz koleksiyonu içeri aktarıp generatedApiDefinition.swagger.json adlı bir OpenAPI tanımına dönüştürür.

Not

Bu öğretici bir REST API odaklanır, ancak Logic Apps ilebir SOAP apı de kullanabilirsiniz.

Power Automate ve Power Apps için Postman koleksiyonunu alın

1. make.powerapps.com veya flow.microsoft.com adresine gidin.

2. Gezinti bölmesinde Veri > Özel bağlayıcılar’ı seçin.

3. Yeni özel bağlayıcı'yı ve sonra Bir Postman koleksiyonunu içeri aktarın'ı seçin.

4. Özel bağlayıcı için bir ad girin ve indiridğiniz veya oluşturduğunuz Postman koleksiyonuna gidip Devam’ı seçin.

   

   Parametre	Değer
   Özel bağlayıcı başlığı	"SentimentDemo"

   Sihirbaz koleksiyonu içeri aktarıp generatedApiDefinition.swagger.json adlı bir OpenAPI tanımına dönüştürür.

Genel ayrıntıları güncelleştirme

Bu noktadan itibaren Power Automate kullanıcı arabirimi gösterilecektir, ancak üç teknolojide de adımlar aşağı yukarı aynıdır. Tüm farklılıkları vurgulayacağız.

1. Genel sayfasında, ana bilgisayar ve API'nin temel URL'si dahil olmak üzere Postman koleksiyonundan içeri aktarılan bilgileri inceleyin. Bağlayıcı, API'nin nasıl çağrılacağını belirlemek için ana bilgisayarı ve temel URL'yi kullanır.

   Not

   Şirket içi API 'lere bağlanma hakkında daha fazla bilgi için bkz. veri ağ geçidi kullanarak şirket içinde API'lere bağlanma.

2. Açıklamayı anlamlı olacak şekilde güncelleştirin. Bu açıklama özel bağlayıcının ayrıntılarında görüntülenir ve diğer kullanıcıların bağlayıcınızın onlara nasıl yararlı olabileceğini anlamalarına yardımcı olabilir.

   Parametre	Value
   Açıklama	"Metnin pozitif veya negatif olup olmadığını belirlemek için Bilişsel Hizmetler Metin Analizleri Yaklaşım API'sini kullanır"

Kimlik doğrulama türünü belirtin

Özel bağlayıcılarda kimlik doğrulaması için çeşitli seçenekler sunulmaktadır. Bilişsel Hizmetler API'lerinde API anahtarı kimlik doğrulaması kullanılır.

1. Güvenlik sayfasındaki Kimlik doğrulaması türü bölümünden API Anahtarı’nı seçin.

2. API Anahtarı'nın altında bir parametre etiketi, adı ve konumu belirtin. Açıklayıcı ve anlamlı bir etiket seçin. Bu metin kullanıcılara, onları özel bağlayıcınızı kullanarak bağlantılar kurmaya yönlendirmek için gösterilir. Parametre adı ve konumu, API tarafından beklenen değerlerle (bu durumda, Postman’de belirttiğiniz üst bilgi) eşleşmelidir. Bağlan öğesini seçin.

   

   Parametre	Value
   Parametre etiketi	"API anahtarı"
   Parametre adı	"Ocp-Apim-Subscription-Key"
   Parametre konumu	"Üstbilgi"

3. Sihirbazın üst kısmındaki adın "SentimentDemo" olarak ayarlandığından emin olun ve Bağlayıcı oluştur’u seçin.

Bağlayıcı tanımını inceleme ve güncelleştirme

Özel bağlayıcı sihirbazı, bağlayıcınızın nasıl işlediğini ve mantıksal uygulamalar, akışlar ve uygulamalarda nasıl kullanıma sunulduğunu tanımlama konusunda size çok sayıda seçenek sunar. Kullanıcı arabirimini açıklayacak ve bu bölümde birkaç seçenekten daha fazla yer alacağız, ancak sizin de kendi başınıza keşfetmeye öneririz.

Kullanıcı arabirimini ve tanımı inceleme

Tanımlama sayfası üzerinde bazı adımlara ulaşmak için önce, ilk olarak Kullanıcı arabirimine bir göz atalım.

1. Bu alanda bağlayıcı için tanımlanmış tüm eylemler, tetikleyiciler (Logic Apps ve Power Automate için) ve başvurular görüntülenir. Burada Postman koleksiyonundan DetectSentiment eylemi görüntülenmektedir. Bu bağlayıcıda tetikleyici yoktur, ancak Azure Logic Apps ve Power Automate ile web kancaları kullanma konusunda özel bağlayıcılara yönelik tetikleyiciler hakkında bilgi edinebilirsiniz.

   

2. Genel alanında, seçili eylem veya tetikleyici hakkında bilgi görüntülenir. Bu bilgiler Postman koleksiyonundan alınır. Bir mantıksal uygulama veya akıştaki işlemler ve parametreler için Görünürlük özelliği dahil olmak üzere buradaki bilgileri düzenleyebilirsiniz:

   • önemli - Her zaman kullanıcıya ilk olarak gösterilir
   • hiçbiri - Normalde mantıksal uygulamada veya akışta görüntülenir
   • gelişmiş: başlangıçta ek bir menünün altına gizlenir
   • dahili: kullanıcıya gösterilmez

3. İstek alanında, Postman koleksiyonuna eklenmiş HTTP isteğini temel alan bilgiler görüntülenir. Bu durumda, HTTP fiilinin, POST olduğunu ve URL'nin "/text/analytics/v2.0/sentiment" olduğunu görürsünüz (API'nin tam URL'si şu şekildedir: <https://westus.api.cognitive.microsoft.com//text/analytics/v2.0/sentiment>). Kısa süre içinde gövde parametresine daha sonra bakacağız.

4. Yanıt alanında, Postman koleksiyonuna eklenmiş HTTP yanıtını temel alan bilgiler görüntülenir. Bu durumda yalnızca "200" (başarılı yanıt) için bir yanıt tanımlanmıştır ancak başka yanıtlar da tanımlayabilirsiniz.

5. Doğrulama alanı, API tanımında algılanan sorunları görüntüler. Bağlayıcıyı kaydetmeden önce bu alanı mutlaka denetleyin.

Tanımı güncelleştirme

Şimdi bağlayıcının Logic Apps'te, Power Automate veya Power Apps'te daha kolay kullanılmasını sağlamak için birkaç değişiklik yapalım.

1. Genel alanında, özeti "Algılanan yaklaşımı temsil eden sayısal bir puan döndürür" olarak güncelleştirin.

2. İstek alanında gövde’yi ve sonra Düzenle’yi seçin.

3. Parametre alanında artık API’nin beklediği üç parametreyi görürsünüz: id, language ve text. ID parametresini ve sonra da Düzenle’yi seçin.

4. Şema Özelliği alanında parametre değerlerini güncelleştirin ve Geri’yi seçin.

   

   Parametre	Değer
   Başlık	"Kimlik"
   Açıklama	"Gönderdiğiniz her belge için bir tanımlayıcı"
   Varsayılan değer	"1"
   Gereklidir	"Evet"

5. Parametre alanında sırasıyla dil'i ve Düzenle'yi seçin, ardından yukarıda kullandığınız işlemi aşağıdaki değerlerle tekrarlayın.

   Parametre	Value
   Başlık	"Dil"
   Açıklama	"Metin için 2 veya 4 karakterli dil kodu"
   Varsayılan değer	"en"
   Gereklidir	"Evet"

6. Parametre alanında sırasıyla metin'i ve Düzenle'yi seçin, ardından yukarıda kullandığınız işlemi aşağıdaki değerlerle tekrarlayın.

   Parametre	Value
   Başlık	"Metin"
   Açıklama	"Yaklaşım analizi uygulanacak metin"
   Varsayılan değer	Hiçbiri
   Gereklidir	"Evet"

7. Parametre alanında Geri’yi seçerek ana tanım sayfasına dönün.

8. Sihirbazın sağ üst kısmında Bağlayıcıyı güncelleştir’i seçin.

Bağlayıcıyı test etme

Şimdi de oluşturduğunuz bağlantının düzgün çalıştığından emin olmak için bağlantıyı test edin. Sınama Şu anda yalnızca Power Automate ve Power Apps uygulamasında kullanılabilir.

Önemli

API anahtarı kullanırken bağlayıcıyı oluşturduktan hemen sonra sınamaması önerilir. Bağlayıcının API'ye bağlanmaya hazır olması birkaç dakika sürebilir.

1. Test sayfasında Yeni bağlantı’yı seçin.

2. Metin Analizi API’sinden alınan API anahtarını girip Bağlantı oluştur’u seçin.

3. Test sayfasına dönün:

   • Power Automate’da Test sayfasına geri dönersiniz. Bağlantı bilgilerinin güncelleştirildiğinden emin olmak için yenile simgesini seçin.
   • Power Apps'te geçerli ortamda kullanılabilen bağlantıların listesine yönlendirilirsiniz. Sağ üst köşedeki dişli simgesini ve ardından Özel bağlayıcılar'ı seçin. Oluşturduğunuz bağlayıcıyı seçin, sonra da Test sayfasına dönün.

4. Test sayfasında metin alanı için bir değer girin (diğer alanlarda, daha önce ayarladığınız varsayılan değerler kullanılır) ve İşlemi test et’i seçin.

5. Bağlayıcı API 'yi çağırır ve duyarlılık Puanını da içeren yanıtı gözden geçirebilirsiniz.

   

Sınırlamalar

Power Automate ve Power Apps'te, mevcut bir özel bağlayıcıyı Postman koleksiyonu kullanarak güncelleştirirseniz bağlayıcıyı kaydetmeden önce önceki özelleştirmeleri yinelemeniz gerekir. Örneğin, kimlik doğrulaması türünü, eylemler için varsayılan değerlerini ve diğer öğeleri yeniden yapılandırmanız gerekir.

Sonraki adımlar

Artık özel bir bağlayıcı oluşturup bağlayıcının davranışlarını tanımladığınıza göre bağlayıcıyı kullanabilirsiniz.

• Bir akışta özel bir bağlayıcı kullanma
• Uygulamadan özel bağlayıcı kullanma
• Bir mantıksal uygulamada özel bağlayıcı kullanma

Ayrıca, bir bağlayıcıyı kuruluşunuzun içinde paylaşabilir ve/veya kuruluşunuz dışındaki kişilerin de kullanabilmesi için bağlayıcınıza sertifika alabilirsiniz.

• Bağlayıcınızı paylaşın
• Bağlayıcınızı onaylayın

Geri bildirimde bulunun

Bağlayıcı platformumuzla ilgili sorunlar veya yeni özellik fikirleri hakkındaki geri bildiriminiz bizim için çok önemlidir. Geri bildirimde bulunmak için Sorun gönderme veya bağlayıcılarla ilgili yardım alma bölümüne gidip geri bildirim türünü seçin.