SharePoint'ten veri aktarımını yapılandırma

Elektronik raporlama (ER) çerçevesini kullanarak bir gelen dosyadan verileri içe aktarmak için, içe aktarmayı destekleyen bir ER biçimi yapılandırmanız ve ardından bu biçimi veri kaynağı olarak kullanan Hedefe türünün bir model eşlemesini çalıştırmanız gerekir. Verileri içe aktarmak için, içe aktarmak istediğiniz dosyaya gitmeniz gerekir. Kullanıcı gelen dosyayı el ile seçebilir. Microsoft SharePoint'ten veri içe aktarmayı destekleyen yeni ER özelliği sayesinde bu işlem müdahalesiz yürüyecek şekilde yapılandırılabilir. Microsoft SharePoint klasörlerinde depolanan dosyalardan veri içe aktarmak için ER yapılandırmalarını kullanabilirsiniz. Bu makalede, SharePoint'den içeri aktarma işleminin nasıl tamamlanacağı açıklanmaktadır. Örneklerde iş verisi olarak satıcı hareketleri kullanılmaktadır.

Ön Koşullar

Bu makaledeki örnekleri tamamlamak için şu erişimlere sahip olmanız gerekir:

• Aşağıdaki rollerden birine erişim:

  • Elektronik raporlama geliştirici
  • Elektronik raporlama işlev danışmanı
  • Sistem yöneticisi

• Uygulama ile kullanılmak için yapılandırılmış Microsoft SharePoint Server örneğine erişim.

• 1099 ödemeleri için ER biçimi ve model yapılandırmaları.

Gerekli ER yapılandırmalarını oluşturma

7.5.4.3 BT hizmeti/çözüm bileşenleri Al/Geliştir (10677) iş sürecinin parçası olan Bir Microsoft Excel dosyasından ER veri içe aktarma görev kılavuzlarını oynatın. Bu görev kılavuzları, Microsoft Excel dosyalarından satıcı hareketlerini etkileşimli olarak içe aktarmak için ER yapılandırmalarını tasarlama ve kullanma sürecinde size yol gösterir. Daha fazla bilgi için bkz. Excel biçiminde gelen belgeleri ayrıştırma. Görev kılavuzlarını tamamladıktan sonra aşağıdaki kuruluma sahip olursunuz.

ER yapılandırmaları

• ER model yapılandırması, 1099 Ödemeleri modeli
• ER biçim yapılandırması, Satıcıların hareketlerini Excel'den içe aktarma biçimi

Veri içe aktarmada kullanılacak gelen dosya örneği

• Excel dosyası 1099import-data.xlsx: Aktarılması gereken satıcı hareketlerinin bulunduğu dosya.

Dekont

Satıcı hareketlerini içe aktarmak için kullanılan biçim, varsayılan model eşleme olarak seçilidir. Bu nedenle, bir model eşlemesi çalıştırıyorsanız, 1099 Ödemeleri modeli çalıştırıyorsanız ve söz konusu model eşleme Hedefe türündeyse, model eşleme, harici dosyalardan içe veri aktarmak için bu biçimi çalıştırır. Ardından bu verileri, uygulama tablolarını güncelleştirmek için kullanır.

Dosya depolama için SharePoint erişimini yapılandırma

Bir SharePoint konumuna elektronik rapor dosyaları depolamak için geçerli şirket tarafından kullanılacak olan SharePoint sunucusu örneği erişimini yapılandırmanız gerekir. Bu örnekte şirket USMF'dir. Yönergeler için bkz: SharePoint depolama yapılandırma.

1. Şuradaki adımları tamamlayın SharePoint depolamayı yapılandırma.

2. Yapılandırılmış SharePoint sitesini açın.

3. Gelen elektronik raporlama dosyalarının depolanabileceği aşağıdaki klasörleri oluşturun:

   • Dosyalar içe aktarma kaynağı (ana) (Örnek aşağıdaki ekran görüntüsünde gösterilmektedir)
   • Dosya içe aktarma kaynağı (alternatif)

   

4. (İsteğe bağlı) Dosyaların içe aktarmadan depolanabileceği klasörleri oluşturun.

   • Dosyalar arşiv klasörü - Bu klasör, başarıyla içe aktarılan klasörler için olacaktır.
   • Dosyalar uyarı klasörü - Bu klasör, bir uyarıyla içe aktarılan dosyalar için olacaktır.
   • Dosya hata klasörü - Bu klasör, içe aktarması başarısız olan dosyalar için olacaktır.

