目录引入报告消息

亚马逊Fire TV客户端上传到亚马逊的每个目录文件都会生成相应的目录数据格式 (CDF) 引入报告。此报告会说明是否成功将目录文件集成至Fire TV的通用浏览和搜索结果。如果没有，则此报告将详细解释失败的原因。此报告还会针对文件改善目的提出警告和建议。

本页列出了引入报告中出现的错误、警告和建议，解释了原因，并针对每种情况提出了解决方案。有关获取和使用引入报告的更多信息，请参阅验证已上传的CDF文件。

注意： 此文档不包含引入报告中出现的所有消息的综合列表。报告中可能还会出现由验证工具生成的XML验证错误。这些消息的措辞因所用的特定工具而异。这些消息不便用户阅读，看起来还有些语义含糊和晦涩难懂。如果出现这种情况，请咨询开发者或您的亚马逊代表，向他们寻求解释和修复帮助。在提交目录前进行目录文件验证既是最佳实践，又能改善引入报告的可读性。

要求
这些问题应该由谁解决？
本文档所用约定
错误
警告
建议
图像相关消息

要求

用户应至少具备处理XML文件的基本知识（即知道什么是元素和attribute属性以及如何关闭标签），并应熟悉验证已上传的CDF文件中的信息。

这些问题应该由谁解决？

一般采用以下两种方式之一创建目录文件：

自动方法是从媒体数据库中提取元数据信息。此操作会使用脚本或其他代码按预定时间表获取数据，将其转换为符合CDF要求的目录文件，然后再上传到您的S3存储桶。这是首选方法，一旦正常运行，就无需人工交互。
手动方法是安排人员将目录文件维护一段时间。

如果贵公司使用自动方法，则必须在源数据库本身，而不是目录文件中执行修复和更改操作。一般只有数据库管理员具有数据库访问权限，因此请寻求其帮助，以允许您访问或为您进行更改。您可能还必须与开发者合作，完善根据数据创建CDF文件的代码。

如果贵公司选择手动维护目录，则受到的访问限制可能较少。

请注意，大型目录通常会收到成千上万条警告和建议。通常都是上千条条目会收到少量警告。这些问题往往无法通过地毯式查找与替换来解决。

例如，为10,000个条目添加演职人员信息的这条建议必须单独处理每个条目。警告和建议不妨碍用户使用您的目录，因此是否处理与何时处理，这取决于您的时间和资源。

本文档所用约定

“CDF文件”是您上传到亚马逊的目录数据文件，它也是引入报告的编制基础。此XML文件符合目录数据格式 (CDF) 架构的要求。请参阅步骤1：创建您的目录文件，获取有关文件内容的详细信息。

WorkID是问题所在的作品元素的ID（Movie、TvShow、TvSeason、TvEpisode、MiniSeries、MiniSeriesEpisode或Extra）。例如，就电影而言，它是指您CDF文件的电影条目下的ID元素值。引入报告中的每条消息都会展开，显示出现此消息的每部作品的ID。

详细消息是您在展开报告所述的特定错误、警告或建议时，在每部WorkID中看到的附加文本。其具体说明了与此作品相关的消息是如何出现的。也有一些消息没有详细信息，这种情况下只能看到WorkID。

嵌套元素用句号指定。例如，TvEpisode.Credits.CrewMember是指Credits元素的子元素CrewMember，而此父元素又是TvEpisode元素的子元素。ID元素Movie.ID是Movie元素的子元素。

任何不用于强调的斜体字都是表示实际值的占位符，如nn表示数字，ss表示文本字符串，url表示完整URL等。

示例所用的省略号（……）表示出于简洁明了的目的，省略一些与主题无关的材料。

错误

引入报告中“错误”部分所列的任何消息都会导致您的CDF文件遭拒。请更正所有报告的错误，然后重新提交CDF文件。

错误

Invalid catalog file
ID is not unique
MiniSeriesEpisode references an invalid MiniSeriesID
Referenced MiniSeries not found
Referenced TvSeason not found
Referenced TvShow not found
Title is required and cannot be blank
Too many invalid images
TvEpisode references an invalid SeasonID
TvEpisode references an invalid ShowID

错误： Invalid catalog file（目录文件无效）

详细消息： Unable to parse provided catalog

问题所在

CDF文件无效。您不会看到此消息，而是会看到XML验证失败的消息。

解决方法

使用Xmllint等工具或Notepad++验证插件，验证文件并指出错误。文件失效可能由多种原因导致：省略结束标记、使用未定义元素（可能只是拼写错误，XML也要区分大小写）、按错误顺序排列元素，或者未添加必要元素或attribute属性。您应始终在提交文件之前验证文件，以免发生错误。

另请参阅

错误： ID is not unique（不是唯一ID）

详细消息： WorkID nn works have this ID

示例： tt123456 6 works have this ID

问题所在

文件中至少有两个条目具有相同ID。CDF文件中的每部作品（Movie、TvShow、TvSeason、TvEpisode等）的ID都必须是唯一的。

解决方法

在您的CDF文件中找出所有具有此ID（示例中为tt123456）的作品。只为一部作品保留此ID，其余作品全部更改ID，确保您能为已更改ID的作品生成唯一ID。如果CDF文件来自数据库，则可以将作品的数据库密钥融入ID，以保证其唯一性。制定ID方案并坚定实施。

注意： 更改ID的同时还必须更改对它的任何引用。例如，您更改TvShow.ID时，还需要更改此节目的TvSeason.ShowID、TvEpisode.ShowID或Extra.RelatesToID元素才能完成匹配。

可能涉及的元素

WorkType.ID
WorkType可以是Movie、TvShow、TvSeason、TvEpisode、MiniSeries、MiniSeriesEpisode或Extra

错误： MiniSeriesEpisode references an invalid MiniSeriesID（MiniSeriesEpisode引用了无效的MiniSeriesID）

详细消息： WorkID

示例： tt123456 MiniSeriesEpisode references an invalid MiniSeriesID

问题所在

具有给定作品ID（示例中为tt123456）的MiniSeriesEpisode虽有MiniSeriesID元素，但为空值。

解决方法

