Bileşen Geliştirme Hakkında

Özel bileşeninizi geliştirme, istediğiniz bir sayfa teknolojisini kullanarak site sayfasına gömülebilen birleşik öğeleri geliştirmenizi sağlar. Bu işlem Oracle Content Management tarafından sağlanan bileşen listesini genişletmenize olanak tanır.

Tüm kayıtlı bileşenlere yönelik girişler, Oracle Content Management uygulamasında tüm kayıtlı bileşenlere yönelik girişleri içeren bir klasör olan Bileşen Kataloğunda saklanır.

Şu adları şablonlar, temalar, bileşenler, siteler veya site sayfaları için kullanmayın: authsite, content, pages, scstemplate_*, _comps, _components, _compsdelivery, _idcservice, _sitescloud, _sitesclouddelivery, _themes, _themesdelivery. Şu adları site sayfaları için kullanabilirsiniz ancak şablonlar, temalar, bileşenler veya siteler için kullanmayın: documents, sites.

Bileşen Tipleri

Bileşen Kataloğu şu bileşen tiplerini destekler:

  • Yerel bileşen

  • Satır içi çerçevede görüntülenen yerel bileşen

  • Uzak bileşen

Bileşenin tipi, bileşen klasörünün "xScsAppType" genişletme özelliği olarak saklanır. Aşağıdakiler geçerli değerlerdir.

Tip Açıklama

Yerel bileşen

Tüm bağımlılıkların yerel olması beklenir.

Satır içi çerçevede görüntülenen yerel bileşen

Bileşen, Oracle Content Management ile aynı etki alanından sunulur.

Uzak bileşen

Bileşen uzak konumdan sunulur.

Bileşen Dosya Yapısı

Bileşen tiplerinin her biri uygulanma yöntemlerine bağlı olarak Bileşen Kataloğunda oluşturulduğunda farklı bir dosya grubu içerir.

Yerel bileşen:

/Components/component-name
    appinfo.json
    _folder_icon.jpg
    assets
        settings.html
        render.js

Satır içi çerçeve kullanan yerel bileşen:

/Components/component-name
    appinfo.json
    _folder_icon.jpg
    assets
        settings.html
        render.js
        js
            sites.min.js
            knockout.min.js
            jquery.min.js

Uzak bileşen:

/Components/component-name
    appinfo.json
    _folder_icon.jpg
    keys.json

Klasör Meta Verileri

Bileşen kayıt verileri, klasör meta verisinde saklanır. Aşağıdaki nitelikler, bileşeni ve bileşenin tipini benzersiz olarak tanımlamak için kullanılır.

Nitelik Açıklama

uygulama adı

Bileşenin adını belirleyen klasörün adı.

uygulama açıklaması

Klasörün açıklaması.

uygulama global benzersiz tanımlayıcısı

Her bileşen bir global benzersiz tanımlayıcı ile ilişkilendirilir ve xScsItemGUID genişletme özelliği olarak saklanır. Global benzersiz tanımlayıcı, bileşen oluşturulurken sunucu tarafından oluşturulur.

uygulama tipi

Nitelik, bileşen tipini belirler. xScsApType genişletme özelliği olarak saklanır.

Not:

xScsAppIconUrl genişletme özelliği olarak saklanan iconUrl niteliği kullanımdan kaldırıldı.

appinfo.json Dosyası

Her bileşen tipi için appinfo.json kayıt dosyası, sadece klasör meta verisi için kullanılamayan verileri içerir. Klasör meta verisinde tanımlı bileşen nitelikleri appinfo.json dosyasına kopyalanmaz.

Yerel bileşen:

{
        "settingsData":{
                "settingsHeight":80,
                "settingsRenderOption"; "dialog",
                "settingsWidth":300,
                "componentLayouts":[],
                "triggers":[],
                "actions":[]
        },
        "initialData":{
                "customSettingsData":[],
        }
}

Satır içi çerçevede görüntülenen yerel bileşen:

{
        "endpoints": {
              "settings": {
                      "height": "300",
                      "width": "400"
              }
        }
        "initialData": {
                "customSettingsData": {}
        }
}

Uzak bileşen:

{
        "endpoints": {
              "widget": {
                     "url": "http://www.externaldomain.com/app/render.html"
              }
              "settings": {
                      "url": "http://www.externaldomain.com/app/settings.html",
                      "height": "300",
                      "width": "400"
              }
        }
        "initialData": {
              "customSettingsData": {}
        }
}

Yerel bileşenler için kayıtlı "url" değerleri yoktur. Bunlar içerik için düzenlenebilen belirli dosyaları kullanır, ancak konumu veya adı değiştiremezsiniz.

  • Yerel bileşenler assets/render.js ve assets/settings.html dosyalarını kullanır.

  • Satır içi çerçevede görüntülenen yerel bileşenler assets/render.html ve assets/settings.html dosyalarını kullanır.

  • Uzak bileşenler belirtilen "url" değerlerini kullanır.