disableTime

Краткая информация

Предоставляет доступ к основным свойствам таблицы и методам.

Обсуждение

Существует два способа указания ссылки на таблицы в скрипте для использования в проекте. Чтобы использовать таблицы, уже имеющиеся в проекте, примените метод listTables на Map class. Чтобы использовать таблицы непосредственно из рабочей области, используйте функцию Table. Возможно, вы решите привязать таблицу в проекте с помощью функции listTables, поскольку вам может понадобиться изменить источник данных таблицы или определяющий запрос, или даже удалить эту таблицу из проекта с помощью класса Map и метода removeTable. Функция Table используется для указания ссылки на новые таблицы, которые нужно добавить в проект. Если у вас есть ссылка на новый, внешний источник таблицы, вы можете добавить ее на Карту с помощью метода addTable.

Таблица может поддерживать от нуля до нескольких определяющих запросов, но только один определяющий запрос может быть активным. Также возможно, что присутствует один или несколько определяющих запросов, но ни один из них не активен. Существует два способа управлять определяющими запросами. Во-первых, вы можете использовать свойство definitionQuery. Если вы устанавливаете уникальную строку SQL на таблице, не имеющей определяющего запроса, или на таблице, которая имеет несколько определяющих запросов, добавляется новый определяющий запрос и становится активным запросом. Если вы устанавливаете строку SQL на таблице, которая уже имеет такой же запрос, то она устанавливает строку как активный определяющий запрос, если он еще не активен. Второй способ управлять определяющими запросами - использовать комбинацию функций listDefinitionQueries и updateDefinitionQueries. Функция listDefinitionQueries возвращает список словарей Python, которые содержат свойства, связанные с каждым запросом. Ключи словаря - name, sql и isActive. Определяющие запросы можно добавлять, изменять или удалять из списка Python с помощью базовых функций Python. Значение словаря isActive может быть установлено на True, чтобы установить активный запрос. Снова только один запрос может быть активным. При попытке сделать активным более одного запроса будет возвращена ошибка. После внесения изменений функция updateDefinitionQueries используется для установки новых изменений.

Метод enableTime позволяет включить время на таблице. Когда время включено, свойство time обеспечивает доступ к объекту LayerTime, позволяя выполнить дальнейшую настройку свойств времени для таблицы. См. раздел справки LayerTime с примерами кодов, которые также можно применять к таблицам.

Поля и строки таблицы можно просматривать и настраивать с помощью класса TableFrameElement на Layout. Чтобы создать фрейм таблицы, используйте метод createTableFrameElement на классе Layout. Обратитесь к разделу справки класса TableFrameElement для получения дополнительной информации и примеров кода.

Изменение источника данных таблицы – это общее требование. Более подробное обсуждение, сведения о параметрах, сценарии и примеры кода см. в разделе справки Обновление и исправление источников данных.

Синтаксис

disableTime()

Свойства

Имя	Объяснение	Тип данных
connectionProperties (Только для чтения)	Возвращает информацию о подключении к источнику данных таблицы как словарь Python.	Dictionary
dataSource (Только для чтения)	Возвращает полный путь к источнику данных таблицы. Он включает полный путь к рабочей области и имя набора данных. Для таблиц многопользовательских баз геоданных возвращается строка, содержащая информацию о подключении таблицы. Подсказка: Таблицы многопользовательских баз геоданных в проекте ArcGIS Pro не хранят путь к файлу подключения к базе данных (`.sde`), который использовался для создания слоя.	String
definitionQuery (Чтение / Запись)	Дает возможность получать или задавать определяющий запрос к таблице.	String
isBroken (Только для чтения)	Возвращает `True`, если источник данных таблицы поврежден.	Boolean
isTimeEnabled (Только для чтения)	Указывает, включено ли время в таблице. Если свойство `isTimeEnabled` возвращает `True`, то свойство `time` таблицы может быть использовано для возврата объекта `LayerTime`. Если время не включено, используйте метод `enableTime` для таблицы, содержащей информацию о времени.	Boolean
longName (Только для чтения)	Полное имя таблицы, включая информацию о составном слое, если она есть. Например, таблица с именем '`Table`' в составном слое с именем '`Group Layer`' возвратит значение `longName`, равное '`Group Layer\\Table`'. Если таблица не входит в группу, `longName` будет таким же, что и значение `name`.	String
metadata (Чтение / Запись)	Получите или задайте информацию класса Метаданные для таблицы. Примечание: Установка метаданных зависит от значения свойства `isReadOnly`.	Metadata
name (Чтение / Запись)	Предоставляет возможность устанавливать или получать имя таблицы способом, обеспечивающим его отображение в таблице содержания. Можно использовать пробелы.	String
time (Только для чтения)	Возвращает объект LayerTime, если в таблице включено время. Примечание: Свойства времени объекта `LayerTime` можно использовать и для объекта Слой, и для объекта `Table`.	LayerTime
URI (Только для чтения)	Universal Resource Indicator таблицы. Это уникальный идентификатор таблицы в проекте, который иногда требуется при использовании доступа Python CIM. После добавления таблицы и установления URI значение со временем не меняется. Например, если вы измените имя таблицы, `URI` не изменится.	String

