Standard Web Services for the Fabasoft Cloud

The standard web service encapsulates commonly used operations.

SOAP and WSDL

You can use SOAP to call the operations listed in the Cloud Standard Web Service WSDL.

The WSDL can be retrieved via following URL:

https://<host>/<vdir>/fscdav/wsdl?WEBSVC=FSCFOLIOCLOUD_1_1001_StandardWebService

Example:

https://at.cloud.fabasoft.com/folio/fscdav/wsdl?WEBSVC=FSCFOLIOCLOUD_1_1001_StandardWebService

JSON

The Cloud Standard Web Service also supports the JSON format. You can call the operations the following way:

https://<host>/<vdir>/wsjson/FSCFOLIOCLOUD_1_1001_StandardWebService/<operation>

Example:

https://at.cloud.fabasoft.com/folio/wsjson/FSCFOLIOCLOUD_1_1001_StandardWebService/GetCurrentUser

Available Operations

The Cloud Standard Web Service provides following operations:

AddObjectRemark
Adds a remark to an object.
CreateChangeSubscription
Creates a change subscription that is used to inform about changes of objects added to the change subscription.
CreateTeamRoom
Creates a Teamroom with the defined values.
CreateTeamRoomInit
Retrieves the required information (e.g. the list of all organizations of the user) for creating a Teamroom.
DeleteChangeSubscription
Deletes a change subscription.
GetChangedObjects
Returns a list of changed objects since a defined date.
GetCurrentUser
Returns all relevant data for the currently logged in user.
GetObjectHistory
Returns the history of an object.
GetObjectRemarks
Returns all remarks of an object.
GetSearchFolderResults
Returns a list of objects contained in a search folder.
SendTeamRoomInvitation
Sends invitations for the defined Teamroom to all defined users.
SendTeamRoomInvitationInit
Returns a list of users of a Teamroom and the default invitation message for this Teamroom.
TeamRoomInvitations
Returns a list of all pending Teamroom invitations of the user.

More information about the parameters of the operations can be found here (the listed actions are mapped to the corresponding web service operations):

Examples

The following chapters provide some standard web service examples.

GetCurrentUser

https://at.cloud.fabasoft.com/folio/wsjson/FSCFOLIOCLOUD_1_1001_StandardWebService/GetCurrentUser

Input JSON Object

---

Output JSON Object

{
  "userdata":{
    "_":"UserData",
    "objaddress":"COO.1.506.1.5553",
    "udfirstname":"Christina",
    "udsurname":"Baumann",
    "udsalutation":"Sehr geehrte Damen und Herren",
    "udorgtxt":"Cloud DataXchange",
    "udemailinformation":[
      {
        "_":"EmailInformation",
        "emailaddress":"baumann@sq.fabasoft.com",
        "addrtopic":{
          "_":"TermComponentObject",
          "objaddress":"COO.1.1001.1.182480",
          "objname":"E-Mail 1"
        }
      }
    ],
    "udfeatures":[
      {
        "_":"UserFeature",
        "uffeatureid":"aspect",
        "ufadditionalfeatureinfo":[
          "FSCFOLIO@1.1001:CMISProperties",
          "FSCFOLIO@1.1001:CMISPropertiesRemarks"
        ]
      },
      {
        "_":"UserFeature",
        "uffeatureid":"basetypefolder",
        "ufadditionalfeatureinfo":[
          "COODESK@1.1:Folder"
        ]
      }
    ],
    "udhomelocation":"https://at.cloud.fabasoft.com/folio",
    "udcountryid":"AT"
  }
}

Note: udcountryid will return the ISO3166Alpha2 code of the country.

CreateTeamroom

https://at.cloud.fabasoft.com/folio/wsjson/FSCFOLIOCLOUD_1_1001_StandardWebService/CreateTeamRoomInit

Input JSON Object

---

Output JSON Object

{
  "groups":{
    "_":"Group",
    "objaddress":"COO.1.506.1.8025",
    "objname":"Cloud DataXchange"
  },
  "securitylevels":null,
  "errors":null,
  "enforceprimarygroup":false,
  "preselectprimarygroup":true
}

Note: Retrieves required information such as organizations assigned to the user. Security levels are not used in the Fabasoft Cloud. If an organization enforces to be used as primary organization, only that one will be returned and enforceprimarygroup will be true.

https://at.cloud.fabasoft.com/folio/wsjson/FSCFOLIOCLOUD_1_1001_StandardWebService/CreateTeamRoom

Input JSON Object

As POST request in the document envelope:

{
  name:"New Teamroom",
  parent:"COO.1.506.1.7065",
  group:"COO.1.506.1.8025",
  notification:false
}

