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

Примечание

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

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

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

Для использования в playbook укажите: 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 строка	Номер клиента для подключения. Вы должны заключить значение в кавычки, чтобы сохранить ведущие нули. По умолчанию: `"000"`
conn_password строка / обязательно	Необходимый пароль для системы SAP.
conn_username строка / обязательно	Необходимое имя пользователя для системы SAP.
host строка / обязательно	Необходимый хост для системы SAP. Может быть полным доменным именем (FQDN) или IP-адресом.
snote строка	С параметром `snote`, будут работать только имплементация и деимплементация. Загрузка SNOTES в систему доступна только если указан параметр `snote_path`.
snote_path строка	Путь к извлечённому txt файлу SNOTE. Файл можно извлечь из SAR-пакета. Если `snote_path` не указан, необходимо определить параметр `snote`. Файл SNOTE txt должен находиться в месте, к которому у системы SAP есть доступ. Например, `/usr/sap/trans/files`.
state строка	Решение о том, что делать с SNOTE. Может быть `'present'`, `'absent'`. Варианты: `"present"` ← (по умолчанию) `"absent"`
sysnr строка	Номер системы 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 строка	Небольшое описание выполнения. Возвращается: всегда Пример: `"SNOTE 000298026 implemented."`
out список / элементы=словарь	Полное описание реализации 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

строка

Небольшое описание выполнения.

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

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

out

список / элементы=словарь

Полное описание реализации 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–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/sap_libs/sap_snote_module.html