在您的CDF文件中查找本剧集所属的MiniSeries元素。如果找到，则记录其ID值。转到MiniSeriesEpisode条目，定位其MiniSeriesID元素，并更改此值，使其匹配MiniSeriesID。换言之，确保MiniSeries.ID = MiniSeriesEpisode.MiniSeriesID。

如未找到MiniSeries元素且您无意添加此元素，则使用MiniSeriesEpisode.MiniSeriesTitle，而不是MiniSeriesEpisode.MiniSeriesID。按给定方式使用MiniSeriesEpisode.MiniSeriesTitle，无需匹配任何内容。仅在缺失MiniSeries元素时执行此操作。

可能涉及的元素

MiniSeries.ID
MiniSeriesEpisode.MiniSeriesID
MiniSeriesEpisode.MiniSeriesTitle

错误： Referenced MiniSeries not found（未找到引用的迷你剧）

详细消息： WorkID MiniSeriesEpisode references a missing MiniSeries with ID of ss

示例： tt123456 MiniSeriesEpisode references a missing MiniSeries with ID of nn654321

问题所在

具有给定作品ID（示例中为tt123456）的MiniSeriesEpisode指定了MiniSeries的ID（示例中为nn654321），但您的目录中没有与之匹配的MiniSeries。

解决方法

可能涉及的元素

MiniSeries.ID
MiniSeriesEpisode.MiniSeriesID
MiniSeriesEpisode.MiniSeriesTitle

错误： Referenced TvSeason not found（未找到引用的TvSeason）

详细消息： WorkID TvEpisode references a missing TvSeason with ID of ss

示例： tt123456 TvEpisode references a missing TvSeason with ID of nn654321

问题所在

具有给定作品ID（示例中为tt123456）的TvEpisode指定了TvSeason的ID（示例中为nn654321），但您的目录中没有与之匹配的TvSeason。

解决方法

在您的CDF文件中查找本剧集所属的TvSeason元素。如果找到TvSeason，则记录其ID值。转到TvEpisode条目，定位其SeasonID元素，并更改此值，使其匹配TvSeasonID。换言之，确保TvSeason.ID = TvEpisode.SeasonID。

如未找到TvSeason元素且您无意添加此元素，则使用TvEpisode.SeasonInShow，而不是TvEpisode.SeasonID。您也可以添加选填元素TvEpisode.SeasonTitle。按给定方式使用TvEpisode.SeasonInShow和TvEpisode.SeasonTitle，无需匹配任何内容。仅在缺失TvSeason元素时执行此操作，这种情况仅发生在您根本无法获得该信息时。

可能涉及的元素

TvSeason.ID
TvEpisode.SeasonID
TvEpisode.SeasonInShow
TvEpisode.SeasonTitle

错误： Referenced TvShow not found（未找到引用的TvShow）

详细消息：

WorkID TvEpisode references a missing TvShow with ID of ss

示例： tt123456 TvEpisode references a missing TvShow with ID of nn654321

问题所在

TvEpisode可能会发生这种情况。具有给定作品ID（示例中为tt123456）的剧集指定了TvShow的ID（示例中为nn654321），但您的目录中没有与之匹配的TvShow。

解决方法

在CDF文件中查找本剧集所属的TvShow元素。如果找到TvShow，则记录其ID值。换言之，确保TvShow.ID = TvEpisode.ShowID。

如未找到TvShow元素且您无意添加此元素，则使用ShowTitle，而不是ShowID。按给定方式使用ShowTitle，无需匹配任何内容。仅在缺失TvShow元素时执行此操作，这种情况应该提出是否要添加此元素的问题。

可能涉及的元素

TvShow.ID
TvEpisode.ShowID
TvEpisode.ShowTitle

错误： Title is required and cannot be blank（标题为必填项，不得为空）

详细消息： WorkID

问题所在

您的CDF文件包含适用于给定ID的Title元素，只是其中没有标题文本。

解决方法

在您的CDF文件中查找具有给定ID的作品，定位其Title元素，并提供其标题文本。示例如下：

之前：<Title locale="en-US"></Title>
之后：<Title locale="en-US">City Lights</Title>

可能涉及的元素

WorkType.Title
WorkType可以是Movie、TvShow、TvSeason、TvEpisode、MiniSeries、MiniSeriesEpisode或Extra。

错误： Too many invalid images（无效图像过多）

请参阅图像相关消息。

错误： TvEpisode references an invalid SeasonID（TvEpisode引用了无效的SeasonID）

详细消息： WorkID

示例： tt123456 TvEpisode references an invalid SeasonID

问题所在

具有给定作品ID（示例中为tt123456）的TvEpisode虽有SeasonID元素，但为空值。

解决方法

在您的CDF文件中查找本剧集所属的TvSeason元素。如果找到，则记录其ID值。转到TvEpisode条目，定位其SeasonID元素，并更改此值，使其匹配TvSeason ID。换言之，确保TvSeason.ID = TvEpisode.SeasonID。

如未找到TvSeason元素且您无意添加此元素，则使用TvEpisode.SeasonInShow，而不是TvEpisode.SeasonID。按给定方式使用TvEpisode.SeasonInShow，它只是一个编号。您也可以添加选填元素TvEpisode.SeasonTitle并按给定方式使用，无需匹配任何内容。仅在缺失TvSeason元素时执行此操作。

可能涉及的元素

TvSeason.ID
TvEpisode.SeasonID
TvEpisode.SeasonInSeries
TvEpisode.SeasonTitle

错误： TvEpisode references an invalid ShowID（TvEpisode引用了无效的ShowID）

详细消息： WorkID

示例： tt123456 TvEpisode references an invalid ShowID

问题所在

具有给定作品ID（示例中为tt123456）的TvEpisode虽有ShowID元素，但为空值。

解决方法

在您的CDF文件中查找本剧集所属的TvShow元素。如果找到，则记录其ID值。转到TvEpisode条目，定位其ShowID元素，并更改此值，使其匹配TvShow ID。换言之，确保TvShow.ID = TvEpisode.ShowID。

如未找到TvShow元素且您无意添加此元素，则使用TvEpisode.ShowTitle，而不是TvEpisode.ShowID。按给定方式使用ShowTitle，无需匹配任何内容。仅在缺失TvShow元素时执行此操作。

可能涉及的元素

TvShow.ID
TvEpisode.ShowID
TvEpisode.ShowTitle

