Microsoft Teams용 적응형 카드 개요Overview of Adaptive Cards for Microsoft Teams


적응형 카드는 정보 블록을 공유 및 표시하는 플랫폼에 구애받지 않는 메서드로, 렌더링을 위해 CSS나 HTML을 복잡하게 사용자 지정할 필요가 없습니다.Adaptive Cards are a platform-agnostic method of sharing and displaying blocks of information without the complexity of customizing CSS or HTML to render them. 적응형 카드는 JSON 형식으로 작성하며, 클라우드 앱과 서비스의 공개 교환이 가능하도록 통합됩니다.You author Adaptive Cards in JSON format, with integrations that cloud apps and services can openly exchange. Microsoft Teams와 같은 특정 호스트로 전달되면 JSON은 호스트에 맞게 자동 조정되는 네이티브 UI로 변환됩니다.When delivered to a specific host, such as Microsoft Teams, the JSON is transformed into native UI that automatically adapts to its host. 따라서 프로세스 디자이너는 비즈니스 프로세스/자동화의 일부로 정보를 표시해야 할 때면 언제든 UI 패턴을 일관되게 제공할 수 있습니다.Therefore, process designers can now offer consistent UI patterns whenever they need to display information as part of a business process/automation.

적응형 카드는 호스트에 맞게 조정되므로 Microsoft Teams와 다른 서비스 간에 정보를 공유하는 데 적합합니다.Since Adaptive Cards adapt to their host, they are perfect vehicles for sharing information between Microsoft Teams and other services.

적응형 카드 스크린샷

흐름에 현재 사용 가능한 작업Currently available actions for flows

작성자는 다음 작업을 통해 Microsoft Teams 적응형 카드를 만들 수 있습니다.The following actions enable makers to create Adaptive Cards for Microsoft Teams. 통합 시나리오가 향상됨에 따라 다른 호스트에도 Power Automate가 지원되며, 이로 인해 Microsoft 클라우드 구독 전반에 걸쳐 적응형 카드를 활용할 기회가 늘어나게 됩니다.As integration scenarios evolve, other hosts will also be supported by Power Automate, which will extend your opportunities to leverage Adaptive Cards throughout Microsoft cloud subscriptions.

Teams 구성원이나 AAD 사용자에게 콘텐츠 전달Directing content to Teams members or AAD users

  • 사용자에게 고유한 적응형 카드를 Flow 봇으로 게시Post your own adaptive card as the Flow bot to a user
    이 작업을 수행하면 적응형 카드가 특정 사용자에게 Flow 봇으로 게시됩니다.This action posts an adaptive card as a Flow bot to a specific user. 이 경우 받는 사람의 이메일 주소를 제공해야 하며, 흐름이 실행되는 동안 받는 사람의 채팅 및 작업 피드에 카드가 표시됩니다.In this case, you will need to provide a recipient email address, and the card will show up in the recipient's chat and/or activity feeds during the flow run. 사용자가 이러한 유형의 적응형 카드를 받기 위해 Teams 인스턴스의 구성원이 되는 데 필요한 요구 사항은 없습니다.There is no requirement for the user to be part of a Teams instance to receive these types of Adaptive Cards. 이 경우 URL 단추만이 흐름 내에 구성된 URL로 리디렉션하는 기능을 수행합니다.In this case, only the URL buttons function by redirecting to the URL that's configured within the flow.

    적응형 카드 샘플

  • Teams 사용자에게 적응형 카드를 Flow 봇으로 게시하고 응답 대기Post an adaptive card as the Flow bot to a Teams user, and wait for a response
    이 작업을 수행하면 이 문서에서 앞서 다룬 사례와 마찬가지로 적응형 카드가 특정 사용자에게 Flow 봇으로 게시됩니다.This action posts an adaptive card as a Flow bot to a specific user, like the case presented earlier in this article. 그러나 이 경우에 흐름은 게시 이후 받는 사람이 카드 내에서 필요한 입력에 응답할 때까지 실행을 계속하지 않습니다.However, in this case the flow run will not continue after the post until the recipient responds to inputs that are required within the card. 받는 사람이 응답하면 흐름이 계속됩니다.The flow continues after the recipient responds. 흐름은 카드별로 받는 사람 한 명당 하나의 응답에 대해 동적 콘텐츠를 반환합니다.The flow returns dynamic content for one (1) response per recipient and per card.

