구성요소 개발 정보

고유의 사용자정의 구성요소를 개발하면 원하는 페이지 기술을 사용하여 사이트 페이지 안에 포함할 수 있는 복합 요소를 개발할 수 있습니다. 사실상 Oracle Content Management와 함께 제공된 구성요소 목록을 확장할 수 있습니다.

모든 등록된 구성요소 항목을 포함하는 Oracle Content Management의 폴더인 구성요소 카탈로그에 모든 등록된 구성요소 항목이 저장됩니다.

템플리트, 테마, 구성요소, 사이트 또는 사이트 페이지에 다음 이름을 사용하지 마십시오: authsite, content, pages, scstemplate_*, _comps, _components, _compsdelivery, _idcservice, _sitescloud, _sitesclouddelivery, _themes, _themesdelivery. 사이트 페이지에는 다음 이름을 사용할 수 있지만 템플리트, 테마, 구성요소 또는 사이트에는 사용하지 마십시오: documents, sites.

구성요소 유형

구성요소 카탈로그는 다음 유형의 구성요소를 지원합니다.

  • 로컬 구성요소

  • 인라인 프레임으로 렌더링된 로컬 구성요소

  • 원격 구성요소

구성요소 유형은 구성요소 폴더의 확장 속성 "xScsAppType"으로 저장됩니다. 적합한 값이 따릅니다.

유형 설명

로컬 구성요소

모든 종속성이 로컬로 예상됩니다.

인라인 프레임으로 렌더링된 로컬 구성요소

구성요소가 Oracle Content Management와 동일한 도메인에서 서비스됩니다.

원격 구성요소

구성요소가 원격 위치에서 서비스됩니다.

구성요소 파일 구조

각 유형의 구성요소는 구현 방법에 따라 구성요소 카탈로그에 생성될 때 다른 파일 집합을 갖습니다.

로컬 구성요소:

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

인라인 프레임을 사용하는 로컬 구성요소:

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

원격 구성요소:

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

폴더 메타데이터

구성요소 등록 데이터는 폴더 메타데이터에 저장됩니다. 다음 속성은 구성요소와 해당 유형을 고유하게 식별하는 데 사용됩니다.

속성 설명

app name

구성요소 이름을 지정하는 폴더의 이름입니다.

app description

폴더의 설명입니다.

app guid

모든 구성요소는 GUID와 연관되며 확장 속성 xScsItemGUID로 저장됩니다. GUID는 구성요소를 생성할 때 서버에서 생성됩니다.

app type

속성은 구성요소 유형을 지정합니다. 확장 속성 xScsApType으로 저장됩니다.

주:

확장 속성 xScsAppIconUrl로 저장된 iconUrl 속성은 더 이상 사용되지 않습니다.

appinfo.json 파일

각 구성요소 유형에 대한 appinfo.json 등록 파일에는 폴더 메타데이터로 제공되지 않는 데이터만 포함됩니다. 폴더 메타데이터에 정의된 구성요소 속성은 appinfo.json 파일과 중복되지 않습니다.

로컬 구성요소:

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

인라인 프레임으로 렌더링된 로컬 구성요소:

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

원격 구성요소:

{
        "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": {}
        }
}

로컬 구성요소에는 등록된 "url" 값이 없습니다. 콘텐츠를 편집할 수 있는 특정 파일을 사용하지만 위치나 이름은 변경할 수 없습니다.

  • 로컬 구성요소는 assets/render.js 및 assets/settings.html 파일을 사용합니다.

  • 인라인 프레임으로 렌더링된 로컬 구성요소는 assets/render.html 및 assets/settings.html 파일을 사용합니다.

  • 원격 구성요소는 지정된 "url" 값을 사용합니다.