Partager via

Utiliser des définitions de colonnes de fichier à l’aide du code

Utilisez des colonnes de fichier pour stocker des données de fichier jusqu’à une taille maximale spécifiée. Les colonnes Fichier sont optimisées pour stocker des données binaires. Dataverse ne sauvegarde pas ces données dans le magasin de données relationnel, ce qui améliore les performances et réduit l’utilisation de la capacité. En savoir plus sur la capacité de stockage.

Une table personnalisée ou personnalisable peut avoir zéro ou plus de colonnes de fichier. Cet article décrit l’utilisation des définitions de colonne dans le code. Pour utiliser les données stockées dans ces colonnes, consultez Utiliser les données de colonne de fichier.

Créer des colonnes de fichier

La méthode recommandée pour créer des colonnes de fichiers consiste à utiliser Power Apps et à définir vos colonnes à l’aide du concepteur. Pour plus d’informations, consultez File columns.

Note

Une considération clé lors de la création de colonnes de fichier est la Taille de fichier maximale stockée dans la propriété MaxSizeInKB. Le paramètre par défaut de cette propriété est 32768, ou 32 Mo. La valeur maximale est 10485760 Ko (10 Go). Bien que l’API puisse gérer les fichiers jusqu’à 10 Go de taille, les requêtes doivent être segmentées. La taille limite pour envoyer une seule requête est de 128 Mo. Lorsqu'une application cliente tente d'envoyer un fichier de plus de 128 Mo dans une seule requête, une erreur est générée. Apprendre à charger les fichiers.

Vous ne pouvez pas modifier la MaxSizeInKB valeur dans Power Apps à l’aide du concepteur après avoir créé la colonne de fichier. Vous pouvez utiliser l’API pour mettre à jour la propriété MaxSizeInKB. Pour plus d’informations, consultez Mettre à jour une colonne à l’aide de l’API web et mettre à jour une colonne à l’aide du Kit de développement logiciel (SDK).

Vous pouvez également créer des colonnes de fichier à l’aide du Kit de développement logiciel (SDK) Dataverse pour .NET ou à l’aide de l’API web. Les exemples suivants montrent comment créer des colonnes de fichier :

Utilisez la Classe FileAttributeMetadata avec la Classe CreateAttributeRequest pour créer une colonne de fichier.

public static void CreateFileColumn(
   IOrganizationService service, 
   string entityLogicalName, 
   string fileColumnSchemaName) 
{

    FileAttributeMetadata fileColumn = new()
    {
        SchemaName = fileColumnSchemaName,
        DisplayName = new Label("Sample File Column", 1033),
        RequiredLevel = new AttributeRequiredLevelManagedProperty(
                AttributeRequiredLevel.None),
        Description = new Label("Sample File Column for FileOperation samples", 1033),
        MaxSizeInKB = 30 * 1024 // 30 MB

    };

    CreateAttributeRequest createfileColumnRequest = new() {
        EntityName = entityLogicalName,
        Attribute = fileColumn                   
    };

    service.Execute(createfileColumnRequest);

}

Utilisez la propriété FileAttributeMetadata.MaxSizeInKB pour définir la taille maximale.

Pour plus d’informations, consultez :

Types de fichiers bloqués

Vous pouvez contrôler quels types de fichiers ne sont pas autorisés à être enregistrés dans les colonnes de fichiers en fonction de l’extension de fichier et du type mime.

Pour plus d’informations, consultez :

Restrictions avec clé autogérée (BYOK)

Important

Certaines restrictions s’appliquent lors de l’utilisation des données de type Fichier et Image en taille réelle dans Dataverse. Si la clé auto-managée (BYOK) est activée sur le locataire, les types de données IoT ne sont pas disponibles pour les organisations du locataire. Les solutions qui contiennent des types de données exclus ne seront pas installées. Les clients doivent refuser BYOK pour utiliser ces types de données.

Toutes les organisations BYOK à partir de la version 9.2.21052.00103 peuvent prendre en charge l’utilisation des types de données de fichier et d’image Dataverse. Les fichiers au sein des organisations BYOK sont limités à une taille maximale de 128 Mo par fichier. Tous les fichiers et images dans les organisations BYOK sont stockés dans le stockage relationnel Dataverse, au lieu du stockage Blob de fichiers Dataverse. Autres limitations :

  • Les téléchargements SAP de délégation d’utilisateur ne sont pas pris en charge
  • Les chargements et téléchargements en bloc sont limités à un seul bloc

Voir aussi

Utiliser les données de colonne de fichier
Utiliser des définitions de colonne d’image avec du code

  • Last updated on