Teams 채널에 콘텐츠 전달Directing content to Teams channels

  • 채널에 고유한 적응형 카드를 Flow 봇으로 게시Post your own adaptive card as the Flow bot to a channel
    이 작업을 수행하면 적응형 카드가 특정 Teams 채널에 Flow 봇으로 게시됩니다.This action posts an adaptive card as a Flow bot to a specific Teams channel. 이 경우에는 Teams 인스턴스와 카드가 게시될 채널을 묻는 메시지가 표시됩니다.In this case, you will be prompted for Teams instance, and a channel where the card will be posted. 흐름 작성자에게는 적응형 카드 게시를 위한 Teams 인스턴스 액세스 권한이 있어야 합니다.The flow-maker will have to have access to the Teams instance in order to post an adaptive card there. 이 경우 URL 단추만이 흐름 내에 구성된 URL로 리디렉션하는 기능을 수행합니다.In this case, only URL buttons function by redirecting to the URL configured within the flow.

  • Teams 채널에 적응형 카드를 Flow 봇으로서 게시하고 응답 대기Post an adaptive card as the Flow bot to a Teams channel, and wait for a response
    위의 사례와 마찬가지로 이 작업을 수행하면 적응형 카드가 특정 Teams 채널에 Flow 봇으로 게시됩니다.This action posts an adaptive card as a Flow bot to a specific Teams channel as in the case above. 그러나 이 경우에 흐름은 채널에서 카드 내에서 필요한 입력이 응답될 때까지 계속되지 않습니다.However, in this case the flow will not continue until someone on the channel has responded to any inputs required within the card. 흐름은 Teams 채널의 누구든 응답하면 계속되지만 카드별로 응답자 한 명당 하나의 응답에 대해서만 동적 콘텐츠를 반환합니다.The flow will continue once the anyone in the Teams channel responds but will only return dynamic content for one (1) response per responder and per card.

    이 카드를 사용하면 흐름이 Teams 구성원의 응답을 기다리게 됩니다.When you use this card, the flow waits for a response from any Teams member.

알려진 문제Known issues

  • ‘응답 대기’ 작업 중 하나를 사용하여 만들어진 것이 아니라면 적응형 카드의 데이터를 수집할 수 없습니다.It is not possible to collect data from Adaptive Cards unless they are created using one of the "wait for a response" actions. 대기하지 않는 적응형 카드는 OpenURL을 제외한 모든 단추 작업의 오류를 반환합니다.Adaptive Cards that don't wait return an error for all button actions except OpenURL. OpenURL 단추에서 자세히 알아보세요.Learn more on OpenURL buttons.

  • ‘응답 대기’ 접미사가 포함되지 않은 카드에서 ‘Action.Submit’ 단추를 선택하면 오류가 발생합니다.Selecting Action.Submit buttons on a card which doesn't include the "wait for a response" suffix, will throw an error.

  • ‘응답 대기’ 작업을 사용하여 만들어진 적응형 카드는 카드별로 1회만 제출이 가능합니다.Adaptive Cards created using the "wait for response" actions can only be submitted once per card. 흐름 실행은 첫 응답 이후 계속되며 이후의 제출은 모두 무시됩니다.The flow run will continue after the first response, and any further submissions are ignored.

  • ‘메시지 업데이트’ 입력 상자(이미지 3 참조) 내의 정보만 사용자의 카드 제출 이후 대체 카드에 표시됩니다.Only the information within the ‘Update message’ input box (see image 3) will be shown on the replacement card after consumers submit the card.

    카드 제출자의 사용자 ID 같은 추가 세부 정보는 ‘응답 대기’ 작업 이후 작업 내 동적 콘텐츠에서 확인할 수 있습니다.Additional details, such as the user id of the person submitting the card, will be available within the dynamic content in actions following the ‘wait for a response’ action. 그러나 카드 제출자를 위한 필요 프로필 정보 입력을 위해 Office 365 사용자 커넥터를 포함해야 할 수 있습니다.However, it may be necessary to include the Office 365 Users connector in order to complete desired profile information for the user who submitted the card.

  • 대체/메시지 업데이트 영역이 구성되지 않았을 경우 ‘응답 대기’ 적응형 카드가 제출되고 나면 카드가 초기화된 다음 동일하게 표시됩니다.Once the "wait for a response" Adaptive Cards are submitted, the card resets and then appears exactly the same, unless the replacement/update message area is configured. 메시지 업데이트는 모범 사례로, 기타 업데이트 실행뿐만 아니라 고객이 카드를 2회 이상 제출하는 것을 방지하기 위해 권장됩니다.Update messages are a best practice, and are recommended in order to update others, but also to prevent consumers from attempting to submit the card more than once.

    메시지 업데이트

메시지 업데이트카드를 업데이트해야 함 입력은 대체 카드가 필요할 때 구성해야 합니다.The Update Message and the Should update card inputs must be configured if a replacement card is desired.

  • Power Automate는 Microsoft 적응형 카드의 고유한 기능과 서비스를 사용하여 어떤 호스트에서든 카드를 처리합니다.Power Automate uses Microsoft Adaptive Cards' unique features and services to handle the cards within any host. 이 문서는 흐름 작업과 관련된 모든 사항을 명시하기 위해 작성되었습니다.This article is intended to clarify any specifics related to flow actions. 적응형 카드 만들기 전체 설명서를 사용할 수도 있습니다.You can also use the full documentation for building Adaptive Cards.

자세히 알아보기Learn more