sp_makewebtask

Transact-SQL 参考

创建一项生成 HTML 文档的任务，该文档包含执行过的查询返回的数据。

说明所有 Web 作业在企业管理器的"作业分类"对话框中都被归为 Web 助手。有关更多信息，请参见定义作业。

sp_makewebtask [@outputfile =] 'outputfile', [@query =] 'query'[, [@fixedfont =]fixedfont][, [@bold =]bold][, [@italic =]italic][, [@colheaders =]colheaders][, [@lastupdated =]lastupdated][, [@HTMLheader =]HTMLheader][, [@username =]username][, [@dbname =]dbname][, [@templatefile =] 'templatefile'][, [@webpagetitle =] 'webpagetitle'][, [@resultstitle =] 'resultstitle'][[, [@URL =] 'URL', [@reftext =] 'reftext']| [, [@table_urls =]table_urls, [@url_query =] 'url_query']][, [@whentype =]whentype][, [@targetdate =]targetdate][, [@targettime =]targettime][, [@dayflags =]dayflags][, [@numunits =]numunits][, [@unittype =]unittype][, [@PRocname =]procname ][, [@maketask =]maketask][, [@rowcnt =]rowcnt][, [@tabborder =]tabborder][, [@singlerow =]singlerow][, [@blobfmt =]blobfmt][, [@nrowsperpage =] n][, [@datachg =] table_column_list][, [@charset =] characterset][, [@codepage =] codepage]

[@outputfile =] 'outputfile'

在 Microsoft® SQL Server™ 的实例上生成的 HTML 文件的位置。如果文档将在远程计算机上生成，则该参数可以是 UNC 名称。outputfile 的数据类型为 nvarchar(255)，没有默认值。

[@query =] 'query'

要运行的查询。query 的数据类型为 ntext，没有默认值。当通过 sp_runwebtask 运行任务时，查询结果将以表格形式显示在 HTML 文档中。可以指定多个 SELECT 查询，从而导致在 outputfile 中显示多个表。

[@fixedfont =]fixedfont

指定查询结果是以固定字体 (1) 还是以成比例字体 (0) 显示。fixedfont 的数据类型为 tinyint，默认值为 1。

[@bold =]bold

指定查询结果是以粗体 (1) 还是非粗体 (0) 显示。bold 的数据类型为 tinyint，默认值为 0。

[@italic =]italic

指定查询结果是以斜体 (1) 还是非斜体 (0) 显示。italic 的数据类型为 tinyint，默认值为 0。

[@colheaders =]colheaders

指定查询结果是带列标题 (1) 还是不带列标题 (0) 显示。colheaders 的数据类型为 tinyint，默认值为 1。

[@lastupdated =]lastupdated

指定所生成的 HTML 文档是否显示"上次更新时间："时间戳指示上次更新的日期和时间 (1) 或者没有时间戳 (0)。在 HTML 文档中，时间戳出现在查询结果的前一行。lastupdated 的数据类型为 tinyint，默认值为 1。

[@HTMLHeader =]HTMLHeader

指定用于显示包含在 resultstitle 中的文本的 HTML 格式代码。HTMLheader 的数据类型为 tinyint，可以是下列值之一。

[@username =]username

是执行查询的用户名。username 的数据类型为 nvarchar (128)，默认设置为当前用户。系统管理员或数据库所有者可以指定其它用户名。

[@dbname =]dbname

在其上运行查询的数据库名。dbname 的数据类型为 nvarchar(128)，默认值为当前数据库。

[@templatefile =] 'templatefile'

用于生成 HTML 文档的模板文件的路径。模板文件包含 HTML 文档的格式特征信息和标记 <%insert_data_here%>，该标记指示将查询结果添加到 HTML 表中的位置。templatefile 的数据类型为 nvarchar(255)。

指定查询结果在模板文件中位置的方法有两种：

1. 通过包含 <%insert_data_here%> 标记指定一个通用表格式，该标记指示将查询结果添加到 HTML 表中的位置。标记间没有间隔。当使用 <%insert_data_here%> 时，fixedfont、bold、italic、colheaders 和 tabborders 值都将应用于查询结果。
2. 指定完整的行格式，以便生成更加精确的版面。使用 <%begindetail%>和 <%enddetail%> 标记，并在这两个标记之间使用 <TR>、</TR>、<TD> 和 </TD> 这些 HTML 标记定义完整的行格式。对于每个要显示在结果集中的列，都插入 <%insert_data_here%> 标记。当使用完整行格式时，下列 sp_makewebtask 参数将被忽略：

   Bold	lastupdated	table_urls
   Colheaders	reftext	URL
   Fixedfont	resultstitle	url_query
   HTMLheader	singlerow	webpagetitle
   Italic	tabborder

   被 sp_makewebtask 所调用的扩展过程可以读取 Unicode 和非 Unicode 模板文件。如果 Unicode 文件包含签名标题，则该标题将在生成 HTML 文件时删除。

[@webpagetitle =] 'webpagetitle'

HTML 文档的标题。webpagetitle 的数据类型为 nvarchar(255)，默认值为 SQL Server Web Assistant。对于空白标题，需要为标题指定两个空格字符，或通过编辑 HTML 源文件来删除 <TITLE> 和 </TITLE> 标记以及标记中间的标题文本。

[@resultstitle =] 'resultstitle'

HTML 文档中显示查询结果上方的标题。resultstitle 的数据类型为 nvarchar(255)，默认值为 Query Results。

[@URL =] 'URL'

转到其它 HTML 文档的超级链接。该超级链接位于查询结果之后、HTML 文档末尾。URL 的数据类型为 nvarchar(255)。如果指定了 URL，也必须指定 reftext，但不能指定 table_ur