Leer y actualizar la configuración del entorno
Muchas configuraciones para el entorno se almacenan como columnas en la Tabla de organización.
La tabla de organización tiene una sola fila y el valor de clave principal de OrganizationId es el mismo valor de Id. de organización visible en el centro de administración de Power Platform. Buscar su id. de organización y el entorno
La respuesta al mensaje WhoAmI devuelve la propiedad OrganizationId. Utilice el valor organizationid para recuperar la única fila de la tabla de organización. Vea SDK para la clase WhoAmIRequest de .NET y la Función WhoAmI de la API web.
Configuraciones admitidas
La documentación de cualquier característica con configuración debe documentar las configuraciones que admiten cambios. No todas las columnas están documentadas. Solo se admiten las configuraciones descritas en la documentación de características.
Por ejemplo, las siguientes columnas son compatibles porque se mencionan en la documentación de la característica:
Nota
Esta lista no es exhaustiva. Busque en la documentación de la característica con la que está trabajando las configuraciones que la característica admite cambios.
Configuraciones no admitidas
Algunas columnas no son explícitamente compatibles con la actualización directa. Por ejemplo, no debería intentar actualizar la columna OrgDbOrgSettings directamente. Esta columna de cadena contiene varios elementos XML que controlan el comportamiento de varias características. Si actualiza este valor incorrectamente, las características que dependen de esta configuración podrían dejar de funcionar. Utilice siempre las herramientas descritas en Configuración de la base de datos del entorno para cambiar los valores de esta columna.
Configuración de solo lectura
Algunas configuraciones están disponibles para su recuperación pero no se pueden configurar. Estas columnas tienen valores falsos para AttributeMetadata.IsValidForCreate y AttributeMetadata.IsValidForUpdate. Puede ver la lista de columnas de solo lectura aquí: Tabla de organización Columnas/atributos de solo lectura.
Nota
Como ocurre con cualquier tipo de tabla, si intenta establecer una columna de solo lectura, la operación no arroja ningún error. Se ignora el valor que proporciona para actualizar una columna de solo lectura.
Las configuraciones que se pueden actualizar se enumeran aquí Tabla de organización Columnas/atributos grabables. Tenga en cuenta que poder escribir no significa que se admite la actualización de la configuración.
Configuraciones obsoletas
Algunas columnas representan configuraciones obsoletas. Debería mirar las descripciones de la columna en la lista de Tabla de organización Columnas/atributos grabables para determinar si la configuración todavía representa la forma de modificar el comportamiento del entorno. Por ejemplo, las siguientes columnas están en desuso:
- CurrentBulkOperationNumber
- CurrentCampaignNumber
- CurrentCaseNumber
- CurrentCategoryNumber
- CurrentContractNumber
- CurrentInvoiceNumber
- CurrentKaNumber
- CurrentKbNumber
- CurrentOrderNumber
- CurrentQuoteNumber
- MicrosoftFlowEnvironment
Utilice PAC CLI para recuperar y actualizar la configuración
Puede recuperar y actualizar los valores de las columnas para la fila de la tabla de organización utilizando el SDK para .NET y la API web como lo haría con cualquier tabla de Dataverse. También puede usar Microsoft Power Platform CLI.
PAC CLI incluye estos comandos:
- pac env list-settings: devuelve la configuración del entorno almacenada en la tabla de organización.
- pac env update-settings: permite actualizar un único valor de columna de la tabla de organización.
Cuando utilice el comando pac env update-settings, asegúrese de actualizar solo las columnas que se puedan actualizar. Si utiliza este comando para configurar una columna de solo lectura, el comando informará incorrectamente de que el cambio se aplicó correctamente porque no se produjo ningún error.