警告

警告不会导致目录引入失败（有关图像的警告除外，数量足够多时会导致失败），但应该在资源允许的情况下全部解决。尤其要注意弃用警告，其表示您的CDF架构已更改，这可能导致部分数据不再可用。

警告

Aspect ratio should be between %f and %f (%f to %f preferred.)
Copyright is optional but should not be blank if supplied
CastMember or CrewMember name should not be blank
ExternalID is optional but should not be blank if supplied
Image height must be greater than %d pixels (greater than %d pixels preferred)
Inconsistent release year information
Invalid image
MiniSeries is not associated with any MiniSeriesEpisodes
Possible invalid string found for optional CastMember Role element
Quality element in Offer is deprecated in favor of Quality element in LaunchDetails
ReleaseInfo element is deprecated
Role (character name) is optional but should not be blank if supplied
Runtime minutes is not within expected range of 1 to 2880 minutes
The ShortDescription should not be the same as the Title
The Synopsis should be longer and more descriptive than the ShortDescription
The Synopsis should not be the same as the ShortDescription
The Synopsis should not be the same as the Title
Text contains characters that are escaped more than once
TvSeason is not associated with any TvEpisodes
TvShow is not associated with any TvEpisodes
Unsupported image type.Provided image not JPG or PNG format

警告： Aspect ratio should be between %f and %f (%f to %f preferred.)（宽高比应该为%f或%f（首选%f或%f。））

请参阅图像相关消息。请注意，此消息可以显示为警告或建议，视严重程度而定。

警告： Copyright is optional but should not be blank if supplied（版权为选填项，如有则应填写）

详细消息： WorkID

问题所在

版权元素出现在具有给定ID的作品下方，但不含版权信息文本。

解决方法

版权是选填元素，如果您不知道版权信息，可以删除此元素。否则，请在您的CDF文件中查找具有给定ID的作品元素，定位其版权元素，然后添加缺失信息。示例如下：

之前：<Copyright locale="en-US"></Copyright>
之后：<Copyright locale="en-US">© 1894 Edison Manufacturing Company</Copyright>

可能涉及的元素

WorkType.Copyright
WorkType可以是Movie、TvShow、TvSeason、TvEpisode、MiniSeries、MiniSeriesEpisode或Extra。

警告： CastMember or CrewMember name should not be blank（CastMember或CrewMember的姓名不应为空）

详细消息： WorkID

问题所在

此警告适用于CastMember或CrewMember。您的CDF文件包含适用于人员的姓名元素，只是其中没有人名。

解决方法

在您的CDF文件中查找具有给定ID的作品元素。查找此作品的演职人员名单元素。查看该演职人员名单部分中的每个CastMember或CrewMember元素，查找任何名称元素为空的元素，然后添加该信息。示例如下：

之前：<Name locale="en-US"></Name>之后：<Name locale="en-US">Alan Smithee</Name>

可能涉及的元素

WorkType.CastMember.Name
WorkType.CrewMember.Name
WorkType可以是Movie、TvShow、TvSeason、TvEpisode、MiniSeries、MiniSeriesEpisode或Extra。

警告： ExternalID is optional but should not be blank if supplied（ExternalID为选填项，如有则应填写）

详细消息： WorkID

问题所在

您的CDF文件包含ExternalID元素，但是没有提供相关信息。ExternalID是其他来源（如IMDb或DVD盒上的UPC代码）分配给作品或个人的ID。ExternalID适用于作品（Movie、TvShow等）、CastMember或CrewMember。通过ExternalID可以链接至该来源，或从中提取信息。例如，演员或职员也可以使用IMDb ExternalID导入其照片和描述。

解决方法

在您的CDF文件中查找具有给定ID的元素。找到其中包含的所有ExternalID元素，每部作品的ExternalID元素数量等于CrewMember或CastMember元素数量与作品本身ExternalID元素之和。ExternalID为选填元素，如有必要可以彻底删除。否则，请添加缺失信息。CastMember示例如下：

<Movie>
    <ID>_WorkID_</ID>
    <ExternalID scheme="imdb">tt0029843</ExternalID>
    ...
    <Credits>
        <CastMember>
            <Name locale="en-US">Errol Flynn</Name>
            <ExternalID scheme="imdb">nm0653028</ExternalID>

可能涉及的元素

WorkType.ExternalID
WorkType.CastMember.ExternalID
WorkType.CrewMember.ExternalID
WorkType可以是Movie、TvShow、TvSeason、TvEpisode、MiniSeries、MiniSeriesEpisode或Extra。

警告： Image height must be greater than %d pixels (greater than %d pixels preferred)（图像高度必须大于%d像素（首选大于%d像素））

请参阅图像相关消息。请注意，此消息可以显示为警告或建议，视严重程度而定。

警告： Inconsistent release year information（发行年份不一致）

详细消息： WorkID Provided ReleaseYear yyyy differs from the year yyyy in the ss element

示例：

tt123456 Provided ReleaseYear 1959 differs from the year 1960 in the OriginalAirDate element
tt456789 Provided ReleaseYear 1977 differs from the year 1978 in the ReleaseDate element

问题所在

作品指定的发行年份应用于多个地区，但并不一致。您已提供ReleaseYear和OriginalAirDate或ReleaseDate，其中每个元素都包含一个年份。追踪时请注意，一共有两种不同的ReleaseDate元素。一种是直属于作品的子元素，而另一种是已弃用ReleaseInfo元素的子元素。只有Movie、TvShow和MiniSeries中才能找到ReleaseDate。所有作品类型中都能找到已弃用的ReleaseInfo.ReleaseDate。只有TvEpisode和MiniSeriesEpisode元素下才能找到OriginalAirDate。

注意： 请勿对任意目录新增内容使用已弃用的ReleaseInfo.ReleaseDate元素。如果在弃用此元素之前就已存在目录，则可以考虑更新目录，使其匹配当前架构。有关说明，请参阅以下的ReleaseInfo元素已弃用。

解决方法

在您的CDF文件中查找具有给定WorkID（示例中为tt123456或tt456789）的元素。查找ReleaseYear元素，验证此年份是否正确，并记住此值。然后，在作品下查找任意OriginalAirDate或ReleaseDate实例，确保这些字符串都包含相同年份。请注意，OriginalAirDate和ReleaseDate遵循严格的数据形式（如2003-08-08T00:00:00Z），年份可能只是其中一部分。

