Aracılığıyla paylaş

Katalog öğesi gönderme belgesi başvurusu

Kataloğa bir öğe gönderirken verileri JSON biçiminde eklemeniz gerekir. Bu makalede, bu belgenin geçerli özellikleri açıklanmaktadır. Bu JSON bir örnektir:

{
  "modelVersion": "1.0.0.0",
  "operation": "CreateOrUpdate",
  "sourcePortal": 526430005,
  "businessJustification": "Power Platform custom connector for Conference API",
  "publisherDetails": {
    "publisherId": "ContosoConferencesTeam",
    "publisherDisplayName": "Catalog Conferences Team"
  },
  "catalogItemDefinition": {
    "id": "ContosoConferencesCustomConnector",
    "displayName": "Contoso Conference Custom Connector",
    "description": "Demo Custom connector to query Conference Speakers & Sessions",
    "offer": {
      "type": "Component_Collection",
      "deploymentType": "Normal",
      "engineeringName": {
        "firstName": "Jennifer",
        "lastName": "Wilkins",
        "email": "jwilkins@contoso.com",
        "phoneNumber": "555-111-1234"
      },
      "supportName": {
        "firstName": "Aidan",
        "lastName": "Hunt",
        "email": "ahunt@contoso.com",
        "phoneNumber": "555-111-1234"
      }
    },
      "packageFile": {
         "name": "packageFileName.zip",
         "filesaslink": "https://Contoso.blob.core.windows.net/ContosoConferencesCustomConnector/packageFileName.zip"
      }
  }
}

Bu tabloda gönderim belgesinin özellikleri açıklanmaktadır:

Mülkiyet Türü Gerekli Description
modelVersion String Hayı Gönderim belgesinin sürüm numarası. Varsayılan değer 1.0.0.0'dır.
sourcePortal int Hayı Bu isteğin kaynağını tanımlar. Varsayılan olarak 526430005 PAC CLI'dır. Diğer kaynaklar için kullanın 526430000. İşlev tam mspcat_GetPowerCatalogDetails listeyi döndürür. mspcat_GetPowerCatalogDetailsResponse.CatalogDetails.sourceOptions özelliği kullanılabilir seçenekleri listeler.
submissionId Kılavuz Hayı Gönderimi tanımlamak için guid. Bu değer, isteğin diğer sistemlere bağlanmasına izin veren bir yabancı anahtardır.
operation String Yes Gelecekteki genişleme için şu anda dikkate alınmıyor. Kullanılacak işlemin türü. Geçerli değerler:
- CreateOrUpdate (Varsayılan)
- Create
- Update
- Disabled
businessJustification String Hayı Onaylayana gönderilen gönderimin iş değerini açıklar. Bu değer HTML veya Zengin Metin Biçimi (RTF) içerebilir. Bu bilgiler, oluşturucu bulma kullanıcı deneyimindeki planlı tüketim deneyiminde görünür. Kullanıcılar, gönderimlerinin maliyet azaltmaya veya üretkenliği azaltmaya yardımcı olduğunu söyleyebilir. Bazı kuruluşlar belirli değer sınıflarına ihtiyaç duyar ve bu değerler buraya girilebilir.
publisherDetails Publisher Yes Bu öğe gönderimiyle ilişkilendirilmiş yayımcı.
catalogItemDefinition CatalogItemDefinition Yes Gönderilen katalog öğesini tanımlar.

Publisher

Katalog gönderim öğesi publisherDetails özelliğini belirtmek için bu verileri kullanın.

İleride katalog öğesinde güncelleştirmeler yapabilen yetkili kullanıcıları içeren bir veya daha fazla Microsoft Entra ID grubuyla ilişkilendirilebilen bir yayımcı kaydı oluşturur.

Uyarı

Bu terimi Çözüm Yayımcısı ile karıştırmayın. Katalog öğesi yayımcısı çözümlerle kullanılmaz.

