Rattacher un document

Le rattachement d’un document nécessite trois appels :

demander une URL de téléversement ;
envoyer le fichier vers cette URL ;
rattacher le fichier à une fiche Bonx.

Le document apparaît ensuite dans l’onglet Fichiers de la fiche.

1. Demandez une URL de téléversement

Envoyez le nom et le type MIME du fichier à generatePresignedUrlUpload.

mutation Upload($fileName: String!, $contentType: String) {
  generatePresignedUrlUpload(fileName: $fileName, contentType: $contentType) {
    uploadUrl
    fileName
    contentType
  }
}

Variables

{ "fileName": "bon-de-reception-REC-0412.pdf", "contentType": "application/pdf" }

La réponse contient :

uploadUrl, l’URL vers laquelle envoyer le fichier. Elle expire après 10 minutes ;
fileName, le nom de stockage créé par Bonx. Conservez cette valeur pour l’étape 3.

2. Envoyez le fichier

Envoyez le contenu du fichier avec une requête PUT vers uploadUrl. Utilisez le même en-tête Content-Type qu’à l’étape 1.

curl -X PUT "$UPLOAD_URL" \
  -H "Content-Type: application/pdf" \
  --data-binary "@bon-de-reception-REC-0412.pdf"

N’ajoutez pas le jeton Bonx à cet appel. L’URL de téléversement contient déjà une autorisation temporaire.

Le stockage refuse le fichier si le Content-Type est différent de celui utilisé à l’étape 1.

3. Rattachez le fichier à la fiche

Utilisez insertFilesOne pour créer le lien entre le fichier et la fiche.

mutation AttachFile(
  $fileId: String!
  $name: String!
  $contentType: String
  $size: Int!
  $recordId: Int!
  $recordType: String!
) {
  insertFilesOne(
    object: {
      fileId: $fileId
      name: $name
      contentType: $contentType
      size: $size
      recordId: $recordId
      recordType: $recordType
    }
  ) {
    id
  }
}

Variables

{
  "fileId": "9f2c…-bon-de-reception-rec-0412.pdf",
  "name": "Bon de réception REC-0412.pdf",
  "contentType": "application/pdf",
  "size": 284119,
  "recordId": 412,
  "recordType": "receivings"
}

Renseignez les variables comme suit :

fileId : utilisez le fileName reçu à l’étape 1 ;
name : indiquez le nom visible dans Bonx ;
size : indiquez la taille du fichier en octets ;
recordId : indiquez l’identifiant interne de la fiche ;
recordType : indiquez le type technique de la fiche.

Types de fiches disponibles

recordType contient le nom technique de l’entité au pluriel.

Fiche	`recordType`
Réception	`receivings`
Expédition	`shipments`
Commande de vente	`salesOrders`
Commande d’achat	`purchaseOrders`
Ordre de fabrication	`manufacturingOrders`
Article	`articles`
Lot	`lots`
Non-conformité	`defects`

Trouver l’identifiant d’une fiche

Un document contient souvent le numéro visible de la fiche, par exemple REC-0412. Utilisez ce numéro pour obtenir l’identifiant interne id.

query FindReceiving($reference: String!) {
  receivings(where: { name: { _eq: $reference } }) {
    id
    name
  }
}

Arrêtez le traitement si la requête ne renvoie aucun résultat. Dans ce cas, le numéro du document ne correspond à aucune réception.

Consultez l’exemple JavaScript complet pour automatiser ces trois appels.

​1. Demandez une URL de téléversement

​2. Envoyez le fichier

​3. Rattachez le fichier à la fiche

​Types de fiches disponibles

​Trouver l’identifiant d’une fiche

1. Demandez une URL de téléversement

2. Envoyez le fichier

3. Rattachez le fichier à la fiche

Types de fiches disponibles

Trouver l’identifiant d’une fiche