Tom Semeraro さんのアクティビティ

Extended Team

Vian Abraham — Fri, 21 Apr 2023 14:30:03 GMT

1 Introduction and access

Working with an implementation partner and want them to join your Support team so that they can view Support Incidents, add comments, create new Support Incidents, as well as participate in Support Incident correspondence? If you want to invite others from outside your organization to join your Support team, the Portal Admin for your organization can add these individuals as external Support team members.

Extended Team members have the same access as Channel Partners. Please review section 1 of the Subscribers with Channel Partners FAQ.

2 How to Add Extended Users

In the upper right corner of the Subscriber Portal, locate your profile icon and select "Our Account"
Click on the Support Access tab
Press the Add Users to Your Extended Team button.
A dialog window will open for you to enter the email addresses of the individuals you like to add to your extended Support team.
When you have entered the email address of everyone you would like to add, press Next.
Review the terms and conditions and press Agree & Save.
Each person will receive an email notification that they have been added to your organization’s extended Support team.

3 Common Questions

Having problems adding an external Support team member, try the following suggestions.

This email address is associated with your organization. Please invite this individual to join your internal team using the Invite Your Team action on the Team tab. If you believe the email address is not associated with your organization, please contact your account owner to resolve this domain conflict.
Too many Support users - An Aras subscriber may have up to 10 Admin + Support users who can directly contact Aras Support. External team members count towards your total Support user limit. Make sure the number of internal Support team members and extended Support team members does not exceed 10 people.
This individual does not have an Aras Portal account and cannot be added as a member of your Extended Team. Please ask this individual to create an Aras Portal account and try again after they can access the Aras Portal.
This individual is not properly setup as a Partner. Please have this individual contact your account owner or partners@aras.com to resolve this issue.

Still having problems adding an extended Support team member? Reach out through Portal Feedback and someone will reach out directly as soon as possible to help you troubleshoot.

サブスクライバーポータルヘルプ

Yumi Kambara — Fri, 01 Dec 2023 18:48:28 GMT

サブスクライバーポータルのご利用中に問題が発生した場合や、機能に関するフィードバック、ご質問などがございましたら、どうぞお気軽にお問い合わせください。

画面右上に表示されているご自身のユーザーアカウント（お名前）をクリックし、「Portal Feedback（ポータルへのフィードバック）」を選択して、リクエストの詳細をご記入ください。

できる限り早急にご連絡させていただきます。

Innovator API

Boma Koko — Thu, 24 Jun 2021 20:59:57 GMT

Use innovator API as much as possible
Avoid usage of where attribute with get request
Make as less requests as possible
Use select attribute with get requests
Check item for error after apply call
Use doGetItem=”0” if you don’t use response result
Avoid using xPaths as much as possible
Use RequestState object carefully
Do not forget to Revoke granted identities
Do not grant Super User Identity
Avoid using SQL operations
Innovator methods should have proper execution permissions
Wisely use returnMode on get AML request
Use client-side cache to get Variable values instead of requesting them from the server.

1. Use innovator API as much as possible
Severity	1
Info	Try to use IOM API instead of applyAML as much as possible. In case if performance is critical and there is a way to implement logic without API in a better way, this rule can be ignored.
Examples	Get id of the item string item = this.getID(); //not this.getProperty(“id”); Get list of parent identities ids Aras.Server.Core.InnovatorDatabase database = context.DB.InnDatabase; string[] identityMembers = Aras.Server.Security.Permissions.GetAncestorIdentityIds(database, new string[] { identityId }); Get list of User Identities string userId = this.getInnovator().getUserID(); var userIdentities = Aras.Server.Security.Permissions.GetIdentitiesList(CCO.DB.InnDatabase, userId); GetItemRepeatConfig and other API actions
Facts	It is preferable to use innovator API instead of creation your own methods, because innovator API was tested by the product QA team When using Innovator API, there is less chance that when upgrading Innovator to a newer version your logic will stop working.