Методы

`disableTime()`

Отключает свойства времени для объекта Table.

`enableTime({startTimeField}, {endTimeField}, {autoCalculateTimeRange}, {timeDimension})`

Включает время в таблице, если там имеется информация о времени.

Имя	Объяснение	Тип данных
startTimeField (Дополнительный)	The name of the field containing the start time values. If each row has a single time field, specify that field name in the `startTimeField` and leave `endTimeField` blank. If each row has a start and end time field, specify both the `startTimeField` and `endTimeField`. (Значение по умолчанию — None)	String
endTimeField (Дополнительный)	The name of the field containing the end time values. Not all tables use an end time field. If each row has a single time field, specify that field name in the `startTimeField` and leave `endTimeField` blank. If each row has a start and end time field, specify both the `startTimeField` and `endTimeField`. (Значение по умолчанию — None)	String
autoCalculateTimeRange (Дополнительный)	If set to True, the start and end time attribute information is used to calculate the table's time extent. (Значение по умолчанию — True)	Boolean
timeDimension (Дополнительный)	The name of the dimension containing time values when using netCDF data. (Значение по умолчанию — None)	String

`getDefinition(cim_version)`

Получает определение CIM для таблицы.

Имя	Объяснение	Тип данных
cim_version	A string that represents the major version of the CIM.	String

Возвращаемое значение

Тип данных	Объяснение
Object	Возвращает определение CIM для объекта `Table`.

`getSelectionSet()`

Возвращает выборку таблицы в виде набора идентификаторов объектов Python.

Возвращаемое значение

Тип данных	Объяснение
List	Возвращает выборку таблицы в виде набора идентификаторов объектов Python.

`listCharts({wildcard})`

Возвращает список объектов диаграммы Python в таблице.

Имя	Объяснение	Тип данных
wildcard (Дополнительный)	A wildcard is based on the chart title and is not case sensitive. A combination of asterisks (*) and characters can be used to help limit the resulting list. (Значение по умолчанию — None)	String

Имя

Объяснение

Тип данных

wildcard

(Дополнительный)

A wildcard is based on the chart title and is not case sensitive. A combination of asterisks (*) and characters can be used to help limit the resulting list.

(Значение по умолчанию — None)

String

Возвращаемое значение

Тип данных	Объяснение
List	Возвращает список объектов диаграммы Python в таблице.

`listDefinitionQueries({wildcard})`

Возвращает список определяющих запросов Python, связанных с таблицей.

Имя	Объяснение	Тип данных
wildcard (Дополнительный)	A wildcard is based on the query name and is not case sensitive. A combination of asterisks (*) and characters can be used to limit the resulting list. (Значение по умолчанию — None)	String

Имя

Объяснение

Тип данных

wildcard

(Дополнительный)

A wildcard is based on the query name and is not case sensitive. A combination of asterisks (*) and characters can be used to limit the resulting list.

(Значение по умолчанию — None)

String

Возвращаемое значение

