SharePoint からのデータ インポートをコンフィギュレーションする
電子申告 (ER) フレームワークを使用して受信ファイルからデータをインポートするには、インポート処理をサポートする ER 形式をコンフィギュレーションし、データ ソースとしてその形式を使用する宛先タイプのモデル マッピングを実行する必要があります。 データをインポートするには、インポートするファイルに移動する必要があります。 受信ファイルは、ユーザーにより手動で選択できます。 Microsoft SharePoint からのデータのインポートをサポートするための新しい ER 機能を使用すると、このプロセスを無人プロセスとしてコンフィギュレーションできます。 ER コンフィギュレーションを使用して、Microsoft SharePoint フォルダーに格納されているファイルからデータのインポートを実行できます。 この記事では、SharePoint からインポートを完了する方法について説明します。 例では、業務データとして仕入先トランザクションを使用します。
必要条件
この記事に記載の例を完了するには、次のアクセスが必要です:
次のロールのいずれかにアクセスします。
- 電子申告開発者
- 電子申告機能コンサルタント
- システム管理者
アプリケーションで使用するようにコンフィギュレーションされた、Microsoft SharePoint Server のインスタンスへアクセスします。
1099 支払の ER 形式およびモデル コンフィギュレーション。
必須な ER コンフィギュレーションの作成
7.5.4.3 IT サービス/ソリューション コンポーネントの取得/開発 (10677) 業務プロセスの一部である Microsoft Excel ファイルからの ER インポート データタスク ガイドを再生します。 これらのタスク ガイドでは、デザインのプロセスおよび Microsoft Excel ファイルから仕入先トランザクションを対話型でインポートする ER コンフィギュレーションの使用について説明します。 詳細については、Excel 形式で受信ドキュメントを解析する を参照してください。 タスク ガイドが完了すると、次の設定になります。
ER コンフィギュレーション
- ER モデル構成、1099 支払モデル
- ER 形式コンフィギュレーション、Excel から仕入先のトランザクションをインポートするための形式
データのインポートに対する受信ファイルのサンプル
- Excel ファイル 1099import-data.xlsx と、インポートする必要がある仕入先トランザクション。
メモ
仕入先トランザクションをインポートするための形式が既定のモデル マッピングとして選択されます。 したがって、1099 支払モデルのモデル マッピングを実行し、そのモデル マッピングが宛先タイプの場合、モデル マッピングは外部ファイルからデータをインポートするこの形式を実行します。 続いてそのデータを使用して、アプリケーション テーブルを更新します。
ファイル ストレージの SharePoint へのアクセスをコンフィギュレーションする
電子レポート ファイルを SharePoint の場所に保管するには、現在の会社によって使用される SharePoint Server のインスタンスへのアクセスをコンフィギュレーションする必要があります。 この例では、会社は USMF です。 手順については、SharePoint ストレージのコンフィギュレーション を参照してください。
SharePoint ストレージのコンフィギュレーション で手順を完了します。
コンフィギュレーションされた SharePoint サイトを開きます。
受信した電子申告ファイルを保存できる次のフォルダーを作成します。
- ファイルのインポート ソース (メイン) (次のスクリーン ショットに示された例)
- ファイルのインポート ソース (代替)
(オプション) インポート後にファイルを保存できる次のフォルダーを作成します。
- ファイル アーカイブ フォルダー - このフォルダーは正常にインポートしたファイル用です。
- ファイル警告フォルダー - このフォルダーは警告付きでインポートしたファイル用です。
- ファイル エラー フォルダー - このフォルダーはインポートに失敗したファイル用です。
組織管理 > ドキュメント管理 > ドキュメント タイプへ移動します。
作成した SharePoint フォルダーにアクセスするために使用される次のドキュメント タイプを作成します。 手順については、ドキュメント タイプのコンフィギュレーション を参照してください。
| 文書種類 | グループ化 | 保管場所 | SharePoint フォルダー |
|---|---|---|---|
| SP メイン | ファイル | SharePoint | ファイルのインポート ソース (メイン) |
| SP 代替 | ファイル | SharePoint | ファイルのインポート ソース (代替) |
| SP アーカイブ | ファイル | SharePoint | ファイル アーカイブ フォルダー |
| SP 警告 | ファイル | SharePoint | ファイル警告フォルダー |
| SP エラー | ファイル | SharePoint | ファイル エラー フォルダー |
ER 形式の ER ソースをコンフィギュレーションします。
組織管理>電子申告>電子申告ソースの順にクリックします。
電子申告ソースページで、コンフィギュレーション済の ER 形式を使用してデータ インポートのソース ファイルをコンフィギュレーションします。
.Xlsx 拡張子のファイルのみがインポートされるように、ファイル名マスクを定義します。 ファイル名マスクはオプションであり、定義された場合にのみ使用されます。 ER 形式ごとにマスクを 1 つだけ定義できます。
複数のインポート用ファイルが存在し、インポート順序が重要ではない場合は、ファイルをインポート前に並べ替える を 並べ替えない に変更します
以前に作成したすべての SharePoint フォルダーを選択します。
メモ
- ER ソースは、アプリケーションの会社ごとに個別に定義されます。 対照的に、ER コンフィギュレーションは会社間で共有されます。
- ER 形式の ER ソース設定を削除すると、接続されているすべてのファイルの状態 (以下を参照) も確認によって削除されます。
ER 形式のファイルの状態を確認します。
電子申告ソースページで、ソースのファイル状態を選択して現在の ER 形式のコンフィギュレーション済ファイル ソースの内容を確認します。
ファイルセクションで、ファイルの一覧を確認します。 このリストは、次のものを表します。
- 該当するソース ファイルは、ファイル名マスク (ファイル名マスクが定義されている場合) に基づいており 、データのインポートの準備が整っています。 これらのファイルについては、インポート フォーマットのソース ログセクションは空白になります。
- 以前にインポートされたファイル。 これらの各ファイルについては、インポート フォーマットのソース ログセクションで、このファイルのインポートの履歴を確認できます。
組織管理>電子申告>ソースのファイルの状態の順に選択することにより、ソースのファイルの状態ページを開くこともできます。 この場合、ページではすべての ER 形式のファイル ソースに関する情報、つまりファイル ソースが現在サインインしている会社でコンフィギュレーションされたという情報が提供されます。
SharePoint フォルダーにある Excel ファイルからのデータをインポートする
SharePoint では、仕入先トランザクションを含む Microsoft Excel ファイル 1099import data.xlsx を、以前に作成したファイルのインポート ソース (メイン) SharePoint フォルダーにアップロードします。
ソースのファイルの状態ページで、更新を選択してページを更新します。 SharePoint にアップロードされた Excel ファイルは、このページに 準備完了 という状態で表示されました。 次のステータスは、現在サポートされています。
- [準備 ] : フォルダー内の新しいファイルごとに SharePoint されます。 このステータスは、ファイルがインポートの準備ができていることを意味します。
- [インポート ] : 他のプロセス (多数が同時に実行されている場合) によってファイルが使用を防ぐために、インポート プロセスによってロックされる場合に、ERレポートによって自動的に割り当てられます。
- [インポート ] : ファイルのインポートが正常に完了すると、ERレポートによって自動的に割り当てられます。 このステータスは、インポートされたファイルがコンフィギュレーション済ファイル ソース (SharePoint フォルダー) から削除されたことを意味します。
- [失敗 ] : ファイルのインポートがエラーまたは例外で完了した場合に、ERレポートによって自動的に割り当てられます。
- [保留 ] : このページでユーザーによって手動で割り当てられます。 このステータスは、ファイルが現在インポートされないことを意味します。 このステータスは、いくつかのファイルのインポートを延期するために使用されます。
データを SharePoint ファイルからインポート
ER コンフィギュレーション ツリーを開き、1099 支払モデルを選択し、ER モデル コンポーネントの一覧を展開します。
選択した ER モデル構成のモデルのマッピングの一覧を開くためのモデル マッピングの名前を選択します。
実行を選択し、選択したモデル マッピングを実行します。 ER 形式のファイル ソースをコンフィギュレーションしたため、必要に応じてファイル ソースオプションの設定を変更できます。 このオプションの設定を維持すると、コンフィギュレーション済ソース (この例では SharePoint フォルダー) から .xslx ファイルがインポートされます。
この例では、1 つだけファイルをインポートしています。 ただし、複数のファイルがある場合、SharePoint フォルダーに追加された順序でインポートするよう選択されます。 ER 形式の各実行で、単一の選択されたファイルをインポートします。
モデル マッピングはバッチ モードで 無人 で実行できます。 この場合、バッチがこの ER 形式を実行するたびに、単一のファイルがコンフィギュレーションされたファイル ソースからインポートされます。
ファイルが SharePoint フォルダーから正常にインポートされると、そのフォルダーから削除され、正常にインポートされたファイルのフォルダー、または警告付きでインポートされたファイルのフォルダーに移動されます。 それ以外の場合は、失敗したファイルのフォルダーに移動されるか、失敗したファイルのフォルダーが設定されていない場合にはこのフォルダー内に保持されます。
V-00001 などの伝票 ID を入力し、OK を選択します。
ソースのファイルの状態ページで、更新を選択してページを更新します。
ファイルセクションで、ファイルの一覧を確認します。 インポート フォーマットのソース ログセクションでは、Excel ファイルのインポートの履歴を提供します。 このファイルが正常にインポートされなかったため、SharePoint フォルダーで削除としてマークされます。
ファイルのインポート ソース (メイン) SharePoint フォルダーを確認します。 正常にインポートされた Excel ファイルは、このフォルダーから削除されました。
買掛金勘定>定期処理のタスク>税金 1099>1099s の仕入先決済の順に選択します。
開始日および終了日フィールドに、適切な値を入力します。 手動 1099 トランザクションを選択します。
伝票 V-00001 として SharePoint 上の Excel ファイルからインポートされた仕入先トランザクションが、ページに表示されます。
インポート用 Excel ファイルの準備
以前に使用した Excel ファイルを開きます。 行 3 列 1で、アプリケーションに存在しない仕入先コードを追加します。 行に追加の false 仕入先情報を追加します。
仕入先トランザクションを含む更新済 Excel ファイルをファイルのインポート ソース (メイン) SharePoint フォルダーにアップロードします。
ER コンフィギュレーション ツリーを開き、1099 支払モデルを選択し、ER モデル コンポーネントの一覧を展開します。
データのインポート処理中に不適切な仕入先コードがエラーと見なされるよう、モデル マッピングを更新するモデル マッピングの名前を選択します。
デザイナー をクリックします。
検証タブで、アプリケーションでインポートされた仕入先勘定が存在するかどうかを評価するようコンフィギュレーションされた、検証ルールの検証後のアクションを変更する必要があります。 後検証アクションフィールドの値を実行停止に更新し、変更内容を保存し、ページを閉じます。
変更内容を保存し、ER モデル マッピング デザイナーを閉じます。
実行を選択し、変更した ER モデル マッピングを実行します。
V-00002 などの伝票 ID を入力し、OK を選択します。
情報ログには、正しくない仕入先勘定が含まれたファイルが SharePoint フォルダーにあり、インポートできないという通知が含まれています。
ソースのファイルの状態ページで更新を選択し、次にファイルセクションでファイルの一覧を確認します。
インポート形式のソース ログセクションでは、インポート プロセスが失敗したこと、およびファイルがまだ SharePoint フォルダーの中にあることを示します (削除済チェック ボックスが選択されていません)。 適切な仕入先コードを追加して SharePoint 上でこのファイルを修正してから、ファイルのインポート ソース (メイン) の SharePoint フォルダーに移動すると、ファイルを再度インポートできます。
買掛金勘定>定期処理のタスク>税金 1099>1099s の仕入先決済の順に選択し、開始日および終了日フィールドで適切な値を入力し、手動 1099 トランザクションを選択します。
伝票 V-00001 のトランザクションのみが使用可能です。 Excel ファイルで最後にインポートされたトランザクションのエラーが見つかった場合でも、伝票 V-00002 のトランザクションは存在しません。
制限
Dynamics 365 Finance のバージョン 10.0.25 より前のバージョンでは、ER フレームワークのユーザー インターフェイス (UI) に、データ インポート用に無人モードでモデル マッピングを実行する、新しいバッチ ジョブを開始する機能を用意していません。 代わりに、構成された ER モデル マッピングをアプリケーション UI から呼び出して、受信ファイルからデータをインポートできるように、新しいロジックを開発する必要があります。 このロジックを開発するには、多少の技術的な作業が必要です。
関連する ER API の詳細については、Application update 7.3 での ER フレームワーク API の変更 の データ インポート用の形式マッピングを実行するためのコード セクションを参照してください。 Application Suite モデルの BankImport_RU クラスでコードを確認して、カスタム ロジックを実装する方法を確認します。 BankImport_RU クラスは、RunBaseBatch クラスを拡張します。 特に、ERIModelMappingDestinationRun オブジェクトが ER モデル マッピングのランナーとして作成される runER() メソッドを確認します。
Finance バージョン 10.0.25 以降では、ER フレームワーク UI に、無人モードでデータ インポート用にモデル マッピングを実行する、新しいバッチ ジョブを開始する機能があります。 このプロセスの詳細については、手動で選択したファイルからバッチ モードでデータをインポートする を参照してください。