Microsoft Teams 응용 프로그램 제작에 필요한 Manifest 파일에 대한 설명

4313 단어 MicrosoftTeams
Microsoft Teams용 어플리케이션을 제작하는 데 필요한 Manifest 파일입니다.이 내용에 관해서는 영어 문서만 찾았기 때문에 요점만 정리했지만 일본어로 정리했습니다.
참조: https://msdn.microsoft.com/en-us/microsoft-teams/schema

Manifest 파일이란 부식입니까?


Microsoft Teams용 애플리케이션을 제작할 때 그 애플리케이션의 개요를 적은 JSON 파일입니다.JSON Schema는 여기.에 기재되어 있습니다.이 Manifest 파일과 아이콘 이미지를 모아 Teams 응용 프로그램의 포장을 만듭니다.
Manifest 파일과 아이콘 이미지를 종합한 Teams 응용 프로그램의 포장 샘플은 여기.에 있다.동결해제되면 매니페스트 파일의 샘플과 아이콘 이미지가 있는 샘플을 확인할 수 있습니다.

문서의 중요 부분


JSON Schema와 샘플을 보면 대충 알 수 있을 것 같아요.하나의 중요한 개념은 기본적으로 Teams가 사용하는 응용은 웹 응용 프로그램이고 Manifest 파일에 이 웹 응용 프로그램의 URL을 기록한다는 것이다.몇 가지 중요한 매개 변수를 발췌하여 아래에 기록하다.

"id"


Microsoft App ID.Microsoft Bot Framework를 사용할 때나 Teams용 인터넷 애플리케이션이 이미 Microsoft에 로그인했을 때 이미 Microsoft App ID가 있을 것 같으니 기입해 주십시오.MS 앱 ID가 없으면 MS 앱ication Registration Portal여기.에'앱 추가'를 하면 새로운 MS 앱 ID를 만들 수 있다.이곳에서 만든 마이크로소프트 앱 아이디는 앞으로 봇을 추가하고 싶을 때도 봇이 쓰는 것과 같은 것을 사용할 수 있다.그나저나 로컬 환경에서만 테스트하면 적절한 GUID만 입력하면 된다.

"name"


응용 프로그램 이름입니다.멋진 이름 지어줄게.Office Store에 로그인할 때도 이 이름을 사용합니다.'short'에는 30글자밖에 없기 때문에 프로그램 이름이 길면'full'에 프로그램 이름의 전체 버전을 적으세요.

"description"


응용 프로그램에 대한 설명입니다.알기 쉬운 설명을 써라."name"과 마찬가지로 Office Store에 등록할 때 이쪽과 같은 정보를 기재해야 합니다.'short'에는 80글자,'long'에는 4000글자가 있으니 설명을 빠뜨리지 않도록 주의해라.

"icons"


응용 프로그램 아이콘입니다.20x20의 흰색/투과 PNG 이미지와 96x96의 전색 PNG 이미지 2개를 준비하여 그 경로를 기록합니다.

"staticTabs"


기본적으로 프로그램에 연결된 탭입니다.뒤에 있는'configurable Tabs'는 프로그램의 설정 화면을 표시할 수 있지만 여기에는 이러한 설정 화면이 표시되지 않습니다.이 "staticTabs"는 여러 탭을 준비할 수 있습니다.반대로 "staticTabs"가 필요하지 않으면 이 항목이 필요하지 않습니다.
매개 변수로서 다음과 같은 내용을 휴대하십시오.
  • entityId: 태그를 식별하는 데 사용되는 고유 ID
  • "name": 표시된 탭의 이름
  • "contentUrl": 탭에 표시할 내용의 URL입니다.Https
  • 필요
  • "websiteUrl": 사용자가 브라우저를 통해 보고 싶을 때의 URL입니다.↑와 마찬가지로 문제없음
  • "scopes": 응용 프로그램의 작용 범위."staticTabs"는 여기에 설정된 범위 내에서만 표시됩니다.크게'personal'과'팀'두 가지로 나뉘는데'staticTabs'는 현 단계에서'personal'만 지원한다."personal"을 선택하면 사용자는 응용 프로그램 표시줄에서 이 탭을 보거나, 응용 프로그램이 Bot 응용 프로그램인 경우, Bot 응용 프로그램과의 1:1 대화에서 이 탭을 볼 수 있습니다
  • "configurableTabs"


    화면을 설정하는 라벨이 있습니다."configurable Tabs"가 있지만 현재 단계에서는 하나의 태그만 지정할 수 있습니다.필요하지 않으면 "configurable Tabs"도 생략할 수 있습니다.
    매개변수는 다음과 같습니다."staticTabs"와 달리 "entityId", "name", "contentUrl"을 쓸 필요가 없다는 것을 알 수 있을 것 같습니다.이 매개변수는 configuration Url에 표시된 화면에 설정되어 있기 때문입니다.사용자의 입력에 따라 이 매개 변수를 적절하게 변경합니다.그리고 탭의 내용을 다시 호출합니다.이러한 configuration Url 처리는 JavaScript를 통해 수행됩니다.
  • "configuration Url": 화면에 표시되는 내용을 설정하는 URL
  • "canUpdateConfiguration": Boolean은 탭의 설정을 업데이트할 수 있는지 여부를 표시합니다.기본값은 True
  • 입니다.
  • "scopes": 응용 프로그램의 작용 범위."staticTabs"와 달리 "configurationTabs"는 현재 "팀"만 지원합니다."팀"이면 팀에 앱을 추가했을 때 이 탭
  • 을 볼 수 있습니다.

    "bots"


    Bot을 설정합니다.응용 프로그램은 Bot 응용 프로그램(Bot이 있는 응용 프로그램)에 기재되어 있습니다.길어지니까 따로 설명할게요.Bot 없이 생략할 수 있습니다.

    "permissions"


    응용 프로그램의 권한입니다.응용 프로그램이 요구하는 권한을 여기에 쓰십시오.현재 사용자 정보를 사용하는 데 필요한'identity', 팀원들에게 정보를 보내는 데 필요한'메시지 팀 Members'두 가지를 설정할 수 있다.만약 어느 것도 사용하지 않는다면, 이 매개 변수는 생략할 수 있다.

    "validDomains"


    태그 컨텐트의 URL로 사용되는 도메인입니다.지금까지 탭의 매개 변수로 다양한 URL이 기록되어 있었다고 생각했지만, 이 영역들을 여기에 열거할 필요가 있습니다.반대로 여기에 기재된 영역 이외의 URL은 무효입니다.example.com

    총결산


    모두 문자로 된 마이크로소프트 Teams 응용 프로그램의 Manifest 파일 요점이 기재되어 있지만 이러한 정보는 Teams의 업데이트에 따라 변경될 수 있습니다(특히 "scopes"주위). 주의하세요!

    좋은 웹페이지 즐겨찾기