2. Avoid usage of where attribute with get request
Severity	2
Info	In this case SQL server cannot cache execution plan which causes performance problems. Sometimes in confusing operations AND and OR, to increase transparency it is possible to use attribute "where". But only if the given AML query is not run too often and it will not affect performance.
Examples	Wrong way: Item item = dal.NewItem("SomeType", "get"); item.setAttribute("where", "some_prop='" + this.getProperty("some_prop") + "'"); Item result = dal.ApplyItem(item); Correct way: Item item = dal.NewItem("SomeType", "get"); string propValue = contextItem.getProperty("some_prop"); item.setProperty("some_prop", propValue); Item result = dal.ApplyItem(item);
Facts	AML where sentence is inserted directly into SQL query after some injection validations. It means SQL parameters aren’t used for AML where query which leads to recompilation of SQL request each time and affects performance.

3. Make as less requests as possible
Severity	1
Info	Performance critical
Examples	Caching Relationships structure in a single request (also fetchRelationships) idlist attribute instead of several requests Avoid calling Innovator methods inside of a loop
Facts	Each HTTP request makes several tcp requests which are multiplied by latency time. Each request initiates additional logic on the server to validate credentials, headers, input data, etc.

4. Use select attribute with get requests
Severity	1
Info	Performance critical - request only what you are going to use
Examples	Properties of item (e.g. “name”) Properties of item properties (e.g. “id of team”) private Item GetPartItem(string partId) { Item part = dal.NewItem("Part", "get"); part.setAttribute("select", "name, team_id(id)"); //... return dal.ApplyItem(part); }
Facts	Performance improvement as the response takes up less size Less XML response size is faster to handle Less JOINs in SQL requests if we ignore some property items

5. Check item for error after apply call
Severity	1
Info	Error validation helps to avoid critical errors
Examples	Wrong way: Item getResult = dal.ApplyItem(someGetRequest); string propertyValue = getResult.getProperty("my_property"); // propertyValue manipulation Correct way: Item getResult = dal.ApplyItem(someGetRequest); if (getResult.isError()) { return getResult; } string propertyValue = getResult.getProperty("my_property"); // propertyValue manipulation
Facts	The further logic might not expect error result case If isEmpty = true then isError is also true. getItemCount is less than 0 only in case isError is true and isEmpty is false. No need to create new error with same message, at this rate we are losing stack trace or any other error information.

6. Use doGetItem=”0” if you don’t use response result
Severity	1
Info	Performance critical
Examples	If you want to Update\Edit Item without handling of result (only check if it succeeded) you should use doGetItem attribute to reduce size of response. Without doGetItem=’0’ With doGetItem=’0’
Facts	Performance improvement since the Innovator Core does not have to apply a GET action to generate the full result. Performance improvement as the response takes up less size. In case cases may help to avoid SQL deadlocks.

7. Avoid using xPaths as much as possible
Severity	2
Info	Avoid xPaths usage in case you have simple Items structure, and target Item can easily be reached by standard IOM API (like getRalationships(), getRelatedItem() and so on).
Examples	Wrong way: 1) Can be done with standard IOM API Item relationships = this.getItemsByXPath("//Item/Relationships/Item[@type='someType']"); Correct way: 1) No need to use xPath Item relationships = this.getRelationships("someType"); 2) Item structure contains File items in different levels of dom. Please note, here used “.//”, not just “//”. In this case search is work only for descendant nodes, ancestor nodes are ignored. this.getItemsByXPath(".//Item[@type='File']"); 3) In case if you need to get some Item with nesting level more or equal 3, xPath can be used (or cannot, it's not mandatory to use it) this.getItemsByXPath("Item/Relationships/Item[@type=’Workflow’]/related_id/Item[@type=’Workflow Process’]/Relationships/Item[@type=’Workflow Process Activity’]");
Facts	Use the standard API, since it contains the most efficient algorithms for passing through the structure If xPath is required, avoid using ‘//’ as it affects performance. ‘//’ xPath takes the whole document as a target of search even if you call xPath method on any node in the document. It may cause unexpected result.

8. Use RequestState object carefully
Severity	2
Info	When using RequestState object, make sure you understand how the values will be used in case more than one object is processed within on request
Examples	There is an onBeforeAdd item method to set value to the RequestState and onAfterAdd item method to get and process value that was previously set. In case more than one item is added within one request, the value could be overwritten and the logic could be broken.
Facts	This will help prevent logical errors in business processes.
Info	RequestState is an object which exists only in context of any server request The same RequestState item is used in every event executed in context of the same request Try to use unique key for RequestState for intended set of methods to not unintentionally overwrite values from another methods (like mentioned in example)

