Tutorial (company)

• connectionID = {3aef3af6-8642-4fc1-8dc9-4e08bd76a6bf}
• actorType = “Customer”

​

Connecting

1. Click EDIT and then click the right Actor Type link. The list of Actor Type links is determined by the GetSupportedActorTypes call made when the connection was set up.
2. This opens the Connect to ERP dialog, which calls the GetSearchableFields function to find out what columns to present in the results list.
   StringArrayPluginResponse response = GetSearchableFields(\{3aef3af6-8642-4fc1-8dc9-4e08bd76a6bf\}, "Customer");
   
   
3. The SuperOffice client calls the SearchActors method to find out if there are any customers in the ERP with the same name. The connector is free to implement the search as it wants. It would be nice if the results were filtered according to the parameters, but this is not required.
   ActorArrayPluginResponse  SearchActors(Guid connectionID, string actorType, string searchText, string[] fieldKeys )
   
   Example input:
   • searchText = “Orkdal Eldresenter”:
   • fieldKeys: { “NUMBER1”, “NAME”, “ADDRESS1” }
   Example result:
   [0] = \{ ActorType = "Customer", ErpKey = "erp831",
           LastModified = "103423595",
           FieldValues = \{
              ["NAME"] = "Orkdal Senter AS",
              ["NUMBER1"] = "4343321",
              ["ADDRESS1"] = "x2" \}
   
4. The returned actors are displayed in the results grid in the dialog.

​

Searching

• If the user enters a different name, SearchActors is called again and the results are updated.
• If the user clicks the Advanced Search button, the search dialog appears and SearchActorsAdvanced is called like during Import.
• If the user selects one of the actors and clicks the Connect button, the full Actor is retrieved from the ERP system using GetActors.
  ActorArrayPluginResponse GetActors( Guid connectionID, string actorType, string[] erpKeys, string[] fieldKeys )
  
  Example input:
  • erpKeys: [0] = "erp831"
  • fieldKeys: [0] = "NAME", [1] = "NUMBER1", [2] = "SUPPLIERLIMIT", [3] = "STDTERMS", [4] = "ADDRESS1"
  Example result:
  [0] = \{ ActorType = "Customer", ErpKey = "erp831",
          LastModified = "103423595",
          FieldValues = \{
            ["NAME"] = "Orkdal Senter AS",
            ["NUMBER1"] = "4343321",
            ["STDTERMS"] = "60",
            ["SUPPLIERLIMIT"] = "x2" \}
            ["ADDRESS1"] = "Oveien 544" \}
  
• If some of the ERP Actor values conflict with the SuperOffice entity, these are displayed in the dialog:

​

Updating ERP

ActorArrayPluginResponse SaveActors( Guid connectionId, ErpActor[] actors )

[0] = { ActorType = "Customer", ErpKey = "erp831",
        LastModified = "103423595",
        FieldValues = {
          ["NAME"] = "Orkdal Senter AS",
          ["NUMBER1"] = "4343321",
          ["STDTERMS"] = "60",
          ["SUPPLIERLIMIT"] = "x2" }
          ["ADDRESS1"] = "Oveien 544" }

​

Creating

1. If the user can’t find a match in the ERP system, they check the Can’t find match in ERP checkbox.
2. The Connect button changes to Create.
3. The user is presented with a dialog where they can fill in the defaults. The list of fields to present and the suggested default values are stored in the SuperOffice database.
4. The SuperOffice client calls the connector’s CreateActor to create the actor, and to get back the ERP ID for the new actor:
   ActorPluginResponse CreateActor( Guid connectionID, ErpActor actor )
   
   Example input:
   actor = \{ ActorType = "Customer", ErpKey = "",
     LastModified = "",
     FieldValues = \{
       ["NAME"] = "Orkdal Eldresenter AS",
       ["NUMBER1"] = "4343321",
       ["ADDRESS1"] = "x2" \}
   
   Example result:
   actor = \{ ActorType = "Customer", ErpKey = "erp831",
     LastModified = "103423595",
     FieldValues = \{
       ["NAME"] = "Orkdal Eldresenter AS",
       ["NUMBER1"] = "4343321",
       ["ADDRESS1"] = "x2" \}
   
5. The returned actor’s ErpKey and last-modified date are stored in the SuperOffice database, and the link is created.

​

Viewing

1. The SuperOffice client calls GetActors for the card being viewed, requesting the fields marked show in ERP card. Any list items that need to be shown are turned into text values by calling GetListItems.
      ActorArrayPluginResponse GetActors(Guid connectionID, string actorType, string[] erpKeys, string[] fieldKeys )
   
   Example input:
   • erpKeys: [0] = "erp831"
   • fieldKeys: [0] = "CUSTGR", [1] = "NUMBER1", [2] = "DOUBLE", [3] = "DATE"
   Example result:
   [0] = \{ ActorType = "Customer", ErpKey = "erp831",
     LastModified = "103423595",
     FieldValues = \{
       ["CUSTGR"] = "G4",
       ["NUMBER1"] = "[I:0]",
       ["DOUBLE"] = "[D:0.0]",
       ["DATE"] = "" \}
   
2. The returned actors are displayed in the ERP tab under the connection name heading.

​

Disconnecting