Тип данных	Объяснение
List	Список словарей Python, представляющих свойства, связанные с каждым запросом. Ключи словаря - `name`, `sql` и `isActive`.

`pasteProperties(source_table, {table_paste_properties[table_paste_properties,...]})`

Метод pasteProperties вставляет свойства из одной таблицы в другую.

Имя Объяснение Тип данных

Имя	Объяснение	Тип данных
source_table	A table or feature layer with the properties that will be pasted.	Table
table_paste_properties[table_paste_properties,...] (Дополнительный)	A single string or a list of strings that specify the property or properties that will be pasted. For example, `table_paste_properties="CHARTS"` will paste only chart properties, whereas `table_paste_properties=["CHARTS", "FIELD_PROPERTIES", "POPUPS"])` will paste multiple properties. ALL—All applicable properties will be pasted. CHARTS—Only chart properties will be pasted. DEFINITION_QUERIES—Only definition query properties will be pasted. DISPLAY_EXPRESSION—Only display expression properties will be pasted. FIELD_PROPERTIES—Only field properties will be pasted. POPUPS—Only pop-up configuration properties will be pasted. (Значение по умолчанию — ALL)	String

source_table

A table or feature layer with the properties that will be pasted.

Table

table_paste_properties[table_paste_properties,...]

(Дополнительный)

A single string or a list of strings that specify the property or properties that will be pasted. For example, table_paste_properties="CHARTS" will paste only chart properties, whereas table_paste_properties=["CHARTS", "FIELD_PROPERTIES", "POPUPS"]) will paste multiple properties.

ALL—All applicable properties will be pasted.
CHARTS—Only chart properties will be pasted.
DEFINITION_QUERIES—Only definition query properties will be pasted.
DISPLAY_EXPRESSION—Only display expression properties will be pasted.
FIELD_PROPERTIES—Only field properties will be pasted.
POPUPS—Only pop-up configuration properties will be pasted.

(Значение по умолчанию — ALL)

String

`saveACopy(file_name)`

Сохраняет таблицу в файл слоя (.lyrx).

Имя	Объяснение	Тип данных
file_name	A string that includes the location and name of the output layer file (`.lyrx`).	String

`setDefinition(definition_object)`

Задает определение CIM для таблицы.

Имя	Объяснение	Тип данных
definition_object	Измененный объект определения CIM, изначально полученный с помощью `getDefinition`.	Object

`setSelectionSet({oidList[oidList,...]}, {method})`

Задает выборку таблицы, используя список Object ID Python.

Имя Объяснение Тип данных

Имя	Объяснение	Тип данных
oidList[oidList,...] (Дополнительный)	Список Object ID Python для работы с соответствующим способом выборки объектов. (Значение по умолчанию — None)	List
method (Дополнительный)	Строка, задающая используемый метод выборки. NEW—Создает новую выборку записей из `oidList`. DIFFERENCE—Выбирает записи, не входящие в текущую выборку, но находящиеся в `oidList`. INTERSECT—Выбирает записи, входящие в текущую выборку и в `oidList`. SYMDIFFERENCE—Выбирает записи, входящие либо в текущую выборку, либо в `oidList`, но не в оба списка одновременно. UNION—Выбирает все записи, входящие как в текущую выборку, так и в `oidList`. (Значение по умолчанию — NEW)	String

oidList[oidList,...]

(Дополнительный)

Список Object ID Python для работы с соответствующим способом выборки объектов.

(Значение по умолчанию — None)

List

method

(Дополнительный)

Строка, задающая используемый метод выборки.

NEW—Создает новую выборку записей из oidList.
DIFFERENCE—Выбирает записи, не входящие в текущую выборку, но находящиеся в oidList.
INTERSECT—Выбирает записи, входящие в текущую выборку и в oidList.
SYMDIFFERENCE—Выбирает записи, входящие либо в текущую выборку, либо в oidList, но не в оба списка одновременно.
UNION—Выбирает все записи, входящие как в текущую выборку, так и в oidList.

(Значение по умолчанию — NEW)

String

`updateConnectionProperties(current_connection_info, new_connection_info, {auto_update_joins_and_relates}, {validate}, {ignore_case})`