9. Do not forget to Revoke granted identities
Severity	2
Info	Specify additional permissions only for a limited amount of code which applies item and revoke them right after it to avoid unexpected permissions grant. Exceptions: if server method uses Aras.ARK.Common there is no need to revoke Identity, since this logic is already included in methods like "ApplyItemWithGrantIdentity", "ApplyActionWithGrantIdentity", etc.
Examples	public Item ApplyItemWithGrantIdentity(Item item, string identityName) { Aras.Server.Security.Identity identityForGrant = Aras.Server.Security.Identity.GetByName(identityName); bool permissionWasGranted = false; try { permissionWasGranted = Aras.Server.Security.Identity.GrantIdentity(identityForGrant); return item.apply(); } finally { if (permissionWasGranted) { Aras.Server.Security.Identity.RevokeIdentity(identityForGrant); } } }
Facts	GrantIdentity call grants permission until they are revoked or until the end of the server method execution.
Info	So, in case you forget to revoke permission some code in the same server method might apply AML with extended permissions list which might lead to security leaks.

10. Do not grant Super User Identity
Severity	1
Info	Never use GrantIdentity method with Super User identity
Examples	Use any (new or existing) other identity (preferably without members) which has necessary access to required data and temporary grant it during business logic to perform operations which require additional access rights.
Facts	GrantIdentity call grants permission until they are revoked or right after server method execution. Granting Super User identity may lead to unintentional exposing of secure data to user.
Info	A good example of best practices is ‘Aras PLM’ identity in PLM package which is granted only during workflow process to operate Parts and Documents. It doesn’t expose any other access than necessary.

11. Avoid using SQL operations
Severity	2
Info	Instead of SQL use IOM API as much as possible
Examples	Problem related to update of LifeCycle state of an item with SQL. In this case logic of transition between states (events/permissions update/etc.) isn’t executed which might corrupt database.
Facts	SQL operations bypass access validations. SQL operations don’t trigger on(Add/Update/Delete/Promote/etc.) events and any server-side logic related to these actions. SQL operations skip update on Innovator Cache (Insert/Update/Delete operations).

12. Innovator methods should have proper execution permissions
Severity	2
Info	Always make sure that execution of a method allowed only for designated users
Examples
Facts	It is important to make sure that only designated users can execute methods which manipulate data with granted identities to avoid security vulnerabilities.
Info	By default, execution is allowed to World identity (until 11.0 SP12). Administrators after 11.0 SP12

13. Wisely use returnMode on get AML request
Severity	2
Info	Use returnMode attribute in case of pagination or count request to improve performance
Examples	Without returnMode=’itemsOnly’ With returnMode=’itemsOnly’ With returnMode='countOnly' Item part = dal.NewItem("Part", "get"); // set properties criteria part.setAttribute("returnMode", "countOnly"); part = dal.ApplyItem(part); // some validations XmlNode itemMax = part.dom.SelectSingleNode(".//Message/event[@name='itemmax']/@value"); int itemsCount = int.Parse(itemMax.Value); //...
Facts	In case you use returnMode=’itemsOnly’ with pagination – server will not send count request to DB to retrieve max count of items for current request. Without pagination usage count request isn’t sent to DB. In case you use returnMode=’countOnly’ – server will send only count request to DB.
Info	Improves performance (less requests are sent to DB)

