Adobe Deneyim Yöneticisi (Önizleme)
Adobe Experience Manager tümleştirmesi, Adobe Experience Manager Forms ile ilgili hizmetlere (ör. İletişim ve daha fazlası) erişim sağlar. Bu tümleştirme, Adobe Experience Manager Forms aracılığıyla bir form gönderildiğinde akışların tetiklenebilmesini de sağlar.
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 | Adobe Experience Manager Forms |
| URL | https://www.adobe.com/go/adobe-experience-manager-forms-community |
| E-posta | aem-pa@adobe.com |
| Bağlayıcı Meta Verileri | |
|---|---|
| Publisher | Kerpiç |
| Web sitesi | https://business.adobe.com/products/experience-manager/forms/aem-forms.html |
| Gizlilik ilkesi | https://www.adobe.com/in/privacy/policy.html |
| Kategoriler | Verimli -lik; İş Yönetimi |
Adobe Experience Manager bağlayıcısını kullanarak Adobe Experience Manager Forms - İletişim özelliklerine erişerek form tasarımını ve XML form verilerini temel alan bir PDF belgesi oluşturabilir veya PostScript (PS), Yazıcı Komut Dili (PCL), Zebra Yazdırma Dili (ZPL) ve diğer Yazıcı Tanımlama Dili belgelerini oluşturabilirsiniz.
Önkoşullar
Bağlayıcıyı kullanmak için bir lisansa ve Bulut Hizmeti olarak Adobe Experience Manager Forms - İletişim API'lerine erişmeniz gerekir.
Kimlik bilgilerini alma
Adobe Experience Manager'ı yalnızca birkaç adımda kolayca kullanmaya başlayabilirsiniz:
Hizmet kimlik bilgilerini oluşturma
Hizmet kimlik bilgilerini oluşturmak için Adobe Experience Manager Geliştirici Konsolu'nu kullanın.
Bağlantınızı ayarlama
Hizmet kimlik bilgilerinizi Adobe Experience Manager Bağlayıcısı'na ekleyin. Hizmet kimlik bilgisi JSON'dan kimlik bilgilerini alabilir ve bu kimlik bilgisi ayrıntılarını tek seferlik bağlantı kurulumunuza kopyalayabilirsiniz:
- Kuruluş Kimliği
- Müşteri Kimliği
- İstemci Sırrı
- Teknik Hesap Kimliği
- Meta Kapsamlar
- Özel Anahtar
- Adobe IMS Ana Bilgisayar URL'si
AEM Sunucusu için Adobe Experience Manager Bulut Hizmeti Yazarı veya Yayımla örneğinizin URL'sini belirtin. Örneğin, https://publish-pXXXX-eXXXXX.adobeaemcloud.com
Bağlayıcınızı kullanmaya başlama
Bağlayıcı aşağıdaki işlemleri destekler:
Şablondan PDF Belgesi oluşturma ve verileri birleştirme
Form tasarımını ve XML form verilerini temel alan bir PDF belgesi oluşturabilirsiniz. İş yazışmaları, beyanlar, talep işleme mektupları, avantaj bildirimleri, aylık faturalar veya karşılama setleri gibi marka onaylı, kişiselleştirilmiş ve standartlaştırılmış belgeler oluşturmanıza yardımcı olur.
Temel bir iş akışı, PDF belgesi oluşturmak için XML form verilerini bir form tasarımıyla birleştirmektir. Adobe Experience Manager Forms Designer'da şablon oluşturabilirsiniz.
İşlemin çıktısı etkileşimli olmayan bir PDF belgesidir. Diğer bir ifadeyle, kullanıcılar form verilerini giremez veya değiştiremez. İşlemin çeşitli seçeneklerini yapılandırmak için aşağıdaki parametreleri belirtebilirsiniz:
| Parametre | Zorunlu (Gerekli) | Description |
|---|---|---|
| Template | Yes | Şablon, PDF belgesinin görünümünü ve davranışını tanımlar. API, biçim şablonlarını destekler: XDP ve PDF belgesi. Tam yol, Adobe Experience Manager Deponuzun başvuru yolu veya ikili dosya belirtebilirsiniz. |
| Data | Yes | Şablonla birleştirilecek verileri içeren bir XML dosyası. Tam HTTP konumu veya ikili dosya belirtebilirsiniz. |
| XCI yapılandırması | Hayı | Hizmet, PDF belgesinin çeşitli özelliklerini yapılandırmak için bir XCI yapılandırma dosyası kullanır. XCI parametresi, yalnızca şablon XDP veya XDP tabanlı bir PDF belgesi türünde olduğunda etkili olur. Tam yol, Adobe Experience Manager Deponuzun başvuru yolu veya ikili dosya belirtebilirsiniz. |
| Locale | Hayı | Pdf dosyasının işlenmesi gereken yerel ayar. |
| İçerik kökü | Hayı | Şablon kaynaklarının konumu (görüntüler, parçalar ve daha fazlası). Bu yol şablon konumuna göredir. |
| PDF'ye etiket ekleme | Hayı | Ekran okuyucular ve diğer yardımcı teknolojilerle kullanmak üzere iyileştirmek üzere etiketlerle bir PDF oluşturmak için belirtin. |
| PDF'ye yazı tipleri ekleme | Hayı | Bir yazı tipi eklediğinizde, katıştırılmış yazı tipi tüm cihazlarda da aynı görünür, ancak daha büyük bir çıkış dosyası oluşturulur. |
| PDF'yi doğrusallaştırma (Hızlı Web Görünümü) | Hayı | PDF'yi Hızlı Web Görünümü için iyileştirmeyi seçin |
| Durumu koru | Hayı | Etkileşimli bir PDF belgesi, form oluşturan çeşitli öğeler içerir. Bu öğeler alanlar (verileri kabul etmek veya görüntülemek için), düğmeler (olayları tetikleme) ve betikleri (belirli bir eylemi gerçekleştirme komutları) içerebilir. Bir düğmeye tıklanması, alanın durumunu değiştiren bir olayı tetikleyebilir. Örneğin, cinsiyet seçeneğinin seçilmesi alanın rengini veya formun görünümünü değiştirebilir. Bu, form durumunun değişmesine neden olan el ile bir olaya örnektir. Böyle etkileşimli bir PDF belgesi Adobe Experience Manager Forms İletişim özellikleri kullanılarak düzleştirilirse formun durumu korunmaz. Form düzlendikten sonra bile formun durumunun korunmasını sağlamak için Formun durumunu kaydetmek ve korumak için Durumu koru Boole değerini True olarak ayarlayın. |
| İmzasız imza alanlarını koruma | Hayı | PDF dosyası düzleştirilmiş olduğunda imzalı ve imzasız imza alanlarının tutulup tutulmayacağını belirtir |
| Adobe Acrobat Reader sürümü | Hayı | PDF belgesini açmak için gereken en düşük Acrobat Reader sürümünü belirtir. Varsayılan sürüm Adobe Acrobat 11'dir. |
Şablondan ve verilerden PostScript (PS), Yazıcı Komut Dili (PCL), Zebra Yazdırma Dili (ZPL), DPL (Datamax Programlama Dili), IPL (Intermec Yazıcı Dili), TPCL (TEC Yazıcı Komut Dili) dosyaları oluşturma
XDP form tasarımını veya PDF belgesini temel alan PostScript (PS), Yazıcı Komut Dili (PCL), Zebra Yazdırma Dili (ZPL), DPL (Datamax Programlama Dili), IPL (Intermec Yazıcı Dili), TPCL (TEC Yazıcı Komut Dili) belgesi oluşturmak için belge oluşturma API'lerini kullanabilirsiniz. Bu API'ler, belge oluşturmak için form tasarımını form verileriyle birleştirmeye yardımcı olur. Belgeyi bir dosyaya kaydedebilir ve Power Automate'i kullanarak bir yazıcıya gönderebilirsiniz. İşlemin çeşitli seçeneklerini yapılandırmak için aşağıdaki parametreleri belirtebilirsiniz:
| Parametre | Zorunlu (Gerekli) | Description |
|---|---|---|
| Template | Yes | Şablon, PDF belgesinin görünümünü ve davranışını tanımlar. API, biçim şablonlarını destekler: XDP ve PDF belgesi. Tam yol, Adobe Experience Manager Deponuzun başvuru yolu veya ikili dosya belirtebilirsiniz. |
| Data | Yes | Şablonla birleştirilecek verileri içeren bir XML dosyası. Tam HTTP konumu veya ikili dosya belirtebilirsiniz. |
| Yazıcı profili | Yes | Kullanılacak XDC dosyasını belirtir. XDC dosyaları, XML biçimindeki yazıcı açıklama dosyalarıdır. Adobe Experience Manager Forms Communications özelliği, Belgeleri PostScript, PCL, DPL, TPCL ve ZPL gibi biçimlerde çıkarmak için XDC dosyalarını kullanır. XDC dosyaları kopya sayısı, çift yönlü yazıcının kullanılıp kullanılmadığı veya zımba seçenekleri gibi yazdırma seçeneklerini belirtmek için de kullanılır. |
| Çıkış türü | Yes | İşlem için çıkış dosyası türünü belirtir. Desteklenen seçenekler PostScript (PS), Yazıcı Komut Dili (PCL), Zebra Yazdırma Dili (ZPL), DPL (Datamax Programlama Dili), IPL (Intermec Yazıcı Dili), TPCL (TEC Yazıcı Komut Dili) seçenekleridir. |
| XCI yapılandırması | Hayı | Kullanılacak XCI dosyasını belirtir. XCI dosyaları, form tasarım öğeleri için kullanılan yazı tiplerini açıklamak için kullanılır. Tam yol, Adobe Experience Manager Deponuzun başvuru yolu veya ikili dosya belirtebilirsiniz. |
| Locale | Hayı | Çıktının işlenmesi gereken yerel ayar. |
| İçerik kökü | Hayı | Şablon kaynaklarının konumu (görüntüler, parçalar ve daha fazlası). Bu yol şablon konumuna göredir. |
| Kopya sayısı | Hayı | Çıkış dosyasının üretilmesi gereken kopya sayısını belirtir. |
| Sayfalandırma | Hayı | İki taraflı mı yoksa tek taraflı yazdırma mı kullanılacağını belirtir. PostScript ve PCL destekleyen yazıcılar bu değeri kullanır. |
Yaygın hatalar ve çözümler
| Hata Kodu | Description | Çözüm |
|---|---|---|
| 403 | Yasak. API'yi kullanmak için forms-users grubunun üyesi olmanız gerekir. | Teknik hesabı forms-users grubunun üyesi yapın, hem kullanıcıyı (teknik hesap) hem de grubu (forms-users) yayımlayın. |
| 400 | Belirtilen şablon geçerli değil. Geçerli bir şablon belirtin ve yeniden deneyin. | Parametrenin template değeri URL değil düz metin olduğunda, veri xml dizesini ikiliye dönüştürün. Dönüştürmeyi yapmak için Microsoft Power Automate'in binary() ifadesini kullanabilirsiniz. JCR yolunu kullandığınızda, yola crx:// ön ek ekleyin. |
| 400 | Belirtilen veriler geçersiz. Geçerli bir veri dosyasıyla yeniden deneyin. | Parametrenin data değeri URL değil düz metin olduğunda, veri xml dizesini ikiliye dönüştürün. Dönüştürmeyi yapmak için Microsoft Power Automate'in binary() ifadesini kullanabilirsiniz. |
| 400 | Belirtilen XCI yapılandırması bazı geçersiz değerler içeriyor. Yapılandırma dosyasını düzeltin ve yeniden deneyin. | Parametrenin XCI configuration değeri URL değil düz metin olduğunda, veri xml dizesini ikiliye dönüştürün. Dönüştürmeyi yapmak için Microsoft Power Automate'in binary() ifadesini kullanabilirsiniz |
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 |
|---|---|---|---|
| AEM Sunucusu | String | AEM Yazar veya Yayımla örneğinizin URL'sini belirtin. | Doğru |
| Kuruluş Kimliği (kuruluş) | String | Kuruluş Kimliğinizi belirtin. | Doğru |
| İstemci Kimliği (clientId) | String | Hizmet kimlik bilgilerinizden İstemci Kimliğini belirtin. | Doğru |
| İstemci Gizli Anahtarı (clientSecret) | securestring | Hizmet kimlik bilgilerinizden İstemci Gizli Dizisini belirtin. | Doğru |
| Teknik Hesap Kimliği (kimlik) | String | AEM teknik hesabınızın kimliğini belirtin. | Doğru |
| Meta Kapsamlar (meta kapsamlar) | String | Hizmet kimlik bilgilerinizden Meta Kapsamları belirtin. | Doğru |
| Özel Anahtar (privateKey) | securestring | Özel Anahtarı sağlayın. Hizmet kimlik bilgilerine eklenir. | Doğru |
| Adobe IMS Ana Bilgisayar URL'si (imsEndpoint) | String | Adobe Identity Management hizmetinin ana bilgisayar URL'sini sağlayın. | 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
| Şablon ve verilerden PDF oluşturma (Önizleme) |
PDF veya XDP şablonundan PDF Belgesi oluşturun ve XML verilerini bu şablonla birleştirin. |
| Şablondan ve verilerden PS, PCL, ZPL, DPL, IPL veya TPCL dosyası oluşturma (Önizleme) |
Bir XDP dosyasından veya PDF belgesinden PostScript (PS), Yazıcı Komut Dili (PCL), Zebra Yazdırma Dili (ZPL), DPL (Datamax Programlama Dili), IPL (Intermec Yazıcı Dili) veya TPCL (TEC Yazıcı Komut Dili) belgesi oluşturun ve XML verilerini onunla birleştirin. |
Şablon ve verilerden PDF oluşturma (Önizleme)
PDF veya XDP şablonundan PDF Belgesi oluşturun ve XML verilerini bu şablonla birleştirin.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Template
|
template | True | binary |
XDP veya PDF şablonunun ikili dosyasını veya konumunu belirtin. |
|
Data
|
data | True | binary |
Şablonla birleştirilecek XML verilerinin ikili dosyasını veya konumunu belirtin. |
|
XCI yapılandırması
|
xci | binary |
XCI yapılandırmaları dosyasının ikili dosyasını veya konumunu belirtin. |
|
|
Locale
|
locale | string |
PDF belgesi için bir yerel ayar seçin. |
|
|
İçerik kökü
|
contentRoot | string |
Şablonda kullanılan varlıkları almak için URI'yi, mutlak başvuruyu veya konumu belirtin. |
|
|
PDF'ye etiket ekleme
|
isTagged | boolean |
Ekran okuyucuları ve diğer yardımcı teknolojileri kullananlar için PDF'yi iyileştirmek için Etiketlerle bir PDF oluşturun. |
|
|
PDF'ye yazı tipleri ekleme
|
embedFonts | boolean |
Cihazlar ve ekranlar arasında tutarlı bir görünüm için PDF'ye yazı tipleri ekleme |
|
|
PDF'yi doğrusallaştırma (Hızlı Web Görünümü)
|
linearizedPDF | boolean |
PDF'yi Hızlı Web Görünümü için iyileştirmeyi seçin |
|
|
Durumu koru
|
retainFormState | boolean |
Belge düzlendikten sonra durumunu korumayı seçin. |
|
|
İmzasız imza alanlarını koruma
|
retainUnsignedSignatureFields | boolean |
İmzalanmamış imza alanlarını korumak veya kaldırmak için seçin |
|
|
Adobe Acrobat Reader sürümü
|
acrobatVersion | string |
PDF belgesini açmak için gereken en düşük Acrobat Reader sürümünü seçin. |
Döndürülenler
- response
- PDFResult
Şablondan ve verilerden PS, PCL, ZPL, DPL, IPL veya TPCL dosyası oluşturma (Önizleme)
Bir XDP dosyasından veya PDF belgesinden PostScript (PS), Yazıcı Komut Dili (PCL), Zebra Yazdırma Dili (ZPL), DPL (Datamax Programlama Dili), IPL (Intermec Yazıcı Dili) veya TPCL (TEC Yazıcı Komut Dili) belgesi oluşturun ve XML verilerini onunla birleştirin.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Template
|
template | True | binary |
XDP veya PDF şablonunun ikili dosyasını veya konumunu belirtin. |
|
Data
|
data | True | binary |
Şablonla birleştirilecek XML verilerinin ikili dosyasını veya konumunu belirtin. |
|
XCI yapılandırması
|
xci | binary |
XCI yapılandırmaları dosyasının ikili dosyasını veya konumunu belirtin. |
|
|
Locale
|
locale | string |
Çıkış dosyasının yerel ayarını seçin. |
|
|
İçerik kökü
|
contentRoot | string |
Şablonda kullanılan varlıkları almak için URI'yi, mutlak başvuruyu veya konumu belirtin. |
|
|
Kopya sayısı
|
copies | integer |
Üretecek kopya sayısını belirtin. |
|
|
Sayfalandırma
|
paginationOverride | string |
Sayfanın bir tarafına veya her iki tarafına yazdırma seçeneğini ayarlayın. |
|
|
Yazıcı profili
|
xdcUri | True | string |
Yazıcı özellikleri ve kağıt türleri gibi yazıcı özelliklerini açıklayan bir XDC dosyası seçin. |
|
Çıkış türü
|
renderType | True | string |
Kullanılabilir çıkış türleri arasından seçim yapın. |
Döndürülenler
- response
- PrintedResult
Tanımlar
PDFResult
- PDFOutput
- binary
PrintedResult
- PrintedOutput
- binary