@things-factory/integration-msgraph 10.1.257 → 10.1.259

package/helps/integration/task/msgraph-calendar-meetings.md

@@ -0,0 +1,40 @@
+# Microsoft 365 회의 일정 조회
+
+커넥션에 연결된 Microsoft 365 테넌트에서 여러 사용자의 회의 일정을 조회합니다. 조회 기간은 오늘을 기준으로 이전 일수와 이후 일수로 지정합니다.
+
+회의 본문은 조회하지 않습니다. 제목, 시작·종료 시각, 주최자, 참석자와 초대 응답, 온라인 회의 여부, 장소를 조회합니다. 비공개·기밀 일정과 다른 참석자가 없는 일정은 제외합니다. 취소된 회의는 연동 대상 일정에도 취소 상태를 반영할 수 있도록 `cancelled`로 표시해 반환합니다.
+
+종료된 Teams 회의는 참석 보고서에서 참석자별 실제 참석 시간(초)을 조회합니다. 참석 보고서를 조회할 수 없는 회의는 실제 참석 시간 없이 반환합니다.
+
+## 필요한 권한
+
+- 애플리케이션 권한 `Calendars.ReadBasic.All`과 관리자 동의가 필요합니다. Exchange 애플리케이션 접근 정책으로 조회 가능한 메일함을 직원의 메일함으로 제한합니다.
+- 실제 참석 시간을 조회하려면 애플리케이션 권한 `OnlineMeetingArtifact.Read.All`, 관리자 동의, 회의 주최자에 대한 Teams 애플리케이션 접근 정책이 필요합니다. 주최자의 회의 정책에서 참석 보고서를 사용하도록 설정해야 합니다.
+
+## 파라미터
+
+- `mailboxes` — 조회할 메일 주소 목록입니다. 쉼표로 구분합니다.
+- `mailboxesAccessor` — 이전 단계의 결과에서 메일함 목록을 가져올 경로입니다(예: `people.employees.items`). 메일 주소 목록이나 직원 목록을 사용할 수 있습니다. 직원 목록이 `employees`의 `items` 형식(`active`, `user { email }`)이면, 재직 중이며 사용자 계정이 연결된 직원의 메일 주소를 사용합니다.
+- `daysBefore` — 오늘을 기준으로 조회할 이전 일수입니다. 기본값은 14일입니다.
+- `daysAfter` — 오늘을 기준으로 조회할 이후 일수입니다. 기본값은 14일입니다.
+
+## 결과
+
+- `from` · `to` — 조회 기간입니다.
+- `mailboxes` — 조회에 성공한 메일함 목록입니다.
+- `failed` — 조회하지 못한 메일함과 실패 사유입니다. 메일함이 없거나 접근 정책에서 허용하지 않는 경우 등이 포함됩니다. 일부 메일함 조회에 실패해도 나머지 메일함은 계속 조회합니다. 요청한 메일함을 모두 조회하지 못하면 단계가 실패합니다.
+- `meetings` — 회의 목록입니다. 각 항목은 다음 정보를 포함합니다.
+  - `mailbox`: 조회한 메일함
+  - `id`: 개별 회의 일정의 식별자(반복 회의도 일정별로 구분)
+  - `subject`, `start`, `end`, `organizer`: 제목, 시작·종료 시각, 주최자
+  - `attendees`: 참석자별 `email`, `name`, `response`
+  - `online`, `location`: Teams 온라인 회의 여부, 장소
+  - `response`: 메일함 소유자의 초대 응답
+  - `attendance`: 참석자별 `email`, 실제 참석 시간인 `seconds`. 조회할 수 없으면 `null`
+  - `cancelled`: 취소 여부
+
+## Office 일정에 반영
+
+다음 단계의 `local-graphql-mutate`에서 `importEvents(calendar: "Teams", source: "MSGRAPH", reading: $reading)`를 호출합니다. 변수 `reading`에 이 단계의 전체 결과(예: `meetings`)를 전달하면 사업장 일정에 반영됩니다.
+
+조회에 성공한 메일함과 연결된 해당 기간의 회의가 더 이상 조회 결과에 없으면, 진행 예정이거나 연기된 회의를 취소 처리합니다. 이미 진행 완료로 기록된 회의는 유지합니다. 반영된 일정은 내 업무 달력과 주간업무보고에서 사용합니다.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@things-factory/integration-msgraph",
-  "version": "10.1.257",
+  "version": "10.1.259",
   "main": "dist-server/index.js",
   "browser": "client/index.js",
   "things-factory": true,
