Skip to content

Main content

Representation Role Credit Flag Tool

Check an explicitly recorded role credit without inferring a person's gender or uncredited work.

Loading tool…

Description

Require nonempty personCode and queriedRole, test exact role membership in creditedRoles, and format credited or not credited in the label.

Identity and survey records can preserve a person's stated wording, display preference, source, and missing-value convention. A formatter should not infer an identity or turn a recorded label into permission for publication.

Require nonempty personCode and queriedRole, test exact role membership in creditedRoles, and format credited or not credited in the label.

When to use this tool

Use Representation Role Credit Flag when you need to organize supplied identity-related record fields while preserving their stated scope.

How to use the tool and how it works

  1. Enter personCode, creditedRoles, queriedRole. Use the units and conventions below.
  2. Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
  3. Read credited, label. Inspect credited before interpreting the associated values.

Require nonempty personCode and queriedRole, test exact role membership in creditedRoles, and format credited or not credited in the label.1

Input fieldMeaning and unitsAccepted input
personCodePerson CodeRequired. Text; maximum UTF-16 length 8192.
creditedRolesCredited RolesRequired. Array of text; maximum UTF-16 length 8192; maximum items 256.
queriedRoleQueried RoleRequired. Text; maximum UTF-16 length 8192.
Output fieldInterpretationReturned shape
creditedCreditedRequired. Boolean.
labelFormatted label for the supplied components under the convention above.Required. Text; maximum UTF-16 length 8192.
json
{
  "input": {
    "personCode": "P7",
    "creditedRoles": [
      "director",
      "writer"
    ],
    "queriedRole": "writer"
  },
  "output": {
    "credited": true,
    "label": "P7; writer=credited"
  }
}

Limitations and assumptions

  • This tests supplied credit metadata; it does not infer identity, actual contribution, historical accuracy, or appropriate representation.
  • 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

Confirm preferences, consent, source wording, and the purpose of collection before displaying or combining personal records.

References

  1. Calculation and input contract: gender-studies/representation-role-credit-flag — tool.io

Similar or alternative tools