5. Kuruluş yönetimi > Belge yönetimi > Belge türleri'ne gidin.

6. Oluşturmuş olduğunuz SharePoint klasörlerine erişim için kullanılacak aşağıdaki belge türlerini oluşturun. Yönergeler için bkz: Belge türlerini yapılandırma.

Belge türü	Grup	Yer	SharePoint klasörü
SP Ana	Dosya	SharePoint	Dosya içe aktarma kaynağı (ana)
SP Alternatif	Dosya	SharePoint	Dosya içe aktarma kaynağı (alternatif)
SP Arşivi:	Dosya	SharePoint	Dosyalar arşivi klasörü
SP Uyarı	Dosya	SharePoint	Dosyalar uyarı klasörü
SP Hatası	Dosya	SharePoint	Dosyalar hata klasörü

ER biçimi için ER kaynaklarını yapılandırma

1. Kuruluş yönetimi>Elektronik raporlama>Elektronik raporlama kaynağı'na tıklayın.

2. Elektronik raporlama kaynağı sayfasında, yapılandırılmış ER biçimini kullanarak, veri içe aktarma işlemi için kullanılacak kaynak dosyalarını yapılandırın.

3. Yalnızca .xlsx uzantılı dosyaların içe aktarılması için bir dosya adı maskesi tanımlayın. Dosya adı maskesi isteğe bağlıdır ve ancak tanımlandığı zaman kullanılır. Her bir ER biçimi için yalnızca bir maske tanımlayabilirsiniz.

4. İçeri aktarma işlemi için çok fazla dosya varsa ve sıralaması önemli değilse Dosyaları içeri aktarmadan önce sırala ayarını Sıralama olarak değiştirme

5. Daha önce oluşturduğunuz tüm SharePoint klasörlerini seçin.

   

Dekont

• ER kaynağı her bir uygulama şirketi için ayrı ayrı tanımlanır. Bunun aksine, ER yapılandırmaları şirketler arasında paylaşılır.
• Bir ER biçimine ait bir ER kaynağı ayarını sildiğiniz zaman, tüm bağlantılı dosya durumları da (aşağıya bakın) onay ile silinir.

ER biçimi için dosya durumlarını inceleme

1. Mevcut ER biçimi için yapılandırılmış dosya kaynaklarının içeriğini incelemek için Elektronik raporlama kaynağı sayfasında Kaynaklar için dosya durumları'nı seçin.

2. Dosyalar bölümünde, dosyalar listesini inceleyin. Bu listede aşağıdakiler sunulur:

   • Dosya adı maskesine göre (bir dosya adı maskesi tanımlandıysa) uygun ve veri içe aktarmaya hazır kaynak dosyalar. Bu dosyalar için, İçe aktarma için kaynaklar günlüğü bölümü boştur.
   • Daha önce içe aktarılan dosyalar. Bu dosyaların her biri için, İçe aktarma biçimi için kaynaklar günlüğü bölümünde, bu dosyanın içe aktarma geçmişini inceleyebilirsiniz.

Kaynaklar için dosya durumları sayfasını Kuruluş yönetimi>Elektronik raporlama>Kaynaklar için dosya durumları'nı seçerek de açabilirsiniz. Bu durumda, sayfada, oturum açtığınız şirkette dosya kaynaklarının yapılandırıldığı tüm ER biçimlerinin dosya kaynakları hakkında bilgiler verilir.

Bir SharePoint klasöründeki Excel dosyalarından verileri içe aktarma

1. SharePoint'te, satıcı hareketlerini içeren Microsoft Excel, dosyasını 1099import-data.xlsx, daha önce oluşturduğunuz Dosya içe aktarma kaynağı (ana) SharePoint klasörüne yükleyin.

   