可能涉及的元素

WorkType.ReleaseYear
WorkType.ReleaseDate
WorkType.ReleaseInfo.ReleaseDate
WorkType可以是Movie、TvShow、TvSeason、TvEpisode、MiniSeries、MiniSeriesEpisode或Extra。

警告： Invalid image（图像无效）

请参阅图像相关消息。

警告： MiniSeries is not associated with any MiniSeriesEpisodes（MiniSeries与MiniSeriesEpisodes无关）

详细消息： WorkID

问题所在

您的CDF文件包含迷你剧条目，但是没有任何剧集。这可能会破坏用户体验，因为用户虽然能看到并选择迷你剧，但打开后是空白内容。造成这种情况的原因有两个。一个是CDF文件中没有MiniSeriesEpisode元素。另一个是这些剧集虽然在CDF文件中，但却指定了错误的迷你剧。

解决方法

在您的CDF文件中查找适用于此MiniSeries的所有预期的MiniSeriesEpisode元素。是否存在此类元素？

否：您需要添加此类元素。
是：每种元素是如何使用MiniSeriesID或MiniSeriesTitle元素来标识MiniSeries的？
MiniSeriesID: 确保其与MiniSeries.ID值（详细消息中的WorkID）匹配。
MiniSeriesTitle: 确保其与MiniSeries.Title值完全匹配，包括大小写。

可能涉及的元素

MiniSeries.ID
MiniSeries.Title
MiniSeriesEpisodes.MiniSeriesID
MiniSeriesEpisodes.MiniSeriesTitle

警告： Possible invalid string found for optional CastMember Role element（为CastMember角色选填元素查找的字符串可能无效）

详细消息： WorkID Please confirm that text is a valid Role (character name)

示例：

tt123456 Please confirm that Actor is a valid Role (character name)
tt123456 Please confirm that Unknown is a valid Role (character name)

问题所在

这个警告非常具有针对性。目前仅用于查找CastMember.Role元素中的“Unknown”（无名氏）或“Actor”（演员）值。角色元素存在的意义就是为演员在作品中饰演的人物提供姓名，如Han Solo。顾名思义，CastMember下的所有条目都是演员。换言之，“Actor”或“Unknown”在极少数情况下可能是有效的人物名。在这种情况下，如果不想在报告中看到此警告，就要尽可能改写条目，如“Actor #1”（演员1号）或“The Unknown”（无名氏）。请注意，如果您添加角色元素却将其留空，则将收到不同警告。

解决方法

在您的CDF文件中查找具有给定ID的作品元素。查找其Credits部分。查找其中包含的CastMember元素，并在角色元素中定位具有“Actor”或“Unknown”的任何元素。Role为选填元素，如果不想知道人物名，则可以忽视此元素。否则，添加人物名。

可能涉及的元素

WorkType.Credits.CastMember.Role
WorkType可以是Movie、TvShow、TvSeason、TvEpisode、MiniSeries、MiniSeriesEpisode或Extra。

警告： Quality element in Offer is deprecated in favor of Quality element in LaunchDetails（Offer的Quality元素已弃用，改用LaunchDetails的Quality元素）

详细消息： WorkID

问题所在

CDF架构虽已更改，但您的文件使用的还是旧架构提供的元素。在这种情况下，自CDF版本1.2起，每种服务类型的Quality元素均已移动至新的Offers.OfferType.LaunchDetails元素下，其他内容保持不变。您的文件仍将Quality元素直接置于Offers.OfferType下。

解决方法

严格来说，您无需进行任何操作。您可以继续使用现有Quality值。但要获取一份简洁的引入报告，您应该在资源允许的情况下更新文件。

如果您的CDF文件是由媒体数据库自动生成的：需要更新从数据库获取信息并将其转换为CDF格式的脚本或转换规则。联系数据库管理员 (DBA) 并告知其现在应该将Quality值导出到Offers.OfferType.LaunchDetails.Quality元素，而不是导出到Offers.OfferType.Quality。DBA可以查阅目录数据格式 (CDF) XSD，了解LaunchElement是否得到妥善安置。
如果您的数据库结构与CDF格式匹配：同样，您的DBA需要执行此更改操作。在这种情况下，需要稍微重新设计数据库，以匹配更新的CDF结构。
如果您的CDF文件是手动制定的：在您的CDF文件中查找具有给定ID的作品。查找其Offers元素。对目前具有Offers的每种服务类型执行以下操作。OfferType.Quality元素：
1. 添加LaunchDetails元素。位置很重要 - 它应该是SubscriptionOffer和FreeOffer类型最后考虑的元素。
2. 在LaunchDetails元素下添加Quality元素。指定原始元素使用的相同值（标清、高清和超高清）。
3. 删除原始的Offers.OfferType.Quality元素。

更改示例如下：

之前

<Movie>
    ...
    <Offers>|
        <FreeOffer>
            <Quality>HD</Quality>
            ...
        </FreeOffer>
        ...
    </Offers>
    ...
</Movie>

之后

<Movie>
    ...
    <Offers>|
        <FreeOffer>
            ……
            <LaunchDetails>
                <Quality>HD</Quality>
            </LaunchDetails>
        </FreeOffer>
        ...
    </Offers>
    ...
</Movie>

可能涉及的元素

WorkType.Offers.OfferType.Quality（已弃用）
WorkType.Offers.OfferType.LaunchDetails.Quality
WorkType可以是Movie、TvShow、TvSeason、TvEpisode、MiniSeries、MiniSeriesEpisode或Extra。
OfferType可以是SubscriptionOffer或FreeOffer

警告： ReleaseInfo element is deprecated（ReleaseInfo元素已弃用）

详细消息： WorkID Please use the ReleaseDate / OriginalAirDate / ReleaseYear element instead for WorkType

示例：

tt123456 Please use the ReleaseDate element instead for ShowType
tt45678 Please use the OriginalAirDate element instead for EpisodeType

问题所在