En azından sağlamanız publisherDisplayName gerekir. publisherId herhangi bir dize değeri olabilir. Sistem bu yayımcının var olup olmadığını denetler, aksi takdirde bunu oluşturur ve atar publisherId.

Örneğin İk BT geliştirici ekibi, Microsoft Entra Id grubunu kullanarak bir yayımcı oluşturabilir ve geliştiricilerin kimliğini tespit edebilir.

Burada bir kişi ve Entra Id grubu ekleme işlemlerini içeren bir yayımcı kaydı örneği verilmiş.

{
   "publisherId": "MyPublisherId",
   "publisherDisplayName": "Contoso Publishing",
   "publisherUpnList": [
      {
         "action": "Add",
         "upn": "john.doe@contoso.com"
      }
   ],
   "publisherAADGroupOIDS": [
      {
         "action": "Add",
         "groupName": "PowerCatalogSubmitters",
         "groupOID": "2ded6de9-ab44-4478-9bd4-e609947daa2e",
         "groupType": "Security"
      }
   ]
}
Mülkiyet Türü Gerekli Description
publisherId String Yes Bu yayımcının benzersiz kimliği. Bu yayımcı için katalog öğesi oluştururken veya güncelleştirirken bu yayımcıyı tanımlamak için bu kimliği kullanın. Katalog Öğeleri aynı anda yalnızca bir yayımcıyla ilişkilendirilebilir. Değer bir GUID veya dize olabilir. Ayarlandıktan sonra bakım yapılmalıdır.
publisherDisplayName String Yes Tüketiciler bu verileri katalog galerisinde görür.
publisherUpnList CatalogUPNOperation[] Hayı Bu yayımcı olarak yeni katalog öğeleri gönderebilen veya güncelleştirebilen kişiler. Yayımcı ilk kez oluşturulduğunda her zaman gönderen kullanıcıyı içerir.
publisherAADGroupOIDS CatalogGroupOperation[] Hayı Üyelerin bu yayımcıya erişmesine izin verilen Entra Id Groups.

CatalogUPNOperation

PublisherpublisherUpnList özelliğini belirtmek için bu verileri kullanın.

Bu yayımcı olarak yeni katalog öğeleri gönderebilen veya güncelleştirebilen kişileri ekleme veya kaldırma işlemini tanımlar.

Mülkiyet Türü Gerekli Description
action String Yes Bu UPN ile gerçekleştirecek eylem. Geçerli değerler: Add veya Remove.
upn String Yes Kullanıcının Kullanıcı Asıl Adı (UPN).
userOid Kılavuz Yes Kullanıcı için Nesne Tanımlayıcısı.

CatalogGroupOperation

PublisherpublisherAADGroupOIDS özelliğini belirtmek için bu verileri kullanın.

Bu yayımcıya erişebilen bir Entra Id Grubu ekleme veya kaldırma işlemini tanımlar.

Mülkiyet Türü Gerekli Description
action String Yes Bu UPN ile gerçekleştirecek eylem. Geçerli değerler: Add veya Remove.
groupName String Yes Grubun adı.
groupOid Kılavuz Yes Grup için nesne tanımlayıcısı.
groupType String Yes Ele alınan Grup türü. Geçerli Değerler ve SecuritydeğerleridirModern.

CatalogItemDefinition

Katalog gönderim öğesi catalogItemDefinition özelliğini belirtmek için bu verileri kullanın.

Bu özellikler, gönderilen katalog öğesini tanımlar. Bu, gerçek Power Platform çözümüdür. Paket, katalogda depolanan pakettir.

Aşağıda, zorunlu olan engineeringName ve supportName kişileri içeren bir katalog öğesi örneği verilmiştir.

