Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Étiquetage d’un fichier de configuration de catégorie d’étiquetage avec la référence d’attributs de catégorie d’étiquette et de trame
<a name="sms-label-cat-config-attributes"></a>

Lorsque vous créez une tâche d'étiquetage de nuages de points ou d'images vidéo en 3D à l'aide de l'opération d' SageMaker API Amazon`CreateLabelingJob`, vous utilisez un fichier de configuration des catégories d'étiquettes pour spécifier vos étiquettes et les instructions de travail. Vous pouvez également fournir ce qui suit dans votre fichier d’attributs de catégorie d’étiquette :
+ Vous pouvez fournir des *attributs de catégorie d’étiquette* pour les types de tâches de suivi et de détection d’objets dans les trames vidéo et les nuages de points 3D. Les employés peuvent affecter un ou plusieurs attributs aux annotations pour fournir plus d’informations sur cet objet. Par exemple, vous pouvez utiliser l’attribut *occluded* pour que les collaborateurs identifient les objets partiellement bloqués. Vous pouvez spécifier un attribut de catégorie d’étiquette pour une seule étiquette à l’aide du paramètre `categoryAttributes` ou pour toutes les étiquettes à l’aide du paramètre `categoryGlobalAttributes`. 
+ Vous pouvez fournir *attributs de trame* pour les types de tâches de suivi et de détection d’objets dans les trames vidéo et les nuages de points 3D à l’aide `frameAttributes`. Lorsque vous créez un attribut d’image, il apparaît sur chaque trame ou nuage de points de la tâche d’employé. Dans les tâches d’étiquetage de trame vidéo, il s’agit d’attributs que les employés attribuent à une trame vidéo entière. Pour les tâches d’étiquetage de nuage de points 3D, ces attributs sont appliqués à un nuage de points unique. Utilisez les attributs de cadre pour que les employés fournissent plus d’informations sur la scène dans une trame ou un nuage de points spécifique.
+ Pour les tâches d’étiquetage de trame vidéo, vous utilisez le fichier de configuration de catégorie d’étiquettes pour spécifier le type de tâche (cadre de délimitation, polyligne, polygone ou point clé) envoyé aux employés. 

Pour les employés, la spécification de valeurs pour les attributs de catégorie d’étiquette et les attributs de trame sera facultative.

