部署带XSLT映射/架构的Logic App Standard后Maps页无映射如何解决

问题根因 #

你遇到的问题由两个常见配置错误导致：

• 目录层级不匹配：Logic App Standard 要求 XSLT 映射文件必须存放在站点根目录（wwwroot）下的 Artifacts/Maps/ 路径中，平台才能自动扫描识别。你当前打包时直接将 Maps 文件夹作为压缩包根目录，部署后文件会被放到 wwwroot/Maps/ 路径下，不符合平台的目录规范，因此无法在 Maps 标签页展示。
• 全量覆盖冲突：默认的 zipDeploy 是全量覆盖部署模式，你分开部署工作流和映射文件的操作，会导致后部署的内容直接覆盖先部署的所有站点文件，不仅会丢失之前部署的工作流配置，也无法实现映射文件的增量添加。

解决方案 #

方案一：合并打包部署（推荐） #

将映射、Schema 等构件和 Logic App 工作流核心文件打包到同一个压缩包一次性部署，既保证目录结构正确，也避免覆盖冲突：

1. 调整原工作流构建任务的 CopyFiles 配置，增加 Artifacts 目录的匹配规则：

- task: CopyFiles@2
  displayName: 'Copy Logic App full project files'
  inputs:
    SourceFolder: 'Integrations/'
    Contents: |
      Workflows/**
      Artifacts/**
      host.json
      connections.json
      parameters.json
      azure.parameters.json
    TargetFolder: 'project_output'

2. 后续直接打包整个 project_output 目录做全量部署即可，部署后的目录结构完全符合 Logic App 规范，映射文件会自动被识别展示。

方案二：单独部署映射文件（适用于需要增量更新的场景） #

如果确实需要单独更新映射文件，需要调整打包层级并开启增量部署配置：

1. 修改映射构件的打包逻辑，保留正确的目录层级：

- task: CopyFiles@2
  displayName: 'Copy Maps with correct hierarchy'
  inputs:
    SourceFolder: 'Integrations/'
    Contents: |
      Artifacts/Maps/**
      Artifacts/Schemas/**
    TargetFolder: 'project_output'

- task: ArchiveFiles@2   
  displayName: 'Create maps zip'
  inputs:
    rootFolderOrFile: '$(System.DefaultWorkingDirectory)/project_output'
    includeRootFolder: false
    archiveType: 'zip'
    archiveFile: '$(Build.ArtifactStagingDirectory)/$(Build.BuildId).zip'
    replaceExistingArchive: true

2. 修改部署任务，开启增量部署避免覆盖原有文件：

- task: AzureFunctionApp@1
  displayName: 'Deploy logic app maps'
  inputs:
    azureSubscription: "${{ parameters.connectedServiceName }}"
    appType: 'functionApp'
    appName:  "${{parameters.LA_name}}-${{ parameters.environment }}" 
    package: '$(Pipeline.Workspace)/mapsArtifact/*.zip'
    deploymentMethod: 'zipDeploy'
  env:
    WEBSITE_RUN_FROM_PACKAGE: 0
    SCM_ZIPDEPLOY_DONOT_PRESERVE_FILETIME: 1

验证方法 #

部署完成后进入 Logic App 的 Kudu 高级管理工具，查看 wwwroot 目录下是否存在 Artifacts/Maps/myMap.xslt 文件，存在的话等待 1~2 分钟刷新 Maps 标签页即可看到对应映射。

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