14. Use client-side cache to get Variable values instead of requesting them from the server.
Severity	Mandatory
Info	Use the client-side cache to get Variables instead of calling the server. This approach reduces the number of requests from Client to Server, improving the UI experience and performance. If cache-enabled items are not already in the cache, you can get them the first time from the server, and they will be automatically cached.
Examples	Wrong way: var commandsEnabled = false; var commandsVarItem = aras.getItemFromServerByName("Variable", "VariableName", "value,default_value"); if(commandsVarItem) { var value = commandsVarItem.getProperty("value") \|\| commandsVarItem.getProperty("default_value"); commandsEnabled = !(value === "0"); } Correct way: var commandsEnabled = false; var variableName = "VariableName"; var commandsVarItem = aras.itemsCache.getItemByXPath(`/Innovator/Items/Item[@type="Variable" and id[@keyed_name="${variableName}"]]`) \|\| aras.getItem('Variable', `id[@keyed_name="${variableName}"]`, `<name>${variableName}</name>`, 0, undefined, 'value,default_value'); if (commandsVarItem) { var value = aras.getItemProperty(commandsVarItem, "value") \|\| aras.getItemProperty(commandsVarItem, "default_value"); commandsEnabled = !(value === "0"); }
Facts	It is preferable to use cached value access rather than making a client-server trip, particularly when the latency is high. Using the Aras Innovator client-side cached value can significantly improve value access time.
Exception	None

Tests

ConnieBurke — Fri, 25 Jun 2021 14:15:48 GMT

Integration Tests
Selenium Tests

1. Integration Tests
Severity	1
Info	Common Integration Tests Best Practices

2. Selenium Tests
Severity	1
Info	Common Selenium Tests Best Practices

Add Column Sets and Group Box

Juan Leach — Wed, 29 Nov 2023 20:15:07 GMT

Setting Up Column Sets

The journey begins on the blank canvas pane of the form designer, where you can add Column Sets. You have options for 2, 3, or 4 Column Sets, each offering a different layout dynamic. When adding columns to an existing set, simply drag the "Column" field to your desired spot.

www.aras.com/.../Setting-Up-Column-Sets.mp4

Customizing for Different Screen Sizes

It's essential to consider how your form will appear on different devices. The 'Wrap Columns on Small Display' option allows columns to stack vertically on smaller screens, maintaining readability and user interaction.

Incorporating Group Boxes

Group Boxes serve as visual containers for related form fields. Drag and drop these into your form layout, and then place the desired columns inside them. This helps in organizing the form and enhancing user navigation.

www.aras.com/.../Incorporating-Group-Boxes.mp4

Columns Adjustments

Once your columns and group boxes are in place, you can fine-tune each element. Adjustments include setting the name, ratio, and the min and max widths of the columns to ensure they fit perfectly within your form's design.

Ratio	Space each column occupies relative to others in terms of width. For instance, a column ratio of "2:1" between two columns means that one column is twice as wide as the others.
Min Width	Minimum width of the column in pixels, used when screen is reduced horizontally.

You can navigate up on the hierarchy of Form > Column set/group box > column > Field using the clickable link on the top of the Detailed Pane. An example of a clickable link: Column Set 0 in the screenshot below.

ACE Presentations

ConnieBurke — Tue, 02 May 2023 20:19:23 GMT

The Aras Training Team provided numerous hands-on, interactive training sessions on various topics at ACE over the last few years. Click on the corresponding year to download the PDFs that were presented during the instructor-led sessions at ACE.

拡張チーム

Tom Semeraro — Fri, 01 Dec 2023 18:53:00 GMT

実装パートナーと連携している場合、そのパートナーをサポートチームに参加させて、サポートインシデントを表示する、コメントを追加する、新しいサポートインシデントを作成する、サポートインシデントに対応する、といった作業をパートナーが行えるようにしたいときがあります。組織外の他のユーザーをサポートチームに招待するには、組織のポータル管理者が、その個人を外部サポートチームメンバーとして追加します。

Web ページの右上隅のプロフィールアイコンで、プロフィールの下の「アカウント」を選択し、「サポートアクセス」タブをクリックします。「拡張チームにユーザーを追加」ボタンを押します。ダイアログウィンドウが開きますので、ここに、拡張サポートチームに追加する個人のメールアドレスを入力します。追加する全員のメールアドレスを入力したら、「次へ」を押します。利用規約を確認し、「同意して保存」をクリックします。組織の拡張サポートチームに追加された各ユーザーに、その旨がメールで通知されます。

外部サポートチームメンバーを追加しているときに問題が発生した場合は、以下の方法を試してみてください。