**Important**  
Vous ne devez fournir un nom d’attribut d’étiquette dans `auditLabelAttributeName` que si vous exécutez une tâche d’audit pour vérifier ou ajuster des étiquettes. Utilisez ce paramètre pour saisir la valeur [LabelAttributeName](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateLabelingJob.html#sagemaker-CreateLabelingJob-request-LabelAttributeName)utilisée dans la tâche d'étiquetage qui a généré les annotations que vous souhaitez que votre collaborateur ajuste. Lorsque vous créez une tâche d'étiquetage dans la console, si vous n'avez pas spécifié de nom d'attribut d'étiquette, le **nom** de votre tâche est utilisé comme LabelAttributeName.

Les rubriques suivantes montrent des exemples de fichier de configuration de catégorie d’étiquette pour différents types de tâches d’étiquetage. Ils expliquent également le schéma et les quotas d’un fichier de configuration de catégorie.

**Topics**
+ [Exemples : Fichiers de configuration des catégories d’étiquettes pour les tâches d’étiquetage de nuage de points 3D](#sms-label-cat-config-attributes-3d-pc)
+ [Exemples : fichiers de configuration de catégorie d’étiquettes pour les tâches d’étiquetage de trame vidéo](#sms-label-cat-config-attributes-vid-frame)
+ [Schéma du fichier de configuration de catégorie d’étiquette](#sms-label-cat-config-attributes-schema)
+ [Quotas d’attribut d’étiquette et de catégorie d’étiquette](#sms-point-cloud-label-cat-limits)

## Exemples : Fichiers de configuration des catégories d’étiquettes pour les tâches d’étiquetage de nuage de points 3D
<a name="sms-label-cat-config-attributes-3d-pc"></a>

Les rubriques suivantes montrent des exemples de fichiers de configuration de catégories d’étiquettes de nuage de points 3D pour les tâches d’étiquetage de détection d’objets, de suivi d’objets, de segmentation sémantique, d’ajustement et de vérification.

**Topics**
+ [Exemple : suivi d’objets de nuage de points 3D et détection d’objets](#example-3d-point-cloud-object)
+ [Exemple : segmentation sémantique du nuage de points 3D](#example-3d-point-cloud-semantic)
+ [Exemple : ajustement du nuage de points 3D](#example-3d-point-cloud-adjustment)
+ [Exemple : vérification du nuage de points 3D](#example-3d-point-cloud-verification)

### Exemple : suivi d’objets de nuage de points 3D et détection d’objets
<a name="example-3d-point-cloud-object"></a>

Voici un exemple de fichier de configuration de catégorie d’étiquette qui inclut des attributs de catégorie d’étiquette pour une tâche d’étiquetage de détection ou de suivi d’objets de nuage de points 3D. Cet exemple inclut deux attributs de trame, qui seront ajoutés à tous les nuages de points soumis à la tâche d’étiquetage. L'étiquette `Car` inclura quatre attributs de catégorie d'étiquette :`X`, `Y`, `Z` et l'attribut global `W`.

```
{
    "documentVersion": "2020-03-01",
    "frameAttributes": [
        {
            "name":"count players",
            "description":"How many players to you see in the scene?",
            "type":"number"
        },
        {
            "name":"select one",
            "description":"describe the scene",
            "type":"string",
            "enum":["clear","blurry"],
            "isRequired":true 
        },   
    ],
    "categoryGlobalAttributes": [
        {
            "name":"W",
            "description":"label-attributes-for-all-labels",
            "type":"string",
            "enum": ["foo", "buzz", "biz"]
        }
    ],
    "labels": [
        {
            "label": "Car",
            "categoryAttributes": [
                {
                    "name":"X",
                    "description":"enter a number",
                    "type":"number",
                },
                {
                    "name":"Y",
                    "description":"select an option",
                    "type":"string",
                    "enum":["y1", "y2"]
                },
                {
                    "name":"Z",
                    "description":"submit a free-form response",
                    "type":"string",
                }
            ]
        },
        {
            "label": "Pedestrian",
            "categoryAttributes": [...]
        }
    ],
    "instructions": {"shortInstruction":"Draw a tight Cuboid", "fullInstruction":"<html markup>"}
}
```

### Exemple : segmentation sémantique du nuage de points 3D
<a name="example-3d-point-cloud-semantic"></a>

Voici un exemple de fichier de configuration de catégorie d’étiquette pour une tâche d’étiquetage par segmentation sémantique de nuages de points 3D. 

Les attributs de catégorie d’étiquette ne sont pas pris en charge pour les types de tâches de segmentation sémantique de nuage de points 3D. Les attributs de trame sont pris en charge. Si vous fournissez des attributs de catégorie d’étiquette pour une tâche d’étiquetage de segmentation sémantique, ils seront ignorés.

```
{
    "documentVersion": "2020-03-01",
    "frameAttributes": [
        {
            "name":"count players",
            "description":"How many players to you see in the scene?",
            "type":"number"
        },
        {
            "name":"select one",
            "description":"describe the scene",
            "type":"string",
            "enum":["clear","blurry"]
        },   
    ],
    "labels": [
        {
            "label": "Car",
        },
        {
            "label": "Pedestrian",
        },
        {
            "label": "Cyclist",
        }
    ],
    "instructions": {"shortInstruction":"Select the appropriate label and paint all objects in the point cloud that it applies to the same color", "fullInstruction":"<html markup>"}
}
```

### Exemple : ajustement du nuage de points 3D
<a name="example-3d-point-cloud-adjustment"></a>

Voici un exemple de fichier de configuration de catégorie d’étiquette pour une tâche d’étiquetage de détection d’objets de nuage de points 3D ou de suivi d’objets. Pour les tâches d’étiquetage d’ajustement de segmentation sémantique de nuage de points 3D, `categoryGlobalAttributes` et `categoryAttributes` ne sont pas pris en charge. 

Vous devez inclure `auditLabelAttributeName` pour spécifier le nom d’attribut d’étiquette de la tâche d’étiquetage précédent que vous utilisez pour créer la tâche d’étiquetage d’ajustement. Le cas échéant, vous pouvez utiliser le paramètre `editsAllowed` pour spécifier si un attribut d’étiquette ou de trame peut être modifié ou non. 

```
{
    "documentVersion": "2020-03-01",
    "frameAttributes": [
        {
            "name":"count players",
            "description":"How many players to you see in the scene?",
            "type":"number"
        },
        {
            "name":"select one",
            "editsAllowed":"none",
            "description":"describe the scene",
            "type":"string",
            "enum":["clear","blurry"]
        },   
    ],
    "categoryGlobalAttributes": [
        {
            "name":"W",
            "editsAllowed":"any",
            "description":"label-attributes-for-all-labels",
            "type":"string",
            "enum": ["foo", "buzz", "biz"]
        }
    ],
    "labels": [
        {
            "label": "Car",
            "editsAllowed":"any",
            "categoryAttributes": [
                {
                    "name":"X",
                    "description":"enter a number",
                    "type":"number"
                },
                {
                    "name":"Y",
                    "description":"select an option",
                    "type":"string",
                    "enum":["y1", "y2"],
                    "editsAllowed":"any"
                },
                {
                    "name":"Z",
                    "description":"submit a free-form response",
                    "type":"string",
                    "editsAllowed":"none"
                }
            ]
        },
        {
            "label": "Pedestrian",
            "categoryAttributes": [...]
        }
    ],
    "instructions": {"shortInstruction":"Draw a tight Cuboid", "fullInstruction":"<html markup>"},
    // include auditLabelAttributeName for label adjustment jobs
    "auditLabelAttributeName": "myPrevJobLabelAttributeName"
}
```

### Exemple : vérification du nuage de points 3D
<a name="example-3d-point-cloud-verification"></a>

Voici un exemple de fichier de configuration de catégorie d’étiquette que vous pouvez utiliser pour une tâche de vérification des étiquettes de détection ou de suivi d’objets dans un nuage de points 3D. Pour une tâche de vérification des étiquettes de segmentation sémantique dans un nuage de points 3D, `categoryGlobalAttributes` et `categoryAttributes` ne sont pas pris en charge. 

Vous devez inclure `auditLabelAttributeName` pour spécifier le nom d’attribut d’étiquette de la tâche d’étiquetage précédent que vous utilisez pour créer la tâche d’étiquetage de vérification. En outre, vous devez utiliser le paramètre `editsAllowed` pour spécifier qu’aucune étiquette ne peut être modifiée. 

```
{
    "documentVersion": "2020-03-01",
    "frameAttributes": [
        {
            "name":"count players",
            "editsAllowed":"any", 
            "description":"How many players to you see in the scene?",
            "type":"number"
        },
        {
            "name":"select one",
            "editsAllowed":"any", 
            "description":"describe the scene",
            "type":"string",
            "enum":["clear","blurry"]
        },   
    ],
    "categoryGlobalAttributes": [
        {
            "name":"W",
            "editsAllowed":"none", 
            "description":"label-attributes-for-all-labels",
            "type":"string",
            "enum": ["foo", "buzz", "biz"]
        }
    ],
    "labels": [
        {
            "label": "Car",
            "editsAllowed":"none", 
            "categoryAttributes": [
                {
                    "name":"X",
                    "description":"enter a number",
                    "type":"number",
                    "editsAllowed":"none"
                },
                {
                    "name":"Y",
                    "description":"select an option",
                    "type":"string",
                    "enum":["y1", "y2"],
                    "editsAllowed":"any"
                },
                {
                    "name":"Z",
                    "description":"submit a free-form response",
                    "type":"string",
                    "editsAllowed":"none"
                }
            ]
        },
        {
            "label": "Pedestrian",
            "editsAllowed":"none", 
            "categoryAttributes": [...]
        }
    ],
    "instructions": {"shortInstruction":"Draw a tight Cuboid", "fullInstruction":"<html markup>"},
    // include auditLabelAttributeName for label verification jobs
    "auditLabelAttributeName": "myPrevJobLabelAttributeName"
}
```

## Exemples : fichiers de configuration de catégorie d’étiquettes pour les tâches d’étiquetage de trame vidéo
<a name="sms-label-cat-config-attributes-vid-frame"></a>

Les outils d’annotation disponibles pour votre employé et le type de tâche utilisé dépendent de la valeur que vous spécifiez pour `annotationType`. Par exemple, si vous souhaitez que les employés utilisent des points clés pour suivre les modifications de la pose d’objets spécifiques sur plusieurs trames, vous devez spécifier `Keypoint` pour `annotationType`. Si vous ne spécifiez aucun type d’annotation, `BoundingBox` sera utilisé par défaut. 

Les rubriques suivantes montrent des exemples de fichiers de configuration de catégories de trame vidéo.

**Topics**
+ [Exemple : point clé d’une trame vidéo](#example-video-frame-keypoint)
+ [Exemple : réglage de trame vidéo](#example-video-frame-adjustment)
+ [Exemple : vérification de trame vidéo](#example-video-frame-verification)

### Exemple : point clé d’une trame vidéo
<a name="example-video-frame-keypoint"></a>

Voici un exemple de fichier de configuration de catégorie d’étiquette de point clé pour une trame vidéo avec attributs de catégorie d’étiquette. Cet exemple inclut deux attributs de trame, qui seront ajoutés à toutes les trames soumises à la tâche d’étiquetage. L’étiquette `Car` inclura quatre attributs de catégorie d’étiquette : `X`, `Y`, `Z` et l’attribut global `W`. 

```
{
    "documentVersion": "2020-03-01",
    "frameAttributes": [
        {
            "name":"count players",
            "description":"How many players to you see in the scene?",
            "type":"number"
        },
        {
            "name":"select one",
            "description":"describe the scene",
            "type":"string",
            "enum":["clear","blurry"]
        },   
    ],
    "categoryGlobalAttributes": [
        {
            "name":"W",
            "description":"label-attributes-for-all-labels",
            "type":"string",
            "enum": ["foo", "buz", "buz2"]
        }
    ],
    "labels": [
        {
            "label": "Car",
            "categoryAttributes": [
                {
                    "name":"X",
                    "description":"enter a number",
                    "type":"number",
                },
                {
                    "name":"Y",
                    "description":"select an option",
                    "type":"string",
                    "enum": ["y1", "y2"]
                },
                {
                    "name":"Z",
                    "description":"submit a free-form response",
                    "type":"string",
                }
            ]
        },
        {
            "label": "Pedestrian",
            "categoryAttributes": [...]
        }
    ],
    "annotationType":"Keypoint",
    "instructions": {"shortInstruction":"add example short instructions here", "fullInstruction":"<html markup>"}
}
```

### Exemple : réglage de trame vidéo
<a name="example-video-frame-adjustment"></a>

Voici un exemple de fichier de configuration de catégorie d’étiquette que vous pouvez utiliser pour une tâche d’ajustement des étiquettes de trame vidéo.

Vous devez inclure `auditLabelAttributeName` pour spécifier le nom d'attribut d'étiquette de la tâche d'étiquetage précédent que vous utilisez pour créer la tâche d'étiquetage de vérification. Le cas échéant, vous pouvez utiliser le paramètre `editsAllowed` pour spécifier si les étiquettes, les attributs de catégorie d’étiquette ou les attributs de trame peuvent être modifiés. 

```
{
    "documentVersion": "2020-03-01",
    "frameAttributes": [
        {
            "name":"count players",
            "editsAllowed":"none", 
            "description":"How many players to you see in the scene?",
            "type":"number"
        },
        {
            "name":"select one",
            "description":"describe the scene",
            "type":"string",
            "enum":["clear","blurry"]
        },   
    ],
    "categoryGlobalAttributes": [
        {
            "name":"W",
            "editsAllowed":"any", 
            "description":"label-attributes-for-all-labels",
            "type":"string",
            "enum": ["foo", "buz", "buz2"]
        }
    ],
    "labels": [
        {
            "label": "Car",
            "editsAllowed":"any", 
            "categoryAttributes": [
                {
                    "name":"X",
                    "description":"enter a number",
                    "type":"number",
                    "editsAllowed":"any"
                },
                {
                    "name":"Y",
                    "description":"select an option",
                    "type":"string",
                    "enum": ["y1", "y2"],
                    "editsAllowed":"any"
                },
                {
                    "name":"Z",
                    "description":"submit a free-form response",
                    "type":"string",
                    "editsAllowed":"none"
                }
            ]
        },
        {
            "label": "Pedestrian",
            "editsAllowed":"none", 
            "categoryAttributes": [...]
        }
    ],
    "annotationType":"Keypoint",
    "instructions": {"shortInstruction":"add example short instructions here", "fullInstruction":"<html markup>"},
    // include auditLabelAttributeName for label adjustment jobs
    "auditLabelAttributeName": "myPrevJobLabelAttributeName"
}
```

### Exemple : vérification de trame vidéo
<a name="example-video-frame-verification"></a>

Voici un exemple de fichier de configuration de catégorie d’étiquette pour une tâche d’étiquetage de trame vidéo.

Vous devez inclure `auditLabelAttributeName` pour spécifier le nom d'attribut d'étiquette de la tâche d'étiquetage précédent que vous utilisez pour créer la tâche d'étiquetage de vérification. En outre, vous devez utiliser le paramètre `editsAllowed` pour spécifier qu’aucune étiquette ne peut être modifiée. 

```
{
    "documentVersion": "2020-03-01",
    "frameAttributes": [
        {
            "name":"count players",
            "editsAllowed":"none", 
            "description":"How many players to you see in the scene?",
            "type":"number"
        },
        {
            "name":"select one",
            "editsAllowed":"any", 
            "description":"describe the scene",
            "type":"string",
            "enum":["clear","blurry"]
        },   
    ],
    "categoryGlobalAttributes": [
        {
            "name":"W",
            "editsAllowed":"none", 
            "description":"label-attributes-for-all-labels",
            "type":"string",
            "enum": ["foo", "buz", "buz2"]
        }
    ],
    "labels": [
        {
            "label": "Car",
            "editsAllowed":"none", 
            "categoryAttributes": [
                {
                    "name":"X",
                    "description":"enter a number",
                    "type":"number",
                    "editsAllowed":"any"
                },
                {
                    "name":"Y",
                    "description":"select an option",
                    "type":"string",
                    "enum": ["y1", "y2"],
                    "editsAllowed":"any"
                },
                {
                    "name":"Z",
                    "description":"submit a free-form response",
                    "type":"string",
                    "editsAllowed":"none"
                }
            ]
        },
        {
            "label": "Pedestrian",
            "editsAllowed":"none", 
            "categoryAttributes": [...]
        }
    ],
    "annotationType":"Keypoint",
    "instructions": {"shortInstruction":"add example short instructions here", "fullInstruction":"<html markup>"},
    // include auditLabelAttributeName for label adjustment jobs
    "auditLabelAttributeName": "myPrevJobLabelAttributeName"
}
```

## Schéma du fichier de configuration de catégorie d’étiquette
<a name="sms-label-cat-config-attributes-schema"></a>

Le tableau suivant répertorie les éléments que vous pouvez et devez inclure dans votre fichier de configuration de catégorie d’étiquette.

**Note**  
Le paramètre `annotationType` est uniquement pris en charge pour les tâches d’étiquetage de trame vidéo. 


****  

|  Paramètre  |  Obligatoire  |  Valeurs acceptées  |  Description  | 
| --- | --- | --- | --- | 
| frameAttributes |  Non  |  Une liste d’objets JSON. **Paramètres requis dans chaque objet JSON :** `name`, `type`, `description` `minimum` et `maximum` sont obligatoires si le `type` est `"number"` **Paramètres facultatifs dans chaque objet JSON :** `enum`, `editsAllowed`, `isRequired`  | Utilisez ce paramètre pour créer un attribut de trame appliqué à toutes les trames ou à tous les nuages de points 3D dans votre tâche d’étiquetage.Consultez le troisième tableau de cette section pour plus d’informations.  | 
| categoryGlobalAttributes |  Non  |  Une liste d’objets JSON. **Paramètres requis dans chaque objet JSON :** `name`, `type` `minimum` et `maximum` sont obligatoires si le `type` est `"number"` **Paramètres facultatifs dans chaque objet JSON :** `description`, `enum`, `editsAllowed`, `isRequired`   | Utilisez ce paramètre pour créer des attributs de catégorie d’étiquette appliqués à toutes les étiquettes que vous spécifiez dans `labels`. Consultez le troisième tableau de cette section pour plus d'informations.  | 
| labels |  Oui  |  Une liste de 30 objets JSON maximum **Paramètres requis dans chaque objet JSON :** `label` **Paramètres facultatifs dans chaque objet JSON :** `categoryAttributes`, `editsAllowed`  |  Utilisez ce paramètre pour spécifier vos étiquettes ou classes. Ajoutez un élément `label` pour chaque classe.  Pour ajouter un attribut de catégorie d’étiquette à une étiquette, ajoutez `categoryAttributes` à cette étiquette. Utilisez `editsAllowed` pour spécifier si une étiquette peut ou non être modifiée dans une tâche d’ajustement des étiquettes. Définissez `editsAllowed` à `"none"` pour les tâches de vérification des étiquettes. Pour plus d’informations, consultez le tableau suivant.  | 
| annotationType (uniquement pris en charge pour les tâches d’étiquetage de trame vidéo)  |  Non   |  String **Paramètres acceptés :** `BoundingBox`, `Polyline`, `Polygon`, `Keypoint` **Valeur par défaut :** `BoundingBox`  |  Utilisez cette option pour spécifier le type de tâche pour vos tâches d’étiquetage de trame vidéo. Par exemple, pour une tâche de détection d’objet de trame vidéo par polygone, choisissez `Polygon`.  Si vous ne spécifiez aucun `annotationType` lorsque vous créez une tâche d’étiquetage de trame vidéo, Ground Truth utilise `BoundingBox` par défaut.   | 
| instructions |  Non  | Un objet JSONParamètres requis dans chaque objet JSON :`"shortInstruction"`, `"fullInstruction"` |  Utilisez ce paramètre pour ajouter des instructions de travail destinées à aider vos collaborateurs à accomplir leurs tâches. Pour plus d’informations sur les instructions de travail, consultez [Instructions à l’intention des travailleurs](sms-point-cloud-general-information.md#sms-point-cloud-worker-instructions-general).  Les instructions courtes doivent comporter moins de 255 caractères et les instructions longues doivent en comporter moins de 2 048.  Pour de plus amples informations, veuillez consulter [Création de pages d’instructions](sms-creating-instruction-pages.md).  | 
| auditLabelAttributeName |  Obligatoire pour les types de tâches d’ajustement et de vérification  |  String  |  Entrez la valeur [LabelAttributeName](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateLabelingJob.html#sagemaker-CreateLabelingJob-request-LabelAttributeName)utilisée dans la tâche d'étiquetage dont vous souhaitez ajuster les annotations.  Utilisez ce paramètre uniquement si vous créez une tâche d’ajustement de détection ou de suivi d’objets dans une trame vidéo ou un nuage de points 3D, ou de segmentation sémantique dans un nuage de points 3D.   | 

### Schéma d’objet d’étiquettes
<a name="sms-labels-schema"></a>

Le tableau suivant décrit les paramètres que vous pouvez et devez utiliser pour créer une liste de `Labels`. Chaque paramètre doit être inclus dans un objet JSON. 


****  

| Paramètre | Obligatoire | Valeurs acceptées | Description | 
| --- | --- | --- | --- | 
| label |  Oui  |  String  |  Nom de la catégorie d’étiquettes qui s’affiche pour les employés. Chaque nom de catégorie d’étiquette doit être unique.  | 
| categoryAttributes |  Non  |  Une liste d’objets JSON. **Paramètres requis dans chaque objet JSON :** `name`, `type` `minimum` et `maximum` sont obligatoires si le `type` est `"number"` **Paramètres facultatifs dans chaque objet JSON :** `description`, `enum`, `editsAllowed`, `isRequired`  | Utilisez ce paramètre pour ajouter des attributs de catégorie d’étiquette à des étiquettes spécifiques que vous spécifiez dans `labels`. Pour ajouter un ou plusieurs attributs de catégorie d’étiquette à une étiquette, incluez l’objet JSON `categoryAttributes` dans le même objet JSON `labels` en tant que `label`.Pour plus d'informations, veuillez consulter le tableau suivant.  | 
| editsAllowed |  Non  |  String **Valeurs prises en charge** : `"none"` : aucune modification n’est autorisée. or `"any"` (Valeur par défaut) : toutes les modifications sont autorisées.  |  Spécifie si une étiquette peut ou non être modifiée par les employés. Pour les tâches d’*ajustement* de trame vidéo ou nuage de points 3D, ajoutez ce paramètre à un ou plusieurs objets JSON dans la liste `labels` pour spécifier si un employé peut ou non modifier une étiquette. Pour les tâches de *vérification* de trame vidéo ou nuage de points 3D, ajoutez ce paramètre avec la valeur `"none"` à chaque objet JSON dans la liste `labels`. Cela rendra toutes les étiquettes non modifiables.  | 

### FrameAttributes et schéma categoryGlobalAttributes
<a name="sms-category-attributes-schema"></a>

Le tableau suivant décrit les paramètres que vous pouvez et devez utiliser pour créer un attribut de trame à l’aide de `frameAttributes` et un attribut de catégorie d’étiquette à l’aide des paramètres `categoryGlobalAttributes` et `categoryAttributes`.


****  

|  Paramètre  |  Obligatoire  |  Valeurs acceptées  |  Description  | 
| --- | --- | --- | --- | 
| name |  Oui  |  String  |  Utilisez ce paramètre pour attribuer un nom à votre attribut de catégorie d’étiquette. Il s’agit du nom que les employés voient pour cet attribut. Chaque nom d’attribut de catégorie d’étiquette dans votre fichier de configuration de catégorie d’étiquette doit être unique. Les attributs de catégorie d’étiquette globale et les attributs de catégorie d’étiquette spécifiques à une étiquette ne peuvent pas avoir le même nom.  | 
| type |  Oui  |  String **Valeurs requises** : `"string"` ou `"number"`  |  Utilisez ce paramètre pour définir le type d’attribut de catégorie d’étiquette ou de trame.  Si vous spécifiez `"string"` pour `type` et fournir une valeur `enum` pour cet attribut, les employés pourront choisir parmi l’un des choix que vous proposez.  Si vous spécifiez `"string"` pour `type` et ne fournissent pas de valeur `enum`, les employés peuvent saisir du texte sous forme libre.  Si vous spécifiez `number` pour `type`, l’employé peut saisir un nombre entre le `minimum` et le `maximum` que vous spécifiez.   | 
| enum |  Non  |  Liste de chaînes  |  Utilisez ce paramètre pour définir les options que les employés peuvent choisir pour cet attribut de catégorie d’étiquette. Les collaborateurs peuvent choisir l’une des valeurs spécifiées dans `enum`. Par exemple, si vous spécifiez `["foo", "buzz", "bar"`] pour `enum`, les employés peuvent choisir entre `foo`, `buzz`, et `bar`. Vous devez spécifier `"string"` pour `type` pour utiliser une liste `enum`.  | 
| description |  `frameAttributes` : Oui `categoryAttributes` ou `categoryGlobalAttributes` : non  |  String  |  Utilisez ce paramètre pour ajouter une description de l’attribut de catégorie d’étiquette ou de trame. Vous pouvez utiliser ce champ pour donner aux employés plus d’informations sur l’attribut.  Ce champ n’est obligatoire que pour les attributs de trame.  | 
| minimum et maximum | Obligatoire si l’attribut type est "number" | Entiers |  Utilisez ces paramètres pour spécifier les valeurs minimales et maximales (inclusivement) que les employés peuvent saisir pour les attributs de catégorie d’étiquette numérique ou de trame. Vous devez spécifier `"number"` pour le `type` pour utiliser `minimum` et `maximum`.  | 
| editsAllowed |  Non  |  String **Valeurs requises** : `"none"` : aucune modification n'est autorisée. or `"any"` (Valeur par défaut) : toutes les modifications sont autorisées.  |  Spécifie si une catégorie d’étiquette ou un attribut de trame peut ou non être modifié par les employés. Pour les tâches d’*ajustement* et de *vérification* de trame vidéo ou nuage de points 3D, ajoutez ce paramètre aux objets JSON de catégorie d’étiquette et d’attribut de trame pour spécifier si un employé peut ou non modifier une étiquette.  | 
| isRequired |  Non  |  Booléen  |  Spécifie si les employés doivent annoter un attribut. Les employés ne peuvent pas soumettre la tâche tant que tous les attributs requis n’ont pas été annotés.  | 

## Quotas d’attribut d’étiquette et de catégorie d’étiquette
<a name="sms-point-cloud-label-cat-limits"></a>

Vous pouvez spécifier jusqu’à 10 attributs de catégorie d’étiquettes par classe. Ces quotas de 10 attributs incluent des attributs de catégorie d’étiquette globale. Par exemple, si vous créez quatre attributs de catégorie d’étiquette globale, puis que vous affectez trois attributs de catégorie d’étiquette à l’étiquette `X`, cette étiquette aura 4\$13=7 attributs de catégorie d’étiquette au total. Pour connaître toutes les limites des attributs de catégorie d’étiquette et des catégories d’étiquette, consultez le tableau suivant.


****  

|  Type  |  Min  |  Max  | 
| --- | --- | --- | 
|  Étiquettes (`Labels`)  |  1  |  30  | 
|  Quota de caractères du nom de l’étiquette  |  1  |  16  | 
|  Attributs de catégorie d’étiquette par étiquette (somme de `categoryAttributes` et `categoryGlobalAttributes`)  |  0 USD  |  10  | 
|  Attributs de catégorie d’étiquette de saisie de texte libre par étiquette (somme de `categoryAttributes` et `categoryGlobalAttributes`).   | 0 | 5 | 
|  Attributs de trame  |  0 USD  |  10  | 
|  Attributs de saisie de texte libre dans `frameAttributes`.  | 0 | 5 | 
|  Quota de caractères du nom d’attribut (`name`)  |  1  |  16  | 
|  Quota de caractères de la description d’attribut (`description`)  |  0  |  128  | 
|  Quota de caractères du type d’attribut (`type`)  |  1  |  16  | 
|  Valeurs autorisées dans la liste `enum` pour un attribut `string`  | 1 | 10 | 
|  Quota de caractères pour une valeur dans la liste `enum`  | 1 | 16 | 
| Nombre maximal de caractères dans la réponse de texte libre pour le texte libre frameAttributes | 0 | 1 000 | 
| Nombre maximal de caractères dans la réponse de texte libre pour le texte libre categoryAttributes et categoryGlobalAttributes | 0 | 80 |