Lire et Mise à jour des paramètres d’environnement
De nombreux paramètres d’environnement sont stockés sous forme de colonnes dans la table d’organisation.
La table d’organisation comporte une seule ligne et la valeur de la clé primaire OrganizationId est la même ID d’organisation visible dans le Power Platform Centre d’administration. Rechercher votre ID d’environnement et d’organisation
Utilisez la réponse au message WhoAmI retourne la propriété OrganizationId. Utilisez le organizationid valeur pour récupérer la seule ligne de la table d’organisation. Voir classe SDK pour .NET WhoAmIRequest et Fonction WhoAmI de l’API Web.
Paramètres pris en charge
La documentation de toute fonctionnalité avec des paramètres doit documenter les paramètres qu’elle prend en charge la modification. Toutes les colonnes ne sont pas documentées. Seuls les paramètres décrits dans la documentation des fonctionnalités peuvent être définis.
Par exemple, les colonnes suivantes sont prises en charge car elles sont mentionnées dans la documentation des fonctionnalités :
Notes
Ce n’est pas une liste complète. Recherchez dans la documentation de la fonctionnalité avec laquelle vous travaillez les paramètres que cette fonctionnalité prend en charge la modification.
Paramètres non pris en charge
Certaines colonnes ne sont explicitement pas prises en charge pour être mises à jour directement. Par exemple, vous ne devriez pas essayer de mettre à jour le OrgDbOrgSettings colonne directement. Cette colonne de chaîne contient plusieurs éléments XML qui contrôlent le comportement de plusieurs fonctionnalités. Si vous ne mettez pas à jour cette valeur de manière incorrecte, les fonctionnalités qui dépendent de ces paramètres pourraient être interrompues. Utilisez toujours les outils décrits dans Paramètres de la base de données d’environnement pour modifier les valeurs de cette colonne.
Paramètres Lecture seule
Certains paramètres peuvent être récupérés mais ne peuvent pas être définis. Ces colonnes ont des valeurs fausses pour les deux AttributeMetadata.IsValidForCreate et AttributeMetadata.IsValidForUpdate. Vous pouvez consulter la liste des colonnes en lecture seule ici : Table d’organisation Colonnes/attributs en lecture seule.
Notes
Comme pour tout type de table, si vous essayez de définir une colonne en lecture seule, l’opération ne génère pas d’erreur. La valeur que vous fournissez pour mettre à jour une colonne en lecture seule est ignorée.
Les paramètres pouvant être mis à jour sont répertoriés ici Table d’organisation Colonnes/attributs inscriptibles. Gardez à l’esprit qu’être inscriptible ne signifie pas que la mise à jour du paramètre est prise en charge.
Paramètres obsolètes
Certaines colonnes représentent des paramètres obsolètes. Vous devriez regarder les descriptions de la colonne dans la liste des Table d’organisation Colonnes/attributs inscriptibles pour déterminer si le paramètre représente toujours la manière de modifier le comportement de l’environnement. Par exemple, les colonnes suivantes sont obsolètes :
- CurrentBulkOperationNumber
- CurrentCampaignNumber
- CurrentCaseNumber
- CurrentCategoryNumber
- CurrentContractNumber
- CurrentInvoiceNumber
- CurrentKaNumber
- CurrentKbNumber
- CurrentOrderNumber
- CurrentQuoteNumber
- MicrosoftFlowEnvironment
Utiliser PAC CLI pour récupérer et mettre à jour les paramètres
Vous pouvez récupérer et mettre à jour les valeurs de colonne pour la ligne de la table d’organisation à l’aide du SDK pour .NET et de l’API Web, comme vous le feriez pour n’importe quel autre système Dataverse tableau. Vous pouvez également utiliser Microsoft Power Platform CLI.
La CLI PAC inclut ces commandes :
- paramètres de liste d’environnement pac : renvoie les paramètres d’environnement stockés dans la table d’organisation.
- pac env update-settings : permet de mettre à jour une seule valeur de colonne de table d’organisation.
Lorsque vous utilisez la commande pac env update-settings , assurez-vous de mettre à jour uniquement les colonnes qui peuvent être mises à jour. Si vous utilisez cette commande pour définir une colonne en lecture seule, la commande signalera de manière incorrecte que la modification a été appliquée avec succès car aucune erreur ne s’est produite.