Paramètres de ligne de commande et clés de fichier de configuration

Les tableaux de cette section décrivent les paramètres de ligne de commande et les clés de fichier de configuration qui peuvent être utilisés dans le client par lots.

Tableau 17-1 Commandes générales

Clé Paramètre Description Obligatoire

Operation

/op=

Indique l'opération à effectuer :

O

UserName

/u=

Spécifie le nom d'utilisateur Oracle Data Relationship Management pour la connexion.

O

Password

/pw=

Spécifie le mot de passe Data Relationship Management pour la connexion.

O

URL

/url=

Spécifie l'URL (y compris le numéro de port) de l'application de moteur dans les processus de serveur Data Relationship Management. Cette URL est configurée et disponible dans la console de configuration Data Relationship Management. Par exemple, net.tcp://localhost:5210/Oracle/Drm/Engine

O

LogFileName

/log=

Spécifie le chemin d'accès et le nom du fichier journal. Si ce fichier existe, le journal est ajouté à la fin du fichier existant. Il est recommandé de placer la valeur entre guillemets.

Attention : pour lancer plusieurs processus de client par lots simultanément, vous devez indiquer un nom de journal unique pour chaque processus.

Remarque : le fichier journal spécifié peut ne pas être créé si le paramètre /log est inséré après un paramètre problématique comme un paramètre avec une valeur manquante ou non valide. Pour garantir la création du fichier journal spécifié, le paramètre /log doit être inséré en tant que premier paramètre.

S'il n'est pas indiqué, le nom suivant est utilisé : DRM_Batch_ClientMMDDYYYY.log, où MM = mois, DD = jour, YYYY = année.

N

N/A

/cfgfile=

Spécifie le chemin d'accès et le nom du fichier de configuration décrivant les options souhaitées. Il est recommandé de placer la valeur entre guillemets.

O, si vous utilisez un fichier de configuration.

N/A

/h[elp] | /?

Affiche la liste des paramètres de ligne de commande.

N

TimezoneOffset

/timezoneid

Décalage local en minutes par rapport à l'heure GMT. Par exemple, le décalage de l'heure CST des Etats-Unis par rapport à l'heure GMT est de -360. Utilisé pour le rendu des dates/heures dans la sortie.

La valeur par défaut est la culture utilisée par le serveur.

N

CultureName

/culturename

Nom de la culture locale, au format : codelangue-codepays/régioncodelangue est un code de deux lettres minuscules dérivé de la norme ISO 639-1 et codepays/région est un code de deux lettres majuscules dérivé de la norme ISO 3166. Par exemple, le code pour l'anglais américain est en-US.

Concerne la langue et le format des données d'entrée. La langue est appliquée spécialement aux messages d'information et d'erreur journalisés par le client par lots. La culture contrôle le formatage des données de type Date/Heure/Réel pour la sortie des opérations telles que des exports. Le paramètre contient des valeurs de secours dont la valeur par défaut dépend des paramètres de culture de l'application Data Relationship Management et des paramètres de culture et de langue du serveur hôte Data Relationship Management sur l'utilisateur de service.

N

ObjectAccess

/objectaccess

Méthode permettant d'accéder aux objets d'import, d'export et de combinaison. Les valeurs valides sont Standard, System ou User, ou un groupe personnalisé.

La valeur par défaut est Standard.

N

InstanceID

/instanceid=

Indique l'ID d'instance de l'application à utiliser si plusieurs applications ont été configurées pour employer la fonctionnalité drm-batch-client-credentials.exe.

O, si plusieurs applications ont été configurées pour employer la fonctionnalité drm-batch-client-credentials.

Tableau 17-2 Script d'action

Clé Paramètre Description Obligatoire

InFile

/infile=

Spécifie le chemin d'accès et le nom du fichier d'entrée. Il est recommandé de placer la valeur entre guillemets.

O

Delimiter

/delim=

Indique le séparateur. Indiquez l'une des valeurs suivantes :

  • Tabulation

  • Virgule

  • #nnn

#nnn représente une valeur de caractère ASCII à 3 chiffres valide (de 0 à 255).

La valeur par défaut est Tabulation.

N

ColumnOrder

/cols=

Indique l'ordre des colonnes. S'il est fourni, ce paramètre doit contenir tous les identifiants de colonne. La valeur par défaut est A12345.

N

StripQuotedStrings

/stripq=

Spécifie si les chaînes entre apostrophes doivent être enlevées. Indiquez l'une des valeurs suivantes :

  • Y[es], T[rue] ou 1

  • N[o], F[alse] ou 0

