検証ルールと説明
データ型別の照合ルールと検証ルール
| データ型 | 照合ルール | 検証規則 | 格納される値 |
|---|---|---|---|
| 一意の ID * | 大文字と小文字の区別 | 受信したとおり | |
| Enum** | 大文字と小文字を区別しない | 小文字に一致 | camelCase として |
| String | 大文字と小文字の区別 | 受信したとおり | |
| 電子メール | 小文字を付ける | RFC 5532 (3.4.1) | 小文字を付ける |
| Date または DateTime | ISO8601 | ISO8601 | ISO8601 |
| Phone | E.164 | E.164 | 受信したとおり |
| ブール型 | 大文字と小文字を区別しない | 'true' または 'false' に一致します | 小文字を付ける |
*レコードはすべてのレコードで一意です。 グローバル一意識別子ですが、ユニバーサル一意識別子 (UUID) の形式をとっている場合とそうでない場合があります。
** 成績レベル列挙型の受信値に先行ゼロ '0' が見つからない (例: '1') は、定義された値のリスト (ENUM) '01' と一致し、'01' として格納されます。
** 既定の ENUM 値の詳細については、「 値の既定の一覧」を参照してください。
プラス記号が使用され、電話番号によって成功する E.164 標準に基づいて、電話と SMS のフィールドの書式が設定されることを想定しています。または、プラス記号の後に国コード、市域コード、電話番号、および行番号が続きます。 (例: +1234567890)
ルールと説明
| [ルール名] | ルールの説明 | 状態 | ルール アクション | フレンドリ メッセージの例 | 発生元 (ソースまたはMicrosoft Entra IDへの書き込み) |
|---|---|---|---|---|---|
| 内部アプリケーション エラー | 予期しないエラーが発生しました。 | 致命的なエラー | データの実行を停止する | 処理中にアプリケーション エラーが発生しました: {error} | データの接続 & データの管理 |
| ファイルが見つかりません | 必要なファイルが見つかりませんでした。 | 致命的なエラー | データの実行を停止する | パスに {expectedFileName} が見つかりません: {Path}。 {Name} のパスをチェックして、{expectedFileName} が存在するか、ファイルの名前が {expectedFileName} であることを確認し、同期を再実行してください。 | データの接続 |
| 操作が取り消されました | データの実行中に、取り消す必要がある問題が発生しました。 | 致命的なエラー | データの実行を停止する | {cancelMessage} というメッセージで操作が取り消されました。 | データの接続 |
| ヘッダーが存在しない | 定義されたファイル ヘッダーを含む処理のために、適切な形式のファイルが送信されていることを確認します。 | 致命的なエラー | データの実行を停止する | {fileName} で {expectedHeaderName} が見つかりません。 抽出を修正して、追加するか、{expectedHeaderName} と読み取っていることを確認してください。 修正されたファイルをアップロードし、同期を再実行します。 | データの接続 |
| ヘッダー内の重複した列 | 定義されたファイル ヘッダーを含み、同じヘッダーの倍数ではなく、適切に書式設定されたファイルが処理のために送信されるようにするため。 | 致命的なエラー | データの実行を停止する | {fileName} に 2 つ以上の {expectedHeaderName} が見つかりました。 抽出を修正し、修正したファイルをアップロードし、同期を再実行してください。 | データの接続 |
| 無効なファイル形式 | サポートされていないファイルまたはフォルダーが圧縮ファイル (zip) に存在する場合。 | 致命的なエラー | データの実行を停止する | アーカイブ検証に失敗しました。 アーカイブ {archiveName} でサポートされていないファイル {fileInArchive} が見つかりました。 | データの接続 |
| 重複するファイルが見つかりました | アーカイブにアーカイブの外部にもアップロードされるファイルが含まれている場合。 例: users.csv と users.zip がアップロードされ、users.zip にも users.csv が含まれています。 | 致命的なエラー | データの実行を停止する | アーカイブ検証に失敗しました。 アーカイブ {archiveName} と外部アーカイブに重複 {fileInArchive} が見つかりました。 | データの接続 |
| 重複ファイルが見つかりました | 複数のアーカイブで重複するファイルが見つかった場合。 例: users.zip と relationship.zip がアップロードされ、relationship.zip にも users.csv が含まれています。 | 致命的なエラー | データの実行を停止する | アーカイブ検証に失敗しました。 アーカイブ {archiveName1}、{archiveName2} に重複 {fileInArchive} が見つかりました。 | データの接続 |
| 相互参照マッピングが見つかりません | リンクされたデータが、指定されている関連データ全体で見つかったことを検証します (例: ユーザーのorganizationがありません。登録のセクションがありません)。 | Error | 投稿からレコードを削除します | ソース [{fileName}/{apiEndPoint}] から {record} の {entityType} レコードが見つかりませんでした。 {entityType} sourcedId と {record} sourcedId が正しいことを確認するか、ソース システム内のデータを更新して同期を再実行します。 | データの接続 & データの管理 |
| 省略可能な相互参照マッピングが見つかりません | リンクされたデータが、指定されている関連データ全体で見つかったことを検証します (例: ユーザーのorganizationがありません。登録のセクションがありません)。 | 警告 | レコードから値を削除し、転記用のレコードを送信します | {record} に対して {entityType} のフィールド {field} の省略可能な参照値 {value} が無効であり、処理を続行するためにレコードから値が削除されました。 {entityType} sourcedId と {record} sourcedId が正しいことを確認するか、ソース システム内のデータを更新して同期を再実行します。 | データの接続 |
| 日付時刻形式エラー | 渡されるデータ値に適切な形式 (ISO8601) があることを確認します。 | Error | 投稿からレコードを削除します | {field} の {record} from source [{fileName}/{apiEndPoint}] には、適切な形式ではない日付 ('YYYY-MM-DD') があります。 | データの接続 & データの管理 |
| 必要なデータが見つからない | レコードの必須フィールドの欠損値を検出する。 | Error | 投稿からレコードを削除します | {record} に必要な値がフィールド名に含まれていない: {field} from source [{fileName}/{apiEndPoint}] を使用してレコードを作成します。 | データの接続 & データの管理 |
| 値の書式設定エラー | フィールドに渡されるデータが定義された書式と一致することを確認します。 データ型別の照合ルールと検証ルールも参照してください。 | Error | 投稿からレコードを削除します | {field} でソース [{fileName}/{apiEndPoint}] から見つかった {record} には、{field} の適切な形式の値がありません。 | データの接続 & データの管理 |
| 解析エラー | 各レコードに対して、データを正しい列に関連付けられるようにします。 単一のコンマ、キャリッジ リターンが見つかった、または引用符が見つからないため、レコードにフラグが設定される可能性があります。 | Error | 投稿からレコードを削除します | ソース [{fileName}/{apiEndPoint}] から [if api: {apiEndpoint}] を解析して列内のデータを検索できません。 ファイル内の区切り記号が 1 つのコンマ (,) であり、フィールド内のキャリッジ リターンが許可されていないことを確認します。 コンマと二重引用符を含むフィールドは、二重引用符で囲む必要があります。 二重引用符を使用してフィールドを囲む場合は、フィールド内に表示される二重引用符を別の二重引用符で囲んでエスケープする必要があります。 | データの接続 |
| 最大フィールド長制約に違反しました | 渡されるデータがフィールド長を超えないようにするため、データが欠落します。 | Error | 投稿からレコードを削除します | {record} の {field} に指定された値が、{length} 文字のサポートされる最大長を超えています。 | データの接続 |
| 参照コードが無効または見つからない | レコードに渡される必須フィールドの参照値 [Enum] が、レコードを関連付けるために見つからないかどうかを識別します。 | Error | 投稿からレコードを削除します | {record} の {field} の値 {refValue} が {refCodeEntity} に見つかりません。 ソース システムを修正してください。 | データの接続 |
| 無効な省略可能な参照コード | レコードに渡される省略可能なフィールドの参照値 [Enum] が、レコードを関連付けるために見つからないかどうかを識別します。 | 警告 | レコードから値を削除し、転記用のレコードを送信します | {record} の {field} の値 {refValue} が {refCodeEntity} に見つかりません。 ソース システムを修正してください。 | データの接続 |
| 省略可能なデータに対応する必須値がありません | レコードが省略可能なデータの値を渡している場合、現在値も存在する必要がある追加の関連データも指定されていることを確認します。 | 警告 | レコードから値を削除し、転記用のレコードを送信します | {record} の省略可能なフィールドに値が指定されましたが、データを正常に投稿するために、関連付けられているフィールドに対応する値がありません。 | データの接続 |
| 循環参照 | レコードに親の関連付けが存在する場合に、循環参照が指定されていないことを確認します。 | 警告 | レコードから値を削除し、転記用のレコードを送信します | {entityType}{entityId} は{entityType}(s) {entityList}を使用して循環参照でリンクされています。 {entityParentIdField} の値は、処理を続行するためにレコードから削除されます。 | データの接続 |
| ユーザー マッピング識別子が見つかりません | 構成されたユーザー ID ルールに基づいて値が存在することを確認します。 | Error | 投稿からレコードを削除しました | ユーザー {record} のユーザー マッピング識別子 {identifierType} が見つかりませんでした。 | データの接続 |
| 複数の一致が見つかったユーザー マッピング | 複数のMicrosoft Entraアカウントがこのユーザーと一致していることが判明した場合、最初の AAD アカウントのみが一致に使用されます。 追加の一致が削除されます。 | Error | セカンダリ レコードを転記から削除します | マッピング識別子 {identifierType}={value} を持つユーザー {record} が、Microsoft Entra IDで複数の一致を検出しました。 最初に見つかった一致のみが使用されます。ObjectId {AadObjectId} Microsoft Entra参照してください。 | データの接続 |
| ユーザー マッピングの競合する一致が見つかりました | 既存の一致したMicrosoft Entra アカウントに別のユーザーが自動的に関連付けないようにするため。 | Error | 投稿からレコードを削除します | マッピング識別子 {identifierType}={value} を持つユーザー {record} は、ObjectId {AadObjectId} にマップされている既存のMicrosoft Entraと一致します。 検出された既存の一致が使用され、この一致はスキップされます。 | データの接続 |
| ユーザーが見つからないMicrosoft Entra IDに一致する | 指定されたユーザー レコードが、構成されたユーザー/識別照合ルールに基づいて、Microsoft Entra ユーザーとの一致を見つけることができなかったことを通知します。 | 警告 | レコードがMicrosoft Entra IDに一致しない | マッピング識別子 {identifierType}={value} を持つユーザー {record} が、Microsoft Entra User と一致していません。 これは、指定された値が、構成されたユーザー ID ルールに基づいてソース システムから正しくないか、最新の実行の前に Azure Active Directory Sync がまだユーザーを追加していない可能性があります。 | データの接続 |
| ユーザーの関連付けが見つからない | ユーザー レコードが提供されているが、学生またはスタッフロールとしてorganizationまたは連絡先ロールとして学生に関連付けられていないことを通知します。 | 警告 | 投稿からレコードを削除します | ソース [{fileName}/{apiEndPoint}] のユーザー {record} に、Organization & Role association data または Contact Relationship association data が存在しません。 有効なユーザーの場合は、適切な Organization & ロールまたは連絡先リレーションシップの関連付けを提供するようにソース データを更新してください。 | データの接続 |
| プライマリ ロールが指定されていません | 1 人のユーザーに対して複数のロール レコードが提供されますが、そのうちの 1 つがプライマリ ロールとしてマークされていないことを通知します。 | 警告 | レコードが受信済みとして追加される | ユーザー {record} のソース [{fileName}/{apiEndPoint}] の複数のロール レコードが、同じorganizationのプライマリ ロールとして示されることなく見つかりました。 ソースからこのユーザーのロールの 1 つをプライマリとして指定することをお勧めします | データの接続 |
| 指定された複数のプライマリ ロール | 複数のロール レコードが指定され、複数がプライマリ ロールとしてマークされていることを通知します | 警告 | レコードが受信済みとして追加される | ユーザー {record} のソース [{fileName}/{apiEndPoint}] の複数のロール レコードが見つかり、同じorganizationのプライマリ ロールとして定義されました。 ソースからこのユーザーのロールの 1 つをプライマリとして指定することをお勧めします。 | データの接続 |
| 役割グループの関連付けが見つからないユーザー ロール | ユーザーに有効なロールが提供されていたが、ロールがロール グループに関連付けられていないことを示します。そのため、どの一致するルールを使用する必要があるかがわかりません。 | Error | 投稿からレコードを削除します | ソース [{fileName}/{apiEndPoint}] のユーザー {record} は有効なロール {value} に関連付けられていますが、ロールはロール グループに関連付けられません。 {value} をロール グループに関連付けるには、値の一覧を更新する必要があります。 | データの接続 |
| データの一般的な投稿エラー | レコードを送信すると、エラーが返されました。 | Error | 投稿からレコードを削除します | {error} が原因で {record} を追加できません。 ソース システムをチェックまたは更新して修正してください。 | データの接続 |
| UPN 形式エラー | 使用または生成されたユーザー プリンシパル名が、Microsoft Entra要件を満たすために適切に書式設定されていないことを通知します。 | Error | レコードがMicrosoft Entra IDに投稿されない | ユーザー レコード: {record} には、Microsoft Entra IDでユーザー オブジェクトを作成するための適切な形式のユーザー プリンシパル名 {value} がありません。 [Username]\(ユーザー名\) 構成で選択したフィールドに基づいて、ソース システム内のこのユーザーのレコードのデータを修正してください。 | データ管理 |
| 無効なプロパティ値Microsoft Entra | Microsoft Entra IDに書き込もうとする理由が無効な文字が存在することを通知します | Error | レコードがMicrosoft Entra IDに投稿されない | 1 つ以上の無効なプロパティのため、Active Directory で {record} を作成または更新できません。 {field} の {record} の値を確認して、英数字のみが含まれており、空白文字と 256 文字未満であることを確認します。 ソース システムのデータを修正するか、{FlowName} の特殊文字を置き換えるの設定をアクティブにしてください。 | データ管理 |
| 依存ライセンスが見つからない | 依存ライセンスがレコードに割り当てられていないことを通知します。 | Error | レコードがMicrosoft Entra IDに投稿されない | 依存ライセンスは現在{record}に割り当てられません。 たとえば、Classroom ライセンスでは、{record} に Exchange Online と SharePoint Online のライセンスが既に必要です。 これに対処するには、依存ライセンスを割り当てて同期を再実行します。 | データ管理 |
| 使用可能なライセンスなし | ユーザーに割り当てるライセンスがないことを通知します。 | Error | ライセンスされていないレコード | {record} にライセンスを割り当てませんでした。 ライセンスの有効期限が切れているか、使い果たされました (この種類のすべての使用可能なライセンスが割り当てられている)。 {licenseType} のライセンスを追加して修復し、同期を再実行します。 | データ管理 |
| グループの最後の所有者を削除できない | 既存の同期されたチーム クラス グループの所有者レコードがないことを通知します。 | Error | レコードがMicrosoft Entra IDから削除されない | {teamsType} には少なくとも 1 人の所有者が必要であるため、{record} を {teamsType} から削除できませんでした。 少なくとも 1 人の所有者が割り当てられていることを確認するには、ソース システムまたはチェックフィルター選択のデータをチェックまたは更新してください。 | データ管理 |
| リソース サイズを超えました | レコードに組織の関連付けが多すぎる場合に通知します。 | Error | レコードがMicrosoft Entra IDに投稿されない | {record} が割り当てられている学校が多すぎます (30 を超える)。 不要になった学校から {record} のメンバーシップを削除してください。 | データ管理 |
| 重複するターゲット エントリ | Microsoft Entra IDに同じ sourceId を持つ複数のレコードが存在することを通知します。 | Error | レコードがMicrosoft Entra IDに投稿されない | Active Directory の {record} に対して同じ sourcedId を持つ 2 つ以上のレコードが存在します。 正しくない ID を特定して削除してください。 | データ管理 |
| Microsoft Entra一致が見つかりません | ターゲットがMicrosoft Entra IDに見つからないため、リンクをソースからMicrosoft Entra IDに追加できなかったことを通知します。 | Error | Microsoft Entra IDにリンクされていないレコード | Active Directory で一致するエントリが見つからなかったので、{record} を更新できません。 受信フローの ID 一致条件を確認します。 | データ管理 |
| 既存のオブジェクトが見つかりました | Microsoft Entra IDで同じ sourceId のリンクが既に見つかったことを通知します。 | Error | レコードがMicrosoft Entra IDに投稿されない | {entityType} の {record} は、過去に同じ sourcedId で既に作成されています。 古い {entityType} を廃止または削除してください。 | データ管理 |
| プリンシパル名の形式が無効です | 生成されるユーザー プリンシパル名に予期しない形式が見つかったため、リンクを追加できなかったことを通知します。 | Error | Microsoft Entra IDにリンクされていないレコード | Active Directory で一致するエントリが見つからなかったので、{record} を更新できません。 ユーザー プリンシパル名の形式は予期しない形式です。 | データ管理 |
| オンプレミス所有オブジェクトを同期できない | テナントがオンプレミスから Microsoft 365 テナントに対して Azure Active Directory Sync を使用していることを通知し、AAD のユーザー値に対する変更がソース データから更新されないことを通知します。 | Error | レコードがMicrosoft Entra IDに投稿されない | オンプレミス Active Directory から同期している {record} のプロパティ (名など) を更新できません。 まず、オンプレミス Active Directory で変更を行ってください。 | データ管理 |
| 重複するセキュリティ グループ ID | Microsoft Entra IDで許可されておらず、追加のセキュリティ グループを作成できない特殊文字を削除した後に、重複するセキュリティ グループ ID が生成されたことをテナントに通知します。 | Error | レコードがMicrosoft Entra IDに投稿されない | 複数のセキュリティ グループには、組織 sourcedId の特殊文字が削除された後に重複する識別子値 {identifierSource} があります。 {identifierValue}。 | データ管理 |