💡
YESOD Excel Add-in 機能説明（エクスポート／インポート）
YESOD Excel Add-in のヘルプです。Excel のタスクペイン（画面右側）から YESOD のデータを エクスポート／インポートできます。SharePoint または OneDrive 上の Excel ファイルでのみ動作します。
できること（機能概要）エクスポートインポートはじめに（利用前の準備）1) 利用条件2) YESOD 認証情報の登録（初回／変更時）操作タイプの選択エクスポートメンバーエクスポート（概要）グループエクスポート（概要）業務アセットエクスポート（概要）インポート（メンバー／グループ／トランザクション）インポートの基本（共通）「インポート後に適用する」チェックボックス（重要）承認前に内容確認したい場合の推奨フローよくあるエラーと対処
はじめに（利用前の準備）
1) 利用条件
- 本アドインは SharePoint または OneDrive 上のファイルでのみ動作します。
- 設定・認証情報は Excelファイル単位で保存されます。ファイルを共有すると、アドインの設定も共有されます。
2) YESOD 認証情報の登録（初回／変更時）
タスクペイン上部の「YESOD認証情報」セクションで以下を登録します。
- YESOD API URL
- 本番環境：
- staging環境：
- YESOD APIトークン
- YESOD で発行した API トークンを入力します
「認証情報を登録」をクリックして保存します。登録済みの場合はマスクされたトークンが表示され、「認証情報を変更」から再登録できます。
エクスポート
メンバーエクスポート（概要）
- YESOD UI から取得した クエリJSON を貼り付けて実行します。
- 実行すると、Excel の アクティブシートにデータが書き込まれます。
- 任意で、情報取得日、検索期間、表示順序、階層セパレータ、出力オプション（入社日・退職日など）を指定できます。
グループエクスポート（概要）
- グループタイプ（会社／組織／事業所／プロジェクト）を選択して実行します。
- 任意で日付（）を指定できます。省略時は最新時点のスナップショットを取得します。
- ※ グループエクスポートではクエリJSONの入力欄は表示されません（メンバー専用です）。
業務アセットエクスポート（概要）
- 業務アセットID を入力して実行します（YESOD の業務アセット詳細 URL 末尾の文字列）。
- モードは 2 種類です。
- 通常モード：基準日（任意。省略時は最新時点のスナップショット）
- 差分モード：差分エクスポートをONにし、比較期間の開始・終了を指定（指定期間に変更があったレコードのみ出力）
- 業務アセットID／差分フラグ／基準日／比較期間／（グループの場合）グループタイプは、操作のたびに保存され次回復元されます。
インポート（メンバー／グループ／トランザクション）
インポートの基本（共通）
- マッピング（必須）を 形式で入力します（複数行可）。
- 任意で以下を指定できます。
- アプリケーション名：YESOD側で変更履歴の出所として記録される名前
- 変更日：（省略時は実行日）
「インポート後に適用する」チェックボックス（重要）
YESOD の import API は、変更をそのまま承認（反映）するかどうかを切り替えられます。本アドインでは、チェックボックスで挙動が変わります。
- OFF：YESOD に 未承認の変更として登録（あとで YESOD 側で承認が必要）
- ON（初期値）：YESOD に変更を登録し、そのまま承認まで実行（即時反映）
※ OFF は「何も起きない（ドライラン）」ではなく、未承認の変更として登録されます。
承認前に内容確認したい場合の推奨フロー
よくあるエラーと対処
- 「認証に失敗しました」：ページを再読み込み。改善しない場合は認証情報を再登録
- 「ファイルIDが取得できません」：SharePoint または OneDrive 上のファイルを開いて操作
- 「クエリJSONを入力してください」：メンバーエクスポートでクエリJSON欄が空。貼り付けてから実行
- 「クエリJSONのパースに失敗しました」：YESOD UI からダウンロードしたJSONをそのまま貼り付け
- 「業務アセットIDを入力してください」：業務アセットID欄が空。入力してから実行
- 「マッピングを入力してください」：インポートでマッピング欄が空。 形式で入力
- エクスポート／インポートに失敗： 「エラー内容をダウンロード」ボタンで詳細を確認