故障排除
在使用Import API v2时，您可能会遇到导入操作失败的情况。一些潜在的原因是:
- 输入文件的内容结构无效。
- 缺少命令的一个必选参数。
- 命令定义的导入资源违反了业务约束。
为了帮助您确定失败的原因，下表解释了最常见的错误。在Collibra Console中记录错误代码。新万博移动客户端
通用命令错误
| 错误代码(可见于dgc.log） | 错误消息的结构 | 原因 |
|---|---|---|
| importCommandIdentifierAmbiguous | 有太多或太少的参数来识别{0}。作为一般规则，使用资源ID作为标识符，或者使用资源名和父资源的标识符。同样的规则也适用于父资源的标识符。 | 中只需要特定的属性子集 资产名称和域ID。 其他组合也会导致这个错误。 的部分API导入操作本章举例说明。 |
| importCommandIdentifierNotDefined | 指定识别{0}的标准。 | 导入命令中不包含标识符强制性的财产。 |
| importCommandNotIdempotent | 如果{0}被{1}标识，则不能修改{1}。 | 更改用于标识资源的相同属性。 您更新资产的名称，由名称和域ID标识。 |
| importCommandResourceAmbiguous | 符合指定条件的{0}个数大于一个。 | 标识符没有包含足够的元素来唯一标识一个资源。 |
| importCommandResourceNotFound | 没有匹配指定条件的{0}。 | 资源的强制依赖项不存在。 导入的资产类型不存在。 |
| importCommandResourceTypeInvalid | 资源类型无效。支持的资源类型为:{0}。 | 您正在尝试导入当前不受支持的资源，或者该资源类型拼写错误。 |
| importCommandResourceTypeNotDefined | 资源类型未定义。可选资源类型包括:{0}。 | 导入命令缺少必选项resourceType财产。 |
资产的错误
| 错误代码 (可见dgc.log） |
错误消息的结构 | 原因 |
|---|---|---|
| importCommandAssetAttributeValuesAmbiguous | 资产为一个或多个属性定义了“value”和“values”属性。 | 的价值而且值字段之间互斥。对于资产或复杂关系的import命令中定义的每个属性，只能提供一个属性。 |
| importCommandAssetDisplayNameInvalidLength | 资产显示名称必须在{0}和{1}之间，但必须有{2}字符。 | 资产显示名称长度必须在错误消息中定义的范围内。 |
| importCommandAssetDomainNull | 资产的域没有定义。 | 对于在导入或同步过程中需要添加的资产，域是必需的。 |
| importCommandAssetNameInvalidLength | 资产名称必须在{0}和{1}之间，但必须有{2}字符。 | 资产名称长度必须在错误消息中定义的范围内。 |
| importCommandAssetNameNull | 资产名称未定义。 | 对于在导入或同步过程中需要添加的资产，资产名称是必需的。 |
| importCommandAssetTypeNull | 没有定义资产类型。 | 对于在导入或同步过程中需要添加的资产，资产类型是必需的。 |
资产类型错误
| 错误代码 (可见dgc.log） |
错误消息的结构 | 原因 |
|---|---|---|
| importCommandAssetTypeNameInvalidLength | 资产类型名称必须在{0}和{1}之间，但必须有{2}字符。 | 资产类型名称长度必须在错误消息中定义的范围内。 |
属性类型错误
| 错误代码 (可见dgc.log） |
错误消息的结构 | 原因 |
|---|---|---|
| importCommandAttributeTypeNameInvalidLength | 属性类型名称必须在{0}和{1}之间，但必须有{2}字符。 | 属性类型名称长度必须在错误消息中定义的范围内。 |
社区的错误
| 错误代码 (可见dgc.log） |
错误消息的结构 | 原因 |
|---|---|---|
| importCommandCommunityNameInvalidLength | 团体名必须在{0}和{1}之间，但必须有{2}字符。 | 团体名长度必须在错误消息中定义的范围内。 |
| importCommandCommunityNameNull | 团体名未定义。 | 团体名是在导入或同步过程中需要添加的团体名。 |
复杂关系误差
| 错误代码 (可见dgc.log） |
错误消息的结构 | 原因 |
|---|---|---|
| importCommandComplexRelationRelationsDuplicated | 复杂关系关系ID为“{0}”。 | import命令包含在命令和标识符中定义的重复关系。 |
| importCommandComplexRelationRelationsNull | 复杂关系的关系没有定义。 | 对于在导入或同步期间需要添加的复杂关系，标识关系是必需的。 |
| importCommandComplexRelationTypeNull | 没有定义复杂关系类型。 | 复杂关系类型对于在导入或同步期间需要添加的复杂关系是必需的。 |
复杂关系类型错误
| 错误代码 (可见dgc.log） |
错误消息的结构 | 原因 |
|---|---|---|
| importCommandComplexRelationTypeNameInvalidLength | 复杂关系类型名称必须在{0}和{1}字符之间，但必须有{2}字符。 | 复杂关系类型名称长度必须在错误消息中定义的范围内。 |
域的错误
| 错误代码 (可见dgc.log） |
错误消息的结构 | 原因 |
|---|---|---|
| importCommandDomainCommunityNull | 没有定义域的团体字。 | 对于导入或同步过程中需要添加的域，团体字是必须的。 |
| importCommandDomainNameInvalidLength | 域名的字符长度必须在{0}和{1}之间，但已经有{2}字符。 | 域名长度必须在错误提示中定义的范围内。 |
| importCommandDomainNameNull | 域名未定义。 | 对于导入或同步过程中需要添加的域，域名为必选项。 |
| importCommandDomainTypeNull | 域类型未定义。 | 对于导入或同步过程中需要添加的域，域类型为必选项。 |
域类型错误
| 错误代码 (可见dgc.log） |
错误消息的结构 | 原因 |
|---|---|---|
| importCommandDomainTypeNameInvalidLength | 域类型名称必须在{0}和{1}之间，但已经有{2}字符。 | 域类型名称长度必须在错误消息中定义的范围内。 |
外部标识符错误
| 错误代码 (可见dgc.log） |
错误消息的结构 | 原因 |
|---|---|---|
| importCommandExternalIdentifierExternalEntityInvalidLength | {0}外部实体ID必须是介于{1}和{2}之间的字符，但必须是{3}字符。 | 外部实体ID长度必须在错误消息中定义的范围内。 |
| importCommandExternalIdentifierExternalEntityNull | 如果提供外部系统ID，则必须提供{0}外部实体ID。指定外部实体ID。 | 当您提供外部系统ID时，外部实体ID是必需的。 |
| importCommandExternalIdentifierExternalSystemInvalidLength | {0}外部系统必须有介于{1}和{2}之间的字符，但必须有{3}字符。 | 外部系统ID长度必须在错误消息中定义的范围内。 |
| importCommandExternalIdentifierExternalSystemNull | 如果提供外部实体ID，则必须提供{0}外部系统ID。指定外部系统ID。 | 当您提供外部实体ID时，外部系统实体ID是必需的。 |
映射错误
| 错误代码 (可见dgc.log） |
错误消息的结构 | 原因 |
|---|---|---|
| importCommandMappingExternalEntityIdInvalidLength | 外部实体ID必须是{0}和{1}之间的字符，但必须是{2}字符。 | 外部实体ID长度必须在错误消息中定义的范围内。 |
| importCommandMappingExternalEntityIdNull | 外部实体ID未定义。 | 对于在导入或同步期间需要添加的映射，外部实体ID是必需的。 |
| importCommandMappingExternalSystemIdInvalidLength | 外部系统ID必须在{0}和{1}之间，但必须有{2}字符。 | 外部系统ID长度必须在错误消息中定义的范围内。 |
| importCommandMappingExternalSystemIdNull | 外部系统ID未定义。 | 对于导入或同步过程中需要添加的映射，外部系统ID是必需的。 |
| importCommandMappingResourceAmbiguous | 多个映射匹配指定的条件。 | 映射的输入(JSON命令或CSV/Excel内容)通过多个属性(UUID、团体、域或资产)包含对资源的引用。狗万新闻c |
| importCommandMappingResourceNotFound | 没有匹配指定条件的映射。 | 无法为所提供的标识符找到映射。 |
角色错误
| 错误代码 (可见dgc.log） |
错误消息的结构 | 原因 |
|---|---|---|
| importCommandRoleNameInvalidLength | 角色名必须在{0}和{1}之间，但必须有{2}字符。 | 角色名长度必须在错误消息中定义的范围内。 |
状态错误
| 错误代码 (可见dgc.log） |
错误消息的结构 | 原因 |
|---|---|---|
| importCommandStatusNameInvalidLength | 状态名必须在{0}和{1}之间，但必须有{2}字符。 | 状态名长度必须在错误消息中定义的范围内。 |
标签错误
| 错误代码 (可见dgc.log） |
错误消息的结构 | 原因 |
|---|---|---|
| importCommandTagNameInvalidLength | 标记名必须在{0}和{1}之间，但必须有{2}字符。 | 标记名长度必须在错误消息中定义的范围内。 |
用户错误
| 错误代码 (可见dgc.log） |
错误消息的结构 | 原因 |
|---|---|---|
| importCommandUserNameEmpty | 用户名不能为空。 | 您必须为用户名提供一个值。 |
用户组错误
| 错误代码 (可见dgc.log） |
错误消息的结构 | 原因 |
|---|---|---|
| importCommandUserGroupNameInvalidLength | 用户组名必须在{0}和{1}之间，但已经有{2}字符。 | 用户组名长度必须在错误消息中定义的范围内。 |
一般的错误
| 错误代码 (可见dgc.log） |
错误消息的结构 | 原因 |
|---|---|---|
| importError | 导入失败。 | 没有明显解决方案的问题的一般导入错误。 |
| synchronizationError | 同步失败。 | 没有明显解决方案的问题的一般同步错误。 |
| errorHelp | 行{0}包含以下错误: | N/A |
| importErrorsLines | 行{0}包含以下错误: | N/A |
| importProcessingError | 输入处理未成功完成。 | 对于没有明显解决方案的问题的一般处理错误。 |
| importValidationError | 输入验证未成功完成。 | 对于没有明显解决方案的问题的一般输入验证错误。 |
API请求错误
| 错误代码 (可见dgc.log） |
错误消息的结构 | 原因 |
|---|---|---|
| importRequestFileNotSpecified | 请求必须包含文件ID或文件流，但不能两者都包含。 | 文件ID和文件流是互斥的，请至少提供其中一个。 |
| importRequestFileNotSpecifiedHelp | 在请求中输入文件ID或文件流。 | N/A |
| importRequestFileNameBlank | 您提供了一个文件流。您还必须提供一个文件名。 | 如果使用文件流作为输入参数，则必须提供文件名。 |
导入参数验证错误
| 错误代码 (可见dgc.log） |
错误消息的结构 | 原因 |
|---|---|---|
| importParametersBatchSizeInvalidValue | 预期的批大小值在{0}和{1}之间，但为{2}。 | 批处理大小的值必须在错误消息中定义的范围内。 |
| importParametersCsvSeparatorNull | 必须提供CSV分隔符。指定CSV分隔符。 | CSV分隔符是必选参数。 |
| importParametersCsvQuoteNull | 必须提供CSV引用字符。指定CSV引用字符。 | CSV引用字符为必选参数。 |
| importParametersCsvEscapeNull | 必须提供CSV转义字符。指定CSV转义字符。 | CSV转义字符是一个必选参数。 |
| importParametersExcelSheetAmbiguous | 不能同时提供Excel表格索引和表格名称(表格索引= "{0}"，表格名称= "{1}")。 | Excel工作表索引和Excel工作表名称参数互斥。一次只能提供一个。 |
| importParametersFileIdNull | 必须提供文件ID。 | 文件ID为必选参数。 |
| importParametersSynchronizationIdBlank | 必须为同步操作提供同步ID。指定同步ID。 | 同步ID是同步时必选的。 |
| importParametersSynchronizationIdInvalidLength | 同步ID必须在{0}和{1}之间，但为{2}。 | 同步ID长度必须在错误消息中定义的范围内。 |
| importParametersSynchronizationIdNotNull | 不能为导入操作提供同步ID。 | 不能为常规导入提供同步ID。 |
| importParametersTemplateBlank | 的JSON模板必须提供。 | JSON模板是一个强制参数。 |
| importParametersTemplateInvalid | 的JSON模板是无效的。 | JSON模板不遵循JSON语法。 |
| importParametersTemplatePlaceholderMissing | 的JSON模板必须包含至少一个占位符。 | 您必须在JSON模板中提供至少一个占位符，表示必须从表格文件中检索的数据。 |
| importParametersTemplatePlaceholderInvalid | 的JSON模板必须包含正整数的占位符。 | JSON模板包含'${0}'作为占位符。 |
| synchronizationAdministrationParametersSynchronizationIdBlank | 必须提供同步ID。指定同步ID。 | 同步ID是同步管理的强制参数。 |
| synchronizationAdministrationParametersSynchronizationIdInvalidLength | 同步ID必须在{0}和{1}之间，但为{2}。 | 同步ID的值必须在错误消息中定义的范围内。 |
JSON输入解析错误
| 错误代码 (可见dgc.log） |
错误消息的结构 | 原因 |
|---|---|---|
| importJsonParsingGeneralError | 解析JSON文件时发生错误。 | N/A |
| importJsonParsingErrorWithPosition | 解析JSON文件时发生错误，原因:{0}，本地化于line = {1} and column ={2}。 | N/A |
模板解析错误
| 错误代码 (可见dgc.log） |
错误消息的结构 | 原因 |
|---|---|---|
| importJsonTemplateGeneralError | 对象解析时出错JSON模板，原因:{0}。 | JSON模板不遵循JSON语法。 |
Excel解析错误
| 错误代码 (可见dgc.log） |
错误消息的结构 | 原因 |
|---|---|---|
| importExcelParsingGeneralError | 解析Excel文件时出现错误，原因:{0}。 | 您提供的文件不是有效的Excel文件。 |
| importExcelParsingEmptyFile | Excel表{0}中没有数据。 | 用于导入或同步的Excel表为空。 |
表视图配置解析错误
| 错误代码 (可见dgc.log） |
错误消息的结构 | 原因 |
|---|---|---|
| importTableViewConfigParsingError | 解析TableViewConfig时发生错误。 | 表视图配置不遵循JSON语法或包含意外的JSON节点。 |
并发导入错误
| 错误代码 (可见dgc.log） |
错误消息的结构 | 原因 |
|---|---|---|
| importConcurrentAddEntityWithSameId | 并发导入导致违反约束。 | 同时运行的多个导入或同步作业包含需要添加的相同资源。 |
| importConcurrentAddEntityWithSameIdHelp | 当同一资源被添加两次时，就会发生这种情况。确保多个导入批次中不包含相同的资源。狗万新闻c | N/A |
| importConcurrentEntityUpdate | 并发导入导致更新异常。 | 同时运行的多个导入或同步作业包含需要更新的相同资源。 |
| importConcurrentEntityUpdateHelp | 当同一资源被并行更新时，就会发生这种情况。确保多个导入批次中不包含相同的资源。狗万新闻c | N/A |
同步错误
| 错误代码 (可见dgc.log） |
错误消息的结构 | 原因 |
|---|---|---|
| importSynchronizationFinalizationAlreadyRunning | 当同步ID("{0} ")正在进行清理时，不能启动同步导入。 | 同步的结束步骤正在进行中。在此期间，不能对同一同步ID执行任何其他同步操作。 |
| importFinalizationSynchronizationAlreadyRunning | 当同步ID("{0} ")正在进行导入时，不能启动同步清理。 | 同步操作正在进行。在此期间，不能对相同的同步ID运行终结步骤。 |