La valeur par défaut est True.

N

PropertyRefByLabel

/propertyrefbylabel

Pour rechercher des références de propriété par libellé (plutôt que par nom), indiquez l'une des valeurs suivantes :

  • Y[es], T[rue] ou 1

  • N[o], F[alse] ou 0

La valeur par défaut est True.

N

Encoding

/encoding

Codage de caractères du fichier d'entrée (nom d'encodage ou numéro de page de code). Ce paramètre est facultatif.

La valeur par défaut est UTF8.

N

Tableau 17-3 Sauvegarder une version vers un fichier

Clé Paramètre Description Obligatoire

VersionAbbrev

/vabbrev=

Spécifie les noms de version à sauvegarder, délimités par /delim s'il existe plusieurs versions.

O

Connection

/conn=

Indique le nom de la connexion externe.

O

Filename

/filename=

Indique le nom du fichier de sauvegarde à créer à l'aide de la connexion externe (/conn).

O

Delimiter

/delim=

Séparateur imprimable. Utilise un caractère unique, par exemple deux-points (:), virgule (,), tiret (-), etc.

N, sauf si vabbrev est une liste de versions.

Tableau 17-4 Blend

Clé Paramètre Description Obligatoire

BlendName

/bl=

Indique le nom de la combinaison à exécuter.

O

SourceVersionAbbrev

/sver=

Spécifie le nom de la version source à combiner.

O

TargetVersionAbbrev

/tver=

Spécifie le nom de la version cible à combiner.

O

NewVersionAbbrev

/nvera=

Spécifie le nom de la version à créer.

N

NewVersionDescription

/nverd=

Spécifie la description de la nouvelle version. Vous devez placer la valeur entre guillemets.

N

AutoSave

/save=

Indique s'il est nécessaire d'enregistrer la version combinée ou de la laisser détachée. Indiquez l'une des valeurs suivantes :

  • Y[es], T[rue] ou 1

  • N[o], F[alse] ou 0

La valeur par défaut est False. Pour plus d'informations sur l'enregistrement de versions, reportez-vous à Exemple 17-2.

N

BlendLogFileName

/blendlog=

Spécifie le nom du fichier journal de la combinaison (qui est différent du fichier journal du client par lots). La valeur par défaut est stockée dans le profil de combinaison.

O

RunTimeParameters

N/A

Indique la liste des paramètres d'exécution séparés par des virgules. Exemple de format : RuntimeParameters=City=Dallas,State=Texas,ZipCode=75234.

Si la valeur contient un délimiteur, comme une virgule, des caractères spéciaux ou des guillemets, mettez-la entre guillemets.

Remarque : les éléments [CR/LF], [CR] et [LF] ne doivent pas faire partie de la valeur.

N

Tableau 17-5 Fermer la version

Clé Paramètre Description Obligatoire

VersionAbbrev

/abbrev=

Spécifie le nom de la version à fermer.

O

Tableau 17-6 Supprimer la version

Clé Paramètre Description Obligatoire

VersionAbbrev

/vabbrev=

Spécifie le nom de la version à supprimer.

O

Tableau 17-7 Export

Clé Paramètre Description Obligatoire

ExportType

/xtype

Indique le type d'export : individuel ou liasse. Indiquez l'une des valeurs suivantes :

  • E[xport]

  • B[ook]

O

ExportName

/xname=

Indique le nom de l'export enregistré à exécuter.

O, si vous exécutez un seul rapport.

OutFile

/outfile=

Pour les exports configurés pour diriger la sortie vers un fichier client, ce paramètre spécifie le chemin d'accès et le nom du fichier de sortie. Si le fichier de sortie existe, il est remplacé. Il est recommandé de placer la valeur entre guillemets. Si ce paramètre est indiqué et que l'export est configuré pour envoyer la sortie vers une connexion au serveur externe, ce paramètre remplace la connexion au serveur externe et l'export est écrit dans le fichier indiqué ici.

O

CurrentVersionAbbrev

/cver=

Spécifie le nom de la version en cours. Si ce paramètre n'est pas indiqué, le système utilise la valeur de la préférence système DefaultCurrentVersion.

O, si aucune variable de version n'est enregistrée avec l'export.

PrevVersionAbbrev

/pver=

Spécifie le nom de la version précédente. Utilisé pour les exports de comparaison de hiérarchie et de différence de hiérarchie. Si ce paramètre n'est pas indiqué, le système utilise la valeur de la préférence système DefaultPreviousVersion.

O, pour les exports de comparaison et de différence si aucune variable de version n'est enregistrée avec ceux-ci.

