SaveWebForm

Syntax

bool SaveWebForm(WebFormId tWebForm, SaveWebFormArg tArg)

Parameters

tWebForm. Opened web form instance moniker.

tArg. Operation execution parameters.

Description

The SaveWebForm operation saves web form changes.

Comments

To execute the operation, in the tWebForm field specify opened web form instance moniker, and in the tArg.meta field specify updated metadata that should be saved. The moniker can be obtained using the OpenWebForm operation.

The operation results in the logical True if web form changes were saved successfully.

Example

Below is the example of saving web form changes. The request contains opened web form instance moniker and updated form code. The response contains whether changes were saved successfully.

SOAP request:

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<SaveWebForm xmlns="http://www.fsight.ru/PP.SOM.Som">
<tWebForm xmlns="">
  <id>JAIKPLIJFFCBGOAEFFBKJBHEGIPOBIEENJBIDLIKIPOIMHCL!M!S!WFEGNCAPIJFFCBGOAELIJILLJGDJIDPIMEGLDMIMKMGNIIGMGI</id>
  </tWebForm>
<tArg xmlns="">
<meta>
  <text>{"items":[{"id":"form","type":"form","props":{"text":"Input","name":"OBJ341659WebForm","modal":true,"color":{"a":255,"r":255,"g":255,"b":255},"size":{"width":234,"height":222},"coordinate":{"left":0,"top":0}},"events":{}},{"type":"label","id":"label_kLkZu0pLy__TOeiJvnl5K","props":{"text":"Initial value:","name":"Label1","alignment":"left","color":{"a":0,"r":255,"g":255,"b":255},"font":{"name":"Roboto","color":{"a":255,"r":0,"g":0,"b":0},"size":12,"bold":false,"italic":false,"strikeThrough":false,"underline":false},"visible":true,"enabled":true,"hint":"","showHint":true,"size":{},"coordinate":{"top":15,"left":17},"position":"absolute"},"parent":"form","events":{}},{"type":"input","id":"input_jLL25aWLkWL3opLvqNRJQ","props":{"text":"","name":"Input1","placeholder":"Enter value","color":{"a":0,"r":255,"g":255,"b":255},"font":{"name":"Roboto","color":{"a":255,"r":0,"g":0,"b":0},"size":14,"bold":false,"italic":false,"strikeThrough":false,"underline":false},"visible":true,"enabled":true,"hint":"","showHint":true,"size":{"width":200,"height":32},"coordinate":{"top":35,"left":17},"position":"absolute"},"parent":"form","events":{}},{"type":"label","id":"label_XngwyZ3Xgzod7NqgQXQtd","props":{"text":"Final value:","name":"Label2","alignment":"left","color":{"a":0,"r":255,"g":255,"b":255},"font":{"name":"Roboto","color":{"a":255,"r":0,"g":0,"b":0},"size":12,"bold":false,"italic":false,"strikeThrough":false,"underline":false},"visible":true,"enabled":true,"hint":"","showHint":true,"size":{},"coordinate":{"top":75,"left":17},"position":"absolute"},"parent":"form","events":{}},{"type":"input","id":"input_VGaJ7DAC5T51_ggvP_bul","props":{"text":"","name":"Input2","placeholder":"Enter value","color":{"a":0,"r":255,"g":255,"b":255},"font":{"name":"Roboto","color":{"a":255,"r":0,"g":0,"b":0},"size":14,"bold":false,"italic":false,"strikeThrough":false,"underline":false},"visible":true,"enabled":true,"hint":"","showHint":true,"size":{"width":200,"height":32},"coordinate":{"top":95,"left":17},"position":"absolute"},"parent":"form","events":{}},{"type":"button","id":"button_INWdSqIoQSDkwA1rq554B","props":{"text":"Save","name":"Button1","color":{"a":255,"r":70,"g":142,"b":240},"font":{"name":"Roboto","color":{"a":255,"r":255,"g":255,"b":255},"size":16,"bold":false,"italic":false,"strikeThrough":false,"underline":false},"visible":true,"enabled":true,"hint":"","showHint":true,"size":{"width":110,"height":32},"coordinate":{"top":171,"left":107},"variant":"primary","position":"absolute"},"parent":"form","events":{}}]}/r/n//...//Form code comments//...</text>
  </meta>
  </tArg>
  </SaveWebForm>
  </s:Body>
  </s:Envelope>

