@k-georgiev

Un identifiant de noeud (nid) correspond, pour être précis techniquement, à la page du document sur Drupal (le CMS intégré à GoFAST qui génère entre autre l'interface graphique et lie les composants entre eux).

Le document associé à un noeud a également un identifiant (sur Alfresco) mais il n'est généralement pas utilisé dans nos API REST. On peut par contre le retrouver lorsqu'on attaque en direct l'API CMIS de la GED Alfresco intégrée.

Les emplacements eux par contre n'ont pas d'identifiants, ce sont des "métadonnées" associés aux documents, eux mêmes associés aux noeuds. Nos APIs travaillent avec les identifiants de noeud (nid) et s'occupent ensuite d'appliquer les modifications en GED.

Par contre la confusion vient peut être du fait que les espaces collaboratifs (qui correspondent à des répertoires en GED) ont effectivement également une page sur Drupal, et donc un identifiant de noeud.

N'hésitez pas à revenir vers moi si ce n'est pas clair !

Bonne journée !

Cordialement,

@k-georgiev No worries, it can also help others in the community 😉

Bonjour @Raphaël-Badawi,

Merci Pour votre reponse, effectivement le probleme etait au niveau su buffer ainsi que dans les headers.
c'est bon ca marche maintenant,
Merci.

@Raphaël-Badawi said in automatisation de process via API:

Pour répondre à votre dernière qauestion, un espace est plus rapide à archiver qu'à supprimer donc en termes de performances l'archivage est une meilleure opération.

Bonjour Raphaël,

merci pour ces précisions. LDAP ayant été écarté au début du projet je pense qu'on va se retrouver un peu bloqué.
En ce qui concerne les performances qui m'inquiètent sont celles liées au fait qu'un utilisateur est membre d'un grand nombre d'espaces, et que du fait qu'un espace soit "seulement" archivé, on se retrouve avec les soucis rencontrés précédemment. Ceci dit ça nous débloque au moins la dernière partie de la demande client à savoir "nettoyer" un espace aprés utilisation.

Vous pouvez faire des appels API depuis n'importe quel langage de programmation.

En bash et PHP vous pouvez utiliser curl, en JS vous pouvez utiliser fetch. En Java il y a le paquet HttpUrlConnection. Et en Python il y a le http.client : https://docs.python.org/3/library/http.client.html

Par exemple pour la requête du premier exemple, où l'utilisateur "adm" veut ajouter au document n°586 l'emplacement de son espace personnel, en curl on aurait ceci :
curl -X POST -H "Content-Type: application/json" -d '{"nid": 586, "locations": ["/Sites/_adm"]}' -u "adm:mypassword" http://gofast-demo.ceo-vision.com/api/node/locations

et en python on aurait quelque chose comme ça (pas du tout expert en python donc possiblement approximatif) :

import http.client import json # Set the request parameters url = "gofast-demo.ceo-vision.com" endpoint = "/api/node/locations" payload = {"nid": 586, "locations": ["/Sites/_adm"]} headers = {"Content-Type": "application/json"} username = "adm" password = "mypassword" # Encode the username and password in base64 auth = f"{username}:{password}" encoded_auth = auth.encode("utf-8") b64_auth = base64.b64encode(encoded_auth).decode("utf-8") # Create an HTTP connection conn = http.client.HTTPConnection(url) # Make the POST request conn.request("POST", endpoint, json.dumps(payload), headers={"Authorization": f"Basic {b64_auth}", **headers}) # Get the response response = conn.getresponse() # Print the response status and body print(f"Response Status: {response.status} {response.reason}") print("Response Body:") print(response.read().decode("utf-8")) # Close the connection conn.close()

bref, tous les chemins mènent à Rome 😉

Bien à vous,
Raphaël.

Bonjour @cpotter , merci pour l'update, si possible de nous verifier le fonctionnement pour mettre en place les changement sur l'API de notre coté.
Cordialement,
Jawad Benaissa

Pour envoyer un fichier j'utilise Java et ce n'est pas moi qui est fait ce code, mais il reprend le code fourni sur cette page : https://blog.cpming.top/p/httpurlconnection-multipart-form-data

Utilisé comme suit :

try { // Set header Map<String, String> headers = new HashMap<>(); String basicAuth = Base64.getEncoder().encodeToString((goFastLogin+":"+goFastPassword).getBytes()); headers.put("Authorization", "Basic "+basicAuth); logger.info("Conexion à go fast"); HttpPostMultipart multipart = new HttpPostMultipart("https://gofasturl/api/node/node", "utf-8", headers); // Add form field multipart.addFormField("type", "alfresco_item"); multipart.addFormField("title", nomFichier); multipart.addFormField("locations", "[\"" + Path + "\"]"); // Add file multipart.addFilePart("file", fichier, nomFichier); // Print result logger.info("Envoie du fichier"); String response = multipart.finish(); return response; } catch (IOException e) { e.printStackTrace(); }

Bonjour @vgirod

Il n'est pour le moment pas possible d'utiliser le broadcast dans les API GoFAST effectivement.

Cela est un peu dangeureux car on ne voit pas ce que l'on fait comme lorsqu'on utilise l'interface graphique mais avec un paramètre supplémentaire pour "forcer" le broadcast cela devrait pouvoir se faire sans prendre trop de risques.

J'ai ouvert un ticket en interne sur le sujet (ref. GOFAST-8411) mais je ne peux pas certifier quand il pourra être mis au plan de développement déjà bien chargé cette année.

Etant donné que vous êtes un client Enterprise, vous pouvez si vous le souhaitez contacter votre interlocuteur chez nous ou nous envoyer un mail à sales@ceo-vision.com si vous souhaitez sponsoriser et accélérer ce développement dans une prochaine version.

Bonne soirée !

Bonjour Axel,

Nous nous sommes aperçu qu'il y avait des manques dans la partie API et aussi pour la traduction. Nous allons corriger la situation.

@sjeandroz
bonjour Sylvain, avez vous pu voir en interne pour un échange par visio en fonction de votre planning?

bonne journée

Bonjour @tcl,

Pour le moment nous ne disposons pas d'une documentation plus précise concernant cette API.

Néanmoins si vous souhaitez des informations particulières, sur des cas d'usages par exemple, n'hésitez pas à m'en faire part.

Bonsoir Marion,

Effectivement il y a pas mal de choses qu'on va pouvoir facilement vous mettre à disposition pour déjà dans un premier temps faire remonter les statistiques de la plateforme accessibles en WEB dans vos outils.

Pour parler technique : Les statistiques de la plateforme sont la 1ère implémentation du mécanisme d'API REST de GoFAST mais cette partie n'est pas documentée car elle n'est actuellement utilisée qu'entre le serveur GoFAST et le client (le navigateur).

Néanmoins il est tout à fait envisageable de rendre cette API publique. Il est assez facile d'ailleurs de s'en rendre compte en inspectant l'onglet réseau de son navigateur quand on navigue dans la page des statistiques.

N'hésites pas à revenir vers nous la semaine du 6 avril pour faire un premier point sur le sujet.

Bonne soirée !

Bonjour,

Je travaille avec les api rest proposé par l'application Community. Je souhaite ajouter un fichier mais il me renvoie une erreur. voici le code que j'utilise :

url = "https://gofast.ceo-vision.com/api/node/node" headers = {'Content-Type': "application/json", 'Authorization': "Basic user:password(Base 64 encoded)"} data = {'type': 'alfresco_item', 'title': file.filename,'locations':'/Site/_Organisation/myorga/2021/','file':file} print(requests.post(url, params=data, headers=headers).json()

Lorsque j'envoie la demande, j'ai le retour suivant : message : 'type is mandatory parameter'
Je ne comprends pas car je le passe en paramètre!
Merci par avance pour votre aide.

Merci bien Sylvain pour votre prompt réponse.
Bonne journée,
Christophe