Script bileşeni Script bileşen düzenleyiciyi içinde yapılandırma
Script bileşeni özel kod yazmadan önce oluşturmak istediğiniz veri akışı bileşen türü seçmeniz gerekir — kaynak, dönüşüm veya hedef — ve bileşen meta verileri ve özelliklerinde yapılandırın Komut dosyası dönüşümü Düzenleyicisi.
Bileşen oluşturmak için türünü seçme
Veri akışı bölmesine bir Script bileşeni eklediğinizde SSIStasarımcı, Script bileşeni türünü seç iletişim kutusu görüntülenir. Kaynak, dönüşüm veya hedef bileşeni önceden. İlk seçiminizi yaptıktan sonra bileşenin yapılandırma devam Komut dosyası dönüşümü Düzenleyicisi.
Script bileşeni varsayılan komut dosyası dilini ayarlamak için Scripting dili Tarih seçeneği Genel sayfası seçenekleri iletişim kutusu. Daha fazla bilgi için, bkz. Genel sayfa.
İki Tasarım zamanı modu anlama
De SSIStasarımcı, Script bileşeni iki modu vardır: meta veri Tasarım modunda ve kod tasarım modunda.
Açtığınızda Komut dosyası dönüşümü Düzenleyicisi, bileşen meta verileri tasarım moduna girer. Bu modda giriş sütunları seçin ve eklemek veya çıkış ve çıktı sütunları yapılandırma, ancak kodu yazamazsınız. Bileşenin meta yapılandırdıktan sonra komut dosyası yazmak için kod tasarım moduna geçiş yapabilirsiniz.
Geçiş yapıldığında kod tasarım moduna tıklayarak Komut dosyası Düzenle, Script bileşeni ek değişiklikleri önlemek için meta verileri kilitler ve temel kodu meta veri girişleri ve çıkışları otomatik olarak oluşturur. Otomatik olarak oluşturulan kodu tamamlandıktan sonra sen-ecek muktedir özel kodunuzu girin. Kodunuzu, erişim tamponlar ve sütun arabelleklerindeki girdi satır işlemek ve bağlantı yöneticileri ve değişkenleri paketi, tüm kesinlikle yazılan nesneleri almak için otomatik olarak oluşturulan temel sınıflar kullanır.
Kodu tasarım modunda özel kodunuzu girdikten sonra meta verileri tasarım moduna geçiş yapabilirsiniz. Bu, girdiğiniz kod silinmez; Ancak, sonraki değişiklikler meta verileri yeniden oluşturulması temel sınıf neden. Daha sonra özel kodunuz tarafından başvurulan nesneler artık varolmayabilir veya değiştirilmiş çünkü bileşeniniz doğrulama başarısız olabilir. Bu durumda, böylece rejenere temel sınıf karşı başarıyla derlenebilir kod el ile düzeltmeniz gerekir.
Meta veri Tasarım modunda bileşen yapılandırma
Meta veri Tasarım modunda giriş sütunları seçin ve ekleyin ve çıkış ve çıktı sütunları yapılandırma, ancak kodu yazamazsınız. Bileşenin meta yapılandırdıktan sonra komut dosyası yazmak için kod tasarım moduna geçin.
Sen-meli configure özel düzenleyicide özellikleri Script bileşeni kullanımı üzerinde bağlıdır. Script bileşeni, bir kaynak, dönüşüm veya hedef yapılandırılabilir. Bileşen nasıl kullanıldığına bağlı olarak, giriş ya da çıkışları veya her ikisini de destekler. Size yazacak özel kod giriş ve çıkış satır ve sütunları işler.
Giriş sütunlar sayfasında komut dosyası dönüşümü Düzenleyicisi
Giriş sütunlar sayfası Komut dosyası dönüşümü Düzenleyicisi dönüşümleri ve hedefleri için ancak kaynakları için görüntülenir. Bu sayfada, özel komut, kullanımına ve salt belirtin veya erişim için okuma istediğiniz kullanılabilir giriş sütunları seçin.
Bu meta verilerini alarak oluşturulacak kod proje BufferWrapper proje öğesi her giriş için bir sınıf içerir ve bu sınıf, seçili giriş her sütun için yazılan erişeni özelliklerini içerir. Örneğin bir tamsayı'yı seçin, CustomerID sütun ve bir dize MüşteriAdı adlı bir giriş sütun CustomerInput, BufferWrapper proje öğesi içeren bir CustomerInput, gelen türetir sınıfı ScriptBufferve CustomerInputsınıf adında bir tamsayı özellik gösterecektir CustomerID adlı bir dize özelliği MüşteriAdı. Bu Kongre, kodu aşağıdaki gibi tür denetlemesi ile yazmak mümkün kılar:
Dim currentCustomerID as Integer = CustomerInput.CustomerID
Dim currentCustomerName as String = CustomerInput.CustomerName
Dim currentCustomerID as Integer = CustomerInput.CustomerID
Dim currentCustomerName as String = CustomerInput.CustomerName
Belirli türde bir veri akışı bileşeni için giriş sütunlar yapılandırma hakkında daha fazla bilgi için bkz: altında uygun örnek Komut dosyası bileşenleri belirli türleri geliştirme.
Girişleri ve çıkışları sayfayı komut dosyası dönüşümü Düzenleyicisi
Giriş ve çıkışları sayfası Komut dosyası dönüşümü Düzenleyicisi kaynakları, dönüşümleri ve hedefleri için görüntülenir. Bu sayfada, eklemek, kaldırmak ve girdileri, çıktıları ve aşağıdaki sınırlamalar içinde özel bir komut dosyası kullanmak istediğiniz çıktı sütunları yapılandırma:
Bir kaynak olarak kullanılan, Script bileşeni herhangi bir giriş vardır ve birden çok çıkış destekler.
Dönüşüm kullanıldığında, Script bileşeni bir giriş ve birden çok çıkış destekler.
Hedef olarak kullanılan, Script bileşeni bir giriş destekler ve çıkış vardır.
Bu meta verilerini alarak oluşturulacak kod proje BufferWrapper proje öğesi her giriş ve çıkış için bir sınıf içerir. Örneğin, adlı bir çıktı oluşturmak CustomerOutput, BufferWrapper proje öğesi içeren bir CustomerOutput, gelen türetir sınıfı ScriptBufferve CustomerOutputsınıf oluşturulan her çıktı sütununa yazılan erişeni özelliklerini içerir.
Sen-ebilmek configure çıktı sütunları yalnızca giriş ve çıkışları sayfa. Sen-ebilmek seçme dönüşümleri ve hedefleri için giriş sütunlar üzerinde Giriş sütunları sayfa. BufferWrapper proje öğesi oluşturduğunuz yazılan erişeni özelliklerini, çıktı sütunları için salt olacaktır. Giriş sütun erişeni özelliklerini salt okunur veya okuma/yazma üzerinde her sütun için seçtiğiniz kullanım türüne bağlı Giriş sütunları sayfa.
Girişleri ve çıkışları belirli bir veri türü için yapılandırma hakkında daha fazla bilgi akışı bileşen Bkz altında uygun örnek Komut dosyası bileşenleri belirli türleri geliştirme.
[!NOT]
Her ne kadar bir çıkış olarak hata çıktı Script bileşeni otomatik işleme hata satırları doğrudan yapılandıramazsınız, ek bir çıktı oluşturmak ve bu çıktıya uygun olduğunda doğrudan satırları komut kullanarak çıkış hata işlevselliğini yeniden üretebilirsiniz. Daha fazla bilgi için, bkz. Hata çıktı Script bileşeni simulasyonu.
ExclusionGroup ve SynchronousInputID özelliklerini çıkışları
ExclusionGroupÖzelliği ile zaman uyumlu çıkışlarına nerede kodunuzu süzme veya dallanma yapar ve her satır için paylaşmak aynı sıfır olmayan çıkış yönlendirir, dönüşümleri içinde yalnızca sıfır olmayan bir değer vardır ExclusionGroupdeğer. Örneğin, dönüşümün satırları varsayılan çıkış veya hata çıktı yönlendirebilirsiniz. Bu senaryo için ek çıkışlar oluşturduğunuzda, değerini ayarlamak emin olun SynchronousInputIDözelliği ile eşleşen tam IDbileşenin giriş.
SynchronousInputIDÖzelliği var sıfır olmayan bir değer yalnızca zaman uyumlu çıkışlarına ile dönüşümleri. Bu özelliğin değeri sıfır ise, çıkış zaman uyumsuz olduğu anlamına gelir. Nerede satırları geçti üzerinden seçili çıktı veya çıkışları için tüm yeni satırları eklemeden, zaman uyumlu bir çıkış için bu özellik içermesi gereken IDbileşenin girdi.
[!NOT]
Ne zaman Komut dosyası dönüşümü Düzenleyicisi ilk çıkış, Editör kümeleri oluşturur SynchronousInputIDÇıkış özelliği IDbileşenin giriş. Ancak, düzenleyici düzenleyici izleyen çıkışlarını oluşturduğunda, ayarlar SynchronousInputIDÖzellikler bu çıkışları sıfır.
Zaman uyumlu çıkışlarına ile bir bileşeni oluşturuyorsanız, her çıktı olmalıdır onun SynchronousInputIDözelliğini IDbileşenin giriş. Bu nedenle, her çıktı ilk çıkış olmalıdır sonra Düzenleyici oluşturur, SynchronousInputIDdeğeri değişti sıfırdan IDbileşenin giriş.
İle zaman uyumsuz çıkışlarına bir bileşeni oluşturuyorsanız, her çıktı olmalıdır onun SynchronousInputIDözelliği sıfıra. Bu nedenle, ilk çıkış olmalıdır onun SynchronousInputIDdeğeri değişti IDbileşenin giriş sıfır.
Script bileşeni satır için iki zaman uyumlu çıkışlarına yönlendiren bir örnek için bkz: Zaman uyumlu dönüşümü Script bileşeni ile oluşturma.
Oluşturulan komut dosyası nesne adları
Komut dosyası bileşeni girişleri ve çıkışları, adlarını ayrıştırmak ve girişleri ve çıkışları sütunların adlarını ayrıştırmak ve bu adlarına göre sınıfları ve özellikleri BufferWrapper proje öğesi oluşturur. Bulunan adları Unicode kategorilerine ait olmayan karakterler varsa UppercaseLetter, LowercaseLetter, TitlecaseLetter, ModifierLetter, OtherLetter, ya DecimalDigitLetter, geçersiz karakterleri oluşturulan adlar kesilir. Örneğin boşluk bırakılır, bu nedenle iki sütun adları olan giriş FirstName ve adher iki sütun adı sahip olarak yorumlanır ad, öngörülemeyen sonuçlar. Bu durumdan kaçınmak için giriş ve çıkış ve giriş ve çıkış sütunları Script bileşeni tarafından kullanılan adları yalnızca Unicode kategorileri bu bölümde listelenen karakter içermelidir.
Sayfayı komut dosyası dönüşümü Düzenleyicisi'nin komut dosyası
Tarih Script sayfası Komut dosyası görev Düzenleyicisi, benzersiz bir ad ve açıklama için Script görev atayabilir. Ayrıca, aşağıdaki özelliklerin değerlerini de atayabilirsiniz.
[!NOT]
De SQL Server 2008 Integration Services (SSIS)ve sonraki sürümleri, tüm komut dosyalarının derlenmiş. Önceki sürümlerde, belirttiğiniz komut ayarlayarak precompiled mi bir Precompileözelliği için görev.
ValidateExternalMetadata özelliği
Boolean değeri ValidateExternalMetadataözelliği belirtir olup bileşen doğrulama dış veri kaynaklarına karşı tasarım zamanında yapmak gerekir ya da mı o kadar çalışma zamanı doğrulama ertelemek. Varsayılan olarak, bu özellik değeri ise True; Yani, dış meta verileri hem tasarım zamanında hem de çalışma zamanında doğrulanır. Bu özelliğin değerini ayarlamak istediğiniz Falsebir dış veri kaynağından olmadığında kullanılabilir tasarım zamanında: Örneğin, ne zaman paket kaynak siteleri veya yalnızca çalışma zamanında hedef oluşturur.
ReadOnlyVariables ve ReadWriteVariables özellikleri
Varolan değişkenlerini virgülle ayrılmış listesi salt okunur değişkenler için kullanılabilir yapmak veya kod bileşeni Access'te okuma bu özelliklerinin değerleri olarak girebilirsiniz. Değişkenler, kod üzerinden erişilir ReadOnlyVariablesve ReadWriteVariablesautogenerated temel sınıf özellikleri Daha fazla bilgi için, bkz. Değişkenleri kullanarak Script bileşeni.
[!NOT]
Değişken adları büyük/küçük harf duyarlıdır.
ScriptLanguage
Sen-ebilmek seçme ya da Microsoft Visual Basic 2008ya Microsoft Visual C# 2008Script bileşeni programlama dili olarak.
Düzenle düğmesini
Komut dosyası Düzenle düğmesini açar Microsoft Visual StudioAraçları uygulamaları (vsta) IDE içinde senin özel JavaScript yazmak için Daha fazla bilgi için, bkz. Kodlama ve kod bileşen hata ayıklama.
Bağlantı Yöneticisi sayfayı komut dosyası dönüşümü Düzenleyicisi
Tarih Bağlantı Yöneticisi sayfası Komut dosyası dönüşümü Düzenleyicisi, özel komut dosyanızı kullanmak istediğiniz bağlantı yöneticileri ekleyip. Normalde bir kaynak veya hedef bileşeni oluşturduğunuzda bağlantı yöneticileri başvurmak gerekiyor.
Kod bu meta verilerini, oluşturulacak proje tabanlı ComponentWrapperProje öğesi içeren bir Connectionsher seçili bağlantı Yöneticisi için yazılı erişimci özelliği olan koleksiyonu sınıf. Her yazılan erişeni özelliği Bağlantı Yöneticisi aynı ada sahiptir ve Bağlantı Yöneticisi örneği döndürür IDTSConnectionManager100. Örneğin, bir bağlantı Yöneticisi adlı eklediyseniz MyADONETConnectionüzerine Bağlantı yöneticileri sayfa editörü, size bağlantı Yöneticisi başvuru komut dosyanıza aşağıdaki kodu kullanarak elde edebilirsiniz:
Dim myADONETConnectionManager As IDTSConnectionManager100 = _
Me.Connections.MyADONETConnection
Dim myADONETConnectionManager As IDTSConnectionManager100 = _
Me.Connections.MyADONETConnection
Daha fazla bilgi için, bkz. Veri kaynakları Script bileşenindeki bağlanma.
|
.gif "Integration Services simgesi (küçük)")
Integration Services ile güncel kalınAyrıca bkz.
Kavramlar
Kodlama ve kod bileşen hata ayıklama