Description
If known, compare requester and document indices in the selected direction and return requester minus document as tierGap; otherwise return gap zero and allowed false.
An access tier or availability window records only part of an authorization policy. Known dates and rank comparisons do not establish identity, consent, or cultural permission to use material.
If known, compare requester and document indices in the selected direction and return requester minus document as tierGap; otherwise return gap zero and allowed false.
When to use this tool
Use Document Access Tier Order when you need a supplied access-metadata consistency check.
How to use the tool and how it works
- Enter documentTier, requesterTier, suppliedOrder, higherIndexAllowsLower. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read known, allowedUnderOrder, tierGap. Inspect known, allowedUnderOrder before interpreting the associated values.
Require duplicate-free suppliedOrder and locate both tiers. If known, compare requester and document indices in the selected direction and return requester minus document as tierGap; otherwise return gap zero and allowed false.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| documentTier | Document Tier | Required. Text; maximum UTF-16 length 8192. |
| requesterTier | Requester Tier | Required. Text; maximum UTF-16 length 8192. |
| suppliedOrder | Supplied Order | Required. Array of text; maximum UTF-16 length 8192; maximum items 256. |
| higherIndexAllowsLower | Higher Index Allows Lower | Required. Boolean. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| known | Known | Required. Boolean. |
| allowedUnderOrder | Allowed Under Order | Required. Boolean. |
| tierGap | Requester index minus document index when both are known; zero placeholder otherwise. | Required. Safe integer. |
{
"input": {
"documentTier": "staff",
"requesterTier": "admin",
"suppliedOrder": [
"public",
"staff",
"admin"
],
"higherIndexAllowsLower": true
},
"output": {
"known": true,
"allowedUnderOrder": true,
"tierGap": 1
}
}Limitations and assumptions
- The unknown-tier zero is a placeholder; this is a supplied order check rather than authentication, access enforcement, or legal permission.
- Inputs must satisfy both the field types and the cross-field conditions above. Invalid input causes an error; a successful false flag or documented placeholder is a different result.
Alternative or Complementary methods
Consult the responsible authority, community protocol, and actual access-control policy before retrieving or reusing material.
References
Similar or alternative tools
- Public Source Access Window Gap
Return nonnegative distances before or after the window and accessibleByDates for inclusive membership.
- Metadata Source Coverage Share
Deduplicate requiredKeys, count those present in sourceKeys, and count those present in both sourceKeys and verifiedKeys.