パブリッシュ・オプションの XML
パブリッシング要求に対してパブリッシュ・オプションの XML で指定した値は、関連するパブリッシュ・テンプレートで設定されたパブリッシュ・オプションよりも優先されます。指定できるパブリッシュ・オプションは、新規または再パブリッシュ・ドキュメントのパブリッシュ名、パブリッシュ・ドキュメントがファイリングされる出力フォルダーの名前または ID、およびパブリッシュ処理の完了時に起動するイベント・アクションの名前または ID です。
パブリッシュ・オプションの XML を表す文字列をパラメーターとして、次の表にリストされているメソッドに渡します。パラメーターが null である場合、名前、出力フォルダー、およびイベント・アクションの値は、関連するパブリッシュ・テンプレートに指定されたデフォルト値に設定されます。
Java™ | .NET |
---|---|
PublishRequest.setPublishOptions | IPublishRequest.SetPublishOptions |
Document.publish | IDocument.Publish |
Document.republish | IDocument.Republish |
例
この例では、パブリッシュ名と出力フォルダーが指定され、関連するパブリッシュ・テンプレートで指定した値の代わりにそれらが使用されます。イベント・アクション・エレメントではイベント・アクションが指定されないため、関連するパブリッシュ・テンプレートで定義されていても、イベント・アクションは使用されません。XML にイベント・アクション・エレメントが含まれていない場合は、パブリッシュ・テンプレート内のイベント・アクション (存在する場合) が使用されます。
<?xml version="1.0"?>
<publishoptions>
<publicationname> My New Title</publicationname>
<!--output folder can be specified as an ID (GUID) by using the outputfolderid element-->
<outputfoldername>My Pubs Folder<outputfoldername>
<!--event action can be specified as an ID (GUID) by using the eventactionid element-->
<eventactionname></eventactionname>
</publishoptions>
エレメントの定義
- publishoptions
- ルート・エレメントです。
- publishoptions.publicationname
- このドキュメントの名前を指定します。
- publishoptions.publicationid
- このドキュメントの ID (GUID) を指定します。
- publishoptions.outputfoldername
- パブリッシュ・ドキュメントがファイリングされるフォルダーの名前を格納します。
- publishoptions.outputfolderid
- パブリッシュ・ドキュメントがファイリングされるフォルダーの ID (GUID) を格納します。
- publishoptions.eventactionname
- パブリッシュまたは再パブリッシュ処理の完了時に起動するイベント・アクションの名前を格納します。
- publishoptions.eventactionid
- パブリッシュまたは再パブリッシュ処理の完了時に起動するイベント・アクションの ID (GUID) を格納します。