community.sap_libs.sap_snote 模块 – 此模块将在 SAP S4HANA 环境中上传和（反）实施 SNOTES。

注意

此模块是 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 模块依赖于 pyrfc Python 库（版本 2.4.0 及更高版本）。根据您使用的发行版，您可能需要安装其他包才能使用这些库。

  • 此模块将使用功能组 SCWB_API。

  • 必须首先配置 TMS。

  • 无法通过 DDIC 或 SAP* 用户集成 SNOTES。

要求

执行此模块的主机需要以下要求。

  • pyrfc >= 2.4.0

参数

参数

注释

client

字符串

要连接到的客户端编号。

必须引用该值以确保保留前导零。

默认值： "000"

conn_password

字符串 / 必需

SAP 系统所需的密码。

conn_username

字符串 / 必需

SAP 系统所需的用户名。

host

字符串 / 必需

SAP 系统所需的 host。可以是 FQDN 或 IP 地址。

snote

字符串

只有使用 snote 参数才能进行实施和反实施操作。

只有提供 snote_path 时，才能将 SNOTES 上传到系统。

snote_path

字符串

解压缩的 SNOTE txt 文件的路径。

该文件可以从 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\"}] }]}"

作者

  • Rainer Leber (@rainerleber)