CDF架构虽已更改，但您的文件使用的还是旧架构提供的元素。在这种情况下，自CDF版本1.3起，已弃用适用于全部作品类型的ReleaseInfo元素，以作品类型特定值替代。ReleaseInfo包含两个子元素： ReleaseDate和ReleaseCountry。ReleaseCountry信息已不再可用。ReleaseDate信息目前根据作品类型进行存储： Movie、TvShow和MiniSeries类型的ReleaseDate；TvEpisode和MiniSeriesEpisode类型的OriginalAirDate。

解决方法

严格来说，您无需进行任何操作。您可以继续使用现有ReleaseInfo.ReleaseDate值。但要获取一份简洁的引入报告，您应该在资源允许的情况下更新文件。

如果您的CDF文件是由媒体数据库自动生成的：需要更新从数据库获取信息并将其转换为CDF格式的脚本或转换规则。联系您的数据库管理员 (DBA) 并告知以下信息：
- 将之前包含在WorkType.ReleaseInfo.ReleaseDate中的作品发行日期导出到适用于TvEpisode的WorkType.OriginalAirDate，以及适用于Movie、TvShow和MiniSeries类型的MiniSeriesEpisode types和WorkType.ReleaseDate。
- 应删除ReleaseInfo元素。
  
  DBA可以查阅目录数据格式 (CDF) XSD，了解详细信息。
如果您的数据库结构与CDF格式匹配：同样，您的DBA需要执行此更改操作。在这种情况下，需要稍微重新设计数据库，以匹配更新的CDF结构。
如果您的CDF文件是手动制定的：在您的CDF文件中查找具有给定ID的作品。查找ReleaseInfo元素并记下ReleaseDate值。
如果作品类型为Movie、TvShow或MiniSeries：添加包括值在内的ReleaseDate元素，作为作品元素下的最后一项内容。
如果作品类型为TvEpisode或MiniSeriesEpisode：添加包括值在内的OriginalAirDate元素，作为作品元素下的最后一项内容。
无论哪种作品类型：在添加新元素后，删除原有的ReleaseInfo元素。

可能涉及的元素

WorkType.ReleaseInfo（已弃用）
WorkType.ReleaseInfo.ReleaseDate（已弃用）
WorkType.ReleaseInfo.ReleaseCountry（已弃用）
WorkType可以是Movie、TvShow、TvSeason、TvEpisode、MiniSeries、MiniSeriesEpisode或Extra。

Movie.ReleaseDate
TvShow.ReleaseDate
MiniSeries.ReleaseDate
TvEpisode.OriginalAirDate
MiniSeriesEpisode.OriginalAirDate

警告： Role (character name) is optional but should not be blank if supplied（角色（人物名称）为选填项，如有则应填写）

详细消息： WorkID Role (character name) for person is blank

示例：tt123456 Role (character name) for Errol Flynn is blank

问题所在

Role元素存在，但不提供信息。角色元素存在的意义就是为演员在作品中饰演的人物提供姓名，如Han Solo。

解决方法

在您的CDF文件中查找具有给定ID（示例中为tt123456）的作品。查找其Credits部分。找到相关人员（示例中为Errol Flynn）的CastMember元素，并定位其Role元素。Role为选填元素，您可以添加人物名，如果人物名未知，您也可以完全删除Role元素。不要使用“Unknown”（无名氏）作为人物名。

可能涉及的元素

WorkType.Credits.CastMember.Role
WorkType可以是Movie、TvShow、TvSeason、TvEpisode、MiniSeries、MiniSeriesEpisode或Extra。

警告： Runtime minutes is not within expected range of 1 to 2880 minutes（运行时的分钟数不在1 - 2880分钟的预期范围内）

详细消息： WorkID Please confirm that nn minutes is the correct runtime

示例：tt123456 Please confirm that 99999999 minutes is the correct runtime

问题所在

您的CDF文件包含RuntimeMinutes元素，其值过大或过小。当此值小于1或大于2880分钟（48小时！）时会触发此警告。很少有作品能够以合法原因超过此范围。应确保最终用户看的信息准确无误，以免破坏用户体验。

解决方法

在您的CDF文件中查找具有给定ID（示例中为tt123456）的作品。查找其RuntimeMinutes元素。确保给定值正确无误。RuntimeMinutes为选填元素，您可以完全删除此元素，但为了保证良好的用户体验，亚马逊不建议您这么做。

可能涉及的元素

WorkType.RuntimeMinutes
WorkType可以是Movie、TvShow、TvSeason、TvEpisode、MiniSeries、MiniSeriesEpisode或Extra。

警告： The ShortDescription should not be the same as the Title（ShortDescription不应与标题相同）

详细消息： WorkID

问题所在

标题元素和ShortDescription元素的文本完全一致，这拉低了用户体验。ShortDescription元素旨在通过2 - 3行的作品摘要，让用户判断自己是否对此感兴趣。用户当时已知标题。

解决方法

在您的CDF文件中查找具有给定ID的作品。查找其ShortDescription元素。将元素中的作品名替换为有关情节或主题的简短描述（2 - 3行）。ShortDescription为选填元素，如果没有描述，则可以完全删除此元素，哪怕亚马逊建议每部作品至少要保留一个ShortDescription。

可能涉及的元素

WorkType.ShortDescription
WorkType可以是Movie、TvShow、TvSeason、TvEpisode、MiniSeries、MiniSeriesEpisode或Extra。

警告： The Synopsis should be longer and more descriptive than the ShortDescription（Synopsis应比ShortDescription更长且更具描述性）

详细消息： WorkID

问题所在

此CDF文件同时包含作品的ShortDescription和Synopsis（剧情简介）。Synopsis文本比ShortDescription更短，但内容并不相同。与2-3行的ShortDescription相比，剧情Synopsis元素旨在对作品进行更详细的描述。

解决方法

在您的CDF文件中查找具有给定ID的作品。查找作品的Synopsis和ShortDescription元素并比较其内容。添加Synopsis扩展内容是提供最佳用户体验的理想解决方案。Synopsis为选填元素，如果您没有与作品相关的更多信息，可以省略此元素。shortDescription虽然是选填元素，但亚马逊建议您至少提供一个此元素。

可能涉及的元素

WorkType.ShortDescription
WorkType.Synopsis
WorkType可以是Movie、TvShow、TvSeason、TvEpisode、MiniSeries、MiniSeriesEpisode或Extra。

