Модуль community.sap_libs.sap_snote — этот модуль загружает и (де)реализует SNOTES в среде SAP S4HANA.

Примечание

Этот модуль является частью коллекции community.sap_libs (версия 1.7.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install community.sap_libs. Для использования этого модуля необходимы дополнительные компоненты; подробности см. в разделе Требования.

Чтобы использовать модуль в плейбуке, укажите: community.sap_libs.sap_snote.

Добавлено в community.sap_libs 1.0.0

Краткое описание
Требования
Параметры
Примеры
Возвращаемые значения

Краткое описание

Для работы модуля sap_snote требуется библиотека Python pyrfc (версии 2.4.0 или новее). В зависимости от используемого дистрибутива может потребоваться установить дополнительные пакеты.
Этот модуль использует группу функций SCWB_API.
Сначала необходимо настроить TMS.
Интеграцию SNOTES нельзя выполнять от имени пользователя DDIC или SAP*.

Требования

Следующие компоненты должны быть установлены на хосте, на котором выполняется этот модуль.

pyrfc >= 2.4.0

Параметры

Параметр	Описание
client string	Номер клиента для подключения. Значение необходимо заключить в кавычки, чтобы сохранить ведущие нули. По умолчанию: `"000"`
conn_password string / обязательный	Необходимый пароль для системы SAP.
conn_username string / обязательный	Необходимое имя пользователя для системы SAP.
host string / обязательный	Необходимый адрес хоста системы SAP. Может быть полным доменным именем (FQDN) или IP-адресом.
snote string	Если указан параметр `snote`, будут доступны только реализация и отмена реализации. Загрузка SNOTES в систему доступна только при указании `snote_path`.
snote_path string	Путь к извлеченному текстовому файлу SNOTE. Файл можно извлечь из пакета SAR. Если параметр `snote_path` не указан, необходимо задать параметр `snote`. Текстовый файл SNOTE должен находиться в месте, к которому у системы SAP есть доступ. Например, `/usr/sap/trans/files`.
state string	Определяет, что делать с SNOTE. Допустимые значения: `'present'`, `'absent'` Варианты: `"present"` ← (по умолчанию) `"absent"`
sysnr string	Номер системы SAP. Значение необходимо заключить в кавычки, чтобы сохранить ведущие нули. По умолчанию: `"01"`

Примеры

- name: test snote module
  hosts: localhost
  tasks:
  - name: implement SNOTE
    community.sap_libs.sap_snote:
      conn_username: 'DDIC'
      conn_password: 'Passwd1234'
      host: 192.168.1.100
      sysnr: '01'
      client: '000'
      state: present
      snote_path: /usr/sap/trans/tmp/0002949148.txt

- name: test snote module without path
  hosts: localhost
  tasks:
  - name: deimplement SNOTE
    community.sap_libs.sap_snote:
      conn_username: 'DDIC'
      conn_password: 'Passwd1234'
      host: 192.168.1.100
      sysnr: '01'
      client: '000'
      state: absent
      snote: 0002949148

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

Общие возвращаемые значения описаны здесь; ниже перечислены поля, уникальные для этого модуля:

Ключ	Описание
msg string	Краткое описание выполнения. Возвращается: всегда Пример: `"SNOTE 000298026 implemented."`
out list / элементы=dictionary	Полное описание реализации SNOTE, если оно доступно. Возвращается: всегда Пример: `"{ \"RETURN\": [{\"ES_MSG\": { \"MSGNO\": \"000\", \"MSGTY\": \"\", \"MSGTXT\": \"\", \"MSGV1\": \"\" }, \"ET_MSG\": [], \"EV_RC\": 0, \"ET_MISSING_NOTES\": [], \"IT_FILENAME\": [{\"FILENAME\": \"/usr/sap/trans/tmp/0002980265.txt\"}], \"IT_NOTES\": [{\"NUMM\": \"0002980265\", \"VERSNO\": \"0000\"}] }]}"`

Ключ

Описание

msg

string

Краткое описание выполнения.

Возвращается: всегда

Пример: "SNOTE 000298026 implemented."

out

list / элементы=dictionary

Полное описание реализации SNOTE, если оно доступно.

Возвращается: всегда

Пример: "{ \"RETURN\": [{\"ES_MSG\": { \"MSGNO\": \"000\", \"MSGTY\": \"\", \"MSGTXT\": \"\", \"MSGV1\": \"\" }, \"ET_MSG\": [], \"EV_RC\": 0, \"ET_MISSING_NOTES\": [], \"IT_FILENAME\": [{\"FILENAME\": \"/usr/sap/trans/tmp/0002980265.txt\"}], \"IT_NOTES\": [{\"NUMM\": \"0002980265\", \"VERSNO\": \"0000\"}] }]}"

Авторы

Rainer Leber (@rainerleber)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/community/sap_libs/sap_snote_module.html