Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Published by Scroll Versions from space PRINSAG and version 9.0
Sv translation
languageen

Like XML files, CSV files can be used to pass information to Prinergy RBA. If you have not already read about using XML with RBA, you should read about that first before reading this section. The concept and implementation are very similar, so only the differences are documented here.
As with XML files, you must define and import a schema for each type of CSV file you wish to read from RBA. Unlike XML schemas however, there is a predetermined structure that the CSV schema files must conform to. A schema for a CSV file should have one element named table which is a complexType containing an unbounded sequence of complexType elements named row, each containing a sequence of elements for the columns in order.

For example, here is a schema that defines a CSV file containing four columns: Job, Group, Server, and Share.

<?xml version="1.0" encoding="UTF-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:element name="table">
<xs:complexType>
<xs:sequence>
<xs:element name="row" maxOccurs="unbounded">
<xs:complexType>
<xs:sequence>
<xs:element name="Job" type="xs:string"/>
<xs:element name="Group" type="xs:string"/>
<xs:element name="Server" type="xs:string"/
>
<xs:element name="Share" type="xs:string"/>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:schema>



The CSV schema file is imported into the RBA XML Schema Manager the same way that an XML Schema is imported.

  • To add a new schema, in Rule Set Manager, from the Tools menu, select RBA XML Schema Manager.

Once the schema has been imported to RBA XML Schema Manager, you can use a Read CSV action in a rule set to read the contents of a CSV file. The imported XML schema file should be specified as the action's Schema Name parameter. The CSV file to be read should be specified as the action's File parameter. The action will raise the CSV Parsed OK event when the file has been successfully read. To iterate over the rows in the CSV file, apply a Split action to the row objects in the event's CSV Data property. Each row object will have one property value from each column contained in the CSV file. The value of those row properties can then be used as parameters to subsequent actions.

Sv translation
languagede

Wie XML-Dateien auch können CSV-Dateien dazu verwendet werden, Informationen an Prinergy RBA weiterzugeben. Lesen Sie über die Verwendung von XML mit RBA, bevor Sie diesen Abschnitt lesen, falls Sie es noch nicht getan haben. Das Konzept und die Umsetzung sind sehr ähnlich, so dass nur die Unterschiede hier dokumentiert wurden.

Wie bei XML-Dateien üblich, müssen Sie ein Schema für jede Art von CSV-Datei definieren und importieren, die Sie von RBA lesen möchten. Im Gegensatz zu XML-Schemata gibt es jedoch eine vorgegebene Struktur, der das CSV-Dateischema entsprechen muss. Ein Schema für eine CSV-Datei sollte ein Element mit dem Namen Tabelle enthalten, das ein complexType mit einer unbegrenzten Folge von complexType-Elementen mit dem Namen Zeile enthält, von denen jede eine Folge von Elementen für die aufeinanderfolgenden Spalten enthält.

Hier ist zum Beispiel ein Schema, das eine CSV-Datei mit vier Spalten definiert: Job, Gruppe, Server und Freigabe.

<?xml version="1.0" encoding="UTF-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:element name="table">
<xs:complexType>
<xs:sequence>
<xs:element name="row" maxOccurs="unbounded">
<xs:complexType>
<xs:sequence>
<xs:element name="Job" type="xs:string"/>
<xs:element name="Group" type="xs:string"/>
<xs:element name="Server" type="xs:string"/>
<xs:element name="Share" type="xs:string"/>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:schema>

Die CSV-Datei wird in den RBA-XML-Schema-Manager wie ein XML-Schema importiert.

  • Um ein neues Schema im Regelsammlungs-Manager hinzuzufügen, wählen Sie aus dem Menü Werkzeuge RBA-XML-Schema-Manager aus.

Wenn das Schema in RBA-XML-Schema-Manager importiert wurde, können Sie mit der Aktion CSV lesen in der Regel auf den Inhalt einer CSV-Datei zugreifen. Die importierte XML-Schema-Datei sollte als Parameter der Aktion Schemaname festgelegt werden. Die zu lesende CSV-Datei sollten als Parameter der Aktion Datei festgelegt werden. Diese Aktion wird das Ereignis CSV erfolgreich analysiert auslösen, wenn die Datei erfolgreich gelesen wurde. Zum Iterieren über die Zeilen in der CSV-Datei, wenden Sie die Aktion Teilen auf die Zeilen-objekte in den Eigenschaften des Ereignisses CSV-Daten an. Jedes Zeilenobjekt erhält einen Eigenschaftswert aus jeder Spalte in der CSV-Datei. Der Wert dieser Zeileneigenschaften kann dann als Parameter für nachfolgende Aktionen verwendet werden.

Sv translation
languagezh