警告： The Synopsis should not be the same as the ShortDescription（Synopsis不应与ShortDescription相同）

详细消息： WorkID

问题所在

此CDF文件同时包含作品的ShortDescription和Synopsis，两者的文本完全一致。与2-3行的ShortDescription相比，Synopsis元素旨在对作品内容进行更详细的描述。

解决方法

在您的CDF文件中查找具有给定ID的作品。查找作品的Synopsis和ShortDescription元素并比较其内容。如果ShortDescription超过2 - 3行，则缩减内容。否则，扩展Synopsis的内容，以打造最佳用户体验。Synopsis为选填元素，如果您没有与作品相关的更多信息，可以省略此元素。ShortDescription虽然是选填元素，但亚马逊建议您至少提供一个此元素。

可能涉及的元素

WorkType.ShortDescription
WorkType.Synopsis
WorkType可以是Movie、TvShow、TvSeason、TvEpisode、MiniSeries、MiniSeriesEpisode或Extra。

警告： The Synopsis should not be the same as the Title（Synopsis不应与Title相同）

详细消息： WorkID

问题所在

Title元素和Synopsis元素的文本完全一致，这拉低了用户体验。Synopsis元素旨在保存内容摘要，帮助用户了解作品内容。用户当时已知标题。

解决方法

在您的CDF文件中查找具有给定ID的作品。查找其Synopsis元素。将此元素中作品名称替换为有关情节或主题的描述。Synopsis为选填元素，如果没有描述，则可以完全删除此元素，哪怕这并非理想做法。

可能涉及的元素

WorkType.Synopsis
WorkType可以是Movie、TvShow、TvSeason、TvEpisode、MiniSeries、MiniSeriesEpisode或Extra。

警告： Text contains characters that are escaped more than once（文本中的字符经过多次转义）

详细消息： WorkID Element contains characters that are escaped more than once

示例：

tt123456 MiniSeriesTitle contains characters that are escaped more than once
tt234567 SeasonTitle contains characters that are escaped more than once
tt345678 ShortDescription contains characters that are escaped more than once
tt456789 ShowTitle contains characters that are escaped more than once
tt567890 Title contains characters that are escaped more than once

问题所在

XML序列化器（代码可能使用其提取数据库的数据，并将其转换为目录XML文件）已将转义字符中的和号(&)替换为转义后的和号(&)。文本中的转义字符表示代码实体，如•表示破折号，&表示和号。序列化程序没有将转义字符考虑在内，而是将其作为纯文本处理，对所有和符号进行了转义。这导致“•”变成了“—”，并显示为“•”。您希望呈现为“this & that”的“this & that”字符串变成了“this & that”，其显示为“this & that”。

解决方法

在您的CDF文件和源数据库中，使用给定ID和详细消息中指定的文本元素（Title、ShowTitle、SeasonTitle、ShortDescription或MiniSeriesTitle）查找作品。如果双重转义字符仅存在于您的目录文件中，则问题在于创建目录文件时的转换操作。尽可能在原始文本中使用非转义字符。您也可以为序列化器指示转移字符串，以便正确识别这些字符。

可能涉及的元素

MiniSeriesEpisode.MiniSeriesTitle
TvEpisode.SeasonTitle
TvEpisode.ShowTitle
TvSeason.ShowTitle
WorkType.ShortDescription
WorkType.Title
WorkType可以是Movie、TvShow、TvSeason、TvEpisode、MiniSeries、MiniSeriesEpisode或Extra。

警告： TvSeason is not associated with any TvEpisodes（TvSeason与TvEpisodes无关）

详细消息： WorkID

问题所在

您的CDF文件包含TvSeason条目，但是没有任何剧集。这可能会破坏用户体验，因为用户虽然能看到并选择播出季，但打开后是空白内容。造成这种情况的原因主要有两个。一个是CDF文件中没有TvEpisode元素。另一个是这些剧集虽然在CDF文件中，但却指定了错误的播出季。

解决方法

在您的CDF文件中查找适用于此季的所有预期的TvEpisode元素。是否存在此类元素？

否：您需要添加此类元素。
是：每种元素是如何使用SeasonID或SeasonInShow元素来标识播出季的？
SeasonID： 确保其与TvSeason.ID值（详细消息中的WorkID）匹配。
SeasoninShow： 确保其与TvSeason.SeasonInShow值匹配。

可能涉及的元素

TvSeason.ID
TvEpisode.SeasonTitle
TvEpisode.SeasonID
TvEpisode.SeasonInShow

警告： TvShow is not associated with any TvEpisodes（TvShow与TvEpisodes无关）

详细消息： WorkID

问题所在

您的CDF文件包含TvShow条目，但是没有任何剧集。这可能会破坏用户体验，因为用户虽然能看到并选择节目，但打开后是空白内容。造成这种情况的原因主要有两个。一个是CDF文件中没有TvEpisode元素。另一个是这些剧集虽然在CDF文件中，但却指定了错误的节目。

解决方法

在您的CDF文件中查找适用于此节目的所有预期的TvEpisode元素。是否存在此类元素？

否：您需要添加此类元素。
是：每种元素是如何使用ShowID或ShowTitle元素来标识节目的？
ShowID： 确保其与TvShow.ID值（详细消息中的WorkID）匹配。
ShowTitle： 确保其与TvShow.Title值完全匹配，包括大小写。

可能涉及的元素

TvShow.ID
TVshow.title
TvEpisode.ShowID
TvEpisode.ShowTitle

警告： Unsupported image type.Provided image not JPG or PNG format（不支持此图像类型。提供的图像不是JPG或PNG格式）

请参阅图像相关消息。

建议

除“无效图像”以外的建议不会妨碍您的目录成功更新。这些建议旨在鼓励通过最佳实践改善最终用户体验。

建议

Aspect ratio should be between %f and %f (%f to %f preferred.)
Image height must be greater than %d pixels (greater than %d pixels preferred)
Invalid image
Provide cast and crew information for better search and browse integration
Provide only one ShortDescription/Synopsis per locale
Provide the Count for CustomerRating for better data quality and user experience

建议： Aspect ratio should be between %f and %f (%f to %f preferred.)（宽高比应该为%f或%f（首选%f或%f。））

