如何在ADF中实现管道返回值以统一获取API Token

你要的子管道返回值、统一维护Token逻辑的需求，ADF原生就支持，不需要绕弯用参数或者全局变量，直接按下面的步骤配置就行：

第一步：搭建独立的Token获取管道 #

• 新建专用管道，命名建议用统一前缀比如Common_GetAuthToken，所有和Token请求相关的配置（请求地址、appKey/appSecret签名逻辑、header规则、异常重试逻辑）全放在这个管道里，后续改规则只动这一处。
• 管道内部先添加Web活动，按接口要求配置Token请求，建议加一层响应校验：拿到接口返回后先判断Token字段非空、过期时间格式合法，如果校验失败自动重试1次，减少偶发接口报错影响上层业务。
• 管道内创建两个管道级变量：tokenValue（字符串类型）、tokenExpireTime（字符串类型），添加Set Variable活动，把Web活动返回的Token值、过期时间分别赋值给这两个变量。
• 打开管道编辑界面右上角的管道输出配置面板，把刚才的两个变量添加为管道返回项，保存即可。这一步就是让子管道执行完之后能对外输出值的核心配置，之前没找到返回入口基本都是漏了这步。

第二步：业务管道调用方法 #

• 在所有需要鉴权的业务管道里，不需要重复配置Token请求，直接添加「执行管道」活动，选择刚才建好的Common_GetAuthToken管道，必须勾选「等待完成」选项。
• 活动执行完成后，直接通过固定路径就能拿到返回的Token值，引用表达式为：

  @activity('执行管道活动的自定义名称').output.pipelineReturnValue.tokenValue
  

  把这个表达式直接填到后续拉取数据的Web活动、Rest数据集的Authorization头配置里即可。

短有效期Token适配优化 #

• 不要每次调用业务API都触发一次Token请求，在业务管道启动时先调用一次取Token的子管道，把返回的Token、过期时间存在当前业务管道的变量里，全管道流程共用。
• 如果业务管道整体运行时长超过Token有效期，可以在每段调用业务API的流程前加个If条件活动，判断当前时间和已存Token的过期时间差，如果剩余有效期不足5分钟，就重新调用一次Common_GetAuthToken管道更新本地存的Token变量即可，全程不需要重复写Token请求的复杂配置。

避坑提示 #

• 不要用ADF全局参数存动态Token，全局参数是发布时固定的静态值，运行时无法动态更新，完全不适合短有效期动态Token的场景。
• 子管道返回值不要嵌套过深的结构，直接平铺返回Token、过期时间两个核心字段就行，上层引用不容易写错路径。
• 如果用自托管集成运行时，确保子管道和调用它的上层管道关联的是同一个可用IR，避免跨IR调用失败。

内容的提问来源于stack exchange，提问作者wilson_smyth