"catalogItemDefinition": {
   "id": "ContosoTravelsApp",
   "displayName": "Contoso Travel Expense App",
   "description": "Submit expenses on the go!",
   "offer": {
   "businessCategories": [526430000, 526430001, 526430002],
   "type": "Component_Collection",
   "deploymentType": "Normal",
   "small48x48Image": {
      "name": "Small48Image",
      "fileSasLink": "https://www.contoso.com/icon48.jpg"      
   },
   "large216x216Image": {
      "name": "Large216image2",
      "fileSasLink": "https://www.contoso.com/icon216.jpg"
   },
   "documents": [
      {
         "name": "ImaNewfile",
         "fileSasLink": "https://www.contoso.com/screenshot1.jpg"
      },
      {
         "name": "ImaNewfile2",
         "fileSasLink": "https://www.contoso.com/screenshot2.jpg"
      }
   ],
   "helpLink": "https://www.contoso.com/help.html",
   "privacyPolicyLink": "https://www.contoso.com/privacy.html",
   "legalTerms": "https://www.contoso.com/legal.html",
   "engineeringName": {
      "firstName": "John",
      "lastName": "Roon",
      "email": "john@contoso.com",
      "phoneNumber": "999-111-1234"
   },
   "supportName": {
      "firstName": "Jane",
      "lastName": "Drill",
      "email": "jane@contoso.com",
      "phoneNumber": "999-111-1234"
   }
   }
}
Mülkiyet Türü Gerekli Description
id Kılavuz Yes Katalog öğesinin benzersiz kimliği. Katalog öğesini güncelleştirirken veya yüklerken bu kimliği kullanın.
displayName String Yes Katalog galerilerinde tüketicilere gösterilen ad.
description String Hayı Katalog galerilerinde tüketicilere gösterilen açıklama.
offer OfferDetails Yes Katalog öğesi gönderiminin ayrıntıları.
packageFile CatalogFileAsset Yes Gönderim için katalog paketi dosyasının nereden alınacağı açıklanır.

TeklifDetaylar

CatalogItemDefinitionoffer özelliğini belirtmek için bu verileri kullanın.

Bu özellikler katalog öğesi gönderiminin ayrıntılarını tanımlar.

Mülkiyet Türü Gerekli Description
businessCategories int[] Hayı Hedef katalog tarafından dikkate alınan seçenek değerlerinin listesi. Bu katalog öğesiyle ilişkilendirilecek iş kategorilerini tanımlar. Kullanılacak geçerli değerler için bkz. İş kategorileri .
type String Yes Katalog öğesinin türü. Geçerli değerler:
- Application
- Component_Collection
supportsApplicationTypes string[] Hayı Desteklenen uygulama türlerinin listesi. Geçerli değerler:
- CanvasApps
- ModelApps
- PowerPortals
- PowerAutomate
deploymentType String Yes Bu katalog öğesinin dağıtılacağı dağıtım türünü gösterir. Geçerli değerler:
- Normal yönetilen bir öğeyi temsil eder.
- Template Yönetilmeyen çözümünüzün, diğer oluşturucuların istedikleri şekilde düzenleyebileceği bir kopyası.
Katalog öğesi türleri hakkında daha fazla bilgi edinin
searchKeywords string[] Hayı Kişilerin bu katalog öğesini bulmak için kullanabileceği sözcükler.
small48x48Image CatalogFileAsset Hayı Galeri görünümü için resim. Bu görüntüyü sağlamazsanız sistem varsayılan simgesi kullanılır.
large216x216Image CatalogFileAsset Hayı Ayrıntı görünümü için resim. Oluşturucuda veya diğer bulma kullanıcı arabiriminde görüntülenecek bir simge sağlayın. Bazı kullanıcı deneyimleri, bulma için kartları işlemek için daha büyük simgeler kullanır.
useCaseDocument CatalogFileAsset Hayı Onaylayanlara servis talebi açıklaması ve açıklaması kullanın.
videos CatalogFileAsset[] Hayı Ayrıntı görünümünde bu video/gif dosyalarının bağlantıları görüntülenir.
documents CatalogFileAsset[] Hayı Ayrıntı görünümünde bu dosyaların bağlantıları görüntülenir.
screenshots CatalogFileAsset[] Hayı Ayrıntı görünümünde bu görüntüler görüntülenir. Oluşturucuların bu uygulamanın aradıkları işlevselliği veya özelliği sağlayıp sağlamadığını belirlemesine yardımcı olmak için uygulamanızın ekran görüntülerini buradan geçirebilirsiniz. Bir uygulamayı veya şablonu indirmeden önce insanların yaptığı en yaygın şey, açıklamayı okumak yerine özellikleri anlamak için resimlerine ve ekran görüntülerine bakmaktır.
helpLink URI Hayı Belgelere bağlantı. Bu URL'ler iç belgelere veya SharePoint kaynaklarına bağlantılar olabilir.
privacyPolicyLink URI Hayı Gizlilik belgesi bağlantısı. Gönderilen bileşenin veya uygulamanın dikkatli kullanımıyla ilgili ilkeler.
legalTermsLink URI Hayı Hüküm ve Koşullar belgesine bağlantı. Katalog öğesinin tüketicisinin değerlendirilmesi için herhangi bir yasal hüküm veya iç rehberlik.
legalTerms String Hayı Hüküm ve Koşullar belgesinin Markdown, HTML veya metin sürümü. Katalog öğesinin tüketicisinin değerlendirilmesi için herhangi bir yasal hüküm veya iç rehberlik.
sourceCodeRepositoryLink URI Hayı Kaynak kod deposuna bağlantı
engineeringName PersonContactInformation Yes Bu katalog öğesini geliştiren mühendis veya grup için iletişim bilgileri.
supportName PersonContactInformation Hayı Bu katalog öğesini destekleyen destek veya grup için iletişim bilgileri. Bir katalog öğesinin tüketicisinin uygulamayla ilgili sorunlarla karşılaştığında ulaşabileceği mühendislik kişisiyle aynı olabilir.