请参阅图像相关消息。请注意，此消息可以显示为警告或建议，视严重程度而定。

建议： Image height must be greater than %d pixels (greater than %d pixels preferred)（图像高度必须大于%d像素（首选大于%d像素））

请参阅图像相关消息。请注意，此消息可以显示为警告或建议，视严重程度而定。

建议： Invalid image（图像无效）

请参阅图像相关消息。

建议： Provide cast and crew information for better search and browse integration（提供演职人员信息，更高效地实现搜索和浏览集成）

详细消息： WorkID

解决方法

此作品在CDF文件中未添加任何演员或职员信息。添加这些信息可使用户更快地找到作品。例如，用户可能想要搜索由亨弗莱·鲍嘉主演或黑泽明导演的电影。如果不提供演职人员基本信息，用户只能通过搜索片名或浏览结果来查找有关作品。

涉及的元素

WorkType.Credits.CastMember
WorkType.Credits.CrewMember
WorkType可以是Movie、TvShow、TvSeason、TvEpisode、MiniSeries、MiniSeriesEpisode或Etra。

建议： Provide only one ShortDescription/Synopsis per locale（每个区域仅提供一个ShortDescription/Synopsis）

详细消息： WorkID There is more than one ShortDescription/Synopsis with locale of ss

示例

WorkID There is more than one ShortDescription with locale of en-us
WorkID There is more than one Synopsis with locale of fr

解决方法

您的CDF文件可以包含多个条目，其ShortDescription下的区域设置相同，也可以包含多个条目，其Synopsis下的区域设置相同，还可以两者兼有。给定区域只能有一个ShortDescription和一个Synopsis。在您的CDF文件中查找具有给定ID的作品。查找其ShortDescription元素。如果ShortDescription有多个条目，请查找具有相同区域值的任何条目。根据需要删除条目，只为此区域保留一个条目。重复适用于Synopsis元素的过程。

涉及的元素

WorkType.ShortDescription
WorkType.Synopsis
WorkType可以是Movie、TvShow、TvSeason、TvEpisode、MiniSeries、MiniSeriesEpisode或Extra。

建议： Provide the Count for CustomerRating for better data quality and user experience（提供CustomerRating计数，改善数据质量和用户体验）

详细消息： WorkID

解决方法

CDF文件中的CustomerRating条目提供Count元素选项。Count旨在说明为作品打分的客户数量。人数越多，则评分可信度越高，因为此数字往往会平衡样本不足所导致的偏差。每次更新目录时，您都要跟踪此信息并更新Count和CustomerRating值。

涉及的元素

WorkType.CustomerRating.Count
WorkType可以是Movie、TvShow、TvSeason、TvEpisode、MiniSeries、MiniSeriesEpisode或Extra。

图像相关消息

有关图像的错误、警告和建议会用其他消息没有的方式进行交互。警告和建议一般不会导致目录遭拒。但如果此类错误和建议的数量超过条目数量的50%，则会触发Too many invalid images（无效图像过多）的错误，从而导致目录遭拒。

很多图像问题不是由CDF文件本身引发的，而是由此文件引用的一张或多张图像引发的。解决某些图像问题时可能需要图形设计、图像编辑或服务器访问权限。您可能需要联系制图部门或IT部门来协助解决这些问题。

有关错误的消息

错误： Too many invalid images
警告： Aspect ratio should be between 1:3 and 3:1 (1:2 to 2:1 preferred.)
警告： Image height must be greater than 240 pixels (greater than 480 pixels preferred)

警告： Invalid image

We were unable to retrieve an image from url.The HTTP response was empty.
We were unable to retrieve an image from url.The HTTP connection was unexpectedly closed.
We were unable to retrieve an image from url.The HTTP response was invalid.
We were unable to retrieve an image from url.The HTTP response was status code, reason.
警告： Unsupported image type.Provided image not JPG or PNG format.
建议： Aspect ratio should be between 1:3 and 3:1 (1:2 to 2:1 preferred.)
建议： Image height must be greater than 240 pixels (greater than 480 pixels preferred)

建议： Invalid image

No image present for item.Please provide image if available.

错误： Too many invalid images（无效图像过多）

详情消息： nn% invalid images or fewer allowed; nn% found.See the warnings and suggestions section for details.

问题所在

存在少量无效图像（出于丢失或不可用原因）并不会导致引入失败，此时您只会看到警告和建议。但如果目录中存在足够数量的无效图像，就会导致失败。此阈值为约50%。请注意，缺少作品图像即视为无效图像，因此您目录中至少要有50%的作品包含有效图像。

解决方法

有关引入时遇到的图像相关问题，请参阅引入报告中的警告和建议部分。查找并更正您在报告中发现的所有警告和建议实例。

涉及的元素

WorkType.ImageUrl
WorkType可以是Movie、TvShow、TvSeason、TvEpisode、MiniSeries、MiniSeriesEpisode或Extra。

警告/建议： Aspect ratio should be between 1:3 and 3:1 (1:2 to 2:1 preferred.)（宽高比应该为1:3或3:1（首选1:2或2:1。））

详细消息： WorkID Unsupported aspect ratio nn for image url.Please provide acceptably sized image.

问题所在

这不是CDF文件的问题，而是所引用图像的问题。此图像的宽高比超出了亚马逊目前的要求，要么过于细长，要么过于扁平。

您需要了解的事项

亚马逊希望宽高比为1:2或2:1。如果提交图像的宽高比为1:3或3:1，则您将收到将图片裁剪为1:2或2:1的建议消息。但当裁剪图像的高度小于240像素时，则弃用此图像。

如果您提交的图像宽高比不是1:3或3:1，则您将收到此警告消息，并且此图像会计入无效图像总数，从而导致目录遭拒。

解决方法

在您的CDF文件中查找具有给定ID（示例中为tt123456）的作品。查找其含有的ImageUrl标签。此URL会指明图像文件位置。向图形设计部门提供此URL，说明您需要裁剪此图片，使宽高比保持在1:3或3:1（如果是1:2或2:1则不用裁剪），同时确保图像高度不低于480像素，即使裁剪后也是如此。请确保修正图像的URL不变。如有，请更新CDF文件中的ImageUrl值。

可能涉及的元素