このメールアドレスが組織に関連付けられている場合。 「チーム」タブの「チームを招待」アクションを使用して、この個人を社内チームに招待してください。メールアドレスが組織に関連付けられていないと思われる場合は、アカウント所有者に連絡して、このドメインの競合を解決してください。
サポートユーザーが多すぎる場合 - Aras サブスクライバーは、Aras サポートに直接連絡できる管理者 + サポートユーザーとして最大 10 人を設定できます。 外部チームのメンバーも、この制限の合計サポートユーザー数にカウントされます。社内サポートチームメンバーと拡張サポートチームメンバーの合計数が 10 人を超えないようにしてください。
Aras ポータルアカウントを持っていない個人であるため、拡張チームのメンバーとして追加できない。 この人に Aras Portal アカウントを作成してもらいます。その後、Aras ポータルにアクセスできるようになってから再度試してもらいます。
この個人がパートナーとして適切に設定されていない。 この問題を解決するためには、該当する個人からアカウント所有者または partners@aras.com に連絡してもらいます。

上記の方法を試しても、拡張サポートチームメンバーの追加に関する問題が解決しない場合は、ポータルのフィードバックからご連絡ください。トラブルシューティングをお手伝いするために、できるだけ早く担当者から連絡いたします。

チームメンバーの管理

Tom Semeraro — Fri, 01 Dec 2023 18:52:23 GMT

ポータルには 3 つのサブスクライバーロールがあります。

メンバー - ポータルメンバーは、すべてのお知らせ、オンライントレーニングリソース、製品ドキュメント、アップグレード計画情報にアクセスできます。コミュニティフォーラムに参加したり、Aras ニュースレター、サポート速報、Aras イベントなどにサインアップするようアカウントを設定したりすることもできます。
サポート - サポート担当者ロールでは、サポートインシデントを表示、作成、更新するだけでなく、サブスクリプションライセンスキーを表示することも可能です。注：サポート担当者として指定できる人数は 1 サブスクライバーあたり最大 10 人です。
管理者 - ポータル管理者ロールでは、サブスクライバーチームの維持管理を支援できます。

サブスクライバーアカウントのポータル管理者は、簡単な手順で、組織内の 1 人または複数の人を Aras サブスクライバーポータルのメンバーになるように招待できます。「削除」アクションを使用して、組織に所属しなくなったメンバーを削除することもできます。

ポータル管理者の場合、Web ページ右上隅の「プロフィール」 > 「アカウント」にある「アカウント」ページに「チームを招待」アクションがあります。メンバーを、サブスクライバー組織のサポート担当者として指定することもできます。

ポータルメンバーになるようにユーザーを招待するには、複数のメールアドレスをコンマで区切って選択し、「チームを招待」ボタンを使用して追加します。ポータルに参加するための招待を受け取ったユーザーがユーザー情報を入力すると、新規ユーザーそれぞれにログイン情報が届きます。

組織がポータル管理者を変更または追加したい場合は、サブスクリプションページに記載されている Aras/パートナーアカウント担当者に連絡してください。

他のチームメンバーを招待する

Tom Semeraro — Fri, 01 Dec 2023 18:51:43 GMT

組織の他のユーザーをサブスクライバーポータルに招待するには、サブスクライバーポータルのログインページに記載されている、アカウント申請のためのリンクを使用します。

ポータル管理者であれば、ポータルメンバーになるようチームメンバーを招待できます。Web ページの右上隅のプロフィールアイコンで、プロフィールの下にある「アカウント」を選択し、複数のメールアドレスをコンマで区切って選択した後、「チームを招待」ボタンを使用して追加します。ポータルに参加するための招待を受け取ったユーザーがユーザー情報を入力すると、新規ユーザーそれぞれにログイン情報が届きます。

Aras に関する最新情報を常に受け取るには

Tom Semeraro — Fri, 01 Dec 2023 18:50:00 GMT

Aras に関する最新情報を常にお受け取りいただくためのメールリストをいくつかご用意しています。ご自身に合ったオプションを選択してください。これらのメール配信は、各メールまたはこのリストからいつでも停止できます。