与 XML 文件类似,CSV 文件可用于向印能捷 RBA 传递信息。 如果尚未阅读有关 XML 与 RBA 结合使用的信息,应首先阅读相应内容,然后再阅读本节。 两者的概念和实施非常相似,因此这里仅说明区别之处。

与使用 XML 文件一样,必须首先为要从 RBA 读取的每种 CSV 文件定义和导入模式。 但与 XML 模式不同的是,CSV 模式文件必须遵守预先确定的结构。 CSV 文件的模式必须有一个名为 table 的元素,这是一个复杂类型的元素,包含一个名为 row 的复杂类型元素的未绑定序列,其中每个元素包含各列的元素序列(有序)。

例如,下面的模式定义的 CSV 文件包含四列:Job、Group、Server 和 Share。


<?xml version="1.0" encoding="UTF-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:element name="table">
<xs:complexType>
<xs:sequence>
<xs:element name="row" maxOccurs="unbounded">
<xs:complexType>
<xs:sequence>
<xs:element name="Job" type="xs:string"/>
<xs:element name="Group" type="xs:string"/>
<xs:element name="Server" type="xs:string"/>
<xs:element name="Share" type="xs:string"/>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:schema>

CSV 模式文件导入 RBA XML 模式管理器的方法与导入 XML 模式相同。

  • 要添加新的模式,在规则集管理器的工具菜单中选择 RBA XML 模式管理器

当模式导入 RBA XML 模式管理器之后,可以在规则集中使用读取 CSV 操作来读取 CSV 文件的内容。 导入的 XML 模式文件应指定为操作的 Schema Name 参数。 要读取的 CSV 文件应指定为操作的 File 参数。 当文件成功读取后,操作将生成 CSV 解析成功事件。 要迭代 CSV 文件中的行,请将拆分操作应用到事件的 CSV 数据属性中的 row 对象。 每个行对象都有一个来自 CSV 文件中所包含列的属性值。 然后这些行属性的值可用作后续操作的参数。

Sv translation
languagees

De la misma forma que los archivos XML, los archivos CSV se pueden utilizar para pasar información a Prinergy RBA. Si todavía no se ha informado sobre el uso de XML con RBA, deber leer información al respecto antes de leer esta sección. El concepto y la implementación son muy similares, por lo que aquí solo se documentan las diferencias.

Al igual que ocurre con los archivos XML, debe definir e importar un esquema para cada tipo de archivo CSV que desee leer de RBA. Sin embargo, a diferencia de lo que ocurre con los esquemas XML, hay una estructura predeterminada que deben cumplir los archivos de esquema CSV. Un esquema para un archivo CSV debe tener un elemento denominado tabla, que es un elemento complexType con una secuencia ilimitada de elementos complexType denominados fila, cada uno de los cuales tiene una secuencia de elementos para las columnas en orden.

Por ejemplo, a continuación se muestra un esquema que define un archivo CSV con cuatro columnas: Trabajo, Grupo, Servidor y Recurso compartido.

<?xml version="1.0" encoding="UTF-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:element name="table">
<xs:complexType>
<xs:sequence>
<xs:element name="row" maxOccurs="unbounded">
<xs:complexType>
<xs:sequence>
<xs:element name="Job" type="xs:string"/>
<xs:element name="Group" type="xs:string"/>
<xs:element name="Server" type="xs:string"/>
<xs:element name="Share" type="xs:string"/>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:schema>

El archivo de esquema CSV se importa en el Administrador de esquemas XML de RBA del mismo modo que se importa un esquema XML.

  • Para agregar un nuevo esquema, en Administrador de conjuntos de reglas, en el menú Herramientas, seleccione Administrador de esquemas XML de RBA.

Una vez que el esquema se ha importado al Administrador de esquemas XML de RBA, puede utilizar una acción Read CSV (Leer CSV) en un conjunto de reglas para leer el contenido de un archivo CSV. El archivo de esquema XML importado se debe especificar como parámetro Nombre del esquema de la acción. El archivo CSV que se va a leer se debe especificar como parámetro Archivo de la acción. La acción genera el evento CSV Parsed OK (CSV analizado correctamente) cuando el archivo se ha leído correctamente. Para realizar la iteración por las filas del archivo CSV, aplique una acción Dividir a los objetos fila en la propiedad CSV Data (Datos de CSV) del evento. Cada objeto de fila tendrá un valor de propiedad de cada columna incluido en el archivo CSV. Los valores de esas propiedades de fila se pueden utilizar a continuación como parámetros para las acciones posteriores.

Sv translation
languagefr

Comme les fichiers XML, les fichiers CSV peuvent être utilisés pour transmettre des informations à Prinergy RBA. Si vous ne l'avez pas encore fait, veuillez consulter les instructions d'utilisation des fichiers XML avec RBA avant de lire cette section. Le concept et la mise en œuvre étant très similaires, seules les différences sont expliquées ici.

