Oracle® WebCenter Content Site Studioテクニカル・リファレンス・ガイド

11gリリース1 (11.1.1)

B72417-01(原本部品番号:E10615-03)

目次

タイトルおよび著作権情報

はじめに

- 対象読者

- ドキュメントのアクセシビリティについて

- 関連ドキュメント

- 表記規則

1 概要

- 1.1 Site Studioテクニカル・リファレンスについて

- 1.2 テクニカル・リファレンスの範囲

2 サイト・アセットの関係とファイル構造

- 2.1 サイト・アセットについて

- 2.2 テンプレート

- 2.2.1 ページ・テンプレート

- 2.2.2 サブテンプレート

- 2.2.3 リージョン・テンプレート

- 2.3 定義

- 2.3.1 プレースホルダ定義

- 2.3.2 リージョン定義

- 2.3.3 要素定義

- 2.4 テンプレートと定義の関係

- 2.5 Webページの提供

- 2.6 変換定義

- 2.7 コントリビューション・モード

- 2.7.1 キー・コマンド

- 2.7.2 問合せ文字列

- 2.7.3 セッションCookie

- 2.7.4 消費モードからコントリビューション・モードへのプロセス

3 Site Studioメタデータ

- 3.1 メタデータについて

- 3.2 メタデータ・フィールド

- 3.2.1 xWebsiteObjectType

- 3.2.2 xWebsiteSection

- 3.2.3 xWebsites

- 3.2.4 xDontShowInListsForWebsites

- 3.2.5 xRegionDefinition

4 リンク形式

- 4.1 リンク形式について

- 4.2 パスベースのリンクの使用

- 4.3 サーバー側スクリプト・リンクの使用

- 4.3.1 wcmUrl

- 4.3.2 ssLink

- 4.3.3 ssNodeLink

- 4.3.4 ssWebLayoutUrl

- 4.4 トークン・リンクの使用

- 4.4.1 ssLINK

- 4.4.2 ssNODELINK

- 4.4.3 サーバー側リンクから生成されるトークン・リンク

- 4.5 JavaScriptリンクの使用

5 Site Studioランタイム生成ファイル

- 5.1 ランタイム生成ファイルについて

- 5.2 ランタイム自動生成ファイル

- 5.2.1 sitenavigation.js

- 5.2.2 sitenavigationfunctions.js

- 5.2.3 sitenavigation.xml

- 5.2.4 sitenavigation.hda

- 5.2.5 sitenavigation_co.hda

- 5.3 wcm.toggle.js

6 フラグメント

- 6.1 フラグメントについて

- 6.2 フラグメント・ライブラリ

- 6.3 読取り専用フラグメント・ライブラリ

- 6.4 wcmFragmentを使用したフラグメントのインクルード

- 6.5 フラグメント・スニペットとssIncludeXml()

- 6.6 カスタム・セクション・プロパティを使用するフラグメント

- 6.6.1 クライアント側JavaScript

- 6.6.2 サーバー側Idocスクリプト

- 6.7 フラグメント定義ファイル

- 6.7.1 <fragments>

- 6.7.2 <fragment>

- 6.7.3 <parameter>

- 6.7.3.1 <option>

- 6.7.3.2 <querytext>

- 6.7.3.3 <validate>

- 6.7.3.4 <convert>

- 6.7.3.5 <customgui>

- 6.7.4 <snippet>

- 6.7.5 <designview>

- 6.7.6 <element>

- 6.8 <ssinfo> XMLデータ・アイランドのフラグメント・インスタンスの構造

7 ネイティブ・ドキュメントと変換

- 7.1 ネイティブ・ドキュメントについて

- 7.2 wcmDynamicConversion

- 7.3 プロパティ・ペインでのドキュメントの変換

- 7.4 ネイティブ・ドキュメントの使用時の一般的なエラー

8 カスタム要素

- 8.1 カスタム要素について

- 8.2 要素API

- 8.2.1 要素APIのロード

- 8.2.2 要素API依存スクリプト

- 8.3 コントリビュータ内のカスタム要素

- 8.3.1 コントリビュータ・フォームからカスタム要素への通信

- 8.3.2 カスタム要素からコントリビュータ・フォームへの通信

- 8.4 レガシー・カスタム要素の互換性

- 8.4.1 レガシー・カスタム要素フォームの検出

- 8.4.2 レガシー・カスタム要素のアップグレード

9 Idocスクリプト拡張機能

- 9.1 Idocスクリプト拡張機能について

- 9.2 wcmPlaceholder

- 9.3 wcmElement

- 9.4 wcmListStart

- 9.5 wcmListEnd

- 9.6 wcmListElement

- 9.7 wcmListRowCount

- 9.8 wcmDynamicList

- 9.9 wcmIncludeElement

- 9.10 wcmDynamicConversion

- 9.11 wcmGetListAsResultSet

- 9.12 wcmFragment

- 9.13 wcmUrl

- 9.14 ssIncludeXml

- 9.15 ssGetDocInfo

- 9.16 ssGetXmlNodeCount

- 9.17 ssIncDynamicConversion

- 9.18 ssIncDynamicConversionByRule

- 9.19 ssIncDynamicConversionByRulesEngine

- 9.20 ssIncInlineDynamicConversion

- 9.21 ssIsNativeDoc

- 9.22 ssRandom

- 9.23 ssGetNodeProperty

- 9.24 ssGetWebsiteNodeType

- 9.25 ssGetCoreMajorVersion

- 9.26 ssSplitString

- 9.27 ssGetWebsiteName

- 9.28 ssGetSiteProperty

- 9.29 ssGetFirstNodeId

- 9.30 ssGetRelativeNodeId

- 9.31 ssLoadSiteNavResultSet

- 9.32 ssGetServerRelativeUrl

- 9.33 ssGetServerRelativePath

- 9.34 ssGetUrlPageName

- 9.35 ssGetNodeLabel

- 9.36 ssGetNodeLabelPath

- 9.37 ssGetAllSites

- 9.38 ssLink

- 9.39 ssNodeLink

- 9.40 ssWeblayoutUrl

10 Idocスクリプト変数

- 10.1 Idocスクリプト変数について

- 10.2 HttpWebsitesRoot

- 10.3 HttpRelativeWebsitesRoot

- 10.4 HttpFragmentsRoot

- 10.5 HttpRelativeFragmentsRoot

- 10.6 SS_SERVER_NAME

- 10.7 HttpASPPath

- 10.8 ssServerRelativeSiteRoot

11 Site Studioサービス

- 11.1 Site Studioサービスについて

- 11.2 コントリビュータに関連するサービス

- 11.3 デザイナに関連するサービス

- 11.4 マネージャに関連するサービス

- 11.5 コンテンツの切替えに関連するサービス

- 11.6 リンク・ウィザードに関連するサービス

- 11.7 サービスのリスト

- 11.7.1 SS_ADD_NODE

- 11.7.2 SS_ADD_WEBSITE_ID

- 11.7.3 SS_BATCH_DECODE_LINK

- 11.7.4 SS_CHECKIN_FRAGMENT_LIBRARY

- 11.7.5 SS_CHOOSE_WEBSITE_SECTION

- 11.7.6 SS_CHOOSE_WEBSITES

- 11.7.7 SS_CLEAR_PREVIEW

- 11.7.8 SS_CLEAR_REGION_ASSOCIATIONS

- 11.7.9 SS_CLEAR_WEBSITE_ID

- 11.7.10 SS_COMMIT_SITE_CHANGES

- 11.7.11 SS_CREATE_NEW_SITE_EX2

- 11.7.12 SS_CREATE_SITE_NAV_JS

- 11.7.13 SS_DECODE_LINK

- 11.7.14 SS_DELETE_NODE

- 11.7.15 SS_DOC_INFO_LATEST

- 11.7.16 SS_EDIT_NATIVE_DOCUMENT

- 11.7.17 SS_GET_ADMIN_PAGE

- 11.7.18 SS_GET_ALL_CUSTOM_NODE_PROP_DEFS

- 11.7.19 SS_GET_ALL_NODE_PROPERTIES

- 11.7.20 SS_GET_ALL_SITE_DOMAINS

- 11.7.21 SS_GET_ALL_SITE_PROPERTIES

- 11.7.22 SS_GET_ALL_SITES_EX2

- 11.7.23 SS_GET_CONFIG_INFO

- 11.7.24 SS_GET_CONTRIBUTOR_CONFIG

- 11.7.25 SS_GET_CONTRIBUTOR_STRINGS

- 11.7.26 SS_GET_DC_RULES

- 11.7.27 SS_GET_DOCUMENT_LABELS

- 11.7.28 SS_GET_DOCUMENT_USAGE

- 11.7.29 SS_GET_ENVIRONMENT_PROPERTY_NAMES

- 11.7.30 SS_GET_FIRST_NODE_ID

- 11.7.31 SS_GET_FRIENDLY_URL

- 11.7.32 SS_GET_LINK

- 11.7.33 SS_GET_LINK_MANAGEMENT_REPORT

- 11.7.34 SS_GET_LINK_WIZARD_CONFIG

- 11.7.35 SS_GET_LINK_WIZARD_CONFIG_WITH_SITE

- 11.7.36 SS_GET_NODE_LINK

- 11.7.37 SS_GET_NODE_PROPERTY

- 11.7.38 SS_GET_PAGE

- 11.7.39 SS_GET_PLACEHOLDER_SWITCH_CONTENT_CONFIG

- 11.7.40 SS_GET_REGION_ASSOCIATIONS

- 11.7.41 SS_GET_REGION_DEFINITION_ELEMENTS

- 11.7.42 SS_GET_RELATIVE_NODE_ID

- 11.7.43 SS_GET_SEARCH_RESULTS

- 11.7.44 SS_GET_SITE_AS_XML_EX2

- 11.7.45 SS_GET_SITE_ASSET_CATEGORIES

- 11.7.46 SS_GET_SITE_CHANGE_MONITOR_TOKEN

- 11.7.47 SS_GET_SITE_DEFINITION

- 11.7.48 SS_GET_SITE_DEFINITION_FOR_USER

- 11.7.49 SS_GET_SITE_DOMAINS

- 11.7.50 SS_GET_SITE_FRAGMENT_ASSET_REPORT

- 11.7.51 SS_GET_SITE_INFO

- 11.7.52 SS_GET_SITE_PROPERTY

- 11.7.53 SS_GET_SITE_PUBLISH_REPORT

- 11.7.54 SS_GET_SITE_REPORT

- 11.7.55 SS_GET_SWITCH_CONTENT_CONFIG

- 11.7.56 SS_GET_UNIQUE_NODE_SITE_ID

- 11.7.57 SS_GET_VERSION

- 11.7.58 SS_GET_WEBLAYOUT_URL

- 11.7.59 SS_IS_JS_NAV_OUT_OF_DATE

- 11.7.60 SS_MAP_FRIENDLY_NAME

- 11.7.61 SS_MOVE_NODE

- 11.7.62 SS_PARSE_FRIENDLY_URL

- 11.7.63 SS_PREPARE_PREVIEW

- 11.7.64 SS_PUBLISH_THIS_PAGE

- 11.7.65 SS_REMOVE_WEBSITE_ID

- 11.7.66 SS_SET_ALL_CUSTOM_NODE_PROP_DEFS

- 11.7.67 SS_SET_ELEMENT_DATA

- 11.7.68 SS_SET_ENVIRONMENT_PROPERTY_NAMES

- 11.7.69 SS_SET_NODE_PROPERTY

- 11.7.70 SS_SET_NODES_PROPERTIES

- 11.7.71 SS_SET_PREVIEW_ELEMENT_DATA

- 11.7.72 SS_SET_SITE_ASSET_CATEGORIES

- 11.7.73 SS_SET_SITE_DOMAINS

- 11.7.74 SS_SET_SITE_PROPERTIES

- 11.7.75 SS_SET_SITE_PROPERTY

- 11.7.76 SS_SWITCH_REGION_ASSOCIATION

- 11.7.77 SS_VALIDATE_WEBSITE_OBJECT

- 11.7.78 WCM_PLACEHOLDER

- 11.7.79 WCM_EDIT_DATA_FILE

- 11.7.80 WCM_BEGIN_EDIT_SESSION

12 Site Studio構成フラグ

- 12.1 Site Studioフラグについて

- 12.2 DisableSiteStudioContribution

- 12.3 ShowSiteStudioMissingDataFileErrors

- 12.4 SiteStudioValidateElementDefinitions

- 12.5 SiteStudioValidateRegionDefinitions

- 12.6 SiteStudioValidatePlaceholderDefinitions

- 12.7 SiteStudioValidateConversionsDefinitions

- 12.8 SiteStudioValidateDataFiles

- 12.9 SiteStudioValidateProjects

- 12.10 SSAccessDeniedHeader

- 12.11 SSAccessDeniedReplacementHeader

- 12.12 SSAccessDeniedUserAgentExceptions

- 12.13 SSAccommodateWelcomeFile

- 12.14 SSAdditionalNavResultSetFields

- 12.15 SSAddSecurityIDValues

- 12.16 SSAfterProjectLoadedProperties

- 12.17 SSAllowDynamicDefinitions

- 12.18 SSAllowEmptyUrlPageName

- 12.19 SSAllowNotModifiedHeader

- 12.20 SSAltTagFieldName

- 12.21 SSAlwaysRecordServerConfig

- 12.22 SSAlwaysUseSiteIdInLinks

- 12.23 SSAssumeXmlIsUtf8

- 12.24 SSAutoCheckinBusyTimeout

- 12.25 SSBackupCollectionName

- 12.26 SSCacheControlOverride

- 12.27 SSCanGenerateUniqueDataFiles

- 12.28 SSChangeAccessDeniedHeaders

- 12.29 SSCheckAssignedContentAccess

- 12.30 SSCheckBrowserForSiteRoot

- 12.31 SSCheckNodeIdUniqueness

- 12.32 SSCheckWebsiteObjectSecurity

- 12.33 SSClearDefinitionArchiveWebsites

- 12.34 SSCompressorArguments

- 12.35 SSCompressorCommand

- 12.36 SSCompressorDir

- 12.37 SSCompressorJar

- 12.38 SSCompressorMainClass

- 12.39 SSCompressorTimeout

- 12.40 SSCompressorTimerInterval

- 12.41 SSCompressorWaitForever

- 12.42 SSContributorSourceDir

- 12.43 SSCustomNodePropertyDefsPermissions

- 12.44 SSDefaultDocumentsFields

- 12.45 SSDefaultEditor

- 12.46 SSDefaultExternalDocNamePrefix

- 12.47 SSDefaultExternalDocNameSuffix

- 12.48 SSDefaultExternalServerRelativeSiteRoot

- 12.49 SSDefaultExternalUrlPrefix

- 12.50 SSDefaultExternalUrlSuffix

- 12.51 SSDefaultPlaceholderDefinition

- 12.52 SSDefaultRegionTemplate

- 12.53 SSDefaultUrlPageName

- 12.54 SSDetectIncludeFileEncoding

- 12.55 SSDICPlaceholderDefinition

- 12.56 SSDirectDeliveryExtensions

- 12.57 SSDirectDeliveryOverrideProperty

- 12.58 SSDirectDeliveryProperty

- 12.59 SSDirectDeliveryRequiredExtensions

- 12.60 SSDisableDeferredNodeExpansion

- 12.61 SSDisableIncludeXmlCache

- 12.62 SSDisableLinkResolutionSiteLocking

- 12.63 SSDisableProjectDeferredNodeExpansion

- 12.64 SSDomCacheDefaultFileSizeFactor

- 12.65 SSDomCacheFileSizeFactors

- 12.66 SSDomCacheLowerBound

- 12.67 SSDomCacheMultiplier

- 12.68 SSDomCacheNodeMultiplier

- 12.69 SSDomCacheStringMultiplier

- 12.70 SSDomCacheStringOverhead

- 12.71 SSDomCacheUseDOM

- 12.72 SSDomCacheUseFileSize

- 12.73 SSEditorDebugLevel

- 12.74 SSEnableASPSupport

- 12.75 SSEnableDirectDelivery

- 12.76 SSEnableExtranetLookCompatibility

- 12.77 SSEnableFolioEditing

- 12.78 SSEnableFormEditing

- 12.79 SSEnableJavaScriptCompressor

- 12.80 SSEnableUpperCaseColumnsCheck

- 12.81 SSGenerateUniqueNodeIds

- 12.82 SSHidePrimaryFileInContributor

- 12.83 SSHttpAbsoluteHelpRoot

- 12.84 SSHttpLayerManager

- 12.85 SSIdocMarker

- 12.86 SSIgnoreMaxAgeNodeProperties

- 12.87 SSIgnoreNoProjectDefaultMetadataMessage

- 12.88 SSIgnoreReadyToReplicate

- 12.89 SSImportOnlyLatestRevs

- 12.90 SSIncludeInactiveNodesInNavResultSet

- 12.91 SSIncludeInactiveNodesInNavXML

- 12.92 SSIncludeRegionTemplatesInDefinitionBundles

- 12.93 SSIncludeXmlTransformFormat

- 12.94 SSIncludeXmlTransformIndent

- 12.95 SSJavaExecutablePath

- 12.96 SSJSONContentType

- 12.97 SSLoadCustomElementsWithOnDemandEditors

- 12.98 SSLoadProjectsAtStartup

- 12.99 SSLoadUncompressedFckSource

- 12.100 SSManuallyValidateNodeIdUniqueness

- 12.101 SSMaxNodeIdLength

- 12.102 SSMaxSiteIdLength

- 12.103 SSMaxSitesMenuItems

- 12.104 SSMaxTemplateEvaluationStack

- 12.105 SSMigrationCollectionName

- 12.106 SSOmitFragmentLibrariesInArchiverQueries

- 12.107 SSOnDemandEditorsThresholdCount

- 12.108 SSPrefillUrlDirNamesDuringUpgrade

- 12.109 SSProjectAutoCheckinInterval

- 12.110 SSProjectLoadFailureTracingSection

- 12.111 SSProjectReleaseSleepTime

- 12.112 SSProjectReleaseWaitTime

- 12.113 SSQuickDiffDefaultRegionTemplate

- 12.114 SSShowAssignmentTooltips

- 12.115 SSSQLUseContains

- 12.116 SSStoppedSiteResponsePageDocName

- 12.117 SSSuppressAddToWebsite

- 12.118 SSSuppressLargeCssOptimization

- 12.119 SSTempProjectLifetime

- 12.120 SSTitleTagFieldName

- 12.121 SSTrackContentAccess

- 12.122 SSTrackFragmentAccess

- 12.123 SSUrlFieldName

- 12.124 SSUrlFixupExceptions

- 12.125 SSUrlPageNames

- 12.126 SSUseAbsoluteRedirects

- 12.127 SSUseCallbackTrackingForASP

- 12.128 SSUseDefaultDocNamePrefix

- 12.129 SSUseDefaultServerRelativeSiteRoot

- 12.130 SSUseDefaultUrlPrefix

- 12.131 SSUseMissingLinkTargetFallback

- 12.132 SSUseOnDemandContributionModeMenus

- 12.133 SSUseUrlSegmentSessionInfo

- 12.134 SSValidateCustomElements

- 12.135 SSWebFilterIgnoreList

- 12.136 SSWeblayoutUrlUsesDocNames

- 12.137 SSWelcomeFile

- 12.138 SSWelcomeFileReplacement

13 Site Studioパフォーマンス・チューニング

- 13.1 Site Studioのパフォーマンスについて

- 13.2 オンデマンドWebサイト管理

- 13.3 オンデマンド・コントリビュータ・エディタ

- 13.3.1 構成フラグについて

- 13.3.2 オンデマンド・エディタに使用される構成フラグ

- 13.3.2.1 SSOnDemandEditorsThresholdCount

- 13.4 コントリビュータ・コードの最適化

- 13.4.1 最適化の要件

- 13.4.2 ビルド・プロセス

- 13.4.3 最適化されたコードのビルド

- 13.4.4 ビルド・スクリプトのデバッグ

- 13.4.5 最適化されたコードを使用するためのSite Studioの構成

- 13.4.6 カスタマイズとビルド・プロセス

- 13.5 メモリー使用量

- 13.5.1 XML DOMのメモリー・サイズ用のフラグ

- 13.5.2 DOC_INFOキャッシュ内のアイテムのサイズ用のフラグ

- 13.5.3 SSXPathCacheEntryキャッシュを制御するためのフラグ

14 JSONとコントリビュータ

- 14.1 JSONについて

- 14.2 コントリビュータとの間の構成の受渡し

15 コントリビュータ・コンソール・ウィンドウ

- 15.1 コントリビュータ・コンソール・ウィンドウについて

- 15.1.1 ロギング・ウィンドウ

- 15.1.2 コマンド・ウィンドウ

- 15.1.3 コントリビュータ・コンソール・ウィンドウ・ユーザー・インタフェース

- 15.2 コントリビュータ・コンソール・ウィンドウのインストール

- 15.3 コントリビュータ・コンソール・ウィンドウの起動

- 15.4 コントリビュータ・コンソール・ウィンドウの使用

- 15.4.1 コントリビュータ・コンソール・ウィンドウ・コンテキスト

- 15.4.2 コントリビュータ・コンソール・ウィンドウがルートであることの確認

- 15.4.3 コントリビュータ・コンソール・ウィンドウの実際的な使用

- 15.4.4 孤立したコンソール・ウィンドウ

- 15.5 ロギング構文

- 15.6 時間プロファイリング

- 15.7 コマンド・ウィンドウ・ヘルパー関数

- 15.8 キーボード・コマンド

16 マネージャ設定ファイル

- 16.1 マネージャ設定ファイルについて

- 16.2 <ssm:settings>タグ

- 16.3 <ssm:general>タグ

- 16.4 <ssm:addSection>タグ

- 16.5 <ssm:removeSection>タグ

- 16.6 <ssm:moveSection>タグ

- 16.7 <ssm:setErrorHandler>タグ

- 16.8 <ssm:editProperties>タグ

- 16.9 <ssm:editCustomProperties>タグ

- 16.10 <ssm:primaryLayout>タグ

- 16.11 <ssm:secondaryLayout>タグ

- 16.12 <ssm:sectionOverride>タグ

- 16.13 マネージャ設定ファイルの例

17 Content Tracker統合

- 17.1 追跡対象データ

- 17.2 構成フラグ

A Site Studio 11gR1と組み合せて使用するためのOracle Content Server 10gR3の構成

- A.1 Oracle Content Server 10gR3でのSite Studio 11gR1のインストール

- A.2 コンポーネントのダウンロード

- A.3 Site Studio Designer 11gR1の入手

- A.4 デフォルト・プロジェクト・ドキュメント情報の設定

- A.5 Apache Webサーバーの構成

- A.6 Sun ONE Webサーバーの構成

- A.7 ゾーン・フィールドの構成

- A.8 コンテンツ・サーバーでのJavaServer Pagesの有効化

B 7.5より前のWebサイトのアップグレード

- B.1 概要

- B.2 自動アップグレードでの処理

- B.3 コンテンツ・サーバーのアップグレード

- B.3.1 単一コンテンツ・サーバー・インスタンスでのサイトのアップグレード

- B.3.2 複数コンテンツ・サーバー・インスタンスでのサイトのアップグレード

- B.3.3 完全アップグレードの実行

- B.3.4 最小アップグレードの実行

- B.4 追加処理の手動実行

- B.4.1 サイト・ナビゲーションの更新

- B.4.2 コンテンツ・サーバー索引の再作成

- B.4.3 カスタム・フラグメントの更新

- B.4.3.1 <base>タグに依存するリンクの変更

- B.4.3.2 古いSS_GET_PAGE / JavaScriptリンクの変更

- B.4.3.3 GET_SEARCH_RESULTSの更新

- B.4.4 カスタム要素の更新

- B.4.5 フォルダへのWebサイト・セクションの割当て

- B.4.6 JSPコードの更新

索引

Oracle® WebCenter Content

Site Studioテクニカル・リファレンス・ガイド

11gリリース1 (11.1.1)

B72417-01(原本部品番号:E10615-03)

2011年11月

Oracle WebCenter Content Site Studioテクニカル・リファレンス・ガイド, 11gリリース1 (11.1.1)

B72417-01

Copyright © 1996, 2011, Oracle and/or its affiliates.All rights reserved.

原本著者: Sean Cearley

原本協力者: David Peterson、Brian Cheyne

このソフトウェアおよび関連ドキュメントの使用と開示は、ライセンス契約の制約条件に従うものとし、知的財産に関する法律により保護されています。ライセンス契約で明示的に許諾されている場合もしくは法律によって認められている場合を除き、形式、手段に関係なく、いかなる部分も使用、複写、複製、翻訳、放送、修正、ライセンス供与、送信、配布、発表、実行、公開または表示することはできません。このソフトウェアのリバース・エンジニアリング、逆アセンブル、逆コンパイルは互換性のために法律によって規定されている場合を除き、禁止されています。

ここに記載された情報は予告なしに変更される場合があります。また、誤りが無いことの保証はいたしかねます。誤りを見つけた場合は、オラクル社までご連絡ください。

このソフトウェアまたは関連ドキュメントを、米国政府機関もしくは米国政府機関に代わってこのソフトウェアまたは関連ドキュメントをライセンスされた者に提供する場合は、次の通知が適用されます。

U.S. GOVERNMENT RIGHTS Programs, software, databases, and related documentation and technical data delivered to U.S. Government customers are "commercial computer software" or "commercial technical data" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations.As such, the use, duplication, disclosure, modification, and adaptation shall be subject to the restrictions and license terms set forth in the applicable Government contract, and, to the extent applicable by the terms of the Government contract, the additional rights set forth in FAR 52.227-19, Commercial Computer Software License (December 2007).Oracle USA, Inc., 500 Oracle Parkway, Redwood City, CA 94065.

このソフトウェアもしくはハードウェアは様々な情報管理アプリケーションでの一般的な使用のために開発されたものです。このソフトウェアもしくはハードウェアは、危険が伴うアプリケーション(人的傷害を発生させる可能性があるアプリケーションを含む)への用途を目的として開発されていません。このソフトウェアもしくはハードウェアを危険が伴うアプリケーションで使用する際、安全に使用するために、適切な安全装置、バックアップ、冗長性(redundancy)、その他の対策を講じることは使用者の責任となります。このソフトウェアもしくはハードウェアを危険が伴うアプリケーションで使用したことに起因して損害が発生しても、オラクル社およびその関連会社は一切の責任を負いかねます。

OracleはOracle Corporationおよびその関連企業の登録商標です。その他の名称は、他社の商標の可能性があります。

このソフトウェアおよびドキュメントは、第三者のコンテンツ、製品、サービスへのアクセス、あるいはそれらに関する情報を提供することがあります。オラクル社およびその関連会社は、第三者のコンテンツ、製品、サービスに関して一切の責任を負わず、いかなる保証もいたしません。オラクル社およびその関連会社は、第三者のコンテンツ、製品、サービスへのアクセスまたは使用によって損失、費用、あるいは損害が発生しても一切の責任を負いかねます。

はじめに

『Oracle WebCenter Content Site Studioテクニカル・リファレンス・ガイド』には、Site Studioで管理されるWebサイトの実装を担当する開発者および管理者に役立つ情報が含まれます。

対象読者

このドキュメントは、Oracle Site Studioで管理されるWebサイトの開発およびデプロイを組織内で担当するユーザーを対象としています。

ドキュメントのアクセシビリティについて

Oracleのアクセシビリティについての詳細情報は、Oracle Accessibility ProgramのWebサイトhttp://www.oracle.com/pls/topic/lookup?ctx=acc&id=docaccを参照してください。

Oracleサポートへのアクセス

Oracleのお客様は、My Oracle Supportにアクセスして電子サポートを受けることができます。詳細情報はhttp://www.oracle.com/pls/topic/lookup?ctx=acc&id=infoか、聴覚に障害のあるお客様はhttp://www.oracle.com/pls/topic/lookup?ctx=acc&id=trsを参照してください。

関連ドキュメント

詳細は、Oracle Site Studioドキュメント・セットの次のドキュメントを参照してください。

- 『Oracle WebCenter Content Site Studio Contributorユーザーズ・ガイド』

- 『Oracle WebCenter Content Site Studio Designerユーザーズ・ガイド』

- Oracle WebCenter Content Site Studio Publisherユーザーズ・ガイド

- 『Oracle WebCenter Content Site Studio管理者およびマネージャーズ・ガイド』

表記規則

このマニュアルでは次の表記規則を使用します。

規則

意味

太字

太字は、操作に関連するGraphical User Interface要素、または本文中で定義されている用語および用語集に記載されている用語を示します。

イタリック体

イタリックは、ユーザーが特定の値を指定するプレースホルダ変数を示します。

固定幅フォント

固定幅フォントは、段落内のコマンド、URL、サンプル内のコード、画面に表示されるテキスト、または入力するテキストを示します。

1 概要

このガイドの構成は次のとおりです。

- 1.1項「Site Studioテクニカル・リファレンスについて」

- 1.2項「テクニカル・リファレンスの範囲」

1.1 Site Studioテクニカル・リファレンスについて

このガイドでは、Site Studioの広範な技術的概要と、Site Studioを使用したWebサイトの作成方法について説明します。また、Site Studioで使用されるプロジェクト・ファイル、マーカー、タグ、サービス・コール、およびIdocスクリプトの拡張機能に関する技術情報も提供します。このガイドを最大限活用するには、HTML、JavaScript、サーバー側Idocスクリプトの知識があること、組織においてWebマスターまたはWeb開発者の役割を果していること、およびコーディングの経験があることが必要です。

ガイドを読む前に、『Oracle WebCenter Content Site Studio Designerユーザーズ・ガイド』および『Oracle WebCenter Content Site Studio Contributorユーザーズ・ガイド』を読んでください。また、Site Studioを使用して1つ以上のWebサイトを作成している必要もあります。このガイドでは、既存のフレームワークに基づいてWebサイトを構築し、独自のニーズに応じて製品をカスタマイズできるように、Site Studioで使用されるスクリプト構文について具体的に説明します。

1.2 テクニカル・リファレンスの範囲

Site Studioテクニカル・リファレンス・ガイドでは、Site Studioの機能のカスタマイズ方法を含め、Oracle Site Studio 11gR1を使用したサイトの構築、保守および消費の技術的な面について説明します。Site Studio 11gR1では、10gR3以前のSite Studioで作成されたWebサイトをサポートしますが、そのようなWebサイトはレガシーWebサイトとみなされます。レガシー・サイトの技術情報については、Site Studio 10gR3のテクニカル・リファレンス・ガイドを参照してください。

2 サイト・アセットの関係とファイル構造

この項の内容は次のとおりです。

- 2.1項「サイト・アセットについて」

- 2.2項「テンプレート」

- 2.3項「定義」

- 2.4項「テンプレートと定義の関係」

- 2.5項「Webページの提供」

- 2.6項「変換定義」

- 2.7項「コントリビューション・モード」

2.1 サイト・アセットについて

Site Studioのサイト・アセットは、コンテンツをプレゼンテーションとは別に簡単に保守する、モジュール方式でカスタマイズ可能な方法を提供します。サイト内の個々のアセットに変更を加える場合、テンプレートと定義の関係(多くの異なるページでの両者の関係など)を知る必要がある場合があります。

サイト・アセットは、サイトの視覚的プレゼンテーションとWebページの実際のコンテンツ(情報)を直接制御するために使用されます。この方法では、コンテンツとプレゼンテーションは別個で、相互に影響を与えることなく保守や変更を行うことが可能です。

Webサイトの構造とプレゼンテーションを保守するファイルはテンプレート(ページ・テンプレート、サブテンプレートおよびリージョン・テンプレート)です。カスケーディング・スタイル・シートも構造とプレゼンテーションの制御に使用でき、Site Studioで管理できます。コンテンツを保守するファイルは定義(プレースホルダ定義、リージョン定義および要素定義)です。これらの定義を使用して、コンテンツの保守方法を制御します。

コンテンツ自体はコンテンツ・ファイル(コントリビュータ・データ・ファイル、ネイティブ・ドキュメント、イメージおよびサイトで使用するFlashなどの他の関連メディア)に格納されます。コントリビュータ・データ・ファイルは、Site Studioによって生成されるXML形式のファイルです。コントリビュータ・データ・ファイルは、Site Studio Contributorアプリケーションを使用して編集します。ネイティブ・ドキュメントは、Microsoft Wordなどの使い慣れたサードパーティ・アプリケーションを使用して作成します。ネイティブ・ドキュメントは、Dynamic Converterを使用してHTML形式に変換し、対応するアプリケーションを使用して編集します。コンテンツの責任を負うのはコントリビュータであるため、コントリビュータ・データ・ファイルはコントリビュータを使用して編集されます。ネイティブ・ドキュメントと他のファイルは、対応するサードパーティ・ソフトウェア(Microsoft Word、Adobe Photoshopなど)を使用して編集し、コントリビュータでサイトに追加できます。コントリビュータで追加されたファイルは、設計者または管理者が簡単に制御できます。

また、サイトを想定どおりに機能させるために使用される制御ファイルおよび構成ファイルがいくつかあります。これらの制御ファイルについては、このガイドの他の章で説明します。

2.2 テンプレート

テンプレートは、使用可能なサイト・アセットの配置に使用されます。すべて、関連付けられたコンテンツを表すタグが含まれたHTMLの1部分(ページ・テンプレートの場合は完全なHTMLページ)です。

使用されるテンプレートは、次の3種類です。

- 2.2.1項「ページ・テンプレート」

- 2.2.2項「サブテンプレート」

- 2.2.3項「リージョン・テンプレート」

テンプレートによって、データを特定の状態に配置できます。定義によって、テンプレートに配置可能なサイト・アセットとアセットの表示方法を定義します。

2.2.1 ページ・テンプレート

ページ・テンプレートは、完全なHTMLページである唯一のテンプレートです。一般的には、Site Studioの最善の使用方法は、アセットを最大限再利用することです。ページ・テンプレートを他のテンプレートのフレームワークとし、サブテンプレートとリージョン・テンプレートを使用してコンテンツを特定の配置にします。さらに、ページ・テンプレートとサブテンプレートで、コントリビューション・リージョンの配置を定義します。

階層の各セクションに、そのノードのプライマリ・ページとしてページ・テンプレートを割り当てることができます(通常そのようにします)。サイト階層のルート・セクションには、Webサイトのホーム・ページが配置されます。階層内の他のセクション同様、セクション・プロパティのプライマリ・ページ・エントリとセカンダリ・ページ・エントリには、ルートを含む、各セクションのプライマリ・ページとセカンダリ・ページに使用されるページ・テンプレートが表示されます。

ページ・テンプレートをセクションのプライマリ・ページまたはセカンダリ・ページに関連付けるデータはプロジェクト・ページに格納されます。プライマリ・ページとセカンダリ・ページの割当てはプロパティ・ペインで行います。

ページ・テンプレートのプレースホルダは、最終的にはwcmPlaceholderスクリプト拡張機能を使用して配置されます。プレースホルダ自体はサイト・アセットではありません。プレースホルダは単にページ・テンプレートまたはサブテンプレート上に定義された領域で、プレースホルダ定義を使用して特定のプレースホルダでのコンテンツの再利用方法を決めることができます。

2.2.2 サブテンプレート

サブテンプレートは、単に<HEAD>セクションのないページ・テンプレートです。コントリビューション・リージョンを含むことができ、主にページ・テンプレートの1つのコントリビューション・リージョンを複数に分割するために使用されます。

サブテンプレートでのタグの挿入は、ページ・テンプレートの場合と同様です。ただし、サブテンプレートでの<HEAD>タグへの参照のインスタンスは予期しない結果となります。これは、複数のスニペットを持ち、その1つがヘッドを参照するフラグメントをサブテンプレートで使用する場合によく起こります。

2.2.3 リージョン・テンプレート

リージョン・テンプレートは、要素とこれに関連付けられているコンテンツの表示場所の定義に役立ちます。リージョン・テンプレートは、使用されるリージョン定義に基づいて選択されます。

リージョン・テンプレートは、コンシューマ・ページに表示される要素の配置に使用されます。使用できる要素は、リージョン定義によって定義されます。使用可能なすべての要素を使用する必要があるわけではありません。これによって、同じ名前の要素定義に対して複数のレイアウトを持つリージョン・テンプレートを作成できます。名前が同じ要素定義を異なるデータ・ファイルに使用することで、サイト・アセットを簡単に再利用できます。

2.3 定義

定義は、使用可能なアセットとその使用方法の定義に使用されます。

この項の内容は次のとおりです。

- 2.3.1項「プレースホルダ定義」

- 2.3.2項「リージョン定義」

- 2.3.3項「要素定義」

2.3.1 プレースホルダ定義

プレースホルダ定義は、コントリビュータがデータを変更できるか、メタデータを変更できるか、関連付けられているデータ・ファイルは切替えや削除が可能かなどのコントリビューション・リージョン内で有効なアクションを制御します。

プレースホルダ定義は、コード(タグ)、セクション・プロパティまたはグローバル・マッピング・プロパティで、あるいはデフォルト・プレースホルダとしてプレースホルダに関連付けられます。プレースホルダ定義とプレースホルダの関連付けが複数リストされている場合、優先度で決定されます。つまり、コードでの関連付けは、セクション・プロパティより優先され、セクション・プロパティはグローバル・マッピング・プロパティより優先されます。グローバル・マッピング・プロパティは、デフォルト・プレースホルダより優先されます。

サンプル・コード

<complexProperty name="flags">は、プレースホルダ定義が使用される場合に有効な(および無効な)アクションの集まりです。

<mappings>タグには、有効なリージョン定義(<regionDefinition>タグを使用)とこれに関連付けられているテンプレート(<regionTemplate>を使用)がリストされます。また、特定のリージョン定義のデフォルト・リージョン・テンプレートは、<regionTemplate>タグ内にコーディングされます。同様に、使用可能なサブテンプレート(これがある場合)は、<subTemplates>タグ下にリストされます。

これらはデザイナのUI(「プレースホルダ定義」ダイアログ」)で処理します。定義のソース・コードは、デザイナで「ソース」タブを選択すると表示できます。

<?xml version="1.0" encoding="UTF-8"?>
<placeholderDefinition
xmlns="http://www.oracle.com/sitestudio/PlaceholderDefinition/"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.oracle.com/sitestudio/PlaceholderDefinition/
http://www.oracle.com/sitestudio/ss_placeholder_definition.xsd">
<property name="description" value="Default placeholder definition" />
<complexProperty name="flags">
<property name="update" value="true" />
<property name="preview" value="true" />
<property name="reset" value="true" />
<property name="modifyMetadata" value="true" />
<property name="approve" value="true" />
<property name="reject" value="true" />
<property name="docInfo" value="true" />
<property name="switchDataFile" value="true" />
<property name="viewUsageReport" value="true" />
<property name="viewTrackerReport" value="true" />
<property name="docInfoUpdate" value="true" />
<property name="switchRegionTemplate" value="true" />
<property name="removeAssociation" value="false" />
</complexProperty>
<mappings>
<regionDefinition location="regiondefinition_recipe">
<regionTemplate location="regiontemplate_recipe" default="true" />
</regionDefinition>
<regionDefinition location="regiondef_nativedoc">
<regionTemplate location="regiontemplate_nativedocument" default="true" />
<regionTemplate location="regiontemplate_recipe" />
</regionDefinition>
<regionDefinition location="regiondefinition_basic">
<regionTemplate location="regiontemplate_default" default="true" />
</regionDefinition>
</mappings>
<subTemplates>
<subTemplate location="subtemplate_right_left" />
<subTemplate location="subtemplate_new_basic" />
</subTemplates>
</placeholderDefinition>

各プレースホルダ定義でリージョン・テンプレートとリージョン定義が関連付けられ、さらに、プレースホルダ定義の範囲内でそのリージョン定義のデフォルト・テンプレートがどのリージョン・テンプレートかがマークされることが、XMLからわかります。異なるプレースホルダ定義を使用すると、当然異なる関連付けが行われます。

2.3.2 リージョン定義

リージョン定義は、プレースホルダを介したコンテンツ(コントリビュータ・データ・ファイル、ネイティブ・ドキュメントなどの任意のコンテンツ)と適切なリージョン・テンプレートとのマッピングに使用されます。

インスタンスで使用されるリージョン定義は、2つの方法のいずれかで定義できます。1つ目として、リージョン定義は、ページ・テンプレートまたはサブテンプレート内に記述される場合、wcmPlaceholderタグで明示的にコールできます。

より一般的には、リージョン定義は、プレースホルダに使用されるデータ・ファイルのメタデータ・フィールドxRegionDefinitionの値に基づいてロードされます。

サンプル・コード

この例は、5つの要素定義が参照されるリージョン定義です。各<elementReference>タグには、ラベルの値(リージョンを編集用に開いたときにコントリビュータに表示される)および説明の値(コントリビュータがラベルにマウスオーバーしたときに表示されるツールチップ・テキスト)を定義する<property>タグがあります。コントリビュータの詳細は、『Oracle WebCenter Content Site Studio Contributorユーザーズ・ガイド』を参照してください。

<dataProperty name="metadata">タグは、メタデータの変更の有効化の例外の場所です。これは、デザイナのUI(「メタデータ変更の有効化」ダイアログ)で行います(『Oracle WebCenter Content Site Studio Designerユーザーズ・ガイド』を参照)。

<complexproperty name="switchregioncontent">タグは、コントリビュータが「リージョン・コンテンツの切替え」ダイアログを使用してアクセス可能なコンテンツの場所です。これは、デザイナのUI(「リージョン・コンテンツ・オプション」ダイアログ)で行います(『Oracle WebCenter Content Site Studio Designerユーザーズ・ガイド』を参照)。

<?xml version="1.0" encoding="UTF-8"?>
<regionDefinition xmlns="http://www.oracle.com/sitestudio/Element/"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.oracle.com/sitestudio/Element/
http://www.oracle.com/sitestudio/ss_element_definition.xsd">
<elements>
<elementReference name="Title_textonly" location="element_plaintext_full">
<property name="label" value="Title_textonly" />
<property name="description" value="Title of recipe, using text only
element" />
</elementReference>
<elementReference name="Image" location="element_image_min">
<property name="label" value="Recipe_image" />
<property name="description" value="Image associated with the recipe" />
</elementReference>
<elementReference name="Ingredients" location="element_wysiwyg_full">
<property name="label" value="Ingredients" />
<property name="description" value="" />
</elementReference>
<elementReference name="Directions" location="element_plaintext_full">
<property name="label" value="Directions" />
<property name="description" value="" />
</elementReference>
<elementReference name="DynamicList" location="element_dynlist_full">
<property name="label" value="Dynamic List" />
<property name="description" value="Dynamic List for toolbar purposes" />
</elementReference>
<elementReference name="StatList" location="element_staticlist_full">
<property name="label" value="Statlist" />
<property name="description" value="Static List for the toolbar" />
</elementReference>
</elements>
<property name="description" value="Recipe Region" />
<dataProperty name="metadata">
<![CDATA[]]>
</dataProperty>
<complexProperty name="switchregioncontent">    <property name="createnewxml" value="true" />    <property name="createnewnative" value="true" />    <property name="choosemanaged" value="true" />    <property name="chooselocal" value="true" />    <property name="choosenone" value="false" />    <valueList name="createnewnativedoctypes">      <value>.pptx</value>      <value>.psd</value>      </valueList>
<complexProperty name="choosemanagedquerytext">
<property name="corecontentonly" value="false" />
<dataProperty name="querytext">
<![CDATA[xWebsiteObjectType <Matches> `Data File` <OR>
xWebsiteObjectType <Matches> `Native Document`]]>
</dataProperty>
</complexProperty>
<dataProperty name="defaultmetadata">
<![CDATA[]]>
</dataProperty>
</complexProperty>
</regionDefinition>

2.3.3 要素定義

各要素定義は、他のサイト・アセット同様単純なXMLファイルです。

静的リスト要素定義ファイルでは、静的リスト内に使用される各要素定義がリストされるため、XMLにより多くのコードが含まれます。

カスタム要素は、単にHTMLの個別のフォームをロードするのみのため、他の要素定義より複雑ということはありません。

サンプル・コード

要素定義のコードは、要素のタイプに応じて大きく異なります。すべての要素に<complexProperty name="flags">セクションが含まれ、フラグとその状態が示されます。要素定義を介して要素で使用されるフラグは、要素によって異なります。

要素定義のコードはバリエーションが広いため、ここではコードを示しません。コードの違いを確認するには、デザイナで要素定義を開きます。

2.4 テンプレートと定義の関係

この項では、ページ・レイアウトと再利用性を制御するためのテンプレートと定義の相互作用について技術的に説明します。

すべてのデータはリージョン定義でタグ付けされる必要があります。それが、適切な定義とテンプレートの組合せによって配置される方法です。

2.5 Webページの提供

各アセットは個々に格納されているため、クライアントに提供する前にサーバーで組み合せてページにします。作成に使用されるアセットは、前述のとおり、アセット同士の参照に基づいて選択されます。

リクエストがあった後のページの作成での一般的なイベントのプロセスは、次のとおりです。

1. リクエストされたURLに基づいて、ページ・テンプレートがロードされます。
特定のページのリクエストで、そのページに関連付けられているページ・テンプレートがロードされます。フォルダまたはルートのリクエストで、プロジェクト・ファイルで指定されたページ・テンプレートがロードされます。そのテンプレートの名前は、デザイナのプロパティ・ペインで編集できます。

2. プレースホルダにリストされていないすべてのアセットがロードされます。

3. プレースホルダ以外のアセットがロードされる際、Idocスクリプトが実行されてプレースホルダに埋め込まれ、プレースホルダ定義の評価が開始されます。ページの特定のプレースホルダ定義が次の順にロードされます。

- wcmPlaceholderタグに明示的に指定されたプレースホルダ定義。

- タグにプレースホルダ定義が特にリストされていない場合、URLに基づいたセクション・プロパティにリストされた定義が使用されます。

- セクション・プロパティにプレースホルダ定義がリストされていない場合、グローバル定義マッピングに使用されている定義が使用されます。

- グローバル定義マッピングにリストされたプレースホルダ定義がない場合、プロパティ・ペインのWebサイト・プロパティにリストされたプレースホルダが使用されます。

4. 使用されるデータ・ファイルは、セクション・プロパティの「プライマリ・ページ・パラメータ(またはセカンダリ・ページ・パラメータ)」にリストされた値に基づきます。例外は、使用されるデータ・ファイルがwcmPlaceholderタグに明示的にリストされている場合です。

5. データ・ファイルのxRegionDefinitionメタデータ・フィールドには、使用されるリージョン定義がリストされます。繰返しになりますが、これは、リージョン定義がwcmPlaceholderタグに明示的にリストされていない場合です。

6. wcmPlaceholderタグに別のリージョン・テンプレートが指定されていないかぎり、使用されるリージョン・テンプレートおよび要素定義は、リージョン定義の設定から決定されます。

7. すべての要素が収集された後、ページが編成されて提供されます。

wcmPlaceholderの使用の詳細は、9.2項「wcmPlaceholder」を参照してください。

2.6 変換定義

テンプレートや定義などの変換定義は、変換ルールの参照に使用される単純なXMLファイルです。

デフォルトのルールを使用した変換定義に使用されるXMLの例を次に示します。

<?xml version="1.0" encoding="UTF-8"?>
<conversionsDefinition
xmlns="http://www.oracle.com/sitestudio/ConversionsDefinition/"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.oracle.com/sitestudio/ConversionsDefinition/
http://www.oracle.com/sitestudio/ss_conversions_definition.xsd">

<conversion name="default" type="simple" key="s~"/>
</conversionsDefinition>

2.7 コントリビューション・モード

コントリビューション・モードは、コントリビュータがページを編集用に開いている場合のページの状態です。その他の場合、ページは消費モードにあるとみなされます。

この項の内容は次のとおりです。

- 2.7.1項「キー・コマンド」

- 2.7.2項「問合せ文字列」

- 2.7.3項「セッションCookie」

- 2.7.4項「消費モードからコントリビューション・モードへのプロセス」

2.7.1 キー・コマンド

キー・コマンドは、コントリビュータ・モードへの移行に使用されるキーストロークの組合せです。これは、JavaScriptファイルwcm.toggle.jsで設定されます。詳細は、5.3項「wcm.toggle.js」を参照してください。

2.7.2 問合せ文字列

問合せ文字列内でwcm.contributor.modeを設定すると、設定に応じてコントリビュータ・モードまたは消費モードが有効になります。これは、次の例に示すようにURLで行うのが最も一般的です。

http://www.example.com?wcm.contributor.mode=true

trueに設定すると、コントリビュータ・モードが有効になります。falseに設定すると、消費モードが有効になります。

2.7.3 セッションCookie

同じドメイン内の移動時にコントリビュータ・モードの設定を保持するには、セッションCookieを設定します。Cookieは、キー・コマンド・アクションまたは問合せ文字列値に基づいて設定または削除されます。

2.7.4 消費モードからコントリビューション・モードへのプロセス

コントリビュータが編集用にページを開くと、ページの状態は次のように遷移します。

1. ユーザーがキー・コマンド(wcm.toggle.jsで設定。デフォルトは[Ctrl] + [Shift] + [F5])を押します。

2. コントリビューション・モード・セッションCookieが設定されます。

3. コントリビューション・モード問合せ文字列値がURLから削除されます(存在する場合)。

4. ブラウザが新たに算出されたURLを使用して同じサーバーのページをリクエストします。

5. サーバー認証が行われます。認証に失敗すると、コントリビュータ・モードCookieは削除されます。

6. ブラウザがリクエストされたページをロードします。

7. ページのロード時、次のコントリビュータ・モード・キーボード・コマンドが検出されるようOnKeyDownイベント・ハンドラがHTMLドキュメント・オブジェクトに適用されます。

8. ページのロード時、JavaScriptコードがコントリビュータ・モードCookieを検出します。(コントリビュータ・モードCookieがサーバーによって削除されていないものとします。)

9. HTMLウィンドウOnLoadイベント時、ブラウザでコントリビューション・モードになります。

3 Site Studioメタデータ

この項の内容は次のとおりです。

- 3.1項「メタデータについて」

- 3.2項「メタデータ・フィールド」

3.1 メタデータについて

各Site Studioアセットには、メタデータと呼ばれる情報が関連付けられています。メタデータはOracle Content Serverによって使用され、複数のリソースとサイト・アセットの管理を支援します。

Webサイトを構築するために作成、編集および使用するSite Studioアセットに関連付けられるメタデータは、効率的な格納およびアセット間の関係の保持に必要です。これは、各アセットの使用や再利用が可能なSite Studio 11gR1で使用される場合に特に重要です。メタデータ・フィールドは、アセット同士の相互使用の構造の保持に役立ちます。メタデータは、検索時の関連フィルタなどの他の事項にも使用されます。

3.2 メタデータ・フィールド

Site Studio製品には、Site Studioコンポーネントにより作成される次の5つのカスタム・メタデータ・フィールドが必要です。

- 3.2.1項「xWebsiteObjectType」

- 3.2.2項「xWebsiteSection」

- 3.2.3項「xWebsites」

- 3.2.4項「xDontShowInListsForWebsites」

- 3.2.5項「xRegionDefinition」

3.2.1 xWebsiteObjectType

xWebsiteObjectTypeメタデータ・フィールドは、管理対象ドキュメントがどのタイプのWebサイト関連アイテムであるかを示すのに使用されます。このフィールドは、使用可能な管理対象オブジェクトの次の値を含むオプション・リストです。

- データ・ファイル: Site Studioによって生成されるXML形式のコンテンツ・ファイル。コントリビュータ・データ・ファイルは、Site Studio Contributorアプリケーションを使用して編集します。

- ページ・テンプレート: Webページのレイアウトと大まかなルックアンドフィールを定義する、完全に成形されたHTMLファイルで、コントリビューション・リージョン(ページの編集可能領域)、ナビゲーション支援機能(フラグメント形式)およびサイトの共通イメージ(バナーなど)が含まれます。ページ・テンプレートは最高レベルのサイト設計オブジェクトです。

- サブテンプレート: ページ・テンプレートのプレースホルダに挿入して、独自のプレースホルダとコントリビューション・リージョンを持つさらに小さな再利用可能な領域に分割可能な部分的な(ヘッドおよび本文のセクションがない)HTMLファイル。

- リージョン・テンプレート: Webページ内のコントリビューション・リージョンのデータのレイアウトとルックアンドフィールを定義する部分的な(ヘッドおよび本文のセクションがない)HTMLファイル。

- プレースホルダ定義: 対応するプレースホルダに設定できるリージョン定義、リージョン・テンプレートおよびサブテンプレートを定義するファイル。プレースホルダでコントリビュータが実行できる処理も指定されます。

- リージョン定義: 特定タイプの要素を構成するコンテンツ・タイプを定義するファイル。コントリビューション・リージョンでコントリビュータが使用できるコンテンツの作成および切替えのオプションも指定し、これらのリージョンに関連付けられたコンテンツ・ファイルのデフォルト・メタデータも設定します。

- 要素定義: 要素タイプの編集操作を定義するファイル。特に、コントリビュータが要素を編集するときに実行できる処理が指定されます。

- ネイティブ・ドキュメント: Microsoft Wordなどの使い慣れたサードパーティ・アプリケーションを使用して作成されるコンテンツ・ファイル。ネイティブ・ドキュメントは、Dynamic Converterを使用してHTML形式に変換し、対応するアプリケーションを使用して編集します。

- フラグメント: Site Studio Webサイトの機能性を高める(動的ナビゲーション支援機能や標準ページ・フッターの提供などによる)コードのかたまり。

- イメージ: コンテンツ・ファイルまたはページ・テンプレートに含まれるJPG、GIF、PNGなどのグラフィック・ファイル(企業のバナーや製品のイメージなど)。

- スクリプト: ユーザーとの対話なしで実行される一連のコマンドが指定されたJavaScriptファイル。スクリプトは、Webページに追加機能を提供するために使用されることも多くあります。

- スタイルシート: ページ・コンテンツの表示方法(具体的には、ヘッダーやリンクなどの様々なHTML要素のページでの表示方法)を制御するカスケーディング・スタイル・シート(CSS)ファイル。多くの場合、CSSファイルへのリンクはページ・テンプレートに埋め込まれるため、テンプレートに基づくすべてのWebページにフォーマット・ルールが適用されます。

- プロジェクト: デザイナでサイトを操作するために必要とする、サイト階層、サイト・セクション・プロパティ、データの関連付け、プレースホルダ・マッピングなどのSite Studio Webサイトに関するすべての情報を格納するXMLファイル。

- カスタム要素フォーム: 要素で使用するカスタム・フォーム(特定のファイル・タイプの選択フォームなど)を定義するHTMLファイル。Site Studioには、あらかじめ定義されたカスタム要素フォームがいくつか含まれています(CS-Dir\custom\SiteStudio\elementforms内)。

- カスタム構成スクリプト: デフォルトのコントリビュータ・エディタ構成をオーバーライドし、カスタマイズした編集機能をコントリビュータに提供するJavaScriptファイル。

- 検証スクリプト: データが要件(特定の最大長を超えていないこと、不正な文字が含まれていないこと、など)を満たしていることを確認するための、要素データの検証ルールを定義するJavaScriptファイル。

- マネージャ設定: Site Studio Managerで使用できる機能を定義するファイル。マネージャは、指定されたユーザー(サイト・マネージャ)によるWebサイトの構造の変更を可能にするWebベースのツールです。

- 変換定義: Webサイトのネイティブ・ドキュメントの変換ルールを指定するファイル。

- その他: Flashアニメーション、動画ファイル、音声ファイルなどのWebサイトで使用されるその他のメディア・ファイル。

これらの各ファイル・タイプの詳細は、『Oracle WebCenter Content Site Studio Designerユーザーズ・ガイド』を参照してください。

3.2.2 xWebsiteSection

xWebsiteSectionフィールドは、管理対象アイテムへのリンクが生成される際、そのリンクにターゲット・セクションが明示的に含まれていない場合に、そのアイテムを表示するのに必要なWebサイト・セクションを判断するために使用されます。このフィールドは、主にコントリビュータ・データ・ファイルとネイティブ・ドキュメントで使用されます。内部的には、siteId:nodeId値が含まれます。Site Studioコンポーネントは標準のコンテンツ・サーバー・ページをオーバーライドして、サイトやセクションを選択するための使いやすいユーザー・インタフェースを提供します。

このフィールドの内容は、Site Studioで使用可能な異なるURL形式を理解する際に重要になります。詳細は、このドキュメントの後の部分で説明します。

注意:
このフィールドは、7.2より前のバージョンのSite Studioで使用されていたフォルダ・ベースのxCollectionIDフィールドの使用にかわるものです。Site Studioのインストール時に、新しいxWebsiteSectionフィールドがxCollectionIDフィールドの既存の値で初期化されますが、対象となるのはWebサイト関連フォルダに存在するドキュメントのみです(たとえば、以前のSite Studio Webサイトの一部であり、そのWebサイトのフォルダの1つに格納されていたドキュメントなど)。

3.2.3 xWebsites

xWebsitesフィールドは、管理対象ドキュメントが属する(コンテンツ・サーバーの)Webサイトの決定に使用されます。内部的には、このフィールドはサイト識別子のカンマ区切りリストです。Site Studioコンポーネントは、標準のコンテンツ・サーバー・ページを上書きして、より使いやすいサイト名のリストを提供します。

各Webサイトには固有のIDがあります。管理対象ドキュメントを含むデザイナまたはコントリビュータ・アプリケーション内でアクションを実行すると(通常アセットの追加や編集)、現在のサイト識別子がその管理対象ドキュメントのxWebsitesフィールドに自動的に追加されます(識別子がまだ存在しない場合)。つまり、デザイナまたはコントリビュータ・アプリケーションのサイト内で管理対象ドキュメントを使用すると、その管理対象ドキュメントは自動的にそのサイトの一部となります。

重要なのは、サイト識別子は一度追加されるとこのフィールドから自動的に削除されないということです。なぜなら、Site Studioでは、現在のところ管理対象ドキュメントの参照元となる可能性のあるすべての場所を認識できないためです。設計者は、デザイナ・アプリケーション内のサイト・アセット・ペインを使用して、Webサイトを対象に管理対象アイテムを手動で追加および削除できます。

注意:
xWebsitesフィールドは、Site Studioバージョン7.2より前のバージョンのSite Studioで使用されていたxWebsiteIDフィールドにかわるものです。Site Studioのインストール時にxWebsiteIDが存在すると、そのxWebsiteIDフィールドの既存の値で新しいxWebsitesフィールドが初期化されます。以前のリリースのSite Studioで作成されたカスタム・フラグメントとの下位互換性を維持するため、xWebsiteIDフィールドは削除されず、以前と同じように動作します。

3.2.4 xDontShowInListsForWebsites

xDontShowInListsForWebsitesフィールドには、コントリビュータがユーザー・インタフェースを介してコントリビュータ・データ・ファイルまたはネイティブ・ドキュメントがWebサイトの動的リストに表示されないように指定したWebサイトがリストされます。このフィールドにより、動的リストでの登録と除外の機能が適切に動作します。

コントリビュータが動的リストからファイルを除外すると、WebサイトIDがこの値に追加されます。コントリビュータがその後Webサイトの動的リストにコンテンツを再度含めると、WebサイトIDがこのメタデータから削除され、コンテンツが動的リストで再度使用可能になります。

注意:
特定のデータ・ファイルまたはネイティブ・ドキュメントのこのメタデータ・フィールドにWebサイト値が表示される場合、そのコンテンツはサイトのどのリストにも表示されません。ただし、検索結果には従前どおり表示されます。

3.2.5 xRegionDefinition

xRegionDefinitionメタデータ・フィールドは、コントリビュータ・データ・ファイルが関連付けられているリージョン定義を指定します。データ・ファイルには、1つのリージョン定義のみが関連付けられますが、リージョン定義には多数のデータ・ファイルを関連付けることができます。

リージョン定義は、Webサイトで使用されるコンテンツのタイプを定義します。コンテンツ・クラスとみなすこともできます。基本的には、特定のサイト・コンテンツ・タイプに対して再利用可能な情報の様々なチャンクを定義する個々の要素のグループです。たとえば、"Press-Release"という名前のリージョン定義(コンテンツ・クラス)があるとします。これは、要素Title、Subtitle、Intro-Text、Body-TexおよびImageで構成されます。コントリビュータ・データ・ファイルは、リージョン定義の各要素のデータを格納するリージョン定義に関連付けられます。(コントリビュータがデータに対して行える処理は、要素定義によって制御されます。)

その組成(要素)の点からサイト・コンテンツ・タイプを定義する以外に、リージョン定義は、対応するコントリビューション・リージョンでコントリビュータが使用できるコンテンツの作成および切替えのオプションも指定します。たとえば、コントリビュータがリージョンのコンテンツを切り替えられるようコントリビューション・リージョンが設定されている場合、サーバー上の既存のコントリビュータ・データ・ファイルのみを使用できます(ネイティブ・ドキュメントや新規のコントリビュータ・データ・ファイルは使用できません)。(プレースホルダ定義によって、コントリビュータが実際にコントリビューション･リージョンのコンテンツを切り替えられるかどうかが制御されることに注意してください。)最後に、リージョン定義は、コンテンツ・サーバーにチェックインされる際、コントリビューション・リージョンのコンテンツのデフォルト・メタデータも設定します、

リージョン定義の詳細は、『Oracle WebCenter Content Site Studio Designerユーザーズ・ガイド』を参照してください。

4 リンク形式

この項の内容は次のとおりです。

- 4.1項「リンク形式について」

- 4.2項「パスベースのリンクの使用」

- 4.3項「サーバー側スクリプト・リンクの使用」

- 4.4項「トークン・リンクの使用」

- 4.5項「JavaScriptリンクの使用」

4.1 リンク形式について

Site Studioでリンクを作成する方法は多数あります。所定のHTMLパスベースのリンクを使用したり、移植性と再利用性というSite Studio 11gのアーキテクチャを最大限活用するSite Studioの拡張機能を使用します。

Site Studio固有のメソッド内では、3種類の主要なリンクがあります。コンテンツ・ファイル(データ・ファイル、ネイティブ・ドキュメントなど)へのリンク、ノードへのリンクおよびイメージなどの静的リソースへのリンクがあります。

4.2 パスベースのリンクの使用

パスベースのリンクは、単にパスを使用したリンクです。必要に応じてIdocスクリプト変数を使用して、パスの一部を置換できます。変数はサーバーによって評価され、提供されるHTML内で置換されます。

パスベースのリンクは、絶対リンクまたは相対リンクとして記述できます。相対リンクおよびIdoc変数を使用したリンクは移植性が高いため、推奨されます。絶対リンクは、サイトが変更された場合に簡単にリンク切れが起こります。絶対リンクが推奨されるのは、外部のWebサイトへのリンクの場合のみです。

パスベースのリンクがリンク・ウィザードを使用して作成される場合、サーバーからWebサイトのルートへのパスの部分は、Idoc変数で置き換えられます。

例

基本的なパスベースのリンクは、想定どおりの完全URLです。

support/index.html

同じリンクをIdoc変数(具体的にはssServerRelativeSiteRoot)を使用して作成すると、次のようになります。

<!--$ssServerRelativeSiteRoot-->support/index.html
<a href="[!--$ssServerRelativeSiteRoot--]support/index.html">

変数のコンテンツでパス・セグメントの最後に"/"が含まれていることの注意してください。

相対パスは、静的HTMLインスタンス内と同様に使用されます。

../../support/index.html
<a href="../../support/index.html">

山カッコが使用されている場合(<!--$wcmUrl('nodelink', '30)-->など)と大カッコが使用されている場合([!--$wcmUrl('nodelink', '30)--])があります。Site Studioでは、XMLファイルおよび山カッコによってエスケープの問題が生じる可能性のある場所には大カッコを記述し、テンプレートには山カッコを記述します。どちらも区別なく使用できる点に注意してください。いずれを使用するか選択する際、どちらのインスタンスでエスケープの問題が生じる可能性があるかに注意してください。

4.3 サーバー側スクリプト・リンクの使用

サーバー側スクリプト・リンクはスクリプトで記述されたリンクですが、サーバーによって評価され、表示されるHTML内では置換されています。表示されているページのソースを確認すると、URL(相対または完全URL)が含まれているのみです。

サーバー側スクリプト・リンクはIdocスクリプトで記述されます。変数でも関数コールでも、サーバー側リンクはサーバーで評価され、表示されているWebページのソースに含まれません。

内容は次のとおりです。

- 4.3.1項「wcmUrl」

- 4.3.2項「ssLink」

- 4.3.3項「ssNodeLink」

- 4.3.4項「ssWebLayoutUrl」

4.3.1 wcmUrl

これは、他のリンク・フォーム(特に、サーバー側ssNodeLink、ssLinkおよびssWeblayoutUrl)をカプセル化するために設計されたスクリプト拡張機能です。これが、Site Studioでの使用を推奨されるリンク形式です。

必要なパラメータは1つのみで、タイプです。指定されたタイプに応じて、他のパラメータが必要な場合と必要でない場合があります。

wcmUrlスクリプト拡張機能は、4.3項「サーバー側スクリプト・リンクの使用」にリストされたスクリプト・リンクの機能が含まれたサーバー側スクリプト・リンクです。1つのスクリプト拡張機能にすべてが含まれることで、コンテンツ・ファイルまたはテンプレートでのリンクの検索が簡単になります。

パラメータ

- type: 次のいずれかとして入力されるリンクのタイプ。
[nodelink | link | resource]

Nodelinkはセクションへのリンクの作成に使用されます。リンクは、デフォルトではindex.htmで終わります。
Linkはコンテンツへのリンクの作成に使用されます。リンクは、デフォルトではcontentIdで終わります。
Resourceは、イメージなどのweblayout静的リソースへのリンクに使用されます。

- nodeId: 参照されるノードのID。タイプがnodelinkまたはlinkのいずれかに設定されている場合にのみ使用されます。

- siteId: 参照されるWebサイトのサイトID。タイプがnodelinkまたはlinkのいずれかに設定されている場合にのみ使用されます。

- dDocName: 参照されるコンテンツのdDocName。タイプがlinkまたはresourceのいずれかに設定されている場合にのみ使用されます。

例

評価前:

[!--$wcmUrl('link', 'switched_region_CDF')--]
[!--$wcmUrl('nodelink', '30')--]
[!--$wcmUrl('resource' 'groups/public/documents/adacct/mydocname.jpg')--]

これらの例では、パラメータに一重引用符が使用されます。他の例では、二重引用符が示される場合があります。山カッコと大カッコと同様、両方とも機能します。一部のインスタンスでは、一方を使用することで、考えられるエスケープの問題の回避に役立つ場合があります。

サーバーによる評価:

<a href="/support/switched_region/">
<a href="/region/West/">
<img src="groups/public/documents/adacct/mydocname.jpg">

1行目は、dDocNameで参照されるコンテンツ・ファイルへのリンクを示しています。2行目は、nodeIdで参照されるノードへのリンクです。3行目は、Oracle Content Server上のイメージ・ファイルへのパスです。

存在しないリソースへリンクされている場合などのようにリンクの値が不正と評価された場合、リンクはトークン・リンクと評価されます。詳細は、4.4.3項「サーバー側リンクから生成されるトークン・リンク 」を参照してください。

4.3.2 ssLink

ssLinkスクリプト・リンクは、ネイティブ・ドキュメントなどのデータ・ファイルへのサーバー側リンクの作成に使用されます。ターゲット・オブジェクトはdDocNameによって参照されます。

パラメータ

- dDocName: 管理対象アイテムのdDocName。パラメータが1つのみ指定されている場合、dDocNameとみなされます。

- targetNodeId: ターゲット・コンテキストとして使用するノードの一意の識別子（オプション）。

- targetSiteId: ターゲット・コンテキストとして使用するWebサイトの一意の識別子（オプション）。targetSiteIdを指定する場合、targetNodeIdも指定する必要があります。

例

評価前:

[!--$ssLink('dDocName')--]

(ここで、dDocNameは/support/switched_regionのコンテンツ・ファイルのことです)

サーバーによる評価:

<a href="/support/switched_region/">

注意:
ssLinkによって生成されるリンクが適切でない場合、ssLINKを使用してトークン化されたリンクがかわりに使用されます。これは、リンク切れしたリンクによってページの生成や配信が妨げられることがないことを意味しますが、リンク切れしたリンクはクリックすると検出できます。

4.3.3 ssNodeLink

ssNodeLinkスクリプト・リンクは、Webサイト・セクションへのサーバー側リンクの作成に使用されます。

パラメータ

- nodeId: ノードの一意の識別子。

- siteId: ノードを含むWebサイトの一意の識別子（オプション）。

例

評価前:

[!--$ssNodeLink('30')--]

(ここで、Webサイトの/support/CRMフォルダのnodeIdは30です)

サーバーによる評価:

<a href="/support/CRM/index.htm">

注意:
ssNodeLinkによって生成されるリンクが適切でない場合、ssNODELINKを使用してトークン化されたリンクがかわりに使用されます。これは、リンク切れしたリンクによってページの生成や配信が妨げられることがないことを意味しますが、リンク切れしたリンクはクリックすると検出できます。

4.3.4 ssWebLayoutUrl

ssWebLayoutUrlは、ドキュメントのweblayoutレンディションへのサーバー側リンクの作成に使用されます。このリソース/レンディションは、dDocNameまたはリソースへのパスで参照できます。

パラメータ

- dDocName: 参照されるコンテンツのdDocName。

例

評価前:

[!--$ssWebLayoutUrl('groups/public/documents/adacct/mydocname.jpg')--]

サーバーによる評価:

<a href="groups/public/documents/adacct/mydocname.jpg">

4.4 トークン・リンクの使用

トークン・リンク(遅延解決リンクとも呼ばれる)は、実際にクリックされるまで解決されません。ソースを表示すると、URLにssLINKまたはssNODELINKが含まれていることがわかります。トークン・リンクはクリックされるまで解決されません(そのため、遅延解決と呼ばれます。リンクの解決はページの表示後に行われます)。これに対し、スクリプト・リンクはWebページの表示前にサーバーで解決されます。

ssLINKおよびssNODELINKはトークン・リンクであることに注意してください。ssLinkおよびssNodeLinkはssLINKおよびssNODELINKと同じ名前ですが、キャメルケースのssLinkおよびssNodeLinkはスクリプト・リンクです。

トークン・リンクは、ネイティブ・ドキュメントにリンクを含める方法として推奨されます。Word docはDynamic Converterを使用してHTMLに変換されるため、トークン・リンクを使用して記述する方が簡単です。他の方法も可能ですが、この方法の方が単純です。

この項の内容は次のとおりです。

- 4.4.1項「ssLINK」

- 4.4.2項「ssNODELINK」

- 4.4.3項「サーバー側リンクから生成されるトークン・リンク」

4.4.1 ssLINK

データ・ファイルへの遅延解決リンクの作成に使用されます。ssLinkとは異なり、遅延解決リンクは、リンクがクリックされるまで解決されません。

パラメータ

- dDocName: 管理対象アイテムのdDocName。パラメータが1つのみ指定されている場合、dDocNameとみなされます。

- targetNodeId: ターゲット・コンテキストとして使用するノードの一意の識別子（オプション）。

- targetSiteId: ターゲット・コンテキストとして使用するWebサイトの一意の識別子（オプション）。targetSiteIdを指定する場合、targetNodeIdも指定する必要があります。

例

<a href="ssLINK/dDocName">

URL内にまだssLINKがあることに注意してください。リンクにマウスオーバーした場合またはソースを表示した場合に、ブラウザにこのように表示されます。リンクをクリックすると、Oracle Content ServerがdDocNameを評価し、フレンドリURLを決定してそれにリダイレクトします。

4.4.2 ssNODELINK

Webサイト・セクションへの遅延解決リンクの作成に使用されます。

パラメータ

- nodeId: ノードの一意の識別子。パラメータが1つのみ指定されている場合、nodeIdとみなされます。

- siteId: ノードを含むWebサイトの一意の識別子（オプション）。siteIdを指定する場合、nodeIdを指定する必要があります。

例

<a href="ssNODELINK/10027">

URL内にまだssNODELINKがあることに注意してください。リンクにマウスオーバーした場合またはソースを表示した場合に、ブラウザにこのように表示されます。リンクをクリックすると、Oracle Content ServerがnodeIdを評価し、フレンドリURLを決定してそれにリダイレクトします。

4.4.3 サーバー側リンクから生成されるトークン・リンク

サーバー側リンク(ssNodeLinkなど)が失敗した場合、トークン・リンクが返されます。不適切なリンクによってページの配信が妨げられることがないよう置換が行われます。

サーバーがサーバー側リンクを評価してリンクに問題がある(dDocNameが正しくないなど)と、サーバーは、トークン・リンクを使用してリンク・パラメータ値を返します。その結果、Webページは実質的なエラーなしで配信されます。ただし、トークン・リンクが使用された場合と同様に、ユーザーはソースでトークン・リンクを(リンクへのマウスオーバーによって)確認できます。

例

渡されたサーバー側リンクのパラメータ値は保持されます。次の値がサーバーに渡されて評価されるとします。

<!--$ssLink('Bad_dDocName')-->

サーバーは、提供するWebページのソースで次の値を返します。

<a href="ssLINK/Bad_dDocName">

これによって、サーバーがリンクを評価する際にWebページ全体をエラーとすることはなくなります。ただし、返されたトークン・リンクをクリックすると、サーバーからエラー・ページが表示されます。

これは、wcmUrlがサーバー側スクリプト・リンクのシン・ラッパーの場合、wcmUrlスクリプト・エラーでも起こります。

4.5 JavaScriptリンクの使用

JavaScriptを使用してサイト・アセットにリンクを入力できます。これは推奨されませんが、使用可能な方法ではあります。

リンクは、ssLINKやssNODELINKと同じパラメータを使用して同様に使用します。ssLINKおよびssNODELINK同様、JavaScriptリンクは遅れて評価されます。唯一の違いは、JavaScriptとして明示的にコールすることです。

例

javascript:link('dDocName')
javascript:nodelink('nodeId')

5 Site Studioランタイム生成ファイル

この項の内容は次のとおりです。

- 5.1項「ランタイム生成ファイルについて」

- 5.2項「ランタイム自動生成ファイル」

- 5.3項「wcm.toggle.js」

5.1 ランタイム生成ファイルについて

Site Studioは、ランタイム・ファイルのコレクションを使用して、完全に動作するWebサイトを配信します。Webサイトのサイト階層を変更すると、これらのファイルが影響を受けます。これが、デザイナでサイト階層を変更したときにランタイム・ファイルの更新を求められる理由です。

ランタイム・ファイルは、Webサイトの次のランタイム・フォルダに格納されます（cs_nameはコンテンツ・サーバーの名前、siteidはWebサイトです）。

cs_name\weblayout\websites\siteid

5.2 ランタイム自動生成ファイル

次のファイルが自動的に生成されます。

- 5.2.1項「sitenavigation.js」

- 5.2.2項「sitenavigationfunctions.js」

- 5.2.3項「sitenavigation.xml」

- 5.2.4項「sitenavigation.hda」

- 5.2.5項「sitenavigation_co.hda」

5.2.1 sitenavigation.js

sitenavigation.jsファイルには、Webサイト階層を定義するのに必要なJavaScriptが含まれます。Site Studioの一部のナビゲーション・フラグメントは、このファイルから情報を読み取るように設計されており、クライアント側JavaScriptを使用してWebサイトのナビゲーション・スキームを動的に生成します。

sitenavigation.jsには、サイト階層の単一ノード(デザイナ・インタフェースではセクションとも呼ばれる)を表すNavNodeオブジェクト定義が含まれます。sitenavigation.jsには、Webサイト・プロジェクト・ファイル内の実際のセクション・プロパティから生成されたプロパティがあります。

ノード・プロパティ/メソッド

定義

m_parent

現在のノードの親が含まれます。

m_level

現在のノードのレベルが含まれます（0はルート）。

m_id

現在のノードのノードIDが含まれます。

m_label

現在のノードのノード・ラベルが含まれます。

m_href

サイト階層におけるこのノードのサーバー相対パスが含まれます。

m_subNodes

子ノードの配列が含まれます。

addNode()

新しい子ノードを追加するために使用できます。

これらの標準プロパティ以外にも、NavNodeオブジェクトには、このセクションの値が割り当てられたすべてのカスタム・セクション・プロパティに対応するメンバー変数が含まれます。これらの変数のネーミング規則は、cp_XXXです(XXXはカスタム・セクション・プロパティ名です)。これらのデータ・メンバーは、NavNodeコンストラクタに渡された追加パラメータを解析することで構成されます。追加パラメータの形式は、名前==値の文字列です（後述するサンプル・コードのg_navNode_0_0の定義を参照）。これらの追加パラメータは、ランタイムJavaScriptファイルの再生成時にSite Studioによって自動的に生成されます。

sitenavigation.jsファイルには、定式名(g_navNode_Root)を使用して単一のルート・ノードで定義されるNavNodeオブジェクトに関するアクティブなサイト階層の宣言も含まれます。この値は、必要に応じてナビゲーション・フラグメントで調査できます。

次に例を示します。

var g_navNode_Root = new NavNode('9001','Home',ssUrlPrefix + 'index.htm',null,'PageTitle==Ravenna Hosting Tutorial Site');
g_navNode_1=g_navNode_Root.addNode('9002','Products',ssUrlPrefix + 'Products/index.htm','PageTitle==Ravenna Hosting Products');
g_navNode_1_0=g_navNode_1.addNode('9003','Servers',ssUrlPrefix + 'Products/Servers/index.htm','MainNavIcon==/idcm1/groups/public/documents/rvh_image/rvh_navicon_1.gif','PageTitle==Ravenna Hosting Servers');
g_navNode_1_0_0=g_navNode_1_0.addNode('9004','Web Servers',ssUrlPrefix + 'Products/Servers/WebServers/index.htm','MainNavIcon==/idcm1/groups/public/documents/rvh_image/rvh_navicon_2.gif','PageTitle==Ravenna Hosting Web Servers','SidebarProductsListBanner==webservers');
g_navNode_1_0_1=g_navNode_1_0.addNode('9005','Database Servers',ssUrlPrefix + 'Products/Servers/DatabaseServers/index.htm','MainNavIcon==/idcm1/groups/public/documents/rvh_image/rvh_navicon_3.gif','PageTitle==Ravenna Hosting Database Servers','SidebarProductsListBanner==databaseservers');
g_navNode_1_0_2=g_navNode_1_0.addNode('9006','Application Servers',ssUrlPrefix + 'Products/Servers/ApplicationServers/index.htm','MainNavIcon==/idcm1/groups/public/documents/rvh_image/rvh_navicon_4.gif','PageTitle==Ravenna Hosting Application Servers','SidebarProductsListBanner==applicationservers');
g_navNode_1_0_3=g_navNode_1_0.addNode('9007','File Servers',ssUrlPrefix + 'Products/Servers/FileServers/index.htm','MainNavIcon==/idcm1/groups/public/documents/rvh_image/rvh_navicon_5.gif','PageTitle==Ravenna Hosting File Servers','SidebarProductsListBanner==fileservers');
g_navNode_1_0_4=g_navNode_1_0.addNode('9008','Mail Servers',ssUrlPrefix + 'Products/Servers/MailServers/index.htm','MainNavIcon==/idcm1/groups/public/documents/rvh_image/rvh_navicon_6.gif','PageTitle==Ravenna Hosting Mail Servers','SidebarProductsListBanner==mailservers');

sitenavigation.jsファイルのNavNode定義とJavaScriptメソッドは、ランタイム・ファイルが再生成されるたびにSite Studioのコンポーネント・リソースから取得されます。NavNodeオブジェクトの階層のみが動的に生成されます。他のJavaScriptを変更する場合は、コンポーネント・リソースを更新または上書きする必要があります。

5.2.2 sitenavigationfunctions.js

sitenavigationfunctions.jsファイルでは、クライアント側JavaScriptのナビゲーション・メカニズムで使用されるメソッドが提供されます。たとえば、IDベースのクライアント側ハイパーリンク関数のlink()メソッドやnodelink()メソッドの定義は、どちらもこのファイルに格納されます。

5.2.3 sitenavigation.xml

sitenavigation.xmlファイルには、サーバー側スクリプトで使用できるアクティブなサイト階層のXML定義が含まれます。このファイルで提供される情報を読み取るために、いくつかのナビゲーション・フラグメントが作成されます。各ナビゲーション・フラグメントは、この情報を読み取り、クライアント側JavaScriptではなくサーバー側スクリプトを使用してWebサイトのナビゲーション・スキームを動的に生成します。

XML定義には、ルートとして単一の<site>タグが含まれます。このタグには、各セクションを定義するための<section>タグの階層が含まれます。

次に例を示します。

<site id="9001" level="0" parent="" label="Home" href="index.htm" PageTitle="Ravenna Hosting Tutorial Site">
<section id="9002" level="1" label="Products" href="Products/index.htm" PageTitle="Ravenna Hosting Products">
<section id="9003" level="2" label="Servers" href="Products/Servers/index.htm" MainNavIcon="/idcm1/groups/public/documents/rvh_image/rvh_navicon_1.gif" PageTitle="Ravenna Hosting Servers">
<section id="9004" level="3" label="Web Servers" href="Products/Servers/WebServers/index.htm" MainNavIcon="/idcm1/groups/public/documents/rvh_image/rvh_navicon_2.gif" PageTitle="Ravenna Hosting Web Servers" SidebarProductsListBanner="webservers"></section>
<section id="9005" level="3" label="Database Servers" href="Products/Servers/DatabaseServers/index.htm" MainNavIcon="/idcm1/groups/public/documents/rvh_image/rvh_navicon_3.gif" PageTitle="Ravenna Hosting Database Servers" SidebarProductsListBanner="databaseservers"></section>
<section id="9006" level="3" label="Application Servers" href="Products/Servers/ApplicationServers/index.htm" MainNavIcon="/idcm1/groups/public/documents/rvh_image/rvh_navicon_4.gif" PageTitle="Ravenna Hosting Application Servers" SidebarProductsListBanner="applicationservers"></section>
<section id="9007" level="3" label="File Servers" href="Products/Servers/FileServers/index.htm" MainNavIcon="/idcm1/groups/public/documents/rvh_image/rvh_navicon_5.gif" PageTitle="Ravenna Hosting File Servers" SidebarProductsListBanner="fileservers"></section>
<section id="9008" level="3" label="Mail Servers" href="Products/Servers/MailServers/index.htm" MainNavIcon="/idcm1/groups/public/documents/rvh_image/rvh_navicon_6.gif" PageTitle="Ravenna Hosting Mail Servers" SidebarProductsListBanner="mailservers"></section></section>

5.2.4 sitenavigation.hda

sitenavigation.hdaファイルには、ssLoadSiteNavResultSet()スクリプト拡張機能で使用できるSiteStudioNavNodes ResultSetの永続表現が含まれます。このファイルには、サーバー側スクリプトで使用できるアクティブなサイト階層の定義が含まれます。このResultSetで提供される情報を読み取るために、いくつかのナビゲーション・フラグメントが作成されます。各ナビゲーション・フラグメントは、この情報を読み取り、クライアント側JavaScriptではなくサーバー側スクリプトを使用してWebサイトのナビゲーション・スキームを動的に生成します。

SiteStudioNavNodes ResultSetには、次の5つの列があります。

- nodeId: ノードの一意の識別子。

- parentNodeId: 親ノードの一意の識別子。

- label: ノードのラベル。

- level: サイト階層におけるノードの深さ。ルート・セクションのレベルは0（ゼロ）です。

- href: ノードのプライマリ・ページに対するパス・ベースのサイト相対URL。

5.2.5 sitenavigation_co.hda

sitenavigation_co.hdaファイルには、sitenavigation.hdaファイルと同じ構造が含まれますが、SiteStudioNavNodes結果セットにはコントリビュータ専用ノードも含まれます。

5.3 wcm.toggle.js

wcm.toggle.jsファイルには、Webサイトでコントリビューション機能を提供するのに必要なJavaScriptが含まれます。最も重要なことは、wcm.contributor.OnKeyDown()関数で、コントリビューション・モードに移行するためのキーボード・シーケンス([Ctrl] + [Shift] + [F5])を必要に応じて別のシーケンスに変更できることです。

デフォルトのキーストロークの組合せを変更するには、次のタスクを実行します。

1. 次のディレクトリに移動します(ここで、CS-Dirはコンテンツ・サーバーのインストール場所です)。
CS-Dir\custom\SiteStudio\publish\resources\wcm\sitestudio\

2. テキスト・エディタでwcm.toggle.jsを開きます。

3. 関数OnKeyDownを見つけます。

4. 別のキーストロークの組合せを使用するよう、この関数の実装を変更します。これによってwcm.contributor.toggleがコールされます。
この関数では仮想キー・コードを使用して、ユーザーによって入力されたキーの組合せを決定します。デフォルト値は、[Ctrl]+[Shift]+[F5]です。F5キーの仮想キーコードは116(16進で0x74)です。よく使用されるその他のファンクション・キーのコードはF1からF12までで、それぞれ112 (0x70)から123 (0x7B)までです。

5. wcm.toggle.jsを保存して閉じます。

注意:
次回Site Studioをアップグレードする際、またはパッチを適用する際、この手順を再度実行してキーストロークの組合せを保持する必要がある場合があります。

注意:
仮想キー・コードはオペレーティング・システム間で異なる場合があるため、コントリビュータが異なるオペレーティング・システムを使用する可能性のあるインスタンスでは、キーストロークの決定に使用されるキー・コードには特に注意が必要です。

6 フラグメント

この項の内容は次のとおりです。

- 6.1項「フラグメントについて」

- 6.2項「フラグメント・ライブラリ」

- 6.3項「読取り専用フラグメント・ライブラリ」

- 6.5項「フラグメント・スニペットとssIncludeXml()」

- 6.6項「カスタム・セクション・プロパティを使用するフラグメント」

- 6.7項「フラグメント定義ファイル」

- 6.8項「<ssinfo> XMLデータ・アイランドのフラグメント・インスタンスの構造」

6.1 フラグメントについて

フラグメントは、HTMLまたはスクリプト(クライアント側のJavaScriptおよびサーバー側のIdocを含む)の自己完結型のスニペットで、Webサイトの複数のテンプレートで再利用可能な値を含むことができます。

フラグメントは、<IMG SRC=xxx>、<SCRIPT SRC=xxx>、<$ docLoadResource(xxx) $>などのタグを使用して他のファイルへの参照も格納できます。外部参照されるファイルやリソースは、フラグメント・アセットとして機能するため、フラグメントの使用時には常に参照可能である必要があります。

単純なフラグメントは、テンプレートの任意の場所に挿入できるアトミック・コンテンツを格納できます。より複雑なフラグメントでは、一部のコンテンツをページの<head>に配置し、他のコンテンツを<body>に配置する必要があります。<body>では、コンテンツをページの先頭や末尾に、またはカーソルの現在の位置に配置できます。つまり、フラグメントには、複数のフラグメント・スニペットを格納できます。

1つの<head>スニペットに対して複数の<body>スニペットを含めることはできますが、推奨されません。主に、ページの<head>を使用するフラグメントは、リージョン・テンプレートやサブテンプレートに配置できないためです。これは、リージョン・テンプレートもサブテンプレートも完全なHTMLページではなく、<head>が含まれていないためです。フラグメントは、Site Studioアーキテクチャの柔軟な性質に最も合うよう<body>のみを使用して作成される必要があります。<body>のみを使用すると、ページ・テンプレート、サブテンプレートおよびリージョン・テンプレートでフラグメントを使用できます。

ページ・テンプレートには<head>が含まれ、フラグメントで使用される場合、<head>と<body>の両方をフラグメントに含めることができます。ただし、これらのフラグメントで、<ssinfo> XMLデータ・アイランドが作成されます。詳細は、6.8項「<ssinfo> XMLデータ・アイランドのフラグメント・インスタンスの構造」を参照してください。

設計者は、Webサイトにおけるフラグメントの使用場所に応じて、フラグメントのルック・アンド・フィールまたは動作を変更できます。この機能は、フラグメント・パラメータの使用により可能になります。フラグメント・パラメータにより、フラグメントの作成者は特定の変数パラメータを指定できます。サイト設計者は、フラグメントをテンプレートに実際に追加するときに、これらのパラメータを選択できます。

大きく分けると、フラグメントには次のものが含まれます。

- 0(ゼロ)個以上のフラグメント・パラメータ定義(名前、タイプ、デフォルト値)。これらは、フラグメント・スニペットで参照されますが、フラグメント・インスタンスを含むページごとに一意に宣言されます。

- 1つ以上のフラグメント・スニペット。これらは、フラグメントをテンプレートに追加する際にコンテンツを配置する必要のある場所を示す識別子を備えた、HTMLまたはスクリプトの断片です。

- 0(ゼロ)個以上のフラグメント・アセット。これらは、Webページでの使用時にフラグメントから参照できるローカル・ファイルです。

フラグメントは、一般的に2つのスニペットで構成されます。1つ目のスニペットは、通常、ページの<head>に存在し、ページを書式設定するCSSファイルを参照するか、フラグメントの実装の一部または全部を提供するJavaScriptファイルを参照します。2つ目のスニペットは、通常、ページの<body>のドロップ・ポイントに存在し、フラグメントのプレゼンテーションを含みます。このスニペットは、インクルードされた.jsファイルにより提供されるメソッドのJavaScriptコールのように単純なこともあれば、HTML、JavaScriptおよびIdocスクリプトのコレクションを格納することもあります。

6.2 フラグメント・ライブラリ

Site Studioでは、個々のフラグメントをフラグメント・ライブラリに格納します。フラグメントごとに独自のライブラリに格納することや、関連するフラグメントをまとめて同じライブラリに格納することが可能です。フラグメント・ライブラリは、次のような管理対象オブジェクトとしてコンテンツ・サーバーに格納されます。

- プライマリ・ファイル: フラグメント・ライブラリの各フラグメントにより必要とされるすべてのアセットを格納したZIPファイル。

- 代替ファイル: フラグメント・ライブラリの各フラグメントの構造全体を定義したフラグメント定義ファイル。

Oracle Content Serverでは、プライマリ・ファイルまたは代替ファイル、あるいはその両方としてコンテンツ・アイテムを管理します(Oracle Content Serverのヘルプを参照)。これらのファイルは、Site Studioのプライマリおよびセカンダリ・ページとは無関係です。混同しないように注意してください。

注意:
前述のプライマリ・ファイルとしてチェックインされるフラグメント・アセットのZIPファイルを、フラグメント・アセットとフラグメント定義ファイルの両方を含むフラグメント・ライブラリのZIPファイルと混同しないでください。フラグメント・ライブラリのZIPファイルは、デザイナのフラグメント・ライブラリのアップロードおよびダウンロード・ユーティリティで使用するもので、フラグメント・ライブラリをより簡単に管理できます。デザイナのフラグメント管理ユーティリティを使用せずにコンテンツ・サーバーの管理対象フラグメント・ライブラリに直接アクセスする場合は、フラグメント・アセットのZIPファイルを管理するだけで済みます。

フラグメント定義ファイルには、ライブラリ内の各フラグメントを定義する1つ以上の<fragment>要素を格納した<fragments>ルート要素が含まれます。フラグメント定義ファイルの正確な構文は、「フラグメント定義ファイル」で説明します。詳細は、6.7項「フラグメント定義ファイル」を参照してください。

コンテンツ・サーバーにフラグメント・ライブラリを追加する場合、コンテンツ・サーバーの標準のチェックイン・ページは使用しません。かわりに、デザイナによるフラグメント・ライブラリのアップロード機能を使用します。この機能により、管理対象コンテンツ・アイテムをチェックインし、フラグメント・アセットのZIPファイルのコピーを次の適切なランタイムweblayoutディレクトリに抽出します(CS_nameはコンテンツ・サーバーの名前です)。

CS_name\weblayout\fragments

このパスは、次の2つのIdoc変数のいずれかを使用して、フラグメントのサーバー側Idocスクリプトで参照できます。

- HttpFragmentsRoot: fragmentsフォルダの完全なHTTPパス。

- HttpRelativeFragmentsRoot: fragmentsフォルダの相対HTTPパス。

6.3 読取り専用フラグメント・ライブラリ

製品に付属するフラグメント定義ファイル（サンプル・フラグメント）内の<fragments>ルート要素は、デザイナ・アプリケーション内で編集または削除されないように、読取り専用属性が設定されています。この属性を設定または解除するGUIは公開されていません。出荷時に設定済のフラグメントは、Site Studioの将来のリリースへのアップグレード時に上書きされる予定のため、変更されないように設計されています。

もちろん、設計者は、これらのフラグメントをコピーおよび編集して、独自のコピーに変更を加えることができます。

6.4 wcmFragmentを使用したフラグメントのインクルード

ツールボックスを使用すると、フラグメントをドラッグアンドドロップで簡単にテンプレートに配置できますが、スクリプトによる方法を使用してフラグメントをソースに直接配置する場合があります。

フラグメントを追加するには、wcmFragmentスクリプトをテンプレートで使用します。タグがリージョン・テンプレートまたはサブテンプレートで使用される場合、最初のドロップポイント・スニペットのみが使用されます。

タグがページ・テンプレートで使用される場合、レガシー<ssinfo> XMLデータ・アイランドがSite Studioに挿入されます。詳細は、6.8項「<ssinfo> XMLデータ・アイランドのフラグメント・インスタンスの構造」を参照してください。

パラメータ

- fragmentInstanceId: ページ上のフラグメント・インスタンスのID。動的リストなど複数ページを返すフラグメントの区別に使用されます。IDによって、動的リストで問合せ結果の異なるページを表示できます。たとえば、あるフラグメントは問合せ結果の1ページ目で、他のフラグメントは独自の結果の3ページ目を表示できます。両方のフラグメントに同じIDが使用されている場合、一方の問合せの結果の特定のページに移動するようクリックすると、他方のフラグメントで独自の結果の同じ番号のページが表示されます。

- fragmentDocName: フラグメント・ライブラリのdDocName。

- fragmentId: 指定されたライブラリ内のフラグメントのID。

- snippetId: 指定されたフラグメント内のスニペットのID。

- tagProperties: フラグメントのプロパティの名前付き値ペア。

サンプル・コード

<!--$wcmFragment("fragmentInstanceID", "fragmentDocName", "fragmentID", "snippetID", "ssTheme=default", "ssHoverColor=", "ssTextColor=", "ssFocusColor=", "ssShowHome=true", "ssShowNext=false", "ssClassName=IDocNavTabsTop")-->

6.5 フラグメント・スニペットとssIncludeXml()

各フラグメントには、フラグメント・ライブラリのフラグメント定義ファイルで定義されたスニペットが含まれます。フラグメント・スニペットは、次の3つの方法でフラグメントにインクルードできます。

- simple: フラグメント・スニペットは、追加のマークアップなしにレイアウト・ページに直接追加され、フラグメントとして認識または管理されなくなります。

- inline: フラグメント・スニペットは、レイアウト・ページに直接追加されますが、フラグメントとして認識および管理されるように前後に特殊なマークアップが付きます。

- reference: フラグメント・スニペットは、レイアウト・ページに実際に追加されず、かわりにインクルード・ファイルのようにスニペットへの参照が追加されます(同時に、フラグメントとして認識および管理されるように前後にマークアップが付きます)。

ごく単純なスニペット以外には、インクルード・メカニズムとしてreferenceを使用することを強くお薦めします。この方法であれば、フラグメントがサイト全体で何度も使用される場合でも、スニペット・コンテンツを単一の場所で管理できます。

インラインおよび参照スニペットの前後に配置される特殊なマークアップの正確な構文は、9.14項「ssIncludeXml」を参照してください。参照によりインクルードされるスニペットは、ssIncludeXml()というスクリプト拡張機能を使用してレイアウト・ページに追加されます。

このスクリプト拡張機能により、管理対象XMLファイルから要素をインクルードしてレイアウト・ページに配置するIdocメカニズムが提供されます。ssIncludeXml()のパラメータには、フラグメント・ライブラリのフラグメント定義ファイルのdDocNameと、抽出されるXMLノードのXPath式が含まれます。(その他のパラメータの詳細は、9.14項「ssIncludeXml」を参照してください)。抽出されるXMLノードのコンテンツは、現在のテンプレートの有効範囲で詳細に評価され、必要に応じて追加のサーバー側Idocスクリプトがインクルードされます。

6.6 カスタム・セクション・プロパティを使用するフラグメント

設計者は、カスタム・セクション・プロパティを定義して、Webサイトの各セクションの各プロパティに一意の値を割り当てることができます(『Oracle WebCenter Content Site Studio Designerユーザーズ・ガイド』を参照。定義と値は、Webサイト・プロジェクト・ファイルに格納されます。

カスタム・セクション・プロパティは、それ自体では役に立ちません。カスタム・プロパティが役に立つのは、レイアウト・ページ内（より一般的には、フラグメント・スニペット内）でクライアント側またはサーバー側スクリプトに参照される場合のみです。カスタム・セクション・プロパティの値にアクセスする場合、クライアント側JavaScriptとサーバー側Idocスクリプトを使用する2つの主な方法があります。

6.6.1 クライアント側JavaScript

クライアント側のランタイム生成ファイルsitenavigation.jsには、現在のWebサイト階層の定義を格納したNavNodeオブジェクトの配列が含まれます(5.2.1項「sitenavigation.js」を参照)。現在のセクションの値を含む各カスタム・セクション・プロパティは、cp_で始まる名前を持つメンバー変数のそのセクションに対応するNavNodeオブジェクト内に格納されます。

カスタム・セクション・プロパティのこれらのクライアント側表現が最もよく使用されるのは、ナビゲーション・フラグメント内です。ナビゲーション・フラグメントは、NavNodeオブジェクトを反復処理し、cp_XXXメンバー変数の存在を検出して使用することで、表示されるナビゲーション・スキームをカスタマイズできます。cp_XXXメンバー変数は、存在する場合としない場合があるため、パラメータへのアクセスは、Site Studioで提供される次の2つのJavaScriptメソッドを使用することでより簡単になります。

- customSectionPropertyExists (prop): カスタム・セクション・プロパティが存在するかどうかを示すtrueまたはfalseの値を戻します。このメソッドがtrueを戻した場合、カスタム・セクション・プロパティを直接使用できます。

- getCustomSectionProperty (prop): カスタム・セクション・プロパティの値が存在する場合、その値を戻します。存在しない場合、空の文字列を戻します。

これらの2つのメソッドのアクションは、Site Studioに付属するCSP Sample Navigation (client)フラグメントで確認できます(『Oracle WebCenter Content Site Studio Designerユーザーズ・ガイド』を参照)。

6.6.2 サーバー側Idocスクリプト

サーバー側Idocスクリプトを使用してカスタム・セクション・プロパティにアクセスする場合、次の複数の方法を使用できます。

- ssGetNodeProperty (name): このスクリプト拡張機能は、現在のWebサイト・セクションの名前付きプロパティの値を取得します。

- ssGetNodeProperty (nodeId, name): このスクリプト拡張機能は、指定されたWebサイト・セクションの名前付きプロパティの値を取得します。

- SS_GET_ALL_NODE_PROPERTIESサービス: このサービスは、指定されたWebサイト・セクションのすべてのカスタム・セクション・プロパティのリストを取得します。

これらのアクションは、Site Studioに付属するCSP Sample Navigation (server)、CSP Sample Dynamic ListおよびSample CSP Page Titleフラグメントで確認できます(『Oracle WebCenter Content Site Studio Designerユーザーズ・ガイド』のサンプル・フラグメントに関する項を参照)。

カスタム・セクション・プロパティは、sitenavigation.xmlファイルのサイト階層のXMLレンディションにも格納されます(5.2.3項「sitenavigation.xml」)を参照。そのため、サーバー側スクリプトを使用してこのXMLファイルを解析するナビゲーション・フラグメントを作成する場合、各セクションのカスタム・セクション・プロパティに対するアクセス権も保持している必要があります。

プロパティの名前は、引用符で囲む必要があります。つまり、特定のノードのlabelプロパティを取得する場合であれば、次のように記述します。

<!--$label = ssGetNodeProperty(nodeId, "label")-->

6.7 フラグメント定義ファイル

フラグメント定義ファイルは、純粋なXMLファイルであり、ファイルの割当て先のコントリビューション・リージョンからその構造を継承したコンテンツを格納しています。コーディングの観点からは、フラグメント・ライブラリのフラグメント定義ファイルは次のように表現されます。

<fragments>
<fragment>

<parameters>
<parameter> param definition goes here </parameter>
<parameter> another param def goes here </parameter>
</parameters>

<snippets>
<snippet> HTML snippet goes here </snippet>
<snippet> another HTML snippet goes here </snippet>
</snippets>

<elements>
<element> element definition goes here </element>
<element> another element def goes here </element>
</elements>

</fragment>
</fragments>

フラグメント定義ファイルには、通常、次のタグが含まれます。

- 6.7.1項「<fragments>」

- 6.7.2項「<fragment>」

- 6.7.3項「<parameter>」

- 6.7.4項「<snippet>」

- 6.7.5項「<designview>」

- 6.7.6項「<element>」

6.7.1 <fragments>

<fragments>タグは、フラグメント・ライブラリを表します。

パラメータ

- id: フラグメント・ライブラリの一意の名前または識別子。

- name: フラグメント・ライブラリの表示名。

- readonly: Trueに設定すると、ライブラリのフラグメントはデザイナで編集できなくなります。

<fragments>タグには、1つ以上の<fragment>子タグのコレクションが含まれます。

6.7.2 <fragment>

<fragment>タグは、単一のフラグメント定義を表します。

パラメータ

- id: フラグメントの一意の名前または識別子。スニペットを参照によりインクルードする場合にXPath式で使用されます。

- name: フラグメントの表示名。

- language: フラグメント実装のためのサーバー側言語。使用可能な言語は、idoc、aspまたはjspです。

- type: このフラグメントのタイプ。フラグメントが表示されるデザイナ・ツールボックスのカテゴリを決定するのに使用されます。また、フラグメントが静的リストと動的リストのどちらであるかも決定されます。使用可能なタイプは、navigation、staticlist、dynamiclistまたはotherです。

- icon: デザイナ・ツールボックスでこのフラグメント用に使用するアイコンの名前。事前定義された次のフラグメント・アイコンのリストから選択します。

アイコン名

イメージ

region

wysiwyg

plaintext

image1

image2

list1

list2

list3

list4

list5

list6

tree

horizontalrule

nonbreakingspace

linebreak

span

div

heading1

heading2

heading3

heading4

heading5

heading6

copyright

flash

companylogo

documents

子タグ

<fragment>タグには、次の子タグが含まれます。

- <parameters>: 0(ゼロ)個以上のパラメータのコレクション。詳細は、6.7.3項「<parameter>」を参照してください。

- <snippets>: 0(ゼロ)個以上のスニペットのコレクション。詳細は、6.7.4項「<snippet>」を参照してください。

- <elements>: 0(ゼロ)個以上の要素のコレクション。詳細は、6.7.6項「<element>」を参照してください。

6.7.3 <parameter>

<parameter>タグは、フラグメントの単一のパラメータを表します。このタグの属性は次のとおりです。

パラメータ

- name: パラメータ名。

- type: パラメータ・タイプ。次のものがあります。

- text: 単純なテキスト型パラメータ。1つ以上の<option>子タグを使用して、事前定義済の選択項目のリストを格納できます。

- bigtext: 複数行のテキスト型パラメータ。

- boolean: 単純なTrue/False型パラメータ。

- integer: 単純な整数型パラメータ。

- float: 単純な浮動小数点型パラメータ。

- size: HTMLサイズ(10px、50%、3ptなど)を表すパラメータ。

- color: 色の値（RGBまたはHTMLの色名を使用）。

- url: URL。

- manageddoc: 「検索結果」ページで選択された、Oracle Content Serverの管理対象ドキュメントのdDocName。問合せパラメータは、<querytext>子タグを使用して指定できます。

- managedurl: 「検索結果」ページで選択された、Oracle Content Serverの管理対象ドキュメントのDocUrl。問合せパラメータは、<querytext>子タグを使用して指定できます。

- managedquery: CAPTURE_QUERYページで選択された問合せテキスト文字列。

- cssstyle: CSSスタイル属性を表すテキスト・パラメータ。このタイプは、textタイプのように動作します。（将来的な使用を意図しています。）

- siteid: 「サイトの選択」ダイアログで選択された、コンテンツ・サーバーの同じインスタンスに含まれるいずれかのWebサイトのsiteId値。

- nodeid: 「セクションの選択」ダイアログのサイト階層を通じて選択された、WebサイトのいずれかのセクションのnodeId値。

- custom: <customgui>子タグを使用して値を入力するための独自のカスタムGUIを提供するパラメータ。

- description: 「フラグメント・パラメータ値」ダイアログに表示されるパラメータの説明。

- required: レイアウト・ページにフラグメントを追加する場合にそのフラグメントのパラメータが必須であるかどうかを指定するtrueまたはfalseの値。

- optionsonly: 1つ以上の<option>子タグに使用可能な事前定義済のオプションが提供されている場合にのみ適用することを示すTrueまたはFalseの値。

<parameter>タグは、パラメータのデフォルト値(在する場合)を表すテキストを格納できます。また、次のオプションの子タグも格納できます。

- <option>: textタイプのパラメータについて、1つ以上のオプション・タグを使用して、事前定義済の選択項目のリストを指定します。詳細は、6.7.3.1項「<option>」を参照してください。

- <querytext>: manageddocおよびmanagedurlタイプのパラメータのQueryText値が含まれます。詳細は、6.7.3.2項「<querytext>」を参照してください。

- <validate>: パラメータを検証するためのカスタマイズされたスクリプト関数が含まれます。詳細は、6.7.3.3項「<validate>」を参照してください。

- <convert>: パラメータを挿入する前に変換するためのカスタマイズされたスクリプト関数が含まれます。詳細は、6.7.3.4項「<convert>」を参照してください。

- <customgui>: パラメータ値を入力するための独自のGUIを提供するカスタマイズされたHTMLスニペットが含まれます。詳細は、6.7.3.5項「<customgui>」を参照してください。

6.7.3.1 <option>

<option>タグは、選択リストの単一のオプションを表します。textタイプのパラメータにのみ適用されます。<option>タグは、選択リストに表示されるテキストを格納する必要があります。このタグの属性は次の1つです。

- value: このオプションが選択されたときに挿入する値。この属性は、オプションに表示される値と挿入される値が同じ場合は任意指定です。

たとえば、次のようになります。

<option>Option 1</option>
<option>Option 2</option>
<option>Option 3</option>
<option>Option 4</option>

または

<option value="A">Option A</option>
<option value="B">Option B</option>
<option value="C">Option C</option>
<option value="D">Option D</option>

6.7.3.2 <querytext>

<querytext>タグは、コンテンツ・サーバーで検索を実行する場合に使用する問合せパラメータを表します。manageddocまたはmanagedurlタイプのパラメータにのみ適用されます。このタグは、CDATAセクション内に問合せテキストを格納します。このタグは属性を持ちません。

たとえば、次のようになります。

<querytext>
<![CDATA[
dExtension <matches> `gif` <or> dExtension <matches> `jpg`
]]>
</querytext>

6.7.3.3 <validate>

<validate>タグは、オプションであり、パラメータをフラグメント・スニペットに挿入する前に検証するためのカスタマイズされたスクリプト・ルーチンを表します。スクリプト・ルーチンは、任意のWSH互換スクリプト言語(VBScriptやJScript)で記述できます。このルーチンには、単一の文字列を入力として使用するvalidateという単一の関数が含まれる必要があります。

関数の戻り値は、次のいずれかになります。

- ブール: パラメータが有効か無効かを表すTrueまたはFalseの値。
または

- 文字列: パラメータが有効の場合、空の文字列を戻し、パラメータが無効の場合、エラー・メッセージを戻します。

<validate>タグは、CDATAセクション内にスクリプトを格納します。このタグの属性は次の1つです。

- language: このスクリプトで使用する言語（VBScriptまたはJScript）。

たとえば、次のようになります。

<validate language="VBScript">
<![CDATA[
Function validate(strInput)
If InStr(strInput, "hello") > 0 Then
validate = ""
Else
validate = "Error, ValidatedParam must contain " _
"the text 'hello' somewhere in the string"
End If
End Function
]]>
</validate>

注意:
<validate>タグは、使用できますが、フラグメント・エディタ・ユーザー・インタフェースには表示されません。つまり、現在はサポートされていません。

6.7.3.4 <convert>

<convert>タグは、オプションであり、パラメータをフラグメント・スニペットに挿入する際に変換するためのカスタマイズされたスクリプト・ルーチンを表します。スクリプト・ルーチンは、任意のWSH互換スクリプト言語(VBScriptやJScript)で記述できます。このルーチンには、単一の文字列を入力として使用し、変換後の文字列を出力として返すconvertという単一の関数が含まれる必要があります。

<convert>タグは、CDATAセクション内にスクリプトを格納します。

パラメータ

- language: このスクリプトで使用する言語（VBScriptまたはJScript）。

たとえば、次のようになります。

<convert language="VBScript">
<![CDATA[
Function convert(strInput)
If StrComp(strInput, "") = 0 Then
convert = "(empty)"
Else
convert = "Your Value Was [" & strInput & "]"
End If
End Function
]]>
</convert>

注意:
<convert>タグは、使用できますが、フラグメント・エディタ・ユーザー・インタフェースには表示されません。つまり、現在はサポートされていません。

6.7.3.5 <customgui>

<customgui>タグは、customタイプのパラメータ専用です。このタグにより、フラグメント設計者は、フラグメント・パラメータを入力するための独自の（単純な）GUIを提供できます。このタグは、標準のHTMLまたはJavaScriptを含むことが可能なCDATAセクション内にHTMLスニペットを格納します。

このタグは、4つのJavaScriptメソッドを通じてSite Studioと対話します。

- window.external.GetValue(): パラメータの初期値を取得するメソッド。カスタム・パラメータは、プレーン・テキスト・パラメータと同じように処理を開始しますが、編集フィールドにはカスタムGUIを表示するためのボタン(図6-1)があります。このメソッドは、編集フィールドから現在の値を取得します。

図6-1 編集フィールドのカスタムGUIボタン

- window.external.SetValue(): 編集フィールドに新しい値を設定するメソッド。

- window.external.OnOK(): Site Studioに対して、処理が終了し、SetValue()メソッドにより渡された値を承認する必要があることを指示するメソッド。

- window.external.OnCancel(): Site Studioに対して、処理が終了したが、SetValue()メソッドにより渡された値を無視する必要があることを指示するメソッド(値が存在する場合)。

たとえば、次のようになります。

<customgui>
<![CDATA[
<HTML>
<HEAD>
<SCRIPT language="javascript">
function initialize()
{
strResult = window.external.GetValue() + "00000";
bold.checked = (strResult.charAt(0) == "1");
italic.checked = (strResult.charAt(1) == "1");
underlined.checked = (strResult.charAt(2) == "1");
font.checked = (strResult.charAt(3) == "1");
}
function getvalue()
{
strResult = "";
strResult = strResult + (bold.checked ? "1" : "0");
strResult = strResult + (italic.checked ? "1" : "0");
strResult = strResult + (underlined.checked ? "1" : "0");
strResult = strResult + (font.checked ? "1" : "0");
return strResult;
}
</SCRIPT>
</HEAD>
<BODY onload="initialize();">
Welcome to my Customized Parameter Input Screen. This example
could perhaps be used as a starting point for entering the
contribution suppression flags.<BR>
<TABLE>
<TR>
<TD>Allow BOLD</TD>
<TD><INPUT type="checkbox" id="bold"></TD>
</TR>
<TR>
<TD>Allow ITALIC</TD>
<TD><INPUT type="checkbox" id="italic"></TD>
</TR>
<TR>
<TD>Allow UNDERLINED</TD>
<TD><INPUT type="checkbox" id="underlined"></TD>
</TR>
<TR>
<TD>Allow Font Changes</TD>
<TD><INPUT type="checkbox" id="font"></TD>
</TR>
<TR><TD COLSPAN="2">&nbsp;</TD></TR>
<TR>
<TD COLSPAN="2">
<INPUT type="button" value="OK"
onclick="window.external.SetValue(getvalue()); window.external.OnOK();"/>
<INPUT type="button" value="Cancel"
onclick="window.external.OnCancel();"/>

</TD>
</TR>
</TABLE>
</BODY>
]]>
</customgui>

注意:
<customgui>タグは、使用できますが、フラグメント・エディタ・ユーザー・インタフェースには表示されません。つまり、現在はサポートされていません。

6.7.4 <snippet>

<snippet>タグは、フラグメントの単一のスニペットを表します。

パラメータ

- id: フラグメント定義におけるスニペットの一意の識別子。

- location: スニペットを配置するレイアウト・ページの場所。head、topofbody、drop-pointおよびbottomofbodyの4箇所があります。

- include: スニペットをテンプレートにインクルードする方法。

- simple: スニペット・コンテンツを直接テンプレートにコピーし(フラグメント・インスタンスの詳細でスニペットをマークアップしません)、最初の挿入時にスニペット・コンテンツで%paramname%を検索してパラメータを直接インライン置換します。

- inline: スニペット・コンテンツを直接テンプレートにコピーし、フラグメント・スニペットとしてアトミックに処理され、移動、編集および削除できるように、フラグメント・インスタンス・スニペットとしてコンテンツをマークします。

- reference: ssIncludeXml()コールをテンプレートに挿入し、フラグメント・スニペットとしてアトミックに処理され、移動、編集および削除できるように、フラグメント・インスタンス・スニペットとしてそのコールをマークします。

<snippet>タグには、フラグメントの単一のアトミック・コンテンツを構成するHTMLまたはスクリプトの完全な単一のスニペットが含まれます。このスニペット・コンテンツは、CDATAセクション内に格納されます。また、このタグは、次のオプションの子タグを格納できます。

- <designview: >デザイナの設計ビューに表示されるスニペットの設計時表現。

6.7.5 <designview>

<designview>タグは、デザイナの「設計」ビューに表示されるフラグメント・スニペットのオプションの設計時ビューを表します(デフォルト表示はフラグメント名です)。このタグは、CDATAセクション内にHTMLを格納します。このタグは属性を持ちません。

たとえば、次のようになります。

<designview>
<![CDATA[
example copyright fragment goes here
]]>
</designview>

6.7.6 <element>

<element>タグは、静的リスト・フラグメント定義に格納された単純な要素を表します。<fragment>定義タグにおける<element>タグの構文は、レイアウト・ページの<region>定義タグで使用される<element>タグの構文と同じです。

静的リスト・フラグメント定義内の要素として使用できるのは、タイプ1、4、5、6（WYSIWYG、カスタム、イメージおよびプレーン・テキスト）の要素のみです。

6.8 <ssinfo> XMLデータ・アイランドのフラグメント・インスタンスの構造

フラグメント・インスタンスとそのパラメータを定義する構造は、デザイナ・アプリケーションにより<ssinfo> XMLデータ・アイランドで管理されます。データ・アイランドには、ページ・テンプレートのフラグメント・インスタンスごとに単一の<fragmentinstance>タグが含まれ、各タグにはフラグメント・インスタンス・パラメータを宣言するIdocスクリプトが含まれます。<ssinfo>データ・アイランドは、<head>スニペットを含むフラグメントがページ・テンプレートに追加された場合に使用されます。リージョン・テンプレートやサブテンプレートに追加されたフラグメントでは、<ssinfo> XMLデータ・アイランドは生成されません。

静的リストや動的リストなどの拡張フラグメント・タイプでは、<fragmentinstance>タグに追加の子タグを格納できます。これらのタグとその属性の正確な構文は、Site Studio 10gR3のテクニカル・リファレンス・ガイドを参照してください。

7 ネイティブ・ドキュメントと変換

この項の内容は次のとおりです。

- 7.1項「ネイティブ・ドキュメントについて」

- 7.2項「wcmDynamicConversion」

- 7.3項「プロパティ・ペインでのドキュメントの変換」

- 7.4項「ネイティブ・ドキュメントの使用時の一般的なエラー」

7.1 ネイティブ・ドキュメントについて

ネイティブ・ドキュメントは多くのWebサイトに含まれています。通常ネイティブ・ドキュメントの多くは、ワード・プロセシング・ファイルやプレゼンテーションですが、ほぼすべてのタイプのドキュメントをネイティブ・ドキュメントとすることができます。

ネイティブ・ドキュメントは、Webサイトに配置される場合、HTMLの文字列に変換され、リージョン・テンプレートに挿入されます。

7.2 wcmDynamicConversion

wcmDynamicConversionメソッドでは、Dynamic Converterを使用して、Webサイトで表示できるようにドキュメントをHTMLに変換します。

WCM_PLACEHOLDERサービスでネイティブ・ドキュメントを使用する場合、次のようにリージョン・テンプレートのwcmDynamicConversionタグで変換定義ファイルのdDocNameを指定する必要があります。

<!--$wcmDynamicConversion("rule1","dataFileDocName=myNativeDoc","pageNum=2",
"conversionsDefinitionDocName=convDefDocName")-->
<!--$wcmDynamicConversion("rule1","dataFileDocName=myNativeDoc","pageNum=2",
"conversionsDefinitionDocName=convDefDocName", "conversionType="simple")-->

7.3 プロパティ・ペインでのドキュメントの変換

ドキュメントの変換は、プロパティ・ペインにリストされる必要があります。ネイティブ・ドキュメントが想定どおりに変換されない最も一般的な原因は、変換が適切にリストされていないことです。

デザイナで、変換定義はプロパティ・ペインの最初のセクションにあります。サイト階層でアイテムを選択します。変換が行われるには、変換がそこにリストされている必要があります。

ただし、wcmDynamicConversionが使用される場合、パネルの変換定義にリストされたアイテムは使用されません。wcmDynamicConversionタグでは、ルールを明示的に指定できます。動的変換をリージョン定義およびリージョン・テンプレートと関連付ける(明示的にコーディングするのではなく)場合、プロパティ・ペインで変換を指定する必要があります。wcmDynamicConversionを使用する場合、使用するルールを明示的に指定するため、これは必要ありません。プロパティ・ペインの変換定義にリストされた動的変換に指定されていないルールを使用することもできます。

詳細は、『Oracle WebCenter Content Site Studio Designerユーザーズ・ガイド』を参照してください。

7.4 ネイティブ・ドキュメントの使用時の一般的なエラー

一般的に、ネイティブ・ドキュメントはSite Studioで簡単に実装できます。Site Studioは、すべての変換ルールが1つの変換定義に含まれるよう構成されています。ルールごとに異なる変換ファイルを使用することは推奨されません。すべてのルールが1つの変換定義にリストされる必要があります。

定義は、Webサイトのプロパティ・ペインの「変換定義」プロパティにリストされる必要があります。変換定義がここにリストされていないことが、Webサイトでネイティブ・ドキュメントが想定どおりに表示されない最も一般的な原因です。これは、WCM_PLACEHOLDER Idocスクリプト拡張機能を使用して変換ルールを明示的に指定する場合でも同様です。

8 カスタム要素

この項の内容は次のとおりです。

- 8.1項「カスタム要素について」

- 8.2項「要素API」

- 8.3項「コントリビュータ内のカスタム要素」

- 8.4項「レガシー・カスタム要素の互換性」

8.1 カスタム要素について

カスタム要素は、ユーザー定義のSite Studio要素です。Site Studio製品に含まれている他の要素に加え、カスタム要素によって、個々のビジネス・ニーズに合うようSite Studio製品を拡張する方法が提供されます。

コード上、カスタム要素は、基本的にはコントリビュータ・フォームのIFRAME内に存在する完全なHTMLタイプのファイル(htm、hcsp、jspなど)です。カスタム要素がSite Studio要素として正しく機能するためには、カスタム要素でAPIを使用して複数のコールバックを実装する必要があります。

8.2 要素API

カスタム要素がコントリビュータ・フォームで正しく機能するためには、カスタム要素でAPIを使用していくつかのコールバックを実装する必要があります。ElementAPIオブジェクトは、コントリビュータ・フォームとカスタム要素間の通信を支援するカスタム要素ページに明示的にロードされるJavaScriptオブジェクトです。ElementAPIにより、カスタム要素がコントリビュータ・フォームと通信するためのメソッドと、コントリビュータ・フォームがカスタム要素に通知を送信するためのコールバック・メカニズムが提供されます。

この項の内容は次のとおりです。

- 8.2.1項「要素APIのロード」

- 8.2.2項「要素API依存スクリプト」

8.2.1 要素APIのロード

ElementAPIとそのサポート・ライブラリを使用する前に、ElementAPIをカスタム要素ページにロードする必要があります。ElementAPIのロード後、カスタム要素は、ページの初期化を継続し、カスタム要素がロードされたことをコントリビュータ・フォームに通知します。

<html>
<head>
<title>Default Custom Element Form</title>
<script type="text/javascript">
function Initialize()
{
//===========================================================================
// TODO: ElementAPI is loaded. Place Custom Element initialization code here.
//===========================================================================

// Let the Contributor Form know that this Custom Element is loaded and ready.
ElementAPI.Ready();
}

// Load the ElementAPI and its supporting libraries - then call Initialize()
// Parameter 1: The Custom Element's window object. This parameter uniquely
//  identifies the Custom Element to the Contributor Form.
// Parameter 2: A function pointer. This function will be executed after the
// ElementAPI and its supporting libraries are loaded.
try {
window.top.WCM.InitializeCustomElement(window, Initialize);
} catch(e) { }
</script>
</head>
<body>
<h3>Default Custom Element Form</h3>
</body>
</html>

8.2.2 要素API依存スクリプト

ElementAPIがカスタム要素ページにロードされる際に、ElementAPI依存スクリプトもロードされます。これらのスクリプトには、JavaScript WCMライブラリのほとんどが含まれており、カスタム要素の作成に使用することもできます。次のスクリプト・ファイルがカスタム要素にロードされます。

- wcm.js

- ./base/wcm.dhtml.js

- ./base/wcm.get.js

- ./base/wcm.http.js

- ./base/wcm.popup.js

- ./sitestudio/wcm.contentserver.popup.js

- ./form/elements/wcm.elementapi.js

- ./sitestudio/elements/wcm.sitestudio.elementapi.js

- ./sitestudio/wcm.idc.js

- ./form/elements/element/wcm.element.js

- ./form/elements/custom/wcm.custom.js

他のカスタム・スクリプト同様、必要に応じてこれらを変更し、変更したスクリプトを/customディレクトリに配置できます。

8.3 コントリビュータ内のカスタム要素

コントリビュータ・フォームは、カスタム要素により実装された関数を実行することでカスタム要素と通信します。初期化プロセスの一部として、カスタム要素では、コントリビュータ・フォームにこれらの関数のポインタを渡して各関数を登録する必要があります。

この項の内容は次のとおりです。

- 8.3.1項「コントリビュータ・フォームからカスタム要素への通信」

- 8.3.2項「カスタム要素からコントリビュータ・フォームへの通信」

8.3.1 コントリビュータ・フォームからカスタム要素への通信

コントリビュータ・フォームは、カスタム要素により実装された関数を実行することでカスタム要素と通信します。初期化プロセスの一部として、カスタム要素では、コントリビュータ・フォームにこれらの関数のポインタを渡して各関数を登録する必要があります。

次に、コントリビュータ・フォームに登録できる関数を示します。これらの関数は、いずれもカスタム要素により実装する必要はありませんが、コントリビュータ・ユーザーからデータを収集して保存する場合は、いくつかの関数が必要になります。また、IsDirty()関数以外のすべての関数は、実行されると、タスク完了時の実行のためにコールバック関数のポインタを渡されます。これにより、実行時にカスタム要素で非同期タスクを実行する必要がある場合に、非同期通信を行うことができます。

関数

説明

CanCloseElement(callback);

コントリビュータ・フォームは、コントリビュータが要素内の情報を更新したときにこのメソッドを実行します。関数の実装では、カスタム要素を安全に閉じることができるかどうかを評価する必要があります。たとえば、データが検証に合格しない場合、カスタム要素が閉じられないことを示す必要があります。

GetElementContent(callback);

コントリビュータ・フォームは、コントリビュータが要素内の情報を更新したときにこのメソッドを実行します。関数の実装では、保存される文字列コンテンツを戻す必要があります。

Hide(callback);

コントリビュータ・フォームは、カスタム要素の上にHTML要素をオーバーレイ表示するDHTMLタスクをフォームで実行するときに常にこのメソッドを実行します。たとえば、このメソッドは、「メタデータ」タブがアクティブ化され、コントリビュータ要素が隠れたときに実行されます。
このメソッドは、特にEphoxベースの要素向けに導入されています（Javaアプレットには常にtop z-indexが含まれるため）。他のすべての要素（HTMLベースの要素）では、このメソッドを無視できます。

Show(callback);

コントリビュータ・フォームは、カスタム要素を再表示する(オーバーレイを削除する)DHTMLタスクをフォームで実行するときに常にこのメソッドを実行します。
このメソッドは、特にEphoxベースの要素向けに導入されています（Javaアプレットには常にtop z-indexが含まれるため）。他のすべての要素（HTMLベースの要素）では、このメソッドを無視できます。

IsDirty();

コントリビュータ・フォームは、フォーム・ポップアップが閉じられるときに常にこのメソッドを実行します。カスタム要素は、未保存の変更があるかどうかを評価して、保存していない変更がある場合はコントリビュータ・ユーザーに通知します。

次に、カスタム要素がコントリビュータ・フォームに関数を登録する方法を示すJavaScriptのコード例を示します。

function CanCloseElement(callback)
{
// No data validation in this sample - just pass back a true value.
callback({canClose: true});

// Here is an example of passing a false value
// callback({canClose: false, reason: 'Failed validation. Use only lowercase
// letters.'};
}

function GetElementContent(callback)
{
// Pass back some sample content for demo purposes.
callback('This is my Custom Element Content.');
}

function Show(callback)
{
// Just handle this notification by executing the callback.
callback();
}

function Hide(callback)
{
// Just handle this notification by executing the callback.
callback();
}

function IsDirty()
{
// This Custom Element is never dirty - so pass a false value.
return {isDirty: false};
}

// Set callback methods for the Contributor Form to send notifications to this Element.
ElementAPI.SetCallback('CanCloseElement', CanCloseElement);
ElementAPI.SetCallback('GetElementContent', GetElementContent);
ElementAPI.SetCallback('Show', Show);
ElementAPI.SetCallback('Hide', Hide);
ElementAPI.SetCallback('IsDirty', IsDirty);

8.3.2 カスタム要素からコントリビュータ・フォームへの通信

カスタム要素では、ElementAPI JavaScriptオブジェクトを使用してコントリビュータ・フォームとの通信を開始します。次に、使用可能なElementAPIメソッドのリストを示します。

関数

説明

ElementAPI.GetDefaultData();

データ・ファイルに格納されたデフォルト・コンテンツを取得します。

ElementAPI.SetHostHeight(height);

IFRAMEを格納する要素の高さを設定します。

ElementAPI.SetRequiredIndicator(isRequired);

コントリビュータ・フォーム・ユーザー・インタフェースで「Required」グラフィック・インジケータを切り替えます。

ElementAPI.GetSite(options);

Webサイトの選択選択ユーザー・インタフェースを表示します。

ElementAPI.GetSection(options);

Webサイト・セクションの選択選択ユーザー・インタフェースを表示します。

ElementAPI.GetColor(options);

「色」選択ユーザー・インタフェースを表示します。

ElementAPI.GetFont(options);

フォントの取得選択ユーザー・インタフェースを表示します。

ElementAPI.GetSearchResults(options);

Oracle Content Serverの検索結果の取得ページを表示します。

ElementAPI.GetQueryText(options);

問合せテキストの取得ユーザー・インタフェースを表示します。

ElementAPI.CaptureQuery(options);

Oracle Content Serverの「問合せの取得」ページを表示します。

ElementAPI.GetHyperlink(options);

ハイパーリンク・ウィザード・ユーザー・インタフェースを表示します。

ElementAPI.FocusForm(options);

親ウィンドウにフォーカスし、要素ウィンドウを隠蔽します。

8.4 レガシー・カスタム要素の互換性

リリース10gR3 (10.1.3.3.2)以前のSite Studioで作成されたカスタム要素フォームはすべて、Site Studio 11gR1と互換性がなく、手動でアップグレード(再作成)する必要があります。下位互換性が維持されていない主な理由は、以前のSite StudioがInternet Explorerの独自仕様のwindow.external機能に依存しているためです。Site Studioリリース10gR3以前に使用されていたカスタム要素のwindow.external機能はコードの実行時にブロックされ、クロスブラウザおよびクロスプラットフォームのDHTMLソリューションで簡単に複製されません。

下位互換性をなくしたことによるメリットは、現在のカスタム要素がより一層柔軟になり、(クロスブラウザおよびクロスプラットフォーム・ソリューションであることに加え)コントリビュータ・アプリケーション・アーキテクチャに緊密に統合されることです。

この項の内容は次のとおりです。

- 8.4.1項「レガシー・カスタム要素フォームの検出」

- 8.4.2項「レガシー・カスタム要素のアップグレード」

8.4.1 レガシー・カスタム要素フォームの検出

10gR3 (10.1.3.3.2)以前のSite Studioを使用して作成されたカスタム要素フォーム(レガシー・カスタム要素フォーム)は、SSValidateCustomElementsフラグをtrueに設定してコントリビュータ・アプリケーションにロードされると、検出されます。コントリビュータ・フォームの当該する場所にエラー・メッセージが表示されます。

コントリビュータ・アプリケーションは、これを行うために、まずカスタム要素フォームをダウンロードし、ソース・コードを解析して、カスタム要素フォームが新しいコントリビュータ・アプリケーションと互換性があるかどうかを確認します。

レガシー・カスタム要素フォームを検出する機能とオーバーヘッドは、本番インストールでは必要ないため、この機能はデフォルトではオフです。レガシー・カスタム要素フォームの検出機能を有効にするには、次の行をOracle Content Serverのconfig.cfgファイルに追加して、サーバーを再起動します。

SSValidateCustomElements=true

8.4.2 レガシー・カスタム要素のアップグレード

10gR3 (10.1.3.3.2)以前のSite Studioを使用して作成されたカスタム要素フォームは、Site Studio 11gR1と互換性がありません。手動でアップグレードし、再作成する必要があります。下位互換性が維持されていない主な理由は、以前のSite StudioがInternet Explorerの独自仕様のwindow.external機能に依存している(レガシー・コントリビュータ・アプリケーションに使用されているActiveXコントロールによる)ためです。Site Studio 10gR3 (10.1.3.3.3)以上(10gR4および11gR1を含む)で使用されているブラウザに依存しないJavaScriptベースのコントリビュータ・アプリケーションの結果、この機能はSite Studioから削除されました。

9 Idocスクリプト拡張機能

Site Studioでは、Webサイトを実行するために複数のIdocスクリプト拡張機能を使用します。

- 9.1項「Idocスクリプト拡張機能について」

- 9.2項「wcmPlaceholder」

- 9.3項「wcmElement」

- 9.4項「wcmListStart」

- 9.5項「wcmListEnd」

- 9.6項「wcmListElement」

- 9.7項「wcmListRowCount」

- 9.8項「wcmDynamicList」

- 9.9項「wcmIncludeElement」

- 9.10項「wcmDynamicConversion」

- 9.11項「wcmGetListAsResultSet」

- 9.12項「wcmFragment」

- 9.13項「wcmUrl」

- 9.14項「ssIncludeXml」

- 9.15項「ssGetDocInfo」

- 9.16項「ssGetXmlNodeCount」

- 9.17項「ssIncDynamicConversion」

- 9.18項「ssIncDynamicConversionByRule」

- 9.19項「ssIncDynamicConversionByRulesEngine」

- 9.20項「ssIncInlineDynamicConversion」

- 9.21項「ssIsNativeDoc」

- 9.22項「ssRandom」

- 9.23項「ssGetNodeProperty」

- 9.24項「ssGetWebsiteNodeType」

- 9.25項「ssGetCoreMajorVersion」

- 9.26項「ssSplitString」

- 9.27項「ssGetWebsiteName」

- 9.28項「ssGetSiteProperty」

- 9.29項「ssGetFirstNodeId」

- 9.30項「ssGetRelativeNodeId」

- 9.31項「ssLoadSiteNavResultSet」

- 9.32項「ssGetServerRelativeUrl」

- 9.33項「ssGetServerRelativePath」

- 9.34項「ssGetUrlPageName」

- 9.35項「ssGetNodeLabel」

- 9.36項「ssGetNodeLabelPath」

- 9.37項「ssGetAllSites」

- 9.38項「ssLink」

- 9.39項「ssNodeLink」

- 9.40項「ssWeblayoutUrl」

注意:
これらのスクリプト拡張機能は、Site Studioの各リリースで変更される可能性があります。

9.1 Idocスクリプト拡張機能について

Idocスクリプトは、Oracle Content Server用のサーバー側カスタムスクリプト言語です。変数の参照、HTMLページへの条件によるコンテンツのインクルードおよび問合せによって返される結果でのループを行えます。

コンポーネントがOracle Content Serverにインストールされると、コンポーネントによってIdocスクリプトと変数に拡張機能が追加され、更なるカスタマイズが可能になります。

Idocスクリプトは、主にHTMLテンプレートのプレゼンテーションと構成設定に使用されます。Site Studioコンポーネントによって、この項で説明する多くのスクリプト拡張機能が追加されます。

9.2 wcmPlaceholder

説明

wcmPlaceholder()関数は、コンテンツを含めるページ上の領域を定義します。プレースホルダが表示する実際のコンテンツは、プレースホルダに関連付けられているデータ・ファイル、サブテンプレートおよびその他のWebサイト・オブジェクトによって異なります。

パラメータ

- placeholderName: プレースホルダの名前。必須。

- dataFileDocName: プレースホルダに関連付けるデータ・ファイルのdDocName。

- templateDocName: プレースホルダに関連付けるリージョン・テンプレートまたはサブテンプレートのdDocName。

- placeholderDefinitionDocName: プレースホルダにマップするプレースホルダ定義のdDocName。

- regionDefinitionDocName: templateDocNameで指定されたリージョン・テンプレートに関連付けるリージョン定義のdDocName。

- placeholderActions: プレースホルダ定義の許可されるアクション。次のものがあります。

- Eは、コントリビュータの更新を許可します。

- Pは、ワークフローの承認を許可します。

- Rは、ワークフローの却下を許可します。

- Iは、docInfoの表示を許可します。

- Sは、データ・ファイルの切替えを許可します。

- Uは、Web使用状況レポートの表示を許可します。

- Tは、Webトラッカ・レポートの表示を許可します。

- Mは、docInfoの更新を許可します。

- Vは、リージョン・テンプレートの切替えを許可します。

- Nは、コンテンツの削除を許可します。

各選択肢は、デザイナのプレースホルダ定義の設計ビューにあるアクションのチェックボックスに対応します。

同時に使用できないパラメータを使用する(たとえば、サブテンプレートとリージョン定義を指定するなど)と、スクリプトは、ここでリストされたパラメータの順序に基づいて実行します。

サンプル・コード

<!--$wcmPlaceholder("placeholderName")-->

<!--$wcmPlaceholder("placeholderName","dataFileDocName=dDocName", "templateDocName=[region template dDocName|subtemplate dDocName]","placeholderDefinitionDocName=dDocName",
"regionDefinitionDocName=dDocName", placeholderActions=EPRISUTMVN")-->

9.3 wcmElement

説明

wcmElement()スクリプトは、リージョン・テンプレートに要素を挿入します。要素は、リージョン定義にリストされる必要はありません。

このスクリプトによって、指定された要素に関連付けられているコンテンツをデータ・ファイルから取得できます。これは、WYSIWYG、イメージ、テキストおよびカスタム要素のみを対象とします。挿入される要素のコンテンツは、現在のレイアウト・ページの有効範囲で詳細に評価され、必要に応じて追加のサーバー側Idocスクリプトがインクルードされます。

パラメータ

- dDocName: elementNameを含むデータ・ファイルのdDocName。dDocNameが指定されない場合、プレースホルダに関連付けられている現在のデータ・ファイルが使用されます。

- elementName: 要素の名前。必須。

サンプル・コード

<!--$wcmElement("elementName")-->

<!--$wcmElement("dDocName", "elementName")-->

9.4 wcmListStart

説明

この関数は、リスト要素の始まりを定義します。

パラメータ

- elementName: リスト要素の名前。必須。

サンプル・コード

<!--$wcmListStart("elementName")-->

9.5 wcmListEnd

説明

この関数は、リスト要素の終わりを定義します。

パラメータ

- elementName: リスト要素の名前。必須。

サンプル・コード

<!--$wcmListEnd("elementName")-->

9.6 wcmListElement

説明

これは、wcmElementと同じ機能ですが、静的リスト要素のコンテンツをリージョン・テンプレートに配置するためのものです。このスクリプトによって、指定された静的リスト要素に関連付けられているコンテンツをデータ・ファイルから取得できます。挿入される要素のコンテンツは、現在のレイアウト・ページの有効範囲で詳細に評価され、必要に応じて追加のサーバー側Idocスクリプトがインクルードされます。

パラメータ

- listName: リスト要素の名前。wcmListElementがwcmListStartとwcmListEndの間で使用される場合、listNameを省略できます。

- elementName: listElementの作成に使用されるリスト内の要素の名前。

- rowNum: listName内のelementNameの行位置。

サンプル・コード

<!--$wcmListElement("Wysiwyg", rowNum)-->

前述の例では、elementNameおよびrowNumのみ使用しています。

コンテキスト内の例:

<!--$wcmListStart("StaticList")-->
<!--$wcmListIndex = 0-->
<!--$wcmListNumRows = wcmListRowCount()-->
<table><!--$loopwhile wcmListIndex < wcmListNumRows-->
<tr>
<td><!--$wcmListElement("Wysiwyg", wcmListIndex)--></td>
<td><!--$wcmListElement("plaintext", wcmListIndex)--></td>
</tr>
<!--$wcmListIndex = wcmListIndex + 1-->
<!--$endloop--></table>
<!--$wcmListEnd("StaticList")-->

9.7 wcmListRowCount

説明

このスクリプトは、リスト要素の行の数を取得します。整数値が返されます。

パラメータ

- listName: リスト要素の名前。wcmListRowCountがwcmListStartとwcmListEndの間で使用される場合、listNameを省略できます。

サンプル・コード

<!--$wcmListRowCount("listName")-->

コンテキスト内の例:

<!--$wcmListStart("listName")-->
<!--$wcmListIndex = 0-->
<!--$wcmListNumRows = wcmListRowCount()-->
<table><!--$loopwhile wcmListIndex < wcmListNumRows-->
<tr>
<td><!--$wcmListElement("Wysiwyg", wcmListIndex)--></td>
<td><!--$wcmListElement("plaintext", wcmListIndex)--></td>
</tr>
<!--$wcmListIndex = wcmListIndex + 1-->
<!--$endloop--></table>
<!--$wcmListEnd("listName")-->

9.8 wcmDynamicList

説明

指定された動的リスト要素から検索パラメータを取得して、SS_GET_SEARCH_RESULTSをコールするためのサービス・バインダの準備をします。成功または失敗を示すブール値を返します。

パラメータ

- elementName: listElementの作成に使用されるリスト内の要素の名前

戻り値

これは、成功または失敗を示すブール値を返します。

サンプル・コード

<!--$wcmDynamicList("elementName")-->

コンテキスト内の例:

<!--$if wcmDynamicList("dynamicList")-->
<!--$executeService("SS_GET_SEARCH_RESULTS")-->
<!--$loop SearchResults-->
<!--$xml(dDocTitle)--><br />
<!--$endloop-->
<!--$endif-->

9.9 wcmIncludeElement

説明

このスクリプトは、要素のコンテンツがリージョンのコンテキスト外に表示されることを許可します。要素がリージョンのコンテキスト(つまり、リージョン・テンプレート)にある場合、そのリージョン・テンプレートに基づいて暗黙的にデータ・ファイルが関連付けられます。

wcmIncludeElementを使用すると、要素がリージョンのコンテキスト外にある場合に強制的にデータ・ファイルを関連付けられます。

パラメータ

- dDocName: データ・ファイルのdDocName。

- expression: XPath式(XMLデータ・ファイルの1つ以上の特定ノードを識別する式)

戻り値

要素のコンテンツが返されます。

サンプル・コード

queryVal = <!--$wcmIncludeElement("datafiledDocName", "wcm:root/wcm:element[@name='elementName']/node()")-->

9.10 wcmDynamicConversion

説明

ネイティブ・ドキュメントの動的変換の作成に使用されます。

パラメータ

- ruleName: ConversionsDefinitionファイルで定義されたルールの名前。必須。

- dataFileDocName: 変換するネイティブ・ドキュメントのdDocName。

- pageNum: 変換するネイティブ・ドキュメント内のページ番号。

- conversionsDefinitionDocName: 変換定義のdDocName。

- conversionType: 使用可能なタイプ値は、simple、full、rule、engineまたはcommandです。

- conversionTemplate: テンプレートのdDocName。conversionType="full"を使用する場合にのみ有効です。

- conversionLayout: レイアウトのdDocName。conversionType="full"を使用する場合にのみ有効です。

- conversionRuleName: ルールの名前。conversionType="rule"を使用する場合にのみ有効です。

- conversionCommand: ページのコンテキストで実行されるIdocスクリプトの断片。conversionType="command"を使用する場合にのみ有効です。

戻り値

パラメータに基づいて動的変換で生成されたHTML。

サンプル・コード

デフォルトの使用:

<!--$wcmDynamicConversion("ruleName")-->

タイプ値のインクルード:

<!--$wcmDynamicConversion("ruleName","dataFileDocName=dDocName","pageNum=number","conversionsDefinitionDocName=dDocName", "conversionType=engine")-->

9.11 wcmGetListAsResultSet

説明

このタグは、静的リスト・コンテンツおよびResultSetとして使用可能なコンテンツの取得に使用されます。

パラメータ

- dDocName: コントリビュータ・データ・ファイルのdDocName名。これが省略された場合、現在のデータ・ファイルが使用されます。

- listName: リスト要素の名前。必須。

- resultSetName: 作成するResultSetの名前。これが省略された場合、ResultSet名はlistNameと同じです。

- evaluateList: リスト要素のIdoc式を評価するかどうかを示すブール値。デフォルトは、trueです。

戻り値

これは、成功または失敗を示すブール値を返します。

サンプル・コード

<!--$wcmGetListAsResultSet("dDocName","List_Element","name_of_ResultSet","false")-->
<!--$wcmGetListAsResultSet("List_Element", "name_of_ResultSet")-->

9.12 wcmFragment

説明

このタグは、フラグメントを追加するためにテンプレートで使用されます。タグがリージョン・テンプレートまたはサブテンプレートで使用される場合、最初のドロップポイント・スニペットのみが使用されます。

パラメータ

- fragmentInstanceId: ページ上のフラグメント・インスタンスのID。動的リストなど複数ページを返すフラグメントの区別に使用されます。IDによって、動的リストで問合せ結果の異なるページを表示できます。たとえば、あるフラグメントは問合せ結果の1ページ目で、他のフラグメントは独自の結果の3ページ目を表示できます。両方のフラグメントに同じIDが使用されている場合、一方の問合せの結果の特定のページに移動するようクリックすると、他方のフラグメントで独自の結果の同じ番号のページが表示されます。

- fragmentDocName: フラグメント・ライブラリのdDocName。

- fragmentId: 指定されたライブラリ内のフラグメントのID。

- snippetId: 指定されたフラグメント内のスニペットのID。

- tagProperties: フラグメントのプロパティの名前付き値ペア。

サンプル・コード

<!--$wcmFragment("fragmentInstanceID", "fragmentDocName", "fragmentID", "snippetID", "ssTheme=default", "ssHoverColor=", "ssTextColor=", "ssFocusColor=", "ssShowHome=true", "ssShowNext=false", "ssClassName=IDocNavTabsTop")-->

9.13 wcmUrl

説明

これは、すべてのリンク形式の作成に使用される単一スクリプトです。レガシー・サイトでは、Site Studioで使用可能な異なるタイプのリンクを生成するために3つの異なるスクリプトが必要でした。

パラメータ

- type: リンクのタイプ。nodelink、link、resourceまたはrenditionのいずれかが入力されます。

- nodelinkはセクションへのリンクの作成に使用されます。リンクは、デフォルトではindex.htmで終わります。

- linkはコンテンツへのリンクの作成に使用されます。リンクは、デフォルトではcontentIdで終わります。

- resourceは、イメージなどのweblayout静的リソースへのリンクに使用されます。

- renditionは、Digital Asset Manager (DAM)レンディションへのリンクに使用されます。

- nodeId: 参照されるノードのID。タイプがnodelinkまたはlinkのいずれかに設定されている場合にのみ使用されます。

- siteId: 参照されるWebサイトのサイトID。タイプがnodelinkまたはlinkのいずれかに設定されている場合にのみ使用されます。

- dDocName: 参照されるコンテンツのdDocName。タイプがlinkまたはresourceのいずれかに設定されている場合にのみ使用されます。

- path: 参照されるコンテンツのパス。タイプがlinkまたはresourceのいずれかに設定されている場合にのみ使用されます。

- renditionName: リンクされるレンディションの名前。タイプがrenditionに設定されている場合にのみ使用されます。

サンプル・コード

セクションへのリンク: デフォルトでは、これらのリンクはindex.htmで終わります。

<!--$wcmUrl('nodelink',nodeId)-->
<!--$wcmUrl('nodelink',nodeId,siteId)-->

コンテンツへのリンク: デフォルトでは、これらのリンクはcontentIdで終わります。

<!--$wcmUrl('link','dDocName')-->
<!--$wcmUrl('link','dDocName','nodeId')-->
<!--$wcmUrl('link','dDocName",'nodeId','siteId')-->

イメージなどのweblayout静的リソースへのリンク:

<!--$wcmUrl('resource','dDocName')-->
<!--$wcmUrl('resource','groups/public/documents/adacct/mydocname.jpg')-->

9.40項「ssWeblayoutUrl」も参照してください。

DAMレンディションへのリンク:

<!--$wcmUrl('rendition', dDocName, 'smallimage')-->

9.14 ssIncludeXml

説明

このスクリプト拡張機能は、管理対象XMLファイル内の任意の要素を抽出してIdoc文字列変数で返すことができるSite Studioのコア・メソッドです。Idoc文字列変数は、HTMLスニペットとしてWebページ上に直接配置できます。抽出されるXMLノードのコンテンツは、現在のレイアウト・ページの有効範囲で詳細に評価され、必要に応じて追加のサーバー側Idocスクリプトがインクルードされます。

パラメータ

- dDocName: XMLデータ・ファイルのdDocName。

- expression: XPath式(XMLデータ・ファイルの1つ以上の特定ノードを識別する式)

戻り値

Xpathにリストされた要素のコンテンツ。

サンプル・コード

<!--$ssIncludeXml("dDocName", "expression"-->

<!--$ssIncludeXml("dDocName", "wcm:portal/wcm:element[@name = "eleName"]/node()"-->

9.15 ssGetDocInfo

説明

このスクリプト拡張機能は、指定されたdDocNameのDOC_INFO結果セットを取得します。

パラメータ

- dDocName: DOC_INFOが取得されるドキュメントの識別子。

戻り値

操作の成功を示すブール値。

サンプル・コード

<!--$ssGetDocInfo("MyDocName")-->

<!--$if ssGetDocInfo("MyDocName")-->
<!--$endif-->

9.16 ssGetXmlNodeCount

説明

このスクリプト拡張機能は、管理対象XMLファイルにおける特定の要素の反復インスタンスの数を返します。この拡張機能は、反復コントリビューション要素のセットを表示するために、静的リスト・フラグメントの実装で主に使用されます。

パラメータ

- dDocName: XMLデータ・ファイルのdDocName。

- expression: XPath式(XMLデータ・ファイルの1つ以上の特定ノードを識別する式)

戻り値

リスト内の行の数を示す整数値。

サンプル・コード

<!--$ssGetXmlNodeCount("dDocName", "expression"-->

<!--$ssGetXmlNodeCount("dDocName", 'wcm:portal/wcm:element[@name = "eleName"]'-->

9.17 ssIncDynamicConversion

説明

このスクリプト拡張機能は、ネイティブ・ドキュメントの動的変換を実行するために使用できます。この変換で生成されるHTMLは、HTMLスニペットの形式でWebページ上に直接配置できるIdoc文字列変数で返されます。このメソッドでは、コール元は、使用する管理対象変換テンプレートおよび変換レイアウトを指定できます。

パラメータ

- dDocName1: 変換するネイティブ・ドキュメントのdDocName。

- dDocName2: 変換に使用するテンプレートのdDocName。

- dDocName3: 変換に使用するレイアウト・テンプレートのdDocName。

- dcPageNum: 変換するドキュメントのページ番号(オプション)。

戻り値

ドキュメント変換のHTML文字列スニペット。

サンプル・コード

<!--$ssIncDynamicConversion("dDocName1", "dDocName2", "dDocName3", "3")-->

9.18 ssIncDynamicConversionByRule

説明

このスクリプト拡張機能は、ssIncDynamicConversion拡張機能と同様に、ネイティブ・ドキュメントの動的変換を実行するために使用できます。この変換で生成されるHTMLは、HTMLスニペットの形式でWebページ上に直接配置できるIdoc文字列変数で返されます。

ssIncDynamicConversionとは異なり、この拡張機能では、使用する変換テンプレートを決定するためにDynamic Converterルール・エンジンで指定されたルールを使用します。したがって、コール元は、管理対象変換テンプレートまたは変換レイアウトを指定する必要がありません。

パラメータ

- dDocName: 変換するネイティブ・ドキュメントのdDocName。

- rule: 使用するDynamic Converterルールの名前。

- dcPageNum: 変換するドキュメントのページ番号(オプション)。

戻り値

ドキュメント変換のHTML文字列スニペット。

サンプル・コード

<!--$ssIncDynamicConversionByRule("dDocName", "rule", "1")-->

9.19 ssIncDynamicConversionByRulesEngine

説明

このスクリプト拡張機能は、ssIncDynamicConversion拡張機能と同様に、ネイティブ・ドキュメントの動的変換を実行するために使用できます。この変換で生成されるHTMLは、HTMLスニペットの形式でWebページ上に直接配置できるIdoc文字列変数で返されます。

ssIncDynamicConversionとは異なり、この拡張機能では、使用する変換テンプレートを決定するために標準のDynamic Converterルール・エンジンを使用します。したがって、コール元は、管理対象変換テンプレートまたは変換レイアウトを指定する必要がありません。

パラメータ

- dDocName: 変換するネイティブ・ドキュメントのdDocName。

- dcPageNum: 変換するドキュメントのページ番号(オプション)。

戻り値

ドキュメント変換のHTML文字列スニペット。

サンプル・コード

<!--$ssIncDynamicConversionByRulesEngine("dDocName", "1")-->

9.20 ssIncInlineDynamicConversion

このスクリプト拡張機能は、ssIncDynamicConversion拡張機能と同様に、ネイティブ・ドキュメントの動的変換を実行するために使用できます。この変換で生成されるHTMLは、HTMLスニペットの形式でWebページ上に直接配置できるIdoc文字列変数で返されます。ssIncDynamicConversionとは異なり、この拡張機能では、動的変換用に空白の組込みテンプレートを使用するため、コール元は管理対象変換テンプレートまたは変換レイアウトを指定する必要がありません。

パラメータ

- dDocName: 変換するネイティブ・ドキュメントのdDocName。

- dcPageNum: 変換するドキュメントのページ番号(オプション)。

戻り値

ドキュメント変換のHTML文字列スニペット。

サンプル・コード

<!--$ssIncInlineDynamicConversion("dDocName", "1")-->

9.21 ssIsNativeDoc

説明

このスクリプト拡張機能は、管理対象ドキュメントが、動的変換を実行できるネイティブ・ドキュメントであるか、変換の不要なコントリビュータ・データ・ファイルであるかを検出するために使用できます。

比較はネイティブ・ドキュメントの選択テストではなく、データ・ファイルの除外テストです。yesという結果が返された場合、ドキュメントはデータ・ファイルではないとみなされたということです。

パラメータ

- dDocName: テストするドキュメントのdDocName。

戻り値

ブール値[1 | 0]。

サンプル・コード

<!--$Variable = ssIsNativeDoc("dDocName")-->

9.22 ssRandom

説明

このスクリプト拡張機能は、乱数を生成するために使用します。

パラメータ

パラメータはありません。

戻り値

負ではない整数の乱数。

サンプル・コード

<!--$ssRandom()-->
<!--$Variable = ssRandom()-->

9.23 ssGetNodeProperty

説明

このスクリプト拡張機能は、現在のセクションまたは明示的に指定したセクションのノード・プロパティを取得するために使用できます。通常は、カスタム・ノード・プロパティへのアクセスに使用します。

パラメータ

- nodeId: 問い合せるセクションのnodeId(オプション)。省略された場合、現在のセクションが使用されます。

- name: プロパティ名。

戻り値

指定されたプロパティの値を返します。"label"が使用された場合、セクション・ラベルが返されますが、他のプロパティも指定できます。

サンプル・コード

たとえば、次のコマンドでは、現在のセクションのセクション・ラベルを取得します。

<!--$ssGetNodeProperty('label')-->

また、次のコマンドでは、セクション474のセクション・ラベルを取得します。

<!--$ssGetNodeProperty('474', 'label') -->

9.24 ssGetWebsiteNodeType

説明

このスクリプト拡張機能は、サイト・ノード(階層のルート)と通常のセクション・ノードの違いを判別するために使用できます。また、ASPサイトとASP以外のサイト（またはセクション・ノード）の違いも判別できます。

パラメータ

- siteId: 問い合せるWebサイトのsiteId(オプション)。

- nodeId: 問い合せるセクションのnodeId。

戻り値

戻り値は次のいずれかです。

- 0: HCSP/JSPタイプのサイトのサイト・ノード。

- 2: HCSP/JSPタイプのサイトのセクション・ノード。

- 100: ASPタイプのサイトのサイト・ノード。

- 102: ASPタイプのサイトのセクション・ノード。

サンプル・コード

<!--$ssGetWebsiteNodeType("siteId", "nodeId")-->
<!--$Variable = ssGetWebsiteNodeType("nodeId")-->

9.25 ssGetCoreMajorVersion

説明

このスクリプト拡張機能は、基礎となるコンテンツ・サーバーのメジャー・バージョンを取得するために使用できます。

パラメータ

パラメータはありません。

戻り値

Oracle Content Serverのメジャー・バージョン番号。

サンプル・コード

<!--$Variable = ssGetCoreMajorVersion()-->

9.26 ssSplitString

説明

このスクリプト拡張機能は、指定したデリミタに基づいて文字列をセグメントに分割するために使用できます。

パラメータ

- string: 分割する文字列。

- delimiter: 文字列の分割に使用するデリミタ(","など)。

- name: 分割操作の結果を格納する結果セットの名前。

戻り値

戻り値は、指定した文字列から切り出されたセグメントの数を示す整数です。この拡張機能では、分割文字列をリストしたStringという名前の1つの列を持つResultSetも生成されます。

サンプル・コード

<!--$ssSplitString("ABC;123;XYZ" , ";" , "StorageRows")-->

9.27 ssGetWebsiteName

説明

このスクリプト拡張機能は、コンテンツ・サーバーで任意のWebサイトのWebサイト名を取得するために使用できます。

パラメータ

パラメータは次のとおりです。

- siteId: Webサイトの一意の識別子。

戻り値

siteIdのWebサイト名(ラベル)。

サンプル・コード

<!--$ssGetWebsiteName("siteId")-->

9.28 ssGetSiteProperty

説明

このスクリプト拡張機能は、コンテンツ・サーバーで任意のWebサイトのサイト・プロパティを取得するために使用できます。

パラメータ

- siteId: Webサイトの一意の識別子。

- propertyName: 必要な値を保持するプロパティの名前。

戻り値

propertyNameにリストしたプロパティ(文字列)。

サンプル・コード

<!--$ssGetSiteProperty("siteId" , "propertyName")-->

9.29 ssGetFirstNodeId

説明

このスクリプト拡張機能は、コンテンツ・サーバーで任意のWebサイトのルート・ノードの識別子(nodeId)を取得するために使用できます。

パラメータ

- siteId: Webサイトの一意の識別子。

戻り値

最初のノードのID。

サンプル・コード

<!--$Variable = ssGetFirstNodeId("siteId")-->

9.30 ssGetRelativeNodeId

説明

このスクリプト拡張機能は、特定のノードを基準としてノードの識別子(nodeId)を取得するために使用できます。

パラメータ

- siteId: Webサイトの一意の識別子。

- nodeId: コンテキスト・ノードの一意の識別子。

- relative: 関係。child、parent、priorまたはnextのいずれかである必要があります。

- respectContribOnly: ブール値。デフォルトはyesです(オプション)。

戻り値

コンテキスト・ノードと指定された関係を持つノードのnodeId。指定された関係を持つノードがない場合、空の文字列。

サンプル・コード

<!--$Variable = ssGetRelativeNodeId("siteId" , "nodeId" , "child" , "no")-->

9.31 ssLoadSiteNavResultSet

説明

このスクリプト拡張機能は、コンテンツ・サーバーの任意のWebサイトに対応するアクティブ階層を含むSiteStudioNavNodesというResultSetを、Idoc実行環境に作成するために使用できます。

パラメータ

- siteId: Webサイトの一意の識別子。

戻り値

SiteStudioNavNodesと呼ばれるWebサイト階層のResultSet。

"SiteStudioNavNodes" ResultSetは、構成フラグSSAdditionalNavResultSetFieldsの設定に応じて5つ以上の列を持ちます(詳細は、12.14項「SSAdditionalNavResultSetFields」を参照)。

- nodeId: ノードの一意の識別子。

- parentNodeId: 親ノードの一意の識別子。

- label: ノードのラベル。

- level: サイト階層におけるノードの深さ。ルート・セクションのレベルは0（ゼロ）です。

- href: ノードのプライマリ・ページに対するパス・ベースのサイト相対URL。

サンプル・コード

<!--$ssLoadSiteNavResultSet("siteId")-->

9.32 ssGetServerRelativeUrl

説明

このスクリプト拡張機能は、指定したノードのプライマリ・レイアウトに対するサーバー相対URLを生成するために使用できます。この相対URLには、末尾のurlPageName(通常はindex.htm)が含まれます。

パラメータ

- siteId: Webサイトの一意の識別子。

- nodeId: ノードの一意の識別子。

戻り値

サーバーを基準とした完全フレンドリURL。

サンプル・コード

<!--$ssGetServerRelativeUrl("siteId" , "nodeId")-->

9.33 ssGetServerRelativePath

説明

このスクリプト拡張機能は、指定したノードのプライマリ・レイアウトに対するサーバー相対URLを生成するために使用できます。この相対URLには、末尾のurlPageName(通常はindex.htm)は含まれません。

パラメータ

- siteId: Webサイトの一意の識別子。

- nodeId: ノードの一意の識別子。

戻り値

ページ名を含まない、サーバーを基準とした完全フレンドリURL。

サンプル・コード

<!--$ssGetServerRelativePath("siteId" , "nodeId")-->

9.34 ssGetUrlPageName

このスクリプト拡張機能は、指定したノードのurlPageNameを取得するために使用できます。

パラメータ

- siteId: Webサイトの一意の識別子。

- nodeId: ノードの一意の識別子。

戻り値

ノードのurlPageName。通常これはindex.htmです。

サンプル・コード

<!--$ssGetUrlPageName("siteId")-->

9.35 ssGetNodeLabel

説明

このスクリプト拡張機能は、指定したノードのラベルを取得するために使用できます。

パラメータ

- siteId: Webサイトの一意の識別子。

- nodeId: ノードの一意の識別子。

戻り値

指定されたノードのラベル。

サンプル・コード

<!--$ssGetNodeLabel("siteId" , "nodeId")-->

9.36 ssGetNodeLabelPath

説明

このスクリプト拡張機能は、GUIラベルに使用できる、Webサイトのルートを基準とする「/」区切りの文字列(/products/servers/web serverなど)を取得するために使用できます。

パラメータ

- siteId: Webサイトの一意の識別子。

- nodeId: ノードの一意の識別子。

戻り値

スクリプトは、指定されたWebサイトの指定されたノードのフォルダを表す"/"で区切られた文字列を返します。

サンプル・コード

<!--$ssGetNodeLabelPath("siteId" , "nodeId")-->

9.37 ssGetAllSites

説明

このスクリプト拡張機能は、使用可能なすべてのWebサイトのリストを含むResultSetを生成するために使用できます。

パラメータ

- resultSetName: 生成するResultSetの名前。

戻り値

サーバー上の使用可能なすべてのWebサイトのリストがResultSetで返されます。

サンプル・コード

<!--$ssGetServerRelativePath("resultSetName")-->

9.38 ssLink

説明

このスクリプト拡張機能は、指定されたドキュメントに対するパス・ベースのURLを生成するために使用します。これは非推奨で、wcmUrlが推奨されます(9.13項「wcmUrl」を参照)。

詳細は、4.3項「サーバー側スクリプト・リンクの使用」を参照してください。

パラメータ

- dDocName: 管理対象アイテムのdDocName。

- targetNodeId: ターゲット・コンテキストとして使用するノードの一意の識別子（オプション）。

- targetSiteId: ターゲット・コンテキストとして使用するWebサイトの一意の識別子（オプション）。

戻り値

特定のコンテンツの断片へのフレンドリ・リンクである文字列。

サンプル・コード

<!--$ssLink("dDocName" , "targetSiteId")-->
<!--$ssLink("dDocName")-->
<!--$ssLink("dDocName" , "targetNodeId" , "targetSiteId")-->

9.39 ssNodeLink

説明

このスクリプト拡張機能は、指定したノードに対するパス・ベースのURLを生成するために使用します。これは非推奨で、wcmUrlが推奨されます(9.13項「wcmUrl」を参照)。

詳細は、4.3項「サーバー側スクリプト・リンクの使用」を参照してください。

パラメータ

- nodeId: ノードの一意の識別子。

- siteId: ノードを含むWebサイトの一意の識別子(オプション)。

戻り値

ノードのプライマリ(ランディング)ページのフレンドリ・リンク。

サンプル・コード

<!--$ssNodeLink("nodeId" , "siteId")-->
<!--$ssNodeLink("nodeId")-->

9.40 ssWeblayoutUrl

説明

このスクリプト拡張機能は、パスまたはdDocNameからファイルの完全なWebアドレスを特定するために使用します。この拡張機能は、通常、データ・ファイルのイメージへのパスに対して使用されます。これは非推奨で、wcmUrlが推奨されます(9.13項「wcmUrl」を参照)。

詳細は、4.3項「サーバー側スクリプト・リンクの使用」を参照してください。

パラメータ

- targetId: ファイルのパスまたはファイルのdDocName値のいずれか。

戻り値

パス・ベースのweblayout URL。

サンプル・コード

<!--$ssWeblayoutUrl('mydocname')-->
<!--$ssWeblayoutUrl('groups/public/documents/adacct/mydocname.jpg')-->

10 Idocスクリプト変数

Site Studioでは、Webサイトを実行するために複数のIdoc変数を使用します。

- 10.1項「Idocスクリプト変数について」

- 10.2項「HttpWebsitesRoot」

- 10.3項「HttpRelativeWebsitesRoot」

- 10.4項「HttpFragmentsRoot」

- 10.5項「HttpRelativeFragmentsRoot」

- 10.6項「SS_SERVER_NAME」

- 10.7項「HttpASPPath」

- 10.8項「ssServerRelativeSiteRoot」

注意:
これらの変数は、Site Studioの各リリースで変更される可能性があります。

10.1 Idocスクリプト変数について

Idocスクリプト変数を使用すると、Webサイトの稼働時の柔軟性とカスタマイズ性が増します。変数の多くは、Oracle Content Server上の様々なフォルダのHTTP位置の格納に使用されます。

10.2 HttpWebsitesRoot

websitesフォルダの完全HTTP位置を定義します。一般的な位置は次のとおりです(serverはマシン名で、instanceはコンテンツ・サーバーのインスタンス名です)。

http://server/instance/websites/

10.3 HttpRelativeWebsitesRoot

Site Studio websitesフォルダの相対HTTP位置を定義します。一般的な位置は次のとおりです(instanceはコンテンツ・サーバーのインスタンス名です)。

instance/websites/

10.4 HttpFragmentsRoot

Site Studio fragmentsフォルダの完全HTTP位置を定義します。一般的な位置は次のとおりです(serverはマシン名で、instanceはコンテンツ・サーバーのインスタンス名です)。

http://server/instance/fragments/

10.5 HttpRelativeFragmentsRoot

Site Studio fragmentsフォルダの相対HTTP位置を定義します。一般的な位置は次のとおりです(instanceはコンテンツ・サーバーのインスタンス名です)。

instance/fragments/

10.6 SS_SERVER_NAME

現在のマシンのプロトコル、サーバー名およびポート番号（該当する場合）を定義します。たとえば、次のようになります(serverはサーバー名です)。

http://server
http://server:81
https://server

10.7 HttpASPPath

標準のSite Studio get_page.aspファイルに対する相対パスを定義します。

10.8 ssServerRelativeSiteRoot

サーバーを基準とした現在のWebサイトに対応するパス・ベースのURLのルート部分を定義します。次の値のいずれかが含まれます。

- /: 現在のWebサイトがフレンドリ・ドメイン・アドレス指定モードを使用してアクセスされる場合

- /siteId/: 現在のWebサイトがフレンドリ・フォルダ・アドレス指定モードを使用してアクセスされる場合

値が存在する場合、ルート・ノードのurlDirNameによりsiteIdは上書きされます。

11 Site Studioサービス

Site Studioには、Oracle Content Serverの多くの新規サービスが導入されています。これらのサービスは、特にWebサイトの実行に使用されます。最も重要なものについてここで説明します。

この項の内容は次のとおりです。

- 11.1項「Site Studioサービスについて」

- 11.2項「コントリビュータに関連するサービス」

- 11.3項「デザイナに関連するサービス」

- 11.4項「マネージャに関連するサービス」

- 11.5項「コンテンツの切替えに関連するサービス」

- 11.6項「リンク・ウィザードに関連するサービス」

- 11.7項「サービスのリスト」

注意:
これらのサービスは、Site Studio Designerアプリケーションおよびコントリビュータ・アプリケーションと、Site Studioコンポーネントにより使用されます。これらのサービスは、Site Studioアプリケーションの各リリースで変更される可能性があります。

11.1 Site Studioサービスについて

サービスは、アクションを実行するためのOracle Content ServerへのHTTPリクエストです。各サービスには、アクションのセット(データベース・トランザクション、コードの実行、問合せなど)が定義されています。

Site Studioコンポーネントをインストールすると、多数のサービスが追加されます。

11.2 コントリビュータに関連するサービス

次のサービスは、Site Studio Contributorを対象に使用されます。

- 11.7.2項「SS_ADD_WEBSITE_ID」

- 11.7.5項「SS_CHOOSE_WEBSITE_SECTION」

- 11.7.6項「SS_CHOOSE_WEBSITES」

- 11.7.7項「SS_CLEAR_PREVIEW」

- 11.7.13項「SS_DECODE_LINK」

- 11.7.16項「SS_EDIT_NATIVE_DOCUMENT」

- 11.7.23項「SS_GET_CONFIG_INFO」

- 11.7.24項「SS_GET_CONTRIBUTOR_CONFIG」

- 11.7.25項「SS_GET_CONTRIBUTOR_STRINGS」

- 11.7.28項「SS_GET_DOCUMENT_USAGE」

- 11.7.31項「SS_GET_FRIENDLY_URL」

- 11.7.39項「SS_GET_PLACEHOLDER_SWITCH_CONTENT_CONFIG」

- 11.7.43項「SS_GET_SEARCH_RESULTS」

- 11.7.55項「SS_GET_SWITCH_CONTENT_CONFIG」

- 11.7.64項「SS_PUBLISH_THIS_PAGE」

- 11.7.65項「SS_REMOVE_WEBSITE_ID」

- 11.7.67項「SS_SET_ELEMENT_DATA」

- 11.7.71項「SS_SET_PREVIEW_ELEMENT_DATA」

11.3 デザイナに関連するサービス

次のサービスは、Site Studio Designerに関連するものです。

- 11.7.1項「SS_ADD_NODE」

- 11.7.2項「SS_ADD_WEBSITE_ID」

- 11.7.4項「SS_CHECKIN_FRAGMENT_LIBRARY」

- 11.7.7項「SS_CLEAR_PREVIEW」

- 11.7.10項「SS_COMMIT_SITE_CHANGES」

- 11.7.11項「SS_CREATE_NEW_SITE_EX2」

- 11.7.12項「SS_CREATE_SITE_NAV_JS」

- 11.7.14項「SS_DELETE_NODE」

- 11.7.15項「SS_DOC_INFO_LATEST」

- 11.7.16項「SS_EDIT_NATIVE_DOCUMENT」

- 11.7.17項「SS_GET_ADMIN_PAGE」

- 11.7.18項「SS_GET_ALL_CUSTOM_NODE_PROP_DEFS」

- 11.7.20項「SS_GET_ALL_SITE_DOMAINS」

- 11.7.21項「SS_GET_ALL_SITE_PROPERTIES」

- 11.7.22項「SS_GET_ALL_SITES_EX2」

- 11.7.23項「SS_GET_CONFIG_INFO」

- 11.7.26項「SS_GET_DC_RULES」

- 11.7.28項「SS_GET_DOCUMENT_USAGE」

- 11.7.29項「SS_GET_ENVIRONMENT_PROPERTY_NAMES」

- 11.7.31項「SS_GET_FRIENDLY_URL」

- 11.7.37項「SS_GET_NODE_PROPERTY」

- 11.7.38項「SS_GET_PAGE」

- 11.7.41項「SS_GET_REGION_DEFINITION_ELEMENTS」

- 11.7.43項「SS_GET_SEARCH_RESULTS」

- 11.7.44項「SS_GET_SITE_AS_XML_EX2」

- 11.7.45項「SS_GET_SITE_ASSET_CATEGORIES」

- 11.7.46項「SS_GET_SITE_CHANGE_MONITOR_TOKEN」

- 11.7.47項「SS_GET_SITE_DEFINITION」

- 11.7.48項「SS_GET_SITE_DEFINITION_FOR_USER」

- 11.7.49項「SS_GET_SITE_DOMAINS」

- 11.7.50項「SS_GET_SITE_FRAGMENT_ASSET_REPORT」

- 11.7.51項「SS_GET_SITE_INFO」

- 11.7.52項「SS_GET_SITE_PROPERTY」

- 11.7.54項「SS_GET_SITE_REPORT」

- 11.7.56項「SS_GET_UNIQUE_NODE_SITE_ID」

- 11.7.57項「SS_GET_VERSION」

- 11.7.59項「SS_IS_JS_NAV_OUT_OF_DATE」

- 11.7.60,項「SS_MAP_FRIENDLY_NAME」

- 11.7.61項「SS_MOVE_NODE」

- 11.7.62項「SS_PARSE_FRIENDLY_URL」

- 11.7.63項「SS_PREPARE_PREVIEW」

- 11.7.65項「SS_REMOVE_WEBSITE_ID」

- 11.7.66項「SS_SET_ALL_CUSTOM_NODE_PROP_DEFS」

- 11.7.68項「SS_SET_ENVIRONMENT_PROPERTY_NAMES」

- 11.7.69項「SS_SET_NODE_PROPERTY」

- 11.7.70項「SS_SET_NODES_PROPERTIES」

- 11.7.72項「SS_SET_SITE_ASSET_CATEGORIES」

- 11.7.73「SS_SET_SITE_DOMAINS」

- 11.7.74項「SS_SET_SITE_PROPERTIES」

- 11.7.75項「SS_SET_SITE_PROPERTY」

- 11.7.76項「SS_SWITCH_REGION_ASSOCIATION」

- 11.7.77項「SS_VALIDATE_WEBSITE_OBJECT」

11.4 マネージャに関連するサービス

次のサービスは、Site Studio Managerに関連するものです。

- 11.7.1項「SS_ADD_NODE」

- 11.7.14項「SS_DELETE_NODE」

- 11.7.18項「SS_GET_ALL_CUSTOM_NODE_PROP_DEFS」

- 11.7.43項「SS_GET_SEARCH_RESULTS」

- 11.7.48項「SS_GET_SITE_DEFINITION_FOR_USER」

- 11.7.52項「SS_GET_SITE_PROPERTY」

- 11.7.61項「SS_MOVE_NODE」

- 11.7.69項「SS_SET_NODE_PROPERTY」

- 11.7.75項「SS_SET_SITE_PROPERTY」

11.5 コンテンツの切替えに関連するサービス

次のサービスは、コンテンツの切替えウィザードの使用に関連するものです。

- 11.7.2項「SS_ADD_WEBSITE_ID」

- 11.7.19項「SS_GET_ALL_NODE_PROPERTIES」

- 11.7.23項「SS_GET_CONFIG_INFO」

- 11.7.25項「SS_GET_CONTRIBUTOR_STRINGS」

- 11.7.27項「SS_GET_DOCUMENT_LABELS」

- 11.7.32項「SS_GET_LINK」

- 11.7.43項「SS_GET_SEARCH_RESULTS」

- 11.7.48項「SS_GET_SITE_DEFINITION_FOR_USER」

- 11.7.55項「SS_GET_SWITCH_CONTENT_CONFIG」

- 11.7.69項「SS_SET_NODE_PROPERTY」

- 11.7.70項「SS_SET_NODES_PROPERTIES」

- 11.7.76項「SS_SWITCH_REGION_ASSOCIATION」

11.6 リンク・ウィザードに関連するサービス

次のサービスは、Site Studioでのリンクの作成および変更に関連するものです。

- 11.7.2項「SS_ADD_WEBSITE_ID」

- 11.7.13項「SS_DECODE_LINK」

- 11.7.25項「SS_GET_CONTRIBUTOR_STRINGS」

- 11.7.31項「SS_GET_FRIENDLY_URL」

- 11.7.34項「SS_GET_LINK_WIZARD_CONFIG」

- 11.7.35項「SS_GET_LINK_WIZARD_CONFIG_WITH_SITE」

- 11.7.48項「SS_GET_SITE_DEFINITION_FOR_USER」

11.7 サービスのリスト

このサービスのリストには、Site Studioのカスタマイズに最も有用なもの(特に、サードパーティ・ソフトウェアと使用する場合)が含まれています。

- 11.7.1項「SS_ADD_NODE」

- 11.7.2項「SS_ADD_WEBSITE_ID」

- 11.7.3項「SS_BATCH_DECODE_LINK」

- 11.7.4項「SS_CHECKIN_FRAGMENT_LIBRARY」

- 11.7.5項「SS_CHOOSE_WEBSITE_SECTION」

- 11.7.6項「SS_CHOOSE_WEBSITES」

- 11.7.7項「SS_CLEAR_PREVIEW」

- 11.7.8項「SS_CLEAR_REGION_ASSOCIATIONS」

- 11.7.9項「SS_CLEAR_WEBSITE_ID」

- 11.7.10項「SS_COMMIT_SITE_CHANGES」

- 11.7.11項「SS_CREATE_NEW_SITE_EX2」

- 11.7.12項「SS_CREATE_SITE_NAV_JS」

- 11.7.13項「SS_DECODE_LINK」

- 11.7.14項「SS_DELETE_NODE」

- 11.7.15項「SS_DOC_INFO_LATEST」

- 11.7.16項「SS_EDIT_NATIVE_DOCUMENT」

- 11.7.17項「SS_GET_ADMIN_PAGE」

- 11.7.18項「SS_GET_ALL_CUSTOM_NODE_PROP_DEFS」

- 11.7.19項「SS_GET_ALL_NODE_PROPERTIES」

- 11.7.20項「SS_GET_ALL_SITE_DOMAINS」

- 11.7.21項「SS_GET_ALL_SITE_PROPERTIES」

- 11.7.22項「SS_GET_ALL_SITES_EX2」

- 11.7.23項「SS_GET_CONFIG_INFO」

- 11.7.24項「SS_GET_CONTRIBUTOR_CONFIG」

- 11.7.25項「SS_GET_CONTRIBUTOR_STRINGS」

- 11.7.26項「SS_GET_DC_RULES」

- 11.7.27項「SS_GET_DOCUMENT_LABELS」

- 11.7.28項「SS_GET_DOCUMENT_USAGE」

- 11.7.29項「SS_GET_ENVIRONMENT_PROPERTY_NAMES」

- 11.7.30項「SS_GET_FIRST_NODE_ID」

- 11.7.31項「SS_GET_FRIENDLY_URL」

- 11.7.32項「SS_GET_LINK」

- 11.7.33項「SS_GET_LINK_MANAGEMENT_REPORT」

- 11.7.34項「SS_GET_LINK_WIZARD_CONFIG」

- 11.7.35項「SS_GET_LINK_WIZARD_CONFIG_WITH_SITE」

- 11.7.36項「SS_GET_NODE_LINK」

- 11.7.37項「SS_GET_NODE_PROPERTY」

- 11.7.38項「SS_GET_PAGE」

- 11.7.39項「SS_GET_PLACEHOLDER_SWITCH_CONTENT_CONFIG」

- 11.7.40項「SS_GET_REGION_ASSOCIATIONS」

- 11.7.41項「SS_GET_REGION_DEFINITION_ELEMENTS」

- 11.7.42項「SS_GET_RELATIVE_NODE_ID」

- 11.7.43項「SS_GET_SEARCH_RESULTS」

- 11.7.44項「SS_GET_SITE_AS_XML_EX2」

- 11.7.45項「SS_GET_SITE_ASSET_CATEGORIES」

- 11.7.46項「SS_GET_SITE_CHANGE_MONITOR_TOKEN」

- 11.7.47項「SS_GET_SITE_DEFINITION」

- 11.7.48項「SS_GET_SITE_DEFINITION_FOR_USER」

- 11.7.49項「SS_GET_SITE_DOMAINS」

- 11.7.50項「SS_GET_SITE_FRAGMENT_ASSET_REPORT」

- 11.7.51項「SS_GET_SITE_INFO」

- 11.7.52項「SS_GET_SITE_PROPERTY」

- 11.7.53項「SS_GET_SITE_PUBLISH_REPORT」

- 11.7.54項「SS_GET_SITE_REPORT」

- 11.7.55項「SS_GET_SWITCH_CONTENT_CONFIG」

- 11.7.56項「SS_GET_UNIQUE_NODE_SITE_ID」

- 11.7.57項「SS_GET_VERSION」

- 11.7.58項「SS_GET_WEBLAYOUT_URL」

- 11.7.59項「SS_IS_JS_NAV_OUT_OF_DATE」

- 11.7.60,項「SS_MAP_FRIENDLY_NAME」

- 11.7.61項「SS_MOVE_NODE」

- 11.7.62項「SS_PARSE_FRIENDLY_URL」

- 11.7.63項「SS_PREPARE_PREVIEW」

- 11.7.64項「SS_PUBLISH_THIS_PAGE」

- 11.7.65項「SS_REMOVE_WEBSITE_ID」

- 11.7.66項「SS_SET_ALL_CUSTOM_NODE_PROP_DEFS」

- 11.7.67項「SS_SET_ELEMENT_DATA」

- 11.7.68項「SS_SET_ENVIRONMENT_PROPERTY_NAMES」

- 11.7.69項「SS_SET_NODE_PROPERTY」

- 11.7.70項「SS_SET_NODES_PROPERTIES」

- 11.7.71項「SS_SET_PREVIEW_ELEMENT_DATA」

- 11.7.72項「SS_SET_SITE_ASSET_CATEGORIES」

- 11.7.73「SS_SET_SITE_DOMAINS」

- 11.7.74項「SS_SET_SITE_PROPERTIES」

- 11.7.75項「SS_SET_SITE_PROPERTY」

- 11.7.76項「SS_SWITCH_REGION_ASSOCIATION」

- 11.7.77項「SS_VALIDATE_WEBSITE_OBJECT」

- 11.7.78項「WCM_PLACEHOLDER」

- 11.7.79項「WCM_EDIT_DATA_FILE」

- 11.7.80項「WCM_BEGIN_EDIT_SESSION」

11.7.1 SS_ADD_NODE

- 説明: このサービスは、特定のサイト・ノードに子ノードを追加します。

- パラメータ:

- siteId: サイトの一意の識別子（必須）。

- nodeId: ノードの一意の識別子（必須）。新規に追加されるノードは、このノードの子になります。

- newNodeId: 新規子ノードの識別子（オプション）。この値が指定されない場合、新しく一意の識別子が生成されます。

- newNodeName: 新規子ノードのラベル（オプション）。この値が指定されない場合、New Sectionというテキストが使用されます。

- 戻り値:

- newNodeId: 新しく作成されたノードの識別子。

- セキュリティ: ユーザーは、新規子ノードを追加するノードに対して少なくとも書込みアクセス権を持っている必要があります。

11.7.2 SS_ADD_WEBSITE_ID

- 説明: このサービスは、特定のドキュメントに対応するWebサイトのリストに特定のsiteIdを追加します。

- パラメータ:

- dDocName: dDocName(必須)。

- siteId: サイトの一意の識別子（必須）。

- fieldName: xWebsitesまたはxDontShowInListsForWebsite(必須)。

- 戻り値: なし。

- セキュリティ: ユーザーは、指定されたdDocNameの最新のリビジョンに対して書込みアクセス権を持っている必要があります。

11.7.3 SS_BATCH_DECODE_LINK

- 説明: このサービスは、セット内にリストされたすべてのリンクおよびsiteIdに基づいてSS_DECODE_LINKを実行するために、SS_DECODE_LINKを対象にセットの受渡しと返却を行います。

- パラメータ:

- SS_DECODE_LINKにリスト入力するリンクおよびsiteIdのリストを格納したLinkというタイトルの結果セット。

- 戻り値:

- Linksというタイトルの結果セット。入力行ごとに、SS_DECODE_LINKで解析された情報を含む行が1つ生成されます。

- セキュリティ: ユーザーは、コンテンツ・サーバーの1つ以上のセキュリティ・グループに対して書込みアクセス権を持っている必要があります。

11.7.4 SS_CHECKIN_FRAGMENT_LIBRARY

- 説明: このサービスはCHECKIN_UNIVERSALのラッパーで、フラグメント.zipファイルが解凍され、weblayoutにデプロイされるポストプロセスが続きます。

- パラメータ:

- primaryFile: フラグメント.zipファイル。必須。

- alternateFile: XMLフラグメント定義。必須。

- 戻り値: なし。

- セキュリティ: CHECKIN_UNIVERSALに対するものと同じ要件。

11.7.5 SS_CHOOSE_WEBSITE_SECTION

- 説明: このサービスは、セクションを選択するUIのコールに使用されます。カスタム・ユーザー・インタフェースを作成する際、Webサイト・セクションを選択する必要がある場合に使用されます。このサービスには、ss_choose_website_section.htmという名前のOracle Content Serverテンプレートがあります(\templates\内)。

- パラメータ:

- siteId: WebサイトのサイトID。オプション。

- 戻り値:

- ss_choose_website_section.htmに記述されたUI。

- パラメータ: なし。

11.7.6 SS_CHOOSE_WEBSITES

- 説明: このサービスは、Webサイトのリストから選択できる画面を表示します。これは、コンテンツ・サーバーUIのxWebsitesフォーム要素のカスタマイズと組み合せて使用します。

- パラメータ:

- xWebsites: WebサイトIDのカンマ区切りリスト。

- 戻り値: なし。

- セキュリティ: コンテンツ・サーバー内のセキュリティ・グループに対して読取りアクセス権を持っている任意のユーザーは、このサービスを起動できます。

11.7.7 SS_CLEAR_PREVIEW

- 説明:このサービスは、プレビューのクリアに使用されます。クリアが実行されない問題がある場合、プレビューは毎週自身をクリアします。ただし、領域の節約には、多くの場合、ファイルの削除が好まれます。

- パラメータ:

- previewId: プレビュー・キャッシュ内のプレビューID(フォルダ名)

- 戻り値: なし。

- セキュリティ: プレビューするドキュメントへの書込みアクセス権。

11.7.8 SS_CLEAR_REGION_ASSOCIATIONS

- 説明: このサービスは、切り替えられたリージョン関連付けのメモリーをクリアします。

- パラメータ:

- siteId: サイトの一意の識別子（必須）。

- nodeId: ノードの識別子（オプション）。このパラメータが指定されない場合、サイト全体の関連付けが消去されます。

- property: primaryUrlまたはsecondaryUrl(nodeIdの指定時には必須)。

- 戻り値: なし。

- セキュリティ: ユーザーは、ノードに対して(nodeIdを指定しない場合はサイトに対して)少なくとも書込みアクセス権を持っている必要があります。

11.7.9 SS_CLEAR_WEBSITE_ID

- 説明: このサービスは、指定されたdDocNameに対応するxWebsitesまたはxDontShowInListsForWebsitesフィールドから指定されたsiteIdをクリアします。

- パラメータ:

- dDocName: xWebsitesまたはxDontShowInListsForWebsitesフィールドを変更するファイルのdDocName(必須)。

- removeWebsiteID: ブール値yes(必須)。

- fieldName: siteIdをクリアするメタデータ・フィールド(xWebsitesまたはxDontShowInListsForWebsites)(必須)。

- siteId: xWebsitesまたはxDontShowInListsForWebsitesフィールドから削除するsiteId(必須)。

- 戻り値: なし。

- セキュリティ: ユーザーは、指定されたdDocNameに対して少なくとも書込みアクセス権を持っている必要があります。

11.7.10 SS_COMMIT_SITE_CHANGES

- 説明: このサービスを実行すると、サイトの変更がコミットされます。Site Studioは、10分ごとに自動的に変更をコミットしますが、このスクリプトを必要に応じて実行し、変更をコミットできます。

- パラメータ:

- siteId: サイトの一意の識別子（必須）。

- 戻り値: なし。

- セキュリティ: サービスを実行するには、プロジェクト・ファイルに対して書込みアクセス権を持っている必要があります。

11.7.11 SS_CREATE_NEW_SITE_EX2

- 説明: このサービスは、コンテンツ・サーバーに空の新規サイトを作成します。

- パラメータ:

- siteId: 作成するサイトの一意の識別子（必須）。識別子は、siteIdのネーミング規則に準拠している必要があります。

- siteLabel: サイトのラベル（オプション）。ラベルが指定されない場合、Unnamed Siteというテキストが使用されます。

- siteType: 作成するサイトのタイプ。たとえば、aspまたはidoc(オプション)。

- initialNodeId: ルート・セクションのnodeId(オプション)。この値が指定されない場合、一意の識別子が作成されます。

- rootSectionActive: ルート・セクションをアクティブとしてマークするかどうかを示します（オプション）。有効な値は、TrueまたはFalseです。

- rootSectionLabel: ルート・セクションのラベル（オプション）。この値が指定されない場合、Homeという値が割り当てられます。

- rootSectionUrlPageName: ルート・セクションのurlPageName値（オプション）。

- rootSectionUrlSecondaryPageName: ルート・セクションのurlSecondaryPageName（オプション）。

- rootSectionUrlDirName: ルート・セクションのurlDirName値（オプション）。

- 戻り値:

- siteId: 作成されたサイトの一意の識別子（必須）。

- セキュリティ: サービスを実行するユーザーは、Site Studioプロジェクト・ファイルをチェックインする際に使用されるセキュリティ・グループに対して書込みアクセス権を持っている必要があります（このファイルは、「デフォルトのプロジェクト・ドキュメント情報の設定」管理ページで構成されます）。

11.7.12 SS_CREATE_SITE_NAV_JS

- 説明: このサービスは、サイト・ナビゲーション・ファイルを作成します。これにより、sitenavigation.js、sitenavigationfunctions.js、sitenavigation.xml、sitenavigation.hdaおよびsitenavigation_co.hdaの各ファイルが再生成されます。

- パラメータ:

- siteId: サイトの一意の識別子（必須）。

- 戻り値:

- siteNavUrl: サイト・ナビゲーション・ファイルの完全なHTTP URL。

- セキュリティ: ユーザーは、ルート・ノードに対して少なくとも書込みアクセス権を持っている必要があります。

11.7.13 SS_DECODE_LINK

- 説明: このサービスは、Site Studioリンクをデコードしてリンクが解決される場所を判別します。

- パラメータ:

- link: サポートされる任意の形式によるSite Studioリンク（必須）。

- siteId: サイトの一意の識別子（必須）。

- 戻り値: （空白の可能性あり）

- targetIsSection: TrueまたはFalse

- nodeLabel: ノードのナビゲーション・ラベル。

- targetDocName: リンクのターゲットとなるdDocName。

- targetNodeId: リンクのターゲットとなるセクションの識別子。

- targetSiteId: リンクのターゲットとなるサイトの識別子。

- targetIsSecondary: TrueまたはFalse

- linkType: 入力されたSite Studioリンクのリンク・タイプ。

- errors: 文字列値unknown Error、noInputLink、invalidInputSiteId、invalidSiteId、invalidNodeId、invalidPathLink、noDocInfo、notSiteStudioUrl、badUrlFormat、cantFindUrlSection、parameterCount、parameterFormatのいずれかです。

- セキュリティ: ユーザーは、コンテンツ・サーバーの1つ以上のセキュリティ・グループに対して書込みアクセス権を持っている必要があります。

11.7.14 SS_DELETE_NODE

- 説明: このサービスは、特定のサイト・ノードとそのすべての子を削除します。

- パラメータ:

- siteId: サイトの一意の識別子（必須）。

- nodeId: 削除するノードの識別子（必須）。

- 戻り値: なし。

- セキュリティ: ユーザーは、削除するノードに対して少なくとも削除アクセス権を持っている必要があります。

11.7.15 SS_DOC_INFO_LATEST

- 説明: このサービスは、最新リリースのドキュメントだけでない、ワークフロー内を含む最新のドキュメントに関する情報を取得します。このサービスは、Oracle Content ServerサービスDOC_INFO_BY_NAMEと同様に動作します。

- パラメータ:

- dDocName: 情報を取得するドキュメントのdDocName。

- 戻り値:

- 指定されたdDocNameの最新バージョンに関するDOC_INFO結果セット。

- ドキュメントの作成者の電子メールアドレス。電子メール・アドレスは結果セットに含まれません。

- セキュリティ: 最新バージョンに対する読取りアクセス権。これは、ドキュメントのワークフローに対するアクセス権を必要とする場合があります。

11.7.16 SS_EDIT_NATIVE_DOCUMENT

- 説明: このサービスは、「チェックアウトして開く」(COAO)の起動に使用できるHTMLページを返します。このページには、COAOの起動に必要なJavaScriptと<object>タグが含まれます。

- パラメータ:

- dDocName: COAO機能を使用して編集するファイルのdDocName（必須）。

- 戻り値: なし。

- セキュリティ: ユーザーは、1つ以上のセキュリティ・グループに対して書込みアクセス権を持っている必要があります。持っていない場合、COAOを使用することはできません。

11.7.17 SS_GET_ADMIN_PAGE

- 説明: このサービスは、ルートSite Studio管理ページを表示します。

- パラメータ: なし。

- 戻り値:

- 管理ページ

- セキュリティ: 管理アクセス権が必要です。

11.7.18 SS_GET_ALL_CUSTOM_NODE_PROP_DEFS

- 説明: 特定のサイトのカスタム・ノード・プロパティ定義を取得します。

- パラメータ:

- siteId: サイトの一意の識別子（必須）。

- 戻り値:

- CustomNodePropertyDefsという名前の結果セット。名前、タイプおよび説明の列があります。

- セキュリティ: ユーザーは、ルート・ノードに対して少なくとも書込みアクセス権を持っている必要があります。

11.7.19 SS_GET_ALL_NODE_PROPERTIES

- 説明: ノード・プロパティの完全なセットを取得します。

- パラメータ:

- siteId: サイトの一意の識別子（必須）。

- nodeId: ノードの識別子（必須）。

- 戻り値:

- 2つの結果セット(StandardPropertiesおよびSiteStudioProperties)が返されます。各結果セットには1つの行が含まれます。列名はプロパティ名です。

- StandardProperties結果セットには、nodeIdを示す1つの行および列のみが含まれます。

- セキュリティ:

- ユーザーは、ノードのフォルダに対して少なくとも読取りアクセス権を持っている必要があります。

- このサービスは、Idocスクリプトから実行できます。

11.7.20 SS_GET_ALL_SITE_DOMAINS

- 説明: このサービスは、サーバー上のドメインの完全なセットを取得します。

- パラメータ: なし。

- 戻り値:

- すべてのドメイン・アドレスを示すDomainMapという名前の結果セット。Key、SiteId、PatternおよびDefaultという行を含みます。Keyはドメイン、SiteIdはID、PatternはSS_GET_PAGEとしてURLが再度書き込まれる先およびDefaultはサイトのデフォルト・アドレスです。

- セキュリティ: 管理アクセス権が必要です。

11.7.21 SS_GET_ALL_SITE_PROPERTIES

- 説明: サイト・プロパティの完全なセットを取得します。

- パラメータ:

- siteId: サイトの一意の識別子（必須）。

- 戻り値:

- 値の行を1つ含むSiteStudioPropertiesという結果セット。列名はプロパティ名です。

- セキュリティ:

- ユーザーは、サイトに対して少なくとも読取りアクセス権を持っている必要があります。

- このサービスは、Idocスクリプトから実行できます。

11.7.22 SS_GET_ALL_SITES_EX2

- 説明: このサービスは、コンテンツ・サーバー上のすべてのサイトのリストを返します。

- パラメータ: なし。

- 戻り値:

- numSites=N

- site0=siteId
. . .

- siteN-1=siteId

同じ情報がSiteIds結果セットで返されます。

- セキュリティ: 戻されるサイトのリストは、ユーザーが少なくとも読取りアクセス権を持っているサイトのリストになります。

11.7.23 SS_GET_CONFIG_INFO

- 説明: このサービスは、デザイナに関するすべてのSite Studio基本構成情報を取得します。

- パラメータ: なし。

- 戻り値:

- 基本構成情報。

- セキュリティ:

- ユーザーは、サイトに対して少なくとも読取りアクセス権を持っている必要があります。

- このサービスは、Idocスクリプトから実行できます。

11.7.24 SS_GET_CONTRIBUTOR_CONFIG

- 説明: このサービスは、コントリビュータに関するSite Studio基本構成情報を取得します。

- パラメータ: なし。

- 戻り値:

- 基本構成情報。

- セキュリティ:

- ユーザーは、サイトに対して少なくとも読取りアクセス権を持っている必要があります。

- このサービスは、Idocスクリプトから実行できます。

11.7.25 SS_GET_CONTRIBUTOR_STRINGS

- 説明: このサービスは、現在のユーザーの言語のweblayout\resources\wcm\base\lang\language idからJavaScriptファイル(wcm.strings.js)をロードします。ユーザーの現在の言語のwcm.strings.jsファイルがない場合、デフォルトのEN文字列が返されます。

- パラメータ: なし

- 戻り値:

- JavaScriptファイルのコンテンツ。

- セキュリティ: パラメータ: なし。ユーザーがログインしていない場合、言語IDはENです。

11.7.26 SS_GET_DC_RULES

- 説明: このサービスは、定義されているすべてのドキュメント変換ルールから成る結果セットを返します。

- パラメータ: なし

- 戻り値:

- DCConversionsまたはDCConversions80(Dynamic Converterのバージョンによる)というDynamic Converterに対して定義されているすべてのルールから成る結果セット。

- セキュリティ: ユーザーは、サイトに対して少なくとも書込みアクセス権を持っている必要があります。

11.7.27 SS_GET_DOCUMENT_LABELS

- 説明: このサービスは、コンテンツIDからラベルを取得するためにコントリビュータによって使用されます。

- パラメータ:

- contentIdsというdDocNamesから成る結果セット。

- 戻り値:

- 指定された各dDocName値のラベル。レスポンスは、dDocName値をキーとするJSON形式です。

- セキュリティ: ユーザーは、少なくとも書込みアクセス権を持っている必要があります。

11.7.28 SS_GET_DOCUMENT_USAGE

- 説明: このサービスは、Webサイトの使用状況レポートを表示します。

- パラメータ:

- dDocName: Webサイト使用状況レポートの実行対象のファイルのdDocName(必須)。

- 戻り値:

- Webサイト使用状況レポート。

- セキュリティ: ユーザーは、少なくとも読取りアクセス権を持っている必要があります。

11.7.29 SS_GET_ENVIRONMENT_PROPERTY_NAMES

- 説明: このサービスは、環境プロパティとして識別されるこのサイトのプロパティを取得します。

- パラメータ:

- siteId: サイトの一意の識別子（必須）。

- 戻り値:

- EnvironmentPropertiesという結果セット。この結果セットには、環境プロパティとして識別されるプロパティごとに1行を持つnameという単一の列が含まれます。

- セキュリティ: ユーザーは、コンテンツ・サーバーの1つ以上のセキュリティ・グループに対して書込みアクセス権を持っている必要があります。

11.7.30 SS_GET_FIRST_NODE_ID

- 説明: このサービスは、サイトの最初のノードを取得します。サイト階層を列挙する場合に便利です。

- パラメータ:

- siteId: サイトの一意の識別子（必須）。

- 戻り値:

- firstId: サイト階層における最初のノードの識別子。

- セキュリティ:

- ユーザーは、ルート・ノードに対して少なくとも読取りアクセス権を持っている必要があります。

- このサービスは、Idocスクリプトから実行できます。

11.7.31 SS_GET_FRIENDLY_URL

- 説明: これは、ドキュメントまたはセクションに対するフレンドリURLを作成します。

- パラメータ:

- siteId: サイトの一意の識別子（必須）。

- ssDocName: 表示するドキュメントのdDocName（オプション）。

- ssTargetNodeId: ドキュメントを表示するセクションの識別子(オプション)。
ssDocNameまたはssTargetNodeIdのいずれかを指定する必要があります。

- ssTargetSiteId: 指定されたssTargetNodeIdを含むサイトの識別子。

- 戻り値:

- ssFriendlyUrl: 指定されたドキュメントまたはセクションのサイト相対URL。

- HttpSiteAddress: Webサイトのルートのアドレス。(これらの2つの戻り値を連結して完全URLを作成できます。)

- セキュリティ: ユーザーは、コンテンツ・サーバーの1つ以上のセキュリティ・グループに対して書込みアクセス権を持っている必要があります。

11.7.32 SS_GET_LINK

- 説明: これは、ssLinkサーバー側リンクのサービス・バージョンです。

- パラメータ:

- ssDocName: 表示するドキュメントのdDocName（必須）。

- TargetNodeId: ドキュメントを表示するセクションの識別子(オプション)。

- TargetSiteId: 指定されたTargetNodeIdを含むサイトの識別子(オプション)。

- SourceNodeId: ドキュメントのxWebsiteSection値を使用できない場合にドキュメントを表示するセクションの識別子(オプション)。

- SourceSiteId: 指定されたssSourceNodeIdを含むサイトの識別子(オプション)。

- 戻り値:

- 指定されたドキュメントの絶対URLを示すssLinkパラメータ。

- セキュリティ: ユーザーは、コンテンツ・サーバーの1つ以上のセキュリティ・グループに対して書込みアクセス権を持っている必要があります。

11.7.33 SS_GET_LINK_MANAGEMENT_REPORT

- 説明: このサービスは、Site Studioサイト内のリンクに関する情報を取得します。

- パラメータ: なし。

- 戻り値: 次の列を含むManifestという結果セット。

- siteId: サイトの一意の識別子(必須)。

- layoutResultSet: 次の値が含まれます。

- nodeId: セクションの識別子。

- dDocName: ドキュメントの名前。

- isPrimaryUrl: 結果がプライマリ・ページとして指定されているかどうか。

- UrlDataFiles: 次の値が含まれます。

- nodeId: セクションの識別子。

- dDocName: ドキュメントの名前。

- isPrimaryUrl: 結果がプライマリ・ページとして指定されているかどうか。

- セキュリティ: ユーザーは、コンテンツ・サーバーの1つ以上のセキュリティ・グループに対して書込みアクセス権を持っている必要があります。

11.7.34 SS_GET_LINK_WIZARD_CONFIG

- 説明: このサービスは、リンク・ウィザードの移入に使用される構成情報を取得します。

- パラメータ:

- link: リンクの値。形式は任意です。

- target: ターゲット・ウィンドウ。

注意:
これらのパラメータはサービス・コールで渡されますが、使用されません。

- 戻り値:

- リンク・ウィザードに対するJSONでの構成が返されます。

- セキュリティ: ユーザーは、コンテンツ・サーバーの1つ以上のセキュリティ・グループに対して書込みアクセス権を持っている必要があります。

11.7.35 SS_GET_LINK_WIZARD_CONFIG_WITH_SITE

- 説明: このサービスは、サイトのコンテキスト内でのリンク・ウィザードの起動に使用されます。

- パラメータ:

- siteId: サイトの一意の識別子（必須）。

- nodeId: ノードの一意の識別子。

- link: リンクの値。形式は任意です。

- target: ターゲット・ウィンドウ。

注意:
nodeId、linkおよびtargetパラメータはサービス・コールで渡されますが、使用されません。

- 戻り値:

- リンク・ウィザードに対するJSONでの構成が返されます。

- セキュリティ: ユーザーは、コンテンツ・サーバーの1つ以上のセキュリティ・グループに対して書込みアクセス権を持っている必要があります。

11.7.36 SS_GET_NODE_LINK

- 説明: これは、ssNodeLinkサーバー側リンクのサービス・バージョンです。

- パラメータ:

- TargetNodeId: URLの作成対象のセクションの識別子(必須)。

- TargetSiteId: 指定されたTargetNodeIdを含むサイトの識別子(オプション)。

- SourceNodeId: URLの作成元のセクションの識別子。これは、リンクが絶対URLか相対URLかを確認する場合に有用です(オプション)。

- SourceSiteId: 指定されたSourceNodeIdを含むサイトの識別子(オプション)。

- 戻り値:

- 結果は、ssNodeLinkパラメータとして返されます。

- セキュリティ: ユーザーは、コンテンツ・サーバーの1つ以上のセキュリティ・グループに対して書込みアクセス権を持っている必要があります。

11.7.37 SS_GET_NODE_PROPERTY

- 説明: このサービスは、ノード・プロパティを取得します。

- パラメータ:

- siteId: サイトの一意の識別子（必須）。

- nodeId: ノードの識別子（必須）。

- property: 削除するプロパティの名前(必須)。

- 戻り値:

- value: リクエストされたノード・プロパティの値。リクエストされたプロパティが存在しない場合、このパラメータは戻されませんが、サービス・コールは正常に完了します。

- セキュリティ:

- ユーザーは、ノードに対して少なくとも読取りアクセス権を持っている必要があります。

- このサービスは、Idocスクリプトから実行できます。

11.7.38 SS_GET_PAGE

コア・サービスであるSS_GET_PAGEは、特にSite Studio用に作成されています。このサービスは、多くの構成要素から単一のWebページを動的に生成することで、製品の中心的な役割を果します。

Site Studioリリース7.2.1以下では、SS_GET_PAGEサービスは、Site Studio WebページのURLを直接参照するために使用されていました。Site Studioの現在のリリースでは、SS_GET_PAGEサービスは、WebページのURLで直接使用されることはほとんどありません。かわりに、Webページは、より標準的なパス・ベースのURLを使用してアクセスされます。

ただし、SS_GET_PAGEコア・サービス・コールは、これらのURLの背後で処理を実行するために依然として存在しています。また、現在はWebサーバーのフィルタ・プラグインがすべてのパス・ベースのSite Studio関連のURLを中間で取得して、基礎となるSS_GET_PAGEサービス・コールに渡す前にそれらを複数の構成要素に変換しています。そのため、ここでは引き続きこのコア・サービスについて説明します。

SS_GET_PAGEサービスは、問合せ文字列の一部として、相互に排他的な次のパラメータのいずれかを必要とします。

- nodeId: 指定されると、サービスはサイト階層の該当ノードを検索し、そのノードのprimaryUrlプロパティを取得します。これにより、ノードのプライマリ・ページを直接提供するのに十分な情報を取得できます。
かわりに、URLでuseSecondary=trueというパラメータを指定して、ノードのセカンダリ・ページを取得することもできます。この場合、サービスはノードのsecondaryUrlプロパティを取得し、セカンダリ・ページを提供します。この機能は、主にデザイナ・アプリケーションで使用されます。

- ssDocName: (有効なdDocName値で)指定されると、サービスは管理対象コンテンツ・アイテムを検索し、3つのルールによる評価(次の「コンテンツを再利用するための3つのルール」を参照)を使用して、コンテンツ・アイテムを表示するWebサイト・セクションを決定します。
次に、セクションのprimaryUrlおよびsecondaryUrlプロパティを解析して、セクションのプライマリ・ページとセカンダリ・ページのどちらを表示するかを決定するための処理決定プロセスを実行します。決定プロセスが完了すると、適切なページが表示されます。

Site Studio Designerのインタフェースと『Oracle WebCenter Content Site Studio Designerユーザーズ・ガイド』では、サイト階層はWebサイトを構成するセクションを持つものとして説明されています。これは、製品の最初の開発時にはノードと呼ばれていました。そのため、SS_GET_PAGEサービスなどの多くの内部機能では、現在もそのように呼ばれています。Site Studioの用語では、ノードはセクションと同じです。

コンテンツを再利用するための3つのルール

nodeIdパラメータとともにSS_GET_PAGEが使用される場合、サービスは指定したセクションのプライマリ・ページを表示するように明示的に指示されるため、追加の決定処理は不要です。ただし、ssDocNameパラメータとともにSS_GET_PAGEが使用される場合、サービスはドキュメントを表示するセクションを決定する必要があります。これは、次の3つのルールにより決定されます。

1. ターゲット: オプションのssTargetNodeIdパラメータがURLに指定されている場合、そのセクションに管理対象ドキュメントが明示的に表示されます。

2. セクション: 管理対象ドキュメントのxWebsiteSectionメタデータ・フィールドに値が含まれる場合、その値がセクションとして使用され、そのセクションに管理対象ドキュメントが表示されます。

3. ソース: オプションのssSourceNodeIdパラメータが現在のページのノードとしてURLに指定されている場合、そのセクションに管理対象ドキュメントが明示的に表示されます。

これらすべての処理により、コントリビュータは、同じサイトの異なるセクションで、または同じコンテンツ・サーバーの異なるサイトでコンテンツ(コントリビュータ・データ・ファイルとネイティブ・ドキュメント)を共有および再利用できます(『Oracle WebCenter Content Site Studio Designerユーザーズ・ガイド』のターゲット・セクションを使用したリージョン・コンテンツの共有に関する項を参照)。

（ssDocNameパラメータを使用する）SS_GET_PAGEサービスは、管理対象ドキュメントを表示するセクションを決定したら、次にプライマリ・レイアウト・ページとセカンダリ・レイアウト・ページのどちらを表示するかを決定する必要があります。これは、次のアルゴリズムにより決定されます。

条件

アクション

ssDocNameがセクションのprimaryUrlプロパティのリージョン・パラメータと一致する場合

プライマリ・ページが表示されます。

ssDocNameがセクションのsecondaryUrlプロパティのリージョン・パラメータと一致する場合

セカンダリ・ページが表示されます。

それ以外の場合

セカンダリ・ページが表示されますが、REPLACEABLEリージョン・パラメータはssDocName値で置き換えられます。
REPLACEABLEリージョンは、セクションのsecondaryUrlVariableFieldプロパティにより定義されます。

前述の説明は、ssDocNameパラメータがコントリビュータ・データ・ファイルまたはネイティブ・ドキュメントを示していることが前提です。ssDocNameパラメータがレイアウト・ファイルを示している場合、異なる処理決定プロセスが発生します。この場合、Site Studioは、そのレイアウトを使用しているセクションを特定するまでサイト階層を順番に検索します。ただし、管理対象レイアウトに対する直接リンクはほとんど使用されません。この方法は、通常、デザイナにより内部的に使用されます。

nodeId、ssDocName、ssTargetNodeIdおよびssSourceNodeIdに加え、SS_GET_PAGEサービスでは、次のオプションのURLパラメータまたはCookieの値も認識されます。

- SSContributor: このパラメータには、コントリビューション・モードでWebページを表示するかどうかを示すtrueまたはfalseの値が含まれます。コントリビューション・モードでは、Webページのコントリビューション・リージョンごとに、コンテンツ・アイテムのワークフロー・バージョンとコントリビューション・アイコンが表示されます。必要に応じて、このパラメータによりログイン・プロンプトも表示されます。URLパラメータとして渡されると、この値は自動的にCookie値として設定され、コントリビュータがサイトをナビゲートするのに合せて自動的に伝播されます。

- PreviewId: このパラメータは、Webページの最新のチェックイン・バージョンのかわりに、一時的なプレビュー・バージョンを表示することを示します。このパラメータは、レイアウト・ページやコントリビュータ・データ・ファイルの新規バージョンをチェックインすることなくプレビュー・サービスを提供するため、（SS_GET_PAGEサービスと組み合せて）デザイナおよびコントリビュータ・アプリケーションでのみ使用します。URLパラメータとして渡されると、この値も自動的にCookie値として設定され、コントリビュータや設計者がサイトをナビゲートするのに合せてプレビュー・モードを維持するために自動的に伝播されます。
このパラメータを直接使用することは避けてください。

エラー・ハンドラ・セクション

エラーは、SS_GET_PAGEサービス・コールの実行中のどの時点でも発生する可能性があります。たとえば、必要なREPLACEABLEリージョンが特定のセクションに対して指定されていない場合、エラーが発生することがあります。通常、これらのタイプのエラーが発生すると、コンテンツ・サーバーの標準のエラー・ページが表示され、コンシューマはWebサイトのコンテキストの外部に移されます。

エラーを表示しながらWebサイトのコンテキスト内にとどまるには、デザイナで、サイト内の1つのセクションをエラー・ハンドラ・セクションとして指定します。SS_GET_PAGEサービス内でエラーが発生すると、コンシューマは、エラー・ハンドラ・セクションに関連付けられたプライマリ・レイアウト・ページにリダイレクトされます。エラー情報を表示するレイアウト・ページでは、次の2つのIdoc変数を使用できます。

- ssErrorMessage: 発生したエラーのテキスト説明。

- ssErrorCode: 発生したエラーのタイプを示す数値エラー・コード(これにより、独自のエラーの説明を表示できます)。

内部的には、エラー・ハンドラ・セクションを設定すると、サイト・プロパティのerrorNodeIdが、エラー・ハンドラ・セクションのnodeIdを含むように設定されます。

Site Studioで出現する可能性のあるエラー・コードのリストは、次のとおりです。

ssErrorCode

ssErrorMessage

-0x100

「Webサイトのこの部分に対してレイアウト・ページが指定されていません。」

-0x101

コンテンツIDのドキュメントのドキュメント情報を検索できませんでした。

-0x102

コンテンツID '{1}'のドキュメントがセクション'{2}' (Id={3})でプライマリURLまたはセカンダリURLと一致せず、置換可能リージョンが定義されていません。

-0x103

セクションに対してプライマリURLが定義されていないため、セクション'{1}' (Id={2})へのリンクに失敗しました。

-0x104

セクションに対してセカンダリURLが定義されていないため、セクション'{1}' (Id={2})へのリンクに失敗しました。

-0x105

SiteStudio Webサイトにセクション'{1}' (Id={2})が含まれていません。

-0x106

コンテンツID '{1}'のレイアウトがSiteStudio Webサイトに保存されていません。

-0x107

コンテンツID '{1}'のレイアウトがWebサイトのセクションURLに見つかりませんでした。

-0x108

コンテンツID '{1}'のドキュメントを表示するWebサイト・セクションを識別できません。

-0x200

「SS_GET_PAGEサービス・コールで不明なエラーが発生しました。」

- 説明: Site Studio Webページを表示します。

- パラメータ:
セクションのプライマリ（スプラッシュ）・ページを表示するためのパラメータ:

- siteId: サイトの識別子(オプション)。指定されない場合、この値は計算で求められます。

- nodeId: セクションの識別子(必須)。

セクションに特定のドキュメントを表示するためのパラメータ:

- ssDocName: 表示するドキュメントのdDocName(必須)。

- ssTargetNodeId: ドキュメントを表示するセクションの識別子(オプション)。

- ssTargetSiteId: 指定されたssTargetNodeIdを含むサイトの識別子(オプション)。指定されない場合、この値は計算で求められます。

- ssSourceNodeId: ドキュメントのxWebsiteSection値を使用できない場合にドキュメントを表示するセクションの識別子(オプション)。

- ssSourceSiteId: 指定されたssSourceNodeIdを含むサイトの識別子(オプション)。指定されない場合、この値は計算で求められます。

- SSContributor: ページをコントリビューション・モードで提供するかどうかを指定します(オプション)。使用可能な値は、trueとfalseです。

- 戻り値:

- Site Studio Webページ。

- セキュリティ: ユーザーは、Webサイト・ページを構成するドキュメントに対して少なくとも読取りアクセス権を持っている必要があります。

11.7.39 SS_GET_PLACEHOLDER_SWITCH_CONTENT_CONFIG

- 説明: このサービスは、指定されたプレースホルダ定義に対する、Oracle Contentウィザードに必要なすべての構成を収集します。

- パラメータ:
これは、次のいずれかを必要とします。

- nodeId: プレースホルダ定義の一意の識別子。
または

- 文字列として渡されるプレースホルダ定義xmlファイル。

- 戻り値: 次のそれぞれについて結果セットを返します。

- RegionTemplates: リージョン・テンプレートの結果セット。

- RegionDefinitions: リージョン定義の結果セット。

- Subtemplates: サブテンプレートの結果セット。

- セキュリティ: ユーザーは、書込みアクセス権を持っている必要があります。

11.7.40 SS_GET_REGION_ASSOCIATIONS

- 説明: このサービスは、SS_SWITCH_REGION_ASSOCIATIONサービスURLを介して変更されたプライマリURLおよびセカンダリURLのリージョン関連付けを返します。

- パラメータ:

- siteId: サイトの一意の識別子（必須）。

- 戻り値:

- Primary: サイトのすべてのプライマリURL。

- Secondary: サイトのすべてのセカンダリURL。

- セキュリティ: ユーザーは、コンテンツ・サーバーの1つ以上のセキュリティ・グループに対して書込みアクセス権を持っている必要があります。

11.7.41 SS_GET_REGION_DEFINITION_ELEMENTS

- 説明: このサービスは、リージョン定義にリストされたすべての要素定義を取得します。

- パラメータ:

- regionDefinition: リージョン定義の一意の識別子。

- 戻り値:

- 列SSElementType、SSElementTitle、SSElementName、SSElementIsList、SSSubelementsを含むssElementConfigsという結果セット。

- セキュリティ: ユーザーは、コンテンツ・サーバーの1つ以上のセキュリティ・グループに対して書込みアクセス権を持っている必要があります。

11.7.42 SS_GET_RELATIVE_NODE_ID

- 説明: このサービスは、特定の相対ノード識別子を取得します。サイト階層を列挙する場合に便利です。

- パラメータ:

- siteId: サイトの一意の識別子（必須）。

- nodeId: ノードの識別子（必須）。

- relative: parent、child、nextまたはpriorのいずれか（必須）。

- 戻り値:

- relativeId: サイト階層における相対ノードの識別子。そのような相対がない場合、空の文字列が返されます。

- セキュリティ:

- ユーザーは、指定したノードに対して少なくとも読取りアクセス権を持っている必要があります。

- このサービスは、Idocスクリプトから実行できます。

11.7.43 SS_GET_SEARCH_RESULTS

- 説明: このサービスは、通常のGET_SEARCH_RESULTSサービスのラッパーです。これにより、いくつかのSite Studio機能をフラグで簡単に指定し、実際の問合せ構文をサーバー上で構成できます。また、標準のSearchResults結果セットを変更して、すべての検索結果についてSite Studioで使用しやすいURLを格納したssUrlという追加列を含めることができます。

- パラメータ:

- siteId: サイトの一意の識別子（必須）。

- ssLimitScope: これは、サイト内のみに有効範囲を制限します(オプション)。true、falseまたは-1です。
Trueは、xWebsitesに対するQueryTextを句で変更します。

Falseは、xWebsitesに対するQueryTextを変更しません。

-1は、xWebsitesに対するQueryTextを<not>句で変更します。

- ssUserSearchText: ユーザー指定の検索テキスト(オプション)。これは、指定されたQueryTextに結合されます。

- ssWebsiteObjectType: オブジェクト・タイプ(オプション)。これは、QueryTextに、xWebsiteObjectTypeが指定されたオブジェクト・タイプに一致する要件を追加します。

- computeFriendlyUrls: これは、ssUrlを含むように結果を変更します(オプション)。このパラメータはデフォルトではtrueです。

- ssDontShowInLists: これは、siteIdがxDontShowInListsForWebsitesメタデータ・フィールドに含まれているドキュメントに検索を制限します。このパラメータは、trueまたはfalseです。

これらのパラメータはすべて、GET_SEARCH_RESULTSで必要とされるパラメータ以外のものです。

- 戻り値:

- Search Resultsという名前の結果セット。

- セキュリティ: ユーザーは、コンテンツ・サーバーの1つ以上のセキュリティ・グループに対して読取りアクセス権を持っている必要があります。

11.7.44 SS_GET_SITE_AS_XML_EX2

- 説明: このサービスは、ノードおよび属性とともにサイト全体をXMLとして取得します。

- パラメータ:

- siteId: サイトの一意の識別子（必須）。

- includeProperties: ノードのプロパティを結果セットとしてレスポンスに含めるかどうかを指定するtrueまたはfalseのブール型パラメータ(オプション)。

- 戻り値:

- siteXml: サイトのXML表現。

- オプションで、XMLファイルに含まれるノードのプロパティを提供する2つの結果セット(StandardPropertiesおよびSiteStudioProperties)が返されます。nodeIdパラメータにより、結果セットの各行がXMLのノードに関連付けられます。

- セキュリティ: ユーザーは、階層のルート・ノードに対して少なくとも書込みアクセス権を持っている必要があります。返されるXMLでは、階層の各ノードが列挙されます。この理由は、Site Studioでは、変更可能なノードにユーザーがナビゲートできるようにツリー構造を表示する必要があるためです。

11.7.45 SS_GET_SITE_ASSET_CATEGORIES

- 説明: このサービスは、プロジェクト・ファイルからサイトのサイト・アセット・カテゴリを取得します。

- パラメータ:

- siteId: サイトの一意の識別子（必須）。

- 戻り値:

- name、type、querytext、metadataおよびdescriptionの列を含むSiteAssetCategoriesという結果セット。

- セキュリティ: ユーザーは、コンテンツ・サーバーの1つ以上のセキュリティ・グループに対して書込みアクセス権を持っている必要があります。

11.7.46 SS_GET_SITE_CHANGE_MONITOR_TOKEN

- 説明: これは、通常デザイナが10秒(デフォルト)ごとに実行して、サイトが変更されているかどうかを確認するハートビート・メッセージです。

- パラメータ:

- siteId: サイトの一意の識別子（必須）。

- 戻り値:

- ssChangeMonitorToken: Webサイトが変更された時に変更される識別子。

- セキュリティ:

- ユーザーは、プロジェクト・ルート要素に対して少なくとも読取りアクセス権を持っている必要があります。

- このサービスは、Idocスクリプトから実行できます。

11.7.47 SS_GET_SITE_DEFINITION

- 説明: このサービスは、XMLでサイト定義を返します。

- パラメータ:

- siteId: サイトの一意の識別子（必須）。

- 戻り値:

- siteXml: サイト階層のXML表現。

- セキュリティ: ユーザーは、プロジェクト・ルート要素に対して書込みアクセス権を持っている必要があります。

11.7.48 SS_GET_SITE_DEFINITION_FOR_USER

- 説明: このサービスは、ユーザーが読取りアクセス権を持っているすべてのノードを示したサイト定義をXMLで返します。

- パラメータ:

- siteId: サイトの一意の識別子（必須）。

- 戻り値: なし。

- セキュリティ: ユーザーは、コンテンツ・サーバーの1つ以上のセキュリティ・グループに対して書込みアクセス権を持っている必要があります。

11.7.49 SS_GET_SITE_DOMAINS

- 説明: このサービスは、サイトのドメイン・マッピング情報を返します。

- パラメータ:

- siteId: サイトの一意の識別子（必須）。

- 戻り値:

- ssSiteDomains: サイトにマップされているドメインをリストした結果セット。

- セキュリティ: ユーザーは、コンテンツ・サーバーの1つのセキュリティ・グループに対して書込みアクセス権を持っている必要があります。

11.7.50 SS_GET_SITE_FRAGMENT_ASSET_REPORT

- 説明: このサービスは、サイトのすべてのフラグメントで使用されているアセットに関するすべての情報をリストします。

- パラメータ:

- siteId: サイトの一意の識別子（必須）。

- 戻り値:

- アセットに関する情報が返されます。同じ情報は、「管理」ページに表示されます。

- セキュリティ: ユーザーは、読取りアクセス権を持ち、ログインしている必要があります。

11.7.51 SS_GET_SITE_INFO

- 説明: このサービスは、サイトのプロジェクト・ファイルのdDocNameを返します。

- パラメータ:

- siteId: サイトの一意の識別子（必須）。

- 戻り値:

- プロジェクト・ファイルのdDocName。

- セキュリティ: ユーザーは、読取りアクセス権を持っている必要があります。

11.7.52 SS_GET_SITE_PROPERTY

- 説明: このサービスは、サイト・プロパティを取得します。

- パラメータ:

- siteId: サイトの一意の識別子（必須）。

- property: 取得するプロパティの名前(必須)。

- 戻り値:

- value: リクエストされたサイト・プロパティの値。

リクエストされたサイト・プロパティが存在しない場合、このパラメータは戻されませんが、サービス・コールは正常に完了します。

- セキュリティ: ユーザーは、サイトに対して少なくとも読取りアクセス権を持っている必要があります。このサービスは、Idocスクリプトから実行できます。

11.7.53 SS_GET_SITE_PUBLISH_REPORT

- 説明: このサービスは、サイトで使用されているアイテムのレポートを取得します。これは、引用サイトの正確性を保証するためにSite Studioパブリッシュ・ユーティリティ(SSPU)またはSite Studio Publisherで使用するよう設計されています。

- パラメータ:

- siteId: サイトの一意の識別子（必須）。

- 戻り値: サイト・コンテンツを表す多数の結果セットを返します。

- セキュリティ: ユーザーは、サイトのルート・フォルダに対して少なくとも書込みアクセス権を持っている必要があります。

11.7.54 SS_GET_SITE_REPORT

- 説明: このサービスは、サイトで使用されているアイテムのレポートを取得します。

- パラメータ:

- siteId: サイトの一意の識別子（必須）。

- 戻り値: サイト・コンテンツを表す多数の結果セットを返します。

- セキュリティ: ユーザーは、サイトに対して少なくとも書込みアクセス権を持っている必要があります。

11.7.55 SS_GET_SWITCH_CONTENT_CONFIG

- 説明: このサービスは、リストされたリージョン定義に対するコンテンツの切替え構成を返します。

- パラメータ:

- regionDefinition: リージョン定義の一意の識別子(必須)。

- 戻り値:

- ssRegionConfigというリージョン定義のXMLのJSONレスポンス。

- セキュリティ: ユーザーは、サイトに対して少なくとも書込みアクセス権を持っている必要があります。

11.7.56 SS_GET_UNIQUE_NODE_SITE_ID

- 説明: このサービスは、指定されたノードIDに関連付けられているサイトを返します。これは、一意のノードを使用するよう設定されているサーバーで使用します。

- パラメータ:

- nodeId: 関連付けられているサイトを決定するノードの一意の識別子(必須)。

- preferredSiteId: 最初に検索するサイトの一意の識別子。これは、ノードが一意でない可能性がある場合に使用されます。

- 戻り値:

- siteId: サイトの一意の識別子。nodeIdがサイトで見つからない場合、サービスは負の値を含むStatusCodeを返します。

- セキュリティ:

- ユーザーは、指定したノードに対して少なくとも読取りアクセス権を持っている必要があります。

- このサービスは、Idocスクリプトから実行できます。

11.7.57 SS_GET_VERSION

- 説明: このサービスは、Site Studioのバージョン番号、ビルド番号およびOracle Content Serverのバージョン番号を返します。

- パラメータ: なし

- 戻り値:

- Site Studioコンポーネントの製品バージョン番号とビルド番号、およびOracle Content Serverのバージョン番号

- セキュリティ:

- ユーザーは、指定したノードに対して少なくとも読取りアクセス権を持っている必要があります。

- このサービスは、Idocスクリプトから実行できます。

11.7.58 SS_GET_WEBLAYOUT_URL

- 説明: このサービスは、ssWeblayoutUrlというラベルのパラメータで完全なweblayout URLを返します。

- パラメータ:

- ssWebLayoutParam: dDocName、またはパスgroups/で始まるweblayout URL(必須)。

- 戻り値:

- ssWeblayoutUrlというラベルのパラメータに含まれた完全なweblayout URL。

- セキュリティ: ユーザーは、コンテンツ・サーバーの1つ以上のセキュリティ・グループに対して書込みアクセス権を持っている必要があります。

11.7.59 SS_IS_JS_NAV_OUT_OF_DATE

- 説明: このサービスは、ナビゲーション・ファイルが古いかどうかを判別します。

- パラメータ:

- siteId: サイトの一意の識別子（必須）。

- 戻り値:

- 0または1の変数jsNavIsOutOfDate。

- セキュリティ:

- ユーザーは、少なくとも読取りアクセス権を持っている必要があります。

- このサービスは、Idocスクリプトから実行できます。

11.7.60 SS_MAP_FRIENDLY_NAME

- 説明: このサービスは、dDocName値をフレンドリ名に、またはフレンドリ名をdDocNameにマップします。これは、SSUrlFieldName構成設定の使用に関連します。

- パラメータ:

- inputName: dDocNameまたはフレンドリ名の値(必須)。

- direction: fromDocNameまたはtoDocName（必須）。

- 戻り値: なし。

- セキュリティ: ユーザーは、コンテンツ・サーバーの1つ以上のセキュリティ・グループに対して書込みアクセス権を持っている必要があります。

11.7.61 SS_MOVE_NODE

- 説明: このサービスは、階層内でサイト・ノードを移動します。

- パラメータ:

- siteId: サイトの一意の識別子（必須）。

- nodeId: 移動するノードの識別子（必須）。

- newParentId: ノードの新しい親の識別子（必須）。

- insertAfterId: 移動後のノードの前に位置する兄弟の識別子（オプション）。このパラメータが指定されない場合、ノードはnew_parent_idの最初の子になります。

- 戻り値: なし。

- セキュリティ: ユーザーは、新規親ノードに対して少なくとも書込みアクセス権を持っている必要があります。

11.7.62 SS_PARSE_FRIENDLY_URL

- 説明: このサービスは、渡されたリンクのターゲットのsiteIdおよびsiteRelativeUrlを返します。

- パラメータ:

- ssFriendlyUrl: サイトに存在するフレンドリURL(必須)。

- 戻り値:

- siteId: サイトの一意の識別子。

- siteRelativeUrl: 入力されたフレンドリURLの解析済URL。

- セキュリティ: ユーザーは、コンテンツ・サーバーの1つ以上のセキュリティ・グループに対して書込みアクセス権を持っている必要があります。

11.7.63 SS_PREPARE_PREVIEW

- 説明: ファイルのプレビューは、チェックインされた実際のアイテムのディレクトリ下のディレクトリの一時ファイルです。このサービスは、指定されたファイルのプレビューIDを作成します。

- パラメータ:

- path: プレビューされるファイルのローカル・ファイル・システム・パス。

- ssDocName: プレビューするアイテムのコンテンツID。

- 戻り値:

- プレビューID。

- セキュリティ: ユーザーは、プレビューするファイルに対して書込みアクセス権を持っている必要があります。

11.7.64 SS_PUBLISH_THIS_PAGE

- 説明: このサービスは、Site Studio Publisherと対話してノードのURLを公開するために使用される「今すぐ公開」機能と同じです。
このサービスがサイトで機能するには、サイトがSite Studio Designerでサイトの公開の有効化アクションでマークされている必要があります。

- パラメータ:

- nodeId: ノードの一意の識別子。(必須)

- isSecondaryPage: ブール値。デフォルトは、falseです。

- 戻り値: なし。

- セキュリティ: ユーザーは、コンテンツ・サーバーの1つ以上のセキュリティ・グループに対して書込みアクセス権を持っている必要があります。

11.7.65 SS_REMOVE_WEBSITE_ID

- 説明: このサービスは、特定のドキュメントに対応するWebサイトのリストから特定のsiteIdを削除します。

- パラメータ:

- dDocName: サイトの一意の識別子(必須)。

- siteId: サイトの一意の識別子（必須）。

- fieldName: xWebsitesまたはxDontShowInListsForWebsite(必須)。

- 戻り値: なし。

- セキュリティ: ユーザーは、指定されたdDocNameの最新のリビジョンに対して書込みアクセス権を持っている必要があります。

11.7.66 SS_SET_ALL_CUSTOM_NODE_PROP_DEFS

- 説明: このサービスは、特定のサイトのカスタム・ノード・プロパティ定義を設定します。

- パラメータ:

- siteId: サイトの一意の識別子（必須）。CustomNodePropertyDefsという結果セットを入力とします。これには、名前、タイプおよび説明の列があります(必須)。

- 戻り値: なし。

- セキュリティ: ユーザーは、ルート・ノードに対して少なくとも書込みアクセス権を持っている必要があります。

11.7.67 SS_SET_ELEMENT_DATA

- 説明: このサービスは、更新および変更の保存のためにコントリビュータによって使用されます。これは、リビジョンの最後にコールされます。データ・ファイルのチェックアウトは、このサービスに依存しません。変更を含むデータ・ファイルをチェックインするには、そのデータ・ファイルがチェックアウトされている必要があります。

- パラメータ:

- dDocName: データ・ファイルの一意の識別子(必須)。

- dId: チェックアウトされたリビジョンのID(必須)。
前述の2つの値は、データ・ファイルのチェックアウトで取得されます。

- 列element、valueおよびisListを含むSSElementDataという結果セット。isListはブール値のため、yesの場合、要素の名前とリスト・サブ要素で指定された列を含む追加の結果セット。

- 戻り値: なし。

- セキュリティ: ユーザーは、コンテンツ・サーバーの1つ以上のセキュリティ・グループに対して書込みアクセス権を持っている必要があります。

11.7.68 SS_SET_ENVIRONMENT_PROPERTY_NAMES

- 説明: このサービスは、指定されたサイトに対して定義済の環境プロパティを設定します。

- パラメータ:

- siteId: サイトの一意の識別子（必須）。

- EnvironmentPropertiesという結果セット。この結果セットには、環境プロパティとして識別されるプロパティごとに1行を持つnameという単一の列が含まれます。

- 戻り値: なし。

- セキュリティ: ユーザーは、コンテンツ・サーバーの1つ以上のセキュリティ・グループに対して書込みアクセス権を持っている必要があります。

11.7.69 SS_SET_NODE_PROPERTY

- 説明: このサービスは、ノード・プロパティを設定します。

- パラメータ:

- siteId: サイトの一意の識別子（必須）。

- nodeId: ノードの一意の識別子（必須）。

- property: 設定または削除するプロパティの名前（必須）。

- value: 属性の新しい値（オプション）。値が指定されない場合、プロパティは削除されます。

- 戻り値: なし。

- セキュリティ: ユーザーは、ノードに対して少なくとも書込みアクセス権を持っている必要があります。

11.7.70 SS_SET_NODES_PROPERTIES

- 説明: このサービスは、複数のノードで複数のノード・プロパティを設定する方法です。

- パラメータ:

- siteId: サイトの一意の識別子（必須）。

- nodeId0: ノードの一意の識別子(必須)。
. . .

nodeIdN

- property0: プロパティの名前(必須)。
. . .

propertyN

- value0: 対応するプロパティの値(必須)。
. . .

valueN

- 戻り値:

- プロパティ・セットの数であるrowsProcessed値

- セキュリティ: ユーザーは、ノードに対して少なくとも書込みアクセス権を持っている必要があります。

11.7.71 SS_SET_PREVIEW_ELEMENT_DATA

このサービスは、SET_ELEMENT_DATAを特化したもので、データはプレビューの場所に保存され、チェックインされません。

詳細は、11.7.67項「SS_SET_ELEMENT_DATA」を参照してください。

11.7.72 SS_SET_SITE_ASSET_CATEGORIES

- 説明: このサービスは、サイト・アセット・カテゴリの変更の保存に使用されます。

- パラメータ:

- siteId: サイトの一意の識別子（必須）。

- description、metadata、name、querytextおよびtypeの列を含むSiteAssetCategoriesという結果セット。名前とタイプの値を指定する必要があります。これらの値は、『Oracle WebCenter Content Site Studio Designerユーザーズ・ガイド』の「サイト・アセット・カテゴリ」ダイアログの説明に一致します。

- 戻り値: なし。

- セキュリティ: ユーザーは、コンテンツ・サーバーの1つ以上のセキュリティ・グループに対して書込みアクセス権を持っている必要があります。

11.7.73 SS_SET_SITE_DOMAINS

- 説明: このサービスは、サイトのドメイン・マッピング情報を設定します。

- パラメータ:

- siteId: サイトの一意の識別子（必須）。

- ssSiteDomains: サイトにマップするドメインをリストした結果セット。

- 戻り値: なし。

- セキュリティ: ユーザーは、コンテンツ・サーバーの1つ以上のセキュリティ・グループに対して書込みアクセス権を持っている必要があります。

11.7.74 SS_SET_SITE_PROPERTIES

- 説明: このサービスは、単一のサービス・コールで複数のサイト・プロパティを設定します。

- パラメータ:

- siteId: サイトの一意の識別子（必須）。

- property: 取得するプロパティの名前(必須)。

- value: リクエストされたサイト・プロパティの値。

- 戻り値: なし。

- セキュリティ: ユーザーは、コンテンツ・サーバーの1つ以上のセキュリティ・グループに対して書込みアクセス権を持っている必要があります。

11.7.75 SS_SET_SITE_PROPERTY

- 説明: このサービスは、サイト・プロパティを設定します。

- パラメータ:

- siteId: サイトの一意の識別子（必須）。

- property: 設定または削除するプロパティの名前（必須）。

- value: 属性の新しい値（オプション）。値が指定されない場合、プロパティは削除されます。

- 戻り値: なし。

- セキュリティ: ユーザーは、サイトに対して少なくとも書込みアクセス権を持っている必要があります。

11.7.76 SS_SWITCH_REGION_ASSOCIATION

- 説明: このサービスは、特定のノードの特定のリージョンに関連付けられたdDocNameを変更します。

- パラメータ:

- siteId: サイトの一意の識別子（必須）。

- nodeId: ノードの識別子（必須）。

- region: リージョン識別子（必須）。

- primaryUrl: primaryUrlの指定されたリージョンに設定するdDocName値(オプション)。

- secondaryUrl: secondaryUrlの指定されたリージョンに設定するdDocName値(オプション)。

- primaryTemplateUrl: プライマリ・ページの指定されたリージョンに設定するリージョン・テンプレートまたはサブテンプレートのdDocName値(オプション)。

- secondaryTemplateUrl: セカンダリ・ページの指定されたリージョンに設定するリージョン・テンプレートまたはサブテンプレートのdDocName値(オプション)。

- 戻り値: なし。

- セキュリティ: ユーザーは、ノードに対して少なくとも書込みアクセス権を持っている必要があります。

11.7.77 SS_VALIDATE_WEBSITE_OBJECT

- 説明: このサービスは、オブジェクト・タイプの既知のXSDスキーマに対してWebサイト・オブジェクト(XML)を検証します。

- パラメータ:

- websiteObject:path: 検証およびアップロードするローカル・オブジェクト・ファイルのパス。

- websiteObjectType: ローカル・オブジェクト・ファイルのオブジェクト・タイプ。

- 戻り値:

- メッセージとステータス・コードを含むバインダ・レスポンス。

- セキュリティ: ユーザーは、コンテンツ・サーバーの1つ以上のセキュリティ・グループに対して書込みアクセス権を持っている必要があります。

11.7.78 WCM_PLACEHOLDER

このサービスはプレースホルダを評価し、Oracle Content Serverにアクセス可能などこからでもプレースホルダのコンテンツを直接取得できるようにします。

これによって、Oracle Content Serverによって管理され、Site Studio Contributorによって編集可能なXMLデータ・ファイルをベースに、完全なSite Studio Webサイトの使用を強制されずにサード・パーティ・アプリケーションを作成できます。

- パラメータ:

- dataFileDocName: プレースホルダに関連付けるデータ・ファイルのdDocName。

- templateDocName: プレースホルダに関連付けるリージョン・テンプレートまたはサブテンプレートのdDocName。

- placeholderDefinitionDocName: プレースホルダにマップするプレースホルダ定義のdDocName。

- regionDefinitionDocName: templateDocNameで指定されたリージョン・テンプレートに関連付けるリージョン定義のdDocName。

- placeholderActions: プレースホルダ定義の許可されるアクション。次のものがあります。

- Eは、コントリビュータの更新を許可します。

- Pは、ワークフローの承認を許可します。

- Rは、ワークフローの却下を許可します。

- Iは、docInfoの表示を許可します。

- Sは、データ・ファイルの切替えを許可します。

- Uは、Web使用状況レポートの表示を許可します。

- Tは、Webトラッカ・レポートの表示を許可します。

- Mは、docInfoの更新を許可します。

- Vは、リージョン・テンプレートの切替えを許可します。

- Nは、コンテンツの削除を許可します。

各選択肢は、デザイナのプレースホルダ定義の設計ビューにあるアクションのチェックボックスに対応します。

- 戻り値:

- 評価されるプレースホルダ・コンテンツ。

これらは、wcmPlaceholderスクリプト拡張機能に必要なパラメータと同じです。

このサービスは、Webキャッシュおよび部分ページ・キャッシュのEdge Side Includes (ESI)で使用できます。ページがESI環境でレンダリングされる場合、ESIサーバーはプレースホルダ・コンテンツのリクエストをキャッシュできます。

11.7.79 WCM_EDIT_DATA_FILE

このサービスはSite Studio Contributorを表示し、ユーザーが指定されたデータ・ファイルを編集できるようにします。

パラメータ

- dDocName: データ・ファイルの一意の識別子。

ファイルをチェックインする際、ヘッド・リビジョンでない場合、チェックインを完了できません。

注意:
このサービスは、あまり直接コールしないでください。かわりに、WCM_BEGIN_EDIT_SESSIONのコールを検討してください。

11.7.80 WCM_BEGIN_EDIT_SESSION

このサービスは、WCM_EDIT_DATA_FILEサービスで編集する前にデータ・ファイルをチェックアウトするために使用されます。チェックアウト後、WCM_BEGIN_EDIT_SESSIONは自動的にWCM_EDIT_DATA_FILEにリダイレクトされます。

- パラメータ:

- dDocName: Site Studioデータ・ファイルの一意の識別子(必須)。

12 Site Studio構成フラグ

この項の内容は次のとおりです。

- 12.1項「Site Studioフラグについて」

- 12.2項「DisableSiteStudioContribution」

- 12.3項「ShowSiteStudioMissingDataFileErrors」

- 12.4項「SiteStudioValidateElementDefinitions」

- 12.5項「SiteStudioValidateRegionDefinitions」

- 12.6項「SiteStudioValidatePlaceholderDefinitions」

- 12.7項「SiteStudioValidateConversionsDefinitions」

- 12.8項「SiteStudioValidateDataFiles」

- 12.9項「SiteStudioValidateProjects」

- 12.10項「SSAccessDeniedHeader」

- 12.11項「SSAccessDeniedReplacementHeader」

- 12.12項「SSAccessDeniedUserAgentExceptions」

- 12.13項「SSAccommodateWelcomeFile」

- 12.14項「SSAdditionalNavResultSetFields」

- 12.15項「SSAddSecurityIDValues」

- 12.16項「SSAfterProjectLoadedProperties」

- 12.17項「SSAllowDynamicDefinitions」

- 12.18項「SSAllowEmptyUrlPageName」

- 12.19項「SSAllowNotModifiedHeader」

- 12.20項「SSAltTagFieldName」

- 12.21項「SSAlwaysRecordServerConfig」

- 12.22項「SSAlwaysUseSiteIdInLinks」

- 12.23項「SSAssumeXmlIsUtf8」

- 12.24項「SSAutoCheckinBusyTimeout」

- 12.25項「SSBackupCollectionName」

- 12.26項「SSCacheControlOverride」

- 12.27項「SSCanGenerateUniqueDataFiles」

- 12.28項「SSChangeAccessDeniedHeaders」

- 12.29項「SSCheckAssignedContentAccess」

- 12.30項「SSCheckBrowserForSiteRoot」

- 12.31項「SSCheckNodeIdUniqueness」

- 12.32項「SSCheckWebsiteObjectSecurity」

- 12.33項「SSClearDefinitionArchiveWebsites」

- 12.34項「SSCompressorArguments」

- 12.35項「SSCompressorCommand」

- 12.36項「SSCompressorDir」

- 12.37項「SSCompressorJar」

- 12.38項「SSCompressorMainClass」

- 12.39項「SSCompressorTimeout」

- 12.40項「SSCompressorTimerInterval」

- 12.41項「SSCompressorWaitForever」

- 12.42項「SSContributorSourceDir」

- 12.43項「SSCustomNodePropertyDefsPermissions」

- 12.44項「SSDefaultDocumentsFields」

- 12.45項「SSDefaultEditor」

- 12.46項「SSDefaultExternalDocNamePrefix」

- 12.47項「SSDefaultExternalDocNameSuffix」

- 12.48項「SSDefaultExternalServerRelativeSiteRoot」

- 12.49項「SSDefaultExternalUrlPrefix」

- 12.50項「SSDefaultExternalUrlSuffix」

- 12.51項「SSDefaultPlaceholderDefinition」

- 12.52項「SSDefaultRegionTemplate」

- 12.53項「SSDefaultUrlPageName」

- 12.54項「SSDetectIncludeFileEncoding」

- 12.55項「SSDICPlaceholderDefinition」

- 12.56項「SSDirectDeliveryExtensions」

- 12.57項「SSDirectDeliveryOverrideProperty」

- 12.58項「SSDirectDeliveryProperty」

- 12.59項「SSDirectDeliveryRequiredExtensions」

- 12.60項「SSDisableDeferredNodeExpansion」

- 12.61項「SSDisableIncludeXmlCache」

- 12.62項「SSDisableLinkResolutionSiteLocking」

- 12.63項「SSDisableProjectDeferredNodeExpansion」

- 12.64項「SSDomCacheDefaultFileSizeFactor」

- 12.65項「SSDomCacheFileSizeFactors」

- 12.66項「SSDomCacheLowerBound」

- 12.67項「SSDomCacheMultiplier」

- 12.68項「SSDomCacheNodeMultiplier」

- 12.69項「SSDomCacheStringMultiplier」

- 12.70項「SSDomCacheStringOverhead」

- 12.71項「SSDomCacheUseDOM」

- 12.72項「SSDomCacheUseFileSize」

- 12.73項「SSEditorDebugLevel」

- 12.74項「SSEnableASPSupport」

- 12.75項「SSEnableDirectDelivery」

- 12.76項「SSEnableExtranetLookCompatibility」

- 12.77項「SSEnableFolioEditing」

- 12.78「SSEnableFormEditing」

- 12.79項「SSEnableJavaScriptCompressor」

- 12.80項「SSEnableUpperCaseColumnsCheck」

- 12.81項「SSGenerateUniqueNodeIds」

- 12.82項「SSHidePrimaryFileInContributor」

- 12.83項「SSHttpAbsoluteHelpRoot」

- 12.84項「SSHttpLayerManager」

- 12.85項「SSIdocMarker」

- 12.86項「SSIgnoreMaxAgeNodeProperties」

- 12.87項「SSIgnoreNoProjectDefaultMetadataMessage」

- 12.88項「SSIgnoreReadyToReplicate」

- 12.89項「SSImportOnlyLatestRevs」

- 12.90項「SSIncludeInactiveNodesInNavResultSet」

- 12.91項「SSIncludeInactiveNodesInNavXML」

- 12.92項「SSIncludeRegionTemplatesInDefinitionBundles」

- 12.93項「SSIncludeXmlTransformFormat」

- 12.94項「SSIncludeXmlTransformIndent」

- 12.95項「SSJavaExecutablePath」

- 12.96項「SSJSONContentType」

- 12.97項「SSLoadCustomElementsWithOnDemandEditors」

- 12.98項「SSLoadProjectsAtStartup」

- 12.99項「SSLoadUncompressedFckSource」

- 12.100項「SSManuallyValidateNodeIdUniqueness」

- 12.101項「SSMaxNodeIdLength」

- 12.102項「SSMaxSiteIdLength」

- 12.103項「SSMaxSitesMenuItems」

- 12.104項「SSMaxTemplateEvaluationStack」

- 12.105項「SSMigrationCollectionName」

- 12.106項「SSOmitFragmentLibrariesInArchiverQueries」

- 12.107項「SSOnDemandEditorsThresholdCount」

- 12.108項「SSPrefillUrlDirNamesDuringUpgrade」

- 12.109項「SSProjectAutoCheckinInterval」

- 12.110項「SSProjectLoadFailureTracingSection」

- 12.111項「SSProjectReleaseSleepTime」

- 12.112項「SSProjectReleaseWaitTime」

- 12.113項「SSQuickDiffDefaultRegionTemplate」

- 12.114項「SSShowAssignmentTooltips」

- 12.115項「SSSQLUseContains」

- 12.116項「SSStoppedSiteResponsePageDocName」

- 12.117項「SSSuppressAddToWebsite」

- 12.118項「SSSuppressLargeCssOptimization」

- 12.119項「SSTempProjectLifetime」

- 12.120項「SSTitleTagFieldName」

- 12.121項「SSTrackContentAccess」

- 12.122項「SSTrackFragmentAccess」

- 12.123項「SSUrlFieldName」

- 12.124項「SSUrlFixupExceptions」

- 12.125項「SSUrlPageNames」

- 12.126項「SSUseAbsoluteRedirects」

- 12.127項「SSUseCallbackTrackingForASP」

- 12.128項「SSUseDefaultDocNamePrefix」

- 12.129項「SSUseDefaultServerRelativeSiteRoot」

- 12.130項「SSUseDefaultUrlPrefix」

- 12.131項「SSUseMissingLinkTargetFallback」

- 12.132項「SSUseOnDemandContributionModeMenus」

- 12.133項「SSUseUrlSegmentSessionInfo」

- 12.134項「SSValidateCustomElements」

- 12.135項「SSWebFilterIgnoreList」

- 12.136項「SSWeblayoutUrlUsesDocNames」

- 12.137項「SSWelcomeFile」

- 12.138項「SSWelcomeFileReplacement」

12.1 Site Studioフラグについて

Site Studioでは、Site Studioの操作のカスタマイズに使用可能な構成フラグがサポートされます。これらのフラグによって、Oracle Content Serverで、またデザイナとコントリビュータ向けにSite Studioの操作を詳細に制御できます。フラグを変更するたびにコンテンツ・サーバーを再起動する必要があります。

Oracle UCMの構成パラメータを追加するには、次の手順を実行します。

1. 管理者として次のURLでOracle Content Serverにログインします。
http://Host_Name:Port/cs

Oracle Content Serverのデフォルト・プロトコルはhttpで、csは、Oracle Content Serverのデフォルトhttp相対Webルートです。デフォルト・ポート番号は16200です。

2. 「管理」ページを開き、「管理サーバー」を選択します。「コンテンツ管理サーバー」ページが開きます。

3. 左側の「一般構成」をクリックします。「一般構成」ページが開きます。

4. 「追加の構成変数」ボックスで、必要に応じてパラメータを追加または変更します。

5. 「保存」をクリックし、コンテンツ・サーバーを再起動します。

デフォルト値のないフラグは構成ファイルに追加する必要があります。出荷時、config.cfgファイルには含まれていません。

12.2 DisableSiteStudioContribution

このフラグは、ページがコントリビューション・モードで開かれないようにします。コントリビューション・モードに切り替えるあらゆる方法がブロックされます。これは、本番Webサイトまたは読取り専用Webサイトを作成する場合に有用です。

値

ブール値

デフォルト

no

12.3 ShowSiteStudioMissingDataFileErrors

このフラグは、空のデータ・ファイル割当てのコントリビューション・リージョンにメッセージが表示されるかどうかの制御に使用されます。

値

ブール値

デフォルト

no

12.4 SiteStudioValidateElementDefinitions

このフラグは、要素定義ファイルがXSDスキーマに対して検証されるかどうかの制御に使用されます。

値

ブール値

デフォルト

yes

12.5 SiteStudioValidateRegionDefinitions

このフラグは、リージョン定義ファイルがXSDスキーマに対して検証されるかどうかの制御に使用されます。

値

ブール値

デフォルト

yes

12.6 SiteStudioValidatePlaceholderDefinitions

このフラグは、プレースホルダ定義ファイルがXSDスキーマに対して検証されるかどうかの制御に使用されます。

値

ブール値

デフォルト

yes

12.7 SiteStudioValidateConversionsDefinitions

このフラグは、変換定義ファイルがXSDスキーマに対して検証されるかどうかの制御に使用されます。

値

ブール値

デフォルト

yes

12.8 SiteStudioValidateDataFiles

このフラグは、データ・ファイルがXSDスキーマに対して検証されるかどうかの制御に使用されます。

値

ブール値

デフォルト

yes

12.9 SiteStudioValidateProjects

このフラグは、プロジェクト・ファイルがXSDスキーマに対して検証されるかどうかの制御に使用されます。

値

ブール値

デフォルト

yes

12.10 SSAccessDeniedHeader

このフラグは、httpレスポンス内で検索するヘッダー文字列の定義に使用されます。検出された場合、フラグSSAccessDeniedReplacementHeaderの値と置き換えられます。(12.11項「SSAccessDeniedReplacementHeader」を参照)

値

文字列

デフォルト

401 Access denied

12.11 SSAccessDeniedReplacementHeader

このフラグは、SSAccessDeniedHeaderの値のかわりに使用されるヘッダー文字列の定義に使用されます(12.10項「SSAccessDeniedHeader」を参照)。

値

文字列

デフォルト

499 Oracle SSO

12.12 SSAccessDeniedUserAgentExceptions

このフラグは、HTTP-USER-AGENTヘッダー内にあった場合に、特定のリクエストに対してSSChangeAccessDeniedHeadersフラグ(12.28項「SSChangeAccessDeniedHeaders」を参照)を無効にする値のカンマ区切りのリストの設定に使用されます。

値

CSV文字列

デフォルト

デフォルト値はありません。

12.13 SSAccommodateWelcomeFile

このフラグは、WLSベースのコンテンツ・サーバーの<welcome-file>メカニズムが提供されるかどうかの制御に使用されます。

値

ブール値

デフォルト

yes

12.14 SSAdditionalNavResultSetFields

このフラグは、ssLoadSiteNavResultSet Idoc関数(9.31項「ssLoadSiteNavResultSet」を参照)で使用されるSiteStudioNavNodes ResultSetのプロパティの標準のセットに追加するセクション・プロパティのカンマ区切りのリストの指定に使用されます。

値

CSV文字列

デフォルト

デフォルト値はありません。

12.15 SSAddSecurityIDValues

このフラグは、セクションへのユーザー・アクセスに使用されるResultSetにdID値0が含まれるどうかの指定に使用されます。これは、以前のバージョンのRecords Managementで操作するめには必要でした。

値

ブール値

デフォルト

no

12.16 SSAfterProjectLoadedProperties

このフラグは、外部アプリケーション向けにSite Studioで使用されるSSAfterProjectLoadedプラグイン・フィルタに送信するサイト・プロパティのカンマ区切りのリストの指定に使用されます。

値

CSV文字列

デフォルト

siteLabel,siteType,isExternal

12.17 SSAllowDynamicDefinitions

このフラグは、ディスクからロードされた定義ファイルのIdoc評価の有効化/無効化に使用されます。

値

ブール値

デフォルト

yes

12.18 SSAllowEmptyUrlPageName

このフラグは、Urlページ名が空の値の受信URLに対してランディング・ページが配信されるかどうかの指定に使用されます。Site Studioの以前のバージョンでは、このような場合、リダイレクトが行われて完全ランディング・ページURLが生成されました。以前の動作に戻すには、オプションをfalseに設定します。

値

ブール値

デフォルト

yes

12.19 SSAllowNotModifiedHeader

このフラグは、Site Studio Publisherユーティリティのカスタマイズされた動作のオーバーライドに使用されます。SSPETagフラグは、GET_FILE URLの結果が変更されていないことを示す304を返すために使用されます。7.2以上のサーバーでこの動作を無効にするには、SSAllowNotModifiedHeaderフラグを使用します。

値

ブール値

デフォルト

yes

12.20 SSAltTagFieldName

このフラグは、コントリビュータを介して挿入されるイメージのalt tagタグに使用されるメタデータ・フィールドの名前の指定に使用されます。

値

文字列

デフォルト

dDocTitle

12.21 SSAlwaysRecordServerConfig

このフラグは、バックアップ・アーカイブにサーバー構成を記録するかどうかの指定に使用されます。

値

ブール値

デフォルト

no

12.22 SSAlwaysUseSiteIdInLinks

このフラグは、リンク形式でサイトIDが常に使用されるかどうかの指定に使用されます。

値

ブール値

デフォルト

no

12.23 SSAssumeXmlIsUtf8

このフラグは、拡張子が.xmlのファイルのコンテンツがUTF-8形式でエンコードされているかの判別に使用されます。フラグがyesに設定されている場合、この仮定によってファイルのエンコード宣言の確認が省略され、XMLファイルの処理が迅速化されます。

値

ブール値

デフォルト

yes

12.24 SSAutoCheckinBusyTimeout

このフラグは、自動チェックイン・メカニズムによってプロジェクト・ファイルのチェックインが試行されるまでの最小時間(秒)の設定に使用されます。これによって、2つのノードが同時にプロジェクト・ファイルをチェックインすることが回避されます。

値

整数

デフォルト

30

12.25 SSBackupCollectionName

このフラグは、アーカイバで使用されるSite Studioバックアップ・コレクションの名前のオーバーライドに使用されます。

値

文字列

デフォルト

デフォルト値はありません。

12.26 SSCacheControlOverride

このフラグは、各レスポンスに同じcache-controlヘッダーを指定するために使用されます。maxageおよびmaxagesecondaryノード・プロパティによる指定が置き換えられます。12.86項「SSIgnoreMaxAgeNodeProperties」も参照してください。

値

文字列

デフォルト

デフォルト値はありません。

12.27 SSCanGenerateUniqueDataFiles

このフラグは、設計モードでの「リージョン」メニューの一意のデータ・ファイルの生成オプションのグローバル・オーバーライドとして使用されます。yesに設定されている場合、オプションを設計モードで使用できます。

値

ブール値

デフォルト

yes

12.28 SSChangeAccessDeniedHeaders

このフラグは、Oracle SSOで使用するために401レスポンスが499レスポンスに変更されるかどうかの制御に使用されます。

値

ブール値

デフォルト

いいえ

12.29 SSCheckAssignedContentAccess

このフラグは、セキュリティ・アクセス用のプライマリURLまたはセカンダリURLに割り当てられているdDocNamesのチェックに使用されます。このチェックは、SS_GET_PAGEのアクション部分の際に行われるため、エラー・ページが表示される場合があります。

値

ブール値

デフォルト

no

12.30 SSCheckBrowserForSiteRoot

このフラグは、ブラウザURLに対するサーバー相対サイト・ルート値を生成するかどうかを示すために使用されます。noに設定されている場合、サーバー相対URL接頭辞がデフォルト・サイト・アドレスから生成されます。

値

ブール値

デフォルト

yes

12.31 SSCheckNodeIdUniqueness

このフラグは、ノードIDがサーバーで一意でないと判別された場合に、IDベースのリンクへのサイトIDの追加に使用されます。yesに設定されている場合、チェックが行われ、必要に応じてサイトIDがリンクに追加されます。noに設定されている場合、チェックは行われず、サイトIDはリンクに追加されません。

注意:
一意でないノードIDが存在することが明らかな場合にのみこのフラグの使用を検討してください。サーバー上の各ノードのチェックが必要なため、サイトが多数ある場合、多数のコールが発生します。

値

ブール値

デフォルト

no

12.32 SSCheckWebsiteObjectSecurity

このフラグは、Webサイト・オブジェクトのセキュリティ・チェックのアクティブ化に使用されます。通常、ページの配信時のコンポーネント/サーバーによるWebサイト・オブジェクトの使用で、リソースへのエンドユーザー・アクセスは発生しないため、これらのオブジェクトへのセキュリティ・チェックはありません。このフラグをtrueに設定すると、各Webサイト・オブジェクトに対するセキュリティ・チェックがアクティブ化されます。

値

ブール値

デフォルト

no

12.33 SSClearDefinitionArchiveWebsites

このフラグは、定義アーカイブのインポート時の既存のxWebsites値の強制削除に使用されます。

値

ブール値

デフォルト

no

12.34 SSCompressorArguments

このフラグは、JavaScriptコンプレッサ・プロセスに渡される追加引数に使用されます。

値

文字列

デフォルト

デフォルト値はありません。

12.35 SSCompressorCommand

このフラグは、JavaScriptコンプレッサ・プロセスを起動するためのコマンドラインのかわりとして使用されます。

値

文字列

デフォルト

デフォルト値はありません。

使用される文字列値の詳細は、Oracle Content Serverのwcm\tools\yui-compressor\doc\フォルダにあるREADMEファイルを参照してください。

12.36 SSCompressorDir

このフラグは、JavaScriptコンプレッサの実装場所のオーバーライドとして使用されます。

値

文字列

デフォルト

<weblayout>/resources/wcm/tools/optimize

12.37 SSCompressorJar

このフラグは、JavaScriptコンプレッサRhino jarファイルの場所のオーバーライドとして使用されます。

値

文字列

デフォルト

<weblayout>/resources/wcm/tools/rhino/rhino1_7R2/js.jar

12.38 SSCompressorMainClass

このフラグは、JavaScriptコンプレッサのメイン・クラスのオーバーライドとして使用されます。

値

文字列

デフォルト

org.mozilla.javascript.tools.shell.Main

12.39 SSCompressorTimeout

このフラグは、JavaScriptコンプレッサのプロセスが完了するための最小許容時間(秒)のオーバーライドに使用されます。

値

整数

デフォルト

900

12.40 SSCompressorTimerInterval

このフラグは、JavaScriptコンプレッサのプロセス・スリープ間隔の長さ(秒)のオーバーライドに使用されます。

値

整数

デフォルト

10

12.41 SSCompressorWaitForever

このフラグは、JavaScriptコンプレッサのファイル・ロック待機時間のオーバーライドに使用されます。

値

ブール値

デフォルト

no

12.42 SSContributorSourceDir

このフラグは、コントリビュータJavaScriptコードが参照される<weblayout>/resourcesディレクトリ内のディレクトリの判別に使用されます。

値

文字列

デフォルト

wcm

12.43 SSCustomNodePropertyDefsPermissions

このフラグは、ユーザーがカスタム・ノード・プロパティにアクセスするために必要なデフォルト権限の判別に使用されます。

値は、次の4つのいずれかです。

- 1 = 読取り権限

- 2 = 書込み権限

- 4 = 削除権限

- 8 = 管理権限

値

整数

デフォルト

2

12.44 SSDefaultDocumentsFields

このフラグは、デフォルト・ドキュメント・フィールドのオーバーライドに使用されます。使用するデフォルト・ドキュメント・フィールドを入力します。

値

CSV文字列

デフォルト

デフォルト値はありません。入力される値は、フィールド名です。

12.45 SSDefaultEditor

このフラグは、コントリビュータ・アプリケーションの基本エディタの指定に使用されます。

値

文字列

デフォルト

fck

12.46 SSDefaultExternalDocNamePrefix

このフラグは、dDocNameパラメータを持つタイプ・リソースの評価済wcmUrlリンクの前に付けられる文字列(場合によっては部分URL)の指定に使用されます。これは、生成されるURLの変更の必要の可能性があるWCM_PLACEHOLDERサービスを介してコンテンツを配信する際に使用されます。

値

文字列

デフォルト

<$HttpAbsoluteWebRoot$>の評価

12.47 SSDefaultExternalDocNameSuffix

このフラグは、dDocNameパラメータを持つタイプ・リソースの評価済wcmUrlリンクに付けられる文字列(場合によってはURL問合せセグメント)の指定に使用されます。これは、生成されるURLの変更の必要の可能性があるWCM_PLACEHOLDERサービスを介してコンテンツを配信する際に使用されます。

値

文字列

デフォルト

デフォルト値はありません。

12.48 SSDefaultExternalServerRelativeSiteRoot

このフラグは、<$ssServerRelativeSiteRoot$>を評価する際に使用する文字列の指定に使用されます。これは、生成されるURLの変更の必要の可能性があるWCM_PLACEHOLDERサービスを介してコンテンツを配信する際に使用されます。

値

文字列

デフォルト

デフォルト値はありません。

12.49 SSDefaultExternalUrlPrefix

このフラグは、部分weblayoutパス・パラメータを持つタイプ・リソースの評価済wcmUrlリンクの前に付けられる文字列(場合によっては部分URL)の指定に使用されます。これは、生成されるURLの変更の必要の可能性があるWCM_PLACEHOLDERサービスを介してコンテンツを配信する際に使用されます。

値

文字列

デフォルト

<$HttpAbsoluteWebRoot$>の評価

12.50 SSDefaultExternalUrlSuffix

このフラグは、部分weblayoutパス・パラメータを持つタイプ・リソースの評価済wcmUrlリンクに付けられる文字列(場合によってはURL問合せセグメント)の指定に使用されます。これは、生成されるURLの変更の必要の可能性があるWCM_PLACEHOLDERサービスを介してコンテンツを配信する際に使用されます。

値

文字列

デフォルト

デフォルト値はありません。

12.51 SSDefaultPlaceholderDefinition

このフラグは、プレースホルダ定義のオーバーライドに使用されます。

値

文字列

デフォルト

SS_DEFAULT_PLACEHOLDER_DEFN

12.52 SSDefaultRegionTemplate

このフラグは、デフォルト・リージョン・テンプレートのオーバーライドに使用されます。

値

文字列

デフォルト

SS_DEFAULT_REGION_TEMPLATE

12.53 SSDefaultUrlPageName

このフラグは、デフォルトurlページ名の値の変更に使用されます。これによって、指定されたindex.htm以外のファイルをWebサイトのセクションのデフォルト・ページにすることができます。

フラグSSUrlPageNames(12.125項「SSUrlPageNames」を参照)によって、他のurlページ名をプライマリ・ページの配信に使用できます。

値

文字列

デフォルト

デフォルト値はありません。

12.54 SSDetectIncludeFileEncoding

このフラグは、Webサイト・オブジェクトのエンコーディングが判別されるかどうかの指定に使用されます。

値

ブール値

デフォルト

no

12.55 SSDICPlaceholderDefinition

このフラグは、デフォルト・プレースホルダ定義名がドキュメント情報コントリビューションで使用されるよう指定するために使用されます。

値

文字列

デフォルト

SS_DEFAULT_PLACEHOLDER_DEFN

12.56 SSDirectDeliveryExtensions

このフラグは、直接配信されるファイル拡張子の指定に使用されます。フラグがconfig.cfgにリストされていない場合、PDFファイルは直接配信で渡され、他のネイティブ・ドキュメントは変換ルールに従います。

フラグが存在する場合、ここに(ファイル拡張子で)リストされているすべてのファイル・タイプは直接配信されます。特にリストされていないファイル・タイプは、変換を介して表示されます。これには、pdfファイルも含まれます(フラグがあり、pdfファイルがリストされていない場合)。

値

CSV文字列

デフォルト

pdf

12.57 SSDirectDeliveryOverrideProperty

このフラグは、セクションのグローバル値のオーバーライドに使用されるカスタム・セクション・プロパティの指定に使用されます。フラグで指定されたプロパティでは、ブール値を使用してグローバル値がオーバーライドされるかどうか示される必要があります。

値

文字列

デフォルト

OverrideDirectDeliveryExtensions

12.58 SSDirectDeliveryProperty

このフラグは、カスタム・セクション・プロパティの名前の指定に使用されます。このプロパティは、この特定のセクションから直接配信されるファイル拡張子を識別します。

ここにリストされたファイル拡張子によって、SSDirectDeliveryExtensions(12.56項「SSDirectDeliveryExtensions」を参照)のグローバル・リストがオーバーライドされます。

値

文字列

デフォルト

DirectDeliveryExtensions

12.59 SSDirectDeliveryRequiredExtensions

このフラグは、常に直接配信によって配信されるファイル・タイプの指定に使用されます。ここにリストされたファイル拡張子は、SSDirectDeliveryProperty(12.58項「SSDirectDeliveryProperty」を参照)でのリストによってオーバーライドされません。

値

CSV文字列

デフォルト

pdf

12.60 SSDisableDeferredNodeExpansion

このフラグは、遅延ノード展開の有効化または無効化に使用されます。Xercesパーサーの遅延ノード展開機能は、小規模なDOMには非効率的な機能として知られているため、このフラグをnoに設定すると、パフォーマンスが悪化する可能性があります。

値

ブール値

デフォルト

yes

12.61 SSDisableIncludeXmlCache

このフラグは、データ・ファイルから抽出されたコンテンツがキャッシュされるかどうかの制御に使用されます。このキャッシュによって、データ・ファイルからのコンテンツの取得が大幅に速くなります。

値

ブール値

デフォルト

no

12.62 SSDisableLinkResolutionSiteLocking

この構成フラグは、ページの編成時にサイトのロック競合を減らすために使用されます。フラグがyesに設定されている場合、Idocスクリプト拡張機能ssLinkおよびssNodeLinkとこれに対応するwcmUrl (wcmUrl('link'...およびwcmUrl('nodelink'...)で内部Webサイト情報構造のアクセスを同期化しないようにします。これで、ロック競合が減ってパフォーマンスが向上し、複数リクエストの同時処理が可能になります。ただし、Webサイトの変更で不適切なリンクが生成されるリスクもあります。

フラグをyesに設定することは、Oracle Content Serverが次の状況で実行されている場合に有用です。

- Site Studio Webサイトの変更が頻繁でなく、ほぼ読取り専用環境です。

- Webページに、リンクを生成するssLinkまたはssNodeLinkコールが多数含まれています。

- サーバーの負荷が通常高く、Site Studio内でロック競合が起こります。

値

ブール値

デフォルト

no

12.63 SSDisableProjectDeferredNodeExpansion

このフラグは、XMLファイルのロード時にDOMノードがメモリーで展開されるか、ノード・コンテンツがオンデマンドでロードされるかの制御に使用されます。

値

ブール値

デフォルト

yes

12.64 SSDomCacheDefaultFileSizeFactor

このフラグは、キャッシュ・サイズを求めるためにファイル・サイズに掛けるデフォルト・ファイル・サイズ値を指定します。

値

数値

デフォルト

2.0

12.65 SSDomCacheFileSizeFactors

このフラグは、キャッシュ・サイズの計算を制御するファイル・サイズと乗数のカンマ区切りのリストを定義します。

たとえば、次の文字列があるとします。

1000,6.0,10000,2.7,50000,2.1,100000,1.9,300000,1.6

[0..999]のファイル・サイズに6.0が掛けられます。

[1000..9999]のファイル・サイズに2.7が掛けられます。

[10000..49999]のファイル・サイズに2.1が掛けられます。

[50000..99999]のファイル・サイズに1.9が掛けられます。

[100000..299999]のファイル・サイズに1.6が掛けられます。

前述の範囲外のファイルには、SSDomCacheDefaultFileSizeFactor(12.64項「SSDomCacheDefaultFileSizeFactor」を参照)の値が掛けられます。

値

CSV文字列

デフォルト

デフォルト値はありません。

12.66 SSDomCacheLowerBound

このフラグは、レポートされるキャッシュ・サイズの下限の定義に使用されます。

値

数値

デフォルト

6000

12.67 SSDomCacheMultiplier

このフラグは、キャッシュにレポートされる最終的な値を得るために計算されたキャッシュ・サイズに掛ける乗数の設定に使用されます。キャッシュによる計算で、レポートされた値に10が掛けられます。

値

数値

デフォルト

0.1

12.68 SSDomCacheNodeMultiplier

このフラグは、DOMノード当たりカウントするバイト数を指定します。

値

数値

デフォルト

12

12.69 SSDomCacheStringMultiplier

このフラグは、文字列サイズを求めるためにDOMの文字列長に掛けるバイト数を指定します。

値

数値

デフォルト

2

12.70 SSDomCacheStringOverhead

このフラグは、DOMの文字列当たりに追加するバイト数を指定します。

値

数値

デフォルト

24

12.71 SSDomCacheUseDOM

このフラグは、XML DOMの列挙に基づいたキャッシュ・サイズの計算に使用されます。

値

ブール値

デフォルト

no

12.72 SSDomCacheUseFileSize

このフラグは、ファイルのサイズに基づいたキャッシュ・サイズの計算に使用されます。

値

ブール値

デフォルト

yes

12.73 SSEditorDebugLevel

このフラグは、Ephoxエディタのデバッグ・レベルのオーバーライドに使用されます。

使用可能な値は、http、debug、info、warn、errorおよびfatalです。

値

文字列

デフォルト

デフォルト値はありません。

12.74 SSEnableASPSupport

このフラグは、Site Studio 11gR1以上でのASPサポートの有効化に使用されます。11gR1コンポーネント以降、ASPサポートはデフォルトでは無効です。

値

ブール値

デフォルト

no

12.75 SSEnableDirectDelivery

このフラグは、直接配信の制御に使用されます。直接配信によって、変換ルールを使用してネイティブ・ドキュメントをページに表示するかわりに、ダウンロードするネイティブ・ドキュメント・コンテンツ・ファイルにリンクできます。

詳細は、『Oracle WebCenter Content Site Studio Designerユーザーズ・ガイド』を参照してください。

値

ブール値

デフォルト

no

12.76 SSEnableExtranetLookCompatibility

このフラグは、ExtranetLookコンポーネントとの相互運用性の有効化および特定のシングル・サインオン(SSO)システムが使用される際のフレンドリURLの保持に使用されます。

値

ブール値

デフォルト

no

12.77 SSEnableFolioEditing

このフラグは、Site Studioリージョンまたはプレースホルダに割り当てられているフォリオの編集を許可します、

値

ブール値

デフォルト

no

12.78 SSEnableFormEditing

このフラグは、「リージョン」メニューでの「フォーム・エディタ」オプションのインクルードのオーバーライドに使用されます。フラグをyesに設定すると、メニューにフォーム・エディタが含まれます。

値

ブール値

デフォルト

no

12.79 SSEnableJavaScriptCompressor

このフラグは、Oracle Content ServerでのSite Studio管理ページのJavaScript圧縮を有効にします。

値

ブール値

デフォルト

yes

12.80 SSEnableUpperCaseColumnsCheck

このフラグは、xRegionDefinitionがdDocNameと同じ大文字/小文字区別であるようにするために使用されます。

値

ブール値

デフォルト

yes

12.81 SSGenerateUniqueNodeIds

このフラグは、nodeIdがザーバー全体で一意であることの確認に使用されます。ブール値noに設定されている場合、nodeIdは各プロジェクト内でのみ一意です。この後者の処理は、以前のSite Studioの動作に合せたものです。

値

ブール値

デフォルト

yes

12.82 SSHidePrimaryFileInContributor

このフラグは、新規Webアセットの作成時のファイル名フィールドの非表示に使用されます。これによって、不適切な名前に変更されないようにします。

値

ブール値

デフォルト

no

12.83 SSHttpAbsoluteHelpRoot

このフラグは、Site Studio Contributorへのヘルプ・ファイルの場所の指定に使用されます。

値

文字列

デフォルト

<$HttpWebRoot$>help/

12.84 SSHttpLayerManager

このフラグは、HttpLayerManagerのかわりに使用されます。これを使用することは、Ephoxでの実装で有用です。

Ephoxに対する有効な値には、default、sunなどがあります。

値

文字列

デフォルト

デフォルト値はありません。

12.85 SSIdocMarker

このフラグは、Webサイト・オブジェクトにIdocスクリプト・コードが含まれているかどうか、Idoc解析および評価の候補であるかどうかを判別する値の設定に使用されます。

値

文字列

デフォルト

!--$

12.86 SSIgnoreMaxAgeNodeProperties

このフラグは、maxageおよびmaxagesecondaryノード・プロパティのオーバーライドに使用されます。

ライブ・システムでcache-controlヘッダーを生成するこれらのプロパティが必要な場合がありますが、開発環境では動作を無効にすることが推奨されます。12.26項「SSCacheControlOverride」も参照してください。

値

ブール値

デフォルト

no

12.87 SSIgnoreNoProjectDefaultMetadataMessage

このフラグは、デフォルト・プロジェクト・メタデータで発生したエラーのオーバーライドに使用されます。通常の動作では、デフォルト・プロジェクト・メタデータが設定されていない場合、例外がスローされます。このオプションをブール値yesに設定すると、それがオーバーライドされます。

値

ブール値

デフォルト

no

12.88 SSIgnoreReadyToReplicate

このフラグは、「レプリケート準備完了」のセクション・レベルの設定のオーバーライドに使用されます。フラグをyesに設定すると、セクション・レベルの設定に関係なく、すべてのセクションがレプリケートされます。

値

ブール値

デフォルト

no

12.89 SSImportOnlyLatestRevs

このフラグは、アーカイブのインポート時に最新リビジョンのみをインポートする場合に使用されます。デフォルトの動作では、アーカイブのインポート時、すべてインポートします。

値

ブール値

デフォルト

no

12.90 SSIncludeInactiveNodesInNavResultSet

このフラグは、ssNavNodes結果セットに非アクティブなノードを含める場合に使用されます。デフォルトでは、ssNavNodes結果セットに非アクティブなノードは含まれません。

値

ブール値

デフォルト

no

12.91 SSIncludeInactiveNodesInNavXML

このフラグは、ナビゲーションXMLファイルに非アクティブなノードを含める場合に使用されます。デフォルトでは、ナビゲーションXMLに非アクティブなノードは含まれません。

値

ブール値

デフォルト

no

12.92 SSIncludeRegionTemplatesInDefinitionBundles

このフラグは、リージョン・テンプレートが定義バンドルに含まれるかどうかの判別に使用されます。デフォルトの動作では、リージョン・テンプレートは定義バンドルに含まれます。このオプションをfalseに設定すると、除外されます。

値

ブール値

デフォルト

yes

12.93 SSIncludeXmlTransformFormat

このフラグは、変換時のデータ・ファイルの変換先のファイル・タイプの設定に使用されます。変換は、xml、xhtmlまたはhtmlで指定されます。

このフラグを変更すると、結果が大幅に異なることがあります。

値

文字列

デフォルト

HTML

12.94 SSIncludeXmlTransformIndent

このフラグは、インデントを含めるようXMLファイルをフォーマットするために使用されます。これによって、1行ではなく、インデントされた形式でXMLコードを出力できます。

値

ブール値

デフォルト

no

12.95 SSJavaExecutablePath

このフラグは、JavaScriptコンプレッサ実装に使用されるJava実行可能ファイルのオーバーライドに使用されます。このフラグは、デフォルト(java.home環境変数)を使用できない場合に使用されます。

フラグを使用する場合、このフラグのデフォルト変数が変更されます。

値

文字列

デフォルト

java.home環境変数

12.96 SSJSONContentType

このフラグは、JSONコンテンツ・タイプのオーバーライドに使用されます。

値

文字列

デフォルト

application/jsonrequest

12.97 SSLoadCustomElementsWithOnDemandEditors

このフラグによって、すべての標準要素がオンデマンドでロードされる際、カスタム要素を完全にロードできます。カスタム要素では独自のUIが提供されるため、オンデマンドでロードされる場合、プレビューはありません。一般に、カスタム要素のロードは標準要素のロードより速いため、完全ロードの許可によって、コントリビュータ・フォームのロード時間のパフォーマンスに大きく影響することはありません。

値

ブール値

デフォルト

yes

12.98 SSLoadProjectsAtStartup

このフラグは、起動時のプロジェクトのロードのオーバーライドに使用されます。システムに多数のプロジェクトがある場合、これによってOracle Content ServerサービスをWindowsのサービスとして起動しないようにできます。

値

ブール値

デフォルト

yes

12.99 SSLoadUncompressedFckSource

このフラグは、圧縮されていないFCKエディタ・ソース・コードのロードに使用されます。これは、FCKエディタのデバッグを支援します。

値

ブール値

デフォルト

no

12.100 SSManuallyValidateNodeIdUniqueness

このフラグは、一意のnodeIdの検証でのXMLパーサーの使用のオーバーライドに使用されます。一部の実装では、XMLパーサーを使用すると大規模プロジェクトの検証に時間がかかるため、デフォルト値では、使用されません。

値

ブール値

デフォルト

yes

12.101 SSMaxNodeIdLength

このフラグは、最大ノードID値長のオーバーライドに使用されます。

値

整数

デフォルト

30

12.102 SSMaxSiteIdLength

このフラグは、最大サイトID値長のオーバーライドに使用されます。

値

整数

デフォルト

30

12.103 SSMaxSitesMenuItems

このフラグは、Webサイト・メニューに表示可能なWebサイトの最大数の設定に使用されます。

値

整数

デフォルト

デフォルト値はありません。

12.104 SSMaxTemplateEvaluationStack

このフラグは、プレースホルダのネストの最大数のオーバーライドに使用されます。

値

整数

デフォルト

200

12.105 SSMigrationCollectionName

このフラグは、バックアップ・アーカイブに使用されるコレクションの名前の設定に使用されます。

値

文字列

デフォルト

コンテンツ・サーバーのインスタンス名の値。

12.106 SSOmitFragmentLibrariesInArchiverQueries

このフラグは、バックアップ・アーカイブでのフラグメント・ライブラリの省略に使用されます。デフォルトの設定ではこれを含めます。

値

ブール値

デフォルト

no

12.107 SSOnDemandEditorsThresholdCount

このフラグは、要素がコントリビュータでオンデマンドでロードされるためにコントリビューションに存在する必要のある要素の数の設定に使用されます。

値

整数

デフォルト

6

12.108 SSPrefillUrlDirNamesDuringUpgrade

このフラグは、バージョン7.5より前のSite Studio WebサイトでのURLディレクトリ名セクション・プロパティの値の生成と移入に使用されます。

値

ブール値

デフォルト

yes

12.109 SSProjectAutoCheckinInterval

このフラグは、プロジェクト・ファイルが自動的にチェックインされる間隔(秒)の設定に使用されます。

値

整数

デフォルト

600

12.110 SSProjectLoadFailureTracingSection

このフラグは、プロジェクトのロード・エラーが発生した際に診断のダンプに使用されるトレース・セクションの名前の指定に使用されます。デフォルトでは、これらの例外は常にダンプされます。このフラグは、指定されたトレース・セクションを有効にし、選択的にダンプする場合に使用されます。

値

文字列

デフォルト

デフォルト値はありません。

12.111 SSProjectReleaseSleepTime

このフラグは、プロジェクト・リリースの待機時にスリープする時間(秒)の設定に使用されます。12.112項「SSProjectReleaseWaitTime」も参照してください。

値

整数

デフォルト

3

12.112 SSProjectReleaseWaitTime

このフラグは、アーカイブ操作時、新たにコミットされたプロジェクト・ファイルがリリース済になるまで待機する時間(秒)の設定に使用されます。12.111項「SSProjectReleaseSleepTime」も参照してください。

値

整数

デフォルト

30

12.113 SSQuickDiffDefaultRegionTemplate

このフラグは、クイックDiffのリージョン・テンプレートとして使用されるテンプレートの設定に使用されます。

値

文字列

デフォルト

SS_DEFAULT_REGION_TEMPLATE

12.114 SSShowAssignmentTooltips

このフラグは、コントリビュータ・モードでの割当てツールチップの有効化または無効化に使用されます。yesに設定されている場合、リージョン・マーカーにマウスオーバーすると、ツールチップが表示されます。

値

ブール値

デフォルト

no

12.115 SSSQLUseContains

このフラグは、SQL検索での問合せの制御に使用されます。SQL CONTAINS演算子がxWebsitesまたはxDontShowInListsForWebsites列で使用できない場合。

このフラグをnoに設定するとLIKE問合せが使用されます。yesに設定すると、CONTAINS問合せが使用されます。

また、Site Id値に"_"文字が含まれている場合、Site Studioで使用される問合せに問題が発生することがあります。これらの問題は、索引付けの際に"_"が単語の区切り文字として使用され、問合せの際にワイルドカードとして使用されるために起こります。

これらの問題を回避するために、CONTAINS問合せを使用せずに、4つの部分から成るLIKE問合せを使用するようSite Studioに指定することができます。

値

ブール値

デフォルト

no

12.116 SSStoppedSiteResponsePageDocName

このフラグは、停止されているWebサイトにアクセスした場合に返されるページを定義するコンテンツ・アイテムのdDocNameの設定に使用されます。

値

文字列

デフォルト

デフォルト値はありません。

12.117 SSSuppressAddToWebsite

このフラグは、リンクされているイメージが現在のWebサイトの一部としてマークされないようにするために使用されます。イメージにリンクする際、Site Studioは通常イメージを現在のWebサイトの一部としてマークします。これには、イメージに対する書込み権限が必要です。このフラグを使用すると、イメージをマークしません。

これが使用されている場合、このイメージはサイト・アーカイブで選択されないことに注意してください。

値

ブール値

デフォルト

no

12.118 SSSuppressLargeCssOptimization

このフラグは、CSS最適化計算の有効化または無効化に使用されます。最適化計算は、コントリビュータ・フォームのロードが速くなるようコントリビュータ・フォームのレンダリング時ではなく、コントリビュータ・モードで行われます。

このフラグがyesに設定されている場合、計算が使用されます。

値

ブール値

デフォルト

no

12.119 SSTempProjectLifetime

このフラグは、一時プロジェクト・ファイルがコンテンツ・サーバーにチェックインされた後残される時間(秒)のオーバーライドに使用されます。

これを変更する場合、特に注意が必要です。

値

整数

デフォルト

120

12.120 SSTitleTagFieldName

このフラグは、タイトル・タグに使用されるメタデータ・フィールドの設定に使用されます。

値

文字列

デフォルト

dDocTitle

12.121 SSTrackContentAccess

このフラグは、コントリビュータを介して挿入されるイメージのタイトル・タグに使用されるメタデータ・フィールドの名前の指定に使用されます。

値

ブール値

デフォルト

yes

12.122 SSTrackFragmentAccess

このフラグは、トラッカを使用したフラグメントの追跡を有効化するオーバーライドとして使用されます。

値

ブール値

デフォルト

no

12.123 SSUrlFieldName

このフラグは、URL内のページ識別子の生成時にdDocNameのかわりに使用されるメタデータ・フィールド名を指定するオーバーライドとして使用されます。先頭にxの付かない名前(xFooではなく、Foo)を指定します。

値

文字列

デフォルト

デフォルト値はありません。

12.124 SSUrlFixupExceptions

このフラグは、リンクを修正プロセスから除外するかどうか判別するためにリンク修正時にリンクに対して比較される文字列値のリストを定義します。リンクは小文字で比較されることに注意してください。つまり、確認対象のリンクはまず小文字にされるため、指定される例外値はすべて小文字にします。

次の例では、いずれもリンクhttp://download.oracle.com/groups/public/documents/database.docxが修正プロセスから除外されます。

SSUrlFixupException=download.oracle.com
SSUrlFixupException=/groups/public
SSUrlFixupException=/documents/
SSUrlFixupException=database.docx

値

文字列。値はパイプ(|)で区切ります。

デフォルト

デフォルト値はありません。

12.125 SSUrlPageNames

このフラグは、プライマリ・ページの配信に使用可能な他のURLページ名の指定に使用されます。これは、以前のデフォルトURLページ名を使用したパスベースのリンクに既存のデータ・ファイルがある場合に有用です。

デフォルトURLページ名は、各セクション・プロパティで指定されたものです。指定されていない場合、index.htmです。関連するタグSSDefaultUrlPageName(12.53項「SSDefaultUrlPageName」を参照)で、index.htmではないデフォルト・ファイルを指定できます。

値

CSV文字列

デフォルト

デフォルト値はありません。

12.126 SSUseAbsoluteRedirects

このフラグは、以前のバージョンのSite Studioのリダイレクトの動作に戻す場合のオーバーライドに使用されます。現在のデフォルトおよび推奨では、相対URLにリダイレクトされます。このフラグがブール値yesに設定されている場合、すべてのリダイレクトで絶対URLが使用されます。

値

ブール値

デフォルト

no

12.127 SSUseCallbackTrackingForASP

このフラグは、ASPでトラッカに対するコンテンツ・アクセスのレポートのコールバック・タイプを使用するかどうかの判別に使用されます。デフォルトでは、コンテンツ・アクセスの追跡を有効にします。より正確である可能性はあるが、より遅いコールバック・タイプを有効にするには、このフラグを有効にします。

値

ブール値

デフォルト

no

12.128 SSUseDefaultDocNamePrefix

このフラグは、SSDefaultExternalDocNamePrefix構成エントリが指定されていない場合にそのデフォルト値の決定に使用されます。

値

ブール値

デフォルト

yes

12.129 SSUseDefaultServerRelativeSiteRoot

このフラグは、SSDefaultServerRelativeSiteRoot構成エントリが指定されていない場合にそのデフォルト値の決定に使用されます。

値

ブール値

デフォルト

yes

12.130 SSUseDefaultUrlPrefix

このフラグは、SSDefaultUrlPrefix構成エントリが指定されていない場合にそのデフォルト値の決定に使用されます。

値

ブール値

デフォルト

yes

12.131 SSUseMissingLinkTargetFallback

このフラグは、computeUrl関数にターゲットがない場合のトークン化されたリンクの生成に使用されます。ターゲットdDocNameまたはターゲットnodeIdが存在しない場合、代替URLは生成されません。フラグのデフォルト・アクションでは、トークン化されたリンクが算出され、スクリプト拡張機能エラーを回避します。

値

ブール値

デフォルト

yes

12.132 SSUseOnDemandContributionModeMenus

このフラグは、コントリビュータのメニューの作成を制御します。ページに複数のプレースホルダがある場合、プレースホルダ・マーカーごとにポップアップ・メニューを作成するには、多数のDOM操作が必要です。Internet Explorerを使用する場合、このプロセスに時間がかかり、CPUが100%に上昇する可能性があります。このフラグがyesに設定されている場合、メニューの作成は、ユーザーが実際にアイコンをクリックするまで遅延されます。

値

ブール値

デフォルト

yes

12.133 SSUseUrlSegmentSessionInfo

このフラグは、追加のパス・セグメントを含めることで、URLでモードを判別できるようにします。(contributor/design/preview<previewId>など)

値

ブール値

デフォルト

no

12.134 SSValidateCustomElements

このフラグは、カスタム要素がカスタム要素フォームの互換性を検証するかどうかの判別に使用されます。この機能は、レガシー・カスタム要素フォームのアップグレードをユーザーに通知するためのものでした。パフォーマンス上の理由から、このフラグはfalseに設定してください。

値

ブール値

デフォルト

no

12.135 SSWebFilterIgnoreList

このフラグは、Webサーバー・フィルタ・プラグインで無視するフォルダの指定に使用されます。これによって、ドメインベースのサイトでOracle Content Serverの外部のリソースに対応できます。

値

文字列

デフォルト

デフォルト値はありません。

12.136 SSWeblayoutUrlUsesDocNames

このフラグは、ssWeblayoutUrlおよび対応するwcmUrl('resource' ...)リンクでweblayoutパスのかわりにdDocNamesを使用する場合に使用されます。

値

ブール値

デフォルト

yes

12.137 SSWelcomeFile

このフラグは、ようこそファイル(WLSによって自動的に生成されるURL接尾辞)の指定に使用されます。これは通常portal.htmで、どのSite StudioのURLにも一致しません。

値

文字列

デフォルト

/portal.htm

12.138 SSWelcomeFileReplacement

このフラグは、プロジェクト階層に対して受信URLを一致する際に使用する、ようこそファイルのかわりの指定に使用されます。

値

文字列

デフォルト

/

13 Site Studioパフォーマンス・チューニング

この項の内容は次のとおりです。

- 13.1項「Site Studioのパフォーマンスについて」

- 13.2項「オンデマンドWebサイト管理」

- 13.3項「オンデマンド・コントリビュータ・エディタ」

- 13.4項「コントリビュータ・コードの最適化」

- 13.5項「メモリー使用量」

13.1 Site Studioのパフォーマンスについて

Site Studio Webサイトは、様々なページ内の様々な形式のコンテンツの迅速な配信を可能にする動的Webサイトです。しかし、パフォーマンスをさらに向上させるためにカスタマイズ可能な点がSite Studioにあります。

13.2 オンデマンドWebサイト管理

作成および保守するWebサイトには、あまり使用されないものがある場合があります。このような場合、実際にリクエストされるまでサーバーでこれらのサイトをメモリーにロードしないようにすると、メモリー管理によるサーバー・パフォーマンスの向上を簡単に行えます。

リクエストされた場合にのみロードするサイトは、サーバーの起動時にロードするサイトとリクエストに応じてロードするサイトを選択できるオンデマンド管理を使用して管理者がそのようにマークできます。

サイトがリクエストされた場合、他のサイトと同様にメモリーにとどまります。

オンデマンドWebサイトの詳細は、『Oracle WebCenter Content Site Studio管理者およびマネージャーズ・ガイド』を参照してください。

13.3 オンデマンド・コントリビュータ・エディタ

コントリビューション・リージョンの要素が多い場合、コントリビュータによるロードに時間がかかる場合があります。これは想定されていることです。Site Studioには、オンデマンド・エディタを使用することでコントリビュータのロードを速くするために設定可能な構成フラグがあります。

この項の内容は次のとおりです。

- 13.3.1項「構成フラグについて」

- 13.3.2項「オンデマンド・エディタに使用される構成フラグ」

13.3.1 構成フラグについて

Site Studioでは、様々なアクション用に多数の構成フラグが使用されます。フラグが多いため、最も一般的なインスタンスで使用されるものについてのみ説明します。

13.3.2 オンデマンド・エディタに使用される構成フラグ

コントリビュータは、ページに表示されるかどうかに関係なく、コントリビューション・リージョン内の各要素についてエディタをロードします。要素が多い場合、これによってコントリビュータのロード時間と待機時間が長くなることがあります。

コントリビュータでオンデマンド・エディタの使用を可能にするために変更できるフラグがあります。オンデマンド・エディタでは、要素に含まれているデータのプレビューが表示されますが、リクエストされるまでエディタはロードされません。

13.3.2.1 SSOnDemandEditorsThresholdCount

この構成フラグは、特定数の要素がロードされる場合にのみコントリビュータでオンデマンド・エディタを有効にする場合に使用されます。このフラグを特定の数値(n)に設定すると、コントリビューション・リージョンにn+1の要素がある場合、要素はオンデマンド要素になります。

値

整数

デフォルト

5

13.4 コントリビュータ・コードの最適化

コントリビュータには、JavaScriptとCSSに基づいたコードの部分が多くあります。このコードは最適化できます。

最適化されたコントリビュータ・ソース・コードは、圧縮および統合されたJavaScriptおよびCSSコードです。最適化されたソース・コードによって、コントリビュータ・アプリケーションのロード時間とブラウザでの実行速度が向上します。デフォルトでは、Site Studioはデバッグおよび構成で最適化されていないソース・コードを使用するよう最初は構成されています。

この章の内容は次のとおりです。

- 13.4.1項「最適化の要件」

- 13.4.2項「ビルド・プロセス」

- 13.4.3項「最適化されたコードのビルド」

- 13.4.4項「ビルド・スクリプトのデバッグ」

- 13.4.5項「最適化されたコードを使用するためのSite Studioの構成」

- 13.4.6項「カスタマイズとビルド・プロセス」

13.4.1 最適化の要件

ビルド・プロセスには、1.5以上の仕様を実装するJava用のJDKが必要です。

ビルド・システムは、デフォルトでは、toolsディレクトリがコントリビューション・アプリケーションのルート・ディレクトリ内にある場合にのみ適切に機能します。ほとんどの場合、toolsディレクトリは次の場所にあります。

CONTENT_SERVER_INSTALL_DIR\weblayout\resources\wcm\tools

注意:
コンピュータが、1.5より前のバージョンのデフォルトJava Runtime Environmentを使用するよう構成されている場合、適合するランタイム環境を参照するようbuild.jsスクリプトのWCM.Compress関数の圧縮モジュールの呼出しを変更する必要があります。特に、runCommand関数の最初のパラメータを、javaから1.5以上のjava実行可能ファイルへの完全パス参照に変更する必要があります。

13.4.2 ビルド・プロセス

最適化されたコントリビュータ・ソース・コードをビルドするロジックはすべて、JavaScriptで記述されたbuild.jsにあります。ビルド・プロセスではRhino (JavaScriptインタープリタ)を使用してビルド・スクリプトを実行し、最適化されたコントリビュータ・ソース・コードを作成します。build.jsスクリプト・ファイルは次のディレクトリにあります。

\tools\optimize\build.js

ビルド・プロセスでは、まず最適化されていないコードの複製コピーを作成します。デフォルトでは、宛先ディレクトリはwcm_minという名前で、次の場所のコントリビュータ・アプリケーションのルート・ディレクトリ外にあります。

CONTENT_SERVER_INSTALL_DIR\weblayout\resources\wcm_min

その後、ビルド・プロセスは、すべてのJavaScriptおよびCSSファイルを圧縮し、各HTMLファイルをスキャンして、最終的にHTMLファイルで参照されているすべてのJavaScriptおよびCSSファイルを連結することで、新たにコピーされたコードを最適化されたソース・コードにします。ビルド・プロセスでは実行時にHTMLファイルを読み取り、HTMLファイル内の既知のコメント構文内にあるすべてのJavaScriptおよびCSSファイルを列挙します。

たとえば、次のようなコメント構文内のJavaScript参照があるとします。

<!-- BEGIN:SCRIPT -->
<script type="text/javascript" src="../wcm.js"></script>
<script type="text/javascript" src="../base/wcm.dhtml.js"></script>
<script type="text/javascript" src="../base/wcm.get.js"></script>
<script type="text/javascript" src="../base/wcm.http.js"></script>
<script type="text/javascript" src="../base/wcm.popup.js"></script>
<script type="text/javascript" src="../base/wcm.compare.js"></script>
<script type="text/javascript" src="../base/wcm.diff.js"></script>
<script type="text/javascript" src="../sitestudio/wcm.idc.js"></script>
<script type="text/javascript" src="../sitestudio/wcm.contentserver.popup.js"></script>
<script type="text/javascript" src="../sitestudio/wcm.helpfiles.js"></script>
<script type="text/javascript" src="../sitestudio/wcm.help.js"></script>
<script type="text/javascript" src="../form/wcm.form.js"></script>
<script type="text/javascript" src="wcm.sitestudio.form.js"></script>
<script type="text/javascript" src="../custom/sitestudio/wcm.sitestudio.form.js"></script>
<!-- END:SCRIPT -->

これが圧縮、連結されて次のように参照されます。

<!-- BEGIN:SCRIPT -->
<script type="text/javascript" src="../wcm.sitestudio.form.composite.js"></script>
<!-- END:SCRIPT -->

同様に、次のコメント構文内に次のCSS参照があるとします。

<!-- BEGIN:CSS -->
<link href="../base/wcm.base.css" rel="stylesheet" type="text/css" />
<link href="wcm.sitestudio.form.css" rel="stylesheet" type="text/css" />
<link href="../custom/sitestudio/wcm.sitestudio.form.css" rel="stylesheet" type="text/css" />
<!-- END:CSS -->

これが圧縮、連結されて次のように参照されます。

<!-- BEGIN:CSS -->
<link href="wcm.sitestudio.form.composite.css" rel="stylesheet" type="text/css" />
<!-- END:CSS -->

13.4.3 最適化されたコードのビルド

Windowsでビルド・プロセスを実行するには、次の場所にあるshell-buildショートカットをダブルクリックします。

\tools\optimize\shell-build

Site Studioでサポートされる他のプラットフォーム(Windowsを含む)でビルド・プロセスを実行するには、次のコマンドラインを使用します。

java.exe -cp ..\rhino\rhino1_7R2\js.jar org.mozilla.javascript.tools.shell.Main build.js

コマンドラインからビルド・プロセスを実行する場合、実行の作業ディレクトリがビルド・スクリプトのディレクトリであることを確認することが重要です。たとえば、シェルからビルドを実行する場合、コマンドラインを実行する前にビルド・スクリプトのディレクトリ(\tools\optimize)にディレクトリを変更するようにします。

プロセスは、「Site Studioの管理」の「フラグメント・ライブラリの管理」ページからも実行できます。「コントリビュータJavaScriptの圧縮」をクリックしてプロセスを起動します。

13.4.4 ビルド・スクリプトのデバッグ

Windowsでビジュアル・デバッガを実行するには、次の場所にあるshell-debugショートカットをダブルクリックします。

\tools\optimize\shell-debug

サポートされる他のプラットフォーム(Windowsを含む)でビジュアル・デバッガを実行するには、次のコマンドラインを使用します。

java.exe -cp ..\rhino\rhino1_7R2\js.jar org.mozilla.javascript.tools.debugger.Main build.js

コマンドラインからビジュアル・デバッガを実行する場合、デバッガの実行の作業ディレクトリがビルド・スクリプトのディレクトリであることを確認することが重要です。たとえば、シェルからデバッガを実行する場合、コマンドラインを実行する前にビルド・スクリプトのディレクトリ(\tools\optimize)にディレクトリを変更するようにします。

13.4.5 最適化されたコードを使用するためのSite Studioの構成

最適化されたコントリビュータ・ソース・コードが作成されたら、SSContributorSourceDir値を変更して、最適化されたソース・コードを使用するようSite Studioを構成できます。この値は、次の構成ファイルで設定できます。

CONTENT_SERVER_INSTALL_DIR\custom\SiteStudio\SiteStudio.cfg

sitestudio.cfg内でSSContributorSourceDirを値wcm_minに設定します。

SSContributorSourceDir=wcm_min

13.4.6 カスタマイズとビルド・プロセス

コントリビュータ・ソース・コードへのカスタマイズは、JavaScriptおよびCSSファイル参照が特別なコメント構文内にある場合、ビルド・プロセスによって自動的に選択されます。また、新たに追加されたHTMファイルでJavaScriptおよびCSSファイル参照の箇所に特別なコメント構文が含まれている場合、ビルド・プロセスはそれらのファイルに対して最適化を実行します。

ビルド・スクリプトをユーザーのカスタマイズのニーズに合せて変更することもできます。たとえば、出力ディレクトリ名または場所を変更できます。また、コピー、圧縮または連結されるファイルを決定するための正規表現フィルタもあります。これらのフィルタは、カスタマイズに合うよう必要に応じて更新できます。

13.5 メモリー使用量

キャッシュされたデータのメモリーの使用によって、Site Studioのレスポンス性が影響を受けます。これを制御する方法の1つは、Site Studioプログラム自体で行われており、様々な変更を組み入れることでSite Studio構造のメモリー要件が低減されています。

これらの変更には、Xerces遅延DOMロードの無効化やプロジェクト・ファイルDOMからの意味のない空白テキスト・ノードの削除などがあります。

メモリー使用量は、フラグの使用でも制御できます。この項の内容は次のとおりです。

13.5.1 XML DOMのメモリー・サイズ用のフラグ

Xercesパーサーの遅延ノード展開機能は、小規模なDOCでは非常に非効率的な機能と言われています。ただし、これはフラグによって制御できます。

- SSDisableDeferredNodeExpansion: 遅延ノード展開を有効または無効にします。デフォルトは、trueです。

13.5.2 DOC_INFOキャッシュ内のアイテムのサイズ用のフラグ

DOC_INFOキャッシュ内のアイテムのサイズを計算するアルゴリズムは、2つの方法で調整できます。1つ目の方法は、ファイル・サイズに対する乗数を使用する方法です。2つ目は、DOMの列挙です。次の構成フラグを使用できます。

- SSComputeDocInfoCacheSize: ResultSetのサイズを計算するかどうかを示すブール値。ResultSetのサイズを計算しない場合、SSDocInfoCacheLowerBound値が使用されます。デフォルトは、falseです。

- SSDocInfoCacheLowerBound: これは、キャッシュにレポートされるResultSetのサイズの下限を設定します。デフォルトは、2000です。

- SSDocInfoCacheMultiplier: キャッシュにレポートされる最終的な値を得るために計算されたキャッシュ・サイズに掛ける乗数。キャッシュ自体の計算で、レポートされた値に10が掛けられます。デフォルトは、0.1です。

- SSDocInfoCacheStringMultiplier: メモリーでの最終的な文字列サイズを得るための文字列長に対する乗数。デフォルトは、2です。

- SSDocInfoCacheStringOverhead: 文字列当たりに追加するバイト数。デフォルトは、24です。

- SSDocInfoCacheColumnOverhead: 結果セットで1列当たりに追加するバイト数。デフォルトは、40です。

- SSDocInfoCacheRowOverhead: 結果セットで1行当たりに追加するバイト数。デフォルトは、24です。

- SSDocInfoCacheCellOverhead: 結果セットで1セル当たりに追加するバイト数。デフォルトは、12です。

注意:
これらのフラグはSite Studio 10gR4で使用されていますが、Site Studio 11gR1では使用されていません。

13.5.3 SSXPathCacheEntryキャッシュを制御するためのフラグ

SSXPathCacheEntryがResourceCacheで消費する領域のサイズを計算するアルゴリズムは、2つの方法で調整できます。1つ目の方法は、ファイル・サイズに対する乗数を使用する方法です。2つ目は、DOMの列挙です。次の構成フラグを使用できます。

- SSDomCacheUseFileSize: ファイルのサイズに基づいたキャッシュ・サイズの計算に使用します。デフォルトは、trueです。

- SSDomCacheUseDOM: XML DOMの列挙に基づいたキャッシュ・サイズの計算に使用します。デフォルト値は、falseです。

- SSDomCacheLowerBound: レポートされるキャッシュ・サイズの下限を設定します。デフォルトは、6000です。

- SSDomCacheMultiplier: 最終的な値を得るために、指定された値を計算されたキャッシュ・サイズに掛けます。現在実際的なキャッシュのサイズを計算するために合計値に10を掛けることを推奨しているため、デフォルトは0.1です。

- SSDomCacheNodeMultiplier: DOMノード当たりカウントするバイト数。デフォルトは、12です。

- SSDomCacheStringMultiplier: 文字列サイズを求めるためにDOMの文字列長に掛けるバイト数。デフォルトは、2です。

- SSDomCacheStringOverhead: DOMで文字列当たりに追加するバイト数。デフォルトは、24です。

- SSDomCacheDefaultFileSizeFactor: キャッシュ・サイズを得るためにファイル・サイズに掛ける値のデフォルト値。デフォルトは、2.0です。

- SSDomCacheFileSizeFactors: キャッシュ・サイズの計算を制御するファイル・サイズと乗数のカンマ区切りのリスト。
たとえば、次の文字列があるとします。

1000,6.0,10000,2.7,50000,2.1,100000,1.9,300000,1.6

[0...999]のファイル・サイズに6.0が掛けられます。

[1000...9999]のファイル・サイズに2.7が掛けられます。

[10000...49999]のファイル・サイズに2.1が掛けられます。

[50000...99999]のファイル・サイズに1.9が掛けられます。

[100000...299999]のファイル・サイズに1.6が掛けられます。

(前述の範囲外のファイルには、SSDomCacheDefaultFileSizeFactorの値が掛けられます。)

14 JSONとコントリビュータ

この項の内容は次のとおりです。

- 14.1項「JSONについて」

- 14.2項「コントリビュータとの間の構成の受渡し」

14.1 JSONについて

JSONはJavaScript Object Notationの頭字語で、軽量なデータ交換に使用される言語です。これにより、マシンにとって解析と生成が簡単になりますが、人間にとっても読み書きが簡単です。JSONは言語に依存しませんが、CおよびCファミリの他のプログラミング言語(C++、Java、Python、Perlなど)に基づいた規約が使用されます。

JSONは、コントリビュータとの間のデータの受渡しを保守する簡単な方法としてSite Studioで使用されます。

14.2 コントリビュータとの間の構成の受渡し

コントリビュータが開かれると、JSON構成オブジェクトは、リセット、更新およびプレビュー用のフラグを渡します。

JSONはデータ転送形式ですが、LocalData、ResultSets、ResultSet、フィールドおよび行のデータ・バインダの概念は依然として存在します。また、一部の構成情報は、データ・バインダの概念なしでコントリビュータに渡されます。

コンソールに、コントリビュータとコンテンツ・サーバーとの間のアクティビティがすべて表示されます。次の例は、JSONで渡されたコンテンツ・アイテムをチェックアウトするリクエストです。

2009/7/18-15:13:34:0737 - REQUEST  - [index.htm] HTTP Request (http_05201522250333165144):
"url": http://myvmware/stellent/idcplg,
"contentType": application/json,
"postdata": {
"LocalData" : {
"IdcService" : "SS_CHECKOUT_BY_NAME",
"dDocName" : "loafer_frontpage"
},
"ResultSets" : {
}
}

2009/7/18-15:13:34:0815 - RESPONSE - [index.htm] HTTP Response (http_05201522250333165144):
"status": 0,
"message": Succeeded,
"status text": OK,
"response text": {
"LocalData": {
"wfAction": "CHECKOUT",
"dReleaseState": "Y",
"isFinished": "0",
"dDocAccount": "",
"refreshSubjects": "",
"IsWorkflow": "",
"CurRevID": "615",
"dActionDate": "8/18/09 4:14 PM",
"refreshMonikers": "",
"dRevClassID": "71",
"dCheckoutUser": "sysadmin",
"IdcService": "SS_CHECKOUT_BY_NAME",
"changedSubjects": "documents,1250624531742",
"RedirectParams": "IdcService=CHECKOUT_OK&dID=\u003c$dID$\u003e&CurRevCheckoutUser=\u003c$url(CurRevCheckoutUser)$\u003e&CurRevID=\u003c$CurRevID$\u003e\u003c$if IsWorkflowInfo$\u003e&IsWorkflowInfo=\u003c$IsWorkflowInfo$\u003e\u003c$endif$\u003e\u003c$if ClientControlled$\u003e&ClientControlled=\u003c$ClientControlled$\u003e\u003c$endif$\u003e\u003c$if inQueueRedirect$\u003e&inQueueRedirect=1\u003c$endif$\u003e",
"changedMonikers": "",
"dSecurityGroup": "Public",
"IsNotLatestRev": "",
"dActionMillis": "36900553",
"dStatus": "RELEASED",
"dRevLabel": "9",
"dAction": "Check out",
"dID": "615",
"dWorkflowState": "",
"dPublishState": "",
"dIsCheckedOut": "1",
"dClbraName": "",
"prevReleaseState": "",
"refreshSubMonikers": "",
"isCurRevEmpty": "",
"latestID": "615",
"CurRevIsCheckedOut": "0",
"dUser": "sysadmin",
"XmlEncodingMode": "Full",
"CurRevCheckoutUser": "sysadmin",
"dDocName": "loafer_frontpage"
},
"ResultSets": {
}
}

コンソールの詳細は、第15章「コントリビュータ・コンソール・ウィンドウ 」を参照してください。

15 コントリビュータ・コンソール・ウィンドウ

この項の内容は次のとおりです。

- 15.1項「コントリビュータ・コンソール・ウィンドウについて」

- 15.2項「コントリビュータ・コンソール・ウィンドウのインストール」

- 15.3項「コントリビュータ・コンソール・ウィンドウの起動」

- 15.4項「コントリビュータ・コンソール・ウィンドウの使用」

- 15.5項「ロギング構文」

- 15.6項「時間プロファイリング」

- 15.7項「コマンド・ウィンドウ・ヘルパー関数」

- 15.8項「キーボード・コマンド」

15.1 コントリビュータ・コンソール・ウィンドウについて

コントリビュータ・コンソール・ウィンドウは、コントリビュータ・アプリケーションのクロスブラウザおよびクロスプラットフォーム・ロギング・メカニズムです。コントリビュータ・コンソール・ウィンドウは、ロギングの格納および複数のHTMLウィンドウにおよぶJavaScriptコードの実行を1つのブラウザ・ウィンドウ内から簡単に行えるようにすることに特に適しています。

コントリビュータ・コンソール・ウィンドウのロギング・ウィンドウ(コントリビュータ・コンソール・ウィンドウの上部)に記録された命令にはすべて、実行の時間および命令が実行されたコンテキストが表示されます。ウィンドウの下部(コマンド・ウィンドウ)は、JavaScriptの実行に使用されます。

注意:
ロギングを格納し、複数コンテキストにおよぶJavaScriptコードの実行を容易にするには、コントリビュータ・コンソール・ウィンドウは、ルート・ブラウザ・ウィンドウである必要があります。詳細は、15.4項「コントリビュータ・コンソール・ウィンドウの使用」を参照してください。

この項の内容は次のとおりです。

- 15.1.1項「ロギング・ウィンドウ」

- 15.1.2項「コマンド・ウィンドウ」

- 15.1.3項「コントリビュータ・コンソール・ウィンドウ・ユーザー・インタフェース」

15.1.1 ロギング・ウィンドウ

コントリビュータ・コンソール・ウィンドウの上部はロギング・ウィンドウです。記録された各命令には、実行の時間および命令のコンテキストが表示されます。ロギング・ウィンドウのツールバーから、ロギング・ウィンドウをクリアしたり、別のロギング・タイプを選択して、記録されているアイテムのリストをフィルタ処理できます。

15.1.2 コマンド・ウィンドウ

コントリビュータ・コンソール・ウィンドウの下部はコマンド・ウィンドウです。コマンド・ウィンドウでは、任意のJavaScriptコードを実行できます。コマンド・ウィンドウのコンテキスト・フィールドでコンテキストIDを指定することで、コードをコントリビュータ・アプリケーションの任意のコンテキスト内で実行できます。使用可能なコンテキストのリストは、次のコード・スニペットをコマンド・ウィンドウで実行すると表示できます。

$D().contexts();

コンテキストのファイル名またはコンテキストのIDをコマンド・ウィンドウのコンテキスト・フィールドに使用できます。コマンド・ウィンドウのツールバー・コンテキスト・フィールドを適切に設定すると、コマンド・ウィンドウで実行されるすべてのコードが、指定されたウィンドウ・オブジェクトのコンテキスト内で実行されます。

15.1.3 コントリビュータ・コンソール・ウィンドウ・ユーザー・インタフェース

コントリビュータ・コンソール・ウィンドウのインタフェースは非常に単純です。

図15-1 コントリビュータ・コンソール・ウィンドウ

「図15-1 コントリビュータ・コンソール・ウィンドウ」の説明

要素

説明

フィルタ

表示するメッセージ・タイプを選択します。

クリア

ロギング・ウィンドウをクリアします。

閉じる

「カスタマイズ」ダイアログを閉じます。

実行

コマンド・ウィンドウに入力されたコードを実行します。

クリア

コマンド・ウィンドウをクリアします。

「コンテキスト」フィールド

実行するコンテキスト(ファイル名またはID)を入力します。

コマンド

実行するコマンドまたはスクリプトを入力します。

15.2 コントリビュータ・コンソール・ウィンドウのインストール

コントリビュータ・コンソール・ウィンドウが使用できるかどうかはオプションで、デフォルトではデプロイされません。コントリビュータ・コンソール・ウィンドウをデプロイするには、Site Studio管理者の「一般コンポーネント情報」ウィンドウから行います。「コントリビュータ・コンソールの有効化」行の「有効化」リンクをクリックします。

管理者の同じ場所からコンソールを無効にすることもできます。

詳細は、『Oracle WebCenter Content Site Studio管理者およびマネージャーズ・ガイド』を参照してください。

15.3 コントリビュータ・コンソール・ウィンドウの起動

コントリビュータ・コンソール・ウィンドウを有効にしたら、これを起動する方法は2つあります。コントリビュータ・コンソールURLに移動するか、キー・コマンドを使用します。

コントリビュータ・コンソール・ウィンドウのURLへの移動

URLがわかっている場合、ユーザーはコントリビュータ・コンソール・ウィンドウに直接移動できます。Site Studioインストールでコントリビュータ・コンソール・ウィンドウは通常次のURLにあります。

http://server_name/instance_name/resources/wcm/base/wcm.console.htm

キー・コマンドの使用

キー・コマンド[Ctrl]+[Alt]+[Shift]+[C]または[Ctrl]+[Alt]+[Shift]+[E]で、コントリビュータ内からコントリビュータ・コンソール・ウィンドウを起動します。後者のキー・コマンドは、コントリビュータ・コンソール・ウィンドウがまだ開いていない場合にこれを開く以外に、すべてのランタイム・エラーを表示します。

注意:
コントリビュータ・コンソール・ウィンドウがweblayoutにインストールされていない場合、ランタイム・エラーがあると、[Ctrl]+[Alt]+[Shift]+[E]で一般エラー・ダイアログが開きます。エラー・ダイアログには、ランタイム・エラーのみが表示されます。ランタイム・ロギングは表示されません。

キー・コマンドを使用すると、wcm.jsへの参照を含む任意のWebページからコントリビュータ・コンソール・ウィンドウを起動できます。これは、コントリビュータ・コンソール・ウィンドウを、フォーカスが置かれているコントリビュータ対応のページ(コントリビューション・モード、コントリビューション・フォーム、行エディタの静的リスト、リンク・ウィザードなど)から起動できるということです。

コントリビュータ・コンソール・ウィンドウは、キー・コマンドによって起動された場合、リンクされているコンテキストのリストを反復してルート・コンテキストを検索します。ルート・コンテキストがみつかったら、コントリビュータ・コンソール・ウィンドウはそのページから起動され、すべてのロギング命令は、リンクされているコンテキストのリストを反復し、開いているコントリビュータ・コンソール・ウィンドウに記録します。

15.4 コントリビュータ・コンソール・ウィンドウの使用

複数コンテキストにおよぶロギングの格納とJavaScriptコードの実行を行うには、コントリビュータ・コンソール・ウィンドウは、ルート・ブラウザ・ウィンドウである必要があります。コントリビュータ・コンソール・ウィンドウがルート・ブラウザ・ウィンドウでない場合、またはリンクされたウィンドウ・オブジェクトのチェーンが壊れている場合、コントリビュータ・コンソール・ウィンドウは孤立し、適切に動作しません。

この項の内容は次のとおりです。

- 15.4.1項「コントリビュータ・コンソール・ウィンドウ・コンテキスト」

- 15.4.2項「コントリビュータ・コンソール・ウィンドウがルートであることの確認」

- 15.4.3項「コントリビュータ・コンソール・ウィンドウの実際的な使用」

- 15.4.4項「孤立したコンソール・ウィンドウ」

15.4.1 コントリビュータ・コンソール・ウィンドウ・コンテキスト

個々のHTMLウィンドウ・オブジェクトは、各ブラウザ・ウィンドウ、各HTML FRAME要素および各HTML IFRAME要素内に存在します。Site Studioでは多くのコンテキストがホストされ、コントリビューションの過程で多くの追加コンテキストが作成され、破棄されます。

これらのウィンドウ同士が通信するには、コンテキストは同じドメインのものである必要があります。コントリビュータのコンテキストのドメインは同じであるため、アプリケーションは、リンクされているコンテキストのリストを動的に反復し、開いているコントリビュータ・コンソール・ウィンドウに記録します。

15.4.2 コントリビュータ・コンソール・ウィンドウがルートであることの確認

コントリビュータ・コンソール・ウィンドウをルート・ブラウザ・ウィンドウとして確立し、コントリビュータ・コンソール・ウィンドウから新たにブラウザ・ウィンドウを起動した場合、孤立したコントリビュータ・コンソール・ウィンドウ・シナリオにはなりません。すべての新規ウィンドウとその生成された子ウィンドウは、コントリビュータ・コンソール・ウィンドウに記録します。

コントリビュータ・コンソール・ウィンドウのルート・ブラウザ・ウィンドウとしての確立

コントリビュータ・コンソール・ウィンドウをルート・ブラウザ・ウィンドウとして確立するには、サーバー上のコントリビュータ・コンソール・ウィンドウ・ファイルに直接移動する必要があります。コントリビュータ・コンソール・ウィンドウに移動すると、新しいブラウザ・ウィンドウでコントリビュータ・コンソール・ウィンドウが開きます。コントリビュータ・コンソール・ウィンドウ以外の他のウィンドウは、必要がなければ閉じてください。

コントリビュータ・コンソール・ウィンドウからの新規ブラウザ・ウィンドウの起動

コントリビュータ・コンソール・ウィンドウから新規ブラウザ・ウィンドウを起動すると、コントリビュータ・コンソール・ウィンドウがルート・ウィンドウになります。コントリビュータ・コンソール・ウィンドウから新規ブラウザ・ウィンドウを起動するには、次のJavaScriptコード・スニペットをコマンド・ウィンドウに入力し、「実行」をクリックします。

$D().launch('http://www.example.com'):

起動されたウィンドウとその生成された子供はすべて、コントリビュータ・コンソール・ウィンドウに記録します。すべての生成されたウィンドウは、ドメインが同じ場合、コントリビュータ・コンソール・ウィンドウに記録します。

15.4.3 コントリビュータ・コンソール・ウィンドウの実際的な使用

コントリビュータ・コンソール・ウィンドウのルート・ウィンドウとしての確立を繰返し行う場合、ショートカットについて検討します。簡単にアクセスするためにコントリビュータ・コンソール・ウィンドウのURLをブックマークに登録できます。コントリビュータ・コンソール・ウィンドウが開いたら、コマンド・ウィンドウに次のように入力すると、空のWebページを開くことができます。

$D().launch();

launchメソッドにパラメータを渡さないことで空のWebページがポップ・アップし、ブックマークを使用して目的のページに移動できます。

15.4.4 孤立したコンソール・ウィンドウ

フォーカスの置かれているコントリビュータ対応のページからコントリビュータ・コンソール・ウィンドウを起動した場合、コントリビュータ・コンソール・ウィンドウではなく、コントリビューション・モードのWebページがルート・コンテキストになります。

コントリビュータ・モードのページが閉じられたり、リフレッシュされた場合、コントリビュータ・コンソール・ウィンドウは孤立します。つまり、コントリビュータ・コンソール・ウィンドウは機能しません。開いているコントリビュータ・コンソール・ウィンドウとルート・コンテキスト(コントリビューション・モードのWebページ)との間のリンクは壊れます。リンクを再確立するには、孤立したコントリビュータ・コンソール・ウィンドウを閉じ、キー・コマンドを再度使用して新規コントリビュータ・コンソール・ウィンドウを開く必要があります。

ほとんどのロギングおよびデバッグの目的では、孤立したコントリビュータ・コンソール・ウィンドウは発生しません。ただし、いくつかのコントリビューション・セッションで新規コントリビュータ・コンソール・ウィンドウを開かない場合、コントリビュータ・コンソール・ウィンドウをルート・コンテキストとして確立する必要があります。

15.5 ロギング構文

コントリビュータ・コンソール・ウィンドウには、特定のタイプのメッセージを簡単に識別するためにロギング・ウィンドウ内の行を色分けして記録する機能があります。また、これらのメッセージは、コントリビュータ・コンソール・ウィンドウでフィルタできます。

行は次の色で表示されます。

メッセージ・タイプ

表示色

ログ

黒色

注意

紫色

エラー

赤色

警告

暗赤色

To-Do

緑色

テスト

青色

実行されたコマンド

灰色

リクエスト

青色(イタリック)

レスポンス

暗赤色(イタリック)

ロギングを有効にするには、次のJavaScriptファイルがhtmlページ・コンテキストにロードされる必要があります。このファイルは、ロギングに使用されるJavaScript関数を定義します。

<script type="text/javascript" src="<$HttpRelativeWebRoot$>resources/<$SSContributorSourceDir$>/wcm.js"></script>

コマンド・ウィンドウに次のように入力して「実行」をクリックすると、様々なロギング・タイプのデモが表示されます。

$D().log('This is a log message.', window);
$D().note('This is a note message.', window);
$D().error('This is an error message.', window);
$D().warn('This is a warning message.', window);
$D().todo('This is a todo message.', window);
$D().test("'This is a test that succeeds.' === 'This is a test that succeeds.'", window);
$D().test("'This is a test that fails.' !== 'This is a test that fails.'", window);
$D().request('This is a request message. A request message should be reserved for logging server requests.', window);
$D().response('This is a response message. A response message should be reserved for logging server responses.', window);
$D().startProfiling('MYprofileID', window);
$D().stopProfiling('MYprofileID', window);
$D().exec("(function(){ return 'Returning this line of code.'; })() // A self-executing function.", window);

15.6 時間プロファイリング

特定のアクションの実行にかかる時間は、コントリビュータ・コンソール・ウィンドウの時間プロファイリング・メカニズムを使用して測定できます。目的のアクションの前後に次の開始と終了のメソッドを挿入すると、終了メソッドの実行後、開いているコントリビュータ・コンソール・ウィンドウに分、秒およびミリ秒が記録されます。

$D().startProfiling('MY_PROFILE_ID'); // Start method
// TODO: perform some action here.
$D().stopProfiling('MY_PROFILE_ID'); // Stop method.

1つ目のパラメータとして同じプロファイルIDが渡されるかぎり、開始と終了のメソッドは異なるウィンドウ・コンテキストに存在できます。たとえば、次のようになります。

$D().startProfiling('MY_PROFILE_ID', window);
$D().stopProfiling('MY_PROFILE_ID', window);

15.7 コマンド・ウィンドウ・ヘルパー関数

指定されたコンテキストと前述のロギング・タイプで任意のJavaScriptコードを実行する以外に、コマンド・ウィンドウで既知のヘルパー関数を実行できます。次に、組込みヘルパー関数のリストを示します。

次のいずれかをコマンド・ウィンドウに入力し、「実行」をクリックします。

関数シグネチャ

説明

$D().clear();

ロギング・ウィンドウをクリアします。

$D().launch();

空のページで新規ポップアップ・ブラウザ・ウィンドウを起動します。

$D().launch(url);

新規ポップアップ・ブラウザ・ウィンドウを起動し、渡されたURLに移動します。

$D().contexts();

使用可能なコンテキストのリストをロギング・ウィンドウに表示します。

$D().setContext(context);

コマンド・ウィンドウのコンテキスト・フィールドを設定します。

$D().data();

特定の時点の使用可能なすべてのコンテキストのランタイム・データを記録します。

$D().data(context);

特定の時点の指定されたコンテキストのランタイム・データを記録します。

15.8 キーボード・コマンド

次に、使用可能なキーボード・コマンドのリストを示します。

関数シグネチャ

説明

[Ctrl]+[Alt]+[Shift]+[C]

コントリビュータ・コンソール・ウィンドウがまだ開いていない場合、開きます。

[Ctrl]+[Alt]+[Shift]+[E]

すべてのエラーをコマンド・ウィンドウに記録します。コントリビュータ・コンソール・ウィンドウがまだ開いていない場合、このコマンドで開きます。

[Ctrl]+[Enter]

コマンド・ウィンドウのテキスト・ボックスにフォーカスがある場合、このキーボード・コマンドによってコマンド・ウィンドウ内のコードが指定されたコンテキストで実行されます。

[Ctrl]+[Alt]+[Shift]+[T]

コントリビュータ・コンソール・ウィンドウにフォーカスがある場合、このキーボード・コマンドによって、テキスト・ボックスに未加工のログ・コンテンツが表示されます(切り替わります)。これによって、コントリビュータ・コンソールのログ・ウィンドウのコンテンツを簡単にコピーおよび貼り付けることができます。

16 マネージャ設定ファイル

この章の内容は次のとおりです。

- 16.1項「マネージャ設定ファイルについて」

- 16.2項「<ssm:settings>タグ」

- 16.3項「<ssm:general>タグ」

- 16.4項「<ssm:addSection>タグ」

- 16.5項「<ssm:removeSection>タグ」

- 16.6項「<ssm:moveSection>タグ」

- 16.7項「<ssm:setErrorHandler>タグ」

- 16.8項「<ssm:editProperties>タグ」

- 16.9項「<ssm:editCustomProperties>タグ」

- 16.10項「<ssm:primaryLayout>タグ」

- 16.11項「<ssm:secondaryLayout>タグ」

- 16.12項「<ssm:sectionOverride>タグ」

- 6.13項「マネージャ設定ファイルの例」

16.1 マネージャ設定ファイルについて

マネージャ設定ファイルは、サイト設計者がマネージャで使用可能な機能を制御する際に使用できる複数の構成オプションが含まれたXMLファイルです。

設計者は、「サイト・アセット」ペインでファイルを編集するときに表示される「フォーム」ビューを使用して、このファイルの複数の設定を変更できます。「ソース」ビューでこのファイルを編集すると、より高度な設定を操作できます。

16.2 <ssm:settings>タグ

<ssm:settings>タグは、マネージャ設定ファイル内のルートXML要素です。

パラメータ

- xmlns: このXMLファイルの名前空間。

子タグ

<ssm:settings>タグは、次のオプションの子タグを格納できます。

- 16.3項「<ssm:general>タグ」

- 16.4項「<ssm:addSection>タグ」

- 16.5項「<ssm:removeSection>タグ」

- 16.6項「<ssm:moveSection>タグ」

- 16.7項「<ssm:setErrorHandler>タグ」

- 16.8項「<ssm:editProperties>タグ」

- 16.9項「<ssm:editCustomProperties>タグ」

- 16.10項「<ssm:primaryLayout>タグ」

- 16.11項「<ssm:secondaryLayout>タグ」

- 16.12項「<ssm:sectionOverride>タグ」

16.3 <ssm:general>タグ

<ssm:general>タグには、汎用の構成設定が含まれます。

パラメータ

- contributorOnly: trueに設定すると、マネージャ・アプリケーションはブラウザがコントリビューション・モードの場合にのみ表示されます。falseに設定すると、マネージャ・アプリケーションは、コントリビューション・モードとコンシューマ・モードの両方で表示されます。

- autoManage: trueに設定すると、マネージャ・アプリケーションは、最初に表示されたときに自動的にサーバーに接続し、サイトの管理に必要な情報を収集します。falseに設定すると、マネージャ・アプリケーションは、サーバーと通信する前にユーザーが「(サイトの管理)」リンクをクリックするのを待機します。

- hierarchy: マネージャ・アプリケーションでの階層の表示を制御します。次のいずれかの値を指定する必要があります。

- hide: サイト階層を表示しません。

- showAll: サイト階層全体を表示します。

- showCurrentSectionOnly: 現在のセクション（およびその子）のみを表示します。

- displayConsole: trueに設定すると、マネージャ・アプリケーションとSite Studioコンポーネント間のすべてのサーバー通信をリストしたコンソールが表示されます。デバッグ目的専用です。

- updateTitle: trueに設定すると、現在選択されているセクションおよびアクション・タブを使用してブラウザのタイトル・バーが更新されます。falseに設定すると、タイトル・バーは更新されません。

- updateUrl: trueに設定すると、現在選択されているセクションおよびアクション・タブの状態を使用してURLが更新されます。falseに設定すると、URLは更新されません。

子タグ

<ssm:general>タグには、子タグは含まれません。

16.4 <ssm:addSection>タグ

<ssm:addSection>タグには、新規セクション追加機能の構成設定が含まれます。

パラメータ

- hidden: trueに設定すると、マネージャからこの機能が隠蔽されます。

子タグ

<ssm:addSection>タグは、次のオプションの子タグを格納して、新規セクション追加機能の動作を制御できます。

- <ssm:urlDirName>には、次のオプション・パラメータが含まれます。

- hidden: trueまたはfalse

- disabled: trueまたはfalse

- <ssm:id>には、次のオプション・パラメータが含まれます。

- hidden: trueまたはfalse

- disabled: trueまたはfalse

- <ssm:primaryUrl>には、次のオプション・パラメータが含まれます。

- inherit: trueまたはfalseに設定し、新規セクションでその親セクションのプライマリURLを継承するかどうかを指定します。

- default: 新規セクションにprimaryUrlのデフォルト値を提供します。

- <ssm:secondaryUrl>には、次のオプション・パラメータが含まれます。

- inherit: trueまたはfalseに設定し、新規セクションでその親セクションのセカンダリURLを継承するかどうかを指定します。

- default: 新規セクションにsecondaryUrlのデフォルト値を提供します。

- <ssm:secondaryUrlVariableField>には、次のオプション・パラメータが含まれます。

- inherit: trueまたはfalseに設定し、新規セクションでその親セクションのsecondaryUrlVariableFieldを継承するかどうかを指定します。

- default: 新規セクションにsecondaryUrlVariableFieldのデフォルト値（trueまたはfalse）を提供します。

16.5 <ssm:removeSection>タグ

<ssm:removeSection>タグには、セクション削除機能の構成設定が含まれます。

パラメータ

- hidden: trueに設定すると、マネージャからこの機能が隠蔽されます。

子タグ

<ssm:removeSection>タグには、子タグは含まれません。

16.6 <ssm:moveSection>タグ

<ssm:moveSection>タグには、セクション移動機能の構成設定が含まれます(ドラッグ・アンド・ドロップによる移動を含む)。

パラメータ

- hidden: trueに設定すると、マネージャからこの機能が隠蔽されます。

子タグ

<ssm:moveSection>タグには、子タグは含まれません。

16.7 <ssm:setErrorHandler>タグ

<ssm:setErrorHandler>タグには、エラー・ハンドラ設定機能の構成設定が含まれます。

パラメータ

- hidden: trueに設定すると、マネージャからこの機能が隠蔽されます。

子タグ

<ssm:setErrorHandler>タグには、子タグは含まれません。

16.8 <ssm:editProperties>タグ

<ssm:editProperties>タグには、標準のセクション・プロパティを編集するための構成設定が含まれます。

パラメータ

- hidden: trueに設定すると、マネージャからこの機能が隠蔽されます。

子タグ

<ssm:editProperties>タグは、次のオプションの子タグを格納できます。

- <ssm:id>には、次のオプション・パラメータが含まれます。

- hidden: trueまたはfalse

- disabled: trueまたはfalse

- <ssm:label>には、次のオプション・パラメータが含まれます。

- hidden: trueまたはfalse

- disabled: trueまたはfalse

- <ssm:active>には、次のオプション・パラメータが含まれます。

- hidden: trueまたはfalse

- disabled: trueまたはfalse

- <ssm:contributorOnly>には、次のオプション・パラメータが含まれます。

- hidden: trueまたはfalse

- disabled: trueまたはfalse

- <ssm:urlDirName>には、次のオプション・パラメータが含まれます。

- hidden: trueまたはfalse

- disabled: trueまたはfalse

- <ssm:urlPageName>には、次のオプション・パラメータが含まれます。

- hidden: trueまたはfalse

- disabled: trueまたはfalse

- <ssm:maxAge>には、次のオプション・パラメータが含まれます。

- hidden: trueまたはfalse

- disabled: trueまたはfalse

16.9 <ssm:editCustomProperties>タグ

<ssm:editCustomProperties>タグには、カスタム・プロパティ機能の構成設定が含まれます。

パラメータ

- hidden: trueに設定すると、マネージャからこの機能が隠蔽されます。

子タグ

<ssm:editCustomProperties>タグには、子タグは含まれません。

16.10 <ssm:primaryLayout>タグ

<ssm:primaryLayout>タグには、プライマリ・レイアウト選択機能の動作を制御するための構成設定が含まれます。

パラメータ

- hidden: trueに設定すると、マネージャ・アプリケーションで「レイアウト」タブが非表示になります。

- externalHidden: trueに設定すると、セクションのプライマリ・レイアウトとして外部URLを選択する機能が非表示になります。

- previewHidden: trueに設定すると、「レイアウト」タブのプレビューIFrameが非表示になります。

子タグ

<ssm:primaryLayout>タグは、次のオプションの子タグを格納できます。

- <ssm:presentation>には、単純なHTMLプレゼンテーション文字列を提供するCDATAセクションが含まれます。これにより、レイアウト選択コンボ・ボックスにレイアウト情報を表示できます。単純なインラインHTMLは、$field$としてマークされたメタデータ・フィールド宣言を通じて可能となります。次にいくつかの例を示します。

- $dDocTitle$

- $dDocName$

- $dDocTitle$（<i>$dDocName$</i>）

- <b>$dDocName$</b>

- <ssm:queryText>には、レイアウト選択コンボ・ボックスにデータを移入するための問合せ文字列を提供するCDATAセクションが含まれます。また、次のオプション・パラメータも格納できます。

- limitscope: trueに設定すると、検索を現在のWebサイトのアイテムのみに制限して実行できます。

16.11 <ssm:secondaryLayout>タグ

<ssm:secondaryLayout>タグには、セカンダリ・レイアウト選択機能の動作を制御するための構成設定が含まれます。

パラメータ

- hidden: trueに設定すると、マネージャ・アプリケーションでセカンダリ・レイアウト・タブが非表示になります。

- previewHidden: trueに設定すると、セカンダリ・レイアウト・タブのプレビューIFrameが非表示になります。

子タグ

<ssm:secondaryLayout>タグは、次のオプションの子タグを格納できます。

- <ssm:presentation>には、単純なHTMLプレゼンテーション文字列を提供するCDATAセクションが含まれます。これにより、レイアウト選択コンボ・ボックスにレイアウト情報を表示できます。単純なインラインHTMLは、$field$としてマークされたメタデータ・フィールド宣言を通じて可能となります。次にいくつかの例を示します。

- $dDocTitle$

- $dDocName$

- $dDocTitle$（<i>$dDocName$</i>）

- <b>$dDocName$</b>

- <ssm:queryText>には、レイアウト選択コンボ・ボックスにデータを移入するための問合せ文字列を提供するCDATAセクションが含まれます。また、次のオプション・パラメータも格納できます。

- limitscope: trueに設定すると、検索を現在のWebサイトのアイテムのみに制限して実行できます。

16.12 <ssm:sectionOverride>タグ

<ssm:sectionOverride>タグには、前述のデフォルト設定を上書きする特定のWebサイト・セクションの構成設定が含まれます。

パラメータ

- nodeId: 上書きされるセクションのID。

子タグ

<ssm:sectionOverride>タグは、次のオプションの子タグを格納できます。これらの子タグの詳細は、次の各項で説明済です。

- 16.4項「<ssm:addSection>タグ」

- 16.5項「<ssm:removeSection>タグ」

- 16.6項「<ssm:moveSection>タグ」

- 16.7項「<ssm:setErrorHandler>タグ」

- 16.8項「<ssm:editProperties>タグ」

- 16.9項「<ssm:editCustomProperties>タグ」

- 16.10項「<ssm:primaryLayout>タグ」

- 16.11項「<ssm:secondaryLayout>タグ」

<ssm:sectionOverride>内のサブセクションのパラメータおよびコンテンツは、一般的な方法で使用できますが、次の例外があります。

- <ssm:moveSection>は、オーバーライドされるセクションにのみ適用される次の2つの追加属性を格納できます。

- source: falseに設定すると、このセクションは移動アクションのソースとして使用されません。

- target: falseに設定すると、このセクションは移動アクションのターゲットとして使用されません。

16.13 マネージャ設定ファイルの例

<?xml version='1.0' encoding='utf-8' ?>
<ssm:settings xmlns:ssm="http://www.example.com/sitestudio/managersettings/">
<ssm:general contributorOnly="false"
autoManage="true"
hierarchy="showAll"
displayConsole="false"
updateTitle="true"
updateUrl="true" />

<ssm:addSection hidden="false">
<ssm:urlDirName hidden="false" disabled="false" />
<ssm:id hidden="false" disabled="false" />
<ssm:primaryUrl inherit="true" default="" />
<ssm:secondaryUrl inherit="true" default="" />
<ssm:secondaryUrlVariableField inherit="true" default="" />
</ssm:addSection>

<ssm:removeSection hidden="false" />
<ssm:moveSection hidden="false" />
<ssm:setErrorHandler hidden="false" />

<ssm:editProperties hidden="false" >
<ssm:id hidden="false" disabled="true" />
<ssm:label hidden="false" disabled="false" />
<ssm:active hidden="false" disabled="false" />
<ssm:contributorOnly hidden="false" disabled="false" />
<ssm:urlDirName hidden="false" disabled="false" />
<ssm:urlPageName hidden="false" disabled="false" />
<ssm:maxAge hidden="false" disabled="false" />
</ssm:editProperties>

<ssm:editCustomProperties hidden="false" />

<ssm:primaryLayout hidden="false" externalHidden="false" previewHidden="false">
<ssm:presentation>
<![CDATA[$dDocTitle$ (<i>$dDocName$</i>)]]>
</ssm:presentation>
<ssm:queryText limitScope="true">
<![CDATA[]]>
</ssm:queryText>
</ssm:primaryLayout>

<ssm:secondaryLayout hidden="false" previewHidden="false">
<ssm:presentation>
<![CDATA[$dDocTitle$ (<i>$dDocName$</i>)]]>
</ssm:presentation>
<ssm:queryText limitScope="true">
<![CDATA[]]>
</ssm:queryText>
</ssm:secondaryLayout>

<ssm:sectionOverride nodeId="42">
<ssm:addSection hidden="true" />
<ssm:removeSection hidden="true" />
<ssm:moveSection hidden="true" />
<ssm:setErrorHandler hidden="true" />
<ssm:setErrorHandler hidden="true" />
<ssm:editProperties hidden="false" />
<ssm:editCustomProperties hidden="true" />
<ssm:primaryLayout hidden="true" />
<ssm:secondaryLayout hidden="true" />
</ssm:sectionOverride>

</ssm:settings>

17 Content Tracker統合

Site StudioとContent Trackerを組み合せて使用し、Site Studio Webサイトに関するレポートを生成できます。2つの製品の統合は、複数の構成フラグを使用してカスタマイズできます。構成フラグでは、レポート対象のデータを制御します。

Content Tracker(データ・エンジン・コントロール・センター)を使用して、追跡対象のデータと、各サービス・コールでそのデータを追跡する場所を制御できます。

この章の内容は次のとおりです。

- 17.1項「追跡対象データ」

- 17.2項「構成フラグ」

17.1 追跡対象データ

追跡されるサイト・アクセスには次の2つのタイプがあります。

- 階層アクセス: 一般的にセクションIDにより行われるアクセスで、セクションの実際のコンテンツにかかわらずそのセクションを対象とするアクセスです。

- コンテンツ・アクセス: コンテンツが実際に表示される場所にかかわらず、特にコンテンツの一部を対象とするアクセスです。

階層アクセス

コンテンツ・アクセス

SS変数

CTフィールド名

レイアウト・ページのdDocName

データ・ファイル、ネイティブ・ドキュメントまたはフラグメント・ライブラリのdDocName

targetPage

sc_scs_dDocName

レイアウト・ページのdID

データ・ファイル、ネイティブ・ドキュメントまたはフラグメント・ライブラリのdID

targetdID

sc_scs_dID

サイトID

サイトID

targetSiteId

extField_1

ノードID

ノードID

targetNodeId

extField_2

セカンダリ・ページ

セカンダリ・ページ

targetIsSecondary

extField_3

Webサイトのオブジェクト・タイプ

Webサイトのオブジェクト・タイプ

targetWebsiteObjectType

extField_4

コントリビューション・モード

コントリビューション・モード

SSContributor

extField_5

（未使用）

データ・ファイル、ネイティブ・ドキュメントまたはフラグメントが使用されているレイアウトのdDocName

targetContentId

extField_6

サイト相対URL

サイト相対URL

siteRelativeUrl

extField_7

エラーが発生すると、次の値がContent Trackerデータベースに格納されます。

エラー・タイプ

SS変数

CTフィールド名

エラー

SS変数

CTフィールド名

サーバーで取得して解決できなかった元のサイト相対URL

originalSiteRelativeUrl

extField_8

元のURLが無効であったかどうか

invalidSiteRelativeUrl

extField_9

サイトにエラー・ハンドラ・ページがあり、そのページにアクセスできる場合、siteRelativeUrlはそのエラー・ページのURLに設定されます。エラーの原因となった元のURLは、originalSiteRelativeUrl値として設定されます。invalidSiteRelativeUrl値は、1に設定されます。

サイトにエラー・ハンドラ・ページがない状態でエラーが発生すると、元のURLがsiteRelativeUrlとして記録され、invalidSiteRelativeUrl値は1に設定されます。この場合、originalSiteRelativeUrl値は空になります。

17.2 構成フラグ

次の構成フラグをconfig.cfgで設定することにより、Site Studioで追跡するデータと、その情報の追跡方法を制御します。

- SSTrackContentAccess=[true|false]
これにより、コンテンツ・アクセスを有効化するかどうかを指定します。デフォルト設定はtrueです。falseに設定すると、階層アクセスのみが追跡されます。

- SSTrackFragmentAccess=[true|false]
これにより、フラグメント・ライブラリに対するアクセスを記録するかどうかを指定します。デフォルト設定はfalseです。

- SSTrackerReportNumDaysBack=[n|7]
これにより、コントリビューション・アイコンのポップアップ・メニューを使用してアクセスできるコンテンツ・アクセス・タイプのレポートの履歴日数を指定します。デフォルト設定は7であり、nは正数(日数)です。

A Site Studio 11gR1と組み合せて使用するためのOracle Content Server 10gR3の構成

Site Studio 11gR1 (11.1.1.4以上)は、Oracle Content Server 10gR3で管理されるサイト・アセットおよびコンテンツに対して使用できます。ただし、これを行うには、手動の処理が必要です。

この項の内容は次のとおりです。

- A.1項「Oracle Content Server 10gR3でのSite Studio 11gR1のインストール」

- A.2項「コンポーネントのダウンロード」

- A.3項「Site Studio Designer 11gR1の入手」

- A.4項「デフォルト・プロジェクト・ドキュメント情報の設定」

- A.5項「Apache Webサーバーの構成」

- A.6項「Sun ONE Webサーバーの構成」

- A.7項「ゾーン・フィールドの構成」

- A.8項「コンテンツ・サーバーでのJavaServer Pagesの有効化」

A.1 Oracle Content Server 10gR3でのSite Studio 11gR1のインストール

Site Studio 11gR1は、Oracle Content Server 10gR3と組み合せて使用できます。ただし、Site Studioを使用するには、サーバーの追加コンポーネントをいくつかダウンロードし、インストールする必要があります。

Oracle Content Server 10gR3で次のものをインストールし、有効にする必要があります。

- 最新の10gR35CoreUpdateおよび10gR35NativeUpdateバンドル(Oracle Content ServerおよびDynamic Converterを必要な機能セット・レベルに更新し、Webフィルタを必要なバージョンに更新)。

- Site Studio 11gR1 PS3 (11.1.1.4)バンドルに含まれているSiteStudioコンポーネント(Site Studio Designerクライアント・インストーラも含まれています)。

Site Studio Webサイトでネイティブ・ドキュメントの動的変換を使用する予定の場合、Oracle Content ServerでDynamic Converterを構成する必要があります。

SiteStudioコンポーネントがインストールされ、有効にされると、Site Studio Designer 11gR1クライアント・インストーラがコンテンツ・サーバーにチェックインされます。インストーラをOracle Content Serverの構成情報ページからダウンロードして実行すると、クライアント・コンピュータでSite Studio Designer 11gR1がインストールされます。

さらに、次の処理を完了する必要があります。

- JDKバージョン1.6をインストールする必要があります(Oracle Content Server 10gR3に含まれるのはJDK 1.5)。

- 新規JDK 1.6インストール・ディレクトリを参照するようOracle Content Server構成ファイルintradoc.cfgを更新する必要があります。JDK_customエントリを構成ファイルの#Additional Variablesセクションに追加します。

A.2 コンポーネントのダウンロード

必要なOracleコンポーネントは、Oracle Technology Network (OTN)のOracle WebCenter Content Universal Content Managementセクションから入手できます。

http://otn.oracle.com/

A.3 Site Studio Designer 11gR1の入手

Oracle Content Server 10gR3でSiteStudio 11gR1コンポーネントをインストールすると、Site Studio Designer 11gR1インストーラがコンテンツ・アイテムとしてサーバーにチェックインされます。Oracle Content Serverの「一般的な情報」ページからSite Studio Designeインストーラをダウンロードできます。Designer 11gR1アプリケーションの使用方法の詳細は、『Oracle WebCenter Content Site Studio Designerユーザーズ・ガイド』を参照してください。

A.4 デフォルト・プロジェクト・ドキュメント情報の設定

Site Studioで新規Webサイトを作成すると、新規プロジェクト・ファイルが作成され、コンテンツ・サーバーにチェックインされます。したがって、Webサイトを作成する前に、新規プロジェクト・ファイルに割り当てるメタデータを指定する必要があります。これは、コンテンツ・サーバーの「プロジェクトのデフォルト・ドキュメント情報の設定」ページで行います。

Site Studioプロジェクト・ファイルに使用されるデフォルト・メタデータを設定するには、次のタスクを実行します。

1. 管理者としてOracle Content Serverにログオンします。

2. 「管理」ページに移動し、「Site Studioの管理」をクリックします。
「Site Studioの管理」ページが表示されます。

3. 「デフォルトのプロジェクト・ドキュメント情報の設定」をクリックします。
「デフォルトのプロジェクト・ドキュメント情報の設定」ページが表示されます。ここで、Site Studioによって生成される新規プロジェクトのデフォルト・メタデータを割り当てます。

4. 必要に応じてメタデータを設定し、設定し終えたら、「更新」をクリックします。
これによって、「Site Studioの管理」ページに戻ります。

A.5 Apache Webサーバーの構成

WebサーバーとしてApache Webサーバーを使用する場合、Site StudioでパスベースのURLを利用できるよう構成ファイルを更新します。ApacheをWebサーバーとして使用しない場合、この項はスキップできます。

Apache Webサーバー構成ファイルを編集するには、次のタスクを実行します。

1. Apache httpd.conf構成ファイルを開きます。このファイルは、Apacheのインストール場所のconfディレクトリにあります。

2. 次のようなエントリを検索します。

LoadModule IdcApacheAuth CS-Dir/shared/os/OS_Name/lib/IdcApacheAuth2.dll
IdcUserDB myserver CS-Dir/data/users/userdb.txt
Alias /myserver "CS-Dir/weblayout"
<Location "/myserver">
DirectoryIndex portal.htm
IdcSecurity myserver
</Location>

注意:
UNIXでは、LoadModule行はIdcApacheAuth2.soを参照します。

3. 次の行を追加します。

<Location "/">
IdcSecurity myserver
</Location>

4. UseCanonicalName構成変数を検索し、オフに設定されていることを確認します。

5. 構成ファイルを保存し、Apache HTTP Serverを再起動します。

注意

- すべてのコード例で、コンテンツ・サーバー名として"myserver"が使用されます。

- Site Studioドメインベースのサイトを使用する場合、<Location "/">エントリ(ステップ3)を使用する必要があります。

- <Location "/">エントリ(ステップ3)を使用しない場合、サーバーで認識する必要のあるWebサイトごとに別個のエントリを使用する必要があります。たとえば、アドレス"http://domain/site1/index.htm"および"http://domain/site2/index.htm"の2つのサイトがある場合、次のように2つの場所のエントリを設定します。

<Location "/site1">
IdcSecurity myserver
</Location>
<Location "/site2">
IdcSecurity myserver
</Location>

Site StudioでのWebサイトURLの変更の詳細は、『Oracle WebCenter Content Site Studio Designerユーザーズ・ガイド』を参照してください。

A.6 Sun ONE Webサーバーの構成

WebサーバーとしてSun ONE Webサーバーを使用する場合、Site StudioでパスベースのURLを利用できるよう構成ファイルを更新します。Sun ONEをWebサーバーとして使用しない場合、この項はスキップできます。

Sun ONE Webサーバー構成ファイルを編集するには、次のタスクを実行します。

1. Sun Webサーバー・ソフトウェア・ディレクトリに移動し、https-host_name/configサブディレクトリ(host_nameは、ソフトウェアがインストールされているシステムの名前)を開きます。次に例を示します。

/https-server7/config

2. テキスト・エディタでobj.confファイルを開きます。

3. <Object name="default">セクション内でWeb IDをNameTransエントリに追加します。

NameTrans fn="pfx2dir" from="/Site_ID" dir="Weblayout_Dir"

ここで、Site_IDはWebサイトのWeb IDで、Weblayout_DirはWebで表示可能なファイル・リポジトリのフルパスです。

4. obj.confファイルで行った変更をWebサーバーの管理ページで適用します。

5. Webサーバーを停止し、再起動します。

A.7 ゾーン・フィールドの構成

Site Studioコンポーネントをインストールすると、いくつかのメタデータ・フィールドがコンテンツ・サーバーに追加されます。この一部をゾーン・フィールドとして構成し、全文索引付けされるようにします。

コンテンツ・サーバーでDBSearchContainsOpSupportコンポーネントがインストールされ、有効化されていることを確認します。このコンポーネントによって、ゾーン・フィールドが適切に全文索引付けされていることが保証されます。全文索引付けは、Site Studioサイトが適切に機能するために必要です。このコンポーネントのインストールまたは有効化が行われていない場合、インストールし、有効にします。コンポーネントzipファイルは、Oracle Content Server配布パッケージの\packages\allplatformディレクトリにあります。

Site Studioメタデータ・フィールドのゾーン・フィールドとしての構成

Site Studioメタデータ・フィールドをゾーン・フィールドとしての構成するには、次のタスクを実行します。

1. 管理者としてOracle Content Serverにログインします。

2. 「管理」ページを開きます。

3. 「ゾーン・フィールドの構成」をクリックします。

4. Webサイトと除外リストをゾーン・テキスト・フィールドとして指定します。

これらのフィールドをゾーン・フィールドとして確立した後、検索索引を再作成する必要はありません。

コンテンツ・サーバー構成ファイルへの設定の追加

コンテンツ・サーバー構成ファイルに設定を追加するには、次のタスクを実行します。

1. 新規ブラウザ・ウィンドウを開き、システム管理者(sysmanagerロールを持つ)としてOracle Content Serverにログインします。

2. 管理アプレットページに移動し、「管理サーバー」リンクをクリックします。

3. 「コンテンツ管理サーバー」ページで、適切なコンテンツ・サーバー・インスタンスのボタンをクリックします。
選択したコンテンツ・サーバー・インスタンスのステータス・ページが表示されます。

4. サーバー・インスタンスのオプション・リストで、「一般構成」リンクをクリックします。
「一般構成」ページが表示されます。

5. ページの下部までスクロール・ダウンし、次の行を「追加の構成変数」ボックスに追加します。

SSUseUniversalQueryFormat=1

6. オプションで、次の行も追加できます。

SSEnableDBSearchShortcut=1

これによって、Site Studio DesignerおよびContributorによって実行される問合せのレスポンスを向上させます。

7. 「保存」をクリックします。

8. コンテンツ・サーバーを再起動します。

A.8 コンテンツ・サーバーでのJavaServer Pagesの有効化

Site StudioでのJavaServer Pagesの使用を予定している場合、コンテンツ・サーバーでJSPを有効にする必要があります。これによって、コンテンツ・サーバーでコンテンツおよびサービス(パーソナライズ、セキュリティ定義、事前定義済変数など)にアクセスしたり、変更できます。JavaServer Pagesの有効化の詳細は、Content Serverドキュメント・セットに含まれているSoftware Developer's Kit (SDK)スタート・ガイドを参照してください。

Site Studioコンポーネントを有効にした後でJSPグループを有効にする場合、JSPフラグメントが適切に機能するようJSPサポートを構成する必要があります。

重要:
JSPはレガシーSite Studioプロジェクト(10gR4より前のアーキテクチャを使用するプロジェクト)でのみサポートされます。これらは通常10gR4より前のリリースのSite Studioで作成され、Designer 10gR4で開かれたプロジェクトです。

新規JSPグループに対するJSPサポートの構成

コンテンツ・サーバーでSite Studioコンポーネントをインストールし、JSPを有効にするグループのリストにグループを追加する場合、そのグループに対するJSPサポート・ファイルを再デプロイし、Site Studio JSPフラグメントが適切に機能できるようにする必要があります。

JSPサポートを構成するには、次のタスクを実行します。

1. 管理者としてOracle Content Serverにログインします。

2. 「管理」で、「Site Studioの管理」をクリックします。

3. 「フラグメント・ライブラリの管理」をクリックします。

4. 「JSPサポートの構成」ボタンをクリックします。

JSPサポート・ファイルがコンテンツ・サーバーの必要なディレクトリに抽出されます。

B 7.5より前のWebサイトのアップグレード

この項の内容は次のとおりです。

- B.1項「概要」

- B.2項「自動アップグレードでの処理」

- B.3項「コンテンツ・サーバーのアップグレード」

- B.4項「追加処理の手動実行」

B.1 概要

7.5より前のリリースのSite Studioからアップグレードする場合、Site Studio 11gR1で使用するにはWebサイトをアップグレードする必要があります。これは、Site Studioバージョン7.5と10gR3で次のような重要なアーキテクチャ上の変更があるからです。

- サイト階層はプロジェクト・ファイルに格納され、フォルダに依存しなくなりました。その結果、Oracle Content Serverのフォルダ機能は必要なくなりました。

- WebサイトURLは、SS_GET_PAGEサービス(11.7.38項「SS_GET_PAGE」を参照)を表示するCGIベースのアドレスではなく、論理パスと接尾辞として表示されます。その結果、よりフレンドリなパスベースのURLが表示されます。

- レイアウト・ページで<base>タグが使用されなくなりました。したがって、baseタグに依存するハイパーリンクおよび参照は変更される必要があります。

- siteIdとルートIDは同義ではなくなりました。

アップグレード後、Site Studio 11gR1ではアップグレードされたプロジェクトはレガシー・プロジェクトとして機能します。つまり、10gR4より前のアーキテクチャを使用し、Site Studio 10gR4および11gR1の新規アーキテクチャと機能は使用されません。Site Studio 7.5または10gR3を使用して作成されたプロジェクトも同様です。それ自体はアップグレードする必要はなく、Site Studio 11gR1で使用できますが、レガシー(10gR4より前)モードで機能し続けます。

B.2 自動アップグレードでの処理

7.5より前のリリースのSite Studioをアップグレードする場合、次のタスクが自動的に実行されます。

アクション

説明

フォルダベースのサイトのプロジェクトベースのサイトへのアップグレード

フォルダ構造の既存の階層がプロジェクト・ファイルで再生成されます。ルートdCollectionNameがsiteLabelとして使用され、ルートdCollectionIDがsiteIdとして使用されます。originalCollectionIDプロジェクト属性が設定され、サイト・タイプがルート・セクションからプロジェクトに転送されます。

新規サイトでのカスタム・セクション・プロパティの更新

タイプsiteidおよびurlのカスタム・セクション・プロパティが更新されます(必要に応じてフレンドリURLが追加されます)。

レイアウト・ページでのフラグメント・インスタンス・パラメータの更新

タイプmanagedurlおよびurlのパラメータが更新されます。

メタデータの移入

「プロジェクト・ファイルの作成」オプションが有効な場合、xWebsiteSection値が移入されます(xCollectionIDから導出)。

レイアウト・ページのリンクおよびデータ・ファイルの更新

「レイアウトのアップグレード」および「データファイルのアップグレード」オプションが有効な場合、レイアウト・ページのweblayoutリンクおよびコントリビュータ・データ・ファイルがアップグレードされてHttpRelativeWebRootトークンが含まれます。オプションでjavascriptリンクも更新されます。

ナビゲーションの更新

Webサイトのナビゲーション・ファイルが生成されます。

注意:
カスタム要素は自動的にアップグレードされません。詳細は、B.4.4項「カスタム要素の更新」を参照してください。

B.3 コンテンツ・サーバーのアップグレード

サイトのアップグレード・タスクは、使用している各コンテンツ・サーバーのSite Studioコンポーネントのアップグレードから始め、その後コンテンツ・サーバーに格納されているWebサイトをアップグレードします。

- B.3.1項「単一コンテンツ・サーバー・インスタンスでのサイトのアップグレード」

- B.3.2項「複数コンテンツ・サーバー・インスタンスでのサイトのアップグレード」

- B.3.3項「完全アップグレードの実行」

- B.3.4項「最小アップグレードの実行」

フォルダ・コンポーネントはSite Studioバージョン7.5以降使用されていませんが、各サイトをフォルダベースの階層からプロジェクトベースの階層に移行するために、Webサイトのアップグレード中フォルダを保持する必要があります。

その後、フォルダ・コンポーネントを無効にできます。フォルダの使用を続ける場合、適切なメタデータで構成する必要があります(B.4.5項「フォルダへのWebサイト・セクションの割当て」を参照)。

注意:
アップグレード手順に従うと、サーバー上の各Webサイトがアップグレードされます。選択したサイトのみをアップグレードする場合、別のサーバーに他のサイトのコピーを作成する必要があります。

B.3.1 単一コンテンツ・サーバー・インスタンスでのサイトのアップグレード

Webサイトが単一コンテンツ・サーバーに格納されている場合、アップグレードは次の処理で構成されます。

1. 新規Site Studioコンポーネントのインストール(初めに古いコンポーネントをアンインストール)。

2. コンテンツ・サーバーでの完全アップグレードの実行。詳細は、B.3.3項「完全アップグレードの実行」を参照してください。

3. 自動アップグレードで行われない追加処理の手動実行。詳細は、B.4項「追加処理の手動実行」を参照してください。

B.3.2 複数コンテンツ・サーバー・インスタンスでのサイトのアップグレード

開発サーバー、コントリビューション・サーバー、本番サーバーなど異なる用途の複数のコンテンツ・サーバーにサイトがある場合があります。

図B-1 複数コンテンツ・サーバー・インスタンスの図

「図B-1 複数コンテンツ・サーバー・インスタンスの図」の説明

各サーバー(ソース・サーバー)のコンテンツは、アーカイバ/レプリケータ・ユーティリティを使用して次のサーバーにコピーされます。したがって、レプリケーションの問題が発生しないよう各サーバーのサイトのアップグレードを注意深く計画することが重要です。

コンテンツ・サーバーの最初の2つのインスタンス上

- コンテンツ・サーバー間のレプリケーションを停止します。

- 新規Site Studioコンポーネントをインストールします。

コンテンツ・サーバーのソース・インスタンス上

- サイトの完全アップグレードを実行します。詳細は、B.3.3項「完全アップグレードの実行」を参照してください。
その後

- 追加処理(自動アップグレードで行われない処理)を手動で実行します。詳細は、B.4項「追加処理の手動実行」を参照してください。

コンテンツ・サーバーのターゲット・インスタンス上

- サイトの最小アップグレードを実行します。詳細は、B.3.4項「最小アップグレードの実行」を参照してください。

コンテンツ・サーバーの両インスタンス上

- コンテンツ・サーバー間のレプリケーションを再開します。
新規コンポーネントがコンテンツ・サーバーのすべてのインスタンスにインストールされ、Webサイトが前述のようにアップグレードされたら、サイトのレプリケートを再開できます。

Site Studioのレプリケーション機能を使用できます(『Oracle WebCenter Content Site Studio管理者およびマネージャーズ・ガイド』を参照)。あるいは、アーカイバ/レプリケータを使用していて、この使用を続ける場合、Site Studioプロジェクト・ファイルを含めるようアーカイブ問合せを変更すれば可能です。

次のターゲット・コンテンツ・サーバー(レプリケーションでのダウンストリーム)上

- ソースとターゲットのコンテンツ・サーバー間のレプリケーションを停止します。

注意:
このケースでは、ソース・サーバー(Box 2)は前述の手順のターゲット・サーバーで、ターゲット・サーバー(Box 3)は後続のレプリケーション(ダウンストリーム)での次のサーバーです。

- 新規Site Studioコンポーネントをインストールします。
その後

- サイトの最小アップグレードを実行します。詳細は、B.3.4項「最小アップグレードの実行」を参照してください。
その後

- ソースとターゲットのコンテンツ・サーバー間のレプリケーションを再開します。

レプリケーションのダウンストリームのコンテンツ・サーバーのターゲット・インスタンスごとに最後の手順を繰り返します。

B.3.3 完全アップグレードの実行

コンテンツ・サーバーの完全アップグレードは、単一サーバーの設定の場合に必要です。複数サーバーの設定の場合のソース・サーバーにも必要です。(複数サーバーの設定での他のすべてのサーバーには最小アップグレードが必要です。)

サイトをアップグレードすると、Site Studioで既存のフォルダベースのサイトがプロジェクトベースのサイトに変更されます。これが行われる際、プロジェクト・ファイルがコンテンツ・サーバーの管理対象アイテムとして作成されます。したがって、各Webサイトを表すプロジェクト・ファイルに割り当てるメタデータを識別する必要があります。

アップグレード・プロセスで、コンテンツ・サーバーは、変更されるコンテンツの索引付けを試みます。これには、時間とリソースが大幅に必要となる場合があります。アップグレード・プロセスを開始する前に自動索引付けを一時的に無効にし、終了したら再度有効にすることもできます。(詳細は、Oracle Content Serverの管理ドキュメントを参照してください。)

完全アップグレードを開始する前に、サーバーで新規Site Studioコンポーネントをインストールし、有効にしておく必要があります。

完全アップグレードを実行するには、次のタスクを実行します。

1. 管理者としてコンテンツ・サーバーにログオンし、「管理」ページ、「Site Studioの管理」ページの順に開きます。

2. 「プロジェクトのデフォルト・ドキュメント情報の設定」をクリックします。
「プロジェクトのデフォルト・ドキュメント情報の設定」ページが開きます。ここで、Site Studioで作成する新規プロジェクトのデフォルト・メタデータを割り当てます。

3. メタデータ値を指定したら、「更新」をクリックします。
これによって、「Site Studioの管理」ページに戻ります。ここでアップグレード・プロセスを開始できます。

4. 「Webサイトの管理」をクリックします。

5. Webサイト更新ページに移動をクリックします。(このオプションは、古いWebサイトが検出された場合にのみ表示されます。)

6. 「詳細オプション」をクリックして、サイトのアップグレード・オプションを指定します。

図B-2 「詳細なアップグレード・オプション」画面

「図B-2 「詳細なアップグレード・オプション」画面」の説明

7. 完全アップグレード向けに次の選択をします。

- 「プロジェクト・ファイルの作成」を選択します。

- 「レイアウトのアップグレード」を選択します。

- 「データファイルのアップグレード」を選択します。

- 「ハイパーリンクの変換」を選択し、リンク形式を選択します。

- サーバー側リンク: サーバー側スクリプトを使用してターゲットの場所をコード化したIDを含むリンク。

- パスベースのURL: ターゲットの場所の完全パスを含むリンク。

8. 「オプション設定」をクリックして「レガシーWebサイトのアップグレード」ページに戻ります。

9. 「アップグレードの開始」をクリックします。
アップグレードの必要な各ファイルがこのページに表示されます。アップグレード・プロセスが完了したことを示すメッセージが表示されるまで待ちます。

注意:
サイトのアップグレードでサイト階層とその多数のリンクが自動的に更新され、コンテンツ・サーバーの「Webサイト」メニューにサイトがリストされます。

B.3.4 最小アップグレードの実行

最小アップグレードは、複数サーバーの設定の場合に必要で、すべてのターゲット・サーバー(レプリケートされるWebサイトのあるサーバー)に適用されます。

最小アップグレードを開始する前に、サーバーで新規Site Studioコンポーネントをインストールし、有効にしておく必要があります。

最小アップグレードを実行するには、次のタスクを実行します。

1. 管理者としてコンテンツ・サーバーにログオンし、「管理」ページ、「Site Studioの管理」ページの順に開きます。

2. 「デフォルトのプロジェクト・ドキュメント情報の設定」をクリックします。
「プロジェクトのデフォルト・ドキュメント情報の設定」ページが開きます。ここで、Site Studioで作成する新規プロジェクトのデフォルト・メタデータを割り当てます。

3. メタデータ値を指定したら、「更新」をクリックします。
これによって、「Site Studioの管理」ページに戻ります。ここでアップグレード・プロセスを開始できます。

4. 「Webサイトの管理」をクリックします。

5. Webサイト更新ページに移動をクリックします。(このオプションは、古いWebサイトが検出された場合にのみ表示されます。)

6. 「詳細オプション」をクリックして、サイトのアップグレード・オプション(図B-2)を指定します。

7. 「プロジェクト・ファイルの作成」を選択します。

注意:
これによってプロジェクト・ファイルがアップグレードされ、「Webサイト・セクション」メタデータ値が移入されます。

8. 「オプション設定」をクリックして「レガシーWebサイトのアップグレード」ページに戻ります。

9. 「アップグレードの開始」をクリックします。
アップグレード・プロセスが完了したことを示すメッセージが表示されるまで待ちます。

これで、コンテンツ・サーバーの「Webサイト」メニューにサイトがリストされます。

B.4 追加処理の手動実行

Webサイトのアップグレード後、手動で行う必要のある処理がまだいくつかあります。次のような処理です。

- B.4.1項「サイト・ナビゲーションの更新」

- B.4.2項「コンテンツ・サーバー索引の再作成」

- B.4.3項「カスタム・フラグメントの更新」

- B.4.4項「カスタム要素の更新」

- B.4.5項「フォルダへのWebサイト・セクションの割当て」

- B.4.6項「JSPコードの更新」

B.4.1 サイト・ナビゲーションの更新

7.5より前のWebサイトをアップグレードしたら、ナビゲーション・ファイルを更新する必要があります。これは、デザイナ(「ナビゲーションの更新」ボタン)または「Site Studioの管理」ページ(具体的には、「Webサイトの管理」ページ)で行えます。この処理は、コントリビュータがサイトで適切に機能するために必要です。

B.4.2 コンテンツ・サーバー索引の再作成

7.5より前のWebサイトをアップグレードしたら、コンテンツ・サーバーの索引を再作成する必要がある場合があります。コンテンツ・サーバーが、データベース検索および索引付け(全文またはメタデータのみ)を使用するよう設定されている場合、検索索引を再作成する必要はありません。別の検索エンジンを使用している場合、検索索引を再作成する必要があります。これが必要なのは、サイトのフォルダに存在するすべてのコンテンツ・アイテム用のxWebsiteSectionメタデータ・フィールドがSite Studioで更新されるためです。

注意:
Oracle Content Serverで管理されるコンテンツ・アイテムの数にもよりますが、検索索引の再索引には非常に時間がかかる場合があります。したがって、この再作成は、Oracle Content Serverの使用がオフピークのとき(通常、夜間または週末)に行うことをお薦めします。

索引の再作成の詳細は、Oracle Content Serverの管理ドキュメントを参照してください。

B.4.3 カスタム・フラグメントの更新

7.5より前のWebサイトのアップグレード後に行う必要のある手動更新のほとんどは、カスタム・フラグメントの変更に関係するものです。Site Studioに含まれる、あらかじめ定義されたフラグメントを現在使用している場合、これを行う必要がありません。これは、各フラグメントの更新版がSite Studioの各リリースに含まれているためです。

ほとんどの場合、組織の特定の目的に合せてフラグメントをカスタマイズしていたり、新しいものを導入していたりします。フラグメントが最新バージョンで機能するためにフラグメントに行う必要のある処理が3つあります。

- B.4.3.1項「<base>タグに依存するリンクの変更」

- B.4.3.2項「古いSS_GET_PAGE / JavaScriptリンクの変更」

- B.4.3.3項「GET_SEARCH_RESULTSの更新」

B.4.3.1 <base>タグに依存するリンクの変更

コンテンツ・サーバーのWebアクセス可能なディレクトリ(weblayout)を指す<base>は、使用されなくなりました。サイトのアップグレード時、Site Studioでレイアウト・ページおよびコントリビュータ・データ・ファイル内の必要なコードは更新されますが、カスタム・フラグメントとスクリプトではこの処理を手動で実行する必要があります。

これは、<base>タグのURLを基準とした、ハンドコードされたリンクを再作成して行うか、かわりにHttpRelativeWebRootサーバー側変数を使用します。

例

グラフィックへの次のようなリンクがあるとします。

<img src="groups/public/documents/adacct/logo.gif">

次ものと置き換える必要があります。

<img src="<!--$HttpRelativeWebRoot-->groups/public/documents/adacct/logo.gif">

B.4.3.2 古いSS_GET_PAGE / JavaScriptリンクの変更

既存のフラグメントでSS_GET_PAGE、javascript:linkまたはjavascript:nodelinkスタイル・ハイパーリンクを使用する場合、多くの利点を使用できるようパスベースのURLに変更することができます。(詳細は、『Oracle WebCenter Content Site Studio Designerユーザーズ・ガイド』を参照してください。)

例

次のようなリンクについて考えてみます。

<a href="javascript:nodelink(42);">link</a>

次のものと置き換える必要があります。

<a href="<!--ssServerRelativeSiteRoot-->products/servers/index.htm">link</a>

B.4.3.3 GET_SEARCH_RESULTSの更新

GET_SEARCH_RESULTSサービスを使用したフラグメントは引き続き機能しますが、SS_GET_SEARCH_RESULTSサービスを使用するようアップグレードされるまでSite Studio 7.5および10gR3で提供される機能は利用できません(詳細は、11.7.43項「SS_GET_SEARCH_RESULTS」を参照)。

SS_GET_SEARCH_RESULTSサービスを使用することには、いくつかの利点があります。

- limitscopeロジック(現在はサービスで提供され、フラグメントには不要): これは、検索結果を現在のWebサイト内のアイテムのみに限定します。

- dontshowinlistsロジック(現在はサービスで提供され、フラグメントには不要): これは、検索結果をコントリビュータによってリストから削除されていないアイテムのみに限定します。

- ssUrl: この列は、検索結果の各行にフレンドリURLを提供します。

GET_SEARCH_RESULTSサービスを使用するフラグメントは、通常動的リスト・フラグメントおよび検索結果ナビゲーション・フラグメントです。必要な更新は、Site Studioのアップグレード元のバージョンによって異なります。

- Site Studioバージョン6.5を使用し、そのバージョンを使用する動的リストまたは検索結果フラグメントをカスタマイズしていた(Site Studioフラグメントをコピーし、それにカスタム・コードを追加するなど)場合、古いxWebsiteIDメタデータ・フィールドを使用してlimitscopeロジックを実行するコードを使用します。

- Site Studioバージョン7.2を使用し、そのバージョンを使用する動的リストまたは検索結果フラグメントをカスタマイズしていた(Site Studioフラグメントをコピーし、それにカスタム・コードを追加するなど)場合、新しいxWebsitesメタデータ・フィールドを使用してlimitscopeロジックを実行するコードを使用します。また、新しいxDontShowInListsForWebsitesメタデータ・フィールドを使用してdontshowinlistsロジックを実行するコードを使用します。

前述のどちらの場合も、古いlimitscopeおよびdontshowinlistsロジックを削除し、この機能を内部で提供する、新しいSS_GET_SEARCH_RESULTSサービスを使用するよう更新する必要があります。

例

Site Studio 6.5では、標準動的リスト・フラグメントには、SSLimitScopeパラメータに対して次のコードが含まれます。これを削除します。

<!--$QueryText=eval(ssQueryText)-->
<!--$if ssLimitScope like "true"-->
<!--$if strEquals(QueryText, '')-->
<!--$QueryText='xWebSiteID=' & siteId-->
<!--$else-->
<!--$QueryText='(' & QueryText & ') and (xWebSiteID=' & siteId & ')'-->
<!--$endif-->
<!--$endif-->

Site Studio 7.2では、標準動的リスト・フラグメントには、SSLimitScopeパラメータに対して次のコードが含まれます。これを削除します。

<!--$QueryText=eval(ssQueryText)-->
<!--$if ssLimitScope like "true"-->
<!--$if strEquals(QueryText, '')-->
<!--$QueryText='xWebsites &lt;contains&gt; ' & siteId-->
<!--$else-->
<!--$QueryText='(' & QueryText & ') and (xWebsites &lt;contains&gt;' & siteId & ')'-->
<!--$endif-->
<!--$endif-->

<!--$if strEquals(QueryText, '')-->
<!--$QueryText= 'not(xDontShowInListsForWebsites &lt;contains&gt; ' & siteId & ')'-->
<!--$else-->
<!--$QueryText='(' & QueryText & ') and not(xDontShowInListsForWebsites &lt;contains&gt; ' & siteId & ')'-->
<!--$endif-->

古いlimitscopeロジックをフラグメントから削除したら、SS_GET_SEARCH_RESULTSを使用するようGET_SEARCH_RESULTSサービス・コールを変更します。ただし、SS_GET_SEARCH_RESULTSサービスを呼び出す前に、次のパラメータ値を設定する必要があります。

パラメータ

説明

ssLimitScope

limitscopeロジックがSS_GET_SEARCH_RESULTSサービスによって適用されることを指定します。通常、このtrue/false値は、フラグメント・パラメータ値によって指定されます。

ssDontShowInLists

dontshowinlistsロジックがSS_GET_SEARCH_RESULTSサービスによって適用されることを指定します。通常、このtrue/false値は、すべてのフラグメントでtrueに指定されます。

ssTargetNodeId

検索結果の表示に使用されるノードIDを指定します。ssTargetSiteIdは、コンテンツ・サーバー上の他のWebサイトへのリンクの生成にも使用できます。ssTargetSiteIdが指定されていない場合、生成されるリンクでは、リンクの生成元と同じサイトが想定されます。

ssTargetSiteId

検索結果の表示に使用されるサイトIDを指定します。ssTargetNodeIdパラメータは、ターゲット・ノードの完全修飾にも使用される必要があります。

ssSourceNodeId

リンクを含む現在のページのノードIDを示します。

ssSourceSiteId

リンクを含む現在のページのサイトIDを示します。

ssWebsiteObjectType

検索結果が特定のWebsiteオブジェクト・タイプに限定されることを指定します。通常、この値は空のままにします。

ssUserSearchText

完全テキスト検索を実行するユーザー・テキストを指定します。通常、これは、検索ボックス・フラグメントに値を入力するコンシューマによって値が指定される検索結果フラグメントにのみ適用されます。

SS_GET_SEARCH_RESULTSサービス・コールの結果をループする際、そのアイテムへのハイパーリンクを作成するには、通常検索結果の新規ssUrl列を使用します。これによって、わかりにくいIDベースのURLではなく、フルパスベースのURLが使用されます。

また、これらのURLは、リンクのソース場所を示すパラメータに追加されます。これによって、無効なリンクがあった場合にエラー・ページが適切に生成されます。

次のパラメータがURLに付加されます。

パラメータ

説明

ssSourceNodeId

ソース・ノードIDを宣言します。ssTargetNodeIdとxWebsiteSectionの両方が空の場合、フレンドリURLの生成に使用されます。

ssSourceSiteId

ソース・サイトIDを宣言します。これによって、ターゲット・ページが見つからない場合にエラー・ページが表示されます。

Idocスクリプトを使用した簡単な例を次に示します。

<!-- New params for SS_GET_SEARCH_RESULTS -->
<!--$ssLimitScope="true"-->
<!--$ssDontShowInLists="true"-->
<!--$ssTargetNodeId=""-->
<!--$ssTargetSiteId=""-->
<!--$ssSourceNodeId=nodeId-->
<!--$ssSourceSiteId=siteId-->
<!--$ssWebsiteObjectType=""-->
<!--$ssUserText=""-->

<!--$executeService("SS_GET_SEARCH_RESULTS")-->

<!--$loop SearchResults-->
<a href="<!--$ssUrl-->?ssSourceSiteId=<!--$siteId-->&ssSourceNodeId= <!--nodeId-->">
<!--$dDocTitle-->
</a><br><br>
<!--$endloop-->

詳細は、Site Studio製品に含まれている動的リスト・フラグメントおよび検索結果フラグメントを参照してください。

B.4.4 カスタム要素の更新

7.5より前のSite Studioを使用して作成されたカスタム要素フォームは、Site Studio 11gR1と互換性がありません。手動でアップグレードし、再作成する必要があります。下位互換性が維持されていない主な理由は、以前のSite StudioがInternet Explorerの独自仕様のwindow.external機能に依存している(コントリビュータに使用されているActiveXコントロールによる)ためです。Site Studio 10gR3 (10.1.3.3.3)以上で使用されているブラウザに依存しないJavaScriptベースのコントリビュータ・アプリケーションの結果、この機能はSite Studioから削除されました。

B.4.5 フォルダへのWebサイト・セクションの割当て

Site Studioでは、サイト階層の編成および管理を行うOracle Content Serverフォルダ機能(フォルダ・コンポーネント)は使用されなくなりました。7.5より前のSite Studioで作成されたWebサイトがアップグレードされる場合、アップグレードされたサイトの一部であると認識されるよう、フォルダ内のコンテンツに新規メタデータ値(Webサイト・セクション)が割り当てられます。

アップグレード後にフォルダに追加された新規コンテンツには、このメタデータ値は付加されません。したがって、フォルダを使用してサイトへのコンテンツの追加を続ける場合、各フォルダにWebサイト・セクションを割り当てる必要があります。

Webサイト・セクション値を割り当てるには、次のタスクを実行します。

1. 更新するフォルダへの書込み(RW)アクセス権を持つユーザーとしてコンテンツ・サーバーにログオンします。

2. 「コンテンツの参照」トレイまたはメニューを開き、「Webサイト」ツリーを開きます。

3. 更新するWebサイトを選択します。

4. 変更するフォルダの「フォルダ情報」をクリックします。

5. 「更新」アクションを選択します。

6. 「Webサイト・セクション」フィールドの隣にある「Browse」をクリックします。

7. 対応するWebサイト・セクションを選択します。

8. 「OK」をクリックします。

9. 「更新」をクリックします。

10. Site StudioでWebサイト・セクションにマップするフォルダごとにこの手順を繰り返します。

B.4.6 JSPコードの更新

SiteStudio.SSNavigationBeanおよびSiteStudio.SSNavigationNodeオブジェクトに基づいてJSPコードを作成した場合、これらのオブジェクトの参照を変更し、次のようにsitestudioをすべて小文字にする必要があります。

- sitestudio.SSNavigationBean

- sitestudio.SSNavigationNode

索引

A  B  C  D  E  F  G  H  I  J  K  L  M  N  O  P  Q  R  S  T  U  V  W  X  Z

記号

<convert>タグ

language属性, 6.7.3.4

<customgui>タグ

JavaScriptメソッド, 6.7.3.5

window.external.GetValue()メソッド, 6.7.3.5

window.external.OnCancel()メソッド, 6.7.3.5

window.external.OnOK()メソッド, 6.7.3.5

window.external.SetValue()メソッド, 6.7.3.5

<fragment>タグ

属性, 6.7.2

子タグ, 6.7.2

<element>子タグ, 6.7.6

<parameter>子タグ, 6.7.3

<snippet>子タグ, 6.7.4

<fragments>タグ

<fragment>子タグ, 6.7.1

<option>タグ

value属性, 6.7.3.1

<parameter>タグ

<convert>子タグ, 6.7.3.4

cssstyleパラメータ・タイプ, 6.7.3

<customgui>子タグ, 6.7.3.5

デフォルト値, 6.7.3

<option>子タグ, 6.7.3.1

<querytext>子タグ, 6.7.3.2

<validate>子タグ, 6.7.3.3

<snippet>タグ

<designview>子タグ, 6.7.5

<ssinfo> XMLデータ・アイランド

<fragmentinstance>タグ, 6.8

フラグメント・インスタンスとパラメータの構造, 6.8

<validate>タグ

language属性, 6.7.3.3

A

addNode()メソッド, 5.2.1

山カッコ, 4.2

Apache Webサーバー, A.5

ASPノード, 9.24

リージョン定義との関連付け, 7.3

非同期通信

カスタム要素と, 8.3.1

10gR4より前のプロジェクトの自動アップグレード, B.2 使用可能なコンテキスト, 15.1.2

B

<base>タグ, B.4.3.1

カッコ

山, 4.2

違い, 4.2

角, 4.2

ビルド・プロセス, 13.4.2

カスタマイズ, 13.4.6

シェルからの実行, 13.4.3

HTMLファイル, 13.4.2

最適化されたコード, 13.4.3

要件, 13.4.1

コマンドラインからの実行, 13.4.3

ビルド・スクリプトのデバッグ, 13.4.4 ビルド・システム, 13.4.1

C

子タグ, 6.7.2

クライアント側JavaScript, 6.6.1

コンソール・ウィンドウでの色分け, 15.5

コマンド・ウィンドウ, 15.1.2

使用可能なコンテキスト, 15.1.2

コンテキスト・フィールド, 15.1.2

JavaScriptの実行, 15.1.2

ツールバー, 15.1.2

コンポーネント・リソース, 5.2.1 構成

Apache, A.5

Sun ONE, A.6

ゾーン・フィールド, A.7

構成フラグ, 13.3.2.1, 17.2

DisableSiteStudioContribution, 12.2

ShowSiteStudioMissingDataFileErrors, 12.3

SiteStudioValidateConversionsDefinitions, 12.7

SiteStudioValidateDataFiles, 12.8

SiteStudioValidateElementDefinitions, 12.4

SiteStudioValidatePlaceholderDefinitions, 12.6

SiteStudioValidateProjects, 12.9

SiteStudioValidateRegionDefinitions, 12.5

SSAccessDeniedHeader, 12.10

SSAccessDeniedReplacementHeader, 12.11

SSAccessDeniedUserAgentExceptions, 12.12

SSAccommodateWelcomeFile, 12.13

SSAdditionalNavResultSetFields, 12.14

SSAddSecurityIDValues, 12.15

SSAfterProjectLoadedProperties, 12.16

SSAllowDynamicDefinitions, 12.17

SSAllowEmptyUrlPageName, 12.18

SSAllowNotModifiedHeader, 12.19

SSAltTagFieldName, 12.20

SSAlwaysRecordServerConfig, 12.21

SSAlwaysUseSiteIdInLinks, 12.22

SSAssumeXmlIsUtf8, 12.23

SSAutoCheckinBusyTimeout, 12.24

SSBackupCollectionName, 12.25

SSCacheControlOverride, 12.26

SSCanGenerateUniqueDataFiles, 12.27

SSChangeAccessDeniedHeaders, 12.28

SSCheckAssignedContentAccess, 12.29

SSCheckBrowserForSiteRoot, 12.30, 12.32

SSCheckNodeIdUniqueness, 12.31

SSClearDefinitionArchiveWebsites, 12.33

SSCompressorArguments, 12.34

SSCompressorCommand, 12.35

SSCompressorDir, 12.36

SSCompressorJar, 12.37

SSCompressorMainClass, 12.38

SSCompressorTimeout, 12.39

SSCompressorTimerInterval, 12.40

SSCompressorWaitForever, 12.41

SSContributorSourceDir, 12.42

SSCustomNodePropertyDefsPermissions, 12.43

SSDefaultDocumentsFields, 12.44

SSDefaultEditor, 12.45

SSDefaultExternalDocNamePrefix, 12.46

SSDefaultExternalDocNameSuffix, 12.47

SSDefaultExternalServerRelativeSiteRoot, 12.48

SSDefaultExternalUrlPrefix, 12.49

SSDefaultExternalUrlSuffix, 12.50

SSDefaultPlaceholderDefinition, 12.51

SSDefaultRegionTemplate, 12.52

SSDefaultUrlPageName, 12.53

SSDetectIncludeFileEncoding, 12.54

SSDICPlaceholderDefinition, 12.55

SSDirectDeliveryExtensions, 12.56

SSDirectDeliveryOverrideProperty, 12.57

SSDirectDeliveryProperty, 12.58

SSDirectDeliveryRequiredExtensions, 12.59

SSDisableDeferredNodeExpansion, 12.60

SSDisableIncludeXmlCache, 12.61

SSDisableLinkResolutionSiteLocking, 12.62

SSDisableProjectDeferredNodeExpansion, 12.63

SSDomCacheDefaultFileSizeFactor, 12.64

SSDomCacheFileSizeFactors, 12.65

SSDomCacheLowerBound, 12.66

SSDomCacheMultiplier, 12.67

SSDomCacheNodeMultiplier, 12.68

SSDomCacheStringMultiplier, 12.69

SSDomCacheStringOverhead, 12.70

SSDomCacheUseDOM, 12.71

SSDomCacheUseFileSize, 12.72

SSEditorDebugLevel, 12.73

SSEnableASPSupport, 12.74

SSEnableDirectDelivery, 12.75

SSEnableExtranetLookCompatibility, 12.76

SSEnableFolioEditing, 12.77

SSEnableFormEditing, 12.78

SSEnableJavaScriptCompressor, 12.79

SSEnableUpperCaseColumnsCheck, 12.80

SSGenerateUniqueNodeIds, 12.81

SSHidePrimaryFileInContributor, 12.82

SSHttpAbsoluteHelpRoot, 12.83

SSHttpLayerManager, 12.84

SSIdocMarker, 12.85

SSIgnoreMaxAgeNodeProperties, 12.86

SSIgnoreNoProjectDefaultMetadataMessage, 12.87

SSIgnoreReadyToReplicate, 12.88

SSImportOnlyLatestRevs, 12.89

SSIncludeInactiveNodesInNavResultSet, 12.90

SSIncludeInactiveNodesInNavXML, 12.91

SSIncludeRegionTemplatesInDefinitionBundles, 12.92

SSIncludeXmlTransformFormat, 12.93

SSIncludeXmlTransformIndent, 12.94

SSJavaExecutablePath, 12.95

SSJSONContentType, 12.96

SSLoadCustomElementsWithOnDemandEditors, 12.97

SSLoadProjectsAtStartup, 12.98

SSLoadUncompressedFckSource, 12.99

SSManuallyValidateNodeIdUniqueness, 12.100

SSMaxNodeIdLength, 12.101

SSMaxSiteIdLength, 12.102

SSMaxSitesMenuItems, 12.103

SSMaxTemplateEvaluationStack, 12.104

SSMigrationCollectionName, 12.105

SSOmitFragmentLibrariesInArchiverQueries, 12.106

SSOnDemandEditorsThresholdCount, 12.107

SSPrefillUrlDirNamesDuringUpgrade, 12.108

SSProjectAutoCheckinInterval, 12.109

SSProjectLoadFailureTracingSection, 12.110

SSProjectReleaseSleepTime, 12.111

SSProjectReleaseWaitTime, 12.112

SSQuickDiffDefaultRegionTemplate, 12.113

SSShowAssignmentTooltips, 12.114

SSSQLUseContains, 12.115

SSStoppedSiteResponsePageDocName, 12.116

SSSuppressAddToWebsite, 12.117

SSSuppressLargeCssOptimization, 12.118

SSTempProjectLifetime, 12.119

SSTitleTagFieldName, 12.120

SSTrackContentAccess, 12.121

SSTrackFragmentAccess, 12.122

SSUrlFieldName, 12.123

SSUrlFixupExceptions, 12.124

SSUrlPageNames, 12.125

SSUseAbsoluteRedirects, 12.126

SSUseCallbackTrackingForASP, 12.127

SSUseDefaultDocNamePrefix, 12.128

SSUseDefaultServerRelativeSiteRoot, 12.129

SSUseDefaultUrlPrefix, 12.130

SSUseMissingLinkTargetFallback, 12.131

SSUseOnDemandContributionModeMenus, 12.132

SSUseUrlSegmentSessionInfo, 12.133

SSValidateCustomElements, 12.134

SSWebFilterIgnoreList, 12.135

SSWeblayoutUrlUsesDocNames, 12.136

SSWelcomeFile, 12.137

SSWelcomeFileReplacement, 12.138

コンソール・ウィンドウ, 14.2

使用可能なコンテキスト, 15.1.2

子, 15.4.2

色分け, 15.5

コマンド・ウィンドウ, 15.1.2

コンテキスト, 15.1.2

ルート・ウィンドウとしての確立, 15.4.3

ヘルパー関数, 15.7

インストール, 15.2

キーボード・コマンド, 15.8

コントリビュータからの起動, 15.3

ロギング・タイプ, 15.1.1, 15.5, 15.7

ロギング・ウィンドウ, 15.1.1, 15.1.1

孤立, 15.4.4

ルート・コンテキスト, 15.4.4

ルート・ウィンドウ, 15.4.2

時間プロファイリング, 15.6

URL, 15.4.3

コンテンツ・アクセス, 17.1, 17.2 コンテンツの再利用

ルール, 11.7.38

コンテンツ・サーバー

フォルダ機能, B.3

JSP, A.8, A.8

最小サイト・アップグレード, B.3.4

コンテンツ・サーバー・サービス

SS_ADD_NODE, 11.7.1

SS_ADD_WEBSITE_ID, 11.7.2

SS_BATCH_DECODE_LINK, 11.7.3

SS_CHECKIN_FRAGMENT_LIBRARY, 11.7.4

SS_CHOOSE_WEBSITE_SECTION, 11.7.5

SS_CHOOSE_WEBSITES, 11.7.6

SS_CLEAR_PREVIEW, 11.7.7

SS_CLEAR_REGION_ASSOCIATIONS, 11.7.8

SS_CLEAR_WEBSITE_ID, 11.7.9

SS_COMMIT_SITE_CHANGES, 11.7.10

SS_CREATE_NEW_SITE_EX2, 11.7.11

SS_CREATE_SITE_NAV_JS, 11.7.12

SS_DECODE_LINK, 11.7.13

SS_DELETE_NODE, 11.7.14

SS_DOC_INFO_LATEST, 11.7.15

SS_EDIT_NATIVE_DOCUMENT, 11.7.16

SS_GET_ADMIN_PAGE, 11.7.17

SS_GET_ALL_CUSTOM_NODE_PROP_DEFS, 11.7.18

SS_GET_ALL_NODE_PROPERTIES, 11.7.19

SS_GET_ALL_SITE_DOMAINS, 11.7.20

SS_GET_ALL_SITE_PROPERTIES, 11.7.21

SS_GET_ALL_SITES_EX2, 11.7.22

SS_GET_CONFIG_INFO, 11.7.23

SS_GET_CONTRIBUTOR_CONFIG, 11.7.24

SS_GET_CONTRIBUTOR_STRINGS, 11.7.25

SS_GET_DC_RULES, 11.7.26

SS_GET_DOCUMENT_LABELS, 11.7.27

SS_GET_DOCUMENT_USAGE, 11.7.28

SS_GET_ENVIRONMENT_PROPERTY_NAMES, 11.7.29

SS_GET_FIRST_NODE_ID, 11.7.30

SS_GET_FRIENDLY_URL, 11.7.31

SS_GET_LINK, 11.7.32

SS_GET_LINK_MANAGEMENT_REPORT, 11.7.33

SS_GET_LINK_WIZARD_CONFIG, 11.7.34

SS_GET_LINK_WIZARD_CONFIG_WITH_SITE, 11.7.35

SS_GET_NODE_LINK, 11.7.36

SS_GET_NODE_PROPERTY, 11.7.37

SS_GET_PAGE, 11.7.38, 11.7.38

SS_GET_PLACEHOLDER_SWITCH_CONTENT_CONFIG, 11.7.39

SS_GET_REGION_ASSOCIATIONS, 11.7.40

SS_GET_REGION_DEFINITION_ELEMENTS, 11.7.41

SS_GET_RELATIVE_NODE_ID, 11.7.42

SS_GET_SEARCH_RESULTS, 11.7.43

SS_GET_SITE_AS_XML_EX2, 11.7.44

SS_GET_SITE_ASSET_CATEGORIES, 11.7.45

SS_GET_SITE_CHANGE_MONITOR_TOKEN, 11.7.46

SS_GET_SITE_DEFINITION, 11.7.47

SS_GET_SITE_DEFINITION_FOR_USER, 11.7.48

SS_GET_SITE_DOMAINS, 11.7.49

SS_GET_SITE_FRAGMENT_ASSET_REPORT, 11.7.50

SS_GET_SITE_INFO, 11.7.51

SS_GET_SITE_PROPERTY, 11.7.52

SS_GET_SITE_PUBLISH_REPORT, 11.7.53

SS_GET_SITE_REPORT, 11.7.54

SS_GET_SWITCH_CONTENT_CONFIG, 11.7.55

SS_GET_UNIQUE_NODE_SITE_ID, 11.7.56

SS_GET_VERSION, 11.7.57

SS_GET_WEBLAYOUT_URL, 11.7.58

SS_IS_JS_NAV_OUT_OF_DATE, 11.7.59

SS_MAP_FRIENDLY_NAME, 11.7.60

SS_MOVE_NODE, 11.7.61

SS_PARSE_FRIENDLY_URL, 11.7.62

SS_PREPARE_PREVIEW, 11.7.63

SS_PUBLISH_THIS_PAGE, 11.7.64

SS_REMOVE_WEBSITE_ID, 11.7.65

SS_SET_ALL_CUSTOM_NODE_PROP_DEFS, 11.7.66

SS_SET_ELEMENT_DATA, 11.7.67

SS_SET_ENVIRONMENT_PROPERTY_NAMES, 11.7.68

SS_SET_NODE_PROPERTY, 11.7.69

SS_SET_NODES_PROPERTIES, 11.7.70

SS_SET_PREVIEW_ELEMENT_DATA, 11.7.71

SS_SET_SITE_ASSET_CATEGORIES, 11.7.72

SS_SET_SITE_DOMAINS, 11.7.73

SS_SET_SITE_PROPERTIES, 11.7.74

SS_SET_SITE_PROPERTY, 11.7.75

SS_SWITCH_REGION_ASSOCIATION, 11.7.76

SS_VALIDATE_WEBSITE_OBJECT, 11.7.77

WCM_BEGIN_EDIT_SESSION, 11.7.80

WCM_EDIT_DATA_FILE, 11.7.79

WCM_PLACEHOLDER, 11.7.78

Content Tracker, 17

データ・エンジン・コントロール・センター, 17

Content Tracker

追跡対象データ, 17.1

コンテキスト, 15.4.1

ファイル名, 15.1.2

コンテキスト・フィールド, 15.1.2

コマンド・ウィンドウ, 15.1.2

コードの実行, 15.1.2

ツールバー内, 15.1.2

コンテキストID

コマンド・ウィンドウ, 15.1.2

コントリビューション・モード

キー・コマンド, 2.7.1

コントリビューション・モード

問合せ文字列, 2.7.2

セッションCookie, 2.7.3

コントリビューション・リージョン

フラグメント定義ファイル, 6.7

コントリビュータ

JSON, 14.1

コンテキスト, 15.4.1

オンデマンド・エディタの有効化, 13.3.2.1

コンテキストでのコードの実行, 15.1.2

ビルド・システムの使用, 13.4.1

コントリビュータ・コンソール・ウィンドウ, 15.1

コマンド・ウィンドウ, 15.1.2

コンテキスト, 15.4.1

コンテキスト, 15.3

ルート・ブラウザ・ウィンドウの確立, 15.4.2

キー・コマンド, 15.3, 15.3

新規ブラウザ・ウィンドウの起動, 15.4.2

ロギング・ウィンドウ, 15.1

孤立したウィンドウ, 15.4.2

ルート・ブラウザ・ウィンドウ, 15.4.2

ルート・コンテンツ, 15.3

URL, 15.3, 15.3

ユーザー・インタフェース, 15.1.3

コントリビュータ・フォーム, 8.2, 8.3

カスタム要素との通信, 8.3.1

登録されている関数, 8.3.1

コントリビュータ・モード

SSContributorパラメータ, 11.7.38

コントリビュータ・サービス

SS_ADD_WEBSITE_ID, 11.7.2

SS_CHOOSE_WEBSITE_SECTION, 11.7.5

SS_CHOOSE_WEBSITES, 11.7.6

SS_CLEAR_PREVIEW, 11.7.7

SS_DECODE_LINK, 11.7.13

SS_EDIT_NATIVE_DOCUMENT, 11.7.16

SS_GET_CONFIG_INFO, 11.7.23

SS_GET_CONTRIBUTOR_CONFIG, 11.7.24

SS_GET_CONTRIBUTOR_STRINGS, 11.7.25

SS_GET_DOCUMENT_USAGE, 11.7.28

SS_GET_FRIENDLY_URL, 11.7.31

SS_GET_PLACEHOLDER_SWITCH_CONTENT_CONFIG, 11.7.39

SS_GET_SEARCH_RESULTS, 11.7.43

SS_GET_SWITCH_CONTENT_CONFIG, 11.7.55

SS_PUBLISH_THIS_PAGE, 11.7.64

SS_REMOVE_WEBSITE_ID, 11.7.65

SS_SET_ELEMENT_DATA, 11.7.67

SS_SET_PREVIEW_ELEMENT_DATA, 11.7.71

変換定義

xWebsiteObjectType値, 3.2.1

変換定義プロパティ, 7.4 変換ルール

wcmDynamicConversion, 7.3

<convert>タグ, 6.7.3.4 CSS

メタデータ, 3.2.1

最適化, 13.4.2

最適化, 13.4

カスタム構成スクリプト

xWebsiteObjectType値, 3.2.1

カスタム要素, 8.1, 12.134

レガシー・フォームの検出, 8.4.1

ElementAPI, 8.2

コントリビュータ・フォーム内, 8.2.1

レガシーの互換性, 8.4

メタデータ, 3.2.1

レガシー・カスタム要素のアップグレード, 8.4.2

検証, 12.134

カスタム要素フォーム, 12.134

xWebsiteObjectType値, 3.2.1

カスタム要素, B.4.4

非同期通信, 8.3.1

依存スクリプト, 8.2.2

ElementAPI, 8.2.2

カスタム・フラグメント, B.4.3 カスタム・ノード・プロパティ, 9.23 カスタム・セクション・プロパティ

sitenavigation.xmlファイル, 6.6.2

カスタム・セクション・プロパティ, 6.6

値へのアクセス, 6.6

クライアント側JavaScriptを使用したアクセス, 6.6.1

サーバー側JavaScriptを使用したアクセス, 6.6.2

<customgui>タグ, 6.7.3.5

D

データ・バインダの概念, 14.2

データ・バインダの形式

JSON, 14.2

データ・エンジン・コントロール・センター, 17, 17 データ・ファイル

xWebsiteObjectType値, 3.2.1

データ転送

JSON, 14.2

デバッグ

ビルド・スクリプト, 13.4.4

デフォルト・プロジェクト・ドキュメント情報, A.4 定義

要素定義, 2.3.3

定義

リージョン定義, 2.3.2

依存スクリプト

ElementAPI, 8.2.2

デザイナ・サービス

SS_ADD_NODE, 11.7.1

SS_ADD_WEBSITE_ID, 11.7.2

SS_CHECKIN_FRAGMENT_LIBRARY, 11.7.4

SS_CLEAR_PREVIEW, 11.7.7

SS_COMMIT_SITE_CHANGES, 11.7.10

SS_CREATE_NEW_SITE_EX2, 11.7.11

SS_CREATE_SITE_NAV_JS, 11.7.12

SS_DELETE_NODE, 11.7.14

SS_DOC_INFO_LATEST, 11.7.15

SS_EDIT_NATIVE_DOCUMENT, 11.7.16

SS_GET_ADMIN_PAGE, 11.7.17

SS_GET_ALL_CUSTOM_NODE_PROP_DEFS, 11.7.18

SS_GET_ALL_SITE_DOMAINS, 11.7.20

SS_GET_ALL_SITE_PROPERTIES, 11.7.21

SS_GET_ALL_SITES_EX2, 11.7.22

SS_GET_CONFIG_INFO, 11.7.23

SS_GET_DC_RULES, 11.7.26

SS_GET_DOCUMENT_USAGE, 11.7.28

SS_GET_ENVIRONMENT_PROPERTY_NAMES, 11.7.29

SS_GET_FRIENDLY_URL, 11.7.31

SS_GET_NODE_PROPERTY, 11.7.37

SS_GET_PAGE, 11.7.38

SS_GET_REGION_DEFINITION_ELEMENTS, 11.7.41

SS_GET_SEARCH_RESULTS, 11.7.43

SS_GET_SITE_AS_XML_EX2, 11.7.44

SS_GET_SITE_ASSET_CATEGORIES, 11.7.45

SS_GET_SITE_CHANGE_MONITOR_TOKEN, 11.7.46

SS_GET_SITE_DEFINITION, 11.7.47

SS_GET_SITE_DEFINITION_FOR_USER, 11.7.48

SS_GET_SITE_DOMAINS, 11.7.49

SS_GET_SITE_FRAGMENT_ASSET_REPORT, 11.7.50

SS_GET_SITE_INFO, 11.7.51

SS_GET_SITE_PROPERTY, 11.7.52

SS_GET_SITE_REPORT, 11.7.54

SS_GET_UNIQUE_NODE_SITE_ID, 11.7.56

SS_GET_VERSION, 11.7.57

SS_IS_JS_NAV_OUT_OF_DATE, 11.7.59

SS_MAP_FRIENDLY_NAME, 11.7.60

SS_MOVE_NODE, 11.7.61

SS_PARSE_FRIENDLY_URL, 11.7.62

SS_PREPARE_PREVIEW, 11.7.63

SS_REMOVE_WEBSITE_ID, 11.7.65

SS_SET_ALL_CUSTOM_NODE_PROP_DEFS, 11.7.66

SS_SET_ENVIRONMENT_PROPERTY_NAMES, 11.7.68

SS_SET_NODE_PROPERTY, 11.7.69

SS_SET_NODES_PROPERTIES, 11.7.70

SS_SET_SITE_ASSET_CATEGORIES, 11.7.72

SS_SET_SITE_DOMAINS, 11.7.73

SS_SET_SITE_PROPERTIES, 11.7.74

SS_SET_SITE_PROPERTY, 11.7.75

SS_SWITCH_REGION_ASSOCIATION, 11.7.76

SS_VALIDATE_WEBSITE_OBJECT, 11.7.77

<designview>タグ, 6.7.5 管理対象ファイルのWebアドレスの特定, 9.40 ネイティブ・ドキュメントの特定, 9.21 ダイアログ

メタデータ変更の有効化, 2.3.2

プレースホルダ定義, 2.3.1

リージョン・コンテンツ・オプション, 2.3.2

リージョン・コンテンツの切替え, 2.3.2

DisableSiteStudioContribution, 12.2 ランタイム・エラーの表示, 15.3 DOC_INFOキャッシュ, 13.5.2, 13.5.2 DOM, 13.5.2, 13.5.3 動的変換, 7.3

インライン, 9.20

ssIncludeDynamicConversion, 9.17

ssIncInlineDynamicConversionの使用, 9.18, 9.19, 9.20

ssIsNativeDocの使用, 9.21

Dynamic Converter

ネイティブ・ドキュメントの変換, 7.2

E

Edge Side Includes, 11.7.78

要素

管理対象XMLファイルからの抽出, 9.14, 9.14

要素コンテキスト, 9.9 要素定義, 2.3.3

xWebsiteObjectType値, 3.2.1

<element>タグ, 6.7.6 ElementAPI

依存スクリプト, 8.2.2

ロード, 8.2.1

ElementAPIオブジェクト, 8.2 要素, カスタムの更新, B.4.4 「メタデータ変更の有効化」ダイアログ, 2.3.2 コンテンツ・サーバーでのJSPの有効化, A.8, A.8 エラー・ハンドラ・ページ

siteRelativeUrl, 17.1

エラー・ハンドラ・セクション, 11.7.38 エスケープの問題

山カッコと大カッコ, 4.2

回避, 4.2, 4.3.1

一重引用符と二重引用符, 4.3.1

ルート・ブラウザ・ウィンドウの確立, 15.4.2 マネージャ設定ファイルの例, 16.13 要素の抽出, 9.14

F

ファイル・サイズ乗数, 13.5.2, 13.5.3

フィルタ, 15.1.1

フラグ

SSXPathCacheEntryキャッシュの制御, 13.5.3

DOC_INFOキャッシュ, 13.5.2

SSComputeDocInfoCacheSize, 13.5.2

SSContributorSourceDir, 13.4.5

SSDisableDeferredNodeExpansion, 13.5.1

SSDocInfoCacheCellOverhead, 13.5.2

SSDocInfoCacheColumnOverhead, 13.5.2

SSDocInfoCacheLowerBound, 13.5.2

SSDocInfoCacheMultiplier, 13.5.2

SSDocInfoCacheRowOverhead, 13.5.2

SSDocInfoCacheStringMultiplier, 13.5.2

SSDocInfoCacheStringOverhead, 13.5.2

SSDomCacheDefaultFileSizeFactor, 13.5.3

SSDomCacheFileSizeFactors, 13.5.3

SSDomCacheLowerBound, 13.5.3

SSDomCacheMultiplier, 13.5.3

SSDomCacheNodeMultiplier, 13.5.3

SSDomCacheStringMultiplier, 13.5.3

SSDomCacheStringOverhead, 13.5.3

SSDomCacheUseDOM, 13.5.3

SSDomCacheUseFileSize, 13.5.3

SSOnDemandEditorsThresholdCount, 13.3.2.1

SSTrackContentAccess, 17.2

SSTrackerReportNumDaysBack, 17.2

SSTrackFragmentAccess, 17.2

フラグ, 13.3.2.1

コンテンツ・トラッカ, 17.2

コンテンツ・サーバー上のフォルダ, B.1, B.3 Oracle Content Server上のフォルダ, B.4.5 データ・ファイル関連付けの強制, 9.9 フラグメント

アセット, 6.1, 6.1, 6.2

複雑, 6.1

コンテンツ, 6.1

説明, 6.1

ライブラリ, 6.2

パラメータ定義, 6.1

単純, 6.1

スニペット, 6.1, 6.5

構造, 6.2

wcmFragment, 9.12

xWebsiteObjectType値, 3.2.1

フラグメント定義ファイル, 6.2, 6.7

<fragment>要素, 6.2

<fragments>ルート要素, 6.2

<fragments>タグ, 6.7.1

フラグメント・ライブラリ, 17.2 フラグメント・ライブラリ, 6.2, 6.7.1

コンテンツ・サーバーへの追加, 6.2

フラグメント定義ファイル, 6.2

フラグメント・パラメータ, 6.1 フラグメント・スニペット, 6.1, 6.5

参照によるレイアウト・ページへの追加, 6.5

特殊なマークアップによるレイアウト・ページへの直接追加, 6.5

オプションの設計時ビュー, 6.7.5

<fragment>タグ, 6.7.1 <fragmentinstance>タグ, 6.8 fragments

フォルダの場所, 10.4, 10.5

<fragments>タグ, 6.7.1 フラグメント, カスタムの更新, B.4.3 完全サイト・アップグレード, B.3.3 全文テキスト索引付け, A.7

G

GET_SEARCH_RESULTSサービス, B.4.3.3, B.4.3.3

グラフィック・ファイル

メタデータ値, 3.2.1

H

コンソール・ウィンドウでのヘルパー関数, 15.7

階層

Webサイト, 9.31

階層アクセス, 17.2

コンテンツ・トラッカ, 17.2

HttpASPPath, 10.7 HttpFragmentsRoot, 6.2, 10.4 HttpRelativeFragmentsRoot, 6.2, 10.5 HttpRelativeWebsitesRoot, 10.3 HttpWebsitesRoot, 10.2

I

Idocスクリプト, 9.1

カスタム・セクション・プロパティの値へのアクセス, 6.6.2

サーバー側, 6.6.2

SS_GET_ALL_NODE_PROPERTIESサービス, 6.6.2

ssGetNodeProperty (name), 6.6.2

ssGetNodeProperty (nodeId, name), 6.6.2

wcmPlaceholder, 9.2

Idocスクリプト

動的変換, 7.4

ssGetAllSites, 9.37

ssGetCoreMajorVersion, 9.25

ssGetDocINfo, 9.15

ssGetFirstNodeId, 9.29

ssGetNodeLabel, 9.35

ssGetNodeLabelPath, 9.36

ssGetNodeProperty, 9.23

ssGetRelativeNodeId, 9.30

ssGetServerRelativePath, 9.33

ssGetServerRelativeUrl, 9.32

ssGetSiteProperty, 9.28

ssGetUrlPageName, 9.34

ssGetWebsiteName, 9.27

ssGetWebsiteNodeType, 9.24

ssGetXmlNodeCount, 9.16

ssIncInlineDynamicConversion, 9.18, 9.19, 9.20

ssIncludeDynamicConversion, 9.17

ssIncludeXml, 9.14

ssIsNativeDoc, 9.21

ssLink, 9.38

ssLoadSiteNavResultSet, 9.31

ssNodeLink, 9.39

ssRandom, 9.22

ssSplitString, 9.26

ssWeblayoutUrl, 9.40

wcmDynamicConversion, 9.10

wcmDynamicList, 9.8

wcmElement, 9.3

wcmFragment, 9.12

wcmGetListAsResultSet, 9.11

wcmIncludeElement, 9.9

wcmListElement, 9.6

wcmListEnd, 9.5

wcmListRowCount, 9.7

wcmListStart, 9.4

wcmUrl, 9.13

Idocスクリプト拡張機能, 9 Idoc変数

エラー情報の表示, 11.7.38

Idoc変数, 10

HttpASPPath, 10.7

HttpFragmentsRoot, 10.4

HttpRelativeFragmentsRoot, 10.5

HttpRelativeWebsitesRoot, 10.3

HttpWebsitesRoot, 10.2

SS_SERVER_NAME, 10.6

ssServerRelativeSiteRoot, 10.8

イメージ

xWebsiteObjectType値, 3.2.1

インストール

Apache Webサーバー, A.5

ApacheSun ONE構成, A.5

デフォルト・プロジェクト・ドキュメント情報, A.4

コンテンツ・サーバーでのJSPの有効化, A.8, A.8

Sun ONE構成, A.6

Sun ONE Webサーバー, A.6

ゾーン・フィールド, A.7

コンソール・ウィンドウのインストール, 15.2 内部Webサイト情報構造, 12.62 invalidSiteRelativeUrl, 17.1 IsDirty()関数, 8.3.1

J

JavaScript

自動生成ファイル, 5.1

クライアント側, 6.6.1

コードの実行, 15.4

複数ウィンドウでのコードの実行, 15.1

ElementAPI, 8.3.2

カスタム・セクション・プロパティの値へのアクセス, 6.6.1

メソッド, 6.6.1

コントリビューション機能を提供するメソッド, 5.3

最適化, 13.4.2

最適化, 13.4

sitenavigation.js, 5.2.1, 5.2.2

wcm.toggle.js, 5.3

JavaScriptコード

コマンド・ウィンドウ内, 15.1.2

JavaScriptインタープリタ, 13.4.2 JavaScript Object Notation, 14.1 JavaScript WCMライブラリ, 8.2.2 JavaServer Pages (JSP), A.8, A.8, B.4.6 JDK, 13.4.1 JPSが有効なグループ, A.8 JSON

渡されるコードの例, 14.2

JSP, A.8, A.8, B.4.6

K

キー・コマンド

コントリビューション・モード, 2.7.1

セッションCookie, 2.7.3

キー・コマンド, 15.3, 15.3, 15.3

L

レイアウト・ページ

特殊なマークアップによるフラグメントの追加, 6.5

スニペットの直接追加, 6.5

複雑なフラグメント, 6.1

<fragmentinstance>タグ, 6.8

フラグメント・スニペットの参照, 6.5

適切なものの提供, 11.7.38

単純なフラグメント, 6.1

レガシー・プロジェクト, B リンク形式

wcmUrlの使用, 9.13

リンク・ウィザード・サービス

SS_ADD_WEBSITE_ID, 11.7.2

SS_DECODE_LINK, 11.7.13

SS_GET_CONTRIBUTOR_STRINGS, 11.7.25

SS_GET_FRIENDLY_URL, 11.7.31

SS_GET_LINK_WIZARD_CONFIG, 11.7.34

SS_GET_LINK_WIZARD_CONFIG_WITH_SITE, 11.7.35

SS_GET_SITE_DEFINITION_FOR_USER, 11.7.48

sitenavigation.jsのlink()メソッド, 5.2.2 リンク

<base>タグ, B.4.3.1

SS_GET_PAGE, B.4.3.2

ElementAPIのロード, 8.2.1 ロック競合, 12.62 ロギングと時間プロファイリング, 15.6 ロギング命令

コンテキスト, 15.3

ロギング時間, 15.6 ロギング・タイプ, 15.1.1, 15.5, 15.7 ロギング・ウィンドウ, 15.1.1

フィルタ, 15.1.1

ロギング・タイプ, 15.1.1

ツールバー, 15.1.1

M

m_hrefノード・プロパティ, 5.2.1

m_idノード・プロパティ, 5.2.1

m_labelノード・プロパティ, 5.2.1

m_levelノード・プロパティ, 5.2.1

m_parentノード・プロパティ, 5.2.1

m_subNodesノード・プロパティ, 5.2.1

管理対象XMLファイル, 要素の抽出, 9.14

マネージャ・サービス

SS_ADD_NODE, 11.7.1

SS_DELETE_NODE, 11.7.14

SS_GET_ALL_CUSTOM_NODE_PROP_DEFS, 11.7.18

SS_GET_SEARCH_RESULTS, 11.7.43

SS_GET_SITE_DEFINITION_FOR_USER, 11.7.48

SS_GET_SITE_PROPERTY, 11.7.52

SS_MOVE_NODE, 11.7.61

SS_SET_NODE_PROPERTY, 11.7.69

SS_SET_SITE_PROPERTY, 11.7.75

マネージャ設定

xWebsiteObjectType, 3.2.1

マネージャ設定ファイル

例, 16.13

マネージャ設定ファイル, 16.1 マネージャ設定ファイルの子タグ

<ssm:addSection>, 16.4

<ssm:editCustomProperties>, 16.9

<ssm:editProperties>, 16.8

<ssm:general>, 16.3

<ssm:moveSection>, 16.6

<ssm:primaryLayout>, 16.10

<ssm:removeSection>, 16.5

<ssm:secondaryLayout>, 16.11

<ssm:sectionOverride>, 16.12

<ssm:setErrorHandler>, 16.7

メモリー使用量, 13.5 メタデータ

変換定義, 3.2.1

CSS, 3.2.1

カスタム構成スクリプト, 3.2.1

カスタム要素フォーム, 3.2.1

カスタム・フィールド, 3.2

データ・ファイル, 3.2.1

dataProperty, 2.3.2

要素定義, 3.2.1

フラグメント, 3.2.1

イメージ, 3.2.1

マネージャ設定, 3.2.1

ネイティブ・ドキュメント, 3.2.1

その他, 3.2.1

ページ・テンプレート, 3.2.1

プレースホルダ定義, 3.2.1

プロジェクト・ファイル, 3.2.1

リージョン定義, 3.2.1

リージョン・テンプレート, 3.2.1

スクリプト, 3.2.1

スタイルシート, 3.2.1

サブテンプレート, 3.2.1

検証スクリプト, 3.2.1

xRegionDefinition, 2.3.2

メタデータ・フィールド

xDontShowListForWebsites, 3.2.4

xWebsiteObjectType, 3.2.1

xWebsites, 3.2.3

メタデータ・フィールド

リージョン定義, 3.2.5

Webサイト・セクション, B.4.5

Site Studioのメタデータ・フィールド, A.7 プロジェクト・ファイルのメタデータ・フィールド, A.4 最小サイト・アップグレード, B.3.4 最小アップグレード, B.3.4 複数コンテンツ・サーバー, サイトのアップグレード, B.3.2

N

NameTrans (Sun ONE Webサーバー), A.6

ネイティブ・ドキュメント

動的変換, 9.17

xWebsiteObjectType値, 3.2.1

ネイティブ・ドキュメント

Dynamic Converter, 7.2

一般的なエラー, 7.4

変換定義, 7.4

動的変換, 7.3

実装7.4

変換でのIdocスクリプトの使用, 7.4

ssIncInlineDynamicConversionの使用, 9.18, 9.19, 9.20

ssIncludeDynamicConversionの使用, 9.17

ssIsNativeDocの使用, 9.21

wcmDynamicConversionの使用, 7.3

wcmDynamicConversion, 9.10

ナビゲーション・リンク, SS_GET_PAGEサービス, 11.7.38 サイトでのナビゲーション, B.4.1 NavNodeオブジェクト

addNode(), 5.2.1

定義, 5.2.1

m_href, 5.2.1

m_id, 5.2.1

m_label, 5.2.1

m_level, 5.2.1

m_parent, 5.2.1

m_subNodes, 5.2.1

ノード・プロパティ, 9.23 ノード，「セクション」を参照 nodeId

パラメータ, 11.7.38

nodelink(), 5.2.2

O

オンデマンド・エディタ, 13.3.2.1

オンデマンドWebサイト, 13.2

最適化

ビルド・プロセス, 13.4.3

ビルド・システム, 13.4.1

要件, 13.4.1

最適化

コントリビュータ・コード, 13.4, 13.4.2

CSSとJavaScriptの最適化, 13.4 JavaScriptとCSSの最適化, 13.4.2 <option>タグ, 6.7.3.1 Oracle Content Server

フォルダ機能, B.1, B.4.5

完全サイト・アップグレード, B.3.3

検索索引, B.4.3

レガシー・プロジェクトのアップグレード, B.3

サイトのアップグレード, B.3.1, B.3.2

originalSiteRelativeUrl, 17.1 孤立したコンソール・ウィンドウ, 15.4.4 孤立したコントリビュータ・コンソール・ウィンドウ, 15.4.2 other

xWebsiteObjectType, 3.2.1

P

ページ・テンプレート

xWebsiteObjectType値, 3.2.1

ページ・テンプレート, 2.2.1 パラメータ

ssDocName, 11.7.38

ssSourceNodeId, 11.7.38

ssTargetNodeId, 11.7.38

<parameter>タグ, 6.7.3 パス・ベースのURL, 10.8

ssLinkの使用, 9.38

ssNodeLinkの使用, 9.39

パス・ベースのURL, A.5, B.4.3.2 プレースホルダ定義

定義

プレースホルダ定義, 2.3.1

サンプル・コード, 2.3.1 xWebsiteObjectType値, 3.2.1 「プレースホルダ定義」ダイアログ, 2.3.1 プレースホルダ, 2.2.1 PreviewIdパラメータ, 11.7.38 プライマリ・ページ, 2.2.1 プロジェクト・ファイル

xWebsiteObjectType値, 3.2.1

プロジェクト・メタデータ, A.4 プロジェクト

7.5より前のプロジェクトのアップグレード, B

プロパティ, カスタム・セクション, 6.6

Q

問合せ文字列

コントリビューション・モードの設定, 2.7.2

<querytext>タグ, 6.7.3.2

R

乱数の生成, 9.22

検索索引の再作成, B.4.2

JSPサポートの再デプロイ, A.8

「リージョン・コンテンツ・オプション」ダイアログ, 2.3.2

リージョン定義, 2.3.2

要素コンテキスト, 9.9

サンプル・コード, 2.3.2

xWebsiteObjectType値, 3.2.1

リージョン定義メタデータ・フィールド, 3.2.5 リージョン・テンプレート

xWebsiteObjectType値, 3.2.1

リージョン・テンプレート, 2.2.3 ResourceCache, 13.5.3 コンテンツの再利用, ルール, 11.7.38 Rhino, 13.4.2 ルート・ブラウザ・ウィンドウ, 15.4.2 ルート・コンテンツ

コントリビュータ・コンソール・ウィンドウの起動, 15.3

ランタイム・エラー

表示, 15.3

S

script

カスタム, 3.2.1

検証, 3.2.1

xWebsiteObjectType値, 3.2.1

スクリプト拡張機能

ssIncludeXml(), 6.5

スクリプト拡張機能, 9.1 スクリプト・リンク, 9.38, 9.39 検索索引, B.4.2 検索結果, B.4.3.3, B.4.3.3 セカンダリ・ページ, 2.2.1 secondaryUrlプロパティ, 解析, 11.7.38 セクション

エラーの処理, 11.7.38

旧名ノード, 11.7.38

セクション・ノード, 9.24 セクション・プロパティ

プライマリ・ページ, 2.2.1

セカンダリ・ページ, 2.2.1

<section>タグ, 5.2.3 サーバー相対URL, 9.32, 9.33 サーバー相対URL, 9.33 サーバー側スクリプト・リンク

ssLinkの使用, 9.38

ssNodeLinkの使用, 9.39

サービス

コントリビュータ, 11.2

デザイナ, 11.3

リンク・ウィザード, 11.6

マネージャ, 11.4

コンテンツの切替え, 11.5

検索結果のサービス, B.4.3.3, B.4.3.3 サービス，「コンテンツ・サーバー・サービス」を参照 セッションCookie

コントリビューション・モード, 2.7.3

キー・コマンド, 2.7.3

ShowSiteStudioMissingDataFileErrors, 12.3 単一コンテンツ・サーバー, サイトのアップグレード, B.3.1 サイト階層

NavNodeオブジェクトの宣言, 5.2.1

XML定義, 5.2.3, 5.2.4

サイト・ナビゲーション, B.4.1 サイト・ノード, 9.24 サイト・プロパティ

ssGetSitePropertyの使用, 9.28

サイト・セクションとフォルダ, B.4.5 SIte Studio

websitesフォルダ, 10.2

Site Studio

コンポーネント・リソース, 5.2.1

メタデータ・フィールド, A.7

10gR4より前のプロジェクト, B

JSONの使用, 14.1

websitesフォルダ, 10.3

Site Studioメタデータ・フィールド

リージョン定義, 3.2.5

Webサイト・セクション, B.4.5

<site>タグ, 5.2.3 sitenavigation.js, 5.2.1, 5.2.2

NavNodeオブジェクトの宣言, 5.2.1

link()メソッド, 5.2.2

NavNodeオブジェクト定義, 5.2.1

nodelink()メソッド, 5.2.2

sitenavigation.xmlファイル, 5.2.3, 5.2.4, 6.6.2 siteRelativeUrl

エラー・ハンドラ・ページ, 17.1

サイト, 「Webサイト」を参照 SiteStudioValidateConversionsDefinitions, 12.7 SiteStudioValidateDataFiles, 12.8 SiteStudioValidateElementDefinitions, 12.4 SiteStudioValidatePlaceholderDefinitions, 12.6 SiteStudioValidateProjects, 12.9 SiteStudioValidateRegionDefinitions, 12.5 <snippet>タグ, 6.7.4 大カッコ, 4.2 SS_GET_ALL_NODE_PROPERTIESサービス, 6.6.2 SS_GET_PAGE, B.4.3.2 SS_GET_PAGEサービス, 11.7.38

コール中のエラー, 11.7.38

nodeIdパラメータ, 11.7.38

オプションのURLパラメータ, 11.7.38

必須パラメータ, 11.7.38

PreviewIdパラメータ, 11.7.38

ssContributorパラメータ, 11.7.38

ssDocNameパラメータ, 11.7.38

SS_GET_SEARCH_RESULTSサービス, B.4.3.3, B.4.3.3 SS_SERVER_NAME, 10.6 SSAccessDeniedHeader, 12.10 SSAccessDeniedReplacementHeader, 12.11 SSAccessDeniedUserAgentExceptions, 12.12 SSAccommodateWelcomeFile, 12.13 SSAdditionalNavResultSetFields, 12.14 SSAddSecurityIDValues, 12.15 SSAfterProjectLoadedProperties, 12.16 SSAllowDynamicDefinitions, 12.17 SSAllowEmptyUrlPageName, 12.18 SSAllowNotModifiedHeader, 12.19 SSAltTagFieldName, 12.20 SSAlwaysRecordServerConfig, 12.21 SSAlwaysUseSIteIdInLinks, 12.22 SSAssumeXmlIsUtf8, 12.23 SSAutoCheckinBusyTimeout, 12.24 SSBackupCollectionName, 12.25 SSCacheControlOverride, 12.26 SSCanGenerateUniqueDataFiles, 12.27 SSChangeAccessDeniedHeaders, 12.28 SSCheckAssignedContentAccess, 12.29 SSCheckBrowserForSiteRoot, 12.30 SSCheckNodeIdUniqueness, 12.31 SSCheckWebsiteObjectSecurity, 12.32 SSClearDefinitionArchiveWebsites, 12.33 SSCompressorArguments, 12.34 SSCompressorCommand, 12.35 SSCompressorDir, 12.36 SSCompressorJar, 12.37 SSCompressorMainClass, 12.38 SSCompressorTimeout, 12.39 SSCompressorTimerInterval, 12.40 SSCompressorWaitForever, 12.41 SSComputeDocInfoCacheSize, 13.5.2 SSContributorパラメータ, 11.7.38 SSContributorSourceDir, 12.42, 13.4.5 SSCustomNodePropertyDefsPermissions, 12.43 SSDefaultDocumentsFields, 12.44 SSDefaultEditor, 12.45 SSDefaultExternalDocNamePrefix, 12.46 SSDefaultExternalDocNameSuffix, 12.47 SSDefaultExternalServerRelativeSiteRoot, 12.48 SSDefaultExternalUrlPrefix, 12.49 SSDefaultExternalUrlSuffix, 12.50 SSDefaultPlaceholderDefinition, 12.51 SSDefaultRegionTemplate, 12.52 SSDefaultUrlPageName, 12.53 SSDetectIncludeFileEncoding, 12.54 SSDICPlaceholderDefinition, 12.55 SSDirectDeliveryExtensions, 12.56 SSDirectDeliveryOverrideProperty, 12.57 SSDirectDeliveryProperty, 12.58 SSDirectDeliveryRequiredExtensions, 12.59 SSDisableDeferredNodeExpansion, 12.60, 13.5.1 SSDisableIncludeXmlCache, 12.61 SSDisableLinkResolutionSiteLocking, 12.62 SSDisableProjectDeferredNodeExpansion, 12.63 SSDocInfoCacheCellOverhead, 13.5.2 SSDocInfoCacheColumnOverhead, 13.5.2 SSDocInfoCacheLowerBound, 13.5.2 SSDocInfoCacheMultiplier, 13.5.2 SSDocInfoCacheRowOverhead, 13.5.2 SSDocInfoCacheStringMultiplier, 13.5.2 SSDocInfoCacheStringOverhead, 13.5.2 ssDocName, 11.7.38 ssDocNameパラメータ, 11.7.38 SSDomCacheDefaultFileSizeFactor, 12.64, 13.5.3 SSDomCacheFileSizeFactors, 12.65, 13.5.3 SSDomCacheLowerBound, 12.66, 13.5.3 SSDomCacheMultiplier, 12.67, 13.5.3 SSDomCacheNodeMultiplier, 12.68, 13.5.3 SSDomCacheStringMultiplier, 12.69, 13.5.3 SSDomCacheStringOverhead, 12.70, 13.5.3 SSDomCacheUseDOM, 12.71, 13.5.3 SSDomCacheUseFileSize, 12.72, 13.5.3 SSEditorDebugLevel, 12.73 SSEnableASPSupport, 12.74 SSEnableDirectDelivery, 12.75 SSEnableExtranetLookCompatibility, 12.76 SSEnableFolioEditing, 12.77 SSEnableFormEditing, 12.78 SSEnableJavaScriptCompressor, 12.79 SSEnableUpperCaseColumnsCheck, 12.80 ssErrorCode, 11.7.38 ssErrorMessage, 11.7.38 SSGenerateUniqueNodeIds, 12.81 ssGetAllSites, 9.37, 9.37 ssGetCoreMajorVersion, 9.24, 9.25, 9.25 ssGetDocInfo, 9.15 ssGetFirstNodeId, 9.29 ssGetNodeLabel, 9.35, 9.35 ssGetNodeLabelPath, 9.36, 9.36 ssGetNodeProperty, 9.23, 9.23 ssGetNodeProperty (name), 6.6.2 ssGetNodeProperty (nodeId, name), 6.6.2 ssGetRelativeNodeId, 9.30, 9.30 ssGetServerRelativePath, 9.33, 9.33 ssGetServerRelativeUrl, 9.32, 9.32 ssGetSiteProperty, 9.28, 9.28 ssGetUrlPageName, 9.34 ssGetWebsiteName, 9.27, 9.27 ssGetWebsiteNodeType, 9.24 ssGetXmlNodeCount, 9.16 SSHidePrimaryFileInContributor, 12.82 SSHttpAbsoluteHelpRoot, 12.83 SSHttpLayerManager, 12.84 SSIdocMarker, 12.85 SSIgnoreMaxAgeNodeProperties, 12.86 SSIgnoreNoProjectDefaultMetadataMessage, 12.87 SSIgnoreReadyToReplicate, 12.88 SSImportOnlyLatestRevs, 12.89 ssIncDynamicConversion, 9.18, 9.19, 9.20 ssIncInlineDynamicConversion, 9.18, 9.18, 9.19, 9.19, 9.20, 9.20 ssIncludeDynamicConversion, 9.17 SSIncludeInactiveNodesInNavResultSet, 12.90 SSIncludeInactiveNodesInNavXML, 12.91 SSIncludeRegionTemplatesInDefinitionBundles, 12.92 ssIncludeXml, 9.14 ssIncludeXml(), 6.5

パラメータ, 6.5

SSIncludeXmlTransformFormat, 12.93 SSIncludeXmlTransformIndent, 12.94 ssIsNativeDoc, 9.21, 9.21, 9.21 SSJavaExecutablePath, 12.95 SSJSONContentType, 12.96 ssLink, 9.38, 12.62 SSLoadCustomElementsWithOnDemandEditors, 12.97 SSLoadProjectsAtStartup, 12.98 ssLoadSiteNavResultSet, 9.31, 9.31 SSLoadUncompressedFckSource, 12.99 SSManuallyValidateNodeIdUniqueness, 12.100 SSMaxNodeIdLength, 12.101 SSMaxSiteIdLength, 12.102 SSMaxSitesMenuItems, 12.103 SSMaxTemplateEvaluationStack, 12.104 SSMigrationCollectionName, 12.105 <ssm:settings>, 16.2 SSNavigationBeanオブジェクト, B.4.6 SSNavigationNodeオブジェクト, B.4.6 ssNodeLink, 9.39, 12.62 SSOmitFragmentLibrariesInArchiverQueries, 12.106 SSOnDemandEditorsThresholdCount, 12.107, 13.3.2.1 SSPrefillUrlDirNamesDuringUpgrade, 12.108 SSProjectAutoCheckinInterval, 12.109 SSProjectLoadFailureTracingSection, 12.110 SSProjectReleaseSleepTime, 12.111 SSProjectReleaseWaitTime, 12.112 SSQuickDiffDefaultRegionTemplate, 12.113 ssRandom, 9.22, 9.22 ssServerRelativeSiteRoot, 10.8 SSShowAssignmentTooltips, 12.114 ssSourceNodeId, 11.7.38 ssSplitString, 9.26, 9.26 SSSQLUseContains, 12.115 SSStoppedSiteResponsePageDocName, 12.116 SSSuppressAddToWebsite, 12.117 SSSuppressLargeCssOptimization, 12.118 ssTargetNodeId, 11.7.38 SSTempProjectLifetime, 12.119 SSTitleTagFieldName, 12.120 SSTrackContentAccess, 12.121, 17.2 SSTrackerReportNumDaysBack, 17.2 SSTrackFragmentAccess, 12.122, 17.2 SSUrlFieldName, 12.123 SSUrlFixupExceptions, 12.124 SSUrlPageNames, 12.125 SSUseAbsoluteRedirects, 12.126 SSUseCallbackTrackingForASP, 12.127 SSUseDefaultDocNamePrefix, 12.128 SSUseDefaultServerRelativeSiteRoot, 12.129 SSUseDefaultUrlPrefix, 12.130 SSUseMissingLinkTargetFallback, 12.131 SSUseOnDemandContributionModeMenus, 12.132 SSUseUrlSegmentSessionInfo, 12.133 SSValidateCustomElements, 12.134 SSWebFilterIgnoreList, 12.135 ssWeblayoutUrl, 9.40 SSWeblayoutUrlUsesDocNames, 12.136 SSWelcomeFile, 12.137 SSWelcomeFileReplacement, 12.138 SSXPathCacheEntry, 13.5.3 静的リスト

フラグメント定義の単純な要素, 6.7.6

スタイルシート

xWebsiteObjectType値, 3.2.1

サブテンプレート

xWebsiteObjectType値, 3.2.1

サブテンプレート, 2.2.2 Sun ONE Webサーバー, A.6 コンテンツの切替えサービス

SS_ADD_WEBSITE_ID, 11.7.2

SS_GET_ALL_NODE_PROPERTIES, 11.7.19

SS_GET_CONFIG_INFO, 11.7.23

SS_GET_CONTRIBUTOR_STRINGS, 11.7.25

SS_GET_DOCUMENT_LABELS, 11.7.27

SS_GET_LINK, 11.7.32

SS_GET_SEARCH_RESULTS, 11.7.43

SS_GET_SITE_DEFINITION_FOR_USER, 11.7.48

SS_GET_SWITCH_CONTENT_CONFIG, 11.7.55

SS_SET_NODE_PROPERTY, 11.7.69

SS_SET_NODES_PROPERTIES, 11.7.70

SS_SWITCH_REGION_ASSOCIATION, 11.7.76

「リージョン・コンテンツの切替え」ダイアログ, 2.3.2

T

タグ

<convert>, 6.7.3.4

<customgui>, 6.7.3.5

<designview>, 6.7.5

<element>, 6.7.6

<fragment>, 6.7.1

<fragments>, 6.7.1

<option>, 6.7.3.1

<parameter>, 6.7.3

<querytext>, 6.7.3.2

<snippet>, 6.7.4

<validate>, 6.7.3.3

テンプレート

フラグメント, 6.1

スニペットのインクルード, 6.7.4

テンプレート

ページ・テンプレート, 2.2.1

リージョン・テンプレート, 2.2.3

サブテンプレート, 2.2.2

ツールバー

コマンド・ウィンドウ, 15.1.2

コンテキスト・フィールド, 15.1.2

ロギング・ウィンドウ, 15.1.1

U

カスタム要素の更新, B.4.4

レガシー・サイトのアップグレード, B.3

7.5より前のプロジェクトのアップグレード

自動アップグレード, B.2

<base>タグ, B.4.3.1

カスタム要素, B.4.4

カスタム・フラグメント, B.4.3

フォルダ, B.4.5

完全アップグレード, B.3.3

GET_SEARCH_RESULTSサービス, B.4.3.3, B.4.3.3

JSPコード, B.4.6

最小アップグレード, B.3.4

複数コンテンツ・サーバー, B.3.2

検索索引, B.4.2

単一コンテンツ・サーバー, B.3.1

サイト・ナビゲーション, B.4.1

サイト・セクション, B.4.5

SS_GET_PAGE, B.4.3.2

コンテンツ・サーバーのアップグレード, B.3

7.5より前のサイトのアップグレード, B.3 フラグメント・ライブラリのアップロード, 6.2 URL

パス・ベース, A.5, B.4.3.2

useSecondaryパラメータ, 11.7.38 データ交換に対するJSONの使用, 14.1 サーバー側スクリプト・リンク, 9.38, 9.39

V

<validate>タグ, 6.7.3.3

検証スクリプト

x WebsiteObjectType, 3.2.1

仮想キー・コード, 5.3 ビジュアル・デバッガ, 13.4.4

W

WCM_PLACEHOLDER, 7.2, 7.4

wcmDynamicConversion, 7.2, 7.3, 9.10

プロパティ・パネル, 7.3

wcmDynamicList, 9.8 wcmElement, 9.3, 9.6, 9.8 wcmFragment, 9.12 wcmGetListAsResultSet, 9.11 wcmIncludeElement, 9.9 wcm.js, 15.3 wcmListElement, 9.6 wcmListEnd, 9.5 wcmListRowCount, 9.7 wcmListStart, 9.4 wcmPlaceholder, 2.2.1, 2.3.2, 9.2 wcm.toggle.js, 2.7.1, 5.3 wcmUrl, 9.13

例, 4.2

Webページ

エラーの処理, 11.7.38

コントリビュータ・モード, 11.7.38

一時的なプレビュー・バージョン, 11.7.38

Webサーバー

Apache, A.5

Sun ONE, A.6

Webサイト

コントリビューション機能, 5.3

階層の定義, 6.6.1

ランタイム・ファイル, 5.1

Webサイト階層, 9.31

sitenavigation.js, 5.2.1, 5.2.2

Webサイト・セクション・メタデータ・フィールド, B.4.5 Webサイト, B.3 websitesフォルダ, 10.2, 10.3 window.external機能, 8.4, 8.4.2, B.4.4

X

xCollectionID, xWebsiteSectionによる置換, 3.2.2

xDontShowInListsForWebsites, 3.2.4

Xercesパーサー, 13.5

Xercesパーサー, 12.60, 13.5.1

XML定義

<section>タグ, 5.2.3

<site>タグ, 5.2.3

XMLファイル, 自動生成, 5.1 XMLノード, 抽出, 6.5 XPath式

ssIncludeXml()パラメータとして, 6.5

xRegionDefinition, 2.3.2 xRegionDefinitionメタデータ・フィールド, 3.2.5 xWebsiteID, xWebsitesによる置換, 3.2.3 xWebsiteObjectType, 3.2.1 xWebsites, 3.2.3 xWebsiteSection

xCollectionIDの置換, 3.2.2

xWebsiteSectionメタデータ・フィールド, B.4.5

Z

ゾーン・フィールド, A.7

Copyright © 1996, 2011, Oracle and/or its affiliates. All rights reserved.