2. Kaynaklar için dosya durumları sayfasında Yenile'yi seçerek sayfayı yenileyin. SharePoint'e yüklenen Excel dosyası, bu sayfada Hazır durumunda gösterilir. Şu anda aşağıdaki durumlar desteklenmektedir:

   • Hazır - SharePoint klasöründeki her yeni dosyaya otomatik olarak atanır. Bu durum, dosyanın içe aktarılmaya hazır olduğu anlamına gelir.
   • İçe Aktarılıyor: Dosya, başka işlemler (çok sayıda işlem aynı anda çalışıyorsa) tarafından kullanılmasını önlemek için içe aktarma işlemi tarafından kilitleneceği zaman bir ER raporu tarafından otomatik olarak atanır.
   • İçe Aktarıldı: Dosyayı içeri aktarma işlemi başarıyla tamamlandığında bir ER raporu tarafından otomatik olarak atanır. Bu durum, içe aktarılan dosyanın, yapılandırılan dosya kaynağından (SharePoint klasörü) silindiği anlamına gelir.
   • Başarısız: Dosyayı içeri aktarma işlemi hatalarla veya özel durumlarla tamamlandığında ER raporu tarafından otomatik olarak atanır.
   • Beklemede: Bu sayfada kullanıcı tarafından el ile atanır. Bu durum, dosyanın şimdilik içe aktarılmayacağı anlamına gelir. Bu durum, bazı dosyaları içe aktarma işlemini ertelemek için kullanılabilir.

   

SharePoint dosyalardan içe aktarma

1. ER yapılandırmaları ağacını açın, 1099 Ödeme modeli'ni seçin ve ER modeli bileşenleri listesini genişletin.

2. Seçili ER model yapılandırmasının model eşlemeleri listesini açmak için model eşlemenin adını seçin.

   

3. Seçili model eşlemeyi çalıştırmak için Çalıştır'ı seçin. ER biçimi için dosya kaynaklarını siz yapılandırdığınız için, Dosya kaynağı seçeneğinin ayarını gerekli olduğu gibi değiştirebilirsiniz. Bu seçeneğin ayarını korursanız, .xslx dosyaları, yapılandırılmış kaynaklardan (bu örnekte SharePoint klasörleri) içe aktarılır.

   Bu örnekte tek bir dosya içe aktarıyorsunuz. Ancak birden çok dosya varsa, bu dosyalar SharePoint klasörüne eklendikleri sırayla içe aktarma işlemine seçilir. Her ER biçimi çalıştırılışında, seçilen dosyalardan biri içe aktarılır.

   

4. Model eşleme, toplu iş modunda katılımsız çalıştırılabilir. Bu durumda, bu ER biçimi bir toplu iş tarafından her çalıştırıldığında, yapılandırılan dosya kaynaklarından tek bir dosya içe aktarılır.

   Bir dosya SharePoint klasöründen başarıyla içe aktarıldıktan sonra, bu klasörden silinir ve başarıyla içe aktarılan veya uyarılar ile içe aktarılan dosyalar klasörüne taşınır. Aksi taktirde başarısız dosyalar klasörüne taşınır veya bu ayarlanmadıysa, bu klasörde kalır.

5. Fiş kodunu (V-00001 vb.) girin ve Tamam'ı seçin.

   

6. Kaynaklar için dosya durumları sayfasında Yenile'yi seçerek sayfayı yenileyin.

   

7. Dosyalar bölümünde, dosyalar listesini inceleyin. İçe aktarma biçimi için kaynaklar günlüğü bölümü, Excel dosyası içe aktarma geçmişini verir. Bu dosya başarıyla içe aktarıldığı için SharePoint klasöründe Silindi olarak işaretlenir.

8. Dosya içe aktarma kaynağı (ana) SharePoint klasörünü inceleyin. Başarıyla içe aktarılan Excel dosyaları bu klasörden silinmiştir.

9. Borç hesapları>Periyodik görevler>Vergi 1099>1099 formlarına ilişkin satıcı kapatması öğesini seçin.

10. Başlangıç tarihi ve Bitiş tarihi alanlarına ilgili değerleri girin. Bunun ardından El ile 1099 hareketleri.

    SharePoint'te V-00001 kodlu fiş için Excel dosyasından içe aktarılan satıcı hareketleri sayfada gösterilir.

    

Excel dosyasını içe aktarmaya hazırlama

1. Daha önce kullandığınız Excel dosyasını açın. Satır 3 sütun 1'e, uygulamada bulunmayan bir satıcı kodu ekleyin. Satıra yanlış bir satıcı bilgisi ekleyin.

   

2. Satıcı hareketlerini içeren güncelleştirilmiş Excel dosyasını Dosya içe aktarma kaynağı (ana) SharePoint klasörüne yükleyin.