CurrentVersionType

/cvertype=

Spécifie le type de la version en cours. Les valeurs valides sont les suivantes :

  • A[s Of]

  • N[ormal]

La valeur par défaut est N[ormal].

N

PrevVersionType

/pvertype=

Spécifie le type de la version précédente. Les valeurs valides sont les suivantes :

  • A[s Of]

  • N[ormal]

La valeur par défaut est N[ormal].

N

CurrentAsOfDate

                           /casofdate=
                        

Indique la date/l'heure à utiliser lorsque vous créez une version à date pour la version en cours pour l'export.

Remarque : les formats de date/d'heure sont déterminés par les paramètres régionaux de l'ordinateur client.

O, si le type de version est AsOf.

PrevAsOfDate

                           /pasofdate=
                        

Indique la date/l'heure à utiliser lorsque vous créez une version à date pour la version précédente pour l'export.

Remarque : les formats de date/d'heure sont déterminés par les paramètres régionaux de l'ordinateur client.

O, si le type de version est AsOf.

BookName

/bk=

Indique le nom de la liasse enregistrée à exécuter. Il est recommandé de placer la valeur entre guillemets.

O, si vous exportez une liasse.

CombineExportOutput

/bkcmb=

Indique s'il est nécessaire de combiner la sortie d'export dans le fichier dont le nom apparaît dans /outfile ou OutFile. Indiquez l'une des valeurs suivantes :

  • Y[es], T[rue] ou 1

  • N[o], F[alse] ou 0

Si ce paramètre a pour valeur False, chaque export est enregistré dans le nom de fichier enregistré dans son profil d'export. Les exports pour lesquels le nom de fichier dans le profil d'export n'est pas valide ou pour lesquels la sortie est définie sur une valeur autre que Fichier sont regroupés dans le fichier dont le nom apparaît dans /outfile ou OutFile. La valeur par défaut est stockée dans la liasse.

N

PreFileName

/prefile=

Spécifie le chemin d'accès et le nom de fichier à ajouter au début d'une liasse d'exports combinée. La valeur par défaut est stockée dans la liasse.

N

PostFileName

/pstfile=

Spécifie le chemin d'accès et le nom de fichier à ajouter à la fin d'une liasse d'exports combinée. La valeur par défaut est stockée dans la liasse.

N

FromHierarchy

/fhier=

Indique la hiérarchie source (précédente). Utilisé pour les exports de comparaison de hiérarchie et de différence de hiérarchie.

N

ToHierarchy

/thier=

Indique la hiérarchie cible (en cours). Utilisé pour les exports de comparaison de hiérarchie et de différence de hiérarchie.

N

FromTopNodeAbbrev

/fabbrev=

Spécifie le nom du noeud supérieur de la hiérarchie source (précédente). Utilisé pour les exports de comparaison de hiérarchie et de différence de hiérarchie.

N

ToTopNodeAbbrev

/tabbrev=

Spécifie le nom du noeud supérieur de la hiérarchie cible (en cours). Utilisé pour les exports de comparaison de hiérarchie et de différence de hiérarchie.

N

Hierarchy n

/hier=

Indique le nom de la hiérarchie à exporter, où n est un nombre (1 à HierarchyCount) identifiant la paire hiérarchie/noeud supérieur en cours (par exemple, TopNodeAbbrev1). Doit correspondre à Hierarchyn. Utilisé pour l'export de hiérarchie et d'autres exports similaires, mais pas pour les exports de comparaison de hiérarchie et de différence de hiérarchie.

N

TopNodeAbbrev n

/nabbrev=

Indique le nom du noeud supérieur à exporter, où n est un nombre (1 à HierarchyCount) identifiant la paire hiérarchie/noeud supérieur en cours (par exemple, TopNodeAbbrev1). Doit correspondre à Hierarchyn. Utilisé pour l'export de hiérarchie et d'autres exports similaires, mais pas pour les exports de comparaison de hiérarchie et de différence de hiérarchie.

N

Encoding

/encoding