Метод updateConnectionProperties заменяет свойства подключения, используя словарь либо путь к рабочей области.

Имя	Объяснение	Тип данных
current_connection_info	A string that represents the workspace path or a Python dictionary that contains connection properties to the source you want to update. If an empty string or `None` is used in `current_connection_info`, all connection properties will be replaced with the `new_workspace_info`, depending on the value of the `validate` parameter.	String
new_connection_info	A string that represents the workspace path or a Python dictionary that contains connection properties with the new source information.	String
auto_update_joins_and_relates (Дополнительный)	If set to `True`, the `updateConnectionProperties` method will also update the connections for associated joins or relates. (Значение по умолчанию — True)	Boolean
validate (Дополнительный)	If set to `True`, the connection properties will only be updated if the `new_connection_info` value is a valid connection. If it is not valid, the connection will not be replaced. If set to `False`, the method will set all connections to match the `new_connection_info` value, regardless of a valid match. In this case, if a match does not exist, the data sources would be broken. (Значение по умолчанию — True)	Boolean
ignore_case (Дополнительный)	Determines whether searches will be case sensitive. By default, queries are case sensitive. To perform queries that are not case sensitive, set `ignore_case` to `True`. (Значение по умолчанию — False)	Boolean

`updateDefinitionQueries(definitionQueries[definitionQueries,...])`

Обновления коллекции определяющих запросов таблицы.

Имя	Объяснение	Тип данных
definitionQueries[definitionQueries,...]	Updates a list of dictionaries that represent the properties of each definition query for a table.	List

Пример кода

Пример Таблицы 1

Следующий скрипт печатает имена автономных таблиц, у которых есть неисправный источник данных, для всех таблиц на всех картах:

import arcpy
aprx = arcpy.mp.ArcGISProject(r"C:\Projects\YosemiteNP\Yosemite.aprx")
for m in aprx.listMaps():
    for tbl in m.listTables():
        if tbl.isBroken:
            print(f"Table: {tbl.name} is broken in map: {m.name}")
del aprx

Пример Таблицы 2

Следующий скрипт добавляет на карту таблицу из файловой базы геоданных:

import arcpy
aprx = arcpy.mp.ArcGISProject(r"C:\Projects\YosemiteNP\Yosemite.aprx")
addTab = arcpy.mp.Table(r"C:\Projects\YosemiteNP\Data_Vector\YosemiteData.gdb\NHDFCode")
m = aprx.listMaps("Yose*")[0]
m.addTable(addTab)
del aprx

disableTime

Краткая информация

Обсуждение

Синтаксис

Свойства

Подсказка:

Примечание:

Примечание:

Методы

disableTime()

enableTime({startTimeField}, {endTimeField}, {autoCalculateTimeRange}, {timeDimension})

getDefinition(cim_version)

Возвращаемое значение

getSelectionSet()

Возвращаемое значение

listCharts({wildcard})

Возвращаемое значение

listDefinitionQueries({wildcard})

Возвращаемое значение

pasteProperties(source_table, {table_paste_properties[table_paste_properties,...]})

saveACopy(file_name)

setDefinition(definition_object)

setSelectionSet({oidList[oidList,...]}, {method})

updateConnectionProperties(current_connection_info, new_connection_info, {auto_update_joins_and_relates}, {validate}, {ignore_case})

updateDefinitionQueries(definitionQueries[definitionQueries,...])

Пример кода

`disableTime()`

`enableTime({startTimeField}, {endTimeField}, {autoCalculateTimeRange}, {timeDimension})`

`getDefinition(cim_version)`

`getSelectionSet()`

`listCharts({wildcard})`

`listDefinitionQueries({wildcard})`

`pasteProperties(source_table, {table_paste_properties[table_paste_properties,...]})`

`saveACopy(file_name)`

`setDefinition(definition_object)`

`setSelectionSet({oidList[oidList,...]}, {method})`

`updateConnectionProperties(current_connection_info, new_connection_info, {auto_update_joins_and_relates}, {validate}, {ignore_case})`

`updateDefinitionQueries(definitionQueries[definitionQueries,...])`