@@ -26,8 +26,8 @@
   "dependencies": {
     "@azure/identity": "^3.1.3",
     "@microsoft/microsoft-graph-client": "^3.0.5",
-    "@things-factory/integration-base": "^10.1.257",
+    "@things-factory/integration-base": "^10.1.259",
     "cross-fetch": "^3.0.4"
   },
-  "gitHead": "885b594299601ca4936f4f39701d6713273bbf1e"
+  "gitHead": "e7283779ee700b4b124226f0ad22d7c1e4063ae7"
 }

package/translations/en.json

@@ -8,5 +8,9 @@
   "label.prompt": "prompt",
   "label.select": "select",
   "label.skip": "skip",
-  "label.top": "top"
+  "label.top": "top",
+  "label.mailboxes": "mailboxes",
+  "label.mailboxes-accessor": "mailboxes accessor",
+  "label.days-before": "days before",
+  "label.days-after": "days after"
 }

package/translations/es.json

@@ -8,5 +8,9 @@
   "label.prompt": "prompt",
   "label.select": "select",
   "label.skip": "skip",
-  "label.top": "top"
+  "label.top": "top",
+  "label.mailboxes": "buzones",
+  "label.mailboxes-accessor": "ruta de buzones",
+  "label.days-before": "días antes",
+  "label.days-after": "días después"
 }

package/translations/ja.json

@@ -8,5 +8,9 @@
   "label.prompt": "プロンプト",
   "label.select": "select",
   "label.skip": "skip",
-  "label.top": "top"
+  "label.top": "top",
+  "label.mailboxes": "メールボックス一覧",
+  "label.mailboxes-accessor": "メールボックス一覧のパス",
+  "label.days-before": "過去の日数",
+  "label.days-after": "先の日数"
 }

package/translations/ko.json

@@ -3,10 +3,14 @@
   "label.body": "body",
   "label.client-secret": "클라이언트 시크릿",
   "label.filter": "필터",
-  "label.orderby": "정열",
+  "label.orderby": "정렬 기준",
   "label.path": "path",
   "label.prompt": "프롬프트",
   "label.select": "select",
   "label.skip": "skip",
-  "label.top": "top"
+  "label.top": "top",
+  "label.mailboxes": "메일함 목록",
+  "label.mailboxes-accessor": "메일함 목록 경로",
+  "label.days-before": "이전 조회 일수",
+  "label.days-after": "이후 조회 일수"
 }

package/translations/ms.json

@@ -8,5 +8,9 @@
   "label.prompt": "prompt",
   "label.select": "pilih",
   "label.skip": "langkau",
-  "label.top": "atas"
+  "label.top": "atas",
+  "label.mailboxes": "peti mel",
+  "label.mailboxes-accessor": "laluan peti mel",
+  "label.days-before": "hari sebelum",
+  "label.days-after": "hari selepas"
 }

package/translations/zh.json

@@ -8,5 +8,9 @@
   "label.prompt": "提示",
   "label.select": "select",
   "label.skip": "skip",
-  "label.top": "top"
+  "label.top": "top",
+  "label.mailboxes": "邮箱列表",
+  "label.mailboxes-accessor": "邮箱列表路径",
+  "label.days-before": "之前天数",
+  "label.days-after": "之后天数"
 }