Önkoşullar

Yönetişim yapıtlarını bir ZIP dosyasıyla içe aktarmadan önce, dosyayı doğru biçimde yaratın ve gerekli izinlere sahip olduğunuzdan emin olun.

ZIP dosyasının içeriğinin düzenlenmesi

Dışa aktarılan ZIP dosyası, bu tip yapay nesne içeren bir CSV dosyasına sahip her yapay nesne tipi için ayrı bir klasör içerir.

Dışa aktarılan ZIP dosyasının içeriğini el ile değiştirebilirsiniz. Aşağıdaki yönergeleri izleyin:

• Ek klasörler yaratmayın; örneğin, bir üst klasör.
• Klasör adlarını değiştirmeyin. ZIP dosyasındaki her bir yapay nesne tipi için şu adlar bulunmalıdır: category, classification, data_class, glossary_term, policy, ruleve reference_data.
• Her CSV dosyasının doğru biçimini koruyun. Yönetişim yapıtlarını içe aktarmak için CSV dosya biçimikonusuna bakın.
• Her CSV dosyasında Artifact ID sütununu kaldırmayın ya da yeniden adlandırmayın. Bu sütun, yapay nesnenin adına ek olarak yapay nesnenin tanıtıcısını belirtir.
• Yapay nesnelerden yalnızca biri için iki yönetişim yapay nesnesi arasında bir ilişki tanımlayın. İki istisna vardır:
  1. İlişki, bir ilke ile bir yönetişim kuralı arasındadır. Bu durumda, her iki CSV dosyasındaki her iki yapay nesne için de ilişkiyi tanımlayın. CSV dosyasında ilkeleri olan bir ilişki Rule sütununa ekleyin. Yönetişim kuralları olan CSV dosyasında Parent Policies sütununa ilişkiyi ekleyin.
  2. all birleştirme seçeneğini kullanıyorsunuz. Bu durumda, tüm CSV içeriğinin yapay nesneler arasındaki ilişkilerle ilgili olarak tutarlı olduğundan emin olmanız gerekir. Örneğin, ZIP içe aktarma dosyası bir ilişki ile bağlantılı hem bir terim hem de bir veri sınıfı içeriyorsa, bu ilişki hem CSV hem de CSV veri sınıflarında bulunmalıdır. Aksi takdirde, ilişki içe aktarma davranışı öngörülemez, ilişki içe aktarılabilir ya da aktarılmayabilir.

ZIP dosyasını içe aktarma hazırlığı

Bir ZIP dosyasını içe aktarmadan önce aşağıdaki görevleri tamamlamanız gerekir:

• Önceden tanımlanmış yapay nesnelerin yinelenmesini önlemek için uygun işlemi gerçekleştirin
• Özel özellikler ve ilişkiler oluşturun

Birleştirme seçenekleri

ZIP içe aktarma işlemi çalıştırılırken aşağıdaki birleştirme seçenekleri kullanılabilir:

• all -Tüm değerleri değiştir-içe aktarılan değerler bir katalogdaki var olan değerlerin yerine geçer
• specified -Tanımlı değerlerle değiştir-boş olmayan içe aktarılan değerler, bir katalogdaki var olan değerleri değiştirir
• empty -Boş değerleri değiştir-içe aktarılan değerler yalnızca bir katalogdaki boş değerlerin yerine geçer

specified varsayılan olarak kullanılır.

Birleştirme seçenekleriyle ilgili daha fazla bilgi için İçe aktarılan ve var olan yapıtları birleştirme yöntemleri başlıklı konuya bakın.

ZIP dosyasının içe aktarılması

Yönetişim yapıtlarının ZIP dosyasını içe aktarmak için:

1. Gerekirse, önceden tanımlanmış yapay nesneleri silin ya da önceden tanımlanmış yapay nesnelerle ilişkileri düzenleyin. Bkz. ZIP dosyasını içe aktarmaya hazırlık.
2. POST /v3/governance_artifact_types/import isteğini gönderin. Birleştirme seçeneğini ve ZIP dosyasının yolunu ekleyin. API belgeleri: Belirtilen ZIP dosyasından değerleri içe aktarmabaşlıklı konuya bakın. Tüm yapay nesneler iş akışı olmadan hemen yayınlanır.
3. İçe aktarma işlemi tamamlandığında, yeni kategorilere diğer işbirliği yapanları ekleyin. Bkz. Kategori işbirlikçilerinin yönetilmesi.

Yeni bir içe aktarma işlemi başlatmadan önce içe aktarma işleminin tamamlanmasını ya da durdurulmuş süreci temizlemesinibeklemeniz gerekir.

İçe aktarma işleminin izlenmesi

ZIP dosyasını içe aktarma isteğini gönderdikten sonra, yanıtta (process_id parametresi) bir işlem tanıtıcısı sağlanır. İçe aktarma durumunu denetlemek için işlem tanıtıcısını kullanabilirsiniz. İçe aktarma durumunu sorgulamak için bir GET /v3/governance_artifact_types/import/status/{process_id} isteği gönderin. Bkz. API belgeleri: İçe aktarma durumu.

Durdurulmuş bir içe aktarma işlemini temizleme

Deneysel Bu bir deneysel yayın düzeyidir ve henüz üretim ortamlarında kullanım için desteklenmez.

İçe aktarma durursa, içe aktarma işlemini temizleyebilir ve ZIP dosyasını yeniden içe aktarabilirsiniz. Önceki işlem tamamlanıncaya ya da durdurulmuş süreci temizlemeden yeni bir içe aktarma işlemi başlatamazsınız. 24 saatlik boşta durma süresinden sonra tüm içe aktarma işlemleri otomatik olarak temizlenir.

Bir GET /v3/governance_artifact_types/import/status/{process_id} isteği göndererek içe aktarma işleminin durumunu denetleyebilirsiniz. Durum IN_PROGRESS ise, ancak yapay nesneler içe aktarılmıyorsa süreç durduruluyor.

Durdurulmuş ya da başarısız bir içe aktarma işlemini temizlemek için POST /v3/governance_artifact_types/import/cleanup/{process_id} isteğini gönderin.

API belgeleri: ZIP içe aktarma sürecini temizlebaşlıklı konuya bakın.

Daha fazla bilgi

• Yönetişim yapıtlarını CSV dosyasıyla içe aktarma

• Tüm yönetişim yapıtlarını bir ZIP dosyasına aktarma

• Yönetişim yapıtları içe aktarma sorunlarının çözülmesi

• API belgeleri: Değerleri belirtilen ZIP dosyasından içe aktar

Üst konu: Yönetişim yapıtları için yöntemleri içe aktar