用途:Import 是 Celigo 集成中的数据目的地步骤,从上游接收记录并写入外部系统(REST API、数据库、ERP、文件服务器或 AI 模型)。每个 Import 绑定一个连接和一个 adaptorType。
主要能力:字段映射(默认 Mapper 2.0 的 mappings[];NetSuite 与 Salesforce 仅支持 Mapper 1.0 的 mapping.fields[]/mapping.lists[]);操作逻辑(create、update、upsert、delete、attach/detach);钩子(preMap、postMap、postSubmit,从记录生成文件的导入还支持 postAggregate);一对多(置 oneToMany: true 并用 pathToMany 指向子数组路径);响应映射(在流程 pageProcessors[] 上配置,用 _json.fieldName 提取,采用 Transformation 1.0 的 extract/generate 语法);postResponseMap 钩子。
执行管线顺序:输入过滤、preMap、字段映射、postMap、提交到目的地、postSubmit、响应映射、postResponseMap。
适配器:记录型有 NetSuiteDistributedImport、HTTPImport、SalesforceImport、RDBMSImport、MongodbImport、DynamodbImport、JDBCImport;文件型有 HTTPImport(http.type: "file")、FTPImport、S3Import、AS2Import、FileSystemImport;AI 型有 AiAgentImport、GuardrailImport;另有 WrapperImport、ToolImport。选择顺序为原生适配器、预置连接器、最后才手写 HTTP。adaptorType 区分大小写。
匹配行为:始终创建、缺失才创建、存在才更新、存在才更新(缺失报错)、upsert 五种;需确定匹配键、匹配时动作与未匹配时动作。优先在导入层做匹配,而非单独 lookup 步骤。无原生 upsert 时可做复合(双端点)导入。
最小必填:name、adaptorType、_connectionId(AiAgentImport/GuardrailImport 非 BYOK 时除外)及适配器配置块。构建步骤:确定目标应用、查现有模式(如 celigo account search、celigo account dependencies import <id>)、查预置连接器(celigo http-connectors list 等)、查询元数据(celigo metadata types、celigo metadata fields)、判断类别、选适配器、写 JSON。
限制:部分细节(如各字段完整定义)需查阅对应 schema 文件;资料未提供收费、平台支持范围与效果保证。