Ir al contenido principal

Creating a User to Consume X3 Web Services


When consuming X3 web services from another platform, such as .net, an X3 user and password must be used to make the web services call.  If the admin user in X3 is set up to call web services, the password by default is blank.  This means the user in the X3 web service call is admin, and the password is blank.  This may cause several issues or concerns as far as security goes.  First of all, you may want to use a user other than the admin user to make the web services calls.  Second, you will likely want to use a password other than blank.
If you have created a new user in X3, and defined it as a web services user, and attempt to use that newly created user and password combination to call the web service, you will likely find that the call fails.  The reason is, the web service is making the call at the folder level, and the user/password defined when the user was created is not the user/password combination the web services layer is using to validate the user.

Creating the User

Here are the steps to create a new user to use in the consumption of web services in X3.
  1. Create a user as you normally would in X3. This is done from Administration > UsersX3 web services creating user
  2. In my example, I created a user named websvc with a password of websvc. Login
  3.  Next, go to Setup > Users, and create the user as an X3 user.Creating user
  4.  In my example, I created an X3 user of WEB1, and attached it to the WEBSVC login. Remember that the checkbox next to “Web services connection” needs to be check to enable this user as a web services user.X3 Web Services Connection

Consuming the Web Service from an External Application

At first thought, you may think you can now access the web services from a .net program using this same user and password that is used to log into X3.  However, if you try to consume the X3 web services using the user websvc / websvc, the authentication will fail.  The web services call will return a message indicating the password is incorrect.
External Application
If you change the password in your web services call to blank, the web service will successfully connect, however, you probably don’t want to use a blank password.

Resolution

  1. Return to the X3 session, making sure you are logged in as your web services user (websvc in my example).
  2. Go to Usage > Password Change.Resolution
  3. You will be asked to enter the “Former password”, along with a new password. By default, when a user is created, the “Former password” will be blank.  Leave the “Former password” blank, and enter a new value for the “New Password”.  In my case, I made the new password “password”. Changing this password will not affect the password that is used to log into X3.
Password Change     4. Now return to the .net program, and use the newly entered value from above for your password, which in my case, was “password”. The web service authentication will now work.

Summary

When attempting to consume X3 web services from an external application, you will want to provide a secure method of accessing X3.  This will likely require creating a user used exclusively for web services, and providing a secure password to use to consume those web services.  The information above provides detailed steps on how to successfully create a user with a secure password to consume the web services.

Entradas populares de este blog

Valores de fstat

Fstat fstat  is a numeric status that is returned upon execution of a database operation, a sequential file operation, or a lock instruction. Syntax fstat Examples # MYTABLE is a table with a key called KEY1, that has a unique component called KEYVAL # Create a record in the table MYTABLE with they key value 1 if it doesn't exist Local File MYTABLE [MYT] Read [MYT]KEY1=1 If fstat [MYT]KEYVAL=1 : Write [MYT] If fstat MSG="The key was created in the mean time" Else MSG="Key created" Endif Else MSG="Key already exists" Endif Details fstat  is always set to '0' if the operation is successfully completed, and has a non-null value if there is an error: In a sequential read ( Getseq  and  Rdseq ),  fstat  is set to '1' at the end of the file. On  Lock ,  fstat  is set to '1' if the lock could not be performed. For a database operation ( Read ,  Look ,  Readlock ,  For ,  Write ,  ...
Leer más

3 ways to send a mail from code in Sage X3, with more attachments too

Origen Fuente:  https://en.sagedev.it/sagex3/send-mail-from-code-with-attachments-sage-x3/ Autor:  https://en.sagedev.it/category/sagex3/ In this post I’ll show you how to send a mail from adonix code in Sage X3. The points we will face are: 1) Meladx/Send introduction 2) Sending  through  meladx (the best way for me: at the end with just a single code line you send a mail!) 3) Sending  through  Workflow 4) Sending  through  ENVOI_MAIL(…) From AWRKMEL Sending mail from code in Sage X3: Send vs meladx Sage X3 has two native ways for sending mails. The first way is  meladx  executable file, that you can find in  runtime\bin  directory. The seconde one is Send instruction, that was used to send mail through an application of the client station (for more information on “Send GSERMES”  go here ). The Meladx executable Meladx send messages through SMTP/POP3 protocols by means of the mail  ...
Leer más

How to Install and Manage Sage X3 Add-Ins in Microsoft Office

When you enable an add-in, it adds custom commands and new features to Microsoft Office programs that help increase your productivity. In this blog post, we’ll review how to install the Sage X3 Add-In for MS Excel and what to do if your Sage X3 Add-In is missing. Fuente original: https://www.netatwork.com/how-to-install-and-manage-sage-x3-add-ins-in-ms-office/ How to Install the Sage X3 Add-In in Microsoft Excel Go to Administration > Utilities > Installation > Install addins for Office V11 Image:   V12 Image:   It should begin downloading the exe, open the exe Next > Install   Open Excel > File > Options   Select Add–Ins > Manage: COM Add-ins > Go   Check the “Excel AddIn for Sage” > Ok   You are now ready to export Excel-based reports/grids from Sage X3. How to troubleshoot and fix a missing Sage X3 add-in in Microsoft Excel Open the Microsoft Office product where the  Sage X3  add-in is missing. Go to Options: Se...
Leer más