Microsoft olmayan yayımcının onay süreci

Bu süreç Microsoft dışı yayımcılar içindir (bağımsız yayımcılar hariç). Bağımsız bir yayımcıysanız Bağımsız yayımcı onay süreci bölümüne gidin.

Özel bağlayıcınızı geliştirmeyi tamamladıktan sonra bunu sertifikasyona hazırlamak ve Microsoft’a gönderilecek bağlayıcı dosyalarını oluşturmak için bu yönergeleri izleyin.

1. Adım: Bağlayıcınızı kaydetme

Sertifika başvurusu için özel bağlayıcınızı geliştirmeyi tamamlamanız gerekmez. Sertifika işlemini başlatmak için, kayıt formumuzu doldurarak, sertifika için bağlayıcıyı kaydettirin.

Aşağıdaki konularda size yardımcı olacak bir Microsoft ilgili kişisi iki iş günü içinde size bir e-posta gönderecek:

• Özel bağlayıcınızı anlayın.
• Geliştirme ilerlemenizi öğrenin.
• Sertifika sürecinde size yol gösterir.

Adım 2: gönderim gereksinimlerini karşılayacak

Sertifikalı bağlayıcılarımız arasında yüksek standartlık kaliteli ve tutarlılık sağlamak için Microsoft, özel bağlayıcılarınızın sertifika için uygun olması gereken bir dizi gereksinimleri ve Kılavuzu vardır.

Bağlayıcıya bir başlık verin.

• Zorunludur ve İngilizce olarak yazılması gerekir.
• Benzersiz olmalı ve mevcut bağlayıcı başlığından ayırt edilebilir olmalıdır.
• Ürün veya kuruluşunuzun adı olmalıdır.
• Sertifikalı bağlayıcılar için var olan adlandırma modellerine uyulması gerekir
• 30 karakterden uzun olamaz
• "API", "konektör" sözcüklerini veya Power Platform ürün Adlarımızda (örneğin, "Power Apps") içermemelidir.
• Satır başı, yeni satır ve boş bir boşluk da dahil olmak üzere alfasayısal olmayan bir karaktere bitemez.

Örnekler

• İyi bağlayıcı başlıkları: "Azure Sentinel", "Office 365 Outlook"
• Zayıf bağlayıcı başlıklar: "Azure Sentinel Power Apps Bağlayıcı", "Office 365 Outlook API"

Bağlayıcınız için bir açıklama yazın.

• Zorunludur ve İngilizce olarak yazılması gerekir.
• Dil bilgisi ve yazım hatası içermemesi gerekir
• ana amacı ve bağlayıcınızın sunduğu değeri tam olarak açıklamalıdır.
• 30 karakterden kısa veya 500 karakterden uzun olamaz.
• Herhangi bir Power Platform ürün adı içeremez (örneğin, "Power Apps").

Bağlayıcınıza ilişkin bir simge tasarlayın

Bu bölüm bağımsız yayımcılar için geçerli değildir.