SOAP response:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
<soapenv:Body>
  <SaveWebFormResult xmlns="http://www.fsight.ru/PP.SOM.Som" xmlns:q1="http://www.fsight.ru/PP.SOM.Som" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">1</SaveWebFormResult>
  </soapenv:Body>
  </soapenv:Envelope>

JSON request:

{
 "SaveWebForm" : 
  {
   "tWebForm" : 
    {
     "id" : "JAIKPLIJFFCBGOAEFFBKJBHEGIPOBIEENJBIDLIKIPOIMHCL!M!S!WFEGNCAPIJFFCBGOAELIJILLJGDJIDPIMEGLDMIMKMGNIIGMGI"
    },
   "tArg" : 
    {
     "meta" : 
      {
       "text" : "{"items":[{"id":"form","type":"form","props":{"text":"Input","name":"OBJ341659WebForm","modal":true,"color":{"a":255,"r":255,"g":255,"b":255},"size":{"width":234,"height":222},"coordinate":{"left":0,"top":0}},"events":{}},{"type":"label","id":"label_kLkZu0pLy__TOeiJvnl5K","props":{"text":"Initial value:","name":"Label1","alignment":"left","color":{"a":0,"r":255,"g":255,"b":255},"font":{"name":"Roboto","color":{"a":255,"r":0,"g":0,"b":0},"size":12,"bold":false,"italic":false,"strikeThrough":false,"underline":false},"visible":true,"enabled":true,"hint":"","showHint":true,"size":{},"coordinate":{"top":15,"left":17},"position":"absolute"},"parent":"form","events":{}},{"type":"input","id":"input_jLL25aWLkWL3opLvqNRJQ","props":{"text":"","name":"Input1","placeholder":"Enter value","color":{"a":0,"r":255,"g":255,"b":255},"font":{"name":"Roboto","color":{"a":255,"r":0,"g":0,"b":0},"size":14,"bold":false,"italic":false,"strikeThrough":false,"underline":false},"visible":true,"enabled":true,"hint":"","showHint":true,"size":{"width":200,"height":32},"coordinate":{"top":35,"left":17},"position":"absolute"},"parent":"form","events":{}},{"type":"label","id":"label_XngwyZ3Xgzod7NqgQXQtd","props":{"text":"Final value:","name":"Label2","alignment":"left","color":{"a":0,"r":255,"g":255,"b":255},"font":{"name":"Roboto","color":{"a":255,"r":0,"g":0,"b":0},"size":12,"bold":false,"italic":false,"strikeThrough":false,"underline":false},"visible":true,"enabled":true,"hint":"","showHint":true,"size":{},"coordinate":{"top":75,"left":17},"position":"absolute"},"parent":"form","events":{}},{"type":"input","id":"input_VGaJ7DAC5T51_ggvP_bul","props":{"text":"","name":"Input2","placeholder":"Enter value","color":{"a":0,"r":255,"g":255,"b":255},"font":{"name":"Roboto","color":{"a":255,"r":0,"g":0,"b":0},"size":14,"bold":false,"italic":false,"strikeThrough":false,"underline":false},"visible":true,"enabled":true,"hint":"","showHint":true,"size":{"width":200,"height":32},"coordinate":{"top":95,"left":17},"position":"absolute"},"parent":"form","events":{}},{"type":"button","id":"button_INWdSqIoQSDkwA1rq554B","props":{"text":"Save","name":"Button1","color":{"a":255,"r":70,"g":142,"b":240},"font":{"name":"Roboto","color":{"a":255,"r":255,"g":255,"b":255},"size":16,"bold":false,"italic":false,"strikeThrough":false,"underline":false},"visible":true,"enabled":true,"hint":"","showHint":true,"size":{"width":110,"height":32},"coordinate":{"top":171,"left":107},"variant":"primary","position":"absolute"},"parent":"form","events":{}}]}\/r\/n\/\/...\/\/Form code comments\/\/..."
      }
    }
  }
}

JSON response:

{
 "SaveWebFormResult" : "1"
}
public static bool SaveWebForm(string moniker, string newText = "")
{
    var somClient = new SomPortTypeClient(); // Proxy object for operation execution
    var tSave = new SaveWebForm()
    {
        tArg = new SaveWebFormArg()
        {
            meta = new WebFormMD()
            {
                text = newText
            }
        },
        tWebForm = new WebFormId() { id = moniker }
    };
    // Save web form changes
    var result = somClient.SaveWebForm(tSave);
    return result;
}

See also:

Working with Development Environment