Table des matières

Search

  1. Préface
  2. Introduction aux services d'entité commerciale
  3. Appels de services d'entité commerciale Enterprise Java Bean
  4. Appels de services d'entité commerciale Representational State Transfer
  5. Appels de services d'entité commerciale du protocole SOAP (Simple Object Access Protocol)
  6. Services d'enregistrements de références croisées et de calculs de MVV
  7. Prise en charge du service de liaison d'entreprise
  8. Appels externes pour le nettoyage, l'analyse et la transformation de données
  9. Utilisation d'API REST pour ajouter des enregistrements
  10. Utilisation d'API REST pour le chargement de fichiers

Guide des services d'entité d'entreprise

Guide des services d'entité d'entreprise

Joindre des fichiers à des tâches

Joindre des fichiers à des tâches

Créez les métadonnées d'un fichier, puis chargez le contenu du fichier vers un stockage temporaire. Après avoir chargé le fichier, joignez-le à une tâche déclenchée ou à une tâche existante.
Pour joindre un fichier à des tâches déclenchées ou des tâches existantes, dans l'outil Provisionnement, activez les pièces jointes pour les déclencheurs de tâche, les types de tâche et les actions de tâche. Pour plus d'informations, consultez le
Guide de l'outil d'approvisionnement de MDM Multidomain
.
  1. Pour créer les métadonnées d'un fichier, utilisez l'API REST Créer les métadonnées du fichier avec le type de stockage TEMP.
    Par exemple, la demande suivante crée les métadonnées du fichier
    file1.txt
     :
    POST http://localhost:8080/cmx/file/localhost-orcl-MDM_SAMPLE/TEMP { “fileName”: “file1.txt”, “fileType”: “text”, “fileContentType”: “text/plain” }
    Créez toujours les métadonnées du fichier dans le stockage TEMP.
    L'API REST Créer les métadonnées du fichier renvoie un ID pour le fichier. L'ID de fichier est au format suivant :
    <Storage Type>_<RowID>
    . RowID désigne l'ID de ligne du fichier que vous chargez vers le stockage.
    Dans l'exemple, l'appel de l'API renvoie l'ID suivant pour
    file1.txt
     :
    TEMP_SVR1.1VDVS
    Vous pouvez utiliser l'ID de fichier pour charger, joindre, mettre à jour et supprimer le fichier.
  2. Pour charger le fichier, utilisez l'API REST Charger le contenu du fichier avec le type de stockage TEMP.
    Par exemple, la demande suivante charge le fichier vers le stockage TEMP :
    PUT http://localhost:8080/cmx/file/localhost-orcl-MDM_SAMPLE/TEMP/TEMP_SVR1.1VDVS/content Test attachment content: file 1
    Une fois le fichier chargé, il est conservé dans le stockage TEMP pendant une période pré-configurée de 60 minutes. Vous devez joindre le fichier à une tâche avant l'expiration de la période pré-configurée.
  3. Joignez le fichier à la tâche qui est déclenchée lorsque vous gérez les enregistrements.
    • Pour joindre le fichier à la tâche qui est déclenchée lorsque vous créez un enregistrement, utilisez l'API REST Créer une entité d'entreprise avec le paramètre
      taskattachments
      .
      Par exemple, la demande suivante crée un enregistrement et joint le fichier avec l'ID de fichier
      TEMP_SVR1.1VDVS
       :
      POST http://localhost:8080/cmx/cs/localhost-orcl-DS_UI1/Person?systemName=Admin&taskAttachments=TEMP_SVR1.1VDVS Content-Type: application/json { firstName: "John", lastName: "Smith", Phone: { item: [ { phoneNumber: "111-11-11" } ] } }
    • Pour joindre le fichier à la tâche qui est déclenchée lorsque vous mettez à jour un enregistrement, utilisez l'API REST Mettre à jour l'entité d'entreprise avec le paramètre
      taskattachments
      .
      Par exemple, la demande suivante met à jour un enregistrement et joint le fichier avec l'ID de fichier
      TEMP_SVR1.1VDVS
       :
      PUT http://localhost:8080/cmx/cs/localhost-orcl-DS_UI1/Person/233?systemName=Admin&taskAttachments=TEMP_SVR1.1VDVS { rowidObject: "233", firstName: "BOB", lastName: "LLOYD", Phone: { item: [ { rowidObject: "164", phoneNumber: "777-77-77", $original: { phoneNumber: "(336)366-4936" } } ] }, $original: { firstName: "DUNN" } }
    • Pour joindre le fichier à la tâche qui est déclenchée lorsque vous fusionnez un enregistrement, utilisez l'API REST Fusionner l'entité d'entreprise avec le paramètre
      taskattachments
      .
      Par exemple, la demande suivante fusionne un enregistrement et joint le fichier avec l'ID de fichier
      TEMP_SVR1.1VDVS
       :
      POST http://localhost:8080/cmx/cs/localhost-orcl-DS_UI1/Person/2478245?action=merge&taskAttachments=TEMP_SVR1.1VDVS Content-Type: application/<json/xml> { keys: [ { rowid: "2478246" } ], overrides: { Person: { firstName: "Charlie" } } }
    • Pour joindre le fichier à la tâche qui est déclenchée lorsque vous annulez la fusion d'un enregistrement, utilisez l'API REST Annuler la fusion de l'entité d'entreprise avec le paramètre
      taskattachments
      .
      Par exemple, la demande suivante annule la fusion d'un enregistrement et joint le fichier avec l'ID de fichier
      TEMP_SVR1.1VDVS
       :
      POST http://localhost:8080/cmx/cs/localhost-orcl-DS_UI1/Person/2478248?action=unmerge&taskAttachments=TEMP_SVR1.1VDVS { rowid: "4880369" }
  4. Joignez le fichier à une tâche existante.
    • Pour joindre le fichier lorsque vous mettez à jour une tâche, utilisez l'API REST Mettre à jour la tâche avec le paramètre
      attachments
      dans le corps de demande.
      Par exemple, la demande suivante met à jour une tâche et joint le fichier avec l'ID de fichier
      TEMP_SVR1.1VDVS
       :
      PUT http://localhost:8080/cmx/cs/localhost-orcl-MDM_SAMPLE/task/urn:b4p2:15934 { taskType: { name: "UpdateWithApprovalWorkflow" }, taskId: "urn:b4p2:15934", owner: "John", title: "Smoke test task - updated", comments: "Smoke testing - updated", "attachments": [ { "id": "TEMP_SVR1.1VDVS" } ], ... }
    • Pour joindre le fichier lorsque vous exécutez une action de tâche, utilisez l'API REST Exécuter une action de tâche avec le paramètre
      attachments
      dans le corps de demande.
      Par exemple, la demande suivante exécute une action de tâche et joint le fichier avec l'ID de fichier
      TEMP_SVR1.1VDVS
       :
      POST http://localhost:8080/cmx/cs/localhost-orcl-MDM_SAMPLE/task/urn:b4p2:15934?taskAction=Cancel { taskType: { name:"UpdateWithApprovalWorkflow", taskAction: [{name: "Cancel"}] }, taskId: "urn:b4p2:15934", owner: "manager", title: "Smoke test task 222", comments: "Smoke testing", "attachments": [ { "id": "TEMP_SVR1.1VDVS" } ], ... }
Une fois que vous avez joint un fichier à une tâche, le processus déplace le fichier à partir du stockage TEMP et le stocke avec les données de la tâche dans le stockage BPM. L'ID du fichier passe à
taskId::filename
.