Microsoft Teams용 적응형 카드 개요

적응형 카드는 정보 블록을 공유 및 표시하는 플랫폼에 구애받지 않는 메서드로, 렌더링을 위해 CSS나 HTML을 복잡하게 사용자 지정할 필요가 없습니다. 적응형 카드는 JSON 형식으로 작성하며, 클라우드 앱과 서비스의 공개 교환이 가능하도록 통합됩니다. Microsoft Teams와 같은 특정 호스트로 전달되면 JSON 파일은 호스트에 맞게 자동 조정되는 네이티브 UI로 변환됩니다. 따라서 프로세스 디자이너는 비즈니스 프로세스/자동화의 일부로 정보를 표시해야 할 때면 언제든 UI 패턴을 일관되게 제공할 수 있습니다.

적응형 카드는 호스트에 맞게 조정되므로 Microsoft Teams와 다른 서비스 간에 정보를 공유하는 데 적합합니다.

적응형 카드 스크린샷.

흐름에 현재 사용 가능한 작업

작성자는 다음 작업을 통해 Microsoft Teams 적응형 카드를 만들 수 있습니다. 통합 시나리오가 향상됨에 따라 다른 호스트에도 Power Automate가 지원되며, 이로 인해 Microsoft 클라우드 구독 전반에 걸쳐 적응형 카드를 활용할 기회가 늘어나게 됩니다.

노트

적응형 카드는 DoD(국방부) 환경에서 사용할 수 없습니다.

Teams 구성원이나 Microsoft Entra 사용자에게 콘텐츠 전달

사용자에게 고유한 적응형 카드를 Flow 봇으로 게시

이 작업을 수행하면 적응형 카드가 특정 사용자에게 Flow 봇으로 게시됩니다. 이 경우 수신자 이메일 주소를 제공해야 합니다. 그러면 흐름이 실행되는 동안 해당 수신자의 채팅 및/또는 활동 피드에 카드가 표시됩니다. 사용자가 이러한 유형의 적응형 카드를 받기 위해 Teams 인스턴스의 구성원이 되는 데 필요한 요구 사항은 없습니다. 이 경우 URL 단추만이 흐름 내에 구성된 URL로 리디렉션하는 기능을 수행합니다.

Teams 사용자에게 적응형 카드를 Flow 봇으로 게시하고 응답 대기

이 작업을 수행하면 이 문서에서 앞서 다룬 사례와 마찬가지로 적응형 카드가 특정 사용자에게 Flow 봇으로 게시됩니다. 그러나 이 경우에 흐름은 게시 이후 받는 사람이 카드 내에서 필요한 입력에 응답할 때까지 실행을 계속하지 않습니다. 받는 사람이 응답하면 흐름이 계속됩니다. 흐름은 카드별로 받는 사람 한 명당 하나의 응답에 대해 동적 콘텐츠를 반환합니다.

Teams 채널에 콘텐츠 전달

  • 채널에 고유한 적응형 카드를 흐름 봇으로 게시
    이 작업을 수행하면 적응형 카드가 특정 Teams 채널에 흐름 봇으로 게시됩니다. 이 경우에는 Teams 인스턴스와 카드가 게시될 채널을 묻는 메시지가 표시됩니다. 흐름 작성자에게는 적응형 카드 게시를 위한 Teams 인스턴스 액세스 권한이 있어야 합니다. 이 경우 URL 단추만이 흐름 내에 구성된 URL로 리디렉션하는 기능을 수행합니다.

  • Teams 채널에 적응형 카드를 흐름 봇으로서 게시하고 응답 대기
    위의 사례와 마찬가지로 이 작업을 수행하면 적응형 카드가 특정 Teams 채널에 흐름 봇으로 게시됩니다. 이 경우 채널의 누군가가 카드에 필요한 입력에 응답할 때까지 흐름이 계속되지 않습니다. 흐름은 Teams 채널의 누구든 응답하면 계속되지만 카드별로 응답자당 하나(1)의 응답에 대해서만 동적 콘텐츠를 반환합니다. 이 카드를 사용하면 흐름이 Teams 구성원의 응답을 기다리게 됩니다.

알려진 문제점

  • 응답 대기 작업 중 하나를 사용하여 생성되지 않는 한 적응형 카드에서 데이터를 수집할 수 없습니다. 대기하지 않는 적응형 카드는 OpenURL을 제외한 모든 단추 작업의 오류를 반환합니다. OpenURL 버튼에 대해 자세히 알아보기

  • 응답 대기 접미사가 포함되지 않은 카드에서 Action.Submit 버튼을 선택하면 오류가 표시됩니다.

  • 응답 대기 작업을 사용하여 만들어진 적응형 카드는 카드별로 1회만 제출이 가능합니다. 흐름 실행은 첫 응답 이후 계속되며 이후의 제출은 모두 무시됩니다.

  • 소비자가 카드를 제출한 후 교체 카드에는 업데이트 메시지 입력 상자 내의 정보만 표시됩니다.

    카드 제출자의 사용자 ID 같은 추가 세부 정보는 응답 대기 작업 이후 작업 내 동적 콘텐츠에서 확인할 수 있습니다. 그러나 카드 제출자를 위한 필요 프로필 정보 입력을 위해 Office 365 사용자 커넥터를 포함해야 할 수 있습니다.

  • 대체/업데이트 메시지 영역이 구성되지 않았을 경우 응답 대기 적응형 카드가 제출되고 나면 카드가 초기화된 다음 동일하게 표시됩니다. 업데이트 메시지가 모범 사례입니다. 다른 사람에게 업데이트하고 소비자가 카드를 두 번 이상 제출하는 것을 방지하기 위해 권장됩니다.

    업데이트 메시지의 스크린샷.

메시지 업데이트카드를 업데이트해야 함 입력은 대체 카드가 필요할 때 구성해야 합니다.

  • Power Automate는 Microsoft 적응형 카드의 고유한 기능과 서비스를 사용하여 어떤 호스트에서든 카드를 처리합니다. 이 문서는 흐름 작업과 관련된 모든 사항을 명시하기 위해 작성되었습니다. 적응형 카드 만들기 전체 설명서를 사용할 수도 있습니다.

참조 항목