お近くで今後開催される Aras イベントについて確認する - ACE、Aras Connect、その他のイベント
Aras からの最新情報の概要を毎月入手する – ニュースレター、製品リリース、プレスリリース
Aras サポートからの時間的制約のある重要なソフトウェア更新を常に最新の状態に保つ – サポート速報アップデート
数週間ごとに開催されるウェビナーで実際に動いている Aras Innovator を見る – ソートリーダーシップ（eBook、デモシリーズ、ウェビナー）

サブスクライバーポータルのユーザー管理

Tom Semeraro — Fri, 01 Dec 2023 18:49:06 GMT

サブスクライバーポータルでのユーザーの管理に関するトピックです。

機能のライセンスをインストールする方法

Tom Semeraro — Fri, 01 Dec 2023 18:47:18 GMT

アクティベーションキーを取得したら、以下の手順で機能のライセンスをインストールします。

Innovator に管理者としてログインします。
右上隅にある「ユーザーメニュー」ボタンをクリックします。次のようなドロップダウンメニューが表示されます。
「機能を有効化する」を選択します。次のようなダイアログボックスが表示されます。
取得したアクティベーションキーを貼り付け、「機能を有効化する」をクリックします。
次のような完了メッセージがポップアップ表示されます。

詳細については、「Aras - インストールガイド」の第 6 章を参照してください。
ライセンスに関する質問または問題については、licenses@aras.comまでご連絡ください

サブスクリプションライセンスにアクセスするには

Tom Semeraro — Fri, 01 Dec 2023 18:46:32 GMT

Aras のサブスクリプションでは、例えばビジュアルコラボレーションのような製品開発のための管理機能や、エンタープライズ検索や一括インポートツールのような Aras Innovator へのマイグレーションを支援する機能を使用できます。

サブスクライバーポータルには、Aras 環境にインストールするための最新機能ライセンスキー一覧があります。「サブスクリプション」、「ライセンス」の順に選択します。

ライセンスのインストールに関する問題またはその他の質問がある場合は、licenses@aras.com までご連絡ください。

Aras Innovator ソフトウェアへのアクセス（FTP）について

Tom Semeraro — Fri, 01 Dec 2023 18:45:49 GMT

サブスクライバーは、Aras FTP サイト経由ですべての Aras ソフトウェアおよび製品ドキュメントにアクセスできます。

各サブスクライバーが、リリースの CD イメージが収納された ftp フォルダにある Aras ソフトウェアにアクセスできます。これには、すべてのプラットフォームリリースと Aras アプリケーションが含まれます。

Aras では、FileZilla FTP クライアントを使用して Aras FTP を操作することをお勧めします。

注：FTP 領域を使用して、特定のサポート調査または Aras アップグレードに関する情報を Aras サポートに送信することもできます。

さらに質問がある場合、またはパスワードのリセットが必要な場合は、Support@aras.com までメールでご連絡ください

Aras サブスクリプションへのアクセス

Tom Semeraro — Fri, 01 Dec 2023 18:45:07 GMT

Aras サブスクリプションのサービスは、ビジネスに不可欠なプロセスと製品データを、Aras ソリューションを使って管理している組織向けに設計されています。こうしたサービスによって、導入期間を短縮し、組織のビジネスニーズにより迅速に対応できます。貴社の Aras Innovator サブスクリプションには、サブスクライバーポータルに表示されているサービスと現在のサブスクリプション期間が含まれます。

「サブスクリプション」ページには以下の情報が表示されます。

サブスクリプション – サブスクリプションサービスの SKU 番号

説明 – サービスの簡単な説明（Aras Innovator Premier Subscription など）

数量 - 以下に示す Aras Premier サブスクリプションの数量は、指定されたユーザー数に対するものです。CAD コネクタの数量は、同時ユーザー数に対するものです。

開始日と終了日 – 現在および将来のサブスクリプション期間の開始日と終了日です。

ステータス – このサブスクリプションのステータス

アクティブ - サブスクリプションサービスが有効です。

保留中 - 次のサブスクリプション期間が計画されていますが、サブスクライバーからこのサービス期間に関する確約済み発注書または同様の契約を受け取っていません。

確約済み - 次のサブスクリプション期間が確約され、サブスクライバーからこのサービス期間の発注書または同様の契約を受け取っています。

サブスクリプションについてご不明な点がありましたら、info@aras.com までメールでお問い合わせください。