• Yaklaşık 230 × 230 piksellik bir kare içinde yaklaşım 160 × 160 piksellik bir logo oluşturun (yuvarlak kenarlı köşeler yok).
• Belirttiğiniz simge arka plan rengiyle eşleşen, saydam olmayan, beyaz olmayan bir arka plan rengi (#ffffff) ve varsayılan olmayan bir renk (#007ee5) içermelidir.
• diğer sertifikalı bağlayıcı simgeleri için benzersiz olmalıdır.
• icon.png olarak PNG biçiminde gönderilmelidir.

İşlem ve parametre özetlerini ve açıklamalarını tanımlama

• Zorunludur ve İngilizce olarak yazılması gerekir.
• Dil bilgisi ve yazım hatası içermemesi gerekir
• İşlem ve parametre özetleri tam olmayan cümleler, 80 karakter veya daha kısa ifadeler olmalı ve yalnızca alfasayısal karakterler ya da parantez içermelidir.
• işlem ve parametre açıklamaları tam, açıklayıcı cümleler olmalı ve noktalama işaretiyle bitmelidir
• Herhangi bir Microsoft Power Platform ürün adı içeremez (örneğin, "Power Apps").

Tam işlem yanıtlarını tanımlama

• İşlem yanıtlarını yalnızca beklenen yanıtları içeren tam bir şema ile tanımlayın.
• Tam bir şema tanımı ile varsayılan yanıtları kullanmayın.
• Swagger'daki tüm işlemler için geçerli yanıt şeması tanımları sağlayın. Boş yanıt şemalarına izin verilmez. Bu, çıktıda dinamik içerik gösterilmeyeceği ve geliştiricilerin yanıtı ayrıştırmak için JSON kullanması gerektiği anlamına gelir.

Kaliteli Ingilizce dil dizeleri oluşturma

Bağlayıcılar, Power Automate yerelleştirmesinin parçası olarak yerelleştirilir, bu nedenle bir bağlayıcı geliştirirken İngilizce dil dizilerinin kalitesi, çeviri kalitesi için çok önemlidir. Burada, sağlayacağınız dizelerin değerlerini oluştururken odaklanacağınız bazı önemli alanlar yer almaktadır.

• Hiçbir dize değerinde yazım hatasının olmadığından emin olmak için yazım denetimi programı çalıştırmayı unutmayın. Tamamlanmamış bir İngilizce dil dizesi varsa çeviri sonucu eksik veya bağlamda yanlış olur.

• Cümlenin tamamlanmış biçimde olduğundan emin olun. Cümle tamamlanmadıysa bu durum daha düşük kalitede çeviriler de oluşturabilir.

• Cümlenin anlamının net olduğundan emin olun. Cümlenin anlamı belirsizse bu durum daha düşük kalitede veya yanlış çeviriler de oluşturabilir.

• Mümkünse çalıştırma zamanı bileşik dizelerinden kaçının. Bunun yerine tam olarak biçimlendirilmiş cümleler kullanın. Bitiştirilmiş dizeler veya cümleler çeviri yapmayı zorlaştırır veya yanlış bir çeviriye neden olabilir.

• Kısaltma kullanırsanız bunu netleştirmek için büyük harf kullandığınızdan emin olun. Bu, yazım hatası nedeniyle yanlış anlaşılma olasılığını azaltır.

• CaMel biçiminde dizeler (örn. minimizeHighways veya MinimizeHighways) genellikle çevrilemez olarak kabul edilir. Dize değerini yerelleştirmeniz isterseniz CaMel biçimindeki dizeyi düzeltmeniz gerekir.

3. Adım: Meta veriler ekleyin

Bağlayıcı yapılarınız (dosyalar), bağlayıcıyı ve son hizmetini açıklayan belirli meta verileri içermelidir. Meta verilerde sağlanan bilgiler bağlayıcı belgelerimizde yayımlanır ve tüm kullanıcılar tarafından genel olarak erişilebilirdir. Bize bu bilgileri sağlamaya yönelik herhangi bir sorun varsa, herhangi bir özel veya gizli bilgi sağlamaz ve Microsoft kişinizle iletişim kurmamıza izin verin. Meta verilerin nasıl belgelenmediğini görmek için, bağlayıcı başvurusu altındaki bağlayıcıya özgü belge sayfalarından herhangi birini ziyaret edin.

Adım 3a: yayıncı ve stackOwner özellikleri

• Yayıncı, şirketinizin veya kuruluşunuzun adıdır. Tam şirket adını girin (örneğin, "Contoso Corporation"). Bu, alfa sayısal biçimde olmalıdır.

• "stackOwner" bağlayıcının bağlandığı sahibi olan şirket veya arka uç hizmet yığınının kuruluşucdur. Bu, alfa sayısal biçimde olmalıdır.

Dosya Konumu: apiProperties.json

Söz dizimi: Publisher ve stackOwner özelliği, apiProperties.json dosyası içinde üst düzey özellikler olarak bulunur. Aşağıdaki Vurgulanan satırları gösterildiği gibi ekleyin. Şemayı ve özellik adını tam olarak gösterildiği gibi girdiğinizden emin olun.

Adım 3c: Örnek kod parçacıkları

Bilgilerinizi kopyalamak ve girmek için aşağıdaki kod parçacıklarını kullanabilirsiniz. Önceki bölümde açıklanan şekilde, parçacıkları doğru konumlardaki doğru dosyalara eklediğinizden emin olun.

    "publisher": "_____",
    "stackOwner": "_____"

    "contact": {
      "name": "_____",
      "url": "_____",
      "email": "_____"
    }

    "x-ms-connector-metadata": [
      {
        "propertyName": "Website",
        "propertyValue": "_____"
      },
      {
        "propertyName": "Privacy policy",
        "propertyValue": "_____"
      },
      {
        "propertyName": "Categories",
        "propertyValue": "_____;_____"
      }
    ]

Adım 3d: Özel bağlayıcı dosyalarınızı doğrulama

paconn validate --api-def [Location of apiDefinition.swagger.json]'i çalıştırın. Bu araç bağlayıcı tanımınızı doğrular ve gönderimden önce düzeltmeniz gereken herhangi bir hatanın olup olmadığını size bildirir.

Bağlayıcınız kimlik doğrulaması türü olarak OAuth kullanıyorsa lütfen bu izin verilen yeniden yönlendirme URL'lerini uygulamanıza ekleyin.

• https://global.consent.azure-apim.net/redirect

• https://global-test.consent.azure-apim.net/redirect

4. Adım: Bağlayıcı yapıtlarını hazırlama

Bu adımın tamamlanması yaklaşık bir hafta sürer.

Microsoft’a, bağlayıcı yapıtları adlı bir dosya kümesi gönderirsiniz ve bu dosyalar, Microsoft tarafından sağlanan bir komut satırı arabirimi (CLI) aracı kullanılarak indirilir. Bu araç, tüm ayırma hataları için bağlayıcıyı doğrular.

Başlamak için şu adımları izleyin:

1. Yükleme yönergelerini izleyerek Microsoft Power Platform Bağlayıcılar CLI aracını yükleme.

2. Komut satırında şunu çalıştırarak Microsoft Power Platform’da oturum açın: paconn login. Microsoft’un Cihaz Kodu işlemini kullanarak oturum açmak için yönergeleri izleyin.

3. Kimlik doğrulaması yapıldıktan sonra özel bağlayıcı dosyalarınızı indirin:

   • paconn download'i çalıştırın. Bağlayıcının numarasını komut satırında belirterek özel bağlayıcınızın bulunduğu ortamı seçin ve özel bağlayıcının adını belirleyin.

   Araç, bir klasördeki bağlayıcı yapılarınızı paconn çalıştırdığınız dosya sistemi konumuna karşıdan yükler. Yayımcının türüne bağlı olarak, çeşitli yapıtlar bulacaksınız:

   Yayıncı	Yapıt
   Bağımsız yayımcı	apiDefinition.swagger.json apiProperties.json
   Microsoft dışı yayımcı (bağımsız dışında)	apiDefinition.swagger.json apiProperties.json settings.json Bağlayıcı simgesi

Benioku (Readme) dosyası yapıtı oluşturma

Hem bağımsız hem de Microsoft olmayan yayıncılar için bir Readme.md dosyası gereklidir. Bağlayıcınızın özelliklerini ve işlevlerini belgelemek için bir Readme.md dosyası oluşturmanız gerekir. Dahil edilecek bir belge örneği için Readme.md örneği'ne gidin.

Adım 5: bağlayıcıyı dağıtım için gönderin

1. GitHub'a ve sertifika portalına göndermek için Microsoft sertifikası için bağlayıcınızı gönderme bölümündeki talimatları izleyin.

2. Microsoft, açık kaynak deposu'na bir çekme isteği gönderdiğinizde bağlayıcınızı iki iş günü içinde dağıtır ve doğrular. Güncelleştirmeler gerekiyorsa fazladan iki iş günü daha bekleyin.

   Microsoft, gönderim işleminin bir parçası olarak, CLA-bot, Swagger validator ve son değişiklik algılayıcısı araçlarını kullanarak bağlayıcıyı doğrular. Swagger sorunlarını gidermeniz gerekiyorsa Swagger Doğrulayıcısı hatalarını düzeltme bölümüne gidin.

6. Adım: Microsoft olmayan yayıncılar tarafından yapılan test beklentileri

Bağlayıcınızı doğruladıktan sonra sizden kapsamlı testler gerçekleştirmenizi isteyeceğiz.

1. Testinize hazırlık olarak, önizleme alanında bir ortam oluşturmak için, sertifika içinde bağlayıcıyı sınama konusundaki yönergeleri izleyin.

2. Dağıtıma başlayabilmemiz için bir hafta içinde Microsoft ilgili kişinize testi tamamladığınızı bildirin.

3. Bağlayıcınızın işlevselliği ve içeriği hem Microsoft hem de sizin tarafınızdan doğrulandıktan sonra bağlayıcıyı test edilmek üzere Önizleme bölgesinde dağıtım için hazırlayacağız.

Adım 7: Dağıtımı bekleme

Bağlayıcınız test işlemi için doğrulandığında tüm ürünlere ve bölgelere dağıtacağız.

Bölgelere dağıtım adım adım yapıldığından bağlayıcının dağıtılacağı bölgelerin adlarını size e-posta ile bildireceğiz. Microsoft olmayan yayıncılar, dağıtım gecikmesi veya donma varsa durum hakkındaki bilgileri ISV portalı'nda ye alan Etkinlik Denetimi'nde bulabilir. Bağımsız yayıncılar e-posta ile bilgilendirilecektir.

Üretim dağıtımı

Üretim için bağlayıcı dağıtım zamanlamalarımız Pazartesi ve Çarşamba sabahları başlar, PST/PDT. Bağlayıcınızı bir sonraki zamanlanmış dağıtıma dahil etmemiz için Microsoft'a üretim dağıtımına hazır olduğunuzu en az 24 saat önceden bildirmeniz gerekir. Microsoft olmayan yayıncılar, ISV portalı'nın Etkinlik Denetimi'ni kullanarak bize bildirimde bulunabilirler. Bağımsız yayıncılar, Microsoft ilgili kişilerini bilgilendirebilir.

Bölge dağıtımı

Çeşitli bölgelere dağıtım, önceden belirlenmiş bir günlük sırayla gerçekleşir. Bölgeler:

• Test ediliyor.
• ABD önizleme.
• Asya; Japonya ve Hindistan hariç.
• Avrupa; Birleşik Krallık hariç.
• Brezilya, Kanada, Japonya ve Hindistan.
• Avustralya, Birleşik Krallık ve ABD.

Örneğin, bağlayıcınız Pazartesi günü dağıtılacak şekilde zamanlanmışsa 1. günde Test bölgesine dağıtılacaktır. Ardından, 2. Günde ABD önizleme bölgesine dağıtılır. Bağlayıcı, altı bölgenin tümüne dağıtılana kadar dağıtım günlük olarak devam eder.

Cuma, Cumartesi, Pazar günleri ve ABD'de tatil olan günlerde dağıtım yapmıyoruz.

Bağlayıcınız sertifikalandırma işlemini tamamlarken bağlayıcıyla ilgili bir pazarlama fırsatı hakkında Power Automate blog sayfasından sizinle iletişime geçeceğiz.

8. Adım: dağıtım sonrası seçeneklerini keşfedin

Burada, bağlayıcınız dağıtıldıktan sonra keşfedebileceğiniz bazı seçenekler bulunmaktadır:

• ISV portalında bağlayıcı telemetrisini istediğiniz zaman görüntüleyin. Bağlayıcınızın durumunu ve kullanımını öğrenmek için ISV portalındaki sertifikalı bağlayıcınız hakkında önemli içgörüler elde etme konusuna bakın.

• Bağlayıcınıza güncellemeler gönderin. Daha fazla bilgi için bkz. Sertifikalı bağlayıcınızı güncelleştirme.

• Müşterilerin herhangi bir sorunla karşılaşıp karşılaşmadığını veya bağlayıcınız için özellik istekleri olup olmadığını öğrenmek için bağlayıcınızı topluluk tartışma forumunda izleyin.

• Önizleme etiketinin kaldırılmasını isteyin. Bağlayıcı bir süre genel kullanıma sunulduktan ve belirli gereksinimleri karşıladıktan sonra genel kullanılabilirlik etiketine yeniden atanmaya hak kazanabilir. Bu etiket, bağlayıcının üretime hazır bir ürün olduğunu gösterir. Ayrıntılar için Bağlayıcıyı önizlemeden genel kullanılabilirliğe taşıma bölümüne gidin.

Göndermeden önce denetim listesi

Microsoft sertifikası için bağlayıcınızı göndermek üzere işleme geçmeden önce , şunlardan emin olun:

• Bağlayıcınızın Adım 2: Gönderim gereksinimlerini karşılama ve Adım 3: Meta veri ekleme'de belirtilen tüm standartları karşıladığından.

• hiçbir işlemde Özet, Açıklama veya görünürlük bilgileri eksiktir

• Özel bağlayıcınızı, işlemlerin beklendiği gibi çalışmasını sağlamak için sınınız (işlem başına en az 10 başarılı çağrı).

• Özel bağlayıcı sihirbazının test bölümündehiçbir çalışma zamanı veya şema doğrulama hatası görüntülemediğinden.

Microsoft dışı bir yayımcıysanız (ve bağımsız bir yayımcı değilseniz), Microsoft onayı için gönderdiğinizde İş Ortağı Sözleşmemizi ve gizlilik sözleşmemizi kabul etmeniz istenir. Gönderimden önce bu koşulları ve dili incelemek isterseniz lütfen Microsoft ilgili kişinize ulaşın.

Sonraki adım

Bağlayıcılarınızı Microsoft sertifikası için gönderme