Ajout et mise à jour de contrats

10.0.6 Utilisez l'API /api/sam/v2/contracts.json pour ajouter et mettre à jour des contrats.

Fonctions d'opération PUT

La requête ne supprime pas les contrats et ne supprime pas les bons de commande ou les affectations de contrat au logiciel. Elle fusionne les données avec le contenu de la base de données.
L'opération correspond à la métrique par ID ou par nom de code si l'ID de métrique n'est pas fourni. Elle crée une métrique si l'ID de métrique n'est pas fourni et que le nom du code de métrique est introuvable. La nouvelle métrique a le même nom d'affichage que le nom de code de la requête.
L'opération ne crée pas de logiciel ou d'éditeur, sauf si le paramètre createSoftware est défini sur true (createSoftware=true).
L'opération ajoute une relation produit-métrique si nécessaire.
L'opération correspond au groupe d'ordinateurs par ID ou par nom si l'ID n'est pas fourni. En cas d'absence d'ID et de nom, le groupe "Tous les ordinateurs" est utilisé. Seuls les groupes d'ordinateurs de type "Génération de rapports" peuvent être utilisés dans les contrats.

Exemple de conversations HTTP

PUT /api/sam/v2/contracts.json

Ajoute ou met à jour les contrats fournis dans le corps de la requête au format JSON (format identique au tableau sous "lignes" de la requête GET)

[
 {
   "contract_id":"CO1","name":"Contract1","type":2,"threshold":100,"metric":{"id":9,"code_name":"INTERNAL_INSTALL"},"computer_group":{"id":0,"name":"All Computers"}
  "purchase_orders":[{"purchase_number":"PO1","quantity":5000,"entitlement_start":"2021-08-03","entitlement_end":"2030-05-21"}
  {
   "purchase_number":"PO2","quantity":2,"entitlement_start":"2030-05-21"
   "entitlement_end":"2030-06-21"}],"software_products":
   [
   {"name":"Notepad++","publisher_name":"don.h@free.fr"}
   ]
  }
]

Limitations

Remarque : Les limitations sont applicables dans BigFix Inventory version 10.0.6.

Les messages d'erreur sont affichés par défaut dans la langue fournie sous l'en-tête "Accept-Language". La langue sélectionnée dans le profil utilisateur n'est pas prise en compte.
Les valeurs de zone personnalisées doivent être fournies au format texte, telles que "123" pour le type entier. Cela ne s'applique pas aux autres zones.
L'opération PUT ne prend pas en charge les caractères nationaux, tels que les alphabets latins. Pour mettre à jour ou ajouter des données de contrat contenant ces caractères, utilisez l'importation au format CSV ou l'importation à l'aide de l'interface utilisateur. Voir aussi Importation de contrats.
Seuls les caractères ASCII des données des contrats sont entièrement pris en charge dans BigFix Inventory version10.0.6. Le problème n'est pas applicable depuis la version 10.0.7. A partir BigFix Inventory de la version10.0.7, les logiciels qui contiennent des caractères non ASCII sont acceptés dans les contrats API REST, ainsi que dans la zone de recherche de l'interface utilisateur, et les zones de contrat telles que le nom de contrat dans l'API REST peuvent contenir des caractères non ASCII.

Codes d'erreur

CODUI4040E=A contract with the specified name and type already exists
CODUI4041E=Some of the selected products are not assigned to the selected metric
CODUI4042E=A contract with the specified contract ID already exists
CODUI4043E=Purchase order numbers are not unique in this contract
CODUI4044E=Element {0} is missing in this contract
CODUI4045E=Incorrect JSON format. An array is expected.
CODUI4046E=Incorrect JSON format. The element at row {0} is not an object.
CODUI4047E=Required field {0} is empty
CODUI4048E=Required field {0} at row {1} is empty
CODUI4049E=Contract custom field with ID {0} does not exist
CODUI4050E=Product and publisher pair at row {0} is not found. Creating software option is not enabled.
CODUI4051E=Metric ID is not found
CODUI4052E=Specified metric code name is invalid. The field must contain up to 254 characters and can contain only uppercase letters, numbers, and the following characters: "-_".
CODUI4053E=Computer group with ID {0} is not accessible to the user or target contract computer group does not exist
CODUI4054E=Ambiguous computer group name. More than one matching group is found.
CODUI4055E=Field {0} at row {1} is too long. The maximal length is {2}.
CODUI4056E=Format of custom field with ID {0} is incorrect. Expected type: {1}
CODUI4057E=Custom field with ID {0} is required
CODUI4058E=Invalid contract type. Correct values are: 1,2,3,4,5.
CODUI4059E=Invalid contract threshold. The value must be a positive integer.
CODUI4060E=Field {0} is too long. The maximum length should be {1}.
CODUI4061E=Specified purchase order quantity at row {0} is invalid. The value must be a positive integer or -1 for ELA.
CODUI4062E=Specified purchase order entitlement dates at row {0} are invalid. End date cannot be before start date.
CODUI4063E=Format of field {0} at row {1} is incorrect. Expected type: {2}.
CODUI4064E=Software name at row {0} is already used by IBM bundle.
CODUI4065E=Software name at row {0} is already used by a software version or release of the same publisher.
CODUI4066E=Software at row {0} cannot be assigned to both Unknown metric and another metric.
CODUI4067E=Specified metric code name is not allowed.
CODUI4068E=Specified computer group name is not accessible to the user or target contract computer group does not exist.
CODUI4098E=Data conversion error occurred at row {0}. Ensure all fields have expected data types.
CODUI4099E=Contract processing failed. The contracts have not been imported.

# For Contracts import from CSV
CODUI5040E=Incorrect number of columns at row {0}.
CODUI5041E=Invalid header: {0}.
CODUI5042E=Invalid number: {0} at row {1} in column {2}.
CODUI5043E=Missing required column: {0}.
CODUI5044E=All or none of the columns need to be provided: {0}.
CODUI5045E=The {0} column requires {1} column to be present.
CODUI5046E=Missing value at row {0} in column {1}.
CODUI5047E=Values need to be provided for all or none of {1} columns at row {0}.