Comme avec les fichiers XML, vous devez définir et importer un schéma pour chaque type de fichier CSV que vous voulez lire dans RBA. Cependant, contrairement aux schémas XML, les schémas CSV doivent suivre une structure prédéterminée. Un schéma pour un fichier CSV doit avoir un élément nommé table qui est un élément complexType contenant une séquence libre d'éléments complexType appelés row, chacun contenant dans l'ordre une séquence d'éléments pour les colonnes.

Voici un exemple de schéma d'un fichier CSV contenant quatre colonnes : Job, Group, Server et Share.

<?xml version="1.0" encoding="UTF-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:element name="table">
<xs:complexType>
<xs:sequence>
<xs:element name="row" maxOccurs="unbounded">
<xs:complexType>
<xs:sequence>
<xs:element name="Job" type="xs:string"/>
<xs:element name="Group" type="xs:string"/>
<xs:element name="Server" type="xs:string"/>
<xs:element name="Share" type="xs:string"/>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:schema>

Le processus d'importation du fichier de schéma CSV dans le Gestionnaire de schémas XML RBA est identique à celui d'un schéma XML.

  • Pour ajouter un nouveau schéma, accédez au Gestionnaire de jeux de règles, ouvrez le menu Outils et sélectionnez Gestionnaire de schémas XML RBA.

Une fois le schéma importé dans le Gestionnaire de schémas XML RBA, vous pouvez utiliser une action Lire CSV dans un jeu de règles pour lire le contenu d'un fichier CSV. Le fichier de schéma XML importé doit être spécifié comme paramètre Nom du schéma de l'action. Le fichier CSV à lire doit être spécifié comme paramètre Fichier de l'action. L'action déclenche l'événement CSV évalué OK lorsque le fichier a été lu. Pour répéter le processus sur les lignes dans le fichier CSV, appliquez une action Séparation aux objets row dans la propriété Données CSV de l'événement. Chaque objet row possède alors une valeur de propriété pour chaque colonne contenue dans le fichier CSV. La valeur de ces propriétés row peut ensuite être utilisée comme paramètre d'actions ultérieures.

Sv translation
languageja

XML ファイルと同じように CSV ファイルを使用して Prinergy RBAに情報を渡すことができます。 RBA での XML の使用についての説明をまだ読んでいない場合は、このセクションを読む前に XMLに関する説明を読んでください。 概念と実装方法はよく似ているので、ここでは相違点についてのみ説明します。

XML ファイルを使用する場合と同じように、RBA から読み取るCSV ファイルのタイプごとにスキーマを定義してインポートする必要があります。 ただし、XML スキーマとは異なり、CSV スキーマ ファイルが従う必要がある事前に定義された構造があります。
CSV ファイルのスキーマは、[table] という名前の 1 つのエレメントを含んでいる必要があります。このエレメントは、[row] という名前の complexType エレメントの未割り当てのシーケンスを含む complexType で、それぞれが列のエレメントのシーケンスを順番に含んでいます。

たとえば、ここに Job、Group、Server、Share という 4 つの列を含むCSV ファイル を定義するスキーマがあります。


<?xml version="1.0" encoding="UTF-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:element name="table">
<xs:complexType>
<xs:sequence>
<xs:element name="row" maxOccurs="unbounded">
<xs:complexType>
<xs:sequence>
<xs:element name="Job" type="xs:string"/>
<xs:element name="Group" type="xs:string"/>
<xs:element name="Server" type="xs:string"/>
<xs:element name="Share" type="xs:string"/>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:schema>


CSV スキーマ ファイルを RBA XML スキーマ マネージャーにインポートする方法は、XML スキーマをインポートする方法と同じです。

  • 新しいスキーマを追加するには、ルール セット マネージャーで、[ツール]メニューの[RBA XML スキーマ マネージャー]を選択します。

スキーマが RBA XML スキーマ マネージャーにインポートされたら、ルール セットで[CSV 読込]アクションを使用して、CSV ファイルの内容を読み取ることができます。 インポートされる XMLスキーマ ファイルはアクションの[スキーマ名]パラメータとして指定する必要があります。 読み取る CSV ファイルは、アクションの[ファイル]パラメータとして指定する必要があります。 このアクションは、ファイルが正常に読み取られたときに[CSV 読込OK]イベントを発生させます。 CSV ファイルの行の反復処理を行うには、[分割]アクションをイベントの[CSV データ]プロパティの []オブジェクトに適用します。 各行オブジェクトには、CSV ファイルに含まれる各列から取得されるプロパティ値があります。 これらの行プロパティの値を後続のアクションのパラメータとして使用できます。