3. ER yapılandırmaları ağacını açın, 1099 Ödeme modeli'ni seçin ve ER modeli bileşenleri listesini genişletin.

4. İçe aktarma işlemi sırasında yanlış satıcı kodunun hata olarak değerlendirilmesi için, model eşlemenin adını seçerek model eşlemeyi güncelleştirin.

5. Tasarımcı’yı seçin.

6. Doğrulamalar sekmesinde, içe aktarılan satıcı hesabının uygulamada var olup olmadığını değerlendirmek amacıyla yapılandırılmış doğrulama kuralı için, doğrulama sonrası eylemi değiştirmeniz gerekir. Doğrulama sonrası eylem alanının değerini Yürütmeyi durdur olarak güncelleştirin, değişikliklerinizi kaydedin ve sayfayı kapatın.

   

7. Değişikliklerinizi kaydedin ve ER model eşleme tasarımcısını kapatın.

8. Değiştirilen ER model eşlemesini çalıştırmak için Çalıştır'ı seçin.

9. Fiş kodunu (V-00002 vb.) girin ve Tamam'ı seçin.

   Bilgi Günlüğünde, SharePoint klasöründe bir dosyanın yanlış satıcı hesabı içerdiği ve içeri aktarılamayacağını belirten bir bildirim bulunur.

   

10. Kaynak için dosya durumları sayfasında Yenile'yi seçin ve ardından Dosyalar bölümünde, dosyalar listesini inceleyin.

    

İçe aktarma biçimi için kaynaklar günlüğü bölümü, içe aktarma işleminin başarısız olduğunu ve dosyanın hala Dosya hatalı SharePoint klasöründe olduğunu (Silindi onay kutusu işaretli değildir) gösterir. SharePoint üzerinde bu dosyayı doğru satıcı kodunu ekleyerek düzeltirseniz ve sonra Dosya içe aktarma kaynak (ana) SharePoint klasörüne taşırsanız, dosyayı yeniden içe aktarabilirsiniz.

11. Borç hesapları>Periyodik görevler>Vergi 1099>1099 formlarına ilişkin satıcı kapatması öğesini seçin, Başlangıç tarihi ve Bitiş tarihi alanlarına uygun değerleri girin ve El ile 1099 hareketleri'ni seçin.

    Yalnızca V-00001 kodlu fişe ilişkin hareketler kullanılabilir. Excel dosyasında son içe aktarılan harekette hata bulunsa bile V-00002 kodlu fişe ilişkin hareketler kullanılamaz.

Sınırlamalar

Dynamics 365 Finance'in 10.0.25 öncesi sürümlerde ER çerçevesinin kullanıcı arabirimi, katılımsız modda veri içeri aktarma için model eşleme çalıştıracak yeni bir toplu iş başlatma olanağı sunmaz. Bunu yerine, yapılandırılan ER model eşlemenin gelen dosyalardan verileri içeri aktarmak üzere uygulama kullanıcı arabiriminden çağrılabilmesi amacıyla yeni bir mantık geliştirmeniz gerekir. Bu mantığı geliştirmek için bazı mühendislik çalışmaları gereklidir.

İlgili ER API'si hakkında daha fazla bilgi edinmek için Application update 7.3 için ER çerçevesi API değişiklikleri başlığındaki Veri içeri aktarma için biçim eşleme çalıştırma kodu bölümüne bakın. Özel mantığınızın nasıl uygulanabileceğini görmek için Application Suite modelinin BankImport_RU sınıfındaki kodu inceleyin. BankImport_RU sınıfı, RunBaseBatch sınıfını genişletir. Özellikle, ERIModelMappingDestinationRun nesnesinin ER model eşlemesinin çalıştırıcısı olarak oluşturulduğu runER() yöntemini inceleyin.

Finance 10.0.25 sürümü ve sonrasında ER çerçevesi kullanıcı arabirimi, veri içeri aktarma için katılımsız modda model eşleme çalıştıracak yeni bir toplu iş başlatma özelliği sunar. Bu işlem hakkında daha fazla bilgi edinmek için Seçilen dosyalardan verileir toplu iş modunda içeri aktarma.

Ek kaynaklar

Elektronik Raporlamaya genel bakış

Application update 7.3 için ER çerçevesi API değişiklikleri

Application update 10.0.23 için ER çerçevesi API değişiklikleri

Application update 10.0.25 için ER çerçevesi API değişiklikleri