Codage de caractères du fichier (nom d'encodage ou numéro de page de code). Ce paramètre est facultatif.

Si un codage est indiqué, il remplace celui enregistré avec l'export ou la liasse en cours d'exécution. Le codage indiqué s'applique également aux options de pré-fichier et de post-fichier locales disponibles du client par lots.

Remarque : si une liasse est exécutée, le codage ne remplace pas le codage des exports de la liasse, mais seulement le paramètre de codage de la liasse.

La valeur par défaut est UTF8.

N

HierarchyCount

/hier

Indique le nombre de paires hiérarchie/noeud supérieur définies.

N

HierarchyGroupPropFromParam

N/A

Indique si le nom de propriété de groupe de hiérarchies doit être obtenu à partir d'un paramètre ou d'une propriété de groupe de hiérarchies donnée. Indiquez l'une des valeurs suivantes :

  • Y[es], T[rue] ou 1

  • N[o], F[alse] ou 0

Si la valeur est True, indiquez un nom de paramètre pour HierarchyGroupProperty. Si la valeur est False, indiquez un nom de propriété de groupe de hiérarchies pour HierarchyGroupProperty. La valeur par défaut est False.

N

HierarchyGroupProperty

N/A

Indique un nom de paramètre ou un nom de propriété de groupe de hiérarchies. Si HierarchyGroupPropFromParam a la valeur True, un nom de paramètre est attendu. Si sa valeur est False, un nom de propriété de groupe de hiérarchies (y compris son espace de noms) est attendu.

N

HierarchyGroupFromParam

N/A

Indique si la valeur de groupe de hiérarchies doit être obtenue à partir d'un paramètre ou d'un groupe de hiérarchies donné. Indiquez l'une des valeurs suivantes :

  • Y[es], T[rue] ou 1

  • N[o], F[alse] ou 0

Si la valeur est True, indiquez un nom de paramètre pour HierarchyGroup. Si la valeur est False, indiquez un nom de propriété de groupe de hiérarchies pour HierarchyGroup. La valeur par défaut est False.

N

HierarchyGroup

N/A

Indique un nom de paramètre ou un nom de groupe de hiérarchies. Si HierarchyGroupFromParam a la valeur True, un nom de paramètre est attendu. Si sa valeur est False, un nom de groupe de hiérarchies est attendu.

N

RunTimeParameters

N/A

Indique la liste des paramètres d'exécution séparés par des virgules. Exemple de format : RuntimeParameters=City=Dallas,State=Texas,ZipCode=75234.

Si la valeur contient un délimiteur, comme une virgule, des caractères spéciaux ou des guillemets, mettez-la entre guillemets.

Remarque : les éléments [CR/LF], [CR] et [LF] ne doivent pas faire partie de la valeur.

N

FromDate

/fdate=

Indique la date/l'heure de début pour les exports du journal des transactions.

Remarque : les formats de date/d'heure sont déterminés par les paramètres régionaux de l'ordinateur client.

N

ToDate

/tdate=

Indique la date/l'heure de fin pour les exports du journal des transactions.

Remarque : les formats de date/d'heure sont déterminés par les paramètres régionaux de l'ordinateur client.

N

Tableau 17-8 Import

Clé Paramètre Description Obligatoire

InFile

/infile=

Pour les imports configurés afin d'importer à partir d'un fichier client, ce paramètre spécifie le chemin d'accès et le nom du fichier d'entrée. Il est recommandé de placer la valeur entre guillemets.

Attention : n'employez pas ce paramètre pour les imports configurés dans le but d'utiliser un fichier d'entrée à partir d'une connexion de serveur externe. Sinon, une erreur survient.

O, si vous importez à partir d'un fichier client.

ImportAbbrev

/iabbrev=

Spécifie le nom de l'import à exécuter.

O

ImportLogFileName

/implog=

Spécifie le chemin d'accès et le nom du fichier journal de l'import (qui est différent du fichier journal du client par lots). Le nom de fichier par défaut est DRM_Batch_ClientMMDDYYYY.log, où MM = mois, DD = jour et YYYY = année.

O

VersionAbbrev

/vabbrev=

Indique le nom de la version à créer par l'import. La valeur par défaut est stockée dans le profil d'import.

N

VersionDescription

/vdescr=

Spécifie la description de la version à créer par l'import. La valeur par défaut est stockée dans le profil d'import.

N

AutoSave

/save=

Indique s'il est nécessaire d'enregistrer la version importée ou de la laisser détachée. Indiquez l'une des valeurs suivantes :

  • Y[es], T[rue] ou 1

  • N[o], F[alse] ou 0

La valeur par défaut est False. Pour plus d'informations sur l'enregistrement de versions, reportez-vous à Exemple 17-2.

N

RunTimeParameters

N/A

Indique la liste des paramètres d'exécution séparés par des virgules. Exemple de format : RuntimeParameters=City=Dallas,State=Texas,ZipCode=75234.

Si la valeur contient un délimiteur, comme une virgule, des caractères spéciaux ou des guillemets, mettez-la entre guillemets.

Remarque : les éléments [CR/LF], [CR] et [LF] ne doivent pas faire partie de la valeur.

N

Tableau 17-9 Multiple

Clé Paramètre Description Obligatoire

OperationCount

N/A

Indique le nombre de sections d'opération du fichier. Indiquez un entier supérieur à 0.

O

OperationN

N/A

Indique le libellé d'une section d'opération où N est un numéro compris entre 1 et la valeur OperationCount.

O

Tableau 17-10 Ouvrir une version

Clé Paramètre Description Obligatoire

VersionAbbrev

/vabbrev=

Spécifie le nom de la version à ouvrir.

O

Tableau 17-11 Actualiser une version

Clé Paramètre Description Obligatoire

VersionAbbrev

/vabbrev=

Indique le nom de la version à actualiser (fermer et ouvrir à nouveau).

O

Tableau 17-12 Demande

Clé Paramètre Description Obligatoire

WorkflowModel

/WorkflowModel=

Indique le nom d'un modèle de workflow.

O

RequestTitle

/RequestTitle=

Indique un titre de demande.

O

Version

/vabbrev=

Indique le nom d'une version.

O, si aucune variable de version n'est indiquée dans le modèle de workflow.

WorkflowTask

/WorkflowTask=

Indique le nom d'une tâche de workflow. Il doit s'agir d'une tâche affectée à l'étape de soumission de la demande.

O

Hiérarchie

/hier=

Indique le nom d'une hiérarchie.

O, si la valeur par défaut n'a pas été définie à l'aide du groupe de hiérarchies

Connection

/conn=

Indique le nom de la connexion externe. Cet élément doit faire référence à une connexion au fichier de serveur accessible via les groupes d'accès à l'objet de l'utilisateur du client par lots.

N

FileName

/filename=

Indique le nom du fichier à localiser à l'aide de la connexion externe. Si le nom de la connexion au fichier de serveur est indiqué, ce paramètre fait référence à un fichier disponible pour la connexion au serveur.

O si Connection est indiqué.

InFile

/infile=

Spécifie le chemin d'accès et le nom du fichier d'entrée. Il est recommandé de placer la valeur entre guillemets.

O, si Connection n'est pas indiqué.

Delimiter

/delim=

Séparateur imprimable. Utilise un caractère unique, par exemple deux-points (:), virgule (,), tiret (-), etc.

N

StripQuotedStrings

/StripQuotedStrings=

Indique si les chaînes entre apostrophes doivent être enlevées des valeurs de données trouvées dans le fichier. Indiquez l'une des valeurs suivantes :

  • Y[es], T[rue] ou 1

  • N[o], F[alse] ou 0

La valeur par défaut est True.

N

AllowBlankOverrides

/AllowBlankOverrides=

Indique si les remplacements vides sont autorisés. Indiquez l'une des valeurs suivantes :

  • Y[es], T[rue] ou 1

  • N[o], F[alse] ou 0

N

BlankValueIndicator

/BlankValueIndicator=

Indique une valeur de texte pour désigner des valeurs vides dans le fichier.

N

DeleteOnSubmitFailure

/DeleteOnSubmitFailure=

Indique si la demande doit être supprimée en cas d'échec de la soumission. Indiquez l'une des valeurs suivantes :

  • Y[es], T[rue] ou 1

  • N[o], F[alse] ou 0

La valeur par défaut est False.

N

Encoding

/encoding

Codage de caractères du fichier d'entrée (nom d'encodage ou numéro de page de code). Ce paramètre est facultatif.

La valeur par défaut est UTF8.

N

Tableau 17-13 Restaurer la version à partir d'un fichier

Clé Paramètre Description Obligatoire

Connection

/conn=

Indique le nom de la connexion externe.

O

Filename

/filename=

Indique le nom du fichier à localiser à l'aide de la connexion externe (/conn).

O

SourceVersionAbbrev

/sver=

Indique les noms de version dans le fichier source à restaurer, délimités par /delim s'il existe plusieurs versions.

O

TargetVersionAbbrev

/tver=

Indique les noms des nouvelles versions, en corrélation avec le paramètre /sver, délimités par /delim s'il existe plusieurs versions.

O

Delimiter

/delim=

Séparateur imprimable. Utilise un caractère unique, par exemple deux-points (:), virgule (,), tiret (-), etc.

N, sauf si sver ou tver est indiqué en tant que liste de versions.

AutoSave

/save=

Enregistre les versions après la restauration :

  • Y[es], T[rue] ou 1

  • N[o], F[alse] ou 0

N