WorkType.ImageUrl
WorkType可以是Movie、TvShow、TvSeason、TvEpisode、MiniSeries、MiniSeriesEpisode或Extra。

警告： Image height must be greater than 240 pixels (greater than 480 pixels preferred)（图像高度必须大于240像素（首选大于480像素））

详细消息： WorkID Image height nn is below acceptance criteria for url.Please provide acceptably sized image.

问题所在

这不是CDF文件的问题，而是所引用图像的问题。作品引用的图像虽然有合适的宽高比，但高度却不足所需的480像素。亚马逊倾向于480像素的图像高度。如果图像高度在240到480像素之间，则您将收到此建议消息。如果图片高度低于240像素，则您将收到此警告消息，并且此图像会计入无效图像总数，从而导致目录遭拒。

解决方法

在您的CDF文件中查找具有给定ID的元素。查找其含有的ImageUrl标签。此URL会指明图像文件位置。向图形设计部门提供此URL，说明图像高度应不低于240像素（首选480像素或更高像素），同时确保图像宽高比为1:3或3:1（如果是1:2或2:1则不用裁剪）。请确保修正图像的URL不变。如有，请更新CDF文件中的ImageUrl值。

可能涉及的元素

WorkType.ImageUrl
WorkType可以是Movie、TvShow、TvSeason、TvEpisode、MiniSeries、MiniSeriesEpisode或Extra。

警告： Invalid image（图像无效）

详细消息： WorkID We were unable to retrieve an image from url.The HTTP response was empty.

问题所在

向图像存储服务器发出图像提供请求后，虽然响应代码显示请求成功，但响应结果中却没有标题或正文，也没有图像。

解决方法

这不是CDF文件的问题，而是服务器的通信问题。如果后续报告中仍存在此问题，则在您的CDF文件中查找具有给定ID的作品，并找到其ImageUrl标签。向IT部门返回URL，说明图像检索请求返回空值，要求相关人员进行调查。

可能涉及的元素

WorkType.ImageUrl
WorkType可以是Movie、TvShow、TvSeason、TvEpisode、MiniSeries、MiniSeriesEpisode或Extra。

警告： Invalid image（图像无效）

详细消息： WorkID We were unable to retrieve an image from url.The HTTP response was unexpectedly closed.

问题所在

向图像存储服务器发出图像提供请求后，服务器连接意外关闭，无法检索图像。

解决方法

这不是CDF文件的问题，而是服务器的通信问题。这种情况很可能是一次性问题，等到下次报告时尝试重现此问题即可。如果图片请求继续返回此警告，则向IT部门提供图像文件URL，并说明系统一直未使用有效HTTP响应来响应检索请求。相关人员应能够基于此信息开展深入调查。

可能涉及的元素

WorkType.ImageUrl
WorkType可以是Movie、TvShow、TvSeason、TvEpisode、MiniSeries、MiniSeriesEpisode或Extra

警告： Invalid image（图像无效）

详细消息： WorkID We were unable to retrieve an image from url.The HTTP response was invalid.

问题所在

向图像存储服务器发出图像提供请求后，但返回的响应消息在某种程度上是乱码。

解决方法

这不是CDF文件的问题，而是服务器的通信问题。这种情况很可能是一次性问题，等到下次报告时观察其是否重复即可。如果图片请求继续返回此警告，则向IT部门提供图像文件URL，并说明系统一直未使用有效HTTP响应来响应检索请求。相关人员应能够基于此信息开展深入调查。

可能涉及的元素

WorkType.ImageUrl
WorkType可以是Movie、TvShow、TvSeason、TvEpisode、MiniSeries、MiniSeriesEpisode或Extra。

警告： Invalid image（图像无效）

详细消息： WorkID We were unable to retrieve an image from url.The HTTP response was status code: reason.

问题所在

向图像存储服务器发出图像提供请求后，但返回的响应代码说明存在问题且未返回图像。

解决方法

这不是CDF文件的问题，而是服务器的通信问题。向IT部门提交图像文件的URL和响应结果的状态码和原因。相关人员应能够基于此信息开展深入调查。问题可能在于请求无效、服务器可用性或防火墙问题、有效负载大小问题、离线服务器等诸多因素。

可能涉及的元素

WorkType.ImageUrl
WorkType可以是Movie、TvShow、TvSeason、TvEpisode、MiniSeries、MiniSeriesEpisode或Extra。

另请参阅

HTTP/1.1：状态码定义

警告： Unsupported image type.Provided image not JPG or PNG format.（不支持此图像类型。提供的图像不是JPG或PNG格式）

详细消息： WorkID Unsupported image type ext for url.Images should be in JPG or PNG format.

问题所在

CDF文件已指定非JPG或PNG格式的图像文件。

解决方法

使用给定ID在CDF文件中查找作品。查找其ImageUrl元素。此URL指定了图像文件的位置。您可能需要联系图形设计部门将图像转换为支持格式（JPG或PNG），也可以自己在图形程序中打开文件，将其另存为支持类型之一。某些文件类型在转换后可能会降低图像质量，因此需要比较初始版和新版，确保新版图像的质量符合要求。使用新版图像替换服务器上的图像。您可能需要更新CDF文件中的ImageUrl元素，才能与新图像名称匹配。

可能涉及的元素

WorkType.ImageUrl
WorkType可以是Movie、TvShow、TvSeason、TvEpisode、MiniSeries、MiniSeriesEpisode或Extra。

建议： Invalid Image（图像无效）

详细消息： WorkID No image present for item.Please provide image if available.

问题所在

CDF文件尚未为此作品指定图像。

解决方法

虽然给定作品的ImageUrl为选填元素，但必须有至少50%的作品条目使用此元素提供有效图像。否则会触发Too many invalid images（无效图像过多）的错误，这会导致已上传的目录遭到拒绝。如果超出50%的阈值且并未添加作品图像，则亚马逊将尝试使用IMDb等外部图像来源。因此，您需要提供充分的作品信息，以便与外部来源匹配。如果缺少其他任何图像，则亚马逊将提供通用占位符，但这会导致用户体验不够理想。

涉及的元素

WorkType.ImageUrl
WorkType可以是Movie、TvShow、TvSeason、TvEpisode、MiniSeries、MiniSeriesEpisode或Extra。

Last updated: 2023年12月18日