2021-12-06 Fred Gleason <fredg@paravelsystems.com>

* Added an 'AssignSchedCode()' method to the 'rivwebpyapi' API.

Signed-off-by: Fred Gleason <fredg@paravelsystems.com>

ChangeLog

@@ -22672,3 +22672,5 @@
 	* Added an 'AddLog()' method to the 'rivwebpyapi' API.
 2021-12-06 Fred Gleason <fredg@paravelsystems.com>
 	* Added an 'DeleteLog()' method to the 'rivwebpyapi' API.
+2021-12-06 Fred Gleason <fredg@paravelsystems.com>
+	* Added an 'AssignSchedCode()' method to the 'rivwebpyapi' API.

apis/rivwebpyapi/api/rivwebpyapi.py

@@ -416,6 +416,41 @@ class rivwebpyapi(object):
         if(r.status_code!=requests.codes.ok):
             r.raise_for_status()
 
+    def AssignSchedCode(self,cart_number,sched_code):
+        """
+          Assigned a schedule code to a cart.
+
+          Takes the following arguments:
+
+          cart_number - The number of the desired cart, in the range
+                        1 - 999999 (integer)
+
+          sched_code - An existing schedule code (integer).
+        """
+
+        if((cart_number<1)or(cart_number>999999)):
+            raise ValueError('invalid cart number')
+        if(not sched_code):
+            raise ValueError('invalid schedule code')
+
+        #
+        # Build the WebAPI arguments
+        #
+        postdata={
+            'COMMAND': '25',
+            'LOGIN_NAME': self.__connection_username,
+            'PASSWORD': self.__connection_password,
+            'CART_NUMBER': str(cart_number),
+            'CODE': sched_code
+        }
+
+        #
+        # Fetch the XML
+        #
+        r=requests.post(self.__connection_url,data=postdata)
+        if(r.status_code!=requests.codes.ok):
+            r.raise_for_status()
+
     def DeleteLog(self,log_name):
         """
           Delete an existing log.

apis/rivwebpyapi/tests/Makefile.am

@@ -23,6 +23,7 @@
 EXTRA_DIST = add_cart.py\
              add_cut.py\
              add_log.py\
+             assign_sched_code.py\
              delete_log.py\
              list_cart.py\
              list_cart_sched_codes.py\

apis/rivwebpyapi/tests/assign_sched_code.py

@@ -0,0 +1,63 @@
+#!%PYTHON_BANGPATH%
+
+# assign_sched_code.py
+#
+# RivWebPyApi test script for Rivendell
+#
+#  Test the AssignSchedCode Web API call
+#
+#   (C) Copyright 2021 Fred Gleason <fredg@paravelsystems.com>
+#
+#   This program is free software; you can redistribute it and/or modify
+#   it under the terms of the GNU General Public License version 2 as
+#   published by the Free Software Foundation.
+#
+#   This program is distributed in the hope that it will be useful,
+#   but WITHOUT ANY WARRANTY; without even the implied warranty of
+#   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+#   GNU General Public License for more details.
+#
+#   You should have received a copy of the GNU General Public
+#   License along with this program; if not, write to the Free Software
+#   Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+#
+
+import getpass
+import rivwebpyapi
+import sys
+
+url='';
+username=''
+password=''
+cart_number=0
+sched_code=''
+
+#
+# Get login parameters
+#
+usage='assign_sched_code --url=<rd-url> --username=<rd-username> --cart-number=<num> --sched-code=<code> [--password=<passwd>]'
+for arg in sys.argv:
+    f0=arg.split('=')
+    if(len(f0)==2):
+        if(f0[0]=='--url'):
+            url=f0[1]
+        if(f0[0]=='--username'):
+            username=f0[1]
+        if(f0[0]=='--password'):
+            password=f0[1]
+        if(f0[0]=='--cart-number'):
+            cart_number=int(f0[1])
+        if(f0[0]=='--sched-code'):
+            sched_code=f0[1]
+
+if(not password):
+    password=getpass.getpass()
+if((not url)or(not username)):
+    print(usage)
+    sys.exit(1)
+
+#
+# Execute
+#
+webapi=rivwebpyapi.rivwebpyapi(url=url,username=username,password=password)
+webapi.AssignSchedCode(cart_number=cart_number,sched_code=sched_code)