As GET request in the URL as parameter:

?name=New Teamroom&parent=COO.1.506.1.7065&...

Output JSON Object

{
  "teamroom":{
    "_":"TeamRoom",
    "objaddress":"COO.1.506.3.11579",
    "objname":"New Teamroom"
  },
  "errors":null
}

Note: The name is mandatory. If the parent is empty, the objects will be put on the users’ desk. By default the notifications for a new Teamroom are activated.

SendTeamRoomInvitation

https://at.cloud.fabasoft.com/folio/wsjson/FSCFOLIOCLOUD_1_1001_StandardWebService/SendTeamRoomInvitationInit

Input JSON Object

As POST request in the document envelope:

{ teamroom:"COO.1.506.3.11579" }

As GET request in the URL as parameter:

?teamroom=COO.1.506.3.11579

Output JSON Object

{
  "message":"\r\nHello!\r\n\r\nIn order to simplify our collaboration I would like to invite you to the Fabasoft Cloud. In this trusted and reliable environment we will be able to exchange data and create joint work results.\r\n\r\nBest regards,\r\nChristina Baumann\nCloud DataXchange\r\n",
  "subject":"New Teamroom",
  "notacceptedusers":{
    "_":"JSAPIUser",
    "apiuobjaddress":"COO.1.506.1.5565",
    "apiuobjname":"R\u00fcegg Luca",
    "apiumail":"rueegg@fabasoft.com",
    "apiufirstname":"Luca",
    "apiusurname":"R\u00fcegg"
  },
  "notinvitedusers":null,
  "allusers":{
    "_":"JSAPIUser",
    "apiuobjaddress":"COO.1.506.1.5565",
    "apiuobjname":"R\u00fcegg Luca",
    "apiumail":"rueegg@fabasoft.com",
    "apiufirstname":"Luca",
    "apiusurname":"R\u00fcegg"
  },
  "errors":null
}

Note: Retrieves required information such as not invited users and users who have not accepted the invitation.

https://at.cloud.fabasoft.com/folio/wsjson/FSCFOLIOCLOUD_1_1001_StandardWebService/SendTeamRoomInvitation

Input JSON Object

As POST request in the document envelope:

{
  teamroom:”COO.1.1.1.1”,
  users: [{
    "_":"JSAPIUser",
    "apiuobjaddress":"COO.1.506.1.268",
    "apiufirstname":"William",
    "apiusurname":" Briere",
    "apiuobjname":"Briere William",
    "apiumail":"briere@sq.fabasoft.com"
  }],
  subject: "text",
  message: ["Line 1", "Line 2", "..."]
}

Output JSON Object

{
"users":null,
"errors":null
}

Note: The input parameter users will be reduced by each successful invitation. Each entry with invalid values or where an error occurred will be returned in the output JSON object as users. If no user exists for the entries apiuobjaddress or apiumail a user will be created.

The first name, surname and e-mail address in a user JSON object are mandatory, so that the user can be created, if it does not exist.

The message that is passed is encoded in UTF-8. If this message should contain line breaks, every line is a single entry in the message text list.

TeamRoomInvitations

https://at.cloud.fabasoft.com/folio/wsjson/FSCFOLIOCLOUD_1_1001_StandardWebService/TeamRoomInvitations

Input JSON Object

---

Output JSON Object

{
  "amount":1,
  "pendinginvitations":{
    "_":"TeamRoomInvitation",
    "objaddress":"COO.1.506.3.11649",
    "objname":"Marketing",
    "issuer":"Baumann Christina",
    "invitationtime":"2015-08-21T12:16:38+02:00"
  }
}

RespondInvitation

https://at.cloud.fabasoft.com/folio/wsjson/FSCFOLIOCLOUD_1_1001_StandardWebService/RespondInvitation

Input JSON Object

As POST request in the document envelope:

{
context:"COO.1.1001.1.324322",
teamroom:"COO.1.506.3.11579"
}

As GET request in the URL as parameter:

?teamroom=COO.1.506.3.11579

Output JSON Object

{
  "result":{
    "_":"TeamRoom",
    "objaddress":"COO.1.506.3.11649",
    "objname":"Marketing"
  },
  "errors":null
}

Note: The context may be COO.1.1001.1.324322 (accept) or COO.1.1001.1.324317 (refuse).

Standard Web Services for the Fabasoft Cloud

SOAP and WSDL

JSON

Available Operations

Examples

GetCurrentUser

CreateTeamroom

SendTeamRoomInvitation

TeamRoomInvitations

RespondInvitation

Download PDF

Download PDF