openiamdocker/http-source-adapter

Http Source Adapter (Workday CSV) 镜像文档

镜像概述

本镜像为基于Workday HTTP请求格式构建的HTTP源适配器，专门用于接收和处理传入的CSV文件。它遵循Workday系统的HTTP请求规范，提供标准化的数据接收、解析及基础处理能力，可无缝集成至企业数据流程中，简化与Workday系统的对接过程。

核心功能与特性

• Workday兼容性：严格遵循Workday HTTP请求格式规范，确保与Workday系统的通信兼容性
• CSV处理能力：支持接收HTTP请求中的CSV文件数据，提供完整的解析功能
• 配置灵活性：支持自定义CSV分隔符、编码格式、请求版本等核心参数
• 数据验证：内置基础数据验证机制，检查文件格式、字段完整性等
• 轻量部署：镜像体积小，资源占用低，支持快速启动和扩展

使用场景与适用范围

• 企业Workday集成：接收Workday系统推送的员工信息、薪酬数据、组织架构等CSV格式文件
• 自动化数据采集：构建企业数据管道，处理来自Workday的定期数据推送任务
• 中间件适配：作为标准化组件，对接需要处理Workday HTTP请求格式的业务系统
• 适用团队：企业IT部门、数据集成团队、HR系统开发团队等需要与Workday对接的技术团队

使用方法与配置说明

基本部署命令

通过docker run快速启动容器：

bash
docker run -d -p 8080:8080 --name workday-csv-adapter \
  -e LISTEN_PORT=8080 \
  -e CSV_DELIMITER=',' \
  -e ENCODING=utf-8 \
  -e WORKDAY_REQUEST_VERSION=v1 \
  [镜像仓库地址]/workday-http-csv-adapter:latest

环境变量配置详解

数据处理流程

1. 请求接收：客户端（如Workday系统）向适配器发送符合Workday HTTP格式的POST请求，请求体包含CSV文件数据
2. 格式验证：适配器验证请求是否符合WORKDAY_REQUEST_VERSION指定的格式规范
3. CSV解析：使用CSV_DELIMITER和ENCODING参数解析CSV数据
4. 数据校验：执行基础数据验证（如必填字段检查、数据类型校验）
5. 结果存储：处理后的数据保存至DATA_OUTPUT_PATH指定目录
6. 响应反馈：向客户端返回处理结果（成功/失败状态及详细信息）

日志与数据持久化

日志查看

通过以下命令查看容器运行日志：

bash
docker logs workday-csv-adapter

数据持久化配置

如需持久化处理后的数据，可通过挂载本地目录实现：

bash
docker run -d -p 8080:8080 --name workday-csv-adapter \
  -e DATA_OUTPUT_PATH=/app/data \
  -v /本地数据目录:/app/data \
  [镜像仓库地址]/workday-http-csv-adapter:latest

Docker Compose配置示例

yaml
version: '3'
services:
  workday-csv-adapter:
    image: [镜像仓库地址]/workday-http-csv-adapter:latest
    container_name: workday-csv-adapter
    ports:
      - "8080:8080"
    environment:
      - LISTEN_PORT=8080
      - CSV_DELIMITER=','
      - ENCODING=utf-8
      - WORKDAY_REQUEST_VERSION=v1
      - DATA_OUTPUT_PATH=/app/data
      - LOG_LEVEL=info
    volumes:
      - ./local-data:/app/data
    restart: unless-stopped