İş kategorileri

OfferDetailsbusinessCategories özelliğini şu iş kategorilerinden birine veya daha fazlasına ayarlayın:

Kod Description
526430000 Müşteri Hizmetleri
526430001 Proje Yönetimi
526430002 Takvim Yönetimi ve Zamanlama
526430003 E-posta Yönetimi
526430004 Dosyalar ve Belgeler
526430005 Bildirim ve Anımsatıcılar
526430006 Veri Analitiği
526430007 Işbirliği
526430008 Commerce
526430009 Finance
526430010 Uyumluluk ve Yasal
526430011 Satışlar
526430012 BT Araçları
526430013 Pazarlama
526430014 operasyonlar ve tedarik zinciri
526430015 Nesnelerin İnterneti
526430016 AI Machine Learning
526430017 Coğrafi konum
526430018 İnsan Kaynakları

Şu anda yeni iş kategorileri yapılandırılamaz, ancak Katalog İş Kategorisi (mspcat_catalogbusinesscategory) genel seçiminden alınabilir.

CatalogFileAsset

Bu özellikler CatalogItemDefinitionpackageFile ve OfferDetailssmall48x48Image, large216x216Image, , useCaseDocumentvideos, documentsve screenshots özelliklerinde başvuruda bulunulan bir dosyayı tanımlar.

Mülkiyet Türü Gerekli Description
name String Yes Dosyanın adı.
filesaslink URI Yes Dosyayı indirmek için bağlantı. Bağlantı kimlik doğrulaması gerektiriyorsa , bir paylaşılan erişim imzası (SAS) URL'si sağlayın.

PersonContactInformation

Bu özellikler OfferDetailsengineeringName ve supportName özellikler katalog öğesindeki kişileri tanımlar.

Mülkiyet Türü Gerekli Description
firstName String Hayı Kişinin adı.
lastName String Yes Kişi aile adı.
email String Yes Kişi e-posta adresi.
phoneNumber String Hayı Kişi telefon numarası.
  • Last updated on